dsh-quota-float

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

截图

| 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