DiplomatHearth/roblox-ai-place-diff

Baseplate 是一个面向 Roblox Studio 的 AI 辅助构建工具，从终端运行。它先读取场景，再规划一次回合，并在任何内容进入 Studio 之前展示所有实例与 Luau 改动，因此不会仅凭代理说一句“完成”就当真。它适合希望把代码编辑器 AI 助手的审批与回滚习惯，用到场景结构和 playtest 上的 Roblox 开发者。

一次回合如何工作

Baseplate 读取实例树、当前选中项、脚本以及可选的 BASEPLATE.md 规则文件。它把整个回合呈现为 diff：+ 新增、~ 修改、− 删除，细到 Luau 的每一行。你批准前不会写入任何内容。会话模式改变确认节奏：--mode plan 绝不修改，--mode auto 或“本次会话不再询问”则跳过重复确认 README。

每个获批回合被包在单条 ChangeHistoryService 记录中，因此一次 Ctrl+Z 就能撤销整个回合。在 Rojo 项目中，同一回合还会成为一个 git commit，/rewind 列出各回合，并可在 Studio 与磁盘上回到其中任意一个。

构建完成后，Baseplate 会在独立的 playtest 中运行游戏并读取 Output。它修复报错并再次运行，直到干净，然后报告前后错误、检查了什么，以及保存在 .baseplate/turns/ 下的截图。文档声明的行为是：无法完成时会如实说明，而不是把回合报告为成功 README。

playtest 副本为何重要

Playtest 会在第二个 Studio 窗口中打开场景的本地副本。README 称该副本无法访问线上 DataStores，因此测试运行不会发放真实货币或覆盖真实存档。这是文档给出的隔离边界，并不保证每个项目的每个脚本都安全。

要求与边界

• Windows 10/11 便携版；Studio 插件以 Baseplate.rbxm 形式随版本发布，通过 baseplate plugin install 安装 releases。
• 模型默认使用 Ollama 的免费本地模型；Claude、GPT 或 Gemini 密钥是可选项 Ollama。
• 插件不在 Creator Store 上，因为其 playtest 检查使用 loadstring，商店不允许。
• 从源码构建需要 Rust 1.85+，构建插件还需要 Rojo 7.7 构建说明。
• README 承认它可能像任何开发者一样做出糟糕改动；设计上的保障是 diff、单步撤销与隔离的 playtest。发布从不自动进行：/publish 会询问，且 BASEPLATE.md 可完全禁用。
• 文档说明无遥测、无账号、无硬件 ID；插件仅通过 localhost 与终端通信。

项目采用 MIT 许可证 license，与 Roblox 无关，使用 Studio 公开的 MCP 服务器和插件 API；终端需要 Windows 机器，可选的 MCP/插件路径负责把它接入 Studio。