升级 vendored Codex 至含 spawn 富卡的 stable(0.147+),点亮子代理模型徽标
- Dominant language
- TypeScript
- Stars
- 2.7k
- Forks
- 395
- Avg merge
- 21h 48m
- Merged PRs (30d)
- 776
Description
## 背景
Codex 子代理的按需委托默认与卡片可视化改造(分支 `dash/codex-subagent-defaults`,PR 待发)中,「子代理模型/思考强度徽标」的数据源受当前 vendored Codex 版本限制:
- 现用版本 **0.145.0**(`tools/codex/latest.json`)的 multi-agent v2 中,`spawn_agent` 只发瞬时 `SubAgentActivityItem`(仅 id/kind/agentThreadId/agentPath),**不含 prompt/model/reasoningEffort**;
- 上游 main 已改为 spawn 直发带 `model` / `reasoningEffort` 的 `CollabAgentToolCallItem`(富卡),但该改动**尚未进入任何 release**:已核实 `rust-v0.146.0`(2026-07-29)与 `rust-v0.147.0-alpha.4` 的 `codex-rs/core/src/tools/handlers/multi_agents_v2/spawn.rs` 均无 `CollabAgentToolCall`。
客户端侧已就绪:`AgentTaskCard` 的模型/强度徽标读 spawn 参数即点亮;translator 的 `subAgentActivity` 处理按 item id 去重,升级后自动让位给富卡路径,无需再改代码。
## 触发条件
上游 [openai/codex](https://github.com/openai/codex) 发布 **0.147 或更新的 stable**,且满足:
```
curl -sL https://raw.githubusercontent.com/openai/codex/rust-v/codex-rs/core/src/tools/handlers/multi_agents_v2/spawn.rs | grep -c CollabAgentToolCall # 应 >0
```
上游节奏约每周一个 stable(0.145→07-21,0.146→07-29),预计 2026-08 上中旬满足。
## 升级时的验证清单
- [ ] 目标版本 `spawn.rs` 含 `CollabAgentToolCall`(见上)
- [ ] 配置键无 diff:`features.multi_agent_v2.multi_agent_mode_hint_text`、`features.multi_agent_v2.expose_spawn_agent_model_overrides`、`agents.*`(enabled / default_subagent_model / default_subagent_reasoning_effort / max_concurrent_threads_per_session / max_depth)——两个 struct 均 `deny_unknown_fields`,字段改名会导致 spawn 注入失败
- [ ] translator 协议 diff 过一遍(重点 multi-agent 相关 item 类型与字段;0.145→0.146 期间已知有 `wait` / `wait_agent` 两代工具名并存现象)
- [ ] 按需委托 hint(`MultiAgentMode::Custom`)生效路径实测(rollout `turn_context.multi_agent_mode`)
- [ ] 更新 `tools/codex/latest.json` pin + 各平台 sha256,跨平台回归(macOS / Windows)
## 预期收益
- 子代理启动卡显示「模型 · 思考强度」徽标(如 `gpt-5.6-terra · 低`)
- spawn 走 collab 富卡生命周期(running → completed,带线程状态摘要),替代当前"即时收口"的简化卡
- 吃到上游 7 月末以来的 multi-agent 修复
Contributor guide
Research direction
Wait for a stable Codex 0.147+ release, then inspect its multi_agents_v2 spawn.rs for CollabAgentToolCall and compare the translator's multi-agent item types and fields. Update tools/codex/latest.json and platform SHA-256 pins, verify the listed configuration keys and custom multi-agent hint path, then run macOS and Windows regressions to confirm rich-card badges and lifecycle behavior.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust, typescript
- Domain
- devtools, tooling
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 38/100