@chenlongapps/opencode-token-usage 0.4.7 → 0.4.9

package/docs/verification.md

@@ -1,5 +1,150 @@
 # 验证记录
 
+## 2026-10-10 · 移除 Run Time 运行状态动画（未发布）
+
+侧边栏、子代理摘要／完整浮窗以及 `/usage` 紧凑／详细模式直接显示耗时，不再附加 `Running.`／`Running..`／`Running...`。移除 `src/running.ts`、动画专用计时器及其 5 项测试，清理仅供动画使用的会话 ID 传递；各入口的原生状态仍用于控制 `~` 实时估算，共享 500ms 耗时 ticker 与原生累计算法未改动。零值隐藏、不可用／未更新标记及面板末行顺序保持不变。
+
+新增子代理摘要回归测试覆盖实时估算、未更新／不可用值与窄终端；smoke 改为检查耗时行不含运行提示、没有新增量时估算仍推进、完成／中断后恢复原生值，并断言打包产物不包含旧动画模块。中英文 README 与产品约定已同步，旧动画验证记录保留为历史记录。
+
+环境：macOS、Node.js v22.23.2、npm 10.9.8，插件包 0.4.8、SDK 2.0.24、OpenTUI 0.5.14，真实宿主 OpenCode 2.0.26；沿用 V2 CLI 插件 API。
+
+| 检查 | 结果 |
+| --- | --- |
+| `npm run typecheck` | 通过 |
+| `npm test` | 205 项通过：移除 5 项动画测试，新增 1 项摘要回归测试 |
+| `npm run build` | 通过；已清理本地旧动画构建产物 |
+| `node --check scripts/smoke.mjs`、`git diff --check` | 通过 |
+| `npm run test:smoke` | 真实 OpenCode 2.0.26 打包／隔离安装的完整检查通过 |
+
+真实 TUI 在侧边栏、两种 `/usage`、子代理摘要／完整浮窗及 48 列子代理视图中均不再显示运行提示，并在没有新流式增量时继续推进 `~` 耗时。同一耗时行在观察期间位置不变；完成／中断后恢复不带 `~` 的原生累计值，空闲父会话不随子代理增长。零值隐藏以及原有标题点击、上下文、定价、TPS／TTFT、Responses 突发／静默、分叉与压缩检查全部通过，没有调用真实付费模型或修改现有 OpenCode 配置。
+
+验证产物：`/var/folders/rw/bmx6c8hd737brl55m0_ff_b80000gn/T/token-usage-smoke-kuK7vo`，其中 `10-running-*-start.txt`／`advanced.txt` 保存各入口没有运行提示且耗时继续增长的画面，`result.json` 保存原生耗时、宿主版本与不含旧动画模块的打包文件列表。Node 22 的既有 OpenTUI 引擎警告与 MockTimers 实验警告保留。
+
+插件版本、SDK、价格快照未变；未升级版本、提交、推送或发布。
+
+## 2026-10-10 · 实时 TPS 突发增量保护（未发布）
+
+`src/performance.ts` 合并 100ms 内的可观察增量，以每个近期窗口的首批增量作为计数基线，不把基线字节计入其时间戳之后的输出；有效跨度至少为 500ms，窗口仍为约 2 秒。EWMA 按经过时间计算权重，最多每 100ms 推进一次，与 delta 条数和视图读取次数解耦。超过窗口的服务端事件间隔或本地静默会重建基线并清除旧平滑值，不使用模型专属倍率、TPS 硬上限或隐藏 reasoning 猜测。
+
+共享性能监视器的超时任务同时负责近期窗口与已有 TTFT 保留期清理：连续 2 秒没有新 delta 后，使实时估算过期并通知视图，回退到已准备的历史 TPS，没有历史值则隐藏该行。静默年龄只使用本地单调时钟，不拿客户端 epoch 减服务端时间；超时和增量均不读取历史或调用 API，也不改变原生 Run Time。TTFT 仍取 step 开始到首个原始增量，完成后的全树 assistant `Σ(Output + Reasoning) ÷ Σ(time.streamed − time.created)` 口径不变。读取失败、切换会话、多视图共享和子代理范围沿用现有控制器。
+
+环境：macOS、Node.js v22.23.2、npm 10.9.8，插件包 0.4.8、SDK 2.0.24、OpenTUI 0.5.14。已复核 V2 插件／CLI 文档与版本固定的 OpenCode 2.0.26 Responses 适配器和事件总线：事件 `created` 是宿主发布时间，done-only 摘要可回退为 delta，并非内部 token 生成时钟。
+
+| 检查 | 结果 |
+| --- | --- |
+| `npm run typecheck` | 通过 |
+| `npm test` | 209 项通过，新增 12 项近期 TPS、突发、时钟、过期及共享控制器回归测试 |
+| `npm run build` | 通过 |
+| `node --check scripts/smoke.mjs`、`node --check test/fixtures/responses.mjs`、`git diff --check` | 通过 |
+| `npm run test:smoke` | 真实 OpenCode 2.0.26 打包／隔离安装的完整检查通过，包含新增 Responses SSE 场景 |
+
+自动化测试覆盖 10ms 摘要突发、同时间戳与碎片化基线、长暂停后恢复、500ms 边界、乱序／重复／空增量、UTF-8、时间加权平滑、有效高速不限幅、客户端／远程 epoch 偏差、无事件过期、并发独立过期、删除／销毁清理、TTFT 保留及多视图不读取历史。中英文 README 已同步说明首次测速延迟、静默回退及实测／估算口径差异。
+
+新增本地 Responses SSE 模拟提供商，包含摘要 delta 突发、第二段 done-only 摘要、间隔 600ms 的文本和静默等待；宿主仍为真实 OpenCode，不调用付费模型或修改现有配置。首轮事件记录中，宿主将摘要交付为相隔 5ms 的 800／400 字节 delta，TUI 正确只显示 TTFT、不显示 TPS；失败的是标题误匹配断言，而非插件指标。限定为数值指标行后，完整复验通过：摘要突发不显示 TPS，后续文本显示 `~11.3 tok/s`，静默后隐藏 TPS、仍保留 `TTFT 0.3s`，完成后按服务端上报的 Output 200 与 Reasoning 800 恢复无 `~` 的历史吞吐。原有侧边栏标题、详情、窄终端、子代理、原生耗时、定价、分叉和压缩检查全部通过；不宣称真实 OpenAI 服务已验证。
+
+验证产物：`/private/var/folders/rw/bmx6c8hd737brl55m0_ff_b80000gn/T/opencode/token-usage-smoke-ZKisPX`，其中 `11-responses-burst.txt`、`11-responses-live.txt`、`11-responses-quiet.txt`、`11-responses-completed.txt` 保存四个阶段，`stream-events.json` 保存真实宿主事件，`result.json` 记录 Responses 实时与历史 TPS 及原有全套结果。Node 22 的既有 OpenTUI 引擎警告与 MockTimers 实验警告保留。
+
+插件版本、SDK、价格快照未变；未升级版本、提交、推送或发布。
+
+## 2026-10-10 · 点击侧边栏标题查看详情（未发布）
+
+侧边栏 `Token Usage` 标题的左键单击复用 `/usage` 的 `UsageDialog` 与统一打开函数，默认紧凑模式，保留 `d` 切换、居中 large 弹窗、滚动及 Escape／esc 关闭。按标题所属的被查看会话打开，不改变统计口径或子代理摘要入口；仅弹窗挂载期间保留原有独立详情控制器，关闭沿用现有取消读取、订阅与 ticker 清理。
+
+新增 `src/click.ts`：匹配左键按下／同一位置松开，拖动取消，选中文字不触发；只有有效点击才阻止鼠标事件冒泡。OpenTUI 的文本普通点击也可能带 `isDragging: true`，因此不把该标记直接当作实际拖动。其他统计行未绑定打开事件，保留文字选择。
+
+环境：macOS、Node.js v22.23.2、npm 10.9.8，插件包 0.4.8、SDK 2.0.24、OpenTUI 0.5.14，真实宿主 OpenCode 2.0.26；已复核 V2 插件／CLI 文档及已安装 OpenTUI 的鼠标选择语义。
+
+| 检查 | 结果 |
+| --- | --- |
+| `npm run typecheck` | 通过 |
+| `npm test` | 197 项通过，新增 5 项点击、防误触与选择事件回归测试 |
+| `npm run build` | 通过，包含 click 模块与类型声明 |
+| `node --check scripts/smoke.mjs`、`git diff --check` | 通过 |
+| `npm run test:smoke` | 真实 2.0.26 打包／隔离安装的完整检查通过 |
+
+真实终端新增断言覆盖空会话与已有用量、标题中键／右键、标题拖选、普通统计行不打开、切换会话后的正确身份、默认紧凑与 `d` 详细模式、Escape／点击 esc 关闭及重复打开后恢复默认模式。检查消息数量与模拟提供商请求数量均不增加；运行中的标题入口继续显示、推进并结算实时耗时。原有窄终端、子代理、全树累计、逐消息计价、未知上下文上限、分叉及已完成压缩检查全部通过。
+
+验证产物：`/private/var/folders/rw/bmx6c8hd737brl55m0_ff_b80000gn/T/opencode/token-usage-smoke-PAneuj`，其中 `01-sidebar-usage-dialog.txt`、`06-sidebar-usage-dialog.txt` 保存标题入口的空／有用量弹窗，`10-running-usage-*` 保存运行中的详情与三帧动画，`result.json` 记录真实宿主版本、打包文件与最终统计。Node 22 的既有 OpenTUI 引擎警告与 MockTimers 实验警告保留。
+
+中英文 README 已同步入口与操作说明，并明确新入口仅在 2.0.26 完成集成验证。插件版本仍为 0.4.8，SDK 与 OpenTUI 依赖未变；未升级版本、提交、推送或发布。
+
+## 2026-10-10 · 当前已耗时实时估算（未发布）
+
+运行中 `Run Time`／`Time` 用 `~` 显示截至当前的累计耗时估算，首轮非零估算也可见，不预测最终或剩余时间。`src/runtime.ts` 从同一次完整历史扫描准备当前轮起点及已计入的重叠时长；显示值用当前轮估算替换同轮已有时长，`milliseconds` 仍只保存原生已完成累计。工具、重试及前台等待继续计时；terminal 回答／执行结束先冻结显示，刷新后以原生完成时间结算并移除 `~`，允许向下校正。读取失败保留冻结的估算及未更新标记，未知历史时间仍显示不可用。
+
+新增 `src/runtime-monitor.ts`，以服务端时间锚点和本地单调时钟推进共享的 500ms ticker；时钟 tick 不扫描历史、不读取 API。启动／重连通过现有 `opencode-token-usage.context` RPC 的只读 `clock` 方法取得时间，不保存数据、不读 MCP、不进入模型调用链路；RPC 不可用或慢响应时，可用带时间戳的实时事件建立锚点，不阻塞实测统计。无可信锚点时保留原生累计值，不用客户端 epoch 时间猜测远程时间。各入口使用同一监视器，关闭最后一个估算视图后取消 ticker；会话切换隔离旧结果，空闲父会话不继承子代理的活动。
+
+环境：macOS、Node.js v22.23.2、npm 10.9.8，插件包仍为 0.4.8、SDK 2.0.24、OpenTUI 0.5.14，真实宿主 OpenCode 2.0.26。已复核 V2 插件／CLI／RPC 文档及已安装 SDK；实际 2.0.26 的 synthetic `server.connected` 握手缺少 `created`。首轮集成因此暴露了新开安静子代理视图没有锚点的问题，已用可选只读 RPC 修复，并加入实际握手形状的回归夹具。
+
+| 检查 | 结果 |
+| --- | --- |
+| `npm run typecheck` | 通过 |
+| `npm test` | 192 项通过，新增 24 项估算、时钟、控制器及显示回归测试 |
+| `npm run build` | 通过，包含 runtime monitor 与类型声明 |
+| `node --check scripts/smoke.mjs`、`git diff --check` | 通过 |
+| `npm run test:smoke` | 真实 2.0.26 打包／隔离安装的完整检查通过 |
+
+自动化测试覆盖首轮、同轮 steer／retry 重叠替换、工具等待、历史空闲、legacy／无输入／分叉起点、terminal 完成后的迟到快照、失败冻结与恢复、无锚点降级、远程时间与客户端 epoch 偏差、共享 ticker 清理、可选 RPC 的慢响应／失败／取消／迟到结果及只读性。时钟偏差与读取失败由固定夹具验证，没有宣称在真实远程宿主注入这些故障。真实 TUI 在侧边栏、两种 `/usage`、子代理摘要／完整浮窗及 48 列视图分别捕获三个 Running 动画帧并确认无新流式增量时估算仍增长；验证首轮显示、切换／新开正在运行的会话、正常完成和中断后的精确结算、空闲父会话不随子代理增长，以及原有分叉、压缩、定价、上下文和 TPS／TTFT 检查。
+
+验证产物：`/private/var/folders/rw/bmx6c8hd737brl55m0_ff_b80000gn/T/opencode/token-usage-smoke-FxP0I5`，其中 `02-switched-streaming.txt` 与 `04-streaming.txt` 保存首轮实时值，`10-running-*` 保存各入口实时值及三帧动画，`result.json` 保存最终原生累计值。Node 22 的既有 OpenTUI 引擎警告与 MockTimers 实验警告保留。本次未升级版本、提交、推送或发布。
+
+## 2026-10-10 · Run Time 运行状态动画
+
+可见的 `Run Time`／`Time` 值按当前查看会话的原生 `context.data.session.status(sessionID)` 附加运行状态。新增 `src/running.ts`，每 500ms 循环 `Running.`／`Running..`／`Running...`，用空格补齐三个点的位置，避免右对齐数值及摘要后续字段移动。动画只更新显示信号，不读取消息历史、不估算未完成耗时，不把子代理活动状态归给空闲的父会话。零值隐藏、不可用／未更新标记以及 Run Time 末行顺序保持不变；进入空闲、隐藏时间项、关闭视图或切换会话时清理原计时器。
+
+环境：macOS、Node.js v22.23.2、npm 10.9.8，插件包 0.4.8、SDK 2.0.24、OpenTUI 0.5.14，真实宿主 OpenCode 2.0.26。
+
+已通过 `npm run typecheck`、168 项 `npm test`（新增 5 项动画循环、固定宽度、清理／重启与格式兼容回归测试）、`npm run build`、smoke 脚本语法检查、`git diff --check` 和完整 `npm run test:smoke`。真实打包／隔离安装在侧边栏、`/usage` 两种模式、子代理摘要／完整浮窗与 48 列子代理视图中分别捕获三个动画帧，确认行位置、累计数值及 Running 起始列不移动，生成中累计值不增长。中断／完成后移除运行提示并恢复已完成原生耗时；打开已经运行的子代理能恢复状态，空闲父会话不继承子代理的运行标记。零值隐藏及原有全套集成断言均通过。
+
+Node 22 的既有 OpenTUI 引擎警告保留。本次未升级版本、提交、推送或发布。
+
+验证产物：`/private/var/folders/rw/bmx6c8hd737brl55m0_ff_b80000gn/T/opencode/token-usage-smoke-4anV5A`，其中 `10-running-*-1-dot.txt`／`2-dot.txt`／`3-dot.txt` 保存各入口的三个帧，`result.json` 保存最终原生耗时及原有集成结果。
+
+## 2026-10-10 · 隐藏零耗时项
+
+正常状态下确认累计原生耗时为零时，侧边栏、子代理摘要／完整浮窗以及 `/usage` 紧凑／详细模式均隐藏整个 `Run Time`／`Time` 项，不留空行或空字段。非零毫秒值、未知值 `—` 与 `Not updated`／`stale` 提示保留。耗时统计与刷新逻辑不变；窄终端没有 Time 时仍保留可用指标，而不是只剩标题。
+
+环境：macOS、Node.js v22.23.2、npm 10.9.8，插件包 0.4.8、SDK 2.0.24、OpenTUI 0.5.14，真实宿主 OpenCode 2.0.26。
+
+已通过 `npm run typecheck`、163 项 `npm test`、`npm run build` 和完整 `npm run test:smoke`。新增 3 项显示回归测试，覆盖零值隐藏、非零毫秒、无效／未知时间、未更新的零值仍带提示、其他面板行不变，以及窄终端摘要的字段和分隔符。真实打包／隔离安装检查覆盖空侧边栏、两种 `/usage` 模式、空子代理摘要／浮窗与 48 列视图；生成中继续隐藏零值，完成后恢复非零耗时，原有全套集成断言均通过。
+
+Node 22 的既有 OpenTUI 引擎警告保留。本次未升级版本、提交、推送或发布。
+
+验证产物：`/private/var/folders/rw/bmx6c8hd737brl55m0_ff_b80000gn/T/opencode/token-usage-smoke-sC9gcQ`，其中 `01-empty-usage-dialog.txt` 与 `01-empty-child-narrow.txt` 保存零耗时隐藏后的界面。
+
+## 2026-10-09 · Run Time 移至面板末行
+
+将侧边栏与子代理完整浮窗的行序调整为 TPS → TTFT → Run Time；任一性能指标缺失时，Run Time 仍为最后一行。保留原有分组空行，统计口径与子代理单行摘要不变，`/usage` 继续在 Session 区域末行显示耗时。
+
+已通过 `npm run typecheck`、160 项 `npm test`、`npm run build` 与真实 OpenCode 2.0.26 的完整 `npm run test:smoke`。行序测试覆盖只有 TPS、只有 TTFT、无性能数据及无效性能数值；真实终端分别核对侧边栏与子代理浮窗的末行位置。本次未升级版本、提交、推送或发布。
+
+验证产物：`/private/var/folders/rw/bmx6c8hd737brl55m0_ff_b80000gn/T/opencode/token-usage-smoke-8HSjAl`，其中 `05-message.txt` 显示 TPS、TTFT、Run Time 的最终行序。
+
+## 2026-10-09 · 当前会话累计原生对话耗时（未发布）
+
+环境：macOS、Node.js v22.23.2、npm 10.9.8，插件包仍为 0.4.7、SDK 2.0.24、OpenTUI 0.5.14，真实宿主为 PATH 中的 OpenCode 2.0.26。本次未升级插件或 SDK 版本、未修改价格快照，未提交、推送或发布。
+
+新增 `src/runtime.ts`，复用 `message.list(order: "asc")` 的完整保留历史。口径核对版本固定的宿主源码 [`turnDuration` / `legacyTurns` / `inputIndex`](https://github.com/anomalyco/opencode/blob/v2.0.26/packages/tui/src/routes/session/rows.ts)：assistant 完成时间减去上一条 idle 之后首个 user／synthetic 输入的创建时间；无 idle 的旧历史取最近输入，无输入时取 assistant 创建时间，负差值按原生算法截为零。每个轮次只保留最终已完成回答的时长，工具调用等中间 step 不重复计入；未完成的 steer 保留同轮上一条已完成回答的值，后续完成时替换而不是叠加。先累加毫秒，再格式化为毫秒／一位小数秒／分时单位。
+
+累计范围仅为当前查看会话，不额外加入子会话耗时；主会话等待子代理的跨度自然包含在主轮次内。轮次之间的空闲不增长，生成中的回答不做实时计时估算。失败／中断回答有原生完成时间戳时累计；历史完成时间缺失或无效时显示 `—`，不冒充完整的零值或小计。普通读取失败保留上次快照并标注未更新。分叉继承副本不继承累计值；压缩保留历史轮次，暂存回退不扣除，但已提交回退删除消息后相应耗时也移除。
+
+侧边栏在用量与费用之后、TPS／TTFT 之前显示 `Run Time`；子代理摘要加入 `Time`，窄终端省略其他字段以保持单行，点击浮窗复用同一控制器；`/usage` 的 Session 区域独立显示 `Run Time (this session)`。原有 token、费用及性能统计仍覆盖会话树。已移除先前尝试的执行日志适配器、监视器与实时估算，不依赖默认未保存正文的实验性 `session.log`，也不需要服务端插件新增持久化。
+
+| 检查 | 结果 |
+| --- | --- |
+| `npm run typecheck` | 通过 |
+| `npm test` | 160 项通过，新增 23 项时间算法、5 项控制器与 3 项格式／行序／窄终端回归测试 |
+| `npm run build` | 通过，产物包含 `dist/runtime.js` 与类型声明 |
+| `npm run test:smoke` | 完整通过，真实打包／隔离安装 + OpenCode 2.0.26 + 本地模拟提供商 |
+
+自动化测试覆盖多轮空闲、重叠页脚去重、首个／最近输入、synthetic／steer、没有输入时的回退、无用量消息、时间缺失及无效日期、失败／中断、压缩、分叉副本及开放轮次边界、累计值重建、会话切换迟到结果隔离、子代理刷新范围、刷新失败保留快照与暂存／已提交回退。时间计算没有额外请求或每秒读取，沿用原有分页与消息快照。
+
+真实 TUI smoke 直接比对首次回答同屏的原生页脚与插件累计值，并以独立的向后扫描 oracle 核对逐轮毫秒合计；另验证空会话为 `0s`、生成中不伪造时长、空闲不增长、累计父轮次不额外加入子代理、切换和新 TUI 从消息历史恢复、子代理浮窗与 48 列单行摘要、中断增加已上报的原生时长，以及真实分叉不继承时间、已完成 compaction 保留升序完整历史。原有 `/usage`、模型切换、TPS／TTFT、未知上下文上限、逐消息定价等全部断言继续通过。
+
+本轮原生耗时的真实集成仅验证 2.0.26；旧历史语义由固定夹具覆盖，没有据此宣称在所有旧宿主重新完成验证。SDK 的已验证宿主记录加入 2.0.26，保留 2.0.11／2.0.22／2.0.24 的既有记录。Node 22 MockTimers 与 OpenTUI 引擎警告保留，没有隐藏或强制绕过。
+
+验证产物：`/private/var/folders/rw/bmx6c8hd737brl55m0_ff_b80000gn/T/opencode/token-usage-smoke-22Efc0`，其中 `05-message.txt` 保存同屏原生页脚与 `Run Time`，`result.json` 保存各会话累计毫秒和宿主版本。
+
 ## 2026-10-09 · 统计钩子的 MCP 等待上限
 
 环境：macOS、Node.js v22.23.2、npm 10.9.8，插件包仍为 0.4.6、SDK 2.0.24，真实宿主为 PATH 中的 OpenCode 2.0.25。未升级版本、提交、推送或发布。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chenlongapps/opencode-token-usage",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "description": "Session-tree token usage, live performance, context window and estimated cost for OpenCode 2",
   "keywords": [
     "opencode",