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 07:04:11 +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/stability/README.md
+++ b/docs/model-sources/providers/stability/README.md
@@ -0,0 +1,15 @@
+# Stability AI：来源导航
+
+[总索引](../../README.md) · [官网证据与边界](SOURCES.md)
+
+本目录包含 2 个单模型文件、2 个单接入面文件。核验日期与状态来自迁移前记录。
+
+## 接入面
+
+- [compute/providers/stability.json](access/providers--stability.md)
+- [compute/model-specs/stability.json](access/model-specs--stability.md)
+
+## 模型
+
+- [`stable-audio-3.0`](models/stable-audio-3.0.md)
+- [`stable-diffusion-3.5-large`](models/stable-diffusion-3.5-large.md)
--- a/docs/model-sources/providers/stability/SOURCES.md
+++ b/docs/model-sources/providers/stability/SOURCES.md
@@ -0,0 +1,40 @@
+# Stability AI：官网证据目录
+
+[供应商索引](README.md)
+
+核验日期：2026-10-03。这里只登记可复用的官网证据与适用边界，具体模型与接入面分别记录。
+
+## 官网证据
+
+### stability
+
+- 入口：[stability](https://stability.ai/news-updates)
+- 类型：`official-doc`；当前读取状态：`fetched`；地域/接入面：`stability 官方入口；具体地域与接入面待该页面逐字段确认`。
+
+## 已知边界与核验说明
+
+已登记官方入口并尝试读取。表中仅标为已核字段的部分有此次核对记录；其余存量参数待逐字段复核。
+
+状态 `partial` 仅表示列出的字段已核实；不能推断整条配置、价格、账号权限或真实模型调用都已验收。`pending` 没有已核字段；`historical` 只作历史兼容参考。路由 tier/priority、产品标签和默认选择属于本仓策略，不伪装成官网数据。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "stability",
+  "checkedAt": "2026-10-03",
+  "sources": [
+    {
+      "id": "stability",
+      "url": "https://stability.ai/news-updates",
+      "kind": "official-doc",
+      "scope": "stability 官方入口；具体地域与接入面待该页面逐字段确认",
+      "retrieval": "fetched",
+      "checkedAt": "2026-10-03",
+      "contentSha256": "89d63195c184b398f48647563610a8918eefff9b65b999ace04d543f152d2cfa",
+      "resolvedUrl": "https://stability.ai/news-updates"
+    }
+  ]
+}
+```
+<!-- source-metadata:end -->
--- a/docs/model-sources/providers/stability/access/model-specs--stability.md
+++ b/docs/model-sources/providers/stability/access/model-specs--stability.md
@@ -0,0 +1,38 @@
+# Stability AI：stability 接入面
+
+[供应商索引](../README.md) · [官网证据](../SOURCES.md)
+
+- 配置文件：[compute/model-specs/stability.json](../../../../../compute/model-specs/stability.json)
+- 核验日期：2026-10-03。
+- 接入类别：`model-specs`。
+
+## 平台配置快照
+
+这是模型共享规格文件，不声明账号权限、平台计价或服务端点。
+
+以上是配置快照，不能据此宣布该端点或账号已实际验收。核查地域、套餐支持、凭据来源及协议时，对照官网证据目录并记录结论。
+
+<!-- source-config: compute/model-specs/stability.json -->
+<!-- source-config-fingerprint: acfdd44992c5fecae5ac33d5b9a0cc1ff186f0ce835b0e88e4ac31ad2f959482 -->
+
+## 关联模型
+
+- [`stable-audio-3.0`](../models/stable-audio-3.0.md)
+- [`stable-diffusion-3.5-large`](../models/stable-diffusion-3.5-large.md)
+
+## 更新前检查
+
+- 核对端点和地域、API 格式、凭据来源、版本要求及套餐实际支持名单。
+- 修改平台字段后复核本文件；修改模型字段后更新对应单模型文件。
+- 未取得官网参数或账号实测证据时，保留 pending / 未实测说明，不以表格快照代替证据。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "stability",
+  "checkedAt": "2026-10-03",
+  "sourceCatalog": "../SOURCES.md"
+}
+```
+<!-- source-metadata:end -->
--- a/docs/model-sources/providers/stability/access/providers--stability.md
+++ b/docs/model-sources/providers/stability/access/providers--stability.md
@@ -0,0 +1,40 @@
+# Stability AI：stability 接入面
+
+[供应商索引](../README.md) · [官网证据](../SOURCES.md)
+
+- 配置文件：[compute/providers/stability.json](../../../../../compute/providers/stability.json)
+- 核验日期：2026-10-03。
+- 接入类别：`providers`。
+
+## 平台配置快照
+
+- API 协议：`stability-rest-api`。
+- 端点：`https://api.stability.ai/v2beta`。
+- 计价币种：`USD`。
+- 访问模式：`普通 API`。
+
+以上是配置快照，不能据此宣布该端点或账号已实际验收。核查地域、套餐支持、凭据来源及协议时，对照官网证据目录并记录结论。
+
+<!-- source-config: compute/providers/stability.json -->
+<!-- source-config-fingerprint: aa7e3342c599d645bab1e9281cd42980eac33ba04223de6b58538d6c52ec7745 -->
+
+## 关联模型
+
+- [`stable-diffusion-3.5-large`](../models/stable-diffusion-3.5-large.md)
+
+## 更新前检查
+
+- 核对端点和地域、API 格式、凭据来源、版本要求及套餐实际支持名单。
+- 修改平台字段后复核本文件；修改模型字段后更新对应单模型文件。
+- 未取得官网参数或账号实测证据时，保留 pending / 未实测说明，不以表格快照代替证据。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "stability",
+  "checkedAt": "2026-10-03",
+  "sourceCatalog": "../SOURCES.md"
+}
+```
+<!-- source-metadata:end -->
--- a/docs/model-sources/providers/stability/models/stable-audio-3.0.md
+++ b/docs/model-sources/providers/stability/models/stable-audio-3.0.md
@@ -0,0 +1,60 @@
+# stable-audio-3.0：模型来源与接入记录
+
+[供应商索引](../README.md) · [官网证据目录](../SOURCES.md)
+
+- 精确模型 ID：`stable-audio-3.0`。
+- 核验日期：2026-10-03；本次只迁移记录，没有重新核验或提高状态。
+
+## 适用接入面
+
+- [compute/model-specs/stability.json](../access/model-specs--stability.md)
+
+## 字段级来源记录
+
+各接入面分开记录；价格为 inputPrice/outputPrice 快照，具体单位和限制看配置及引用官网。partial 只确认已列字段，不代表全部参数、平台可用性或账号调用已验收。
+
+### compute/model-specs/stability.json
+
+[查看配置](../../../../../compute/model-specs/stability.json) · [接入面说明](../access/model-specs--stability.md)
+
+当前配置详情（不是全部官网确认值；routing 是本仓策略）：
+
+<!-- source-details: {"config":"compute/model-specs/stability.json","id":"stable-audio-3.0"} -->
+```json
+{
+  "spec.serviceType": [
+    "music_gen"
+  ],
+  "spec.capabilities": [
+    "music_generation",
+    "audio_generation"
+  ],
+  "spec.releasedAt": "2026-05-20"
+}
+```
+<!-- source-details:end -->
+
+<!-- source-config: compute/model-specs/stability.json -->
+
+| 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `stable-audio-3.0` | 未声明 / 未声明 | 非计价主数据 | 待核实 | [stability](../SOURCES.md#stability) | pending | `8ca27cf7c48f2e8f28451c2afccfaf86022bf2f9e07d2196a2e8037d620a2024` |
+
+## 下次更新核查
+
+- 对照官网核查精确 ID／别名、是否仍列出、上下文／输入／输出限制及单位。
+- 分别核查推理档位、默认值、是否可关闭思考、采样和强制工具选择限制、多模态输入／输出。
+- 按本接入面核对价格、缓存、阶梯／峰谷、套餐支持；不能把其他平台参数直接复制。
+- 只更新真正复核的字段与引用来源；保留其余待核实项及历史记录。
+- 同步对应 canonical JSON、回归和模型指纹，再运行来源校验。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "stability",
+  "checkedAt": "2026-10-03",
+  "sourceCatalog": "../SOURCES.md"
+}
+```
+<!-- source-metadata:end -->
--- a/docs/model-sources/providers/stability/models/stable-diffusion-3.5-large.md
+++ b/docs/model-sources/providers/stability/models/stable-diffusion-3.5-large.md
@@ -0,0 +1,88 @@
+# stable-diffusion-3.5-large：模型来源与接入记录
+
+[供应商索引](../README.md) · [官网证据目录](../SOURCES.md)
+
+- 精确模型 ID：`stable-diffusion-3.5-large`。
+- 核验日期：2026-10-03；本次只迁移记录，没有重新核验或提高状态。
+
+## 适用接入面
+
+- [compute/providers/stability.json](../access/providers--stability.md)
+- [compute/model-specs/stability.json](../access/model-specs--stability.md)
+
+## 字段级来源记录
+
+各接入面分开记录；价格为 inputPrice/outputPrice 快照，具体单位和限制看配置及引用官网。partial 只确认已列字段，不代表全部参数、平台可用性或账号调用已验收。
+
+### compute/providers/stability.json
+
+[查看配置](../../../../../compute/providers/stability.json) · [接入面说明](../access/providers--stability.md)
+
+当前配置详情（不是全部官网确认值；routing 是本仓策略）：
+
+<!-- source-details: {"config":"compute/providers/stability.json","id":"stable-diffusion-3.5-large"} -->
+```json
+{
+  "serviceType": [
+    "image_gen"
+  ],
+  "capabilities": [
+    "image_generation",
+    "high_quality",
+    "controllable"
+  ]
+}
+```
+<!-- source-details:end -->
+
+<!-- source-config: compute/providers/stability.json -->
+
+| 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `stable-diffusion-3.5-large` | 未声明 / 未声明 | USD：未声明 / 未声明 | 待核实 | [stability](../SOURCES.md#stability) | pending | `64524c4615b4fdf9b332e192d5875cde2ee001b5a39dba98d682c5e8a6256f4d` |
+
+### compute/model-specs/stability.json
+
+[查看配置](../../../../../compute/model-specs/stability.json) · [接入面说明](../access/model-specs--stability.md)
+
+当前配置详情（不是全部官网确认值；routing 是本仓策略）：
+
+<!-- source-details: {"config":"compute/model-specs/stability.json","id":"stable-diffusion-3.5-large"} -->
+```json
+{
+  "spec.serviceType": [
+    "image_gen"
+  ],
+  "spec.capabilities": [
+    "image_generation",
+    "high_quality",
+    "controllable"
+  ]
+}
+```
+<!-- source-details:end -->
+
+<!-- source-config: compute/model-specs/stability.json -->
+
+| 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `stable-diffusion-3.5-large` | 未声明 / 未声明 | 非计价主数据 | 待核实 | [stability](../SOURCES.md#stability) | pending | `e857add69197a81d9040870d29452276d33dbbf2c469b1f71e27d12b28aa7f91` |
+
+## 下次更新核查
+
+- 对照官网核查精确 ID／别名、是否仍列出、上下文／输入／输出限制及单位。
+- 分别核查推理档位、默认值、是否可关闭思考、采样和强制工具选择限制、多模态输入／输出。
+- 按本接入面核对价格、缓存、阶梯／峰谷、套餐支持；不能把其他平台参数直接复制。
+- 只更新真正复核的字段与引用来源；保留其余待核实项及历史记录。
+- 同步对应 canonical JSON、回归和模型指纹，再运行来源校验。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "stability",
+  "checkedAt": "2026-10-03",
+  "sourceCatalog": "../SOURCES.md"
+}
+```
+<!-- source-metadata:end -->