本课验证范围：电脑示例与假接口测试可复现；本课不包含板端解释器、外设或整机验收。
起步包提供原创说明、可在电脑运行的示例、板端参考代码和记录表。镜像、模型权重及第三方 EDA 工程需从对应来源获取；此包不是可烧录 BSP。
选择你的开发配置
课程、配件入口与下载包保持同一板型；选择不代表兼容性已验证
开始前准备
- 先阅读板型与版本课，并确认本课是否需要目标硬件。
- 下载起步包；保留原始配置，不直接覆盖板上的 main.py。
操作步骤
区分配置与代码
把板号、引脚和设备参数放配置中；算法输入输出使用清晰字段。不要在示例里写 Wi-Fi 密码或生产服务器密钥。
运行纯计算示例
先看 vision_events.py 与 servo_planner.py 的函数和测试。修改输入框位置、置信度及时间，观察输出变化；电脑上不导入 machine/media。
python -B -m unittest discover -s tests -p test_examples.py -v建立调试顺序
输入校验、单模块处理、输出记录分别运行。遇到异常先保留完整错误与最小输入，不用无限重试掩盖问题。
留下可复现记录
填写验证记录中的步骤、预期、实际结果和日志。发布代码前重跑测试，注明 PC 验证还是板端实测。
预期结果与核对
- 别人使用同一配置和输入能复现相同输出。
- 工程记录不包含客户密码、原始人脸图或私钥。
遇到问题时
- 电脑能运行，板端报导入错误
- 区分 CPython 标准库与 MicroPython 可用库；仅部署板端实际使用的文件。
- 第二次运行才失败
- 检查文件/目录重复创建、外设资源释放和前一次脚本是否停止。
本课配套文件
当前下载配置：KJX K230 1GB 核心模组方案。下载并解压后，进入 KJX-K230-starter 目录，再按以下相对路径打开文件；先看 CONFIGURATION.md 中的适用范围。
HANDS_ON.md本课相关源文件或操作说明；见包内 README 的验证范围。vision_events.py本课相关源文件或操作说明；见包内 README 的验证范围。servo_planner.py本课相关源文件或操作说明；见包内 README 的验证范围。tests/test_examples.py本课相关源文件或操作说明；见包内 README 的验证范围。records/validation-record.json本课相关源文件或操作说明；见包内 README 的验证范围。courses/python-project-basics.md本课完整离线说明，与网页同源。CONFIGURATION.md当前所选板型、起步配置清单与适用边界；不替代实物配置文件。
