dsh-whale-widget-plus

<h1 align="center">DSH 小鲸鱼余额挂件 · 多种表情版</h1>

dsh-whale-widget-plus — DeepSeek Harness 网页右下角的常驻小鲸鱼挂件<br> <strong>四套表情素材切换</strong> · 火山 Coding Plan 用量 / DeepSeek 余额双模式 · 情绪动画 · 自定义台词

---

✨ 功能亮点

🐋 四表情版本切换

菜单里一键切换 第一版 / 第二版 / 第三版 / 第四版 四套表情素材：

• 第一版：18 张（主图 + 生气/害羞/失落/疲惫/摸头 + OK/伤心/别吵/加油/压力大肥鱼/嘲笑/干什么/惊吓/打招呼/点赞 + 眨眼两帧）
• 第二版：32 张（主图 + 生气了/脸红/哭唧唧/死机中 + 发呆/OK/什么/你的钱我收下了/可以给我吗/咬牙切齿/坏笑/墙角大肥鱼/大受震撼/好厉害/委屈/开心/得加钱/得意/懂你意思/无聊/点赞/牵强笑/疑问/竟然是/被发现了/超大声/超开心/震惊 + 眨眼两帧）
• 第三版：32 张（主图 + 害羞/哭唧唧/瞌睡中/挨揍中/哼哼哼 + 比心/叉腰/哒咩哒咩/打招呼/刚睡醒/给擦擦/乖巧/好了叫你/喝茶/活动筋骨/加油/检讨中/可怜的大肥鱼/留下证据/面壁思过/你来写/跑路了/糖果/偷偷看/小蛋糕/已经洞察了一切/优雅/正在研究/抓包偷吃 + 眨眼两帧）
• 第四版：33 张（主图 + 眨眼两帧 + 学霸/浇花/举牌/睡觉/投降/堆雪人/肥鱼钓鱼/厨神/弹吉他/玩游戏/看书/艺术创作/珍珠奶茶/咖啡/泡面/冰淇淋/马赛克冰淇淋/玩手机/摸鱼/你来你来/思考人生/跪了/瑟瑟发抖/跳舞/大肥鱼搬砖/装死/四脚朝天/大哭/不！！！/吃白饭）
• 选择记忆在 localStorage，刷新保持；切换即时生效

💰 双数据模式

• 火山引擎 Coding Plan 用量：5 小时滚动 / 本周 / 本月百分比，多账号自动轮询
• DeepSeek 官方余额：¥ 实时查询 + 今日已用（峰谷计价）+ 每轮对话消耗

🎭 挂机情绪动画（自动）

• 连点 5 次 → 生气
• 悬停 8 秒 → 害羞
• 2 分钟无交互 → 失落
• 会话配额 ≥90% → 疲惫模式（死机表情）
• 空闲随机眨眼 + 随机卖萌表情（25~60 秒）

🗣️ 台词系统

• 内置随机台词（6 组）+ 自定义台词（增删改、轮播/随机模式）
• 手动选择固定台词
• 情绪/卖萌表情不配台词（表情管表情、台词管台词）

⚙️ 其他

• 大小可调（记忆）、气泡颜色、眨眼频率、音效、手动表情/台词锁定
• 图片加载失败自动重试（不卡破图）
• 刷新无闪现（尺寸 localStorage 秒预置）

📦 安装

标准 DSH 插件安装（两个插件都装）：

# 1. 鲸鱼挂件本体
dsh plugin --profile web add link:C:\path\to\dsh-whale-widget-plus

# 2. 火山数据源（火山模式必需，DeepSeek-only 可跳过）
dsh plugin --profile web add link:C:\path\to\dsh-whale-widget-plus\plugins\volc-usage

重启 dsh web，浏览器 Ctrl+F5 强刷即可看到小鲸鱼。

🖥️ 官方桌面版支持（v0.3.1+）

插件同时适配官方桌面版（DeepSeek Harness Desktop，dsh ≥ 0.1.7-rc.2）：桌面版界面不走 HTTP 页面注入，插件通过 package.json 的 dsh.client 客户端模块声明（lib/client.js，platform: web、immediately: true）在客户端启动时自动挂载小鲸鱼，无需任何额外步骤。Web 模式行为不变（仍走 webServer.tapIndex 注入）。

🏗️ 数据链路架构

┌────────────┐   GET /api/volc-usage        ┌─────────────────────────┐
│ 浏览器前端  │◄──────同源 fetch─────────────│  dsh web 服务端 (Node)   │
│ (widget.js │                              │                         │
│  注入页面)  │   GET /dsh-whale/            │  ┌───────────────────┐  │
│            │       balance.json           │  │ dsh-volc-usage    │  │
│            │◄────────────────────────────│  │ · 读 .credentials │  │
│            │                              │  │   .yaml 多账号    │  │
│            │   GET /dsh-whale/            │  │ · 火山 OpenAPI    │  │
│            │       last-turn.json         │  │   HMAC-SHA256 签名 │  │
│            │◄────────────────────────────│  │ · GetCodingPlan- │  │
│            │                              │  │   Usage + 余额查询 │  │
│            │                              │  │ · ≥90%/429 自动   │  │
│            │                              │  │   轮换 ACTIVE key │  │
│            │                              │  └───────────────────┘  │
│            │                              │  ┌───────────────────┐  │
│            │                              │  │ dsh-whale-widget-plus  │  │
│            │                              │  │ · DeepSeek 余额   │  │
│            │                              │  │   /user/balance   │  │
│            │                              │  │ · 今日已用(峰谷)   │  │
│            │                              │  │ · 每轮消耗统计     │  │
│            │                              │  └───────────────────┘  │
└────────────┘                              └─────────────────────────┘

一句话链路：前端定时 fetch 同源接口 → 插件后端持凭证调官方 OpenAPI → 归一化成百分比/金额 → 鲸鱼数字滚动 + 表情联动。

关键设计

…