@shelken/pi-dynamic-models

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

安装

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

配置

路径（后者覆盖前者）：

• {pi-agent-dir}/extensions/pi-dynamic-models/config.json
• .pi/extensions/pi-dynamic-models/config.json

{
  "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 列表缓存 6h，过期后在 session_start 异步更新，失败时继续使用旧缓存
• 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）

缓存

• registry：{pi-agent-dir}/cache/models-registry.json
• provider：{pi-agent-dir}/cache/provider-models/<name>.json