前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。当需要在智能体开发中接入互联网搜索能力时，直接调用 Z.ai 或智谱 AI 的接口通常需要额外的配置和开发工作。dsh-web-search-zai 插件将这两家服务商的搜索能力封装进 DSH 的原生配置体系中，让开发者可以在 DSH 环境中直接使用搜索功能。
插件定位¶
这是一个由社区开发者 kenny2077 维护的联网工具插件。它允许你通过 DeepSeek Harness 直接调用 Z.ai 或智谱 AI 的接口进行网页搜索。插件提供了中英文原生的设置卡片，支持 Coding Plan 配额和 REST API 计费两种模式，并复用现有的 ZAI_API_KEY 凭证。
核心功能¶
- 多源搜索：支持使用 Z.ai 或智谱 AI 的搜索接口。
- 原生配置：提供中英文双语设置界面，配置项位于
web-search-zai命名空间下。 - 双计费模式：默认支持 Coding Plan MCP 配额，同时也支持 REST API 计费。
- 凭证复用：复用 DSH 中已有的
ZAI_API_KEY，无需重复输入。
安装与启用¶
在安装前，请确保你的 DeepSeek Harness 已开启 web 设置服务，且运行环境满足以下要求：
* Node.js 22.19+ 或 24+。
使用官方安装命令将插件添加到 web 配置文件中：
dsh plugin --profile web add dsh-web-search-zai@latest
dsh web
如果你偏好直接从 GitHub 安装最新构建：
dsh plugin --profile web add github:kenny2077/dsh-web-search-zai
典型用法¶
安装完成后，通过 dsh web 命令打开 Web 界面。在设置中找到 Web Search (Z.ai) 卡片，进行以下配置：
- 选择计费模式：在卡片中选择 Coding Plan（订阅 MCP 配额）或 API（API 余额）。
- 配置密钥：如果 DSH 已配置了正确的
ZAI_API_KEY，留空输入框即可保留共享密钥；否则手动输入密钥。输入明文密钥会覆盖凭证管理。 - 选择服务商：默认使用 Z.ai 国际版。如需使用智谱中国版，需在高级设置中开启“Use Zhipu (China)”并保存。
保存配置后，即可在 DSH 中发起网页搜索请求。该插件以当前 DSH 进程的权限运行，搜索请求会直接消耗所选服务（Coding Plan 或 API）的配额。
适用场景与注意¶
- 适用场景：需要在 DeepSeek Harness 智能体中集成联网搜索能力的开发者。
- 注意事项：
- 这是一个社区插件，社区目录收录不代表 DeepSeek 或 Z.ai 的官方背书。
- 安装前建议查看源码和许可证（MIT）。
- 即使没有发起对话推理请求，执行一次搜索操作也会消耗配额。
- 密钥存储在 DSH 的凭证管理中，浏览器不会直接读取存储的密钥。
总结¶
该插件通过统一接口将 Z.ai 和智谱的搜索能力引入 DeepSeek Harness，简化了配置流程。你可以通过 npm 包管理安装，或在社区目录中查看详情。
- 插件仓库：https://github.com/kenny2077/dsh-web-search-zai
- 社区目录：https://www.skillhub.cn/plugins/kenny2077/dsh-web-search-zai
