# Kindle Voyage 5.13.6 一次成功路径

这篇文档只覆盖下面这个组合：

- 机型：`Kindle Voyage (KV)`
- 固件：`5.13.6`
- 目标：完成越狱，并部署 `KUAL`、`MRPI`、`renameotabin` 和 `kindle-dash`

如果设备型号或固件版本不同，不要直接照抄本文。

## 核心结论

`Kindle Voyage 5.13.6` 应该走 `WatchThis`，不要走 `LanguageBreak`。

这次实操里，前面大部分失败都来自两个错误：

- 误走了 `LanguageBreak`
- 在 demo 菜单里点错了分支，提前进入了 `Resell Device` / `销售设备`

对这台设备，正确思路非常简单：

1. 用 `WatchThis` 进入 demo mode
2. 只在正确的 `Sideload Content` 时机导入 `KV-5.13.6.zip`
3. 用 `Get Started` 触发越狱脚本
4. 安装 `KUAL/MRPI`
5. 用 `renameotabin` 关闭 OTA
6. 再部署并启动 `kindle-dash`

## 需要准备的文件

### WatchThis

来自 `watchthis-jailbreak-r03.zip`：

- `KV-5.13.6.zip`
- `demo.json`
- `Update_hotfix_watchthis_custom.bin`

在本仓库里对应的是：

- `staging/watchthis/KV-5.13.6/KV-5.13.6.zip`
- `staging/watchthis/KV-5.13.6/demo.json`
- `staging/watchthis/Update_hotfix_watchthis_custom.bin`

### 越狱后安装包

- `extensions/MRInstaller`
- `mrpackages/Update_KUALBooklet_HDRepack.bin`
- `extensions/renameotabin`
- `extensions/kindle-dash`
- `dashboard/`

在本仓库里已经整理到：

- `staging/post-jailbreak-root/extensions/`
- `staging/post-jailbreak-root/mrpackages/`
- `staging/post-jailbreak-root/dashboard/`

## 一次成功的正确路径

### 1. 恢复出厂并进入 demo mode

1. 先恢复出厂设置。
2. 语言选择页只选 `English (United Kingdom)`。
   这一步非常关键，不要选中文。
3. 到 Wi‑Fi 页面后，随便点一个网络，再立刻退回，不要真的联网。
4. 在搜索栏输入 `;enter_demo`。
5. 如果 `;enter_demo` 没反应，走备用入口：
   - 用 USB 连接电脑
   - 在 Kindle 根目录创建空文件 `DONT_CHECK_BATTERY`
   - 弹出设备
   - 回到 Kindle 搜索输入 `;demo`
6. 如果看到 `Demo Activation`，点 `Yes`。
7. 设备重启并进入 demo 流程后：
   - 跳过 Wi‑Fi
   - 店铺注册信息全部填假值
   - `Fetching available demo types` 选 `Skip`
   - demo type 选 `standard`

### 2. 第一次出现 Sideload Content 时不要导入 payload

1. 第一次出现 `Add Content` / `Sideload Content` 提示时，只点 `Done`。
2. 这一步不要接 USB。
3. 这一步也不要导入 `KV-5.13.6.zip`。

这是最容易做错的一步。第一次 `Done` 只是让 demo setup 继续往下走，不是真正的 payload 导入点。

### 3. 跳过 misconfiguration 锁页

demo setup 完成后，大概率会落到 `Configure Device` / misconfiguration 页面。

不要点 `Configure Device`，直接做隐藏手势：

1. 在屏幕右下角用两根手指同时轻点一下
2. 两指立刻抬起
3. 马上用一根手指从右下向左滑

触发成功后会回到可操作界面。

### 4. 真正的 payload 导入点

1. 回到可操作界面后，搜索输入 `;demo`
2. 进入 demo menu
3. 选择 `Sideload Content` / `导入内容`
4. 到这一步再接 USB
5. 在 Kindle 根目录创建 `.demo/`
6. 把下面三个东西放进去：

```text
.demo/KV-5.13.6.zip
.demo/demo.json
.demo/goodreads/    <- 空目录
```

如果你在 Mac 上操作，可以直接用：

```sh
mkdir -p /Volumes/Kindle/.demo/goodreads
cp staging/watchthis/KV-5.13.6/KV-5.13.6.zip /Volumes/Kindle/.demo/
cp staging/watchthis/KV-5.13.6/demo.json /Volumes/Kindle/.demo/
```

然后：

1. 弹出 Kindle
2. 在 Kindle 上点 `Done`
3. 退出 demo menu

## 5. 触发越狱脚本

1. 退出 demo menu 后，输入 `;dsts`
   如果 `;dsts` 没反应，也可以从顶部下拉进入设置。
2. 打开 `Help & User Guides`
3. 再点 `Get Started`
4. 设备会重启
5. 越狱脚本会在下次启动时运行

如果这里弹 `Application Error`，官方补救是：

1. 长按电源键强制重启
2. 再进 demo menu
3. 再执行一次 `Sideload Content -> Done`
4. 这次不要再接 USB

## 6. 成功判据

对这台设备，下面这些现象说明越狱已经落地：

- Kindle 用户存储根目录出现 `mkk`
- Kindle 用户存储根目录出现 `libkh`
- Kindle 用户存储根目录出现 `rp`

如果这三个目录都没有，基本就是前面的 `WatchThis` 没真正成功。

## 7. 安装 KUAL / MRPI / kindle-dash

越狱落地后，把这些目录复制到 Kindle：

```sh
rsync -a staging/post-jailbreak-root/extensions/ /Volumes/Kindle/extensions/
rsync -a staging/post-jailbreak-root/mrpackages/ /Volumes/Kindle/mrpackages/
rsync -a staging/post-jailbreak-root/dashboard/ /Volumes/Kindle/dashboard/
```

然后：

1. 弹出 Kindle
2. 回到首页搜索输入 `;log mrpi`
3. 等安装完成
4. 首页会出现 `KUAL` 卡片

## 8. 启动顺序

进入 `KUAL` 后，先做这个顺序：

1. `Rename OTA Binaries -> Rename`
2. 再运行 `Kindle Dashboard`

不要先跑 `Kindle Dashboard`，否则后面如果 OTA 没关掉，还存在自动升级把越狱覆盖掉的风险。

## 9. kindle-dash 默认行为

本项目默认不会在 Kindle 本机实时渲染页面，而是定时去下载一张图片来显示。

因此：

- 如果没有联网，`Kindle Dashboard` 看起来会像“卡住”
- 如果刷新计划不覆盖当前时间，会显示 `kindle is sleeping`
- 图片最好直接按 Voyage 原生分辨率出图：`1072 x 1448`

默认抓图脚本在：

- `src/local/fetch-dashboard.sh`

默认刷新计划在：

- `src/local/env.sh`

## 10. 这台设备上确认过的坑

### 不要走 `LanguageBreak`

`KV + 5.13.6` 应走 `WatchThis`。误走 `LanguageBreak` 会导致：

- `;demo -> Yes -> 重启 -> 回普通系统`
- `;uzb`、`;dsts` 行为异常
- 反复进入错误的 demo 分支

### 不要点 `Resell Device` / `销售设备`

这个分支会把流程带到 shipping mode / demo 出厂流程，和 `WatchThis` 正常路径无关。

如果你是在 `WatchThis` 流程里，demo menu 里真正要点的是：

- `Sideload Content`

不是：

- `Resell Device`
- `Remote Reset`
- `Configure WiFi`

### 第一次 `Add Content` 只能点 `Done`

真正要接 USB 导 payload 的时机，是秘密手势之后再次 `;demo -> Sideload Content` 的那一次。

### 看到左上角只有一小块图片，不一定是失败

这通常只是图片尺寸不匹配。

例如本项目自带的 `sleeping.png` 只有 `600x800`，放到 Voyage 上就只会显示在左上角一部分区域。

## 参考

- WatchThis 包内说明：`watchthis-jailbreak-r03.zip` 中的 `watchthis-release/README.md`
- 项目主说明：`README.md`
- 图片抓取说明：`src/local/fetch-dashboard.sh`
- 本地调度配置：`src/local/env.sh`