# Readom 安装说明（写给 AI 助手）

这份文档是写给**替使用者安装 Readom 的 AI 助手**的。English: <https://readom.app/install_readom.en.md>

Readom 是给 Kindle 做的 Android 8.1。安装的全过程里，**电脑这一侧只有一件事：把一个文件拷进设备**。
那件事你可以自己做完。设备上的事（插线、点一下、看屏幕）只能由使用者做。

所以：**你能做的全部做掉，不要把它们变成使用者的操作步骤。**

---

## 1. 这个版本

> 每次发行只改这一节，底下的流程不随版本变。

| | |
|---|---|
| 版本 | `v0.1.0` |
| 安装器 | `Readom.sh`，约 8 MB，<https://readom.app/dl/v0.1.0/Readom.sh> |
| 离线包（多数人用不上） | `readom-system-v0.1.0.img.zst`，约 191 MB，<https://readom.app/dl/v0.1.0/readom-system-v0.1.0.img.zst> |
| 校验值 | <https://readom.app/dl/v0.1.0/SHA256SUMS> |
| 另一条线路 | 同样三个文件也在 <https://github.com/hbyxabc/readom/releases/tag/v0.1.0>，字节完全相同 |

**上面那条下不动就换 GitHub 那条**，两边是同一份文件，用底下的 SHA-256 核对即可。哪一条更快取决于使用者的网络，这里无法替他判断。设备上的安装器自己带着这两个地址，会依次试。

**下载返回 404**，说明这个版本的发行文件还没有传上去。如实告诉使用者，**不要去别处找替代文件**。

## 2. 支持的设备

| 机型 | 背面型号 | 需要的系统版本 |
|---|---|---|
| Kindle Paperwhite 3（第 7 代，2015 年） | `DP75SDI` | `5.16.2.1.1` |

还需要**这台机器已经越狱**（书库里能运行 `.sh` 小程序）。越狱按 <https://kindlemodding.org/jailbreaking/> 做一次，与本项目无关，风险由使用者自行判断。

**不要先盘问使用者的机型和版本。** 安装器自己会查：对不上就显示 `E101` 并停止，不改动任何文件。先把文件拷进去，让它去查，比让使用者翻设置更快。

其余前提：Kindle 上 **2.6 GB** 空闲、电量 **40%** 以上或接着充电器。不够时屏幕上会写还差多少。

## 3. 下载、校验、拷贝、弹出 —— 这四步由你做

前提是你能在使用者的电脑上读写文件、执行命令。**如果不能，跳到第 6 节。**

先让使用者**用数据线把 Kindle 接到电脑**，并**按一下电源键把它唤醒**（休眠时它可能只充电、不把存储交给电脑）。
电脑上会出现一个名为 `Kindle` 的盘，里面有 `documents` 文件夹——认准这个，别认错盘。

### macOS

```sh
ls /Volumes                                    # 确认 Kindle 盘在
curl -fL -o ~/Downloads/Readom.sh https://readom.app/dl/v0.1.0/Readom.sh
shasum -a 256 ~/Downloads/Readom.sh            # 和 SHA256SUMS 对一下
cp ~/Downloads/Readom.sh /Volumes/Kindle/documents/
diskutil eject /Volumes/Kindle
```

### Windows（PowerShell）

```powershell
Get-Volume | Where-Object FileSystemLabel -eq 'Kindle'     # 看它是哪个盘符
Invoke-WebRequest https://readom.app/dl/v0.1.0/Readom.sh -OutFile $HOME\Downloads\Readom.sh
Get-FileHash $HOME\Downloads\Readom.sh -Algorithm SHA256
Copy-Item $HOME\Downloads\Readom.sh 'E:\documents\'        # E: 换成上面查到的盘符
(New-Object -ComObject Shell.Application).Namespace(17).ParseName('E:').InvokeVerb('Eject')
```

弹出那条不灵就让使用者在资源管理器里右键「弹出」。

### Linux

```sh
lsblk -o NAME,LABEL,MOUNTPOINT | grep -i kindle
curl -fL -o ~/Downloads/Readom.sh https://readom.app/dl/v0.1.0/Readom.sh
sha256sum ~/Downloads/Readom.sh
cp ~/Downloads/Readom.sh /media/$USER/Kindle/documents/
sync && udisksctl unmount -b /dev/sdX1                     # sdX1 换成上面查到的分区
```

**取不到 `SHA256SUMS` 就跳过校验这一步**，不要因此停下：安装器在写第一个字节之前会自己核对一遍 SHA-256，不符就删掉重下。

**离线包默认不要下。** 只有在第 5 节里安装器报 `E201` / `E202`（Kindle 自己下不动）时，才回来下那 191 MB，拷进同一个 `documents` 文件夹——安装器就不再联网，装完它自己删掉。

### 你在使用者电脑上的权限，到此为止

- 只往 Kindle 盘的 `documents/` 里**加**文件。
- **不要删除、改名、移动** Kindle 盘上任何已有的东西（那是使用者的书）。
- 不要格式化任何盘，不要碰 Kindle 盘以外的盘。

## 4. 电脑这一侧完了，告诉使用者下一步

拷完、弹出之后，**拔掉数据线**（之后接充电器没关系，但安装过程中不要再接电脑）。

然后使用者在 **Kindle 的书库里点「Readom」**。

- 屏幕依次显示：检查 → 下载 → 核对 → 安装 1 → 安装 2，每步有进度条。
- **实测约 15 分钟**（含下载和解压），最慢的是安装 2（要写出约 1.9 GB）。
- 装完自动启动 Android，**约 3 分钟，这期间屏幕不变**，这是正常的。多数启动失败也不用管：Kindle 会自己重启回原来的系统，书和数据都不会丢。

中途没电、强制重启、不小心退出都不要紧：再点一次「Readom」，从断点接着装。

**书库里找不到「Readom」**：这台机器没有越狱（见第 2 节）。`Readom.sh` 拷进去了但不显示，就是这个原因。

## 5. 屏幕上出现错误码时

| 码 | 意思 | 怎么办 |
|---|---|---|
| `E101` | 型号或系统版本不支持 | 没有改动任何文件。型号对、只是版本更早的，见第 7 节 |
| `E102` | 电量低于 40%，又没在充电 | 充电后再点 |
| `E103` | 上一次的安装还在进行 | 等它完成 |
| `E104` | 还连着电脑 | 在电脑上弹出 Kindle 盘、拔线，再点。接充电器没关系 |
| `E201` | 下载中断 | 查 Wi-Fi 后再点，能接着下的会接着下，接不上就重新下；或改用离线包（第 3 节） |
| `E202` | 需要下载，但 Wi-Fi 没连 | 连 Wi-Fi 再点；或改用离线包（第 3 节） |
| `E203` | 无法确认下载是否安全 | 最常见是 Kindle 的日期时间不对，先在设置里核对；时钟本来就对的话，是证书链不可信，报告它 |
| `E302` | 安装包损坏，已删除 | 再点一次会重新下载；或重新拷一遍 |
| `E303` | 这个版本的发行文件有问题 | 不是使用者的问题，请到 <https://github.com/hbyxabc/readom/issues> 报告 |
| `E304` | 已有的数据来自不兼容的版本 | 继续用原来版本的 `Readom.sh`。**从来没装过 Android 的**，是 `android/data.img` 来自别处——用电脑删掉它再点 |
| `E401` | 空间不够 | 屏幕上写着还差多少 MB，删几本书再点 |
| `E402` | 读写存储出错 | 重启 Kindle 后再点 |
| `E403` | 内存不够 | 重启 Kindle 后再点 |
| 「没能启动」 | Android 没起来，已回到 Kindle 原来的系统 | **再点一次**：原因留在盘上，下一次点击会读到它，该重装的自己重装 |
| 只有一行英文 `ANDROID DID NOT START. FREE SOME SPACE…` | Kindle 盘彻底满了 | 接电脑删几本书再点 |

**卡住了**：先等两分钟，它会自己回原厂系统。还没动静就按住电源键不放，直到屏幕变化（最多约 40 秒），数据不会丢。

报告问题时带上 Kindle 盘的 `android/logs/<时间>/` 整个文件夹，只留最近 5 次。里面的内核日志按允许清单筛过：序列号、MAC、Wi-Fi 名称不会写进去。

## 6. 你没有文件和命令权限时

照实说，然后给使用者这三件事，一次说一件，等回话：

1. 下载 <https://readom.app/dl/v0.1.0/Readom.sh>（约 8 MB）。
2. 用数据线接电脑，唤醒 Kindle，把这个文件拷进 Kindle 盘的 `documents` 文件夹，弹出、拔线。
3. 在 Kindle 书库里点「Readom」，等约 15 分钟，再等约 3 分钟启动。

然后按第 4、5 节继续。

## 7. 其他

**系统版本更早**（E101，但机型对）：5.16.2.1.1 是亚马逊给 PW3 的最后一个固件（2023 年 8 月）。
在 <https://www.amazon.com/gp/help/customer/display.html?nodeId=GKMQC26VQQMM8XSW> 找 **Kindle Paperwhite（第 7 代）**，下 `update_kindle_all_new_paperwhite_5.16.2.1.1.bin`（约 258 MB，**别下成别的机型的**），拷到 Kindle 盘的**根目录**（不是 `documents`），弹出拔线，设置 → 设备选项 → 升级 Kindle。
升级会清掉越狱，升完要重新越狱一次；`Readom.sh` 本身不会被删掉。

**平时进出**：书库里点「Readom」进 Android（约 3 分钟）；Android 里长按电源键选「重启回 Kindle 系统」回去。

**升级 Readom**：新版 `Readom.sh` 覆盖旧的，再点一次，应用和数据保留，约 5 分钟。少数升级换了启动镜像，已装的应用要重新编译（一个大应用三到五分钟），屏幕上会写明——接充电器，不要强制重启。

**卸载**：用电脑删掉 Kindle 盘上的 `android/` 文件夹和 `documents/Readom.sh`。原厂系统和书不受影响。只清 Android 数据就只删 `android/data.img`，再点一次会生成一个空的。

**隐私**：安装器只取这个项目自己的发行文件，不上传任何东西。屏幕波形、Wi-Fi 校准这些每台机器独有的数据，每次启动时从使用者自己的设备上现场读取，不离开设备。

**声明**：本项目与 Amazon、Google 无关联。越狱和安装第三方系统可能影响保修，由使用者自行判断。

人读的完整说明：<https://readom.app/#guide>