Files
kindle-calendar/dash/docs/kindle-voyage-5.13.6-bootstrap-zh.md
2026-03-17 10:37:27 +08:00

116 lines
2.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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 已连上 WiFi且你已经在 `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. 连上 WiFi
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)