fix(data): complete verified contracts and source maintenance (#114)

2026-10-21 05:04:44 +08:00 · 2026-10-03 03:49:55 -07:00
parent 647d6f0cfd
commit 642985e819
208 changed files with 5313 additions and 2285 deletions
--- a/docs/model-sources/providers/xunfei/AUDIT.md
+++ b/docs/model-sources/providers/xunfei/AUDIT.md
@@ -0,0 +1,29 @@
+# xunfei：数据闭环核查
+
+[供应商索引](README.md) · [官网证据](SOURCES.md) · [总体计划](../../../data-maintenance/PLAN.md)
+
+核查日期：2026-10-03。本记录是维护任务清单，不替代单模型字段证明。
+
+## 本轮结论
+
+X2 官方 HTTP 文档明确 /x2/chat/completions、spark-x、65536 输入、131072 输出和采样默认值。旧 /v1 与 X2 不能混用。
+
+新增独立 X2 接入，旧 Provider 保留 Ultra 并 tombstone 错放的 spark-x；修正共享规格和展示名。实际账号调用、动态 thinking 请求转译仍需客户端验收；不声称旧 Ultra 参数已核。
+
+## 官方入口读取
+
+| 来源 | 本次结果 | 读取说明 |
+| --- | --- | --- |
+| [xunfei](https://www.xfyun.cn/doc/spark/X1http.html) | 正文已读取 | 121939 字节；摘要与 SOURCES.md 同步 |
+
+## 完成边界
+
+当前单接入面记录：4 条；pending 2、partial 2、historical 0。partial 只证明已列字段。
+
+下一步按各 models 文件逐字段核实；有收费账号授权后做聚焦请求、流式、工具和费用验收。官网读取失败、页面壳与平台差异均不得自动提升为已核实。
+
+## 本轮最终记录统计
+
+本仓记录 4 条：pending 2、partial 2、historical 0；partial 中仅 ID 证明 0 条。此统计反映字段证明覆盖，不是账号调用或整条参数通过数量。
+
+总窗口未公开：现有 contextWindow=65536 是保守输入预算，不是官网总窗口证明；字段级引用已移除该证明。独立 maxInput 表达需客户端支持后再声明。
--- a/docs/model-sources/providers/xunfei/README.md
+++ b/docs/model-sources/providers/xunfei/README.md
@@ -1,12 +1,13 @@
 # 讯飞星火：来源导航

-[总索引](../../README.md) · [官网证据与边界](SOURCES.md)
+[总索引](../../README.md) · [官网证据与边界](SOURCES.md) · [数据闭环核查](AUDIT.md)

-本目录包含 2 个单模型文件、2 个单接入面文件。核验日期与状态来自迁移前记录。
+本目录包含 2 个单模型文件、3 个单接入面文件。核验日期与状态来自迁移前记录。

 ## 接入面

 - [compute/providers/xunfei.json](access/providers--xunfei.md)
+- [compute/providers/xunfei-x2.json](access/providers--xunfei-x2.md)
 - [compute/model-specs/xunfei.json](access/model-specs--xunfei.md)

 ## 模型
--- a/docs/model-sources/providers/xunfei/SOURCES.md
+++ b/docs/model-sources/providers/xunfei/SOURCES.md
@@ -13,6 +13,8 @@

 ## 已知边界与核验说明

+X2 的 65536 是最大输入，不是已公开的总窗口；本仓 contextWindow 保留为现有客户端的保守预算，未登记为已核字段。输出上限有明文整数 131072。独立最大输入预算须按客户端/schema 兼容规范另行完成。
+
 已登记官方入口并尝试读取。表中仅标为已核字段的部分有此次核对记录；其余存量参数待逐字段复核。

 状态 `partial` 仅表示列出的字段已核实；不能推断整条配置、价格、账号权限或真实模型调用都已验收。`pending` 没有已核字段；`historical` 只作历史兼容参考。路由 tier/priority、产品标签和默认选择属于本仓策略，不伪装成官网数据。
--- a/docs/model-sources/providers/xunfei/access/providers--xunfei-x2.md
+++ b/docs/model-sources/providers/xunfei/access/providers--xunfei-x2.md
@@ -0,0 +1,42 @@
+# 讯飞星火：xunfei-x2 接入面
+
+[供应商索引](../README.md) · [官网证据](../SOURCES.md)
+
+- 配置文件：[compute/providers/xunfei-x2.json](../../../../../compute/providers/xunfei-x2.json)
+- 核验日期：2026-10-03。
+- 接入类别：`providers`。
+
+## 平台配置快照
+
+- API 协议：`openai-completions`。
+- 端点：`https://spark-api-open.xf-yun.com/x2`。
+- 计价币种：`CNY`。
+- 访问模式：`普通 API`。
+
+官方 HTTP 文档明确 X2 使用 `/x2/chat/completions`，输入 65536、输出上限 131072，通用 Bearer 认证与 OpenAI Chat/SSE 形状。未执行账号调用；不与旧 `/v1` 的 Ultra 模型混用端点。
+
+以上是配置快照，不能据此宣布该端点或账号已实际验收。核查地域、套餐支持、凭据来源及协议时，对照官网证据目录并记录结论。
+
+<!-- source-config: compute/providers/xunfei-x2.json -->
+<!-- source-config-fingerprint: f4675c8f311b69a932ce2fdcb332ecc899e77c24d3ddf6cd32f348b04d092d40 -->
+
+## 关联模型
+
+- [`spark-x`](../models/spark-x.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
@@ -16,11 +16,10 @@
 以上是配置快照，不能据此宣布该端点或账号已实际验收。核查地域、套餐支持、凭据来源及协议时，对照官网证据目录并记录结论。

 <!-- source-config: compute/providers/xunfei.json -->
-<!-- source-config-fingerprint: d3a6cf19f2ba08c91c3637e19aec7de281c5ce375ce63c91557791cc7b759531 -->
+<!-- source-config-fingerprint: e7a7a73843f27ab120c010871d3bc851fc1b121ff9bb9809bcaf2fd1caa65afb -->

 ## 关联模型

- [`spark-x`](../models/spark-x.md)
 - [`4.0Ultra`](../models/4.0ultra.md)

 ## 更新前检查
--- a/docs/model-sources/providers/xunfei/models/spark-x.md
+++ b/docs/model-sources/providers/xunfei/models/spark-x.md
@@ -3,28 +3,28 @@
 [供应商索引](../README.md) · [官网证据目录](../SOURCES.md)

 - 精确模型 ID：`spark-x`。
- 核验日期：2026-10-03；本次只迁移记录，没有重新核验或提高状态。
+- 核验日期：2026-10-03；本轮复核仅限下表已核字段，其余仍待核实。

 ## 适用接入面

- [compute/providers/xunfei.json](../access/providers--xunfei.md)
+- [compute/providers/xunfei-x2.json](../access/providers--xunfei-x2.md)
 - [compute/model-specs/xunfei.json](../access/model-specs--xunfei.md)

 ## 字段级来源记录

 各接入面分开记录；价格为 inputPrice/outputPrice 快照，具体单位和限制看配置及引用官网。partial 只确认已列字段，不代表全部参数、平台可用性或账号调用已验收。

-### compute/providers/xunfei.json
+### compute/providers/xunfei-x2.json

-[查看配置](../../../../../compute/providers/xunfei.json) · [接入面说明](../access/providers--xunfei.md)
+[查看配置](../../../../../compute/providers/xunfei-x2.json) · [接入面说明](../access/providers--xunfei-x2.md)

 当前配置详情（不是全部官网确认值；routing 是本仓策略）：

-<!-- source-details: {"config":"compute/providers/xunfei.json","id":"spark-x"} -->
+<!-- source-details: {"config":"compute/providers/xunfei-x2.json","id":"spark-x"} -->
 ```json
 {
  "contextWindow": 65536,
-  "maxOutputTokens": 128000,
+  "maxOutputTokens": 131072,
  "serviceType": [
    "reasoning"
  ],
@@ -33,19 +33,21 @@
    "reasoning",
    "deep_thinking",
    "math",
-    "code"
+    "code",
+    "tool_use"
  ],
  "defaultTemperature": 1.2,
-  "defaultTopP": 0.95
+  "defaultTopP": 0.95,
+  "modelName": "spark-x"
 }
 ```
 <!-- source-details:end -->

-<!-- source-config: compute/providers/xunfei.json -->
+<!-- source-config: compute/providers/xunfei-x2.json -->

 | 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
 | --- | --- | --- | --- | --- | --- | --- |
-| `spark-x` | 65536 / 128000 | CNY：未声明 / 未声明 | `modelName`→[xunfei](../SOURCES.md#xunfei) | [xunfei](../SOURCES.md#xunfei) | partial | `e86e73c51d95392d5a755647f74010d21d4b40ab7928853deecbbd39c27a5432` |
+| `spark-x` | 65536 / 131072 | CNY：未声明 / 未声明 | `modelName`→[xunfei](../SOURCES.md#xunfei), `maxOutputTokens`→[xunfei](../SOURCES.md#xunfei), `defaultTemperature`→[xunfei](../SOURCES.md#xunfei), `defaultTopP`→[xunfei](../SOURCES.md#xunfei) | [xunfei](../SOURCES.md#xunfei) | partial | `3915d411151bb2d2a39e4c79ae8ced199358eda45ad3df7de9237ff713012c84` |

 ### compute/model-specs/xunfei.json

@@ -57,7 +59,7 @@
 ```json
 {
  "spec.contextWindow": 65536,
-  "spec.maxOutputTokens": 128000,
+  "spec.maxOutputTokens": 131072,
  "spec.serviceType": [
    "reasoning"
  ],
@@ -66,10 +68,12 @@
    "reasoning",
    "deep_thinking",
    "math",
-    "code"
+    "code",
+    "tool_use"
  ],
  "spec.supportsReasoning": true,
-  "spec.defaultTemperature": 1.2
+  "spec.defaultTemperature": 1.2,
+  "id": "spark-x"
 }
 ```
 <!-- source-details:end -->
@@ -78,7 +82,11 @@

 | 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
 | --- | --- | --- | --- | --- | --- | --- |
-| `spark-x` | 65536 / 128000 | 非计价主数据 | `id`→[xunfei](../SOURCES.md#xunfei) | [xunfei](../SOURCES.md#xunfei) | partial | `12a6e5633db6604800f759bf1a6323ccc745fd574af632d937f67b6efb08754a` |
+| `spark-x` | 65536 / 131072 | 非计价主数据 | `id`→[xunfei](../SOURCES.md#xunfei), `spec.maxOutputTokens`→[xunfei](../SOURCES.md#xunfei), `spec.defaultTemperature`→[xunfei](../SOURCES.md#xunfei) | [xunfei](../SOURCES.md#xunfei) | partial | `8706b7fa604391f173d6adaa415343ca0b846618c7ecd4e0630dd20bbc957e17` |
+
+## 输入与总窗口边界
+
+官方说明的是输入 65536、输出 131072 两个独立限制，没有声明总上下文窗口。当前 contextWindow=65536 沿用为客户端保守输入预算，不将它登记为已核总窗口；需客户端独立最大输入字段后再正确表达此合同。

 ## 下次更新核查