Overview
dsh-tandem
README / EN
Package documentation
Registry summary
dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known limitations
- Codex 非 tty 时输出会被吞,所以日志直接写文件(结果里给日志路径)。 - 「退出码 0」不等于干完活:偶发空跑(进程正常退出、日志只有头部和 prompt、文件没动)。已用完成标记兜住并重派一次,但它只是启发式判定,最终仍要靠 `checks` 自己核验产物。 - 上游缓存命中率不可控(实测 0~80% 波动),同一任务重复跑成本不是线性的。 - 超时按整棵进程树杀,避免 codex 子进程残留。 - `checks` 的命令用 shell 执行,语义随平台而定(Windows 是 `cmd /c`);总时限到点后剩余检查直接判失败。 - `tandem_consult` 用 `read-only` 沙箱,它物理上改不了文件——这是刻意的。 代价:Windows 上 `read-only` 沙箱会把**读取也拦住**(`exec_command ... rejected: blocked by policy`,连 cwd 里的文件都读不到),`cwd` 参数因此在本机不起作用。要让 Codex 会审一个真实项目,就把关键文件的内容拼进 `context` 传给它——实测这样效果正常。这个怪癖只在 Windows 的 Codex 沙箱上出现。 ### 与 Codex 0.163 的兼容性(2026-10-18) - **必须 `--disable multi_agent`**:0.163 默认开启多 agent 协作工具,非交互 `exec` 下模型会调用 `collab wait`(等待一个不存在的子线程)然后永久挂起。实测一条 2K 字符的评审 prompt 挂 172 秒无输出;关掉后 27 秒正常返回。 - **必须 `-c mcp_servers={}`**:桌面端配置的 MCP 服务器(node_repl / computer-use)在非交互 exec 里反复启动失败,把一个 12 字节文件的活拖到 90~130 秒;只覆盖本次进程后降到 25 秒,且不改用户的 `~/.codex/config.toml`。 ### 一个刻意的取舍:不做「跑完比对哪些文件被改」 只保证**各任务目录互不重叠**(重复、互相包含、越界都拒绝),不做运行前后快照对比。 原因是快照这条路两头都不讨好:并行任务和外部进程都会在同一个审计窗口里改文件,快照只能看到「差异」、看不到「谁改的」,归因错了就是误报;而 `mtime + size` 的粒度还会漏掉同尺寸改写。误报和漏报同时存在时,这个字段只会变成噪音,不如只保证「互不重叠」这个能确定的事实。 真需要知道改了哪些文件,就在 `checks` 里让任务自己 `git status --short` 并把输出写进产物。
