feat(resources): 完善设备维护与 SD 资源调用闭环

[orulink-wugui]

背景

本 PR 替代 #24。

旧分支曾通过双父 merge commit ba9036e5d12821192c62dbe7c29cad2c0d3df13f 合入 Application 分支 1ed28630cd1b8a6d5529f35c909de4bc4341bc1b，导致 GitHub 在旧 PR 中展示另一条分支的历史。当前远端 main 已通过 PR #22 正式包含 Application 相关提交，因此本 PR 从最新 origin/main 重新建立，只迁移 SDK 设备维护与资源闭环的最终代码差异。

新分支没有携带 ba9036e，相对 main 只有 4 个普通单父提交。迁移前后 Git tree 哈希完全一致，确保旧分支中的功能、测试和文档没有丢失。

本次改动

固件与 SD 资源维护

• 提供 ESP32 固件 Release 查询、下载、校验和串口烧录能力。
• 支持自动请求设备进入 ROM 下载模式，并在高速烧录失败后重新进入下载模式执行降速重试。
• 提供官方 SD 资源查询、下载、校验、串口安装和读卡器安装接口。
• 支持同版本官方资源重复安装，不根据当前版本跳过。
• 将 SD 资源启用总时限扩展为 30 分钟，并增加 120 秒无进展停滞检测。
• 超时错误保留最后阶段、进度和设备诊断明细。

用户作品与官方表情

• 支持通过设备端口或 SD 读卡器读取用户作品目录。
• 校验作品标识、时间线、轨道、素材数量、文件大小和 CRC。
• 支持作品写入、读取、删除、完整播放与指定 clip_id 播放。
• 提供 robot.expressions.play_official 调用官方表情。
• 提供 robot.works.play_expression 调用用户作品中的单个表情。
• 保留 v1/v2 作品和既有完整作品播放接口的兼容性。
• 通过固件能力协商拒绝不支持的来源或调用方式，不在官方资源与用户作品之间静默回退。

Daemon 与 Application 边界

• SDK 仓库继续作为 Daemon 唯一源码。
• 维护 REST API 与业务帧路由分离。
• 有 Application 时，Desktop 和 Device 业务帧仍经过当前 Application。
• 无 Application 时，通过同一 Daemon 透明转发，不建立第二条设备业务连接。
• 保持无 Application 启动、冻结 Runtime 入口和 Application 受控启动能力。
• Application 冷启动等待窗口覆盖 Windows 首次启动耗时。

跨平台兼容

• Windows 卷信息接口动态解析，非 Windows 平台不直接访问 ctypes.windll。
• 缺少 Windows 卷 API 时返回明确维护错误。
• 保持 Python 3.10、Windows Runtime 与 Application 分发主线兼容。

历史清理说明

• 基线：最新远端 main，提交 5f15233。
• 未迁移 merge commit：ba9036e。
• 新 PR 相对主线只有 4 个普通提交。
• 新旧功能分支的最终 tree 哈希均为：
  23fcbddb6db2892703c6a595fb6b347b8116dd1f
• 因此本次清理只改变提交拓扑，不改变 SDK 最终代码内容。

TDD / 验证

• SDK 全量测试：
  • .venv\Scripts\python.exe -m pytest -q
  • 全部通过。
• 重点闭环测试：
  • 维护服务与扩展能力；
  • SD 资源合同端到端；
  • 设备控制 REST；
  • Application Runtime；
  • Daemon 路由；
  • 冻结 Runtime 入口；
  • SDK 对外 API。
  • 全部通过。
• 类型检查：
  • .venv\Scripts\python.exe -m mypy src
  • 85 个源码文件零错误。
• git diff --check origin/main...HEAD：通过。

测试仅保留一条预期的 ZIP 重复文件名警告，用于验证重复条目会被拒绝，不代表功能失败。

配套仓库

• ESP32：codex/sd-ota-resources-dev / PR #131。
• 桌面端：codex/sd-resource-install-progress / PR #97。
• 服务端不承载 Daemon，本次没有修改服务端。

风险与注意事项

• SDK 仓库远端不存在 dev 分支，因此本 PR 按仓库实际主线和既定策略提交到最新 main。
• PR 为 draft，不会自动合并。
• 旧 PR fix(maintenance): 完善设备资源维护、作品调用与安装诊断 #24 将在确认本 PR 的提交列表和差异正确后关闭。