前言¶
在 DSH web 客户端中使用 DeepSeek 时，当前会话花了多少钱、现在跑的是哪一档资费、距离下一档资费还有多久，这些状态不一定会自动显示在交互区里。
@dshworks/dsh-meter 是一个 dsh web 客户端插件，用来在 composer 下方增加一行计费信息，并在 hover 或 focus 时展开更多详情，包括会话成本、资费状态、缓存和余额相关数据。
插件定位¶
- 包名：
@dshworks/dsh-meter - 维护者：
dshworks - 许可证：MIT
- 运行位置：作为 dsh web 客户端插件运行
- 核心用途：在会话界面显示 DeepSeek 计费状态，包括会话成本、当前资费、资费切换时间、账户余额和相关费率信息
核心功能¶
composer 下方的一行¶
插件会在 composer 下方添加一行信息，显示：
- 当前会话成本
- 当前资费
- 距离资费翻转的时间
这一行用于快速查看当前会话的计费状态，不需要额外打开面板。
Hover 或 focus 后打开卡片¶
当 hover 或 focus 到 composer 下方的 meter 行时，会打开一个卡片。卡片中显示：
- 会话总额
- 请求数
- 模型
- 24 小时资费条
- 缓存命中、新鲜输入、输出的 token 数与金额
- 账户余额及赠送信用
- 其他资费下的相同 token 价格
- 缓存节省
这部分更适合查看一次会话的构成：哪些 token 命中了缓存，哪些是新鲜输入，输出是多少，以及如果换成其他资费会是什么价格。
Settings → Meter 用于冷启动查看¶
如果还没有会话，或者会话还没有产生计费请求，composer 下方的 meter 行可能不会出现。
已核实资料说明：
- meter 需要会话且已有计费请求后出现
Settings → Meter用于冷启动查看
打开 Settings → Meter 后，可以查看：
- 当前资费
- 倒计时
- 七天资费网格
- 公开费率卡
- 账户余额
两套费率卡，不做汇率换算¶
DeepSeek 发布 USD 和 CNY 两套独立费率卡，账户按其中一个计费。
插件会读取账户币种，并按 DeepSeek 的 USD/CNY 两套独立费率卡显示 funded 行，不做汇率换算。
安装与启用¶
1、确认 pnpm 位于 PATH。dsh plugin 会转发到 pnpm，因此 pnpm 必须可用。
2、添加插件：
dsh plugin --profile web add @dshworks/dsh-meter
3、启动 web profile：
dsh --profile web
4、进入会话。meter 需要会话且已有计费请求后出现；如果需要冷启动查看资费、费率卡和余额，可以打开 Settings → Meter。
典型用法¶
1、安装并启动：
dsh plugin --profile web add @dshworks/dsh-meter
dsh --profile web
2、冷启动查看资费信息：
打开 Settings → Meter，查看当前资费、倒计时、七天资费网格、公开费率卡和账户余额。
3、查看会话详情：
Hover 或 focus 会话下方的 meter 行，打开卡片查看资费、缓存和余额详情。
已核实资料中的示例行如下：
2 turns · 2 steps | LLM 3.1s | TTFT avg 1.3s · 41 tok/s | Cache hit 50% | Input 44.3K tok ¥0.0672 | peak | off-peak in 48m
适用场景与注意¶
适合以下场景：
- 使用 dsh web 客户端调用 DeepSeek
- 希望在 composer 下方直接看到当前会话成本
- 需要查看当前资费、资费切换时间、七天资费网格和公开费率卡
- 需要查看缓存命中、新鲜输入、输出、账户余额及赠送信用
- 需要按账户币种查看 USD 或 CNY 的独立费率卡，而不希望插件做汇率换算
使用前注意：
- 插件以当前 dsh 进程权限运行，安装前应检查源码和 MIT 许可证。
- 插件需要 pnpm 位于 PATH。
- meter 行需要会话且已有计费请求后出现；
Settings → Meter用于冷启动查看。 - 已核实资料只说明两个配置项位于插件自身配置中，未给出具体配置项名称。
- 余额通过 host 路由读取；已核实资料提到
/dsh-meter/balance返回currency信息，但凭据与权限细节未完全确认。 - 已核实资料未给出完整 dsh 兼容版本范围，不能据此判断具体版本要求。
链接¶
- GitHub：https://github.com/dshworks/dsh-meter
