dsh-whale-food-expack

🍚 给 DSH 的小鲸鱼记账挂件加上「喂白米饭 + 干活敲键盘 + 工具显示」的附加包

不修改本体插件 · 纯本机运行 · 不向任何服务器发送数据 · 非官方项目

当前版本 1.5.0（npm）· 依赖本体 dsh-whale-widget ≥ 0.3.0

---

演示

喂白米饭 + 干活敲键盘 + 工具显示，同时进行：

不干活时：喂白米饭	干活时：敲键盘 + 工具显示

• 喂白米饭：把饭碗拖到鲸鱼身上 → 张嘴吃掉 → 冒一句台词；吃完留一个空碗，左键点一下自动盛满
• 敲键盘 + 工具显示：agent 干活时鲸鱼露出手敲键盘，实时吐司报使用的工具名（🛠 read），失败时变红抖动

使用指南

#	功能	使用方法与效果
①	喂白米饭	把白米饭🍚拖到鲸鱼身上 → 鲸鱼张嘴咀嚼、冒一句对应台词并增加饱食度（没拖中会飞回原位）
②	续饭功能	满碗喂掉后留一个空碗；左键单击空碗自动盛满，开始下一轮（刷新后仍保持空碗）；注意⚠️：空碗🥣无法拖动
③	饱食度系统	空闲 −1%/分钟；干活时按 token 消耗（20,000 tokens = −1%）；喂一碗饭 +5%。≤50% 时每 30 秒主动喊一句饿话，越饿说得越惨（5 档）。数值实时显示在右上角小气泡里：深蓝 = 正常、橙色 = 饿了、红色 = 快饿死了
④	敲键盘反应	agent 干活时鲸鱼敲键盘并露出两只手；每次工具调用吐司报工具名（🛠 read）；工具失败变红抖动（💥 pwsh 失败了）；开工「🔧 开工！」、收工播报「✨ 干完啦～ 本轮 12.3K tokens · 饱食度 -8.0%」并伸个懒腰

安装

前置条件：先装好本体 —— 插件市场里的「DSH 小鲸鱼记账挂件」（包名 dsh-whale-widget，版本 ≥ 0.3.0）。 本插件只是它的附加层，没有本体不会显示任何东西。

# 从 npm / 插件市场安装（推荐，已发布 v1.5.0）
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	20000	干活时多少 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 秒

20,000 这个数是从真实会话日志量出来的（一次工具调用约 6.4K tokens → 约 −0.32%， 50 步的日常任务约 −16% ≈ 3 碗饭）。推导与计费口径见 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    # 30 项：下降速率、喂食、档位、语境、相邻不重复、token 换算、台词文件一致性
node test/layers.mjs     # 45 项：层级、皮肤/全屏兼容、桌面端注入行、镜像文字翻正

106 条断言，不联网、不启动 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。