# Lịch

Cách xuất Lịch hoạt động, từ lúc kết nối đến lúc xử lý sự cố.

## Kết nối

Bấm «Kết nối» bên cạnh Lịch trên trang chính của Exporter, rồi «Mở thư mục Lịch». Cửa sổ mở ra trong thư mục của Lịch, `~/Library/Group Containers/group.com.apple.calendar`: bấm «Chọn thư mục này». Rồi chọn nơi lưu tệp và bấm «Dùng thư mục này».

macOS không hỏi quyền truy cập lịch, và Exporter không bao giờ hỏi: các sự kiện được đọc từ cơ sở dữ liệu bên trong thư mục bạn đã cho phép, không qua EventKit. Hộp thoại quyền bạn từng thấy ở ứng dụng khác thuộc về con đường kia.

## Các tệp đi đâu

Mỗi tháng một tệp Markdown, trong một thư mục: `2026-09.md`, `2026-10.md`. Một thư mục nằm ngay trong thư mục nhà của bạn, như `~/Documents`, sẽ có thêm thư mục `calendar-export` bên trong; một thư mục sâu hơn, như `~/Documents/lich`, được dùng đúng như vậy. Tháng không có sự kiện thì không có tệp.

## Những gì được xuất

Mọi sự kiện trong các lịch được đánh dấu trên thẻ, trong khoảng thời gian đã đặt. Bộ chọn nhóm các lịch theo tài khoản, như thanh bên của Lịch, nên một lần bỏ chọn có thể để cả một tài khoản ra ngoài.

Một sự kiện thuộc về tháng mà nó bắt đầu, đúng một lần, kể cả khi nó kéo dài qua cuối tháng.

## Sự kiện lặp lại

Sự kiện lặp lại có mặt trong mọi ngày nó diễn ra, không chỉ ngày nó được tạo. Exporter đọc các lần xuất hiện mà Lịch giữ cho khung nhìn của chính nó, nên tệp khớp với ứng dụng, và một dòng cho biết sự kiện lặp lại thế nào.

## Định dạng

Luôn là Markdown: frontmatter của tháng, rồi mỗi ngày một tiêu đề và mỗi sự kiện một dòng.

Một ngày bắt đầu bằng các sự kiện cả ngày, rồi đi theo giờ bắt đầu, đúng thứ tự Lịch vẽ ngày đó. Sự kiện cả ngày ghi «all day»; nó không bao giờ nhận một mốc 00:00 mà nó không có.

## Tệp

| khóa | chứa |
| --- | --- |
| `title`, `month` | “Lịch, tháng 9 năm 2026” và `2026-09` |
| `events` | tệp chứa bao nhiêu sự kiện |
| `calendars` | các lịch của tháng, lịch dày nhất trước |

Một dòng là giờ, sự kiện, lịch mà nó đến từ đó và nơi nó diễn ra, rồi tới các trường mà một vault có thể truy vấn:

| trường | chứa |
| --- | --- |
| `repeats::` | `daily`, `weekly`, `every 2 weeks` |
| `join::` | liên kết cuộc gọi video, khi sự kiện có |
| `with::` | có bao nhiêu người trong đó |

```markdown
## 2026-09-17, Thứ Năm

- all day Sinh nhật Marilyn · Sinh nhật
- 09:30-10:00 Standup · Công việc · Zoom [repeats:: weekly] [with:: 6]
- 13:00-14:00 Ăn trưa với Kevin · Cá nhân · Philz Coffee
```

## Đọc lùi bao xa

Hàng «reads» trên thẻ: năm nay, 2 năm, 5 năm hoặc tất cả. Nó đổi những tệp được ghi, nên khoảng hẹp hơn là bản xuất nhỏ hơn.

Lịch giữ khoảng hai năm các lần xuất hiện cho khung nhìn của chính nó, và đó là tất cả những gì có thể đọc: trên một máy Mac thật, 2 năm, 5 năm và tất cả trả về cùng những sự kiện. «tất cả» nghĩa là tất cả những gì máy Mac này có, không phải tất cả những gì từng xảy ra.

## Miễn phí và sau khi mở khóa

100 sự kiện đầu tiên là miễn phí, và vẫn miễn phí. Mở khóa Lịch sẽ xuất phần còn lại ([giá](https://exporter.dev/pricing)).

## Đồng bộ và đồng bộ lại toàn bộ

Sau lần «sync now» đầu tiên, Exporter ghi lại một tháng khi có gì đó trong đó thay đổi, nhiều nhất mỗi phút một lần. Dời một sự kiện sẽ ghi lại tháng của nó, và chỉ tháng đó.

«full resync» hỏi trước, rồi xóa các tệp tháng mà Exporter đã ghi và ghi lại mọi lịch được đánh dấu. Mọi thứ khác trong thư mục vẫn còn.

## Sự cố và cách xử lý

- «no calendar database in that folder (pick the Calendar folder itself)»: bấm «connect» lần nữa và chọn thư mục mà cửa sổ mở ra
- thiếu một lịch: nó đã bị bỏ dấu trên thẻ, hoặc cả tài khoản của nó bị bỏ dấu. Bộ chọn nhóm các lịch theo tài khoản
- thiếu sự kiện cũ: hàng «reads» đang đặt ở khoảng ngắn hơn, hoặc chính Lịch không còn giữ chúng
- lời nhắc của bạn nằm trong bản xuất: Lịch hiển thị lời nhắc đã lên lịch như một lịch riêng. Hãy bỏ dấu tài khoản «Reminders» trên thẻ

## Related

- [Lịch](https://exporter.dev/vi/calendar): Mỗi tháng một tệp Markdown
- [Lời nhắc](https://exporter.dev/vi/docs/reminders): Tệp danh sách, trường và cách sửa
- [Máy chủ MCP](https://exporter.dev/vi/docs/mcp): Kết nối Claude và các agent khác

---

human version: https://exporter.dev/vi/docs/calendar
every page: https://exporter.dev/llms.txt