dsh-usage-billing · DeepSeek 用量与消费统计插件

针对 DeepSeek Harness 的免构建双面插件：自动统计本机所有会话的 DeepSeek 模型调用，按官方定价分段计费，并在主界面与设置页提供图表化的用量面板。

计费口径：2026-08-17 00:00（北京时间）前旧价；之后峰谷定价（高峰 9:00–12:00、14:00–18:00，其余空闲时段）。价格表见文末。

功能

• 全自动统计：监听 llm/stream，所有会话的每次模型调用都会被记录（输入/输出/缓存命中/未命中 tokens）
• 历史回填：首次启动自动扫描本机会话日志，重建历史用量与消费，并附会话标题
• 分段计费：按北京时间自动归入「8/17 前旧价 / 8/17 后高峰 / 8/17 后空闲」三段
• 主界面：
  • 左下角「用量」按钮 → 悬浮汇总面板（总费用、分段占比、近 14 天费用柱状图、会话 Top 5）
  • 输入框下方常驻一行当前会话的用量
• 设置页 → 用量统计：完整明细（统计卡片、分段占比、14 天柱状图、按会话 Top 8、按模型、最近调用、回填/清空）
• 动态工具 usage_stats：模型可直接查询统计（“现在用了多少钱？”）
• 持久化：数据写入写策略根目录 .dsh-usage-stats.json，重启不丢

安装

方式 A：官方 profile 插件机制（推荐）

# 安装并登记到 profile 的 bundles（内部走 pnpm 管理 profile 依赖）
dsh plugin --profile web add 

应用启动时通过本包的 dsh.bundle.patch（cordis.patch.yml）自动挂载，无需任何其他配置。

⚠ 不要直接修改官方 bundle（如 @deepseek-ai/dsh-web-app/cordis.patch.yml）， 也不要把插件放进 npm-cache\_npx 缓存（npm reify 会随时重建并留下悬空链接）。

方式 B：用户级补丁（不动 profile）

把本仓库根目录的 cordis.patch.yml 内容加入：

%USERPROFILE%\.dsh\cordis.patch.yml

- insert:
    - id: usage-stats
      name: 'dsh-usage-billing'

内置进打包部署（开箱即用）的完整方案见 PUBLISH.md。

数据与口径

数据	位置 / 说明
统计文件	写策略根目录下 .dsh-usage-stats.json（通常为用户主目录）
计费时段	北京时间；调价边界 2026-08-17 00:00
计费单位	元 / 百万 tokens

价格表（元 / 百万 tokens）：

时段	模型	命中	未命中	输出
8/17 前	v4-flash	0.02	1	2
8/17 前	v4-pro