StemStudio:给 AI 的不是代码,是能被检查的命令
一条 DSL。三个进程。212 star。
StemStudio 是一个跑在浏览器里的 3D 游戏编辑器加运行时:React + Three.js + WebGPU,行为脚本、ECS、物理、多人、AI copilot 全在里面,MIT,2026-05-20 建库。
介绍它的人一般会说「浏览器变成了完整游戏引擎」。我觉得那句话没错,但漏掉了它真正的设计决定。
翻 docs/stem-script.md 的第一段,有一句写得很硬:
Stem Script is not a general-purpose scripting language. Each line resolves to an immutable command intent.
它给 AI 的不是 JavaScript,是一条命令契约。这才是这个项目值得写的地方。
一、先看看它长什么样

dashboard 实拍,2026-11-19 用无头 Chrome 抓的。注意横幅上的 BYOK 提示和「Import stemscript folder」。
界面本身说明了它的三条入口:描述一句话生成、导入 .stemscript 文件夹、从空白开始。左边那条「Switch to folder storage」是 local-first 的另一种存法——项目写进你选的文件夹,而不是浏览器数据库。
二、三个进程,都在你自己的机器上

bun run dev 起三个:编辑器 5173、Go 写的 AI 代理 8081、Colyseus 的多人房间 2567。
这是 local-first 的落地方式,不是口号:
- 编辑器在浏览器里,项目存 IndexedDB 或你选的文件夹;
- AI 代理是本地的 Go 程序,拿着你自己的 key 去调 provider——中间没有它的服务器,因为根本没有它的服务器;
- 多人 sidecar 是 Node + Colyseus,
bun run dev时自动拉起,两个标签页就能进同一个房间。
不用 AI 就不启动代理,不写多人就不启动 sidecar。代价是本地要装三样东西:Bun 1.0+、Go 1.21+、Node 20+。
顺带一个硬约束:它要求 WebGPU,不支持 WebGL。Chromium 上还有文件夹存储;Firefox / Safari 能用,但只能存 IndexedDB。
三、一行脚本,四层,最后变成一次不可变的意图

DSL 文本 → 解析后的命令意图 → CommandsRegistry → engine handler。
看一个真实的 .stemscript 片段(取自文档):
project title "Tiny Obby"
add group name=Level
add box name=Ground size=12,0.1,12 position=0,-0.05,0 color=#2d3748 parent=Level
add capsule name=Player size=0.5,1.8,0.5 position=0,0.9,0 color=#3b82f6
update Player tag=Player
physics engine rapier gravity=-9.81
behavior attach Player behaviorId=character config={isDefault:true,walkSpeed:3}
camera "DefaultCamera" cameraType=THIRD_PERSON defaultDistance=6
它长得像 shell 命令和 JSON 的混血:一行一条命令,key=value 传参,向量写成 0,1,0,配置块用 JSON 字面量,含空格的字符串加引号。add box 是简写,展开成 registry 里的 create_primitive。
关键是每一行都要先变成一个不可变的命令意图——命令名加归一化参数——然后跨过编辑器/引擎边界,由注册的 handler 执行。文档把这句话说得很清楚:handler 可以改场景、导资源、配运行时,但脚本那一行本身是一个稳定的请求,可以被检查、校验、重放、保存、复查和 diff。
而这一切成立的前提是一句更朴素的话:
The parser does not run arbitrary JavaScript.
解析器只做分词、别名解析和参数归一化。它不是一个小运行时,所以它没有能力做坏事。
四、为什么命令比代码好管
这不是口味问题。同一份能力,用「让 AI 写 Three.js 代码」和「让 AI 发命令」两种方式交付,工程属性完全不同:
| 维度 | 让 AI 写代码 | 让 AI 发命令 |
|---|---|---|
| 校验 | 只能等它跑挂 | 参数可以逐条校验 |
| 重放 | 靠代码本身可重入 | 同一份命令文件重放,结果可预期 |
| 复查 | 得读懂整段 JS | 一行一个动作,可以 diff |
| 权限 | 代码里的能力等于全部 | 能表达的动作就是命令表里的那些 |
| 兼容演进 | 改 API 就断 | 简写可以演进,raw registry 名兜底 |
这也是为什么 .stemscript 能当一个游戏的根文件——Stem-Studio/Games-StemScript 里那些例子,整套游戏就是一个脚本加一堆资产。
五、连 copilot 自己也被收窄了

同一个命令契约,人和 AI 走同一条路,但 AI 被挡在需要「你亲手选文件」的动作外面。
这一处是我读文档时最意外的:同一个 AI 有两套权限。
- Script Tool(项目所有者/管理员)能
import、exec(选文件或文件夹)、dump scene、export scene、save,还能跑管理员命令check/test; - playground 里的 copilot 只能做只读检查(
list/get)和实时编辑(add box、behavior attach);需要文件选择器、项目任务存储、外部资源搜索、打包导出的命令,一律拒绝,改给你 import / exec 那两行,让你自己执行。
这个设计比「AI 什么都能干」成熟。理由也很实在:在浏览器里,文件选择器必须由用户手势触发——这不是权限洁癖,是平台限制。但把它显式化成权限分层,而不是让 AI 撞墙报错,是可维护的做法。
还有一处细节值得记:管理员命令 check / test 不是另写一套断言,而是从写命令派生出探测。也就是说,测试的可信度来自「它测的就是刚才那条命令」。
六、局限
- 仓库三个月没推过提交。建库 2026-05-20,最后一次 push 是 2026-08-09,13 个 open issue。212 star、34 fork。这是公司项目,不是个人玩具——团队表里有 CTO、Head of Engineering 这些角色,官网 buildwithstem.com——但活跃度就摆在这里。
- WebGPU 是硬门槛。不支持 WebGL,意味着老设备、部分 Linux 驱动、旧 Safari 直接出局。这不是能靠 polyfill 绕的。
- 多人只是开发级。Colyseus sidecar 跑在你本机,房间调度、持久化、认证、扩容、反作弊都没有。文档也没假装有。
- AI 能力全是外链。BYOK 意味着你不付订阅费,但要付 provider 的钱;而且没有 key 时,生成入口就只剩「自己描述」的壳。
- 三套工具链。Bun + Go + Node 同时装,对只想试试的人来说门槛不低。
- 没有第三方复现。性能、稳定性、能撑多大的场景,都只有作者自己的说法。
七、我的判断
我认为它最值得抄的不是「浏览器里跑引擎」,而是把 AI 的操作面做成一个有边界的命令表。
这件事在很多「AI + 工具」的项目里被忽略了:大家忙着让模型多能,很少问「它做的每一步能不能被检查」。Stem Script 的答案是把动作收窄到可枚举——收窄会损失表达力,但换来四件事:能校验、能重放、能 diff、能限权。
我在别的项目里见过同一个动作的不同版本:Hypit 把时间轴收窄成词的投影,AnyCrawl 把解析收窄成 schema,Blender Skills 把验收收窄成六项检查。StemStudio 的版本是把「改游戏」收窄成命令。说法不同,问的是同一件事:你愿意为「可检查」放弃多少表达力?
它给出的答案偏保守,也因此更容易被信任。至于这个项目本身还能不能继续长——看一眼提交时间就知道,那已经不是技术问题了。
项目与资料
- 仓库:Stem-Studio/Engine(MIT)
- Stem Script 文档:docs/stem-script.md
- 用
.stemscript写的完整游戏:Stem-Studio/Games-StemScript - 官网:buildwithstem.com
数据来源:star / fork / issue / 建库与最后 push 时间 / 许可取自 GitHub REST API(2026-11-19);三个端口、依赖版本、provider 列表、WebGPU 要求与浏览器支持范围取自 README;四层契约、「不可变命令意图」「解析器不执行任意 JavaScript」、Script Tool 与 playground copilot 的权限差别、check / test 的派生方式取自 docs/stem-script.md 原文。dashboard 截图是 2026-11-19 用本机无头 Chrome 访问 buildwithstem.com/dashboard?mode=playground 得到的,未做任何修改。
Enjoy Reading This Article?
Here are some more articles you might like to read next:
- Blender Skills:能不能建出来不难,能不能过检查才难
- STE80 Humanizer:改写不难,改完事实还在才难
- AnyCrawl:LLM-ready 不是模型给的,是默认值给的
- Cheetah:常驻内存不该由模型大小决定
- AI Filmmaking Camera Control:让模型只抄镜头,不抄人
- 认知博弈:形式化、求解与可辨识性综述
- 麦田(Maitian):平台改版那天,不该让每个用户升级一次
- The Software Engineering Handbook:把工程判断写成一份自由度账本
- Hypit:你编辑的是词,秒是编译出来的
- Omni LoRA:一个 671 MB 的修正,要背两个任务