LuatOS for VS Code

LuatOS 是面向合宙 LuatOS 开发者的 VS Code 功能集合插件。它把文档问答、项目管理、代码协作、LuaTools 兼容构建和设备下载调试集中在同一个工作台中。

主要功能

• Docs 问答：直接使用合宙 Docs Chat 的官方知识服务，支持 LuatOS API、模组规格、示例和开发文档查询。
• 多会话工作台：在 VS Code 的 LUATOS 标签中创建、恢复和并行运行多个会话。
• Auto / Plan：Plan 用于先梳理实施步骤，Auto 用于执行代码、项目和设备相关任务。
• 代码协作：读取当前项目和编辑器上下文，生成代码变更，并可在 VS Code Diff 中查看和应用。
• 项目管理：识别 LuatOS 项目，配置项目名、SOC、串口和下载检测参数。
• LuaTools 兼容：使用选定的 LuaTools 工作目录，支持 .luatos 项目导入、导出和 userprojs 项目管理。
• 设备下载与调试：通过内置 luatos-cli 执行脚本下载、设备复位和启动日志检测。
• 审批方式：支持请求批准、替我审批和完全访问三种协作方式。

安装

1. 在 VS Code 中打开扩展面板。
2. 选择右上角菜单中的“从 VSIX 安装”。
3. 选择本扩展提供的 luatos-*.vsix 文件。
4. 重载 VS Code，在右侧辅助栏打开 LUATOS。

当前验证包内置 Windows x64 版本的 luatos-cli。文档问答和代码协作可先直接使用；设备下载功能需要 Windows x64 环境、可用的 LuaTools 工作目录和已连接设备。

快速开始

1. 打开工作台

在右侧辅助栏选择 LUATOS，或按 Ctrl+Shift+P 执行：

LuatOS: Open Workbench

首页下方输入问题或开发任务，发送后会自动创建会话。点击顶部的“新任务”可回到会话列表并开始下一项工作。

2. 文档问答

直接输入问题，例如：

Air780EPM 怎么连接 MQTT？
Air8101 支持摄像头吗？
Air8000W 有几个 UART？

回答中的官方资料、工具调用和引用会显示在会话中。建议每个独立主题使用新会话，便于保留清晰的上下文。

3. 代码任务

打开 LuatOS 项目后，可以在输入框中选择：

• +：添加 Lua 或配置文件作为上下文；
• IDE 上下文：附加当前编辑器文件或选区；
• Plan：先生成实施计划；
• Auto：执行计划、修改代码并完成验证。

代码变更会以变更卡片显示。选择“查看并应用变更”可打开 VS Code Diff，确认后写入项目。

4. 配置项目和设备

点击会话输入框上方的“项目 · 项目名”或“新建项目”，可以配置：

• 项目名称；
• SOC 文件；
• 串口；
• 启动检测超时时间和关键字。

项目会保存在 LuaTools 工作目录的 userprojs 下，并同步到 LuaTools 项目列表。

在“设置 → 工作目录”中选择 LuaTools 目录或其上级目录。插件会根据目录结构识别工具目录；未配置工作目录时，文档问答和代码功能仍可使用，但项目导入导出、构建和设备操作不可用。

5. 下载和启动检测

在已配置项目和串口的 Auto 会话中输入明确任务，例如：

自动下载并检测是否启动成功

工作台会显示构建、脚本下载、复位和日志检测进度。串口输出可以展开查看，任务结束后会给出构建、下载和启动检测结果。

设置

打开 LUATOS 顶部的齿轮，可查看：

• IoT 账号状态；
• 余额与用量入口；
• LuaTools 工作目录和内置命令行工具状态；
• 已发现的项目及导入、导出、打开操作；
• 扩展版本和诊断日志。

IoT 登录、积分余额和充值入口会随着服务端账号能力逐步开放。

常见问题

没有看到 LUATOS 标签

确认扩展已安装并重载 VS Code，然后在“视图 → 外观”中打开辅助栏。也可以使用命令面板执行 LuatOS: Open Workbench。

项目显示为“新建项目”

在设置中刷新项目列表，并确认已打开包含 luatos.json、user 和固件文件的项目目录。选择项目后，会话顶部会显示项目名称。

无法下载设备

请先在设置中选择 LuaTools 工作目录，再为当前会话选择项目、SOC 和串口。设备操作只会使用当前会话的项目和串口配置。

如何查看运行日志

设备任务完成后，在会话中的调试输出卡展开查看摘要；完整日志可通过设置中的日志入口打开。