DeepSeek Harness 采用插件化架构，允许通过插件扩展功能。dsh-meter 是一个专注于会话级别的成本监控与计费插件，它在每个会话右上角展示当前会话的 token 用量与费用，并提供价格配置功能，解决了在长时间对话或开发过程中难以量化成本的问题。
核心功能¶
会话头部入口
每个会话右上角有一个常驻的费用徽标，显示当前会话的费用及高峰/空闲状态。若会话使用的模型未配置价格，徽标会显示琥珀色的“未登记价格”标签。徽标旁会显示状态标签：当前处于高峰显示红色“高峰”，否则显示灰色“空闲”。判定按 provider 时区进行（默认北京时区）。
统计卡片
鼠标悬停或点击徽标可展开统计卡片。卡片展示了当前会话的详细用量：缓存命中与未命中的 token 数、缓存写入情况、输出 token 数。费用按币种并列显示。卡片还包含上下文占用条与压缩预测，以及每轮新增的迷你图（展示 token 占用变化）。卡片底部会列出派生的子代理及其费用，状态点（实心绿点、旋转环、中性点）复用官方 StateDot 组件，反映子代理的运行状态。
逐轮消耗详情面板
提供“按轮次”（工具调用 step 合并）和“按请求”两种视图。视图切换会改变图表与表格的粒度。费用柱状图与四段 token 堆叠图展示了每轮的消耗。明细表按轮次倒序排列，支持折叠。
设置与计价逻辑
通过 GUI 设置页（插件配置页）可编辑价格表。支持分段计价（按请求长度）和高峰时段感知（可配置多个高峰窗口及生效星期）。内置法定节假日日历，命中当天则不触发高峰价。计价核心支持按请求时刻归属时段、按请求长度取档、以及缓存未命中/命中/写入分开计价。
安装与启用¶
源码目录安装（推荐）
当前源码线（0.3.3x）尚未发布到 npm，建议使用源码目录方式安装：
npx @deepseek-ai/dsh plugin --profile web add ./dsh-meter
包安装
npm 上的 dsh-meter 停留在 0.3.18 版本。运行 0.2.x 及更新宿主时，安装前的 peer 校验会直接拒绝安装。仅在 0.1.7 线（0.1.7-rc.2 ~ 0.1.7.x）的宿主上，npm 上的 0.3.18 才能安装：
npx @deepseek-ai/dsh plugin --profile web add dsh-meter@0.3.18
安装完成后，重启 GUI 或 host 即可生效。
配置定价¶
通过配置文件定价
也可以使用配置文件维护价格表，Agent 可据此直接生成配置。默认路径为 $DSH_HOME/dsh-meter/prices.yaml（未设 DSH_HOME 则在 ~/.dsh/dsh-meter/prices.yaml）。
# 校验价格配置
node scripts/check-prices.mjs
# 或指定文件
node scripts/check-prices.mjs my-prices.yaml
单位为元/百万 tokens。优先级为：显式配置 > 价格文件 > 内置默认。
迁移与维护¶
插件是独立包，迁移到另一台机器时，只需将 dsh-meter/ 目录（不带 node_modules/）或 .tgz 文件拷贝过去，重新运行安装命令即可。
迁移后务必重新安装一次，以确保 profile 配置正确更新。价格以整数（1/100000 单位）存储，无浮点误差。
注意事项¶
- 版本兼容性：npm 上的
dsh-meter停留在 0.3.18，peer 区间为^0.1.0-rc.7。运行 0.2.x 及更新宿主时，peer 校验会拒绝安装。 - 许可证：未在资料中找到明确的许可证信息。
- 精度：价格存储为高精度整数，显示时保留两位小数。
