前言¶
做 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
