@shelken/pi-dynamic-models

从 models.dev 自动发现并补全 models.json 中的远端模型

Package details

extension

Install @shelken/pi-dynamic-models from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@shelken/pi-dynamic-models

Pi manifest JSON

{
  "extensions": [
    "./index.ts"
  ]
}

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

从 models.dev 自动发现并补全 models.json 中远端 provider 的模型列表。

pi install npm:@shelken/pi-dynamic-models

路径（后者覆盖前者）：

{
  "enable": true,
  "enableProviders": ["cpa"],
  "excludePatterns": ["gpt-image-*", "sora-*"],
  "debug": false
}

字段	说明
`enable`	总开关
`enableProviders`	要发现的 provider。省略、`""` 或 `[""]` = `models.json` 里所有带 `baseUrl` 的 provider；`[]` = 不启用
`excludePatterns`	glob（`` / `?`），匹配的 AUTO* id 不注册；不碰手写模型
`debug`	为 true 时逐模型日志 + console

读 {pi-agent-dir}/models.json 的 baseUrl / apiKey / api，请求 provider 的 /models
不覆盖 models.json 手写模型，也不覆盖 pi 内置 同 id 模型参数（如 openai/anthropic）；只追加缺失 id。registerProvider 会整表替换，实现上会合并：内置 → models.json → 新 AUTO
registry 缓存 6h（过期先用旧数据再后台刷新）；provider 列表缓存 10min
factory 同步用磁盘 cache 注册 AUTO 模型（session restore 能找到上次的 provider/id）
同一次 runtime 内 AUTO 内容 hash 未变则跳过重注册；每次扩展 factory 会清空 hash（/new 会换 ModelRegistry，必须重新 register）
默认只打摘要日志
默认过滤 contextWindow === 0（如 image 模型）
列表变化或首次发现时 notify（无页脚 status）
日志：{pi-agent-dir}/logs/pi-dynamic-models.log

/dynamic-models          # status：上次摘要 + provider cache 列表
/dynamic-models status
/dynamic-models refresh  # 强制拉网并重注册（忽略 freshness）