DIY Sandbox

DIY Sandbox是一款个性化编辑手机ui的小工具。作为运行在安卓设备上的Lua声明式沙盒创作工具，免费开源。它并非一款面向普通玩家的游戏，而是一个可编程的运行时容器——App本身是一个“空壳”，界面、功能模块甚至内嵌的小游戏，全部由一份Lua脚本目录来定义和驱动。这个app适合有编程基础的的用户去使用。

DIY Sandbox推荐理由

DIY Sandbox，可以用它从零搭建UI界面、嵌入Love2D游戏工程、连接网络、读写文件，甚至调用内置的AI Agent来辅助编写代码。它面向的是有编程基础、喜欢在移动端折腾自定义项目的开发者或爱好者。如果你正在寻找一款能在手机上编写Lua、搭建工具或跑通Love2D小游戏的沙盒环境，可以来悠悠下载了解详情。

DIY Sandbox核心功能与使用方式

1、声明式Lua UI搭建。App提供了一套完整的UI组件库，涵盖卡片、行、列、网格、列表、标签页、文本框、滑块等。所有界面元素都可以通过编写Lua表来定义，布局、颜色和交互逻辑不受原生页面的限制，你可以把它做成工具面板、游戏菜单甚至控制台。

2、Love2D工程嵌入与双向通信。标准Love2D游戏工程可以作为普通UI组件嵌入页面中，支持挂起、冻结、销毁三种生命周期状态，并允许UI层与游戏层进行双向消息通信。现成的Love2D工程无需大幅修改即可导入运行。

3、脚本热重载，改完即见。修改Lua脚本后不需要重新编译或打包，通过内置容器终端执行bash agent/app-reload命令即可让改动立刻生效，实现“一边改代码一边预览效果”的开发节奏。

4、原生能力工具箱。内置了Base64/Hex/URL编码、MD5/SHA/HMAC哈希、UUID生成、定时器、设备信息查询等常用原生能力，同时提供完整的文件API、键值持久化、SQLite存储以及HTTP/WebSocket网络请求支持。

5、内置AI Agent与Ubuntu容器。App内嵌了proot Ubuntu终端环境，并集成了opencode coding agent，可以在容器中让AI直接编辑沙盒的Lua脚本，再通过热重载立即验证效果。容器命令也可以绑定到按钮上，实现流式输出的交互工具。

DIY Sandbox背景、定位与适用场景

它适合在手机上快速验证Lua脚本逻辑、搭建轻量级工具界面、运行Love2D小游戏原型，或者利用内置的Ubuntu容器和AI Agent进行移动端的编码实验。

由于所有功能都由脚本驱动，它的形态完全取决于你写了什么，而不是预设了一套固定的功能菜单。

它适合有Lua编程基础或愿意学习Lua的开发者；喜欢在移动端折腾自定义工具、UI和交互原型的创作者；

以及想利用AI Agent辅助编写和调试脚本的技术爱好者。

如果你只是想找一款开箱即用的沙盒游戏来“玩”，它可能不是合适的选择；

但如果你想在手机上获得一个可编程、可热重载、可跑Love2D的Lua开发环境，它在这个定位上提供了相当完整的工具链。

DIY Sandbox特色亮点

“改脚本即改App”的声明式架构是它最核心的差异化

大多数工具类App的功能边界在开发时就已固定，用户只能在其提供的选项范围内使用。

DIY Sandbox反了过来：导航栏、页面内容、顶栏按钮、对话框，全部由一份Lua脚本目录声明式定义。

改脚本就是改App，不需要重新编译或安装。

这种“运行时由脚本定义”的设计，把App的形态控制权交还给了使用者，在移动端开发工具中并不常见。

脚本管理体系清晰，工程化程度较高

每一个工程单独存放在独立文件夹中，图片、音频、字体和Lua源码分类存放。

脚本目录、调试控制台和素材目录的分区明确，上手之后相当于在手机上拥有了一个自带渲染能力的Lua运行容器。

输入适配全面，不局限于触屏

触屏触摸、多点触控、手势滑动都可以在Lua中捕获，同时支持外接蓝牙手柄按键映射。

对于需要复杂交互的工具或小游戏原型来说，这层适配减少了从“想法”到“可操作原型”之间的摩擦。

DIY Sandbox使用教程与实用技巧

首次启动后先了解脚本目录结构

App首次启动时会将默认脚本释放到应用私有的脚本目录中。你可以在设置页的“导入/导出”功能中导出一份完整的脚本zip包到手机存储，便于在外部编辑器中查看和修改。

从修改main.lua开始上手

用手机上的文本编辑器打开main.lua，按照AGENTS.md的说明，尝试修改一个文字或添加一个按钮。

比如把某个text组件的显示内容改成你自己的话，保存后回到App，执行热重载即可看到变化。

这是熟悉声明式UI逻辑的最快路径。

善用热重载，但注意不要改崩主脚本

热重载让修改脚本后无需重启App即可生效，非常适合反复调试。但如果main.lua被改崩导致App无法正常打开，不必慌张——Agent入口（agent/main.lua）是独立加载的，仍然可以通过它来修复主脚本。

嵌入Love2D工程时，先确认生命周期状态

将Love2D游戏作为UI组件嵌入时，它支持挂起、冻结、销毁三种状态。

在编写UI层与游戏层的通信逻辑时，需要根据游戏当前所处的生命周期状态来决定消息的发送和接收时机，避免在游戏已经销毁后仍然尝试通信。

云端同步和自动备份建议保持开启

v0.3.5版本新增了云端同步手动触发按钮和定时自动备份本地数据的功能。

对于在手机上直接编辑脚本的场景来说，自动备份可以有效降低因误操作或应用异常导致脚本丢失的风险