zai-coding-cn 模型缺少 glm-5.3：pi-ai 版本过旧（附已验证修复）

[hongliang-zhang]

现象

在模型设置里选择 provider zai-coding-cn 时，下拉的模型清单里没有 glm-5.3（也没有 glm-5.2-highspeed）。

根因

provider/model 的清单并不在这个仓库里，而是随 @earendil-works/pi-ai 包发布（dist/providers/data/<provider>.json），dsh-llm-pi-ai 在运行时通过 getBuiltinModels / builtinProviders 读取。pi-ai 是外部运行时依赖（没有打进 dsh 的 bundle），所以每个用户看到的清单 = 他实际装到的 pi-ai 版本。

仓库把 pi-ai 钉在 ^0.82.1（packages/llm/llm-pi-ai/package.json），而 glm-5.3 / glm-5.2-highspeed 是在 pi-ai 0.84.x 才进入 zai-coding-cn 目录的。于是每个全新安装解析到的都是 0.82.1 的旧目录，所有用户都看不到 glm-5.3。pnpm-workspace.yaml 的注释本身也写道：pi-ai 新版"自带模型目录更新，这正是升级它的意义"——只是当前还停在 0.82.1。

影响

所有安装 dsh 的用户。

已验证的修复（供团队直接采用）

由于仓库暂不接受外部 PR（见 CONTRIBUTING），我把修复实现在 fork 上并完整验证：

• fork 分支：hongliang-zhang/deepseek-harness 的 chore/bump-pi-ai-for-glm-5.3
• commit：hongliang-zhang@2cbd4dd48f

改动要点：

• @earendil-works/pi-ai ^0.82.1 → ^0.84.2（同步 minimumReleaseAgeExclude）
• 处理 0.84 带来的类型漂移：
  • thinkingFormat 新增的 baseten（走 chatTemplateArgs，配置未暴露）→ 归入 WithheldThinkingFormat
  • StopReason 新增的 pending / deferred（merge-extensible）→ mapStopReason 增加 documented default
• 重新录制 provider 下拉快照（新增 baseten、qwen-token-plan-individual）
• 附 Agent Note（implemented/process/2026-08-16-pi-ai-catalog-refresh-and-bump-drift.md）

已验证：完整 pnpm run typecheck + pnpm run build 通过、dsh-llm-pi-ai 单测通过、web 快照 refresh + replay 稳定、note 的 format/classification gate 通过、pre-commit / pre-push hook 通过。

顺带一提

希望后续新模型能更快到达用户。两种方向（任选）：定期 bump pi-ai（现状机制，可加一个"pi-ai 落后上游"的 CI 提醒）；或让 provider 方自维护模型清单（如官方 zai 自己维护，而不是依赖 pi-ai 的快照）。欢迎讨论。

若本帖分类不合适，烦请团队移动；意在把问题和现成修复同步出来。

[weijiafu14]

根因分析（pi-ai 目录随包发布、rc 锁旧版所以缺新模型）与我们维护兼容层时看到的完全一致，补两条：

今天就能用的解法（已验证的形状）：目录缺的模型可以显式声明绕过内置目录——settings.yaml 的 llm-pi-ai: 段给 zai-coding-cn（或自定义 provider 名）直接声明 glm-5.3 的模型条目（id、contextWindow、maxTokens、需要的话 thinkingLevelMap/compat），声明路由不查目录。声明写法的完整可跑参考：examples/custom-gateways——我们的验证装置就是这么在真实端点上声明并跑通模型的（包括声明值真实上线的录制断言）。

版本边界的系统解：你诊断的"pi-ai 是外部运行时依赖、rc 锁死旧 minor"正是 #3752 提案要立的边界，我们在那边放了跨版本（0.82.1/0.84.1/0.84.4）行为级 A/B 的全套实测数据支持迁移——目录滞后（你这贴和 #4042）是该提案最直接的用户可见收益。

边界说明：显式声明拿到的是路由与容量语义；zai 侧对 glm-5.3 的订阅/鉴权按你的凭证为准。

[fan56]

这正是 dsh-model-sync 解决的问题——不用升级 dsh / pi-ai，也不用手工维护声明。

@weijiafu14 上面说的"显式声明模型条目"是可行解，但它要手写，且之后目录再漂移还得跟着手工改。dsh-model-sync 把这一步自动化了：从 pi.dev 网关拉取模型列表，翻译后经官方 settings.mutate 写进路由（零补丁），之后定时保持新鲜。实测今天 pi.dev 的 zai-coding-cn 已有 glm-5.3 / glm-5.3-flash / glm-5.3-highspeed，装上启动 5 秒自动同步，或随时 /model-sync 手动刷：

npm i @aiwayds/dsh-model-sync
dsh plugin add @aiwayds/dsh-model-sync

两点边界说明：

• 0.1.6 起容量值有卫生门：列表里的垃圾值（非正整数、或 maxTokens ≥ contextWindow 的回声值）会被剥离并在同步报告中说明，避免诱发 "Output token limit reached" 一族问题（Does anybody also encounter "Output token limit reached" error while using dsh? #1166）。
• 你自己在 modelOverrides 里的调整（think level、收窄 context window）跨轮保留且优先于同步值——这也是 0.1.6 刚修的。
• zai 侧对 glm-5.3 的订阅/鉴权按你的凭证为准，同步只解决"目录里有、能选中"这一层。