mirror of
https://git.openapi.site/https://github.com/desirecore/config-center.git
synced 2026-10-21 01:24:43 +08:00
docs: split model source records and unify project instructions (#113)
* docs: split model sources and consolidate project instructions * docs: normalize empty model navigation footer
This commit is contained in:
GitHub
@@ -1,95 +1,56 @@
|
||||
# 模型数据来源维护
|
||||
# 模型数据来源导航
|
||||
|
||||
此目录记录 `compute/providers`、`compute/coding-plans`、`compute/model-specs` 的模型数据来源。每家供应商一份 Markdown，普通 API、订阅、套餐和共享规格在同一页分别列出。
|
||||
[更新前核查清单](../../AGENTS.md) · [维护规则](MAINTENANCE.md) · [模板](TEMPLATE.md)
|
||||
|
||||
## 本轮核验范围
|
||||
本目录按供应商、官网证据、单模型、单接入面分层记录。索引不承载全部参数表；模型差异和核验状态在对应文件中维护。
|
||||
|
||||
- 核验日期：2026-10-03。
|
||||
- 配置范围：28 个 Provider、11 个套餐、23 个共享规格文件。
|
||||
- 当前模型记录：619 条（同一模型在不同接入面会分别计数）。
|
||||
- 317 条 `partial`：只核实表中列出的字段，可能仅确认官网出现该 ID；不是整条规格全通过。
|
||||
- 301 条 `pending`：登记官网入口，但尚未取得该条模型的字段级证明。
|
||||
- 1 条 `historical`：匿名模型的历史兼容记录，不证明当前平台可用。
|
||||
|
||||
没有把所有存量数据写成已核实。当前确认的是本轮明确核对的字段、官网公共目录以及本地配置契约；没有执行逐供应商账号的收费模型调用。
|
||||
|
||||
## 统一记录规则
|
||||
|
||||
1. **来源必须是发布者的官网、官方文档、官方 API 或可验证的官方代码仓库。** 搜索摘要、聚合榜单、社区文章、第三方转载和本仓旧配置只能帮助定位，不是字段的主证据。官方域名上的用户文章也不等于官方公告。
|
||||
2. **原厂与接入面分开。** 原厂存在某模型，不证明套餐可用；国际端点不证明国内端点可用；OpenRouter USD 价格不覆盖国内 CNY。
|
||||
3. **数字写清含义。** 上下文窗口、最大输入、最大输出、默认输出参数分别记录。官网只写 K/M 时注明换算，优先使用明文整数；输入/输出独立限制不使用 output<=input 的通用断言。
|
||||
4. **价格写清单位和条件。** 区分每百万 token、每张、每秒、每字符、search unit、按实例；原价、限时优惠、缓存命中/写入、峰谷、长上下文阶梯分别注明。未知价格省略；-1 等 API 占位值不转换成零价。
|
||||
5. **日期写清用途。** `checkedAt` 是本轮实际访问日期；模型发布时间另行确认。读取了官网不代表所有模型字段都已核实，页面壳或登录墙不可标为证明。
|
||||
6. **本仓策略不冒充官网参数。** `routing.tier`、`routingPriority`、`defaultReference`、产品能力标签、预设启用状态等是产品配置/工程判断；不要引用营销榜单来证明它们。
|
||||
7. **官方来源也有边界。** 官方 API 的动态目录是某一时点的接入面快照；缺失表示本次未列出，不能自动推断原厂退役。官网参数核对不等于实际账号调用验收。来源元数据保存实际跳转地址与成功读取正文的 SHA-256，不保存完整网页原文；访问失败的 URL 明确记录。
|
||||
|
||||
## 目录索引
|
||||
|
||||
| 供应商 | 模型记录 | 有已核字段 | 待核实/历史 |
|
||||
| --- | ---: | ---: | ---: |
|
||||
| [OpenAI](providers/openai.md) | 93 | 13 | 80 |
|
||||
| [Anthropic](providers/anthropic.md) | 21 | 9 | 12 |
|
||||
| [GitHub Copilot](providers/github-copilot.md) | 0 | 0 | 0 |
|
||||
| [DeepSeek](providers/deepseek.md) | 12 | 9 | 3 |
|
||||
| [阿里云百炼 / Qwen / Wan / HappyHorse](providers/alibaba.md) | 118 | 103 | 15 |
|
||||
| [火山引擎](providers/volcengine.md) | 66 | 0 | 66 |
|
||||
| [月之暗面 Kimi](providers/moonshot.md) | 21 | 7 | 14 |
|
||||
| [智谱](providers/zhipu.md) | 31 | 28 | 3 |
|
||||
| [百川](providers/baichuan.md) | 8 | 0 | 8 |
|
||||
| [MiniMax](providers/minimax.md) | 67 | 55 | 12 |
|
||||
| [小米 MiMo](providers/xiaomi.md) | 25 | 7 | 18 |
|
||||
| [百度千帆](providers/baidu.md) | 20 | 15 | 5 |
|
||||
| [腾讯混元](providers/tencent.md) | 25 | 1 | 24 |
|
||||
| [讯飞星火](providers/xunfei.md) | 4 | 2 | 2 |
|
||||
| [硅基流动](providers/siliconflow.md) | 3 | 0 | 3 |
|
||||
| [Ollama](providers/ollama.md) | 1 | 0 | 1 |
|
||||
| [Google Gemini](providers/google.md) | 30 | 28 | 2 |
|
||||
| [Mistral](providers/mistral.md) | 9 | 4 | 5 |
|
||||
| [xAI](providers/xai.md) | 9 | 3 | 6 |
|
||||
| [Cohere](providers/cohere.md) | 17 | 16 | 1 |
|
||||
| [可灵](providers/kling.md) | 11 | 0 | 11 |
|
||||
| [OpenRouter](providers/openrouter.md) | 15 | 15 | 0 |
|
||||
| [Perplexity](providers/perplexity.md) | 6 | 2 | 4 |
|
||||
| [Stability AI](providers/stability.md) | 3 | 0 | 3 |
|
||||
| [匿名模型历史兼容](providers/stealth.md) | 1 | 0 | 1 |
|
||||
| [无问芯穹](providers/infini.md) | 1 | 0 | 1 |
|
||||
| [摩尔线程](providers/moorethread.md) | 1 | 0 | 1 |
|
||||
| [快手 StreamLake Coding](providers/kwai.md) | 1 | 0 | 1 |
|
||||
|
||||
## 文件格式
|
||||
|
||||
- `providers/<supplier-id>.md`：配置位置 → 官网证据 → 核验边界 → 当前参数表 → 更新步骤 → 机器可读来源元数据。
|
||||
- [TEMPLATE.md](TEMPLATE.md)：新增供应商时复制这个格式；来源 ID 使用稳定的英文短名。
|
||||
- 每个 `source-config` 段落对应一个 canonical JSON 文件；每一行对应一条 `models[].modelName` 或 `specs[].id`。
|
||||
- “已核字段→来源”使用完整字段路径，必须指向成功读取的官网来源。未列出的字段仍未核实。ID 的核对要求完整标识符匹配，不能以 gpt-5.5 出现来证明 gpt-5；ID 出现也不证明该端点可调用。
|
||||
- `source-config-fingerprint` 记录端点、协议、币种和平台非凭据字段，防止只改平台而遗漏来源复核。API Key 等凭据不写进来源记录。
|
||||
- 行尾 SHA-256 是当前完整模型对象的指纹，用于发现配置已变而文档未复核。指纹不是官方签名，也不证明字段正确。
|
||||
|
||||
## 更新流程
|
||||
|
||||
1. 从供应商页面的官方入口打开对应模型、地域与接入面，读取正文/公共 API。把失败、页面壳或权限要求原样登记。
|
||||
2. 将官网内容与现有 JSON 逐字段比较；发现差异时先记录含义、单位、限时/地域条件，再改配置。
|
||||
3. 同步 Provider、共享规格、套餐名单及相关回归。删除某接入面不再列出的预置型号时添加该接入面的 tombstones；历史兼容规格是否保留单独判断。
|
||||
4. 基于现有 Markdown 增量编辑受影响行和核验说明；不要整页重建或删除既有来源历史。更新实际核实的字段、日期和状态。
|
||||
5. 运行 `node scripts/validate-sources.mjs --fingerprints`，将对应模型的新指纹写入文档；平台字段改变时同步 `#@config` 指纹，确认参数表与 JSON 一致。
|
||||
6. 数据变化时递增 `manifest.json#presetDataVersion` 并更新日期；纯文档修订不需要假装发布数据更新。
|
||||
7. 执行 `npm run validate`、`npm test` 和 `git diff --check`。必要时在已授权账号进行聚焦实测，并记录结果与限制。
|
||||
|
||||
```bash
|
||||
npm run validate:sources
|
||||
node scripts/validate-sources.mjs --fingerprints
|
||||
npm run validate
|
||||
npm test
|
||||
```text
|
||||
providers/<supplier>/
|
||||
README.md # 供应商导航
|
||||
SOURCES.md # 官网证据与适用边界
|
||||
models/<model-id>.md # 单模型参数及接入差异
|
||||
access/<category>--<id>.md # 单接入面平台配置
|
||||
```
|
||||
|
||||
来源校验不访问网络，也不消费模型额度：检查官方域名、引用、日期、全部模型覆盖、重复 ID、完整对象指纹和参数表是否与配置一致。更新数据后若来源记录陈旧，CI 会失败。
|
||||
本次结构迁移：28 个供应商目录、360 个单模型文件、62 个单接入面文件。619 条记录及 317 partial / 301 pending / 1 historical 的状态原样保留；未重新核验或提高状态。
|
||||
|
||||
## 本轮修正记录
|
||||
## 供应商
|
||||
|
||||
- Qwen3.7 Max：合并两个冲突的 canonical ID；官网明确纯文本、1000000 上下文、131072 最大输出，API/Token Plan 同步；北京隐式缓存命中价补为 2.4 元/百万 token。
|
||||
- MiniMax Hailuo 2.3 Fast：合并只在大小写上不同的两个规格，保留 exact 别名及原有非 Agent 路由。
|
||||
- Cohere Embed：兼容 API 官网明确不支持 dimensions 参数，移除该接入面可选维度列表；原生共享规格和默认响应维度保留。
|
||||
- OpenRouter auto：移除原来的零价字段，明确官网 -1 是动态计价占位值。
|
||||
- OpenRouter 当前目录未列出的三个旧预置：从该 Provider 移除并 tombstone，不将原厂模型或其他网关的历史兼容规格同步判为退役。
|
||||
| 供应商 | 模型文件 | 接入面文件 |
|
||||
| --- | ---: | ---: |
|
||||
| [阿里云百炼 / Qwen / Wan / HappyHorse](providers/alibaba/README.md) | 65 | 6 |
|
||||
| [Anthropic](providers/anthropic/README.md) | 11 | 3 |
|
||||
| [百川](providers/baichuan/README.md) | 4 | 2 |
|
||||
| [百度千帆](providers/baidu/README.md) | 14 | 3 |
|
||||
| [Cohere](providers/cohere/README.md) | 10 | 2 |
|
||||
| [DeepSeek](providers/deepseek/README.md) | 8 | 2 |
|
||||
| [GitHub Copilot](providers/github-copilot/README.md) | 0 | 1 |
|
||||
| [Google Gemini](providers/google/README.md) | 20 | 2 |
|
||||
| [无问芯穹](providers/infini/README.md) | 1 | 1 |
|
||||
| [可灵](providers/kling/README.md) | 6 | 2 |
|
||||
| [快手 StreamLake Coding](providers/kwai/README.md) | 1 | 1 |
|
||||
| [MiniMax](providers/minimax/README.md) | 30 | 3 |
|
||||
| [Mistral](providers/mistral/README.md) | 6 | 2 |
|
||||
| [月之暗面 Kimi](providers/moonshot/README.md) | 14 | 3 |
|
||||
| [摩尔线程](providers/moorethread/README.md) | 1 | 1 |
|
||||
| [Ollama](providers/ollama/README.md) | 1 | 1 |
|
||||
| [OpenAI](providers/openai/README.md) | 50 | 4 |
|
||||
| [OpenRouter](providers/openrouter/README.md) | 15 | 1 |
|
||||
| [Perplexity](providers/perplexity/README.md) | 3 | 2 |
|
||||
| [硅基流动](providers/siliconflow/README.md) | 3 | 1 |
|
||||
| [Stability AI](providers/stability/README.md) | 2 | 2 |
|
||||
| [匿名模型历史兼容](providers/stealth/README.md) | 1 | 1 |
|
||||
| [腾讯混元](providers/tencent/README.md) | 19 | 3 |
|
||||
| [火山引擎](providers/volcengine/README.md) | 37 | 3 |
|
||||
| [xAI](providers/xai/README.md) | 7 | 2 |
|
||||
| [小米 MiMo](providers/xiaomi/README.md) | 15 | 2 |
|
||||
| [讯飞星火](providers/xunfei/README.md) | 2 | 2 |
|
||||
| [智谱](providers/zhipu/README.md) | 14 | 4 |
|
||||
|
||||
2026-10-02 的 [JSON 审计快照](../../reports/provider-model-audit-2026-10-02.json) 保留为历史结果；此目录是后续字段级来源记录入口。历史快照日期和计数不会因为本轮修正而重写。
|
||||
## 阅读示例
|
||||
|
||||
- [GPT-6.1 Sol](providers/openai/models/gpt-6.1-sol.md)：原厂与订阅接入分别列出。
|
||||
- [OpenAI API 接入](providers/openai/access/providers--openai.md)：端点、协议、币种与关联模型。
|
||||
- [OpenAI 官网证据](providers/openai/SOURCES.md)：可复用证据与边界。
|
||||
|
||||
来源校验入口：`npm run validate:sources`。任何模型遗漏、来源引用错误、参数详情或指纹陈旧都会失败。完整工作流程见维护规则和 AGENTS.md。
|
||||
|
||||
Reference in New Issue
Block a user