# Kindle Voyage 5.13.6 新机 Bootstrap 说明

## 目标

把“同型号新机拉齐能力”收敛成一个单入口脚本：

- 预置 `WatchThis` payload
- 预置 `KUAL / MRPI / USBNetwork / kindle-dash`
- 预置 SSH 恢复脚本
- SSH 打通后自动同步 dashboard、切主题、立即出图

对应脚本：

- [bootstrap-new-kindle.sh](/Users/gavin/kindle-dash/bootstrap-new-kindle.sh)

## 先说结论

这个脚本不是“100% 零交互刷机”。

当前仍然不能完全自动化的部分有：

1. `WatchThis` demo 流程本身需要设备端手势与点击
2. `;log mrpi` 需要在 Kindle 搜索栏手工触发
3. 首次 SSH 最稳的方式仍然是在 `KTerm` 里执行：

```sh
sh /mnt/us/ssh-force-dropbear-22.sh
```

所以这套 bootstrap 的真实定位是：

- 尽量把 Mac 侧和文件预置自动化
- 把设备侧必须手工的动作压到最少

## 脚本模式

### 1. `prepare-storage`

当 Kindle 以 USB 存储方式挂载到 Mac 后执行：

```sh
sh bootstrap-new-kindle.sh prepare-storage
```

它会自动：

- 把 `KV-5.13.6.zip`、`demo.json` 放到 `.demo/`
- 创建 `.demo/goodreads/`
- 把 `Update_hotfix_watchthis_custom.bin` 放到 Kindle 根目录
- 把 `extensions/`、`mrpackages/`、`dashboard/` 预置到 Kindle
- 把 `scripts/kindle/*.sh` 拷到 Kindle 根目录，供 `KTerm` 使用

### 2. `post-ssh`

当 Kindle 已连上 Wi‑Fi，且你已经在 `KTerm` 拉起 `dropbear` 后执行：

```sh
sh bootstrap-new-kindle.sh post-ssh
```

它会自动：

- 修复设备侧 SSH 辅助脚本权限
- 尝试同步 `authorized_keys`
- 同步 dashboard 运行时和主题包
- 立即切到指定主题并把背景画到屏幕上

可选：

```sh
sh bootstrap-new-kindle.sh post-ssh -t simple -o portrait
sh bootstrap-new-kindle.sh post-ssh --start-dashboard
```

### 3. `all`

默认模式：

```sh
sh bootstrap-new-kindle.sh
```

逻辑是：

- 如果检测到 `/Volumes/Kindle`，先做 `prepare-storage`
- 如果同时检测到 `ssh kindle` 可用，再继续做 `post-ssh`
- 哪一段当前做不了，就明确打印下一步人工动作

## 设备侧最短人工步骤

1. 恢复出厂并进入 demo mode
2. 到真正的 `Sideload Content` 时机
3. 让脚本已预置好的 `.demo` payload 生效
4. 通过 `Get Started` 完成越狱
5. 搜索 `;log mrpi`
6. 在 `KUAL` 中先执行 `Rename OTA Binaries -> Rename`
7. 连上 Wi‑Fi
8. 打开 `KTerm`，执行：

```sh
sh /mnt/us/ssh-force-dropbear-22.sh
```

9. 回到 Mac，执行：

```sh
sh bootstrap-new-kindle.sh post-ssh
```

## 相关文档

- WatchThis 越狱路径：
  [kindle-voyage-5.13.6-watchthis-zh.md](/Users/gavin/kindle-dash/dash/docs/kindle-voyage-5.13.6-watchthis-zh.md)
- SSH 打通与 KTerm 兜底：
  [kindle-voyage-5.13.6-dual-ssh-playbook-zh.md](/Users/gavin/kindle-dash/dash/docs/kindle-voyage-5.13.6-dual-ssh-playbook-zh.md)