dsh-dsbal

English

极简的 DeepSeek API 余额显示插件：只在 DSH Web 侧边栏显示一个数字，不做别的事。

• 侧边栏底部设置按钮上方显示人民币余额（左侧钱包图标，右侧 ¥xx.xx），与设置按钮对齐。
• 30 秒自动刷新；点击按钮立即手动刷新并重置自动周期。
• hover 弹出功能说明卡：余额告警阈值说明（< 50 黄 / < 30 橙 / < 10 红 → 按钮虚线边框）、峰谷计费规则（两行：高峰/低谷时段）、合并的刷新规则与刷新时间（一行）。
• 峰谷定价提示：时段按北京时间定义（高峰 09:00-12:00、14:00-18:00，其余为低谷；自 2026-08-23 起周六/周日全天按低谷）。余额右侧显示空心 badge——高峰为红色「梁文峰」、低谷为 DeepSeek 品牌蓝「梁文谷」（badge 右对齐，宽度不超过侧边栏）。
• 余额不足告警：< 10 红色、< 30 橙色、< 50 黄色、≥ 50 正常（按钮加对应颜色的虚线边框；橙、黄两色做了视觉区分）。
• 跟随界面语言：全部文本随 DSH 语言设置（zh / en）动态切换。

安装

直接从 GitHub 安装（当前推荐方式）：

dsh plugin --profile web add github:flyingfishzxf/dsh-dsbal

或者发布到 npm 后：

dsh plugin --profile web add dsh-dsbal

本地开发时也可以从本地路径安装：

dsh plugin --profile web add file:/path/to/dsh-dsbal

安装后需要重启 dsh web 并强制刷新浏览器，新的 bundle 才会生效。

工作原理

• 宿主端注册 dsBalance Remote 服务：fetch 通过凭据通道解析 DeepSeek API Key（默认 DEEPSEEK_API_KEY），经 shell 调用 GET {baseURL}/user/balance（web.fetch 无法携带 Authorization 头）：
  • POSIX：curl，使用 ${DEEPSEEK_API_KEY} 展开。
  • Windows：node -e（基于 OpenSSL 的 fetch）。沙箱化的 PowerShell 无法完成任何 schannel TLS（curl 与 .NET 均报 SEC_E_NO_CREDENTIALS），Node 的 fetch 不受影响。该请求显式以非受限方式运行（danger-full-access）：Windows ACL 沙箱在宽工作区部署下会失效（例如从主目录启动 dsh web），否则余额获取会依赖宿主的启动目录。命令是固定的、由插件自身构造（URL 来自设置、密钥来自凭据通道），因此安全；POSIX 保持受限模式。
  • 密钥与 URL 均通过 shell spec 的显式 env 层传递，绝不出现在命令行或日志中。
• 客户端挂载 Remote、渲染侧边栏按钮与 hover 卡片，并负责刷新循环。

配置

与 DeepSeek 模型适配器一致，插件尊重 llm-deepseek 设置段：

• apiKeyEnv — 凭据引用（默认 DEEPSEEK_API_KEY）。
• baseURL — API 基地址（默认 https://api.deepseek.com）。

依赖

• POSIX：宿主需要 curl；Windows：宿主需要 node。
• DSH 凭据中需配置 DeepSeek API Key。

局限

• 只显示 DeepSeek API 余额——即配置的 API Key（默认 DEEPSEEK_API_KEY）对应账户通过 GET /user/balance 查询的余额。不显示其他提供商或其他账户的余额，也无法合并或换算多个账户。
• 只读：仅展示余额，不含充值、密钥管理等操作。
• 刷新间隔固定为 30 秒，不可配置。
• 余额以人民币（CNY）显示（DeepSeek API 以 CNY 报告账户余额）。
• 宿主依赖：POSIX 需要 curl，Windows 需要 node（见"依赖"）。

推送到插件市场

目前尚未收录。插件列表由 awesome-dsh-plugin 维护，每个插件对应一个 YAML 文件。

要收录本插件：

1. 确保仓库满足要求：

   • 创建满 1 天；
   • 提交数 ≥ 10；
   • 在 GitHub 仓库添加 dsh-plugin topic（仓库 Settings → General → Topics，CI 会检查）。

2. Fork awesome-dsh-plugin。

3. 新增 data/plugins/flyingfishzxf__dsh-dsbal.yml：

   url: https://github.com/flyingfishzxf/dsh-dsbal
   name: flyingfishzxf/dsh-dsbal
   category: usage
   description:
     en: 'Shows the DeepSeek API account balance in the DSH Web sidebar with 30s auto-refresh, click-to-refresh, hover details, and low-balance threshold warnings.'
     zh: '在 DSH Web 侧边栏显示 DeepSeek API 账户余额：30 秒自动刷新、点击刷新、悬停查看明细、余额不足阈值告警。'
   

   市场描述只写功能、不带营销词（最高级会被打回）——"极简"定位写在本 README 里，不写进市场条目。

4. 重新生成 README 并与 YAML 一起提交：

   npm ci
   node scripts/generate-readme.mjs
   

5. 发起 Pull Request。

PR 合并后，dshmarket 会自动收录。

许可证

MIT