STUDIOZ AI CHO PHOTOSHOP — HƯỚNG DẪN CÀI ĐẶT (bản 1.1.0)
=========================================================

Dùng StudioZ AI (tạo ảnh, chỉnh ảnh bằng câu lệnh, bộ lọc AI) ngay trong Photoshop.
Phí mỗi ảnh trừ vào số dư ví StudioZ, giống như trên web.

YÊU CẦU
- Adobe Photoshop 2023 (bản 24.2) trở lên, trên macOS hoặc Windows.
- Tài khoản StudioZ đã bật StudioZ AI.

TRONG THƯ MỤC NÀY
- Thư mục "StudioZ AI"     : plugin, chép nguyên thư mục này vào Photoshop.
- HUONG-DAN-CAI-DAT.txt    : hướng dẫn này.


---------------------------------------------------------
BƯỚC 1. TẮT PHOTOSHOP
---------------------------------------------------------
Thoát hẳn Photoshop trước khi chép (macOS: Cmd + Q; Windows: đóng cửa sổ Photoshop).


---------------------------------------------------------
BƯỚC 2. CHÉP THƯ MỤC "StudioZ AI" VÀO THƯ MỤC Plug-ins
---------------------------------------------------------
Chép NGUYÊN thư mục "StudioZ AI" (không chép từng tệp bên trong) vào thư mục Plug-ins của Photoshop.

WINDOWS
  1. Mở File Explorer, vào:
        C:\Program Files\Adobe\Adobe Photoshop 2026\Plug-ins
     (đổi "2026" thành đúng năm của bản Photoshop trên máy: 2023, 2024, 2025…)
  2. Dán thư mục "StudioZ AI" vào đó.
  3. Windows hỏi quyền quản trị: bấm "Tiếp tục" (Continue).

macOS
  1. Mở Finder › Ứng dụng (Applications) › Adobe Photoshop 2026 › Plug-ins
     (hoặc trong Finder bấm Cmd + Shift + G, dán:  /Applications/Adobe Photoshop 2026/Plug-ins )
     Đổi "2026" thành đúng năm của bản Photoshop trên máy.
  2. Kéo thư mục "StudioZ AI" vào thư mục Plug-ins.
  3. macOS hỏi mật khẩu máy: nhập mật khẩu đăng nhập máy Mac để cho phép.

Đúng vị trí sẽ là:
  …/Adobe Photoshop 20xx/Plug-ins/StudioZ AI/manifest.json

Máy có nhiều bản Photoshop: chép vào thư mục Plug-ins của bản bạn đang dùng.


---------------------------------------------------------
BƯỚC 3. MỞ PANEL TRONG PHOTOSHOP
---------------------------------------------------------
  1. Mở Photoshop.
  2. Menu Plugins (Trình cắm thêm) › StudioZ AI › StudioZ AI.
  3. Panel có thể kéo gắn vào cột panel bên phải như các panel khác.


---------------------------------------------------------
BƯỚC 4. KẾT NỐI TÀI KHOẢN STUDIOZ
---------------------------------------------------------
  1. Trên trình duyệt, đăng nhập studioz.vn › StudioZ AI › bấm nút "Ps Photoshop".
  2. Bấm "Tạo mã kết nối", rồi "Sao chép mã" (mã bắt đầu bằng szp_ , chỉ hiện một lần).
  3. Dán mã vào panel trong Photoshop › bấm Kết nối.
  Muốn ngắt một máy: vào lại mục "Ps Photoshop" trên web và thu hồi mã đó.


---------------------------------------------------------
DÙNG NHANH
---------------------------------------------------------
- Ảnh nguồn: vùng chọn, layer hiện tại hoặc cả ảnh. Ảnh tham chiếu: tối đa 3 ảnh (vùng chọn, layer hoặc tệp trên máy).
- Chất lượng: chọn 1K, 2K hoặc 4K trước. Ô "Mô hình AI" chỉ hiện các mô hình ra được đúng chất lượng đó,
  kèm giá mỗi ảnh ở chất lượng đó. Mức có ghi "gợi ý" là chất lượng cao nhất đang hỗ trợ.
  Danh sách mô hình và giá lấy trực tiếp từ StudioZ, nên mô hình mới được bật trên web sẽ tự có trong panel.
- Ảnh tạo xong được đặt thành layer mới trên ảnh đang mở; mục "Ảnh đã tạo" giữ lại các ảnh vừa làm.
- Hết tiền: bấm vào số dư ở góc panel để nạp tiền ngay trong panel.


---------------------------------------------------------
CẬP NHẬT BẢN MỚI
---------------------------------------------------------
Tắt Photoshop › xoá thư mục "StudioZ AI" cũ trong Plug-ins › chép thư mục "StudioZ AI" mới vào › mở lại Photoshop.
Mã kết nối vẫn giữ nguyên, không cần nhập lại.


---------------------------------------------------------
GỠ CÀI ĐẶT
---------------------------------------------------------
Tắt Photoshop › xoá thư mục "StudioZ AI" trong Plug-ins.


---------------------------------------------------------
GẶP LỖI
---------------------------------------------------------
- Không thấy StudioZ AI trong menu Plugins:
    · Kiểm tra tệp manifest.json nằm ngay trong Plug-ins/StudioZ AI/ (không bị lồng thêm một thư mục nữa).
    · Đã tắt hẳn và mở lại Photoshop chưa.
    · Photoshop phải từ bản 2023 (24.2) trở lên: menu Trợ giúp › Giới thiệu Photoshop để xem bản.
- Hiện HAI panel StudioZ AI: máy đã cài trước bằng tệp .ccx. Mở ứng dụng Creative Cloud › Plugins (Trình cắm thêm)
  › Quản lý plugin › gỡ "StudioZ AI", chỉ giữ bản chép thư mục (hoặc ngược lại).
- Panel báo mã kết nối sai / hết hạn: tạo mã mới trên web (Bước 4) và dán lại.
- Không chép được vào Plug-ins (báo không đủ quyền): dùng tài khoản quản trị của máy, hoặc chép bằng tay khi được hỏi mật khẩu.

Cách khác: nếu máy có ứng dụng Creative Cloud, có thể bấm đúp tệp StudioZ-AI.ccx (tải ở StudioZ AI › Photoshop trên web)
để Creative Cloud tự cài. Chỉ dùng MỘT trong hai cách.
