
940842546/dsh-usage-billing
30最近提交 2026年8月15日
dsh-usage-billing DSH 插件
本插件自动监听所有会话的 DeepSeek 模型调用,记录 tokens 并按官方定价分段计费,在主界面和设置页提供可视化面板。支持历史回填、北京时间分段计费、数据持久化,以及中英双语界面。
如何安装 dsh-usage-billing DSH 插件
dsh plugin --profile web add dsh-usage-billing复制不会执行命令。安装 dsh-usage-billing DSH 插件前请核对仓库和版本。
dsh-usage-billing DSH 插件数据来源
dsh-usage-billing DSH 插件快照日期:2026年8月16日
discovered
dsh-usage-billing DSH 插件能做什么
- 自动监听 `llm/stream`,记录每次模型调用的输入/输出/缓存命中/未命中 tokens。
- 首次启动自动扫描本机会话日志,重建历史用量与消费,并附会话标题。
- 按北京时间自动归入「8/17 前旧价 / 8/17 后高峰 / 8/17 后空闲」三段计费。
- 主界面左下角「用量」按钮 → 悬浮汇总面板(总费用、分段占比、用量热力图、会话 Top 5)。
- 输入框下方常驻一行当前会话的用量。
- 设置页 → 用量统计:完整明细(统计卡片、分段占比、日/周/月/年/累计热力图、按会话 Top 8、按模型、最近调用、回填/清空)。
- 提供动态工具 `usage_stats`,模型可直接查询统计(例如“现在用了多少钱?”)。
- 数据持久化到 `.dsh-usage-stats.json`,重启不丢失。
- 中英双语,所有界面文案跟随应用语言切换。
dsh-usage-billing DSH 插件适合哪些场景
- 实时监控 DeepSeek API 费用,按会话或时段查看开销。
- 分析用量模式,优化模型选择与预算分配。
- 追踪历史 token 消耗与费用,用于报告或审计。
- 识别消耗最多的会话或模型,进行针对性调整。
- 直接通过对话询问模型“花了多少钱?”,快速获取统计。
dsh-usage-billing DSH 插件适合谁
- 使用 DeepSeek Harness 的开发者与重度用户,需要管理 API 费用。
- 团队或个人大量使用 DeepSeek 模型,希望按会话或时段追踪计费。
dsh-usage-billing DSH 插件的限制
- 仅支持 DeepSeek 官方模型(v4-flash、v4-pro),定价表硬编码,不支持自定义模型或价格。
- 计费逻辑基于北京时间(CST),其他时区用户可能遇到边界差异。
- 统计文件为共享资源,多个实例同时运行会互相覆盖,请保持单实例。
- 需要 DeepSeek Harness 环境且配置了 DeepSeek 模型,无法独立使用。
- 插件仍在演进中(v0.2.0+),更新时可能涉及 schema 迁移。
dsh-usage-billing DSH 插件的仓库 README 摘录
以下文字摘自 dsh-usage-billing DSH 插件的上游仓库 940842546/dsh-usage-billing 的 README,版权归原作者,仅作引用。
中文 | [English](README.en.md) 针对 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 后空闲」三段 - **主界面**: - 左下角「用量」按钮 → 悬浮汇总面板(总费用、分段占比、用量热力图、会话 Top 5) - 输入框下方常驻一行**当前会话**的用量 - **设置页 → 用量统计**:完整明细(统计卡片、分段占比、日/周/月/年/累计热力图(悬停即时显示 token 与金额)、按会话 Top 8、按模型、最近调用、回填/清空) - **动态工具 `usage_stats`**:模型可直接查询统计(“现在用了多少钱?”) - **持久化**:数据写入写策略根目录 `.dsh-usage-stats.json`,重启不丢 - **中英双语**:所有界面文案跟随应用语言设置即时切换(中文 / English) ## 安装 ### 方式 A:npm 一键安装(推荐,预构建) ```powershell dsh plugin --profile web add dsh-usage-billing ``` npm 包:https://www.npmjs.com/package/dsh-usage-billing 应用启动时通过本包的 `dsh.bundle.patch`(`cordis.patch.yml`)自动挂载,无需任何其他配置。 > ⚠ 不要直接修改官方 bundle(如 `@deepseek-ai/dsh-web-app/cordis.patch.yml`), > 也不要把插件放进 `npm-cache\_npx` 缓存(npm reify 会随时重建并留下悬空链接)。 > 本地路径形式同样支持:`dsh plugin --profile web add <本仓库路径>`。 ### 方式 B:用户级补丁(不动 profile) 把本仓库根目录的 `cordis.patch.yml` 内容加入: ``` %USERPROFILE%\.dsh\cordis.patch.yml ```
阅读完整 README仓库许可: MIT
dsh-usage-billing DSH 插件常见问题
安装后用量面板不显示怎么办?
客户端 bundle 由部署的 `clientModules` 服务发现。安装后需要重启 DeepSeek Harness 应用并刷新页面。如果仍然不显示,请确认插件已通过 `dsh plugin --profile web add dsh-usage-billing` 正确安装,且 profile 处于激活状态。
升级后统计翻倍了怎么修复?
旧版本自动回填时未先清空导致。从 v0.2.0 起插件使用 `schemaVersion` 迁移标记,重启应用后会自动单次重建修正。如果问题依旧,手动删除统计文件 `.dsh-usage-stats.json` 再重启。
能否同时运行多个 DeepSeek Harness 实例?
不可以。统计文件是共享资源,多个实例同时运行会互相覆盖导致数据损坏。请保持单实例运行。
插件支持自定义价格或非 DeepSeek 模型吗?
不支持。定价表硬编码为 DeepSeek v4-flash 和 v4-pro 模型,不支持自定义模型或价格。如需自定义定价,需要修改插件源码。
如何切换界面语言?
插件自动跟随 DeepSeek Harness 的语言设置。更改应用语言为中文或英文,插件的所有界面(包括浮动面板和设置页)会即时切换。