# 屏幕使用时间

屏幕使用时间导出如何工作，从连接到修复问题。

## 连接

在屏幕使用时间卡片上点按“连接”。面板会在 macOS 存放屏幕使用时间的 Knowledge 文件夹 `~/Library/Application Support/Knowledge` 中打开：点按“选择此文件夹”。然后点按“选择导出文件夹”。

## 文件存放在哪里

每天一个 Markdown 文件，以日期命名（`2026-09-01.md`），旁边还有一个 `summary.md`。直接位于个人文件夹中的文件夹，如 `~/Documents`，会在其中新建一个 `screen-time-export` 文件夹；更深层的文件夹，如 `~/Documents/screen-time`，会被直接使用。

## 导出的内容

卡片上勾选的日期。标签页只用于给列表排序：“天”（每一天，最新的在前）、“最近”（最近七天）和“最多”（屏幕使用时间最多）。

macOS 大约保留四周的屏幕使用时间。Exporter 从不删除任何一天的文件，所以导出会超出这个范围继续增长，而较早的日子只有这个文件夹里的一份。在你导出之前就已被 macOS 删除的日子无法导出。

每日文件有四个部分：App Usage（每个使用了一分钟或以上的应用，以及它的使用时长和次数）、Web Usage（每个域名的时长和访问次数）、Notifications（每个应用的通知数量）和 Screen Sessions（屏幕何时亮起、何时熄灭，以及总时长）。`summary.md` 包含 Top Apps 和 Daily Totals，涵盖最近一次同步读取的日子，大约是最近四周。

## 格式

始终是 Markdown：表格，当天的总计写在 front matter 中。

## 文件

| 键 | 内容 |
| --- | --- |
| `title` | `Screen Time` 和日期 |
| `id`、`created`、`modified` | 日期 |
| `tags` | `screen-time` |
| `total_screen_time` | 当天的总时长，如 `3h 51m` |
| `apps_used`、`domains_visited` | 应用和网站的数量 |

```markdown
---
title: "Screen Time 2026-09-01"
id: "2026-09-01"
created: 2026-09-01T00:00:00
modified: 2026-09-01T00:00:00
tags:
  - "screen-time"
total_screen_time: "3h 51m"
apps_used: 4
domains_visited: 2
---

## App Usage

| App | Duration | Sessions |
|-----|----------|----------|
| Xcode | 2h 4m | 6 |
| Safari | 1h 21m | 11 |
```

## 免费与解锁

首次同步时你勾选的最新 10 天就是免费的日子，而且免费的始终是这 10 天：之后的日子需要一次性解锁（[价格](https://exporter.dev/pricing)）。如果想选择其他免费的日子，请在首次同步之前取消勾选。

## 同步和完全重新同步

首次点按“立即同步”后，Exporter 会在运行期间添加新的日子，最多每分钟一次。

“完全重新同步”会先询问，然后删除 Exporter 写入的文件，包括每一天的文件，再重新导出 macOS 仍保留的内容。macOS 已经删除的日子不会回来：在点按它之前，务必先备份这个文件夹。

## 问题和修复

- “该文件夹中没有 knowledgeC.db（请选择 Knowledge 文件夹本身）”：再次点按“连接”，然后选择面板打开时所在的文件夹
- 不再有新的日子：免费的 10 天已经用完。解锁屏幕使用时间，然后点按“立即同步”
- 一开始就缺少某一天：macOS 已经删除了它
- `summary.md` 只涵盖最近几周：它汇总的是最近一次同步读取的日子；其余的保存在每日文件中

## Related

- [Screen Time](https://exporter.dev/screen-time): Screen Time as one file per day
- [Screen Time guides](https://exporter.dev/guides/screen-time): Keep every day as a file
- [Getting started](https://exporter.dev/docs/getting-started): Install, connect, first export

---

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