gavin/kindle-calendar
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source
This commit is contained in:
douboer@gmail.com
2026-03-21 18:44:12 +08:00
parent f9d715157f
commit 89b1f97a6f
52 changed files with 3510 additions and 562 deletions
Download Patch File Download Diff File Expand all files Collapse all files

374
dash/docs/kindle-voyage-5.13.6-watchthis-zh.md
View File

@@ -1,34 +1,57 @@
# Kindle Voyage 5.13.6 一次成功路径
# Kindle Voyage 5.13.6 WatchThis 实测成功路径
这篇文档只覆盖下面这个组合：
恢复出厂
USB - .demo、DONT_CHECK_BATTERY、hotfix 和安装包一次性写回去
Demo Activation，点 Yes, 重启
这份文档只覆盖下面这个组合：
- 机型：`Kindle Voyage (KV)`
- 固件：`5.13.6`
- 目标：完成越狱，并部署 `KUAL`、`MRPI`、`renameotabin` 和 `kindle-dash`
- 目标：完成 `WatchThis` 越狱、安装 `custom hotfix`，再通过 `MRPI` 落地 `KUAL / USBNetwork / KTerm / kindle-dash`
如果设备型号或固件版本不同，不要直接照抄本文。
如果机型或固件版本不同，不要直接照抄。
## 核心结论
`Kindle Voyage 5.13.6` 应该走 `WatchThis`，不要走 `LanguageBreak`。
这台 `KV + 5.13.6` 当前最稳的顺序，不是“`Get Started` 后立刻检查 `mkk/libkh/rp`”，而是下面这条完整链路：
这次实操里，前面大部分失败都来自两个错误：
1. 恢复出厂，语言只选 `English (United Kingdom)`
2. 先输入;enter_demo, `;demo`
demo activation - yes - shipping mode error(电量低的原因)
1. 把 Kindle 接上 USB。
2. 我在根目录创建一个空文件 DONT_CHECK_BATTERY。
3. `demo menu -> Sideload Content`，在这里接 USB，把 `.demo/` payload 写进去
- .demo/KV-5.13.6.zip
- .demo/demo.json
- .demo/goodreads/
- extensions/
- mrpackages/
- dashboard/
- Update_hotfix_watchthis_custom.bin
4. `;dsts -> Help & User Guides -> Get Started`
5. 按 demo 流程继续：`register this demo -> Skip -> standard`
6. 遇到 `Configure Device` 就用隐藏手势回到主页
7. 回到主页后搜索 `;uzb`，
Update Error 2 -- 插usb，继续重启到 register this demo
输入三个111
standard 页面 (详见下面说明) ……
- 误走了 `LanguageBreak`
- 在 demo 菜单里点错了分支，提前进入了 `Resell Device` / `销售设备`
**再接 USB，把 `Update_hotfix_watchthis_custom.bin` 放到根目录**
8. `;dsts -> Device Options -> Update Your Kindle`
9. 回到主页后搜索 `;log mrpi`
10. 首页出现 `KUAL`
对这台设备，正确思路非常简单：
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 payload
来自 `watchthis-jailbreak-r03.zip`：
@@ -36,203 +59,216 @@
- `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`
- `dash/staging/watchthis/KV-5.13.6/KV-5.13.6.zip`
- `dash/staging/watchthis/KV-5.13.6/demo.json`
- `dash/staging/watchthis/Update_hotfix_watchthis_custom.bin`
### 越狱后安装包
- `extensions/MRInstaller`
- `mrpackages/Update_KUALBooklet_HDRepack.bin`
- `extensions/renameotabin`
- `extensions/kindle-dash`
- `dashboard/`
本仓库已经整理好的目录：
在本仓库里已经整理到：
- `dash/staging/post-jailbreak-root/extensions/`
- `dash/staging/post-jailbreak-root/mrpackages/`
- `dash/staging/post-jailbreak-root/dashboard/`
- `staging/post-jailbreak-root/extensions/`
- `staging/post-jailbreak-root/mrpackages/`
- `staging/post-jailbreak-root/dashboard/`
如果你已经执行过：
```sh
sh bootstrap-new-kindle.sh prepare-storage
```
这些内容通常已经预置到 Kindle 用户存储，不需要再手工拷一次。
## 一次成功的正确路径
### 1. 恢复出厂并进入 demo mode
### 1. 恢复出厂并进入 demo menu
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`
3. 不要联网。
4. 在搜索框输入 `;demo`。
5. 进入 `demo menu`。
### 2. 第一次出现 Sideload Content 时不要导入 payload
如果这里没有进入 `demo menu`，再考虑备用入口；对本次实机成功路径来说，直接 `;demo` 就够了。
1. 第一次出现 `Add Content` / `Sideload Content` 提示时，只点 `Done`。
2. 这一步不要接 USB。
3. 这一步也不要导入 `KV-5.13.6.zip`。
### 2. 在 Sideload Content 页面导入 payload
这是最容易做错的一步。第一次 `Done` 只是让 demo setup 继续往下走，不是真正的 payload 导入点。
1. 在 `demo menu` 里点 `Sideload Content`。
2. 到这个页面后，再接 USB。
3. 在 Kindle 根目录确认下面三个东西存在：
### 3. 跳过 misconfiguration 锁页
```text
.demo/KV-5.13.6.zip
.demo/demo.json
.demo/goodreads/
```
demo setup 完成后，大概率会落到 `Configure Device` / misconfiguration 页面。
4. 安全弹出 Kindle。
5. 回到 Kindle，点 `Done`。
6. 退出 `demo menu`。
不要点 `Configure Device`，直接做隐藏手势：
如果你在 Mac 上手工操作，对应文件结构就是：
```text
/Volumes/Kindle/.demo/KV-5.13.6.zip
/Volumes/Kindle/.demo/demo.json
/Volumes/Kindle/.demo/goodreads/
```
### 3. 用 Get Started 触发越狱脚本
1. 退出 `demo menu` 后，搜索输入 `;dsts`。
2. 进入 `Help & User Guides`。
3. 点 `Get Started`。
接下来按这轮实测成功路径继续：
1. 出现 `register this demo` 时，三个输入框都填 `111`
2. `Fetching available demo types` 选 `Skip`
3. 出现 demo type 时选 `standard`
之后设备会重启。
### 4. 遇到 Configure Device 时不要点进去
重启后如果看到 `Configure Device`，不要点 `Configure Device`，直接做隐藏手势：
1. 在屏幕右下角用两根手指同时轻点一下
2. 两指立刻抬起
3. 马上用一根手指从右下向左滑
触发成功后会回到可操作界面。
成功后会回到主页。
### 4. 真正的 payload 导入点
### 5. 用 ;uzb 暴露用户存储并写入 hotfix
1. 回到可操作界面后，搜索输入 `;demo`
2. 进入 demo menu
3. 选择 `Sideload Content` / `导入内容`
4. 到这一步再接 USB
5. 在 Kindle 根目录创建 `.demo/`
6. 把下面三个东西放进去：
回到主页后：
1. 搜索输入 `;uzb`
2. 再接 USB
3. 在 Kindle 根目录确认存在：
```text
.demo/KV-5.13.6.zip
.demo/demo.json
.demo/goodreads/ <- 空目录
/Volumes/Kindle/Update_hotfix_watchthis_custom.bin
```
如果你在 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/
```text
dash/staging/watchthis/Update_hotfix_watchthis_custom.bin
```
拷到 Kindle 根目录。
然后：
1. 弹出 Kindle
2. 在 Kindle 上点 `Done`
3. 退出 demo menu
1. 安全弹出 Kindle
2. 回到设备
## 5. 触发越狱脚本
### 6. 手工安装 custom hotfix
1. 退出 demo menu 后，输入 `;dsts`
如果 `;dsts` 没反应，也可以从顶部下拉进入设置。
2. 打开 `Help & User Guides`
3. 再点 `Get Started`
4. 设备会重启
5. 越狱脚本会在下次启动时运行
这一步不要再走 `Help & User Guides`。
如果这里弹 `Application Error`，官方补救是：
正确路径是：
1. 搜索输入 `;dsts`
2. 进入 `Device Options`
3. 点 `Update Your Kindle`
这一步跑完后设备会重启，并退出 demo 状态，回到正常主页。
## 7. 用 MRPI 安装 KUAL / USBNetwork / KTerm / dashboard
回到主页后，搜索输入：
```text
;log mrpi
```
如果 `mrpackages/` 已经预置到根目录，MRPI 会开始安装。
实测成功判据：
- 主页出现 `KUAL`
- 如果这轮预置了 `KTerm`，后续也应该能找到 `KTerm`
## 8. 进入 KUAL 后的顺序
进入 `KUAL` 后，先执行：
```text
Rename OTA Binaries -> Rename
```
不要先跑 `Kindle Dashboard`，先把 OTA 关掉。
## 9. 这轮流程里最容易做错的地方
### 不要走 LanguageBreak
`KV + 5.13.6` 应走 `WatchThis`，不要走 `LanguageBreak`。
### 不要点 Resell Device / Remote Reset / Configure WiFi
这几个都不是这条成功路径的一部分。
### `Get Started` 后不要直接去找 `Update Your Kindle`
先要完成：
- `register this demo`
- `Skip`
- `standard`
- 重启后隐藏手势回主页
然后才是：
- `;uzb`
- 写入 `Update_hotfix_watchthis_custom.bin`
- `Device Options -> Update Your Kindle`
### `Update Your Kindle` 之前必须先写 hotfix bin
`Update Your Kindle` 对应的是安装：
```text
Update_hotfix_watchthis_custom.bin
```
如果根目录里没有这个文件，就很容易出现 `Software Update / Update Error 2`。
### 不要把 `mkk/libkh/rp` 当成当前这条流程里的唯一人工判据
这轮最实用的成功判据是：
1. `Update Your Kindle` 能正常跑完并重启回主页
2. `;log mrpi` 能执行
3. 首页出现 `KUAL`
## 10. 如果某一步出错
### `Get Started` 后出现 Application Error
按上游 `WatchThis` README 的补救方式：
1. 长按电源键强制重启
2. 再进 demo menu
2. 再进 `demo menu`
3. 再执行一次 `Sideload Content -> Done`
4. 这次不要再接 USB
## 6. 成功判据
### `Update Your Kindle` 报 `Update Error 2`
对这台设备，下面这些现象说明越狱已经落地：
先检查 Kindle 根目录里是不是真的有：
- 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/
```text
Update_hotfix_watchthis_custom.bin
```
然后：
注意不要把 macOS 生成的：
1. 弹出 Kindle
2. 回到首页搜索输入 `;log mrpi`
3. 等安装完成
4. 首页会出现 `KUAL` 卡片
```text
._Update_hotfix_watchthis_custom.bin
```
## 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`
误当成真正的 hotfix 文件。