快速上手

本指南幫助您在 5 分鐘內 完成設定，實現全自動的瀏覽器歷史紀錄備份。

---

第一步 — 首次啟動

啟動 HistorySync。首次執行時，安裝精靈將引導您完成基本設定。

如果從原始碼執行：

python -m src.main

---

第二步 — 同步瀏覽器

在儀表板中，點擊立即同步。HistorySync 將：

1. 自動偵測系統上已安裝的所有瀏覽器。
2. 使用 WAL 快照安全讀取 SQLite 歷史資料庫 — 瀏覽器可保持執行狀態。
3. 將紀錄匯入 HistorySync 本機資料庫。

首次同步耗時較長

如果您有跨多個瀏覽器的多年歷史資料，首次同步可能需要一兩分鐘。後續同步為增量模式 — 僅匯入新紀錄。

選擇性同步

只同步特定瀏覽器，使用 CLI：

hsync -s --browsers chrome,firefox

---

第三步 — 搜尋歷史紀錄

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 相關頁面，排除教學

---

第四步 — 開啟自動同步

進入設定 → 自動同步：

1. 啟用自動同步。
2. 設定偏好的間隔（預設：2 小時）。
3. 啟用開機啟動，讓 HistorySync 以背景靜默模式隨系統啟動。

從此，瀏覽器歷史紀錄將持續自動聚合到同一個可搜尋的資料庫中。

---

第五步 — 設定雲端備份（選用）

WebDAV 備份讓您能在新設備上恢復歷史紀錄，或跨設備共享資料。

1. 進入設定 → WebDAV 雲端備份。
2. 填寫 WebDAV 伺服器 URL、使用者名稱和密碼。
3. 啟用自動備份並設定間隔。
4. 點擊測試連線驗證設定。

主流服務商的詳細設定步驟請參閱 WebDAV 設定指南。

---

第六步 — 系統匣模式（背景執行）

設定完成後，關閉主視窗。HistorySync 將最小化到系統匣，繼續靜默同步和備份。

以右鍵點擊系統匣圖示可以：

• 開啟 HistorySync — 恢復主視窗。
• 立即同步 — 觸發即時同步。
• 立即備份 — 觸發即時 WebDAV 備份。
• 結束 — 完全停止應用程式。

---

後續步驟

目標	文件
從終端機自動化同步	CLI 命令參考
設定特定 WebDAV 服務商	WebDAV 設定
自訂鍵盤快捷鍵	鍵盤快捷鍵
匯出歷史紀錄為 CSV / JSON / HTML	CLI 參考 — 匯出歷史紀錄
了解安全架構	安全架構