DeepSeek Harness 内置了 web_search 和 web_fetch 后端，使用时需要单独申请 API 密钥并计费。已有 Z.AI (GLM) 订阅的用户往往希望复用现有额度。这个插件通过 OAuth 登录，将 Harness 的网络搜索、阅读和视觉能力接入 Z.AI 后端，无需管理额外的 API 密钥。
核心功能¶
该插件主要解决网络检索和内容获取的后端接入问题，并提供状态监控。
- 网络搜索：将 Harness 的
web_search工具替换为 Z.AI 的web_search_prime。 - 网络阅读器：将
web_fetch工具替换为 Z.AI 的webReader。 - 视觉能力：注册
zai_vision工具，用于图像描述、OCR 和视觉问答。 - 状态监控：提供
/dsh-glm-status命令，显示令牌年龄、计划过期时间和剩余配额。 - 零依赖：代码不依赖外部库，无
node_modules、dependencies或peerDependencies。
安装与启用¶
通过命令行或插件管理器安装。安装后需要重启 Harness 才能生效。
命令行安装：
dsh plugin --profile desktop add dsh-glm-web-search
插件管理器安装：
- 打开 Plugins → Add plugin。
- 输入
dsh-glm-web-search。 - 确保安装源为 npm（或中国大陆镜像 npmmirror）。
- 安装完成后重启 Harness。
使用方法¶
安装并登录后，原有的工具调用逻辑无需修改，插件会自动接管。
登录与登出：
/dsh-glm-web-search login # 打开浏览器进行 OAuth 授权
/dsh-glm-web-search logout # 清除本地凭据
上述命令支持简写别名：
/dsh-glm-login
/dsh-glm-logout
查看状态：
/dsh-glm-status
此命令会显示令牌有效性、计划详情以及 GLM-5.3 和 GLM-5.3-Flash 的配额使用情况。
配置与限制¶
插件支持部分配置项，默认值通常能满足基本需求。
配置字段：
| 字段 | 默认值 | 说明 |
|---|---|---|
origin |
https://zcode.z.ai |
网关地址 |
model |
unset | 搜索和获取所使用的模型 |
appVersion |
probed | 通告给网关的客户端版本 |
jwtEnv |
ZAI_JWT |
凭据环境变量引用 |
tokenPath |
$DSH_HOME/dsh-glm-web-search/token.json |
本地令牌文件路径 |
vision |
true |
是否注册 zai_vision 工具 |
timeoutMs |
90000 |
请求超时时间（毫秒） |
已知限制：
- 搜索结果上限：上游 Z.AI 返回最多 10 个结果，DSH 工具层将其截断为 8 个（设置
truncated: true）。 - 免费账户限制：免费 Z.AI 账号可用于搜索和获取；视觉功能需要 Flash 模型支持。
- 凭据存储：凭据存储在本地文件
$DSH_HOME/dsh-glm-web-search/token.json中，升级插件不会丢失凭据。
适用场景¶
如果你已持有 Z.AI 订阅计划，希望在不增加 DeepSeek Harness 账单的情况下使用联网和视觉功能，该插件是直接的选择。由于它是零依赖插件，对系统环境要求较低。
