DeepSeek Harness (DSH) 的设计理念是「一切皆插件」，这使得开发者可以通过扩展来增强客户端功能。对于开发者来说，实时掌握 DeepSeek 账户的 API 余额是一项基础需求。outprinthelloli/dsh-piggy-bank 旨在解决这一问题，它是一个 DSH Web 插件，通过在页面中挂载一个可拖动的悬浮组件，实时从官方接口获取并展示余额。
插件名为 outprinthelloli/dsh-piggy-bank，由 outprintHelloLi 维护，许可证为 MIT。
核心功能¶
-
悬浮存钱罐
- 组件可拖动位置，显示在页面任意位置。
- 提供 4 种内置透明 PNG 样式：卡通猪、蓝色鲸鱼、黑金龙纹、陶瓷。
- 支持导入外部.svg文件作为自定义样式。 -
余额展示
- 余额数值直接显示在存钱罐上方。
- 文字带有深色背景，保证可读性。 -
自动刷新
- 页面打开时立即查询。
- 任务开始或结束时立即刷新。
- 对话运行期间按设定间隔自动查询（默认 30 秒），仅在页面可见时进行轮询。 -
余额动画
- 查询时存钱罐会有摇晃动作。
- 余额下降时，存钱罐抖动并显示-¥xx.xx（淡入淡出 5 秒）。
- 余额增加时，以金色显示+¥xx.xx。 -
设置界面
- 在 DSH 的设置侧边栏中，可调整「查询时间间隔」（范围 5–600 秒）。
- 可切换存钱罐样式。
- 可添加自定义 SVG。
安装与启用¶
本插件为纯 Node.js 实现，提供一键安装脚本。
使用脚本安装（推荐）：
node scripts/install.mjs
该脚本会自动完成以下步骤：
1. 查找 DSH profile（默认为 web）。
2. 复制插件文件。
3. 在 profile 的 package.json 中登记依赖和 bundle。
4. 执行 pnpm install。
可选参数：
# 安装到其它 profile（例如 headless）
node scripts/install.mjs --profile headless
# 只复制/登记，不执行 pnpm install
node scripts/install.mjs --no-install
使用 DSH 命令安装：
dsh plugin --profile web add dsh-piggy-bank
安装完成后，需重启 dsh web 进程，并在浏览器中硬刷新页面（Windows: Ctrl+Shift+R；macOS: Cmd+Shift+R）以加载新组件。
典型用法¶
安装并启用插件后，在 DSH 客户端页面右上角会出现存钱罐图标。拖动图标可改变其位置。点击图标或查看其上方数值，即可看到当前 DeepSeek 账户余额。
在 DSH 设置侧边栏中，可以配置自动查询的频率。如果希望更实时地监控，可以将间隔调整为较小的值（如 5 秒）；如果希望减少对 API 的请求，可调整为较大的值（如 600 秒）。同时，可在设置中更换存钱罐的样式。
注意事项¶
-
前置条件
- 需要在~/.dsh/.credentials.yaml中配置DEEPSEEK_API_KEY。
- 需要安装 Node.js ≥ 20 以及 pnpm。
- 需要确保 DSH 已初始化 web profile（默认为~/.dsh/profiles/web）。 -
数据来源与局限
- 数据来源为 DeepSeek 官方接口GET https://api.deepseek.com/user/balance。
- DeepSeek 开放平台未提供 token 用量、费用或账单接口，因此本插件仅展示余额，不做本地用量记账或费用估算。 -
安全性
- 插件以 DSH 进程的权限运行，安装前建议检查源码与许可证（MIT）。
短结尾¶
outprinthelloli/dsh-piggy-bank 提供了在 DSH 界面内直接监控余额的能力，通过可视化的动画反馈余额变化，降低了开发者手动查询 API 的频率。相关目录与源码可参考下方链接。
