DIY Sandbox（包名com.diysandbox.android）App本身是一个空壳：导航栏、页面内容、对话框、按钮布局全部由一份Lua脚本目录声明式定义，修改脚本并重载即可实时改变应用形态，不需要重新编译。核心能力包括声明式Lua UI（card/row/column/grid/tabs/slider等组件，两级响应式状态）、Love2D画布嵌入（标准Love2D工程可作为UI组件挂载，支持挂起/冻结/销毁三态生命周期和双向消息通信）、网络能力（HTTP含SSE流式与multipart上传、WebSocket、系统状态栏通知）、文件与存储（完整文件API、共享存储、键值持久化、内置SQLite），以及内置的Ubuntu（proot）容器终端和opencode AI编码代理。开发者明确表示它不是给普通用户玩的游戏，而是面向有编程基础用户的开源沙盒运行时。

DIYSandbox大肥鱼介绍

Android DIY Sandbox是一个运行在Android上的Lua声明式沙盒运行时。

App本身是一个空壳运行时：导航栏、每个页面的内容、主页顶栏按钮、对话框、其实里面镶嵌的love2d小游戏，全部由Lua脚本目录式声明定义。改脚本即改App，不需要重新编译。

一句话：把手机变成一个可以用纯Lua快速搭UI、跑游戏、连网络、读写文件、并内置AI编码代理的简易沙盒。

DIYSandbox使用教程

1、App首次启动时，会把默认脚本释放到应用私有的脚本目录中。你可以在App的设置页里找到“导入/导出”功能，通常可以导出一份完整的脚本zip包到手机存储。

2、用手机上的文本编辑器打开main.lua。按照AGENTS.md的说明，尝试改一个文字、加一个按钮。比如，把某个text组件的显示内容改成你自己的话。

3、改完并保存后，回到App。如果你使用了内置的容器终端，可以在里面执行bashagent/app-reload命令来重载脚本，让修改立刻生效，无需重启App。

✨ 核心能力

• 声明式Lua UI —card / row / column / grid / list / tabs / textfield / slider … 一套整套组件，写Lua表即得间歇式Flutter界面；state/reactive两级响应式状态。

• love2d 功耗—love{}把标准love2d工程当成普通UI嵌入组件页面，支持挂起/冻结/热点三态生命周期，UI ↔ 游戏死亡消息通信。

• 网络— host.http（含SSE流式、分段上传）、、host.websocket系统状态栏通知，可做“后台监听→通知提醒”类应用。

• 文件与存储—完整文件API、原生共享存储(自动申请权限)、键值持久化、内置SQLite。

• AI Agent(opencode) — 内置 Ubuntu 容器 + opencode编码代理，可以在容器里让 AI 直接编辑本沙盒的 Lua 脚本，并用bash agent/app-reload热重载生效。

• 容器终端—内嵌Ubuntu(proot)终端，host.spawn把容器命令绑到按钮、流式输出。

• 工具箱—Base64 / Hex / URL编码、MD5/SHA/HMAC、UUID、定时器、设备信息等能力。

目录脚本内容AGENTS.md是完整的 Lua API 开发文档。

🚨 先说最重要的一件事：它不是沙盒游戏

“DIY Sandbox”这个名字是整篇介绍里最大的认知陷阱。它在下载站常被归到“沙盒模拟创作类工具”，描述里也写着“自由搭建、像素造物”。但打开之后你会发现，这里没有一堆方块让你摆放，也没有物理引擎让你堆叠物体。你面对的是一份Lua脚本，以及一个由这份脚本渲染出来的界面。导航栏有几个标签、每个页面放什么按钮、按钮点击后跳转到哪里、弹窗长什么样，全部由脚本里的表结构和组件声明决定。官方在常见问题里写得非常直白：“DIY Sandbox是给普通用户玩的游戏吗？不是。它是一个面向有编程基础用户的开源沙盒运行时”。

这意味着：如果你期待的是一个像《泰拉瑞亚》或《我的世界》那样“进入世界、开始建造”的体验，它给不了。它能给你的，是一个在手机上写Lua、实时看到界面变化、把Love2D小游戏嵌进去、连接网络和读写文件的可编程环境。把“DIY”理解为“Do It Yourself in code”，而不是“Do It Yourself in a sandbox world”，是使用它之前必须完成的认知切换。这个错位不解决，下载后的第一反应大概率是“这和我想的不一样”。

它实际能做什么：一个空壳运行时，用Lua填满

🖥️ 声明式Lua UI：用写代码的方式“画”出一个App

DIY Sandbox的UI不是用可视化编辑器拖拽出来的，而是用Lua表声明出来的。它提供了一套组件：card、row、column、grid、list、tabs、textfield、slider等，你用Lua写一个表结构，运行时把它渲染成原生的Flutter界面。配合state和reactive两级响应式状态，修改数据后界面会自动更新。这套机制的实际用途是：你可以用几十行Lua快速搭出一个工具面板、一个游戏菜单、一个控制台，甚至一个简易App的完整界面，而不需要配置Android开发环境、不需要编译APK。修改main.lua保存后，在容器终端执行`bash agent/app-reload`即可热重载，界面立刻变化。对于想快速验证一个界面想法、或者想在手机上直接改布局的人来说，这个循环非常短。

🎮 Love2D画布：把现成的Lua小游戏嵌进来

它原生兼容Love2D生态。Love2D是一个成熟的Lua 2D游戏框架，很多开源小游戏和原型都是用Love2D写的。DIY Sandbox通过`love{}`声明，把标准的Love2D工程当作一个普通UI组件嵌入页面，支持挂起、冻结、销毁三种生命周期状态，并且UI层和游戏层之间可以双向发送消息。这意味着你不需要为了在手机上跑一个Love2D小游戏而折腾打包和签名，把工程放进`games/`目录，在脚本里引用它，就能在App的某个页面里直接玩。对于做游戏原型、学习Love2D、或者想在手机上测试自己写的Lua小游戏的人，这个能力的便利性是直接的。

🌐 网络、文件与容器：不止是UI玩具

DIY Sandbox的能力不止于画界面和跑小游戏。网络层提供HTTP（含SSE流式响应和multipart上传）、WebSocket，以及系统状态栏通知，可以做出“后台监听数据、有更新时发通知”这类轻量应用。文件层有完整文件API、共享存储自动申请权限、键值持久化和内置SQLite。再往下，它内置了一个Ubuntu（proot）容器终端，`host.spawn`可以把容器命令绑定到按钮上，流式输出结果显示在界面里。这些能力叠在一起，让它具备了一个“手机上的可编程沙盒”的骨架，而不是一个只能改改文字和颜色的皮肤引擎。

🤖 AI编码代理：内置容器里的opencode

v0.3.5版本集成了opencode编码代理，运行在内置的Ubuntu容器里。理论上，你可以在容器终端里让AI直接编辑本沙盒的Lua脚本，然后用`app-reload`热重载生效。这个功能的设计意图是降低“改脚本”的门槛——不需要你自己逐行写Lua，可以用自然语言描述需求，让代理去改代码。但需要注意：AI代理的具体使用可能需要你自行配置API或模型接入，不是开箱即用，官方常见问题里也明确提到了这一点。把它当作一个“有潜力但需要配置”的辅助功能，而不是一个一键生成App的魔法按钮。

💰 收费与“免费”的真实边界

🤔 DIY Sandbox是免费的吗？

是免费的，多个来源标注“免费、无需谷歌市场”，项目采用BSD-3-Clause开源许可证，代码在GitHub上可审查。下载和基础使用不需要付费，也没有发现强制内购或会员墙的迹象。它的成本不在软件内，而在学习Lua和配置环境的时间上。你需要能看懂基础的Lua语法，理解表结构、函数调用和变量作用域，否则面对一份几百行的main.lua会无从下手。

📢 有广告或后台采集吗？

公开描述中没有广告弹窗或强制观看广告的机制。但需要如实指出：下载站页面列出的权限包括写入外部存储、完全网络访问、拍摄照片和视频、读取手机状态和身份、录音、唤醒锁定等。对于一个“Lua运行时”来说，网络、存储和唤醒锁定是合理的（联网、读写脚本和素材、保持容器运行），但摄像头、麦克风和读取手机状态这些权限的必要性，需要用户自己判断。开源代码可以审查，但普通用户未必有能力逐行核实。如果对这些权限敏感，可以在系统设置中限制其实际调用，或者只在备用设备上使用。

🍎 有iOS版本吗？

没有，而且开发者明确表示不计划推出。在相关讨论中，作者的说明是Apple没有像Android那样方便地创建可安装构建的方式，并且这类应用也难以通过App Store的审核。所以DIY Sandbox是一个Android独占的工具。如果你用的是iPhone，这个方向目前没有对应的官方产品。

🔁 同类“沙盒”产品的定位差异

❓ 常见问题

🎮 DIY Sandbox和《我的世界》《泰拉瑞亚》是一类东西吗？

不是，完全不是。《我的世界》和《泰拉瑞亚》是“进入一个世界、在里面挖掘和建造”的沙盒游戏；DIY Sandbox是“用Lua脚本定义App界面、嵌入Love2D小游戏”的运行时工具。它没有预设的游戏世界，没有可挖掘的地形，也没有物理沙盒让你堆叠物体。你面对的是代码和界面声明，而不是一个可探索的空间。把它理解为“手机上的Lua界面搭建工具+Love2D启动器”，比理解为“沙盒游戏”准确得多。

✍️ 不会Lua能玩吗？

很难。整个App的界面和功能都由Lua脚本定义，不写Lua就意味着你只能看默认皮肤，无法改动任何东西。官方常见问题里明确写了它面向“有编程基础用户”。但门槛也不是高到离谱：如果你懂一点编程基础（变量、函数、表/字典），Lua本身语法比较轻，花一两个小时能看懂基本结构。完全零基础的话，建议先补一下Lua的基础概念，再打开main.lua，否则面对几百行代码容易直接放弃。

💥 改脚本改崩了，App打不开怎么办？

项目设计了保护机制。Agent入口（`agent/main.lua`）是独立加载的，即使你把`main.lua`改崩了，Agent仍然可用，你可以通过它来修复脚本。这个设计考虑到了“写代码一定会出错”的现实。但保护机制只能保Agent入口不被拖垮，不保证你改崩的`main.lua`能自动恢复。养成在修改前导出脚本zip包的习惯，或者用版本控制工具管理你的脚本目录，比依赖任何保护机制都可靠。

🤖 内置的AI Agent能直接用吗？

容器环境（proot Ubuntu）是内置的，但AI Agent（opencode）的具体使用可能需要你自行配置API或模型接入。它不是“打开就能让AI帮你写App”的状态，你需要有可用的模型API和相应的配置知识。把AI Agent当作一个“有潜力但需要折腾”的附加能力，而不是一个开箱即用的核心功能。如果你本来就有使用AI编码工具的经验，它会是一个有趣的补充；如果你没有，不要因为它而决定下载这个App。

📱 我的手机能装吗？

官方只打包了arm64-v8a架构，minSdk为26（Android 8.0），但下载站标注的系统要求是Android 4.4以上。这意味着较老的32位设备或Android 8.0以下的系统，可能无法安装或运行。安装包82.21MB，需要预留足够的存储空间给脚本、素材和容器环境。如果你的手机是近几年的主流arm64机型，兼容性通常没有问题；如果是较老的设备，建议先确认系统版本和架构再下载。

👍 适合谁，不适合谁

适合：有Lua或编程基础、想在手机上快速搭建工具界面或App原型的开发者；想把Love2D小游戏直接跑在手机上、不想折腾打包签名的游戏原型作者；对“用脚本定义整个App”这种声明式UI模式好奇、愿意读代码和API文档的技术向用户；以及需要一个小型可编程环境来测试网络请求、文件操作或SQLite的移动端学习者。

不太适合：以为它是一个沙盒游戏、想进去自由建造和探索的普通玩家（这是最常见的错位）；完全不会编程、只想拖拽组件做界面的零基础用户；期待“打开就有现成功能”、不愿意读文档和改脚本的人；以及需要iOS版本的用户（开发者明确表示不计划推出）。如果你要的是一个休闲向的像素沙盒或物理沙盒，sand:box或Sandbox Playground才是更对应的选择，而不是DIY Sandbox。

⚖️ 优缺点速览

优点：声明式Lua UI让“改脚本即改界面”的循环非常短，热重载无需重启；原生兼容Love2D生态，现成工程可以较直接地嵌入运行；内置网络、文件、SQLite和Ubuntu容器，能力边界超出“UI玩具”；开源、免费、无需谷歌市场，代码可审查；Agent入口独立加载，改崩主脚本仍有恢复入口；体积82MB，在同类开发工具中不算沉重。

需要注意的点：名字和下载站分类容易让人误以为它是沙盒游戏，认知错位是最高频的“踩坑”；需要Lua基础，零编程经验上手困难；AI Agent需要自行配置API或模型，不是开箱即用；权限列表包含摄像头、麦克风、读取手机状态等条目，对一款Lua运行时来说需要用户自行判断合理性；仅arm64-v8a、minSdk 26，老设备兼容性受限；没有iOS版本，且不计划推出。

新手使用小贴士与避坑提醒

✏️ 下载前先在心里把“游戏”两个字划掉。如果你要的是进入一个世界自由建造，直接关掉这个页面，去看sand:box或Sandbox Playground。如果你对“用Lua定义App界面”这件事本身有兴趣，再继续往下看。这个判断花十秒钟，能省掉下载后“完全不是我想的那样”的失望。

✏️ 先导出默认脚本zip包，再动手改。首次启动后，在设置页找到“导入/导出”功能，导出一份完整的脚本zip到手机存储。这份备份是你在改崩main.lua之后的退路，比任何保护机制都直接。养成“改前备份”的习惯，折腾的成本会低很多。

✏️ 从改一个文字、加一个按钮开始，不要一上来就重构。用文本编辑器打开main.lua，找到一个text组件的显示内容，改成你自己的话，保存，重载，看界面变了没有。这个最小的成功循环会让你理解整个“脚本→渲染”的机制，然后再逐步加按钮、加页面。直接对着完整的组件文档从头写，容易在细节里迷失。

✏️ Love2D工程先放一个简单的进去。不要拿一个依赖大量第三方库的复杂工程来测试兼容性。找一个单文件的Love2D小游戏，放进games/目录，用love{}引用，确认能正常运行、UI和游戏能互相发消息，再考虑更复杂的集成。兼容性是“能用”和“好用”之间的分界线，先用简单的验证，再逐步加码。

💬 编辑点评

DIY Sandbox是一款被名字和下载站分类严重拖累的工具。“沙盒”这个词让它看起来像一个面向玩家的游戏，而它实际上是一个面向开发者的Lua声明式运行时。声明式UI、Love2D嵌入、网络与文件API、Ubuntu容器终端，这些能力组合在一起，在手机端确实少见，热重载和Agent保护机制也说明作者在“让折腾不那么痛苦”上花了心思。但它的问题同样清晰：它不是给普通用户的产品，Lua基础是一道真实存在的门槛，AI Agent需要自行配置，权限列表也需要用户自己判断。把它当作一个“手机上的可编程沙盒”来用，给有代码基础、想快速验证界面或跑Love2D原型的人，它在82MB的体积里提供了超出预期的可折腾空间；如果把它当作一个沙盒游戏来下载，它会在打开的第一分钟就让你困惑。最好的使用方式，是在下载前就读清楚它是什么，然后要么带着明确的目的打开它，要么干脆选择另一个真正面向玩家的沙盒。本站提供DIY Sandbox资源下载，具体版本、架构与文件信息以下载页展示为准。

📌 总结

下载DIY Sandbox之前，先确认三件事：你要的是一个用Lua脚本定义界面和逻辑的可编程运行时，而不是一个进入世界自由建造的沙盒游戏；你具备基础的Lua阅读能力，或者愿意花时间学；你能接受AI Agent需要自行配置、权限列表需要自己判断、iOS版本不存在这些现实边界。三个答案都清楚之后，它在“手机上的Lua UI搭建+Love2D运行”这个细分需求上，是一个免费、开源、完成度扎实的选择。如果其中任何一项让你犹豫，或者你想要的只是休闲沙盒体验，sand:box等面向玩家的产品才是更对应的方向。本站资源以下载页实际展示为准。