DSH ZCode Connect

中文 · English

把 ZCode 桌面 App 登录的 Coding Plan 模型零配置接入 DeepSeek Harness —— 不用粘贴 API Key，不用走 OAuth。注册 zcode-coding-plan 提供商，固定提供 GLM-5.3-Flash 与 GLM-5.3 两个模型。

配置与套餐状态在插件卡片里：设置 → 插件 →「ZCode Coding Plan」卡片——三窗口用量表（重置时间、重置券使用）、ZCode 主目录表单（保存即热生效）与模型目录。请求不限于目录内模型。

每次模型调用都以 ZCode 自带客户端的方式发出——相同端点、相同 key、相同请求头、相同请求体归因——因此 ZCode 与 DSH 的代码能力对比在真正相同的环境下进行。细节见 docs/behavior.md。

插件卡片

在 设置 → 插件 → 插件配置 中展开 ZCode Coding Plan。卡片内容从上到下固定为：

1. 套餐用量：三个额度窗口、重置时间、重置机会和两段确认的重置按钮；
2. ZCode 主目录（.zcode）：唯一可编辑字段，默认 ~/.zcode；清空后保存即重新继承默认值；
3. 模型目录：当前公布的两个模型；请求不受该目录限制；
4. 恢复默认值 / 放弃 / 保存：保存后实时生效。

卡片默认收起。home 存在 DSH zcode-plan 设置命名空间；凭证不会写入 DSH 设置。

剩余额度面板

点击输入框右侧的 ContextMeter 环形图后，在其 bW_panel 弹层内显示 ZCode Coding Plan 的三窗口剩余额度——与 ZCode 侧栏「剩余额度」同一数据源（bigmodel/Z.ai 监控端点，只读、无需签名）：

ZCode 额度 5小时 61% · 每周 89% · 工具 99%

悬停显示各窗口重置时间；host 侧 60 秒缓存。该查询完全独立于模型请求路径，不影响请求头对齐。

重置通知与重置机会

ZCode 的两种重置提醒这边都有对应物。额度窗口滚动时，host 对比相邻两次监控快照（某窗口的 nextResetTime 向前跳变即视为已重置——自然到点与在 ZCode 里用重置券触发的重置表现一致），输入框上方出现通知行：

✓ 5 小时额度已重置 · 已用 83% → 1%                    ✕

账号 JWT 保护的 reset 状态（ZCode 的「获得 N 次重置额度」提醒）同样接入：host 仅在内存中解密 enc:v1: 凭证值（AES-256-GCM，同机确定性密钥——细节见 docs/behavior.md），调用只读的 reset/status 端点，新券发放时弹出同样的横幅，额度面板常驻显示重置机会行：

✓ 获得 1 次重置额度 · 剩余 2 小时                    ✕
✓ 重置机会 5 小时 ×1（2 小时后过期）

点「✕」关闭即确认；ContextMeter 额度面板底部保留最近一条已确认的重置记录。全部复用现有 60 秒轮询。明文 token 不落盘、不进配置、不写日志；任何失败（凭证、端点、密钥）都只是静默隐藏重置机会行，不影响额度与模型路径。ZCode 升级改掉凭证方案时该功能自动降级消失。

在 DSH 里直接使用重置券：面板「重置机会」行内有「重置 5 小时 / 重置每周」按钮（ZCode 同款 reset/use 端点）。两段确认防误触——第一次点击变成「确认重置？」，3 秒内再点才真正发出；失败重试复用同一幂等键，服务端不会重复扣券。用掉一张券后额度窗口立即滚动，输入框上方会弹「额度已重置」通知。该按钮是本插件对 ZCode 账号唯一的写操作，只在你的点击下发生。

环境要求

• DeepSeek Harness Web GUI ≥ 0.1.2-alpha.1，使用 profile web
• Node.js ^22.19.0 || >=24.0.0
• 已安装并登录 ZCode 桌面 App，且 Coding Plan 有权

安装

# 若 lib/ 不存在（新检出）：先 pnpm install && pnpm run build
dsh plugin --profile web add "link:<绝对路径>/deepseek-harness-zcode_mask"

使用现有 DSH Web 进程；不要为本插件启动替代服务器。

dsh plugin add 会把包装进 DSH profile（它是在 profile 目录里执行的 pnpm 转发器）；lib/ 构建好之后，本目录无需单独 install。

提供商会以 ZCode Coding Plan 出现在 Models 页。ZCode 凭证按请求实时读取——在 ZCode 里换 plan、重新登录，下一次请求即刻生效。

卸载

dsh plugin --profile web remove dsh-zcode-connect

卸载不会修改 ZCode 主目录，也不会删除 DSH 会话；zcode-plan 设置值可能保留，重新安装后继续使用。

命令行

dsh plugin --profile web exec dsh-zcode-connect doctor   # 诊断（支持 --json）

隐私

模型路径读取三个 ZCode 状态文件（plan 缓存、提供商配置、设备 id）。可选的重置机会功能还会读取 credentials.json，仅在内存中解密 enc:v1:，绝不回写 ZCode 目录；唯一账号写操作是用户两段确认触发的 reset/use。细节和失败降级见 docs/behavior.md。

开发

pnpm install && pnpm run check   # 类型检查 + 测试 + 构建
pnpm run live-e2e                # 真实 API 冒烟

仓库工作规则维护在 AGENTS.md。GLM-5.3-Flash 支持图片输入（Anthropic base64 image 块）；GLM-5.3 仅文本。