Wayfinder: per-PersonaBot 费用与用量可见性 #34

v1.0 closeout (2026-10-05)

Human 已批准关闭此协调父票。v1.0 的 per-PersonaBot token 用量可见性已完成：#36–#39 全部关闭，初始消费方 #428 已交付，#39 的实现子票 #499、#502、#503、#507 和图表 #592 均已合并。

最终交付契约以 #39、ADR-0094 和其 完成记录 为准：按 PersonaBot、Host-local day、execution role、实际 provider/model 保留四类 token 与未知用量信息；Profile 默认七天、支持模型/provider/执行类别筛选、累计统计与手动刷新。普通 Session 删除后保留统计，彻底清除 PersonaBot 按隐私契约清除可识别用量。旧决策中的 purpose 分项及全表重建描述不代表最终实现。

初始统计 PR #439 与最终切片 PR #641 已合并；真实 DSH、UI 证据和 Human QA 记录随对应 PR/issue 保留。金额估算、账单对账与预算告警不属于此 v1.0 父票。

Destination

为 BotHarness 定出并落地 v1.0 的 per-PersonaBot 用量可见性：DSH usage facts 的完整性、explicit Session ownership 归属、durable 日汇总 projection，以及供 PersonaBot Profile 消费的 read model。金额估算（价格 / 计费口径）不在 1.0 范围，由 #35 留在 v1.1。

Historical decisions (2026-09-29; see final delivery above)

• 数据源：DSH SessionEvent 的 assistant/message.usage 与 assistant/attempt 的 stream usage；按 DSH 导出的 deriveTurnTokenUsage 逐 turn 折四个 token 桶；sessionProjections.tokenUsage 只作每 Session 总量对账（fork 子 Session 含父前缀，按 isOwnSeq 去重）。
• 归属：orchestrator、assignment 及各自 subagent/fork 全部归 PersonaBot；unowned / ambiguous 不计入任何 bot，只进 diagnostics。
• 口径：重试、压缩、自动标题等系统调用计入（带 purpose 便于诊断）。
• 日界：Host OS 本地时区。
• projection：durable 日桶 (bot, day, provider, model, purpose) 存 botharness.db，可从 Session 日志重建；live 增量 + 迟到修正。
• read model：由 Usage read model / Typert remote / Profile contract #39 定义 contract；Profile 卡片只消费 read model，不直读 Session logs / tables。
• 金额：1.0 不做；价格与计费口径：官方来源、币种/时段/缓存规则 #35 价格表、era、币种留 v1.1。

Tickets

• 用量数据完整性：重试 / 压缩 / fork-subagent 的可计费可见性 #36 用量数据完整性：重试 / 压缩 / fork-subagent 的可计费可见性 · research（v1.0）
• Usage projection：derive-on-demand vs durable daily aggregates #37 Usage projection：durable daily aggregates（决策已定，见上；实现随 Tracer 4: token 日桶 projection + token Profile Card #428）
• 费用归属语义：explicit Session ownership → PersonaBot / Assignment / Subagent #38 归属语义：所有 bot-owned Session → PersonaBot；unowned 仅 diagnostics（决策已定）
• Usage read model / Typert remote / Profile contract #39 Usage read model / Typert remote / Dashboard contract · grilling（v1.0，供 Profile 卡片消费）
• 价格与计费口径：官方来源、币种/时段/缓存规则 #35 价格与计费口径 · research（v1.1，不在 1.0）

Consumed by

• PersonaBot Profile: popover + Channel-body view + Profile Card registry #425 PersonaBot Profile epic（T4 Tracer 4: token 日桶 projection + token Profile Card #428 token 日桶 + token 卡）
• Group Profile：群活跃与成员活跃（按消息数） #424 Group Profile（v1.1，按消息数，不用 usage）

Locked architectural baseline

• DSH SessionEvent / Session history 是 Agent execution usage 的候选 durable source；用量数据完整性：重试 / 压缩 / fork-subagent 的可计费可见性 #36 负责验证哪些调用真实可见。
• Foundation：explicit Session ownership 与 DSH activity projection #80 的 explicit Session ownership 是 PersonaBot / Orchestrator / Assignment / Subagent 归属入口；cwd、Workspace Grant 与 UI selection 不参与归属。
• Foundation：operational database owner / writer lease / schema generation #79 已确定 botharness.db 是 BotHarness operational database physical host；Usage module 只拥有自己的 derived projection tables。
• 价格不是 execution fact；1.0 不落金额总账。
• Browser 只通过 read model 查询 usage；Dashboard / Profile 不直读 Session logs 或 tables。

Not yet specified

• 价格表分发、更新与免责声明（价格与计费口径：官方来源、币种/时段/缓存规则 #35，v1.1）。
• DeepSeek account balance 是否与估算并列展示。
• 单 Session 下钻与 Trajectory/Trace 的连接方式。
• 预算与告警是否另立后续 ticket。

Out of scope

• 真实支付、结算或账单对账。
• 实时逐 token 费用动画。
• 用 Cordis Event、Dashboard cache 或日汇总替代 durable execution facts。