模型注册表
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"
}
]
}
]
}
贡献模型
要添加或更新注册表中的模型:
- Fork 仓库
- 使用您的更改编辑
registry/models.json - 运行验证脚本:
python registry/validate.py - 提交拉取请求
验证脚本检查:
- 有效的 JSON 结构
- 必需字段(id、name、provider)
- 无重复的模型 ID
- 正确的层级值
自动刷新
注册表在页面加载时自动刷新。24 小时缓存防止过多请求。您可以通过清除设置 > 隐私中的应用缓存数据来强制刷新。
GitHub Pages 托管
注册表作为静态 JSON 文件从 GitHub Pages 提供。这意味着:
- 无需服务器端逻辑
- 更改在 PR 合并和 Pages 重建后立即生效
- 文件通过 CDN 缓存以实现快速全球访问
- 如果 GitHub 无法访问,应用程序会优雅回退