前言¶

在 DeepSeek Harness（DSH）里跑长会话时，宿主自带的统计胶囊通常只报 token，不报按官方价表换算的人民币、也不报账户里还剩多少钱。社区里有不少用量与余额类插件，但不少要求自行配置 DEEPSEEK_API_KEY 才能查真实余额，或依赖自建账本与轮询，体积和兼容范围也各不相同。下面介绍维护者 oliblue-evan 发布的 dsh-liao-usage（分类：admin-security）：在输入框下方增加一枚胶囊，汇总本会话用量、按峰谷与模型档位估算的参考费用，以及账户余额；已登录 DeepSeek 账号时查余额可走宿主账号授权，无需把 API Key 交给插件。

这是什么¶

dsh-liao-usage 是 DSH 的单文件客户端 bundle 插件，宿主半边无额外运行时依赖。它在对话输入框下方渲染一枚徽标（胶囊），点开可查看四桶 token 明细、计价口径、峰谷倒计时与今日时段轴。费用按 DeepSeek 价表、每笔事件发生的时刻与当时模型档位累加（峰谷/档位）；费用为参考估算，账户余额为接口返回值。源码与说明见 GitHub，社区目录页为 SkillHub。package.json 当前版本为 1.2.1，许可证 MIT；README 写明仓库含 71 项断言（npm test）。

核心功能¶

底部胶囊与明细面板¶

胶囊示例形态（README 中的示意，数值为示例）：

🧮 108.0k tok · ¥0.05 · 余 ¥123.45

实际界面中，前置图标表示峰谷（太阳为高峰、月亮为空闲），中间为当前参考花费，末尾为余额（尚未取到余额时该段可隐藏）。token 总量主要出现在展开面板中，避免与宿主已有统计胶囊重复。

面板沿用宿主会话统计弹层的版式，大致包括：账户余额（含赠送钱包说明）与手动刷新；「缓存已省」；本会话花费按四桶（缓存命中 / 未命中 / 写入 / 输出）列出「金额 @ 单价」；时段说明（当前档位、模型、切换倒计时）与今日时段轴。会话中途换过模型时，可按模型拆分金额块；仅单一模型时不重复展示。

用量与计价数据来源¶

• Token 用量：读取 DSH 自带的 tokenUsage 投影，随宿主数据更新，插件侧不做定时轮询用量。
• 参考费用：优先使用宿主注册的 usagePillCost 会话投影，按每条 assistant/message / assistant/attempt 折叠，模型取自前一条 request/header，时刻取事件自身 time，与官方 token 折叠口径一致；宿主投影不可用时降级为「按当前价估算」，面板会标明口径，避免把估算当成账单。
• 峰谷与档位：高峰为北京时间周一至周五 09:00–12:00、14:00–18:00（左闭右开），高峰单价 ×2；周末与中国法定节假日按空闲计价。模型名含 flash 走 flash 价，其余走 pro 价。价目与生效时刻在 README 中与同类实现 dsh-token-billing 对齐说明，官方调价时需改宿主侧价表源码（client.js 顶部 / lib/pricing.js）。

余额：账号优先，API Key 兜底¶

已登录 DeepSeek 账号时，插件通过宿主 ctx.remote.account.getBalance 复用与「设置 → 账号」相同的授权链路，授权 token 留在宿主进程，浏览器侧主要看到余额数字。

未登录且账号返回 null 时，回落到宿主解析 DEEPSEEK_API_KEY 并请求官方余额接口（60 秒缓存、密钥不下发浏览器、错误按 sk- 脱敏）。面板会标注来源为「账号」或「API Key」。

设置与体验（1.2.x）¶

README 记载：设置分为「底部胶囊」与「展开明细」两组卡片，带即时示例（标注为示例、不查账号）；支持一键恢复默认显示设置；折叠帮助说明参考费用、真实余额与缓存节省。弹层支持首帧定位、Esc/外部点击关闭、余额请求去重与 60 秒缓存、手动刷新绕过缓存等行为修复与测试覆盖。

安装与启用¶

安装命令以 README 原文为准：

plugin_manager(action: "install_bundle", target: "github:oliblue-evan/dsh-liao-usage")

执行后重新加载页面即可。插件通过 cordis.patch.yml 向组合层插入 usage-pill 槽位；peerDependencies 要求 @deepseek-ai/dsh-api-remotes 与 @deepseek-ai/dsh-client-ui-conversation 在 >=0.2.1-rc.2 <0.3.0-0 范围内，请与本机 DSH 版本一并核对。

disclosure 中声明：可能访问 https://api.deepseek.com；可选读取环境变量 DEEPSEEK_API_KEY（credentials:read:DEEPSEEK_API_KEY）；支持离线模式字段为 true，网络与权限以 package.json 为准。

典型用法¶

1. 按上文命令安装 bundle 并刷新 DSH Web 界面。
2. 在对话页输入框下方找到用量胶囊；点击展开查看本会话四桶用量、参考费用与余额来源说明。
3. 需要更新余额时，在面板概览区使用刷新控件（手动刷新可绕过 60 秒缓存）。
4. 在插件设置中调整胶囊与明细显示项；不确定口径时查看折叠帮助或面板底部对「实际发生额 / 按当前价估算」的标注。

无需额外配置文件即可使用；仅 API Key 路径用户需已在宿主中配置 DEEPSEEK_API_KEY。

适用场景与注意¶

适合：希望在同一界面看到会话 token、按 DeepSeek 官方价表与峰谷规则估算的参考人民币费用，以及（尽量）免配置 Key 的账户余额的 DSH 用户；需要峰谷倒计时与今日时段轴、按模型拆分花费时也可使用本插件。

注意：

• 参考费用不等于第三方渠道或自定义模型的真实账单；余额以接口返回为准。
• 本插件不做同类大插件中的历史账本、今日全量扫盘、CSV 导出等能力，有意保持小体积（README 称约 30 KB 量级）与零用量轮询。
• 插件以当前 DSH 进程权限运行，安装前请自行审阅 源码 与 MIT 许可证；disclosure 已列出网络与凭据读取范围。
• DeepSeek 上下文缓存不产生「缓存写入」计费桶时，对应行会因数据为 0 而隐藏，属按数据判定而非写死隐藏。

结尾¶

dsh-liao-usage 把会话 tokenUsage、逐笔时刻计价的 usagePillCost 与账号/API Key 双路径余额收进输入框下方一枚胶囊，适合在 admin-security 类能力里做用量与余额的可视化核对。目录页：https://www.skillhub.cn/plugins/oliblue-evan/dsh-liao-usage；仓库：https://github.com/oliblue-evan/dsh-liao-usage。