前言¶
如果你用 DeepSeek Harness（DSH）做过「让 agent 写个小玩意儿」的尝试，大概会遇到两件事：agent 生成了一堆代码或 Markdown，你没法立刻玩起来；想让画面好看一点，就得自己准备美术资源、调尺寸、对齐风格。DSH 的解法是插件化——把生成、预览、试玩、导出这些环节打包成一个插件交给 agent 调用，而不是让它自由发挥。
DSH Game Studio 就是这类插件，由 ZSeven-W 维护，包名 @zseven-w/dsh-game-studio，分类在社区目录里归为「趣味换装」一类的轻量玩乐方向，许可证 MIT，当前插件版本 0.1.0-rc.2，已在 DSH 0.2.1-rc.5 上测试。它解决的问题很具体：你用一句话描述一个小游戏，agent 从模板生成、自动试玩确认能跑、在侧栏里实时渲染给你看，之后可以按编号替换 AI 生成的美术，最后导出成一个离线 HTML。
下面按功能、安装、用法、注意事项依次介绍。
它是什么¶
一句话定位：DSH Game Studio 是一个 DSH 插件，输入一句游戏描述，输出一个可玩的游戏。
它面向两类人：一是想在对话里直接得到能玩的东西、不想离开终端去开编辑器的 agent 使用者；二是想要一个可被 agent 反复修改、有版本可回退、能单文件交付的轻量游戏原型工具的人。它不是游戏引擎，不面向需要复杂物理、多人联机或资产管线的项目。
核心功能¶
两个模板起步¶
插件内置两个模板：2D 俯视角（collector）和同一玩法逻辑的 3D 体素世界（voxel，基于 three.js）。agent 拿到一句话后，改的是角色、规则、关卡和界面，不是从零写渲染。也就是说，如果你要的是「收集 + 躲避」这类玩法，模板的命中率很高；其他类型也能做，但需要更多迭代。
侧栏实时预览¶
游戏运行在对话旁的沙箱 iframe 里，每次改动触发重建并刷新预览，面板下方列出美术槽位、候选图和版本。横屏游戏会用宽舞台显示。这是它和「让 agent 生成一个 HTML 文件自己打开」最大的差别：改代码的过程中就能看到结果。
AI 美术，花钱前先审批¶
角色初始是代码画的模型。想吃到正式美术时，game_studio_generate_asset 用 OpenAI 图像接口或本机 Codex CLI 为每个槽位生成 1–4 张带编号的候选图，可选参考图。在产生任何费用之前，会弹出审批卡，写明服务、张数和预估费用；你批准后才执行。你在聊天里附的图片可以作为参考图。
自动试玩¶
game_studio_playtest 在无界面的 Chrome 或 Edge 里跑最新代码，报告阶段、最高分、剩余生命、帧率、脚本错误并附截图。不靠方向键操作的游戏（格子、卡牌、瞄准、节奏类）需要在 window.__autoplay 里定义自动驾驶逻辑，试玩才会走到真实玩法循环。这是「agent 说做好了」和「确实能玩」之间的那道验证。
版本与导出¶
每次让游戏发生变化的构建都会存成版本，game_studio_restore_version 把代码、规则和美术一起回退；game_studio_export 生成一个不联网、自包含的 HTML 文件，任何浏览器都能打开，也可以放在任意静态托管上。game_studio_share 在本地网络上开一个临时只读链接，侧栏显示二维码，适合手机上试玩。
安装与启用¶
在 DSH 里将插件装到 profile，装完启动网页端：
dsh plugin --profile web add @zseven-w/dsh-game-studio@latest
dsh web
环境要求：
- DeepSeek Harness
0.2.1或更新（网页版或桌面版） - Node.js
24.11或更新（package.json 里engines声明的是>=24.11.0） - 同一台电脑上装有 Google Chrome 或 Microsoft Edge，用于自动试玩
生图是可选的：没有 OpenAI API key 也没有登录 Codex 时，游戏仍以代码绘制的角色运行。安装 AI 美术需要二选一：
| 服务 | 需要什么 | 说明 |
|---|---|---|
| OpenAI（GPT Image） | DSH 凭据或环境变量里的 key（默认 OPENAI_API_KEY） |
按张计费，审批卡显示预估；openaiBaseUrl 可以指向兼容 OpenAI 的网关 |
| Codex CLI | 已安装并登录 Codex（codex login） |
计入 Codex 订阅额度，不需要 API key；每张几分钟，后台运行 |
配置写在 profile 的 cordis.patch.yml 的 config 下，常用项：
| 选项 | 默认值 | 含义 |
|---|---|---|
imageProvider |
auto |
auto、openai 或 codex；auto 在有 OpenAI key 时用 OpenAI，否则用 Codex |
openaiModel |
gpt-image-2.5-flare |
OpenAI 图像模型 |
openaiBaseUrl |
OpenAI | 兼容 OpenAI 的接口地址 |
openaiCredential |
OPENAI_API_KEY |
存放 key 的凭据名或环境变量名 |
codexPath |
从 PATH 或登录 shell 中查找 |
Codex CLI 可执行文件 |
codexReasoningEffort |
low |
Codex 生图的推理强度 |
confirmSpending |
true |
每次生成前都请求批准 |
典型用法¶
在一个工作区文件夹里开会话，直接用自然语言提需求，不用记工具名：
做一个小游戏：小猫在厨房里偷鱼干，别被扫地机器人撞到。做一个 3D 小游戏：小骑士在城堡里收集金币，躲开骷髅兵，60 秒内收集 20 枚金币就算胜利。做一个消除小游戏：在 6×6 的格子里交换相邻的宝石，60 秒内拿到 1000 分就赢。
之后可以在同一会话里继续：
用 AI 给主角生成 2 张新美术，我在右栏挑。主角照着我附的这张图来画。导出成一个 HTML 文件。
侧栏上的应用、撤回、构建、导出、恢复、分享按钮，通过 /game-studio 命令调用的是同一批操作，也就是说人工按钮和 agent 调用走同一套逻辑，不会各改一份。
agent 实际调用的是 10 个工具，主要的几个：
| 工具 | 作用 |
|---|---|
game_studio_create |
从模板创建游戏，参数含标题、美术风格、orientation（竖屏或横屏）和 slots（游戏自己的美术槽位，用用户的语言命名） |
game_studio_build |
改完 game.json 或 game.js 后重建、刷新预览，并附一句说明存成一个版本 |
game_studio_playtest |
无界面试玩，报告阶段、最高分、生命、帧率、错误和截图 |
game_studio_generate_asset |
给一个槽位生成 1–4 张候选图，可选参考图，花钱前先审批 |
game_studio_apply_asset |
按编号把候选图放进游戏并重建 |
game_studio_revert_asset |
把某个槽位恢复成上一张美术 |
game_studio_versions |
列出已保存版本，最新在前 |
game_studio_restore_version |
把整个游戏恢复到较早版本 |
game_studio_export |
导出自包含、可离线游玩的 HTML |
game_studio_share |
开启或关闭本地网络上的临时只读链接 |
游戏项目在磁盘上的样子¶
每个游戏就是工作区里的一个普通文件夹：
game.json：标题、美术风格、横竖屏、美术槽位和规则。规则是自由格式，任何键都会以window.GAME.rules传给游戏。game.js：agent 编辑的游戏代码。提供window.__gameState()供试玩读取；不用方向键操作的游戏可选提供window.__autoplay(state)；提供window.__renderSlots(size)后，侧栏能显示代码绘制的角色。assets/：每个槽位的图片，加记录每张图来源的ASSETS.json。直接改槽位文件会被记为你的修改。dist/index.html：当前构建产物；.studio/存放版本、候选图和试玩记录。
这意味着工作区以外的依赖几乎为零，游戏目录可以直接复制、提交或搬家。
适用场景与注意¶
适合的场景：
- 想在对话里直接得到能玩的东西，不想开编辑器
- 「收集 + 躲避」这类收集玩法的原型，模板覆盖度高
- 需要可回退、可单文件交付的轻量游戏产物
需要留意的：
- 插件以当前 DSH 进程的权限运行。它会读写工作区目录、按配置调用生图服务、在本地网络上监听分享端口，装之前应先读一遍源码，确认这些行为符合你的预期。许可证是 MIT。
- 这是
0.1.0-rc.2，属于 rc 阶段，接口和模板还可能变。README 里「实际效果」一节给出的数据是作者自己在真实 DSH 里用 DeepSeek-V4.1-Flash 做的一轮测试（2026-11-04/05，样本量 20）：收集加躲避类 10 个需求首轮都能玩，中位用时约 14 分钟；其他十种类型都能做出能玩的游戏，但中位用时约 26 分钟，加入__autoplay、自定义美术槽位和横屏支持后复跑其中 4 个，用时降到 8–18 分钟。作者自己也标注了样本较小，不要把这一轮数据当作普遍结论。 - 生图会离开本机：发往所选服务的只有提示词和你提供的参考图。分享链接只在本地网络监听、默认 30 分钟后自动关闭。这些设计降低了风险，但不是免疫，走代理或公司网关时注意
openaiBaseUrl指向哪里。
结尾¶
DSH Game Studio 的价值在于把「描述—生成—试玩—换美术—导出」压成一次对话，中间省掉的是手动打开浏览器、手动找素材的来回。适合做小玩意和原型验证，不适合做正经游戏项目。
- 社区目录页：https://www.skillhub.cn/plugins/ZSeven-W/dsh-game-studio
- GitHub：https://github.com/ZSeven-W/dsh-game-studio
目录页归为「趣味换装」分类，仓库自带 README 中/英等 15 种语言版本，README.zh.md 是中文一手文档。
