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