DSH Plugins Marketplace

DSH Plugins

Plugins

/

Tools & Capabilities

/

dsh-balance-sentinel

d

dsh-balance-sentinel

Manifest valid

DeepSeek balance monitoring, low balance alerts pushed to Feishu/DingTalk; reminders stop after DSH is disabled.

UI (client)hasBundlePatch

dsh-balance-sentinel | 余额哨兵 · DeepSeek 余额告警

中文 | English

npm version npm downloads CI release license DSH

DSH 插件:DeepSeek 余额监控 + 低余额两级告警推送到飞书/钉钉等 IM + 支持宿主账号免填 Key、零运行时依赖

先看三行

  • DSH 运行期间监控,关闭即停;不支持远程 Web 面板
  • 余额低于阈值自动推送到飞书/钉钉,充值或调阈值后推一条「恢复/解除」
  • 面板里粘 webhook → 保存并发送测试,保存即生效;装完只需重启一次

装完就是这样(面板)与真实告警(飞书卡片:告急红 / 预警橙 / 恢复绿):

面板:余额 + 阈值 + 通道低余额告警推送
余额哨兵面板:官方余额、告警阈值、推送配置飞书低余额告警卡片

安装

要求:DSH ≥ 0.2.1-rc.2、Node ≥ 18。

# GitHub 仓库直装(任何时候都可用,推荐先用这条)
dsh plugin --profile web add github:liancheng2020/dsh-balance-sentinel
# 或 npm(随 Release 一同发布到 npm)
dsh plugin --profile web add dsh-balance-sentinel
# 或 Release 固定版本 tarball
dsh plugin --profile web add https://github.com/liancheng2020/dsh-balance-sentinel/releases/download/v0.1.3/dsh-balance-sentinel-0.1.3.tgz

三条任选一条即可;若 npm/Release 那条还没上线,用第一条。桌面端:设置 → 插件 → 添加插件,填 dsh-balance-sentinel 或 github:liancheng2020/dsh-balance-sentinel。装完重启一次 DSH。

适用环境:仅本机 DSH Desktop/本机 Web,监控跑在 DSH 进程里、退出即停(重开从本机状态继续);不支持远程 Web 面板(桥接只绑 127.0.0.1:17430,只接受本机页面)。支持宿主账号免填 Key:宿主内置账号服务且已登录(免填 ≠ 无需账户),否则用 DEEPSEEK_API_KEY 或 balance.apiKey,都没有时面板给出明确原因。

当前版本 0.1.3(见 CHANGELOG)。

首次使用(两步接通)

  1. 打开 余额哨兵 面板:立刻看到真实余额,或明确原因(未登录 / 无账号服务 / 网络…)。
  2. 「推送配置」选通道 → 粘 webhook(自动识别)→ 保存并发送测试。飞书/钉钉框内有「如何获取机器人 Webhook」:官方链接 + 三步路径 + 该通道适用的安全设置。没配通道前只监控不推送。

保存成功只说明通道「已配置,待测试」,测试推送真的送达才会变成「最近测试成功」;失败则显示「最近测试失败」并附原因与时间。改通道或凭据后旧结果立即清除,不会有残留的「已验证」冒充接通。

接通时余额已低于阈值,会补发一条当前状态(仅一次)。

它怎么工作

  • 两级阈值:默认低于 ¥20 推「预警」、低于 ¥5 推「告急」(账户币种,面板可改);充值或调阈值回到预警之上推一条「恢复/解除」,保存即生效。
  • 不刷屏:同级停留不重推;充值回升推「恢复」(10 分钟冷却防抖),调阈值解除已送达告警立即推「解除」;告警未送达时静默取消;免打扰时段顺延、出窗合并成一条。
  • 失败可追踪、可重试:待发送告警持久化;业务失败 10 分钟退避、3 次后挂起可手动重试;超时等「送达不确定」立即挂起、不自动重发;状态保存失败时落盘备用回执,重启/多实例恢复后仍不重发(不确定的恢复为挂起,不标记成功)。状态与回执都无法落盘时会明确告警「去重无法保证」。
  • 不卡死、多实例不重推:宿主查询 15s 兜底,任何异常后调度继续;desktop + web 共享 DSH_HOME 时整周期锁 + 磁盘合并,同一跃迁只推一次。
  • 通道:企微 / 钉钉 / 飞书(消息卡片)/ Bark / Server酱 / Telegram / 通用 Webhook;超长自动分条;HTTP 200 但业务失败同样判失败。
  • 跟随宿主深浅色:面板读 data-ds-dark-theme,浅色皮肤用白卡片+细描边+轻投影,卡片、徽章、浮层与原生下拉菜单同步换色。
  • 余额来自官方账户同源,v1 不做成本估算。

配置(可选,profile 的 cordis.patch.yml)

- id: balance-sentinel
  name: dsh-balance-sentinel
  config:
    balance:
      enabled: true                # 关掉即停监控,面板仅展示
      pollSeconds: 60              # 最小 60
      warn: 20                     # 预警阈值(账户币种)
      critical: 5                  # 告急阈值
      timezone: Asia/Shanghai
      quiet: { start: "", end: "" }  # 免打扰,如 "23:00"–"08:00"
      apiKey: ""                   # 仅老宿主回落用;优先宿主账号/环境变量
    notify:
      signature: true              # 推送尾部署名(安装标识可点击),可关
      signatureText: ""
    localApi:
      enabled: true                # 面板桥接 127.0.0.1:17430,可关

阈值与通道也可在面板里改,保存即生效,无需重启。

隐私与合规

  • 状态与 webhook 仅存本机 $DSH_HOME/balance-sentinel/(目录 0700),不上传、默认无遥测。
  • 本地桥接只绑 127.0.0.1、拒绝跨站来源,且不暴露 webhook url/secret;余额查询走宿主账号服务或官方 /user/balance,60s+ 间隔、失败退避。代码 MIT。

反馈

装不上或推送不通,请带 DSH 版本 / 插件版本 / 系统 / 报错原文到 Issues。

本地验证:node scripts/selftest.mjs、node scripts/selftest-client.mjs、node scripts/verify-dedup.mjs、node scripts/verify-market.mjs(纯 node、零依赖)。

同作者另一插件:AIHOT 雷达(额度重置监控 + AI 资讯日报)。

Versions

Latest versionPublishedSize
0.1.3——

Comments

Loading…

Similar plugins

dsh-ds-balance

by zlZayn

DSH 插件:在左侧栏底部显示 DeepSeek 账户余额(原生 UI),设置页提供连接、展示币种、预警阈值与刷新节奏的配置卡片。(原生嵌入“设置-插件-插件配置”)

Tools & CapabilitiesDevelopment & InfrastructureManifest valid

★ 2

↓ 362/wk

MIT

TypeScript

Sep 19, 2026

dsh plugin --profile web add dsh-ds-balance

by etony668

DeepSeek API 余额常驻显示(侧边栏「设置」旁)· DeepSeek API balance badge beside Settings in the DSH sidebar

Tools & CapabilitiesDevelopment & InfrastructureTerminal & ClientsManifest valid

★ 0

MIT

JavaScript

Oct 17, 2026

dsh plugin --profile web add @etony668/dsh-balance

by Anyway-one

Multi-provider balance monitor with low-balance alerts and trend history for the dsh web GUI

Terminal & ClientsManifest valid

★ 0

JavaScript

Aug 26, 2026

dsh plugin --profile web add dsh-balance

by zeenhuang9-boop

DSH 侧栏底部的 DeepSeek 余额纯文本读数:余额/今日已用/峰谷倒计时/每轮消耗/余额预警,真嵌入侧栏 footer。

Tools & CapabilitiesManifest valid

★ 0

MIT

JavaScript

Nov 1, 2026

dsh plugin --profile web add dsh-balance-plain

by hnmrxz

在 DeepSeek Harness (dsh) 底部状态栏实时显示 DeepSeek 账户余额。

Manifest valid

★ 4

MIT

JavaScript

Aug 15, 2026

dsh plugin --profile web add dsh-plugin-deepseek-balance

by wangxiang0605qvq

DSH 侧边栏实时 DeepSeek 账户余额插件(走账号登录,无需 API Key) | Live DeepSeek account balance in the DSH sidebar

Manifest valid

★ 0

MIT

JavaScript

Sep 29, 2026

dsh plugin --profile web add @deepseek-ai/dsh-deepseek-balance