linshule/dsh-balance

README 摘要

dsh-balance DeepSeek API 账户余额实时显示插件（dsh web GUI 常驻插件） 界面预览（示意渲染） 功能 - 左侧边栏左下角悬浮余额徽章， 可拖拽 调整位置（位置记忆在浏览器 localStorage，默认位于设置按钮上方） - 状态圆点实时反映：🟢 可用 / 🔴 不可用或出错 / ⚪ 未配置 - 点击徽章弹出详情气泡：多币种余额（总余额 / 充值 / 赠金）、可用状态、上次更新时间、立即刷新；未配置 Key 时可内联粘贴保存 - 自动刷新：30 秒 / 1 分钟 / 5 分钟可调（默认 1 分钟） - 设置 → 「DeepSeek 余额」页：API Key 管理（保存 / 清除）、刷新间隔、余额明细 - API Key 持久化在 /.dsh/ds-balance.json （仅本机，重启不丢失） - 网络抖动自愈：curl 走 HTTP/1.1 + 自动重试 3 次（规避 Windows schannel 的瞬时断连 56 错误） 架构 - Host （ lib/index.js ）：经 subprocess 调 curl.exe 请求 DeepSeek 官方余额接口 GET https://api.deepseek.com/user/balance （携带 Authorization: Bearer ）； 提供 /api/ds-balance/status balance key 路由（仅回环地址可访问） - Client （ lib/client.js ）： window. ModuleLoader 模块，注册 shell.overlay 徽章与 settings.section 设置页，同源 fetch 调路由 安装（本地链接） 重启 web 服务生效（插件行由包内 cordis.patch.yml 的 dsh.bundle.patch 声明）。 使用 1. 重启后点击左下角「余额 · 未配置」徽章（或 设置 → DeepSeek 余额） 2. 粘贴你的 sk-... API Key 并保存 —— 持久化到 /.dsh/ds-balance.json ，之后重启无需重填 3. 按住徽章拖动可调整位置（松手自动记忆） API 路由（仅回环） 路由 方法 说明 /api/ds-balance/status GET 是否已配置 Key（含掩码） /api/ds-balance/balance GET 实时查询余额（并发去重） /api/ds-balance/key PUT / DELETE 保存 / 清除 API Key License MIT © 2026 linshule

分类