前言¶

在 DeepSeek Harness（DSH）里跑长会话时，输入框下方那条统计条会常驻轮次、步数、吞吐和 token 总量，但不会直接告诉你：这次对话在 DeepSeek 官方渠道上大概花了多少钱，账号里还剩多少额度。若你同时配置了官方 API Key（deepseek-official）或官方账号渠道（deepseek-account），又需要按高峰/空闲档理解计费，单靠统计条里的 token 数还要自己对价目表心算。

下面介绍社区插件 dsh-deepseek-usage-meter（维护者 AyahaShirane，MIT）。它在同一条统计条里、紧跟 token 用量之后增加一枚指示器，显示本次会话在官方渠道上的估算开销与DeepSeek 官方账号剩余额度，并可在点击后展开按模型、按计费项拆分的明细。

这是什么¶

dsh-deepseek-usage-meter 是 DSH 的客户端类插件：Host 侧注册会话投影 deepseekCost，浏览器侧读取投影并按 DeepSeek 官方价目表折算金额，同时可选调用 ctx.remote.account.getBalance() 拉取平台侧余额。只处理 DeepSeek 官方路由；未配置官方 provider 时插件不注册、不渲染，避免在其它 provider 上出现无意义的 ¥0 指示器。

社区目录页：https://www.skillhub.cn/plugins/AyahaShirane/dsh-deepseek-usage-meter
源码与说明：https://github.com/AyahaShirane/dsh-deepseek-usage-meter

界面上会看到什么¶

指示器挂在 conversation.composer.dock 槽位，与 token 统计条（id: "stats"）同一行，样式沿用 DSH 设计 token，浅色/深色主题与统计条一致。

常驻一行大致形如：

● ≈¥2.2103 · 余额 ¥11.23

行首圆点表示当前计费时段：绿灯为空闲时段，红灯为高峰时段（悬停有说明，每分钟重算）。点击可展开面板，内容包括：各模型下未缓存输入、缓存读取、缓存写入、输出各花了多少钱（token 数在悬停提示里）、该模型缓存命中率、本次开销在高峰/空闲两档上的拆分，以及充值余额与赠送余额。面板刻意不重复统计条已显示的会话总 token 与会话级缓存命中率。

数据从哪来、怎么计价¶

金额按 DeepSeek 官方价目表计算（USD 与 CNY 两套官方价，不做汇率换算），货币优先跟随账户钱包。价目依据见官方文档：https://api-docs.deepseek.com/zh-cn/quick_start/pricing。README 中列出的 CNY 示例（每百万 tokens）包括 deepseek-flash 与 deepseek-v4-pro 在空闲/高峰下缓存命中、缓存未命中与输出的单价；缓存写入按缓存未命中价计入。

Host 侧实现要点：同一 (turn, step) 重放时替换而非累加；llm/retry-started 之后的再次尝试才再次计入；按 (provider, model, 高峰|空闲) 分桶，历史用量不会因当前时刻被重新定价。金额在浏览器侧 lib/client.js 计算，Host 只提供可核对的事实字段。

激活条件¶

两层判定，且监听 llm/adapters-updated 动态挂上或摘下投影：

1. Host：ctx.llm.listProviders() 中出现 deepseek-official 或 deepseek-account 才注册 deepseekCost。
2. 浏览器：无投影则不渲染、不查余额；若本会话有调用但全部走非官方路由，同样不显示；官方与非官方混用时会照常显示。

安装与启用¶

README 中的安装方式面向已把插件以 link: 形式放进 desktop profile 的开发/集成场景，而非通用的 dsh plugin add github:… 一行命令。资料原文示例：

"dependencies": { "dsh-deepseek-usage-meter": "link:<此目录>" },
"dsh": { "profile": { "bundles": [ ..., "dsh-deepseek-usage-meter" ] } }

改代码后让客户端重新加载 bundle（在 Plugins 页关闭再开启该插件）即可生效；重新安装同名包需要重启应用。

卸载：在 Plugins 页停用并移除，或在 $DSH_HOME/profiles/desktop 执行 pnpm remove dsh-deepseek-usage-meter，并从 dsh.profile.bundles 中删除该 bundle 名。

插件以当前 DSH 进程权限运行；安装前应自行查看仓库源码与 MIT 许可证，确认符合你的环境策略。社区目录站点与 DeepSeek、幻方无官方从属关系。

典型用法¶

1. 在 DSH 中配置并启用 DeepSeek 官方渠道（deepseek-official 或 deepseek-account），开启插件 bundle。
2. 正常对话；在输入栏下方统计条右侧查看 ≈¥… 与会话开销相关的余额片段。
3. 需要核对「钱从哪来」时，点击指示器查看按模型与计费项拆分的明细及高峰/空闲金额拆分。
4. 若已登录官方账号且 Remote 可用，余额会与平台侧充值/赠送分列展示；余额查询失败时仅影响余额一半，开销估算仍显示。

维护者在仓库提供 Host 折叠语义、计价格式化与组件渲染的自测脚本（test/test-host.mjs、test/test-client.cjs、test/test-render.cjs），需 DSH 自带 Electron 或 Node 环境，详见 README「自测」一节。

适用场景与已知限制¶

适合：主要走 DeepSeek 官方 API Key 或官方账号渠道、希望在同一界面看到会话级估算成本与账号余额的 DSH 用户。

注意：

• 价目表为 内置常量（lib/client.js 的 PRICES），官方调价后需手动更新插件。
• 节假日表目前只覆盖 2026 年（lib/index.js 的 CN_HOLIDAY_RANGES_2026）；未列入的法定假日会按高峰计价，可能略微高估。
• 金额为按官方价目表的估算，平台账单为准；只统计当前会话，无跨会话或按天累计。
• 当前 package 版本为 1.0.1（以仓库 package.json 为准）。

结尾¶

dsh-deepseek-usage-meter 把 DeepSeek 官方渠道的 token 用量、高峰/空闲档与官方价目表接到输入栏统计条上，在不大改 DSH 的前提下补全会话开销与余额这一层信息。需要细节时以 GitHub README 为准：

• 目录页：https://www.skillhub.cn/plugins/AyahaShirane/dsh-deepseek-usage-meter
• 仓库：https://github.com/AyahaShirane/dsh-deepseek-usage-meter