备份与恢复

本页说明中州鹅当前的完整备份流程，代码与文档对应关系见核对记录。旧版可能只提供明文 ZIP。

在应用的“数据与备份”页面导出、导入完整用户数据。换手机、换包名、换签名或卸载前，先把备份保存到应用目录以外。

导出格式

格式	用途
默认的加密 .fcbak	保存完整备份，导入时输入导出时设置的密码。
明文 ZIP	在导出对话框中明确选择，用于兼容旧版或上游版本；文件内容没有加密。

密码不要求复杂度，但不能为空，并需再次输入确认。应用不会保存密码，也无法找回。 这是备份文件的密码，与局域网编辑器的六位配对码无关。

完整备份可能包含用户词库、布局、主题、剪贴板历史、目录路径和同步设置。 Android 系统自动备份仅保留部分设置界面外观，不能替代手动完整备份。

完整数据备份还包括自行导入的 JS 语音插件脚本、插件注册信息、插件普通设置和网络主机授权记录。JS 插件设置里通过密钥字段保存的 API key 会以 AES-GCM 加密后的密文写入备份；用于解密的 Android Keystore 密钥不会导出，所以在另一台设备、卸载重装或清除应用数据后，需要重新填写这些密钥。腾讯云 AppID、SecretId 等普通设置会随其他偏好一起写入备份。

普通 ZIP 可以直接查看插件脚本与普通设置；.fcbak 会用备份密码加密整个归档。请勿将 API key 写在自定义插件源码中或普通文本字段中，这些内容会跟随脚本或偏好进入普通 ZIP。

导入流程

1. 先为当前数据导出一份备份。
2. 选择 .fcbak 或兼容 ZIP；加密文件输入对应密码。
3. 等待校验，核对恢复目标和替换范围，再确认恢复。
4. 恢复时输入法暂时停止，应用通过独立恢复页面完成替换；结束后重新打开并核对方案、用户词库、布局与主题。

加密文件认证完成前不会解析 ZIP 或替换现有数据；认证通过后仍会检查压缩包、数据库、偏好和目标目录。 不要把公共存储根目录或混有其他用途文件的父目录选作恢复目标。

中断、冲突与外部存储

恢复记录会在进程退出后用于继续清理或回滚。再次打开出现恢复页面时，先按提示重试；有外部存储时，确认原来的卷和目录已经可用。 发生目录冲突会保留原数据和导入数据，诊断文件只提供路径与错误信息。 保留原数据等待恢复时，不要清除应用数据或手动删除不确定用途的恢复目录。

进程中断恢复已通过相应测试，不代表已经验证物理断电、文件系统损坏或真实存储卷拔插。

不同备份的区别

• Rime 同步用于交换用户词典等方案数据，不是完整应用备份。
• 布局／主题二维码用于分享单份配置，不包含全部应用数据。
• 系统自动备份只含外观白名单，不包含主偏好、剪贴板、同步凭据和 Rime 文件。

开发与兼容性细节见加密备份格式和整包恢复事务。

大条目与一致性

备份和恢复在 SQLite 内复制大文本或二进制条目，并处理 WAL 状态，减少把整个条目一次性装入应用内存的需要。 完整 Rime 备份会先暂停原生写入；同步保存不等于引擎已停止写库。外部共享目录若在备份期间被其他程序修改，会报告一致性问题，应停止其他写入者后重试。