fix(maker-core): 兜底模型映射链不改写命名空间自定义 Provider id(#3764)

[fico-hub]

这次改了什么

摘要

fix #3764。自定义 Anthropic 兼容 Provider(非 Cindy 网关)下,同一把 key 在官方 Claude Code CLI 里 Sonnet 5 / Opus 5 都能用,在 Cindy 里两个模型轮流 403。根因在目录窗口未知时的兜底映射链 legacyToSdkModelString:model.includes('sonnet') 的含糊匹配把任意含 sonnet 的 id(含命名空间形式 cindy/claude-sonnet-5)都追加 [1m],而 cindy/claude-opus-5 不命中任何分支、逐字透传——同一 Provider 的两个模型 wire id 形态不对称,上游白名单按收到的字符串逐一拒绝;UI 仍显示「Sonnet 5 / Opus 5」,改写对用户不可见。

修复:含命名空间前缀(provider/…)的 id 是自定义/网关 Provider 的路由键,不属于兜底链的官方裸 id 知识范围——除既有显式命名空间条目(codex/* 不带 [1m]、deepseek/* 与 z-ai/glm-5.2 的历史兼容后缀)外,一律逐字透传,与官方 CLI 行为一致、Sonnet/Opus 对称。裸 id 兜底链(官方 sonnet/opus/fable/gpt 映射)与窗口已知路径(toSdkModelString 按目录 contextWindow 决定 [1m],含 #3497 方向的自定义 Provider 窗口)行为不变。

变更类型

• feat 新功能
• fix 缺陷修复
• refactor / perf 重构或性能优化
• docs / test / chore 文档、测试或工程维护
• 其他:

范围

• 关联 Issue / 需求:Custom provider Claude model IDs are rewritten asymmetrically (sonnet vs opus) #3764
• 本 PR 包含:legacyToSdkModelString 的命名空间 id 透传分支(既有命名空间条目原样保留)+ 对称性回归
• 明确不包含:窗口已知路径的 [1m] 语义(不变);自定义 Provider 的 contextWindow 传递(fix(codex): honor custom provider context windows #3497 在途,互补不冲突)
• 用户可见变化:自定义 Anthropic 兼容 Provider 的命名空间模型 id 逐字发送,Sonnet/Opus 对称可用
• 是否存在 breaking change:无(官方裸 id、codex/deepseek/z-ai 显式条目、窗口已知路径均逐字节不变;唯一行为变化是「未知命名空间 id 不再被含糊加 [1m]」——即 issue 所报缺陷本身)

UI 变化

无 UI 变化。

怎么验证的

自动验证

pnpm --dir packages/maker-core exec vitest run src/agents/claude-code/__tests__/models.test.ts

结果:14 过(新增 1 条对称性回归:cindy/claude-sonnet-5 与 cindy/claude-opus-5 均逐字透传;winky/claude-sonnet-4-6 与 winky/claude-opus-4-8 同;窗口已知时仍按窗口决定 [1m]。既有官方裸 id 映射、codex/deepseek/z-ai 条目、防漂移别名用例全部照过)。反证:stash index.ts 后恰好该条新用例失败,其余 13 条照过。

maker-core typecheck 过。

pnpm test:unit:related

结果:exit 0,全过(零失败)。

手工验证

无(改写语义由单测穷举锁定;官方 CLI 的逐字发送行为以 issue 提报人实测为据)。

未执行的验证

• 未对真实自定义 Anthropic 兼容上游端到端验证(需要提报人环境的上游白名单;wire id 生成语义已由单测覆盖)。

风险

风险分类

低风险。命名空间分支只透传不改写;所有既有显式条目原样迁移进该分支(输出逐字节不变,有回归锁定);裸 id 链不动。

影响与回滚

影响面:maker-core 的 Claude Code SDK 模型串生成(仅目录窗口未知的兜底路径)。远程与移动端适配:模型串在宿主 maker-core 生成后随会话下发,远端会话同样受益,无需额外适配。回滚:revert 单 commit,无 schema 变更。

提交前检查

• 已运行定向单测(含反证)、typecheck 与 pnpm test:unit:related(失败项已逐一归因)
• commit 带 DCO 签名(Signed-off-by: ficowang fico@xd.com)
• diff 聚焦单一问题,无无关改动

[greptile-apps]

Greptile Summary

修复 Claude Code 模型字符串的兜底映射：窗口未知时，除既有显式兼容条目外，带 Provider 命名空间的模型 ID 均逐字透传。

• 保留 codex/*、deepseek/* 与 z-ai/glm-5.2 的既有后缀行为
• 新增自定义 Provider 下 Sonnet/Opus 对称透传及窗口已知路径的回归测试

Confidence Score: 5/5

该 PR 看起来可以安全合并，未发现由本次改动引入的具体可达缺陷。

新分支修正了未知窗口兜底链对命名空间模型 ID 的模糊改写，现有显式兼容条目和窗口驱动路径均保持原有语义，新增测试覆盖了目标回归场景。

Important Files Changed

Filename	Overview
packages/maker-core/src/agents/claude-code/index.ts	将命名空间模型从裸模型兜底匹配中隔离，同时保留所有已知的历史兼容映射；未发现可达的行为回归。
packages/maker-core/src/agents/claude-code/tests/models.test.ts	覆盖多个自定义 Provider 的 Sonnet/Opus 对称透传，并确认窗口已知时仍由 contextWindow 决定 [1m]。

_{Reviews (1): Last reviewed commit: "fix(maker-core): 兜底模型映射链不改写命名空间自定义 Provi..." | Re-trigger Greptile}

[MagicLizi]

代码重审通过：命名空间自定义 Provider id 在兜底链逐字透传，官方裸 id 与既有显式条目不变；当前 head 没有 P0/P1。

[MagicLizi]

合了。自定义 Provider 的 sonnet/opus 现在对称透传，不会再被兜底链偷偷加 [1m] 弄成一边能用一边 403。