TuanBong Chrome — bản 0.4.4

CÀI ĐẶT / CẬP NHẬT (Google Chrome trên máy tính)
1. Giải nén ZIP vào thư mục cố định tuanbong-chrome.
2. Đã cài bản cũ: chép TOÀN BỘ tệp mới vào đúng thư mục tiện ích cũ, gồm cả background.js và youtube.js. Không chỉ chép mỗi manifest.json.
3. Mở chrome://extensions → bật Developer mode / Chế độ nhà phát triển.
4. Nếu cập nhật: bấm Reload / Tải lại trên thẻ TuanBong. Nếu Chrome yêu cầu, đồng ý quyền chạy trên YouTube và trang TuanBong. Nếu cài lần đầu: Load unpacked / Tải tiện ích đã giải nén → chọn thư mục chứa manifest.json.
5. Tải lại tab YouTube đang mở để nút mới xuất hiện. Nếu có hai bản TuanBong, chỉ giữ bật bản mới.

KẾT NỐI WEBSITE 0.4.4
- Trang học tự kiểm tra tiện ích và chỉ mở công cụ khi nhận diện được kết nối.
- Chưa cài hoặc chưa kết nối: hiện hướng dẫn và nút tải.
- Cài / cập nhật xong: tải lại trang học và tab YouTube. Có thể bấm Tôi đã cài — Kiểm tra lại.
- Không thêm quyền truy cập website nào; vẫn chỉ YouTube và trang học TuanBong.

TỐI ƯU 0.4.4
- Nhận diện tiêu đề phân cảnh trong bản chép lời mới của YouTube, tránh cuộn toàn bộ khi phụ đề đã tải đủ.
- Cuộn lấy phụ đề dài theo nhịp 25ms khi YouTube đã hiển thị vùng tiếp theo, thay cho chờ cố định 100ms.
- Chỉ cuộn tiếp trong phạm vi phụ đề đã đọc, chờ khi YouTube dựng dòng chậm để tránh bỏ sót.
- Tốc độ thực tế vẫn tùy YouTube và máy. Không rút ngắn thời gian chờ phụ đề tải đủ.

CÁC TỐI ƯU TRƯỚC
- Phụ đề dài: chỉ xử lý lại các dòng mới hoặc thay đổi trong mỗi lần lấy.
- Giảm sao chép nội dung và đo bố cục lặp lại. Không tự tải trước khi bấm học.
- Có kiểm thử 4.500 dòng mô phỏng 75 phút; đây không phải đo tốc độ trên podcast thật.

CÁC SỬA LỖI TRƯỚC
- Kiểm tra địa chỉ hiện tại của tab khi YouTube chuyển video trong cùng trang.
- Chờ thông tin video mới ổn định thay vì báo lỗi ngay.
- Thông báo lỗi hiện ngoài thanh nút và có trạng thái Thử lại.

CÁC SỬA LỖI TRƯỚC
- Loại nhãn thời gian ẩn như 0 giây / 9 giây khỏi nội dung lời thoại.
- Bài đã nhập bị lỗi lặp lại được làm sạch khi mở lại trên trang học mới.
- Giảm thời gian chờ và số lần cuộn; nhận biết danh sách đầy đủ trong khung có tiêu đề/chân trang.

CÁC SỬA LỖI TRƯỚC
- Nhận diện khung Trong video này / Bản chép lời có phân cảnh.
- Hủy yêu cầu khi đổi video và bật lại nút nếu hết thời gian chờ.
- Trang học nhận đúng mã video mới; không tự mở bài cũ trong lúc chờ phụ đề.

TỐI ƯU TỐC ĐỘ
- Bỏ cuộn lần lượt khi bố cục cho thấy toàn bộ các dòng đã được tải vào trang.
- Giảm thời gian chờ khi mở bản chép lời và khi chuyển gói sang bài học.
- Danh sách chỉ hiện từng phần vẫn được thu thập lần lượt. Tốc độ thực tế phụ thuộc YouTube và đường truyền.

DÙNG MỘT NÚT
1. Mở một video dạng youtube.com/watch trong Chrome.
2. Bấm “🐶 Học cùng TuanBong” bên dưới video, gần các nút thích / chia sẻ.
3. Tiện ích thử mở phần mô tả và bản chép lời, ưu tiên tiếng Anh khi YouTube hiện lựa chọn đó, rồi đọc các dòng có mốc thời gian.
4. Trang học mở ở tab mới, nạp video và phụ đề tự động. Video ở tab YouTube ban đầu được tạm dừng để tránh hai nơi cùng phát.
5. Nếu đã có bài học với phụ đề trong trình duyệt: mở tiếp bài cũ, giữ nguyên phụ đề đã chỉnh, nhãn thì, câu đã lưu và tiến độ. Bài mới lưu phụ đề tự động, đánh dấu chưa xác nhận phủ toàn video.
6. Có thể dùng nút trong popup tiện ích nếu không thấy nút dưới video.

KHI CHƯA LẤY ĐƯỢC
- Thời gian chờ khoảng 18 giây. Không có phụ đề / giao diện không tương thích: thông báo lỗi ngay cạnh nút và có đường dẫn mở đúng video để nhập SRT/VTT hoặc dán thủ công.
- Bạn cũng có thể mở mô tả → Hiện bản chép lời, chọn tiếng Anh, bật mốc thời gian rồi bấm thử lại.
- Không chuyển sang video khác trong lúc đang lấy phụ đề. Tiện ích sẽ hủy để tránh chuyển nhầm nội dung.
- Cần cho tiện ích quyền truy cập youtube.com; không chỉ bật quyền “khi bấm” nếu muốn nút tự xuất hiện.

QUYỀN VÀ DỮ LIỆU
- Tiện ích chạy trên YouTube để thêm nút. Chỉ đọc bản chép lời khi bạn bấm học; không tự tải phụ đề hay mở trang học chỉ vì bạn đang xem video.
- Chỉ xin quyền YouTube và /youtube/ trên website TuanBong, không quyền mọi website. activeTab + scripting hỗ trợ popup; storage lưu tạm gói chuyển; background mở tab bài học.
- Chỉ chuyển nội dung phụ đề, tên và link video đến chính trang TuanBong. Không đọc mật khẩu, cookie đăng nhập hoặc gửi dữ liệu đến dịch vụ tải phụ đề trung gian. Không API trả phí, AI hoặc backend.
- Mỗi lần mở có một gói riêng, tự xóa sau khi trang học nhận xong; gói quá 24 giờ được dọn trong lần mở tiếp theo.
- Dữ liệu học nằm trong trình duyệt, không tự đồng bộ giữa Chrome/Safari hay hai máy. Dùng Cài đặt → Xuất/Khôi phục bản sao lưu nếu muốn chuyển dữ liệu.

GIỚI HẠN
- Tự động phụ thuộc giao diện và bản chép lời YouTube hiện có. Không bảo đảm mọi video, tài khoản, ngôn ngữ hoặc giao diện đều hoạt động.
- Chỉ đọc nội dung có trong giao diện bản chép lời; thử cuộn để gom dòng nếu danh sách nạp dần. Hãy kiểm tra phạm vi phụ đề, vẫn có thể thiếu một phần video.
- Mốc kết thúc ước lượng từ dòng kế tiếp, không phải mốc từng từ; lặp câu không bảo đảm khớp âm thanh tuyệt đối.
- Chưa kiểm thử trọn luồng bằng tiện ích cài trong Chrome thực tế ở môi trường này. Luồng xử lý có kiểm thử tự động và các điều khiển YouTube đã được đối chiếu trực tiếp.

BẢN CŨ
Mở bản ChatGPT cũ → Cài đặt → Xuất bản sao lưu. Mở https://english-ebook-website.pages.dev/youtube/ → Cài đặt → Khôi phục. Không xóa bản cũ trước khi kiểm tra dữ liệu đã chuyển đủ.


CHUYỂN ĐỊA CHỈ WEBSITE · 0.4.4
Tiện ích mở bài học tại https://tuanbong.pages.dev/youtube/ và vẫn hỗ trợ kết nối trang cũ.
Trước khi cập nhật: ở trang cũ → Cài đặt → Xuất bản sao lưu.
Sau cập nhật: ở trang mới → Cài đặt → Khôi phục → chọn tệp vừa xuất.
Kiểm tra đủ video, câu và từ đã lưu. Dữ liệu không tự đồng bộ giữa hai địa chỉ.

