JR SSSY Smart Service Supporting Youtube
Tài liệu kỹ thuật

Hướng dẫn vận hành hệ thống

Tài liệu tham chiếu đầy đủ cho từng module — từ xác thực, bảng điều khiển, YouTube Studio đến báo cáo doanh thu và quản trị.

v4.11.7 Chrome Extension Studio + youtube.com

Cài đặt & đăng nhập

Extension yêu cầu đăng nhập tài khoản JR SSSY trước khi dùng. Sau khi cài, mở popup từ biểu tượng trên thanh công cụ Chrome.

  • 1. Cài extensionBấm Cài đặt Extension trên trang chủ hoặc tìm JrSSSY - Smart Service Supporting Youtube trên Chrome Web Store. Sau khi cài, ghim icon để truy cập nhanh.
  • 2. Đăng nhậpNhập tên đăng nhập và mật khẩu. Bật Lưu đăng nhập nếu muốn giữ phiên trên máy cá nhân.
  • 3. Tạo tài khoản mớiChọn Tạo tài khoản mới → điền họ tên, email, username, mật khẩu → Gửi mã xác nhận Email → nhập OTP 6 số → xác nhận.
  • 4. Mở YouTube StudioTruy cập studio.youtube.com bằng tài khoản YouTube đã liên kết. Hầu hết tính năng Studio chỉ hoạt động khi bạn đã đăng nhập extension.
Quyền USER / PRO / ULTRA có thể tự nâng cấp qua trang Nâng cấp (đăng nhập trên web → nạp ví → mua gói). Extension tự đồng bộ quyền khi mở popup hoặc trong ~45 giây qua background. Admin vẫn có thể cấp quyền thủ công.

Popup & trang chủ

Popup là trung tâm điều khiển: mở công cụ AI, vào Doanh thu, Cài đặt và các module quản trị.

  • Trang chủ (Main)Hiển thị các ô lớn: Sáng tạo Tiêu đề, MJ Prompt Helper, Doanh thu (nếu được cấp quyền), Cài đặt.
  • Nút quay lạiBiểu tượng ← ở header đưa bạn về trang trước trong popup.
  • Ẩn/hiện theo quyềnCác nút có class perm-check chỉ hiện khi admin bật quyền cho vai trò của bạn (ví dụ title_gen, mj_helper, api_manage).
  • Thông tin người dùngVào Cài đặt → Thông tin người dùng để xem/chỉnh avatar và thông tin cá nhân.

Sáng tạo Tiêu đề

Công cụ AI gợi ý nhiều tiêu đề YouTube từ chủ đề bạn nhập — hữu ích khi brainstorm trước khi upload.

  • Mở công cụPopup → Sáng tạo Tiêu đề (cần quyền title_gen).
  • Nhập chủ đềGõ ý tưởng video. Chọn Số lượng tiêu đề muốn tạo.
  • Tạo & sao chépBấm Tạo Tiêu đề. Kết quả hiện trong khung bên dưới — chọn dòng phù hợp để copy sang Studio.
Cần API Gemini hợp lệ (xem mục Quản lý API Key). Nếu báo lỗi quota, thử key dự phòng hoặc đợi reset quota.

MJ Prompt Helper

Hỗ trợ viết prompt Midjourney: viết lại, phân tích ảnh tham chiếu, hoặc dùng trực tiếp với tham số tùy chỉnh.

  • Chế độViết lại Prompt, Phân tích Ảnh, hoặc Sử dụng Trực tiếp với tham số MJ.
  • Ảnh tham khảoDùng Upload hoặc Paste từ clipboard.
  • Model & số lượngChọn model Gemini, số prompt (1–5), và Đuôi Tham số nếu có trong cài đặt MJ.
  • Cài đặt MJ HelperPopup → Cài đặt → Cài đặt MJ Helper.

Dịch YouTube Studio

Extension tích hợp trên trang chỉnh sửa video và trang Dịch (Translations) trong YouTube Studio.

  • Trang chỉnh sửa videoMở studio.youtube.com/video/…/edit. Công cụ dịch xuất hiện trong các trường tiêu đề, mô tả, thẻ.
  • Trang TranslationsĐường dẫn …/edit/translations — dịch hàng loạt metadata sang ngôn ngữ đích.
  • Tự động dịch khi mởBật trong Cài đặt → Tự động dịch khi mở.
  • Bộ nhớ đệmBật bộ nhớ đệm dịch lưu bản dịch đã tạo, giảm gọi API lặp lại.

Trợ lý Mô tả video

Hỗ trợ soạn và tối ưu phần mô tả ngay trong giao diện chỉnh sửa video Studio.

  • Kích hoạtMở trang edit video (không phải tab Translations).
  • Sử dụngNhập gợi ý hoặc dùng AI để mở rộng/chuẩn hóa mô tả.
  • Phạm viChỉ active trong /video/*/edit, không chạy trên dashboard Studio.

AI Reply bình luận

Tự động thêm nút trả lời AI trong khu vực bình luận YouTube Studio.

  • Điều kiệnCần quyền comment_helper (thường gói PRO trở lên).
  • Luồng dùngStudio → Comments → chọn comment → bấm AI Reply → chỉnh sửa → gửi.
  • Ngôn ngữExtension ưu tiên trả lời đúng ngôn ngữ comment.
Luôn duyệt nội dung trước khi gửi. AI chỉ gợi ý — bạn chịu trách nhiệm nội dung đăng lên kênh.

Dashboard Doanh thu

Bảng tổng hợp doanh thu ước tính theo kênh/tháng, đồng bộ từ YouTube Studio và server JR SSSY.

  • Mở dashboardPopup → Doanh thu hoặc logo doanh thu trên header Studio.
  • Thu thập dữ liệuScrape số liệu khi duyệt Analytics trong Studio.
  • Đồng bộ serverNút pull lấy snapshot từ Cloudflare Worker.
  • Bảng & lọcXem theo tháng, tổng team, tăng trưởng. Admin/leader có chip lọc leader/thành viên.
  • Ngôn ngữChọn English trong Cài đặt → mở lại Revenue để UI hiển thị đúng locale.
Cột / vùngÝ nghĩa
Chủ kênh / TeamAi sở hữu hoặc thuộc nhóm leader nào
Thông tin kênhTên, ID, trạng thái đồng bộ
Các cột thángDoanh thu ước tính từng tháng (từ 07/2025)
Tăng trưởngSo sánh % giữa tháng bạn chọn

Leader, nhập tay & xem team

Dành cho leader/admin: quản lý doanh thu cả nhóm, bổ sung số tháng chưa scrape được.

  • Tự mở leaderAdmin mở Revenue có thể tự vào view leader đã lưu.
  • Đổi leaderChọn chip leader khác → pull dữ liệu server theo leader đó.
  • Nhập tay theo thángManual chỉ gap-fill — không ghi đè tháng đã có doanh thu scrape.
  • Đồng bộ manualLưu/đồng bộ lên server sau khi nhập tay.
  • ExportXuất CSV để báo cáo nội bộ.
Nếu dữ liệu kênh biến mất sau đổi leader: reload extension, mở lại Revenue và pull lại từ server.

YouTube công khai (youtube.com)

Các script chạy trên trang xem video, kết quả tìm kiếm và trang kênh công khai.

  • Channel HelperHỗ trợ phân tích/thao tác trên trang kênh.
  • Keyword HelperGợi ý và xử lý từ khóa khi nghiên cứu niche.
  • Keyword InspectorTrên /results? — inspect từ khóa ngay trang tìm kiếm.
  • Thumbnail InjectorThumbnail bổ sung trên trang watch.
  • VidIQ IntegrationTương thích với extension VidIQ nếu đã cài.

Cài đặt & ngôn ngữ

Popup → Cài đặt: profile, ngôn ngữ UI, cache dịch, theme và lối tắt quản trị.

  • Ngôn ngữTiếng Việt / English — áp dụng popup và nhiều module.
  • Tự động dịch & cacheHai toggle riêng; admin có thể khóa theo vai trò.
  • Tùy chỉnh giao diệnChế độ Tối/Sáng/Theo hệ thống — mọi tài khoản đều dùng được (nút Cài đặt góc màn hình / popup).
  • Đăng xuấtXóa phiên local khi đổi máy hoặc tài khoản.

Quản lý API Key

Smart API Manager — lưu nhiều key Gemini & YouTube, xoay vòng và fallback.

  • MởCài đặt → Quản lý API Key (api_manage).
  • GeminiThêm từng dòng một API key. Hệ thống thử key tiếp theo khi hết quota.
  • YouTube Data APIDùng cho tính năng gọi YouTube API chính thức.
Không chia sẻ API key công khai.

Admin & phân quyền

Chỉ admin/ULTRA: cấu hình quyền theo nhóm và quản lý user.

  • Cấu hình quyềnBật/tắt capability cho USER, PRO, ULTRA.
  • Quản lý UserThêm user, đổi vai trò, refresh danh sách từ server.
Vai tròĐiển hình
USERXem cơ bản, một số công cụ tắt
PROAI Reply, MJ, title gen, API (tùy cấu hình)
ULTRA / AdminToàn quyền + quản trị user & revenue team

Ngôn ngữ & Quảng cáo (ANS)

Module ANS 3.0 nhúng trong popup — quản lý ngôn ngữ metadata và quảng cáo.

  • MởCài đặt → Ngôn Ngữ và Quảng Cáo.
  • StudioScript ANS cũng chạy trên Studio (ngoài trang edit video).

Xử lý sự cố thường gặp

Checklist nhanh khi extension không hoạt động như mong đợi.

  • Không thấy nút / tính năng khóaKiểm tra đăng nhập và quyền vai trò.
  • Lỗi AI / dịchKiểm tra Gemini API key, quota, mạng.
  • Revenue thiếu sốScrape lại từ Studio Analytics → Pull trên Revenue.
  • English vẫn tiếng ViệtĐổi ngôn ngữ → đóng mở lại tab Revenue/popup.
  • Sau cập nhậtchrome://extensions → Reload JrSSSY.