DeepSeek Harness plugin

dsh-quota

Bottom-right quota pill and panel aggregating membership quotas across AI platforms (Kimi Code, DeepSeek, Zhipu Coding Plan, BigModel, Qwen, Scnet, TokenRouter, SupaWriter), auto-syncing API keys from the DSH credentials domain with colored usage bars.

Jump to install

Source facts

Repository
Minokun/dsh-quota
Latest update
Aug 19, 2026
Category
Usage & Billing
GitHub stars
0

Install

Start with a prompt that asks an agent to read the source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to read the page and repository first.

Do not install anything yet. Read this DeepSeek Harness plugin and explain what it does, which files, networks, or credentials it can access, and how to install and remove it.

Plugin page: https://deepseekplugins.org/plugins/Minokun/dsh-quota
GitHub: https://github.com/Minokun/dsh-quota
Plugin: dsh-quota
Author: Minokun
Install command: dsh plugin --profile web add github:Minokun/dsh-quota

Do not run the install command until I confirm.

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer2 files
README.mdSource · read only

dsh-quota

DeepSeek Harness 插件:右下角「会员额度」悬浮球 + 面板,一眼看清各 AI 平台的套餐额度与余额。

!面板特写

<details> <summary>📸 整页效果(悬浮球在右下角)</summary>

!整页效果

</details>

截图里都是什么:

  • 右下角的「会员额度」悬浮球:圆点表示整体状态(绿 = 全部正常 / 黄 = 部分异常 / 红 = 全部失败),旁边是上次刷新时间;点击展开/收起面板,打开时数据超过 5 分钟会自动后台刷新
  • 每个平台一张卡片:右上两个徽标——API = 官方 API 直查(key 自动同步自 DSH 凭证域,下方灰色小字显示用的是哪个凭证引用,例如 ⇄ 已同步 KIMI_CODING_API_KEY · DSH 凭证),MCP = 通过已注册的 MCP 服务器查询;正常 / 失败 / 未配 Key 是本次查询状态
  • 彩色进度条:用量占比(<60% 绿 / 60–85% 黄 / >85% 红),右侧是 已用 / 上限 剩xx,下方小字是额度窗口的重置时间
  • 头部「刷新」按钮:立即重新查询所有平台;面板底部「API Key 管理」折叠区可手动补 key(一般不需要——DSH 里加过的 key 会自动同步过来)

功能

  • 定时自动更新:默认每 5 分钟刷新一次(refreshIntervalMinutes 可调);打开面板时数据超过 5 分钟也会自动补刷;手动「刷新」随时可用
  • 进度条可视化:用量占比彩色进度条(<60% 绿 / 60–85% 黄 / >85% 红),带重置时间
  • 配置哪些显示哪些:只有 key 能解析(或 MCP 已注册)的平台才显示,没配置的平台不占面板
  • Key 自动同步:直连平台的 API key 直接读 DSH 凭证域(与模型配置同一批 apiKeyEnv 引用)——DSH 里加过 key 就不用手动再填;凭证变更自动触发刷新
  • 手动 Key 兜底:面板里可手动保存 key(存于 DSH 凭证域的插件私有引用,删除不影响 DSH 模型配置)

支持的平台

钉住平台(始终显示,缺 key 时提示):Kimi Code、DeepSeek、智谱 Coding Plan。

自动发现平台(key 在 DSH 凭证域/环境变量能解析就自动出现,否则隐藏):Z.AI Coding、Moonshot、OpenRouter、SiliconFlow(国际/国内)、MiniMax Coding(国际/国内)、StepFun、xAI、OpenCode Go、DeepInfra、Venice、NeuralWatt。面板「API Key 管理」覆盖全部直连平台——填 key 即接入(写入 DSH 凭证域,模型配置也能用)。

MCP 平台(纯可选扩展,通过另行注册的 mcp__* 工具取数;本仓库不包含这些 MCP 服务器):智谱 BigModel、通义千问(百炼)、超算互联网、TokenRouter、SupaWriter。没注册时对应平台自动隐藏。

自定义平台:有余额 API 的平台(聚合站 / one-api / new-api…)在面板底部「自定义平台」直接添加,或在 config 里声明 httpPlatforms / mcpPlatforms —— 详见 [docs/extending.md](docs/extending.md)(含"如何把网页 Cookie 平台做成 MCP 接入"的完整指南)。

安装

dsh plugin --profile web add dsh-quota

或打开 设置 → 插件市场,搜索 dsh-quota 一键安装。

配置(可选)

在 composition 里给条目加 config:

- id: quota
  config:
    refreshOnBoot: true          # 启动后自动刷新一次(默认 true)
    refreshIntervalMinutes: 30   # 定时刷新间隔,0 关闭(默认 0)

接入你自己的 MCP 平台

除了上述内置平台,composition 里声明 mcpPlatforms 即可把任何已注册的 mcp__* 额度工具接进面板(通用解析:自动识别 used/limit/remaining 形的配额行与 balance 形余额;未注册时该行自动隐藏):

- id: quota
  config:
    mcpPlatforms:
      - id: mysite
        label: 我的平台
        tools: ['mcp__mysite__my_quota']   # 按序调用,可多个

开发

pnpm install
pnpm build        # 构建 host + client,含 client-id 一致性门禁
pnpm typecheck
sh scripts/reload.sh   # 构建;Host 改动重启 dsh 生效,界面改动刷新页面生效

发布(maintainer)

发版走 npm Trusted Publishing(GitHub Actions OIDC)——不需要本地 token 或 2FA 验证码:

sh scripts/release.sh          # 默认 patch;也可 sh scripts/release.sh minor / 0.8.0

流程:npm version 升版本并打 tag → 推送触发 .github/workflows/publish.yml → CI 里构建(含门禁)→ OIDC 认证发布,自带 SLSA provenance。动作日志见 Actions

绑定配置(一次性,已绑好):npmjs.com 包设置 → Trusted Publisher → GitHub Actions → Minokun / dsh-quota / publish.yml / 允许 npm publish

License

MIT