lhh010/dsh-minigames

dsh-minigames

简体中文 | English

DSH Web UI 浮动小游戏窗口：等待模型回复或修 bug 时的摸鱼神器。

• 折叠态：窗口隐藏后留下一个圆形浮动 🎮 按钮（默认右下角），可自由拖动并记住位置，

按住拖动（位移超过 5px）松手不会打开窗口；单击才重新打开面板。

• 展开态：浮动小游戏窗口，拖动标题栏可随意移动，松手靠近屏幕边缘自动吸附

（左右停靠/上下贴边），位置、停靠状态与宽度均持久化，刷新后自动恢复；默认宽度 min(50vw, 640px)，可拖左缘调整 360px–80vw，面板内自由选择游戏。

• 游戏（全部离线、零资源文件、Canvas 绘制）：

1. 🦖 恐龙跳一跳 —— Chrome 经典小恐龙（昼夜/雨天）；
2. 🧱 俄罗斯方块 —— 经典下落消除；
3. 🛡️ 坦克大战（带 AI） —— 2D 坦克对战，敌军追踪 + 视线开火，共 3 波；
4. 💎 消消乐 —— 点击消除四连通同色块，目标分过关、逐关递增；
5. 🔢 华容道 —— 16 格数字华容道（15-puzzle），滑动方块按序排列，用时越短分越高；
6. 🐍 贪吃蛇 —— 经典贪吃蛇，穿越边界会从对侧出现（环面地图）；
7. 🔢 2048 —— 方向键滑动合并数字，合成 2048 即达成；
8. 💣 扫雷 —— 左键翻开、右键标旗、双击数字自动展开周围；
9. 🃏 记忆翻牌 —— 翻开两张配对，步数越少分越高；
10. ⚫ 五子棋 vs AI —— 15×15，AI 会进攻也会堵你；
11. 🦘 跳一跳 —— 按住蓄力、松开起跳，落点越准加分越多；
12. 🧱 打砖块 —— 移动挡板反弹小球，清完进入下一关、球速递增；
13. 🔨 打地鼠 —— 30 秒限时点击打地鼠，命中 +1、打空 -1；
14. ⚫ 黑白棋 vs AI —— 8×8 奥赛罗，角最重要，无棋可下自动让位；
15. 🐦 Flappy —— 点击/空格振翅穿过柱子缝隙，越远分越高；
16. 🧩 数独 —— 9×9 标准数独，D 键切换难度，填满无冲突即胜；
17. 🟡 吃豆人 —— 经典迷宫吃豆，力量豆可反吃幽灵；
18. 🎯 跟枪练习 —— FPS 跟枪：锁定鼠标转视角压住三维漂移靶子，左键射击有后坐力。

• 预留扩展接口：游戏注册表（registerGame），新增游戏只需实现一个接口。
• 体验细节：隐藏窗口/切换标签页时自动暂停游戏、恢复时继续；每局最高分存

localStorage；键盘输入只在点击游戏区域后生效，不会劫持聊天输入框。

• 尺寸自适应：游戏画布按面板真实可用空间自适应（工具条+画布+按键提示整体

始终完整展示，不出现滚动条；浏览器缩放/面板拖宽缩窄都会自动重排），宽高上限 960px。

你的 DSH 版本决定装哪个插件版本（装错会崩：常见症状 useConversation is not a function）

- DSH 0.1.2-alpha.1 ~ 0.2.1-alpha.1：装新版（下方默认命令；各 DSH 版本对应的插件 tag 见下方变更记录）

- 更旧的 DSH（0.1.1-rc.2 及以前）：无可用版本

安装

前置：已构建的 DSH 20260808+ 快照、pnpm。

# 方式一：git 依赖固定 tag（公开镜像，推荐；也可用 github:lhh010/dsh-minigames）
dsh plugin --profile web add '@dsh-external/dsh-minigames@github:lhh010/dsh-minigames#v0.3.27'

# 方式二：本地安装
git clone https://github.com/lhh010/dsh-minigames.git   # 或直接使用本目录
cd dsh-minigames
pnpm install
pnpm build

# 装入当前 web profile（自动写入依赖并加入 dsh.profile.bundles）
dsh plugin --profile web add /绝对路径/to/dsh-minigames

# 可选：确认组合配置只出现一个插件行
dsh --profile web --dump-config | grep dsh-minigames

安装提示：pnpm 11 首次安装可能拦截 node-pty 等构建脚本——在 ~/.dsh/profiles/web 下执行 pnpm approve-builds --all 放行后重跑安装命令；装完硬刷新浏览器（Ctrl/Cmd+Shift+R）。

智能版本门控更新提示 / DSH-gated update chip

更新浮标会结合当前运行的 DSH 版本（宿主端从 dsh 安装清单读取）与仓库根的 compatibility.json（版本→支持的 DSH 列表，精确匹配）判定提示形态：

• 最新版支持当前 DSH → 正常「新版本 vX 可用，点击更新」；
• 最新版需要更高 DSH、但存在支持当前 DSH 的中间新版 → 提示更新到中间版，并注明「另有 vX 需更高 DSH」；
• 最新版需要更高 DSH、且当前 DSH 无任何可用新版 → 琥珀色信息条：「新版本 vX 支持更高 DSH 版本，当前 DSH vY 暂不可用」，不提供直接升级。

兼容数据拉取失败或无该版本条目时，自动回退为旧的普通升级提示（离线安全）。发版时需同步维护 `compatibility.json`（与版本表/变更记录同一步骤新增一行）。

2026-10-04 · v0.3.27 — 声明支持 dsh-v0.2.1-alpha.1

• 声明：支持 dsh-v0.2.1-alpha.1（升级实机验证：web 宿主七插件挂载激活正常，零适配改动）；typecheck/210 单测/构建全绿

2026-09-29 · v0.3.26 — 声明支持 dsh-v0.2.0-rc.2

• 声明：支持 dsh-v0.2.0-rc.2（升级实机验证：六插件挂载激活正常，零适配改动）；typecheck/210 单测/构建全绿

2026-09-28 · v0.3.25 — 声明支持 dsh-v0.2.0-rc.1

• 声明：支持 dsh-v0.2.0-rc.1（升级实机验证：六插件挂载激活正常，零适配改动）；typecheck/210 单测/构建全绿

2026-09-28 · v0.3.24 — 声明支持 dsh-v0.1.7-rc.2

• 声明：支持 dsh-v0.1.7-rc.2（npm 升级实机验证：六插件挂载激活正常，零适配改动）；typecheck/210 单测/构建全绿

2026-09-24 · v0.3.23 — 声明支持 dsh-v0.1.7-rc.1

• 声明：支持 dsh-v0.1.7-rc.1（舰队扫检零错误零崩溃，零适配改动）；typecheck/210 单测/构建全绿

2026-09-23 · v0.3.22 — 新增 DSH 版本门控更新提示 + 声明支持 dsh-v0.1.7-alpha.2

• 新功能：更新浮标结合当前运行的 DSH 版本（宿主端点读取）与仓库 compatibility.json 判定——最新版不支持当前 DSH 时改提示「需更高 DSH 版本」（琥珀色信息条）或中间版本（蓝色+备注），不再误引导直接升级；兼容数据缺失时自动回退旧行为
• 声明：支持 dsh-v0.1.7-alpha.2（实机验证）；typecheck/210 单测/构建全绿

2026-09-21 · v0.3.21 — 修复视口缩放后悬浮按钮/窗口越界

• 修复：🎮 launcher 圆钮与浮窗坐标此前仅在加载/拖拽时夹回视口内，缩放窗口（或系统显示缩放变化）后可能落在屏幕外点不到，需刷新才能恢复；现监听 resize 实时重夹紧 launcher、浮窗位置与宽度（右吸附时重新贴右缘）并持久化
• 验证：typecheck/build/203 单测全绿；实机复现原步骤（缩小→拖至右缘→放大）确认按钮自动回到可视区

2026-09-15 · v0.3.20 — 声明支持 dsh-v0.1.6-alpha.1

声明支持 dsh-v0.1.6-alpha.1（npm 已发布，钉版本实机验证；client 插件面零代码差异，typecheck/203 单测全绿，实机加载正常）。安装命令统一更新为 #v0.3.27。

2026-09-11 · v0.3.19 — 声明支持 dsh-v0.1.5-rc.2

• 声明：rc.1 为 0.1.5 系列首个候选版本，client 插件面零代码差异；npm 已发布，钉版本实机验证
• 验证：typecheck/build/203 单测全绿；热挂载实机验证（青色「后台运行中」状态 + Token 用量面板为本轮新增功能，见下方更新记录）

2026-09-09 · v0.3.18 — 声明支持 dsh-v0.1.5-alpha.2

• 验证：alpha.2 改动为 Sidebar 文档预览、模型文件交付、minimal 默认工具调整与 fs-ext 安装修复，client 插件面零代码差异；npm 已发布，钉版本实机验证；typecheck/build/203 单测全绿，启动清单确认加载

2026-09-08 · v0.3.17 — 声明支持 dsh-v0.1.5-alpha.1

• 验证：0.1.5 改动在会话格式 V3 / ctx.agent 移除 / 宿主 client bundle 服务路由改 /plugins/?? 组合路由，client 插件面零代码差异；npm 已发布，钉版本实机验证；typecheck/build/单测全绿，启动清单确认加载

2026-09-05 · v0.3.16 — 声明支持 dsh-v0.1.3-alpha.2

• 验证：alpha.2 改动全在 pi-ai / Web 顶栏 / 子代理消息 / host 面，client 插件面零代码差异；npm 已发布，钉版本实机验证；typecheck/build/单测全绿

2026-09-04 · v0.3.15 — 声明支持 dsh-v0.1.3-alpha.1

• 验证：0.1.3 破坏性变更集中在 host/session 侧（SessionHandle / session format v2），client 插件面零代码差异；npm 未发布，源码宿主实机验证；typecheck/build/203 单测全绿

2026-09-03 · v0.3.14 — 声明支持 dsh-v0.1.2-rc.1

• 验证：alpha.5→rc.1 为纯版本号提交（252 文件零代码差异）；实机 rc.1 验证通过，无需代码改动

2026-09-02 · v0.3.13 — 声明支持 dsh-v0.1.2-alpha.5

• 验证：对 alpha.5 源码 typecheck/build 全绿；alpha.5 为纯 bug 修复，无插件面向 API 变更

2026-09-02 · v0.3.12 — 声明支持 dsh-v0.1.2-alpha.4

• 验证：对 alpha.4 源码 typecheck/build 全绿；版本路由标注扩充到 alpha.4

2026-09-02 · v0.3.11 — 更新提示词补版本路由与排查指引

• 修复（更新提示词）：提示词新增第 0 步（先 dsh --version 确认本地 DSH 版本，对照 README「版本兼容」表选对应 tag，不匹配则改装）与第 3 步（安装失败/版本不匹配/启动报错先查 README「版本兼容」「已知限制」章节）；原两步安装流程不变

2026-08-31 · v0.3.10 — 声明支持 DSH dsh-v0.1.2-alpha.3（typecheck/build + 203 单测全绿，实机验证）

2026-08-22 · v0.3.6 — 修复俄罗斯方块落地不消除（锁定延迟）

• 根因：方块落到最终位置后并不立即合并，要等下一次重力 tick 失败才锁定+消除——1 级时最长悬停 800ms，期间拼满的行看起来「该消除却没消除」；而高级别（120ms）又快到无法把方块滑进最左列，留下永远差一格的死列
• 修复：引入标准锁定延迟（lock delay）——落地后保留 400ms 可控窗口（可滑动/旋转微调，滑动与旋转会刷新窗口，每块最多刷新 15 次防无限拖延），到期自动锁定并立即执行消除；空格硬降/↓ 软降到底仍是即时锁定。同时在 lock() 内加入自检：满行若在消除后仍残留会输出错误日志（正常情况下不可能发生）
• 验证：新增 isLanded/lock 单测 2 例（含消除后守恒断言），203 例全部通过；typecheck、build 通过

2026-08-20 · v0.3.5 — 声明 DSH 0.1.1-rc.1 兼容性（实机 boot 验证）

• 验证：DSH npm 0.1.1-rc.1 实机 boot 验证通过——boot 清单包含 @dsh-external/dsh-minigames、client.js 返回 200；本插件为纯浏览器端 bundle（document.body portal），不依赖任何宿主服务或布局槽位，0.1.1-rc.1 上零改动，全部 18 款游戏行为不变

2026-08-20 · v0.3.4 — 修复黑白棋 HUD 棋子符号反向

• 修复：黑白棋 HUD 与终局比分的棋子符号与直觉相反——此前实心 ● 配的是黑棋（玩家）计数、空心 ○ 配的是白棋（AI）计数，读起来像比分/胜负算错了。现改为 ○（空心）= 黑棋（玩家）、●（实心）= 白棋（AI），与棋盘实际棋子一致；落子/翻转/终局判定逻辑不变（已用 300 局随机模拟验证）。

2026-08-16 · v0.3.3 — 浮动窗口与可拖动 🎮 启动按钮

• 面板浮动窗口化：折叠态由右侧 rail 改为圆形浮动 🎮 按钮；展开态为可拖动、

边缘吸附（左右停靠/上下贴边）的浮动窗口，位置、停靠状态与宽度持久化

• 🎮 按钮可拖动：按住拖动（位移超过 5px）移动按钮并限制在视口内，松手记住

位置（dsh-minigames:launcher）且不触发打开面板；未位移的单击才打开窗口

• 调宽修复：拖左缘调宽改为锚定窗口实际右缘（原实现隐含右缘贴边的假设）
• 可访问性：折叠态由 ` 改为原生
• 验证：typecheck 与 201 个单测通过；实机加载验证通过

2026-08-11 · v0.3.2 — 恐龙跳一跳角色美化

• 🦖 小恐龙：按经典像素矩阵重绘——大头朝右、上翘尾巴、流线身体、

两条跑步腿（跳跃收起）、白色像素眼；白天近黑、夜晚反白

• 🐦 鸟：圆润身体 + 前伸头 + 尖嘴 + 扑动翅膀 + 尾巴，双调色板
• 🌵 仙人掌：圆角圆顶 + 弯折手臂 + 竖纹肋线 + 顶部高光，双株同理
• 验证：typecheck 与 201 个单测通过；实机加载验证通过

2026-08-11 · v0.3.1 — 跟枪练习 FPS 化与多游戏打磨

• 🎯 跟枪练习 FPS 化：Pointer Lock 鼠标锁定（光标隐藏）、准星固定屏幕中央、

鼠标增量转视角（含俯仰，修复上下方向）、目标三维漂移（横向 + 高度浮动）、 左键射击（后坐力视角上跳回落 + 随机横向晃动衰减 + 可见子弹弹道与命中火花）、 右下角第一人称步枪 viewmodel、开枪枪口火光、暂停/开始覆盖层提示

• 🔨 打地鼠：3×3 → 5×5（25 洞），同时冒头最多 5 只
• 🟡 吃豆人：嘴巴补集动画（张嘴闭嘴）、幽灵走路与眼睛转向、

格子对齐移动（不再中心/墙体晃动）、撞墙回中不卡死、开局幽灵缓冲、 幽灵出生点移到上部通道两端