dsh-api-balance

dsh-api-balance

中文 | English | 日本語 | 偽中国語

API 用量余额插件（DeepSeek Harness）——在 webui 用量圆圈（发送按钮左侧的上下文已用显示）的弹出面板中提供「用量 / 余额」标签切换。

[!NOTE]

由于维护者（狐莉）患有罕见的视网膜色素变性（锥杆营养不良15型）疾病，并经中华人民共和国残疾人联合会认证属于一级视力残疾，暂时无法独立完成 NPM 软件包提交流程，故本仓库暂时不会提供 npm 打包。我们（狐莉与小爪）对此引起的不便表示抱歉，该问题终有一天会得到解决，但十分遗憾可能并不是现在立刻马上。在此之前，辛苦各位使用者通过 GitHub 源码安装（详见文档）。当然，这位用户，可以耽误您一点时间吗嘛？请允许我向您介绍我们声明式和可复现的 NixOS 以及更加符合狐莉美学的 nix flake 安装方案。（乖巧

安装

从 GitHub 源码安装

dsh plugin --profile web add github:Kihara777/dsh-api-balance

包内 dsh.bundle 指向 cordis.patch.yml，安装后即作为 profile 的一个 layer 激活。 卸载：dsh plugin --profile web remove @kihara777/dsh-api-balance。

声明式安装（NixOS）

NixOS 用户可经 NixKits 的 nixkits.dsh 模块声明式安装—— 版本由 Nix 锁定、随系统代际更新、可复现：

{
  nixkits.dsh.plugins.packages = [{
    package = pkgs.dsh-api-balance;
    id = "api-balance";
    name = "@kihara777/dsh-api-balance";
  }];
}

详见完整文档。

功能

• 余额 / 用量面板：webui 用量圆圈弹出面板内的「用量 / 余额」标签切换
• 账户余额：DeepSeek 官方 GET /user/balance（API key 认证）
• 用量明细：当日 / 当月 / 30 日消耗（金额 + token + 分模型明细）与图表
• 平台令牌自动获取：默认从本机浏览器登录态自动扫描，手动连接为回退
• 语音播报：语音包 + TTS（浏览器内置 / 自定义 API），峰谷计费自动提示；音色按界面语言与话的变体自动匹配（请求普通话不会挑到粤语音色），也可在语音设置里直接指定音色
• 界面增强：峰时红色标识、疑问窗口滚动优化、回车换行开关、右上「…」菜单切换全屏等

开发

纯 JS 插件，无构建步骤（lib/index.js + lib/client.js 直接提交）：

npm install --legacy-peer-deps    # 安装依赖（peer 由宿主 dsh 在运行时提供）

代码结构：

文件 · 作用 lib/index.js · host 半部：端点、令牌管理、上游查询 lib/client.js · client 半部：webui 面板与交互 cordis.patch.yml · bundle patch：供 dsh plugin add 注册本插件

许可

安全政策（含已评估的外部报告清单——误报不再重复受理）见 SECURITY.md。 每次修复与更新记在 MAINTENANCE.md（四语）：写「改了什么、为什么、怎么验证的」。