SurfSense/_bmad-output/user-guide.md

# Hướng Dẫn Sử Dụng SurfSense

**Dành cho Người Dùng Cuối**

---

## 📖 Giới Thiệu

SurfSense là nền tảng tìm kiếm và quản lý kiến thức được hỗ trợ bởi AI, giúp bạn:
- 🔍 Tìm kiếm thông tin nhanh chóng từ lịch sử duyệt web
- 💾 Lưu trữ và tổ chức kiến thức cá nhân
- 🤖 Trò chuyện với AI để nghiên cứu sâu
- 🌐 Capture nội dung từ bất kỳ trang web nào

---

## 🚀 Bắt Đầu Nhanh

### Bước 1: Cài Đặt Browser Extension

1. **Tải Extension:**
   - Truy cập Chrome Web Store (hoặc store tương ứng với trình duyệt của bạn)
   - Tìm kiếm "SurfSense"
   - Click **Add to Chrome/Browser**

2. **Kích Hoạt Extension:**
   - Click vào icon SurfSense trên thanh công cụ trình duyệt
   - Đăng nhập bằng tài khoản của bạn
   - Cấp quyền truy cập cần thiết

3. **Xác Nhận Cài Đặt:**
   - Icon SurfSense sẽ xuất hiện trên thanh công cụ
   - Bạn sẽ thấy thông báo "Connected" khi extension hoạt động

### Bước 2: Truy Cập Web Dashboard

1. Mở trình duyệt và truy cập: `https://app.surfsense.ai` (hoặc URL do admin cung cấp)
2. Đăng nhập bằng tài khoản đã đăng ký
3. Bạn sẽ thấy Dashboard chính với các tính năng:
   - **Search Bar** - Tìm kiếm nhanh
   - **Recent Activity** - Hoạt động gần đây
   - **Collections** - Bộ sưu tập kiến thức
   - **AI Chat** - Trò chuyện với AI

---

## 🔍 Tính Năng Chính

### 1. Capture Nội Dung Từ Web

**Cách sử dụng Extension để lưu nội dung:**

1. **Capture Toàn Bộ Trang:**
   - Truy cập trang web bạn muốn lưu
   - Click icon SurfSense trên thanh công cụ
   - Chọn **"Capture This Page"**
   - Nội dung sẽ được lưu tự động

2. **Capture Đoạn Văn Bản Cụ Thể:**
   - Bôi đen văn bản bạn muốn lưu
   - Click chuột phải → **"Save to SurfSense"**
   - Hoặc sử dụng shortcut: `Ctrl/Cmd + Shift + S`

3. **Thêm Tags và Notes:**
   - Sau khi capture, popup sẽ hiện ra
   - Thêm tags (ví dụ: `research`, `work`, `personal`)
   - Thêm ghi chú cá nhân nếu cần
   - Click **"Save"**

**💡 Mẹo:** Extension tự động trích xuất metadata (title, URL, timestamp) để bạn dễ tìm kiếm sau này.

---

### 2. Tìm Kiếm Kiến Thức

**Trên Web Dashboard:**

1. **Tìm Kiếm Cơ Bản:**
   - Nhập từ khóa vào Search Bar
   - Kết quả hiển thị theo độ liên quan (relevance)
   - Click vào kết quả để xem chi tiết

2. **Tìm Kiếm Nâng Cao (Advanced Search):**
   - Click icon **Filter** bên cạnh Search Bar
   - Lọc theo:
     - **Date Range** - Khoảng thời gian
     - **Tags** - Nhãn đã gán
     - **Source** - Nguồn (website, PDF, note)
     - **Content Type** - Loại nội dung (article, video, image)

3. **Semantic Search (Tìm Kiếm Ngữ Nghĩa):**
   - SurfSense sử dụng AI để hiểu ý nghĩa câu hỏi
   - Ví dụ: Thay vì tìm "Python tutorial", bạn có thể hỏi:
     - *"How do I create a REST API in Python?"*
     - *"Best practices for Python async programming"*

**💡 Mẹo:** Sử dụng dấu ngoặc kép `"exact phrase"` để tìm cụm từ chính xác.

---

### 3. Quản Lý Collections (Bộ Sưu Tập)

**Tạo Collection mới:**

1. Vào **Dashboard** → Click **"Collections"** trên sidebar
2. Click **"+ New Collection"**
3. Đặt tên (ví dụ: "AI Research", "Work Projects")
4. Chọn icon và màu sắc (tùy chọn)
5. Click **"Create"**

**Thêm items vào Collection:**

- **Cách 1:** Kéo thả (drag & drop) từ search results
- **Cách 2:** Click vào item → **"Add to Collection"** → Chọn collection
- **Cách 3:** Khi capture nội dung mới, chọn collection trong popup

**Chia sẻ Collection:**

1. Mở Collection bạn muốn chia sẻ
2. Click **"Share"** ở góc trên bên phải
3. Chọn quyền truy cập:
   - **View Only** - Chỉ xem
   - **Can Edit** - Có thể chỉnh sửa
4. Copy link và gửi cho người khác

---

### 4. AI Chat

**Trò chuyện với AI về kiến thức của bạn:**

1. **Mở AI Chat:**
   - Click icon **Chat** trên sidebar
   - Hoặc sử dụng shortcut: `Ctrl/Cmd + K`

2. **Hỏi Câu Hỏi:**
   - Nhập câu hỏi vào chat box
   - Ví dụ:
     - *"Summarize all articles I saved about machine learning"*
     - *"What are the key points from my research on climate change?"*
     - *"Find contradictions in my saved articles about diet"*

3. **AI Tự Động Phân Tích:**
   - AI sẽ tìm kiếm trong toàn bộ kiến thức của bạn
   - Tổng hợp thông tin từ nhiều nguồn liên quan
   - Cung cấp câu trả lời dựa trên nội dung bạn đã lưu
   - Thời gian xử lý: 5-15 giây (tùy độ phức tạp)

4. **Xem Sources (Nguồn Tham Khảo):**
   - Mỗi câu trả lời của AI có **[1], [2], [3]** citations
   - Click vào số để xem nguồn gốc
   - Bạn có thể mở link gốc để đọc chi tiết

5. **Attach Files và Mention Documents:**
   - Click icon **📎** để đính kèm files
   - Sử dụng **@** để mention documents cụ thể trong chat
   - AI sẽ ưu tiên phân tích các documents được mention

**💡 Mẹo:** AI Chat hoạt động tốt nhất khi bạn đã lưu nhiều nội dung liên quan đến chủ đề bạn hỏi.

---

### 5. Connectors (Kết Nối Ứng Dụng Bên Ngoài)

**Mở rộng khả năng tìm kiếm với các ứng dụng bạn đang dùng:**

SurfSense cho phép bạn kết nối với **26+ ứng dụng bên ngoài** như Gmail, Google Drive, Slack, Notion, Linear, và nhiều hơn nữa. Sau khi kết nối, bạn có thể tìm kiếm thông tin từ **tất cả các ứng dụng này** ngay trong SurfSense!

**Cách kết nối:**

1. **Mở Connectors Modal:**
   - Vào **Dashboard** → Click **"Connectors"** trên sidebar
   - Hoặc trong Chat → Click icon **"⚡ Connectors"**

2. **Chọn Ứng Dụng:**
   - Bạn sẽ thấy 2 nhóm:
     - **Managed OAuth (Composio):** Google Drive, Gmail, Google Calendar
     - **Quick Connect:** Slack, Notion, Linear, Airtable, và nhiều hơn
   - Click **"Connect"** bên cạnh ứng dụng bạn muốn

3. **Xác Thực (OAuth):**
   - Bạn sẽ được chuyển đến trang đăng nhập của ứng dụng (ví dụ: Google)
   - Đăng nhập và cấp quyền **chỉ đọc** (read-only) cho SurfSense
   - SurfSense **KHÔNG** có quyền xóa hoặc chỉnh sửa dữ liệu của bạn

4. **Indexing Tự Động:**
   - Sau khi kết nối, SurfSense sẽ tự động:
     - Lấy dữ liệu từ ứng dụng (emails, files, messages, etc.)
     - Tạo index để bạn có thể tìm kiếm
     - Tự động cập nhật mỗi 60 phút (hoặc theo cấu hình)

**Ví dụ sử dụng:**

- **Kết nối Gmail:** Tìm kiếm trong emails cũ mà không cần mở Gmail
- **Kết nối Google Drive:** Tìm files và documents ngay trong SurfSense
- **Kết nối Slack:** Tìm conversations và shared files từ workspace
- **Kết nối Notion:** Tìm kiếm trong pages và databases

**Quản lý Connectors:**

- **Xem trạng thái:** Vào **Settings** → **"Connectors"** để xem danh sách
- **Ngắt kết nối:** Click **"Disconnect"** để thu hồi quyền truy cập
- **Re-index:** Click **"Re-index Now"** để cập nhật dữ liệu ngay lập tức

**🔐 Bảo mật:** 
- Connectors chỉ có quyền **đọc** (read-only)
- Dữ liệu được mã hóa khi lưu trữ
- Bạn có thể ngắt kết nối bất cứ lúc nào

**💡 Mẹo:** Kết nối các ứng dụng bạn dùng thường xuyên để có trải nghiệm tìm kiếm "all-in-one" - tìm mọi thứ ở một nơi!

> **📚 Tìm hiểu thêm:** Xem [connectors-explained.md](./connectors-explained.md) để hiểu chi tiết cách Connectors hoạt động.

---

### 6. Quick Search (Tìm Kiếm Nhanh)

**Sử dụng Extension Popup:**

1. Click icon SurfSense trên thanh công cụ
2. Nhập từ khóa vào search box trong popup
3. Kết quả hiển thị ngay lập tức (không cần mở web app)
4. Click vào kết quả để:
   - **View in SurfSense** - Mở trong web app
   - **Open Original** - Mở trang web gốc
   - **Copy Link** - Copy link

**Keyboard Shortcuts:**

- `Ctrl/Cmd + Shift + F` - Mở Quick Search
- `Enter` - Mở kết quả đầu tiên
- `↑ ↓` - Di chuyển giữa các kết quả
- `Esc` - Đóng popup

---

## ⚙️ Cài Đặt Cá Nhân

### Tùy Chỉnh Preferences

1. Vào **Dashboard** → Click avatar → **"Settings"**
2. Các tùy chọn:

**General:**
- **Language** - Ngôn ngữ giao diện (English, Tiếng Việt)
- **Theme** - Giao diện (Light, Dark, Auto)
- **Default Collection** - Collection mặc định khi capture

**Privacy:**
- **Auto-Capture** - Tự động capture trang web (On/Off)
- **Exclude Domains** - Danh sách website không capture (ví dụ: banking sites)
- **Data Retention** - Thời gian lưu trữ dữ liệu (30 days, 90 days, Forever)

**AI Settings:**
- **AI Model** - Chọn model (GPT-4, Claude, Gemini)
- **Response Style** - Phong cách trả lời (Concise, Detailed, Academic)
- **Citations** - Luôn hiển thị nguồn (On/Off)

**Notifications:**
- **Email Digest** - Nhận tóm tắt hàng tuần (On/Off)
- **Browser Notifications** - Thông báo khi có kết quả mới (On/Off)

---

## 🔐 Bảo Mật và Quyền Riêng Tư

### Dữ Liệu Của Bạn

- **Mã Hóa:** Tất cả dữ liệu được mã hóa (encryption) khi lưu trữ và truyền tải
- **Quyền Sở Hữu:** Bạn sở hữu 100% dữ liệu của mình
- **Xóa Dữ Liệu:** Bạn có thể xóa bất kỳ item hoặc toàn bộ tài khoản bất cứ lúc nào

### Quản Lý Quyền Truy Cập

1. **Xem Devices Đã Đăng Nhập:**
   - Vào **Settings** → **"Security"**
   - Xem danh sách devices đang active
   - Click **"Sign Out"** để đăng xuất device cụ thể

2. **Two-Factor Authentication (2FA):**
   - Vào **Settings** → **"Security"** → **"Enable 2FA"**
   - Quét QR code bằng app authenticator (Google Authenticator, Authy)
   - Nhập mã xác nhận

---

## 🛠️ Troubleshooting (Xử Lý Sự Cố)

### Extension Không Hoạt Động

**Triệu chứng:** Icon SurfSense không hiển thị hoặc không capture được nội dung.

**Giải pháp:**

1. **Kiểm tra Extension đã được enable:**
   - Vào `chrome://extensions/` (hoặc tương đương)
   - Tìm "SurfSense"
   - Đảm bảo toggle **ON**

2. **Refresh Extension:**
   - Click icon SurfSense → **"Refresh"**
   - Hoặc reload trang web (`F5`)

3. **Kiểm tra quyền truy cập:**
   - Vào `chrome://extensions/` → SurfSense → **"Details"**
   - Đảm bảo **"Site access"** = "On all sites"

4. **Reinstall Extension:**
   - Gỡ extension cũ
   - Cài đặt lại từ store

### Tìm Kiếm Không Ra Kết Quả

**Nguyên nhân có thể:**

- Từ khóa quá cụ thể hoặc sai chính tả
- Nội dung chưa được index (đợi vài phút sau khi capture)
- Filters quá chặt

**Giải pháp:**

1. Thử từ khóa đơn giản hơn
2. Tắt tất cả filters
3. Kiểm tra **"All Content"** thay vì chỉ một collection
4. Sử dụng Semantic Search (hỏi bằng câu tự nhiên)

### AI Chat Không Phản Hồi

**Triệu chứng:** Chat loading mãi không có kết quả.

**Giải pháp:**

1. **Kiểm tra kết nối internet**
2. **Refresh trang web** (`F5`)
3. **Thử câu hỏi đơn giản hơn** (tránh câu quá dài hoặc phức tạp)
4. **Kiểm tra AI Model settings:**
   - Vào **Settings** → **"AI Settings"**
   - Thử đổi sang model khác (ví dụ: từ GPT-4 sang Claude)

### Sync Issues (Vấn Đề Đồng Bộ)

**Triệu chứng:** Nội dung capture trên extension không hiển thị trên web app.

**Giải pháp:**

1. **Đợi vài giây** (sync thường mất 2-5 giây)
2. **Refresh web app** (`F5`)
3. **Kiểm tra trạng thái sync:**
   - Click icon SurfSense → Xem **"Sync Status"**
   - Nếu **"Offline"**, kiểm tra internet
   - Nếu **"Error"**, click **"Retry Sync"**

---

## 📞 Hỗ Trợ

### Liên Hệ Support Team

- **Email:** support@surfsense.ai
- **Live Chat:** Click icon **"Help"** ở góc dưới bên phải Dashboard
- **Documentation:** [https://docs.surfsense.ai](https://docs.surfsense.ai)
- **Community Forum:** [https://community.surfsense.ai](https://community.surfsense.ai)

### Báo Lỗi (Bug Report)

1. Vào **Settings** → **"Help & Feedback"** → **"Report a Bug"**
2. Mô tả vấn đề:
   - Bạn đang làm gì khi lỗi xảy ra?
   - Kết quả mong đợi vs kết quả thực tế?
   - Screenshot (nếu có)
3. Click **"Submit"**
4. Team sẽ phản hồi trong vòng 24 giờ

---

## 💡 Tips & Best Practices

### Tối Ưu Hóa Trải Nghiệm

1. **Sử dụng Tags Nhất Quán:**
   - Tạo danh sách tags cố định (ví dụ: `work`, `personal`, `research`)
   - Tránh tạo quá nhiều tags tương tự (`ai`, `AI`, `artificial-intelligence`)

2. **Organize Collections Theo Dự Án:**
   - Mỗi dự án/chủ đề = 1 collection
   - Sử dụng sub-collections cho các chủ đề con

3. **Review Định Kỳ:**
   - Mỗi tuần, xem lại **Recent Activity**
   - Xóa nội dung không còn cần thiết
   - Re-organize items vào collections phù hợp

4. **Tận Dụng AI Chat:**
   - Thay vì tìm kiếm thủ công, hỏi AI:
     - *"What did I learn about X last month?"*
     - *"Summarize my research on Y"*

5. **Backup Quan Trọng:**
   - Vào **Settings** → **"Data Export"**
   - Click **"Export All Data"** (format: JSON hoặc Markdown)
   - Lưu file backup vào cloud storage (Google Drive, Dropbox)

---

## 🎓 Học Thêm

### Video Tutorials

- [Getting Started with SurfSense (5 phút)](https://youtube.com/surfsense/getting-started)
- [Advanced Search Techniques (10 phút)](https://youtube.com/surfsense/advanced-search)
- [Using AI Chat Effectively (15 phút)](https://youtube.com/surfsense/ai-chat)


### Use Cases

**1. Sinh Viên/Nghiên Cứu Viên:**
- Lưu papers, articles từ Google Scholar
- Tổ chức theo môn học/chủ đề
- Sử dụng AI để tóm tắt và so sánh nghiên cứu

**2. Developers:**
- Save Stack Overflow answers, documentation
- Organize theo ngôn ngữ/framework
- Quick search khi cần reference

**3. Content Creators:**
- Lưu inspiration từ web
- Organize theo campaign/project
- AI giúp brainstorm ideas từ saved content

---

**Cập nhật lần cuối:** 2026-01-31  
**Phiên bản tài liệu:** 1.0  
**Áp dụng cho:** SurfSense v2.0+