前言¶
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
