update at 2026-03-21 18:44:12

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

@@ -80,11 +80,15 @@ sh bootstrap-new-kindle.sh prepare-storage --download-kterm --kterm-version v2.6
 
 ### 4. WatchThis 导入点
 
-必须特别注意：
+按这轮实机成功路径，直接记录下面这组顺序：
 
-1. 第一次 `Add Content / Sideload Content` 只能点 `Done`
-2. 不要在第一次导入点接 USB
-3. 真正的 payload 导入点，是隐藏手势返回后，再次进入 `;demo -> Sideload Content`
+1. 搜索 `;demo`
+2. 进入 `demo menu`
+3. 选择 `Sideload Content`
+4. 到这个页面后再接 USB
+5. 确认 `.demo/KV-5.13.6.zip`、`.demo/demo.json`、`.demo/goodreads/` 都在
+6. 弹出设备后在 Kindle 上点 `Done`
+7. 退出 `demo menu`
 
 这里的详细说明看：
 
@@ -93,19 +97,43 @@ sh bootstrap-new-kindle.sh prepare-storage --download-kterm --kterm-version v2.6
 
 因为 bootstrap 已经把 `.demo` payload 预置好了，这一轮不需要你在导入点再手工从 Mac 拷 `KV-5.13.6.zip`。
 
-### 5. 触发越狱并验收
+### 5. 触发越狱脚本
 
-完成 `Get Started` 后，设备会重启并执行越狱脚本。
+接下来按这个顺序走：
 
-验收标准：
+1. `;dsts -> Help & User Guides -> Get Started`
+2. `register this demo` 三个输入框都填 `111`
+3. `Fetching available demo types` 选 `Skip`
+4. demo type 选 `standard`
+5. 设备重启
+6. 落到 `Configure Device` 时，不要点进去，用隐藏手势回到主页
 
-- Kindle 用户存储根目录出现 `mkk`
-- Kindle 用户存储根目录出现 `libkh`
-- Kindle 用户存储根目录出现 `rp`
+这里不要急着跑 `;log mrpi`，因为还差 custom hotfix 这一步。
 
-如果没有这三个目录，说明这轮 `WatchThis` 没真正落地，不要继续往后做。
+### 6. 安装 WatchThis custom hotfix
 
-### 6. 安装 KUAL / MRPI / USBNetwork / dashboard / KTerm
+回到主页后：
+
+1. 搜索 `;uzb`
+2. 接 USB
+3. 确认 Kindle 根目录存在 `Update_hotfix_watchthis_custom.bin`
+4. 安全弹出 Kindle
+5. 搜索 `;dsts`
+6. 进入 `Device Options`
+7. 点 `Update Your Kindle`
+8. 等设备重启回主页
+
+如果这里报 `Update Error 2`，第一件事先检查根目录里是否真的有：
+
+- `Update_hotfix_watchthis_custom.bin`
+
+不要把 macOS 生成的：
+
+- `._Update_hotfix_watchthis_custom.bin`
+
+误当成真正的 hotfix 文件。
+
+### 7. 安装 KUAL / MRPI / USBNetwork / dashboard / KTerm
 
 回到首页后：
 
@@ -125,7 +153,7 @@ Rename OTA Binaries -> Rename
 
 ## Wi‑Fi 和 SSH 验证
 
-### 7. 接回 Wi‑Fi
+### 8. 接回 Wi‑Fi
 
 让 Kindle 连到和 Mac 同一个主 Wi‑Fi。
 
@@ -134,7 +162,7 @@ Rename OTA Binaries -> Rename
 - Guest Wi‑Fi
 - 开了客户端隔离的网络
 
-### 8. 在 KTerm 里拉起 DropBear
+### 9. 在 KTerm 里拉起 DropBear
 
 打开 `KTerm`，执行：
 
@@ -151,7 +179,7 @@ sh /mnt/us/ssh-force-dropbear-22.sh
 dropbear... TCP *:22 (LISTEN)
 ```
 
-### 9. 在 Mac 上确认 SSH
+### 10. 在 Mac 上确认 SSH
 
 回到 Mac：
 
@@ -180,7 +208,7 @@ ps -ef | grep -E 'sshd|dropbear|telnetd' | grep -v grep
 
 ## Dashboard 闭环验证
 
-### 10. 让 bootstrap 跑后半段
+### 11. 让 bootstrap 跑后半段
 
 在 Mac 上执行：
 
@@ -188,9 +216,15 @@ ps -ef | grep -E 'sshd|dropbear|telnetd' | grep -v grep
 sh bootstrap-new-kindle.sh post-ssh -t simple -o portrait
 ```
 
+前提说明：
+
+- 这一步默认建立在第 2 步 `prepare-storage` 已成功落地的前提上
+- 当前 `post-ssh` 会同步 dashboard shell 脚本、`KUAL` 菜单和主题包
+- 它不会回补 `prepare-storage` 预置的原生二进制，例如 `next-wakeup`、`xh`
+
 预期结果：
 
-- 同步当前 dashboard 运行时
+- 同步当前 dashboard shell 脚本、`KUAL` 菜单和主题包
 - 同步主题包
 - 设备立即切到 `simple / portrait`
 - 屏幕出现背景与时钟
@@ -201,7 +235,9 @@ sh bootstrap-new-kindle.sh post-ssh -t simple -o portrait
 sh bootstrap-new-kindle.sh post-ssh -t simple -o portrait --start-dashboard
 ```
 
-### 11. 抓首张验收图
+这一步同样默认要求设备上已经有 `prepare-storage` 预置的完整 dashboard 基础运行时。
+
+### 12. 抓首张验收图
 
 在 Mac 上执行：