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/stealth/README.md
+++ b/docs/model-sources/providers/stealth/README.md
@@ -0,0 +1,13 @@
+# 匿名模型历史兼容：来源导航
+
+[总索引](../../README.md) · [官网证据与边界](SOURCES.md)
+
+本目录包含 1 个单模型文件、1 个单接入面文件。核验日期与状态来自迁移前记录。
+
+## 接入面
+
+- [compute/model-specs/stealth.json](access/model-specs--stealth.md)
+
+## 模型
+
+- [`ox-alpha`](models/ox-alpha.md)
--- a/docs/model-sources/providers/stealth/SOURCES.md
+++ b/docs/model-sources/providers/stealth/SOURCES.md
@@ -0,0 +1,54 @@
+# 匿名模型历史兼容：官网证据目录
+
+[供应商索引](README.md)
+
+核验日期：2026-10-03。这里只登记可复用的官网证据与适用边界，具体模型与接入面分别记录。
+
+## 官网证据
+
+### openrouter-api
+
+- 入口：[openrouter-api](https://openrouter.ai/api/v1/models)
+- 类型：`official-api`；当前读取状态：`fetched`；地域/接入面：`OpenRouter 公共 Models API 快照；USD/token 换算为 USD/百万 token`。
+### glm53-flash
+
+- 入口：[glm53-flash](https://docs.bigmodel.cn/cn/guide/models/vlm/glm-5.3-flash.md)
+- 类型：`official-doc`；当前读取状态：`fetched`；地域/接入面：`智谱原厂 Flash/FlashX 参数及中国区套餐限制`。
+
+## 已知边界与核验说明
+
+本页仅记录历史兼容规格。当前 OpenRouter 官网 API 已不列出 Ox Alpha；历史别名来源及揭晓关系未获得本次可读官网材料确认。共享规格保留供其他网关兼容，不把它当当前官方平台可用性证明。
+
+状态 `partial` 仅表示列出的字段已核实；不能推断整条配置、价格、账号权限或真实模型调用都已验收。`pending` 没有已核字段；`historical` 只作历史兼容参考。路由 tier/priority、产品标签和默认选择属于本仓策略，不伪装成官网数据。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "stealth",
+  "checkedAt": "2026-10-03",
+  "sources": [
+    {
+      "id": "openrouter-api",
+      "url": "https://openrouter.ai/api/v1/models",
+      "kind": "official-api",
+      "scope": "OpenRouter 公共 Models API 快照；USD/token 换算为 USD/百万 token",
+      "retrieval": "fetched",
+      "checkedAt": "2026-10-03",
+      "contentSha256": "38864160760c394d4d81864581a33adbced3c582fdd8732809f90ec7e911f032",
+      "resolvedUrl": "https://openrouter.ai/api/v1/models"
+    },
+    {
+      "id": "glm53-flash",
+      "url": "https://docs.bigmodel.cn/cn/guide/models/vlm/glm-5.3-flash.md",
+      "kind": "official-doc",
+      "scope": "智谱原厂 Flash/FlashX 参数及中国区套餐限制",
+      "retrieval": "fetched",
+      "checkedAt": "2026-10-03",
+      "contentSha256": "d9e2d56363f9e04e18c5bb60756edffaf565d2ccb28c420552da2ead3eecef9c",
+      "resolvedUrl": "https://docs.bigmodel.cn/cn/guide/models/vlm/glm-5.3-flash.md"
+    }
+  ]
+}
+```
+<!-- source-metadata:end -->
--- a/docs/model-sources/providers/stealth/access/model-specs--stealth.md
+++ b/docs/model-sources/providers/stealth/access/model-specs--stealth.md
@@ -0,0 +1,37 @@
+# 匿名模型历史兼容：stealth 接入面
+
+[供应商索引](../README.md) · [官网证据](../SOURCES.md)
+
+- 配置文件：[compute/model-specs/stealth.json](../../../../../compute/model-specs/stealth.json)
+- 核验日期：2026-10-03。
+- 接入类别：`model-specs`。
+
+## 平台配置快照
+
+这是模型共享规格文件，不声明账号权限、平台计价或服务端点。
+
+以上是配置快照，不能据此宣布该端点或账号已实际验收。核查地域、套餐支持、凭据来源及协议时，对照官网证据目录并记录结论。
+
+<!-- source-config: compute/model-specs/stealth.json -->
+<!-- source-config-fingerprint: 6598d8a86005f10e6d88c60c5b5dd09357539b051b2297adbe8b7849423d1998 -->
+
+## 关联模型
+
+- [`ox-alpha`](../models/ox-alpha.md)
+
+## 更新前检查
+
+- 核对端点和地域、API 格式、凭据来源、版本要求及套餐实际支持名单。
+- 修改平台字段后复核本文件；修改模型字段后更新对应单模型文件。
+- 未取得官网参数或账号实测证据时，保留 pending / 未实测说明，不以表格快照代替证据。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "stealth",
+  "checkedAt": "2026-10-03",
+  "sourceCatalog": "../SOURCES.md"
+}
+```
+<!-- source-metadata:end -->
--- a/docs/model-sources/providers/stealth/models/ox-alpha.md
+++ b/docs/model-sources/providers/stealth/models/ox-alpha.md
@@ -0,0 +1,76 @@
+# ox-alpha：模型来源与接入记录
+
+[供应商索引](../README.md) · [官网证据目录](../SOURCES.md)
+
+- 精确模型 ID：`ox-alpha`。
+- 核验日期：2026-10-03；本次只迁移记录，没有重新核验或提高状态。
+
+## 适用接入面
+
+- [compute/model-specs/stealth.json](../access/model-specs--stealth.md)
+
+## 字段级来源记录
+
+各接入面分开记录；价格为 inputPrice/outputPrice 快照，具体单位和限制看配置及引用官网。partial 只确认已列字段，不代表全部参数、平台可用性或账号调用已验收。
+
+### compute/model-specs/stealth.json
+
+[查看配置](../../../../../compute/model-specs/stealth.json) · [接入面说明](../access/model-specs--stealth.md)
+
+当前配置详情（不是全部官网确认值；routing 是本仓策略）：
+
+<!-- source-details: {"config":"compute/model-specs/stealth.json","id":"ox-alpha"} -->
+```json
+{
+  "spec.contextWindow": 1048576,
+  "spec.maxOutputTokens": 131072,
+  "spec.serviceType": [
+    "chat",
+    "reasoning",
+    "vision"
+  ],
+  "spec.capabilities": [
+    "chat",
+    "reasoning",
+    "deep_thinking",
+    "code",
+    "tool_use",
+    "agent",
+    "long_context",
+    "vision",
+    "image_understanding",
+    "video_understanding"
+  ],
+  "spec.supportsReasoning": true,
+  "spec.defaultTemperature": 1,
+  "spec.defaultTopP": 0.95,
+  "spec.releasedAt": "2026-08-21",
+  "spec.extra.thinkingOnly": true
+}
+```
+<!-- source-details:end -->
+
+<!-- source-config: compute/model-specs/stealth.json -->
+
+| 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `ox-alpha` | 1048576 / 131072 | 非计价主数据 | 待核实 | [openrouter-api](../SOURCES.md#openrouter-api) | historical | `1d20e9cc8d59f956ab8fe266f8aaaf5eedf6297c3487c6fd6f85e03e7bb7b560` |
+
+## 下次更新核查
+
+- 对照官网核查精确 ID／别名、是否仍列出、上下文／输入／输出限制及单位。
+- 分别核查推理档位、默认值、是否可关闭思考、采样和强制工具选择限制、多模态输入／输出。
+- 按本接入面核对价格、缓存、阶梯／峰谷、套餐支持；不能把其他平台参数直接复制。
+- 只更新真正复核的字段与引用来源；保留其余待核实项及历史记录。
+- 同步对应 canonical JSON、回归和模型指纹，再运行来源校验。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "stealth",
+  "checkedAt": "2026-10-03",
+  "sourceCatalog": "../SOURCES.md"
+}
+```
+<!-- source-metadata:end -->