# @deepseek-ai/dsh-client-ui-openrouter-usage

[English](README.md) | 中文

OpenRouter 花费界面插件（浏览器端部分）：`conversation.composer.dock` 条带中的每会话 会话费用 读数（`CostDock`，order 5，紧跟内置 stats 行之后），加上侧边栏底部的账户 余额 徽章（`BalanceBadge`，位于 `sidebar.footer.action`）。

`CostDock` 读取持久的 `openRouterCost` 投影（由历史尾页播种、由 `session/projection` 帧更新），仅当一个 step 真正计价后才显示 `会话费用 $X.XX`——不会出现零成本分组。未知定价的 step 数会通过 tooltip 呈现，从而让数值的覆盖范围依然可见。因此 `CostDock` 不持有 store、不设刷新链、不挂事件监听。

`BalanceBadge` 是账户级别的值，不属于会话投影：slot 注入面携带一个 `snapshot()` 回调，按 60 秒间隔轮询 host 的 `ctx.remote.openRouterUsage.snapshot()` Remote，并驱动本地状态。在折叠的 rail 中只渲染余额标记；在宽列中呈现带标签的胶囊。未知或缺失的值渲染为空占位。两个条目在真实数据出现之前都不渲染任何内容，因此未组装 OpenRouter 网关或 key 的组装体不会产生任何布局成本。

`/client` 的导出接口包括插件本体（`apply`/`inject`）、`CostDock`/`BalanceBadge` 组件与注入面类型。

## 模型体验

间接影响：无。无论是花费读数还是余额徽章都不会注入任何模型上下文；它们只是 `openRouterCost` 投影与 `openRouterUsage` Remote 快照的纯客户端只读模型。agent 循环与所有提示词均保持不变。

#### KV Cache 影响

无。花费来自既有的日志用量事件，余额是一个获取到的账户数值；两者都不是新的模型可见输入。

## 已知限制与暂缓事项

- **以折叠时刻计价**——`CostDock` 渲染持久投影当前持有的数值；已折叠历史的数值反映折叠时的定价表（见 `dsh-openrouter-usage`）。
- **轮询而非推送**——`BalanceBadge` 轮询 host 快照；没有 `openRouterUsage` 转发事件通道，因此数值按轮询间隔更新，而非即时。