先把环境和线材确认好
官方快速教程要求 Mind+ 在 V1.8.1 RC1.0 及以上，低版本里加载不出行空板 K10 扩展，装到这个版本再往下走。准备一根支持数据传输的 USB Type-C 线，把板子直连电脑的原生 USB 口，中间不要经过无供电的 HUB；只充电不传数据的线接上了也不会出现端口。Windows 10、Windows 11 通常免驱，Windows 7 要先手动装好串口驱动，否则连接菜单里始终是空的。
这套流程走的是 Mind+ 图形化的上传模式。如果这块 K10 之前用 MicroPython、Arduino IDE 或 PlatformIO 烧过程序，图形化模式和这些固件模式互切需要重新切换或重新烧录固件，得先把固件切回来，否则上传到设备会连不上或跑不起来；板子还停在别的固件里时，下面五步并不适用。
从建项目到屏幕出第一行字
- 打开 Mind+，切换到上传模式。预期结果：界面进入上传模式的编程区，扩展库入口和上传到设备按钮都能点开，积木区可以拖放编辑。
- 在扩展里搜索并加载行空板 K10。预期结果：积木列表里多出 K10 分类，能看到缓存显示文字、将缓存内容显示或显示更新这些屏幕积木；搜不到分类时，先回头核对 Mind+ 是不是到了 V1.8.1 RC1.0。
- 用数据线把板子接到电脑，在连接菜单里选中出现的串口。预期结果：菜单里列出一个可选串口并能连上，Mind+ 显示设备已连接；列表为空就先按线材和驱动两段排查，别急着往下拖积木。
- 从 K10 分类拖入缓存显示文字积木，把积木里的文字改成自己要显示的内容，比如 Hello，再拖入将缓存内容显示或显示更新积木接在它后面，整段放进主循环。预期结果：脚本区出现前后衔接的两块积木，先写缓存、后统一显示，中间没有断开或悬空的积木。
- 点击上传到设备，等烧录进度走完。预期结果：提示上传成功，板子自动运行后屏幕上出现第 4 步设的文字；如果只放了缓存显示文字、漏了后面的显示类积木，屏幕会一直不变，别误以为烧录没成功。
五步里最容易漏的是第 4 步的后半块。缓存类积木只把内容写进内存，显示类积木才把缓存推到屏幕上，两块要成对出现；后面画图形、显图片、做界面都是同一个两段式，区别只在往缓存里写什么。只拖缓存积木屏幕不动，是新手最常遇到的困惑，原因就在这里。
官方 FAQ 特别提醒：屏幕显示类积木不要放进回调函数、线程、MQTT 接收或中断这类触发型积木里，否则显示容易异常。需要刷新界面时，把显示统一放到主循环里做。
对照官方 unihiker_k10 库里的写法，这个两段式会更清楚。库的最小示例先 draw_text 写入、再 show_draw 显示，和图形化里先缓存文字、再统一显示正好一一对应：
from unihiker_k10 import screen
screen.init(dir=2)
screen.draw_text(text="Hello", x=10, y=0, font_size=24, color=0xFF0000)
screen.show_draw()知道这个对应，在图形化里拖完缓存类积木就会自然去找配对的显示类积木，不至于留半截脚本。这段只是代码侧的对照，图形化入门照着上面五步拖积木就行，不用写代码。
点不亮时按什么顺序查
卡住时别逐条乱试，按版本、端口、上传报错、固件状态的顺序排查更省事：先确认 Mind+ 版本够不够，它决定扩展在不在；再看端口能不能出现，它决定设备连不连得上；连上以后才看上传报的是什么错；这些都正常却仍跑不起来，最后回头确认板子是不是还停在别的固件模式。
| 现象 | 原因 | 解法 |
|---|---|---|
| 扩展里搜不到行空板 K10 | Mind+ 版本低于 V1.8.1 RC1.0 | 升级到 V1.8.1 RC1.0 及以上，再重新加载扩展 |
| 连接菜单找不到端口 | 用了只充电的线、接了无供电 HUB，或 Windows 7 没装串口驱动 | 换官方数据线、直连电脑原生 USB 口，Windows 7 先装好串口驱动 |
上传失败并报 spawn ENAMETOOLONG
|
Mind+ 解压路径过长，或路径里含中文、括号 | 把 Mind+ 重新解压到短的纯英文路径再打开 |
| 上传后板子持续重启 | 需要恢复设备初始化 | 用恢复设备初始化设置或 Mind+ V2 的擦除功能；恢复时先按住 BOOT 再接 USB，识别到端口后松开 |
第一行字出来以后，往缓存里继续加文字、图形和图片，再统一显示一次，就能在同一块屏幕上叠出简单界面，积木顺序和这五步没有区别。