npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

dsh-api-dashboard

v1.7.2

Published

DeepSeek Harness 多平台 API 余额 / 用量看板:输入框下方实时显示各平台余额与本会话估算消耗

Readme

dsh-api-dashboard · 哦鲸鲸

npm license

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

手机、平板和电脑浏览器共用一个 Web 插件。

| 场景 | 形态 | |---|---| | Android DSHA / 手机 | 输入框下余额胶囊、底部看板、单击子代理详情 | | 平板 | 居中面板,设置与看板内部滚动 | | 电脑浏览器 | 居中对话框、桌面两列卡片,鼠标操作 |

**兼容说明:**本轮实际验收为 DSH 0.2.0-rc.2、Node 24、Android DSHA Web;保留 0.1.x 声明范围,但旧宿主、各桌面系统未做本轮完整真机验收。电脑端这里指 Web GUI 的响应式布局,不能等同官方 Desktop profile 已完整验证。

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

界面预览

余额条常驻在输入框下方;会话里有子代理时,下面会多一行可横滑的消耗胶囊(顺序 = 创建顺序,单击看详情;可关闭并移到看板分区)。

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

功能

  • 三层 UI:状态条(输入框下方)→ 看板抽屉(点状态条)→ 平台详情(点卡片 ⓘ)
  • 峰谷趣味计费:DeepSeek 工作日 9:00-12:00 / 14:00-18:00 显示 ☀️ 梁文峰,其余时间与周末 🌙 梁文谷(半价)
  • 三色阈值灯:绿 / 黄 / 红,阈值可自定义;余额首次跌破预警线自动推送通知
  • 一键去充值:平台详情里直接打开该平台的开放平台 / 充值页。手机版走宿主桥调系统浏览器 (GUI 在 webview 里,window.open 开不出外部浏览器),桌面 / 浏览器回退新标签页
  • 会话消耗估算:按模型单价折算;混合币种两段显示 ~¥3.40+$12.50,不做汇率折算合并
  • 子代理消耗:子代理单独成行、可横滑,单击查看分行详情;关闭胶囊后移到看板分区
  • 大肥鱼挂件(可选):屏幕边缘一只可拖拽的互动挂件,纯娱乐,不显示任何金额
  • 自定义接入:中转站自动探测余额接口;自建接口支持点分路径手动映射
  • 配置持久化:阈值 / 币种 / 刷新间隔(1~60 秒)/ 自定义条目都存本地状态文件,重启不丢
  • 一键自更新:设置面板内检查并安装新版本(下载 → 校验 → 备份 → 替换 → 失败回滚)

支持平台

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

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

安装

**Android DSHA 新用户推荐:**在 GitHub 正式 Release下载 .tgz,通过 DSHA 原生插件管理器导入,然后重启 Web GUI。1.7.0 已在当前 DSHA 以归档导入方式验收;不需要手动复制 Key。

电脑 Web profile:dsh plugin --profile web add dsh-api-dashboard,然后重启 dsh web。手机裸 npm 安装可能遇到的布局问题见下面的旧版源码安装说明,不把桌面命令当成手机通用保证。

手机版 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,零构建;semver 用于严格更新兼容校验);客户端 client/client.js(改完需重启 dsh web)
  • 测试:for f in test/*.mjs; do node "$f"; done(退出码非 0 即失败)
  • 改动红线、踩坑记录、发布流程:AGENTS.md、docs/RELEASING.md

更新日志

v1.7.0:适配 DSH 0.2.0-rc.2,保留已声明的 0.1.x 范围。检查更新会弹出发布摘要、适配对象、版本范围和当前 DSH 兼容结果;不兼容或声明缺失时禁止一键安装,安装前服务端再次校验。正式频道只跟 GitHub 已发布正式 Release。另修复冷子代理缓存、fork 今日重复计费、轮询卸载竞态、慢响应体超时及鉴权异常放行。同轮补充:子代理显示开关(关闭后移到看板分区)、单击详情、宿主主题完整适配、胶囊上移,以及浮层/输入框位移通道和大肥鱼大小持久化修复;支持官方 DeepSeek 配置凭据引用。继续手动维护价格表;补入六个近期 GPT / Claude 模型的标准档参考价,来源和长上下文/服务档位限制见 价格复核。部署后需重启 Web GUI。

最近一版 v1.6.9 —— 🔢 设置里的数字框能删干净了:旧写法在输入时当场夹取,而 Number("") === 0 会把"删空"立刻回填成 0,于是必须先写新数字才能删掉旧的;现在输入期只留数字、失焦/保存才夹取,空串也不再静默变成 0(那等于悄悄关掉「重复提醒」和「今日花销提醒」)。同时把「发送测试提醒显示失败」分诊开:接口没打到(插件文件已更新、dsh 还没重启 → 服务端仍是旧版本,路由不存在)会明说,不再一律报"发送失败"把人带往系统通知设置。

上一版 v1.5.0 —— 🐋 大肥鱼挂件音效引擎重做(换成 Web Audio:预解码 + 同步起播 + 松手音 40ms 衔接,避开 macOS Touch Bar 播放条与「网络层拦请求导致静默无声」,保留 media element 回退)+ 音效组 2 → 4 组;并把桌面 / 平板适配并入主线(原 preview/desktop 分支:三档形态 —— 手机全宽 / 平板居中面板 / 桌面居中对话框、桌面档面板 720px + 卡片两列、role="dialog" 无障碍、宿主侧栏竖线抑制),统一为同一个正式版。(换成 Web Audio:预解码 + 同步起播 + 松手音 40ms 衔接,避开 macOS Touch Bar 播放条与「网络层拦请求导致静默无声」,并保留 media element 回退)+ 音效组 2 → 4 组。

上一版 v1.4.6 —— 修 issue #2 的三个问题:余额低于预警线不再叫「异常」(查询正常但金额低 → 「不足」,真故障才叫「异常」)、标题与卡片口径统一(都走阈值分级,另补「需关注」汇总)、余额告警改走 DSHA App 桥(旧的两条通知通道在 DSH ≥ 0.1.5 上都不存在,告警一直被静默吞掉;现在拿不到通道也会在 /api-dashboard/alerts 里明示,可做可见降级);并适配 DSH 0.1.7 的 provider 配置新位置(段落已迁进 profile 的 cordis.patch.yml),判定改为白名单制——拿域名(provider 自己写的 baseURL,或 DSH 内置目录给的默认地址)比对官方白名单,命中才算官方,其余一律按中转站;「官方但官方没开放余额接口」的那类不再被错分成中转站。上一版 v1.4.5 —— 消耗估算口径三处修正:峰谷改按「事件发生时刻」计价(旧实现按「打开面板那一刻」,谷时跑的量在峰时查看会被翻倍)、法定节假日全天算谷时、缓存写入按官方 ×125% 单独计价;同时把十一家厂商的价格表逐条对官方原文重核,并补录 40+ 条新模型(GPT-6 Astra、Claude Fable 5.1、GLM-5.3-FlashX、MiniMax-M3、Gemini 3.5 Flash、Grok 4.7 / 4.6、MiMo V2.6 等);另修「点设置抽搐一下」与刷新间隔 300 秒两处交互根因。一版一行的完整历史见 CHANGELOG.md。

分发与权限

市场收录、兼容证据和权限披露。插件会读取已有凭据、请求余额 API、写本地状态;自更新会备份并替换本插件目录,不能标为“无网络/无文件/无凭据访问”。截图展示基础功能,1.7.0 新交互以更新说明为准。

如果它解决了你的余额或用量查看问题,欢迎 Star;遇到安装问题请在 Issues 提供 DSH/插件版本和错误文字,不要粘贴 API Key。

License

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