配置

默认值 → ~/.dsh/tandem.json → 插件 config，后者覆盖前者。见 config.example.json。

{
  "codexCommand": "codex",
  "model": "gpt-6.1-sol",
  "maxParallel": 3,
  "workRoots": ["D:/dsh/work"],
  "taskTimeoutMs": 300000,
  "requireCompletionMarker": true,
  "stateDir": "D:/dsh/config/dsh-tandem/state",
  "envKey": "PORTDAN_API_KEY"
}

codexCommand：留 codex 即可，插件会自动探测 npm 全局安装位置，并优先用 .exe（Windows 下 spawn .cmd 需要额外包一层 cmd.exe）。
workRoots：允许派活的目录白名单——插件会拒绝工作根之外的 dir、互相包含或重复的 dir。注意它限制的是「任务从哪儿起步」，不是文件写入范围：Codex 以 danger-full-access 运行（Windows 沙箱实测会把 workspace-write 静默降级成只读，改不了文件），所以白名单挡得住手滑与误配，挡不住任务提示词里明目张胆的越界写入。要真正限制写入，得在 checks 里自己核验产物路径。
maxParallel：上限 3，实测超过 3 会被上游挂住。
requireCompletionMarker：默认 true。Codex 退出码 0 之后，还会检查日志里有没有它固定打印的 tokens used 完成标记，没有就判「空跑」并按失败重派。实测过同一份 prompt 一次 37 秒空跑（退出码 0、一个文件没改）、一次 117 秒正常改完，光看退出码分不出来。这是人类可读输出、不是稳定接口，换版本后若失效就设成 false。
- 0.163 的结尾格式变了（2026-10-18 实测）：tokens used 之后还有一段重复的最后消息，所以匹配允许标记后跟最多 4000 字符收尾文本，仍锚定日志末尾。

dsh-tandem

インストール

ドキュメント

配置