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 05:24:25 +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/xai/models/grok-4-1-fast-reasoning.md
+++ b/docs/model-sources/providers/xai/models/grok-4-1-fast-reasoning.md
@@ -0,0 +1,69 @@
+# grok-4-1-fast-reasoning：模型来源与接入记录
+
+[供应商索引](../README.md) · [官网证据目录](../SOURCES.md)
+
+- 精确模型 ID：`grok-4-1-fast-reasoning`。
+- 核验日期：2026-10-03；本次只迁移记录，没有重新核验或提高状态。
+
+## 适用接入面
+
+- [compute/model-specs/xai.json](../access/model-specs--xai.md)
+
+## 字段级来源记录
+
+各接入面分开记录；价格为 inputPrice/outputPrice 快照，具体单位和限制看配置及引用官网。partial 只确认已列字段，不代表全部参数、平台可用性或账号调用已验收。
+
+### compute/model-specs/xai.json
+
+[查看配置](../../../../../compute/model-specs/xai.json) · [接入面说明](../access/model-specs--xai.md)
+
+当前配置详情（不是全部官网确认值；routing 是本仓策略）：
+
+<!-- source-details: {"config":"compute/model-specs/xai.json","id":"grok-4-1-fast-reasoning"} -->
+```json
+{
+  "spec.contextWindow": 2000000,
+  "spec.maxOutputTokens": 16384,
+  "spec.serviceType": [
+    "chat",
+    "reasoning"
+  ],
+  "spec.capabilities": [
+    "chat",
+    "reasoning",
+    "code",
+    "vision",
+    "tool_use",
+    "fast",
+    "long_context"
+  ],
+  "spec.supportsReasoning": true,
+  "spec.defaultTemperature": 1
+}
+```
+<!-- source-details:end -->
+
+<!-- source-config: compute/model-specs/xai.json -->
+
+| 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `grok-4-1-fast-reasoning` | 2000000 / 16384 | 非计价主数据 | 待核实 | [xai](../SOURCES.md#xai) | pending | `3f57f33f10d210e6c29e8ed64ef741e9ff5d7b4eb5793ed3636c7cf0dd9b64ef` |
+
+## 下次更新核查
+
+- 对照官网核查精确 ID／别名、是否仍列出、上下文／输入／输出限制及单位。
+- 分别核查推理档位、默认值、是否可关闭思考、采样和强制工具选择限制、多模态输入／输出。
+- 按本接入面核对价格、缓存、阶梯／峰谷、套餐支持；不能把其他平台参数直接复制。
+- 只更新真正复核的字段与引用来源；保留其余待核实项及历史记录。
+- 同步对应 canonical JSON、回归和模型指纹，再运行来源校验。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "xai",
+  "checkedAt": "2026-10-03",
+  "sourceCatalog": "../SOURCES.md"
+}
+```
+<!-- source-metadata:end -->
--- a/docs/model-sources/providers/xai/models/grok-4-3.md
+++ b/docs/model-sources/providers/xai/models/grok-4-3.md
@@ -0,0 +1,64 @@
+# grok-4-3：模型来源与接入记录
+
+[供应商索引](../README.md) · [官网证据目录](../SOURCES.md)
+
+- 精确模型 ID：`grok-4-3`。
+- 核验日期：2026-10-03；本次只迁移记录，没有重新核验或提高状态。
+
+## 适用接入面
+
+- [compute/model-specs/xai.json](../access/model-specs--xai.md)
+
+## 字段级来源记录
+
+各接入面分开记录；价格为 inputPrice/outputPrice 快照，具体单位和限制看配置及引用官网。partial 只确认已列字段，不代表全部参数、平台可用性或账号调用已验收。
+
+### compute/model-specs/xai.json
+
+[查看配置](../../../../../compute/model-specs/xai.json) · [接入面说明](../access/model-specs--xai.md)
+
+当前配置详情（不是全部官网确认值；routing 是本仓策略）：
+
+<!-- source-details: {"config":"compute/model-specs/xai.json","id":"grok-4-3"} -->
+```json
+{
+  "spec.contextWindow": 1000000,
+  "spec.serviceType": [
+    "chat"
+  ],
+  "spec.capabilities": [
+    "reasoning",
+    "code",
+    "vision",
+    "tool_use",
+    "long_context"
+  ],
+  "spec.supportsReasoning": true
+}
+```
+<!-- source-details:end -->
+
+<!-- source-config: compute/model-specs/xai.json -->
+
+| 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `grok-4-3` | 1000000 / 未声明 | 非计价主数据 | 待核实 | [xai](../SOURCES.md#xai) | pending | `3a98611d4bdf605df812b42990f46e24f033ba5a671a0920011feb103954fffe` |
+
+## 下次更新核查
+
+- 对照官网核查精确 ID／别名、是否仍列出、上下文／输入／输出限制及单位。
+- 分别核查推理档位、默认值、是否可关闭思考、采样和强制工具选择限制、多模态输入／输出。
+- 按本接入面核对价格、缓存、阶梯／峰谷、套餐支持；不能把其他平台参数直接复制。
+- 只更新真正复核的字段与引用来源；保留其余待核实项及历史记录。
+- 同步对应 canonical JSON、回归和模型指纹，再运行来源校验。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "xai",
+  "checkedAt": "2026-10-03",
+  "sourceCatalog": "../SOURCES.md"
+}
+```
+<!-- source-metadata:end -->
--- a/docs/model-sources/providers/xai/models/grok-4.20-0309-reasoning.md
+++ b/docs/model-sources/providers/xai/models/grok-4.20-0309-reasoning.md
@@ -0,0 +1,106 @@
+# grok-4.20-0309-reasoning：模型来源与接入记录
+
+[供应商索引](../README.md) · [官网证据目录](../SOURCES.md)
+
+- 精确模型 ID：`grok-4.20-0309-reasoning`。
+- 核验日期：2026-10-03；本次只迁移记录，没有重新核验或提高状态。
+
+## 适用接入面
+
+- [compute/providers/xai.json](../access/providers--xai.md)
+- [compute/model-specs/xai.json](../access/model-specs--xai.md)
+
+## 字段级来源记录
+
+各接入面分开记录；价格为 inputPrice/outputPrice 快照，具体单位和限制看配置及引用官网。partial 只确认已列字段，不代表全部参数、平台可用性或账号调用已验收。
+
+### compute/providers/xai.json
+
+[查看配置](../../../../../compute/providers/xai.json) · [接入面说明](../access/providers--xai.md)
+
+当前配置详情（不是全部官网确认值；routing 是本仓策略）：
+
+<!-- source-details: {"config":"compute/providers/xai.json","id":"grok-4.20-0309-reasoning"} -->
+```json
+{
+  "contextWindow": 1000000,
+  "maxOutputTokens": 16384,
+  "serviceType": [
+    "chat",
+    "reasoning"
+  ],
+  "capabilities": [
+    "chat",
+    "reasoning",
+    "vision",
+    "tool_use",
+    "structured_output",
+    "long_context"
+  ],
+  "defaultTemperature": 1,
+  "defaultTopP": 1,
+  "inputPrice": 1.25,
+  "outputPrice": 2.5,
+  "extra.cachedInputPrice": 0.2
+}
+```
+<!-- source-details:end -->
+
+<!-- source-config: compute/providers/xai.json -->
+
+| 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `grok-4.20-0309-reasoning` | 1000000 / 16384 | USD：1.25 / 2.5 | 待核实 | [xai](../SOURCES.md#xai) | pending | `851263210eebad330fe7ca416787515facad734fb78327e18e7bda7c343b209e` |
+
+### compute/model-specs/xai.json
+
+[查看配置](../../../../../compute/model-specs/xai.json) · [接入面说明](../access/model-specs--xai.md)
+
+当前配置详情（不是全部官网确认值；routing 是本仓策略）：
+
+<!-- source-details: {"config":"compute/model-specs/xai.json","id":"grok-4.20-0309-reasoning"} -->
+```json
+{
+  "spec.contextWindow": 2000000,
+  "spec.maxOutputTokens": 16384,
+  "spec.serviceType": [
+    "chat",
+    "reasoning"
+  ],
+  "spec.capabilities": [
+    "chat",
+    "reasoning",
+    "code",
+    "vision",
+    "tool_use"
+  ],
+  "spec.supportsReasoning": true,
+  "spec.defaultTemperature": 1
+}
+```
+<!-- source-details:end -->
+
+<!-- source-config: compute/model-specs/xai.json -->
+
+| 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `grok-4.20-0309-reasoning` | 2000000 / 16384 | 非计价主数据 | 待核实 | [xai](../SOURCES.md#xai) | pending | `f08001fea5c3b53121767acc43c4563df1abac7cb4320affc28ec6e2806d9d28` |
+
+## 下次更新核查
+
+- 对照官网核查精确 ID／别名、是否仍列出、上下文／输入／输出限制及单位。
+- 分别核查推理档位、默认值、是否可关闭思考、采样和强制工具选择限制、多模态输入／输出。
+- 按本接入面核对价格、缓存、阶梯／峰谷、套餐支持；不能把其他平台参数直接复制。
+- 只更新真正复核的字段与引用来源；保留其余待核实项及历史记录。
+- 同步对应 canonical JSON、回归和模型指纹，再运行来源校验。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "xai",
+  "checkedAt": "2026-10-03",
+  "sourceCatalog": "../SOURCES.md"
+}
+```
+<!-- source-metadata:end -->
--- a/docs/model-sources/providers/xai/models/grok-4.3.md
+++ b/docs/model-sources/providers/xai/models/grok-4.3.md
@@ -0,0 +1,70 @@
+# grok-4.3：模型来源与接入记录
+
+[供应商索引](../README.md) · [官网证据目录](../SOURCES.md)
+
+- 精确模型 ID：`grok-4.3`。
+- 核验日期：2026-10-03；本次只迁移记录，没有重新核验或提高状态。
+
+## 适用接入面
+
+- [compute/providers/xai.json](../access/providers--xai.md)
+
+## 字段级来源记录
+
+各接入面分开记录；价格为 inputPrice/outputPrice 快照，具体单位和限制看配置及引用官网。partial 只确认已列字段，不代表全部参数、平台可用性或账号调用已验收。
+
+### compute/providers/xai.json
+
+[查看配置](../../../../../compute/providers/xai.json) · [接入面说明](../access/providers--xai.md)
+
+当前配置详情（不是全部官网确认值；routing 是本仓策略）：
+
+<!-- source-details: {"config":"compute/providers/xai.json","id":"grok-4.3"} -->
+```json
+{
+  "contextWindow": 1000000,
+  "serviceType": [
+    "chat",
+    "reasoning"
+  ],
+  "capabilities": [
+    "chat",
+    "reasoning",
+    "vision",
+    "tool_use",
+    "structured_output",
+    "long_context"
+  ],
+  "defaultTemperature": 1,
+  "defaultTopP": 1,
+  "inputPrice": 1.25,
+  "outputPrice": 2.5,
+  "extra.cachedInputPrice": 0.2
+}
+```
+<!-- source-details:end -->
+
+<!-- source-config: compute/providers/xai.json -->
+
+| 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `grok-4.3` | 1000000 / 未声明 | USD：1.25 / 2.5 | 待核实 | [xai](../SOURCES.md#xai) | pending | `bd07b22c70b23607ba3a86737f6ae7b54ea1ca53949ddbb693724bfad1d627d9` |
+
+## 下次更新核查
+
+- 对照官网核查精确 ID／别名、是否仍列出、上下文／输入／输出限制及单位。
+- 分别核查推理档位、默认值、是否可关闭思考、采样和强制工具选择限制、多模态输入／输出。
+- 按本接入面核对价格、缓存、阶梯／峰谷、套餐支持；不能把其他平台参数直接复制。
+- 只更新真正复核的字段与引用来源；保留其余待核实项及历史记录。
+- 同步对应 canonical JSON、回归和模型指纹，再运行来源校验。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "xai",
+  "checkedAt": "2026-10-03",
+  "sourceCatalog": "../SOURCES.md"
+}
+```
+<!-- source-metadata:end -->
--- a/docs/model-sources/providers/xai/models/grok-4.5.md
+++ b/docs/model-sources/providers/xai/models/grok-4.5.md
@@ -0,0 +1,69 @@
+# grok-4.5：模型来源与接入记录
+
+[供应商索引](../README.md) · [官网证据目录](../SOURCES.md)
+
+- 精确模型 ID：`grok-4.5`。
+- 核验日期：2026-10-03；本次只迁移记录，没有重新核验或提高状态。
+
+## 适用接入面
+
+- [compute/model-specs/xai.json](../access/model-specs--xai.md)
+
+## 字段级来源记录
+
+各接入面分开记录；价格为 inputPrice/outputPrice 快照，具体单位和限制看配置及引用官网。partial 只确认已列字段，不代表全部参数、平台可用性或账号调用已验收。
+
+### compute/model-specs/xai.json
+
+[查看配置](../../../../../compute/model-specs/xai.json) · [接入面说明](../access/model-specs--xai.md)
+
+当前配置详情（不是全部官网确认值；routing 是本仓策略）：
+
+<!-- source-details: {"config":"compute/model-specs/xai.json","id":"grok-4.5"} -->
+```json
+{
+  "spec.contextWindow": 500000,
+  "spec.maxOutputTokens": 450000,
+  "spec.serviceType": [
+    "chat",
+    "reasoning"
+  ],
+  "spec.capabilities": [
+    "chat",
+    "reasoning",
+    "code",
+    "vision",
+    "long_context",
+    "tool_use"
+  ],
+  "spec.supportsReasoning": true,
+  "spec.releasedAt": "2026-07-08",
+  "spec.extra.thinkingOnly": true
+}
+```
+<!-- source-details:end -->
+
+<!-- source-config: compute/model-specs/xai.json -->
+
+| 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `grok-4.5` | 500000 / 450000 | 非计价主数据 | 待核实 | [xai](../SOURCES.md#xai) | pending | `3ce065e502bf8d1e6297adee096f6b4a7111ec0a0044f7e0184c0956528735a4` |
+
+## 下次更新核查
+
+- 对照官网核查精确 ID／别名、是否仍列出、上下文／输入／输出限制及单位。
+- 分别核查推理档位、默认值、是否可关闭思考、采样和强制工具选择限制、多模态输入／输出。
+- 按本接入面核对价格、缓存、阶梯／峰谷、套餐支持；不能把其他平台参数直接复制。
+- 只更新真正复核的字段与引用来源；保留其余待核实项及历史记录。
+- 同步对应 canonical JSON、回归和模型指纹，再运行来源校验。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "xai",
+  "checkedAt": "2026-10-03",
+  "sourceCatalog": "../SOURCES.md"
+}
+```
+<!-- source-metadata:end -->
--- a/docs/model-sources/providers/xai/models/grok-4.7.md
+++ b/docs/model-sources/providers/xai/models/grok-4.7.md
@@ -0,0 +1,126 @@
+# grok-4.7：模型来源与接入记录
+
+[供应商索引](../README.md) · [官网证据目录](../SOURCES.md)
+
+- 精确模型 ID：`grok-4.7`。
+- 核验日期：2026-10-03；本次只迁移记录，没有重新核验或提高状态。
+
+## 适用接入面
+
+- [compute/providers/xai.json](../access/providers--xai.md)
+- [compute/model-specs/xai.json](../access/model-specs--xai.md)
+
+## 字段级来源记录
+
+各接入面分开记录；价格为 inputPrice/outputPrice 快照，具体单位和限制看配置及引用官网。partial 只确认已列字段，不代表全部参数、平台可用性或账号调用已验收。
+
+### compute/providers/xai.json
+
+[查看配置](../../../../../compute/providers/xai.json) · [接入面说明](../access/providers--xai.md)
+
+当前配置详情（不是全部官网确认值；routing 是本仓策略）：
+
+<!-- source-details: {"config":"compute/providers/xai.json","id":"grok-4.7"} -->
+```json
+{
+  "contextWindow": 500000,
+  "serviceType": [
+    "chat",
+    "reasoning"
+  ],
+  "capabilities": [
+    "chat",
+    "reasoning",
+    "code",
+    "vision",
+    "tool_use",
+    "structured_output",
+    "long_context"
+  ],
+  "inputPrice": 2,
+  "outputPrice": 6,
+  "extra.reasoning": {
+    "supportedEfforts": [
+      "low",
+      "medium",
+      "high",
+      "xhigh"
+    ],
+    "defaultEffort": "high"
+  },
+  "extra.cachedInputPrice": 0.5,
+  "extra.pricingNotes": "Prices are per 1M tokens below 200K prompt tokens; above 200K, input and cache rates are 2x and output rates are 2x. No text output limit is documented."
+}
+```
+<!-- source-details:end -->
+
+<!-- source-config: compute/providers/xai.json -->
+
+| 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `grok-4.7` | 500000 / 未声明 | USD：2 / 6 | `modelName`→[xai](../SOURCES.md#xai) | [xai](../SOURCES.md#xai) | partial | `5fd96154879e4600be87236cf9a12b2c3026dd6286d4288afcb70edd7e9e6661` |
+
+### compute/model-specs/xai.json
+
+[查看配置](../../../../../compute/model-specs/xai.json) · [接入面说明](../access/model-specs--xai.md)
+
+当前配置详情（不是全部官网确认值；routing 是本仓策略）：
+
+<!-- source-details: {"config":"compute/model-specs/xai.json","id":"grok-4.7"} -->
+```json
+{
+  "spec.contextWindow": 500000,
+  "spec.serviceType": [
+    "chat",
+    "reasoning"
+  ],
+  "spec.capabilities": [
+    "chat",
+    "reasoning",
+    "code",
+    "vision",
+    "tool_use",
+    "long_context"
+  ],
+  "spec.supportsReasoning": true,
+  "routing.tier": "flagship",
+  "routing.routingPriority": 30,
+  "routing.eligibleForAgent": true,
+  "routing.reasoning": {
+    "supportedModes": [
+      "auto",
+      "low",
+      "medium",
+      "high",
+      "xhigh"
+    ],
+    "defaultMode": "high"
+  }
+}
+```
+<!-- source-details:end -->
+
+<!-- source-config: compute/model-specs/xai.json -->
+
+| 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `grok-4.7` | 500000 / 未声明 | 非计价主数据 | `id`→[xai](../SOURCES.md#xai) | [xai](../SOURCES.md#xai) | partial | `a5d32750e0ae4157df10b5e495e002d64ceff291f57d2972421249942f8d3606` |
+
+## 下次更新核查
+
+- 对照官网核查精确 ID／别名、是否仍列出、上下文／输入／输出限制及单位。
+- 分别核查推理档位、默认值、是否可关闭思考、采样和强制工具选择限制、多模态输入／输出。
+- 按本接入面核对价格、缓存、阶梯／峰谷、套餐支持；不能把其他平台参数直接复制。
+- 只更新真正复核的字段与引用来源；保留其余待核实项及历史记录。
+- 同步对应 canonical JSON、回归和模型指纹，再运行来源校验。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "xai",
+  "checkedAt": "2026-10-03",
+  "sourceCatalog": "../SOURCES.md"
+}
+```
+<!-- source-metadata:end -->
--- a/docs/model-sources/providers/xai/models/grok-build-0.1.md
+++ b/docs/model-sources/providers/xai/models/grok-build-0.1.md
@@ -0,0 +1,68 @@
+# grok-build-0.1：模型来源与接入记录
+
+[供应商索引](../README.md) · [官网证据目录](../SOURCES.md)
+
+- 精确模型 ID：`grok-build-0.1`。
+- 核验日期：2026-10-03；本次只迁移记录，没有重新核验或提高状态。
+
+## 适用接入面
+
+- [compute/providers/xai.json](../access/providers--xai.md)
+
+## 字段级来源记录
+
+各接入面分开记录；价格为 inputPrice/outputPrice 快照，具体单位和限制看配置及引用官网。partial 只确认已列字段，不代表全部参数、平台可用性或账号调用已验收。
+
+### compute/providers/xai.json
+
+[查看配置](../../../../../compute/providers/xai.json) · [接入面说明](../access/providers--xai.md)
+
+当前配置详情（不是全部官网确认值；routing 是本仓策略）：
+
+<!-- source-details: {"config":"compute/providers/xai.json","id":"grok-build-0.1"} -->
+```json
+{
+  "contextWindow": 256000,
+  "serviceType": [
+    "chat"
+  ],
+  "capabilities": [
+    "chat",
+    "code",
+    "agent",
+    "tool_use",
+    "structured_output"
+  ],
+  "defaultTemperature": 1,
+  "defaultTopP": 1,
+  "inputPrice": 1,
+  "outputPrice": 2,
+  "extra.cachedInputPrice": 0.2
+}
+```
+<!-- source-details:end -->
+
+<!-- source-config: compute/providers/xai.json -->
+
+| 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `grok-build-0.1` | 256000 / 未声明 | USD：1 / 2 | `modelName`→[xai](../SOURCES.md#xai) | [xai](../SOURCES.md#xai) | partial | `3a28f38bc86c8f91091c92e616466f353a21fa64dd088e60ce2261ea9011f75c` |
+
+## 下次更新核查
+
+- 对照官网核查精确 ID／别名、是否仍列出、上下文／输入／输出限制及单位。
+- 分别核查推理档位、默认值、是否可关闭思考、采样和强制工具选择限制、多模态输入／输出。
+- 按本接入面核对价格、缓存、阶梯／峰谷、套餐支持；不能把其他平台参数直接复制。
+- 只更新真正复核的字段与引用来源；保留其余待核实项及历史记录。
+- 同步对应 canonical JSON、回归和模型指纹，再运行来源校验。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "xai",
+  "checkedAt": "2026-10-03",
+  "sourceCatalog": "../SOURCES.md"
+}
+```
+<!-- source-metadata:end -->