# BÁO CÁO KHẢO SÁT CHUYÊN SÂU QUY CHUẨN THỊ GIÁC & DIỄN XUẤT ĐIỆN ẢNH (R3, R4, R5)
## DỰ ÁN AI CINEMA: THẬP NGŨ NIÊN (THE FIFTEEN SPRINGS)

> **Tài liệu**: Survey Report & Specification Mining  
> **Người thực hiện**: `teamwork_preview_spec_miner` (Visual & Acting Standards Spec Miner)  
> **Mã thư mục làm việc**: `.agents/teamwork/spec_miner_survey_2`  
> **Phạm vi trọng tâm**: Yêu cầu R3, R4, R5 thuộc `ORIGINAL_REQUEST.md` và mở rộng toàn diện hệ thống visual assets, prompt schema, character bible, storyboard.

---

## TỔNG QUAN KHẢO SÁT (EXECUTIVE SUMMARY)

Qua quá trình rà soát toàn diện mã nguồn, kịch bản phân cảnh (`FilmMaker/TAP_01` đến `TAP_06`), sổ tay tạo hình (`00_Project_Bible/CHARACTER_BIBLE.md`), sổ tay bối cảnh (`ENVIRONMENT_BIBLE.md`), dữ liệu prompt (`02_AI_Prompts/gemini_banana_prompts.json`, `muse_ai_video_prompts.json`), và kho tài nguyên thực tế (`04_Assets/characters`, `04_Assets/keyframes`, `04_Assets/backgrounds`), Spec Miner phát hiện 3 nút thắt kỹ thuật cốt lõi ảnh hưởng trực tiếp đến chất lượng điện ảnh của EP01 và toàn bộ dự án:

1. **Vấn đề R3 (Nút thắt Start Frame & Lỗi Vật lý)**: 12/48 shot trong EP01 hiện tại đang nạp trực tiếp ảnh chân dung studio đơn lẻ (`04_Assets/characters/.../thuy_kieu_maiden_16yo_720p.png` chụp trong khuê phòng hoặc `kim_trong_18yo_720p.png` trên hiên thư phòng) làm Start Frame cho các cảnh quay ngoại cảnh phức tạp (cỏ non Đạp Thanh, mộ hoang Đạm Tiên, cưỡi ngựa bên suối liễu). Điều này làm Muse.ai bị ảo giác không gian (spatial hallucination), dẫn đến hiện tượng trôi dạt bối cảnh, đàn chim bay ngược (optical flow reversal), hoặc nhân vật "đi lùi" (moonwalking).
2. **Vấn đề R4 (Vi phạm Nguyên tắc Nam nhân Phong kiến Rơi lệ)**: Phát hiện nhiều đoạn trong kịch bản phân cảnh (`TAP_01:195`, `TAP_02:116`, `TAP_03:66, 144, 194`, `TAP_05:47`, `TAP_06:122, 124`, `TIMELINE_AND_AGING_MATRIX.md:66`) và video prompts (`ep03_scene04_shot01`, `ep03_scene09_shot01`) mô tả nam nhân (Kim Trọng, Vương Quan, Vương Ông, Thúc Sinh, Thúc Ông) "rơi nước mắt", "khóc ngất", "nức nở", "hai hàng lệ tuôn rơi". Điều này phá vỡ khí chất Nho giáo phong kiến và chuẩn mực nam nhi trượng phu thời Mạc/Minh.
3. **Vấn đề R5 (Lệch Khẩu hình & Thiếu Chốt Chặn Thoại Ngoài Khung Hình)**: Rà soát phát hiện 52 shot chứa lời thoại hoặc giọng ngâm Voice-Over (V.O.), nhưng **0/52 shot (0%)** có chỉ thị khóa khẩu hình (`closed-lip guard`). Điển hình tại Cảnh 08 Shot 02 (Kim Trọng nhặt thoa kim), Thúy Kiều cất tiếng gọi từ bên kia tường hoa nhưng trong khung hình là Kim Trọng; do không có guard, Muse.ai tự động điều khiển môi Kim Trọng mấp máy nói giọng nữ của Kiều.

---

## BẢNG TÍNH NĂNG ĐƯỢC PHÁT HIỆN (FEATURES DISCOVERED)

| # | Phân loại | Tính năng | Mô tả chức năng | Dữ liệu đầu vào (Inputs) | Dữ liệu đầu ra (Outputs) | Hành vi khi lỗi (Error Behavior) | Phương thức phát hiện |
|---|---|---|---|---|---|---|---|
| 1 | Visual Pipeline | Start Frame Resolution (`resolve_start_frame`) | Tự động phân giải Start Frame cho từng shot video theo thứ tự ưu tiên: explicit frame -> tail frame trước -> reference frame -> character asset | `shot_id`, `shot_data`, `explicit_frame` | Đường dẫn file ảnh Start Frame (str/Path) | Nếu là Shot 1 của scene, rơi về static solo portrait trong phòng thay vì cảnh ngoại, gây lỗi nhảy cảnh | `05_Production_Pipeline/production_orchestrator.py:118-160` |
| 2 | Visual Pipeline | Head-Tail Auto Chaining | Trích xuất Tail Frame (frame 239) của video vừa render bằng OpenCV làm Start Frame cho shot kế tiếp | `target_video_path` (MP4 10s 24fps) | `clean_frame_239.jpg` lưu tại `04_Assets/keyframes/<shot_id>/` | Nếu video fail hoặc thiếu, chuỗi nối tiếp đứt đoạn | `05_Production_Pipeline/run_shot.py:145-155` |
| 3 | Visual Pipeline | Visual Continuity Checker | So sánh độ tương đồng histogram HSV (60%) và Gray Diff (40%) giữa Tail Frame N và Head Frame N+1 | `video_prev`, `video_next`, `threshold=0.65` | `match_score` (float 0.0 - 1.0), boolean | Nếu score < 0.65, cảnh báo khựng hình ("CẢNH BÁO KHỰNG HÌNH") và yêu cầu bridging transition | `05_Production_Pipeline/continuity_checker.py:31-86` |
| 4 | Prompt Engineering | Audio Guard Injection | Tự động bổ sung hậu tố cấm BGM, cấm âm thanh điện tử vào prompt gửi sang Muse.ai | Chuỗi `prompt` ban đầu | Chuỗi `prompt` kèm `Tuyệt đối KHÔNG sinh nhạc nền...` | Nếu prompt đã có guard tiếng Anh/Việt thì bỏ qua; nếu thiếu thì tự động nối đuôi | `05_Production_Pipeline/run_shot.py:40-43` |
| 5 | Image Engine | Positive Style Anchor | Bộ khung thẩm mỹ 8K UHD điện ảnh thế kỷ 16 thời Mạc/Minh cho Gemini Banana | Tên nhân vật, trang phục, góc máy | Prompt 16:9 và 9:16 chuẩn hóa | Sinh ảnh chuẩn Á Đông, loại bỏ phong cách Tây phương | `00_Project_Bible/CHARACTER_BIBLE.md:27-28` |
| 6 | Image Engine | Single Character Solo Rule | Quy tắc bắt buộc chân dung nhân vật chỉ chứa 1 người duy nhất trong khung hình để triệt tiêu biến dạng chi và trôi dạt nhận diện | Mô tả nhân vật | Solo Portrait 720p/master | Bị lạm dụng làm Start Frame cho cả các cảnh ngoại cảnh và đại cảnh đông người | `00_Project_Bible/CHARACTER_BIBLE.md:25` |
| 7 | Acting Directive | Anti-Male-Tears Directive | Quy chuẩn cấm toàn bộ nam nhân phong kiến rơi lệ; chuyển tải cảm xúc qua cơ mặt đanh, mắt trĩu nặng, nhìn xa xăm, nén thở | Kịch bản, hành vi nhân vật nam | Mô tả diễn xuất kìm nén, nghiêm nghị | Hiện tại bị vi phạm tại 15 vị trí kịch bản và prompt | `ORIGINAL_REQUEST.md:27-30` vs `TAP_01:195` |
| 8 | Lip-Sync Directive | Lip-Sync & Off-Screen Guard | Ngăn ngừa nhân vật trên màn ảnh mấp máy môi khi nghe thoại vọng từ xa hoặc ngâm thơ V.O. | Chỉ thị thoại O.S./V.O. | Cặp thẻ `[CHỦ THỂ THOẠI]` và `[KHÓA KHẨU HÌNH]` | 52 shot thiếu chốt chặn, dẫn đến nhân vật nhép miệng sai người | `ORIGINAL_REQUEST.md:31-34` vs `muse_prompts` |
| 9 | Physics Directive | Directional Motion Vector Guard | Quy định hướng chuyển động cơ học tuyệt đối (tiến về trước, sải cánh hướng chân trời) để ngăn chim bay lùi, người đi giật lùi | Mô tả chuyển động camera & chủ thể | Vector chuyển động xác định | Thiếu hướng vector dẫn đến optical flow ngược và trượt chân | Khảo sát lỗi render Muse.ai |

---

## BẢNG TRƯỜNG HỢP BIÊN & DỊ THƯỜNG (EDGE CASES)

| # | Tính năng liên quan | Đầu vào / Hoàn cảnh (Input) | Hành vi quan sát được (Observed Behavior) | Đánh giá & Rủi ro |
|---|---|---|---|---|
| 1 | R3: Start Frame | `ep01_scene04_shot02` nạp `thuy_kieu_maiden_16yo_720p.png` (ảnh Kiều ngồi trong khuê phòng cầm đàn) làm Start Frame cho cảnh "Ba chị em thả bộ du xuân giữa thảm cỏ non" | Frame 0 là cảnh trong nhà tĩnh, sau đó video cố gắng chuyển động thành bước đi ngoài trời -> biến dạng không gian, giật cục | **CỰC KỲ NGHIÊM TRỌNG**: Gây đứt gãy thị giác hoàn toàn giữa Scene 04 Shot 01 và Shot 02. |
| 2 | R3: Start Frame | `ep01_scene05_shot02` nạp ảnh Kiều ngồi thư phòng làm Start Frame cho cảnh "Nàng Kiều rơi lệ trước nấm mồ Đạm Tiên bên gốc bàng hoàng hôn" | Nhân vật xuất hiện giữa hai bối cảnh đối lập (khuê phòng giàu sang vs mộ hoang tàn tạ) trong cùng 1 shot | **CỰC KỲ NGHIÊM TRỌNG**: Nhân vật không hòa quyện vào môi trường mộ Đạm Tiên. |
| 3 | R3: Start Frame | `ep01_scene06_shot01` nạp `kim_trong_18yo_720p.png` (thư sinh ngồi hiên đọc sách) làm Start Frame cho cảnh "Kim Trọng cưỡi bạch mã bờ suối" | Nhân vật đang ngồi ghế bỗng nhiên cưỡi ngựa -> thân hình biến dạng, chân ngựa dính vào tà áo | **CỰC KỲ NGHIÊM TRỌNG**: Gãy logic vật lý và tạo hình nhân vật. |
| 4 | R3: Motion Physics | Text-to-Video hoặc Start Frame có chim chao liệng mà không chỉ định vector bay tiến | Đàn chim én bay giật cục, vỗ cánh thụt lùi về phía đuôi (optical flow inversion) | **NGHIÊM TRỌNG**: Lỗi vật lý thô thiển, phá vỡ cảm giác điện ảnh cổ phong. |
| 5 | R3: Motion Physics | Camera dolly-in trong khi nhân vật bước đi mà không đồng bộ vector | Nhân vật di chuyển chân nhưng người bị kéo lùi như đi trên máy chạy bộ (moonwalking) | **NGHIÊM TRỌNG**: Phá hỏng bước chân tao nhã của ba chị em du xuân. |
| 6 | R4: Diễn xuất | `TAP_01:195`: Kim Trọng nắm tay Kiều trong sương mai chia ly: `*(Nắm chặt tay Kiều, nghẹn ngào rơi nước mắt)*` | Nam nhân trâm anh thế phiệt khóc ướt mắt như phim truyền hình hiện đại | **VI PHẠM QUY CHUẨN R4**: Mất phong thái nam nhân Nho giáo; cần đổi thành đanh cơ mặt, nén sâu hơi thở. |
| 7 | R4: Diễn xuất | `TAP_02:116`: `Vương Ông và Vương Quan gục đầu bên cổng thành khóc ngất` | Phụ thân và em trai gục đầu khóc ngất | **VI PHẠM QUY CHUẨN R4**: Cần chuyển thành ánh mắt trĩu nặng nhìn theo cỗ xe, hàm nghiến chặt nuốt đắng cay. |
| 8 | R4: Diễn xuất | `ep03_scene09_shot01`: Prompt video ghi `tiếng Thúc Sinh gào khóc nghẹn ngào gọi tên Kiều`, camera `revealing Thuc Sinh weeping alone` | Thúc Sinh khóc gào thảm thiết trên bãi tro tàn | **VI PHẠM QUY CHUẨN R4**: Cần chuyển thành Thúc Sinh sững sờ ngã quỵ, hai tay bốc nắm tro tàn siết chặt, ánh mắt vô hồn thất thần. |
| 9 | R5: Khẩu hình | `ep01_scene08_shot02`: Kim Trọng trong khung hình, audio có lời Kiều: `'Dám hỏi bên ấy có ai trông thấy chiếc thoa kim chăng?'` | Muse.ai nhận diện đoạn hội thoại có trong prompt và làm khẩu hình Kim Trọng mấp máy khớp lời thoại nữ của Kiều | **CỰC KỲ NGHIÊM TRỌNG**: Lỗi lệch khẩu hình lố bịch (nam nhân nói giọng nữ). |
| 10 | R5: Khẩu hình | `ep01_scene01_shot01-05`: Giọng ngâm thơ V.O. dẫn truyện ("Trăm năm trong cõi người ta...") vang lên khi có nhân vật trong hình | Nhân vật trên màn ảnh mấp máy môi như thể tự ngâm thơ dẫn truyện | **NGHIÊM TRỌNG**: Phá vỡ tính thiêng liêng của lời bình điện ảnh dẫn nhập. |

---

## PHẦN 1: KHẢO SÁT HIỆN TRẠNG ASSETS & PROMPTS TRÊN REPOSITORY

### 1.1. Hiện trạng Kho Tài nguyên Hình ảnh (`04_Assets/`)
- **Nhân vật (`04_Assets/characters/`)**: Tổng cộng 62 file (31 file 720p và 31 file master 8K). Bao quát 32 nhân vật theo 7 nhóm. Toàn bộ các file này đều tuân thủ quy tắc "Single Character Solo Shot" với tỷ lệ 16:9 hoặc chân dung, nhân vật ở trạng thái tĩnh trên nền khuê phòng hoặc thư phòng.
- **Keyframes (`04_Assets/keyframes/`)**: 184 file tại 53 thư mục. Chủ yếu là các `clean_frame_239.jpg` được OpenCV trích xuất từ các lần render trước của các cảnh từ Scene 01 đến Scene 14.
- **Bối cảnh (`04_Assets/backgrounds/`)**: Có 29 file (các background đã tạo như `vuon_thuy_spring_720p.png`, `vuong_family_gate_storm_720p.png`, `vuong_chiaroscuro_livingroom_720p.png`, `ma_giam_sinh_arrival_720p.png`, `lau_ngung_bich_720p.png`...).
- **KHOẢNG TRỐNG TÀI NGUYÊN (MISSING ASSETS)**: Dự án đang **hoàn toàn thiếu** các ảnh Start Frame phối hợp nhân vật và ngoại cảnh (Contextual Blended Start Frames) cho các phân đoạn cốt lõi của EP01:
  - `ep01_tieu_khe_suoi_trong_kieu_720p.png`: Ba chị em tản bộ dọc bờ suối trong vắt ("bước lần theo ngọn tiểu khê").
  - `ep01_bai_co_xanh_du_xuan_720p.png`: Thúy Kiều và Thúy Vân giữa thảm cỏ non xanh mơn mởn ("cỏ non xanh tận chân trời").
  - `ep01_hoi_dap_thanh_dong_duc_720p.png`: Đại cảnh hội xuân đông đúc dập dìu ngựa xe tài tử giai nhân.
  - `ep01_mo_dam_tien_hoang_hon_720p.png`: Nấm mồ Đạm Tiên vô chủ bên gốc bàng già trơ trọi lúc hoàng hôn buông xuống.
  - `ep01_kim_trong_bach_ma_suoi_lieu_720p.png`: Kim Trọng cưỡi bạch mã dừng chân bên rặng liễu rủ lúc ráng chiều.
  - `ep01_tuong_hoa_thoa_kim_720p.png`: Bức tường hoa rực rỡ cành đào vắt ngang chiếc thoa kim lấp lánh.

### 1.2. Hiện trạng Bộ Prompt (`02_AI_Prompts/`)
- `gemini_banana_prompts.json` (321 dòng): Chỉ chứa định nghĩa tĩnh cho 32 nhân vật (16:9 và 9:16), 4 bối cảnh chung, và 3 critical keyframes. **Chưa có cấu trúc sinh Contextual Start Frame cho từng Scene cụ thể**.
- `muse_ai_video_prompts.json` (1144 dòng, 120 motion prompts):
  - Đã có cấu trúc `audio_directive_standard` (hậu tố Audio Guard cấm BGM rác).
  - **Khiếm khuyết lớn**: Thiếu hoàn toàn các trường quy chuẩn:
    - Không có trường `acting_directive` (quy định biểu cảm cơ mặt, cấm nam nhân khóc).
    - Không có trường `lip_sync_guard` (phân loại thoại on-screen vs off-screen/VO, bắt buộc khép môi khi nghe thoại xa).
    - Không có trường `motion_vector_guard` (chỉ dẫn hướng chuyển động vật lý, chống chim bay ngược, chống người đi lùi).

---

## PHẦN 2: ĐẶC TẢ R3 — QUY TRÌNH SWEET-SPOT START FRAME 2 BƯỚC & KHỬ LỖI VẬT LÝ

### 2.1. Cơ chế vận hành lỗi hiện tại
Trong `05_Production_Pipeline/production_orchestrator.py` (hàm `resolve_start_frame` dòng 118-160):
Khi một Shot là Shot đầu tiên của một phân cảnh mới (ví dụ `ep01_scene04_shot02`, `ep01_scene05_shot02`, `ep01_scene06_shot01`), hệ thống kiểm tra:
1. `shot_num > 1` (sai, vì là shot đầu bối cảnh mới hoặc shot không có tail frame).
2. Kiểm tra `character_asset_ref` -> Lấy `04_Assets/characters/01_Main_Protagonists/thuy_kieu_maiden_16yo_720p.png` hoặc `kim_trong_18yo_720p.png`.
Hậu quả: Muse.ai nhận ảnh đầu vào là Kiều đang ngồi trong phòng với cây đàn tỳ bà, rồi prompt lại bảo "chị em thả bộ giữa thảm cỏ non". Động cơ video AI không thể giải quyết mâu thuẫn không gian này, buộc phải "biến hình" (morphing) thô bạo hoặc giữ nguyên phòng ngủ rồi cho chân lướt đi lùi!

### 2.2. Quy trình Sweet-Spot 2 Bước Chuẩn Hóa (Gemini Banana ➔ Muse.ai I2V)

```
[BƯỚC 1: TỔNG HỢP START FRAME BỐI CẢNH (GEMINI BANANA)]
┌─────────────────────────────────────────────────────────────┐
│ 1. Character Visual Anchor (Ngũ quan, độ tuổi, y phục cổ phong) │
│                       +                                     │
│ 2. Environment Visual Anchor (Suối trong, cỏ non, mộ hoang)  │
│                       +                                     │
│ 3. Framing Standard: 720p (1280x720) 16:9 Lossless PNG,     │
│    Medium Close-Up (MCU) / American Shot, chừa an toàn      │
│    headroom & shoulder room, ánh sáng tản mềm volumetric.   │
└──────────────────────────────┬──────────────────────────────┘
                               │
                               ▼ Sinh ra: contextual_start_frame_720p.png
[BƯỚC 2: DIỄN HOẠT VIDEO LIỀN MẠCH (MUSE.AI I2V)]
┌─────────────────────────────────────────────────────────────┐
│ 1. Nạp contextual_start_frame_720p.png qua agent-browser    │
│ 2. Motion Prompt kèm 4 lớp bảo vệ:                         │
│    - Vector Guard (Hành động tiến về trước, không đảo chiều)│
│    - Acting Guard (Biểu cảm tinh tế, Anti-Male-Tears)       │
│    - Lip-Sync Guard (Khép chặt môi khi thoại ngoài khung)   │
│    - Audio Guard (Foley/Ambience/Thoại, cấm tuyệt đối BGM) │
│ 3. Render 10s 24fps -> Tải về 04_Assets/videos/             │
│ 4. OpenCV trích xuất Tail Frame (Frame 239) làm Start Frame  │
│    cho Shot tiếp theo (Head-Tail Seamless Chaining).        │
└─────────────────────────────────────────────────────────────┘
```

### 2.3. Bộ Prompt Gemini Banana Mẫu Cho 4 Bối Cảnh Cốt Lõi EP01

#### 1. Tiểu Khê Suối Trong & Triền Cỏ Non Du Xuân (Scene 04)
```text
Masterpiece, 8K UHD, photorealistic 16th century Annam Mac/Ming historical cinema aesthetic. An 18-year-old noble maiden Thuy Kieu and her younger sister Thuy Van strolling gracefully along the edge of a crystal-clear winding brook ('ngon tieu khe') bordered by endless rolling vibrant green grass meadows under gentle morning spring sunlight ('co non xanh tan chan troi'). Wearing authentic pastel celadon-jade and ivory-white Giao Linh silk robes with delicate pear blossom embroidery, hair in elegant noble updo with jade hairpin. Medium shot, generous headroom and shoulder room, natural volumetric lighting, 35mm anamorphic lens, 8k resolution, cinematic color grading, strictly no western faces, no modern elements --ar 16:9
```

#### 2. Nấm Mồ Đạm Tiên Ven Đường Buổi Chiều Tà (Scene 05)
```text
Masterpiece, 8K UHD, photorealistic 16th century historical drama. A sorrowful 18-year-old East Asian noble maiden Thuy Kieu standing reverently beside a desolate, low-lying untended earthen mound grave ('nam mo se se co ay') under a gnarled barren banyan tree beside a deserted country road at crimson sunset dusk. Pale melancholy face, sorrowful soulful almond eyes, standing still in solemn contemplation. Wearing wind-blown celadon jade silk Giao Linh robe. Somber overcast twilight sky, chilly evening breeze rustling withered leaves, ancient Annam countryside atmosphere, 35mm film still, cinematic dramatic lighting, single person focal point --ar 16:9
```

#### 3. Bờ Suối Liễu Tơ Mềm & Bạch Mã Kim Trọng (Scene 06)
```text
Masterpiece, 8K UHD, photorealistic 16th century historical romance. An exceptionally handsome 18-year-old East Asian noble scholar Kim Trong mounted regally on a magnificent white horse ('bach ma') halted beside lush weeping willows along a sparkling riverside path at golden hour dusk. Dignified gentlemanly posture, intelligent sparkling eyes, gentle composed poetic expression, completely dry eyes and composed noble jaw. Wearing luxurious celestial cyan and navy silk brocade robes with geometric fret collar and jade scholar cap. Warm golden rim light, 35mm cinema lens, picturesque poetic landscape --ar 16:9
```

#### 4. Bức Tường Hoa Cành Đào & Thoa Kim Lấp Lánh (Scene 08)
```text
Masterpiece, 8K UHD, photorealistic 16th century historical cinema. An antique terracotta-tiled garden wall ('tuong hoa') separating two scholarly courtyards under brilliant summer sunlight. Blooming pink peach blossom branches arching gracefully over the wall. Caught delicately on a wooden peach branch is an exquisite antique filigree golden hairpin ('thoa kim') glistening in the sunbeams. In foreground, handsome 18-year-old noble scholar Kim Trong standing in scholar courtyard gazing up with wonder and reverence. 50mm f/1.8 lens, luminous summer atmosphere, 35mm film grain --ar 16:9
```

### 2.4. Danh mục Quy tắc Phòng chống Lỗi Vật lý (Motion Physics Guard Rules)

1. **Khử lỗi đàn chim bay ngược (Anti-Reverse-Flight)**:
   - *Quy tắc prompt bắt buộc*: Khi xuất hiện đàn chim (chim én, quạ sa trường), prompt BẮT BUỘC có chỉ thị vector hướng: `Đàn chim én sải cánh bay lướt dứt khoát về phía trước hướng chân trời xa (swallows flapping wings forward, flying decisively into the distance). Tuyệt đối KHÔNG bay lùi, không đảo chiều cánh, không chao đảo giật cục (strictly forward flight, no backward flapping, no reverse optical motion)`.
2. **Khử lỗi người đi thụt lùi (Anti-Moonwalking)**:
   - *Quy tắc prompt bắt buộc*: Khi có nhân vật bước đi, camera và hướng chân phải đồng pha: `Nhân vật sải bước tiến thẳng về phía trước theo lối mòn (walking forward along the path). Bàn chân bám chắc mặt đất tự nhiên từng nhịp, máy quay tracking lùi êm ái nhường đường cho bước chân tiến lên (camera pulls back smoothly as subject advances). Tuyệt đối không trượt chân lùi, không đi giật lùi (strictly no foot sliding, no moonwalking)`.
3. **Khử lỗi biến dạng vật thể & chi (Anti-Deformation Guard)**:
   - *Quy tắc prompt bắt buộc*: Với nhạc cụ (đàn tỳ bà, đàn tam thập lục), vật cầm tay (thoa kim, quạt giấy, chén trà), prompt BẮT BUỘC chỉ định điểm neo cố định: `Hai bàn tay ôm chắc cần đàn tỳ bà cố định, ngón tay chỉ khẽ gảy trên dây đàn (hands firmly holding lute neck, fingers plucking gently). Thân đàn giữ nguyên hình dạng gỗ trắc, tuyệt đối không biến dạng phím đàn, không sinh ngón tay thừa (solid wooden prop geometry, no warping, no extra fingers)`.

---

## PHẦN 3: ĐẶC TẢ R4 — QUY CHUẨN DIỄN XUẤT PHỔ QUÁT & ANTI-MALE-TEARS DIRECTIVE

### 3.1. Cơ sở Văn hóa & Lịch sử của Chỉ thị Anti-Male-Tears
Trong xã hội phong kiến phương Đông thế kỷ 16 chịu ảnh hưởng sâu sắc của Nho giáo chính thống:
- "Nam tử hán đại trượng phu", "Đàn ông đổ máu không đổ lệ". Người đàn ông gánh vác cương thường, trung hiếu, danh dự gia tộc.
- Hành vi khóc lóc sướt mướt, nước mắt rơi lã chã, gào khóc ngất lịm bị coi là sự yếu hèn, mất tư cách quân tử và làm nhục gia phong.
- Nỗi đau của người đàn ông phong kiến là **nỗi đau hướng nội (internalized suppressed agony)**: Càng đau đớn, uất hận thì gương mặt càng phải đanh lại như đá tảng, ánh mắt càng trĩu nặng thâm sâu, hơi thở càng nén chặt đến thắt nghẽn lồng ngực.

### 3.2. Bảng Đối chiếu Sửa đổi Toàn diện cho các Nhân vật Nam

| Nhân vật | Tình huống kịch tính | Mô tả cũ (Vi phạm R4) | Mô tả mới chuẩn hóa (Tuân thủ Anti-Male-Tears) |
|---|---|---|---|
| **Kim Trọng** | Sáng sớm chia ly Liêu Dương (`TAP_01:195`) | `*(Nắm chặt tay Kiều, nghẹn ngào rơi nước mắt)*` | `*(Nắm chặt tay Kiều, cơ hàm bạnh ra nghiến chặt, ánh mắt trĩu nặng u uất nhìn thẳng vào mắt nàng, lồng ngực nén sâu hơi thở dài uất nghẹn, tuyệt đối không một giọt lệ)*` |
| **Kim Trọng** | 15 năm tìm kiếm gặp lại Kiều (`TAP_06:124`, `TIMELINE_MATRIX:66`) | `đôi mắt chàng ngấn lệ... rưng rưng giọt lệ thuở ban đầu` | `đôi mắt phong sương bàng hoàng sững sờ, hàng mi run nhẹ xúc động tột cùng, khóe môi khẽ mỉm nụ cười nghẹn ngào tri ân nhưng ánh mắt cương nghị tuyệt đối khô ráo` |
| **Vương Ông** | Cảnh gia biến bị áp chế (`TAP_01:227`) | `tiếng thét nghẹn ngào của Vương Ông... khóc than` | `Vương Ông nghiến răng uất nghẹn, trán nổi gân xanh, ánh mắt rực lửa căm hờn nhìn thẳng vào lũ sai nha tham tàn, ngực phập phồng nén giận dữ, giữ vững khí tiết nhà Nho` |
| **Vương Ông & Vương Quan** | Cảnh tiễn Kiều bán mình (`TAP_02:116`) | `Vương Ông và Vương Quan gục đầu bên cổng thành khóc ngất` | `Vương Ông đứng sững như chôn chân, hai bàn tay siết chặt đến trắng bợt đốt ngón tay, mắt trĩu nặng nhìn theo làn bụi xe; Vương Quan đứng thẳng bên cha, hàm bạnh chặt, ánh mắt uất hận nhìn trời` |
| **Thúc Sinh** | Bãi tro tàn Vô Tích (`TAP_03:144, 194`, `muse_ep03_sc09`) | `Thúc Sinh đấm ngực khóc rống lên... hai hàng nước mắt tuôn rơi lã chã` | `Thúc Sinh ngã quỵ xuống đất, hai bàn tay run rẩy bốc nắm tro tàn siết chặt trong lòng bàn tay, ánh mắt thất thần vô hồn nhìn vào khoảng không, lồng ngực co thắt nén tiếng nấc nghẹn` |
| **Thúc Ông** | Công đường xử kiện Thúc gia (`TAP_03:66`) | `Thúc Ông rưng rưng nước mắt` | `Thúc Ông vuốt chòm râu bạc, ánh mắt nghiêm nghị giãn ra vẻ thán phục và xúc động, khẽ gật đầu biểu đồng tình` |
| **Từ Hải** | Sa trường tử chiến (`TAP_06:47`, `muse_ep06_sc01`) | `Từ Hải... lệ rơi sa trường` | `Từ Hải sừng sững như tượng đồng, ánh mắt quắc thước nhìn thẳng vào quân thù, ngạo nghễ bất khuất giữa làn mưa tên, tuyệt đối không một gợn bi lụy` |

### 3.3. Quy chuẩn Diễn xuất Vi mô Nhân vật Nữ (Female Micro-Expressions)
Thay thế lối diễn xuất gào khóc cường điệu sân khấu cải lương bằng kỹ thuật biểu cảm vi mô (micro-expressions) chuẩn điện ảnh:
1. **Thúy Kiều**:
   - *Khóc trong uất ức / chia ly*: Không há miệng gào khóc. Đầu hơi nghiêng, ánh mắt thẫn thờ nhìn xuống, khóe mi ngân ngấn ánh sáng rồi một giọt nước mắt trong suốt chầm chậm lăn nhẹ trên má phấn. Đôi môi mím chặt nén tiếng nấc.
   - *Trước mộ Đạm Tiên*: Nét mặt từ từ chùng xuống, đồng tử mở to bàng hoàng, hàng mi khẽ rủ xuống như trĩu nặng một linh cảm tiền định, hai bàn tay khẽ run run nâng vạt áo.
2. **Thúy Vân**:
   - Biểu cảm ngơ ngác, thuần khiết, đôi má tròn đầy đặn thoáng nét âu lo ngây thơ, bàn tay nhẹ nhàng níu lấy tay áo chị Kiều với ánh mắt thương xót chị nhưng không bi lụy thái quá.
3. **Quần chúng du xuân (Crowd Extras)**:
   - Tự nhiên, thanh nhã: Nụ cười mỉm e ấp, ánh mắt trao nhau kín đáo sau chiếc quạt nan tre, bước chân khoan thai nhẹ nhàng, tay khẽ nâng cành liễu, tuyệt đối không vẫy tay nhốn nháo như diễn kịch đường phố.

---

## PHẦN 4: ĐẶC TẢ R5 — CHỐT CHẶN KHẨU HÌNH & THOẠI NGOÀI KHUNG HÌNH (LIP-SYNC & OFF-SCREEN GUARD)

### 4.1. Bản chất Lỗi Kỹ thuật tại Muse.ai
Muse.ai và các mô hình Image-to-Video tích hợp âm thanh vận hành theo cơ chế multimodal:
Khi nhận vào một đoạn prompt vừa có mô tả chuyển động vừa có đoạn thoại hội thoại hoặc trích dẫn thơ trong dấu ngoặc kép (`"..."`), mô hình tự động gán hành động phát âm (speech generation) cho bất kỳ khuôn mặt người nào xuất hiện rõ nhất trong khung hình!
Hậu quả:
- Nếu shot quay Kim Trọng nhặt thoa kim, nhưng audio mô tả tiếng Kiều gọi từ xa: Kim Trọng bị ép mở miệng nói nhép theo giọng nữ của Kiều!
- Nếu shot quay đại cảnh có tiếng dẫn chuyện V.O.: Bất kỳ người qua đường nào gần máy quay cũng có thể bị giật mép mấp máy môi theo lời bình!

### 4.2. Khung Quy chuẩn Chốt Chặn Khẩu hình (Off-Screen Dialogue Guard Protocol)

Mọi shot video có chứa yếu tố âm thanh lời nói hoặc tiếng gọi BẮT BUỘC phải phân định rõ 1 trong 3 trạng thái:

#### Trạng thái A: Thoại Trực diện Trên Màn Ảnh (On-Screen Dialogue)
- Áp dụng khi nhân vật trong khung hình chính là người đang nói.
- *Cú pháp chỉ thị*:
  `[CHỈ THỊ KHẨU HÌNH ON-SCREEN]: Nhân vật {Tên_Nhân_Vật} cất tiếng nói/thì thầm. Khẩu hình chuyển động nhẹ nhàng tự nhiên theo từng âm tiết, miệng mở vừa phải đoan trang, cơ mặt giữ vẻ tự nhiên, tuyệt đối không méo miệng hay ngoác miệng quá đà.`

#### Trạng thái B: Thoại Ngoài Khung Hình / Gọi Từ Xa (Off-Screen Dialogue / Call from Afar)
- Áp dụng khi nhân vật trong khung hình là người NGHE, còn giọng nói phát ra từ ngoài ống kính, sau bức tường, hoặc từ xa vọng lại (như cảnh Kim Trọng nhặt thoa kim).
- *Cú pháp chỉ thị BẮT BUỘC*:
  `[CHỈ THỊ KHÓA KHẨU HÌNH - OFF-SCREEN GUARD]: Giọng nói của {Tên_Người_Nói_Ngoài_Khung} vọng lại từ xa ngoài khung hình. Nhân vật trong khung hình ({Tên_Người_Trong_Hình}) là người lắng nghe: ĐÔI MÔI KHÉP CHẶT HOÀN TOÀN TỰ NHIÊN (lips strictly closed, completely motionless mouth). Biểu cảm tập trung vào ánh mắt ngạc nhiên, lắng nghe, bừng sáng hoặc sững sờ. TUYỆT ĐỐI KHÔNG MẤP MÁY MÔI, KHÔNG NHÉP MIỆNG, KHÔNG PHÁT RA TIẾNG NÓI TỪ NHÂN VẬT NÀY.`

#### Trạng thái C: Lời Dẫn Chuyện / Độc Thoại Nội Tâm (Voice-Over / Inner Monologue)
- Áp dụng khi tiếng ngâm thơ lục bát Kiều hoặc độc thoại nội tâm vang lên trong khi nhân vật đang suy tư.
- *Cú pháp chỉ thị BẮT BUỘC*:
  `[CHỈ THỊ KHÓA KHẨU HÌNH - VOICE-OVER GUARD]: Lời thơ/tiếng ngâm là giọng dẫn chuyện Voice-Over (V.O.) từ miền ký ức / độc thoại nội tâm. Toàn bộ nhân vật trong khung hình giữ KHẨU HÌNH BẤT ĐỘNG, ĐÔI MÔI KHÉP KÍN THANH NHÃ (lips remain strictly closed, no lip movement). Cảm xúc chỉ truyền tải qua ánh mắt đăm chiêu trầm mặc và nhịp thở êm đềm.`

### 4.3. Ví dụ Sửa đổi Chuẩn hóa cho Cảnh Kim Trọng Nhặt Thoa Kim (`ep01_scene08_shot02`)

```json
{
  "scene_title": "EP01 Scene 08 Shot 02: Kim Trọng Nhặt Thoa Kim & Tiếng Kiều Gọi Vọng Qua Tường",
  "mode": "Image-to-Video",
  "character_asset_ref": "04_Assets/characters/01_Main_Protagonists/kim_trong_18yo_720p.png",
  "reference_start_frame": "Frame cuối của ep01_scene08_shot01: Cành đào vắt chiếc thoa kim.",
  "motion_prompt": "Kim Trong buoc ra vuon hoa nhin thay chiec thoa kim lap lanh tren canh dao. Chang mung ro buoc lai, hai tay nang niu ky vat truoc nguc. Dung luc ay tu ben kia buc tuong hoa vang len tieng goi e ap trong treo cua Nang Kieu. [KHOA KHAU HINH BAT BUOC]: Kim Trong la nguoi lang nghe, doi moi khep kin hoan toan khong noi (lips strictly closed, motionless mouth). Mat Kim Trong bung sang hanh phuc ngo ngang, anh mat ngap tran say dam huong len bo tuong hoa. Tuyet doi Kim Trong KHONG map may moi, khong nhep mieng. 24fps dien anh 16:9, tuyet doi khong chen chu. Âm thanh: Tiếng bước chân nhẹ trên lối sỏi, tiếng chim hót trưa hè. Giọng Thúy Kiều O.S. e ấp vọng qua bờ tường: 'Dám hỏi bên ấy có ai trông thấy chiếc thoa kim chăng?'. Tiếng Kim Trọng thở phào vui sướng (không lời). Tuyệt đối KHÔNG sinh nhạc nền, không tạp âm rác.",
  "camera_motion": "Medium tracking shot as Kim approaches peach tree, looking up attentively",
  "duration_sec": 10,
  "lip_sync_guard": {
    "dialogue_type": "off_screen",
    "speaker": "Thúy Kiều (O.S.)",
    "on_screen_subject": "Kim Trọng",
    "directive": "Lips strictly closed, motionless mouth, attentive delighted listening expression"
  }
}
```

---

## PHẦN 5: CẬP NHẬT PROMPT SCHEMA, CHARACTER BIBLE & CHECKLIST KIỂM ĐỊNH

### 5.1. Cập nhật Schema cho `02_AI_Prompts/gemini_banana_prompts.json`
Bổ sung nhánh `contextual_start_frames` cho từng Scene:
```json
{
  "contextual_start_frames": {
    "ep01_scene04_brook_and_meadow": {
      "scene_id": "ep01_scene04",
      "shot_ref": "shot01_shot02",
      "output_filename": "04_Assets/backgrounds/ep01_tieu_khe_suoi_trong_kieu_720p.png",
      "character_anchor": "thuy_kieu_maiden + thuy_van",
      "environment_anchor": "vuon_thuy_spring (brook & meadow)",
      "prompt_16x9": "Masterpiece, 8K UHD, photorealistic 16th century Annam Mac/Ming historical cinema aesthetic... [Contextual Prompt] --ar 16:9"
    },
    "ep01_scene05_dam_tien_grave": {
      "scene_id": "ep01_scene05",
      "shot_ref": "shot01_shot02",
      "output_filename": "04_Assets/backgrounds/ep01_mo_dam_tien_hoang_hon_720p.png",
      "character_anchor": "thuy_kieu_maiden",
      "environment_anchor": "dam_tien_grave_dusk",
      "prompt_16x9": "Masterpiece, 8K UHD, photorealistic 16th century historical drama... [Contextual Prompt] --ar 16:9"
    },
    "ep01_scene06_kim_trong_arrival": {
      "scene_id": "ep01_scene06",
      "shot_ref": "shot01",
      "output_filename": "04_Assets/backgrounds/ep01_kim_trong_bach_ma_suoi_lieu_720p.png",
      "character_anchor": "kim_trong",
      "environment_anchor": "willow_brook_sunset",
      "prompt_16x9": "Masterpiece, 8K UHD, photorealistic 16th century historical romance... [Contextual Prompt] --ar 16:9"
    }
  }
}
```

### 5.2. Cập nhật Schema cho `02_AI_Prompts/muse_ai_video_prompts.json`
Mỗi phần tử trong `motion_prompts` bổ sung 3 trường cấu trúc bắt buộc:
```json
{
  "acting_directive": {
    "character_name": "Kim Trọng",
    "gender": "male",
    "anti_male_tears": true,
    "expression_specs": "Tense jaw, heavy downcast gaze, stoic composure, zero tears"
  },
  "lip_sync_guard": {
    "dialogue_mode": "off_screen", // ["none", "on_screen", "off_screen", "voice_over"]
    "speaker": "Thúy Kiều (O.S.)",
    "on_screen_actor": "Kim Trọng",
    "guard_clause": "[KHOA KHAU HINH BAT BUOC]: Doi moi khep chat hoan toan, tuyet doi khong map may moi."
  },
  "motion_vector_guard": {
    "subject_vector": "Forward motion / Standing still looking up",
    "camera_vector": "Slow tracking in",
    "physics_anti_bug": "Strictly no sliding, no backward walking, no warped props"
  }
}
```

### 5.3. Bổ sung Mục Mới vào `00_Project_Bible/CHARACTER_BIBLE.md`
Cần thêm Chương VIII:
`## CHƯƠNG VIII: QUY CHUẨN DIỄN XUẤT ĐIỆN ẢNH & ANTI-MALE-TEARS DIRECTIVE (R4 & R5)`
1. Định chế Nam nhân Phong kiến: Tuyệt đối 0% nước mắt. Mọi nỗi đau thể hiện bằng cơ hàm bạnh, mắt trĩu nặng, nhìn xa xăm, hơi thở nén sâu.
2. Định chế Nữ nhân & Vi mô: Biểu cảm tinh tế, giọt lệ ngưng đọng nơi khóe mi lăn nhẹ, cấm gào khóc cường điệu.
3. Định chế Khẩu hình: Phân biệt On-screen vs Off-screen/V.O., bắt buộc khóa khẩu hình khi nghe thoại từ xa.

### 5.4. Bảng Kiểm Định Nghiệm Thu (Verification Checklists)

#### Checklist R3: Sweet-Spot Start Frame & Lỗi Vật lý
- [ ] 100% Shot mở đầu phân cảnh mới hoặc thay đổi địa điểm phải sử dụng Start Frame được tổng hợp từ Gemini Banana (kết hợp Nhân vật + Bối cảnh cụ thể ở độ phân giải 720p 16:9).
- [ ] 0% Shot nạp ảnh chân dung studio trong phòng (`thuy_kieu_maiden_16yo_720p.png` hoặc `kim_trong_18yo_720p.png`) trực tiếp vào cảnh ngoại trời.
- [ ] 100% prompt có đàn chim én bay phải chứa chỉ thị vector bay tiến về phía trước (`flying forward into the distance`), triệt tiêu 100% lỗi bay ngược.
- [ ] 100% prompt có nhân vật bước đi phải đồng bộ vector bước chân và camera lùi, triệt tiêu lỗi trượt lùi (moonwalking).
- [ ] 100% shot nối tiếp trong cùng phân cảnh phải kế thừa Tail Frame (frame 239) qua Head-Tail chaining với độ tương đồng `continuity_checker >= 65%`.

#### Checklist R4: Anti-Male-Tears & Diễn xuất Phổ quát
- [ ] 0% nam nhân (Kim Trọng, Vương Quan, Vương Ông, Từ Hải, Thúc Sinh, Thúc Ông, Hồ Tôn Hiến) có miêu tả khóc, rơi lệ, rưng rưng, nức nở trong kịch bản và prompt.
- [ ] 100% phân đoạn bi kịch của nam nhân được thay thế bằng: cơ hàm bạnh ra nghiến chặt, ánh mắt trĩu nặng, ánh nhìn xa xăm đăm chiêu, lồng ngực phập phồng nén hơi thở, bàn tay siết chặt nắm đấm.
- [ ] Nữ nhân (Kiều, Vân, Vương Bà) đạt chuẩn micro-expressions: lệ đọng khóe mi lăn nhẹ, môi khẽ run, không gào khóc cải lương.
- [ ] Quần chúng du xuân tự nhiên, tao nhã, không vẫy tay sân khấu.

#### Checklist R5: Chốt chặn Khẩu hình (Lip-Sync & Off-Screen Guard)
- [ ] 100% shot có thoại ngoài khung hình (O.S.) hoặc lời gọi từ xa (như Kim Trọng nhặt thoa kim) chứa chỉ thị `[KHOA KHAU HINH BAT BUOC]: Đôi môi khép chặt hoàn toàn tự nhiên, tuyệt đối không mấp máy môi`.
- [ ] 100% shot có giọng ngâm dẫn chuyện Voice-Over (V.O.) có chỉ thị khóa môi bất động cho toàn bộ nhân vật lọt vào ống kính.
- [ ] Nhân vật thoại trực diện on-screen có chỉ thị mở miệng vừa phải, cử động tự nhiên theo nhịp điệu phát âm.

---

*Báo cáo được hoàn thành bởi `teamwork_preview_spec_miner` phục vụ xây dựng `PROJECT.md` và triển khai các Milestone M1-M5.*
