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 賬單的情況下使用聯網和視覺功能，該插件是直接的選擇。由於它是零依賴插件，對系統環境要求較低。
