fix(settings): 模型目录拼写对齐底座规范并兼容存量配置大小写

[asto18089]

本 PR 原为「底座修复 + 目录拼写」混合提交，已按要求拆分：本 PR 仅保留设置页目录拼写对齐（直接解决选模型不生效的保存侧问题）；底座 gitlink/r7 登记/guard 指纹/bridge 端到端回归见配套 PR #295。

背景

0.8.1 macOS 版用 GLM Coding Plan 国际版，选了列表里的 glm-5.2，访问时报：

send_user_message failed: model "glm-5.2" is not served by direct provider zai

自定义模型名 glm-5.3 正常（且上游实际把 glm-5.2 路由到 glm-5.3，服务端本可接受）。

根因（保存侧）

设置页目录项拼写与底座（CodeWhale）route 目录不一致：z.ai 直连的底座目录行是市场拼写 GLM-5.2 / GLM-5-Turbo，而目录列表保存的是小写 glm-5.2。用户从列表选择后，小写选择器进入底座严格路由，精确比较匹配不到自身目录行。底座侧的大小写不敏感回退修复（resolver）走 Pinvou/CodeWhale#14 + 配套 gitlink PR（#295）；本 PR 让新保存配置直接以规范拼写进入底座，不依赖回退路径。

拼写约定（本 PR 确立）

凡底座（CodeWhale）route 目录收录的模型，设置页目录项一律以底座目录拼写为准；自定义端点按厂商 wire id：

• z.ai 直连（GLM Coding Plan 国际版，严格直连路由）：列表项 GLM-5.2 / GLM-5-Turbo（glm-5.1 底座即小写）
• bigmodel.cn Coding Plan / 开放平台 / qwen_token_plan：自定义/聚合端点，模型名原样透传，保持厂商小写 wire id（glm-5.2 等）

变更

• model-catalog.js：仅 z.ai 直连两组列表改规范拼写 + 约定注释；bigmodel 组补防回归注释说明不得对齐大写
• isPresetModel / findCloudProviderForModel 目录命中改大小写不敏感（catalogItemMatchesModel），存量小写配置仍识别为预设行，不误判为自定义
• node 测试：新增「z.ai 直连存量小写配置仍命中大写目录行 → 预设」

验证

• node --test tests/model_catalog_grouping.test.js：35 全通过（main 基线 34 + 新增 1）
• python3 scripts/architecture-guard.py 通过
• 不涉及 CodeWhale 与 Rust 侧，fork-guard.sh 不受影响

已知风险

• 无行为风险：目录命中大小写不敏感只会放宽匹配，存量精确匹配行为不变
• 若底座侧修复 PR（fix(engine): 严格直连 provider 大小写不敏感匹配自身目录行 #295）未合入，仅靠本 PR 新保存的大写 GLM-5.2 在当前底座上本就精确匹配成功，可独立生效

[asto18089]

合并顺序依赖（fast-gate 预期失败说明）

fast-gate 的「公开底座 gitlink 可达性」步骤（scripts/verify-public-submodule.sh）要求 gitlink 必须等于已发布标签 pinvou-v0.9.5-r6 的解引用目标。本 PR gitlink 指向 Pinvou/CodeWhale#14 的修复分支头（0719d893），尚未存在于 Pinvou/CodeWhale 的公开 refs，因此该步骤失败——这与 PR #216 当年的处境相同，是配对流程的固有顺序。

CodeWhale#14 的全部 required checks 已通过（check / gate / link / DCO / Gitleaks）。

合并步骤（需 CodeWhale 写权限的管理员执行）

1. squash 合并 Pinvou/CodeWhale#14 到 pinvou3-clean（产生新 sha）
2. 在 Pinvou/CodeWhale 上给该 sha 打固定标签 pinvou-v0.9.5-r7
3. 我会随后向本 PR 追加提交：gitlink 重指新 sha + verify-public-submodule.sh 标签期望 r6→r7（fork-guard.sh 期望值与登记已在当前提交中更新）
4. fast-gate 全绿后即可入合并队列

其余检查（rust-lint / frontend-test / version-consistency / DCO / commit-message / changes / Gitleaks / CodeQL）均已通过；windows-rust-test 跑完后如有失败会跟进。

[asto18089]

审阅结论:有意义 + 根因属实,已帮修 1 处存量兼容缺口

根因核实(均在底座源码逐项验证)

• 底座 bundled 目录中 zai 收录确为 GLM-5.2 / GLM-5.3 / glm-5.1 / GLM-5-Turbo,与本 PR 拼写约定一致。
• route/resolver.rs 的目录匹配是大小写敏感精确比较(canonical_model.as_str() == raw),小写 glm-5.2 匹配不到 zai 自身目录行;且小写 glm-5.2 恰好命中 modelstudio-token-plan 等 4 家的裸 wire id,触发 ForeignModelForDirectProvider 误拒——报错信息 model "glm-5.2" is not served by direct provider zai 因果链完全成立。
• z.ai 直连组保持小写的 glm-4.7 不被任何其他 provider 收录,走 StrictDirect 裸透传,不受影响。

质量核查(全过)

• rebase 到最新 main 零冲突;node --test tests/model_catalog_grouping.test.js 36 全过(含帮修新增 1);architecture-guard.py 通过;eslint 无告警。
• 专门排查过两个疑点均排除:reasoning effort 档位判断比较前已 toLowerCase();smoke 测试断言的小写保存走 bigmodel 组(本就保持小写)。
• 拆分干净:底座侧修复走 fix(engine): 严格直连 provider 大小写不敏感匹配自身目录行 #295,本 PR 无无关改动。

帮修:编辑弹窗存量兼容缺口(MINOR~中)

PR 正文声称「存量小写配置仍识别为预设行,不误判为自定义」,但这只在选择器分组(isPresetModel / findCloudProviderForModel)成立。SettingsView.jsx 还有 3 处大小写敏感精确比较:

• initialCatalogMatch(编辑弹窗初始化 customModel 状态的判据)
• renderProviderModelField 的 known / selectedItem(模型字段显示预设标题还是「自定义模型 ID」)
• picker 高亮 active

后果:存量保存了小写 glm-5.2(z.ai 直连)的用户打开编辑弹窗,initialCatalogMatch 为 false → customModel 初始化为 true → 显示为「自定义模型 ID」、picker 高亮自定义项。改动前这些用户是精确命中的,属于本 PR 引入的 UI 回归,恰好违背正文的兼容性声明(不影响路由,保存值不变)。

修复(94ef0d0):导出 catalogItemMatchesModel 并在上述 3 处复用,不重复实现;补 1 个 node 测试覆盖编辑弹窗存量命中场景。修复后 36 测试全过。

[JensenChen28]

审核结论：方向正确，有一处同类遗漏，建议修复后合入

已验证通过

• 拼写对齐与底座一致：底座 bundled zai 目录确为 GLM-5.2 / GLM-5.3 / glm-5.1 / GLM-5-Turbo（CodeWhale/crates/config/assets/models_dev.bundled.json），本 PR 将 z.ai 直连组改为 GLM-5.2 / GLM-5-Turbo 正确；bigmodel 为自定义端点不在底座 zai 目录，保持小写透传的约定合理。
• 放宽匹配无回归：catalogItemMatchesModel 只放宽不收紧，存量精确匹配行为不变；reasoningEffortTiersForModel 等本就大小写不敏感。
• 测试：实际 36 个全部通过（PR 描述写 35 = 34 + 1，实际新增 2 个 test 块，计数小误差）；architecture-guard.py 通过。
• gitlink：分支带 r6、origin/main 已是 r7，但分支未改 gitlink，合并自然取 main 的 r7，无冲突，符合公约「仅真实冲突才 rebase」。

问题

1.（中）同类遗漏 — SettingsView.jsx:1741

const active = preset === group.preset && model === item.model && !item.custom;

renderCatalogPicker（同一编辑弹窗内点「更换」展开的目录列表，SettingsView.jsx:1894）的 active 高亮仍是严格相等。存量小写 glm-5.2 配置在该列表中不会显示选中标记，而同一弹窗的 initialCatalogMatch（1269）与 renderProviderModelField（1619-1620）都已改为大小写不敏感——这正是本 PR 声称要兼容的「存量小写」场景。建议改为 catalogItemMatchesModel(item, model)，一行改动。

2.（低）注释依据不准确

代码注释与 PR 描述称「glm-5.1 底座即小写」，这只对 bundled json 成立；Rust ModelInfo 目录行是 GLM-5.1（CodeWhale/crates/agent/src/lib.rs:441，两处大小写不一致是底座自身问题）。app 的 z.ai 组未列 glm-5.1，无功能影响，但作为「拼写约定」的注释依据有误导性：未来 z.ai 组若新增 glm-5.1，按该注释会保存小写，可能复现同类问题。建议修正注释表述。

3.（提示，非缺陷）

存量小写配置只有用户重新选择模型才会覆写为大写；打开弹窗不动字段直接保存仍是小写，运行时仍依赖 #295 的底座回退。PR 已如实声明此依赖关系，可接受。

建议

修复问题 1（必须）并修正问题 2 的注释表述（建议）后即可批准。问题 3 对 #295 的依赖属预期。

[asto18089]

回复 @JensenChen28 的审计建议：2 条有效已修，1 条同意非缺陷

逐条在底座源码（当前 r6 与 main 的 r7 gitlink 均核对过）核实如下，建议 1、建议 2 属实，已在 0d9414c 修复并推送；建议 3 同意属预期依赖。

建议 1（中）renderCatalogPicker 高亮严格相等 — ✅ 属实，已修

核实：编辑存量配置时 catalogGroups 已按 provider 过滤为单组（SettingsView.jsx:1314），存量小写 glm-5.2 在「更换」目录列表中对 GLM-5.2 行必然失去选中标记；全仓扫描确认 1741 行是唯一残留的严格比较（其余 3 处已在 94ef0d0 改过）。已改为 catalogItemMatchesModel(item, model)，一行改动。

建议 2（低）注释依据不准确 — ✅ 属实，已重写注释

核实细节，比审计描述再深一层：

• bundled json（models_dev.bundled.json）zai 行确为 GLM-5.2 / GLM-5.3 / glm-5.1 / GLM-5-Turbo——资产自身大小写不统一；
• Rust agent 层 ModelInfo 的 Zai 行（lib.rs:441）确实是大写 GLM-5.1；lib.rs:383 的小写 z-ai/glm-5.1 是 Openrouter 行，两者不是同一 provider 的目录；
• resolver 目录（resolver.rs:456 default_offerings）= 手工 seam（无 Zai 行）+ bundled json（bundled_catalog_offerings），即路由口径的权威拼写以 bundled json 为准，glm-5.1 在路由目录确为小写。

原注释「（glm-5.1 为小写）」单看 bundled json 没错，但读者无法区分两套目录，审计指出的误导风险成立。新注释改为「新增条目须逐行核对 bundled 资产的 zai 行拼写，不可套用大小写规律」。

顺带发现并修正一处已失实的表述：原注释称「底座 resolver 对严格直连 provider 已做大小写不敏感回退」——所指的 Pinvou/CodeWhale#14 已于 8-17 被维护者关闭（通用修复优先回馈上游，收敛为 Hmbown/CodeWhale#5475），当前 r6 与 main 的 r7（a36e6cd5）均不含该回退（scope_selector 仍为精确比较）。注释已改为如实描述：回退在上游审核中、未随当前 gitlink 发布，故新保存配置必须用目录行原样拼写。

建议 3（提示）— 同意非缺陷，依赖对象已更新

依赖关系声明本身可接受，但依赖链在评审后发生了变化：存量小写配置的运行时恢复原走 CodeWhale#14，现改为待上游 Hmbown/Codewhale#5475 合入 → fork 同步 → gitlink 升级（配套 PR #295 需相应重定 gitlink 目标，其现指向的 CodeWhale 分支已关闭）。在回退随 gitlink 发布前，存量小写用户在编辑弹窗重新选择模型（保存大写 GLM-5.2，当前底座上即精确匹配成功）即可恢复——本次 1741 行修复正是让这条规避路径的高亮与预设识别正确。

验证

• node --test tests/model_catalog_grouping.test.js 36 全过；全套 tests/*.test.js 37 全过；
• 改动文件 eslint 无告警；architecture-guard.py 通过。

另更正一处计数笔误：审计指出 PR 描述「35 = 34+1」应为 36，属实，此前帮修实际新增了 2 个 test 块。

[JensenChen28]

复核通过：两项意见均已修复

新提交 0d9414c8 核验：

• 目录选择器高亮（1741）：改为 catalogItemMatchesModel，!item.custom 短路在前，与 1619/1620/1655 三处复用一致，存量小写配置在「更换」目录列表中可正确高亮。
• 拼写约定注释：改为以 models_dev.bundled.json 目录行原样拼写为准，明确底座资产自身大小写不统一（agent 层 ModelInfo 统一大写）、新增条目须逐行核对，并说明回退未随当前 gitlink 发布、新保存必须用原样拼写的理由——表述准确。

验证：node --test tests/model_catalog_grouping.test.js 36 个子测试全过；architecture-guard.py 通过。

CHANGES_REQUESTED 的阻塞项全部解除，可合入。

[zhuowp]

复审结论：请求修改

先前评审指出的目录选择器高亮遗漏和注释依据均已修复；36 个 model catalog 测试、architecture guard、cargo fmt 与线上 required gate 均通过。

不过全量复审发现大小写兼容的作用域过宽：它同时改变了本地和所有云 provider 的自定义模型分类，详见行内评论。请将兼容限定到有已知历史拼写迁移的 z.ai 目录项，或提供能证明其余 provider（尤其 local_vllm）模型 ID 均大小写不敏感的契约，并补反向测试。

[zhuowp]

[P2] 这个通用比较器现在被 isPresetModel 的 local_vllm 分支和所有云 provider 复用，超出了本 PR 需要兼容的 z.ai 存量 glm-5.2。本地 OpenAI-compatible 服务暴露的模型 ID 是不透明字符串，可能区分大小写；例如目录有 qwen36_35b_256k 时，用户配置的自定义 ID QWEN36_35B_256K 在本 PR 后会被误分为预设，目录选择器也会错误高亮默认项。云端同 provider 的 case-only 自定义 ID 也有同类问题。请把 case-insensitive alias 限定到明确的 z.ai 迁移项/provider，其他目录继续精确比较，并补“本地 case-only ID 仍为自定义”的反向测试。

[asto18089]

复审意见核实与修复（39abd7ec）：

意见成立，已按建议的第一种方案修复。

核实过程：

• catalogItemMatchesModel 确被 isPresetModel 的 local_vllm 分支、全部云 provider 分支及 findCloudProviderForModel 复用，全量大小写不敏感使所有目录命中一起放宽。
• local_vllm 目录唯一非 custom 项即 qwen36_35b_256k，vLLM 模型 ID 为不透明字符串，案例真实。
• git 历史核实：z.ai 直连组从首次引入（179ea7bc）至本 PR 前目录行始终为小写 glm-5.2/glm-5-turbo，本 PR 是唯一一次拼写迁移；minimax 等其余组拼写从未变更，无历史迁移需要兼容。因此未采用第二种方案（证明全部 provider ID 大小写不敏感的契约）——该前提对本地 vLLM 确实不成立。

修复（39abd7ec）：

• catalogItemMatchesModel 恢复精确比较，仅当命中目录项显式登记的 legacyAliases 时兼容——z.ai 直连两个迁移项分别登记 ['glm-5.2']/['glm-5-turbo']（存量值只能来自旧目录行的精确拼写，精确别名即可完整覆盖，不做 case-insensitive）。
• 顶部拼写约定注释补充：凡目录行拼写变更（含大小写），旧拼写须登记到 legacyAliases。
• 测试 36 → 38：新增「本地 case-only 模型 ID（QWEN36_35B_256K）仍为自定义」「云端无迁移目录 case-only ID（minimax-m3）仍为自定义」两个反向测试，并补 glm-5-turbo 存量别名正例、Glm-5.2 混合大小写不命中的边界断言。

验证：node --test tests/model_catalog_grouping.test.js 38 全过；architecture-guard.py 通过。settings_ui_smoke 因本机缺 puppeteer-core 跳过（环境依赖，与本改动无关）。

[asto18089]

补记：本 PR 于 2026-08-18 06:20 合并，squash 提交 449fbc3 内容止于 0d9414c——上述修复（39abd7ec）在合并后才推到本分支，未随本 PR 进入 main。该修复已另行提交 #311，请移步复审。