# Wallet Cách hoạt động của việc xuất từ Ví, từ kết nối đến khắc phục sự cố. ## Kết nối Bấm “Kết nối” bên cạnh Ví trên trang chính của Exporter, rồi “Mở thư mục Passes”. Bảng chọn mở ra trong thư mục nơi macOS giữ các thẻ của bạn, `~/Library/Passes`: bấm “Chọn thư mục này”. Sau đó chọn nơi lưu tệp và bấm “Dùng thư mục này”. Hãy lấy chính thư mục Passes, không phải thư mục `Cards` bên trong. Exporter đọc các thẻ từ `Cards`, còn `passes23.sqlite` bên cạnh chỉ vì một điều: ngày thẻ được ký, cũng là ngày duy nhất mà nhiều thẻ cũ có. ## Tệp nằm ở đâu Mỗi thẻ một tệp Markdown, trong cùng một thư mục, đặt tên theo ngày và theo loại thẻ: `2026-09-17 united airlines SFO-EWR.md`, `2026-09-11 the sf database meetup.md`. Thẻ hoàn toàn không có ngày thì chỉ mang tên của nó (`apple store.md`). Thư mục nằm ngay trong thư mục cá nhân, như `~/Documents`, sẽ có thêm thư mục `wallet-export` bên trong; thư mục sâu hơn, như `~/Documents/wallet`, được dùng nguyên như vậy. ## Những gì được xuất Mọi thẻ được đánh dấu trên thẻ nguồn: thẻ lên máy bay, vé tàu và vé xe khách, vé sự kiện, thẻ cửa hàng, phiếu giảm giá và thẻ dạng chung. Các nút lọc chỉ lọc danh sách: thẻ (tất cả), chuyến bay (gồm cả tàu và xe khách), sự kiện và thẻ cửa hàng. Hai thẻ cho ra cùng một tên tệp sẽ mỗi thẻ nhận một hậu tố ngắn lấy từ id, nên không thẻ nào ghi đè thẻ nào. Bỏ đánh dấu một thẻ sẽ xóa tệp của nó ở lần đồng bộ sau; đánh dấu lại thì tệp quay về. ## Định dạng Luôn là Markdown: front matter của thẻ, một tiêu đề và một dòng cho biết ở đâu và khi nào, rồi đến các trường đúng như thẻ hiển thị, mặt sau của thẻ dưới tiêu đề `Back`, và số của mã vạch. ## Tệp | khóa | chứa | | --- | --- | | `title`, `id` | thẻ tên là gì, và id mà Ví đặt cho nó | | `kind` | `flight`, `transit`, `event`, `card` hoặc `other` | | `date`, `date_source` | khi nào thẻ có giá trị, và đó là ngày của bên phát hành, ngày hết hạn hay ngày ký | | `organization`, `pass_type` | bên phát hành và mã định danh loại thẻ của họ | | `expires`, `voided` | khi nào hết hạn, và Ví đã đánh dấu thẻ là đã dùng hay chưa | | `coordinates` | tọa độ địa điểm, khi thẻ có mang | Mục `Details` mang các trường có kiểu của Apple mà thẻ chưa hiển thị: nhà ga, cửa đến, múi giờ, hạng vé. Mục `Where` nêu tên địa điểm. Mã vạch có nội dung nhị phân sẽ nói rõ điều đó thay vì ghi ký tự điều khiển vào tệp. ```markdown --- title: "United Airlines SFO-EWR" kind: flight date: 2026-09-17T18:20:00 date_source: relevant organization: "United Airlines" --- # United Airlines SFO-EWR San Francisco (SFO) → Newark (EWR) · 17 Sep 2026 - FLIGHT: UA 274 - GATE: F19 - SEAT: 34D ## Back - CONFIRMATION: GGCLMQ ``` ## Ngày, kể cả khi không có Thẻ được xếp theo ngày của chính nó, trong múi giờ mà bên phát hành ghi: chuyến bay rời Denver lúc 23:25 là ngày đó ở Denver, không phải ngày hôm sau nơi bạn đang đọc. Vé sự kiện cũ thường không có ngày nào cả; những thẻ đó được xếp theo ngày ký, và `date_source: signed` nói rõ điều đó trong tệp. ## Thẻ bằng ngôn ngữ khác Một thẻ có thể giữ chữ của nó trong tệp `pass.strings` bên trong gói và chỉ để lại các khóa trong thẻ. Exporter phân giải chúng theo ngôn ngữ máy Mac của bạn, nên vé hiện tên sự kiện chứ không phải `EVENT_NAME`. ## Miễn phí và mở khóa 20 thẻ mới nhất của bạn là miễn phí, và vẫn luôn miễn phí. Mở khóa Ví 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 “Đồng bộ ngay” đầu tiên, Exporter chỉ ghi lại tệp của một thẻ khi thẻ đó thay đổi, nhiều nhất mỗi phút một lần. Cửa ra, chỗ ngồi và giờ lên máy bay thay đổi trong ngày bạn đi, và mỗi thay đổi chỉ ghi lại tệp của riêng thẻ đó. “Đồng bộ lại toàn bộ” sẽ hỏi trước, rồi xóa các tệp thẻ mà Exporter đã ghi và ghi lại mọi thẻ được đánh dấu. Mọi thứ khác trong thư mục vẫn giữ nguyên. ## Sự cố và cách khắc phục - “không có thẻ nào trong thư mục đó (hãy chọn thư mục Passes trong thư viện của bạn)”: bấm “Kết nối” lần nữa và chọn thư mục mà bảng chọn mở ra - thiếu một thẻ: nó bị bỏ đánh dấu trên thẻ nguồn, hoặc 20 thẻ miễn phí đã dùng hết. Hãy mở khóa Ví rồi bấm “Đồng bộ ngay” - một thẻ không có ngày trong tên: thẻ không mang ngày nào, và cơ sở dữ liệu của Ví cũng không đọc được. Hãy kết nối chính `~/Library/Passes` thay vì `Cards` - không thấy số thẻ ngân hàng: chúng hoàn toàn không nằm trên máy Mac. Ví giữ thẻ thanh toán trong Secure Element, và Exporter không bao giờ thấy chúng ## Related - [Ví](https://exporter.dev/vi/wallet): Mỗi thẻ là một tệp Markdown - [Bắt đầu](https://exporter.dev/vi/docs/getting-started): Cài đặt, kết nối, lần xuất đầu tiên - [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/wallet every page: https://exporter.dev/llms.txt