LeeGuanWei-a/dsh-mini-games-lee

🎮 dsh-mini-games-lee — DeepSeek Harness 小游戏合集

在 DeepSeek Harness Web GUI 上运行的小游戏合集：一个毛玻璃悬浮窗，内含 4 个游戏，可随时切换、拖动、收起。

| 游戏 | 玩法 | 排行榜 |
|---|---|---|
| 🕹️ 俄罗斯方块 | 7-bag 出块、墙踢旋转、消行计分、逐级加速、下一块预览 | 分数（高→低） |
| 🐍 贪吃蛇 | 15×15 网格，吃食物变长、撞墙/自撞结束、每 3 个加速一级 | 分数（高→低） |
| 🔢 2048 | 4×4 合并到 2048，键盘或屏幕方向键 | 分数（高→低） |
| 💣 扫雷 | 初级 9×9/10 雷、中级 12×12/24 雷，左键翻开 / 右键标记，首点安全 | 用时（低→高） |

共性：
- ☀️/🌙 深浅色主题一键切换，毛玻璃背景
- 窗口可拖到页面任意位置，▁/✕ 收起为标题条（自动暂停），□ 还原
- 每个游戏独立排行榜（最近 10 局，localStorage 持久化、可清空）
- 键盘全局操作（打开期间无需点击窗口），同时提供屏幕按钮，输入框打字不受影响

✅ 运行环境（版本标识）

| 组件 | 版本 |
|---|---|
| @deepseek-ai/dsh（Harness CLI / Web GUI） | 0.1.2-rc.1（开发与实测版本） |
| Web GUI 地址 | http://127.0.0.1:3080 |
| 宿主接口依赖 | shell.overlay、conversation.session.header.utilities、timer（inject: ['timer']） |
| 插件形态 | Host-resident Client Plugin（node 半区空 apply + 浏览器半区 ./client） |

⚠️ dsh.client 元数据、window.__ModuleLoader__.load 浏览器产物与宿主 roster 扫描机制绑定本版本 harness。换版本装配前请核对插槽名与 timer 契约。

🚀 安装（一条命令）

仓库根目录即 npm 包，lib/ 已构建并提交，可直接从 GitHub 安装：

dsh plugin --profile web add github:LeeGuanWei-a/dsh-mini-games-lee

安装时包内 dsh.bundle.patch（cordis.patch.yml）会把插件行自动插入 profile 层叠：

- insert:
- id: dsh-mini-games-lee
name: 'dsh-mini-games-lee'

重启 Web 后：页面中央出现小游戏窗口；会话头部右侧工具区出现 🎮 入口（用来重新打开）。

升级 / 回滚：

dsh plugin --profile web remove dsh-mini-games-lee
dsh plugin --profile web add github:LeeGuanWei-a/dsh-mini-games-lee

🎮 操作

窗口顶部是一排 游戏标签，点击切换（切换会开始新的一局）。

🕹️ 俄罗斯方块

| 操作 | 按键 / 屏幕按钮 |
|---|---|
| 左右移动 | ← / →，或 ← → |
| 软降（+1/格） | ↓，或 ▼ |
| 旋转（带墙踢） | ↑ 或 X，或 ↻ |
| 反向旋转 | Z |
| 硬降（+2/格） | 空格，或 ⤓ |
| 暂停 / 继续 | P，或 Ⅱ |

🐍 贪吃蛇

| 操作 | 按键 / 屏幕按钮 |
|---|---|
| 转向（反向输入被忽略） | ← → ↑ ↓ 或 WASD，或 ↑ ← ↓ → |
| 暂停 / 继续 | 空格 或 P，或 Ⅱ |

🔢 2048

| 操作 | 按键 / 屏幕按钮 |
|---|---|
| 滑动合并 | ← → ↑ ↓ 或 WASD，或 ↑ ← ↓ → |
| 暂停 / 继续 | P，或 Ⅱ |

💣 扫雷

| 操作 | 按键 / 屏幕按钮 |
|---|---|
| 翻开格子（首次点击才布雷，该格及周围保证无雷） | 鼠标左键 |
| 插旗 / 取消插旗 | 鼠标右键 |
| 切换难度（初级 9×9 · 中级 12×12） | 初级 / 中级 |
| 重新开始 | ↺ 新局 |

📦 仓库结构

dsh-mini-games-lee/
├── package.json            # npm 包：dsh.bundle.patch + dsh.client 元数据 + exports
├── cordis.patch.yml        # 自注册插件行（安装自动插入 profile）
├── src/
│   ├── index.js            # node 半区：空 apply（纯 UI 插件）
│   ├── client.js           # 浏览器半区入口：游戏注册表 + apply
│   ├── shared/
│   │   ├── theme.js        # 深浅色板
│   │   ├── records.js      # 按游戏分库的 localStorage 排行榜
│   │   ├── store.js        # 窗口状态（open/theme/pos/game）
│   │   └── ui.js           # 悬浮窗框架：拖拽、游戏标签、通用排行榜、入口按钮
│   └── games/
│       ├── tetris.js       # 🕹️ 俄罗斯方块
│       ├── snake.js        # 🐍 贪吃蛇
│       ├── g2048.js        # 🔢 2048
│       └── minesweeper.js  # 💣 扫雷
├── lib/                    # 已构建产物（提交在仓库，克隆即装）
│   ├── index.js
│   └── client.js           # 全部模块内联 + ModuleLoader 注册形态
└── scripts/build-lib.mjs   # src → lib 内联打包（改源码后 npm run build）

加一个新游戏
1. 在 src/games/ 新建模块，导出一个游戏对象：

export const MYGAME = (() => {
function View(props) {           // props: { ctx, th, active, onGameOver, onOpenRank }
// 用 el(...) 渲染；props.th 提供当前主题色；
// props.active 为 false 时不要跑时钟/键盘；
// 一局结束时调用一次 onGameOver({ value: 分数, meta: '说明文字' })
}
return { id: 'mygame', title: '我的游戏', icon: '🎯', short: '短名', scoreOrder: 'desc', View }
})()

2. 在 src/client.js 的 GAMES 数组里加入它；
3. 把新文件加到 scripts/build-lib.mjs 的 MODULES 列表（放在 client.js 之前）；
4. npm run build 重新生成 lib/（记得提交）。

🏆 排行榜说明

- 每个游戏独立存储：dsh.minigames.records.v1.；
- 每局结束自动记录（扫雷只记胜利局），保留最近 10 条；
- 排序：多数游戏按分数降序，扫雷按用时升序；
- 数据保存在本机浏览器 localStorage，清站点数据 / 无痕 / 换浏览器会丢；
- 排行榜视图内可两次点击清空当前游戏的记录。

📄 许可证

MIT。