DIY Sandbox 是一个面向有编程基础用户的 Lua 沙盒运行时，它把手机变成一个可以自由绘制界面、加载脚本工程的环境。启动后你可以直接覆盖默认的粒子沙盒界面，用 Lua 代码从零搭建按钮、滑块、文本框、弹窗和分页布局，原生兼容 Love2D 生态，现成的 Love2D 工程稍作调整即可导入运行。软件本体只是一个轻量加载器，真正的功能全部由脚本决定，适合想折腾工具面板、游戏菜单或控制台界面的用户。
1、界面组件与布局
内置卡片、行、列、网格、列表、标签页、文本框、滑块等 UI 组件，布局、颜色和交互逻辑都能通过 Lua 代码重新绘制，不受原生页面限制。
2、Love2D 工程嵌入
标准的 love2d 游戏工程可以作为普通 UI 组件嵌入页面，支持挂起、冻结、销毁三种生命周期状态，UI 层与游戏层之间可以双向传递消息。
3、原生工具能力
提供 Base64/Hex/URL 编码、MD5/SHA/HMAC 哈希、UUID 生成、定时器以及设备信息查询等能力，方便在脚本中直接调用。
4、免编译修改流程
调整界面布局、修改逻辑或增加功能，只需编辑 Lua 文件并重载工程，不需要经过编译、打包、安装这一整套流程。
1、脚本管理按工程划分，每个工程单独存放文件夹，图片、音频、字体和 Lua 源码分类存放，查找和替换素材都比较直观。
2、输入适配覆盖触屏触摸、多点触控和手势滑动，均可在 Lua 中捕获，同时支持外接蓝牙手柄的按键映射。
3、支持热重载，改完脚本直接重新加载工程即可预览效果，不必重启整个 App，适合边改代码边调试。
4、脚本管理、调试控制台和素材目录分区清晰，整体相当于手机上一个自带渲染能力的 Lua 运行容器，熟悉之后可操作空间很大。
1、App 首次启动时会把默认脚本释放到应用私有的脚本目录中。在设置页找到“导入/导出”功能，通常可以导出一份完整的脚本 zip 包到手机存储。
2、用手机上的文本编辑器打开 main.lua，按照 AGENTS.md 的说明尝试改一个文字或加一个按钮。例如把某个 text 组件的显示内容改成你自己的话。
3、改完并保存后回到 App。如果使用了内置的容器终端，可以在里面执行 bash agent/app-reload 命令重载脚本，让修改立刻生效，无需重启 App。
问题：DIY Sandbox 是给普通用户玩的游戏吗？
答案：不是。它是一个面向有编程基础用户的开源沙盒运行时，核心是让你用 Lua 脚本构建应用界面和逻辑。
问题：内置的 Ubuntu 容器和 AI Agent 需要额外配置吗？
答案：容器环境（proot Ubuntu）是内置的，但 AI Agent（opencode）的具体使用可能需要你自行配置 API 或模型接入。
问题：我写的脚本改崩了，应用打不开怎么办？
答案：项目设计了保护机制，Agent 入口（agent/main.lua）是独立加载的，即使你改崩了 main.lua，Agent 仍然可用，你可以通过它来修复脚本。
DIY Sandbox 的定位很明确，它不是给普通用户消遣的游戏，而是给有编程基础的人准备的 Lua 运行容器。完整的 UI 组件、Love2D 工程嵌入能力、热重载和脚本目录管理，让手机上的界面实验和工程调试变得顺手。内置的 proot Ubuntu 容器省去了自己搭环境的麻烦，AI Agent 则需要自行配置 API 或模型接入。如果你熟悉 Lua 或 Love2D，想随时在手机上改脚本、跑工程，这个工具值得一试。
欢迎关注我们
