Solicide/dsh-snake

dsh-snake 🐳

DeepSeek Harness Web 贪吃鲸小游戏插件：蓝色鲸鱼直接游走在 DSH 页面背景中
（全视口、完全点击穿透），吃金色 Token，右下角仅保留一个极简控制胶囊，
浏览 DSH 时随时可玩，不遮挡内容、不抢页面焦点。

玩法

| 按键 | 作用 |
| --- | --- |
| ↑ ↓ ← → | 转向（运行中）；开始 / 结束画面上在按钮间移动焦点 |
| 空格 | 开始 / 暂停 / 继续；确认当前聚焦的按钮（开始、重来、退出） |
| 回车 | 同空格（菜单态确认按钮） |

- 点击右下角胶囊（或其按钮）即接管键盘；焦点离开后鲸鱼作为背景继续游走，不再响应按键。
- 运行中只有一枚 🐳 分数徽章，没有任何提示层遮挡背景棋盘；
开始 / 暂停 / 结束画面才显示对应按钮与提示。
- 失败后：🔄 重来 与 ✕ 退出，方向键切换、空格确认（失败时若面板已聚焦会自动聚焦"重来"）。
- 退出后背景鲸鱼与透明效果一并移除，页面恢复原样；侧栏底部 🐳 入口可随时重新打开。
- 最高分与胶囊位置保存在浏览器 localStorage。

设计要点（不影响浏览 DSH）

- 背景舞台直接挂在 body（DSH #root 之下，z-index 0），pointer-events:none，
页面所有点击完全不受影响。
- 开启背景时把 DSH 表面令牌（--dsw-alias-bg-*）覆盖为半透明值（与 beautiCode
背景同类做法，明暗主题各一套），鲸鱼才得以透出；退出游戏后自动还原为不透明。
- 全屏棋盘自动适配分辨率：格数与格子大小按窗口尺寸自动计算
（短边约 16 格、正方形格铺满整个视口，8–64 格钳制），窗口大小变化时空闲状态自动重建棋盘；
游戏区域以极淡网格 + 内缩边界线标示。
- 画布完全透明：只有极淡网格、金色 Token（带 "token" 字样与光晕）与蓝色鲸鱼
（固定透明度的 DeepSeek 蓝圆角方块，蓝色背部约占 75% 面积、白色月牙肚皮约占 25%、
单侧眼斑与尾鳍），叠加在它上面的 DSH 文字保持清晰。
- 键盘只在「胶囊已聚焦」时响应，并且永远不劫持 input / textarea / contenteditable
—— 在聊天框打字时方向键、空格照常输入。

安装

从 GitHub 安装（推荐）
dsh plugin --profile web add github:Solicide/dsh-snake
本地开发 / 源码安装（自动把包加入 profile 的 bundles 层）
dsh plugin --profile web add "link:D:\dsh\dsh-snake"

安装后重启 dsh web 服务并刷新页面（bundle 树在启动时组合）；
之后修改 lib/client.js 只需刷新页面即可生效（bundle 以 no-cache 下发）。

English quick start

| Key | Action |
| --- | --- |
| ↑ ↓ ← → | Steer the whale; move focus between buttons on menus |
| Space | Start / pause / resume; activate the focused button (start, retry, exit) |
| Enter | Same as Space on menus |

Click the control pill at the bottom-right to take the keyboard. The whale
keeps swimming in the page background while you browse DSH; key input never
interferes with text fields. Close with the ✕ on the game-over screen, and
reopen any time from the 🐳 entry at the sidebar footer.

结构

lib/index.js           宿主半面（纯客户端插件，空 apply）
lib/game.js            纯逻辑引擎（无 DOM/定时器，可单测）
lib/client.template.js 客户端 bundle 模板（背景舞台 + 控制胶囊 + 键盘交互）
scripts/build-client.mjs  把 game.js 内联进模板生成 lib/client.js
test/game.test.mjs     引擎单元测试
test/client.smoke.mjs  客户端 bundle 冒烟测试（桩 DOM 环境）
cordis.patch.yml       组合树补丁（insert: ui-snake / dsh-snake）

开发校验：

npm run check   # 重新生成 client.js + 语法检查 + 单元/冒烟测试

License

MIT