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/perplexity/README.md
+++ b/docs/model-sources/providers/perplexity/README.md
@@ -0,0 +1,16 @@
+# Perplexity：来源导航
+
+[总索引](../../README.md) · [官网证据与边界](SOURCES.md)
+
+本目录包含 3 个单模型文件、2 个单接入面文件。核验日期与状态来自迁移前记录。
+
+## 接入面
+
+- [compute/providers/perplexity.json](access/providers--perplexity.md)
+- [compute/model-specs/perplexity.json](access/model-specs--perplexity.md)
+
+## 模型
+
+- [`sonar`](models/sonar.md)
+- [`sonar-pro`](models/sonar-pro.md)
+- [`sonar-reasoning-pro`](models/sonar-reasoning-pro.md)
--- a/docs/model-sources/providers/perplexity/SOURCES.md
+++ b/docs/model-sources/providers/perplexity/SOURCES.md
@@ -0,0 +1,40 @@
+# Perplexity：官网证据目录
+
+[供应商索引](README.md)
+
+核验日期：2026-10-03。这里只登记可复用的官网证据与适用边界，具体模型与接入面分别记录。
+
+## 官网证据
+
+### perplexity
+
+- 入口：[perplexity](https://docs.perplexity.ai/docs/agent-api/migrate-from-sonar/overview)
+- 类型：`official-doc`；当前读取状态：`fetched`；地域/接入面：`perplexity 官方入口；具体地域与接入面待该页面逐字段确认`。
+
+## 已知边界与核验说明
+
+官网迁移文档确认平台正在转向 Agent API；旧 Sonar 型号规格与当前账号可调用性必须独立核对，不能只修改 model 字符串。
+
+状态 `partial` 仅表示列出的字段已核实；不能推断整条配置、价格、账号权限或真实模型调用都已验收。`pending` 没有已核字段；`historical` 只作历史兼容参考。路由 tier/priority、产品标签和默认选择属于本仓策略，不伪装成官网数据。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "perplexity",
+  "checkedAt": "2026-10-03",
+  "sources": [
+    {
+      "id": "perplexity",
+      "url": "https://docs.perplexity.ai/docs/agent-api/migrate-from-sonar/overview",
+      "kind": "official-doc",
+      "scope": "perplexity 官方入口；具体地域与接入面待该页面逐字段确认",
+      "retrieval": "fetched",
+      "checkedAt": "2026-10-03",
+      "contentSha256": "1b0fcd7be3f09329357b1d99b50f41833d0614f57fccdf0aa367552018923cb8",
+      "resolvedUrl": "https://docs.perplexity.ai/docs/agent-api/migrate-from-sonar/overview"
+    }
+  ]
+}
+```
+<!-- source-metadata:end -->
--- a/docs/model-sources/providers/perplexity/access/model-specs--perplexity.md
+++ b/docs/model-sources/providers/perplexity/access/model-specs--perplexity.md
@@ -0,0 +1,39 @@
+# Perplexity：perplexity 接入面
+
+[供应商索引](../README.md) · [官网证据](../SOURCES.md)
+
+- 配置文件：[compute/model-specs/perplexity.json](../../../../../compute/model-specs/perplexity.json)
+- 核验日期：2026-10-03。
+- 接入类别：`model-specs`。
+
+## 平台配置快照
+
+这是模型共享规格文件，不声明账号权限、平台计价或服务端点。
+
+以上是配置快照，不能据此宣布该端点或账号已实际验收。核查地域、套餐支持、凭据来源及协议时，对照官网证据目录并记录结论。
+
+<!-- source-config: compute/model-specs/perplexity.json -->
+<!-- source-config-fingerprint: ff9eac633ae62936752669aef03f3f08e161d61fe0957c88ef987ea40693e78b -->
+
+## 关联模型
+
+- [`sonar-pro`](../models/sonar-pro.md)
+- [`sonar-reasoning-pro`](../models/sonar-reasoning-pro.md)
+- [`sonar`](../models/sonar.md)
+
+## 更新前检查
+
+- 核对端点和地域、API 格式、凭据来源、版本要求及套餐实际支持名单。
+- 修改平台字段后复核本文件；修改模型字段后更新对应单模型文件。
+- 未取得官网参数或账号实测证据时，保留 pending / 未实测说明，不以表格快照代替证据。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "perplexity",
+  "checkedAt": "2026-10-03",
+  "sourceCatalog": "../SOURCES.md"
+}
+```
+<!-- source-metadata:end -->
--- a/docs/model-sources/providers/perplexity/access/providers--perplexity.md
+++ b/docs/model-sources/providers/perplexity/access/providers--perplexity.md
@@ -0,0 +1,42 @@
+# Perplexity：perplexity 接入面
+
+[供应商索引](../README.md) · [官网证据](../SOURCES.md)
+
+- 配置文件：[compute/providers/perplexity.json](../../../../../compute/providers/perplexity.json)
+- 核验日期：2026-10-03。
+- 接入类别：`providers`。
+
+## 平台配置快照
+
+- API 协议：`openai-completions`。
+- 端点：`https://api.perplexity.ai`。
+- 计价币种：`USD`。
+- 访问模式：`普通 API`。
+
+以上是配置快照，不能据此宣布该端点或账号已实际验收。核查地域、套餐支持、凭据来源及协议时，对照官网证据目录并记录结论。
+
+<!-- source-config: compute/providers/perplexity.json -->
+<!-- source-config-fingerprint: 2e86809aa786094beabf698af599985f4ffcd34fec8f78c33c29ae9968081397 -->
+
+## 关联模型
+
+- [`sonar-pro`](../models/sonar-pro.md)
+- [`sonar-reasoning-pro`](../models/sonar-reasoning-pro.md)
+- [`sonar`](../models/sonar.md)
+
+## 更新前检查
+
+- 核对端点和地域、API 格式、凭据来源、版本要求及套餐实际支持名单。
+- 修改平台字段后复核本文件；修改模型字段后更新对应单模型文件。
+- 未取得官网参数或账号实测证据时，保留 pending / 未实测说明，不以表格快照代替证据。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "perplexity",
+  "checkedAt": "2026-10-03",
+  "sourceCatalog": "../SOURCES.md"
+}
+```
+<!-- source-metadata:end -->
--- a/docs/model-sources/providers/perplexity/models/sonar-pro.md
+++ b/docs/model-sources/providers/perplexity/models/sonar-pro.md
@@ -0,0 +1,97 @@
+# sonar-pro：模型来源与接入记录
+
+[供应商索引](../README.md) · [官网证据目录](../SOURCES.md)
+
+- 精确模型 ID：`sonar-pro`。
+- 核验日期：2026-10-03；本次只迁移记录，没有重新核验或提高状态。
+
+## 适用接入面
+
+- [compute/providers/perplexity.json](../access/providers--perplexity.md)
+- [compute/model-specs/perplexity.json](../access/model-specs--perplexity.md)
+
+## 字段级来源记录
+
+各接入面分开记录；价格为 inputPrice/outputPrice 快照，具体单位和限制看配置及引用官网。partial 只确认已列字段，不代表全部参数、平台可用性或账号调用已验收。
+
+### compute/providers/perplexity.json
+
+[查看配置](../../../../../compute/providers/perplexity.json) · [接入面说明](../access/providers--perplexity.md)
+
+当前配置详情（不是全部官网确认值；routing 是本仓策略）：
+
+<!-- source-details: {"config":"compute/providers/perplexity.json","id":"sonar-pro"} -->
+```json
+{
+  "contextWindow": 200000,
+  "maxOutputTokens": 8192,
+  "serviceType": [
+    "chat"
+  ],
+  "capabilities": [
+    "chat",
+    "web_search",
+    "reasoning",
+    "citation"
+  ],
+  "inputPrice": 3,
+  "outputPrice": 15,
+  "extra.pricingNotes": "Total Sonar API cost includes token costs plus a request fee based on search context size."
+}
+```
+<!-- source-details:end -->
+
+<!-- source-config: compute/providers/perplexity.json -->
+
+| 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `sonar-pro` | 200000 / 8192 | USD：3 / 15 | 待核实 | [perplexity](../SOURCES.md#perplexity) | pending | `2cc4bd973047d00f734e5ef7ec62baca0f83c8e34db26ef26283161610504be1` |
+
+### compute/model-specs/perplexity.json
+
+[查看配置](../../../../../compute/model-specs/perplexity.json) · [接入面说明](../access/model-specs--perplexity.md)
+
+当前配置详情（不是全部官网确认值；routing 是本仓策略）：
+
+<!-- source-details: {"config":"compute/model-specs/perplexity.json","id":"sonar-pro"} -->
+```json
+{
+  "spec.contextWindow": 200000,
+  "spec.maxOutputTokens": 8192,
+  "spec.serviceType": [
+    "chat"
+  ],
+  "spec.capabilities": [
+    "chat",
+    "web_search",
+    "reasoning",
+    "citation"
+  ]
+}
+```
+<!-- source-details:end -->
+
+<!-- source-config: compute/model-specs/perplexity.json -->
+
+| 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `sonar-pro` | 200000 / 8192 | 非计价主数据 | 待核实 | [perplexity](../SOURCES.md#perplexity) | pending | `333bdfa39e2d5f1c07040e470408ed5a1efd68bc22d31a2ee524465cd84ca8d9` |
+
+## 下次更新核查
+
+- 对照官网核查精确 ID／别名、是否仍列出、上下文／输入／输出限制及单位。
+- 分别核查推理档位、默认值、是否可关闭思考、采样和强制工具选择限制、多模态输入／输出。
+- 按本接入面核对价格、缓存、阶梯／峰谷、套餐支持；不能把其他平台参数直接复制。
+- 只更新真正复核的字段与引用来源；保留其余待核实项及历史记录。
+- 同步对应 canonical JSON、回归和模型指纹，再运行来源校验。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "perplexity",
+  "checkedAt": "2026-10-03",
+  "sourceCatalog": "../SOURCES.md"
+}
+```
+<!-- source-metadata:end -->
--- a/docs/model-sources/providers/perplexity/models/sonar-reasoning-pro.md
+++ b/docs/model-sources/providers/perplexity/models/sonar-reasoning-pro.md
@@ -0,0 +1,99 @@
+# sonar-reasoning-pro：模型来源与接入记录
+
+[供应商索引](../README.md) · [官网证据目录](../SOURCES.md)
+
+- 精确模型 ID：`sonar-reasoning-pro`。
+- 核验日期：2026-10-03；本次只迁移记录，没有重新核验或提高状态。
+
+## 适用接入面
+
+- [compute/providers/perplexity.json](../access/providers--perplexity.md)
+- [compute/model-specs/perplexity.json](../access/model-specs--perplexity.md)
+
+## 字段级来源记录
+
+各接入面分开记录；价格为 inputPrice/outputPrice 快照，具体单位和限制看配置及引用官网。partial 只确认已列字段，不代表全部参数、平台可用性或账号调用已验收。
+
+### compute/providers/perplexity.json
+
+[查看配置](../../../../../compute/providers/perplexity.json) · [接入面说明](../access/providers--perplexity.md)
+
+当前配置详情（不是全部官网确认值；routing 是本仓策略）：
+
+<!-- source-details: {"config":"compute/providers/perplexity.json","id":"sonar-reasoning-pro"} -->
+```json
+{
+  "contextWindow": 128000,
+  "maxOutputTokens": 8192,
+  "serviceType": [
+    "chat"
+  ],
+  "capabilities": [
+    "chat",
+    "web_search",
+    "reasoning",
+    "deep_thinking"
+  ],
+  "inputPrice": 2,
+  "outputPrice": 8,
+  "extra.pricingNotes": "Total Sonar API cost includes token costs plus a request fee based on search context size."
+}
+```
+<!-- source-details:end -->
+
+<!-- source-config: compute/providers/perplexity.json -->
+
+| 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `sonar-reasoning-pro` | 128000 / 8192 | USD：2 / 8 | 待核实 | [perplexity](../SOURCES.md#perplexity) | pending | `63d921844b0a02e0ba15de47b42aa28cba3beb2fc65ceec1b260849a720575d7` |
+
+### compute/model-specs/perplexity.json
+
+[查看配置](../../../../../compute/model-specs/perplexity.json) · [接入面说明](../access/model-specs--perplexity.md)
+
+当前配置详情（不是全部官网确认值；routing 是本仓策略）：
+
+<!-- source-details: {"config":"compute/model-specs/perplexity.json","id":"sonar-reasoning-pro"} -->
+```json
+{
+  "spec.contextWindow": 128000,
+  "spec.maxOutputTokens": 8192,
+  "spec.serviceType": [
+    "chat"
+  ],
+  "spec.capabilities": [
+    "chat",
+    "web_search",
+    "reasoning",
+    "deep_thinking"
+  ],
+  "spec.supportsReasoning": true,
+  "spec.defaultTemperature": null
+}
+```
+<!-- source-details:end -->
+
+<!-- source-config: compute/model-specs/perplexity.json -->
+
+| 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `sonar-reasoning-pro` | 128000 / 8192 | 非计价主数据 | 待核实 | [perplexity](../SOURCES.md#perplexity) | pending | `7336594cf9d00c11e30c9dc426e3bf051969c2b1f61116cdf144fcacc457b3ef` |
+
+## 下次更新核查
+
+- 对照官网核查精确 ID／别名、是否仍列出、上下文／输入／输出限制及单位。
+- 分别核查推理档位、默认值、是否可关闭思考、采样和强制工具选择限制、多模态输入／输出。
+- 按本接入面核对价格、缓存、阶梯／峰谷、套餐支持；不能把其他平台参数直接复制。
+- 只更新真正复核的字段与引用来源；保留其余待核实项及历史记录。
+- 同步对应 canonical JSON、回归和模型指纹，再运行来源校验。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "perplexity",
+  "checkedAt": "2026-10-03",
+  "sourceCatalog": "../SOURCES.md"
+}
+```
+<!-- source-metadata:end -->
--- a/docs/model-sources/providers/perplexity/models/sonar.md
+++ b/docs/model-sources/providers/perplexity/models/sonar.md
@@ -0,0 +1,97 @@
+# sonar：模型来源与接入记录
+
+[供应商索引](../README.md) · [官网证据目录](../SOURCES.md)
+
+- 精确模型 ID：`sonar`。
+- 核验日期：2026-10-03；本次只迁移记录，没有重新核验或提高状态。
+
+## 适用接入面
+
+- [compute/providers/perplexity.json](../access/providers--perplexity.md)
+- [compute/model-specs/perplexity.json](../access/model-specs--perplexity.md)
+
+## 字段级来源记录
+
+各接入面分开记录；价格为 inputPrice/outputPrice 快照，具体单位和限制看配置及引用官网。partial 只确认已列字段，不代表全部参数、平台可用性或账号调用已验收。
+
+### compute/providers/perplexity.json
+
+[查看配置](../../../../../compute/providers/perplexity.json) · [接入面说明](../access/providers--perplexity.md)
+
+当前配置详情（不是全部官网确认值；routing 是本仓策略）：
+
+<!-- source-details: {"config":"compute/providers/perplexity.json","id":"sonar"} -->
+```json
+{
+  "contextWindow": 128000,
+  "maxOutputTokens": 4096,
+  "serviceType": [
+    "chat"
+  ],
+  "capabilities": [
+    "chat",
+    "web_search",
+    "citation",
+    "fast"
+  ],
+  "inputPrice": 1,
+  "outputPrice": 1,
+  "extra.pricingNotes": "Total Sonar API cost includes token costs plus a request fee based on search context size."
+}
+```
+<!-- source-details:end -->
+
+<!-- source-config: compute/providers/perplexity.json -->
+
+| 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `sonar` | 128000 / 4096 | USD：1 / 1 | `modelName`→[perplexity](../SOURCES.md#perplexity) | [perplexity](../SOURCES.md#perplexity) | partial | `01bc6e3f8a68692aca07ee7553db726873ef2366962379ee417956aca3402d71` |
+
+### compute/model-specs/perplexity.json
+
+[查看配置](../../../../../compute/model-specs/perplexity.json) · [接入面说明](../access/model-specs--perplexity.md)
+
+当前配置详情（不是全部官网确认值；routing 是本仓策略）：
+
+<!-- source-details: {"config":"compute/model-specs/perplexity.json","id":"sonar"} -->
+```json
+{
+  "spec.contextWindow": 128000,
+  "spec.maxOutputTokens": 4096,
+  "spec.serviceType": [
+    "chat"
+  ],
+  "spec.capabilities": [
+    "chat",
+    "web_search",
+    "citation",
+    "fast"
+  ]
+}
+```
+<!-- source-details:end -->
+
+<!-- source-config: compute/model-specs/perplexity.json -->
+
+| 模型 ID | 上下文 / 输出 | 计价 | 已核字段→来源 | 来源入口 | 状态 | 数据指纹 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `sonar` | 128000 / 4096 | 非计价主数据 | `id`→[perplexity](../SOURCES.md#perplexity) | [perplexity](../SOURCES.md#perplexity) | partial | `2a42086b6b01ead6dab0e899b3d8a5581f04cba4769462fdede7b1053018e331` |
+
+## 下次更新核查
+
+- 对照官网核查精确 ID／别名、是否仍列出、上下文／输入／输出限制及单位。
+- 分别核查推理档位、默认值、是否可关闭思考、采样和强制工具选择限制、多模态输入／输出。
+- 按本接入面核对价格、缓存、阶梯／峰谷、套餐支持；不能把其他平台参数直接复制。
+- 只更新真正复核的字段与引用来源；保留其余待核实项及历史记录。
+- 同步对应 canonical JSON、回归和模型指纹，再运行来源校验。
+
+<!-- source-metadata:start -->
+```json
+{
+  "formatVersion": 1,
+  "supplier": "perplexity",
+  "checkedAt": "2026-10-03",
+  "sourceCatalog": "../SOURCES.md"
+}
+```
+<!-- source-metadata:end -->