项目情况
Aily Blockly 是 Aily Project 推出的开源、AI 驱动的硬件图形化开发 IDE，核心是用 “拖拽积木 + 自然语言对话 + 端云协同编译” 大幅降低嵌入式（ESP32/Arduino/STM32）开发门槛，兼顾新手易用与工业级工程化能力。
1、核心定位与背景
全称：Aily Blockly（隶属 Aily Project）
技术底座：Electron + Angular + Google Blockly + AI 大模型
核心目标：打破专业嵌入式与业余创客的壁垒，长期愿景是自然语言编程（一句话生成完整项目）
状态：开源（GitHub 1.8k+ Star）、跨平台（Windows/macOS/Linux）、免费公测
主创背景：点灯科技（Blinker 物联网平台）团队，创始人奈何 col 为 Arduino 中文社区创建者
2、核心功能（四大杀手锏）
（1）工程化依赖管理（解决 “库版本地狱”）
项目隔离：每个项目独立管理开发板核心（Core）与库版本，互不干扰（类似前端 package.json）
一键库管理：内置库管理器，支持安装 / 更新 / 切换版本，彻底避免传统 Arduino IDE 全局库冲突
开箱即用：无需手动配置工具链，安装即可开发
（2）端云协同闪电编译（60 倍提速）
传统痛点：ESP32 项目本地编译常需 20–60 分钟
Aily 方案：云端预编译缓存 + 本地增量编译
效果：编译时间从1 小时压缩至 1 分钟，大型项目优势更明显
（3）AI 全流程辅助（从需求到代码）
AI 项目生成：自然语言描述需求（如 “ESP32 温湿度监测，DHT11+OLED 显示”），AI 自动完成：硬件选型、模组推荐、引脚分配、工程创建、代码生成
AI 代码生成：图形化编程中，AI 可将自然语言转为积木逻辑或 MicroPython 代码
AI 转库（核心杀招）：上传任意 Arduino C++ 库，AI 自动解析并生成 Blockly 积木，无限扩展图形化生态（传统图形化编程无积木则无法用第三方库）
（4）多硬件平台 + 专业调试
支持芯片：Arduino（AVR）、ESP32、STM32、RP2040 等 30+ 芯片、80+ 开发板
内置工具：全能串口调试（数据可视化）、U8G2 取模、点阵编辑等
项目广场：海量开源案例（物联网、AI、传感器），一键导入运行
3、优势对比（vs 传统 Arduino IDE）
一、安装前准备
1、系统要求
2、环境依赖
3、下载渠道
aily blockly官网
https://aily.pro/home
https://yysc.tech/home
https://yiyu.pro/home
aily blockly
项目地址：https://github.com/ailyProject/aily-blockly
镜像仓库：https://gitee.com/mirrors/aily-blockly
项目文档 : https://yiyu.pro/doc
项目交流：https://github.com/orgs/ailyProject/discussions
下载地址1：https://aily.pro/download
下载地址2（Github）：https://github.com/ailyProject/aily-blockly/releases
下载对应系统安装包（目前版本 V 0.9.51）
获取源码 / 最新版（2026.5.15）
安装无脑下一步，路径不含中文、空格、特殊符号
二、安装步骤清单
□ Step1: 下载对应系统安装包（约150MB） → Windows: aily-blockly-Setup-0.9.51.exe → macOS: aily-blockly-0.9.51.dmg □ Step2: 关闭杀毒软件（可选，避免误报） □ Step3: 双击安装包，一路“下一步” → Windows：建议默认路径 C:\Users\{用户名}\AppData\Local\Aily Blockly → macOS：拖拽到Applications文件夹 □ Step4: 等待安装完成（约2-3分钟） □ Step5: 首次启动 → 官网注册/登录 → 进入主界面[citation:2]□ Step6: 【避坑】确认左侧开发板列表正常加载 → 若空白，检查网络（需访问GitHub/npm源）⚠️ 国内用户特别配置
由于部分资源托管在境外，国内用户建议：
设置npm镜像源：
npm config set registry https://registry.npmmirror.com
如果GitHub Releases下载慢，使用Gitee镜像
三、项目创建配置清单
新建项目流程
□ Step1: 点击“新建项目” → 输入项目名称（这里写的K10） □ Step2: 选择开发板（搜索行空板） → 常用选择： • ESP32系列：esp32:esp32:esp32 • ESP32-S3：esp32:esp32:esp32s3（AI语音等高性能项目推荐）[citation:1]• Arduino Uno：arduino:avr:uno □ Step3: 等待工具链自动下载（首次选板需下载SDK，约200-500MB） □ Step4: 添加需要的库（项目级隔离，不影响其他项目）[citation:1]□ Step5: 【可选】配置AI API Key → 设置 → AI服务 → 未配置时部分AI功能不可用[citation:8]成功创建“K10” 项目
添加需要的库（这里添加了RGB灯带驱动库和IIC电机驱动库）
四、核心坑点与避坑指南
🔴 坑点1：安装后白屏/无法加载
现象：安装完成打开，界面空白或卡在加载页。
原因：
网络问题无法访问GitHub/npm源
首次启动需要下载运行时资源
杀毒软件拦截
解决方案：
检查网络，尝试开启代理
国内用户配置npm镜像源
临时关闭杀毒软件后重试
删除配置缓存：C:\Users{用户名}\AppData\Roaming\Aily Blockly\ 后重启
🔴 坑点2：开发板识别失败/烧录不了
现象：点击烧录后提示“No serial port found”或一直等待连接。
原因：
90%是USB线问题：用了充电线（无数据功能）
驱动未安装（尤其是CH340/CP210x）
端口被其他程序占用（如Arduino IDE、串口助手）
解决方案：
✅ 换用数据线（手机原装线通常是数据线）
安装对应驱动：
CH340：http://www.wch.cn/download/CH341SER_EXE.html
CP210x：https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers
关闭所有其他串口软件
Windows检查设备管理器 → 端口(COM和LPT) 是否有新增设备
🔴 坑点3：云端编译超时/失败
现象：点击闪电编译后长时间等待或报错。
原因：
未登录账号（云端编译需要登录）
网络不稳定
开发板配置不完整
解决方案：
确认已登录：界面右上角头像 → 登录状态
首次编译某开发板时，确保本地SDK已完全下载
网络不佳时可尝试本地编译模式
检查项目目录路径是否包含中文/空格（建议全英文路径）
🔴 坑点4：AI功能无法使用/报错
现象：点击AI按钮无响应或提示功能不可用。
原因：
未登录账号
AI功能需要邀请码（内测阶段）
未配置API Key
网络无法访问AI服务
解决方案：
获取邀请码：https://c.yiyu.pro/join/YY1F392KAEM
登录后确认AI服务状态
在设置中配置API Key（如需自备）
检查网络是否能访问OpenAI/国内AI服务
🟡 坑点5：库安装失败/找不到库
现象：添加依赖库时报错，或编译时提示“xxx library not found”。
原因：
库名输入错误
网络问题无法下载
该库尚未被AI转换（部分小众库需手动转换）
解决方案：
使用AI转库功能：提供原生Arduino库，AI自动生成Blockly积木
检查库名称是否拼写正确（区分大小写）
使用内置库管理器浏览可用库
若网络问题，手动下载库放入 项目目录/node_modules/
🟡 坑点6：编译成功但硬件无反应
现象：提示烧录成功，但LED不闪、传感器无数据。
原因：
引脚配置与接线不符
电源供电不足（尤其是WiFi/屏幕等耗电外设）
代码逻辑问题
解决方案：
对照AI生成的接线图逐根检查
外接供电：USB-Hub供电不足时，改用电脑直连或加供电
使用串口监视器查看调试输出（内置串口工具）
先跑简单测试（如Blink）确认板子正常
🟡 坑点7：多项目切换时依赖混乱
现象：项目A正常，切换到项目B后编译报错。
原因：Aily Blockly的设计是项目级隔离，不会混乱。但可能存在：
项目B未正确配置开发板
项目B缺少必要的库
解决方案：
确认每个项目独立配置了开发板
使用“克隆项目”功能复制配置
查看项目目录下的 package.json 确认依赖
五、快速检查清单（首次启动必查）
启动前检查 □ USB数据线是数据线（非充电线） □ 开发板驱动已安装 □ 已注册账号并登录 □ 网络稳定（能访问GitHub/npm） 创建项目检查 □ 项目路径不含中文/空格 □ 选择了正确的开发板型号 □ 工具链下载完成（首次选板稍等几分钟） □ 依赖库已添加 烧录检查 □ 开发板已连接电脑 □ 无其他串口程序占用端口 □ 编译成功（约1分钟）[citation:3]□ 烧录成功后硬件运行 遇到问题时 □ 查看内置串口监视器输出 □ 检查接线是否与AI生成的图一致 □ 查看官方文档：https://yiyu.pro/docAily Blockly小结
1、定位：开源 AI 驱动嵌入式图形化编程软件，主打拖拽积木 + AI 写硬件程序
2、支持：ESP32、Arduino、STM32 等主流开发板
3、核心亮点
（1）云端极速编译，大幅提速
（2）AI 一句话生成项目、自动转第三方库积木
（3）项目独立管库，告别版本冲突
4、适用：零基础学硬件、创客做项目、少儿编程教学
5、优势：比传统 IDE 更简单、更快、更智能
