全部文档
按项目版本、文档类型与主题查找。目录收录本站全部正文，旧地址跳转页不重复计数；搜索也支持日期和原文件名。
第一次使用请从快速上手开始；开发、构建和故障调查可直接进入维护资料目录。
- 第一次使用中州鹅使用指南
完成“安装并启用 → 导入完整方案 → 部署 → 输入”四步即可开始。APK 不预装中文方案、完整词典或语言模型；已经使用过其他版本的用户，先备份和迁移。
- 安装使用指南
日常安装选择成功的 Commit CI 生成的签名主应用，或 Releases 的中州鹅 Nightly。 默认分支已合入直连版，历史 Fcitx 发行包仍保留；安装时核对 Release 的提交、包名与签名，历史归档不是当前下载推荐。 A
适用于本手册所在提交的直连版。应用名 中州鹅，包名 org.fcitx.fcitx5.android.fx.rime。 本版直接使用 Rime 引擎，并提供完整键盘、候选、布局编辑器、主题和设置界面。 Rime 方案决定输入规则与词典；键盘
- 中州鹅功能总览使用指南
本页介绍当前 Rime 直连版。Rime 方案决定输入规则和词典，屏幕键盘布局决定按键与手势；导入一种不会自动得到另一种。 首次使用从安装和快速上手开始，完整操作见用户手册。
- 参与文档修改使用指南
本站使用 VitePress，源码位于 docs 分支的 docs/。只修改文档不需要 Android 构建环境；准备 Git、Node.js 20 或更高版本、npm 和 Python 即可。
- 致谢与差异说明使用指南
本仓库的 fx-rime-only 分支以 fxliang/fcitx5-android 的 fx 分支（提交 3ad25fc9）为基线，把「Rime 只是众多输入法之一」专用化为「Rime 是唯一的输入引擎」，并在此之上持续开发自己的功能
- 支持与捐赠使用指南
中州鹅是个人兴趣维护的定制分支，不设捐赠渠道。
- 全部文档使用指南
按项目版本、文档类型与主题查找。目录收录本站全部正文，旧地址跳转页不重复计数；搜索也支持日期和原文件名。
- 中州鹅：从原型到直连主应用使用指南
中州鹅保留 Android 键盘、布局、主题和常用工具，通过单一 owner 线程与 JNI 直接调用 librime。默认分支已不包含旧 Fcitx 原生后端。
- 备份与恢复使用指南
本页说明中州鹅当前的完整备份流程，代码与文档对应关系见核对记录。旧版可能只提供明文 ZIP。
- 候选窗增强使用指南
候选展示分两个作用域：工具栏候选栏（Kawaii Bar 内）与独立候选窗 / 展开候选面板。本版对两者都有增强，注意区分各自的设置位置。
- 剪贴板同步（内置）使用指南
主程序内置剪贴板同步能力，与桌面端及其他设备互通，使用同步功能无需另装插件。
- 字体集编辑器（字体设定）使用指南
本版沿用 字体集 (Fontset) 系统——把"哪些位置用哪个字体、多大字号"配置化，存放于 config/fontset.json。设置入口是 应用主页 → 外观 → 字体设定。
- 键盘布局编辑器使用指南
本版提供完整的 应用内键盘布局编辑器，配合底层的 JSON 配置文件 (config/TextKeyboardLayout.json)，允许你：
- MacroKey 编辑器使用指南
应用内可视化编辑 MacroKey 的工具，避免手写 step 数组。
- Popup 预设编辑器使用指南
PopupPreset 编辑器 配合 config/PopupPreset.json 配置文件，让你能可视化地编辑按键长按弹出的候选字符（比如按住 a 弹出的一排可选字符）。
- Kawaii Bar 增强使用指南
Kawaii Bar 是位于键盘上方的功能状态栏：左侧状态区、中间一排功能按钮、右侧控制按钮，工具栏下方那条候选栏也在其中。
- 调整模式使用指南
调整模式（Adjust Mode）是一个临时可视化状态，允许你直接拖动键盘边缘、移动手柄修改键盘的尺寸与位置。
Compose Override 是按键的一个可选字段：当 IME 处于 正在输入 的状态（有预编辑文本或候选词时）键面会临时切换为你指定的"覆盖版"，输入结束后自动还原。
- 浮动键盘使用指南
浮动键盘脱离屏幕底部停靠位置，可任意拖动摆放、调整尺寸，适合分屏、平板悬空操作或遮挡内容时使用。
- 单手模式使用指南
适配大屏设备的单手输入模式：键盘整体缩窄到屏幕一侧，拇指更容易够到全部按键。
- 分体键盘使用指南
屏幕宽度较大的场景（平板、折叠屏展开、横屏）下，键盘左右分成两半，各放一半按键，便于双手握持设备时两根拇指同时输入。
- 滑动操作使用指南
本版把一部分按键的滑动行为开放为可配置项。滑动分为普通滑动（手指在键上直接滑动）与长按后滑动（先按满长按延迟、再滑，交给「长按+滑动」复合手势处理）两类。
- AlphabetKey 字母键使用指南
最常用的按键类型：点击发送 main 字符，滑动发送 alt 字符。
- BackspaceKey 退格键使用指南
删除前一个字符；长按连续删除；本版为长按与上滑增加了一组复合手势与正文保护。
- CapsKey 大小写键使用指南
切换 / 锁定大小写状态。点击进入一次大写或退出大写状态；长按或双击进入锁定大写。
- CommaKey 逗号键使用指南
逗号键，默认点击发送 , 交给方案处理，长按菜单提供表情入口。
- Fcitx 键名速查使用指南
在 MacroKey 的 step 中，{"fcitx": "<sym>"} 形式的 KeyRef 用一个字符串引用一个具体按键。本页给出常用的 <sym> 列表与中文说明，并按用途分组。
- LanguageKey 语言键使用指南
直连版的语言键不再是"切换 Fcitx 输入方案"的按钮，而是中英文切换 + Rime 方案选单的入口。
切换到指定的文本键盘布局。常用于在 QWERTY ↔ 数字符号 ↔ 符号面板之间跳转。
- MacroKey 宏键使用指南
MacroKey 是 fx 引入的最具表现力的按键类型 —— 一个键可以绑定点击 / 滑动 / 长按三个独立的"宏序列"，每个序列由若干 step 组成，可依次发送按键、提交文本、执行编辑命令、切换布局层、触发应用动作等。
- 按键类型总览使用指南
键盘布局通过 TextKeyboardLayout.json 的 JSON 数据结构定义 —— 某个布局或方案子布局的键盘排列是二维数组：外层数组的每个元素代表一行，每行又是按顺序排列的按键对象数组。完整文件还包含布局名称、方案子布局等结构
- ReturnKey 回车键使用指南
发送回车 / 换行 / 提交（根据当前输入框的 IME action）。
- SpaceKey 空格键使用指南
发送空格；同时承载一组内置的滑动 / 长按行为，本版为它扩充了可配置划动动作与长按重复输入空格。
- SymbolKey 符号键使用指南
这是沿用历史类型名的标点键。当前默认点击发送标准句号 . 作为按键事件，交给 Rime 方案决定最终标点；label 只控制键面显示，不直接决定上屏文字。
- 在线编辑器使用指南
「中州鹅」网页编辑器使用 🪿 网页图标，可在电脑浏览器中编辑键盘布局、主题和图标（应用内置了 LAN 编辑桥，页面由本 fork 自己的站点提供）：
- Rime 引擎与中州韵设置使用指南
中州鹅直接调用 librime，保留完整 Android 键盘和设置。 原生 Fcitx Core、fcitx5-rime 及 AndroidFrontend 已移除，Rime 无需插件 APK。 APK 不预装中文方案、完整词典或万象模型
- 共享导入与解压使用指南
本版增强了"从其他应用分享内容到中州鹅"的导入流程。
- 符号、表情与颜文字使用指南
在键盘中打开符号、表情或颜文字面板，它们使用独立的分组与最近使用记录。面板占用键盘区域，返回后继续使用原键盘。
- 文本编辑底部栏使用指南
文本编辑是键盘上那排 光标移动 / 选择 / 剪切复制粘贴 按键所在的底部栏；工具栏（Kawaii Bar）上的光标按钮也会直接打开它。它的风格、手势参数与提示文案都可以在设置中调整。
- 磨砂按键使用指南
Frosted Key Blur —— 按键磨砂模糊效果，让按键呈现毛玻璃质感，配合自定义背景图效果尤佳。
- Monet 编辑器使用指南
利用 Android 12+ 系统的 Monet 动态取色 生成键盘主题，让键盘色调自动跟随系统壁纸 / 主题色变化。
- 设置界面外观与动画使用指南
本页适用于采用 Material 3 设置界面的版本。旧版本没有以下入口时，请先更新应用。
- QR 分享与导入使用指南
fx 引入了 二维码 (QR Code) 分享机制，让用户可在不依赖云端的情况下，轻松交换：
- 主题编辑器使用指南
应用内 主题编辑器 可视化调整颜色、背景、按键样式，无需手改文件即可创建新主题。
- 更新检查器与镜像使用指南
中州鹅内置 GitHub Release 更新检查器，直接从本仓库 SandyYuR/fcitx5-android Releases 拉取最新版本并安装。
Foxy imports a plugin as one JavaScript source file from Settings > JavaScript plugins. Plugin files in this directory a
- JS 语音插件使用指南
JS 插件把语音服务的识别协议写在一个 .js 文件里，在中州鹅内置的 QuickJS 中运行。输入法负责录音、会话和结果回填；使用内置插件时无需另外安装语音 APK。
- 外部语音输入使用指南
在语音设置的“首选语音输入”中选择支持本项目 AIDL 接口的外部识别应用。
- 构建版本与数据共存使用指南
安装包以实际 manifest 中的包名和签名为准，不用 Debug/Release 文件名推断是否可并存。 主应用已内置 Rime，不加载独立引擎插件 APK。
- 核心概念使用指南
Rime 方案决定编码、词典、候选和语言状态；键盘布局决定屏幕键位、显示文字、长按与滑动动作。 换 Rime 方案不等于导入键盘布局，两者分别配置。 布局的子模式可按 Rime 方案覆盖键位，数字和符号层由布局切换。
- 直连版现状与迁移使用指南
中州鹅的默认分支 fx-rime-only 直接使用 librime，保留 Android 键盘、候选、主题、布局编辑器和常用工具。旧 Fcitx 原生后端已经移除，文档站独立维护在 docs 分支。
- 介绍使用指南
中州鹅是保留完整 Android 键盘、候选、布局编辑器、宏、主题和剪贴板功能的 Rime 输入法。 Android 前端继承 Fcitx5 for Android 与 fxliang 的 fx 分支，当前直连版通过 JNI 直接调用 li
- 迁移到中州鹅使用指南
当前包名仍为 org.fcitx.fcitx5.android.fx.rime。先在旧应用导出完整用户数据， 确认备份保存到应用目录以外；同签名并满足版本条件时可覆盖安装。 升级后检查 Rime 方案、用户词库、布局、主题、剪贴板及外部目录
- 中州鹅文档首页使用指南
本站默认介绍 中州鹅：Rime 直连版。早期 靓企鹅中州韵 保留了 Fcitx 中间层，其原站文档、维护报告和后续批注独立归档。 同一个 fx-rime-only 分支名曾用于两种架构，不能仅凭旧文章中的分支名判断适用版本。
- 维护资料完整目录现行维护
收录两代项目的维护正文与验证说明。选择“中州鹅”可继续区分现行维护、实现协议、直连版历史与验证证据；选择“靓企鹅中州韵”可查看含 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，与这里无关；下面的路径是作者机器上的布置，换机时按同名变量自行替换即可。
- 文档工作区使用指南
本站源码在 docs 分支；默认代码分支 fx-rime-only 不包含 docs/。站点默认介绍中州鹅 Rime 直连版。
- 常见问题使用指南
这是预期状态，不是故障。 本版不预置任何输入方案，需要自己放入 Rime 方案并部署一次。步骤见 快速上手：放入 .schema.yaml + 词典 → default.custom.yaml patch schemalist → 中州韵设
- OEM 自启动与后台限制使用指南
在 小米 (MIUI / HyperOS)、华为 (EMUI / HarmonyOS)、OPPO (ColorOS)、vivo (OriginOS / FuntouchOS)、荣耀、realme 等国产定制 ROM 上，系统默认会对应用的常
- 反馈问题使用指南
请先确认反馈的应用、包名和构建类型；Debug、Release、旧测试包及上游版本的数据可能相互独立：
来源与散列记录。
代码目标为修复分支 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 数据只来自固定测试语料。
- 参与文档修改旧版原站
本文档放在仓库的 docs 分支的 docs/ 目录中，使用 VitePress 构建。只修改文档时通常不需要准备 Android 构建环境，只需要 Git、Node.js 和 npm。
- 致谢与差异说明旧版原站
本仓库的 fx-rime-only 分支以 fxliang/fcitx5-android 的 fx 分支（提交 3ad25fc9）为基线，把「Rime 只是众多输入法之一」专用化为「Rime 是唯一的输入引擎」，并在此之上持续开发自己的功能
- 支持与捐赠旧版原站
靓企鹅·中州韵是个人兴趣维护的定制分支，不设捐赠渠道。
- 旧版 Fcitx 文档完整目录旧版原站
这里恢复直连版合入前原站的 64 篇文档，包括 13 篇维护报告和完整用户手册。 原文固定于文档分支 edcf536f；本站展示只适配内部链接并加上旧版提示。 当前直连版操作请看中州鹅手册。
- 候选窗增强旧版原站
候选展示分两个作用域：工具栏候选栏（Kawaii Bar 内）与独立候选窗 / 展开候选面板。本版对两者都有增强，注意区分各自的设置位置。
- 剪贴板同步（内置）旧版原站
主程序内置剪贴板同步能力，与桌面端 / 其他设备的剪贴板互通——无需安装任何插件（Rime-only 版没有插件体系，此功能一直在主 APK 内）。
- 字体集编辑器（字体设定）旧版原站
本版沿用 字体集 (Fontset) 系统——把"哪些位置用哪个字体、多大字号"配置化，存放于 config/fontset.json。设置入口是 应用主页 → 外观 → 字体设定。
- 键盘布局编辑器旧版原站
本版提供完整的 应用内键盘布局编辑器，配合底层的 JSON 配置文件 (config/TextKeyboardLayout.json)，允许你：
- MacroKey 编辑器旧版原站
应用内可视化编辑 MacroKey 的工具，避免手写 step 数组。
- Popup 预设编辑器旧版原站
PopupPreset 编辑器 配合 config/PopupPreset.json 配置文件，让你能可视化地编辑按键长按弹出的候选字符（比如按住 a 弹出的一排可选字符）。
- Kawaii Bar 增强旧版原站
Kawaii Bar 是位于键盘上方的功能状态栏：左侧状态区、中间一排功能按钮、右侧控制按钮，工具栏下方那条候选栏也在其中。
- 调整模式旧版原站
调整模式（Adjust Mode）是一个临时可视化状态，允许你直接拖动键盘边缘、移动手柄修改键盘的尺寸与位置。
Compose Override 是按键的一个可选字段：当 IME 处于 正在输入 的状态（有预编辑文本或候选词时）键面会临时切换为你指定的"覆盖版"，输入结束后自动还原。
- 浮动键盘旧版原站
浮动键盘脱离屏幕底部停靠位置，可任意拖动摆放、调整尺寸，适合分屏、平板悬空操作或遮挡内容时使用。
- 单手模式旧版原站
适配大屏设备的单手输入模式：键盘整体缩窄到屏幕一侧，拇指更容易够到全部按键。
- 分体键盘旧版原站
屏幕宽度较大的场景（平板、折叠屏展开、横屏）下，键盘左右分成两半，各放一半按键，便于双手握持设备时两根拇指同时输入。
- 滑动操作旧版原站
本版把一部分按键的滑动行为开放为可配置项。滑动分为普通滑动（手指在键上直接滑动）与长按后滑动（先按满长按延迟、再滑，交给「长按+滑动」复合手势处理）两类。
- AlphabetKey 字母键旧版原站
最常用的按键类型：点击发送 main 字符，滑动发送 alt 字符。
- BackspaceKey 退格键旧版原站
删除前一个字符；长按连续删除；本版为长按与上滑增加了一组复合手势与正文保护。
- CapsKey 大小写键旧版原站
切换 / 锁定大小写状态。点击进入一次大写或退出大写状态；长按或双击进入锁定大写。
- CommaKey 逗号键旧版原站
逗号键，长按可调出表情、快捷短语与 Unicode 输入等菜单。
- Fcitx 键名速查旧版原站
在 MacroKey 的 step 中，{"fcitx": "<sym>"} 形式的 KeyRef 用一个字符串引用一个具体按键。本页给出常用的 <sym> 列表与中文说明，并按用途分组。
- LanguageKey 语言键旧版原站
Rime-only 版的语言键不再是"切换 Fcitx 输入方案"的按钮，而是中英文切换 + Rime 方案选单的入口。
切换到指定的文本键盘布局。常用于在 QWERTY ↔ 数字符号 ↔ 符号面板之间跳转。
- MacroKey 宏键旧版原站
MacroKey 是 fx 引入的最具表现力的按键类型 —— 一个键可以绑定点击 / 滑动 / 长按三个独立的"宏序列"，每个序列由若干 step 组成，可依次发送按键、提交文本、执行编辑命令、切换布局层、触发应用动作等。
- 按键类型总览旧版原站
键盘布局通过 TextKeyboardLayout.json 的 JSON 数据结构定义 —— 顶层是一个二维数组：外层数组的每个元素代表一行，每行又是按顺序排列的按键对象数组。文件里的换行只是排版便利，真正划分行的是数组嵌套结构而不是文本
- ReturnKey 回车键旧版原站
发送回车 / 换行 / 提交（根据当前输入框的 IME action）。
- SpaceKey 空格键旧版原站
发送空格；同时承载一组内置的滑动 / 长按行为，本版为它扩充了可配置划动动作与长按重复输入空格。
- SymbolKey 符号键旧版原站
直接提交一个符号，通常适合标点或单字符符号。
- 在线编辑器旧版原站
提供一个可在电脑浏览器中使用的在线编辑器（应用内置了 LAN 编辑桥，页面由本 fork 自己的站点提供）：
- 功能总览旧版原站
本页一站式列出本版本的主要功能。它们分为两类：继承自 fx 分支的应用层功能（基线 fxliang/fcitx5-android fx 分支）与本分支（Rime-only）的专属改动。点击进入相应子页查看详细说明。
- Rime 引擎（内置）旧版原站
靓企鹅·中州韵把 Rime 作为唯一输入引擎直接编入主 APK：静态链接 librime.a，Rime 共享数据（default.yaml、keybindings.yaml、punctuation.yaml、symbols.yaml 等公共
- 共享导入与解压旧版原站
本版增强了"从其他应用分享内容到 Fcitx5"的导入流程。
- 文本编辑底部栏旧版原站
文本编辑是键盘上那排 光标移动 / 选择 / 剪切复制粘贴 按键所在的底部栏；工具栏（Kawaii Bar）上的光标按钮也会直接打开它。它的风格、手势参数与提示文案都可以在设置中调整。
- 磨砂按键旧版原站
Frosted Key Blur —— 按键磨砂模糊效果，让按键呈现毛玻璃质感，配合自定义背景图效果尤佳。
- Monet 编辑器旧版原站
利用 Android 12+ 系统的 Monet 动态取色 生成键盘主题，让键盘色调自动跟随系统壁纸 / 主题色变化。
- 设置界面外观与动画旧版原站
本页适用于采用 Material 3 设置界面的版本。旧版本没有以下入口时，请先更新应用。
- QR 分享与导入旧版原站
fx 引入了 二维码 (QR Code) 分享机制，让用户可在不依赖云端的情况下，轻松交换：
- 主题编辑器旧版原站
应用内 主题编辑器 可视化调整颜色、背景、按键样式，无需手改文件即可创建新主题。
- 更新检查器与镜像旧版原站
靓企鹅·中州韵内置 GitHub Release 更新检查器，直接从本仓库 SandyYuR/fcitx5-android Releases 拉取最新版本并安装。
- 构建版本与数据共存旧版原站
靓企鹅·中州韵只有一个构建版本、没有插件。这一页说明它与上游、fxliang 版本在同一台设备上的共存关系，以及用户数据的边界。
- 核心概念旧版原站
理解以下几个概念，可以帮助你更顺畅地配置和使用靓企鹅·中州韵。
- 安装旧版原站
前往 SandyYuR/fcitx5-android Releases 下载最新版本：
- 介绍旧版原站
靓企鹅·中州韵（其他语言显示名 Fcitx5.fx.rime）是 SandyYuR/fcitx5-android 仓库 fx-rime-only 分支构建的 Android 输入法：一个 APK 里同时包含 Fcitx5 底盘、Rime（中
- 从上游迁移到靓企鹅·中州韵旧版原站
如果你已经在使用 上游 fcitx5-android 或 fxliang fx 构建，并有大量自定义数据（Rime 配置、词库、主题、布局、SharedPreferences 等），不需要从零开始——旧应用导出的备份 可以直接被本版导入。
- 快速上手旧版原站
完成 安装 后，按以下步骤开始使用。
这是 SandyYuR/fcitx5-android 仓库 fx-rime-only 分支构建的应用 靓企鹅·中州韵（其他语言显示名 Fcitx5.fx.rime，包名 org.fcitx.fcitx5.android.fx.rime）的最
去掉 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.fx.rime 是一个将 Fcitx5、Rime（中州韵）和 Android 输入法界面集成在同一 APK 中的版本：
去掉 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”在工程上仍然可行，但它不是当前架构，也没有在本仓库被实现或测量验证。当前实际链路仍是：
本文面向只参与文档编写的贡献者，推荐只克隆 docs 分支最新提交，减少下载量与环境准备复杂度。
- 常见问题旧版原站
这是预期状态，不是故障。 本版不预置任何输入方案，需要自己放入 Rime 方案并部署一次。步骤见 快速上手 第零步：放入 .schema.yaml + 词典 → default.custom.yaml patch schemalist →
- OEM 自启动与后台限制旧版原站
在 小米 (MIUI / HyperOS)、华为 (EMUI / HarmonyOS)、OPPO (ColorOS)、vivo (OriginOS / FuntouchOS)、荣耀、realme 等国产定制 ROM 上，系统默认会对应用的常
- 反馈问题旧版原站
请先确认反馈的是哪个发行版——它们是不同包名的并存应用：
- 两代项目与历史档案旧版原站
中州鹅是现在维护的 Rime 直连版。靓企鹅中州韵（旧文档亦写作“靓企鹅·中州韵”）是保留 Fcitx 中间层的历史 Rime 专版。