在 DeepSeek Harness (DSH) 的插件化架構中,將外部 MCP 服務轉化爲本地可調用的能力是提升智能體通用性的關鍵。智譜的 GLM Coding Plan 提供了聯網搜索、網頁讀取和開源倉庫操作等能力。本插件將智譜的 MCP 服務器能力以 DSH 原生 provider 和工具的形式引入,替換或補充原有的 web_search/web_fetch 後端,並註冊 github_* 工具。
核心功能¶
本插件提供以下能力:
- 聯網搜索:接管 DSH 的
web_search工具,使用智譜的web_search_prime。 - 網頁讀取:接管 DSH 的
web_fetch工具,使用智譜的webReader返回 Markdown。 - 開源倉庫工具:註冊
github_search_doc、github_get_repo_structure、github_read_file三個原生工具。
安裝¶
使用官方 npm 註冊表安裝:
dsh plugin --profile web add deepseek-harness-zhipu_plan_tools
Open Design 或 headless profile 也可使用相同命令安裝。
配置與使用¶
安裝完成後,需完成以下步驟以啓用功能。
1. 添加提供方¶
在 DSH 設置 → 模型中,提供方下拉選擇 zai-coding-cn。這是智譜中國區的端點。
2. 配置憑據¶
插件默認引用名爲 ZAI_CODING_CN_API_KEY。請確保該 API Key 已存在於環境變量或 ~/.dsh/.credentials.yaml 中。
3. 插件配置¶
打開 DSH 設置 → 插件 → 插件配置,展開“智譜工具”卡片。各配置項說明如下:
| 配置項 | 默認值 | 說明 |
|---|---|---|
| 啓用智譜工具 | 開 | 總開關,關閉後搜索/讀取進入兼容回退,倉庫工具卸載 |
聯網搜索(接管 web_search) |
開 | 通過智譜搜索,替換模型可見的內置搜索說明 |
網頁讀取(接管 web_fetch) |
開 | 通過智譜 webReader 返回 Markdown |
| 開源倉庫工具 | 關 | 註冊 github_search_doc、github_get_repo_structure、github_read_file |
| 提示詞中文化 | 關 | 將插件注入的提示、工具說明與錯誤消息切換爲中文 |
| 憑據引用名 | ZAI_CODING_CN_API_KEY |
僅保存引用名,不保存 Key 本身 |
行爲說明¶
- 最小化預設:在
minimal預設下,插件不會註冊web_search陰影,保持雙工具承諾。 - 兼容回退:關閉搜索或讀取功能後,會自動進入兼容回退(使用 DeepSeek 搜索或受限 HTTP 抓取)。
- 安全性:API Key 永不寫入配置文件或日誌中。
- 熱更新:Host 側產物支持熱重載,修改
src/目錄並運行構建後即可生效。
適用場景與注意¶
該插件適合需要利用智譜 GLM Coding Plan 強大聯網與代碼倉庫分析能力的 DSH 用戶。使用前請確保 DeepSeek Harness 版本 ≥ 0.1.5-rc.1。
注意:插件以當前 DSH 進程的權限運行。安裝前請檢查源碼與許可證(MIT)。