DSH 游戏工坊
一句话描述一个小游戏 —— 在 DeepSeek Harness 对话的侧栏里直接玩，换上 AI 美术，导出成一个 HTML 文件。
10 个 agent 工具 • 侧栏实时预览 • 2D 与 3D 体素模板 • OpenAI 或 Codex 生图、花钱前先确认 • 自动试玩 • 版本历史 • 单文件导出
English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Français · Español · Deutsch · Português · Русский · हिन्दी · Türkçe · ไทย · Tiếng Việt · Bahasa Indonesia
包名：@zseven-w/dsh-game-studio · 当前插件版本：0.1.0-rc.5 · 已在 DSH 0.2.1-rc.5 上测试
🎮 在线试玩游戏墙（10 款实测 2D/3D 小游戏，手机/电脑点开即玩） · 在线源订阅：finiking/dsh-games
agent 干活时，游戏就在右侧侧栏里运行；下方是带编号的 AI 美术候选，等你来挑
为什么用 DSH 游戏工坊
用大白话跟 agent 说想要什么游戏，比如「做一个 3D 小游戏：小熊猫在竹林里收集竹笋，躲开野猪」。它会从模板出发把游戏做出来，自己试玩一遍确认能玩，然后放进侧栏，你马上就能玩。角色一开始是代码画的模型；想要正式美术时，agent 用 OpenAI 或你的 Codex 账号生成候选图，你按编号挑一张，游戏里就换上了。每次改动都存成一个版本可以回退，做好的游戏能导出成一个离线可玩的 HTML 文件。
| 🎮 第一次回答就能玩 | 两个模板：2D 俯视角，以及同一套玩法的 3D 体素世界（three.js）。agent 会把它改成你描述的游戏：角色、规则、关卡、界面。 |
| 🖥️ 侧栏实时预览 | 游戏在对话旁的沙箱面板里运行，每次改动自动重建；下方列出美术槽位、候选图和版本。横屏游戏会用宽舞台显示。 |
| 🎨 换上自己的美术，花钱前先确认 | game_studio_generate_asset 用 OpenAI 图像接口或本机 Codex CLI 给每个槽位生成带编号的候选图。花钱之前会弹出审批卡，写明服务、张数和预估费用。你在聊天里附上的图片可以作为参考图。 |
| 🤖 自动试玩 | game_studio_playtest 在无界面的 Chrome 或 Edge 里玩最新代码，报告阶段、得分、帧率、脚本错误并附截图。不靠方向键操作的游戏（格子、卡牌、瞄准、节奏……）定义 window.__autoplay，试玩就能玩到真正的玩法。 |
| 🕰️ 版本历史 | 每次让游戏发生变化的构建都会保存；game_studio_restore_version 把代码、规则和美术一起恢复。 |
| 📦 单文件导出 | game_studio_export 生成一个不联网、自包含的 HTML 文件，用任何浏览器打开，或放到任意静态托管上。 |
| 📱 在手机上试玩 | game_studio_share 在本地网络上开一个临时只读链接（或通过 cloudflared 开启 Cloudflare 临时公网链接，发给任何网络下的朋友都能玩），侧栏里会显示二维码。 |
| 🌐 发布到 GitHub Pages | game_studio_publish 用本机已登录的 gh 把构建好的 HTML（或整面游戏墙）推到你名下的公开仓库并开启 GitHub Pages，生成关掉电脑也能长期游玩的网址。 |
| 🗂️ 游戏墙 | 点右栏的 +，选 游戏工坊 · 游戏墙：工作区里做过的游戏铺满一面墙，封面是最近一次试玩的画面，可按 2D/3D 筛选，按最近修改、版本数或名称排序。点一下就能玩，不经过 agent，也不花 token。你还可以订阅在线游戏源（owner/repo、GitHub 仓库地址或 GitHub Pages 网址），把别人发布的游戏合入墙内直接游玩。导出游戏墙会把本地游戏打包成一个离线网页，发给朋友就能玩。 |
用它做出来的游戏
> 🎮 在线试玩游戏墙（10 款 2D/3D 实测游戏，支持手机触屏与电脑直玩）：finiking.github.io/dsh-games/wall —— 安装插件后也可以在本地游戏墙「在线源」填入 finiking/dsh-games 直接订阅进侧栏游玩。
下面是实测中做出的四个游戏。每个都是新会话里用图下那一句话开始的；有几个后来在同一会话里又提了修改，已注明。游戏画面用游戏自带的自动驾驶录制。
《月光狐狸：灯笼岛》——3D 体素模板，实机画面
「做一个小游戏：小狐狸在月光森林里收集灯笼，躲开荆棘怪。」2D 模板；角色后来换成了挑选的 AI 美术
「做一个 3D 小游戏：小狐狸在体素小岛上收集灯笼，躲开荆棘怪。」3D 体素模板；灯笼模型在后续请求里重做过
「做一个 3D 小游戏：小企鹅在冰山上收集小鱼，躲开海豹。」3D；红帽子是后续请求加的
「做一个 3D 小游戏：小熊猫在竹林里收集竹笋，躲开野猪。」3D；角色后来换成 AI 美术，竹林仍是 3D
实际效果
在真实 DSH 里用 DeepSeek-V4.1-Flash 实测，每个游戏都在新会话里用一句话做出来，再由独立试玩打分（2026-11-04/05）：
- 收集 + 躲避类游戏（模板最擅长的类型）：10 句不同的需求，10 个首轮就能玩，每个游戏中位用时约 14 分钟。
- 其他类型：消除、推箱子、塔防、投篮、横版跳跃、节奏、赛车、卡牌对战、种菜、咖啡店经营。10 个都做出了能玩的游戏，但中位用时约 26 分钟。加入
__autoplay、自定义美术槽位和横屏支持后，复跑其中 4 个，用时降到 8–18 分钟。样本较小。
工具
| 工具 | 作用 |
|---|---|
game_studio_create |
从 collector（2D）或 voxel（3D）模板创建能玩的游戏，构建并显示在侧栏。参数包括标题、美术风格、orientation（竖屏或横屏）和 slots：游戏自己的美术槽位，用用户的语言命名。 |
game_studio_build |
改完 game.json 或 game.js 后重新构建、刷新预览，并附一句说明存成一个版本。 |
game_studio_playtest |
无界面地玩最新代码（手机竖屏或 960×540 横屏），报告阶段、最高分、剩余生命、帧率、错误和截图；characters: true 只返回角色特写。 |
game_studio_generate_asset |
用 openai 或 codex 给一个槽位生成 1–4 张候选图，可选参考图。花钱前先审批；Codex 在后台运行。 |
game_studio_apply_asset |
按编号把候选图放进游戏，重新构建并刷新。 |
game_studio_revert_asset |
把某个槽位恢复成上一张美术。 |
game_studio_versions |
列出已保存的版本，最新的在前。 |
game_studio_restore_version |
把整个游戏恢复到较早的版本。 |
game_studio_export |
导出一个自包含、可离线游玩的 HTML 文件。 |
game_studio_share |
在本地网络开启（或关闭）一个临时只读链接让手机试玩；传 public: true 则通过 cloudflared 生成任何网络都能打开的临时公网链接。 |
game_studio_list |
列出工作区里的游戏（标题、2D/3D、是否已构建、版本数），agent 能按名字找到「那个企鹅游戏」。 |
game_studio_export_wall |
导出游戏墙：一个离线 HTML 页面，每个已构建的游戏一个格子，点格子就能玩。 |
game_studio_publish |
通过本机已登录的 gh CLI 把已构建的游戏（或传 wall: true 把整面游戏墙）发布到 GitHub Pages，传 remove: true 则从仓库删除。操作前先经你批准，且只写入带有 .dsh-game-studio.json 标记的仓库。 |
侧栏上的按钮（应用、撤回、构建、导出、恢复、分享、发布）通过 /game-studio 命令调用同样的操作。
生图服务与费用
| 服务 | 需要什么 | 费用 | 说明 |
|---|---|---|---|
| OpenAI（GPT Image） | DSH 凭据或环境变量里的 API key（默认 OPENAI_API_KEY） |
按张计费到你的 key，审批卡上会显示预估 | 每批约一分钟。openaiBaseUrl 可以指向兼容 OpenAI 的网关。 |
| Codex CLI | 已安装并登录 Codex（codex login） |
计入你的 Codex 订阅额度，不需要 API key | 每张几分钟，在后台运行，完成后通知。 |
imageProvider: auto（默认）在配置了 OpenAI key 时用 OpenAI，否则用 Codex。confirmSpending 开启时（默认），你批准审批卡之前不会生成任何东西。角色图在交给你之前会检查透明背景和构图，并按槽位尺寸裁好。
安全与隐私
- 游戏在沙箱 iframe 里运行，内容安全策略禁止联网；导出的文件不发出任何网络请求。
- 离开你电脑的只有提示词，以及你提供的参考图，发往你选择的生图服务。
- 分享链接只读，只提供这个游戏的构建产物，到你设定的时间（默认 30 分钟）自动关闭。局域网链接只在本地网络上监听；公网链接在本地只监听
127.0.0.1，经你确认后通过 Cloudflare 隧道（trycloudflare.com）转发。 - 发布到 GitHub Pages（
game_studio_publish）通过本机已登录的ghCLI 完成（插件不接触你的 GitHub token），经你批准后只把构建产物 HTML 上传到公开仓库（任何人都能查看文件），且绝不写入没有.dsh-game-studio.json标记的现有仓库。 - 订阅的在线游戏在提供者自己的网站上以沙箱 iframe（
sandbox="allow-scripts"）运行，无法访问 DSH 或你的工作区，且在导出或发布本地游戏墙时绝不复制或转发第三方在线游戏。 - API key 从 DSH 凭据或环境变量读取，不会写进项目、日志或工具结果。
环境要求
- DeepSeek Harness
0.2.1或更新（网页版或桌面版），Node.js24.11或更新。 - 同一台电脑上装有 Google Chrome 或 Microsoft Edge，用于自动试玩。
- 生成 AI 美术需要 OpenAI API key 或已登录的 Codex CLI。都没有时，游戏仍可用代码画的角色正常运行。
- 可选：安装
cloudflared（macOS 可用brew install cloudflared）以使用公网临时分享链接；安装并登录gh（brew install gh并运行gh auth login）以发布到 GitHub Pages。
安装到 DSH
从 npm 安装到 DSH profile：
dsh plugin --profile web add @zseven-w/dsh-game-studio@latest
dsh web
快速开始
在一个工作区文件夹里开个会话，比如这样说：
做一个小游戏：小猫在厨房里偷鱼干，别被扫地机器人撞到。做一个 3D 小游戏：小骑士在城堡里收集金币，躲开骷髅兵，60 秒内收集 20 枚金币就算胜利。做一个消除小游戏：在 6×6 的格子里交换相邻的宝石，60 秒内拿到 1000 分就赢。
接着试试：
用 AI 给主角生成 2 张新美术，我在右栏挑。主角照着我附的这张图来画。导出成一个 HTML 文件。
配置
在 profile 的 cordis.patch.yml 里的 config 下设置：
| 选项 | 默认值 | 含义 |
|---|---|---|
imageProvider |
auto |
auto、openai 或 codex。 |
openaiModel |
gpt-image-2.5-flare |
OpenAI 图像模型；固定下来，结果才有可比性。 |
openaiBaseUrl |
OpenAI | 兼容 OpenAI 的接口地址，例如公司网关。 |
openaiCredential |
OPENAI_API_KEY |
存放 key 的凭据名或环境变量名。 |
codexPath |
从 PATH 或登录 shell 中查找 |
Codex CLI 可执行文件。 |
codexModel |
Codex 的默认值 | Codex 生图用的模型。 |
codexReasoningEffort |
low |
Codex 生图的推理强度。 |
codexTimeoutMinutes |
15 |
单张 Codex 图超过这个时间就放弃。 |
confirmSpending |
true |
每次生成前都请求批准。 |
cloudflaredPath |
从 PATH 或 Homebrew 目录查找 |
公网临时分享链接使用的 cloudflared 可执行文件。 |
ghPath |
从 PATH 或 Homebrew 目录查找 |
发布到 GitHub Pages 使用的 GitHub CLI（gh）可执行文件。 |
githubRepo |
dsh-games |
发布到 GitHub Pages 时在你账号下使用的公开仓库名。 |
游戏项目格式
每个游戏就是工作区里的一个普通文件夹：
game.json：标题、美术风格、横竖屏、美术槽位和规则。规则是自由格式，任何键都会以window.GAME.rules传给游戏。game.js：agent 编辑的游戏代码。它提供window.__gameState()供试玩读取；不靠方向键操作的游戏可选提供window.__autoplay(state)；提供window.__renderSlots(size)后，侧栏能显示代码画的角色（2D 模板在drawCharacter()里画角色）。assets/：每个槽位的图片，以及记录每张图来源的ASSETS.json。你可以直接改槽位文件，工坊会把它记为你的修改。dist/index.html是当前构建；.studio/里存放版本、候选图和试玩记录。
开发
npm ci
npm run build # 生成 lib/index.js、lib/client.js 和打包好的 three.js 运行时
npm test # node --test；找不到 Chrome 或 Edge 时跳过试玩相关测试
生态
- DSH Crew —— 从 Claude Code / Codex 把任务派给 DSH agent
- DSH iOS —— 在对话里直接操作 iOS 模拟器或 USB 连接的 iPhone
- DSH Android —— 在对话里直接操作 Android 模拟器或 USB 设备
- DSH Noema —— DSH 的长期记忆
- DSH OpenPencil —— 在对话里查看和编辑
.op设计文档
致谢与许可证
- three.js —— 打包进体素游戏的 3D 运行时（MIT）。
- qrcode-generator —— Kazuhiko Arase —— 侧栏分享面板里的二维码（MIT）。
- Playwright（
playwright-core）—— 自动试玩时驱动浏览器（Apache-2.0，运行时依赖）。 - 模板、角色图和体素模型均为本项目原创。
- 完整声明见 THIRD_PARTY_NOTICES.md。
许可证：MIT
