Skip to main content
M

dsh-quota

minokun/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.

Install

dsh plugin --profile web add github:minokun/dsh-quota

README

dsh-quota

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

面板特写

📸 整页效果(悬浮球在右下角)

整页效果

截图里都是什么:

  • 右下角的「会员额度」悬浮球:圆点表示整体状态(绿 = 全部正常 / 黄 = 部分异常 / 红 = 全部失败),旁边是上次刷新时间;点击展开/收起面板,打开时数据超过 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 已注册)的平台才显示,没配置的平台不占面板
  • 当前平台优先:面板里「当前在用」的模型所属平台的卡片自动排到最前(紧跟第一行的「本会话」用量卡片),换模型时顺序实时跟着变;其余平台仍按内置顺序(直连 API 在前、MCP 兜底在后)。供应商 → 平台的映射表只有一份(src/platform-map.ts,Host 与浏览器共用),火山方舟 ark → volcark 这类规则不会再出现「只有一侧认得」的漂移
  • 本会话用量可折叠:面板第一行「本会话」默认收起,只显示模型与估算花费;点标题展开输入 / 缓存读 / 输出 token、估算成本与计费周期行(展开状态会记住)。只要屏幕上有会话这张卡就在——还没产生用量时收起行显示「本会话还没有产生 token 用量」、展开行三桶为 0,不会整块消失。余额型平台的计费周期行在样本不足 7 天时只报「近 N 天实测 + 日均」,不再把日均外推成「近 7 天总额」
  • Key 自动同步:直连平台的 API key 直接读 DSH 凭证域(与模型配置同一批 apiKeyEnv 引用)——DSH 里加过 key 就不用手动再填;凭证变更自动触发刷新
  • 同平台多账号:同一平台在 DSH 里挂了第二个模型供应商(例如再建一个 deepseek-b 路由,apiKeyEnv 指向 DEEPSEEK_B_API_KEY、baseURL 填官方地址),面板会按凭证引用出第二张卡,标题用 · deepseek-b 区分,两张卡各查各的 key、互不覆盖。注意 DSH 本身一个供应商只有一个 apiKeyEnv——在同一个供应商卡片里重复填 key 是覆盖,不是新增账号;第三方兼容网关(baseURL 不是官方域名)也不会被拿来查官方余额接口
  • 手动 Key 兜底:面板里可手动保存 key(存于 DSH 凭证域的插件私有引用,删除不影响 DSH 模型配置)
  • 消耗速率与剩余时长预估:本地时序采样(≥10 分钟一个点、保留 14 天,落盘到 $DSH_HOME/dsh-quota/history.json,重启不清零),在当前配额窗口段上计算平均消耗速率(%/h),条目下方给出「约 x 小时后耗尽」预估;窗口重置自动截断分段,不会跨重置算出错误速率;quota_refresh 工具同步透出
  • 余额型平台的「近 7 天消耗 / 余额还能撑多久」:余额条目按日历时间口径算——近 7 天实测余额降幅 ÷ 跨度(闲置时间也算进分母)得到真实日均,再外推 7 天花费与余额耗尽时间。样本跨度不足 24 小时不显示(几十分钟的活跃速率外推一周会放大 3 倍左右,这正是「日均 ¥20 却被算成 ¥430/周」的来源);跨度不足 7 天会标注「按 N 天实测折算」
  • 一键测活:每张卡片右上「测」按钮当场重跑该平台的查询,返回毫秒延迟(✓ 320ms)或上游原始错误;只读探测,不改动快照
  • 自定义端点安全校验:接口地址必须是公网 HTTPS——拒绝内嵌用户名/密码、查询参数、localhost/.local/.internal 与回环/私有/链路本地/保留地址(含 IPv4/IPv6 字面量);请求拒绝跟随 3xx 跳转、响应超过 256 KiB 直接失败,避免自定义平台被用来探测内网
  • 中英双语界面:面板文案跟随 DSH 的语言设置(ctx.locale 服务)实时切换,缺失该服务时按浏览器语言自动判定;药丸/悬浮环/面板/错误提示/时间格式全部本地化(en 文案不含中文字符,有单测把关)
  • 红点告警 Badge:悬浮球/悬浮环右上角红点计数——查询失败的平台 + 用量占比 ≥ alertPercent(默认 85,可配置)的条目 + 登录失效提醒,恢复后自动消失
  • 「即将见底 / 预计耗尽」提醒:条目越阈值、或按当前速率预计 30 分钟内耗尽时,从悬浮球冒出一次 toast,每个额度窗口只提醒一次(状态存 localStorage,刷新不重弹;点 ✕ 也不重弹,窗口真正重置后才允许下一次)。窗口身份按 resetAt 比较并带 5 分钟容差——上游网关的 resetsAt 有秒级抖动,按字符串全等会把同一个 100% 的窗口当成两个而反复提醒
  • HUD 悬浮环模式:面板头部一键在「药丸 / 悬浮环」之间切换(localStorage 记住);悬浮环显示剩余额度环形进度(绿/黄/红三档、平滑动画),焦点跟随当前会话模型,无对应时每 4 秒轮播各平台(悬停暂停);拖到屏幕左右边缘自动贴边微缩、悬停展开

支持的平台

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

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

Magpie(本机网关):装了 Magpie 就自动多出若干张卡,一个账号一张——网关在跑就显示,没跑就整行隐藏,不需要填任何 key(回环口 GET /v1/magpie/quotas 免鉴权)。网关里接了几个订阅/套餐/余额账号就有几行,模型配置里配了 magpie / magpie-anthropic / magpie-responses 供应商时才会去查。端口默认 127.0.0.1:3425,用环境变量 MAGPIE_URL 覆盖。

  • 额度窗口:网关的 5 hours / 7 days / 30 days / MCP · Month 等窗口直接映射成「5 小时窗口」「7 天窗口」「30 天窗口」「MCP 月度额度」,used 即已用百分比;带 limit 的计数窗口(如 0 / 1000)照实显示原读数;带 unit + balance 的(如 Kimi 的 Extra usage)显示金额而非进度条
  • 用量记账:每个账号追加一条「近 30 天消耗」(花费 + 调用次数,取自 GET /v1/magpie/usage)。纯 API-key 供应商(按量计费、没有订阅窗口的,如 sidrune)只在用量里有记录,插件会单独给它一行,否则它在面板上完全不可见
  • 卡片灰色注释:账号名、套餐有效期、是否自动续费
  • 当前模型认领:magpie 的所有行共用同一个凭证引用(一个网关 Key 背后是好几个账号),所以置顶按模型 id 的 provider 前缀认领(codex/gpt-5.6-terra → magpie#codex),不会永远把本机第一行顶到前面
  • 与内置订阅行去重:subscription.ts 也会直连 chatgpt.com 读 ~/.codex/auth.json 取 Codex 额度。magpie 收的是同一份登录态、且自带代理与 token 续期,所以 magpie 那行查到了额度时内置行自动让位(避免同一账号两张卡、其中一张在需要代理的网络里红成 fetch failed);magpie 没接该账号或那行失败时,内置行照旧保留

OpenDesign(open-design.ai / Vela):额度同样不在推理 API 上——模型面 amr-link.open-design.ai/v1 只认 sk-amr-… 推理 key,没有任何额度路由;额度在控制面 amr-api.open-design.ai/api/v1,且只认 vela_ctrl_… 控制面 key(任何网页都不印这个 key,由 vela CLI 设备授权签发)。所以凭证引用是 OPENDESIGN_CONTROL_KEY(别名 VELA_CONTROL_KEY),不是给模型供应商配的 OPENDESIGN_API_KEY:后者填进来只会得到 401,面板会直接告诉你这一点。

查 OD 额度必须先登录 Open Design:那把 key 由 vela 的设备授权签发,没有任何网页会显示它。所以本插件不要求你手抄 key ——它每次刷新都直接读 vela 的登录态(~/.amr/config.json 的 profiles.prod.controlKey),变了就写回 DSH 凭证域,于是「在 Open Design 里登录 / 重新登录」就等于「面板恢复」,key 轮换也自动跟上。没登录时卡片不会消失,而是钉住显示「需要先登录 Open Design(vela CLI / 桌面版)才能查额度」,卡片上的灰字会写明本次读数用的是「Open Design 登录态」还是「DSH 凭证域」。查询路径:GET /workspaces/current 解析 workspaceId → GET /workspaces/{id}/billing/preflight 取额度窗口与钱包 → GET /billing/summary 补累计消费(拿不到只少一行)。卡片显示 7 天窗口(credits 与折算 USD)、钱包余额(负数即欠费,照实显示)、累计消费;窗口各自独立、绝不相加。多工作空间时用环境变量 OPENDESIGN_WORKSPACE_ID 钉住。注意别用 /billing/coding-plan-usage——那个端点对控制面 key 返回 401,preflight 才是能用的。

火山方舟(Volcengine Ark):额度不在推理 API 上——ARK_API_KEY(ark-…)只能调模型,所以 DSH 里只配了它时,卡片只能探活显示「模型服务 在线」,这是设计如此、不是查询失败。套餐用量要走火山引擎控制面 OpenAPI(open.volcengineapi.com,GetCodingPlanUsage / GetAgentPlanAFPUsage,HMAC-SHA256 签名),必须用 AccessKey ID + SecretAccessKey:在面板底部「API Key 管理」里把两者按 AK:SK(或控制台给的合成串 AK/SK、整行 AccessKeyID/SecretAccessKey: …)填进「火山方舟 (AK/SK)」,插件会自动拆开,或直接写凭证引用 VOLC_ACCESS_KEY_ID / VOLC_ACCESS_KEY_SECRET(也认 VOLC_ACCESS_KEY / VOLC_SECRET_KEY 等别名)。AK/SK 建议用 IAM 子用户并只授 ArkReadOnlyAccess(只读);Coding Plan 与 Agent Plan 共用同一对 AK/SK,插件先试 Coding Plan、未订阅时自动落到 Agent Plan。

国外官方平台(用量/成本口径):OpenAI 走组织 Admin API /v1/organization/costs(凭证引用 OPENAI_ADMIN_KEY,即 sk-admin-…),Anthropic 走 Admin cost_report(凭证引用 ANTHROPIC_ADMIN_KEY,即 sk-ant-admin…,请求带 anthropic-version、金额单位是「分」已自动换算)。两家都没有余额查询接口,卡片展示「今日 / 近 7 天 / 近 30 天消耗」,并在卡片上注明;普通 sk-* / 项目 key 会被上游拒绝,不是插件的问题。

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

智谱 BigModel 的登录态会自己续上:该 MCP 服务器(bigmodel-mcp)能从本机 Chrome / Edge / Brave 的 bigmodel_token_production cookie 解出 JWT。面板刷新时若上游回「登录状态已过期」(code 401),它会自动重取浏览器里的新 token、写回会话文件并重试一次,所以你在浏览器里重新登录 open.bigmodel.cn 后,点一下刷新(或等自动轮询)就恢复,不用重启 dsh、也不用手动粘贴 cookie。

MCP 平台行兼容 DSH 0.2.1 与 0.2.2 两种 ctx.tools.execute 形态:0.2.2 把 execute({callId,name,arguments}) 换成了整批 execute({calls,signal}) 并把调度交给所选执行器;把旧的单调用形状发给 0.2.2 会在任何工具体运行前就被批调度器拒掉(ToolBatchExecutionError: Tool batch execution failed,原因是 input.calls.map 读不到)。Host 半边因此按运行时能力分派:存在 selectExecutor/definitions(0.2.2 起才有)就走单元素批,否则退回旧单调用;两条路都归一化成同一种结果,旧版 dsh 上行为不变。

智谱余额用 API key 就能查,不需要登录态:智谱 Coding Plan 卡(API key 直连)除了 5 小时/周窗口与搜索额度,还会显示账户余额、累计消费——走 GET https://open.bigmodel.cn/api/biz/account/query-customer-account-report(Authorization: Bearer <key>,返回 balance/availableBalance/rechargeAmount/giveAmount/totalSpendAmount/frozenBalance)。注意智谱把控制台接口也放在 /api/biz/* 下,但权限不同:/api/biz/customer/accountSet、/api/biz/customer/getCustomerInfo 对 API key 返回 403 APIKey not allow access(那才是 MCP 登录行存在的原因);余额、订阅列表 /api/biz/subscription/list、资源包 /api/biz/tokenAccounts/list/my、用量 /api/monitor/usage/model-usage 都对 API key 开放。附加行取不到(403/超时)只会少一行,不会把卡片变成错误。

平台来源以 DSH 系统配置为准:MCP 平台行只在 DSH composition(profile 的 cordis.yml / cordis.patch.yml)声明了对应的 @deepseek-ai/dsh-mcp-client 条目时才创建——Host 半边通过 cordis loader 服务读取真实的 entry 树,而不是看项目里的 .mcp.json、也不是"恰好存在同名工具";composition 里删掉条目(并重启 dsh)后,对应平台立即从面板消失。loader 服务不可用的旧版本上自动退回"工具注册表探测"。

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

NewAPI 有两种口径:openai-billing 使用模型 sk-* key 查询该 key 的额度;newapi-account 使用个人设置里的系统访问令牌与用户 ID 查询 /api/user/self,显示整个账号的余额和累计用量。

安装

dsh plugin --profile web add dsh-quota

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

版本要求:0.8.0+ 需要 dsh 0.1.2-alpha.1 及以上(浏览器端模块表改用 @deepseek-ai/dsh-client-store platform seed)。仍在用旧版 dsh(0.1.0-rc 系列) 请锁定 dsh-quota@0.7.x。

配置(可选)

在 composition 里给条目加 config:

- id: quota
  config:
    refreshOnBoot: true          # 启动后自动刷新一次(默认 true)
    refreshIntervalMinutes: 30   # 定时刷新间隔,0 关闭(默认 0)
    alertPercent: 85             # 用量占比告警阈值(红点计数,默认 85)

接入你自己的 MCP 平台

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

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

开发

pnpm install
pnpm link-harness # 把类型/依赖对齐到本机已安装的 dsh(见下)
pnpm build        # 构建 host + client,含 client-id 一致性门禁
pnpm typecheck
sh scripts/reload.sh   # 构建;Host 改动重启 dsh 生效,界面改动刷新页面生效

pnpm link-harness 默认从本机已安装的 dsh(npm root -g,或 DSH_INSTALL=<dsh 目录>) 软链 node_modules/@deepseek-ai/*,让 typecheck/build 与运行时解析同一份代码。 改 dsh 源码时才用 sh scripts/link-harness.sh --harness [checkout 路径] 切到工作树构建。 两者都没有时回退到仓库内 vendor/(schemastery / cordis / dsh-client-store)。

交流群

扫码加入 QQ 交流群,一起反馈问题、分享用法、共建插件——欢迎一起来建设!

QQ 交流群二维码

License

MIT

Related plugins