鲸娘跑酷 Fr20210478/dsh-whale-chase-rice

大肥鱼想吃饭 · Big Fat Fish Wants to Eat

一个小鲸鱼娘跑酷游戏，住在 DeepSeek Harness Web UI 的浮窗里，用来填满等 AI 回答的那几分钟：跳过生活里的糟心事，冲到大碗白米饭，回答好了会有提示。

小鲸鱼娘

| 胜利结算 | 失败结算 | 终点米饭 |
| 胜利 | 失败 | 米饭 |

功能

- 随时可玩：AI 空闲、正在回答、刚回答完都能开一局；单局可选 0.5 / 1 / 2 / 3 分钟。
- 一个键：空格 / ↑ / W / 点击 / 触屏点击跳跃。撞到词就结束，冲到大碗白米饭就是通关。
- 只有文字的生活障碍：加班、内卷、PUA、内耗、焦虑、失眠、脱发、肥胖、贫穷、长痘、生病（英文模式显示 OT / RACE / PUA / BURN / ANX / SLEEP / HAIR / FAT / DEBT / ACNE / SICK）。纯文字、随机颜色、无边框无底板、不倾斜；每个障碍宽高随机，间距随机，并且用可达性规则保证下一跳一定跳得过去。障碍会随跳跃高度和本局进度变大。
- 米饭一直看得见：从第一帧就停在右侧，整局慢慢靠近，最后 5 秒加速冲向鲸鱼娘。
- 结算对话框：胜利 / 失败各有一张插画；关闭对话框会回到暂停的起始页，不会自动重开。
- 暂停 / 继续 / 重新开始；拖动标题栏可以移动游戏卡片。
- 圆形可拖动浮窗：带鲸鱼娘头像的圆形按钮，默认在右侧、从上往下 1/5 处；拖到任意位置后会按「最近边缘 + 纵向比例」记住，切换全屏/改变窗口大小时不会跑偏。有未读回答时出现一个小圆点，没有闪烁光效。
- 回答好提示：游戏区上方出现 回答好了 提示条；开着音效时会响提示音。正在跑的这一局不会被强行打断。
- 中英文界面，在设置里切换。
- 防沉迷可选，默认关闭：温和档为 3 局 → 休息 30 秒、每次等待最多玩 5 分钟、每天最多 60 分钟、回答完成后 5 秒冷却、达到每日 80% 时轻提示。
- 音效默认关闭。
- 不联网、无遥测、无第三方运行时依赖；所有设置存在浏览器 localStorage。

安装

前提：已安装 DeepSeek Harness，并且带 Web UI（桌面版自带 Web UI；本项目在桌面版 0.2.1-rc.2 上开发验证）。

DSH 插件页的「添加插件」接受三种地址：npm 包名、GitHub 仓库地址、本地目录路径。本插件现在可以用后两种安装；npm 包名要等发布后才可用（见下）。

方式一：在 DSH 界面里安装（推荐）

1. 打开 DSH 侧边栏的「插件」页，点「添加插件」。
2. 在「包名或地址」输入框里填 GitHub 仓库地址：https://github.com/Fr20210478/dsh-whale-chase-rice
3. 点「安装」，装好后按提示重启 DSH。对话面板右侧会出现圆形鲸鱼娘头像。

「添加插件」的输入框也接受 npm 包名和本地目录路径。插件包名就是 npm 包名：形如 dsh-xxx 或 @作者/插件名，也就是社区插件 README 安装命令里 dsh plugin add 或 pnpm add 后面那一段（示例：dsh-plugin-whale-pet）。

本插件目前只通过 GitHub 分发；计划使用的 npm 包名是 dsh-whale-chase-rice，但尚未发布到 npm，所以现在请填上面的 GitHub 地址。等发布到 npm 后，也可以直接填这个包名，由 DSH 按「安装源」下载。

填 GitHub 地址或 .tgz 直链时不经过安装源，需要本机能直接访问 GitHub；如果访问不了，可以改用本地目录安装。

方式二：命令行安装

dsh plugin --profile web add https://github.com/Fr20210478/dsh-whale-chase-rice

把 web 换成你要安装到的 profile（Web UI 一般是 web）。桌面版正在运行时不能对它执行 dsh plugin，请先用上面的界面安装。

方式三：本地目录（开发 / 改代码时）

克隆仓库后，用 Harness 的插件管理器 install_bundle 指向仓库根目录（package.json 所在目录），或在「添加插件」里直接填这个目录的绝对路径。重启 Harness 后生效。需要移除时，在插件页卸载，或对 dsh-whale-chase-rice 执行 remove_bundle。

升级：插件页里没有「更新」按钮的插件，需要先卸载再安装新版本。

没出现头像？ 到「插件」页确认这个 bundle 已安装并启用，然后重启 DSH。

使用

- 拖动圆形头像移动它；单击打开游戏。
- 拖动游戏卡片标题栏移动卡片；Esc 关闭，P 暂停。
- 齿轮里设置：音效、语言、单局时长、防沉迷、统计重置、最佳分数重置。
- AI 回答好时，如果正在玩，这一局继续，提示条出现在游戏区上方；如果窗口收起且你玩过，会重新弹出并响一次提示音（音效开启时）。

替换美术

assets/ 下的 whale、victory、failure、rice 四个基名，支持 .png / .jpg / .jpeg / .webp；构建时取每个基名最新的文件，因此替换图片不需要改代码：

node scripts/build.mjs # 把最新图片内联进 client.js
或开发时保持监听：
npm run watch
只替换文件不会改变正在运行的插件：图片在构建时内联进 client.js，必须先重新构建，再重新安装 / 重启 Harness（客户端热更新可用时会自动加载，否则需要重启）。建议尺寸：whale 512px 透明底、victory / failure 384px 透明底、rice 420px 透明底。详见 assets/README.md。

开发

node scripts/build.mjs # src/ + assets/ -> client.js
node --test # 29 个测试：游戏规则、防沉迷、bundle、界面
npm pack --dry-run # 检查最终会发布到 npm 的文件列表

client.js 里的模块 id 和版本号都从 package.json 读取，改包名或版本号后重新构建即可。

| 路径 | 作用 |
| index.js | Host 半（空实现） |
| src/core.js | 纯游戏 / 防沉迷规则 |
| src/render.js | Canvas 场景、文字障碍、Q 版动画 |
| src/client.template.js | React 浮窗、启动器、对话框、设置 |
| scripts/build.mjs | 把所有源码拼成 client.js |
| test/ | node:test 测试 |
| locale/ | 插件管理器展示元数据（中 / 英） |
| cordis.patch.yml | 插件行声明（name 即 npm 包名） |

许可

MIT。assets/ 里的鲸鱼娘插画是为本项目生成的；如果二次分发时想换形象，替换 assets/ 即可。

一个迷你 Q 版鲸鱼娘跑酷小游戏，住在 DeepSeek Harness Web UI 的浮窗里。它陪你打发等 AI 回复的几分钟：跳过工作生活的重担，够到那碗米饭，答案就绪时还会提醒你。

| 胜利 | 失败 | 目标 |
| Victory | Failure | Rice bowl |

功能

- 随时可玩，不只在 AI 回复时。单局时长可选 0.5、1、2 或 3 分钟。
- 一个操作。 空格 / ↑ / W / 点击 / 触摸跳跃。撞到文字本局结束；够到饭碗弹出胜利对话框。
- 只有文字重担：加班、内卷、PUA、内耗、焦虑、失眠、脱发、肥胖、贫穷、长痘、生病（英文版为 OT / RACE / PUA / BURN / ANX / SLEEP / HAIR / FAT / DEBT / ACNE / SICK）。无描边、无色块填充、无旋转；随机中等颜色。每个障碍的尺寸和间距随机生成，通行规则保证下一跳跳得过去，重担随跳跃高度和游戏进程变大。
- 饭碗始终在视野内：它等在右边缘，慢慢靠近，最后五秒冲向鲸鱼娘。
- 结果对话框使用自带插画。关闭对话框回到暂停的开始界面——绝不自动重开。
- 暂停 / 继续 / 重开；拖动标题栏可移动卡片。
- 圆形可拖动启动器，头像为鲸鱼娘；默认在右边缘、向下五分之一处。位置按「最近边缘 + 垂直比例」记忆，全屏和窗口缩放后仍保持相同相对位置。未读答案用静态圆点标记，没有光晕。
- 答案就绪提醒：游戏区上方出现 Answer ready 条，可选提示音。进行中的一局不会被打断。
- 英文 / 中文界面。
- 防沉迷，可选，默认关闭：3 局 → 休息 30 秒，每次等 AI 最多 5 分钟，每天最多 60 分钟，答案后 5 秒冷却，每日额度用到 80% 时提醒。
- 默认静音。 不发起网络请求，不上报遥测，不依赖第三方运行时；设置保存在 localStorage。

安装

环境要求：带 Web UI 的 DeepSeek Harness（桌面应用自带一个；本项目针对桌面应用 0.2.1-rc.2 开发和测试）。

插件页的 Add plugin 输入框接受三种写法：npm 包名、GitHub 仓库地址、本地目录路径。本插件目前请用后两种；npm 包名要等发布之后才能用（见下文）。

方式一：从 DSH UI 安装（推荐）

1. 打开 DSH 侧边栏的 Plugins 页，点 Add plugin。
2. 在 Package name or address 里填 GitHub 仓库地址： https://github.com/Fr20210478/dsh-whale-chase-rice
3. 点 Install，按提示重启 DSH。Conversation 面板右边缘会出现圆形鲸鱼娘启动器。

Add plugin 输入框也接受 npm 包名和本地目录路径。插件包名就是 npm 包名——形如 dsh-xxx 或 @author/plugin。社区插件 README 的安装命令里，dsh plugin add 或 pnpm add 后面跟的那一段就是它（例如 dsh-plugin-whale-pet）。

本插件目前只通过 GitHub 分发；计划中的 npm 包名是 dsh-whale-chase-rice，但尚未发布到 npm，所以现在请用上面的 GitHub 地址。等 npm 包上线后，填这个包名就会通过所选的 Registry 下载。

GitHub 地址或 .tgz 链接是直接拉取的，不走 registry，所以本机必须能访问 GitHub；访问不了就改用本地目录安装。

方式二：命令行

dsh plugin --profile web add https://github.com/Fr20210478/dsh-whale-chase-rice

把 web 换成你要用的配置档。桌面应用独占自己的配置档，必须先完全退出，dsh plugin 才能改动它——应用运行期间请走上面的 UI 方式。

方式三：本地目录（开发用）

克隆仓库，然后把 harness 插件管理器（install_bundle）指向仓库根目录（含 package.json 的那一层），或者在 Add plugin 里填这个绝对路径，再重启 Harness。以后要移除，就在 Plugins 页卸载，或者对 dsh-whale-chase-rice 调用 remove_bundle。

升级：Plugins 页上没有 Update 按钮的插件，要升到新版本只能卸载后重装。

没看到启动器？ 先确认 Plugins 页上这个 bundle 已安装并启用，再重启 DSH。

使用

- 拖动圆形头像可以移动位置；点它打开游戏。
- 拖标题栏可以移动卡片。Esc 关闭，P 暂停。
- 设置项：音效、语言、单局时长、防沉迷、重置统计 / 最佳成绩。
- AI 在你游玩期间完成时，这一局会继续，答案条会出现在它上方。如果窗口已关闭而你玩过，窗口会重新打开，提示音只响一次（开启声音时）。

美术资源

把 assets/ 里的 whale、victory、failure、rice 任意一个替换成 .png / .jpg / .jpeg / .webp 文件即可；构建时按基础名挑选最新的文件，所以不用改代码：

node scripts/build.mjs
or keep it rebuilding while you iterate:
npm run watch

只替换文件不会更新正在运行的插件：美术资源在构建时内联进 client.js，所以要先重新构建，再重新安装 / 重启 Harness（客户端热重载可能直接生效；否则就重启）。建议尺寸：whale 512 px 透明，victory / failure 384 px 透明，rice 420 px 透明。见 assets/README.md。

开发

node scripts/build.mjs # src/ + assets/ -> client.js
node --test # 29 tests: game rules, anti-addiction, bundle, UI
npm pack --dry-run # inspect the exact files that would be published

client.js 里的模块 id 和版本号读自 package.json；重命名包或升级版本后要重新构建。

| 路径 | 作用 |
| index.js | 宿主端（无需提供任何服务） |
| src/core.js | 纯游戏与防沉迷规则 |
| src/render.js | Canvas 场景、文字负担、Q 版动画 |
| src/client.template.js | React 浮层、启动器、对话框、设置 |
| scripts/build.mjs | 把所有内容拼接成 client.js |
| test/ | node:test 测试套件 |
| locale/ | 插件管理器的展示元数据（英文 / 中文） |
| cordis.patch.yml | 插件行声明（name 是 npm 包名） |

许可证

MIT。assets/ 里的鲸鱼少女插画是为本项目生成的；如果你重新分发游戏时换了美术资源，请替换掉它们。