快速上手¶
本指南帮助你在 5 分钟内 完成配置，实现全自动的浏览器历史备份。
第一步 — 首次启动¶
启动 HistorySync。首次运行时，安装向导将引导你完成基本配置。
如果从源码运行：
第二步 — 同步浏览器¶
在仪表盘中，点击立即同步。HistorySync 将：
- 自动检测系统上已安装的所有浏览器。
- 使用 WAL 快照安全读取 SQLite 历史数据库 — 浏览器可保持运行状态。
- 将记录导入 HistorySync 本地数据库。
首次同步耗时较长
如果你有跨多个浏览器的多年历史数据，首次同步可能需要一两分钟。后续同步为增量模式 — 仅导入新记录。
选择性同步¶
只同步特定浏览器，使用 CLI：
第三步 — 搜索历史记录¶
GUI 搜索¶
在历史标签页顶部的搜索栏中输入关键词，结果即时呈现。
全局悬浮窗（Spotlight 风格）¶
在任意应用程序中按下 Ctrl+Shift+H 即可唤出速查悬浮窗，支持 Windows、macOS 和 Linux（X11）。Wayland 环境下请将 python -m src.main --quick 绑定到系统级快捷键代替。
自然输入，或使用高级查询语法：
| 示例查询 | 查找内容 |
|---|---|
python async |
标题或 URL 中含这些词的页面 |
domain:github.com |
仅 GitHub 页面 |
after:2024-06-01 domain:arxiv.org |
2024年6月后浏览的论文 |
is:bookmarked tag:work |
标记为"work"的已收藏页面 |
react -tutorial |
React 相关页面，排除教程 |
第四步 — 开启自动同步¶
进入设置 → 自动同步：
- 启用自动同步。
- 设置首选间隔（默认：2 小时）。
- 启用开机启动，让 HistorySync 以后台静默模式随系统启动。
从此，浏览器历史记录将持续自动聚合到同一个可搜索数据库中。
第五步 — 配置云端备份（可选）¶
WebDAV 备份让你能在新设备上恢复历史记录，或跨设备共享数据。
- 进入设置 → WebDAV 云端备份。
- 填写 WebDAV 服务器 URL、用户名和密码。
- 启用自动备份并设置间隔。
- 点击测试连接验证配置。
主流服务商的详细配置步骤请参阅 WebDAV 配置指南。
第六步 — 托盘模式（后台运行）¶
配置完成后，关闭主窗口。HistorySync 将最小化到系统托盘，继续静默同步和备份。
右键点击托盘图标可以：
- 打开 HistorySync — 恢复主窗口。
- 立即同步 — 触发即时同步。
- 立即备份 — 触发即时 WebDAV 备份。
- 退出 — 完全停止应用。
下一步¶
| 目标 | 文档 |
|---|---|
| 从终端自动化同步 | CLI 命令参考 |
| 配置特定 WebDAV 服务商 | WebDAV 配置 |
| 自定义键盘快捷键 | 键盘快捷键 |
| 导出历史记录为 CSV / JSON / HTML | CLI 参考 — 导出历史 |
| 了解安全架构 | 安全架构 |