dsh-plugin-deepseek-balance

English | 中文

一个 DeepSeek Harness（dsh）Web 插件：不用打开 DeepSeek 开放平台，直接在会话输入框下方的 token 统计栏里显示本次运行已用的余额和剩余余额。

本次运行已用 ¥0.42 · 余额 ¥10.98

它渲染在原有 token 统计行（517 / 12.2K · 45.2s … 那一行）的正下方。鼠标悬停显示明细（赠送 / 充值 / 更新时间），点击任意处立即刷新。

目录

• 功能特性
• 效果预览
• 工作原理
• 为什么是「本次运行已用」
• 环境要求
• 安装
• 配置
• 使用
• 验证
• 卸载
• 常见问题
• 已知限制
• 开发说明
• 许可证

功能特性

• 零额外配置 —— 直接复用 Harness 已有的 DEEPSEEK_API_KEY 凭据（就是「设置 → 模型」里填的那个），无需单独管理 Key。
• 只走官方接口 —— 读取文档化的 GET https://api.deepseek.com/user/balance 接口，不爬网页、不需要登录态。
• 实时显示 —— 默认每 60 秒轮询；显示位置与内置 token 统计同处一条栏（conversation.composer.dock 插槽），始终和 token 栏在一起。
• 点击刷新 —— 点击该行立即触发一次上游重新查询。
• 隐私安全 —— API Key 从不进入浏览器，浏览器只能读到本机同源路由返回的数字；不写日志、不外发。
• 充值自适应 —— 运行期间充值（余额超过基线）时基线自动抬高，「已用」不会变成负数。