会话成本徽章 Sttrevens/dsh-cost-meter

@steven-wu/dsh-cost-meter

树外 dsh 插件，在 Web UI 中为当前打开的对话显示实时的 USD 成本徽章。

它是一个双面 dsh.client 包：

- 宿主端（lib/index.js）在 session-projection 接缝上注册一个 sessionCost 投影。该 fold 从 request/header 事件中跟踪当前的 provider/model，并从 provider 上报的用量桶（未缓存输入 / 输出 / 缓存读取 / 缓存写入）中累计成本，复用 token-meter 的“替换同一个 (turn, step) 样本而不是重复计数”规则。该视图暴露整个会话的合计值，以及一个以轮次编号为键的 byTurn 映射。
- 客户端（lib/client.js）在 conversation.chat.assistant-actions 插槽中注册一个徽章——即每条助手消息末尾的操作行，与轮次的时间/时长信息并列。每个徽章显示该轮次的成本；悬停会打开一个工具提示，其中包含按桶的明细（输入 / 输出 / 缓存读取 / 缓存写入）以及会话总计。

定价表

定价以 USD 每百万 token 为单位，以 provider/model 为键：

{
"per": 1000000,
"currency": "USD",
"default": { "input": 0.6525, "output": 1.9575, "cacheRead": 0.02175, "cacheWrite": 0 },
"models": {
"deepseek-official/deepseek-v4-pro": { "input": 0.6525, "output": 1.9575, "cacheRead": 0.02175, "cacheWrite": 0 },
"deepseek-official/deepseek-v4-flash": { "input": 0.2175, "output": 0.6525, "cacheRead": 0.00725, "cacheWrite": 0 }
}
}

插件在启动时读取 ~/.dsh/cost-pricing.json（可通过 DSH_COST_PRICING 环境变量或该行的 config.pricingPath 覆盖路径）。首次运行时，它会将默认表写入该路径；编辑它并重启 dsh web 以应用更改。没有 models 条目的模型会回退到 default（当没有 default 时成本为零）。

安装

该包声明了 dsh.bundle 清单，因此 dsh plugin add 会安装它，并且自动将其添加到 profile 的 bundle 层——无需手动编辑 patch：

dsh plugin --profile web add @steven-wu/dsh-cost-meter
重启 web profile，然后刷新页面

开发期间使用本地检出：

dsh plugin --profile web add file:/path/to/dsh-cost-meter

注意：
- @deepseek-ai/dsh-* 被声明为 peerDependencies（从 harness 解析），绝不作为 dependencies——将它们安装到 profile 中会遮蔽 harness 副本，并可能拉取过期的 dist-tag。
- 设置中的“Plugins”面板是只读的（清单 + 配置卡片）；安装只能通过 dsh plugin --profile … add 进行。
- 纯 cordis 挂载（cordis.patch.yml 插入行）也可以工作——随附的 cordis.patch.yml 为任一方式保留了该行。

sessionCost 投影通过与 tokenUsage / sessionStats 相同的接缝传递，因此它也会出现在每个投影载体中（历史尾部页面，session/projection 推送帧）无需额外接线。