前言¶
用 DeepSeek Harness（DSH）做智能体或日常开发时，会话会分散在不同项目里。宿主本身能记录单次对话，但若要看「这个月各项目一共用了多少 Token、开发时间大致多长、按公开价目表估算要花多少钱」，往往得自己翻日志或靠会话级小挂件——后者通常只回答「这一轮花了多少」，很难做项目维度的汇总。
下面介绍社区维护的客户端插件 dsh-stats（界面品牌 DSH Usage，npm 包 @rongyi7/dsh-stats）。它读取 DSH 会话记录，在独立浮层里按项目、日期和模型整理用量，并支持查询已配置账户的余额与订阅额度；侧边栏底部增加「用量」入口，不占用会话输入区、不改动会话界面。
这是什么¶
dsh-stats 是 DeepSeek Harness 的用量统计插件，维护者为 rongyishuaige7，在 SkillHub 等社区目录中归类为客户端插件。仓库：https://github.com/rongyishuaige7/dsh-stats；目录页：https://www.skillhub.cn/plugins/rongyishuaige7/dsh-stats。
README 说明：与只挂在会话旁的用量插件可以叠加——它们回答单轮消耗，本插件回答「这个月在各项目上花了多少」。
核心功能¶
插件面板标题为「DSH 用量」，头部固定显示数据来源状态、刷新、导出、计价设置和关闭；共四个标签页。
项目总览¶
按项目展示 Token、开发时间与预估费用。表格支持任意列排序；展开项目可查看轮/步、工具时长、首 token、tok/s 和会话明细。右上角可搜索并隐藏项目，隐藏项不计入指标和趋势。项目每页 50 个、会话每页 100 条，翻页不改变顶部汇总。
开发时间线¶
按日视图将项目排成泳道，上方每根柱子表示半小时的费用或 Token；点色条或柱子可看该半小时明细，展开泳道可打开会话。「全部」模式为日历矩阵，每页 30 天，点格子进入当天。
用量趋势¶
范围可选近 7 / 30 / 90 天，指标可在费用与 Token 之间切换。上方摘要给出区间合计、日均和最常用模型；中间为每日柱图，下方为固定 26 周活动热力图，末尾按当前指标列出模型占比。点柱子或热力格可跳到对应日期的总览。
账户余额¶
一屏列出所有已接入账户，按紧急程度排序（额度或余额快用完、凭证失效、快照过期等优先）。多账户时顶部按币种合计可用余额。每个余额账户可设一条提醒线，仅保存在当前浏览器。账户查询由 DSH 宿主读取凭证并请求各 Provider 官方接口，凭证不进入前端 bundle 或导出文件。
计价设置¶
头部齿轮打开计价设置抽屉，含模型价格、自定义规则、更新与版本三个分区。自定义规则保存前可先「预览影响」。无法确认价格的部分会标出，不会硬猜；订阅和 Token Plan 用量不会折算成 API 费用。
安装与启用¶
插件装进 DSH 的 profile。桌面端与 Web 是两套 profile（desktop、web），装到其一不会同时装到另一个。插件要求 Node.js 22 或更高；桌面端自带运行时，无需另装 Node。npm 稳定版为 0.5.1（资料写明 2026-10-23 发布）。DSH 0.2.1 及以上可在「设置 → 插件市场」搜索 dsh-stats 一键安装；市场列表来自 awesome-dsh-plugin。
若市场索引尚未同步，可用命令行安装。命令中的 -w 是 pnpm 的 workspace 安装选项，不是路径。
桌面端（macOS 示例，其他系统改用应用目录内对应的 dsh CLI）：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin \
--profile desktop add -w @rongyi7/dsh-stats
装完后完整退出 DSH（macOS 用 Cmd+Q），再重新打开；侧边栏底部「用量」即为入口。用 npm 单独安装的 dsh 无法操作 desktop profile。
Web：
dsh plugin --profile web add -w @rongyi7/dsh-stats
然后重启 Web 宿主（dsh web）并刷新页面；只刷新浏览器不会重新加载宿主侧插件。
自定义 profile 时将 desktop / web 换成实际名称即可。固定版本、升级卸载等见仓库使用指南的安装部分。
典型用法¶
- 安装并完整重启对应 profile 的宿主后，从侧边栏底部打开「用量」。
- 在项目总览中排序、展开项目，必要时隐藏无关项目后再看汇总与趋势。
- 在开发时间线或用量趋势中按日/区间查看峰谷，需要明细时从柱子或热力格跳转到当天总览。
- 需要核对单价或补自定义规则时，打开头部计价设置；项目总览、时间线、趋势支持 CSV/JSON 导出当前选中日期或区间的项目数据（账户余额为实时快照，不提供导出）。
- 键盘：
Tab在面板内循环，Esc逐层关闭筛选与抽屉后关闭面板；表头与展开按钮可用Enter操作。
费用界面统一用人民币展示估算值；USD 按 README 记载的固定汇率快照换算。导出 JSON 保留原币与汇率字段便于审计。时间线、峰谷与计价规则生效时间均用北京时间（UTC+8）。
适用场景与注意¶
适合：长期在 DSH 上多项目开发、需要项目级 Token 与时间汇总、希望对照公开价目表做费用估算、并在同一面板查看多账户余额与提醒线的用户。
注意：
- 插件以当前 DSH 进程权限运行，安装前应查看仓库源码与 MIT 许可证，并确认 peer 范围与宿主版本匹配（
package.json声明dsh为>=0.1.0-rc.6 <0.3.0；README 建议0.5.1为已验证组合）。 - 费用均为估算，最终以 Provider 账单为准；主汇总不包含无法确认计价的会话（原因可在会话详情与导出字段
costStatus、ruleId、pricingSource中定位）。 - 当前会话的 projection cache 可能滞后数秒，面板约每 60 秒自动刷新。
- 社区目录（如 SkillHub）与 DeepSeek / 幻方无官方从属关系，DSH 生态理念是「一切皆插件」，本文介绍的是社区插件而非官方应用商店条目。
装完若侧边栏没有「用量」，先确认安装成功、profile 是否正确，再完整重启宿主；Web 端需重启 dsh web 而非仅硬刷新浏览器。
结尾¶
dsh-stats（DSH Usage）把 DSH 会话记录整理成项目级 Token、开发时间线与预估费用面板，并可选查账户余额；安装包 @rongyi7/dsh-stats，与 README 中的市场名 dsh-stats 为同一插件。
