Skip to content

Releases

v3.2.0:Codex 当主会话、执行机同步支持 SSH

Choose a tag to compare

@lordfine lordfine released this 17 Nov 06:44

这一版让只有 Codex 的人也能用:Codex 当主会话,派原生子代理和 Orca worker;同步配置到执行机从只支持 WSL 扩到 SSH 远程 Linux。Claude Code 的现有用法不变,只用 Claude Code、没写新配置的老用户读到的规则意思没变。

Codex 当主会话

  • 之前:安装器只装 Claude Code,--codex 只是把技能多拷一份到 ~/.agents/skills,Codex 里没有角色,子代理全跟着主会话的模型跑。
  • 现在:安装器按本机装了什么自动选宿主(--宿主 claude-code|codex|both,旧的 --codex 等同 both)。给 Codex 装时,从同一份 agent 正文生成 ~/.codex/agents/<角色>.toml,只写名字、说明和角色说明,不写模型和档位;只读角色的正文前加一段只读前言。dispatch-retro 在 Codex 里只能显式调用。Codex 0.166 实测:派 explorer 时传的模型和档位照传,子代理按它跑,角色前言也加载了。

个人配置

  • 之前:个人配置在 ~/.claude/派活配置/,只有 Claude Code 用得上;各角色用什么模型只能靠 agent 文件和 magpie 路由组。
  • 现在:新位置 ~/.dispatch/,安装器的备份也放这里(~/.dispatch/备份/)。没有 ~/.dispatch/config.toml 时照样读旧位置,不用搬。新增 config.toml(个人)和项目根的 .dispatch.toml(项目,覆盖个人),每个角色可写走原生还是 Orca、宿主、模型、档位,都可以不写。脚本/生效配置.py 列出合并后的结果和每项来源,写错的地方会指出来。只有 Codex 的人,安装器写一份默认配置。

体检

  • 之前:没装 magpie、Orca 的人跑体检一片报错。
  • 现在:没装的工具跳过并说明;检查配置.json 没有时用默认值;新增“派活配置”一项,校验 config.toml 和 .dispatch.toml。

执行机同步

  • 之前:只有 WSL/同步配置到WSL.py,在 WSL 里跑、一跑就写,没有预览,也不支持远程 Linux 机器。
  • 现在:主机上跑 脚本/同步执行机.py <名称>,执行机登记在个人配置的 执行机.toml,支持 WSL 和 SSH 两种传输。默认只预览;--执行 先备份到目标机 ~/.dispatch-同步备份/ 再写,写入中途失败时打印手动恢复步骤,写完调一次模型验证(只报告,不回滚);--装CLI 预览或安装和主机同版本的 Claude Code、Codex,不用 sudo,单项最多等 30 分钟,前一项失败时后面的标“未尝试”。按固定清单同步,SSH 上认证文件、私钥、浏览器登录态、缓存、历史会话、hooks 永远不复制,链接解引用后命中这些的也跳过并报告;SSH 上只带 HTTP/SSE 类 MCP,敏感请求头和 env 用目标机已有的值;代理类环境项(NO_PROXY 等)跟随目标机,不从主机带过去;个人配置里的 备份/ 不复制;回环网关地址换成执行机能连的地址。旧入口还能用,内部改调新实现。

文档

  • README、使用指南、设计决策、实测记录按两种主会话重写:使用指南加“Codex 当主会话”一节;设计决策补两种主会话共用一套正文、Codex 角色不写模型、只读靠核对、个人配置搬家、执行机同步的取舍;实测记录加 11-16 到 17 这一轮。
  • 手册改成两种宿主通用,新增 参考/宿主差异.md(技能和角色装在哪、模型和档位怎么传、Codex 下只读怎么核对、怎么核对实际模型)和 Codex 用的 AGENTS.md片段.md。角色正文里只有 Claude Code 才有的工具名改成两边通用的说法。派活记录加“宿主”“实际模型”两栏。

其他

  • 安装器收尾提示按实际个人配置位置说:已经有个人配置的,打印它在哪、提示可以复盘,不再提示初始化引导。

升级:git pull 后重跑 python 安装.py,个人配置原样保留;从 v3.1 及以前升级见 docs/安装与自定义.md。

v3.1.0:测试分工、推理档实测、模型落点、返工链与规格自查

Choose a tag to compare

@lordfine lordfine released this 15 Nov 21:37

这一版来自一次实际项目的复盘:一个实际项目三周里派了 138 张票。问题集中在测试拖垮本机、推理档位传了不生效、子代理悄悄落到最贵的模型、返工链串不起来、用量统计被污染这几处。

测试分工

  • 之前:大档票要求 worker 交付前自己跑全量,几个 worker 同时跑,本机卡到没法用;交付里只有一个“测试结果”,实现做完、只是测试没过也记成“失败”,复盘分不清是谁的问题。
  • 现在:worker 只跑定向测试,全量一律由主脑在 worker 会话外用排队脚本跑,被占就记进待补清单,不让 worker 等。交付模板拆成“实现 / 门禁 / 全量”三栏。改部署、回退或迁移的批次,集成后加一轮跨票审查,再用真实数据库导出副本跑“升级—回退—再升级”。

推理档位

  • 之前:手册只说“原生子代理不传 effort”,没说清楚怎么才能让子代理用更高的档,大家各自猜。
  • 现在:实测写进手册。具名角色的档位钉在组成员上,调用时传的不起作用;走 sonnet、fable 别名时,按 magpie 里该别名的 effort 发;工作流 agent() 把 model 写成带 levels 的角色组名再传 effort,会照传。Agent 工具的 model 只认别名,做不到这一点。

模型落点

  • 之前:没写 model 的子代理(general-purpose、不带角色的工作流子代理)在 subagent 档位没设时直接用主会话的 Opus,又贵又看不出来;有人给 worker 写 codex/<模型名>,绕过了组内兜底,落点检查也认不出角色。
  • 现在:手册写明子代理模型的取值顺序(调用参数 → agent 文件 → magpie subagent 档位 → 主会话模型),worker 的 --model 只写角色组名。落点检查会列出“直接写模型名”的会话和请求数,兜底偏高时附上实际模型明细。

用量统计

  • 之前:magpie 用量里 source=log 的日志导入行被当成派活请求算进兜底占比,数字偏高;订阅来源的每分钟名额满了以后,stays=turn 会让这一轮剩下的请求都留在兜底模型上,看起来像兜底失控。
  • 现在:落点检查过滤日志导入行;参考篇写明兜底的“粘滞”是正常现象,以及用量表里状态 0、时间是入队时间这些读数注意点。

返工链

  • 之前:新开 worker 返工时 Orca 不带续派标识,标题又各写各的,复盘时 138 张票的返工链一条都没串上;返工原因只有自由文字。
  • 现在:返工和续派的标题固定写成“批NN-票X 返工N”;规格开头加“本轮派给”一行,返工原因分三类(规格错 / 实现质量 / 门禁未过)。

规格质量

  • 之前:规格里写错文件路径或行号,worker 拿到才发现;几类反复出现的坑(收紧状态判断漏了写入点、改按钮文字没改浏览器用例、为跑通测试做的变通悄悄留在代码里等)每次都靠主脑记性。
  • 现在:规格模板加“派前自查”十条;新增 脚本/规格路径检查.py,派前核对规格里的路径和行号在基线上是否存在(只读;整行带“新建/新增”的会跳过)。

体检与执行机

  • 之前:worker 计数只看本机账上“running”的,派到远程执行机的 worker 被算成 0;组合文件里的别名档位和 magpie 实际不一致也查不出来。
  • 现在:体检分开报“本机账上 N(含派到远程机的)/ 远程机自己账上 M”,并对照 worker 上限;比对组合文件和 magpie 实际的别名 effort。参考篇支持登记多台执行机(本机 WSL 之外再加开发机)。

其他

  • 窄任务别派大:同一件事接着问用 SendMessage 续接,算术、计数本地算,诊断交付控制在 10 行左右。
  • 工作流里返回空(null)的审查员或核验者,那一块算“没覆盖”,不当成“没发现问题”。
  • 验收参考:Windows 侧加 import 冒烟;脚本和证据不放 /tmp;WSL 里没有浏览器扩展时用 Playwright。
  • Orca 参考更新到 1.4.258:去掉已失效的 fast 说明,worktree list/rm 要带 --environment,复用工作区不传 --name。
  • Codex 示例组合去掉 fast 后缀;别名 effort 和 subagent 档位改成和作者现状一致(都 medium、subagent 不设),并注释原因。

v3.0.0:拆成三个技能、初始化引导与复盘迭代、个人配置分离

Choose a tag to compare

@lordfine lordfine released this 09 Nov 08:20

这一版把“一份大手册”拆成框架加个人配置,并加了初始化引导和复盘迭代。

结构

  • 手册按渐进加载拆开:dispatch/SKILL.md 只留决策规则,Orca、远程执行机、验收与测试、组合与路由、配合其他技能各一篇参考,用到才读。入口约 13KB,比 v2 的单份手册少四分之一,没有 WSL 的人也不用再读 WSL 那一篇。
  • 新增 dispatch-retro:初始化引导(探测机器和工具、问偏好、生成个人配置)和定期复盘(读反馈和用量,给推荐由用户决定,框架问题起草 issue)。
  • 新增 dispatch-feedback:项目会话按问题、代价、证据、建议、归属五栏写反馈。
  • 个人配置搬到 ~/.claude/派活配置/(DISPATCH_CONFIG_DIR 可改),框架升级不碰它;脚本找不到时回落到旧位置。
  • 新增 安装.py:只动框架文件,替换前备份,保留用户改过的 agent,--codex 同时装给 Codex。
  • 仓库目录改成顶层 skills/、agents/,原 claude-code/ 目录取消。

规则

  • 新增 impl-lite 组,给清单式的确定性活;三个实现组只是分组定义,放什么模型由个人组合定。
  • 推理档按任务类型的矩阵选,确定性的活允许交付后按明确反馈补一轮;资源紧时依次减并发、降推理档、换常规模型,最后才减审查,验收标准不降。
  • 规格模板 模板/规格.md:开头四行(风险档、确定性、推理档、返工原因),末尾带实现者固定规则;四栏里补“必须保留的现有能力”和“不新增持久状态或机制”。
  • 验收:返工两轮还冒相邻新问题就停下对比基线;冻结线;审查发现默认由一名独立核验者复现(试行);收紧类改动 grep 全部调用方测试、集成后跑全量;安全类大档票的安全轴逐条核“只许收紧”。
  • 改全局语义的票单独先发、合入后马上跑全量;一批 5~6 张票。
  • worker 被上游 429 打断会静默停住:报进度前先读终端尾部。
  • Claude Code 别名档位按大小排:fable、opus、sonnet、haiku,各自用途写在组合文件里。
  • 每分钟请求上限按账号共用,名额满时 magpie 会让给非订阅兜底,兜底占比高先查这个。

测试与脚本

  • 新增 脚本/全量排队.sh:一台测试机同一时间只跑一个全量,--no-wait 被占退出 75;每次运行给一个不同的 FULL_TEST_RUN_ID。
  • 大档票和改全局语义的票交付前跑一次全量;参考篇写了全量提速的判断方法(先看加进程有没有用,再上模板库、处理拖尾)。
  • 体检加了 Orca 版本变化提醒、组合一致性(含别名档位)、扩展检查;落点检查可挂 Orca 定时任务,只弹通知。
  • WSL衔接.py:Windows 和 WSL 两份检出之间取分支、合并、取回 Windows,先 --演练。
  • 真实 WSL 往返测试改为读 DISPATCH_TEST_WSL_DISTRO,没设就跳过。

安装或升级

  • 新装:git clone 后运行 python 安装.py(Linux / macOS / WSL 用 python3),装完新开会话说「初始化派活」。
  • 从 v2 升级:先把个人改过的组合和 本机/ 下的文件拷到 ~/.claude/派活配置/,再重跑安装脚本,详见 安装与自定义。

v2.0.0:角色路由组、可切换组合与 WSL 支持

Choose a tag to compare

@lordfine lordfine released this 06 Nov 10:44

这是一次体系级改动:agent 的模型字段从具体的路由组名改成了"角色路由组",从 v1 升级时需要按新文档重新建组。

主要变化

  • 角色路由组:7 个 agent 和 Orca worker 的模型都改成按用途命名的组(group/explore、group/research、group/review、group/impl 等),组里放哪些模型由"组合"决定,agent 文件以后不用再改。
  • 可切换的组合:组合就是"每个角色组里放谁"的一份清单。仓库带了两份示例(国产模型组合、Codex 组合)和一个跨平台切换脚本,可以照着格式写自己的组合。
  • 推理档位:示例配置只用 medium / high / xhigh 三档,并记录了一个坑:成员没钉档位时,如果请求的档位网关不支持,这个成员会被跳过,整轮落到兜底成员上。文档里给了 :medium+high+xhigh 和组级 levels= 两种写法。
  • WSL 支持:两种用法。一是 Windows 主会话通过 Orca 的 SSH 远程服务器,把 worker 派进 WSL 的 ext4 检出;二是直接在 WSL 里开主会话。配置共享用链接,再加一个同步脚本生成 settings 和 MCP 配置。
  • 文档改成通用写法:并发、档位、模型搭配都写成"原则 + 示例值",实测结论都注明了测试环境。

升级

参照 安装与自定义 和 magpie/路由组与档位.md,按顺序做:建档位组、替换组合文件里的来源占位符、跑一次切换脚本、更新 agent 文件,然后新开一个会话。