[Grok/dsh 65] 用量、费用与跨入口统计

[Blackman99]

Parent

#132

Ticket: 65

Status: ready-for-agent

User Stories: 17, 33, 64（见父规格）

What to build

用户查看会话、模型和子代理用量，终端状态、统计命令及 JSON 输出一致，并明确哪些费用不可得。

Acceptance criteria

• 验证输入/缓存/输出/推理计数与每模型汇总，子代理计入规则及辅助模型例外按参考区分。
• 缺费用或部分费用不显示为零，不把估算标为账单真实值；恢复后不重复累计。
• CLI、headless、状态行与会话信息读取同一可解释统计，失败/中断回合同样一致。
• 受控提供商响应和真实 dsh 父子回合验证完整/缺失/部分报告，费用文档与发布元数据同步。

Blocked by

• [Grok/dsh 08] 多提供商模型与推理选项 #140 — Ticket 08: 多提供商模型与推理选项
• [Grok/dsh 14] 无头 JSON 与流式事件兼容 #146 — Ticket 14: 无头 JSON 与流式事件兼容
• [Grok/dsh 22] 设置、主题与状态行 #154 — Ticket 22: 设置、主题与状态行
• [Grok/dsh 40] dsh 子代理执行与任务视图 #172 — Ticket 40: dsh 子代理执行与任务视图

Delivery contract

用户于2026-09-20批准当前测试与任务拆分。按父规格的已安装产物/真实终端和公开协议测试验收；实际实现须带适用的文档、Changeset及必要检查。ready-for-agent表示任务已定义，不表示前置任务已完成，也不授权自动开始本轮实施、购买付费资源或发布软件版本。

[Blackman99]

已集成到 rewrite/grok-dsh-20260920：5f48970（已 rebase 到 #196、#204 之上，双方改动都保留）。

实现

• 统一账本：packages/cli/bin/rust-usage.mjs 折叠 dsh 会话日志。一次模型调用 = 一次 dsh 尝试（step/start 或重试 → 结束），token 取服务商上报的用量：输入含缓存读/写，输出含推理，并按 provider/model 路由分行。
• 子代理计入启动它的父回合，同时单列会话数和 token。辅助调用（会话标题、压缩摘要、/btw、记忆）不在会话日志中，不计入，并在界面上注明。
• 折叠覆盖整份日志，恢复后不重复累计。分叉按参考规则保留继承的历史；-p 结果只报告本次提示启动的回合。
• 未上报用量的调用、中断或失败的回合、运行中或缺失日志的子代理，都标为“不完整、可能少计”，不补 0。
• 费用：dsh 不上报费用，固定版本的 dsh 与参考源码里也没有价格表。因此费用一律显示“not available”，headless 写 cost_status: "unknown"，不估算，也不显示 $0。只有服务商真实上报时才会出现费用（Rust 单测覆盖）。
• 各入口读取同一账本：
  • TUI：/usage（别名 /cost）、/session-info 的 Usage 行；
  • 状态行命令负载：session_usage、context_window.session_*_tokens、cost.total_api_duration_ms；
  • headless：json / streaming-json / streaming-messages-json；
  • 新命令 codsh --rust usage <session-id> [turn]（参考 JSON 信封）。
• TUI 提示区从 6 行增至 8 行，使 /session-info 加上用量行后仍能显示会话 ID。
• README / README.zh / CONTEXT、帮助文本、补全脚本和 changeset（minor）已同步。

实际运行的检查（Linux）

• pnpm run typecheck 通过。
• pnpm test：2559 通过、15 跳过。2 个 rust-plugin-mcp 用例因 target/debug 二进制过期而失败，重建后单独重跑 2/2 通过。rebase 前负载下 reference-evidence 与 rust-launcher 各有一次已知超时，单独重跑均通过。
• 新增 vitest scripts/rust-usage.spec.mjs：与 rust-control.spec.mjs 合计 25/25 通过。
• cargo test -p codsh-rust：661 通过，4 个已知失败（2 个 filesystem_sandbox 缺 bubblewrap，privacy/voice 假服务器不稳定）。
• cargo test --workspace --exclude codsh-rust：1043 通过。
• cargo clippy 0 警告；cargo fmt --check 通过。
• 新增 PTY scripts/rust-usage-pty-test.py：真实 dsh 父子回合 + 无密钥 mock 服务商，15 项全部通过：
  • /usage、/cost、状态行负载、/session-info、CLI 及其错误；
  • 恢复不重复计数后新增回合；Ctrl+C 中断回合计为未上报调用；
  • 完整 / 缺失（none）/ 部分（child-none）报告；
  • headless 三种格式、-c 切片、--fork-session、失败回合；
  • 子代理走第二条模型路由，每模型汇总为真实数据。
• 其他 PTY：
  • rebase 后：rust-plain-json-test.py 10/10，rust-plugin-mcp-pty-test.py 通过；
  • rebase 前：workflow、goal、plugin-content、memory-capture、subagent、queue、background、subagent-message、plan、monitor 均通过；
  • rust-plain-pipe-test.py 通过了用量断言，但在沙箱步骤失败：本机没有 bubblewrap，属于环境问题。

未验证

• macOS / Windows（仅 Linux）。
• 真实付费服务商：未调用任何付费模型。真实服务商的用量字段和费用上报，留给 [Grok/dsh 71] 固定任务集的真实模型评测 #203 在获得批准后验证。

main、npm 发布、默认版本均未改动；PR #213 未合并。本工单解除 #203（真实模型评测）的阻塞，但 #203 未启动，需要所有者批准。