# 📖 Hướng Dẫn Sử Dụng Zero Bookmark Manager (Từ A – Z)

> **Zero Bookmark Manager** là tiện ích mở rộng (Chrome Extension) mạnh mẽ, hiện đại và toàn diện nhất giúp bạn quản lý, tìm kiếm, dọn dẹp và khai thác dấu trang (bookmarks) một cách trực quan, khoa học với sự hỗ trợ của Trí tuệ Nhân tạo (AI).

---

## 📸 Danh Sách 24 Ảnh Chụp Màn Hình Cần Chuẩn Bị (Screenshots Checklist)

Trong bản tài liệu, các thẻ chèn ảnh chuẩn `![Hình ảnh: ...](images/zero-bookmark/...)` đã được bố trí sẵn kèm hướng dẫn chi tiết. Khi xuất bản bài viết hoặc đóng gói tiện ích, bạn chỉ cần chụp 24 bức ảnh theo danh sách sau và lưu vào thư mục `images/zero-bookmark/`:

| STT | Tên tệp ảnh đề xuất | Vị trí trong tài liệu | Mô tả chi tiết nội dung cần chụp |
| :---: | :--- | :--- | :--- |
| **1** | `logo.png` | 1. Giới thiệu | Logo hoặc banner đồ họa chính thức của Zero Bookmark Manager. |
| **2** | `pin_extension.png` | 2. Cài đặt (Chrome Store) | Thanh công cụ Chrome khi bấm vào biểu tượng mảnh ghép và ghim icon tiện ích. |
| **3** | `developer_mode_toggle.png` | 2. Cài đặt (Offline) | Màn hình `chrome://extensions` với nút bật "Developer mode" ở góc trên bên phải. |
| **4** | `load_unpacked_action.png` | 2. Cài đặt (Offline) | Cửa sổ chọn thư mục tiện ích khi nhấn nút "Load unpacked". |
| **5** | `extension_display_modes.png` | 3. Các chế độ mở | Minh họa 3 chế độ: Quick Save Popup, Side Panel (dọc web) và Full Dashboard tab. |
| **6** | `command_palette.png` | 4. Command Palette | Cửa sổ bảng lệnh nổi giữa màn hình (Ctrl + K) với ô tìm kiếm và danh sách phím tắt/lệnh. |
| **7** | `quick_save_single.png` | 5. Quick Save (1 Tab) | Popup Quick Save lưu trang hiện tại: Tiêu đề, URL, chọn thư mục, Suggested tags và Notes. |
| **8** | `quick_save_multitab.png` | 5. Quick Save (Đa Tab) | Giao diện lưu nhiều tab đang mở với checkbox chọn tab và ô đặt tên thư mục gom nhóm. |
| **9** | `view_modes_overview.png` | 6. 8 Chế độ xem | Bố cục so sánh các view: Flat, Tree, Card, Bento Box, Kanban Board. |
| **10** | `web_preview_modal.png` | 6. Chế độ xem | Cửa sổ Modal Iframe xem trước nội dung trang web trực tiếp trong tiện ích (nút Detail). |
| **11** | `sidebar_and_folder_studio.png` | 7. Quản lý thư mục | Cây thư mục thanh bên (thao tác kéo thả) kèm hộp thoại Folder Studio đổi màu/icon. |
| **12** | `search_and_filters.png` | 8. Tìm kiếm & Lọc | Thanh công cụ phía trên: Ô tìm kiếm Fuzzy search, lọc theo Domain, Tags và dropdown Sort. |
| **13** | `tags_browser.png` | 9. Quản lý Thẻ (Tags) | Popup Tags Browser hiển thị các nhãn thẻ màu sắc và số lượng bookmark liên kết. |
| **14** | `markdown_notes.png` | 9. Ghi chú cá nhân | Khung hiển thị và soạn thảo ghi chú Markdown cho bookmark (tiêu đề nhỏ, list, code). |
| **15** | `snooze_dialog.png` | 10. Báo lại (Snooze) | Hộp thoại đặt lịch hẹn nhắc nhở đọc lại (1 hour, Tonight, Tomorrow, Custom time) & Chrome notification. |
| **16** | `ai_settings.png` | 11. Cài đặt AI | Màn hình cấu hình AI Provider (Gemini, OpenAI, Claude, Groq, Ollama...) và ô nhập API Key. |
| **17** | `ai_chatbot.png` | 11. AI Chatbot | Khung chat AI nổi ở góc phải trò chuyện tìm kiếm và phân loại bookmark bằng tiếng Việt. |
| **18** | `smart_cleanup_dashboard.png` | 12. Dọn dẹp thông minh | Màn hình Smart Cleanup: Quét Dead links, Duplicates, Stale bookmarks, Empty folders. |
| **19** | `duplicate_merger.png` | 12. Gộp trùng lặp | Giao diện so sánh 2 bookmark trùng lặp và các nút gộp tag/ghi chú trước khi xóa. |
| **20** | `analytics_dashboard.png` | 13. Thống kê Analytics | Màn hình số liệu tổng quan, biểu đồ tròn phân bổ danh mục và top tên miền. |
| **21** | `workspaces_switcher.png` | 14. Workspaces | Dropdown chuyển đổi không gian làm việc: Work, Learning, Design, Personal. |
| **22** | `google_drive_sync.png` | 15. Đồng bộ Google Drive | Trạng thái đăng nhập Google OAuth 2.0, ngày sao lưu và nút "Backup Now" / "Restore". |
| **23** | `export_import_dialog.png` | 15. Xuất / Nhập | Hộp thoại chọn xuất JSON/HTML/CSV và khu vực kéo thả tệp để nhập dữ liệu. |
| **24** | `themes_palette.png` | 16. Tùy biến Theme | Bảng màu theme (Tokyo Night, Dracula, Nord, Dark, Light, Tết...). |

---

## 📑 Mục Lục

1. [Giới thiệu tổng quan](#1-giới-thiệu-tổng-quan)
2. [Cài đặt & Khởi động](#2-cài-đặt--khởi-động)
3. [Các chế độ mở giao diện](#3-các-chế-độ-mở-giao-diện)
4. [Bảng phím tắt & Bảng lệnh (Command Palette)](#4-bảng-phím-tắt--bảng-lệnh-command-palette)
5. [Lưu Bookmark nhanh (Quick Save & Multi-Tab Save)](#5-lưu-bookmark-nhanh-quick-save--multi-tab-save)
6. [8 Chế độ hiển thị (Views)](#6-8-chế-độ-hiển-thị-views)
7. [Quản lý thư mục & Cây thư mục (Sidebar & Folder Studio)](#7-quản-lý-thư-mục--cây-thư-mục-sidebar--folder-studio)
8. [Tìm kiếm, Lọc & Sắp xếp thông minh](#8-tìm-kiếm-lọc--sắp-xếp-thông-minh)
9. [Quản lý Thẻ (Tags) & Ghi chú Markdown (Notes)](#9-quản-lý-thẻ-tags--ghi-chú-markdown-notes)
10. [Danh sách đọc (Reading Queue) & Hẹn giờ nhắc nhở (Snooze)](#10-danh-sách-đọc-reading-queue--hẹn-giờ-nhắc-nhở-snooze)
11. [Trợ lý AI & Tự động phân loại (Chatbot & Auto-Tagging)](#11-trợ-lý-ai--tự-động-phân-loại-chatbot--auto-tagging)
12. [Dọn dẹp thông minh (Smart Cleanup Dashboard)](#12-dọn-dẹp-thông-minh-smart-cleanup-dashboard)
13. [Bảng thống kê & Đo lường (Analytics Dashboard)](#13-bảng-thống-kê--đo-lường-analytics-dashboard)
14. [Không gian làm việc (Workspaces)](#14-không-gian-làm-việc-workspaces)
15. [Sao lưu, Xuất / Nhập & Đồng bộ Google Drive](#15-sao-lưu-xuất--nhập--đồng-bộ-google-drive)
16. [Tùy chỉnh Giao diện, Phông chữ & Ngôn ngữ](#16-tùy-chỉnh-giao-diện-phông-chữ--ngôn-ngữ)
17. [Giải đáp thắc mắc thường gặp (FAQ)](#17-giải-đáp-thắc-mắc-thường-gặp-faq)

---

## 1. Giới thiệu tổng quan

![Hình ảnh: Logo hoặc banner đồ họa chính thức của Zero Bookmark Manager](images/zero-bookmark/logo.png)  
*(📸 Mô tả ảnh: Logo chính thức hoặc ảnh bìa tổng quan giao diện Zero Bookmark Manager hiển thị phong cách hiện đại và logo của tiện ích)*

Trình duyệt của bạn có hàng trăm, thậm chí hàng nghìn bookmark lưu lại nhưng không bao giờ xem lại vì quá lộn xộn? **Zero Bookmark Manager** giải quyết triệt để vấn đề này với:

* **Tốc độ vượt trội:** Áp dụng cơ chế *Lazy Rendering* và tải ảo giúp lướt mượt mà hàng chục nghìn bookmark mà không bị đơ giật.
* **8 phong cách giao diện:** Phù hợp với mọi thói quen từ danh sách cổ điển đến lưới trực quan, Bento Box hay Kanban.
* **Tích hợp Trí tuệ nhân tạo (AI):** Tự động gắn tag, tóm tắt, tìm kiếm ngữ nghĩa và trò chuyện trực tiếp qua AI Chatbot.
* **Dọn dẹp & Khôi phục:** Tự phát hiện liên kết chết, hỗ trợ tra cứu nội dung cũ qua Wayback Machine (Archive.org), gộp bookmark trùng lặp.
* **Bảo mật & Cá nhân hóa:** Hoạt động hoàn toàn trên trình duyệt của bạn (*Local-First*), đồng bộ an toàn qua tài khoản Google Drive cá nhân.

---

## 2. Cài đặt & Khởi động

### Cách 1: Cài đặt từ Chrome Web Store (Khuyên dùng)
1. Truy cập liên kết [Zero Bookmark Manager trên Chrome Web Store](https://chromewebstore.google.com/detail/zero-bookmark-manager/jhcoclfodfnchlddakkeegkogajdpgce).
2. Nhấn nút **Thêm vào Chrome (Add to Chrome)** ➔ Xác nhận thêm tiện ích.
3. Nhấp vào biểu tượng mảnh ghép trên thanh công cụ và **Ghim (Pin)** biểu tượng Zero Bookmark Manager để tiện mở nhanh.

![Hình ảnh: Ghim icon tiện ích lên thanh công cụ Chrome](images/zero-bookmark/pin_extension.png)  
*(📸 Mô tả ảnh cần chụp: Ảnh chụp thanh công cụ trình duyệt Chrome khi người dùng bấm vào biểu tượng mảnh ghép (Extensions) và nhấp ghim tiện ích Zero Bookmark Manager)*

### Cách 2: Cài đặt thủ công (Dành cho Developer / Bản phát hành Offline)
1. Tải bản nén zip từ mục [Releases](https://github.com/ChickenSoup269/Zero-Bookmark-Manager/releases) hoặc sao chép mã nguồn:
   ```bash
   git clone https://github.com/ChickenSoup269/Zero-Bookmark-Manager.git
   ```
2. Mở Google Chrome, nhập lên thanh địa chỉ: `chrome://extensions`.
3. Bật công tắc **Chế độ dành cho nhà phát triển (Developer Mode)** ở góc trên bên phải.

![Hình ảnh: Bật Developer mode trên Chrome](images/zero-bookmark/developer_mode_toggle.png)  
*(📸 Mô tả ảnh cần chụp: Ảnh chụp màn hình trang chrome://extensions với con trỏ chuột trỏ vào nút bật "Developer mode" ở góc trên bên phải)*

4. Nhấn **Tải tiện ích đã giải nén (Load unpacked)** và trỏ vào thư mục dự án chứa tệp `manifest.json`.

![Hình ảnh: Cửa sổ chọn thư mục khi nhấn Load unpacked](images/zero-bookmark/load_unpacked_action.png)  
*(📸 Mô tả ảnh cần chụp: Cửa sổ chọn thư mục BookMark2.0 khi người dùng nhấn nút "Load unpacked")*

---

## 3. Các chế độ mở giao diện

Bạn có thể mở và sử dụng Zero Bookmark Manager theo **3 cách linh hoạt**:

1. **Popup Lưu nhanh (Quick Save Popup):** Nhấp chuột trái vào icon tiện ích hoặc bấm phím tắt `Ctrl + Shift + Y` (Mac: `Cmd + Shift + Y`). Giúp lưu nhanh trang hiện tại, điền ghi chú, chọn thư mục, thêm tag mà không làm gián đoạn việc duyệt web.
2. **Thanh bên (Side Panel):** Mở tiện ích ngay bên cạnh trang web đang duyệt. Bạn vừa đọc bài viết, vừa tra cứu danh mục bookmark song song mà không cần chuyển tab.
3. **Tab đầy đủ (Full Manager Dashboard):** Nhấn nút *"Mở trang đầy đủ"* từ Quick Save hoặc truy cập `chrome-extension://<ID>/bookmarks.html`. Cung cấp toàn bộ không gian làm việc rộng rãi với đầy đủ thanh công cụ, các bộ phân tích và bảng điều khiển.

![Hình ảnh: So sánh 3 chế độ mở Quick Save, Side Panel và Full Dashboard](images/zero-bookmark/extension_display_modes.png)  
*(📸 Mô tả ảnh cần chụp: Ảnh ghép hoặc minh họa so sánh 3 chế độ: (1) Popup Quick Save nhỏ gọn, (2) Thanh bên Side Panel trượt dọc cạnh trang web, và (3) Tab Full Dashboard mở rộng toàn màn hình)*

> 💡 **Mẹo:** Trong phần Cài đặt (Settings), bạn có thể tùy chọn: khi nhấp vào icon tiện ích, trình duyệt sẽ tự động mở *Quick Save Popup*, *Side Panel* hoặc *Full Dashboard*.

---

## 4. Bảng phím tắt & Bảng lệnh (Command Palette)

Tiện ích được thiết kế để thao tác bằng bàn phím siêu tốc:

### Bảng phím tắt cơ bản

| Phím tắt (Windows / Linux) | Phím tắt (macOS) | Hành động |
| :--- | :--- | :--- |
| `Ctrl + K` | `Cmd + K` | Mở Bảng điều khiển lệnh (Command Palette) |
| `Ctrl + Shift + Y` | `Cmd + Shift + Y` | Mở cửa sổ Lưu nhanh (Quick Save) |
| `Ctrl + F` | `Cmd + F` | Nhảy nhanh vào ô tìm kiếm bookmark |
| `Ctrl + N` | `Cmd + N` | Mở hộp thoại tạo thư mục mới |
| `Ctrl + A` | `Cmd + A` | Chọn tất cả bookmark (khi bật chế độ Checkbox) |
| `Ctrl + Z` | `Cmd + Z` | Hoàn tác (Undo) hành động vừa thực hiện |
| `Delete` / `Backspace` | `Delete` | Xóa bookmark đang chọn |
| `↑` / `↓` (Arrow Keys) | `↑` / `↓` | Di chuyển lựa chọn giữa các bookmark |
| `Enter` | `Enter` | Mở bookmark hoặc thư mục đang được chọn |
| `Esc` | `Esc` | Đóng bảng lệnh, modal hoặc cửa sổ phụ |

### Bảng lệnh Command Palette (`Ctrl + K` hoặc `Cmd + K`)
Tương tự tính năng Spotlight của macOS hoặc Command Palette trong VS Code:
* Gõ tên trang hoặc URL để truy cập ngay lập tức.
* Gõ từ khóa để chuyển nhanh giao diện: `Flat`, `Tree`, `Card`, `Kanban`, `Bento`...
* Gõ tên theme để đổi màu ngay lập tức: `Tokyo Night`, `Dracula`, `Nord`, `Gruvbox`...
* Tìm kiếm xuyên suốt cả Ghi chú cá nhân (Notes) và Thư mục (Folders).

![Hình ảnh: Cửa sổ nổi Command Palette khi bấm Ctrl + K](images/zero-bookmark/command_palette.png)  
*(📸 Mô tả ảnh cần chụp: Cửa sổ nổi Command Palette hiển thị giữa màn hình khi nhấn Ctrl + K, có ô tìm kiếm và danh sách các lệnh nhanh, kết quả bookmark kèm icon trực quan)*

---

## 5. Lưu Bookmark nhanh (Quick Save & Multi-Tab Save)

Khi đang duyệt một trang web tâm đắc, chỉ cần ấn `Ctrl + Shift + Y`:

### Lưu một trang hiện tại (Single Save)
* **Tiêu đề & Đường dẫn:** Tự động điền theo trang hiện tại, bạn có thể chỉnh sửa lại theo ý muốn.
* **Thư mục (Folder):** Tìm nhanh thư mục có sẵn hoặc gõ tên mới để tạo ngay thư mục con.
* **Thẻ (Tags):** Nhập tag và ấn Enter. Tiện ích có nút *Gợi ý (Suggest)* tự động trích xuất tag phù hợp dựa trên nội dung hoặc tên miền.
* **Ghi chú (Notes):** Viết nhanh lý do bạn lưu trang này, tóm tắt ý chính bằng Markdown.

![Hình ảnh: Giao diện popup Quick Save lưu một trang](images/zero-bookmark/quick_save_single.png)  
*(📸 Mô tả ảnh cần chụp: Giao diện popup Quick Save đang mở trên một trang web, hiển thị tiêu đề, ô chọn thư mục, các tag được gợi ý và khung nhập ghi chú Notes)*

### Lưu đồng loạt nhiều Tab (Multi-Tab Save)
1. Nhấp chuyển sang chế độ *"Save multiple tabs"* (Lưu nhiều tab).
2. Đánh dấu chọn các tab đang mở bạn muốn lưu lại (hoặc *Chọn tất cả*).
3. Đặt tên thư mục gom nhóm (ví dụ: `Tài liệu nghiên cứu AI - 2026`).
4. Nhấn **Save All** để gom toàn bộ phiên duyệt web vào một thư mục chỉ trong 1 giây.

![Hình ảnh: Popup Quick Save ở chế độ Multi-tab lưu nhiều tab cùng lúc](images/zero-bookmark/quick_save_multitab.png)  
*(📸 Mô tả ảnh cần chụp: Popup Quick Save ở chế độ Multi-tab với danh sách các tab đang mở trong trình duyệt có checkbox tích chọn và ô nhập tên thư mục gom nhóm)*

---

## 6. 8 Chế độ hiển thị (Views)

Zero Bookmark Manager cung cấp **8 chế độ hiển thị linh hoạt** tại thanh công cụ:
* **Flat View (Phẳng):** Danh sách tinh gọn, tiết kiệm diện tích tối đa, thích hợp với người thích giao diện gọn gàng.
* **Tree View (Cây phân cấp):** Hiển thị rõ các tầng thư mục lồng nhau, bấm mở rộng hoặc thu gọn từng nhánh.
* **Detail View (Chi tiết):** Hiển thị đầy đủ ngày tạo, số lượt truy cập, đường dẫn, thẻ tag và nút Xem trước (Preview Modal) nội dung trang web trực tiếp qua Iframe.
* **Card View (Dạng thẻ):** Giao diện lưới hiện đại hiển thị Favicon lớn, tiêu đề rõ ràng, phù hợp cho màn hình lớn.
* **List View (Danh sách chuẩn):** Định dạng truyền thống dễ đọc với đầy đủ thông tin metadata.
* **Bento Box View:** Thiết kế dạng khối Bento mang phong cách công nghệ thời thượng, bắt mắt.
* **Kanban Board View:** Chia bookmark thành các cột theo thư mục hoặc trạng thái, dễ dàng hình dung tiến trình.
* **Mockup / Gallery View:** Trình bày theo dạng thư viện đồ họa dành cho người làm thiết kế, hình ảnh.

![Hình ảnh: Bố cục so sánh các chế độ xem chính](images/zero-bookmark/view_modes_overview.png)  
*(📸 Mô tả ảnh cần chụp: Ảnh tổng hợp trình diễn các chế độ xem chính: Card View, Detail View với cửa sổ Iframe xem trước, Kanban Board và Bento View)*

![Hình ảnh: Cửa sổ Modal Iframe xem trước nội dung trang web](images/zero-bookmark/web_preview_modal.png)  
*(📸 Mô tả ảnh cần chụp: Modal Web Preview hiển thị trang web trực tiếp trong khung Iframe khi người dùng bấm nút xem chi tiết của bookmark mà không cần mở tab mới)*

---

## 7. Quản lý thư mục & Cây thư mục (Sidebar & Folder Studio)

* **Thanh bên tùy biến (Sidebar):** Nằm ở phía bên trái, hiển thị toàn bộ cây thư mục bookmark của trình duyệt. Bạn có thể kéo đường viền để thay đổi độ rộng thanh bên theo ý muốn.
* **Kéo & Thả (Drag & Drop):** Kéo một bookmark thả vào thư mục bất kỳ trên thanh bên để di chuyển; kéo thả sắp xếp lại thứ tự các thư mục cha và con.
* **Thao tác thư mục:** Nhấp chuột phải hoặc bấm vào biểu tượng `⋮` cạnh thư mục để thêm thư mục con mới, đổi tên thư mục, đổi màu sắc hoặc biểu tượng đại diện (**Folder Studio**), và xóa thư mục có xác nhận an toàn.

![Hình ảnh: Cây thư mục thanh bên và hộp thoại Folder Studio](images/zero-bookmark/sidebar_and_folder_studio.png)  
*(📸 Mô tả ảnh cần chụp: Cây thư mục bên trái với thao tác kéo thả, kèm hộp thoại Folder Studio đang mở cho phép chọn màu sắc và biểu tượng icon cho thư mục)*

---

## 8. Tìm kiếm, Lọc & Sắp xếp thông minh

* **Tìm kiếm mờ (Fuzzy Search):** Ô tìm kiếm không chỉ so sánh từ khóa chính xác mà còn hỗ trợ tìm kiếm mờ: gõ không dấu, gõ sai một vài ký tự hoặc gõ cụm từ viết tắt vẫn trả về kết quả chính xác trong Tiêu đề, URL, Thẻ (Tags) và Ghi chú (Notes).
* **Bộ lọc chuyên sâu:** Lọc theo Thư mục, lọc theo Tên miền (Domain Filter), lọc theo Thẻ (Tag Filter) và Danh sách đọc sau (Reading Queue).
* **Sắp xếp đa dạng:** Ngày thêm mới nhất / cũ nhất, A → Z, số lượt truy cập nhiều nhất (*Most Visited*), lần truy cập gần nhất (*Last Opened*), nhóm theo tên miền, và ghim Yêu thích (*Favorites*) lên đầu.

![Hình ảnh: Thanh điều khiển tìm kiếm, lọc theo domain và sắp xếp](images/zero-bookmark/search_and_filters.png)  
*(📸 Mô tả ảnh cần chụp: Khu vực thanh điều khiển trên cùng với ô tìm kiếm gõ từ khóa, menu lọc theo Domain, dropdown sắp xếp và các nút lọc nhanh)*

---

## 9. Quản lý Thẻ (Tags) & Ghi chú Markdown (Notes)

### Quản lý Thẻ (Tags Browser)
Bạn có thể gán nhãn nhiều thẻ cho cùng một bookmark (ví dụ: `#programming`, `#javascript`, `#docs`). Tiện ích có riêng một **Tags Browser Popup**:
* Xem danh sách toàn bộ các tag đã dùng kèm số lượng bookmark tương ứng.
* Đổi màu sắc cho từng tag để dễ nhận diện.
* Xóa hoặc gộp các tag tương tự nhau.

![Hình ảnh: Cửa sổ quản lý Tags Browser](images/zero-bookmark/tags_browser.png)  
*(📸 Mô tả ảnh cần chụp: Cửa sổ Tags Browser hiển thị các thẻ màu sắc kèm số lượng bookmark bên cạnh và thanh công cụ quản lý thẻ)*

### Ghi chú cá nhân (Markdown Notes)
* Bấm vào biểu tượng ghi chú hoặc mở chi tiết (Detail) của bookmark để thêm chú thích.
* Hỗ trợ định dạng **Markdown**: in đậm, in nghiêng, danh sách gạch đầu dòng, khối code... Giúp bạn ghi nhớ lý do lưu trang hoặc đoạn code cần dùng.

![Hình ảnh: Khung chi tiết bookmark hiển thị ghi chú Markdown](images/zero-bookmark/markdown_notes.png)  
*(📸 Mô tả ảnh cần chụp: Khung chi tiết bookmark hiển thị đoạn ghi chú được định dạng đẹp mắt bằng Markdown với tiêu đề, gạch đầu dòng và code highlight)*

---

## 10. Danh sách đọc (Reading Queue) & Hẹn giờ nhắc nhở (Snooze)

### Danh sách đọc (Reading Queue / Read Later)
Khi gặp bài viết hay nhưng chưa có thời gian đọc, bấm biểu tượng **Kính đọc sách / Reading Queue** để đưa bài vào danh sách đọc. Sau khi đọc xong, bạn có thể tích chọn *"Đã đọc"* để đánh dấu hoàn tất.

### Hẹn giờ báo lại (Snooze Bookmarks)
Nếu bạn muốn xem lại một tài liệu vào sáng mai, cuối tuần hoặc một ngày cụ thể:
1. Nhấn nút `⋮` trên bookmark ➔ Chọn **Snooze (Báo lại)**.
2. Chọn mốc thời gian: *Sau 1 giờ*, *Tối nay*, *Sáng mai*, *Cuối tuần*, hoặc *Chọn ngày giờ tùy ý*.
3. Đúng thời gian đã hẹn, Chrome sẽ gửi **Thông báo đẩy (Notification)** để nhắc bạn mở lại link đó.

![Hình ảnh: Hộp thoại Snooze đặt lịch hẹn nhắc nhở đọc lại](images/zero-bookmark/snooze_dialog.png)  
*(📸 Mô tả ảnh cần chụp: Hộp thoại Snooze hiện ra với các tùy chọn mốc thời gian nhanh: 1 hour, Tonight, Tomorrow morning, Next week, Custom date/time và thông báo nhắc nhở của trình duyệt)*

---

## 11. Trợ lý AI & Tự động phân loại (Chatbot & Auto-Tagging)

### Cấu hình nhà cung cấp AI (AI Settings)
Vào phần Cài đặt ➔ **AI Settings** để lựa chọn mô hình bạn muốn dùng:
* **Google Gemini API** (Khuyên dùng - nhanh, hỗ trợ ngữ cảnh lớn, có gói miễn phí).
* **OpenAI** (ChatGPT - GPT-4o, GPT-4o-mini).
* **Anthropic Claude**.
* **Groq** (Tốc độ phản hồi cực nhanh).
* **Ollama / Local AI** (Chạy mô hình AI trực tiếp trên máy của bạn, hoàn toàn bảo mật).
* **Chrome Built-in AI** (Mô hình Gemini Nano chạy trực tiếp bên trong trình duyệt Chrome).

![Hình ảnh: Cấu hình AI Settings và API Key](images/zero-bookmark/ai_settings.png)  
*(📸 Mô tả ảnh cần chụp: Màn hình cấu hình AI Settings với menu chọn Provider, ô nhập API Key và lựa chọn model)*

### AI Chatbot thông minh
Nhấn biểu tượng Chatbot ở góc giao diện để tương tác bằng ngôn ngữ tự nhiên:
* *"Tìm cho tôi các bookmark liên quan đến học lập trình Python."*
* *"Tôi có những trang nào hướng dẫn về nấu ăn không?"*
* *"Tóm tắt các tài liệu tôi đã lưu trong tuần này."*
* *"Gợi ý cho tôi cách sắp xếp lại thư mục Tài liệu học tập."*

![Hình ảnh: Khung chat AI trợ lý thông minh](images/zero-bookmark/ai_chatbot.png)  
*(📸 Mô tả ảnh cần chụp: Cửa sổ chat AI nổi lên ở góc dưới bên phải với cuộc hội thoại mẫu người dùng đặt câu hỏi và AI trả lời trích dẫn các liên kết bookmark liên quan)*

### Tự động gắn thẻ bằng AI (Smart Auto-Tagging)
Khi thêm bookmark mới, tiện ích có thể tự động đọc tiêu đề và URL, phân tích và gán các thẻ tag thông minh chuẩn xác mà bạn không cần phải tự nghĩ ra từ khóa.

---

## 12. Dọn dẹp thông minh (Smart Cleanup Dashboard)

Trải qua thời gian dài, danh bạ bookmark thường chứa rất nhiều "rác". Nhấn nút **Smart Cleanup** để mở trung tâm dọn dẹp:

* **Kiểm tra liên kết hỏng (Dead Link Checker):** Tiện ích sẽ gửi yêu cầu ngầm để kiểm tra xem link còn sống hay đã bị lỗi (404 Not Found, 500 Server Error, Domain hết hạn).
* **Tích hợp Wayback Machine:** Đối với các trang web quan trọng đã bị xóa, bạn có thể nhấn vào biểu tượng lưu trữ để tra cứu bản sao lịch sử trên Internet Archive (Wayback Machine) và khôi phục nội dung!
* **Gộp liên kết trùng lặp (Duplicate Merger):** Quét toàn bộ kho bookmark để tìm các trang bị lưu trùng URL nhiều lần. Cho phép bạn chọn giữ lại bản cũ nhất/mới nhất, hoặc gộp toàn bộ tags & notes từ các bản sao vào một bản duy nhất trước khi xóa.
* **Liên kết không sử dụng (Stale Bookmarks):** Liệt kê các bookmark đã lưu hơn 6 tháng hoặc 1 năm nhưng chưa từng được mở lần nào.
* **Thư mục rỗng (Empty Folders):** Phát hiện các thư mục không chứa bất kỳ bookmark nào để bạn dọn dẹp với 1 cú nhấp chuột.
* **Bookmark chưa gắn tag (Untagged):** Gom các bookmark chưa được phân loại để bạn dễ dàng gắn thẻ bổ sung.

![Hình ảnh: Màn hình Smart Cleanup Dashboard](images/zero-bookmark/smart_cleanup_dashboard.png)  
*(📸 Mô tả ảnh cần chụp: Giao diện Smart Cleanup Dashboard hiển thị các thẻ phân loại: Dead Links, Duplicates, Stale Bookmarks, Empty Folders với nút bấm quét và xử lý hàng loạt)*

![Hình ảnh: Giao diện gộp liên kết trùng lặp Duplicate Merger](images/zero-bookmark/duplicate_merger.png)  
*(📸 Mô tả ảnh cần chụp: Giao diện Duplicate Merger hiển thị 2 hoặc nhiều liên kết bị trùng lặp kèm các nút chọn "Giữ lại bản mới nhất", "Gộp tags và notes" và "Xóa bản trùng")*

---

## 13. Bảng thống kê & Đo lường (Analytics Dashboard)

Truy cập **Analytics Dashboard** để có cái nhìn trực quan về kho tàng kiến thức của bạn:
* **Tổng số bookmark & thư mục:** Đo lường quy mô dữ liệu.
* **Biểu đồ tỷ lệ danh mục:** Xem bạn dành sự quan tâm nhiều nhất cho lĩnh vực nào (Công nghệ, Giải trí, Tin tức, Mua sắm...).
* **Top tên miền được lưu nhiều nhất:** Thống kê các website bạn tin tưởng lưu lại nhiều nhất.
* **Tần suất truy cập:** Đo lường các liên kết bạn thường xuyên ghé thăm nhất trong ngày/tuần.

![Hình ảnh: Bảng thống kê Analytics Dashboard](images/zero-bookmark/analytics_dashboard.png)  
*(📸 Mô tả ảnh cần chụp: Màn hình Analytics Dashboard với các số liệu tổng quan, biểu đồ tròn phân bổ danh mục và danh sách Top Domains)*

---

## 14. Không gian làm việc (Workspaces)

Nếu bạn vừa sử dụng trình duyệt cho công việc, vừa cho học tập và giải trí cá nhân, tính năng **Workspaces** là trợ thủ đắc lực:
* Có sẵn các không gian mẫu: **Work** (Công việc), **Learning** (Học tập), **Design** (Thiết kế), **Personal** (Cá nhân), hoặc bạn có thể tự tạo không gian mới.
* Mỗi Workspace ghi nhớ:
  * Chế độ xem ưa thích (*View Mode*).
  * Thư mục gốc đang mở.
  * Bộ lọc thẻ (*Tags*) đang áp dụng.

![Hình ảnh: Dropdown chuyển đổi không gian làm việc Workspaces](images/zero-bookmark/workspaces_switcher.png)  
*(📸 Mô tả ảnh cần chụp: Dropdown hoặc menu chuyển đổi Workspace trên thanh công cụ hiển thị các tab Work, Learning, Design, Personal)*

---

## 15. Sao lưu, Xuất / Nhập & Đồng bộ Google Drive

Dữ liệu dấu trang là tài sản số vô giá, Zero Bookmark Manager bảo vệ dữ liệu của bạn qua nhiều phương thức:

### 1. Đồng bộ Đám mây qua Google Drive (Cloud Sync)
* Đăng nhập trực tiếp bằng tài khoản Google thông qua giao thức Chrome Identity OAuth 2.0 an toàn.
* Dữ liệu được lưu trong một tệp an toàn riêng trên Google Drive của chính bạn (quyền `drive.file` - tiện ích chỉ truy cập tệp do chính nó tạo ra).
* Hỗ trợ Sao lưu thủ công hoặc thiết lập Tự động sao lưu định kỳ.
* Chuyển đổi máy tính mới hoặc cài lại trình duyệt: Chỉ cần đăng nhập và bấm **Restore** là toàn bộ bookmark, tags, notes lập tức trở lại.

![Hình ảnh: Cửa sổ đồng bộ Google Drive](images/zero-bookmark/google_drive_sync.png)  
*(📸 Mô tả ảnh cần chụp: Cửa sổ Sync Settings hiển thị trạng thái kết nối tài khoản Google Drive, ngày giờ sao lưu gần nhất và hai nút "Backup Now" / "Restore")*

### 2. Xuất dữ liệu (Export)
* **JSON (Khuyên dùng):** Xuất toàn vẹn 100% dữ liệu: thư mục, liên kết, số lượt truy cập, ngày tạo, thẻ tag, ghi chú Markdown, lịch hẹn báo lại.
* **HTML (Chuẩn Netscape):** Định dạng tương thích tiêu chuẩn với tất cả trình duyệt web khác (Chrome, Edge, Firefox, Safari, Brave, Opera).
* **CSV:** Phù hợp nếu bạn muốn mở bằng Microsoft Excel hoặc Google Sheets để phân tích bảng biểu.

### 3. Nhập dữ liệu (Import)
* Nhập từ tệp JSON sao lưu hoặc tệp HTML xuất từ trình duyệt khác.
* **Tự động phát hiện trùng lặp:** Hệ thống sẽ hỏi bạn muốn bỏ qua các link đã có sẵn hay cập nhật thêm metadata mới.

![Hình ảnh: Hộp thoại xuất nhập dữ liệu Export / Import](images/zero-bookmark/export_import_dialog.png)  
*(📸 Mô tả ảnh cần chụp: Hộp thoại Export/Import hiển thị các lựa chọn định dạng tệp JSON, HTML, CSV kèm nút tải xuống và khu vực kéo thả tệp)*

---

## 16. Tùy chỉnh Giao diện, Phông chữ & Ngôn ngữ

Vào biểu tượng **Cài đặt (Settings)** để biến đổi tiện ích theo phong cách riêng của bạn:
* **Bộ sưu tập Theme phong phú:**
  * *Sáng / Tối:* Light, Dark, System (tự động theo hệ điều hành).
  * *Chủ đề lập trình viên nổi tiếng:* Dracula, Tokyo Night, Nord, SynthWave 84, Gruvbox, Catppuccin, Night Owl, GitHub Blue.
  * *Chủ đề lễ hội:* Chủ đề Tết truyền thống.
* **Phông chữ tùy chọn:** Hỗ trợ đổi font chữ hệ thống sang các font hiện đại hoặc Nerd Fonts chuyên biệt cho dân IT.
* **Nguồn lấy biểu tượng trang (Favicon Provider):** Tùy chọn nguồn tải icon: Google Favicons, DuckDuckGo Favicons, hoặc Tự động (Auto).
* **Gói ngôn ngữ tùy chỉnh (Custom i18n):** Mặc định hỗ trợ Tiếng Việt và Tiếng Anh. Bạn có thể tải file ngôn ngữ mẫu JSON, dùng AI dịch sang bất kỳ ngôn ngữ nào và tải lên để áp dụng ngay lập tức.

![Hình ảnh: Bảng màu và các theme phong phú trong Cài đặt](images/zero-bookmark/themes_palette.png)  
*(📸 Mô tả ảnh cần chụp: Bảng chọn theme trong Cài đặt hoặc ảnh ghép minh họa các theme tiêu biểu: Tokyo Night, Dracula, Nord, Dark Mode và Light Mode)*

---

## 17. Giải đáp thắc mắc thường gặp (FAQ)

### Q1: Dữ liệu của tôi có bị gửi lên máy chủ của bên thứ ba không?
> **Trả lời:** Hoàn toàn **KHÔNG**. Zero Bookmark Manager hoạt động theo phương châm bảo mật *Local-First*. Toàn bộ bookmark, thẻ tag và ghi chú được lưu trữ trực tiếp trong bộ nhớ cục bộ của trình duyệt (`chrome.storage.local`). Khi bạn dùng tính năng đồng bộ Google Drive, dữ liệu truyền thẳng giữa máy bạn và tài khoản Google cá nhân của bạn. Khi dùng AI, yêu cầu chỉ gửi trực tiếp đến API Provider mà bạn cung cấp chìa khóa (API Key).

### Q2: Tôi có bị mất bookmark khi gỡ cài đặt tiện ích không?
> **Trả lời:** Các bookmark chính của bạn vẫn nằm nguyên vẹn trong hệ thống bookmark chuẩn của Chrome. Tuy nhiên, các metadata mở rộng (như thẻ Tags riêng, ghi chú Markdown, lịch hẹn Snooze) được lưu trong tiện ích. Vì vậy, trước khi gỡ hoặc đổi máy tính, bạn hãy vào mục Export để tải về 1 bản sao lưu `.json` hoặc bấm Backup lên Google Drive.

### Q3: Tính năng Wayback Machine hoạt động như thế nào?
> **Trả lời:** Khi tiện ích phát hiện một link bị chết (lỗi 404 hoặc website đã ngừng hoạt động), nút **Wayback Machine** sẽ xuất hiện. Khi nhấn vào, tiện ích sẽ tự động tìm kiếm phiên bản chụp lại (snapshot) gần nhất của trang web đó trên cơ sở dữ liệu `archive.org`, giúp bạn đọc lại nội dung bài viết ngay cả khi website gốc đã biến mất vĩnh viễn.

### Q4: Làm sao để mở nhanh Side Panel mà không cần nhấn chuột?
> **Trả lời:** Bạn có thể vào phần cài đặt của Quick Save, chuyển mục **Default Click Action** thành **Side Panel**. Khi đó, chỉ cần nhấp icon hoặc bấm phím tắt là thanh bên sẽ trượt ra ngay lập tức.

---

> 💌 **Hỗ trợ & Góp ý:**  
> Chúc bạn có trải nghiệm quản lý tri thức và dấu trang thật hiệu quả cùng Zero Bookmark Manager! Nếu bạn gặp vấn đề hoặc có đề xuất tính năng mới, hãy gửi phản hồi về email: [thientran01345@icloud.com](mailto:thientran01345@icloud.com).
