维护资料完整目录
收录两代项目的维护正文与验证说明。选择“中州鹅”可继续区分现行维护、实现协议、直连版历史与验证证据；选择“靓企鹅中州韵”可查看含 Fcitx 的原站报告与后续批注。
附件通过各报告链接获取；原始证据目录同时列出没有独立正文的附件包。普通功能说明另见全部文档。
- 维护资料完整目录现行维护
收录两代项目的维护正文与验证说明。选择“中州鹅”可继续区分现行维护、实现协议、直连版历史与验证证据；选择“靓企鹅中州韵”可查看含 Fcitx 的原站报告与后续批注。
- 直连版逐提交文档对照提交对照
核对 1fbbf1ab0（完整主应用改为直连）到 81ce93574，共 55 个提交。日期按 Asia/Shanghai 显示。 每条记录保留代码提交链接、当前说明入口和文档处理结果；这些条目说明本次文档核对，不等同于重新执行其 Andr
- 当前功能文档与源码入口提交对照
本表将当前功能页与默认分支实际存在的生产源码关联，供后续维护继续核对。接口参考原文仍以本项目宿主为准；源码文件存在不代表已经执行对应功能测试。
本次以远端默认分支 fx-rime-only，81ce935746eb4e17911bd503ddb2012fdb6b8435 为代码事实源，以整理前的 docs@703cd9e28 为文档基线。 已核实的 fx 来源基线为 3ad25fc
- 继承功能与旧提交索引提交对照
相对已核实存在的 fx 基线 3ad25fc9b，直连接入前共有 261 个提交。下面逐条登记提交、改动主题与文档位置。
- 中州鹅直连版维护手册现行维护
本页描述默认分支 fx-rime-only 的现行维护方式；2026 年 10 月 30 日的源码核对范围与固定提交见代码与文档对照。功能操作见用户手册。 历史实验、阶段结论和当时的测试数量在直连版历史中保留，含 Fcitx 层的旧版资料在
- 文档分类与维护约定现行维护
站点由 docs 分支构建。用户看到的默认内容对应 中州鹅 Rime 直连版；带 Fcitx 中间层的 靓企鹅中州韵单独归档。
- 验证证据与原始附件现行维护
本目录收录中州鹅的验证说明和维护附件，包括无独立正文的旧实验目录。测试结果、截图、ZIP 和 JSON 对应记录时点，不能自动视为当前版本再次通过。
- ClipCascade 接收限额实现协议
本页说明同步接收路径的资源预算与兼容边界。使用方法见剪贴板同步。
- 正确性约束与代码定位实现协议
本页保存中州鹅现行的输入、前端、配置和数据约束，以及从工作区 AGENTS.md 移出的详细定位表。修改对应区域前先核对生产调用与测试，不能只确认文件存在。历史报告用于解释来源，不替代当前实现。
- 自定义 hosts 下载任务实现协议
使用方法见更新检查器。本页说明启用自定义 hosts 后，任务如何跨页面关闭、进程重建和发布中断继续工作。
- 实现协议与数据处理实现协议
这里维护随当前直连版演进的中文实现说明，供排查兼容问题、修改代码和对接服务时查阅。
- JS 语音插件宿主与开发接口实现协议
本页描述中州鹅当前宿主。安装与账号配置请先看JS 插件使用指南；Foxy 英文原文只作接口来源参考，差异以本页及源码为准。
- 加密备份格式实现协议
手动导出默认生成有密码保护的 .fcbak；对话框也允许明确选择不加密 ZIP，供旧版或上游版本兼容使用。 两种格式都可导入。使用步骤见备份与恢复。
- 整包恢复事务与进程中断实现协议
完整备份先解压到有大小限制的私有隔离目录，再由用户确认。 加密备份在解压前完成认证。替换现有数据前，先检查剪贴板 WAL、数据库版本、偏好 XML 和外部目标目录。 操作步骤见备份与恢复。
- 维护文档现行维护
先选项目版本，再按任务找资料。中州鹅使用 Kotlin 前端、单一 owner 线程和 JNI 直接调用 librime；靓企鹅中州韵是保留 Fcitx 中间层的历史版本。
- Windows 本机构建环境现行维护
这页记录在 Windows 上构建、测试与出包的本机侧经验，供维护者排查环境问题。 CI 用的是 GitHub 托管的 Ubuntu，与这里无关；下面的路径是作者机器上的布置，换机时按同名变量自行替换即可。
来源与散列记录。
代码目标为修复分支 ea6229a4，安装的是 x8664 Debug APK，版本名也为 ea6229a4。后端直接加载 libdirect-rime.so。
本轮继续修复 perf/direct-rime-startup-20261024 的草稿保存链路。完整来源与验证边界。
运行代码 6f96066b，分支 perf/direct-rime-startup-20261024，最终测试来源 b193b9ff。来源与验证。
目标 APK 为提交 b2c4631a 的 x8664 Debug，包名 org.fcitx.fcitx5.android.fx.rime.debug。后端为直接调用 librime，历史命名空间不代表仍使用 Fcitx 原生后端。来源与
On Android 10+, direct downloads using the configured hosts mapping run as unique WorkManager jobs. Ordinary downloads a
代码：d3cb8769。对应旧报告 P2-3。
本批当前代码为 710e4ef93f20eaf1d80d93913be1edfaefdb097d，代码 PR #13 面向 fx-rime-only，文档 PR #12 面向 docs。 分类范围和合入顺序见本批合入准备。
运行代码 8dca031c，测试探针 93942a2e。API35 AOSP x8664 Debug、无 KVM；发行和 CI 仍只构建 ARM64。当前程序直接调用 librime，未加载 Fcitx 后端。来源与环境
默认分支 6af8bc0b 将新增、上移、下移操作固定在行标题栏；keysFlow 只复用实际按键。旧 d66c9e4a 修复的是隐藏箭头与普通键／新增键共用池导致的不可见状态残留。该复用路径已消失，因此无需重新加入旧生产代码修复。
在 b2c4631a x8664 Debug 的 API 35 AOSP 模拟器上，切到 AOSP 输入法再切回 Rime 直连版时，旧服务的排队布局回调触发主线程崩溃。原始异常栈。异常类保留历史 Fcitx 命名，当前后端仍是 libri
该批源码基线与运行改动 11137251，分支 perf/direct-rime-startup-20261024。来源、计数与已发布APK边界。
- User data backup验证证据
Manual export defaults to password-protected .fcbak. The dialog also offers an explicit unencrypted ZIP for compatibilit
最终运行代码与测试：7e5c2c1b。本项为补充发现，不重复计入旧139行。来源及设备范围
运行代码基准为 4bb3486c，分支 perf/direct-rime-startup-20261024。后端为 librime 直连，旧 Fcitx 类名和包名仍保留在 Android 前端。
运行代码 209cca0e，测试 3e09e289。API35 AOSP x8664 Debug、无 KVM；发行与CI仍只构建ARM64。来源、PID及内存映射检查
运行代码 9b1f958c。补充发现，不重复计入旧139行。
Whole backups are extracted into a bounded private quarantine before confirmation. Protected backups are authenticated b
代码：bb9d2a78，对应旧报告 P1-8。
运行代码 209cca0e。补充发现，不重复计入旧139行。
Whole backups are extracted into a bounded private quarantine before confirmation. Protected backups are authenticated b
代码：544f84a8。补充发现，不重复计入旧139条。
Whole backups are extracted into a bounded private quarantine before confirmation. Protected backups are authenticated b
源码 c72115de，运行修改 c2ba6510。完整来源与产物校验。
The dedicated WebSocket transport validates decrypted frame headers before Okio can deliver bytes to OkHttp's message as
本页记录 9f6f847c 时点的对照与审计。随后旧后端、构建开关和未执行类的清理，见 旧后端清理记录；本页原始测试数据保持不变。
补测确认：含 Fcitx 的默认版也存在首次点选比后续慢的现象。直连版此次修掉了一处 主线程读取缓存时等待后台调度的阻塞；现有小样本尚未证明首次整体上屏有稳定改善， 不能宣称已经消除用户真机的首次卡顿。
- 直连 Rime：旧后端与构建残留清理直连版历史
本轮在 feat/direct-rime-prototype 清理已经不参与直连输入的实现。 默认分支 fx-rime-only 不修改；历史 Fcitx 对照仍固定为 a714feff， 通过独立 checkout 构建，原始数据见迁移审
- 新增真机日志：首次选词等待与连续保存日志直连版历史
本文先记录 12ab22cd 的定位与 9adb6949 的修复验证，随后追加 新包真机回访。用户反馈有所好转；两次已记录的首次选词 core 为 4.655 / 46.693ms，同线程 sync 均为 0。本次未见旧 145ms 尖峰，
- 直连 Rime：依赖清理与性能记录直连版历史
分支：feat/direct-rime-prototype。本次工作以 1ab4bbe 的完整界面版为起点。 APK 继续使用包名 io.github.sandyyur.rime.direct、应用名「中州鹅」，保留原键盘与设置界面。
用户手册、维护手册、历史设计、性能报告、截图与原始验证证据统一保存在 docs 分支，由文档站 PR #7 交付。 代码 PR #4 删除整个 docs/ 目录，README 提供文档入口；构建工具随附的 README 继续随工具维护。
当前源码维护已迁入独立 librime 复刻仓库，见源码维护迁移。本页固定构建与补丁路径保留为对应阶段的历史记录。
- 合并前最终审阅：运行依赖与 APK 残留直连版历史
审阅基线为 1c6917887762bb12242566c55afec90281d7eab4，后续清理放在同一个 PR #4 的独立审阅提交中。 交付包、当前源码与最终 CI 入口以 PR #4 描述为准。
- Foxy 审查后的响应性修复与同条件验证直连版历史
适用分支：feat/direct-rime-prototype。基础修复提交 8ef7c6c6， profile/诊断补齐 0ff6a0aa，就绪重绑边界修正 8634bbeb；最终构建源码为 12ab22cd82297638bee75ef
本篇保留最初静态审查时点；后续已实施的修改、追加真机日志及动态验证见 修复与同条件验证。
- 原应用界面接入直连 librime直连版历史
日期：2026-10-16。分支：feat/direct-rime-prototype。默认构建仍使用原 Fcitx 引擎。
- librime 直连实验：实现与验证直连版历史
日期：2026-10-16。代码基于 a714feff，工作分支 feat/direct-rime-prototype。
2026-10-27 按用户要求移除 98f3713c、d66c9e4a，变基到默认分支 6af8bc0b，其余 60 个原提交及新结构回归测试整理为 12 个提交。分类列表、完整性核对与新验证。旧后续可见性补丁无需重加：标题栏操作和实际按
用户日志 org.fcitx.fcitx5.android.fx.rime-2026-10-21T010408Z.txt 记录：
- 中州鹅直连版合并交付记录直连版历史
日期：2026-10-19。合并入口：PR #4， feat/direct-rime-prototype → fx-rime-only。本次整理将 PR 准备到可合并状态，实际合并由维护者执行。
- 密码框打开方案菜单导致键盘隐藏的修复直连版历史
用户通过宏的「应用操作 → 切换 Rime 方案」打开菜单时，菜单短暂显示，键盘随后消失再弹出。 来源是用户提供的 io.github.sandyyur.rime.direct-2026-10-20T110648Z.txt；下面仅记录排错所
- 早期直连原型的可借鉴点与冷启动审查直连版历史
本报告只审查代码、提出验证与改进顺序，未修改实现，未运行新的性能 A/B，未构建 APK。 用户随后授权的首键接收、会话复用与验证见响应性改进； 本页保留实施前的审查结论。 用户提到的日志 D:\GitHub\fx2-rime\日志\io.
- 重新部署与中州鹅发行标识直连版历史
日期：2026-10-20。对应 PR #4 的第六项功能交付，另在功能分支同步默认分支新增修复；不写入默认分支、不合并 PR。
- 中州鹅直连版：合并与文档站交付直连版历史
2026-10-21 已按下表顺序全部使用 Rebase and merge 合入，保留线性分类提交。 文档站在代码合入前完成部署，用户与维护手册均已核对可访问；后续本页补记实际交付。
- 首键接收、会话复用与首次选词直连版历史
本次是在用户授权后实施的修改，承接旧原型审查 与真机日志分析。此前两份文档是修改前的审查记录。 上轮重绑改进的对照固定为修改前直连分支 2f6a0ea08527831d3f07df12499f5b72d5ffc0bd。 本轮已补做含 Fci
- 万象：用户工具包的触摸与画面对照直连版历史
本次补充从 Android 触摸输入到画面变化的对照。历史 API 回放审计测量的是另一段路径，数据保留，不混用百分比。
- 本会话构建版交付索引直连版历史
当前产品为 中州鹅，org.fcitx.fcitx5.android.fx.rime，工作分支 feat/direct-rime-prototype， PR #4。 操作入口见用户手册， 开发入口见维护手册。
- 中州鹅引擎源码仓库与维护流程迁移直连版历史
本轮 PR 使用 Rebase and merge，分类提交、归档标签与依赖合入顺序见合并交付。固定 prebuilt gitlink 由归档标签保留，合并后无需追随 HEAD 改 pin。
- 无调用方代码清理直连版历史
在 feat/direct-rime-prototype 继续检查旧后端清理 后留下的纯 Kotlin 辅助实现。产品修改提交：6c470b8b901f2109cc748447b6f69fad0be6fc9e。 默认分支和历史 Fcitx
- 用户日志补充：输入会话重绑与卡顿定位直连版历史
本页补充旧原型与冷启动审查。 本次只分析用户上传日志和固定版本源码，未修改实现、未构建诊断包、未新增性能测试。 用户随后授权的实现、补充复现条件与验证见响应性改进； 本页保留修改前的证据范围。
所有文档在 feat/direct-rime-prototype 维护。默认分支不用于本次修改。
- 中州鹅直连版历史直连版历史
这里记录从 librime 原型到完整主应用的演进，以及后续审阅、合入和功能修订。涉及 Fcitx 的对照实验仍属于直连版研发记录；保留 Fcitx 层版本自身的手册和报告另在靓企鹅中州韵档案。
本次将 feat/direct-rime-prototype 中的共享 MD3 界面修改提取到 fx-rime-only，整理为一个提交。来源为 6db49cec、776e60d5、 4b9e14e7 的界面部分，以及输入法菜单需要的窗口焦
- 2026-10-30 默认分支审阅与修复直连版历史
本页记录默认分支本批改动审阅、fix 分支合入和配套文档。代码合并目标为 fx-rime-only，文档站由 docs 分支部署。
- 2026 年 10 月修复批次与合入准备直连版历史
本页汇总这一批 Rime 直连性能、会话、编辑器和数据保护改进，供合入前审阅。 两份旧报告的原始结论保留，当前 139 项状态见对照总表。
本批承接 2026-10-31 的浏览器与源码审阅。代码基线为 81ce93574，文档基线为 cf28e852d，网页编辑器基线为 ffa77d3。主代码在 fix/review-20261031，文档在 fix/docs-review-
- 万象触摸与录屏对照原始数据验证证据
方法与结论见报告。正式运行 39041913893 在同一个 Android 35 x8664 KVM 模拟器完成 14 轮、4,752 次触摸及 1,584 次硬件参考按键。 两版匹配相同输入长度的完整提交文本；这不是人工标注的汉字识别准
主报告。 产品源码固定为 12ab22cd82297638bee75ef30b31b3decb21decb。
- 万象立即输入与候选点选：原始结果验证证据
测试是同一天两轮开发验证，固定修改前直连产品 2f6a0ea0， 不替代此前含 Fcitx 默认分支的画面对照。 实现、结果解读与限制见响应性报告。
结论、口径和限制见主报告。 产品源码为 9adb694932df4340bc48d359af2c788ad6809f3e；文档归档提交不改变产品代码。 原始手机日志和其中的个人输入不入库。CI 数据只来自固定测试语料。
去掉 fcitx5、让 Kotlin UI 直接通过 JNI 驱动 librime C API，是可行的——而且同一作者 fxliang 已经做过一个这样的输入法（Foxy），可直接作为架构范本。自定义键盘布局、主题、符号面板等 UI 可以
层 1 · 其他引擎插件模块（Phase 1）
可行，且比直觉容易。 三个关键事实：
以 2026-09-03 报告的 93 个编号逐项复核，当前结论为：78 项已修复，9 项部分修复，1 项未修复，5 项因功能/构建移除而不再适用。对照 Rime 专版交接后，另列 8 项本轮新纳入的问题或相关回归，包含此前漏审的引擎启停回
审阅基线：SandyYuR/fcitx5-android，分支 fx-rime-only，提交 e51afd887fb623e4b8fa1baed554dc4e1ae2ef32。审阅结束时 HEAD 与 origin/fx-rime-onl
“去掉 fcitx5、由 Kotlin/JNI 直接驱动 librime”在工程上仍然可行，但它不是当前架构，也没有在本仓库被实现或测量验证。当前实际链路仍是：
审阅基线：SandyYuR/fcitx5-android，分支 fx-rime-only，提交 e916245e（2026-10-04）。相关文档：HANDOVER-rime-only.md §3.4（e916245e 条目）与 §5。
Foxy 符号数据和交互模型已经落地，不再是“评估后等待确认”的功能：
现象（日志 日志/音节选择器...2026-09-07T085832Z.txt）：打完字后点 tab 无反应（连点 29 次零响应），点一下"清除"就恢复。同日志里 BackSpace 后 tab 又能用。
- 旧版维护报告旧版原站
恢复原站维护菜单中的全部 13 篇报告，内容对应 edcf536f 时点。 完整旧版文档 · 当前直连版维护手册
审阅基线：SandyYuR/fcitx5-android，分支 fx-rime-only，提交 e51afd887fb623e4b8fa1baed554dc4e1ae2ef32。日期：2026-09-07。
同步默认分支采用普通合并提交；已推送的迭代历史保留。代码 PR 建议使用 Squash and merge，标题可用「重建 MD3 设置与首次启动引导，完善主题和返回动画」。
推荐在现有 View + Fragment + Preference 架构上完成设置界面的 M3 Expressive 改造：保留六个首页入口、现有功能页面和数据契约；统一组件、色彩、排版、动效与返回体验。在「外观」内新增「设置界面外观」，
入口在 MainFragment.kt（调查基线 f84084c3 下的 app/src/main/java/org/fcitx/fcitx5/android/ui/main/MainFragment.kt），分两个大类共 10 项，其下再
去掉 fcitx5、让 Kotlin UI 直接通过 JNI 驱动 librime C API，是可行的——而且同一作者 fxliang 已经做过一个这样的输入法（Foxy），可直接作为架构范本。自定义键盘布局、主题、符号面板等 UI 可以
- 【历史归档】f5 输入法精简与 Rime 整合实施方案旧版批注与方案
层 1 · 其他引擎插件模块（Phase 1）
可行，且比直觉容易。 三个关键事实：
- fx2 代码复审报告 · 2026-10-11旧版批注与方案
以 2026-09-03 报告的 93 个编号逐项复核，当前结论为：78 项已修复，9 项部分修复，1 项未修复，5 项因功能/构建移除而不再适用。对照 Rime 专版交接后，另列 8 项本轮新纳入的问题或相关回归，包含此前漏审的引擎启停回
- fx-rime-only 系统性代码审阅报告旧版批注与方案
审阅基线：SandyYuR/fcitx5-android，分支 fx-rime-only，提交 e51afd887fb623e4b8fa1baed554dc4e1ae2ef32。审阅结束时 HEAD 与 origin/fx-rime-onl
“去掉 fcitx5、由 Kotlin/JNI 直接驱动 librime”在工程上仍然可行，但它不是当前架构，也没有在本仓库被实现或测量验证。当前实际链路仍是：
审阅基线：SandyYuR/fcitx5-android，分支 fx-rime-only，提交 e916245e（2026-10-04）。相关文档：HANDOVER-rime-only.md §3.4（e916245e 条目）与 §5。
- Foxy 风格符号面板搬运评估（当前实现复盘）旧版批注与方案
Foxy 符号数据和交互模型已经落地，不再是“评估后等待确认”的功能：
现象（日志 日志/音节选择器...2026-09-07T085832Z.txt）：打完字后点 tab 无反应（连点 29 次零响应），点一下"清除"就恢复。同日志里 BackSpace 后 tab 又能用。
- 靓企鹅中州韵：后续批注与原始方案旧版批注与方案
这些资料来自整理前的维护区，涉及含 Fcitx 中间层的旧版，包括后续添加批注的报告、旧用户手册，以及单独保存的原始可行性方案。 原站固定快照另见64 篇原站目录；两份版本分别保留，避免覆盖后续批注或原始历史。
- fx-rime-only 性能专项审阅报告旧版批注与方案
审阅基线：SandyYuR/fcitx5-android，分支 fx-rime-only，提交 e51afd887fb623e4b8fa1baed554dc4e1ae2ef32。日期：2026-09-07。
- 靓企鹅·中州韵 用户指南（Rime-only 版）旧版批注与方案
Fcitx5.fx.rime 是一个将 Fcitx5、Rime（中州韵）和 Android 输入法界面集成在同一 APK 中的版本：
- MD3 设置界面实施记录与合并说明旧版批注与方案
同步默认分支采用普通合并提交；已推送的迭代历史保留。代码 PR 建议使用 Squash and merge，标题可用「重建 MD3 设置与首次启动引导，完善主题和返回动画」。
推荐在现有 View + Fragment + Preference 架构上完成设置界面的 M3 Expressive 改造：保留六个首页入口、现有功能页面和数据契约；统一组件、色彩、排版、动效与返回体验。在「外观」内新增「设置界面外观」，
- 设置界面重构方案（2026-09-28 调查报告）旧版批注与方案
入口在 MainFragment.kt（调查基线 f84084c3 下的 app/src/main/java/org/fcitx/fcitx5/android/ui/main/MainFragment.kt），分两个大类共 10 项，其下再
去掉 fcitx5、让 Kotlin UI 直接通过 JNI 驱动 librime C API，是可行的——而且同一作者 fxliang 已经做过一个这样的输入法（Foxy），可直接作为架构范本。自定义键盘布局、主题、符号面板等 UI 可以
“去掉 fcitx5、由 Kotlin/JNI 直接驱动 librime”在工程上仍然可行，但它不是当前架构，也没有在本仓库被实现或测量验证。当前实际链路仍是：