[Bug][Codex V2] 子 Agent 自动字段为空：模型名与路由目录不一致时缺少诊断

[zhushihao]

Summary

在 Codex MultiRouter -> 子 Agent 页面里，当 profile 的 model 名称与当前路由投影的模型目录不一致时，“高级字段”中的自动值（角色名称、角色描述、开发者指令、昵称候选）会全部留空，同时 UI 没有任何 warning/error 提示原因。用户会以为配置为空或程序坏了。

Environment

• CCSwitchMulti: 3.19.2-18.4
• OS: macOS aarch64
• Function: Codex MultiRouter V2 / 子 Agent

Observed

这些 profile 的自动字段为空：

• deepseek-v4-flash-deepseek，而路由目录里是 deepseek-v4-flash
• deepseek-v4-pro-deepseek，而路由目录里是 deepseek-v4-pro
• glm-5.3-flash-4faa657f-…，而路由目录里是 glm-5.3-flash
• k3，但当前 Kimi 路由只勾选了 k3-256k

模型名能和当前路由目录对上的 profile 可以正常生成自动字段和角色文件。

Expected behavior

1. 自动字段要么能生成，要么 UI 明确说明为什么不能生成。
2. 模型名不匹配时应显示可操作的诊断，例如：
   • model_not_in_projected_catalog
   • route_selection_excludes_model
   • alias_or_prefix_mismatch
3. 不应该只显示空字段，同时保持“自动”标签和“恢复自动值”按钮，让用户无法判断是 UI 问题、模型目录问题，还是路由勾选问题。

Suggested fix

在 profile 行或高级字段区增加诊断状态，并在模型名与投影目录不一致时显示提示：

模型名未命中当前路由投影目录，无法生成自动字段。

如果存在已知的 alias/前缀关系，也可以考虑提供一键对齐到当前投影模型名。

Related

Issue #65 讨论的是写入与回读使用不同 Provider 上下文的问题；本 issue 聚焦在模型名与路由目录不一致时，子 Agent 自动字段缺少诊断提示。

[zhushihao]

根因已定位并复现：模型名没匹配上的机理不是目录缺失，而是前后端两套投影不一致

按本 Issue 的要求重新从实际运行实例和数据库做了核对（应用 3.19.2-18.4 / macOS aarch64，live DB ~/.cc-switch/cc-switch.db + 2026-08-24/08-29 备份 + live ~/.codex/config.toml），此前的"模型名与路由目录不一致"只是表象，真正的机制如下。

因果链（四步，均有代码与数据实证）

1. 后端投影会把"路由别名的 key"改写成投影可见模型名。
   src-tauri/src/codex_multirouter/compiler.rs compile_v2（约 147-176 行）：当路由别名（aliases）的 target 等于某候选模型的 canonical/upstream 名时，编译器用别名的 key 作为该模型的 visible name，原名退到 upstreamModel。
   实例：基元律动路由存在别名 glm-5.3-flash-4faa657f-1e92-467e-b3b0-d446aeb27b9a → glm-5.3-flash，因此 live ~/.codex/config.toml 的投影目录里实际是 model = "glm-5.3-flash-4faa657f-1e92-467e-b3b0-d446aeb27b9a", upstreamModel = "glm-5.3-flash"。

2. profile 按播种时刻的后端投影名落库，之后不再跟随投影变化。
   Provider 保存时 sync_router_subagent_profiles_from_provider_catalog（src-tauri/src/codex_multirouter/mutation.rs:250）执行 SyncCatalog：只增量添加缺失 profile，不改名、不迁移、不删除（UI 文案也声明"已有问卷和手工设置不会被覆盖"）。因此 profile.model 是播种那一刻的投影名快照。

3. 子 Agent 页的 preview/statuses 用的是前端自己算的另一套目录。
   前端投影 buildModelCatalogForRoutes（src/components/codex/CodexRouterWorkspacePage.tsx:2074）只按目标 Provider 目录的原名建表，完全不感知别名改写与碰撞改名；子 Agent 编辑器通过 settingsForDiagnostics（CodexSubagentProfileEditor.tsx:391-417）把这份前端目录覆盖进 preview 请求。
   于是 preview 在 codex_config.rs:5526 查不到 spec，报 Profile model is not routable；即使绕过，codex_subagent_profiles.rs:1344 对 profile.model 与目录模型名的匹配是 eq_ignore_ascii_case 精确等值（无前缀、无别名、无 upstream 回退），匹配失败即判 Unroutable，跳过该 profile 不生成角色。

4. preview 失败 → 前端三段回退兜底成空。
   四个自动字段均为 overrides.X ?? preview?.X ?? ""（editor 约 1460-1499 行）。preview 报错后字段全部为空，但"自动"徽标与"恢复自动值"按钮仍在，且错误只显示在编辑器角落，没有可操作诊断——即本 Issue 描述的现象。

复现测试：已新增两个 Rust 回归测试并跑通（本地工作区，均通过）：

• route_alias_key_becomes_projected_visible_model（compiler.rs）：同一份数据下，后端编译器把可见模型名改写为别名 key，原名退到 upstream。
• preview_breaks_when_frontend_catalog_keeps_plain_name_but_profile_uses_alias_key（codex_config.rs）：同一份 profile，喂前端投影目录报 Profile model is not routable（→ 四字段全空）；喂后端投影目录则正常生成角色名/描述/开发者指令/昵称。

Issue 中四个异常 profile 的逐一归因（对照 DB 备份）

profile	归因	当前状态
deepseek-v4-flash-deepseek / deepseek-v4-pro-deepseek	2026-08-24 备份中 DeepSeek 路由有同构别名（后缀名→原名），后端投影按别名 key 改名，profile 按后端名播种；后来 DeepSeek 目录收缩掉 flash/pro 且别名被清，名字在任何投影中都不存在	已在 08-29 的目录同步中清理
k3	08-24 时 Kimi 目录同时有 k3 和 k3-256k，k3 是当年从目录播种的；后来目录收窄为仅 k3-256k 且路由 include 勾选只留 k3-256k，名字消失（"曾经命中、后被目录收缩与勾选挡掉"的实例）	已清理
glm-5.3-flash-4faa657f-…	别名 key 仍让后端投影把可见名改写成该 UUID 后缀名；后端认为它可路由（路由 mode=all + 前缀 glm 可命中），但前端预览目录里只有原名 → 精确匹配失败 → 自动字段全空。这是当前仍在复现的实例	仍在（disabled 残留）

名字匹配的 profile 全部正常生成角色文件，与"匹配的正常、不匹配的全空"现象完全吻合。

同步逻辑的三个断点（建议修复方向）

1. 前后端投影统一（根因）：后端 compile_v2 会做别名改写与碰撞改名（追加 provider 名后缀、unique_visible_model 兜底），前端 buildModelCatalogForRoutes 两者都不做。建议后端暴露唯一一份投影给子 Agent 页，前端不再自带目录覆盖 modelCatalog。
2. 子 Agent 编译匹配放宽：codex_subagent_profiles.rs:1344 除精确等值外，应接受"经路由别名映射后的等价名"。2026-08-21 的 alias 修复已在路由侧建立 visible/upstream 双身份索引（当时修复的是 alias_target_missing），子 Agent 侧没有跟上，属同类缺口。
3. SyncCatalog 增加"改名迁移"：发现 profile 的 model 与当前投影的别名/碰撞前名等价时重键迁移，而不是留下永久失效项；删除仍建议保留手动（现有"与目录同步"按钮）。

UI 侧建议与本 Issue 原诉求一致：在 preview/statuses 失败时给出可操作诊断码（model_not_in_projected_catalog / route_selection_excludes_model / alias_or_prefix_mismatch），而不是静默留空。

数据侧止血（临时）

删除基元律动路由上的 UUID 别名并重新保存 Provider，投影名会回到 glm-5.3-flash，再用"与目录同步"清理失效 profile 即可。但这只是清现场；机制不修，下次别名/碰撞改名仍会复发。

---

环境：CCSwitchMulti 3.19.2-18.4 / macOS aarch64；核对基于 live 数据库、2026-08-21/24/26/28 备份与 08-29 13:01 glm-normalize 前备份；未改动任何业务代码、数据库与 live 配置，仅新增上述两个回归测试。