# 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-hans/safari): 历史记录、书签和标签页成为文件
- [Safari 指南](https://exporter.dev/zh-hans/guides/safari): 历史记录和 Obsidian
- [价格](https://exporter.dev/zh-hans/pricing): 免费额度、一次性解锁和 Exporter Cloud

---

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