dsh-whale-balance

DeepSeek Harness (DSH) 插件 — 点击左上角小鲸鱼 logo，弹出「模型 API · 余额 / 价格 / 用量」面板，打开期间每 60 秒自动刷新。

EN: A DSH web plugin that turns the sidebar whale logo into a launcher for an API balance / pricing / usage panel with 60s auto-refresh.

预览截图待补充。面板功能见下方「支持的渠道与数据源」。

功能

• 🐋 一键打开：点击侧栏顶部小鲸鱼即弹出面板（捕获阶段拦截，不影响其他点击行为）
• 💰 余额查询：逐渠道调用各平台官方 HTTP API，大数字展示可用余额
• 🏷️ 价格表：内置参考价（标注日期与来源）+ OpenRouter 实时价动态拉取
• 📈 用量：OpenRouter 已用/额度、one-api 系中转站近 90 天用量
• 🗂️ 按请求地址分组：baseURL 相同的渠道自动归组（如同一网关下的多个渠道），查不到余额的组排在最后
• 🔗 跳转查询页：每组头部「↗ 余额 / 控制台」直达该平台的网页查询入口（新标签）
• 🔐 密钥安全：密钥只在宿主进程内解析（环境变量优先，其次 $DSH_HOME/.credentials.yaml），任何完整密钥都不会发往前端，面板仅显示尾 4 位掩码
• 🎨 主题自适配：全部样式基于 --dsw-alias-* 变量，深浅主题自动跟随

支持的渠道与数据源

渠道类型	余额	用量	价格
DeepSeek 官方	✅ /user/balance	—	内置表
Moonshot（Kimi）	✅ /v1/users/me/balance（支持欠费负数显示）	—	内置表
OpenRouter	✅ /api/v1/key（已用 / 限额）	✅	实时拉取 /api/v1/models
one-api / new-api 系中转	✅ billing/subscription + usage 探测，失败再试 api/usage/token	✅ 近 90 天	—
智谱 GLM / Qwen Token 计划	❌ 平台无 API（如实标注并给控制台链接）	—	内置表

内置价格表截至发布时点，来源见面板底部标注；请以各官网为准。未确认的价格不入表（显示 —），宁缺毋错。

安装

# 方式一：dsh CLI（推荐）
dsh plugin --profile web add github:Nothree-code/dsh-whale-balance

# 方式二：手动 pnpm
cd %DSH_HOME%\profiles\web
pnpm add github:Nothree-code/dsh-whale-balance

安装后重启 dsh web 生效（nssm restart dsh-web 或你的启动方式）。

工作原理

lib/index.js   Host 半  inject: [webServer, settings, fs, llm]
               → 注册 GET /whale-balance-data
               → 枚举 settings 里的全部 LLM provider（含 deepseek-official）
               → 解析凭据（env 优先 → .credentials.yaml）→ 并发调官方 API
               → 45s 结果缓存；OpenRouter 模型价 10min 缓存

lib/client.js  Client 半  inject: [slots]
               → 捕获阶段拦截侧栏品牌按钮点击（替换默认「新建会话」）
               → shell.overlay slot 渲染 React 面板（portal-free，随宿主主题）
               → 60s 自动刷新（面板打开期间）；分组 / 排序 / 链接渲染

修改了 lib/*.js 之后需要同步到 node_modules 的实体拷贝并重启 dsh web（可运行 sync.ps1）。

私有渠道的查询链接

公开平台（DeepSeek / Moonshot / OpenRouter / 智谱 / 百炼）的查询页已内置。自建网关或私有中转的查询页请在本机 %DSH_HOME%\settings.yaml 配置（该文件不属于任何代码仓库，不会泄露）：

whale-balance:
  consoleUrls:
    your-gateway.example.com: https://your-gateway-console.example.com

键为该渠道的请求地址（host 或完整 baseURL），值为查询页 URL。插件不内置任何私有地址。

隐私与安全

• 不收集、不上传任何数据；所有 API 请求从你的机器直达各平台
• 路由带同源校验（Origin / Sec-Fetch-Site），防外站调用
• 完整密钥永不进入前端响应体（自动化校验过：正则断言无 sk-... 泄露）

License

MIT © 2026 Nothree-code