dsh-usage-widget

dsh-usage-widget（用量与余额）

English | 中文

在 DeepSeek Harness 桌面端侧边栏左下角（Settings 上方）显示：

• 账号余额 —— 通过官方账号服务 ctx.deepseekAccount.getBalance 读取，与「设置 → 账号」同源；充值余额与赠送余额都显示在收起状态的第一行。
• 今日 token 消耗 —— 全部会话合计，含输入（缓存命中／未命中）与输出明细，并单独列出推理 token。
• 今日花费 —— 按模型单价与高峰／空闲时段换算，悬停或点击可展开当前会话明细。
• 本月累计 —— 本月至今的 tokens、花费、请求数、活跃天数与会话数。
• 当前时段 —— 「今日」那一行前有一个实时徽标（高峰时段 ×2 / 空闲时段），展开面板里还有一行「当前时段 / 距切换 1h 30m → 空闲时段」，一眼看出现在按哪档计价、还有多久切换。

收起状态下显示三行：余额、今日、本月。鼠标悬停或点击展开：余额、当前时段、今日明细、按模型分组、本月累计、当前会话（今日 + 本月）明细、更新时间与刷新按钮。

不展开也能看到关键数字：第一行 余额 ¥5.83 · 赠送 ¥9.56（充值余额为主色、赠送余额为弱化色），第二行以时段徽标开头，第三行本月。侧边栏收起成 56px 窄栏时缩为一个图标，完整数值都在悬停提示里。

数据来源

会话日志是多帧 Zstandard 容器（每批追加一帧）。插件按帧边界增量读取：只解压上次之后新增的帧，一个尚未写完的尾帧会被跳过并在下一轮补上，因此不会重复计数，也不会因为日志很大而变慢（本机 15 个会话文件、2 万行首轮扫描约 0.3 秒，之后每次只读增量）。

安装

从 GitHub Release 安装（推荐，不需要克隆仓库）：

dsh plugin --profile desktop add "https://github.com/ZeroOT-Liu/dsh-usage-widget/releases/latest/download/dsh-usage-widget.tgz"

或者直接从仓库安装：

dsh plugin --profile desktop add "github:ZeroOT-Liu/dsh-usage-widget"

两种方式都会把 dsh-usage-widget 写进 profile 的 dsh.profile.bundles（~/.dsh/profiles/<profile>/package.json），对该 profile 的全部会话生效并跨重启保留。

装好后刷新页面（Ctrl+R），让浏览器取到新的模块清单。

卸载：

dsh plugin --profile desktop remove dsh-usage-widget

本地开发

用 link: 指向工作目录，改完代码刷新页面即可生效，不需要重新安装：

dsh plugin --profile desktop add "link:/绝对路径/dsh-usage-widget"

配置

配置写在 cordis.patch.yml 的同名行里。价格单位是「元 / 百万 tokens」，填空闲时段价格，高峰时段按 peakMultiplier 倍计算（默认为 2，与官方价目表一致）。

高峰时段（北京时间，周一至周五 9:00–12:00、14:00–18:00）价格翻倍，其余时段（含周末）半价。中国法定节假日不在规则内，节假日按高峰计价。

未配置单价的模型仍会统计 token，但不计入花费，并在展开面板中标注 未配置单价，未计入花费。

安全

汇总路由 /api/dsh-usage-widget/summary 是精确路由，会优先于 API 网关的 /api 前缀匹配，因此不会继承网关的浏览器会话校验。为弥补这一点，路由自行执行与网关相同的信任判定：只接受回环 Host（127.x.x.x、localhost、::1 及 allowHosts 中的主机），拒绝跨站 Origin／sec-fetch-site，其余一律 403。请求方法限 GET／HEAD。

文件

插件是零依赖的：只使用 Node 内置模块与相对导入。profile 安装的插件无法解析 DSH 自带的 @deepseek-ai/* 包，因此宿主不 import 它们（也不导出 Cordis Config schema），客户端不 require 任何 Harness Client 包，样式只引用 --dsw-alias-* 主题 token。

测试

node test/run-tests.mjs      # 帧解码、计价、增量聚合（与真实日志全量解码交叉验证）
node test/client-smoke.mjs   # 在 Node 中按真实握手加载并渲染客户端部件
node test/host-smoke.mjs     # 宿主半边：服务依赖声明、路由的信任校验与响应

已知限制

• 花费是按价目表推算的参考值，不是账单；官方账单以平台用量页为准。价格变动需自行更新配置。
• 「今日」按宿主本机时区划分；跨时区使用请以本机日历日为准。
• 会话日志写入是分批落的，因此部件显示可能比实际对话落后一个批次（通常几秒），点「刷新」可立即重读。
• 本月累计依赖日志保留窗口（keepDays，默认 45 天，足够覆盖一个自然月）。若把它调到 32 以下，月初的数据可能已被清理，此时面板会标注「本月早期数据超出保留窗口，可能不完整」。

环境要求

• DeepSeek Harness 桌面版（desktop profile，验证于 0.2.0-rc.2）。装在 web profile 也可以，只要该 profile 组合了官方账号插件（@deepseek-ai/dsh-deepseek-account-platform）；没有它时部件仍显示用量，余额位置显示「账号服务不可用」。
• 部件还会读取该 profile 的会话服务（sessions、uiSession）来判定当前会话，标准组合都自带这两项。
• 会话日志为 Zstandard 多帧格式，需要宿主自带 Node ≥ 22.15（DSH 运行时为 Node 24，无需额外处理）。
• 未登录 DeepSeek 账号时余额显示「未登录」，用量与花费照常统计。

常见问题

安装时报 UNABLE_TO_VERIFY_LEAF_SIGNATURE / fetch failed —— 本机装了 TLS 拦截代理（企业网络、杀毒软件、抓包工具），而 Node 默认只用内置根证书。让 Node 改用系统证书库即可：

NODE_OPTIONS="--use-system-ca" dsh plugin --profile desktop add "https://github.com/ZeroOT-Liu/dsh-usage-widget/releases/latest/download/dsh-usage-widget.tgz"

余额位置显示「账号服务不可用」 —— 该 profile 没有组合官方账号插件；用量与花费照常工作。

花费与实际账单对不上 —— 价格是配置里的推算值，官方调价后需要更新 cordis.patch.yml 中的 models。

License

MIT