前言¶
用 DeepSeek Harness（DSH）跑智能体时，模型调用会不断发生，但 Web UI 默认并不汇总 token 消耗和费用。想核对某次对话花了多少、高峰时段是否更贵、账户余额还剩多少，往往要翻日志或自己记账。
下面介绍社区插件 dsh-usage-plugin（GitHub：feiyang-dev/dsh-usage-plugin）。它在 DSH Web 界面里挂上「用量与消耗」和「剩余余额查询」面板，自动记录每次模型调用的 token 与缓存命中，按 DeepSeek 峰谷价计费，并支持导出与本地持久化。
这是什么¶
dsh-usage-plugin 是 DeepSeek Harness 生态中的用量与消耗统计插件，由 feiyang-dev 维护，在 SkillHub 目录中归类为客户端插件。npm 包名为 @feiyang666/dsh-usage-plugin，采用 MIT 许可证，要求 Node.js >= 18。
插件以 Host + Client 双面一体 的 npm 包形式发布：Node 侧 Cordis 插件负责记录、计费、余额查询与导出；浏览器侧面板通过 /usage/api 与 host 通信。安装后，Web UI 顶部「对话」「轨迹」之后会出现 「用量与消耗」 与 「剩余余额查询」 两个 tab。
核心功能¶
用量与消耗¶
每次模型调用会记录 token 用量与缓存命中情况，包括输入未命中、缓存命中、缓存写入、输出、推理和结束原因。费用按 DeepSeek 官方峰谷/基础价格计算：
- 工作日高峰：北京时间 9:00–12:00、14:00–18:00
- 自 2026-08-23 起，周末全天按空闲价计费
模型名取自实际请求参数；非 DeepSeek 模型如实显示，无官方价格的模型消耗按 0 统计。
概览页提供「按模型」汇总表和「按 API 服务商 × 模型」明细表，底部有总费用合计。支持日期筛选：今天、近 7 天、近 30 天、全部，以及自定义起止区间。
用量日历与缓存命中列表¶
用量日历按月展示每日用量热力图，可按消耗或调用数着色；悬停查看高峰/空闲消耗拆分，点击某天可查看当日调用明细。
缓存命中列表按时间倒序排列，支持快捷筛选与自定义日期区间，汇总行区分高峰消耗、空闲消耗和总费用。列表分页渲染，每页 100 条。
价格表¶
面板内置 DeepSeek 官方 API 价格表，覆盖 deepseek-v4-flash、deepseek-v4-flash-vision-exp、deepseek-v4-pro。高峰价与空闲价分列展示，可在面板内编辑并持久化到 pricing.json，也可一键恢复默认。
余额查询¶
使用当前配置的 DEEPSEEK_API_KEY 查询 DeepSeek 账户余额。需在 设置 → 模型 中配置与对话相同的 API Key。
导出与导入¶
支持将记录导出为 CSV、JSON 或 PNG 长图（按最新在前，最多 2000 条，超出会提示；PNG 含高峰/空闲消耗分列）。可通过原生目录选择器指定导出位置，导出后自动打开所在目录。
支持选择 JSON 或 CSV 文件合并导入，按时间去重。
持久化与跨平台¶
自 v1.9.2 起，记录存放在固定专用数据目录，不随工作区切换而丢失。默认路径因平台而异，例如 Windows 为 %LOCALAPPDATA%\dsh-usage-plugin\dsh-usage\usage-records.json。也可通过环境变量 DSH_USAGE_DATA_DIR 指定。记录上限 100000 条。
插件支持 Windows、macOS、Linux，路径处理使用 node:path，目录选择与「打开所在目录」调用各系统原生方式。
安装与启用¶
DSH 生态遵循「一切皆插件」的思路；SkillHub（https://www.skillhub.cn）是独立的社区插件目录，与 DeepSeek / 幻方无官方从属关系。
方式一：桌面端一键安装（推荐）¶
安装 DeepSeek Harness 桌面版，打开后进入 「安装插件」→ 推荐插件 → 用量与消耗插件 → 一键安装，完成后点 「立即重启服务」。
方式二：命令行安装¶
前提：已安装 DSH 和 pnpm。
npm install -g @deepseek-ai/dsh
npm install -g pnpm
执行安装命令：
dsh plugin --profile web add @feiyang666/dsh-usage-plugin
也可安装到其他 profile，例如 headless：
dsh plugin --profile headless add @feiyang666/dsh-usage-plugin
装完后重启 dsh web 服务。该命令会通过 pnpm 将包安装到 ~/.dsh/profiles/web，并根据包内的 cordis.patch.yml 自动接线，无需手动编辑配置文件。
注意：2026-08-16 起 npm 包名由
@feiyang666/deepseekharnessdesktop更名为@feiyang666/dsh-usage-plugin。旧包名不再维护，安装与升级请使用新包名。
典型用法¶
经过上面的安装步骤并重启服务后，刷新 http://127.0.0.1:3080 ，确认顶部出现「用量与消耗」和「剩余余额查询」tab。
- 发一条对话消息，打开「用量与消耗」面板，查看本次调用的 token 与费用记录。
- 在概览页切换日期范围，对比不同时间段的消耗。
- 切换到「用量日历」子页签，点击某天查看明细。
- 在「剩余余额查询」tab 点「查询余额」，确认账户余额（需先配置
DEEPSEEK_API_KEY）。 - 在导出区域选择格式（CSV / JSON / PNG），指定目录后导出记录。
「用量与消耗」面板内含 概览 / 用量日历 / 缓存命中列表 / 价格表 四个子页签。
卸载命令：
dsh plugin --profile web remove @feiyang666/dsh-usage-plugin
适用场景与注意¶
适合谁：
- 长期在 DSH 上跑智能体，需要追踪 token 消耗和费用
- 使用 DeepSeek API 峰谷计费，想区分高峰与空闲时段成本
- 需要导出用量记录做归档或外部分析
注意事项：
- 插件以当前 dsh 进程的权限运行，会读写本地数据目录并调用 DeepSeek API 查询余额。安装前应查看 GitHub 源码 与 MIT 许可证，确认符合你的安全要求。
- 余额查询依赖网络访问
api.deepseek.com；国内网络可能需要配置代理。 - 无官方价格的模型消耗统计为 0，非 DeepSeek 模型的费用仅供参考，不代表实际账单。
链接¶
- SkillHub 目录页：https://www.skillhub.cn/plugins/feiyang-dev/dsh-usage-plugin
- GitHub 仓库：https://github.com/feiyang-dev/dsh-usage-plugin
- npm 包：https://www.npmjs.com/package/@feiyang666/dsh-usage-plugin
dsh-usage-plugin 把每次模型调用的 token、缓存命中和峰谷费用收进一个面板，配合导出与余额查询，适合需要长期盯用量、控成本的 DSH 用户。
