面向 Kindle Paperwhite 3 / KOReader kindlepw2 的离线 Rime 中文输入插件。
插件保留 KOReader 原有中文键盘外观，由 ARMv7 softfp native wrapper 提供
自然码双拼、朙月拼音及其他双拼方案的候选、分页、选词和用户词频学习。
当前版本：0.5.0，目标平台：kindlepw2。
- 解压发布包，得到
rime.koplugin。 - 将整个目录复制到 Kindle 的
/mnt/us/koreader/plugins/。 - 重启 KOReader。
- 打开“更多工具 → Rime Chinese input”，启用 Rime 输入法。
- 再次重启 KOReader，等待首次部署完成。PW3 首次部署约需 1–2 分钟。
- 切换到
RIME键盘（键盘布局列表中显示为RIME (ri)）。默认方案为schema_list的第一项；短按键盘地球图标可打开方案选择 Dialog。
RIME 是插件在 KOReader 键盘布局列表中注册的专属布局名，与系统自带的
中文（简体） 键盘外观相同，但使用独立的按键定义：只有选择 RIME 才会
启用 librime；选择 中文（简体） 时仍使用 KOReader 原生中文输入法。
插件完全离线工作，不修改 Kindle rootfs、系统输入法或 KOReader Core。
- 短按
RIME键盘的地球图标会打开 Rime 方案选择 Dialog；长按仍打开 KOReader 键盘布局选择界面。插件菜单中的 “Input schema” 也可使用。 - 方案选择即时生效并持久保存。切换时未提交的编码会被清除，已输入正文不受 影响。
- 方案选择 Dialog 同时显示所选方案的运行时选项：中/英、半角/全角、简体/繁體
与全/半角标点等（由各 schema 的
switches声明决定，不同方案选项不同）。 点击 “Switch” 一次完成方案与选项的切换。 - 每个方案的选项选择会单独记忆：下次打开该方案时沿用上次的选择；会话重建时 也会自动套用，而不是每次都回到 schema 默认值。
- 内置自然码、朙月拼音·简化字、小鹤、微软、智能 ABC、拼音加加、四通双拼 和笔画。自然码是默认方案，全部双拼方案默认输出简体字。
- 点击候选、Space 或数字键提交候选。
- 可打印按键原样交给当前 Rime 方案处理；Lua 层不转换大小写，也不硬编码方案字母表。
- 左右候选箭头按实际候选宽度动态分页；候选窗口和全局索引选词由 librime_koreader 提供。
- Backspace 编辑当前拼音；没有拼音时保持 KOReader 原始行为。
- Enter 先提交拼音，再执行输入框原本的 Enter 行为。
- Escape 清除当前拼音且不提交。
- 光标移动、切换输入框或关闭键盘前会先提交当前拼音。
- 用户词频位于 KOReader data 目录的
rime/user，升级插件不会删除它。
Terminal direct inputbox 和英文键盘不会被 Rime 接管。
升级时直接覆盖 /mnt/us/koreader/plugins/rime.koplugin 后重启。不要删除
KOReader data 目录下的 rime/user，它保存用户词频。
禁用时在插件菜单关闭“Enable Rime input”并重启 KOReader。彻底卸载时先禁用并
重启，再删除插件目录。卸载后 RIME 布局项随插件消失，键盘会回退到英文；
如需继续使用系统中文键盘，请在布局列表中重新选择 中文（简体）。用户词频
可继续保留，便于以后重新安装。
- 状态菜单显示错误：先确认设备与固件与本发布包的目标平台（
kindlepw2） 匹配；其他设备/固件的适配方法见源码仓库的docs/ADAPTATION.md。 - 首次部署中：等待状态变为 Ready，期间原生中文输入法保持可用。
- 数据损坏：选择“Redeploy Rime data”并重启；该操作不删除 userdb。
- 输入状态异常：选择“Clear current Rime input”。
- 需要诊断：临时启用“Debug logging”，重启并复现后立即关闭。Release 默认不逐键记录。
.so缺失、ABI 不匹配、maintenance 或 session 失败时，插件会在安装键盘 patch 前停止并回退原生输入法；相关错误记录在 KOReadercrash.log。
插件为 GNU AGPLv3；候选栏 UI 衍生来源记录在 NOTICE。随包发布的 Rime 数据和
第三方归属见 THIRD_PARTY_LICENSES.md。