1. 为什么嵌入式 UI 开发开始用 AI 生成 AirUI 代码嵌入式 UI 开发一直是个体力活。屏幕驱动、触摸校准、字体加载、控件布局、事件绑定每一块都要手写还要兼顾硬件差异。LuatOS 的 AirUI 库把常用组件、事件管理、输入控制做了封装提供 Lua 接口能在真机和 PC 模拟器上跑门槛已经降了不少。但真正写起来一个 480x320 的横屏界面光是把开机窗口、待机窗口、主菜单窗口的切换逻辑理顺就得反复调。AI 生成代码在 Web 和 App 领域已经很成熟但嵌入式场景不一样内存受限、API 有严格规范、库需要显式 require、模拟器和真机行为还有差异。所以问题不是AI 能不能写 Lua而是AI 写的 AirUI 代码能不能直接跑起来。我这次拿一个真实需求做验证横屏 480x320三个窗口开机 1.5 秒、待机、主菜单可切换用 exwin 管理窗口通过消息机制打开不用接口直接调用。整个链路是需求描述 → HTML 原型 → AI 转 AirUI 项目代码 → 模拟器运行 → 排错优化。下面把每一步的可复制配置和验证动作都写清楚你可以跟着做一遍。核心检索词先明确AirUI 是 LuatOS 的图形化开发核心库封装组件、事件、输入和主题提供 Lua 接口适合工业 HMI、智能家居控制屏、环境监测仪表这类需要 LCD 触摸交互的设备。AI 辅助生成 AirUI 代码适合已经熟悉 Lua 基础、想快速搭原型的嵌入式开发者。2. TaoToken 统一 Key 接入把模型通道先打通AI 生成代码的质量很大程度取决于你用的模型和调用通道。Trae 内置免费模型经常排队性能不稳定我试过在非工作时间用免费模型勉强够用但正式开发还是建议走稳定的 API 通道。TaoToken 提供统一 Key一个 Key 可以调多种模型省去到处申请和切换的麻烦。先说清楚定位TaoToken 是模型 API 聚合通道不是替代编辑器也不是灰色中转。你仍然在 Trae、Cline、Claude Code 这些工具里写代码只是把模型请求指向 TaoToken 的 API 地址。接入前你需要准备三件套Base URL、API Key、Model ID。Base URL 用https://taotoken.net/api注意这个地址不加 UTM 参数。API Key 在控制台创建Model ID 根据你要用的模型填比如claude-sonnet-4-20250514或gpt-4o这类。如果你用 Claude Code配置方式是在项目根目录或用户目录下建 settings 文件。以.claude/settings.json为例{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoTokenKey, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }如果你用 Cline 或 Roo Code 这类 VS Code 插件在插件设置里选 OpenAI Compatible然后填{ baseUrl: https://taotoken.net/api/v1, apiKey: sk-你的TaoTokenKey, modelId: gpt-4o }注意 Cline 的 baseUrl 通常要带/v1而 Claude Code 的ANTHROPIC_BASE_URL不带/v1这是两个容易踩的坑。Codex 用户如果走auth.json格式是{ openai: { baseURL: https://taotoken.net/api/v1, apiKey: sk-你的TaoTokenKey } }配好之后建议先用模型对话功能发一条测试消息确认 Key 和通道正常。这一步别省否则后面代码生成报错你分不清是模型问题还是配置问题。API Key 在控制台的 API Keys 页面创建接入文档里有各工具的详细截图。3. 可复制配置Trae 智能体 AirUI 项目结构环境搭建分三块项目文件夹、Trae 配置、智能体安装。先建一个空文件夹我命名为airui。打开 Trae把这个文件夹作为项目打开切换到 Solo 模式。然后安装luatos-docs-code智能体这是让 AI 正确生成 LuatOS 代码的基础。安装完务必验证智能体创建成功、规则创建成功、技能创建成功三项都确认。模型选择上实测 MiniMax 和 GLM 效果较好。如果你走 TaoToken 通道可以在 Trae 的模型设置里选自定义 API填入前面的 Base URL 和 Key。项目结构建议这样组织方便 AI 理解airui/ ├── main.lua ├── ui/ │ ├── win_boot.lua │ ├── win_standby.lua │ └── win_menu.lua ├── drv/ │ ├── lcd_drv.lua │ └── tp_drv.lua └── plan/ └── plan_20260327.md关键配置片段在main.lua里exwin 必须显式 require而且不能用 local-- 正确写法 exwin require(exwin) -- 错误写法会导致全局找不到 -- local exwin require(exwin)显示和触摸初始化推荐让驱动文件加载即完成初始化自动判断模拟器还是真机-- drv/lcd_drv.lua local lcd_drv {} function lcd_drv.init() if rtos.bsp() PC then -- 模拟器初始化 lcd.init(simulator, {port virtual, w 480, h 320}) else -- 真机初始化以 Air8000A 为例 lcd.init(st7789, { port lcd.HWID_0, pin_dc 0, pin_rst 1, direction 0, w 480, h 320 }) end end lcd_drv.init() return lcd_drv触摸驱动类似加载时自动初始化。这样 AI 生成的代码只要require lcd_drv就能完成初始化不用再手动调函数。窗口管理用 exwin通过消息机制打开-- 打开主菜单窗口 sys.publish(OPEN_MENU_WIN) -- 在窗口模块里订阅 sys.subscribe(OPEN_MENU_WIN, function() exwin.open(menu) end)这套配置的核心是exwin 全局 require、驱动加载即初始化、窗口用消息切换。把这三条写进智能体的规则里AI 生成代码的准确率会明显提升。4. 验证请求从 HTML 到 AirUI 的完整生成与运行第一步用 DeepSeek 生成 HTML 原型。打开 DeepSeek 网页版输入需求帮我生成一个 html用于嵌入式设备 UI 演示窗口横屏分辨率 w480, h320 包含开机窗口显示 1.5 秒、待机窗口和主菜单窗口可以切换。DeepSeek 会生成包含三个窗口的 HTML 文件保存到本地比如C:\Users\luat\Downloads\deepseek_html_20260327_d5969e.html。第二步在 Trae 里输入指令让智能体生成项目代码/plan 参考以下需求先帮我制定 plan仅输出 plan 文件并保存 创建一个以项目命名时间的空文件夹生成的项目文件放里面。 制定 plan 时除了输出 plan 文件内容还要输出项目功能需求和业务逻辑分析、 项目总体设计、项目详细设计。 帮我生成一个 LuatOS 项目代码功能需求如下 1、硬件模组Air8000A 2、软件功能需求 参考 C:\Users\luat\Downloads\deepseek_html_20260327_d5969e.html 的页面布局 严格遵守 AirUI 文档接口和参数进行窗口 UI 设计使用 exwin 进行管理 通过消息机制来打开窗口不使用接口直接调用窗口。 窗口横屏分辨率 w480, h320 使用 airui 的方式初始化显示、触摸和字体。 3、按照 plan 创建完整的项目代码AI 先输出 plan 文件包含功能需求分析、业务逻辑、总体设计、详细设计。确认 plan 后让它继续生成完整代码。第三步模拟器运行。用 LuatOS PC 模拟器打开项目观察串口日志。第一次运行大概率会报错这很正常关键是看报错信息。验证成功的标志模拟器上出现开机窗口1.5 秒后切到待机窗口点击后进入主菜单窗口三个窗口布局与 HTML 原型基本一致。串口日志里能看到窗口打开和切换的记录。如果走到这一步画面正常、切换正常说明 AI 生成的 AirUI 代码已经可以直接落地。剩下的就是细节调优。5. 常见报错排查401、exwin 加载、画面空白排错是这次验证最有价值的部分我把遇到的真实报错和解决方法列出来。报错一401 Unauthorized如果你走 TaoToken 通道出现 401 通常是 Key 没填对或 Base URL 写错。检查三点Key 是否以sk-开头、Base URL 是否带了多余的/v1Claude Code 不带Cline 带、Key 是否已过期。在控制台重新创建一个 Key 测试。报错二local proxy failed这个报错一般出现在本地代理配置上。如果你在 Trae 或 Cline 里配了本地代理地址检查端口是否被占用、代理进程是否启动。走 TaoToken 直连的话把代理配置清空直接用https://taotoken.net/api。报错三reading choices 失败这是模型返回格式不对通常是 Model ID 填错或者通道不支持该模型。确认你填的 Model ID 在 TaoToken 支持列表里换一个模型重试。报错四exwin 未加载模拟器报attempt to index a nil value (global exwin)。原因是 exwin 是扩展库没内置到 LuatOS 内核固件必须显式 require。而且不能用 local-- 正确 exwin require(exwin) -- 错误 local exwin require(exwin)报错五OAuth 相关错误如果你用 Claude Code 且之前登录过官方账号可能出现 OAuth 冲突。解决方法是清掉旧的认证缓存改用 API Key 方式。检查~/.claude目录下的认证文件确保ANTHROPIC_API_KEY生效。报错六模拟器无画面代码不报错但屏幕空白。原因是require lcd_drv和require tp_drv只是加载文件不会自动运行初始化函数。改成加载即初始化让驱动文件在末尾直接调用 init并自动判断模拟器还是真机。报错七画面布局混乱画面出来了但控件重叠、间距不对。让 AI 调整字体大小、控件间距、对齐方式、颜色搭配。多轮迭代效果逐步改善。排查顺序建议先看串口日志定位报错行再判断是配置问题还是代码问题配置问题查 Key 和 URL代码问题查 require 和初始化。6. 把 AI 生成 AirUI 代码用起来CTA 与后续建议这次验证下来AI 生成 AirUI 代码已经能完成从 HTML 原型到可运行项目的转换虽然做不到一键完美但配合正确的工具链和细节调试效率提升是实打实的。给你几条实用建议。第一善用 AI 生成初始框架人工专注细节调优别指望一次生成就完美。第二遇到问题时准确描述现象把串口日志原文贴给 AI引导它分析原因比笼统说报错了有效得多。第三把 exwin 全局 require、驱动加载即初始化、窗口消息切换这三条写进智能体规则能减少大量重复排错。如果你要长期做嵌入式 AI 辅助开发建议走 Coding Plan稳定通道对生成质量影响很大。需要验证模型效果可以用模型对话先测几条。API Key 在控制台创建接入文档里有各工具的完整配置截图。AirUI 的接口规范清晰文档完整这为 AI 理解业务意图提供了良好基础。获取最新 API 文档可以看官方文档站。把模型通道打通、把智能体规则配好、把排错流程跑顺AI 辅助嵌入式 UI 开发就能真正落地到项目里。