Vietboost documentation

Gom nội dung cần xem lại, ngay trong trình duyệt

Vietboost là extension Chrome để lưu trang, media và ghi chú thành một Thư viện cá nhân; quét/tải media là công cụ bổ trợ khi bạn cần.

Extension chạy tại máy của bạn. Popup và side panel ưu tiên tab Gom nội dung: lưu URL, media đã quét và ghi chú để quay lại đúng ngữ cảnh.

Website quản lý tài khoản, thiết bị, quyền sử dụng, VIP và Thư viện cloud. Một tài khoản được liên kết an toàn với các extension của bạn.

• Đăng nhập một lần để mở Inbox cục bộ trong trình duyệt.
• Gom link, media và ghi chú; mở lại nguồn chỉ với một chạm.
• VIP thêm bộ sưu tập, nhãn, trạng thái xem sau và đồng bộ Thư viện đa thiết bị.
• AI VIP được VietBoost xác thực và xử lý qua máy chủ.

Inbox trước, Thư viện khi bạn cần đi xa hơn

Đăng nhập để lưu nội dung cục bộ. VIP biến Inbox thành kho tham khảo có bộ sưu tập và bản sao trong tài khoản VietBoost.

• User: Inbox local-first, tối đa 10 link, 10 media và 10 ghi chú trong extension.
• VIP: Bộ sưu tập, nhãn, trạng thái xem lại, ghim và đồng bộ cloud đa thiết bị.
• Admin: luôn được mở khóa để vận hành và kiểm thử.
• Xóa một mục sẽ được ghi nhận khi đồng bộ tiếp theo; không có thao tác tải lại trang nào tự xóa dữ liệu.

1. 01

   Lưu nhanh

   Mở tab Gom nội dung trong popup hoặc side panel, rồi chọn Lưu trang đang xem. Link được chuẩn hóa để tránh lưu trùng do URL theo dõi.

2. 02

   Bổ sung ngữ cảnh

   Tạo ghi chú nhanh hoặc lưu kết quả quét media. Mỗi mục giữ nền tảng, thời điểm lưu và URL nguồn để bạn mở lại đúng nội dung.

3. 03

   Gom theo mục đích

   VIP có thể tạo Bộ sưu tập, gắn nhãn, ghim và đưa mục vào Xem sau, Đang dùng hoặc Hoàn tất.

4. 04

   Đồng bộ có chủ đích

   VIP chọn Đồng bộ để sao lưu link, metadata và ghi chú vào tài khoản. VietBoost không tự upload file media gốc.

Cài extension và liên kết tài khoản

Guest có thể tải media Rednote được hỗ trợ; đăng nhập để dùng các nền tảng và tính năng tải còn lại.

1. 01

   Tải bản Chrome mới nhất

   Mở trang tải extension, tải file ZIP hoặc bản phát hành được cung cấp, sau đó giải nén vào một thư mục riêng.

2. 02

   Mở Chrome Extensions

   Truy cập chrome://extensions, bật Developer mode và chọn Load unpacked. Trỏ tới thư mục chứa manifest.json.

3. 03

   Ghim Vietboost

   Nhấn biểu tượng puzzle trên thanh công cụ, ghim extension và mở popup trên một trang social được hỗ trợ.

4. 04

   Đăng nhập để đồng bộ

   Trong popup chọn Đồng bộ tài khoản web. Sau khi hoàn tất PKCE login, quyền download được cập nhật tự động.

chrome://extensions
Developer mode: ON
Load unpacked → thư mục có manifest.json

Quét, chọn và tải media

Extension giữ toàn bộ tiến trình trong hàng đợi để bạn có thể theo dõi, hủy hoặc thử lại từng file.

• Ảnh có thể lưu nguyên bản, PNG hoặc JPG theo cài đặt.
• Video HLS được remux local khi source cho phép; không upload media lên server.
• Tên file chứa nền tảng, author, post id và index để tránh nhầm lẫn.
• Chỉ download thành công mới được tính vào thống kê hôm nay.

1. 01

   Mở đúng bài viết

   Đi tới bài viết hoặc trang media trên nền tảng được hỗ trợ. Một trang listing có thể cần mở từng item để lấy source chất lượng tốt nhất.

2. 02

   Nhấn Quét bài viết

   Popup hoặc side panel sẽ hiển thị số media phát hiện được và logo nền tảng hiện tại.

3. 03

   Chọn cách tải

   Tải từng media để kiểm soát file, hoặc Tải tất cả để đưa các item hợp lệ vào queue. Tải hàng loạt yêu cầu tài khoản đã đăng nhập.

4. 04

   Theo dõi tiến trình

   Toast và side panel hiển thị resolving, converting, remuxing, downloading, completed hoặc failed. URL hết hạn sẽ được resolve lại một lần trước khi retry.

Danh sách social được cập nhật từ server

Danh sách dưới đây dùng chung nguồn dữ liệu với extension. Admin có thể tạm dừng một adapter mà không cần phát hành bản mới.

Rednote

Ảnh và video từ Xiaohongshu

TikTok

Video và media trong bài đăng

Instagram

Ảnh, carousel và video

YouTube

Video và thumbnail phù hợp

Facebook

Media công khai trên bài đăng

X

Ảnh và video từ bài đăng công khai

Pinterest

Pin và media công khai

ZCOOL

Tác phẩm và media được hỗ trợ

Guest, User và VIP

Quyền được resolve ở server và đồng bộ về extension. UI không tự suy đoán quyền chỉ từ tên gói.

• Guest: tải media Rednote được hỗ trợ; đăng nhập để dùng các nền tảng và tính năng tải còn lại.
• User: mở khóa mọi tính năng download hiện tại, gồm đa nền tảng, tải hàng loạt và chất lượng source cao nhất.
• VIP: thêm AI server, streaming AI, bộ sưu tập và đồng bộ Thư viện cloud theo membership.
• Thiết bị bị ngắt liên kết sẽ mất session active ngay cả khi token cũ chưa hết hạn.

Website login
  → PKCE callback
  → Extension background
  → active installation session
  → entitlements + usage + download stats

AI local và AI server

Bạn có thể chọn trải nghiệm AI local với provider riêng hoặc dùng AI server đã được quản lý trong gói VIP.

• AI VIP: VietBoost validates membership, quota, and provider access on the server.
• AI server: request đi qua endpoint đã xác thực, yêu cầu entitlement VIP và có quota rõ ràng.
• Context menu và quick action đều dùng cùng một gate ở background service worker.
• Prompt, URL và nội dung nhạy cảm không được ghi vào telemetry.

Dịch · Tóm tắt · Viết lại · Trích xuất ý chính
AI local: provider + model của bạn
AI server: Vietboost VIP

Xem social được dùng nhiều nhất hôm nay

Thống kê được tính từ những lượt download hoàn tất và gắn với tài khoản đã đăng nhập trên thiết bị active.

1. 01

   Trong extension

   Mở popup → Tài khoản → Download hôm nay → Xem. Modal hiển thị tổng lượt tải, social đứng đầu, logo và thanh xếp hạng.

2. 02

   Trên website

   Mở Tài khoản → Tổng quan hoặc Tài khoản → Sử dụng. Bảng Download hôm nay dùng cùng dữ liệu với extension.

3. 03

   Hiểu số liệu

   Chỉ trạng thái completed được tính. Download failed, cancelled, guest hoặc token đã bị ngắt liên kết không làm tăng thống kê tài khoản.

Dữ liệu nào được xử lý

Vietboost ưu tiên xử lý local. Telemetry chỉ ghi các sự kiện sản phẩm tối thiểu và được sanitize ở server.

• Content script không truy cập access token hoặc refresh token.
• Media URL, prompt, username và dữ liệu bí mật không được lưu trong telemetry.
• Download stats chỉ lưu event thành công, nền tảng, thời điểm và userId đã xác thực.
• Thư viện cloud chỉ lưu nội dung bạn đồng ý đồng bộ: URL, metadata, nhãn và ghi chú; không tự upload file media nguồn.
• Bạn có thể xem, xuất hoặc yêu cầu xóa dữ liệu trong khu vực tài khoản.

Các endpoint dành cho extension

API extension là boundary server. Client không được tự quyết định identity, entitlement, quota hoặc trạng thái thiết bị.

• Access token chỉ được gắn ở background service worker.
• Mọi route authenticated kiểm tra active installation session.
• CORS chỉ mở cho extension flow; website dùng server-side session riêng.
• Không gửi token, URL hoặc prompt qua content script.

POST /api/extension/guest/bootstrap
POST /api/extension/heartbeat
GET  /api/extension/config
GET  /api/extension/platforms

POST /api/extension/auth/exchange
POST /api/extension/auth/refresh
GET  /api/extension/me
GET  /api/extension/entitlements
GET  /api/extension/usage
GET  /api/extension/download-stats
GET  /api/extension/library (VIP)
POST /api/extension/library (VIP sync)

fetch('/api/extension/download-stats', {
  headers: { Authorization: `Bearer ${accessToken}` }
})

Khi extension không tải được

Làm theo checklist này trước khi gửi yêu cầu hỗ trợ. Hầu hết lỗi nằm ở session, trang chưa tải đủ hoặc source đã hết hạn.

• Nếu social đang bảo trì, hãy kiểm tra Supported platforms trên website.
• Nếu chỉ video HLS lỗi, thử source khác hoặc bật remux trong cài đặt.
• Nếu quyền biến mất đột ngột, vào Tài khoản → Thiết bị để liên kết lại.

1. 01

   Kiểm tra session

   Mở popup và xác nhận email hiển thị ở Tài khoản. Nếu hiện Chưa đăng nhập, thực hiện lại Đồng bộ tài khoản web.

2. 02

   Tải lại trang

   Một số trang cần F5 sau khi cài hoặc cập nhật extension để content script được nạp lại.

3. 03

   Mở side panel

   Dùng side panel để xem queue chi tiết. Item failed có thể Retry sau khi source được resolve lại.

4. 04

   Kiểm tra quyền Chrome

   Đảm bảo extension được phép chạy trên domain hiện tại và thư mục download vẫn có quyền ghi.

Câu hỏi thường gặp

Các câu hỏi phổ biến về tài khoản, download, AI và dữ liệu.

• Tôi có cần VIP để tải không? Không. Tài khoản đã đăng nhập dùng được toàn bộ download hiện tại; VIP dành cho AI server và quyền premium.
• Tôi có cần VIP để lưu lại xem sau không? Không. Sau khi đăng nhập, bạn có Inbox cục bộ trong trình duyệt. VIP mở bộ sưu tập và đồng bộ Thư viện lên tài khoản.
• Tôi có thể dùng nhiều máy không? Có. Mỗi extension installation được liên kết với một tài khoản và có thể quản lý trong Devices.
• Download stats có lưu file không? Không. Chỉ event thành công và nền tảng được ghi để hiển thị số liệu.
• Tại sao dữ liệu hôm nay chưa hiện? Stats chỉ tính completed sau khi extension gửi event với session active.
• Tôi cần hỗ trợ thêm ở đâu? Gửi thông tin phiên bản, nền tảng, trạng thái account và mã lỗi qua Support.