用量统计面板 noneghost/dsh-deepseek-usage

DeepSeek 用量统计 · DSH 插件

给 DSH（DeepSeek Harness）用户的内嵌用量面板：实时余额 + 历史 Token 统计 + 峰谷消费估算 + 使用时段建议，中英文一键切换。

License: MIT
Platform: DSH
Lang: 中文 / English

✨ 它是什么？

把这个插件装进 DSH 后，会在你的会话里出现一个复刻官方 DeepSeek usage 页面的统计面板：

- 💰 余额：调用官方 GET /user/balance 实时显示总余额（复用 Harness 已配置的 DEEPSEEK_API_KEY，无需手动输入）。
- 📊 Token 用量：按天堆叠柱状图（输入 / 缓存读 / 输出），一眼看清每天用在哪。
- 🗓 多时间范围：今天 / 本周 / 过去一周 / 本月 / 过去30天 / 全部，所有统计随选择切换。
- 🧮 按模型：每个范围下各模型（输入 / 缓存读 / 缓存写 / 输出 / 调用）。
- 🗂 按工作区：按会话所在工作区目录分组，覆盖 Harness 全部历史工作区（含插件安装前的记录）。
- 💸 消费估算：按官方 2026-08-17 峰谷价估算（高峰时段北京 9-12 / 14-18，空闲时段半价），区分高峰/空闲消费。
- ⏱ 时段分析：高峰/空闲占比 + 24 小时用量分布（随范围变化）。
- 💡 省钱建议：直接算出"把高峰用量挪到空闲时段能省多少钱"，并给出最佳批量窗口（22:00-08:00）。
- 🌐 中英文：面板右上角 EN / 中文 一键切换。

🚀 安装

方式一：动态插件（推荐 · 无需改配置）

1. 打开一个 DSH 会话（agent 预设为 cordis）。
2. 调用 cordis_define，把 plugin/host.js 内容粘贴为 code.host，plugin/client.js 内容粘贴为 code.client。
3. 调用 cordis_run 激活（首次需在浏览器点"允许"）。
4. 完成！去使用吧 👇

方式二：标准 npm 包（组合配置）

本仓库同时提供标准 DSH 插件包（lib/index.js Host + lib/client.js Client），可直接从 GitHub 安装：

1) 安装为依赖（GitHub 直装）
npm install github:noneghost/dsh-deepseek-usage

2) 在 harness profile 的 cordis.patch.yml 中加一行组合配置：
- id: dsh-deepseek-usage
name: dsh-deepseek-usage

重启后：会话头部右侧出现 "用量" 按钮 → 右侧详情面板；或 设置 → DeepSeek 用量。

不需要安装任何依赖，插件只使用 Harness 内置服务。

🖱 怎么用

- 打开面板：任意会话头部右侧的 "用量" 按钮 → 右侧详情面板；或 设置 → DeepSeek 用量。
- 切换时间范围：面板顶部"统计范围"下拉。
- 切换语言：面板右上角 EN / 中文。
- 实时角标：输入框下方显示"今日 tokens · 调用次数"。

📸 截图

截图待补充 —— 欢迎提交 PR 添加（screenshots/ 目录）。

❓ 常见问题

Q：余额显示不出来？
余额需要可用的 DEEPSEEK_API_KEY。插件优先使用 Harness 已配置的凭据（面板会显示来源），也可在面板手动粘贴 Key（仅内存，不落盘）。

Q：第一次打开为什么有点慢？
首次会扫描 Harness 的持久化会话日志（可能包含很多历史会话），完成后会缓存；之后切换范围都是即时的。

Q："按工作区"是怎么划分的？
按每个会话创建时的工作目录（cwd）。使用过的工作区都会出现；没有记录的工作区显示 0。

Q：消费数字是官方真实账单吗？
是估算：用量来自 Harness 实际调用记录 × 官方峰谷价表。官方账单请以平台为准。价格表在 plugin/host.js 的 PRICES 里，官方调价后可自行修改。

Q：数据会保存到磁盘吗？
API Key 只保存在内存。统计读取的是 Harness 已有的会话日志，插件本身不写盘。

📊 官方价格表（2026-08-17 起，元/百万 Token）

| 模型 | 时段 | 缓存命中 | 缓存未命中(输入) | 输出 |
| V4 Flash | 高峰 | 0.10 | 3 | 9 |
| V4 Flash | 空闲 | 0.05 | 1.5 | 4.5 |
| V4 Pro | 高峰 | 0.30 | 9 | 27 |
| V4 Pro | 空闲 | 0.15 | 4.5 | 13.5 |

高峰时段 = 北京时间 09:00-12:00、14:00-18:00；其余为空闲时段（半价）。

📄 许可

MIT © noneghost