前言¶
在 DSH 里跑长会话时，宿主自带的统计胶囊通常只报 token，不报人民币参考费用，也不会在输入区旁边直接给出账户余额。若再装一套「账本 + 轮询 + 自行持久化」的计费插件，体积和兼容范围往往偏大，部分项目还标注只支持较早的 dsh 版本，在新 harness 上装不上。
下面介绍维护者 oliblue-evan 发布的 dsh-liao-usage（社区目录条目可能以 dsh-usage-pill 展示）：在输入框下方增加一枚胶囊，汇总本会话 token 用量、按 DeepSeek 价表与峰谷/档位换算的参考费用，以及账户余额；已登录 DeepSeek 账号时查余额不需要配置 API Key。插件归类为 admin-security，当前 GitHub 星标为 0，许可证 MIT，版本 1.2.1（以 package.json 为准）。
这是什么¶
dsh-liao-usage 是单文件客户端 bundle + 无额外运行时依赖的宿主半边：客户端读 DSH 自带的 tokenUsage 投影与宿主注册的 usagePillCost 会话投影；余额优先走宿主账号远程 ctx.remote.account.getBalance，未登录时才回落到 DEEPSEEK_API_KEY 与官方 /user/balance 路由。费用为参考估算，余额为接口返回值；面板会区分「逐笔实际发生额」与「按当前价估算」，避免把估算当成账单。
核心功能¶
底部胶囊¶
输入框下方显示类似：
🧮 108.0k tok · ¥0.05 · 余 ¥123.45
（截图与文档中的数值均为示例。）前置图标表示峰谷：太阳为高峰、月亮为空闲；中间为当前参考花费，末尾为账户余额。token 总量主要出现在展开面板中，避免与宿主已有统计胶囊重复。
展开面板¶
点开可见四桶明细（缓存命中 / 未命中 / 写入 / 输出）、计价口径、峰谷倒计时与今日时段轴。会话中途换过模型时，在合计之外按模型 id 分列金额（仅多模型时显示）。DeepSeek 不回报「缓存写入」时，对应行在 token 与金额均为 0 时自动隐藏。
余额来源¶
| 路径 | 条件 | 说明 |
|---|---|---|
| 账号授权 | 已登录 DeepSeek 账号 | 复用宿主 getBalance，密钥不下发浏览器；面板标注来源为「账号」 |
| API Key | 账号返回 null | DEEPSEEK_API_KEY，60 秒缓存、手动刷新可 bypass；面板标注「API Key」 |
余额请求去重并共享 60 秒缓存；失败时保留上次余额并标注，提供重试入口。
参考费用口径¶
正常情况使用宿主 usagePillCost 投影：每笔 assistant/message / assistant/attempt 按事件发生时刻的峰谷与当时模型档位累加，避免「用当前价反推历史用量」在跨峰谷或换模型时改写过去花费。投影不可用时降级为「按当前价估算」，面板底部会写明。内置价目与社区插件 dsh-token-billing 的内置表逐位一致；高峰为北京时间周一至周五 09:00–12:00、14:00–18:00（左闭右开），周末与中国法定节假日按空闲计价。
设置（1.2.0）¶
设置分为「底部胶囊」与「展开明细」两组卡片，带即时示例（示例数据明确标注，不查账号、不改会话）。支持一键恢复默认显示设置，不触碰用量、历史计价或账号授权。
与同类做法的差异（README 归纳）¶
- 用量：读宿主
tokenUsage投影，而非自建全量账本与定时轮询。 - 余额：账号登录优先，同类插件中不少仍要求自行配置 API Key 才能看真实余额。
- 体积：约 30 KB 量级，无构建步骤；仓库含 71 项断言（
npm test）。
本插件不做跨会话历史/今日统计类大账本；需要仪表盘、预算、CSV 导出等完整计费台的用户应另选功能更全的插件，并自行核对 engines.dsh 兼容范围。
安装与启用¶
安装命令须来自仓库 README，安装后刷新页面：
plugin_manager(action: "install_bundle", target: "github:oliblue-evan/dsh-liao-usage")
宿主半边通过 cordis.patch.yml 插入 usage-pill 槽位；客户端注入 @deepseek-ai/dsh-client-ui-conversation 与 @deepseek-ai/dsh-api-remotes。peerDependencies 要求 @deepseek-ai/dsh-api-remotes 与 @deepseek-ai/dsh-client-ui-conversation 为 >=0.2.1-rc.2 <0.3.0-0（以 package.json 为准）。
disclosure 中声明：可能访问 https://api.deepseek.com；可选读取环境变量 DEEPSEEK_API_KEY（file-0600）；支持 offlineMode。安装前请阅读源码与许可证，插件以当前 DSH 进程权限运行。
典型用法¶
- 在 DSH 中执行上述
plugin_manager安装 bundle，reload 页面。 - 在输入框下方找到用量胶囊；点击打开明细，查看四桶 token、参考费用
@单价、账户余额与时段轴。 - 需要更新余额时，在面板概览使用刷新控件；Esc、外部点击或关闭按钮收起面板（内部刷新不会误关）。
- 在插件设置中调整胶囊与明细显示项；可用「恢复默认」仅重置 UI 偏好。
未登录且未配置 DEEPSEEK_API_KEY 时，余额段会消失或说明原因，参考费用仍可在有 tokenUsage / usagePillCost 时显示。
适用场景与注意¶
适合：在本机 DSH 长会话开发、调试时，想同时看到 token 四桶、DeepSeek 价表参考人民币、峰谷状态与账户余额；已用 DeepSeek 账号登录、希望余额查询不经过自填 API Key 的用户。
注意：
- 显示费用带
≈与「参考费用」语义，第三方渠道或自定义模型仍按内置 DeepSeek 规则估算，不能代表渠道真实账单。 - 仅显示余额但余额不可用时，面板仍保留费用入口；网络错误不会误报为「未配置密钥」。
- 社区插件目录（如 SkillHub）与 DeepSeek / 幻方无官方从属关系；目录 slug 与 GitHub 仓库名可能不一致，以仓库 oliblue-evan/dsh-liao-usage 与 README 安装目标为准。
结尾¶
dsh-liao-usage 把会话用量、按笔计价参考费用、峰谷与余额收进输入框下方一枚胶囊，账号登录路径复用宿主余额接口，刻意控制体积与依赖。进一步了解可看社区目录页 oliblue-evan/dsh-usage-pill 与源码仓库 github.com/oliblue-evan/dsh-liao-usage。
