Choi-Peng/dsh-deepseek-balance ↗★ 1

@choi-p/dsh-deepseek-balance

DeepSeek account balance in the dsh web sidebar footer, with live config hot reload and an editable Settings → Plugins card. 适合需要直观监控 API 余额、设置低额度预警的 DeepSeek 开发者。

패키지
@choi-p/dsh-deepseek-balance
호환성
미검증
Harness peer 범위
>=0.1.0-rc.7 <0.2.0
Cordis peer 범위
>=4.0.1 <5
버전
0.5.2
라이선스
MIT
최근 업데이트
2026. 9. 8.

설치

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Choi-Peng/dsh-deepseek-balance

配置

插件设置遵循 dsh 官方双缝配置模型,均实时生效,无需重启 dsh web

层来源生效方式
默认值schema 内置(cny,两个阈值均为 0)—
base 层(部署方静态配置)插件 bundle 自带 cordis.patch.yml 行内 config(dsh.bundle.patch,安装即自动挂载)dsh web 监听 patch 层(HMR),编辑后自动用新配置重启此 fiber
用户层(运行时设置)设置 → 插件 → Balance Monitor 的保存/重置,经 ctx.settings 持久化到 $DSH_HOME/settings.yaml;重置 = 清空用户层回落 basesettings 服务热发布,立即生效;本插件不再改写 cordis.patch.yml

base 层 config(bundle 默认附带):

- insert:
    - id: deepseek-balance
      name: '@choi-p/dsh-deepseek-balance'
      config:
        displayCurrency: cny   # cny = 仅 CNY | usd = 仅 USD | both = 同时显示(默认 cny)
        warningThresholdCny: 0 # CNY 预警阈值(0 = 禁用);低于显示红色,低于其两倍显示黄色
        warningThresholdUsd: 0 # USD 预警阈值(0 = 禁用);低于显示红色,低于其两倍显示黄色

卡片暴露 displayCurrency(下拉框:仅 CNY / 仅 USD / CNY 和 USD)以及两个告警阈值(数字输入框),并提供 保存 / 恢复默认值;保存采用 revision 乐观并发,若配置已在别处修改会提示并加载最新值;侧边栏余额展示每 60 秒轮询刷新。预警规则:余额 ≤ 阈值显示红色,≤ 阈值的两倍显示黄色,阈值为 0 时不预警。

API 密钥从 DEEPSEEK_API_KEY 环境变量读取;密钥仅由 host 端持有并以 Bearer 方式随请求发送,不会下发到浏览器。

余额 API 会返回账户的全部币种余额(通常为 CNY 与 USD);侧边栏按 displayCurrency 设置显示对应币种。

使用

  1. 在环境变量中设置 DEEPSEEK_API_KEY 后启动 dsh web —— 侧边栏底部、Settings 上方会显示余额读数,每 60 秒自动刷新。
  2. 设置 → 插件 → 余额监控 卡片:选择要显示的币种并设置预警阈值,然后保存。所有修改实时生效,无需重启 dsh web。