dsh-blue-whale-balance
DeepSeek 余额动画桌宠：按密钥观测账目、历史趋势与主题提醒设置
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:YUYU276/dsh-blue-whale-balance#4e99debe139aa2bd28a39af29cb94cabb3e2b662Blue Whale Balance 以 dsh-blue-whale-balance 发布，当前版本为 1.4.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
提供原版 DeepSeek 蓝鲸和社区鲸鱼娘两种形象。鲸鱼娘为透明背景的 Q 版蓝发女仆，使用六种情景各两组、每组四帧的独立绘制动画（共 48 帧）；原版蓝鲸的浮动和气泡动画继续保留。适用于 macOS DeepSeek Harness Desktop 和 DSH Web。
/user/balance 接口。API Key 每次通过宿主 ctx.credentials.resolve('DEEPSEEK_API_KEY') 读取，与 dsh 官方模型共用已有配置。客户端和本插件文件不保存密钥。密钥仅发送至 https://api.deepseek.com/user/balance，拒绝重定向；不调用聊天模型。
先获取本仓库：git clone，或页面右上角 Code → Download ZIP 解压；把插件目录放到一个固定位置，例如 ~/dsh-plugins/dsh-blue-whale-balance。
桌面版由 Electron 管理配置。为 desktop profile 添加本地包依赖和插件行后重启 dsh（修改前建议备份这两个文件）：
~/.dsh/profiles/desktop/package.json 的 dependencies 增加一行（路径换成你的实际位置）：
"dsh-blue-whale-balance": "link:/absolute/path/to/dsh-blue-whale-balance"
~/.dsh/profiles/desktop/cordis.patch.yml 追加：
- insert:
- id: blue-whale-balance
name: dsh-blue-whale-balance
config:
requestTimeoutMs: 10000
重启 DeepSeek Harness Desktop 生效；若未出现，检查 dsh 插件加载日志。桌宠位于 dsh 窗口悬浮层，跟随 dsh 界面显示。
对于 Web profile，可使用官方 CLI：
dsh plugin --profile web add link:/absolute/path/to/dsh-blue-whale-balance
可在 profile 的补丁中设置网络超时时间：
- update:
- id: blue-whale-balance
config:
requestTimeoutMs: 10000
npm test
测试使用假密钥和模拟网络，检查余额精度、多币种、每次查询的新鲜度、重叠请求合并、失败重试、错误不泄露密钥、外部来源拒绝与插件卸载清理。
12edce05da4d83ebd4bae241f07aad364f0f54eb鲸鱼娘形象资料：https://github.com/Neko3000/deepseek-whalechan 。新素材使用内置 image_gen 工具，按社区常见视觉特征重新生成，未复制下载的参考图；静态形象提示词见 ASSET-PROMPT.md，六种逐帧动画的完整提示词见 FRAME-PROMPTS.json。
本插件独立实现查询与界面逻辑。DeepSeek 名称和蓝鲸图案属于 DeepSeek；鲸鱼娘为社区二创，非官方吉祥物。
| 情景 | 动作 A | 动作 B | 每帧时长 |
|---|---|---|---|
| 待机 | 抱碗眨眼、尾巴轻摆 | 用勺子舀饭吃饭 | 320 ms |
| 工作中 | 在平板上书写 | 思考、灵感动作 | 260 ms |
| 完成待查看 | 挥手提醒 | 竖拇指庆祝 | 260 ms |
| 余额不足 | 抱着仅剩几粒米的碗哀求 | 双手递出空碗讨饭 | 400 ms |
| 被拖动 | 伸手保持平衡 | 抱碗蜷腿 | 220 ms |
| 被点击 | 惊讶后微笑 | 贴脸招手 | 240 ms |
每张 PNG 是固定四列两行的透明精灵图。播放器逐帧移动背景裁切窗口，每组循环随机 2–4 次，再在完整循环边界换组；初始动作组随机。鲸鱼娘关闭整图位移的 CSS 动画，手部、眼睛、脸和尾巴由重新绘制的帧变化驱动。原版蓝鲸保留原有动画。
工作状态来自宿主真实 sessionStatus；完成未读状态保持至查看；欠费由余额返回值触发；拖动和点击优先显示对应交互动作。预览动作在 6.5 秒后恢复真实状态。减少动态效果时停止逐帧计时；隐藏页面暂停播放，卸载清理计时器和监听器。
打开同目录 preview.html 可同时检查十二组动作，支持暂停、逐帧和变速。
--dsw-* 语义变量，宿主深色属性提供回退色。局部预设：跟随宿主、工作蓝、海洋蓝、鲸鱼娘工坊；自定义强调色单独保存，可恢复默认。预设只装饰本插件面板，不注册或改写全站主题。构建与检查（Node.js 22+）：
npm install --include=dev
npm run build
npm test
npm run test:ui
src/client.js 是界面源文件，lib/ledger.js 为账目与设置逻辑；构建脚本合并生成无新增运行时依赖的 lib/client.js。开发依赖仅用于 React/jsdom 交互检查。
设计依据是用户提供的《DSH 高星插件报告》9.3–9.5 节；独立实现账目、主题与提醒，没有引入其他插件的代码、美术或音效。本次继续使用原有自制 48 帧素材。