在 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）。
