pi 在发布流程加入模型目录兼容性检查——kimi-coding 协议切换打挂 pi 1.2.0 之后

Earendil 成员 davidbrai 于 2026 年 10 月 15 日把 PR #11007 合入 pi，距 v1.3.0 发布只过了几分钟——改动落在该 release 之后的 main 上。它针对的是目录分发模式自带的失败形态：pi.dev 会把每个已发布的模型目录即时下发给所有不低于 MINIMUM_PI_VERSION 的已发布 pi，一旦某条目录条目需要这些版本尚不具备的代码，它们就会出问题。

kimi-coding 切换到 openai-completions API 时发生的正是这种事：pi 1.2.0 仍向新 URL 发送 Anthropic 请求，收到的是 404。v1.3.0 已经带上同一链路上的防御面——release 说明里列有 Nix flake 修复，在 provider 切换 API 时从最新发布的目录刷新模型目录 pin，release 打 tag 前固定最新目录并以其构建（#10985）。#11007 补上的是发布路径上的编译期 counterpart。

检查在发布前运行，也在触及 packages/ai 的 PR 上运行：把最新 release 的 pi-ai 与其内建模型放在一起、将新目录铺在上面编译，某个模型使用了其 provider 未实现的 API 就会成为类型错误并阻断发布。如果这种不兼容是有意的，就在同一个提交里抬升 MINIMUM_PI_VERSION。该常量迁至 scripts/model-catalog-minimum-version.mjs，由检查与发布脚本共享。

这次合并晚于 v1.3.0 的 tag，因此要等下一个 release；GitHub 上 #11007 的 diff 可看到跨五个文件的完整改动。