# The Historical Vault - YouTube Studio Assistant Pro (v2.0)

Extension & AI Tunnel tự động hóa 100% quy trình xuất bản, SEO metadata, chapters, tags và upload thumbnail trên **YouTube Studio** (`https://studio.youtube.com/`).

---

## 🚀 Các Tính Năng Đã Nâng Cấp Vượt Trội (v2.0)

1. **Thuật toán xuyên thấu Shadow DOM (Deep Shadow DOM Piercing)**:
   - Khắc phục triệt để lỗi YouTube Studio ẩn các ô nhập liệu bên trong Web Components (`ytcp-*`, `tp-yt-*`, `iron-input`).
   - Tự động dò tìm đệ quy qua toàn bộ cây Shadow Root để điền Tiêu đề, Mô tả, Radio Audience, Tags và nút Hiện thêm.
2. **Tự động gắn Thumbnail trực tiếp (Direct Thumbnail Auto-Injection)**:
   - Không cần mở hộp thoại chọn file của Windows!
   - Tiện ích tự động tải file ảnh JPEG gốc từ máy chủ Bridge (`http://127.0.0.1:8766/api/thumbnail/{ep}`) và gán trực tiếp vào input tải lên của YouTube Studio qua `DataTransfer` API.
3. **Động cơ AI Antigravity Cinematic SEO Engine (Port 8766)**:
   - Tích hợp sẵn cơ sở tri thức điện ảnh về **Trận Rạch Gầm - Xoài Mút 1785**.
   - Hỗ trợ viết lại tiêu đề giật gân, bổ sung mốc thời gian kịch tính, tạo danh sách 500 ký tự tags thịnh hành và bình luận thảo luận ghim.
4. **Bảng điều khiển kéo thả tự do (Draggable Panel) & Nút soi DOM (🔍)**:
   - Bạn có thể kéo thả widget đến bất kỳ vị trí nào trên màn hình để không che các nút "Next", "Save", "Details" của YouTube Studio.
   - Nút `🔍` cho phép quét và kiểm tra xem YouTube Studio đã hiển thị đủ các trường dữ liệu hay chưa.
5. **Đường hầm Tester tự nhận diện Profile (`Default`)**:
   - Khi chạy `.\tunnel_ctl.ps1 chrome` hoặc `.\start_tester_tunnel.ps1`, Chrome tự động mở đúng Profile chính chủ (`mirsixabcf2@gmail.com`) đã đăng nhập sẵn kênh **The Historical Vault**, mở cổng Debugging 9222 và tự nạp Extension.

---

## 🛠️ Hướng Dẫn Sử Dụng Nhanh

### 1. Nạp / Cập nhật Extension trên Chrome
- Mở `chrome://extensions/`
- Bật **Developer mode**
- Bấm **Load unpacked** và chọn `C:\Projects\Historical\extension` (Nếu đã nạp trước đó, chỉ cần bấm biểu tượng **Reload 🔄** tại thẻ tiện ích).

### 2. Vận hành trên YouTube Studio
- Truy cập bất kỳ video nào:
  - [Chỉnh sửa Bản Full Movie Private (36m)](https://studio.youtube.com/video/c8Akru2j7ok/edit)
  - Hoặc bấm **Create** -> **Upload videos** để tải các tập từ Ep 2 đến Ep 8.
- Bảng điều khiển nổi **Historical Vault Pro** sẽ tự động hiển thị:
  - Bấm **`⚡ AUTO-FILL METADATA & THUMBNAIL (1-CLICK)`**: Tự động điền Title, Description, Tags, tick Không dành cho trẻ em, và tự động gắn Thumbnail!
  - Bấm **`🎬 Copy 4K Video Path`**: Lấy đường dẫn file video 4K gốc (`content/videos_4k/...`) để dán vào khi upload.
  - Sử dụng khung **`✨ Antigravity Cinematic AI`** để yêu cầu tinh chỉnh nội dung theo ý muốn.

---

## 📁 Kiểm Tra Trạng Thái Đường Hầm
Chạy trong PowerShell tại thư mục dự án:
```powershell
.\tunnel_ctl.ps1 status
```