FIX: Carla sử dụng bridge có midikeyboard

md/52_CARLA_BRIDGE.md

@@ -93,11 +93,13 @@ xem §8).
 
 1. Tải: <https://github.com/falkTX/Carla/releases> (bản `win64`).
 2. Giải nén ra bất kỳ đâu (VD `D:\Tools\Carla\`, chứa `carla.exe`).
-3. Mở app → **Plugin Manager** → section **"Carla Bridge (VSTi native GUI)"** →
-   nút **"Định vị Carla..."** → chọn thư mục chứa `carla.exe` (hoặc chính file
-   `carla.exe`).
+3. Khai báo 1 lần (2 cách, tùy chọn 1):
+   - **Nút bấm**: Plugin Manager → section **"Carla Bridge (VSTi native GUI)"** →
+     **"Định vị Carla..."** → chọn thư mục chứa `carla.exe` (hoặc chính file).
+   - **Nhập tay**: ô text trong section đó → nhập `D:/Tools/Carla` → **Lưu**.
 4. App lưu vào `storage/carla_path.json` → cache detect bị xóa → nút
-   **"Carla Bridge"** hiện trong dropdown nút Synth.
+   **"Carla Bridge"** hiện trong dropdown nút Synth + **tự động mở Carla**
+   khi chọn VSTi.
 
 ### 3.1 Thứ tự phát hiện `carla_local`
 
@@ -119,10 +121,19 @@ body: { "carla_path": "D:/Tools/Carla" }      (thư mục HOẶC file exe)
 
 ## 4. Luồng sử dụng end-to-end (Windows)
 
-1. **Nút Synth** (track strip / btnSynth) → chọn **"🎛 Carla Bridge (mở Carla.exe)"**
-   → app spawn `carla.exe` (ưu tiên `carla-single <plugin>` nếu chọn kèm plugin).
-2. Trong Carla: **Add Plugin** → chọn VSTi (Kontakt, Nexus, Vital...) → native GUI
-   hiện ra → chỉnh âm, chọn bank/preset của plugin.
+1. **Nút Synth** → chọn **VSTi** trong danh sách → app **TỰ ĐỘNG gọi Carla**:
+   sinh file project `.carxs` (định dạng XML chính thức của Carla —
+   `carla.exe [FILE]` nhận project file) chứa node
+   `<Plugin><Info><Type>VST3</Type><Binary>path</Binary>...</Info></Plugin>`
+   → `carla.exe <project.carxs>` → Carla mở lên **plugin đã load sẵn** kèm
+   **on-screen MIDI keyboard** (`PixmapKeyboard`).
+   - VST3 (file `.vst3` hoặc folder `X.vst3` Windows): auto-load qua `.carxs`.
+   - VST2 (`.dll`/`.so` ngoài `.vst3`): không auto-load tin cậy (cần uniqueID)
+     → mở Carla trống để user **Add Plugin** thủ công.
+   - Project `.carxs` nằm `{STORAGE_DIR}/carla_projects/`, tự dọn sau 1 ngày.
+2. Trong Carla: native GUI của VSTi hiện ra → **chọn instrument/preset** của
+   plugin → **bật ARM** trên track trong app (tùy chọn) → **bấm phím trên
+   keyboard ảo của Carla** để preview realtime (âm thật qua audio device).
 3. **Save preset** bằng nút của CHÍNH plugin (không dùng project save của Carla)
    → file `.vstpreset`.
 4. Trong app: dropdown Synth → **"⬆ Upload preset (từ Carla...)"** → chọn file