WhoDB

轻量级、自托管的数据库工作台,集数据浏览、编辑、查询与 AI 问答于一体。

源仓库
clidey/whodb
Star 数
★ 5k
最近更新
今天
License
Apache-2.0
主语言
Go

30 秒速览

运行形态
自托管服务桌面应用命令行工具
可在哪里用
通用 · 跨平台
费用
有免费版,另有付费云服务
上手难度
低 · 几分钟可跑通
开始前需要
DockerShell / 命令行网络访问本地文件系统
典型场景
数据库管理员快速检查本地或远程数据库的表结构和数据行,无需安装重型客户端。
不适合
  • 需要 SSO、审计日志和细粒度权限控制的企业团队
  • 希望完全离线使用且不接入任何外部 AI 服务的用户
  • 需要处理超大数据集、依赖浏览器数据网格的场景

这个 Agent 能做什么,适合哪些场景?

WhoDB 是一个自托管的数据库工作台,提供浏览器、桌面应用和命令行界面三种使用方式。它支持多种数据库(如 PostgreSQL、MySQL、SQLite、MongoDB、Redis 等),提供电子表格风格的数据浏览与编辑、可视化 Schema 图、多单元查询草稿纸、导入导出及模拟数据生成等功能。通过可选的 AI 集成(如 Ollama、OpenAI、Anthropic),用户可以用自然语言提问。WhoDB 还提供 CLI 和 MCP 服务器,便于终端操作与 AI 工具集成。社区版基于 Apache 2.0 许可,另有商业的 WhoDB Platform。

WhoDB 提供完整的数据库操作流程:用户通过浏览器、桌面应用或 CLI 连接数据库,在数据网格中浏览、筛选、排序和编辑行;使用 Schema 图查看表关系;在草稿纸中编写并执行 SQL 查询,支持自动补全与历史记录;支持数据导入、导出和模拟数据生成(用于开发和测试)。用户可通过内置聊天界面连接 AI 提供商(支持 OpenAI、Anthropic、Ollama、LM Studio 等),用自然语言询问数据问题。WhoDB 的后端基于 Go,前端为 React/TypeScript,可通过 Docker 运行,并支持环境变量配置 AI 提供商和加密密钥。

  1. 数据库管理员快速检查本地或远程数据库的表结构和数据行,无需安装重型客户端。
  2. 开发人员在开发环境中生成模拟数据,或导入导出数据以辅助测试。
  3. 数据分析师使用自然语言向数据库提问,快速获取查询结果。
  4. 团队新成员通过 Schema 图直观理解现有数据库的表关系。
  5. 在无图形界面的服务器上,通过 CLI 或 MCP 服务器执行数据库查询和管理任务。
  6. 企业用户评估 WhoDB Platform 以获取共享项目、SSO、审计日志等高级功能。

如何安装或部署这个 Agent?

使用 Docker 运行:

docker run --rm -it -p 8080:8080 clidey/whodb

如需持久化会话,请先生成加密密钥:

openssl rand -hex 32

然后挂载 /data 并设置环境变量:

docker run -it -p 8080:8080 \
  -v whodb-data:/data \
  -e WHODB_ENCRYPTION_KEY=your_saved_64_character_hex_key \
  clidey/whodb

也可通过桌面应用(macOS/Windows/Snap)或 CLI 安装。

如何使用这个 Agent?

启动后,在浏览器中访问 http://localhost:8080,输入数据库连接信息即可开始使用。连接后,您可以在数据网格中浏览和编辑行,使用 Schema 图查看表关系,在草稿纸中编写查询。如需启用 AI 功能,打开聊天界面,选择“添加提供商”,输入 OpenAI/Anthropic 的 API 密钥,或本地启动 Ollama/LM Studio。CLI 用户可运行 whodb-cli 打开终端界面,或 whodb-cli mcp serve 启动 MCP 服务器。

这个 Agent 有哪些优点和局限?

优点
  • 支持广泛的数据库,包括 PostgreSQL、MySQL、SQLite、MongoDB、Redis 等,覆盖常见场景。
  • 提供可视化 Schema 图和数据网格编辑,降低了数据库操作门槛。
  • AI 集成灵活,支持多种提供商,且无需后端配置即可使用。
  • 提供自托管、Docker、桌面应用和 CLI 多种部署方式,适合不同环境。
  • MCP 服务器支持与 AI 工具集成,扩展了自动化能力。
局限
  • 社区版的功能可能因数据库而异,某些高级特性(如 SSO、审计日志)仅在企业版提供。
  • AI 功能依赖外部提供商(Ollama、OpenAI 等),需要网络连接或本地服务。
  • 对于大规模数据集,浏览器端的数据网格可能性能有限。
  • 自定义 AI 提供商可能需要环境变量配置,对非技术用户有一定门槛。

这个 Agent 与同类方案有什么区别?

WhoDB 可视为 TablePlus、DBeaver 等传统数据库客户端或 Retool 等内部工具构建器的替代品,但更轻量且以自托管和 AI 集成为特色。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
WhoDB 当前 51 · 缺口较多 自托管服务免费版 + 付费版 ★ 5k 今天 Go —
Tabularis——开源桌面 SQL 工作台 47 · 缺口较多 桌面应用免费 + 模型费 ★ 5.2k 今天 TypeScript ChatGPT · Codex · Claude Code · Claude.ai
Nocturne Memory:MCP 长期记忆服务器 56 · 缺口较多 MCP 服务器免费 ★ 1.4k 26 天前 Python —
WrenAI GenBI 53 · 缺口较多 命令行工具免费版 + 付费版 ★ 18k 今天 Python Codex · Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
51/ 100 五分制 2.6 / 5
本评测基于 2026年8月11日 的源码;此后该项目发布了 11 个正式版本,尚未复审。分数与结论只代表评测时的版本。 最近版本 ↓
信任安全 11/29
可靠稳定 8/14
适用触发 10/18
规范维护 10/18
有效结果 9/13
证据核验 3/8
查看各维度的扣分理由
信任安全11 / 29 · 1.9/5

证据显示:README 提到加密会话和 WHODB_ENCRYPTION_KEY,表明对敏感数据有一定处理;CI 工作流使用 step-security/harden-runner 限制网络出口,体现最小权限意识;但未发现用户确认机制、数据流透明说明、回滚机制或明确的来源归属。扣分原因:缺少用户确认、数据流透明、回滚和来源归属的证据。

可靠稳定8 / 14 · 2.9/5

证据显示:README 和 CI 工作流一致,描述的功能与代码结构相符;依赖通过 go.mod 和 package.json 管理,但未提供依赖可用性保证;失败消息未在文档中明确。扣分原因:失败消息不明确,依赖可用性未验证。

适用触发10 / 18 · 2.8/5

证据显示:README 明确目标用户(数据库开发者、团队协作)和多种使用场景(本地、桌面、CLI);支持多种数据库,能力边界有说明;但触发精度(如 AI 功能触发)未详细说明;环境适配(Docker、桌面、CLI)有文档。扣分原因:触发精度不足。

规范维护10 / 18 · 2.8/5

证据显示:README 结构清晰,提供快速开始、安装选项、AI 提供商配置;安装说明详细;命名稳定(WhoDB);有示例和 FAQ 链接;已知限制未明确列出;许可证为 Apache-2.0;版本和变更日志未在文件中体现;维护责任有支持邮箱和贡献指南。扣分原因:已知限制、版本变更日志缺失。

有效结果9 / 13 · 3.5/5

证据显示:输出可用性高(提供多种界面和 CLI);边际价值明显(一站式数据库管理);成本效益合理(开源免费)。扣分原因:无具体性能或成本数据支持。

证据核验3 / 8 · 1.9/5

证据显示:README 中的声明与代码结构基本一致,但未提供可追溯的验证方法;跨来源佐证不足(仅依赖 README 和 CI);事实与推断未明确区分。扣分原因:缺乏可追溯性和跨来源验证。

风险与缓解建议
  • 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
  • 未发现用户确认机制,执行敏感操作前应确认。
  • 数据流透明性不足,建议审查网络请求和数据处理。
  • 缺少回滚机制,操作前应备份数据。
  • 依赖安全未完全验证,建议检查依赖漏洞。
证据充分度:低 评估于 2026年8月11日 审查版本 ed5b49b71e40 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. 0.135.0 Release 0.135.0
    发布说明摘录
    * Security fix for TestSourceConnection bypass (https://github.com/clidey/whodb/security/advisories/GHSA-jcvx-4v4m-p5v9) * Security fix for DuckDB bypass (https://github.com/clidey/whodb/security/advisories/GHSA-x3h5-pr45-fx4r) * Update UI to reflect platform * Update dependencies * Update CLI MCP functionality Installation Mac App Store [Download from the Apple Store](https://apps.apple.com/app/whodb/id6754566536) Microsoft Store [Download from the Microsoft Store](https://apps.microsoft.com/detail/9pftx5bv4ds6) Snap Store ```bash sudo snap install whodb ``` …
    在 GitHub 查看 ↗
  2. 0.134.0 Release 0.134.0
    发布说明摘录
    * Fix for https://github.com/clidey/whodb/security/advisories/GHSA-2mwr-p8j5-rm33 * Fix for https://github.com/clidey/whodb/security/advisories/GHSA-pvf2-6h4x-r24j * Fix for https://github.com/clidey/whodb/security/advisories/GHSA-6mr5-wx6p-65fg * Fix for https://github.com/clidey/whodb/security/advisories/GHSA-q89h-vc47-vf4c * Fix for https://github.com/clidey/whodb/security/advisories/GHSA-4r6q-hf67-63p9 * Fix for https://github.com/clidey/whodb/security/advisories/GHSA-q79w-r6rg-4w2j * Fix for https://github.com/clidey/whodb/security/advisories/GHSA-whw2-94xc-h8w8 …
    在 GitHub 查看 ↗
  3. 0.133.0 Release 0.133.0

常见问题

WhoDB 社区版是否完全免费?
社区版基于 Apache 2.0 许可,完全免费,可自行托管。企业版(WhoDB Platform)是商业产品,提供更多功能。
如何确保会话安全?
启动时需设置 WHODB_ENCRYPTION_KEY 环境变量,并挂载 /data 目录持久化加密的会话。如果使用 HTTPS 反向代理,需设置 WHODB_SECURE=true 以仅通过 HTTPS 发送 cookie。
AI 功能需要额外配置吗?
无需后端配置,您可以在聊天界面直接添加 OpenAI、Anthropic 等提供商并输入 API 密钥。本地 Ollama 和 LM Studio 支持自动检测。
支持哪些数据库?
支持 PostgreSQL、MySQL、SQLite、MongoDB、Redis 等,具体支持程度取决于数据库类型。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents