DeepSeek Harness (DSH) 支持通過插件擴展功能。dsh-tetris 是一個 bundle 插件，將經典俄羅斯方塊嵌入 DSH Web 側欄。它支持全屏遊玩和跨玩家共享排行榜。
核心功能¶
該插件包含現代俄羅斯方塊的核心玩法要素：
- 7-bag 隨機：七個方塊一輪洗牌，避免連抽相同方塊。
- SRS 踢牆：支持貼牆和貼地旋轉。
- 幽靈方塊：顯示落點預覽。
- 保留（Hold）：暫存當前方塊。
- 鎖定延遲：落地後 500ms 內仍可移動或旋轉。
- 音效 + BGM：Web Audio 合成主題曲。
- 最高分持久化：localStorage 保存歷史最高分。
- 跨玩家排行榜：所有安裝者的分數進入同一張榜。
安裝與啓用¶
使用官方命令安裝：
dsh plugin --profile web add dsh-tetris
安裝完成後，重啓 dsh web。側欄底部會出現 「🎮 俄羅斯方塊」 按鈕，點擊即可全屏遊玩。
若從 GitHub 源碼安裝：
dsh plugin --profile web add github:jasoncanada77-star/dsh-tetris
使用 git 安裝會運行 prepare 構建腳本。如果你的 pnpm 版本 >= 10，需要在 profile 的 pnpm-workspace.yaml 中添加：
allowBuilds:
dsh-tetris: true
使用說明¶
進入遊戲後，在側欄輸入暱稱（最長 12 字，默認「玩家」）即可上榜。遊戲結束（分數 > 0）後，分數會自動提交到共享排行榜。
注意事項¶
- KV 服務限制：排行榜使用免費的 kvdb.io 服務，無 SLA 保證，數據可能不穩定。
- 安全性與防作弊：分數由客戶端上報，無鑑權機制，無法防止作弊。
- 離線支持：網絡不可用時，分數暫存本地，聯網後自動補交。
技術結構¶
這是一個標準 DSH bundle 插件：
* 入口點註冊在 sidebar.footer.action（按鈕）和 shell.overlay（全屏浮層）。
* 遊戲邏輯運行在瀏覽器端，使用原生 setInterval/setTimeout。
* 卸載命令：dsh plugin --profile web remove dsh-tetris。
