指南 / 现场笔记
一份工单出去，结果与证据回来。
从第一次委托，到本机 Dispatch 与分享卡：讲清日常用法、真正会发生什么，以及数据与权限的边界。
01 / 开始使用
插件负责调度；其它都可以后加。
Worker Routing 是一个只含说明的插件：它不创建模型、不保存 API key，也不实现 Codex 的多 agent 运行时。它给主 agent 判断规则——何时委托、交出什么、如何接回结果；可以从原生 Codex workers 开始。
- 让 Codex 内置的 plugin-creator 把 plugins/worker-routing 注册到你的个人 marketplace，保留现有主模型与 provider。
- 安装后新开一个主会话确认它真的加载了——注册成功不等于当前会话已生效。
- 它只改变后续调度：不接管请求，也不替你选模型或付费路线。ACP 执行通道与主会话上下文集成是两个独立可选项，需要时再配置。
02 / 委托与验收
交出一整块责任，而不是一条指令。
值得委托的是一块能独立收尾的责任：调查、修改、自测一起交给同一个 worker。工单写清目标、边界，以及完成时要交回什么。小任务或临近完成的工作留在主会话——交接也有成本。
修复空行导致的 CSV 导入失败。
范围：一个函数外加一个针对性检查。
补一个能复现该 bug 的检查，运行它，并交回 diff 与结果。
不要改动公开 API 或无关文件。
若修复必须越界，请停下来说明。- 需要修正时，优先在原会话继续，而不是新起一个 worker。
- 主 agent 交付前要检查真实 diff 与相关检查。worker 说「完成」只是它的结论，不等于工程验收。
- 说「自己来」或「solo」，工作就留在主会话，主 agent 也应避免重复实现已经交出的责任。
03 / 可选 ACP 通道
外部通道可加可不加。
可以从一个默认小工开始，不需要比较模型或填写特长。原生 worker 使用宿主工具；你也可以把已登记的 ACP route 设为日常默认，交给它自己的独立会话。
- route 配置、worker home、workspace 白名单、provider 与账号选择都留在 Git 外，由你掌握。
- 在现有 ACP 配置里设 routing.default，正常 run 就能省略 --route；换渠道只改这一处。routing.fallbacks 可留空，备用必须预先获准。
- 自动备用只处理启动前的入口不可用或必要环境凭据缺失。启动后先恢复原执行；改默认保留旧会话，明确停用旧渠道则阻止后续续做。
- 工单通过你可配置的 agent 传出去；--permissions read|full 只决定 cwr-acp 如何应答 ACP 权限请求，它不是 OS 文件沙箱，也不构成隔离。
- 能启动 route 或列出模型，不等于真实推理成功；初始化与执行是两个观测层。
第一次试用可以交出一个小而完整的任务：改一个函数、补一个检查，再看真实 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 的输入。完整安装文档提供验证与恢复步骤。