前言¶

DSH（DeepSeek Harness）的插件生态支持通过插件扩展宿主功能。除了实用的记账、状态监控类插件外，社区中也存在一些为增强交互体验而设计的附加组件。

dsh-whale-food-expack 是为 DSH 小鲸鱼记账挂件（dsh-whale-widget）设计的互动附加包。它不修改本体插件，而是通过叠加层的方式，给小鲸鱼增加了“喂白米饭”、“干活敲键盘”以及“工具实时显示”等行为逻辑。本插件由 Mynaniao 维护，采用 MIT 许可证。

核心功能¶

该插件主要实现以下能力：

1. 喂白米饭

   • 支持拖拽交互：将白米饭拖到鲸鱼身上即可喂食。
   • 自动续饭：满碗喂掉后会留一个空碗，左键点击空碗可自动盛满，开始下一轮进食。
   • 饱食度反馈：喂食会增加饱食度，数值显示在右上角的小气泡中。

2. 饱食度系统

   • 自然消耗：空闲状态下，饱食度每分钟下降 1%。
   • 工作消耗：Agent 干活时，饱食度会根据 Token 消耗量下降（设定为 3000 tokens = -1%）。
   • 饥饿反馈：当饱食度 ≤ 50% 时，每 30 秒小鲸鱼会喊一次饿，越饿喊得越惨。

3. 敲键盘与工具显示

   • 视觉反馈：Agent 干活时，鲸鱼会露出手并敲击键盘。
   • 工具报错：每次调用工具会在界面上弹出吐司提示（如 🛠 read），若工具调用失败，鲸鱼会变红并抖动。
   • 实时状态：界面上会实时显示当前正在使用的工具。

安装与启用¶

在安装本插件前，请确保宿主环境已安装并启用本体插件「DSH 小鲸鱼记账挂件」（包名 dsh-whale-widget），且版本 ≥ 0.3.0。

本插件是附加层，没有本体不会显示任何内容。

dsh plugin --profile web add dsh-whale-food-expack

命令执行完成后，需要重启 dsh web 进程，插件才能生效。

使用指南¶

安装并重启后，使用方法如下：

1. 喂食操作

   • 将白米饭🍚拖拽到鲸鱼身上进行喂食。
   • 满碗喂掉后会留下一个空碗🥣，此时无法拖动空碗。
   • 左键单击空碗，系统会自动盛满米饭，开始新一轮喂食。

2. 状态查看

   • 饱食度数值实时显示在右上角的小气泡里。
   • 深蓝色代表正常状态，橙色代表饿了，红色代表快饿死了。

3. 位置校准

   • 如果叠加层位置错位（例如嘴跑到额头、手飘在半空），按 Ctrl+Alt+M 进入调整模式。
   • 此时会出现红色虚线框，拖动嘴、键盘、左手、右手即可调整位置。
   • 再次按 Ctrl+Alt+M 或 Esc 退出模式，位置会自动保存。

数据与隐私¶

本插件的数据存储和运行逻辑完全在本地浏览器中：

• 存储位置：所有数据存储在浏览器的 localStorage 中，包括饱食度数值、喂食次数、位置校准数据等。
• 隐私安全：插件不会向任何服务器发送数据，也不读取对话内容，仅订阅 Agent 的状态事件（如开工、收工、工具名、成败）。

注意事项¶

• 依赖本体：必须先安装并启用 dsh-whale-widget ≥ 0.3.0，否则本插件无任何显示。
• 重启生效：安装或卸载后，必须重启 dsh web 才能加载或移除插件。
• 层级冲突：本插件可能会与某些皮肤插件或全屏插件发生层级冲突（z-index 问题）。如果遇到设置点不开或显示不全，可以使用 Ctrl+Alt+M 调整模式重新校准，或检查皮肤插件的兼容性配置。

参考资料¶

• 项目主页：https://github.com/Mynaniao/dsh-whale-food-expack
• 插件目录：https://www.skillhub.cn/plugins/Mynaniao/dsh-whale-food-expack