DeepSeek Harness (DSH) 插件系统允许用户扩展功能。dsh-usage 插件在 DSH 设置面板中增加了一个「用量」区块，用于监控 token 消耗和 API 额度。它由用户 linanbuan 维护，基于 MIT 协议开源。
核心功能¶
该面板主要解决智能体开发与使用中的成本监控问题，提供以下能力：
- 用量明细：展示当日与累计的 token 用量、缓存命中，以及输入/输出/缓存写入/计费次数的详细分解。
- 历史日历：提供月历视图，每天通过两根按比例的长度条展示总用量与缓存命中。点选某天可查看精确数字，支持翻月查看。
- API 额度监控：支持已接入的 API 额度查询，包括已用比例与刷新时间。
- 性能与缓存：本地折叠显示用量（60 毫秒级），提供方额度并发获取（90 秒新鲜度）。
- 隐私与健壮性：API 密钥仅保留在 Host 侧，浏览器只接收响应体。网络读取设置 20 秒超时，若超时或失败会重试一次；若两轮都失败，保留上一轮的好数字并标注原因。
安装与启用¶
- 前置条件：需先安装 DeepSeek Harness 桌面端。
- 安装插件：将本目录放到任意位置，执行以下命令安装到指定 profile：
dsh plugin --profile <你的 profile> add <本目录的绝对路径>
- 生效：安装后 Host 模块需要重启 Harness 才能生效，浏览器端通常由 HMR 立即更新。
- 禁用：如需禁用，在 profile 自己的
cordis.patch.yml中覆盖配置：
- id: usage-panel
disabled: true
显示细节¶
- 数值格式：用量数字以完整整数显示，不做
K/M等缩写。 - CommandCode：仅显示百分比，不显示金额。
- OpenCode-Go：显示窗口百分比与刷新时间。
自检¶
运行以下命令可进行插件自检，确保路由、断言及配置均正常：
pnpm test
# 或
node test/selfcheck.mjs
