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

docs/data-maintenance/CLIENT-DEPENDENCIES.md

@@ -0,0 +1,37 @@
+# 需要客户端或账号验收的数据任务
+
+[维护计划](PLAN.md) · [执行结果](RESULTS.md)
+
+本轮只修改 config-center。以下事项不因单模型官网字段已核或本仓校验通过而视为客户端已实现。
+
+## 原生协议接入
+
+| 原厂/型号 | 本仓状态 | 实施步骤与验收条件 |
+| --- | --- | --- |
+| Google：gemini-3.8-flash-tts、gemini-3.8-flash-lite-tts | 原生语音型号仅共享规格 | 核音频响应和输入/输出独立预算；实现原生请求、音频解码、流式与声音参数；固定 fixture 后用授权账号验证，再设置已支持的客户端版本门槛并增加 Provider |
+| Google：gemini-3.8-live、gemini-3.8-live-extended-thinking | 原生 Live 规格 | 核 WebSocket 会话、身份验证、实时输入/输出和中断；验证流式事件、断线重连及工具事件；不能放入普通 Chat Completions Provider |
+| Google：gemini-3.5-transcribe、gemini-3.5-transcribe-live | 转写规格 | 实现文件/流式转写、语言检测、时间戳、说话人字段与错误处理；验收音频时长/格式/费用，不把它们当普通文本 Chat |
+| MiniMax：MiniMax-H3、MiniMax-H3-Max | 视频 V2 共享规格 | 核 submit/query 原生任务、参数约束、时长/分辨率与下载结果；完成异步轮询和计费后单独接入，不通过 Anthropic Messages |
+| Kling：kling-3.0-turbo | 新协议共享规格，官网入口页面壳 | 先获取可读取官方任务 API 合同，再实现 submit/query、凭据、视频参数和超时；既有 kling-v3 名称不证明新型号同协议 |
+| Cohere：rerank-v3.5、rerank-v4.0-pro、rerank-v4.0-fast | 原生共享规格，兼容 Provider 不提供 Rerank | 核原生 /v2/rerank、query/documents/top_n/返回排序和 search unit 单位；从客户端计费到响应映射独立验收后再增加接入 |
+| Cohere：Embed 4/5 的多模态与可选维度 | 原生能力与文本兼容端点分开 | 原生文本/图片/PDF输入、返回默认/指定维度和费用分别验收；兼容端点不发送 dimensions |
+| Cohere：north-mini-code-1-0、north-small-translate-1-0 | 原厂精确 ID 共享规格 | 核原生 Chat 与兼容 API 开放名单和账号授权，验证窗口/输出明文整数；旧 north-mini-code 仅本仓历史匹配，不作为调用实参 |
+| Stability：stable-audio-3.0 | 发布公告与共享规格 | 获取官方 API 身份、音频参数、输出形状和计价；授权账号验收后接入，不凭发布公告推算端点 |
+| Tencent：hy4-preview | 原厂规格；OpenRouter 已有独立前缀接入 | 国内 Hunyuan、TokenHub、OpenRouter 的 ID/币种/窗口分别核；不把 Tencent 新闻价格直接填国内现有 Provider |
+| Perplexity：Agent API | 旧 Sonar 同步/流式兼容保留 | 实现 /v1/agent 的 input/preset、typed output、search_results、工具/背景任务和费用；对照旧同步兼容响应回归，不能只换 model 字符串 |
+
+## 预算、安装和默认策略
+
+| 事项 | 当前处理 | 后续完成条件 |
+| --- | --- | --- |
+| GPT-5.4 Mini/Nano 独立输入预算 | 总窗口不冒充最大输入，官方输入 272000/总窗口 400000 差异已记录 | 客户端独立输入预算字段及 schema 消费；先发布客户端再声明新字段，回归输入截断与输出预留 |
+| GPT-5.4 系列默认 none | supportedEfforts 包含 none，defaultEffort 当前 frozen schema 不接受 none | 复核客户端默认推理模式及现有产品策略；按兼容规范发布支持 none 默认值的客户端，不能先扩本仓 enum |
+| Python 推荐归档与 Hatch pin | 推荐 3.14.8 官网摘要真实；fallback 保留 Hatch 1.16.5 映射 3.14.0 | 首启导入、重复安装/更新幂等、路径识别及 minClientVersion 验收；不能为表面一致修改 pin 表 |
+| 默认 service-map | 原默认保留，完整策略映射绑定校验 | 选取代表性任务与明确费用/延迟预算，比较同接入新旧模型、工具/模态、错误回退；记录测量日期和选择理由后更新默认 |
+| 真实账号调用 | 本轮没有收费账号调用 | 获得对应账号授权后逐接入面做最小请求、流式、工具、推理、媒体任务及用量核对；保存不含凭据的结果摘要 |
+
+## 同步与字段移除边界
+
+本轮对照 DesireCore 远端 main `412e05b043656d1f3ba2b56307ef5ceabbf8a77a`：预置模型合并会用新预置对象替换 preset 模型，保留用户覆写；保护 user-added/synced 模型。共享规格从官方目录重读并替换缓存，不是把 extra 逐键合并到旧规格。因此本轮不下发未证实的 Ox Alpha modelOrigin，未覆盖用户自建配置。
+
+该版本共享规格缓存使用 `_index.json` 的 mtime 失效；本轮同时更新规格索引的批次说明以触发重读。以后修改共享规格时需一并更新索引，或客户端完成更细粒度的缓存失效；不同历史客户端不能据此宣布全部行为已验收。

docs/data-maintenance/PLAN.md

@@ -0,0 +1,34 @@
+# 数据维护闭环计划
+
+核查基线：2026-10-03，远端 main 的 presetDataVersion 125。模型来源登记覆盖 619 条接入面记录，不能等同于 619 个独立模型或完整官网验收。
+
+## 工作拆分与验收
+
+| 工作线 | 现状与影响 | 实施范围 | 验收条件 |
+| --- | --- | --- | --- |
+| 推理合同迁移 | 14 个旧键客户端不读取；不同平台的档位不能共用 | Provider、套餐、共享规格、单模型来源及回归 | 官网核对后使用有效嵌套字段；不遗漏关闭思考限制；清除全部旧键警告 |
+| 临时与历史规格 | GPT-Reserve 借用其他型号参数；Ox Alpha 身份映射待证实 | 临时参数、自动路由资格、历史身份说明 | 保留兼容边界，未证实数据不扩大自动选模；历史记录不冒充当前可用性 |
+| 字段级官网核验 | 301 pending，258 条 partial 仅确认 ID | 每家供应商 SOURCES、单模型参数、接入面差异 | 实际读取官方内容；只提高有明确证据的字段；冲突/失败有逐项后续任务 |
+| 原生协议接入 | 部分新音频、视频、Rerank 只有共享规格 | 本仓型号登记与客户端待办 | 标明协议、依赖、验收方法；未证实客户端支持前不向普通 Provider 上架 |
+| 旧工具退出 | 第三方快照、模糊匹配、硬编码路径可覆盖数据 | tools 历史脚本与维护入口 | 原入口不能覆写主数据；历史可追溯；新流程只以官方证据作为写入依据 |
+| 非模型来源 | 汇率/加价属于本仓策略，搜索 API 契约未被模型来源门禁覆盖 | docs/data-sources、独立校验及回归 | 明确策略含义和官方合同；配置漂移、目录遗漏及错误引用能被检查发现 |
+| 运行时目录 | recommended 与 fallback 更新时间及内容不同 | runtimes、官方来源、可重复刷新脚本 | 核实两者的不同语义；官网版本/下载/摘要有效；刷新不随意更改客户端工具版本 |
+| 默认服务选择 | 新型号发布未必适合替换默认 | service-map 选择依据与后续验收清单 | 引用可解析；默认保留/升级有明确策略，需性能和费用证据时不凭营销直接替换 |
+
+## 并行边界
+
+- 推理与历史工作线独占 OpenAI、xAI、智谱、DeepSeek 和匿名历史规格；百炼套餐中对应 DeepSeek 单条来源由该工作线同步。
+- 工具与非模型工作线独占 tools、docs/data-sources、独立校验、package scripts 和对应测试。
+- 运行时工作线独占 runtimes、docs/runtime-sources、刷新脚本和对应测试。
+- 主工作线负责其余供应商的官网核验、总体来源规则、未完成接入清单、manifest 与最终 review。
+- 所有工作使用同一 checkout，保留 logs 等无关文件；不并行修改同一文件，不在子任务中提交。
+
+## 合并工作线后的门禁
+
+1. 对照最新版 origin/main 确认没有混入其他变更，审查差异中的数据是否有字段级依据。
+2. 运行来源校验、完整配置校验、测试和 git diff --check。
+3. 只有预设数据变化才递增 manifest；文档和工具改造不单独递增。
+4. 逐项报告完成内容、证据限制和跨仓依赖；官网读取、Schema 通过不代替真实账号调用。
+5. 按已有授权完成提交、PR、受保护合并及远端 CI 复查。
+
+后续结果见 [本轮执行记录](RESULTS.md)。每家供应商的具体证据仍保存在各自来源目录，不在此重复拼成总证据表。

docs/data-maintenance/RESULTS.md

@@ -0,0 +1,46 @@
+# 2026-10-03 数据维护执行记录
+
+[详细计划](PLAN.md) · [客户端与账号依赖](CLIENT-DEPENDENCIES.md) · [供应商来源导航](../model-sources/README.md)
+
+预设数据批次：125 → 126。主工作线与三个并行子任务共同核验，最后统一 review。所有事实主证据为官方文档、官方 API 或官方仓库；旧第三方工具不再参与主数据写入。
+
+## 数据变化
+
+本轮相对 main 更新 39 条既有接入面/共享规格记录，新增 3 条、移除 3 条；这是配置记录数，不是独立模型数。身份迁移和端点分离计入新增/移除。
+
+| 范围 | 修改内容 | 验收与边界 |
+| --- | --- | --- |
+| OpenAI、xAI、智谱、百炼 | 清除 14 处不被读取的旧推理键；改为嵌套 supportedEfforts/defaultEffort；补 GPT-5.4 系列 xhigh；GPT-5.4 Pro 默认 medium | 逐接入面官网核实，回归比较完整档位；Grok 同页 xhigh 冲突不擅自增加；none 默认受 frozen schema 限制 |
+| Anthropic | Opus 5、Sonnet 5 默认 xhigh → high；清除三个扁平 defaultEffort，含 Sonnet 5.5 的冲突旧默认 | 直连默认与共享路由策略分开；补单型号规格与 effort 官方来源，订阅权限仍另核 |
+| 临时/匿名身份 | GPT-Reserve 保留手动使用、关闭 Agent 自动资格；Ox Alpha 移除未证实原厂身份映射 | 未获取正式参数不删除用户要求的临时配置，也不让假定参数扩大自动路由 |
+| 讯飞 | 新增独立 /x2 Provider；旧 /v1 保留 Ultra 并墓碑移除错放的 spark-x；X2 展示名与输出上限 131072、函数调用标签同步 | 官网确认 X2/X1.5 同名不同端点；旧账号自建模型受客户端保护；真实请求与 thinking 转译待验收 |
+| Kimi、小米 | K3 国内输入/输出/缓存命中 20/100/2 CNY 每百万 token；MiMo V2.5 Pro 3/6/0.025 补齐 | 国内官方价格，不换算国际美元；MiMo 保留到已记录的退役日，不提前删除 |
+| 百度套餐 | 移除 ERNIE 4.5 套餐图像理解标签；GLM 5.1 抵扣说明由 ×6 改为高峰 ×4 /低峰 ×3 | 官方套餐 FAQ 与原厂 API 分开；不把套餐限制回写原厂能力 |
+| MiniMax | M3 共享窗口 1048576 → 1000000；M2.7 API/套餐/规格移除误标 vision；补音乐存量用户资格说明 | M3 原有共享输出 512000 尚无本轮原厂证明；不将 OpenRouter 限制冒充原厂，也不删历史付费型号 |
+| Cohere | 原生 Rerank3.5 从兼容 Provider 移除并墓碑保留；Embed4 原生维度补齐；North Mini 使用准确 ID，新增 North Small Translate 共享身份 | 原生模型未向普通兼容 Provider 强行上架；旧 North 简称仅作历史匹配，去掉宽泛 pattern |
+| Google、Mistral | Google 九个单型号页补最大输出证据；Codestral 补官方价格来源 | 最大输入与总窗口不混用，尚未适配音频协议只保留共享规格 |
+| 运行时 | 更新 Node/npm/pnpm/Yarn 官方离线目录；推荐六平台 Node、六平台 Python 档名/摘要核实 | Node 33 条，npm13/pnpm30/Yarn30；Python fallback 按内置 Hatch pin 保留；未下载全档或进行安装实测 |
+
+## 维护机制闭环
+
+- 每家供应商均有独立 `AUDIT.md`，共 28 家；原字段级证明继续在单模型文件中维护，不集中复制成大表。
+- 来源记录仍覆盖 619 条。原 301 pending → 272，317 partial → 346，historical 保持 1。partial 中只确认 ID 的记录从 258 → 214；核实过其他字段的记录从 59 → 132，**仍不代表这些记录全部规格通过**。当前字段级引用 738 项。
+- 新增八份非模型政策/API 合同记录，区分产品策略与官方事实。来源保存真实读取日期、最终地址和内容摘要；页面壳与失败不能支持已核字段。默认映射完整快照受门禁保护，换成另一个有效型号也必须更新策略记录。
+- 运行时来源细分为推荐、Python pin、Node 与三个包管理器快照。离线门禁防止配置与文档漂移；联网更新脚本默认只读，显式 `--write` 才更新目录，读取/摘要失败时不写入。
+- 四个旧 ZenMux 入口显式失败，原文归档为 `.txt` 供追溯，避免第三方相似匹配再覆盖价格或窗口。
+- 共享规格索引同步更新批次说明，确保已核客户端能按索引 mtime 失效缓存；AGENTS.md 补充维护约束和全部来源校验命令。
+
+## 尚未完成的工作
+
+272 条 pending 仍缺字段证明，214 条 partial 仅确认身份。待办按各供应商 AUDIT 和单模型文件逐条处理：旧型号、套餐权限、国内/国际价格、独立输入输出预算、JS 页面壳与登录/账号目录均不能用其他平台参数代替。
+
+跨仓依赖详见 [客户端与账号任务表](CLIENT-DEPENDENCIES.md)，包含原生音频/视频/Rerank、Perplexity Agent API、独立输入预算、Python 安装契约和默认模型评估。本仓已经修正能由官方证据证明的问题；本轮没有进行收费模型调用、安装或默认模型性能评测，不将这些待办标为完成。
+
+## 验证
+
+- 完整配置校验：79 项通过，3 项跳过，0 项失败，旧推理字段告警为 0。
+- 模型来源：452 个机器记录页面、619 条记录，0 项失败。
+- 非模型来源：8 条政策/API 合同记录，0 项失败。
+- 运行时来源离线一致性：0 项失败。
+- 单元测试：118 项通过；回归覆盖端点分离、完整推理档位、临时身份、套餐模态、原生协议边界、来源跳转/页面壳、运行时摘要和未来日期。
+- `git diff --check` 通过。配置校验及测试不代表账号调用或安装验收。