dsh-whale-food-expack
English | 中文
🍚 给 DSH 的小鲸鱼记账挂件加上「喂白米饭 + 干活敲键盘 + 工具显示」的附加包
不修改本体插件 · 纯本机运行 · 不向任何服务器发送数据 · 非官方项目
dshfind
当前版本 1.6.2（npm）· 依赖本体 dsh-whale-widget ≥ 0.3.0
演示
喂白米饭 + 干活敲键盘 + 工具显示，同时进行：
喂饭与敲键盘同时进行
- 喂白米饭：把饭碗拖到鲸鱼身上 → 张嘴吃掉 → 冒一句台词；吃完留一个空碗，左键点一下自动盛满
- 敲键盘 + 工具显示：agent 干活时鲸鱼露出手敲键盘，实时吐司报使用的工具名（
🛠 read），失败时变红抖动
使用指南
| # | 功能 | 使用方法与效果 |
|---|
| ① | 喂白米饭 | 把白米饭🍚拖到鲸鱼身上 → 鲸鱼张嘴咀嚼、冒一句对应台词并增加饱食度（没拖中会飞回原位） |
| ② | 续饭功能 | 满碗喂掉后留一个空碗；左键单击空碗自动盛满，开始下一轮（刷新后仍保持空碗）；注意⚠️：空碗🥣无法拖动 |
| ③ | 饱食度系统 | 空闲 −1%/分钟；干活时按 token 消耗（3,000 tokens = −1%，与实际干活的掉速对齐）；喂一碗饭 +5%。≤50% 时每 30 秒主动喊一句饿话，越饿说得越惨（5 档）。数值实时显示在右上角小气泡里：深蓝 = 正常、橙色 = 饿了、红色 = 快饿死了 |
| ④ | 敲键盘反应 | agent 干活时鲸鱼敲键盘并露出两只手；每次工具调用吐司报工具名（🛠 read）；工具失败变红抖动（💥 pwsh 失败了）；开工「🔧 开工！」、收工播报「✨ 干完啦～ 本轮 12.3K tokens · 饱食度 -8.0%」并伸个懒腰 |
安装
前置条件：先装好本体 —— 插件市场里的「DSH 小鲸鱼记账挂件」（包名 dsh-whale-widget，版本 ≥ 0.3.0）。
本插件只是它的附加层，没有本体不会显示任何东西。
# 从 npm / 插件市场安装（推荐，已发布 v1.6.2）
dsh plugin --profile web add dsh-whale-food-expack
# 或者直接从 GitHub 安装
dsh plugin --profile web add github:Mynaniao/dsh-whale-food-expack
装好后重启 dsh web（宿主半端在启动时加载），然后刷新页面。
# 卸载（鲸鱼娘本体不受影响，继续正常工作）
dsh plugin --profile web remove dsh-whale-food-expack
配置与数据
饱食度数值都在 assets/satiety.mjs 顶部，改完刷新页面即生效：
| 常量 | 当前值 | 含义 |
|---|
IDLE_PER_MIN | 1 | 空闲每分钟掉 1% |
TOKENS_PER_PERCENT | 3000 | 干活时多少 token 掉 1%（调大更耐饿，调小饿得快） |
FEED_GAIN | 5 | 一碗饭 +5% |
HUNGRY_AT | 50 | ≤50% 开始喊饿 |
TIER_SPAN / TIER_COUNT | 10 / 5 | 每降 10% 换一档，共 5 档 |
HUNGER_INTERVAL_MS / HUNGER_TOAST_MS | 30000 / 3000 | 每 30 秒一句，吐司停留 3 秒 |
3,000 这个数是从真实会话日志量出来的：干活时实测约 14,574 token/分钟，
除以旧版"干活 5%/分钟"正好 ≈ 2,900，取整 3,000 —— 也就是换成 token 计费后，
掉速和原来基本一样。推导与计费口径见 docs/tech-notes.md。
台词都在 assets/ 里，直接编辑、刷新即生效：
hunger-lines.json —— 5 档饿话（第 1 档最轻），相邻两句不重复feed-lines.json —— 喂饭台词，按吃之前的状态分四档：starving(≤20%) / hungry(≤50%) / normal / full(≥80%)
数据与隐私 —— 全部只存在你自己的浏览器里，本插件不向任何服务器发送数据：
| localStorage 键 | 存什么 | 想清零怎么办 |
|---|
dshwv-satiety / dshwv-satiety-at | 当前饱食度 + 时间戳（用于离线补算） | 删除这两个键 → 回到 100% |
dshwv-feed-count | 累计喂了多少碗 | 删掉 |
dshwv-rice-empty | 饭碗是空是满 | 删掉（恢复满碗） |
dshwp-cal | 你调过的位置 | 删掉（恢复默认位置） |
dshwp-mouth | 只调嘴的简写覆盖：'left,top,width,height' | 删掉 |
页面关着的时间按空闲速率补算（离线时无法知道 agent 在不在干活，取保守值）。
想改成"离线不扣"，删掉 assets/plus.js 里 loadSatiety() 中的那次 decay 调用即可。
常见问题
装了没反应？
先确认本体在不在（插件市场里的「DSH 小鲸鱼记账挂件」）。本插件只给本体加东西，没本体就什么都不显示。
装完记得重启 dsh web，然后刷新页面。
叠加层错位了（嘴跑到额头、手飘在半空）？
上游换立绘或挂了别的皮肤插件时会发生。按 Ctrl+Alt+M 进入调整模式 → 嘴/键盘/左手/右手会出现红色虚线框，直接拖动；再按一次 Ctrl+Alt+M（或 Esc）结束，松手即存。位置存在 localStorage['dshwp-cal']。
想彻底关掉？
dsh plugin --profile web remove dsh-whale-food-expack，然后重启；本体继续正常工作。
饥饿模式台词不出现？
饱食度要降到 50% 以下才会开始说；而且每 30 秒一句，不是一直在说。想立刻看效果：
控制台执行 localStorage['dshwv-satiety']='45'; localStorage['dshwv-satiety-at']=Date.now() 再刷新。
它会读取我的对话内容吗？
不读。宿主半端只订阅 agent 的状态事件（开工/收工/工具名/成败），不含对话内容；前端也只是把这些状态画成动画。
兼容性
桌面端（DeepSeek Orb）：支持。桌面端的 index.html 由安装包静态直出，网页版用的 tapIndex 在那边不会被调用，所以本插件同时挂了 webserver/index-inject 那条通道 —— 两条通道并存时靠 window.__dshWhalePlus 保证只启动一次。桌面端改完需完全重启 Orb。
界面皮肤（如 dsh-macos-skin）与全屏：支持。皮肤会插入一层不透明全屏壁纸（z-index: 2147483000），本插件检测到后把鲸鱼、饭碗、右键菜单，以及应用自己的对话框/菜单（它们 portal 到 <body> 且没有 z-index，不抬就会"设置点不开"）一起抬到壁纸之上。进全屏时把鲸鱼与菜单搬进 document.fullscreenElement。
层号约定：壁纸 2147483000 < 鲸鱼 2147483100 < 饭碗 2147483105 < 右键菜单 2147483110 < 应用层 2147483200 < 皮肤自己的弹窗 2147483300+。
排查冲突时可以在控制台执行 localStorage['dshwp-compat']='0' 再刷新，关闭这一层兼容；改回 '1' 恢复。
开发与测试
npm test # = node test/host.mjs && node test/satiety.mjs && node test/layers.mjs
node test/host.mjs # 31 项：注入幂等、事件折叠、token 计费口径、失败判定、并行工具、FIFO 兜底、静态资源解析
node test/satiety.mjs # 31 项：下降速率、喂食、档位、语境、相邻不重复、token 换算、台词文件一致性
node test/layers.mjs # 45 项：层级、皮肤/全屏兼容、桌面端注入行、镜像文字翻正
107 条断言，不联网、不启动 DSH、不碰真实 ~/.dsh。CI 见 .github/workflows/test.yml（push / PR 自动跑）。
- Node ≥ 20（仅开发与测试需要；装插件本身不需要）
- 结构：宿主
lib/index.js（折叠 agent 活动成 /dsh-whale-food-expack/activity.json，并白名单式暴露 assets/）；
前端 assets/plus.js + plus.css（1.2 秒轮询，按 seq 判新事件）；纯逻辑抽在 assets/satiety.mjs 便于单测。
- 实现细节（架构、activity 折叠规则、饱食度与 token 换算的推导、几何与校准坐标、存档键、调试方法）见
docs/tech-notes.md
许可与致谢
- 本体：「DSH 小鲸鱼记账挂件」由 @MeteorNOX 开发
（DeepSeek-Balance-Whale-Widget，MIT）。
本插件与作者无隶属关系，也不是 DeepSeek 官方产品。
- 不含上游素材：本插件不包含本体的任何代码或美术素材（图片 / 动图 / 音效），运行时只通过公开的
DOM 类名（
.dshwv-img 等）对接；上游改版可能导致叠加层错位，用 Ctrl+Alt+M 重新对齐即可。
- 本插件：几何、配色、台词、米饭贴图与动画由本插件作者提供，按 MIT 授权分发，见 LICENSE。
- 免责与第三方：非官方项目、不含上游素材、商标与权利主张的完整说明见 NOTICE.md。
