docs: split model source records and unify project instructions (#113)

* docs: split model sources and consolidate project instructions * docs: normalize empty model navigation footer
2026-10-21 06:24:14 +08:00 · 2026-10-03 00:29:46 -07:00
parent cccf14f72d
commit 647d6f0cfd
517 changed files with 39351 additions and 3328 deletions
--- a/docs/model-sources/providers/xunfei/README.md
+++ b/docs/model-sources/providers/xunfei/README.md
@@ -0,0 +1,15 @@
+# 讯飞星火：来源导航
+
+[总索引](../../README.md) · [官网证据与边界](SOURCES.md)
+
+本目录包含 2 个单模型文件、2 个单接入面文件。核验日期与状态来自迁移前记录。
+
+## 接入面
+
+- [compute/providers/xunfei.json](access/providers--xunfei.md)
+- [compute/model-specs/xunfei.json](access/model-specs--xunfei.md)
+
+## 模型
+
+- [`4.0Ultra`](models/4.0ultra.md)
+- [`spark-x`](models/spark-x.md)
--- a/docs/model-sources/providers/xunfei/SOURCES.md
+++ b/docs/model-sources/providers/xunfei/SOURCES.md
@@ -0,0 +1,40 @@
+# 讯飞星火：官网证据目录
+
+[供应商索引](README.md)
+
+核验日期：2026-10-03。这里只登记可复用的官网证据与适用边界，具体模型与接入面分别记录。
+
+## 官网证据
+
+### xunfei
+
+- 入口：[xunfei](https://www.xfyun.cn/doc/spark/X1http.html)
+- 类型：`official-doc`；当前读取状态：`fetched`；地域/接入面：`讯飞 X2/X1.5 的 HTTP 文档；端点与独立输入/输出限制`。
+
+## 已知边界与核验说明
+
+已登记官方入口并尝试读取。表中仅标为已核字段的部分有此次核对记录；其余存量参数待逐字段复核。
+
+状态 `partial` 仅表示列出的字段已核实；不能推断整条配置、价格、账号权限或真实模型调用都已验收。`pending` 没有已核字段；`historical` 只作历史兼容参考。路由 tier/priority、产品标签和默认选择属于本仓策略，不伪装成官网数据。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "xunfei",
+  "checkedAt": "2026-10-03",
+  "sources": [
+    {
+      "id": "xunfei",
+      "url": "https://www.xfyun.cn/doc/spark/X1http.html",
+      "kind": "official-doc",
+      "scope": "讯飞 X2/X1.5 的 HTTP 文档；端点与独立输入/输出限制",
+      "retrieval": "fetched",
+      "checkedAt": "2026-10-03",
+      "contentSha256": "324d06b132ff4ab16a0543157467283dc789153303cf456b44af45d1fc6f1548",
+      "resolvedUrl": "https://www.xfyun.cn/doc/spark/X1http.html"
+    }
+  ]
+}
+```
+<!-- source-metadata:end -->
--- a/docs/model-sources/providers/xunfei/access/model-specs--xunfei.md
+++ b/docs/model-sources/providers/xunfei/access/model-specs--xunfei.md
@@ -0,0 +1,38 @@
+# 讯飞星火：xunfei 接入面
+
+[供应商索引](../README.md) · [官网证据](../SOURCES.md)
+
+- 配置文件：[compute/model-specs/xunfei.json](../../../../../compute/model-specs/xunfei.json)
+- 核验日期：2026-10-03。
+- 接入类别：`model-specs`。
+
+## 平台配置快照
+
+这是模型共享规格文件，不声明账号权限、平台计价或服务端点。
+
+以上是配置快照，不能据此宣布该端点或账号已实际验收。核查地域、套餐支持、凭据来源及协议时，对照官网证据目录并记录结论。
+
+<!-- source-config: compute/model-specs/xunfei.json -->
+<!-- source-config-fingerprint: f394c05c83d9cc3aa04530ca464f1ec93109aea075915638d5a9ec4721acb98a -->
+
+## 关联模型
+
+- [`spark-x`](../models/spark-x.md)
+- [`4.0Ultra`](../models/4.0ultra.md)
+
+## 更新前检查
+
+- 核对端点和地域、API 格式、凭据来源、版本要求及套餐实际支持名单。
+- 修改平台字段后复核本文件；修改模型字段后更新对应单模型文件。
+- 未取得官网参数或账号实测证据时，保留 pending / 未实测说明，不以表格快照代替证据。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "xunfei",
+  "checkedAt": "2026-10-03",
+  "sourceCatalog": "../SOURCES.md"
+}
+```
+<!-- source-metadata:end -->
--- a/docs/model-sources/providers/xunfei/access/providers--xunfei.md
+++ b/docs/model-sources/providers/xunfei/access/providers--xunfei.md
@@ -0,0 +1,41 @@
+# 讯飞星火：xunfei 接入面
+
+[供应商索引](../README.md) · [官网证据](../SOURCES.md)
+
+- 配置文件：[compute/providers/xunfei.json](../../../../../compute/providers/xunfei.json)
+- 核验日期：2026-10-03。
+- 接入类别：`providers`。
+
+## 平台配置快照
+
+- API 协议：`openai-completions`。
+- 端点：`https://spark-api-open.xf-yun.com/v1`。
+- 计价币种：`CNY`。
+- 访问模式：`普通 API`。
+
+以上是配置快照，不能据此宣布该端点或账号已实际验收。核查地域、套餐支持、凭据来源及协议时，对照官网证据目录并记录结论。
+
+<!-- source-config: compute/providers/xunfei.json -->
+<!-- source-config-fingerprint: d3a6cf19f2ba08c91c3637e19aec7de281c5ce375ce63c91557791cc7b759531 -->
+
+## 关联模型
+
+- [`spark-x`](../models/spark-x.md)
+- [`4.0Ultra`](../models/4.0ultra.md)
+
+## 更新前检查
+
+- 核对端点和地域、API 格式、凭据来源、版本要求及套餐实际支持名单。
+- 修改平台字段后复核本文件；修改模型字段后更新对应单模型文件。
+- 未取得官网参数或账号实测证据时，保留 pending / 未实测说明，不以表格快照代替证据。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "xunfei",
+  "checkedAt": "2026-10-03",
+  "sourceCatalog": "../SOURCES.md"
+}
+```
+<!-- source-metadata:end -->
--- a/docs/model-sources/providers/xunfei/models/4.0ultra.md
+++ b/docs/model-sources/providers/xunfei/models/4.0ultra.md
@@ -0,0 +1,97 @@
+# 4.0Ultra：模型来源与接入记录
+
+[供应商索引](../README.md) · [官网证据目录](../SOURCES.md)
+
+- 精确模型 ID：`4.0Ultra`。
+- 核验日期：2026-10-03；本次只迁移记录，没有重新核验或提高状态。
+
+## 适用接入面
+
+- [compute/providers/xunfei.json](../access/providers--xunfei.md)
+- [compute/model-specs/xunfei.json](../access/model-specs--xunfei.md)
+
+## 字段级来源记录
+
+各接入面分开记录；价格为 inputPrice/outputPrice 快照，具体单位和限制看配置及引用官网。partial 只确认已列字段，不代表全部参数、平台可用性或账号调用已验收。
+
+### compute/providers/xunfei.json
+
+[查看配置](../../../../../compute/providers/xunfei.json) · [接入面说明](../access/providers--xunfei.md)
+
+当前配置详情（不是全部官网确认值；routing 是本仓策略）：
+
+<!-- source-details: {"config":"compute/providers/xunfei.json","id":"4.0Ultra"} -->
+```json
+{
+  "contextWindow": 32768,
+  "maxOutputTokens": 32768,
+  "serviceType": [
+    "chat"
+  ],
+  "capabilities": [
+    "chat",
+    "reasoning",
+    "code",
+    "tool_use"
+  ],
+  "defaultTemperature": 1,
+  "defaultTopP": 1
+}
+```
+<!-- source-details:end -->
+
+<!-- source-config: compute/providers/xunfei.json -->
+
+| 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `4.0Ultra` | 32768 / 32768 | CNY：未声明 / 未声明 | 待核实 | [xunfei](../SOURCES.md#xunfei) | pending | `018bed7da0a903812515899572d00d3efcdb86395896232f8af59809775b5ec6` |
+
+### compute/model-specs/xunfei.json
+
+[查看配置](../../../../../compute/model-specs/xunfei.json) · [接入面说明](../access/model-specs--xunfei.md)
+
+当前配置详情（不是全部官网确认值；routing 是本仓策略）：
+
+<!-- source-details: {"config":"compute/model-specs/xunfei.json","id":"4.0Ultra"} -->
+```json
+{
+  "spec.contextWindow": 32768,
+  "spec.maxOutputTokens": 32768,
+  "spec.serviceType": [
+    "chat"
+  ],
+  "spec.capabilities": [
+    "chat",
+    "reasoning",
+    "code",
+    "tool_use"
+  ],
+  "spec.defaultTemperature": 1
+}
+```
+<!-- source-details:end -->
+
+<!-- source-config: compute/model-specs/xunfei.json -->
+
+| 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `4.0Ultra` | 32768 / 32768 | 非计价主数据 | 待核实 | [xunfei](../SOURCES.md#xunfei) | pending | `1dee4706e0bc0dd341a81fcbcb28f2f2d45f138c91476086fe9e42ddf8c1159b` |
+
+## 下次更新核查
+
+- 对照官网核查精确 ID／别名、是否仍列出、上下文／输入／输出限制及单位。
+- 分别核查推理档位、默认值、是否可关闭思考、采样和强制工具选择限制、多模态输入／输出。
+- 按本接入面核对价格、缓存、阶梯／峰谷、套餐支持；不能把其他平台参数直接复制。
+- 只更新真正复核的字段与引用来源；保留其余待核实项及历史记录。
+- 同步对应 canonical JSON、回归和模型指纹，再运行来源校验。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "xunfei",
+  "checkedAt": "2026-10-03",
+  "sourceCatalog": "../SOURCES.md"
+}
+```
+<!-- source-metadata:end -->
--- a/docs/model-sources/providers/xunfei/models/spark-x.md
+++ b/docs/model-sources/providers/xunfei/models/spark-x.md
@@ -0,0 +1,100 @@
+# spark-x：模型来源与接入记录
+
+[供应商索引](../README.md) · [官网证据目录](../SOURCES.md)
+
+- 精确模型 ID：`spark-x`。
+- 核验日期：2026-10-03；本次只迁移记录，没有重新核验或提高状态。
+
+## 适用接入面
+
+- [compute/providers/xunfei.json](../access/providers--xunfei.md)
+- [compute/model-specs/xunfei.json](../access/model-specs--xunfei.md)
+
+## 字段级来源记录
+
+各接入面分开记录；价格为 inputPrice/outputPrice 快照，具体单位和限制看配置及引用官网。partial 只确认已列字段，不代表全部参数、平台可用性或账号调用已验收。
+
+### compute/providers/xunfei.json
+
+[查看配置](../../../../../compute/providers/xunfei.json) · [接入面说明](../access/providers--xunfei.md)
+
+当前配置详情（不是全部官网确认值；routing 是本仓策略）：
+
+<!-- source-details: {"config":"compute/providers/xunfei.json","id":"spark-x"} -->
+```json
+{
+  "contextWindow": 65536,
+  "maxOutputTokens": 128000,
+  "serviceType": [
+    "reasoning"
+  ],
+  "capabilities": [
+    "chat",
+    "reasoning",
+    "deep_thinking",
+    "math",
+    "code"
+  ],
+  "defaultTemperature": 1.2,
+  "defaultTopP": 0.95
+}
+```
+<!-- source-details:end -->
+
+<!-- source-config: compute/providers/xunfei.json -->
+
+| 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `spark-x` | 65536 / 128000 | CNY：未声明 / 未声明 | `modelName`→[xunfei](../SOURCES.md#xunfei) | [xunfei](../SOURCES.md#xunfei) | partial | `e86e73c51d95392d5a755647f74010d21d4b40ab7928853deecbbd39c27a5432` |
+
+### compute/model-specs/xunfei.json
+
+[查看配置](../../../../../compute/model-specs/xunfei.json) · [接入面说明](../access/model-specs--xunfei.md)
+
+当前配置详情（不是全部官网确认值；routing 是本仓策略）：
+
+<!-- source-details: {"config":"compute/model-specs/xunfei.json","id":"spark-x"} -->
+```json
+{
+  "spec.contextWindow": 65536,
+  "spec.maxOutputTokens": 128000,
+  "spec.serviceType": [
+    "reasoning"
+  ],
+  "spec.capabilities": [
+    "chat",
+    "reasoning",
+    "deep_thinking",
+    "math",
+    "code"
+  ],
+  "spec.supportsReasoning": true,
+  "spec.defaultTemperature": 1.2
+}
+```
+<!-- source-details:end -->
+
+<!-- source-config: compute/model-specs/xunfei.json -->
+
+| 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `spark-x` | 65536 / 128000 | 非计价主数据 | `id`→[xunfei](../SOURCES.md#xunfei) | [xunfei](../SOURCES.md#xunfei) | partial | `12a6e5633db6604800f759bf1a6323ccc745fd574af632d937f67b6efb08754a` |
+
+## 下次更新核查
+
+- 对照官网核查精确 ID／别名、是否仍列出、上下文／输入／输出限制及单位。
+- 分别核查推理档位、默认值、是否可关闭思考、采样和强制工具选择限制、多模态输入／输出。
+- 按本接入面核对价格、缓存、阶梯／峰谷、套餐支持；不能把其他平台参数直接复制。
+- 只更新真正复核的字段与引用来源；保留其余待核实项及历史记录。
+- 同步对应 canonical JSON、回归和模型指纹，再运行来源校验。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "xunfei",
+  "checkedAt": "2026-10-03",
+  "sourceCatalog": "../SOURCES.md"
+}
+```
+<!-- source-metadata:end -->