dsh-minigame-plugin

DeepSeek Harness 小游戏制作插件 — 让 AI 帮你快速创建各种 HTML5 小游戏。

功能

• 帮助 AI 创建任意类型的 HTML5 2D + 3D 小游戏，不限制游戏类型，用户想做什么就做什么
• 提供 Canvas 2D / Three.js / Babylon.js 三大引擎，根据需求自动选择
• 内置 17 个参考文档，覆盖常见游戏机制的可复用模式（碰撞检测、粒子系统、物理引擎、网格算法等）
• 支持程序化音效、高分存储
• 多语言国际化：中/英/日/韩 四语言支持，自动检测浏览器语言，一键切换
• 包体与性能优化：对象池、离屏 Canvas、InstancedMesh、设备分级、空闲降帧，2D < 40 KB，3D < 128 MB
• UI 自适应：自动适配 PC、平板、手机，虚拟摇杆，横竖屏切换，刘海屏安全区域
• 游戏叙事：三幕式结构、角色设计、多结局，让游戏有故事性
• 高级 UI 设计：克制构图、去卡片化、暗色主题、有意识的动效
• 单文件、零依赖、打开即玩

插件能力

不限制游戏类型，由用户提出需求。以下是插件提供的能力和参考模式：

引擎支持

引擎	维度	包体	适用场景
Canvas 2D	2D	零依赖	所有 2D 游戏：动作、射击、益智、休闲、物理、平台
Phaser.js	2D	CDN	需要完整框架的复杂 2D 游戏
DOM + CSS	2D	零依赖	卡牌、文字、点击类轻量游戏
Three.js	3D	~150KB	所有 3D 游戏：动作、赛车、射击、解谜、模拟、RPG
Babylon.js	3D	~500KB	需要完整引擎的复杂 3D 场景

参考模式（可组合复用）

类别	参考文档	可复用模式
2D	弹球、贪吃蛇、射击、平台跳跃、消除、跑酷、俄罗斯方块、2048、打地鼠、记忆翻牌	碰撞检测、网格系统、对象池、物理模拟、视差滚动、粒子特效、动画过渡
3D	Three.js 完整参考	3D 场景、物理引擎、InstancedMesh、后处理、射线检测、空间音频
通用	多语言、性能优化、响应式、叙事设计、UI 设计	i18n、对象池、设备分级、三幕式结构、去卡片化 UI

安装

安装到 Web 配置文件

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

本地开发

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

临时试用

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

验证安装

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

输出中应包含 dsh-minigame-plugin 层和 minigame-skill-filesystem 行。

使用

安装后，在 DeepSeek Harness 对话中直接描述你想做的游戏即可，技能会自动激活。不限制游戏类型，任何类型的游戏都可以制作。 例如：

• "帮我做一个弹球消砖块游戏"
• "做一个贪吃蛇，要有粒子特效"
• "创建一个暗黑主题的射击游戏"
• "帮我做一个 2048 游戏，用粉嫩配色"
• "做一个跑酷游戏，移动端适配"
• "做一个 3D 赛车游戏，有氮气加速"
• "帮我做一个 3D 解谜游戏，物理拖拽"
• "做一个 Roguelike 地牢探险游戏"
• "做一个音游，节奏打击"
• "做一个钓鱼游戏，有收集图鉴"

项目结构

package.json              Harness bundle 配置
cordis.patch.yml          Cordis 插件补丁
index.js                  技能文件系统入口
skills/minigame/
  SKILL.md                核心技能文件
  references/
    canvas-api.md          Canvas 2D API 速查
    3d-games.md            3D 游戏开发（Three.js / Babylon.js）
    i18n.md                多语言国际化（中/英/日/韩）
    performance.md         包体优化与性能优化
    responsive.md          UI 自适应与多机型适配
    narrative.md           游戏叙事设计（三幕式结构）
    game-ui.md             游戏 UI 设计（克制构图、去卡片化）
    breakout.md            弹球消砖块
    snake.md               贪吃蛇
    shooter.md             射击游戏
    platformer.md          平台跳跃
    match3.md              消除游戏
    runner.md              跑酷游戏
    tetris.md              俄罗斯方块
    2048.md                2048
    whack-a-mole.md        打地鼠
    memory-card.md         记忆翻牌

依赖

• Node.js >= 20.19.0
• DeepSeek Harness 开发者预览版
• @deepseek-ai/dsh-skill-filesystem ^0.1.0-rc.6

许可

MIT

---

dsh-minigame-plugin (English)

A DeepSeek Harness plugin for creating any type of HTML5 2D/3D mini-game. No game type restrictions — users propose what they want, and the plugin composes capabilities to build it. Supports Canvas 2D, Three.js, Babylon.js, with 16 reference documents covering reusable game patterns.

Capabilities

• No game type limits — user proposes any game, plugin composes the right engine and patterns
• Canvas 2D / Three.js / Babylon.js / Phaser.js engines, auto-selected based on need
• 17 reference docs: collision detection, particle systems, physics, grid algorithms, 3D scenes, etc.
• Multi-language: Chinese / English / Japanese / Korean
• Performance: object pooling, offscreen canvas, InstancedMesh, device tiering
• Responsive: PC, tablet, mobile, virtual joystick, landscape/portrait
• Narrative: three-act structure, character design, multi-endings
• Premium UI: restrained composition, cardless layouts, dark theme, intentional motion

Install

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

Usage

Just describe the game you want to build in a DeepSeek Harness conversation. The skill activates automatically.

License

MIT