dsh-usage-balance-plugin

DeepSeek Harness 的今日用量 & 余额悬浮窗插件：

• 💰 实时余额（DeepSeek 官方接口，每 60 秒自动刷新）
• 📊 今日用量：消费金额 / API 请求次数 / Tokens（统计自 DSH 本地会话日志，精确）
• 🏷️ 消费金额按官方中文定价页的实时人民币单价估算（缓存 1 小时，调价自动同步；页面抓取失败时回退内置价格）
• 🪟 可拖动悬浮窗（限制在视口内）、可关闭、侧边栏 ¥ 按钮开关、手动刷新

安装

前置：已安装 DeepSeek Harness（DSH）。

# 1. 找到 DSH 的依赖目录（Windows 示例；通用方法见下方"如何找到 DSH 目录"）
cd "C:\Users\你的用户名\AppData\Roaming\npm\node_modules\@deepseek-ai\dsh"

# 2. 安装本插件（装进 DSH 的 node_modules）
npm install dsh-usage-balance-plugin

# 3. 在 DSH 配置的补丁文件里注册插件行。
#    文件路径：<DSH 配置目录>\profiles\<profile>\cordis.patch.yml
#    例如 C:\Users\你的用户名\.dsh\profiles\web\cordis.patch.yml：
- insert:
    - id: dsh-usage-balance-plugin
      name: dsh-usage-balance-plugin

# 4. 重启 DSH → 右下角出现悬浮窗

如何找到 DSH 目录

npm root -g
# 输出全局 node_modules 路径（如 C:\Users\<你>\AppData\Roaming\npm\node_modules）
# DSH 目录就在它下面：<全局 node_modules>\@deepseek-ai\dsh

DSH 的配置目录默认为 %USERPROFILE%\.dsh（可用环境变量 DSH_HOME 覆盖）。

使用

• 右下角悬浮窗：今日消费金额（大字）、API 请求次数、Tokens、余额
• 按住标题栏拖动；✕ 关闭；侧边栏底部 ¥ 按钮开关
• 余额 60 秒自动刷新，用量 5 分钟自动刷新；"刷新"按钮同时手动刷新

数据说明

• 请求次数 / Tokens：来自 DSH 本地会话日志（assistant/message 事件的 usage），精确反映本机 DSH 的调用；不含通过同一 API Key 的其他程序（如联网搜索、其他工具）。
• 消费金额：Token 桶 × 官方人民币单价（缓存命中 / 未命中 / 输出 × 平峰 / 高峰，周末全天低谷）× 时段规则，为估算值，可能与平台账单有小偏差。
• 余额：官方 /user/balance 接口实时查询；API Key 从 DSH 凭据存储（DEEPSEEK_API_KEY）解析。

隐私与安全

• API Key 仅存在于 DSH 进程内，通过 stdin 传给 curl（不落盘、不显示在命令行）。
• 插件只读取 DSH 本地会话日志与官方公开页面，不上传任何数据。

License

MIT