ZCode 派发台 Shuffle-1992/dsh-dispatch

DSH 派发台（dispatch）

一个 DeepSeek Harness（DSH）插件：把任务派发给本机 四个 AI 编程 CLI（ZCode / OpenCode / Qoder / WorkBuddy）的无头进程，并在 DSH 页面右下角的悬浮面板里监视它们。

DSH 自带的 subagent 跑的是 DSH 自己的智能体；本插件跑的是你自己的 CLI —— 独立进程、独立额度、独立会话。任务行出现在「DSH 派发台」面板里，可查输出、可终止、可续跑、可换通道重跑。

四个引擎

全部走官方 CLI：不反代、不模拟 OpenAI/Anthropic 兼容接口、不读写任何凭据内容 ——插件只负责「起进程 / 传参数 / 读 stdout」。四个引擎自动发现（env → 配置 → PATH → 已知安装位置 → 跨盘符扫描），不需要手填路径。

| 引擎 | 官方 CLI | 登录 | 额度 / 积分 |
| ZCode | zcode.cjs（桌面客户端自带） | 读客户端凭据 | ✅ 能查（含免费额度 Start Plan 通道） |
| OpenCode | opencode（PATH） | 免费模型无需凭据 | 免费（无额度概念） |
| Qoder | qoderclicn（PATH） | ⚠️ 需单独登录 | ⚠️ 积分制，无余额接口；单次消耗可查 |
| WorkBuddy | codebuddy（客户端内置） | ⚠️ 需单独登录 | ⚠️ 积分制，CLI 完全不暴露 |

拿不到的就不显示（不编数字、不猜汇率）—— 详见 四个引擎详解。

它做什么

| 能力 | 说明 |
| 派发（四引擎） | 把 prompt / 任务文件 / 目标描述交给任一引擎跑；build/edit/plan/yolo 四种模式仅 ZCode 支持 |
| 单写者互斥 | repo / 文件锁 + 进程内 FIFO 队列：同锁任务串行，冲突只排队不报错 |
| 实时监视 | 状态、耗时、Token 用量、上下文占用、积分/费用、退出码、锁持有者；可 tail 最近输出 |
| 续跑 / 重跑 | 同会话 --resume 重发原提示词，或发新指令（仅 ZCode 支持 resume） |
| 通道与降级链 | 切换通道 / 模型 / 思考强度；额度耗尽时按降级链自动交接重跑到下一个可用通道 |
| 分流模式 | 主通道名额满时把新任务自动改派到降级通道（两条通道并发名额叠加） |
| 思考强度核对 | 记录请求档位 vs 实际生效档位，不符时给出向上改档建议 |
| 引擎登录助手 | WorkBuddy 登录态四态显示 + 一键登录；登录服务温和终止、残留标记自动诊断 |
| 免费额度通道 | ZCode Start Plan：托管官方 app-server 走逐请求签名，与付费通道复用同一套流水线 |
| 用量聚合 | 本地台账 5 小时滚动 / 本周 / 今日，外加套餐剩余额度 |
| 派发总开关 | 一个跨会话真值文件：false = 任何会话都不得派发（runner / 插件 / 桥接三处强制生效） |
| 智能体工具 | 注册 dispatch 工具，与面板共用同一套动作实现（一操作两调用方） |
| 落地自动唤醒 | 任务落地（done/failed/killed/paused）时唤醒发起会话，与 DSH 后台任务同款 |

快速开始

安装（本项目不发布 npm，只从 GitHub 仓库装）：

dsh plugin --profile <你的profile> add "github:Shuffle-1992/dsh-dispatch#path:dispatch"

#path:dispatch 不能省 —— 本仓库是 monorepo，插件本体在 dispatch/ 子目录。

配置（runnerPath 与 workRoot 任一为空则不创建 dispatcher，面板走 demo 降级）：机器专有路径放 ~/.dsh/profiles/<profile>/cordis.patch.yml，按 id 覆盖。

完整步骤、配置字段全表、常见安装问题见 安装与配置。

文档

| 文档 | 讲什么 |
| 安装与配置 | 两种安装方式、字段全表、profile patch、常见安装问题 |
| 四个引擎 | 各引擎能力/额度、为什么走官方 CLI 而不是反代、实测并发上限 |
| 使用 | 悬浮面板、智能体工具动作表、派发优先级与三条硬规则、免费额度通道 |
| 凭据与 401 | ZCode 报「身份验证失败」的根因与修法 |
| 架构 | 目录结构、设计取舍、复跑证据、第三方材料声明 |
| 踩坑总账 | 每个真机坑的现场、根因、修法（最厚的一份，问题排查先查它） |
| 引擎细节与验收 | 引擎协议细节、登录、额度、验收清单 |
| DSH 0.2.1 兼容性审查 | 上游 API 兼容面 |
| 项目全面审查报告 | 外部审查的 13 项问题与修复记录 |
| 代码审查 2026-10-17 | 历史审查留档 |

交接与历史留档：docs/CREATOR-HANDOFF.md、 docs/NEXT-SESSION-HANDOFF.md、 docs/OPENCODE-DISPATCH-HANDOFF.md。

许可

MIT（见 LICENSE）。refs/ 下的第三方材料沿用其各自许可（详见架构文档的第三方材料声明）。