前言¶

在 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 倉庫。