133563825as-ai/dsh-api-dashboard

dsh-api-dashboard · 哦鲸鲸

npm
license

开源（MIT）的 DeepSeek Harness 专用插件：多平台 API 余额 / 用量看板 —— 在 Web GUI 输入框下方实时显示各平台余额与本会话估算消耗。

⚠️ 安装或维护本插件之前，请先读 AGENTS.md —— 数据准确性红线、踩过的坑、安装姿势对照都在那里。
本插件深度绑定 DeepSeek Harness 的客户端与宿主 API，只能在 DSH 里运行（手机版 DSHA 与桌面版同框架）。

界面预览

余额条常驻在输入框下方；会话里有子代理时，下面会多一行可横滑的消耗胶囊（顺序 = 创建顺序，长按看详情）。

| 看板（点余额条打开） | 大肥鱼挂件（可拖拽 / 吸附边缘） |
|:---:|:---:|
|  |  |
| 设置 · 基础 | 设置 · 大肥鱼 |
|  |  |

功能

- 三层 UI：状态条（输入框下方）→ 看板抽屉（点状态条）→ 平台详情（点卡片 ⓘ）
- 峰谷趣味计费：DeepSeek 工作日 9:00-12:00 / 14:00-18:00 显示 ☀️ 梁文峰，其余时间与周末 🌙 梁文谷（半价）
- 三色阈值灯：绿 / 黄 / 红，阈值可自定义；余额首次跌破预警线自动推送通知
- 会话消耗估算：按模型单价折算；混合币种两段显示 ~¥3.40+$12.50，不做汇率折算合并
- 子代理消耗：子代理单独成行、可横滑，长按看完整详情
- 大肥鱼挂件（可选）：屏幕边缘一只可拖拽的互动挂件，纯娱乐，不显示任何金额
- 自定义接入：中转站自动探测余额接口；自建接口支持点分路径手动映射
- 配置持久化：阈值 / 币种 / 刷新间隔（1~60 秒）/ 自定义条目都存本地状态文件，重启不丢
- 一键自更新：设置面板内检查并安装新版本（下载 → 校验 → 备份 → 替换 → 失败回滚）

支持平台

| 分组 | 平台 |
|---|---|
| 国内 | DeepSeek、智谱 GLM、Kimi、阶跃星辰、硅基流动、MiniMax |
| 海外 | OpenRouter、Novita AI、xAI Grok |
| 其他 | 自定义中转站（自动探测余额接口）、自定义模型（手动映射） |

OpenAI / Claude / Gemini / Groq / Mistral / Together 等未开放余额查询接口，面板会如实显示「未开放」，
不会伪造数字。智谱按量付费账户同样没有公开余额接口（显示中性「未开放」，不标红）。

安装

手机版 DSHA（Android）—— 实测可用，照抄即可

1. 下载源码
curl -L "https://codeload.github.com/133563825as-ai/dsh-api-dashboard/tar.gz/refs/heads/main" \
-o /tmp/dsh-api-dashboard.tar.gz

2. 解压到固定位置（--strip-components=1 必须带）
rm -rf /root/dsha-api-dashboard && mkdir -p /root/dsha-api-dashboard
tar xzf /tmp/dsh-api-dashboard.tar.gz -C /root/dsha-api-dashboard --strip-components=1

3. 建 node_modules 软链 —— 这一步不能省（插件的 peer 依赖由宿主 DSH 提供）
ln -sfn /usr/local/lib/node_modules/@deepseek-ai/dsh/node_modules /root/dsha-api-dashboard/node_modules

4. 用 link: 装进 web profile（文件保持真实路径，客户端 UI 才能被框架找到）
dsh plugin --profile web add link:/root/dsha-api-dashboard

5. 重启 dsh web

仓库根目录的 install.sh 把上面 5 步做完了：sh install.sh。

桌面版同理（路径换成你自己的）。npm 一行命令 dsh plugin --profile web add dsh-api-dashboard
在桌面版通常可用，但在手机版 DSHA 上装完客户端 UI 不会出现 —— 原因与逐条实测对照见
AGENTS.md。

升级

1. 插件设置面板 →「检查更新」→「一键自更新」，重启 dsh web 生效；
2. 或重跑上面第 1、2 步覆盖源码目录后重启；
3. 或 dsh plugin --profile web remove dsh-api-dashboard 后重新安装。

配置
在设置面板里调即可（保存后写入 ~/.dsh/dsh-api-dashboard.json）。
也可以直接写 cordis.patch.yml：

- id: dsh-api-dashboard
config:
safeThreshold: 50        # 绿色阈值
warnThreshold: 10        # 黄色阈值（低于它变红）
currency: CNY            # 主计价货币
overseasCurrency: USD    # 海外模型计价：follow | USD | CNY
refreshIntervalMs: 300000
clientPollIntervalMs: 30000
timeoutMs: 8000

API Key 自动读取，无需写进配置：先查环境变量（DEEPSEEK_API_KEY / ZHIPU_API_KEY / MOONSHOT_API_KEY /
STEPFUN_API_KEY / SILICONFLOW_API_KEY / MINIMAX_API_KEY / OPENROUTER_API_KEY / NOVITA_API_KEY / XAI_API_KEY），
再查 DSH 凭证系统 ~/.dsh/.credentials.yaml。

官方直连 / 中转站判定

状态条显示的是「官方余额」还是「—（中转站无余额接口）」，按三层判定，优先级从高到低：

1. 用户显式名单 —— 设置面板「官方直连 provider」，写进去的一律按官方；
2. baseURL 域名 —— 服务端读 settings.yaml 的 provider baseURL，按域名比对官方端点白名单；没写 baseURL 的不表态；
3. 命名约定 —— 带 -official / _official 后缀的按官方。

三层都不命中默认按中转站处理（宁可不显示，也不显示错的余额）。设置面板会列出当前的自动判定结果。

安全

- API Key 只从环境变量 / DSH 凭证系统读取，不写进代码或仓库；
- /api-dashboard/config 返回的 Key 一律 **；浏览器端只请求同源接口，不向第三方域名发数据；
- 本地状态文件含自定义条目的 Key，权限 0600，被 .gitignore 排除；
- 自定义模型 / 中转站的 Key 会发往你自己填的接口地址，请只填信任的服务；
- v1.4.1 起插件路由带鉴权闸门（无 cookie → 401，跨域 → 403）。

开发

- 服务端 src/index.js（ESM，零依赖、零构建）；客户端 client/client.js（改完需重启 dsh web）
- 测试：for f in test/.mjs; do node "$f"; done（退出码非 0 即失败）
- 改动红线、踩坑记录、发布流程：AGENTS.md、docs/RELEASING.md

更新日志

最近一版 v1.4.4 —— 子代理胶囊只显示它自己新产生的消耗（不再把父会话继承来的历史、兄弟或后代子代理的消耗算进去）；并恢复 v1.4.3 升级后误显示为 ~— 的历史子代理行。一版一行的完整历史见 CHANGELOG.md。

License

MIT —— 见 LICENSE。大肥鱼互动挂件移植自
MeteorNOX/DeepSeek-Balance-Whale-Widget（MIT），
许可副本见 assets/whale/LICENSE-whale-widget.txt。