> 适用版本：Lua 5.4.7 运行时 + Electron 渲染壳 + 原生 `auto` 模块（Windows C stub / Android NDK stub.apk）

> 本文档基于 `D:/LuaStudio` 工程实际代码编写，涵盖：**IDE 介绍、函数文档、新手教程、插件开发对接教程**四部分。

—

## 一、IDE 介绍

### 1.1 产品定位

LuaStudio 是一个用 **Electron** 打造的 **Lua 5.4 集成开发环境**，面向「自动化脚本 / 手游辅助 / 桌面工具」开发者。它把 Lua 解释器、代码编辑器、屏幕取色找图、安卓无障碍控制、AI 智能体、一键打包运行整合在一个界面里。

核心：

– **内置 Lua 5.4.7 运行时**，静态编译、零外部依赖，单文件运行无需目标机装 Lua。

– **一键打包**：Windows 端直接产出独立 `.exe`；安卓端产出 `.apk`（内置无障碍+NDK 推理）。

– **原生 `auto` 模块**：封装图色找图、键鼠/触摸、控件无障碍、OCR、YOLO 检测、文件系统、网络等数百个 API，**运行（F5）即生效，无需 `require`**。

– **综合工具（抓抓）**：屏幕取色、区域找色、比色、找图、控件树 dump、OCR，所见即所得地生成 `auto.*` 调用代码。

– **双端协同**：Windows 桌面自动化 + 安卓（ADB 镜像 / 无障碍 / NDK）自动化，平台一键切换。

– **AI 智能体**：支持 Function Calling 的 agent 循环，可让模型自己调用工具并申请权限。