dsh-web-search-glm：基於智譜 GLM 的 DeepSeek Harness 聯網插件

在 DeepSeek Harness (DSH) 中實現智能體的聯網能力，通常需要配置特定的搜索 Provider。dsh-web-search-glm 插件填補了使用智譜 GLM 模型進行原生 Web 搜索的空白，它通過 GLM 的 Anthropic 兼容接口執行搜索請求，並將結果映射爲 DSH 可識別的標準格式。

是什麼¶

這是一個由開發者 Noemm 維護的插件，旨在爲 DSH 的 ctx.web 接口提供 GLM 後端支持。它不依賴爬蟲，而是直接調用 GLM 的 web_search_prime 原生工具。

核心功能¶

原生工具執行：通過 GLM 端點執行原生的 web_search_20250305 服務器工具。
結果映射：將 GLM 返回的 web_search_prime 結果塊映射爲標準化的搜索源。
內容解析：解析內容爲 {url, title, snippet} 格式。
去重處理：自動按 URL 去重。
信號支持：支持完整的 AbortSignal。
多查詢處理：在單次響應中處理多次搜索請求。

安裝與啓用¶

安裝插件¶

使用以下命令將插件添加到指定 profile：

dsh plugin --profile <profile> add dsh-web-search-glm

啓用 Provider¶

DSH 需要明確選擇使用哪個搜索 Provider。默認的 dsh-base bundle 可能已鎖定官方 Provider，你需要通過 profile 的 patch 層進行覆蓋。

在目標 profile 的 cordis.patch.yml 文件中添加或修改以下內容：

# ~/.dsh/profiles/<profile>/cordis.patch.yml
- id: web
  config:
    searchProvider: glm

或者，直接在啓動環境變量中設置：

export DSH_WEB_SEARCH_PROVIDER=glm

配置說明¶

插件的配置項位於 ~/.dsh/settings.yaml 中的 web-search-glm 部分。

基礎配置示例¶

web-search-glm:
  apiKeyEnv: ZAI_API_KEY
  # baseURL: https://api.z.ai/api/anthropic/v1   # 海外部署地址
  # model: glm-5.3-flash                         # 參考模型說明

關鍵配置項¶

配置項	默認值	說明
`apiKeyEnv`	`ZAI_API_KEY`	憑證引用名稱，建議與 `zai` provider 保持一致。
`apiKey`	—	硬編碼的 API Key（不推薦，建議使用 `apiKeyEnv`）。
`baseURL`	`https://open.bigmodel.cn/api/anthropic/v1`	Anthropic 兼容端點地址，`/messages` 由插件自動追加。
`model`	`glm-5.3`	執行原生聯網搜索的模型名稱。
`apiVersion`	`2023-06-01`	請求頭 `anthropic-version` 的值。
`maxTokens`	`4096`	消息請求的 Token 上限。
`maxUses`	`5`	單次請求中 `web_search` 工具的最大調用次數。

憑證解析鏈¶

插件在每次搜索時按順序解析憑證：
1. web-search-glm section 中的 literal apiKey。
2. 通過 apiKeyEnv 引用的憑證服務。
3. 環境變量 apiKeyEnv 的值。

如果以上均未解析成功，搜索將返回 WEB_PROVIDER_CREDENTIAL_MISSING 錯誤。

環境變量回退¶

如果 web-search-glm section 未設置 baseURL，插件會優先檢查啓動環境的 GLM_SEARCH_BASE_URL 變量。

模型說明¶

glm-5.3（默認）：經驗證在 2026-08-27 可正常使用，支持中英文查詢並返回約 10 個來源。
glm-5.3-flash：經驗證可正常使用，行爲與 glm-5.3 一致，可作爲替代方案。
glm-5-flash：該端點不支持此模型，使用時會收到 [1214][modelCode：不存在] 錯誤，請勿使用。

注意事項與適用場景¶

錯誤處理：如果響應中不包含可用的結構化搜索結果，或者接口返回非 2xx 狀態碼，插件會返回 WEB_PROVIDER_ERROR。錯誤信息會原樣透傳。
查詢驗證：該端點（非插件配置）不會拒絕無意義的查詢，仍會執行搜索並返回結果。
計費：搜索費用計入 GLM Coding Plan。
兼容性：依賴 dsh >= 0.1.1-rc.2。
許可證：MIT License。

安裝前請檢查源碼與許可證。插件在當前 DSH 進程權限下運行，適合需要利用智譜 GLM 模型進行聯網檢索的開發者。

總結¶

經過上述配置，DSH 即可利用 GLM 的原生聯網能力。源碼與文檔可在 GitHub 查看。