💻 Desktop ẩn: Chạy app (desk_launch)

Nhóm palette: Desktop · type: desk_launch · cổng: 1 vào · 1 ra

Mục đích

Bản đang bán: Desktop ẩn đang tắtFlag ENABLE_HIDDEN_DESKTOP = False trong app/feature_flags.py. Palette không hiện nhóm Desktop. Properties hiện “Desktop ẩn đang tắt tạm thời.” Không quảng cáo USP “chạy trên desktop ẩn” cho đến khi bật flag. Phần dưới mô tả hành vi khi bật lại (engine vẫn còn).

Khi bật lại: tạo Windows Desktop tên desktop_name (mặc định botdesk1), desk.launch(exe, args, cwd), poll cửa sổ theo title/class. Thiếu exe hoặc hết timeout không thấy cửa sổ → raise (dừng job).

Từng setting

Ô trên Properties	Key	Mặc định	Ý nghĩa / cách dùng
Delay sau (ms)	`delay_after_ms`	tuỳ node	Chờ thêm sau khi node chạy xong rồi mới sang node kế. Dùng để UI kịp hiện, ảnh kịp load. Không có ở node `note`, `end`, `delay_random`, `start`.
Desktop name	`desktop_name`	botdesk1	Tên desk ảo.
Exe	`exe`	—	Bắt buộc.
Args	`args`	—	Tham số dòng lệnh.
CWD	`cwd`	—	Thư mục làm việc.
Match mode	`match_mode`	title_contains	`title_contains` / `title_exact`.
Title chứa	`title`	—	Lọc cửa sổ trên desk.
Class chứa	`cls`	—	Class Win32.
Wait (ms)	`wait_ms`	2000	Chờ trước khi poll.
Timeout (ms)	`timeout_ms`	8000	Hết giờ không thấy cửa sổ → raise.
Poll (ms)	`poll_ms`	300	Khoảng dò cửa sổ.

Ví dụ thực tế

A. Launch exe trên botdesk1, match title_contains, wait 2000 / timeout 8000 / poll 300.
B. Thiếu path exe hoặc hết timeout không thấy cửa sổ → job dừng (raise), không rẽ nhánh Lỗi như Start exe.

Lưu ý

ResizeResize cửa sổ không hỗ trợ hidden desktop (raise).

Xem thêm: Nhóm Desktop ẩn

💻 Desktop ẩn: Chạy app (desk_launch)

Nhóm palette: Desktop · type: desk_launch · cổng: 1 vào · 1 ra

Mục đích

Từng setting

Ô trên Properties	Key	Mặc định	Ý nghĩa / cách dùng
Delay sau (ms)	`delay_after_ms`	tuỳ node	Chờ thêm sau khi node chạy xong rồi mới sang node kế. Dùng để UI kịp hiện, ảnh kịp load. Không có ở node `note`, `end`, `delay_random`, `start`.
Desktop name	`desktop_name`	botdesk1	Tên desk ảo.
Exe	`exe`	—	Bắt buộc.
Args	`args`	—	Tham số dòng lệnh.
CWD	`cwd`	—	Thư mục làm việc.
Match mode	`match_mode`	title_contains	`title_contains` / `title_exact`.
Title chứa	`title`	—	Lọc cửa sổ trên desk.
Class chứa	`cls`	—	Class Win32.
Wait (ms)	`wait_ms`	2000	Chờ trước khi poll.
Timeout (ms)	`timeout_ms`	8000	Hết giờ không thấy cửa sổ → raise.
Poll (ms)	`poll_ms`	300	Khoảng dò cửa sổ.

Ví dụ thực tế

A. Launch exe trên botdesk1, match title_contains, wait 2000 / timeout 8000 / poll 300.
B. Thiếu path exe hoặc hết timeout không thấy cửa sổ → job dừng (raise), không rẽ nhánh Lỗi như Start exe.

Lưu ý

ResizeResize cửa sổ không hỗ trợ hidden desktop (raise).

Xem thêm: Nhóm Desktop ẩn