Claude Code 插件。Claude 当工头：把一件想清楚的开发任务派给本机 ZCode（GLM）， 在 worktree 里隔离执行，用 git diff 和测试客观验收。
状态（2026-10-14）：第一版完成并已适配 ZCode App 3.12.2 起的版本（decisions D14；2026-10-14 在 App 3.15.3 上零 token 核对全过、3.14.5 上花额度冒烟全过，见 verified.md）；插话改走 v4/command（D17）；接上账号型 Coding Plan（凭据文件来源，D19）；闲时投递与 quota（D20）随 v0.3.5 发布，start plan 投递撤而复开（D21，2026-10-09 服务器撤了人机验证后拣回）；v0.4.0 加观察面板：watch 子命令加 Claude Code mod（hooks/，D22），v0.4.1 回复按 Markdown 显示、超过两行可展开，v0.4.2–0.4.3 修长命令把工具名挤成两行、撑破卡片边框。2026-10-08 按外部安全审计加固闸门（越界判界照内核走法、闸门自保、任务单快照等，decisions D23，随 v0.5.3 发布）。npm test 803 个用例。
术语在 docs/CONTEXT.md。本地开发记录（docs/handoff/、docs/tasks/、docs/PLAN*.md、docs/archive/、docs/SPEC-offpeak.md、docs/SPEC-watch-pane.md、docs/jev-*-plan.md、docs/research/）不进 GitHub，只在开发机上有；
有它们就从 docs/PLAN-v4.md 与 docs/handoff/handoff-20260908.md 接手，没有就从 README 与 docs/PRD.md 开始。
| 层 | 位置 | 职责 |
|---|---|---|
| 协议 | lib/appserver.mjs lib/session.mjs lib/providers.mjs lib/offpeak-provider.mjs lib/startplan-provider.mjs lib/scrub.mjs |
拉起 zcode app-server --stdio，JSON-RPC 请求配对与反向请求路由，会话生命周期，回合结束判定 |
| 工作流 | lib/config.mjs lib/credentials.mjs lib/offpeak.mjs lib/offpeak-check.mjs lib/offpeak-send.mjs lib/offpeak-run.mjs lib/startplan-send.mjs lib/startplan-run.mjs lib/registry.mjs lib/models.mjs lib/tiers.mjs lib/runs.mjs lib/queue.mjs lib/run.mjs lib/intent.mjs lib/tool-summary.mjs lib/snapshot.mjs |
配置、登记簿、等级分配、队列与锁、runner 的一生、runs/<id>/ 落盘、本回合解析与会话快照 |
| 闸门 | lib/gate.mjs lib/pending.mjs lib/review/ |
红线 → 模型审批（workspace/generateText）→ 挂起等人 |
| 外壳 | bin/zcode-executor lib/cli/ skills/zcode-executor/ templates/ hooks/ types/ |
CLI 与 skill；hooks/ 是只在 Claude Code 里生效的观察面板 mod（decisions D22），运行环境没有 Node、不 import lib/，数据只从 watch 子命令来；types/ 是 mod 状态的类型声明，给 claude plugin validate 核对用。MCP 外壳按需后加 |
跨层共用的只有 lib/errors.mjs（ExecutorError）。
项目只接 zcode，协议层直接说 app-server 的 JSON-RPC，中间没有 ACP。
- 验证协议先走零 token 路径（握手、create、list、close）。每一次
session/send花真实额度。 - 模型审批只产出放行或转人工；拒绝同样退回人工。人工由 Claude 用 AskUserQuestion 转交。
- 用词照
CONTEXT.md：会话、任务单、投递、回合、审批请求、提问、红线、模型审批、挂起、模型等级、思考等级。 - 纯
.mjs，零运行时依赖，不加构建。 ~/.zcode/v2/config.json与~/.zcode/v2/credentials.json只读：前者有明文 API key、App 会重写它；后者是 App 的加密凭据，只解账号型 coding plan 要的四个键（D19）和闲时投递要的zcodejwttoken（D20）。两处读到的 key 只落 D14 的临时个人 provider 文件；JWT 只进内存与 JSON-RPC 参数，不落盘。- 从 zcode-acp 搬来的代码保留 Apache-2.0 版权声明，记入
NOTICE。 - 排障看
~/.zcode/cli/log/zcode-YYYY-MM-DD.jsonl。JSON-RPC 错误的细节在error.data.details，message只有一句概括。 - DSH 插件定义在根
package.json（dsh字段 +cordis.patch.yml），npm 包名即插件，桌面端插件页直装；dsh-plugin/是其 TypeScript 源码与构建产物（lib 入库），2026-10-11 subtree 并入，旧 Gitea 仓库冻结。与 CLI 唯一耦合是watch --json行协议。开发、测试见其 docs/dsh-plugin.md 与目录内 README；peer 依赖全部 optional，CLI 全局安装保持零依赖。
版本号只在 package.json 里改，其余位置（两份 README 的版本徽章、.claude-plugin/plugin.json、.codex-plugin/plugin.json、
.github/plugin/plugin.json、.grok-plugin/plugin.json、gemini-extension.json、plugin.yaml）由 scripts/sync-doc-version.mjs 同步，
挂在 npm 的 version 生命周期脚本上；npm test 里的 --check 漏同步就挂。文档里的标记挪了位置要改那个脚本，找不到标记它直接非零退出。
两份 README 测试徽章里的用例数不在同步范围，用例数变了要手改（还有 README「开发」一节和本文件开头的状态行）。
npm version patch # 改 package.json + 同步版本号 + 建 commit 和 v* tag；加功能用 minor
git push --follow-tags # 推 tag 才是触发器.github/workflows/publish.yml 按 tag 跑：测试 → tag 与 package.json 版本一致 → npm publish
（Trusted Publishing，OIDC 无令牌）→ 建 GitHub Release（--generate-notes，提交信息就是 changelog）。
人工配置只有一处：npmjs.com 包设置里登记可信发布者 kyomio/zcode-executor + 文件名 publish.yml。
ci.yml 在推 main 和 PR 时跑测试（Node 22 与 24）。
- 要做什么、CLI 长什么样、闸门怎么走 → docs/PRD.md；实现与测试决定、用户故事 → docs/SPEC.md
- 写代码前 → docs/RULES.md（风格、注释、输出、落盘、测试、提交）
- 现在做到哪、下一件是什么 →
docs/PLAN.md（本地记录，不进仓库） - 接手开发、看背景 →
docs/handoff/handoff-20260908.md（本地记录，不进仓库） - 改插件清单、marketplace、安装方式 → 记忆库里「Claude 插件 marketplace 规范」（
search_memories），官方页面 code.claude.com/docs/en/plugins-reference - 写协议层，或碰到 app-server 的方法、事件、反向请求 → docs/reference/zcode-app-server-protocol.md，再对照 docs/verified.md 里的本机实测
- 想改定位、换协议、放宽审批、改名 → 先读 docs/decisions.md 里的理由
- 需要参考实现 → docs/decisions.md D2 提到的 zcode-acp（
npm pack zcode-acp-server）