docs: 记录 Sub2API 用户错误调优

2026-07-18 05:46:52 +02:00
parent f17ceeb93d
commit 92d1f3cbd0
2 changed files with 39 additions and 1 deletions
@@ -0,0 +1,38 @@
+# R2.18.1 任务报告
+
+## 结论
+
+- PK01 Sub2API 最近 8 小时所有分组共 2672 个请求、117 个客户错误（4.38%）、264 个上游错误（9.88%）。
+- 错误集中在 `unidesk-codex-pool`：896 个请求、117 个客户错误（13.06%）、上游错误率 25.78%；自用池 1785 个请求、0 个客户错误。
+- 最近 2 小时盈利池已恢复到 494 个请求、17 个客户错误（3.44%）、上游错误率 3.85%。其中 16 个是 `glm-5.2` 无组内支持账号的 404，不能归因或扣分给上游账号。
+- 唯一真实上游错误穿透是 `#27 https://sub.yjxm1221.top plus 0.025` 的 `claude-opus-4-8` 流式 502，请求 ID `bbdb8812-ed41-4a90-819d-3886b1b87655`。
+
+## 根因与边界
+
+- `#27` 最近 2 小时原生 Ops 记录 4 个 502：3 个状态型上游失败，1 个流缺少终止事件；模型覆盖 `claude-opus-4-8` 和 `gpt-5.6-sol`，没有并发限制直接证据。
+- 8 小时唯一“切号后失败”请求 `5ecefdb0-5224-4c53-bf0b-288e8709636e` 最终为 499 客户取消：`#31` 在 104.5 秒后触发切号到 `#39`，41.6 秒后客户取消，不作为上游账号可靠性扣分。
+- `#42 carmentucker178408@hotmail.com` 是 runtime-manual OAuth 账号，5 小时额度 100%、原生 quota `allowed=false`，约 3.5 小时后重置；保持 priority 1，避免永久降权损失恢复后的零边际成本。
+- `glm-5.2` 没有任何组内账号真实支持。保持快速 404，不映射到名称相近模型；消除此错误需要新增真实支持该模型的上游或让客户端改用受支持模型。
+
+## Priority 调优
+
+所有变更均先 dry-run，再 confirm，并由精准 runtime CRUD 自动回读，全部 `mismatched=0`；`priority` 数值越小越高。
+
+- `#37 https://www.xiaobaishu.org plus 0.02`：8 调到 6。
+- `#39 https://www.xiaobaishu.org pro 0.02`：8 调到 6。
+- 两个 xiaobaishu 账号近 2 小时合计 41 请求、0 失败，TTFT P95 分别 3007ms 和 3661ms，且人民币采购倍率为 0.02。
+- `#31 https://sub2.pokexiao.com plus 0.04`：5 调到 10；近 2 小时承担 167 个成功请求，但 TTFT P95 30605ms，并有 1 次可归因失败。
+- `#27 https://sub.yjxm1221.top plus 0.025`：10 调到 20；降低发生 502 和不完整流后继续被优先选中的概率。
+- `#32`、`#35` 因 TTFT 偏高不提升；`#28` 样本不足不调整；lyon9801 保持 priority 1 和既有周限保护。
+
+## 短窗口复核
+
+- 调整后 15 分钟：92 个请求、2 个客户错误（2.17%）、上游错误率 4.35%。
+- 两个客户错误均为 `glm-5.2` 不支持 404，没有新的上游 5xx 客户穿透。
+- 成功流式请求 TTFT P50 2081ms、P95 3848ms、P99 4554ms。
+- runtime list 回读确认 `#37/#39=6`、`#31=10`、`#27=20`。
+
+## 变更边界
+
+- 未修改 Sub2API 源码、版本、代理、凭据、分组、容量、Secret、模型映射或外部哨兵。
+- 未给 OAuth 账号应用 API-key 通用临时不可调度模板。
@@ -237,7 +237,7 @@
 ### R2.18 [completed]

 基于 R2.16 优先级和 R2.17 通用 failover 模板下发后约 3 小时的新窗口，再按 PK01 Sub2API 所有分组的用户可见错误与人民币边际成本调优全局 priority：使用原生 runtime errors 聚合完整账号名称、评分、请求、Token、API USD、成本、可归因失败、TTFT、规则命中、切号和置信度，区分盈利池与自用池；只对新窗口证据充分的账号做精准 dry-run、确认写入和回读，不重复计入旧错误，不修改版本、源码、容量、代理、凭据、分组、可调度、临时规则或外部哨兵，完成任务后将详细报告写入[任务报告](./details/sub2api-upstream-reliability/R2.18_Task_Report.md)。
-#### R2.18.1 [in_progress]
+#### R2.18.1 [completed]

 继续调优 PK01 Sub2API 用户可见错误和全局 priority：内部 monitor 使用真实 API key 和正式入口产生的错误与外部客户错误同等纳入正式分析，只标注调用方而不剔除；以近 2 小时所有分组错误确认主因，以近 8 小时账号评分、可归因失败率、TTFT、Token、API USD、人民币边际成本、切号恢复和置信度形成候选；仅通过官方 runtime/YAML 能力做精准 dry-run、确认和回读，不修改源码、版本、代理、凭据、分组或外部哨兵，完成任务后将详细报告写入[任务报告](./details/sub2api-upstream-reliability/R2.18.1_Task_Report.md)。