Quick Search设置备份与恢复教程:换机3步完成迁移,别名与触发词全带走
Quick Search设置备份与恢复教程:换机3步完成迁移,别名与触发词全带走
Quick Search 是一款 Android 万能搜索应用,一个搜索框就能搜应用、联系人、文件、日历事件、笔记、书签、系统设置和全网内容。它的内置功能 Backup & Restore(设置备份与恢复),可以把全部偏好、搜索引擎别名、触发词、笔记和书签打包成一个 .quicksearch 备份文件;换新手机时 3 步完成迁移,无需手动逐项重配。
本文带你完成:Quick Search 设置备份文件怎么导出、换机恢复怎么操作、别名与触发词为什么能一起带走。
一、备份能带走的 8 类数据
在 SettingsBackupManager.kt 中定义了可导出的数据项,导出时默认勾选:
| 数据项 | 说明 |
|---|---|
| Settings(设置) | 始终包含,不可取消 |
| Pinned Items | 置顶应用、联系人、文件等 |
| Shortcuts | 应用快捷方式与自定义深链接 |
| Notes | 笔记内容 |
| Search Engines | 搜索引擎、排序与别名 |
| Reminders / Bookmarks | 提醒与书签 |
| Search History | 搜索历史(默认开启) |
| API Keys | 可选,需手动勾选 |
⚠️ 注意:勾选导出 API Keys 时,文件会以明文存储密钥,请勿把备份文件分享给他人(提示文案见 strings.xml)。
二、旧手机导出:找到 Backup & Restore 入口
- 打开 Quick Search,进入 Settings(设置);
- 滚动到 More Options(更多选项),点击 Backup & Restore("Export or import your app settings",入口见 SettingsMoreOptions.kt);
- 选择 Export,在弹窗中按需勾选要导出的数据项,确认后文件自动保存到 Downloads(下载) 目录。
备份文件名格式为 quick-search-settings-20261113-102904.quicksearch(带时间戳,命名逻辑见 SettingsBackupActions.kt)。
三、换机3步恢复:别名与触发词全带走
第 1 步:把备份文件传到新手机
通过云盘、数据线或 QQ/微信,把 .quicksearch 文件传到新手机的 Downloads 或 Documents 目录(放子文件夹也行,程序会向下扫描 3 层,见 BackupFileDiscovery.kt)。
第 2 步:新手机安装并授权文件权限
首次启动时按引导授予文件权限。授予后,应用会自动扫描设备上的备份文件;一旦发现,会直接进入恢复界面并提示 "Backup File Found"(有备份文件吗?),见 ImportSettingsScreen.kt。
第 3 步:一键 Restore
在引导页选择备份文件,点击 Restore;没有自动发现时,也可在文件管理器中手动选择文件导入。恢复成功后直接进入 "Start Searching" 主界面,跳过后续引导页。
💡 恢复会用备份内容覆盖现有设置("This will overwrite your existing settings")。若不想走引导流程,随时可在 设置 → More Options → Backup & Restore 中 Import。
四、为什么别名和触发词能一起迁移?
Quick Search 的别名(如 ggl → Google)和长按设置的触发词,本质都是保存在设置偏好(SharedPreferences)中的数据,因此随备份文件整体序列化/恢复:
- 搜索引擎别名:输入别名前缀即可定向某个引擎,别名规则见 AliasHandler.kt;
- 分区/工具别名:如
wtr直达天气工具,空别名可直达应用、文件、联系人等分区; - 触发词(Triggers):长按任意结果设置触发词后,输入该词即自动打开对应项目。
迁移完成后,新手机上的别名与触发词行为与旧机完全一致。更多别名用法可参考 FEATURES.md。
五、常见问题
备份是明文的吗?
.quicksearch 是明文 JSON(格式版本 formatVersion: 2),未勾选 API Keys 时不含敏感密钥,但仍建议存放在安全位置。
新手机没装文件权限能恢复吗? 不能。引导流程会先请求文件权限,再扫描备份文件(逻辑见 NavigationManager.kt)。
除了手动导出还有其他备份方式吗? 有。Quick Search 同时支持 Android 系统级自动备份,相关声明见 data_extraction_rules.xml,换机时可作为双保险。
总结
- 旧机:设置 → More Options → Backup & Restore → Export,一键导出;
- 新手机:文件放入 Downloads,安装后在引导页 Restore 一键恢复;
- 别名、触发词、搜索引擎排序、笔记、书签全部原样带走,3 步完成换机迁移 ✅

