DosterBool/dsh-balance-guard

README 摘要

dsh-balance-guard · API 余额守卫 DeepSeek Harness 插件：在底部状态条（ 1 轮 · 1 步 LLM 3.8s … 那一行）实时显示你的 API 余额（人民币）；余额低于自定义阈值时 暂停模型输出 ，并自动跳转充值页。 功能 - 🪙 状态条余额 ：每 5s 刷新显示 余额 ¥xx.xx （正常绿色 / 低于阈值红色 ⚠） - 💸 本会话花费（自动计费） ： 本会话 -¥x.xx = API 余额减少量，每次刷新自动重算， 无需手动设置价格 ；余额上升（充值）自动校正基线，不会把充值算成花费；token 明细在悬停提示里 - 🛑 暂停输出闸门 ：余额 credentials 服务（ DEEPSEEK API KEY ） 环境变量 - 📑 通用设置页 ：阈值、充值页 URL、闸门开关与「重置本会话计费基线」也同步出现在 设置 → 通用 → 余额守卫 区块，无需在状态条上找 ⚙ 自动计费原理 - 宿主为每个会话维护 {基线余额, 上次余额, 累计花费} ，持久化在 $DSH HOME/balance-guard-usage.json （重启不丢，最多保留最近 100 个会话） - 客户端每 5s 刷新 → 宿主查一次余额（API 调用 10s 节流）→ 结算差额： - 余额下降 → 计入该会话花费 - 余额上升 → 认为是充值，自动抬升基线（花费不变） - 首次见到某会话时以当前余额为基线（花费从 0 开始）；点「重置本会话基线」可重新开始 - 精度 = 余额接口精度（¥0.01）；多个会话同时开着时，差额会记到先刷新的那个会话上 安装 配置（默认值） 项 默认 说明 threshold 10 余额阈值（¥），低于即暂停输出 rechargeUrl https://platform.deepseek.com/top up 充值页 baseUrl https://api.deepseek.com 余额 API base（ GET {base}/user/balance ） enabled true 暂停闸门开关 pollSeconds 60 宿主侧余额轮询周期 运行时修改通过状态条里的 ⚙ 弹窗完成；patch 配置（ cordis.patch.yml ）在重启装配时生效，JSON 文件优先级更高。 安全说明 - 手动填写的 API Key 会以明文存入 $DSH HOME/balance-guard.json （本机单用户工具；介意的话请留空走环境变量/凭据） - /balance-guard/ HTTP 接口永不返回密钥 - 查询失败时保留上次"已确认低余额"判定（fail-closed）；从未确认过低余额时查询失败不暂停（fail-open） 目录结构

分类