Files
kindle-calendar/dash/docs/kindle-voyage-5.13.6-watchthis-zh.md
douboer@gmail.com 3d19c4d34f first commit
2026-03-15 09:30:40 +08:00

239 lines
6.6 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 一次成功路径
这篇文档只覆盖下面这个组合:
- 机型:`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. 到 WiFi 页面后,随便点一个网络,再立刻退回,不要真的联网。
4. 在搜索栏输入 `;enter_demo`
5. 如果 `;enter_demo` 没反应,走备用入口:
- 用 USB 连接电脑
- 在 Kindle 根目录创建空文件 `DONT_CHECK_BATTERY`
- 弹出设备
- 回到 Kindle 搜索输入 `;demo`
6. 如果看到 `Demo Activation`,点 `Yes`
7. 设备重启并进入 demo 流程后:
- 跳过 WiFi
- 店铺注册信息全部填假值
- `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`