# HƯỚNG DẪN QUY TRÌNH KỸ THUẬT: PHÂN TÍCH THẺ MẪU MÀU GỖ BẰNG AI VISION (SOP CHO AGENT)

Tài liệu này là quy trình chuẩn (SOP) cực kỳ chi tiết, được thiết kế để bất kỳ AI Agent nào khi đọc cũng có thể tự động thực hiện việc phân tích hình ảnh thẻ mẫu gỗ mới, đối chiếu thư viện và thiết lập quy trình sơn một cách chính xác tuyệt đối mà không cần sự can thiệp của con người.

---

## 📁 1. CẤU TRÚC HỆ THỐNG THƯ MỤC CỐT LÕI
Tất cả các thao tác phải được thực hiện trong thư mục gốc: `C:\antigra-DS\CLAW_LAM_VIEC\WEB-DAY-NGHE\HETHONGXEMMAU\`

*   `THEMAUGOC/`: Thư mục ĐẦU VÀO. AI sẽ quét thư mục này để tìm tệp ảnh mới (vd: `.png`, `.jpg`).
*   `HETHONGMOTA/`: Thư viện ĐỐI CHIẾU mô tả. Chứa 22 tệp mẫu chuẩn (vd: `cotswold_1.md`).
*   `QUITRINHSON/`: Thư viện CÔNG THỨC gốc. Chứa quy trình chuẩn tương ứng với từng mẫu mô tả.
*   `DANHMUCSANPHAM/`: Cơ sở dữ liệu HÓA CHẤT BTChem (174 tệp Markdown). Dùng để tra cứu mã sơn, dung môi, chất làm cứng thực tế.
*   `KETQUA/`: Thư mục ĐẦU RA. Chứa tệp báo cáo Markdown do AI sinh ra (vd: `QT_mau_moi.md`).
*   `XONG/`: Thư mục LƯU TRỮ. Nơi chuyển ảnh gốc sang sau khi hoàn tất phân tích.
*   `Prompt-phan-tich-hinh.md`: Chứa prompt chuẩn mực mà AI phải dùng để phân tích ảnh.

---

## 🤖 2. QUY TRÌNH THỰC THI CHUẨN (BẮT BUỘC TUÂN THỦ TỪNG BƯỚC)

Khi được kích hoạt với lệnh "có mẫu mới trong THEMAUGOC, thực hiện skill đi", Agent PHẢI thực hiện tuần tự 5 bước sau:

### BƯỚC 1: TIẾP NHẬN & XÁC MINH ẢNH MẪU
1. Dùng lệnh `list_dir` hoặc tương đương để liệt kê nội dung thư mục `THEMAUGOC/`.
2. Xác định tên tệp ảnh mới (ví dụ: `image123.jpg`). BẮT BUỘC giữ nguyên tên gốc của tệp ảnh, tuyệt đối không được đổi tên để đảm bảo tính đồng nhất hệ thống.

### BƯỚC 2: PHÂN TÍCH HÌNH ẢNH (AI VISION) & KIỂM ĐỊNH THỊ GIÁC CHỐNG LỆCH HƯỚNG
1. Đọc nội dung tệp `Prompt-phan-tich-hinh.md` để lấy bộ tiêu chí phân tích chuẩn.
2. Dùng công cụ đọc/xem ảnh (`view_file` hoặc tương đương) để nạp ảnh mẫu vào bộ nhớ thị giác (Vision).
3. **Quy tắc kiểm định thị giác chống nhận định sai lệch (Anti-Bias Checks):**
   - **Xóa bỏ định kiến (Zero-bias):** Không áp đặt kỹ thuật của mẫu trước lên mẫu sau. Mỗi mẫu là một bài toán riêng biệt.
   - **Xác định tính chất vân:** Bắt buộc kiểm tra họa tiết có phải là thớ gỗ tự nhiên liên tục (vân thẳng/vân núi) hay chỉ là các đốm hạt sần loang lổ ngẫu nhiên (hiệu ứng giả đá/xi măng như `Trungbay 13`).
   - **Xác định cốt nền:** Quan sát kỹ đây là gỗ tự nhiên (có ghim gỗ mở) hay gỗ công nghiệp MDF được phủ sơn bệt tạo hiệu ứng kỹ xảo.
4. Đánh giá bề mặt gỗ theo 5 tiêu chí khắt khe cốt lõi:
   - **Vân gỗ (Grain):** Sắc nét/Che khuất? Nông/Sâu? Xác định loại cốt gỗ (Sồi, Tần bì, Thông, Óc chó, MDF giả lập...).
   - **Độ phẳng bề mặt (Pore Status):** Hở ghim (Open-pore), lấp một phần (Semi-open), hay lấp đầy phẳng lỳ (Closed-pore)? Bề mặt nhẵn hay cào cước sần sùi hoặc tạo sần đốm?
   - **Độ bóng (Sheen/Gloss):** Ước lượng mức độ phản quang: Mờ sâu (5-10%), Mờ (20-30%), Bán bóng (50%), Bóng gương (90%).
   - **Màu sắc & Độ tương phản:** Xác định tông màu chủ đạo. Phân loại sắc độ (tươi sáng, trung tính, hiện đại, trầm tối cổ điển). Phần ghim gỗ/đốm màu có màu gì so với thịt phẳng?
   - **Phân loại Phong cách (Style & Decor):** Nhận diện phong cách thiết kế đại diện (VD: Japandi, Vintage Shabby Chic, Rustic Country, Industrial, Wabi-sabi...).

### BƯỚC 3: ĐỐI CHIẾU THƯ VIỆN & CHẨN ĐOÁN KỸ THUẬT (QUY TẮC ĐỐI CHIẾU NHIỀU PHƯƠNG ÁN)
1. Lập luận kỹ thuật: Bề mặt này dùng hệ Sơn Bệt (Pigmented), Lau màu Stain (thấm gỗ), Tẩy màu/Lau tim tương phản (Glaze/Ceruse/Limed), hay Sơn kỹ xảo giả đá/bê tông (Faux finish)?
2. **Quy tắc đối chiếu loại trừ:**
   - Tìm kiếm trong `HETHONGMOTA/`: Quét và chọn ra **ít nhất 3 mẫu** có nét tương đồng trong thư mục này.
   - Lập bảng so sánh loại trừ dựa trên cấu trúc vân, màu nền và kỹ thuật để tìm ra 1 mẫu chuẩn có hiệu ứng tương đồng nhất (Tuyệt đối không chốt ngay mẫu đầu tiên khi chưa so sánh loại trừ).
3. Liên kết quy trình: Khi đã chốt được mã mẫu tương đồng (ví dụ: `cotswold_3` hoặc `Trungbay 13`), hãy tham chiếu sang quy trình gốc tương ứng nằm trong thư mục `QUITRINHSON/` để lấy khung kỹ thuật nền tảng.

### BƯỚC 4: THIẾT LẬP BẢNG CÔNG THỨC CHI TIẾT (LẤY TỪ DANHMUCSANPHAM)
Dựa trên quy trình nền tảng, Agent phải tra cứu các hóa chất thực tế của nhà máy BTChem tại thư mục `DANHMUCSANPHAM/` để thiết lập bảng thi công.
1. Khớp nối các bước với hóa chất thật: (Ví dụ: Lót thì dùng `Lót PU FD 0212 TN`, cứng `FD 2106L`, dung môi `PU TXXT`. Màu nền dùng `Tinh màu Vàng BT` hoặc `Stain K25`).
2. Nếu là gỗ Thông / Gỗ nhiều nhựa: **Bắt buộc** chèn bước chặn tinh dầu/Tannin bằng Primer trước khi lót.
3. **Áp dụng bí quyết hiệu chỉnh thực tế (nhà máy Việt Nam):** Nếu phát hiện gỗ lệch màu, loang lổ hoặc ghim gỗ nông, hãy đề xuất các giải pháp kỹ thuật ở đúng công đoạn:
   - *Dặm màu sửa lỗi mộc:* Thực hiện trực tiếp trên gỗ mộc thô chưa sơn để xử lý vết lệch màu hoặc ghép mộc.
   - *Dặm màu hiệu chỉnh / Lau màu Pad Stain (khử đỏ/vàng):* Thực hiện trên lớp sơn lót chặn không màu (clear sealer) đã chà nhám mịn để tránh loang màu vào thớ gỗ.
   - *Phun màu loãng nhiều lần (multi-pass):* Cho gỗ ghim nông để bảo tồn vân gỗ tự nhiên mà vẫn lên đều màu.
4. Xuất kết quả dưới định dạng BẢNG MARKDOWN chứa các cột sau:
   - **Bước** (Số thứ tự)
   - **Quy trình thực hiện**
   - **Loại vật tư BTChem đề xuất**
   - **Tỉ lệ pha (Sơn : Cứng : Dung môi)** (Lấy chính xác từ file mô tả hóa chất)
   - **Thiết bị & Phương pháp thi công**
   - **Thời gian khô tối thiểu**
   - **Ghi chú kỹ thuật**

### BƯỚC 5: XUẤT BÁO CÁO VÀ DỌN DẸP HỆ THỐNG
1. Tạo tệp báo cáo tổng hợp: Ghi toàn bộ nội dung phân tích (từ Bước 2 đến Bước 4) vào một file mới định dạng `.md`.
2. Lưu file báo cáo vào thư mục `KETQUA/`. **QUAN TRỌNG:** Tên file báo cáo và tên quy trình bên trong báo cáo bắt buộc phải ĐẶT THEO ĐÚNG TÊN FILE ẢNH GỐC (chỉ thay đuôi thành `.md`). Ví dụ: ảnh là `image123.jpg` thì file kết quả phải là `image123.md`.
3. Dọn dẹp thư mục: Sử dụng lệnh di chuyển tệp (ví dụ: `Move-Item -Force`) để chuyển tệp ảnh mẫu gốc từ `THEMAUGOC/` sang thư mục lưu trữ `XONG/` với tên giữ nguyên. **Tuyệt đối không để lại bất kỳ tệp nào trong THEMAUGOC** sau khi xử lý xong.
4. (Tùy chọn) Ghi log thay đổi vào các tệp nhật ký hệ thống (như `walkthrough.md` hoặc `memory`).

---
**Tóm tắt mệnh lệnh thực thi cho Agent:** 
*Quét `THEMAUGOC/` -> Phân tích ảnh với `Prompt-phan-tich-hinh.md` -> Tìm mẫu khớp trong `HETHONGMOTA/` -> Lấy công thức nền từ `QUITRINHSON/` -> Ráp hóa chất thực tế từ `DANHMUCSANPHAM/` -> Lưu báo cáo vào `KETQUA/` -> Chuyển ảnh sang `XONG/`.*