跳到主要内容

模型注册表

AISCouncil 使用社区维护的模型注册表来保持其可用模型列表最新。注册表是一个托管在 GitHub Pages 上的 JSON 文件,应用程序会获取并缓存。

工作原理

注册表文件(registry/models.json)包含提供商、其模型和定价层级的结构化列表。页面加载时,AISCouncil.Registry 模块获取带有 24 小时缓存的最新注册表数据。如果获取失败,它会回退到本地捆绑的副本。

注册表格式

注册表定义提供商和带有元数据的模型:

{
"providers": [
{
"id": "anthropic",
"name": "Anthropic",
"models": [
{
"id": "claude-sonnet-4-20250514",
"name": "Claude Sonnet 4",
"tier": "standard"
}
]
}
]
}

贡献模型

要添加或更新注册表中的模型:

  1. Fork 仓库
  2. 使用您的更改编辑 registry/models.json
  3. 运行验证脚本:python registry/validate.py
  4. 提交拉取请求

验证脚本检查:

  • 有效的 JSON 结构
  • 必需字段(id、name、provider)
  • 无重复的模型 ID
  • 正确的层级值

自动刷新

注册表在页面加载时自动刷新。24 小时缓存防止过多请求。您可以通过清除设置 > 隐私中的应用缓存数据来强制刷新。

GitHub Pages 托管

注册表作为静态 JSON 文件从 GitHub Pages 提供。这意味着:

  • 无需服务器端逻辑
  • 更改在 PR 合并和 Pages 重建后立即生效
  • 文件通过 CDN 缓存以实现快速全球访问
  • 如果 GitHub 无法访问,应用程序会优雅回退