# R14 Sub2API 账号评分渐进披露改进报告

## 问题

`runtime errors --group ... --since ...` 默认文本把账号质量、用量成本和故障控制拆成三张宽表，并附完整客户错误维度与 request 索引。12 个账号时远端结果达到约 35-50 KB，默认输出可能触发全局保护；本次调优因此退化为多次逐账号查询，违背“一次常规评分命令完成评分与成本评估”的既有合同。

## 实现

- 关联 [UniDesk #2408](https://github.com/pikasTech/unidesk/issues/2408)。
- 默认分组视图把账号名称、ID、priority、评分、等级、置信度、尝试、可归因上游失败、失败率、TTFT P95、请求、Token、API USD、人民币采购倍率、人民币上游成本、切号恢复和可用性合并为一张表。
- 默认客户错误只保留有界模型、状态码、同步/流式和消息桶摘要。
- `--account` 继续展示完整账号质量、成本、排除原因和故障控制；`--full` 继续提供完整有限索引；显式 JSON 合同不变。
- 更新 `unidesk-sub2api` 权威 reference，固定一次常规命令的最短路径和渐进披露边界。
- 未修改 Sub2API 源码、版本、生产 runtime、账号或 YAML 配置。

## 验证

执行真实只读命令：

`bun scripts/cli.ts platform-infra sub2api codex-pool runtime errors --target PK01 --since 8h --group 2`

结果：

- 一次调用直接返回 12 个账号的聚合评分、用量、成本与恢复信息。
- 默认输出没有 `outputTruncated`，无需 dump 或逐账号拼表。
- 同一输出保留 group 概要、TTFT、客户错误摘要、可用性、根因和策略效果。
- 账号与 `--full` 下钻命令继续在默认输出末尾明确展示。
- 按仓库规则未新增测试；真实只读 smoke 同时验证了参数解析、远端采集、compact 投影和默认文本渲染。

## 工具调用改进

同类账号池调优由“全组查询触发输出保护，再对多个账号逐一补查”收敛为“一次全组查询；只有具体 request 或单账号配置需要时再下钻”。变化项继续由 `--target`、`--since` 和 `--group` 参数表达，没有硬编码本次账号、窗口或分组。
