Fcitx5 Android 输入法自造词记忆问题排查指南

问题现象分析

在使用 Fcitx5 Android 输入法时，用户发现 Rime 输入法引擎无法记住自造词。具体表现为：当输入词库中不存在的词汇（如"橱子"）后，再次输入相同词汇时，系统未能显示之前输入过的自造词。这一问题与 Windows、Mac 和 Linux 平台上的 Rime 输入法表现不一致，后者能够正常记住用户自造词。

问题根源探究

经过深入排查，发现该问题的根本原因是 Rime 数据目录的权限设置不当。当用户将 Rime 的同步目录（sync_dir）设置为外部存储位置（如 /storage/emulated/0/Download/Rime）时，Android 系统的文件权限机制可能导致 Rime 引擎无法正常写入用户词典数据。

解决方案

1. 恢复默认配置：将 Rime 的配置文件恢复为默认设置，特别是以下两个关键参数：

   • 移除自定义的 sync_dir 设置
   • 使用自动生成的 installation_id 而非自定义 ID

2. 正确配置示例：

distribution_code_name: "fcitx-rime"
distribution_name: Rime
distribution_version: 5.1.4
install_time: "Sun Jan 28 09:26:07 2024"
rime_version: 1.9.0
installation_id: "4d04634d-b761-48db-b64b-5e67e42eb487"
update_time: "Sun Jan 28 09:38:20 2024"

技术原理详解

Android 系统对应用访问外部存储有严格的权限限制。当 Rime 尝试将用户词典写入外部存储时，可能会因权限不足而导致写入失败。相比之下，使用应用内部数据目录则不受此限制，因为应用对自身数据目录拥有完全访问权限。

最佳实践建议

1. 除非有特殊需求，否则不建议修改 Rime 的默认数据存储位置
2. 如需备份用户词典，建议使用 Rime 内置的词典导出功能
3. 定期检查 Rime 数据目录的读写权限
4. 在修改配置后，务必手动触发 Rime 部署以确保更改生效

问题排查通用方法

当遇到类似输入法记忆功能异常时，可以按照以下步骤排查：

1. 检查数据目录权限设置
2. 验证配置文件语法是否正确
3. 查看输入法日志输出
4. 尝试恢复默认配置测试基础功能
5. 逐步添加自定义配置以定位问题点

通过以上方法，大多数与用户词典记忆相关的问题都能得到有效解决。