dsh-tetris — DSH 俄罗斯方块

经典俄罗斯方块，做成标准 DSH 插件 bundle：一条命令安装，在 DSH 侧栏点「🎮 俄罗斯方块」即可全屏游玩，支持跨玩家共享排行榜。

玩法预览

经典 10×20 俄罗斯方块，带现代玩法要素：

• 🎲 7-bag 随机：七个方块一轮洗牌，杜绝「脸黑」连抽
• 🔄 SRS 踢墙（Super Rotation System）：贴墙/贴地也能旋转
• 👻 幽灵方块：显示落点预览（G 开关）
• 💾 保留（Hold）：C 键暂存当前方块
• ⏱️ 锁定延迟：落地后 500ms 内仍可移动/旋转
• 🎵 音效 + BGM：Web Audio 合成《Korobeiniki》主题曲（M/B 开关，默认关闭）
• 🏆 最高分持久化：localStorage 保存历史最高分
• 🌍 跨玩家排行榜：所有安装者的分数进同一张榜（输入昵称上榜，离线自动暂存、联网后补交）
• 😎 副标题：AI干活~我摸鱼！

安装方法（给 DSH 玩家）

方式一（推荐）：安装 bundle

dsh plugin --profile web add dsh-tetris

• 从 npm 安装（预构建产物，无需构建授权）；或从 GitHub 安装源码：

  dsh plugin --profile web add github:jasoncanada77-star/dsh-tetris
  

  git 安装会跑 prepare 构建脚本，pnpm ≥10 首次需要你在 profile 的 pnpm-workspace.yaml 里允许：

  allowBuilds:
    dsh-tetris: true
  

• 重启 dsh web 后，侧栏底部出现 「🎮 俄罗斯方块」 按钮，点击即全屏游玩
• 卸载：dsh plugin --profile web remove dsh-tetris

提示：tool.view.cordis 是动态插件专属座位，bundle 版改用 shell.overlay（全屏浮层）+ sidebar.footer.action（入口按钮）。

方式二：动态插件（cordis_define）

不装 bundle，直接在当前会话里定义运行：

• code.client：把 dynamic/plugin/client.js 的全部内容粘贴进去
• code.host：留空（纯 Client 端）
• cordis_run 后在 Run 卡片内直接游玩（渲染在 tool.view.cordis）

排行榜说明

• 游戏结束（分数 > 0）后自动把本局分数提交到共享排行榜，右侧「排行榜」面板实时展示 Top 8
• 在「排行榜」面板输入昵称（最长 12 字，本地记住，默认「玩家」）即可上榜
• 离线降级：网络不可用时分数存入本地待提交队列，下次联网自动补交；排行榜显示「离线」但游戏不受影响
• 后端：默认指向免费的 kvdb.io JSON 键值存储（浏览器 CORS 可用），单榜保留最近 15 条高分
• 更换后端：改 src/client/index.js 顶部 LEADERBOARD.readUrl / writeUrl 常量即可指向任意 JSON 文档存储，无需改游戏逻辑
• ⚠️ 娱乐性功能：分数由客户端上报、无鉴权，防不了作弊；免费 KV 服务无 SLA

操作说明

按键	功能
← →	左右移动
↑	旋转（顺时针）
Z	反向旋转
↓	软降（每格 +1 分）
空格	硬降
C / Shift	保留/交换方块
P / Esc	暂停 / 继续
G	幽灵方块 开/关
M	音效 开/关
B	BGM 开/关

技术说明

标准 bundle 结构（官方 docs/user/develop/basic/publish.md 的"打包与安装"路线）：

• bundle manifest：package.json 声明 dsh.bundle.patch → cordis.patch.yml（insert 一行 dsh-tetris）
• 浏览器半部：exports["./client"] → lib/client.js，dsh.client.platform: "web"；模块加载器把它编入 /plugins/dsh-tetris/client.js
• Client 插件：src/client/index.js —— inject: ['slots']，注册 sidebar.footer.action（打开按钮）+ shell.overlay（全屏游戏）
• 构建：tsdown.config.ts 复刻官方 clientBundle 契约（cjs/browser + window.__ModuleLoader__.load({id, factory}) 闭包工厂 + react 走模块表 external）
• Node 半部：src/index.js 空 apply()（仅占位 host 行）
• 游戏引擎：与动态版同源；静态插件是普通浏览器模块，定时器直接用原生 setInterval/setTimeout/requestAnimationFrame，全部在 useEffect cleanup 中回收
• 排行榜：window.fetch 直连 JSON-REST 端点，游戏逻辑与传输解耦；卸载后经 disposed 标记丢弃异步结果

目录结构

dsh-tetris/
├── package.json            # dsh.bundle + dsh.client manifest
├── cordis.patch.yml        # 插件行 patch
├── tsdown.config.ts        # 构建配置（node 半部 + client bundle）
├── src/
│   ├── index.js            # Node 半部（空 apply）
│   └── client/index.js     # 浏览器半部（游戏 + 排行榜）
├── lib/                    # 构建产物（提交进仓库，git 安装无需构建也能跑）
├── dynamic/plugin/client.js  # 动态插件版（cordis_define 分发）
├── original/index.html     # 原始网页版（仅供对照）
└── README.md / LICENSE

上架状态

• 插件市场（dshmarket）的目录来自 awesome-dsh-plugin 注册表：提 PR 加一条 data/plugins/<owner>__<repo>.yml 即自动收录
• 仓库需满 1 天且 ≥10 commits（CI 自动检查），达到门槛后提交 PR

License

MIT