额度悬浮窗liuliuhuhushui/dsh-quota-float

dsh-quota-float

DeepSeek Harness（DSH）的用量/余额悬浮窗插件 —— 一张可以全页拖动的卡片，显示当前对话所选模型对应供应商的额度或余额。

截图

| Kimi —— 用量进度条 | DeepSeek —— 消费与余额 |
| --- | --- |
| Kimi 用量视图 | DeepSeek 余额视图 |

卡片跟随当前对话选择的模型 —— 切换对话，视图随之切换。

功能

- 🐳 跟随对话：通过 Harness 自己的模型目录读取当前对话选择的模型，并解析出与模型调用完全相同的凭据（设置 → Models → apiKeyEnv → 凭据库）。本包不保存任何密钥。
- 🔀 按供应商切换视图：
- Kimi —— 5h 窗口 + 每周限额进度条，带重置倒计时
- DeepSeek —— 当天消费 + 余额（能识别充值，消费数字不会被充值抹掉）
- 火山引擎 Ark —— 5h + 每周额度（控制台 Cookie + CSRF，先查 DSH 凭据库再查启动环境）
- 阿里云 BSS —— 本月账单 + 账户余额（AccessKey 对，HMAC-SHA1 签名 OpenAPI，先查 DSH 凭据库再查启动环境）
- 🎨 原生外观：基于 DSH 主题令牌（亮/暗自动适配）+ DeepSeek 品牌蓝点缀
- 🖱️ 全页拖动：位置跨对话共享；标题栏可收起；手动刷新按钮
- 🛡️ 稳定：3 次重试 + 5 分钟文件缓存（~/.dsh/quota-float/）+ 失败回退旧数据不白屏

安装

一条命令 —— 自动从 npm 安装并注册 bundle：
dsh plugin add @liuliuhuhushui/dsh-quota-float

手动安装（备选）

cd ~/.dsh/profiles/web        # Windows: %USERPROFILE%\.dsh\profiles\web
pnpm add @liuliuhuhushui/dsh-quota-float

然后把包名加入 profile 的 package.json 的 bundle 列表：

{
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"@liuliuhuhushui/dsh-quota-float"
]
}
}
}

重启 DSH，卡片出现在窗口右下角。

原理

浏览器卡片（shell.overlay 插槽）
└─ GET /quota-float/quota?provider=&model=
└─ Host 插件（index.js）
├─ settings.get('llm-pi-ai' | 'llm-deepseek') → apiKeyEnv 引用
├─ credentials.resolve(ref) → 与模型调用同一把 key
└─ 供应商用量 API（fetch ×3 重试）→ 5 分钟文件缓存

Host 端在 Harness Web 服务器上注册了一个精确路由（webServer.register）；
Client 端是手写的 window.__ModuleLoader__ 格式 bundle —— 零依赖、无构建步骤。

环境要求

- DeepSeek Harness web profile（Node ≥ 22.13）
- 在 DSH 设置 → Models 里配置好 API key（插件直接复用）
- 仅火山 Ark：~/.dsh/.credentials.yaml 里加 ARK_COOKIE + ARK_CSRF_TOKEN（或放在启动环境）
- 仅阿里云：~/.dsh/.credentials.yaml 里加 ALIBABA_CLOUD_ACCESS_KEY_ID + ALIBABA_CLOUD_ACCESS_KEY_SECRET（或放在启动环境）

许可证

MIT