cn-scuo-oo/dsh-deepseek-quota 预览 preview

cn-scuo-oo/dsh-deepseek-quota

Plugin插件 Native原生 ⭐ 3 MIT Usage & Cost用量与计费UI & Themes界面与主题

DeepSeek Harness Web 侧边栏 DeepSeek API 额度卡片 + 充值面板插件 | Sidebar quota card & recharge panel for DeepSeek Harness: 实时官方 /user/balance(60秒自动刷新)、与官网一致的充值档位/支付方式、官方充值二维码,API 密钥保留在主机端。一键安装:bash install.sh

Project Overview项目介绍

This is a native sidebar plugin built exclusively for DeepSeek Harness Web, designed to show your remaining DeepSeek API account balance and add a built-in official recharge entry directly to your DSH sidebar. It pulls real-time balance data from DeepSeek’s official public GET /user/balance API, and automatically refreshes the data every 60 seconds to keep your balance reading up to date. It displays total balance, separate breakdowns of topped-up and gifted balance, last update time, and usage since the plugin loaded, and keeps your API Key confined entirely to the DSH host process to prevent credential leaks. This plugin also triggers a red warning when your balance drops to zero or below, to alert you before your calls get interrupted.

It adapts to both expanded and collapsed states of the DSH sidebar. When the sidebar is expanded, it shows a full information card with all balance details, and when collapsed it shrinks to a 32px circular button that you can click to expand the sidebar and check your balance. After installation and a restart of DSH, you only need to use the same DeepSeek API Key you already configured for DSH model calls to enable the plugin, no extra configuration files are required. To recharge, click the recharge button on the card to open a centered modal panel, select your amount and payment method, then scan the generated QR code to open the official DeepSeek recharge page on your phone.

This plugin requires Node.js 18 or newer to run, and supports all major desktop operating systems including Windows, macOS, and Linux. It offers two installation methods: a recommended one-click install script that automatically detects your DSH profile, copies plugin files, updates your profile configuration, and creates required symlinks, and a manual installation option for users with custom setups. It is released under the permissive open source MIT license, is completely free to use, and does not handle any payments or collect any user funds—all recharge flows go directly to DeepSeek’s official platform. You can also run a local mock API server to test the full plugin workflow without a real DeepSeek API key.

这是一款专门为 DeepSeek Harness Web 开发的原生侧边栏插件,核心功能是在侧边栏展示 DeepSeek API 的剩余账户额度,并提供内嵌的官方充值入口。它对接 DeepSeek 官方的 /user/balance 接口,每 60 秒自动刷新余额,支持展示总余额、充值余额、赠送余额、更新时间和加载后的期间已用额度,当余额低于等于0时还会给出红色警示,API Key 全程不会流出宿主进程,保障用户凭据安全。

它适配 DeepSeek Harness 侧边栏的宽窄两种状态,展开时显示完整信息卡片,收起时变为32px圆形按钮,点击即可展开侧边栏查看额度。常规使用流程为安装重启后,只需在 DSH 设置中填入已有的 DeepSeek API Key 即可启用,点击卡片右上角可手动刷新余额,点击头部充值按钮即可弹出居中充值面板。面板生成官方充值页二维码,手机扫码即可跳转官方页面完成支付,它适合日常使用 DeepSeek API 开发、需要随时监控余额并快速充值的 DSH 用户。

该插件要求运行环境为 Node.js 18 及以上版本,支持 Windows、macOS 和 Linux 系统,提供一键脚本安装和手动安装两种方式,支持自定义安装到指定 profile,也提供一键卸载命令。它采用 MIT 许可证开源免费使用,无任何付费功能,充值流程仅跳转官方页面,不代收任何资金,不会绕过官方计费规则。首次安装后需要重启 DeepSeek Harness 才能加载插件,可通过本地 mock 服务完成无真实 API Key 的全流程联调测试。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:cn-scuo-oo/dsh-deepseek-quota

把 cn-scuo-oo/dsh-deepseek-quota 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-deepseek-quota

DeepSeek Harness Web 侧边栏的 DeepSeek API 剩余额度卡片 + 充值面板 插件。 实时展示官方余额(总余额 / 充值构成 / 赠送余额 / 期间已用 / 更新时间),每 60 秒自动刷新; 卡片内提供「充值」入口,弹出居中充值面板(金额档位与支付方式与 DeepSeek 官网一致), 扫码打开官方充值页完成支付。数据来自 DeepSeek 官方 /user/balance 接口,API Key 全程不出 Host 进程。

MIT License Node 18+ Release v1.0.0


目录


功能特性

# 能力 实现
1 实时余额展示 对接 DeepSeek 官方 GET /user/balance,展示总余额、充值/赠送构成、期间已用、更新时间
2 自动刷新 每 60 秒自动刷新 + 手动刷新按钮;刷新失败保留旧值(stale-while-error)
3 低余额警示 余额 ≤ 0 时主数字变红;侧边栏收起态显示 !
4 充值入口 卡片头部「充值」按钮 → 居中充值面板(金额档位/支付方式与官网一致)
5 官方支付二维码 面板生成官方充值页二维码(https://platform.deepseek.com/top_up)供扫码支付
6 密钥安全 API Key 只在 Host 进程内使用,浏览器侧经同源路由取数,Key 不落浏览器
7 视觉一致 复用侧边栏「设置」同源设计令牌(字体/颜色/间距/圆角/悬停态),宽度像素级对齐
8 宽/窄自适应 侧边栏展开显示完整卡片,收起退化为 32px 圆形按钮,点击展开侧边栏

适用平台

项 要求
宿主 DeepSeek Harness Web(桌面端 / Web profile)
运行环境 Node 18+(DSH 内嵌 Node 或系统 Node 均可)
操作系统 Windows(Git Bash / WSL)/ macOS / Linux
数据源 DeepSeek 官方 GET /user/balance(需有效 DEEPSEEK_API_KEY)

安装

方式 A:一键安装(推荐)

git clone https://github.com/cn-scuo-oo/dsh-deepseek-quota.git
cd dsh-deepseek-quota
bash install.sh

脚本自动完成:检测 DSH profile 与 Node 版本(缺失给出修复指引)→ 复制插件文件到 ~/.dsh/profiles/web/vendor/dsh-deepseek-quota/ → 更新 profile package.json (dependencies + bundles 声明)→ 建立 node_modules 符号链接。

安装完成后 重启 DeepSeek Harness(或页面按 Cmd+R 刷新),侧边栏底部「设置」上方即出现额度卡片。

自定义 profile 名 / 卸载:

bash install.sh --profile myprofile     # 安装到指定 profile
bash install.sh --uninstall             # 卸载(移除文件、声明与符号链接)

方式 B:手动安装(等价)

  1. 把 lib/、package.json、cordis.patch.yml 复制到 ~/.dsh/profiles/web/vendor/dsh-deepseek-quota/;
  2. 编辑 ~/.dsh/profiles/web/package.json:
    • dependencies 增加 "dsh-deepseek-quota": "file:./vendor/dsh-deepseek-quota";
    • dsh.profile.bundles 追加 "dsh-deepseek-quota";
  3. 建立符号链接:ln -s "$PWD/vendor/dsh-deepseek-quota" ~/.dsh/profiles/web/node_modules/dsh-deepseek-quota;
  4. 重启 DSH。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev DeepSeek-Harness-Token-Free 下一个 Next dsh-peak-gate →