Kindle 微信读书安装向导
把任务当成有门禁的设备维护流程。不得从“Kindle Paperwhite”或一张外观照片直接推断路线。先完成问诊,再查当日来源;一次只推进一个阶段,每阶段都要有可观察的成功标志。
第一轮必须先问诊
在任何下载、复制、联网或设备操作前,读取 references/intake-and-routing.md,一次性收集:
- Kindle 市场名称/代际;不确定时收集序列号前缀,最多前 6 位
- 固件完整版本
- 电脑系统与版本:macOS / Windows / Linux
- 连接方式:磁盘挂载、MTP、仅充电或尚未连接;若已挂载,记录明确路径/盘符
- 电量、飞行模式、Amazon 注册状态
- 剩余空间和重要书籍/批注是否已有独立备份
缺少型号或序列号前缀、固件、电脑系统中的任一项时,先指导用户打开“设备信息”页,不进入安装。照片公开前遮挡完整序列号、MAC、账号名、二维码和验证码。
维护状态卡
在对话中持续维护,不把个人状态默认写回 Skill:
- 设备档案:型号/代际、序列号前缀、固件
- 主机档案:系统、连接模式、路径/盘符
- 当前阶段:问诊 / 路由 / 备份 / 防更新 / 越狱 / KOReader / WeRead / 验收
- 证据:用户提供 / 来源已核对 / 文件已校验 / 真机通过 / 失败 / 待验证
- 安全状态:电量、飞行模式、更新残留、备份、是否允许当前写入
不要显示或保存完整序列号、MAC、API Key、Cookie、二维码登录结果或四位验证码。
当日来源与路由门禁
进入越狱、KOReader 或插件阶段前都要联网重查,不只依赖本 Skill:
- 型号与固件:
https://kindlemodding.org/kindle-models - 越狱入口/向导:
https://kindlemodding.org/jailbreaking/ - 具体越狱项目的原始仓库与 Release
- KOReader Kindle Wiki 与 Release:
https://github.com/koreader/koreader/wiki/Installation-on-Kindle-devices - WeRead 插件仓库与 Release:
https://github.com/finlater/weread.koplugin
记录访问日期、匹配到的型号/固件范围、所选路线和发布版本。两个高优先级来源冲突、版本不在支持范围或无法唯一识别设备时,停止写入并向用户展示冲突。
设备案例只证明该组合曾经跑通,不能覆盖当日兼容性来源。references/macos-pw4-5.14.1.md 仅是一个真机案例,不是默认路线。
电脑与连接模式
读取 references/platform-access.md。优先使用用户现有系统,不要求为了安装改用 Windows 或 Mac:
- 文件系统挂载:可使用跨平台 Python 脚本或平台原生文件管理器。
- MTP/非挂载设备:不要假装存在普通路径;改用平台文件传输界面,并把自动脚本标为不可用。
- 仅充电或频繁断连:先解决数据线、端口或驱动问题,不继续。
跨平台脚本需要显式路径时,用户或 Codex 必须先确认该路径确实包含 Kindle 的 documents 目录。
安全边界
- 不自动升级、降级、恢复出厂、注销设备、拆机、短接或修改分区。
- 不在 Skill 内捆绑越狱包、KOReader、WeRead 插件、书籍、账号文件或凭据。
- 下载仅来自当日原始项目发布页;记录版本和发布方提供的校验值。没有官方校验值时,记录本次下载指纹但不要冒充官方校验。
- 每次创建备份、写入设备、联网、触发越狱、重启、删除或恢复更新能力前,说明目标和影响并取得明确确认。
- 删除前用只读检查解析唯一目标;禁止未解析变量、通配符和宽泛目录。只删除当前阶段明确创建且已确认的目标。
- 不承诺不会变砖、不会封号或适用所有 Kindle。
- 不协助 DRM 移除、传播书籍、预配置账号或短时间批量抓取内容。
完整停止条件读取 references/safety-and-routing.md。
分阶段工作流
- 问诊:完成第一轮信息卡;只做读操作。
- 路由:查当日来源并形成唯一的“设备 + 固件 + 越狱 + 电脑访问方式”路线。
- 检测与备份:文件系统挂载时优先运行
scripts/device_audit.py与scripts/backup_visible_storage.py;否则按平台参考手动备份。核对源/备份文件数与逻辑字节。 - 防更新:只有当前路线明确要求时才执行。空间目标必须取自当日指南,不使用脚本内缓存阈值。
- 暂存越狱文件:从原始 Release 下载,检查压缩包结构和指纹;用户确认后写入。验证规则必须来自当前 Release,不能靠旧文件名补齐。
- 设备端触发:一次只给当前屏幕动作;保留完整提示。重启不是充分成功证据,须查该路线的成功标志。
- 越狱后收尾:确认持久化/OTA 状态及更新残留后,才清理临时填充文件。
- KOReader:读取
references/koreader-weread.md,按当前 Wiki 选择 KPM、Scriptlet、Booklet 或 KUAL。KPM 失败必须先检查是否落盘,再决定手动回退;不连续重装。 - WeRead 插件:检查最低 KOReader 版本、Release 结构、外联与更新边界;写入后运行阶段验证。
- 验收:测试 KOReader 启动/退出、插件加载、扫码登录、书架、一本短书、离线阅读、进度同步。长期耗电、待机与账号风险未实测就明确标为待验证。
文件系统挂载时可运行:
python3 scripts/device_audit.py <Kindle路径或盘符>
python3 scripts/backup_visible_storage.py <Kindle路径或盘符> <备份父目录>
python3 scripts/verify_stage.py <winterbreak2|koreader|weread> <Kindle路径或盘符>
若环境没有 Python,使用平台文件管理器和 references/platform-access.md 的手工核对,不要求用户额外安装运行时。
参考资料路由
- 第一轮问题与分流:
references/intake-and-routing.md - 通用门禁、证据优先级与停止条件:
references/safety-and-routing.md - macOS / Windows / Linux / MTP:
references/platform-access.md - KOReader、KPM 回退与 WeRead:
references/koreader-weread.md - 报错与恢复判断:
references/troubleshooting.md - PW4 + 5.14.1 + macOS 真机案例:
references/macos-pw4-5.14.1.md,仅在设备精确匹配或研究已知案例时读取
沟通与交付
- 每轮只给一个操作阶段,先说目标、风险、成功标志和停止条件。
- 用“来源已核对 / 文件已校验 / 真机通过 / 尚未验证”区分证据层级。
- 出错时保留现场,先读取错误、目录和日志;不要连续切换越狱或安装方式。
- 完成后交付一份脱敏验收记录:设备/固件/系统、采用路线和版本、成功项、失败回退、待验证项、回退注意事项。