常见问题

编译失败、烧录被拒、串口占用、AI 网关……把高频问题集中在这里。

先确认工具链已启用（设置 → 插件），板型 FQBN 选对；Arduino 首编会自动拉核心，耐心等几分钟。报缺库就去插件市场装对应库。仍失败把报错贴给 AI，它会按「断言 / 编译 / 超时」分类自动修。

这是板卡认错的典型表现：板子被识别成别的型号，流程空等后被拒。回到「设备」面板，重新选择正确的板型与端口，再上传。

串口监视器、Arduino IDE、串口助手任一占着端口都会冲突。全部关闭，或在 LabCode 里先停监视再上传。Windows 还可能是驱动未装（见设备管理器黄色感叹号）。

它们原生 USB 共用 303a:1001，是靠「板型选择」区分的，不是故障。认准板型即可。

LabCode 是三通道 AI 网关：① 本地 llama（需本机已部署模型）② BYOK（填入你的 API Key 直连）③ 官方登录 + 积分（注册送积分，免费起步）。先确认选的是哪条通道、凭证是否有效。

本地优先是核心定位：工程文件与调试日志默认只写本机、不外发，仅记录排错必需字段（不记文件内容、不记 AI 正文、不记 Key）。只有你主动配置 BYOK 或调用官方云模型时，才会按你的设置发起对应请求。

板卡来自 boardRegistry.ts（单一数据源），当前收录 10 款：5 款 ESP32（S3/C3/P4 等）+ 5 款 STM32。新增板只需改这一个文件，并满足三条件：能编译 + OpenOCD 有 cfg + USB VID:PID 真实。

插件市场与联系表单、内容块、版本、下载计数由后端 server.mjs（零依赖 Node ESM，端口 8788）提供；管理后台在 /admin/。接口细节见接口参考。

仍解决不了？在「帮助 → 导出测试报告」生成诊断文件发给我，里面含板卡识别、端口、烧录等关键埋点（已脱敏），能直接定位问题。