前言¶
在使用 DeepSeek Harness (DSH) 構建智能體時，接入外部模型通常依賴 API 密鑰。然而，ZCode (Z.ai) 桌面應用提供的某些配額（例如 Weekend Build 中的 300,000,000 個 GLM-5.3-Flash token）在客戶端自身的目錄中被聲明爲賬戶綁定（"access": { "type": "zhipu-account", "mode": "start-plan" }），沒有可提取的 API 密鑰。嘗試直接使用平臺路由會因驗證碼問題失敗或返回“餘額不足”。
該插件通過 Chrome DevTools Protocol (CDP) 驅動 ZCode 的桌面應用 GUI，讓客戶端自行完成請求籤名和認證，從而讓 DSH 能夠通過一個本地 OpenAI 兼容端點使用這些賬戶綁定配額。
插件定位¶
- 名稱：DSH ZCode Connector
- 所有者：ZhaoAndy821
- 類別：模型推理
- 許可證：MIT
核心功能¶
- GUI 驅動：通過 CDP 驅動 ZCode 桌面應用的 GUI，模擬真實用戶的點擊、輸入和讀取操作。
- OpenAI 兼容端點：提供一個本地服務，接收
POST /v1/chat/completions請求，將提示詞輸入 ZCode 窗口，等待回覆並返回結果。 - MCP 服務器：提供 MCP stdio 服務器，暴露狀態、後臺運行、提問和配置工具，供 MCP 客戶端（如 DSH）使用。
- 狀態讀取：從 ZCode 的文件系統讀取客戶端狀態（如代理設置、工具調用、子代理運行情況），並在面板中展示。
工作原理與行爲¶
插件不通過僞造 API 密鑰來獲取配額，而是讓 ZCode 客戶端完成實際工作。
- 客戶端簽名：ZCode 的渲染器會爲每個請求生成簽名，這與用戶手動點擊發送時的路徑一致。
- 真實控件操作：橋接層通過 CDP 觸發真實的控件事件（點擊、輸入文本），不涉及內部隱藏接口。
- 憑證安全：賬戶 Token 僅用於讀取計劃 API 以顯示剩餘配額，絕不離開系統或記錄到日誌中。
- 會話模型：設計爲一次會話一次對話，避免併發調用或重試風暴。
- 窗口狀態：窗口不需要可見、聚焦或置頂，只需在後臺運行。插件通過 CDP 操作的是渲染進程，而非 OS 窗口堆棧。
狀態監控與面板¶
插件會在 DSH 右側側邊欄提供一個 HTML 面板，實時顯示：
* 賬戶與計劃信息
* 實時配額（Quota）
* 已加載的能力
* 運行中的子代理（Role、任務、工具調用路徑、耗時、Token 消耗）
* 已完成的子代理結果（狀態、時長、工具數）
* 生成指示器與自動化調度任務
通過 MCP stdio 服務器，這些狀態信息也可被其他 MCP 客戶端讀取。
安裝與啓用¶
該插件託管在社區目錄中。安裝時請確保從可信來源獲取，並檢查源碼與許可證（MIT）。
- 插件目錄：https://www.skillhub.cn/plugins/ZhaoAndy821/dsh-zcode-connector
- 源代碼：https://github.com/ZhaoAndy821/dsh-zcode-connector
適用場景與注意¶
- 適用場景：需要使用 ZCode 賬戶綁定配額（如特定計劃或促銷額度）進行開發或測試，且不希望依賴不可靠的第三方代理服務的開發者。
- 重要注意：
- 憑證僅用於顯示：插件讀取的 Token 僅用於展示配額，絕不離開本地系統。
- 一次對話：當前設計限制爲一次會話一次對話，不支持多輪並行。
- 被動讀取：狀態監控通過讀取文件實現，不主動輪詢 GUI，不消耗額外配額。
