# lua_debug_qt

**Repository Path**: michaelhyg/lua_debug_qt

## Basic Information

- **Project Name**: lua_debug_qt
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-22
- **Last Updated**: 2026-04-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Lua Qt 调试助手

这个目录下提供一个纯串口版的 ESP32 Lua 调试助手，所有设备交互都通过 `@@LUA_*` 串口协议完成，不再依赖 HTTP 调试。

当前支持：

- `@@LUA_PING`
- `@@LUA_LIST`
- `@@LUA_EXEC <len>`
- `@@LUA_STORE <slot> <len>`
- `@@LUA_DELETE <slot>`
- `@@LUA_FLASH_LOAD [slot]`
- `@@LUA_RESET`

界面能力：

- 刷新设备内脚本列表
- 按槽位加载 Flash 脚本
- 保存当前编辑器内容到 Flash
- 删除指定槽位脚本
- 执行当前 Lua 脚本
- 把当前编辑器内容导出为本地 `.lua` 文件
- 查看串口原始日志和协议日志
- Lua API 参考和片段插入

关键字目录：

- 启动时会从外部 `lua_completion_entries.json` 读取关键字
- 若应用旁边没有该文件，会先从应用包内置模板复制一份出来
- 后续可直接编辑该 `json`，不需要再改 `cpp`

## 构建

如果使用 Homebrew 的 Qt：

```bash
cmake -S . -B build -DCMAKE_PREFIX_PATH="$(brew --prefix qt)"
cmake --build build
```

## 运行

双击或打开应用包：

```bash
open ./build/lua_debug_assistant.app
```

如果你想直接运行内部 Mach-O 可执行文件：

```bash
./build/lua_debug_assistant.app/Contents/MacOS/lua_debug_assistant
```

首次启动后，应用旁边会生成可编辑的关键字文件：

```bash
./build/lua_debug_assistant.app/lua_completion_entries.json
```

如果要根据 ESP32 工程里的 `lua_modules.c` 自动刷新关键字目录，可以运行：

```bash
python3 ./tools/sync_lua_keywords.py
```

## 使用步骤

1. 打开串口
2. 点击“刷新列表”读取设备中的 Lua 槽位
3. 选择槽位或直接输入槽位名
4. 加载、保存、删除或执行脚本
5. `print()` 输出在“串口日志”页查看