指南 / 现场笔记
一份工单出去，结果与证据回来。
从第一次委托，到本机 Dispatch 与分享卡：讲清日常用法、真正会发生什么，以及数据与权限的边界。
0.4 / COOPERATION ARCHITECTURE
派出去、接回来，再推进。
0.4 系列把完整责任、worker 自查、主脑帮助与原会话续做放进同一条协作路径。主 agent 保留目标和验收判断；原生执行由 Codex 宿主负责，可选 ACP 运行器补上 session、回执、交付收集和有限批量执行。
- MAIN AGENT
守住目标，组织分工
接到工程目标，按已有通道选择交出完整责任，写清边界与完成条件。
目标 · 工单 · 权限 - WORKER
自己检查，也自己修正
调查、实现、自查与普通返修留在同一责任里。遇到关键判断缺口，带着成果和精确问题回来。
调查 → 实现 → 检查 → 修正 - MAIN AGENT
接住证据，推进交付
查看实际成果、覆盖与冲突，定向检查疑点；条件达标后整合交付，需要帮助时补充判断。
实际成果 · 检查证据 · 最终交付
关键判断、补充条件或具体返修，优先继续原会话；有用的执行留在 worker 一侧。
主 agent 依据插件说明作判断；CLI 负责已授权的机械步骤。运行完成、worker 自述和工程验收分别是不同证据。Dispatch 是可选的 ACP 回执投影。
01 / 开始使用
插件负责调度；其它都可以后加。
先安装 Worker Routing 插件，让主 agent 收到何时委派、怎样交出完整责任，以及如何帮助、续做与验收的说明。原生 Codex workers 可以直接作为执行通道；ACP 与私人上下文 hook 按需添加。
- 让 Codex 内置的 plugin-creator 把 plugins/worker-routing 注册到你的个人 marketplace，保留现有主模型与 provider。
- 安装后新开一个主会话确认它真的加载了——注册成功不等于当前会话已生效。
- 它只改变后续调度：不接管请求，也不替你选模型或付费路线。ACP 执行通道与主会话上下文集成是两个独立可选项，需要时再配置。
02 / 委托与验收
交出一整块责任，而不是一条指令。
值得委托的是一块能独立收尾的责任：调查、修改、自测一起交给同一个 worker。工单写清目标、边界，以及完成时要交回什么。小任务或临近完成的工作留在主会话——交接也有成本。
修复空行导致的 CSV 导入失败。
范围：一个函数外加一个针对性检查。
补一个能复现该 bug 的检查，运行它，并交回 diff 与结果。
不要改动公开 API 或无关文件。
若修复必须越界，请停下来说明。- 需要修正时优先继续原会话；同一缺口经过两次明确返修仍无进展时，先重新决定恢复方式。
- worker 在授权范围内自行检查、修正普通错误并复验；既定条件达标就交付，遇到关键判断缺口时提出精确问题。
- 主 agent 按风险验收实际成果与证据；批量工作先看覆盖、关键结论与冲突，再定向展开疑点。worker 说「完成」仍是候选声明。
- 说「自己来」或「solo」，工作就留在主会话，主 agent 也应避免重复实现已经交出的责任。
03 / 可选 ACP 通道
外部通道可加可不加。
可以从一个默认小工开始，不需要比较模型或填写特长。先尊重已有通道选择：原生 worker 使用宿主工具；已登记的 ACP route 也可以是日常默认，使用自己的独立会话。
- route 配置、worker home、workspace 白名单、provider 与账号选择都留在 Git 外，由你掌握。
- 在现有 ACP 配置里设 routing.default，正常 run 就能省略 --route；换渠道只改这一处。routing.fallbacks 可留空，备用必须预先获准。
- 自动备用只处理启动前的入口不可用或必要环境凭据缺失。启动后先恢复原执行；改默认保留旧会话，明确停用旧渠道则阻止后续续做。
- 每次 run / continue 都必须显式带 --permissions read|full，省略会在派工前拒绝；不会继承上一轮。这个参数只决定 ACP 权限应答，不是 OS 文件沙箱。
- 超时或取消不能被迟到的完成结果覆盖；已有输出与清理状态分开保留。能启动 route 或列出模型，仍不证明真实推理成功。
- 复杂成果可选有界交付收集；已明确独立的责任可使用下方有限 batch 流程。需要恢复时，先核实原 session、回执和清理状态，再继续已有工作。
分工由主脑决定，机械步骤交给 CLI。
一份主 agent 编写的 order spec，连接工单准备、有限批量执行与增量读取。一个默认 worker 就能开始；只有已明确独立的责任才适合成批交出。
prepare整理工单机械生成 orders + manifest，不启动 worker。batch按资源准入执行检查授权与资源，在这一批内执行，逐项保存已结算结果。collect先读回来的部分只读已结算索引，不等整批结束；剩余责任继续保留。
ACP 运行器保留 session、回执与有界交付线索；worker 自述、实际运行状态和主脑验收分别判断。共享 HOME 的并发安全未知时，按该资源串行。
第一次试用可以交出一个小而完整的任务：改一个函数、补一个检查，再看真实 diff 与检查结果。
04 / 本机 Dispatch
回执自然留下足迹。
Dispatch 在本机呈现 ACP 回执与主动记录的复查笔记。业务数据只读；主题、语言和时区可以保存。它不安排工作，也不建第二套任务数据库。原生 Codex 活动在这里没有数据源——每个数字都明确只覆盖 ACP。
node integrations/acpx/src/cli.mjs dashboard --config /absolute/private/config.json
node integrations/acpx/src/cli.mjs stats --config /absolute/private/config.json --since 7d- 命令会在前台运行并打印一个私人 loopback URL（默认随机端口）；需要你自己打开该 URL 并保持进程运行。第一次派发 ACP 任务之前，面板打开时是空的，这是预期行为。
- 统计口径：运行完成不等于工程验收；已观测 tokens 是已知工作量，不是省下的 Codex 额度，也不是计费证据；缺少用量保留为未知而非零。
- 项目按实际工作目录找回：本机 Git 仓库把链接的 worktree 归入同一仓库，另有文件夹过滤；这不是 Codex 保存的项目名，也不用聊天文本推断身份。
- 用量覆盖度指出多少任务有可归属数据；普通完成或关闭不需标注，也不产生待办。
05 / 分享卡与隐私
自己做主的一张小卡。
分享卡预览 1600×900 横版与 1080×1350 竖版，可导出 SVG 或 PNG。主题、中英文、版式各自独立：四种主题 × 两种语言 × 两种版式 × SVG/PNG 共 32 种组合，文件名带主题、语言、格式与日期。
- 分享卡入口在面板页首的「分享小卡」按钮。
- 数字笔触可选 Soft / Book / Mono，装饰可选 Thread / Bloom / None；手绘装饰只来自本地 SVG。
- 文案从四组双语预设起步、可自由编辑；另有可选署名。这两项是你主动输入的展示文本，以纯文本转义后进入图片，绝不会从私人记录或账号身份推断。
- 统计部分只接受汇总数字、时间范围、时区与覆盖度；工单、输出、私有 route 名、路径与内部 ID 不会自动填入卡片，也不会自动上传。
草稿只留在浏览器内存、刷新即重置，与持久化的本机展示偏好分开——只有主题、语言与时区会被保存。
06 / 上下文与边界
这是输入装配边界，不是文件沙箱。
可选的主会话集成用原生 SessionStart hook，在第一个 root 请求之前加载你的私人说明，只注入 root；新 worker 不继承主对话历史。主上下文必须先于首次 root 请求到达，新委托才保持 root/child 输入边界。
- hook 只作用于 root，需要你 review 并信任；安装器不会改写 AGENTS、自动批准 hook，或改动模型与 provider 配置。
- 共享工程规则仍可能随宿主到达 worker——「共享规则」不等于把文件访问限制在某个目录；路由配置本身不提供隔离。
- 文件权限由宿主与 sandbox 决定，这套机制不会阻止已获准使用文件工具的进程读取本机其它文件。
接入后，在新会话中确认主 agent 收到了完整说明，再用一份不含私人内容的小工单检查 worker 的输入。完整安装文档提供验证与恢复步骤。