前言¶

DeepSeek Harness (DSH) 的核心能力在於插件化擴展。當開發者需要在 DSH 流程中使用 z.ai 的 GLM Coding Plan 相關能力時，通常需要手動對接 MCP 服務器。dsh-plugin-zai-mcp 插件通過 DSH 內置的 @deepseek-ai/dsh-mcp-client 橋接層，將 z.ai 的四款 MCP 服務器（視覺、網頁閱讀、網頁搜索、zread）封裝爲原生 DSH 工具。

插件定位¶

該插件由用戶 nekomona 維護，屬於“模型推理”類別。它不包含構建步驟，通過聲明式配置即可接入 DSH 的插件生態。

核心能力¶

插件將 z.ai 的 MCP 服務器轉化爲 DSH 工具，共計 13 個工具。工具調用會消耗 GLM Coding Plan 配額。

1. zai-vision
   - 傳輸方式：stdio
   - 工具：

   • analyze_image
   • analyze_video
   • ui_to_artifact
   • extract_text_from_screenshot
   • diagnose_error_screenshot
   • understand_technical_diagram
   • analyze_data_visualization
   • ui_diff_check

2. zai-web-reader
   - 傳輸方式：streamable-http
   - 工具：

   • webReader

3. zai-web-search
   - 傳輸方式：streamable-http
   - 工具：

   • web_search_prime

4. zai-zread
   - 傳輸方式：streamable-http
   - 工具：

   • search_doc
   • get_repo_structure
   • read_file

安裝¶

插件支持從 Git 源安裝，DSH 會自動處理 dsh.profile.bundles 配置。

dsh plugin --profile web add "github:nekomona/dsh-plugin-zai-mcp"

配置與 Key 管理¶

插件默認零配置。如果 DSH 已配置 GLM coding-plan key，插件會自動重用該憑據。

API Key 的解析順序如下：
1. config.apiKey
2. 環境變量 Z_AI_API_KEY 或 ZAI_CODING_CN_API_KEY
3. DSH 的託管憑據存儲

Key 僅用於讀取，絕不寫入磁盤或日誌。若需自定義，可配置 apiKeyEnvNames 或直接設置 config.apiKey。

注意事項¶

• 雲端依賴：所有工具調用均通過 z.ai / Zhipu 的服務（open.bigmodel.cn）完成，發送給工具的 URL、圖片、視頻等數據都會經過這些雲端服務。
• 配額限制：工具調用消耗 GLM Coding Plan 配額。
• zread 限制：zread 僅支持 zread.ai 索引的公開倉庫，無法讀取私有或未索引的代碼庫。
• 視覺限制：zai-vision 處理本地媒體文件時，大小限制爲 8MB。
• 許可證：當前未明確列出許可證（uncertain）。

總結¶

該插件爲 DSH 用戶提供了無需手動配置 MCP 客戶端即可使用 z.ai 服務的途徑。更多技術細節和源碼可參考其 GitHub 倉庫。

• 插件目錄：https://www.skillhub.cn/plugins/nekomona/dsh-plugin-zai-mcp
• GitHub：https://github.com/nekomona/dsh-plugin-zai-mcp