# 螢幕使用時間

螢幕使用時間匯出的運作方式，從連接到排解問題。

## 連接

在螢幕使用時間卡片上按「連接」。面板會在 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（當天使用一分鐘以上的每個 App，以及它的使用時間和使用次數）、Web Usage（每個網域的使用時間和造訪次數）、Notifications（每個 App 的通知數量）和 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` | 使用了多少個 App 和網站 |

```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 天就是免費的日子，而且會一直是這十天：之後的日子需要一次性解鎖（[價格](https://exporter.dev/pricing)）。若要選擇其他免費的日子，請在首次同步之前取消勾選。

## 同步與完全重新同步

第一次按「立即同步」之後，只要 Exporter 在執行，就會加入新的日子，最多每分鐘一次。

「完全重新同步」會先詢問，然後移除 Exporter 寫出的檔案（包括每個每日檔案），再重新匯出 macOS 仍保有的內容。macOS 已經刪除的日子不會回來：在你按下它之前，請務必先備份資料夾。

## 問題與解決方法

- 「該資料夾中沒有 knowledgeC.db（請選擇 Knowledge 資料夾本身）」：再按一次「連接」，然後選擇面板打開的那個資料夾
- 新的日子不再出現：免費的十天已用完。解鎖螢幕使用時間，然後按「立即同步」
- 某一天從一開始就不見：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-hant/docs/screen-time
every page: https://exporter.dev/llms.txt