前言¶
在 DeepSeek Harness（DSH）里做需要实时信息的对话时，模型会调用原生 web_search 工具。默认情况下，这条链路往往走 DeepSeek 内置搜索通道，可能消耗平台侧余额或按量计费接口。若你已经在智谱开放平台开通了 GLM Coding Plan，并把主要工作流放在该套餐的搜索额度上，更希望 DSH 的联网查询与 Coding Plan 对齐，而不是多开一条计费路径。
社区插件 dsh-web-search-zhipu-mcp（仓库 wgl2zj/dsh-websearch-zai-codingplan）做的是一件事：接管 DSH 的 web_search，经智谱官方「联网搜索 MCP」（web_search_prime）返回结果，计费落在 Coding Plan 套餐搜索额度；同时提供设置页，可单独保存本插件 API Key。维护者为 wgl2zj，在 SkillHub 分类为联网工具。
这是什么¶
插件 npm 包名为 dsh-web-search-zhipu-mcp，当前资料中的版本为 0.2.1，许可证 MIT。它注册 provider zhipu-mcp-search，替代内置 DeepSeek 搜索通道，避免同一工具位被两条实现抢占。对使用者而言，对话里照常触发 web_search，底层改为向 https://open.bigmodel.cn/api/mcp/web_search_prime/mcp 发起 MCP Streamable HTTP 调用，并把返回的标题、链接、摘要映射回 DSH 需要的 sources[] 形态。
核心功能¶
下面所列均来自项目 README，无额外杜撰。
- 接管
web_search：结果由智谱官方搜索 MCP 提供，消耗 GLM Coding Plan 套餐搜索额度；按 README 说明，不烧 DeepSeek 平台余额，也不走按量计费 API。 - 设置页配置 Key：路径为 Settings → 智谱搜索，可填写或清除插件专用 API Key；Key 写入 DSH 凭据服务，界面不回显。
- Key 解析顺序：专用凭据（
ZHIPU_WEB_SEARCH_API_KEY，由设置页写入）优先；若无，回退共用ZAI_CODING_CN_API_KEY（与zai-coding-cn模型通道同一把）；两者皆无则报错。不填专用 Key 时，若已配置模型通道 Key，可零额外配置使用。 - 轮换即时生效：凭据按次解析，更换 Key 后下一次搜索即用新值，无需重启 DSH。
- 自动停用内置 DeepSeek 搜索：安装本插件后，内置通道让位，避免重复注册。
安装与启用¶
推荐通过 npm 一键安装。安装后需彻底退出并重启 DSH 后生效。
dsh plugin --profile desktop add dsh-web-search-zhipu-mcp
若从本机源码目录以 link 方式接入（需自行 git clone 仓库到本地，资料中的做法如下），将 <克隆目录绝对路径> 换为实际路径：
dsh plugin --profile desktop add link:<克隆目录绝对路径>
卸载或回滚：
dsh plugin --profile desktop remove dsh-web-search-zhipu-mcp
移除后，web_search 回落为 DSH 内置 DeepSeek 通道。
兼容性方面，README 记载在 DSH 桌面版 0.2.2-rc.1（Windows x64）实测通过；理论兼容同代 cordis 插件体系的 DSH 版本。开发跑测试需 Node ≥ 20。
典型用法¶
- 在智谱开放平台（open.bigmodel.cn）确认已具备 GLM Coding Plan 套餐。
- 二选一提供凭据：
- 设置页（推荐）：Settings → 智谱搜索 → 粘贴 API Key → 保存；
- 或沿用 Models 页为zai-coding-cn通道已配置的ZAI_CODING_CN_API_KEY。 - 在 DSH 对话中让模型执行联网搜索即可，
web_search自动走智谱 MCP。
无需改对话提示词或单独调用 MCP 工具名；对模型侧仍是一次标准的 web_search 调用。
工作原理（简述）¶
调用链可概括为：DSH web_search → 本插件 provider → 凭据解析 → POST 智谱 MCP 端点 → 将 content[0].text 中双重 JSON 编码剥开，映射为 {title, url, snippet}。
设置页通过本机回环路由 /dsh-web-search-zhipu-mcp/credentials 完成 GET 查状态、POST 存清；宿主半执行 credentials.set / unset / describe，并带跨站栅栏，值不回显。
README 还记录了若干实现边界：例如一次搜索一次 MCP 会话、不复用跨搜索会话；search_recency_filter / search_domain_filter 尚未从模型侧接入；设置页文案当前为中文。
适用场景与注意¶
适合谁：已在 GLM Coding Plan 上承担搜索额度、希望在 DSH 桌面版统一用智谱联网结果、并可能与 zai-coding-cn 共用一把 Key 的开发者。
运行与安全：插件随当前 DSH 进程权限运行，会向智谱云端发起 HTTPS 请求。安装前建议阅读仓库源码与 MIT 许可证，确认凭据存储方式符合你的环境策略。SkillHub 目录页与 DeepSeek / 幻方无官方从属关系，属于社区「一切皆插件」生态中的独立条目。
已知限制：以 README「已知边界」为准——单搜索单会话、部分 MCP 过滤参数未接、依赖 DSH 凭据体系（peer：@deepseek-ai/dsh-credentials）。
相关链接¶
- SkillHub 目录：https://www.skillhub.cn/plugins/wgl2zj/dsh-websearch-zai-codingplan
- GitHub 仓库：https://github.com/wgl2zj/dsh-websearch-zai-codingplan
按上述步骤安装并配置 Key 后，DSH 原生 web_search 即可在 Coding Plan 额度内完成智谱侧联网检索，与模型通道配置形成可选共用、专用优先的凭据策略。
