前言¶

做 HTML5 小遊戲原型，常規流程是選引擎、搭骨架、寫碰撞和輸入，再補適配和性能優化。如果交給智能體來做，問題通常出在兩處：一是每次對話都要重新交代技術選型和適配要求；二是碰撞檢測、對象池這類模式反覆手寫，輸出質量不穩定。

dsh-minigame-plugin 的做法是把這類經驗固化成技能文檔。DSH 的理念是「一切皆插件」，能力通過插件注入對話——裝好這個插件後，在 DeepSeek Harness 對話裏直接描述想做的遊戲，它會按需求選引擎、套用參考模式，輸出單文件、零依賴、打開即玩的頁面。下面介紹它的功能、安裝方式和典型用法。

這是什麼¶

dsh-minigame-plugin 是一個 DeepSeek Harness 插件，作者爲 sasajun2345，當前版本 0.1.0，MIT 許可。一句話定位：讓 AI 幫你快速創建各種 HTML5 小遊戲。

它不限定遊戲類型，2D 和 3D 都支持。分工很簡單：用戶提出需求，插件負責組合引擎和參考模式，把需求落成可玩的遊戲文件。

核心功能¶

• 引擎支持：Canvas 2D / Phaser.js / DOM + CSS / Three.js / Babylon.js，按需求自動選擇。前三者面向 2D 場景，Three.js 和 Babylon.js 面向 3D 場景。
• 參考文檔：內置 17 個參考文檔，覆蓋碰撞檢測、粒子系統、物理引擎、網格算法等可複用模式（README 英文概述處寫作 16，中文部分與項目結構均爲 17，此處以 17 爲準）。
• 音效與存檔：支持程序化音效、高分存儲。
• 多語言國際化：中/英/日/韓四語言，自動檢測瀏覽器語言，一鍵切換。
• 包體與性能優化：對象池、離屏 Canvas、InstancedMesh、設備分級、空閒降幀；文檔給出的指標爲 2D < 40 KB，3D < 128 MB。
• UI 自適應：自動適配 PC、平板、手機，支持虛擬搖桿、橫豎屏切換、劉海屏安全區域。
• 遊戲敘事：三幕式結構、角色設計、多結局。
• 高級 UI 設計：剋制構圖、去卡片化、暗色主題、有意識的動效。
• 產出形態：單文件、零依賴、打開即玩。

安裝與啓用¶

前置條件：Node.js >= 20.19.0、DeepSeek Harness 開發者預覽版。插件依賴 @deepseek-ai/dsh-skill-filesystem ^0.1.0-rc.6，隨安裝自動處理。

安裝到 Web 配置文件¶

執行下面的命令，把插件添加到 web 配置文件：

npx @deepseek-ai/dsh plugin --profile web add github:sasajun2345/dsh-minigame-plugin

驗證安裝¶

運行以下命令檢查配置：

npx @deepseek-ai/dsh --profile web --dump-config

輸出中應包含 dsh-minigame-plugin 層和 minigame-skill-filesystem 行，說明插件已正確加載。

本地開發與臨時試用¶

如果你在本地改這個插件，可以從當前目錄安裝：

npx @deepseek-ai/dsh plugin --profile web add .

也可以不打進配置，用補丁方式臨時試用：

npx @deepseek-ai/dsh web --patch ./cordis.patch.yml

典型用法¶

安裝後，在 DeepSeek Harness 對話中直接描述想做的遊戲即可，技能自動激活。不限制遊戲類型，任何類型都可以製作。例如：

幫我做一個彈球消磚塊遊戲
做一個貪喫蛇，要有粒子特效
創建一個暗黑主題的射擊遊戲
做一個 2048 遊戲，用粉嫩配色
做一個 3D 賽車遊戲，有氮氣加速
做一個 Roguelike 地牢探險遊戲

從這些例子可以看出，描述裏不需要指定引擎和實現細節——2D 還是 3D、要不要特效、用什麼配色，說清需求即可，引擎選型和模式複用交給插件處理。

適用場景與注意¶

適合兩類使用者：一是想快速產出可玩 HTML5 原型的開發者，用它省掉從零搭建的時間；二是想給自己的 DSH 智能體補上小遊戲生成能力的人，安裝後對話即用。

使用前有幾點需要留意：

1、插件以當前 dsh 進程的權限運行。安裝第三方插件前，建議先到 GitHub 倉庫閱讀源碼，確認行爲符合預期再安裝。
2、許可證爲 MIT，分發或二次開發前確認符合你的授權要求。
3、README 給出的包體指標（2D < 40 KB、3D < 128 MB）是文檔聲明的優化目標，實際結果與具體遊戲的複雜度相關。

小結¶

dsh-minigame-plugin 把小遊戲開發中的引擎選型、常見機制和適配優化整理成技能文檔，讓 DeepSeek Harness 能根據一句描述生成打開即玩的 HTML5 遊戲。對需要快速驗證玩法原型的場景，值得一試。

• 目錄頁：https://www.skillhub.cn/plugins/sasajun2345/dsh-minigame-plugin （社區目錄爲獨立站點，與 DeepSeek、幻方無官方從屬關係）
• GitHub：https://github.com/sasajun2345/dsh-minigame-plugin