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