@goodandready/dsh-key-limits

dsh plugin --profile web add @goodandready/dsh-key-limits

📦 @goodandready/dsh-key-limits

<div align="center">

<h3>DeepSeek Harness 智能体 API 密钥额度、Token 计划与订阅余额实时监控插件</h3>

<p align="center">

<a href="https://www.npmjs.com/package/@goodandready/dsh-key-limits"><img src="https://img.shields.io/npm/v/@goodandready/dsh-key-limits.svg?style=for-the-badge&color=6366f1&labelColor=1e1b4b" alt="npm version"></a>

<a href="LICENSE"><img src="https://img.shields.io/github/license/GooDAnDReaDY/dsh-key-limits.svg?style=for-the-badge&color=10b981&labelColor=064e3b" alt="license"></a>

<a href="https://github.com/topics/dsh-plugin"><img src="https://img.shields.io/badge/DSH-Plugin-8b5cf6.svg?style=for-the-badge&labelColor=2e1065" alt="DSH Plugin"></a>

<a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node-20%2B-f59e0b.svg?style=for-the-badge&labelColor=451a03" alt="Node version"></a>

</p>

<!-- 作者所有项目直达按钮 -->

<p align="center">

<a href="https://goodandready.app/"><img src="https://img.shields.io/badge/作者全部项目-goodandready.app-ff4500.svg?style=for-the-badge&logo=rocket&logoColor=white&labelColor=1a1a2e" alt="作者全部项目"></a>

</p>

<p align="center">

<a href="README.md"><b>🇬🇧 English</b></a> •

<a href="README.zh.md"><b>🇨🇳 中文说明</b></a> •

<a href="README.ru.md"><b>🇷🇺 Русский</b></a>

</p>

<!-- 项目支持模块 -->

<table align="center">

<tr>

<td align="center">

⭐ <strong>如果您喜欢这个插件，请在 GitHub 上为它点亮 Star</strong> — 这能让我知道插件对您有用，并鼓励我继续开发和维护它。

<br><br>

🐛 <strong>如果您发现 Bug 或希望增加功能</strong>，请使用任意语言在 GitHub 上提交 Issue — 我会评估您的建议，并在后续版本中实现有价值的改进。

</td>

</tr>

</table>

</div>

---

⚡ 概述与核心痛点

AI 开发者和工程师在日常工作中通常需要同时跨多个主流模型服务商与订阅计划（如 OpenCode GO、Ollama Cloud、通义千问 Qwen Cloud、Kimi、智谱清言 GLM、MiniMax、Cline、DeepSeek、OpenRouter 以及 Command Code）。

在 DeepSeek Harness (DSH) 中缺少全局配额状态监控时：

• 会话在代码生成进行到一半时因 5 小时滚动窗口或每月配额枯竭而异常中断报错。
• 难以直观判断当前会话激活模型究竟绑定了哪一个具体的密钥账户。
• 频繁在几十个各厂商后台网页间来回切换查询，割裂开发心流。

dsh-key-limits 专为解决此痛点而生，在 DSH Web 工作区提供免打扰、沉浸式的实时配额与余额监控。插件专注核心剩余状态，不引入沉重的财务账目或统计报表。

---

🏗️ 架构与数据流

graph LR
  subgraph Client ["DSH 网页端 (Web UI)"]
    FC["FloatChip (悬浮监控胶囊)"]
    CB["ActiveKeyButton (输入栏实时按钮)"]
    SC["设置卡片 (settings.plugin.item)"]
    M["弹窗模块 (全部限额 / 当前密钥)"]
  end

  subgraph Backend ["Cordis 插件服务端"]
    Router["HTTP API 路由 (/dsh-key-limits)"]
    CredStore["加密凭据托管服务"]
    Updater["安全本地回环更新器"]
  end

  subgraph Providers ["服务商接口与发布源"]
    P1["OpenCode GO / Ollama / 通义千问"]
    P2["Command Code / Cline / 智谱清言"]
    P3["DeepSeek / OpenRouter / MiniMax"]
    NPM["npmjs.org 公共官方仓库"]
  end

  FC -->|点击| M
  CB -->|点击| M
  M -->|每 60 秒轮询| Router
  SC -->|保存密钥配置| Router
  SC -->|检查/触发升级| Updater
  Router --> CredStore
  Router -->|并行 12 秒超时请求| P1
  Router -->|并行 12 秒超时请求| P2
  Router -->|并行 12 秒超时请求| P3
  Updater -->|检查版本并安全安装| NPM

---

✨ 核心特性详解

1. 悬浮监控胶囊 (FloatChip)

• 视口全局悬浮：显示当前所有配置账户中最紧缺的配额百分比（或配置的账户总数）。
• 自由拖拽与边缘保护：支持平滑鼠标/触摸拖拽，内置视口碰撞检测，绝不滑出屏幕。坐标自动保存于 localStorage。
• 一键速查：点击胶囊立即打开全部限额详情弹窗，直观展示 9 个账户的健康度、额度条与刷新时间。

2. 对话输入栏集成 (ActiveKeyButton)

• 嵌入消息输入面板 (conversation.composer.bar，优先级 10)。
• 实时侦测当前对话所绑定的模型供应商。
• 精准呈现该模型对应订阅的剩余百分比或金额余额。
• 点击按钮打开仅针对该活跃账户的详情弹窗。

3. 账户排序与活跃账户置顶

• 自定义显示顺序 (order)：在设置中心，使用简洁直观的 ▲ / ▼ 按钮上下移动调整卡片先后排列。
• 活跃账户自动置顶 (activeOnTop)：当前聊天所调用的账户将自动固定至列表第一位。默认开启。

4. 人性化重置倒计时 (fmtReset)

• 距离重置超过 24 小时：格式化显示天、小时与分钟（例如 5d 5h 19m）。
• 不足 24 小时：简明显示小时与分钟（例如 4h 59m）。
• 已过期的窗口即时标明需刷新状态。

5. 克制优雅的视觉风格

• 卡片间统一定义 12px 垂直间距，杜绝元素贴边与边框压叠。
• 充足状态 (>30%) 采用温和的中性主题色，预警黄 (<30%) 与危急红 (<15%) 仅在真正紧缺时出现。
• 5px 高度的高端精致进度条。

6. 连接池健康度与预测分析

• 连接池健康度概览：实时统计各提供商账户健康状况（健康 / 预警 / 耗尽），精准呈现额度告警或网络超时的账户。
• 消耗速率与剩余时长预测：基于本地浏览器 24 小时滚动快照，精确计算每小时消耗速率（%/h）并推算额度耗尽时间（剩余可用约 X.X 小时）。
• 无感重置倒计时：悬浮胶囊工具提示与卡片标签即时显示最近窗口的重置剩余时间（如 重置倒计时: 2h 15m）。
• 24小时消耗趋势折线（SVG Sparkline）：轻量紧凑的无感矢量迷你走势图，根据配额状态自适应主题色彩。

7. 停靠吸附模式、全局快捷键与危险浮条告警

• 停靠吸附（Docked Mode）：胶囊标题栏提供一键吸附按钮，将胶囊固定在右下角，避免拖动遮挡且节省窗口空间。
• 全局快捷键 Alt+K：在任意界面随时呼出全额度管理中心，无需鼠标寻找胶囊。
• 危险浮条（Danger Toast）：当当前激活密钥配额降至 15% 以下时，屏幕顶部优雅弹出告警，防止生成突然中断。

8. 加密备份与一键批量刷新

• 加密导出与导入：支持将所有配置好的密钥与凭据导出为经过 AES-256-GCM 高强度加密的文件，凭借自定义密码实现设备与环境间的无缝迁移。
• 全部刷新（Refresh All）：在额度面板中一键发起所有密钥的批量强制刷新，带流畅旋转动画与受控并发保护。

9. 内置一键版本更新

• 在设置卡片内直接检测 npm 官方最新版本。
• 自动化调用安装程序升级至确定版本，无需手动开启终端执行 shell 指令。
• 严格限制为 Loopback 本地同源请求，保障系统安全。

10. 安全与存储架构

• 凭据隔离存储：明文 API 密钥及敏感会话 Cookie（如 Ollama Cloud）仅保存在宿主 DSH 的 credentials 专用凭证服务中。本地 subs.json 文件仅存储脱敏元数据与引用。
• 严格文件权限：数据库文件 subs.json 及临时置换文件均强制使用 POSIX 0600 权限模式（仅当前进程所有者可读写），防止本机多用户环境数据外泄。
• 失效凭据安全清除：内存凭证缓存于每次查询前自动清空；已注销或撤回的密钥绝不残留于内存轮询或备份导出（POST /export）中。
• 重定向跨域防泄漏：各服务商数据抓取客户端默认配置 redirect: 'error'，严格阻断 HTTP 301/302/307 重定向过程中可能发生的鉴权标头外泄风险。
• 事务级持久化回滚：磁盘写入异常会自动触发内存状态回滚并返回规范的 HTTP 500 错误，坚决杜绝虚假写入成功。

---

🔌 支持的服务商一览

服务商 ID · 名称 · 配额窗口类型 · 鉴权方式

commandcode · Command Code · 滚动 5小时 / 每周 / 每月 (GOAT, Pro, Max 计划) · API 密钥 (user_... 或令牌)

opencode-go · OpenCode GO · 滚动 5小时 / 每周 / 每月 · 会话 Cookie (auth) 与 Workspace ID

ollama · Ollama Cloud · 会话 / 每周 / 每月 · API 密钥与会话 Cookie

qwen · 通义千问 (Qwen Cloud) · 5小时 / 1周 Token 计划 · 会话 Cookie 与可选 sec_token

kimi · Kimi for Coding · 每周调用额度限制 · API 密钥 (sk-kimi-...)

glm · 智谱清言 (GLM / Z.ai) · 每日 / 每月额度 · 个人中心 API 密钥

minimax · MiniMax Coding Plan · 编程计划专属配额 · API 密钥 (sk-cp-...)

cline · Cline · 5小时 / 每周 / 每月 · Bearer API 令牌

siliconflow · 硅基流动 (SiliconFlow / SiliconCloud) · 账户总余额与赠金 ($ / ¥) · API 密钥 (sk-...)

anthropic · Anthropic · 请求与 Token 速率配额 · API 密钥 (sk-ant-...)

groq · Groq · RPM 与 TPM 实时限速 · API 密钥 (gsk_...)

gemini · Google Gemini · API 状态与模型配额 · API 密钥 (AIza...)

deepseek · DeepSeek · 账户资金余额 ($ / ¥) · API 密钥 (sk-...)

openrouter · OpenRouter · 账户代币余额 ($ credits) · API 密钥 (sk-or-...)

---

📦 快速安装

在活动的 DSH 运行环境中安装官方公开发布包：

dsh plugin --profile web add @goodandready/dsh-key-limits

重启 DSH Web 服务：

dsh web --profile web

---

…(truncated)