deepseekplugins

DeepSeek Harness plugin

dsh-deepseek-balance-stelligh

DeepSeek Harness plugin: real-time DeepSeek account balance widget with official top-up entry

Usage & Billing
Jump to install

Source facts

Repository
Stellight/dsh-deepseek-balance
Latest update
Aug 20, 2026
Category
Usage & Billing
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and 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 review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/Stellight/dsh-deepseek-balance
Plugin: dsh-deepseek-balance-stelligh
Author: Stellight

Check the source files

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

File explorer3 files
README.mdSource · read only

dsh-deepseek-balance

DeepSeek Harness 静态 dual-face 插件：在页面内实时显示 DeepSeek 账户余额，并提供官方充值入口。

!dsh-plugin

功能

  • 实时余额：调用官方接口 api.deepseek.com/user/balance，展示可用总额 / 充值余额 / 赠送余额（支持多币种 CNY/USD）；
  • 自动刷新：每 60 秒自动刷新，支持手动「立即刷新」，状态灯（绿/黄/红）与「更新于 HH:MM:SS」时间戳；
  • 官方充值：「官方充值 ↗」一键直达 DeepSeek 官方充值页 platform.deepseek.com/top_up（新标签页），附 API Key 创建入口；
  • 嵌入式 UI：显示在左侧边栏底部、Cordis Plugin 选项上方（sidebar.footer.action 插槽），随明暗主题自适应；侧边栏收起（rail）时显示金额图标；
  • 密钥管理：支持手动输入 / 更换 / 清除 API Key，界面只显示掩码（sk-···xxxx）。

架构（dual-face，无构建步骤）

文件半区说明
dsh/index.jsHostESM 插件：Node 原生 fetch 调用官方余额接口；在本地 dsh web 服务器上注册同源 HTTP 路由（/dsh-balance/config、/dsh-balance/key、/dsh-balance/key/clear、/dsh-balance/fetch、/dsh-balance/topup）供浏览器半区调用
dsh/client.jsClient手写 lazy-CJS bundle（window.__ModuleLoader__.load 协议，与内置 client 插件同格式）：React UI、主题 token 样式、静默重试连接宿主

客户端与宿主的通信走同源 HTTP 路由（页面由 dsh 的本地 web 服务器提供），不依赖动态插件专属的 host.call 机制。

安全说明

  • 仓库代码中不包含任何 API Key。密钥按以下顺序从运行时获取：

1. 会话内存（用户在面板中输入的密钥）； 2. 进程环境变量 DEEPSEEK_API_KEY（同步快路径，避免启动期拥塞）； 3. DSH 凭证库 ref DEEPSEEK_BALANCE_API_KEY（~/.dsh/.credentials.yaml）。

  • 密钥仅在本机进程内用于调用官方余额接口，不出网、不落盘。

安装（dsh profile 插件）

本包通过 dsh 的 profile bundle 机制持久挂载（与 modlens 等外置插件同机制；注意：直接写 profile 的 cordis.patch.yml 插入行会在启动时被消费清空、重启后丢失，请使用下面的 bundle 方式）：

1. 找到你的 dsh profile 目录（默认 ~/.dsh/profiles/web/）； 2. 把本包放入 profile 的 node_modules： - 方式 A：在 profile 目录内执行 npm install dsh-deepseek-balance； - 方式 B：手动复制本包到 ~/.dsh/profiles/web/node_modules/dsh-deepseek-balance/； 3. 编辑 profile 的 package.json，加入依赖与 bundle 条目： ``json { "dependencies": { "dsh-deepseek-balance": "1.1.1" }, "dsh": { "profile": { "bundles": [ "dsh-deepseek-balance" ] } } } ` （包内的 cordis.patch.yml 作为 bundle 自举补丁在每次启动时自动应用，不会被消费。） 4. 重启 harness（dsh web`）。卡片自动出现在左侧边栏底部，无需批准、无需每次重装。

版本历史

  • 1.1.1 — 持久挂载修复：改为 profile bundle 机制（依赖 + bundles 列表 + 包内自举补丁），重启不再丢失；
  • 1.1.0 — 静态 dual-face 重构：Node 原生 fetch + 同源 HTTP 路由（不再依赖 shell/curl）；嵌入式侧边栏卡片置顶（Cordis Plugin 上方）；
  • 1.0.x — 动态 Cordis 插件原型（cordis_define + cordis_run，见 git 历史）。

License

[MIT](LICENSE)

Back to searchOpen GitHub repository

More related plugins

View category