# R2.5.3 任务报告

## 目标

交由 Artificer 改进 Sub2API 账号评分流程，使一次 `runtime errors` 查询直接输出最近窗口的账号 Token（M/B）和金额（USD `$`），保持 PK01 v0.1.147 兼容、默认 Kubernetes 列表风格、机器输出保留精确值与来源。

## 原生接口取证

2026-07-14 在 PK01 运行面只读验证 `/api/v1/admin/usage`。v0.1.147 原生记录提供：

- `input_tokens`、`output_tokens`；
- `cache_creation_tokens`、`cache_read_tokens`；
- `image_output_tokens`；
- `total_cost`、`actual_cost`；
- 账号、分组、模型、请求时间和首 Token 延迟等归因字段。

最近 4 小时、全部 OpenAI 分组共读取 49 页、4,145 条成功 usage：

- 总 Token：406.796M；
- 原生 `actual_cost`：$448.4070；
- 原生 `total_cost`：$448.4070；
- `unidesk-codex-pool`：1,563 请求、125.660M Token、$136.6777；
- `自用`：2,582 请求、281.135M Token、$311.7292；
- `grok`：无流量。

Token 汇总口径为 input + output + cache creation + cache read + image output；金额直接采用原生 `actual_cost`，并保留 `total_cost` 校验，不引入第二份价格表。

## 实现规格

Issue #2035 已记录完整实现和验收要求：

- 复用账号评分已经读取的 usage 分页，不额外重复扫描；
- 默认账号表直接展示完整账号名称、Token M/B、`$actual_cost`；
- JSON 输出保留精确整数 Token、分项、原始 USD 数值和 provenance；
- 无流量可显示零；API 或字段缺失必须显示 `unsupported/partial`，不得伪装为零；
- 兼容 v0.1.147，不修改运行面、不维护独立价格表。

## Artificer 派单状态

已创建并推送独立 worktree/branch：

- `/root/unidesk/.worktree/sub2api-account-usage-ledger`；
- `feat/sub2api-account-usage-ledger`。

原生资源 API 显示 Artificer 为 `available`，但 `agentrun create task` 被 NC01/nc01-v02 类型化拒绝：

`github/repository-override-pikainc-pikaoa is not declared by YAML lane NC01/nc01-v02`

因此当前没有创建 runner，也没有绕过 YAML 资源契约。Issue #2035 评论已补充原生字段、4 小时数据和派单阻塞证据。任务保持进行中，待 AgentRun lane 资源声明修复后直接继续受控派单与 PR 验收。
