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

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

@@ -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 上执行：

31
dash/docs/kindle-voyage-5.13.6-bootstrap-zh.md
View File

@@ -8,7 +8,7 @@
- 预置 `KUAL / MRPI / USBNetwork / kindle-dash`
- 可选预置 `KTerm`
- 预置 SSH 恢复脚本
- SSH 打通后自动同步 dashboard、切主题、立即出图
- SSH 打通后自动同步 dashboard shell 脚本 / KUAL 菜单 / 主题包，切主题并立即出图
对应脚本：
@@ -106,9 +106,14 @@ sh bootstrap-new-kindle.sh post-ssh
- 修复设备侧 SSH 辅助脚本权限
- 尝试同步 `authorized_keys`
- 同步 dashboard 运行时和主题包
- 同步 dashboard shell 脚本、KUAL 菜单和主题包
- 立即切到指定主题并把背景画到屏幕上
当前边界：
- `post-ssh` 不会回补 `prepare-storage` 阶段预置的原生二进制，例如 `next-wakeup`、`xh`
- 所以它的默认前提仍然是：这台设备之前已经执行过 `prepare-storage`，或设备上本来就已有完整 dashboard 基础运行时
可选：
```sh
@@ -116,6 +121,8 @@ 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`
默认模式：
@@ -135,23 +142,29 @@ sh bootstrap-new-kindle.sh
1. 恢复出厂并进入 demo mode
2. 到真正的 `Sideload Content` 时机
3. 让脚本已预置好的 `.demo` payload 生效
4. 通过 `Get Started` 完成越狱
5. 搜索 `;log mrpi`
6. 在 `KUAL` 中先执行 `Rename OTA Binaries -> Rename`
7. 如果本轮没有预置 `KTerm`，这里先手工补装 `KTerm`
8. 连上 Wi‑Fi
9. 打开 `KTerm`，执行：
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
sh /mnt/us/ssh-force-dropbear-22.sh
```
10. 回到 Mac，执行：
14. 回到 Mac，执行：
```sh
sh bootstrap-new-kindle.sh post-ssh
```
这里默认仍然建立在第 1 步已经成功做过 `prepare-storage` 的前提上。
## 相关文档
- WatchThis 越狱路径：

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 文件。