前言¶

在 DeepSeek Harness（DSH）的插件化生态中，针对 ChatBI 类场景（如数据库查询、MCP 工具调用、API 管理）的解决方案通常依赖后端服务。dsh-chatbi 插件将这一逻辑下沉至客户端，通过本地运行时处理数据库连接、MCP 服务器交互及 SQL/API 工具注册，无需额外部署 Java 后端。

核心定位¶

该插件由 Huauauaa 维护，采用 MIT 许可证。它是一个完全自包含的 DSH 客户端插件，专注于数据库、MCP、API 和 SQL 工具的管理。

功能概览¶

插件通过本地 JSON 存储管理各类工具配置，核心功能包括：
* 数据库连接：支持通过 Node.js 的内置 node:sqlite 进行 SQLite 操作，其他类型数据库连接仅存储元数据。
* MCP 与 API 工具：提供 MCP 服务器及 API 工具的注册与调用能力，均基于 HTTP POST 或 fetch。
* SQL 工具：通过模板映射到 chatbi_sql_execute 接口。
* Agent 工具：为智能体提供 chatbi_status（状态摘要）、chatbi_sql_execute（执行 SQL）、chatbi_mcp_call、chatbi_api_call 以及 chatbi_list_* 系列工具。
* 数据存储：所有配置数据存储在本地 $DSH_HOME/chatbi/store.json。
* 界面：使用 Tailwind CSS v4 构建，集成于 DSH 设置页面。

安装与启用¶

安装前需确保环境满足 Node.js 版本要求（Node ≥ 22）。
在插件目录下执行：

dsh plugin --profile web add ./

安装完成后，在 DSH 客户端的设置中即可找到 ChatBI 相关配置入口。

配置与使用¶

进入 Settings → ChatBI：
* 数据目录：默认为 $DSH_HOME/chatbi，可在设置中覆盖。
* 选项卡：提供概览、数据库、MCP 工具、API 工具、SQL 工具五个视图。
* 数据位置：所有工具配置文件存储在 $DSH_HOME/chatbi/store.json。

Agent 工具使用¶

插件注册了以下 Agent 工具供智能体调用：
* chatbi_status：获取本地存储的摘要信息。
* chatbi_sql_execute：执行 SQL 语句（支持 SQLite）。
* chatbi_mcp_call：调用已注册的 MCP 工具。
* chatbi_api_call：调用已注册的 API 工具。
* chatbi_list_*：列出 MCP、SQL 或 API 工具。

注意事项与限制¶

• 驱动依赖：MySQL/PostgreSQL 连接仅存储在本地，若需执行实时 SQL，需自行安装并配置对应驱动（插件未内置）。
• MCP 调用假设：MCP 工具的调用假设配置的服务器端点为 HTTP，且支持通用 JSON body。
• 初始化方式：MCP、SQL、API 工具需要通过编辑 store.json 初始化，或通过后续扩展 UI 来实现。

验证与构建¶

如需本地验证，可运行以下命令：

npm install --legacy-peer-deps
npm test
npm run build

结语¶

dsh-chatbi 适合需要在 DSH 客户端侧直接管理数据源与工具链的开发者。如需更多信息，可访问 SkillHub 插件目录 或查看 GitHub 仓库。