前言¶
DeepSeek Harness (DSH) 採用了插件化架構，旨在將各類數據源和工具接入智能體。在企業應用中，讓智能體訪問數據庫或內部業務 API 是常見需求，但直接暴露憑證或賦予無限調用權限存在風險。dsh-connect 插件提供了一套標準化的連接與工具註冊方案，解決數據接入與 Agent 調用之間的安全與協作問題。
插件定位¶
這是 DeepSeek Harness 的數據源連接插件，由 niuhuoshan 維護。它主要解決兩個問題：一是將企業數據庫和第三方 API 安全接入 DSH 環境；二是將這些連接轉化爲受約束的 Agent 工具，供智能體在對話中按需調用。
核心功能¶
插件提供以下核心能力：
* 數據庫連接與結構發現：連接 MySQL、PostgreSQL 等數據庫，掃描物理結構，生成可供 Agent 檢索的元數據。
* AI 語義建模：利用 DSH 默認模型對錶和字段進行語義識別，生成業務名稱、描述和標籤。
* 只讀 SQL 查詢：支持 Agent 生成受限的只讀 SQL 語句進行數據查詢。
* 固定 HTTP API 調用：配置固定的第三方 API，註冊爲受約束的 Agent 工具，模型無法修改 URL 或參數。
* Agent 工具註冊：自動將配置好的數據源和 API 註冊爲 DSH Agent 可識別的工具。
* 元數據同步與指標推薦：支持增量同步和指標推薦功能，並支持 YAML 格式導出。
安裝與啓用¶
在 DSH 的 Web profile 中執行以下命令進行安裝：
dsh plugin --profile web add @niuhuoshan/dsh-connect
安裝完成後重啓 DSH。進入 設置 -> DSH連接器，即可看到插件入口。頁面包含 數據庫 和 HTTP API 兩個 Tab。
典型用法¶
數據庫接入¶
- 在 設置 -> DSH連接器 -> 數據庫 中點擊 添加數據庫。
- 填寫連接信息（主機、端口、用戶名、密碼等），點擊 測試連接。
- 點擊 掃描 完成物理結構發現。若需語義識別，勾選 AI 語義增強 後點擊 AI 建模。
- 在聊天中直接提問，例如：“華東區域本月每天的訂單量和銷售金額是多少？”，Agent 會檢索元數據並調用查詢工具。
HTTP API 接入¶
- 在 設置 -> DSH連接器 -> HTTP API 中添加 API。
- 配置固定的基礎 URL、路徑模板、認證方式和參數。
- 測試請求成功並啓用後，在聊天中用自然語言描述需求，Agent 即可觸發調用。
適用場景與注意事項¶
- 安全邊界：數據庫僅支持只讀、DDL 和多語句，不支持寫庫。HTTP API 配置固定，模型無法修改 URL、方法或跨域跳轉。
- 數據脫敏：樣例數據僅保存在本地，不會暴露給 Agent 或模型。敏感字段（如密碼、Token）會被自動脫敏。
- 憑證管理：數據庫密碼和 API 憑證保存在 DSH credential service 中，不會出現在列表接口或 Agent 返回值中。
- 開源協議：插件採用 MIT 許可證。
總結¶
dsh-connect 爲 DSH 提供了標準化的數據源接入方案，通過 AI 語義建模和受約束的工具調用，讓智能體能夠安全、高效地訪問企業數據和業務接口。如需瞭解更多細節，可參考社區目錄或 GitHub 倉庫。
