植物生长 · 设备部署

准备

项	说明
一台电脑	macOS / Linux / Windows
一张 SD 卡	建议 32 GB（★ 卡上数据会被全部抹掉 ★）
一个读卡器	插到电脑上，能识别出可移动盘

第一步：先干跑（★ 不写盘，强烈建议 ★）

macOS / Linux

curl -fsSL https://cnb.cool/iamfuture_x/pi-flash/-/git/raw/main/burn_pi_image_macos.sh -o pi-flash.sh && sudo bash pi-flash.sh --install --oneclick --dry-run

Windows

# ★ 普通 PowerShell 里粘这一条 ★ —— 会自己弹 UAC 请你确认提权
$d="$env:USERPROFILE\pi-flash"; ni -ItemType Directory -Force $d|Out-Null;
iwr -useb https://cnb.cool/iamfuture_x/pi-flash/-/git/raw/main/pi-flash.ps1 -OutFile "$d\pi-flash.ps1";
Start-Process powershell -Verb RunAs -ArgumentList "-NoProfile","-ExecutionPolicy","Bypass","-NoExit","-File","$d\pi-flash.ps1","-DryRun","-CacheDir","$d"

干跑会把检测磁盘、取镜像、校验全部走一遍，★ 但不会写盘 ★。第一次务必先跑这个。

第二步：正式烧写

macOS / Linux

curl -fsSL https://cnb.cool/iamfuture_x/pi-flash/-/git/raw/main/burn_pi_image_macos.sh -o pi-flash.sh && sudo bash pi-flash.sh --install --oneclick

Windows

# ★ 普通 PowerShell 里粘这一条 ★ —— 会自己弹 UAC 请你确认提权
$d="$env:USERPROFILE\pi-flash"; ni -ItemType Directory -Force $d|Out-Null;
iwr -useb https://cnb.cool/iamfuture_x/pi-flash/-/git/raw/main/pi-flash.ps1 -OutFile "$d\pi-flash.ps1";
Start-Process powershell -Verb RunAs -ArgumentList "-NoProfile","-ExecutionPolicy","Bypass","-NoExit","-File","$d\pi-flash.ps1","-CacheDir","$d"

★★ 会问你两次 ★★：

1. ★ 电脑登录密码 ★（macOS 写裸设备需要 sudo 权限）
2. ★ 二次确认 ★ —— 必须输入 ★ 大写 YES ★ 才会真正开始写盘

★ 多个可移动盘时 ★：脚本会列出编号（盘符 / 容量 / 设备名），★ 你输入要格式化的那个编号 ★，然后仍要输 YES。

执行后你会看到什么

第 1 步  检测可移动盘        ★ 自动排除系统盘 / 虚拟盘 / 光驱 ★
第 2 步  选择目标盘          1 个自动选；多个 ⇒ 列出编号让你选
第 3 步  ★ 二次确认 ★         ★ 必须输入大写 YES 才开始 ★
第 4 步  取镜像              读索引 ⇒ 查本地缓存 ⇒ 下载 ⇒ 校验 sha256 ⇒ 解压
第 5 步  写入                ★ 带实时进度条 ★
第 6 步  回读比对            逐字节比对（★ 防"假成功" ★）
第 7 步  安全弹出 + 记录版本
第 8 步  ★ 装到树莓派后必做 ★

★ 装好之后：第一件事必须做 ★

把卡插进树莓派 → 开机 → 等约 2 分钟 → 在设备上执行：

df -h /

★ 根分区应该 ≈ 卡容量 ★（32G 卡 ⇒ 约 29G）。

如果只显示 ~3.4G ⇒ ★ 首次启动的扩容脚本没执行 ⇒ 请立刻反馈，不要继续使用该卡 ★。

设备联网后即可在设备管理后台看到并完成绑定。

常见问题

"没有检测到可移动盘" 确认读卡器插好、卡插到位。部分内置读卡器会被系统报告为"内置磁盘"，脚本会 ★ 拒绝继续 ★ —— 这是刻意设计。

多个盘怕选错 ★ 在输入 YES 之前随时 Ctrl+C ★ —— 真正写盘之前不会破坏任何数据。

下载慢 / 想复用镜像 镜像缓存在 ★ 当前执行目录 ★，同目录重跑即复用。--refresh（Windows：-Refresh）强制重下，--cache-dir（-CacheDir）改位置。

回读不一致 脚本会给出第一处差异的偏移。若落在前 512 MiB（boot 分区）内，通常是系统写入的索引文件（.Spotlight-V100 / .fseventsd）所致，数据本体正确；否则重新烧写。

想全自动、不问 YES（仅用于自动化脚本） macOS/Linux：--yes --disk /dev/diskN（★ 必须显式点名盘 ★） Windows：-DiskNumber N -Yes（★ 必须同时指定盘号 ★）

英文界面 macOS/Linux：把脚本名换成 burn_pi_image_macos.en.sh Windows：把脚本名换成 pi-flash.en.ps1