kindle-calendar/dash/docs/kindle-voyage-5.13.6-bootstrap-zh.md

Kindle Voyage 5.13.6 新机 Bootstrap 说明

目标

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

• 预置 WatchThis payload
• 预置 KUAL / MRPI / USBNetwork / kindle-dash
• 可选预置 KTerm
• 预置 SSH 恢复脚本
• SSH 打通后自动同步 dashboard shell 脚本 / KUAL 菜单 / 主题包，切主题并立即出图

对应脚本：

• bootstrap-new-kindle.sh

先说结论

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

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

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

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

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

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

KTerm 说明

当前仓库默认不自带 KTerm 安装包。

脚本支持两种方式把 KTerm 纳入预置：

1. 直接把官方 KTerm release 的 .zip 放到：

dash/staging/kterm/kterm-kindle-*.zip

2. 或执行脚本时显式传入：

sh bootstrap-new-kindle.sh prepare-storage --kterm-package /绝对路径/kterm-kindle-*.zip

3. 或直接让脚本在 Mac 侧联网下载：

sh bootstrap-new-kindle.sh prepare-storage --download-kterm --kterm-version latest

也可以固定版本：

sh bootstrap-new-kindle.sh prepare-storage --download-kterm --kterm-version v2.6

如果脚本没有找到 KTerm 安装包，它不会报错退出，但会明确提示：

• 本轮只预置 SSH 恢复脚本
• KTerm 仍需手工补装

下载逻辑说明：

• 下载发生在 Mac 侧，不在 Kindle 设备侧进行
• 下载后的 .zip 会缓存到 dash/staging/kterm/
• 对 Kindle Voyage 5.13.6，脚本默认优先选择不带 armhf 后缀的 .zip
• 预置时会直接解压到 Kindle 的 extensions/

脚本模式

1. prepare-storage

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

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 使用
• 如果检测到 KTerm zip，也会一并解压到 extensions/

2. post-ssh

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

sh bootstrap-new-kindle.sh post-ssh

它会自动：

• 修复设备侧 SSH 辅助脚本权限
• 尝试同步 authorized_keys
• 同步 dashboard shell 脚本、KUAL 菜单和主题包
• 立即切到指定主题并把背景画到屏幕上

当前边界：

• post-ssh 不会回补 prepare-storage 阶段预置的原生二进制，例如 next-wakeup、xh
• 所以它的默认前提仍然是：这台设备之前已经执行过 prepare-storage，或设备上本来就已有完整 dashboard 基础运行时

可选：

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

其中 --start-dashboard 的稳定前提也是一样：设备上必须已经具备完整 dashboard 基础运行时。

3. all

默认模式：

sh bootstrap-new-kindle.sh

逻辑是：

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

设备侧最短人工步骤

1. 恢复出厂并进入 demo mode
2. 到真正的 Sideload Content 时机
3. 让脚本已预置好的 .demo payload 生效
4. ;dsts -> Help & User Guides -> Get Started
5. 继续完成 demo 流程里的 register this demo -> Skip -> standard
6. 重启后遇到 Configure Device，用隐藏手势回到主页
7. 搜索 ;uzb 挂载 USB，把 Update_hotfix_watchthis_custom.bin 放到根目录
8. ;dsts -> Device Options -> Update Your Kindle
9. 回到主页后搜索 ;log mrpi
10. 在 KUAL 中先执行 Rename OTA Binaries -> Rename
11. 如果本轮没有预置 KTerm，这里先手工补装 KTerm
12. 连上 Wi‑Fi
13. 打开 KTerm，执行：

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

14. 回到 Mac，执行：

sh bootstrap-new-kindle.sh post-ssh

这里默认仍然建立在第 1 步已经成功做过 prepare-storage 的前提上。

相关文档

• WatchThis 越狱路径： kindle-voyage-5.13.6-watchthis-zh.md
• SSH 打通与 KTerm 兜底： kindle-voyage-5.13.6-dual-ssh-playbook-zh.md
• 恢复出厂后的 bootstrap 闭环验证： kindle-voyage-5.13.6-bootstrap-validation-zh.md