# Safari

Safari 匯出如何運作，從連接到修復。

## 連接

在 Exporter 主頁上點按 Safari 旁的「連接」。面板會在 Safari 的資料夾中開啟；不要選擇任何內容，直接點按「選擇此資料夾」，讓 Exporter 可以讀取你的瀏覽記錄和書籤。然後選擇檔案存放的位置。

你打開的標籤頁、標籤頁群組以及 Safari 的頁面圖片位於 Safari 留給自己的第二個資料夾中。點按卡片上「標籤頁」旁的「連接」，用同樣的方法選擇那個資料夾。Exporter 從不會在一開始就要求它。

## 選擇同步內容

卡片上每個列表都有一個標籤：「類型」（寫入什麼，各自附帶檔案數）、「網站」（按網站查看的瀏覽記錄）、「書籤」（資料夾）、「閱讀列表」和「標籤頁」（這台 Mac、你的其他裝置和你的標籤頁群組）。預設全部勾選；取消勾選你不需要的，它的檔案就會移除。

## 檔案去哪裡

直接位於個人資料夾下的資料夾（如 `~/Documents`）會在其中產生一個 `safari-export` 資料夾，每種類型一個資料夾：

- `history/2026-10-20.md`：一天，每小時一個標題，每次造訪一行，`topics.md` 放在這些日期檔案旁邊
- `bookmarks/Favorites.md`：每個最上層資料夾一個檔案，按 Safari 顯示的名稱命名
- `reading-list/How compost works.md`：你儲存的每個頁面一個檔案
- `tabs/<device>.md` 和 `tab-groups/<group>.md`：這台 Mac 的視窗和已釘選的標籤頁、其他每台裝置的標籤頁、每個標籤頁群組
- `recently-closed/Recently Closed.md`、`downloads/2026-10.md`、`top-sites/Top Sites.md`、`site-settings/Site Settings.md`、`privacy-report/2026-10.md`、`watches/<page>.md`
- `icons/`、`pictures/` 和 `pages/`：網站圖像、Safari 的頁面圖片和頁面文字（如果包含）
- `csv/`：按月的瀏覽記錄（`history-2026-10.csv`）、`bookmarks.csv`、`reading-list.csv` 和 `downloads.csv`（如果包含 CSV）

## 每個檔案包含什麼

在卡片或設定時的「選項…」裡的「包含」中勾選：

- 頁面摘錄：Safari 自己保存的每個頁面的幾行文字，放在其瀏覽記錄或書籤下方（macOS 27）
- 主題：Safari 為頁面標註的主題，寫在每一天中，也寫在 `topics.md` 中並附帶 Wikidata 連結
- 圖像：每個網站的圖像放在其行前，只拷貝一次
- 頁面圖片，勾選前關閉：Safari 為每個頁面保存的圖片，放在其瀏覽記錄或標籤頁下方，需要連接 Safari 的第二個資料夾
- 頁面文字，勾選前關閉：書籤和閱讀列表中每個頁面的文字，存放在 `pages/` 中，在你的 Mac 上取得一次，不使用你的 Cookie。需要登入的頁面、私人位址或包含機密資訊的位址不會被取得，其檔案會說明原因。你的瀏覽記錄從不會被取得。
- CSV，勾選前關閉：按月的瀏覽記錄、書籤、閱讀列表和下載項目，以表格存放在 `csv/` 中，每次造訪、每個書籤、每個頁面和每次下載各一列，供 Numbers 或試算表使用

連結和圖片遵循設定 › Markdown 中的選擇：wikilinks 或標準 Markdown。

## 免費與解鎖

最近 10 天的瀏覽記錄免費，書籤和閱讀列表也完整免費。「解鎖 Safari」一次購買即可解鎖其餘全部：你的所有瀏覽記錄、標籤頁、標籤頁群組、「最近關閉的項目」、下載項目、「熱門網站」、網站設定、隱私權報告和監看的網頁。

## 命令列

`exporter export --source safari --dest <folder>` 會把同樣的檔案寫入你在命令列卡片中允許的資料夾。參見[命令列](https://exporter.dev/docs/cli)。

## 問題與排查

- 「這不是 Safari 的資料檔案夾」：再次打開面板，不選擇任何內容，直接點按「選擇此資料夾」。
- 沒有摘錄或主題：它們來自 Safari 本身，需要 macOS 27，且只針對 Safari 此後讀取過的頁面。
- 缺少某一天：Safari 大約保留一年的瀏覽記錄；它遺忘的日子仍在你的資料夾中保留檔案。
- 「標籤頁」顯示「未連接」：在卡片上「標籤頁」旁連接 Safari 的第二個資料夾。

## Related

- [Safari](https://exporter.dev/zh-hant/safari): 瀏覽記錄、書籤和標籤頁成為檔案
- [Safari 指南](https://exporter.dev/zh-hant/guides/safari): 瀏覽記錄和 Obsidian
- [價格](https://exporter.dev/zh-hant/pricing): 免費額度、一次性解鎖與 Exporter Cloud

---

human version: https://exporter.dev/zh-hant/docs/safari
every page: https://exporter.dev/llms.txt
