DeepSeek 用量统计 · DSH 插件

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

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