English | 简体中文

WatcheRobot SD 卡写入

先读 SD 卡资源说明。只使用读卡器和仓库脚本；使用烧录指南中的专用非 base Conda 环境，不向其他 Python 环境安装内容，也不修改其他环境。

写入前确认准确的 SD 卡盘符或挂载点。Windows 使用 powershell -NoProfile -ExecutionPolicy Bypass -File tools/flash.ps1 sd --drive "E:\"；macOS/Linux 使用 bash tools/flash.sh sd --drive "/Volumes/WATCHE"。示例路径必须换成实际 SD 卡，不能猜测盘符或选择系统盘。

不写 --package 时，脚本自动下载最新官方包。使用 Release 中的资源包时，在命令末尾添加 --package <watche-sd-resources-*.tar.gz>。不要手工解压发布归档；脚本会校验并转换成设备使用的 watche/ 布局。

SD 卡须为 FAT32，分配单元大小 512 字节。Windows 可在 SD 卡的格式化窗口选择，或在管理员终端激活专用 Conda 环境后运行 powershell -NoProfile -ExecutionPolicy Bypass -File tools/flash.ps1 sd-format --drive "E:\"。格式化会删除全部文件，包括资源和用户作品，须先备份。只有用户授权格式化且目标卡已确认时才执行；单纯更新资源不代表授权格式化。命令执行后直接格式化，不再二次确认，运行前须核对目标盘符。格式化脚本仅支持 Windows 可移动盘。

写入脚本必须确认 FAT32、介质可写、压缩包清单、逐文件哈希和最终目录；Windows 还会检查分配单元，macOS/Linux 须在准备卡时确认 512 字节设置。资源写入通过 staging 切换官方资源，同时保留用户作品。不得删除无关文件；只有用户明确要求丢弃未完成的设备事务时才可使用 --force。

只有退出码为零且最后出现 Installed ... successfully 才能报告写卡成功。随后提醒用户安全弹出 SD 卡，并在机器人断电状态下插回头部。上电后能进入正常界面并播放一个表情，才算设备已经读取这套 SD 资源；不要把电脑端写卡成功直接表述为设备读取成功。