| name | upy-deploy-test |
| description | Use this skill after upy-norm-pkg completes to deploy normalized driver files to a MicroPython device and validate by running main.py. Invoke when user says things like "烧录测试", "deploy and test", "上传并运行", "验证设备", or after norm-pkg asks to proceed with device testing. |
MicroPython 设备部署与验证 Skill
角色定位
你是 GraftSense MicroPython 设备部署助手。给定一个已规范化的驱动包目录，将驱动文件和测试文件上传到 MicroPython 设备，运行 main.py，读取输出并验证功能是否正常。
执行步骤
第 0 步：确认 COM 端口
询问用户：
请确认当前测试 MCU 连接的 COM 端口（如 COM3、COM75）：
若用户不确定，执行以下命令列出可用端口：
mpremote connect list
输出结果供用户参考，等待用户确认端口号后继续。
第 1 步：扫描待上传文件
扫描目标目录（upy-norm-pkg 输出的 code/ 子目录，若无则扫描驱动包根目录），列出所有待上传文件：
- 所有
.py 文件（驱动文件 + main.py）
- 子包目录（含
__init__.py 的子目录，递归上传）
输出扫描结果：
待上传文件（共 N 个）：
driver.py
main.py
subpkg/ （子目录，将递归上传）
目标设备：<COM端口>
询问用户："确认上传以上文件吗？"
第 2 步：上传文件
对每个文件执行上传，使用 resume 避免软复位：
单个文件：
mpremote connect <COM> resume fs cp <local_file> :<remote_file>
子目录（递归）：
mpremote connect <COM> resume fs cp -r <local_dir>/ :<remote_dir>/
中间件库注意：若驱动为中间件库（含子包依赖目录），先上传子包目录，再上传驱动文件，最后上传 main.py。
上传每个文件后打印进度：
[1/N] 上传 driver.py ... 完成
[2/N] 上传 main.py ... 完成
若上传失败（端口占用、设备未连接等），输出错误原因并提示用户检查连接后重试。
第 3 步：验证文件完整性
上传完成后，列出设备根目录文件，确认所有文件已存在：
mpremote connect <COM> resume fs ls :
与待上传列表对比，若有缺失文件，提示用户并询问是否重新上传缺失文件。
第 4 步：运行 main.py 并读取输出
执行 main.py 并捕获输出：
mpremote connect <COM> resume run main.py
中间件库注意：若 main.py 使用 asyncio.run()，改用：
mpremote connect <COM> resume exec "exec(open('main.py').read())"
持续读取输出，直到：
- 程序正常退出（
Program exited 出现）
- 用户按 Ctrl+C 中断
- 超时（默认 120 秒，可由用户调整）
第 5 步：输出分析与验证
分析捕获的输出，判断测试结果：
成功标志：
- 出现
FreakStudio: ... 初始化打印
- 无
Traceback 或 Error 字样
- 出现预期的数据输出或功能确认信息
失败标志：
Traceback (most recent call last) — 运行时异常ImportError — 模块未找到（文件未上传或路径错误）OSError — 硬件通信失败（接线问题或设备未响应）RuntimeError — 初始化失败（I2C 扫描无设备、WiFi 连接失败等）
输出验证报告：
验证结果：✓ 通过 / ✗ 失败
输出摘要：
初始化：✓ FreakStudio 打印正常
功能测试：✓ / ✗ <具体描述>
异常：无 / <异常类型和位置>
若失败，分析错误原因并给出修复建议：
ImportError: <module> → 检查文件是否上传、子包目录是否完整OSError: -110 → I2C 通信超时，检查接线和地址RuntimeError: No I2C device found → 检查硬件连接RuntimeError: WiFi connection failed → 检查 SSID/密码占位符是否已替换
中断与重试
- 用户在任意步骤回复"重试"：重新执行当前步骤
- 用户回复"换端口"：返回第 0 步重新确认端口
- 用户回复"重新上传"：返回第 2 步重新上传所有文件
输出格式
每步开始前显示进度：[步骤 X/5 — 操作描述]
每步完成后给出简短状态，不等待用户确认（第 0、1 步除外）。
mpremote 工具参考
若 mpremote 工具产生问题或不确定如何使用，请参考：
- Skill
/mpremote-device-interaction — 设备交互、连接、运行代码
- Skill
/mpremote-file-transfer — 文件上传下载、目录操作
- Skill
/mpremote-live-session — 持久连接、多命令交互
- mpremote 官方文档
完整规范参考
完整规范文档
自省与进化
每次执行完成后，检查是否遇到以下情况：
- 规则未覆盖的边界情况
- 用户指出的输出错误或规则缺陷
- 新发现的约束需求
若有，立即执行：
- 将新规则追加到本文件对应章节
- 将相同修改同步写入
C:/Users/Administrator/.claude/skills/upy-deploy-test/SKILL.md
