# SKILL HUẤN LUYỆN HỆ THỐNG: train-skill.md

Tài liệu này hướng dẫn quy trình huấn luyện (training) hệ thống tra cứu mẫu sơn gỗ bằng cách phân tích tập hợp ảnh mẫu chuẩn, lưu mô tả nhận diện và chuẩn bị các file quy trình trống để kỹ thuật viên tự ghi công thức thực tế.

---

## 📁 1. Cấu Trúc Thư Mục Huấn Luyện (Training Structure)

- **Thư mục ảnh huấn luyện đầu vào:** `C:\antigra-DS\CLAW_LAM_VIEC\WEB-DAY-NGHE\HETHONGXEMMAU\HINHMAU-TRAINNING\`
- **Thư mục lưu mô tả nhận diện (AI Vision):** `C:\antigra-DS\CLAW_LAM_VIEC\WEB-DAY-NGHE\HETHONGXEMMAU\HETHONGMOTA\`
- **Thư mục lưu quy trình sơn trống:** `C:\antigra-DS\CLAW_LAM_VIEC\WEB-DAY-NGHE\HETHONGXEMMAU\QUITRINHSON\`
- **Thư mục lưu ảnh sau huấn luyện:** `C:\antigra-DS\CLAW_LAM_VIEC\WEB-DAY-NGHE\HETHONGXEMMAU\XONG\Trainfile\`
- **Prompt hướng dẫn phân tích:** `C:\antigra-DS\CLAW_LAM_VIEC\WEB-DAY-NGHE\HETHONGXEMMAU\Prompt-phan-tich-hinh.md`

---

## 🤖 2. Các Bước Thực Hiện Huấn Luyện (Workflow Steps)

### Bước 1: Quét và phân tích ảnh trong `HINHMAU-TRAINNING`
- Quét toàn bộ danh sách các ảnh định dạng `.png` hoặc `.jpg` có trong thư mục `HINHMAU-TRAINNING`.
- Đối với mỗi tệp ảnh, sử dụng mô hình AI Vision kết hợp với prompt tiêu chuẩn tại `Prompt-phan-tich-hinh.md` để đánh giá bề mặt gỗ theo 5 tiêu chí khắt khe cốt lõi:
  1. **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ó...).
  2. **Độ 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?
  3. **Độ 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%).
  4. **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ỗ có màu gì so với thịt phẳng?
  5. **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, Mid-Century Modern...).

### Bước 2: Ghi mô tả nhận diện vào `HETHONGMOTA`
- Tạo file mô tả tương ứng dưới dạng `.md` trong thư mục `HETHONGMOTA`.
- **Quy tắc đặt tên file:** Tên file mô tả phải trùng khớp hoàn toàn với tên file hình gốc (chỉ thay đổi đuôi mở rộng sang `.md`).
  *Ví dụ: Ảnh `QT_PG_06_PU_TrangMo_TrongNha_M30.png` -> File mô tả `QT_PG_06_PU_TrangMo_TrongNha_M30.md`.*

### Bước 3: Tạo file quy trình trống trong `QUITRINHSON`
- Tạo một file Markdown trống hoàn toàn (hoặc chỉ chứa tiêu đề tên quy trình ở dòng đầu tiên) có tên tương tự trong thư mục `QUITRINHSON`.
- **Mục đích:** Để kỹ thuật viên tự tay điền các bước thi công thực tế và tỉ lệ pha chế hóa chất thực nghiệm vào file này, làm cơ sở dữ liệu tra cứu chuẩn cho AI sau này.

### Bước 4: Di chuyển ảnh đã huấn luyện vào `XONG/Trainfile`
- Tạo thư mục đích: `C:\antigra-DS\CLAW_LAM_VIEC\WEB-DAY-NGHE\HETHONGXEMMAU\XONG\Trainfile\`.
- Di chuyển (hoặc sao chép rồi xóa sạch tệp gốc ở thư mục nguồn) toàn bộ các tệp ảnh mẫu gốc từ `HINHMAU-TRAINNING` vào thư mục này để lưu trữ tập trung và làm sạch thư mục chờ huấn luyện.


---

*Tài liệu huấn luyện hệ thống - Cập nhật ngày 17/07/2026.*