前言¶
用 DeepSeek Harness 开发或调试智能体时，经常要确认 DeepSeek API 账户还剩多少额度。手动切到官方平台查询，不如在宿主侧边栏直接看方便。下面介绍一个 DSH 插件：cn-scuo-oo/dsh-deepseek-quota。它在 DSH Web 侧边栏加入 DeepSeek API 剩余额度卡片，并提供一个充值入口。
它属于 DSH 插件生态中的社区插件，不等同于 DeepSeek 官方应用商店内置功能；社区目录也是独立站点，与 DeepSeek / 幻方没有官方从属关系。
这是什么¶
cn-scuo-oo/dsh-deepseek-quota 由 cn-scuo-oo 发布，采用 MIT License 开源。它解决的是一个具体问题：在 DSH Web 侧边栏直接查看 DeepSeek API 余额、充值/赠送构成、期间已用和更新时间，并在卡片中进入充值面板，扫码打开 DeepSeek 官方充值页完成支付。
核心功能¶
下面列出的能力都围绕「余额展示」和「充值入口」：
- 实时余额展示：对接 DeepSeek 官方
GET /user/balance，展示总余额、充值/赠送构成、期间已用、更新时间。 - 自动刷新与手动刷新：每 60 秒自动刷新，也可点击手动刷新；刷新失败时保留旧值。
- 低余额警示：余额
≤ 0时主数字变红；侧边栏收起态显示!。 - 充值入口：卡片头部「充值」按钮打开居中充值面板，金额档位/支付方式与官网一致。
- 官方支付二维码：面板生成官方充值页二维码
https://platform.deepseek.com/top_up，供扫码支付。 - 密钥安全：API Key 只在 Host 进程内使用，浏览器侧经同源路由取数，Key 不落浏览器。
- 视觉一致：复用侧边栏「设置」同源设计令牌，宽度像素级对齐。
- 宽/窄自适应：侧边栏展开显示完整卡片；收起退化为 32px 圆形按钮，点击可展开侧边栏。
安装与启用¶
先确认运行环境：需要 Node 18+；支持 Windows（Git Bash / WSL）、macOS、Linux。
下面命令用于安装插件：
git clone https://github.com/cn-scuo-oo/dsh-deepseek-quota.git
cd dsh-deepseek-quota
bash install.sh
安装后，侧边栏底部会出现「DeepSeek 额度」卡片。
配置 API Key 时，在 DSH 应用内填写：
设置 → 模型 → 填入 DEEPSEEK_API_KEY
这个 Key 用于调用 DeepSeek 官方余额接口。
如果没有真实 Key，也可以用本地联调地址：
DEEPSEEK_BASE_URL=http://127.0.0.1:8899
这个环境变量用于覆盖官方接口地址，适合本地 Mock 或公司代理场景；无真实 Key 时插件会走本地 mock 上游。
典型用法¶
1、查看额度：侧边栏底部「DeepSeek 额度」卡片显示 ¥余额 大字，以及「充值 X · 赠送 Y」「更新于 HH:MM:SS」。
2、刷新：点击卡片右上角刷新图标立即取数。
3、充值：点击卡片头部「充值」按钮，选择金额/支付方式，点击「去支付」展示官方充值页二维码，手机扫码打开 DeepSeek 官方充值页完成支付。
4、充值到账后：回到侧边栏点击刷新图标，或等待 60 秒自动刷新。
充值面板的边界¶
DeepSeek 没有公开的「按订单生成支付二维码」API，官方充值页也禁止内嵌。因此这个插件不代收资金，也不绕过官方计费；面板展示的是官方充值入口二维码：
https://platform.deepseek.com/top_up
用户在面板中选择金额和支付方式后扫码，打开官方充值页完成支付。支付完成后，回到 DSH 侧边栏刷新卡片即可查看最新余额。
安全与注意¶
- 数据源：DeepSeek 官方
GET /user/balance，需要有效DEEPSEEK_API_KEY。 - Key 边界：API Key 全程不出 Host 进程，浏览器侧经同源路由取数，API Key 不进入浏览器、前端代码或命令字符串。
- 合规边界：只对接 DeepSeek 官方公开 API 与官方充值页，不涉及爬虫、绕过官方计费或代收资金逻辑。
- 安装边界：插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。该插件基于 MIT License 开源，可自由使用、修改、商用。
链接¶
- 仓库：
https://github.com/cn-scuo-oo/dsh-deepseek-quota - 目录页线索（未核验）：
https://www.skillhub.cn/plugins/cn-scuo-oo/dsh-deepseek-quota
