前言¶

在 DeepSeek Harness（DSH）里接第三方模型，常见做法是单独配 API Key 或自建网关。若你已经在 ZCode 桌面客户端里开通了 Z.ai / Start Plan，额度和管理界面都在 ZCode 侧，和 DSH 会话是两套入口。下面介绍的插件把 Start Plan 额度接进 DSH，以原生 GLM 模型提供方注册，并在 Web UI 里查看额度、签到与可领取计划，减少在客户端与 Harness 之间来回切换。

这是什么¶

dsh-zcode-start 由社区维护者 AkutagawaKoyori 发布，归类为模型推理类 DSH 插件。一句话定位：把 ZCode 的 Z.ai / Start Plan 额度带进 DeepSeek Harness，作为 GLM 模型提供方使用，并在 DSH 内管理额度与账号状态。

插件不替代 ZCode 客户端：它读取本机 ZCode 已登录后写入的凭据，向官方网关发起与客户端一致的推理请求；凭据不会写入插件仓库、日志或提交历史。

核心功能¶

模型提供方¶

注册提供方标识 zcode-start-plan，对外暴露 GLM-5.3-Flash 与 GLM-5.3（上下文 1M、输出上限 128k），支持 tool calling、流式 reasoning。推理强度与官方客户端一致，通过 output_config.effort 发送，可选 off / low / high / max。

设置页与额度¶

Web UI 中 Settings → ZCode 展示账号与 JWT 状态、额度进度条、由 API 拉取的模型能力表（非硬编码）、可展开的请求日志，以及 device-code 登录 / 登出。请求日志落在 ~/.dsh/zcode-plan-logs/，写入前会对 authorization、x-api-key 及含 token 的字段做脱敏。

可领取计划¶

支持手动 Check claimable；另有约 30 分钟一次的背景探测，发现可领礼包时在界面角落提示。

Agent 工具¶

插件向 Harness 注册工具：zcode_quota、zcode_claim、zcode_reset、zcode_chat、zcode_login，便于在对话或自动化流程里查额度、领取、重置、聊天或触发登录。

可靠性与错误¶

对限流、网关错误、空流等场景自动重试（指数退避，最多 10 次、总预算约 5 分钟）。网关约 28 种业务码及 HTTP 回退会映射为可读说明，并附带是否建议重试。

隐私与出站内容¶

出站文本会做 scrubbing：例如将 DeepSeek Harness 替换为 ZCode，并 neutralise harness 包名与命令名，避免上游 prompt 暴露 Harness 身份。插件本身不增加遥测。

前置条件¶

1. 已安装 DSH 并具备可用 profile。
2. 已安装 ZCode 桌面客户端，且至少成功登录过一次。插件从 ~/.zcode/v2/credentials.json 读取凭据，从 ~/.zcode/v2/telemetry-state.json 读取 device id。
3. 账号持有有效的 Z.ai / Start Plan 权益。

安装与启用¶

仓库在 package.json 中声明 dsh.bundle.patch 指向同目录的 cordis.patch.yml，因此可通过官方插件安装命令接入 Cordis 补丁。

dsh plugin add github:AkutagawaKoyori/dsh-zcode-start

若使用 plugin_manager 工具，可执行：

{ "action": "install_bundle", "target": "github:AkutagawaKoyori/dsh-zcode-start" }

本地已有插件目录时，将 target 换为绝对路径即可。安装完成后打开 Settings → ZCode；若模型列表里仍未出现该提供方，重启一次 harness 进程。

典型用法¶

1. 打开 Settings → ZCode，确认账号、JWT 与额度条；需要时可在此 device-code 登录或登出。
2. 在模型选择里选提供方 ZCode (Z.ai Start Plan)，再选 GLM-5.3-Flash 或 GLM-5.3，并设定 reasoning 等级。
3. 需要礼包计划时点击 Check claimable；背景探测也会在可领时出现角标提示。

与普通 DSH 会话相同：选定模型后即可对话；工具调用与流式 reasoning 行为由插件按网关能力适配。

适用场景与注意¶

适合谁： 已在 ZCode 使用 Start Plan、又希望把同一额度用在 DSH 智能体或本地 Harness 工作流里的开发者。

运行权限： 插件以当前 DSH 进程权限运行，会读取本机 ZCode 凭据并访问网关。安装前建议浏览 GitHub 仓库 源码与 MIT 许可证，确认符合你的安全策略。

文档中的其他说明（摘自 README）：

• identity.json 保存网关期望的官方 ZCode system-prompt 信封；缺失或格式错误时网关可能返回 code 3012。该文件不含用户数据，仅为运行时填充占位符的角色文本。
• claim 依赖进行中的活动；reset 需要付费 Coding Plan，否则网关原文错误会直接展示。
• 服务端尚未下发 granted plan 前，额度桶可能不显示；设置页会显示 granted 总量并标注「用量待统计」。

社区插件目录 SkillHub 上的 dsh-zcode-start 页 与 GitHub 为独立信息源，与 DeepSeek / 幻方无官方从属关系；安装与版本以仓库 README 为准（当前资料中 package 版本为 1.1.0）。

结尾¶

经过上面的步骤，你可以在 DSH 里把 ZCode Start Plan 当作常规 GLM 提供方使用，并在同一套 Web 设置里管理额度与登录状态，而不必为 Harness 单独再配一套 Z.ai 密钥。进一步了解功能与更新，可查看 SkillHub 目录页 与 GitHub：AkutagawaKoyori/dsh-zcode-start。