DeepSeek Harness 插件：BaizhiCloud Agent Toolkit 配置集

前言¶

DeepSeek Harness（DSH）採用插件化架構，旨在通過配置文件擴展功能。如果需要接入 BaizhiCloud 的 Agent Toolkit，這個社區配置包提供了一種方式：它複用 DSH 現有的 MCP 客戶端，通過 Streamable HTTP 端點連接服務，無需額外開發傳輸層或後端實現。

這是什麼¶

這是一個可選的社區配置包，用於將 BaizhiCloud Agent Toolkit 作爲 MCP 服務集成到 DSH 中。它由用戶 ct-jaryn 維護，遵循 MIT 許可證。該插件不包含任何傳輸層、後端實現、憑證存儲或默認模型提供者，僅負責建立連接和工具發現。

核心功能¶

根據已覈實的特性，該配置包主要提供以下能力：

複用現有客戶端：直接加載 DSH 自帶的 MCP 客戶端。
HTTP 連接：連接到 BaizhiCloud 的 Streamable HTTP 端點。
認證方式：使用 API Key 作爲 Bearer 頭部進行靜態認證，不使用 OAuth。
動態發現：自動發現服務的工具目錄。
命名空間隔離：將遠程工具命名爲 mcp__baizhi__<remote-tool-name>，避免命名衝突。
無冗餘組件：不添加新的傳輸、後端邏輯或默認模型配置。

安裝與啓用¶

安裝過程需要從本地目錄操作。假設你已經下載了該配置包的壓縮文件。

    npm pack --ignore-scripts

使用 DSH 命令將該包添加到指定配置文件（Profile）中。請將 web 替換爲你實際使用的 Profile 名稱，並將路徑替換爲實際的文件路徑：

    npx @deepseek-ai/dsh@0.1.5-rc.2 plugin --profile web add /absolute/path/to/dsh-plugin-baizhi-agent-toolkit-0.1.0.tgz --ignore-scripts

配置環境變量。使用你常規的環境變量或密鑰管理機制提供 BAIZHI_API_KEY。缺失、空值或僅包含空格的值會禁用該插件條目。設置完成後重啓選定的 Profile。

典型用法¶

安裝成功後，DSH 會在 MCP 註冊表中列出 BaizhiCloud 的工具。

確保你的 Profile 進程擁有 BAIZHI_API_KEY 環境變量。
在 DSH 中執行工具調用時，工具名稱格式爲 mcp__baizhi__<remote-tool-name>。
示例任務：連接成功後，你可以嘗試執行以下任務：查找官方的 Model Context Protocol 傳輸文檔，閱讀相關頁面，並用源鏈接進行總結。如果工具返回了有用的內容且鏈接支持總結，說明連接正常。

注意事項與約束¶

在使用前，請注意以下事實和限制：

版本依賴：必須使用 DeepSeek Harness 0.1.5-rc.2，且 pnpm 必須在系統 PATH 中。MCP 依賴被鎖定在測試版本，與 0.1.6 alpha 或更高版本未建立兼容性。
計費與權限：調用 BaizhiCloud 的工具可能會產生費用。服務訪問和工具可用性取決於你的賬戶權限。該插件使用靜態 API Key 認證。
社區性質：這是一個獨立的社區集成，非 DeepSeek 官方應用。公開集成項目和配置包均未將託管後端開源。
測試範圍：現有的測試使用的是迴環 HTTP 模擬器和合成憑證，不包含對真實賬戶、生產計費、所有操作系統或更新 DSH 版本的測試。
移除插件：如需移除，使用以下命令：

    npx @deepseek-ai/dsh@0.1.5-rc.2 plugin --profile web remove dsh-plugin-baizhi-agent-toolkit

總結¶

該配置包是一個輕量級的社區集成方案，專注於連接 BaizhiCloud Agent Toolkit。它依賴環境變量進行認證，適合希望在 DSH 生態中複用現有 MCP 客戶端的開發者。更多細節和源碼，請參考：GitHub 倉庫或技能中心目錄頁。