# BÁO CÁO KHẢO SÁT TOÀN DIỆN TÀI NGUYÊN & VỆ SINH KHÔNG GIAN SẢN XUẤT TẬP 01 (EP01)
## DỰ ÁN ĐIỆN ẢNH AI: "THẬP NGŨ NIÊN" (THE FIFTEEN SPRINGS)

> **Mã báo cáo**: `SURVEY-EP01-ASSETS-HYGIENE-01`  
> **Tác giả**: Teamwork Explorer Subagent (`explorer_survey_2`)  
> **Thời gian thực hiện**: 2026-10-09T02:45:00Z  
> **Phạm vi khảo sát**: `04_Assets/` (`videos/`, `keyframes/`, `characters/`, `archive/`, `audio_sfx/`, `audio/`, `backgrounds/`) & Ngữ cảnh kỹ thuật liên quan (`05_Production_Pipeline/`, `episodes/ep01/`).  
> **Chỉ thị tham chiếu**: `ORIGINAL_REQUEST.md`, `AGENTS.md`, `GEMINI.md`.

---

## 1. TỔNG QUAN ĐIỀU HÀNH (EXECUTIVE SUMMARY)

Chiến dịch tái sản xuất toàn diện Tập 01 (Ep01) của tác phẩm điện ảnh AI *"Thập Ngũ Niên"* yêu cầu tái thiết lập một không gian làm việc sạch (Clean Slate), triệt tiêu nguồn lây nhiễm dị tật hình ảnh giữa các nhân vật, đồng thời bảo tồn 100% bằng chứng sáng tạo phục vụ đăng ký sở hữu trí tuệ (IP) và bảo vệ tuyệt đối kho tư liệu tạo hình nhân vật gốc.

Kết quả khảo sát thực tế trên toàn bộ hệ thống file cho thấy:
1. **Kho Video (`04_Assets/videos/`)**: Đang lưu trữ **300 file video**, trong đó có đúng **184 file video thuộc Tập 01** với tổng dung lượng **2.144,84 MB (~2,14 GB)** bao gồm **26 bản Master cảnh**, **152 shot quay thô 10s**, và **6 file chuyển cảnh/thử nghiệm đặc biệt**. Toàn bộ 184 file này cần được chuyển giao nguyên vẹn vào `04_Assets/archive/ep01_legacy_v1/`.
2. **Kho Keyframe (`04_Assets/keyframes/`)**: Đang tồn tại **155 thư mục mang tiền tố `ep01_*`** chứa **157 file ảnh** (chủ yếu là `clean_frame_239.jpg`, `head_frame_0.jpg`) và **1 file ảnh gốc ở root** (`ep01_scene03_start_720p.png`), tổng dung lượng **36,16 MB**. Khảo sát mã nguồn `05_Production_Pipeline/production_orchestrator.py` (dòng 137-146) đã định vị chính xác **nguyên nhân gốc rễ (Root Cause)** gây ô nhiễm khuôn mặt Thúy Kiều sang các nhân vật khác: hàm `resolve_start_frame()` tự động ưu tiên nạp `find_tail_frame(prev_shot_id)` khi `shot_num > 1` mà không kiểm tra ranh giới phân cảnh (Cinematic Cut vs Continuous Take). Toàn bộ 155 thư mục này bắt buộc phải được dọn sạch để ngăn chặn pipeline mới tiếp tục lấy nhầm frame rác cũ.
3. **Kho Tạo Hình Nhân Vật Gốc (`04_Assets/characters/`)**: Tách biệt hoàn toàn về cấu trúc vật lý so với thư mục keyframe. Tất cả **7 nhân vật hạt nhân của Tập 01** (Thúy Kiều, Thúy Vân, Kim Trọng, Vương Quan, Vương Ông, Vương Bà, Đạm Tiên) cùng dàn nhân vật phụ (Quản gia họ Vương, Thị nữ, Tiểu đồng, Sai nha, Thằng bán tơ, Mụ mối) đều sở hữu đầy đủ cả 2 định dạng: bản **720p (1280x720)** và bản **Master (1376x768)** lossless PNG. **100% file nguyên vẹn, không lỗi hỏng, đạt độ phân giải chuẩn.**
4. **Kho Lưu Trữ Bằng Chứng IP (`04_Assets/archive/`)**: Đã có cấu trúc nền tảng (`audio/`, `duplicate_false_positives/`, `videos/`). Việc khởi tạo không gian chuyên biệt `04_Assets/archive/ep01_legacy_v1/` kèm bản thuyết minh `README.md` theo chuẩn pháp lý Luật SHTT Việt Nam là hoàn toàn khả thi và cần thiết.
5. **Kho Âm Thanh & SFX (`04_Assets/audio_sfx/` & `audio/`)**: Lưu trữ đầy đủ ambience hội xuân Thanh Minh chuẩn uncompressed WAV 48kHz stereo (`ep01_scene04_festival_crowd_ambience_120s.wav` - 120s) và nhạc nền Suno BGM cổ phong điện ảnh (`scene01_bgm.m4a` - 178.88s Opus 48kHz).

---

## 2. KẾT QUẢ KHẢO SÁT CHI TIẾT TỪNG PHÂN VÙNG TÀI NGUYÊN (`04_Assets/`)

### 2.1. Phân vùng Video Cũ (`04_Assets/videos/`)

Hệ thống ghi nhận tổng cộng **300 file video** định dạng `.mp4` trong `04_Assets/videos/`:
- **File thuộc Tập 01 (Cần di dời vào Archive)**: **184 files** (Dung lượng: `2.249.030.734 bytes` ~ `2.144,84 MB`).
- **File thuộc các tập khác & prologue độc lập (Giữ nguyên tại chỗ)**: **116 files** (Gồm Ep02: 29 files, Ep03: 26 files, Ep04: 21 files, Ep05: 16 files, Ep06: 16 files, Prologue 1980s: 5 files, Test audio: 1 file, Thập niên intro: 4 files).

#### Bảng Thống Kê Chi Tiết 184 Video Tập 01 Theo Phân Cảnh (Scenes 01 - 14):

| Phân Cảnh | Số File | Dung Lượng (MB) | Số Master | Số Shot Thô (10s) | Số File Chuyển Cảnh/Khác | Ghi Chú Nội Dung Kịch Bản |
| :--- | :---: | :---: | :---: | :---: | :---: | :--- |
| **Scene 01** | 28 | 517.54 | 3 | 21 | 4 | Làng quê Bắc Bộ 1980s & Giới thiệu thời không |
| **Scene 02** | 20 | 174.33 | 3 | 15 | 2 | Gia trang họ Vương, phòng khách thanh bạch |
| **Scene 03** | 17 | 153.62 | 2 | 15 | 0 | Thúy Kiều, Thúy Vân, Vương Quan xuất hiện |
| **Scene 04** | 14 | 249.11 | 2 | 12 | 0 | Hội đạp thanh & Lễ tảo mộ Thanh Minh |
| **Scene 05** | 29 | 280.48 | 2 | 27 | 0 | Nấm mồ Đạm Tiên bên dòng suối & Kiều than khóc |
| **Scene 06** | 16 | 222.23 | 2 | 14 | 0 | Kim Trọng cưỡi ngựa tuyết trắng tao ngộ Thúy Kiều |
| **Scene 07** | 10 | 84.18 | 2 | 8 | 0 | Kim Trọng tương tư nơi thư phòng |
| **Scene 08** | 10 | 101.31 | 2 | 8 | 0 | Kim Trọng thuê nhà vườn Thúy cạnh nhà Kiều |
| **Scene 09** | 8 | 85.26 | 2 | 6 | 0 | Kim Trọng nhặt cành thoa vàng rơi trên cành đào |
| **Scene 10** | 16 | 149.90 | 2 | 14 | 0 | Đêm tự tình & Thề nguyền dưới trăng |
| **Scene 11** | 3 | 33.76 | 1 | 2 | 0 | Tin sét đánh: Kim Trọng về Liêu Dương chịu tang chú |
| **Scene 12** | 3 | 21.37 | 1 | 2 | 0 | Gia biến ập tới: Thằng bán tơ vu oan giáng họa |
| **Scene 13** | 6 | 45.20 | 1 | 5 | 0 | Sai nha nha môn ập vào tra khảo Vương Ông, Vương Quan |
| **Scene 14** | 4 | 26.54 | 1 | 3 | 0 | Kiều quyết định bán mình chuộc cha |
| **Tổng Cộng** | **184** | **2.144,84** | **26** | **152** | **6** | **Toàn bộ di sản Video v1 của Ep01** |

#### Danh Mục Chi Tiết 26 Bản Master Cảnh Cần Lưu Trữ:
1. `ep01_scene01_master_50s.mp4` (52,51 MB)
2. `ep01_scene01_master_audio_normalized_46s.mp4` (51,98 MB)
3. `ep01_scene01_master_v1.mp4` (155,76 MB)
4. `ep01_scene02_kieu_van_lcut_master.mp4` (8,35 MB)
5. `ep01_scene02_master.mp4` (21,06 MB)
6. `ep01_scene02_master_v1.mp4` (66,24 MB)
7. `ep01_scene03_master.mp4` (21,06 MB)
8. `ep01_scene03_master_v1.mp4` (65,31 MB)
9. `ep01_scene04_master.mp4` (21,26 MB)
10. `ep01_scene04_master_v1.mp4` (111,28 MB)
11. `ep01_scene05_master.mp4` (30,05 MB)
12. `ep01_scene05_master_v1.mp4` (123,33 MB)
13. `ep01_scene06_master.mp4` (22,32 MB)
14. `ep01_scene06_master_v1.mp4` (97,79 MB)
15. `ep01_scene07_master.mp4` (12,33 MB)
16. `ep01_scene07_master_v1.mp4` (35,54 MB)
17. `ep01_scene08_master.mp4` (17,76 MB)
18. `ep01_scene08_master_v1.mp4` (41,26 MB)
19. `ep01_scene09_master.mp4` (27,99 MB)
20. `ep01_scene09_master_v1.mp4` (28,23 MB)
21. `ep01_scene10_master.mp4` (21,60 MB)
22. `ep01_scene10_master_v1.mp4` (63,02 MB)
23. `ep01_scene11_master.mp4` (16,60 MB)
24. `ep01_scene12_master.mp4` (10,66 MB)
25. `ep01_scene13_master.mp4` (22,20 MB)
26. `ep01_scene14_master.mp4` (13,02 MB)

#### Danh Mục 6 File Chuyển Cảnh / Thử Nghiệm Đặc Biệt:
1. `ep01_scene02_gia_trang_10s.mp4` (5,22 MB)
2. `ep01_scene02_kieu_tam_thap_luc_10s.mp4` (5,33 MB - Bản render thử nghiệm chứa Kiều chơi đàn trong Scene 2)
3. `ep01_transition_scene01_to_02_2s.mp4` (1,10 MB)
4. `ep01_transition_scene01_to_tam_thap_luc_2s.mp4` (1,18 MB)
5. `ep01_transition_scene01_to_tam_thap_luc_2s_with_audio.mp4` (1,23 MB)
6. `thap_ngu_nien_ep01_intro_prologue_scene01_110s.mp4` (90,09 MB - Bản ghép thử nghiệm prologue và Scene 1)

---

### 2.2. Phân vùng Keyframe & Hiện Tượng Nhiễm Độc Hình Ảnh (`04_Assets/keyframes/`)

#### Thống Kê Vật Lý Thư Mục Keyframe:
- Tổng số thư mục trong `04_Assets/keyframes/`: **221 thư mục**.
- Số thư mục thuộc Tập 01 (`ep01_*`): **155 thư mục** (chiếm 70,1% toàn bộ keyframe).
- Tổng số file nằm trong 155 thư mục này: **157 files** (Dung lượng: `37.917.783 bytes` ~ `36,16 MB`).
  - `clean_frame_239.jpg`: **154 files**.
  - `head_frame_0.jpg`: **2 files** (`ep01_scene02_kieu_tam_thap_luc`, `ep01_scene02_shot01`).
  - `start_frame_seamless_720p.png`: **1 file** (`ep01_scene02`).
- File đơn lẻ tại thư mục gốc `04_Assets/keyframes/`: **1 file** `ep01_scene03_start_720p.png` (1.750.859 bytes).
- Thư mục thuộc các tập khác (Ep02..Ep06, prologue, intro): **66 thư mục** (Bảo lưu tuyệt đối, không đụng tới).

#### Phân Tích Cơ Chế Gây Lỗi (Root Cause Analysis - Code & Pipeline Leak):
Qua đối chiếu trực tiếp mã nguồn điều phối render tại `05_Production_Pipeline/production_orchestrator.py` (dòng 127-160):

```python
# Trích xuất nguyên văn từ 05_Production_Pipeline/production_orchestrator.py (dòng 137-146):
    # Tự động tìm shot trước nếu là shot đánh số
    m = re.search(r"^(ep\d+_scene\d+)_shot(\d+)$", shot_id, re.IGNORECASE)
    if m:
        scene_prefix = m.group(1)
        shot_num = int(m.group(2))
        if shot_num > 1:
            prev_shot_id = f"{scene_prefix}_shot{shot_num - 1:02d}"
            prev_tail = find_tail_frame(prev_shot_id)
            if prev_tail:
                return str(prev_tail.resolve())
```

**Chuỗi logic dẫn đến dị tật biến dạng (Morphing) và rò rỉ khuôn mặt Thúy Kiều:**
1. **Thiếu cơ chế phân biệt loại cú máy**: Hàm `resolve_start_frame()` tự động thực thi logic: Cứ là shot thứ 2 trở đi (`shot_num > 1`), code lập tức gọi `find_tail_frame(prev_shot_id)`. Nó hoàn toàn bỏ qua việc shot đó là **Cinematic Cut** (đổi góc máy, đổi nhân vật) hay **Continuous Take** (cùng một nhân vật nối tiếp chuyển động).
2. **Khai báo prompt rỗng**: Trong `episodes/ep01/prompts/muse_prompts.json`, hàng loạt shot thuộc Scene 02, Scene 05, Scene 06, Scene 13 có trường `character_asset_ref: null` hoặc `reference_start_frame` trỏ ngược về tail frame của shot trước.
3. **Hiện tượng lây nhiễm cụ thể tại các cảnh trọng điểm**:
   - **Scene 02 (Gia đình họ Vương)**: Do shot thử nghiệm `ep01_scene02_kieu_tam_thap_luc` đưa hình ảnh Thúy Kiều vào, các shot sau nối đuôi frame cuối dẫn đến Vương Ông (cụ ông 55 tuổi) và Vương Quan (thanh niên 16 tuổi) bị nạp ảnh đầu vào là cô gái trẻ áo lụa, khiến Muse.ai sinh ra khuôn mặt nhân vật nam mang nét nữ nhi hoặc trâm cài tóc lố bịch.
   - **Scene 05 (Mộ Đạm Tiên)**: Shot 08 kết thúc với cảnh Thúy Kiều khóc nức nở bên nấm mồ. Shot 09 chuyển sang Vương Quan lên tiếng khuyên nhủ. Do pipeline tự động lấy frame 239 của Shot 08 làm Start Frame cho Shot 09, nhân vật Vương Quan bị ép vào khuôn hình Thúy Kiều! Muse.ai cố gắng biến khuôn mặt thiếu nữ thành nam thiếu niên, gây ra lỗi morphing nghiêm trọng (mặt méo mó, mắt lé, tóc biến dạng). Đây là lý do thư mục `04_Assets/archive/duplicate_false_positives` phải chứa hàng loạt file shot09 - shot24 bị lỗi lặp frame và biến dạng.
   - **Scene 06 (Gặp gỡ Kim Trọng)**: Cảnh quay cắt chéo giữa Kim Trọng (nam sinh cưỡi ngựa tuyết) và Thúy Kiều (tiểu thư e ấp sau cành liễu). Việc lấy đuôi shot này làm đầu shot kia đã làm Kim Trọng bị lẫn y phục phụ nữ và Thúy Kiều bị lẫn mũ miện nho sinh.
   - **Scene 13 & 14 (Gia biến & Bán mình)**: Cảnh sai nha tra tấn Vương Ông bị lây nhiễm hình ảnh thiếu nữ từ các shot trước, làm sai lệch hoàn toàn tính chất tàn bạo, khốc liệt của cảnh bi kịch gia đình họ Vương.
4. **Hậu quả nếu không dọn sạch**: Hàm `find_tail_frame()` trong `production_orchestrator.py` kiểm tra `KEYFRAMES_DIR / shot_id`. Nếu thư mục cũ vẫn còn `clean_frame_239.jpg`, hệ thống render sẽ lập tức nuốt chửng frame cũ bị nhiễm độc này thay vì nạp Start Frame chuẩn xác từ kho Character Bible!

---

### 2.3. Phân vùng Kho Nhân Vật Gốc (`04_Assets/characters/`)

Khảo sát đối soát kỹ thuật xác thực toàn bộ ảnh nhân vật trong `04_Assets/characters/`:
- **Độ cô lập**: Thư mục `characters/` nằm độc lập hoàn toàn với `keyframes/`.
- **Độ vẹn toàn**: Không có bất kỳ file nào bị lỗi header, hỏng pixel hay mất dữ liệu.

#### Bảng Kiểm Định 7 Nhân Vật Cốt Lõi Tập 01 (Ep01 Core Protagonists):

| Nhân Vật | Phân Loại Thư Mục | File 720p (1280x720) | Dung Lượng 720p | File Master (1376x768) | Dung Lượng Master | Tình Trạng |
| :--- | :--- | :--- | :---: | :--- | :---: | :---: |
| **Thúy Kiều** | `01_Main_Protagonists/` | `thuy_kieu_maiden_16yo_720p.png` | 1.268.162 B | `thuy_kieu_maiden_16yo_master.png` | 1.360.639 B | Chuẩn 100% |
| **Thúy Vân** | `01_Main_Protagonists/` | `thuy_van_maiden_16yo_720p.png` | 1.174.746 B | `thuy_van_maiden_16yo_master.png` | 1.267.719 B | Chuẩn 100% |
| **Kim Trọng** | `01_Main_Protagonists/` | `kim_trong_18yo_720p.png` | 1.542.062 B | `kim_trong_18yo_master.png` | 1.703.967 B | Chuẩn 100% |
| **Vương Quan** | `02_Vuong_Family_And_Fate/` | `vuong_quan_16yo_720p.png` | 1.453.892 B | `vuong_quan_16yo_master.png` | 1.606.204 B | Chuẩn 100% |
| **Vương Ông** | `02_Vuong_Family_And_Fate/` | `vuong_ong_55yo_720p.png` | 1.298.592 B | `vuong_ong_55yo_master.png` | 1.424.147 B | Chuẩn 100% |
| **Vương Bà** | `02_Vuong_Family_And_Fate/` | `vuong_ba_50yo_720p.png` | 1.500.547 B | `vuong_ba_50yo_master.png` | 1.669.287 B | Chuẩn 100% |
| **Đạm Tiên** | `02_Vuong_Family_And_Fate/` | `dam_tien_720p.png` | 1.508.473 B | `dam_tien_master.png` | 1.637.223 B | Chuẩn 100% |

#### Dàn Nhân Vật Phụ & Vai Quần Chúng Trong Tập 01 (Đều Đầy Đủ 720p & Master):
- `quan_gia_vuong_720p.png` & `_master.png` (Quản gia họ Vương, người già bộc trực).
- `gia_no_nu_vuong_720p.png` & `_master.png` (Gia nô nữ họ Vương, phục vụ trà nước).
- `vuong_servants_720p.png` & `_master.png` (Đoàn gia nhân họ Vương trong tiết Thanh Minh).
- `quan_gia_kim_trong_720p.png` & `_master.png` (Quản gia phủ Kim Trọng).
- `tieu_dong_kim_trong_720p.png` & `_master.png` (Tiểu đồng dắt ngựa tuyết trắng cho Kim Trọng).
- `kim_attendants_720p.png` & `_master.png` (Tùy tùng của Kim Trọng).
- `sai_nha_720p.png` & `_master.png` (Đầu trâu mặt ngựa, nha dịch hung tàn vụ gia biến).
- `thang_ban_to_720p.png` & `_master.png` (Kẻ vu oan giáng họa họ Vương).
- `ma_giam_sinh_720p.png` & `_master.png` (Kẻ buôn người xuất hiện cuối Ep01).

> **Kết luận**: Kho nhân vật là **tài sản bất khả xâm phạm**. Bất kỳ thao tác dọn dẹp nào cũng phải cam kết giữ nguyên 100% các file này.

---

### 2.4. Phân vùng Kho Lưu Trữ Hiện Hữu (`04_Assets/archive/`)

Thư mục `04_Assets/archive/` hiện đang có cấu trúc:
- `audio/`: Chứa các bản thu giọng ngâm thơ thử nghiệm bằng TTS (`scene01_voiceover.mp3`, `test_kieu_voice.mp3`).
- `duplicate_false_positives/`: Chứa 16 file video và 16 thư mục keyframe của Scene 05 (shot09 - shot24) bị lỗi morphing do cơ chế lặp frame trước đây.
- `videos/`: Chứa các bản dựng thử nghiệm Scene 1 có lồng tiếng TTS (`ep01_scene01_cinematic_master_with_voice_50s.mp4`, `ep01_scene04_preview_stitched_v1.mp4`, v.v.).
- `README.md`: Bản ghi chép sơ khởi về mục đích lưu trữ làm bằng chứng sáng tạo của con người (Human-in-the-Loop).

**Định hướng kiến trúc**: Khởi tạo thư mục con chuyên biệt `04_Assets/archive/ep01_legacy_v1/` để quy tụ toàn bộ 184 file video v1 của Tập 01, giải phóng hoàn toàn `04_Assets/videos/` cho đợt sản xuất mới.

---

### 2.5. Phân vùng Âm Thanh & SFX (`04_Assets/audio_sfx/` & `04_Assets/audio/`)

Khảo sát kỹ thuật thông số âm thanh qua `ffprobe`:
1. `04_Assets/audio_sfx/ep01_scene04_festival_crowd_ambience_120s.wav`:
   - Định dạng: Uncompressed PCM 16-bit Little Endian (`pcm_s16le`).
   - Tần số lấy mẫu: **48.000 Hz (48kHz)**.
   - Kênh âm thanh: **2 kênh Stereo**.
   - Thời lượng: **120,0 giây** (chuẩn 2 phút trải nền hội xuân).
   - Bitrate: **1.536 kbps**. Tình trạng: Hoàn hảo cho Stem 2 (Ambience).
2. `04_Assets/audio/festival_crowd_ambience_bed.wav`:
   - Định dạng: PCM 16-bit, 48kHz, 2 kênh Stereo, thời lượng 60,0 giây.
3. `04_Assets/audio/scene01_bgm.m4a`:
   - Định dạng: Opus Stereo, 48kHz, thời lượng **178,88 giây (~3 phút)**.
   - Âm nhạc: Khúc hòa tấu Suno cổ phong (Tỳ Bà, Tranh, Sáo Trúc).

---

## 3. ĐẶC TẢ KỸ THUẬT VỆ SINH & LƯU TRỮ (R2 HYGIENE & ARCHIVAL SPECIFICATIONS)

### 3.1. Kế Hoạch Di Dời Toàn Bộ 184 Video Cũ Vào `04_Assets/archive/ep01_legacy_v1/`

#### Cấu Trúc Đề Xuất Cho Thư Mục Lưu Trữ:
Nhằm đảm bảo tính khoa học, dễ tra cứu và chứng minh bằng chứng sở hữu trí tuệ, thư mục `04_Assets/archive/ep01_legacy_v1/` được phân nhóm như sau:

```
04_Assets/archive/ep01_legacy_v1/
├── README.md               # Hồ sơ giải trình pháp lý & danh mục bằng chứng sáng tạo
├── masters/                # 26 Bản Master Scene hoàn thiện của v1 (50s - 155s)
├── raw_shots/              # 152 Shot quay thô 10s (ep01_scene01_shot01 .. ep01_scene14_shot03)
└── specials/               # 6 File chuyển cảnh, test L-cut, composite intro
```

#### Bảng Ánh Xạ Di Dời Chi Tiết:
- **masters/**: Chứa toàn bộ 26 file có tên chứa `master` thuộc `ep01` (ví dụ: `ep01_scene01_master_50s.mp4`, `ep01_scene01_master_v1.mp4`, `ep01_scene02_kieu_van_lcut_master.mp4` .. `ep01_scene14_master.mp4`).
- **raw_shots/**: Chứa toàn bộ 152 file có tên chứa `shot` thuộc `ep01` (ví dụ: `ep01_scene01_shot01_10s.mp4` .. `ep01_scene14_shot03_10s_v1.mp4`).
- **specials/**: Chứa 6 file:
  - `ep01_scene02_gia_trang_10s.mp4`
  - `ep01_scene02_kieu_tam_thap_luc_10s.mp4`
  - `ep01_transition_scene01_to_02_2s.mp4`
  - `ep01_transition_scene01_to_tam_thap_luc_2s.mp4`
  - `ep01_transition_scene01_to_tam_thap_luc_2s_with_audio.mp4`
  - `thap_ngu_nien_ep01_intro_prologue_scene01_110s.mp4`

**Nguyên tắc bảo toàn**:
- Sử dụng lệnh di chuyển an toàn (`shutil.move` hoặc script Python chuyên trách), kiểm tra hash dung lượng trước và sau khi chuyển.
- Tuyệt đối không xóa bất kỳ file nào trong số 184 file này (Zero Permanent Deletion).

---

### 3.2. Dự Thảo Nội Dung `04_Assets/archive/ep01_legacy_v1/README.md`

Dưới đây là nội dung toàn văn dự thảo của file `README.md` cần được khởi tạo bên trong thư mục `04_Assets/archive/ep01_legacy_v1/`:

```markdown
# HỒ SƠ LƯU TRỮ & CHỨNG CỨ LAO ĐỘNG SÁNG TẠO: TẬP 01 (EP01) - PHIÊN BẢN LEGACY V1
## DỰ ÁN ĐIỆN ẢNH AI: "THẬP NGŨ NIÊN" (THE FIFTEEN SPRINGS)

> **Cơ sở pháp lý**:  
> - Luật Sở hữu trí tuệ Việt Nam (Điều 4 khoản 8: Quyền tác giả; Điều 14: Các loại hình tác phẩm được bảo hộ; Điều 20: Quyền tài sản; Điều 43: Tác phẩm thuộc phạm vi công chúng).  
> - Nguyên tác văn học: *Đoạn Trường Tân Thanh - Truyện Kiều* của Đại thi hào Nguyễn Du (1765 - 1820, Public Domain). Tác phẩm "Thập Ngũ Niên" là tác phẩm phái sinh điện ảnh độc lập có sự sáng tạo nguyên bản của Tác giả Nguyễn Sĩ Sơn.  
> - Bằng chứng lao động sáng tạo của con người (Human-in-the-Loop): Quá trình chọn lọc, thử nghiệm, loại bỏ và tinh chỉnh qua nhiều vòng đời phiên bản (Selection, Arrangement, and Refinement).

---

### 1. BỐI CẢNH & NGUYÊN DO LƯU TRỮ PHIÊN BẢN V1
Thư mục này lưu trữ nguyên vẹn toàn bộ 184 video thành phẩm và bán thành phẩm của đợt sản xuất Thử nghiệm Đầu tiên (Production Batch v1) của Tập 01 (Ep01) bao gồm 14 Phân cảnh (Scenes 01 đến 14).

**Lý do kỹ thuật và nghệ thuật dẫn đến quyết định lưu trữ:**
1. **Hiện tượng Rò rỉ Hình ảnh (Character Identity Contamination)**: Ở phiên bản v1, pipeline tự động hóa áp dụng cơ chế nối tiếp frame cuối (Head-Tail Auto Chaining) cho tất cả các shot liên tiếp trong một Scene. Cơ chế này không phân biệt giữa `Continuous Take` (cùng một nhân vật tiếp diễn) và `Cinematic Cut` (chuyển đổi góc nhìn sang nhân vật khác). Hậu quả là hình ảnh của Thúy Kiều đã lây nhiễm sang các nhân vật nam như Vương Quan, Vương Ông, Kim Trọng, gây ra hiện tượng méo mó khuôn mặt (morphing) và sai lệch tạo hình nhân vật nghiêm trọng.
2. **Nâng cấp Cổng Kiểm duyệt 2 Tầng (Antigravity Quality Gate)**: Dự án chuyển đổi sang mô hình kiểm duyệt chất lượng cao tự động bằng Google Antigravity SDK: thẩm định độc lập từng shot (Shot Gate >= 0.8) và thẩm định dòng chảy điện ảnh (Scene Gate 30-40s) để đảm bảo không nhảy trục, khớp hướng nhìn và đồng nhất màu sắc.
3. **Bảo tồn bằng chứng pháp lý**: Việc giữ lại các bản render v1 cùng lịch sử sai lệch là minh chứng xác thực nhất khẳng định: Tác phẩm không phải là sản phẩm tạo sinh ngẫu nhiên một nút bấm của AI, mà là kết quả của một chuỗi lao động trí tuệ kéo dài, có sự can thiệp, đánh giá, loại bỏ và đạo diễn chặt chẽ của con người (Human Agency).

---

### 2. DANH MỤC THỐNG KÊ TÀI NGUYÊN LƯU TRỮ

- **Tổng số file**: 184 file video (.mp4).
- **Tổng dung lượng**: 2.144,84 MB (2,14 GB).
- **Chuẩn kỹ thuật video**: 1280x720 (720p), 24.0 fps, Codec H.264 / NVENC.
- **Chuẩn kỹ thuật audio**: AAC 48.000 Hz Stereo, 192 kbps.

#### Phân loại thư mục con:
1. `masters/` (26 files): Toàn bộ các bản ghép master từng cảnh của v1 (Scene 01 đến Scene 14).
2. `raw_shots/` (152 files): Toàn bộ các shot quay đơn lẻ 10s do Muse.ai render.
3. `specials/` (6 files): Các bản chuyển cảnh (transitions), test L-cut thoại và composite intro prologue.

---

### 3. THÔNG BÁO QUYỀN SỞ HỮU TRÍ TUỆ
Toàn bộ tư liệu lưu trữ trong thư mục này thuộc quyền sở hữu trí tuệ hợp pháp của Tác giả **NGUYỄN SĨ SƠN** (CCCD: 031090010018). Nghiêm cấm mọi hành vi sao chép, trích xuất hoặc thương mại hóa khi chưa có sự chấp thuận bằng văn bản của Chủ sở hữu quyền tác giả.
```

---

### 3.3. Kế Hoạch Làm Sạch An Toàn Kho Keyframe Bị Nhiễm Độc (Contaminated Keyframes Purge)

#### Danh Sách Mục Tiêu Cần Làm Sạch (Purge Targets):
1. **Toàn bộ 155 thư mục có tiền tố `ep01_*`** nằm bên trong `04_Assets/keyframes/`:
   - `ep01_scene01_shot01` đến `ep01_scene01_shot21` (21 thư mục)
   - `ep01_scene02`, `ep01_scene02_gia_trang`, `ep01_scene02_kieu_tam_thap_luc`, `ep01_scene02_shot01` đến `ep01_scene02_shot15` (18 thư mục)
   - `ep01_scene03_shot01` đến `ep01_scene03_shot15` (15 thư mục)
   - `ep01_scene04_shot01` đến `ep01_scene04_shot12` (12 thư mục)
   - `ep01_scene05_shot01` đến `ep01_scene05_shot27` (27 thư mục)
   - `ep01_scene06_shot01` đến `ep01_scene06_shot14` (14 thư mục)
   - `ep01_scene07_shot01` đến `ep01_scene07_shot08` (8 thư mục)
   - `ep01_scene08_shot01` đến `ep01_scene08_shot08` (8 thư mục)
   - `ep01_scene09_shot01` đến `ep01_scene09_shot06` (6 thư mục)
   - `ep01_scene10_shot01` đến `ep01_scene10_shot14` (14 thư mục)
   - `ep01_scene11_shot01` đến `ep01_scene11_shot02` (2 thư mục)
   - `ep01_scene12_shot01` đến `ep01_scene12_shot02` (2 thư mục)
   - `ep01_scene13_shot01` đến `ep01_scene13_shot05` (5 thư mục)
   - `ep01_scene14_shot01` đến `ep01_scene14_shot03` (3 thư mục)
2. **File đơn lẻ tại thư mục gốc keyframes**:
   - `04_Assets/keyframes/ep01_scene03_start_720p.png` (1 file)

#### Các Phân Vùng TUYỆT ĐỐI BẢO LƯU (Strict Invariants):
1. **Kho nhân vật gốc (`04_Assets/characters/`)**:
   - Phải giữ nguyên vẹn 100% tất cả 62 file chân dung nhân vật trong 7 thư mục con.
   - Trước và sau khi dọn dẹp keyframe, script BẮT BUỘC phải đối soát: Đủ 14 file chân dung chuẩn của 7 nhân vật chính Tập 01 (7 bản 720p và 7 bản master) với dung lượng > 1 MB mỗi file.
2. **Keyframe của các tập khác**:
   - Giữ nguyên toàn bộ 66 thư mục còn lại trong `04_Assets/keyframes/` (`ep02_*`, `ep03_*`, `ep04_*`, `ep05_*`, `ep06_*`, `prologue_*`, `intro_*`).
   - Giữ nguyên các file phong cảnh hội xuân tại root (`crowd_qingming_festival_720p.png`, `crowd_qingming_festival_master.png`).

#### Giao Thức Thực Thi 4 Bước An Toàn (Safe Execution Protocol):
```python
# Pseudo-code / Quy trình thực thi cho Agent Implementer:
1. PRE-CHECK:
   - Đếm số file trong 04_Assets/characters/: Khẳng định >= 62 files.
   - Xác nhận sự tồn tại của 14 portrait files cốt lõi Ep01.
2. FILTER PURGE LIST:
   - Quét 04_Assets/keyframes/
   - Chỉ chọn thư mục thỏa mãn regex chặt chẽ: ^ep01_scene\d+.*$ hoặc ^ep01_.*$
   - Tuyệt đối cấm quét hoặc xóa bằng wildcard lỏng lẻo như *.* hay *.png trên toàn bộ 04_Assets.
3. EXECUTE PURGE:
   - Xóa an toàn các file và thư mục trong danh sách purge đã lọc.
   - Xóa file 04_Assets/keyframes/ep01_scene03_start_720p.png.
4. POST-CHECK:
   - Kiểm tra lại 04_Assets/characters/: Xác nhận nguyên vẹn 100%.
   - Kiểm tra 04_Assets/keyframes/: Xác nhận còn đúng 66 thư mục (không còn bất kỳ thư mục ep01 nào).
```

---

## 4. KIẾN NGHỊ THI CÔNG CHO CÁC AGENT TIẾP THEO

1. **Gửi Agent Thực Thi Dọn Dẹp & Lưu Trữ (Workspace Cleaner / Migration Implementer)**:
   - Tiến hành tạo thư mục `04_Assets/archive/ep01_legacy_v1/` và 3 thư mục con `masters/`, `raw_shots/`, `specials/`.
   - Di chuyển an toàn toàn bộ 184 file video theo đúng Bảng Ánh Xạ.
   - Ghi file `04_Assets/archive/ep01_legacy_v1/README.md` theo nội dung đã dự thảo tại Mục 3.2.
   - Thực thi Giao thức 4 bước xóa bỏ 155 thư mục keyframe `ep01_*` bị ô nhiễm và file `ep01_scene03_start_720p.png`.
   - Cập nhật lại `episodes/ep01/manifest.json` để đưa số lượng shot đã render về 0, chuẩn bị đón nhận đợt sản xuất mới.

2. **Gửi Agent Kỹ Sư Pipeline & Cổng Kiểm Duyệt (Pipeline Engineer & Quality Gate Auditor)**:
   - Tái cấu trúc hàm `resolve_start_frame()` trong `05_Production_Pipeline/production_orchestrator.py`: Bổ sung cờ phân loại rõ ràng:
     - Nếu là `Cinematic Cut`: BẮT BUỘC bỏ qua `find_tail_frame()`, trực tiếp đọc `character_asset_ref` hoặc prompt trong `02_AI_Prompts/gemini_banana_prompts.json` để tạo Start Frame mới độc lập.
     - Nếu là `Continuous Take`: Mới được phép lấy `find_tail_frame()` của shot trước.
   - Tích hợp module kiểm duyệt `antigravity_critic_gate.py` với 2 tầng Shot Gate và Scene Gate theo đúng yêu cầu R1 của `ORIGINAL_REQUEST.md`.

---
*Báo cáo được hoàn tất và niêm phong tại `c:\Projects\KieuStory\.agents\teamwork\explorer_survey_2\survey_assets_hygiene.md`.*