这套环境和电脑上的 Python 不是一回事
K10 没有操作系统，跑的是烧在板上的 MicroPython 固件，配套官方 unihiker_k10 库。它是精简运行时，标准库只是 CPython 的子集，也不能 pip 安装任意第三方包。把电脑上的 Python 脚本直接拷过来跑，多半会卡在缺库上。
第一个程序，在屏幕上写字
from unihiker_k10 import screen
screen.init(dir=2)
screen.draw_text(text="Hello K10", x=10, y=0, font_size=24, color=0xFF0000)
screen.show_draw()screen.init(dir=2) 初始化屏幕并设置方向，draw_text 只是把文字画进缓存，必须再调用 screen.show_draw 才真正显示出来。这和图形化里缓存显示文字加显示更新是同一个模型，只是换成了代码。
颜色用十六进制 RGB 数值传入，例如 0xFF0000 是红色，0x00FF00 是绿色。坐标 x 与 y 以屏幕左上角为原点。
预期结果：运行后屏幕左上角附近显示一行红色的 Hello K10 文字。只调用 draw_text、不调 show_draw 时，文字留在缓存里，屏幕会停在旧画面，看不到新内容。
常用屏幕接口
| 接口 | 作用 |
|---|---|
| screen.init(dir=...) | 初始化屏幕并设置显示方向 |
| screen.draw_text(...) | 把文字绘制到缓存，可设坐标、字号、颜色 |
| screen.show_draw() | 把缓存内容一次性推送到屏幕 |
常见故障
程序在跑，屏幕没反应。现象：程序正常运行，屏幕却停在旧画面、不显示新写的内容。原因：多半是只绘制没提交，draw_text 只把文字写进缓存，少了 show_draw() 这一步，缓存就不会推上屏幕。解法：检查代码里有没有 screen.show_draw()，补在绘制之后重新运行；图形化侧对应「将缓存内容显示 / 显示更新」积木，也要补上再运行。
从积木切到代码要注意
- 切换固件或设备模式会覆盖板上当前程序，动手前先备份
- 图形化积木生成的逻辑不能直接粘进 MicroPython 工程，接口并不通用
- 板载 AI 能力在代码侧有对应接口，用法以官方库文档为准，别照搬 Arduino 示例
- 涉及图片或模型文件时先确认 TF 卡已插好并格式化为 FAT32
下一步
屏幕会写了，去行空板 K10 屏幕显示与界面看图形、颜色与刷新机制。