前言¶
在使用 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，不消耗额外配额。
