Cách chạy workflow bằng RunMacro Runner an toàn

Điều kiện cần

• File .qmacro tồn tại, tải hoàn chỉnh và đến từ nguồn bạn có thể đánh giá; nếu có mật khẩu, cần nhận đúng mật khẩu từ tác giả.
• Điền giá trị cho mọi input hiển thị; file Dòng TXT phải tồn tại và có ít nhất một dòng dữ liệu.
• Chế độ Trình duyệt cần CSV/Google Sheet có cột ID đúng provider, trình duyệt/provider đang hoạt động và API/token/executable khi giao diện yêu cầu.
• Báo cáo, Telegram, Cloud/Gist và Lập lịch chạy cần được bật/cấu hình trong Cài đặt Runner và ứng dụng phải có quyền ghi thư mục đích.

Chế độ hỗ trợ

• RunMacro Runner — Đây là giao diện chuyên dụng để mở RunMacro package. Chế độ Desktop điều khiển màn hình thật; Chế độ Trình duyệt chạy Chrome/CDP theo profile. Khóa mode, số luồng hoặc browser chỉ thể hiện ý định của tác giả trong UI, không phải bảo đảm cưỡng chế tuyệt đối.

Chức năng này làm gì

RunMacro Runner mở gói .qmacro, dựng biểu mẫu từ metadata, áp dụng input đã liên kết vào workflow đã giải mã và chạy bằng Chế độ Desktop hoặc Trình duyệt. Gói app-key mở im lặng; gói mật khẩu yêu cầu mật khẩu trước khi nạp lệnh. Với RunMacro package lạ có lệnh nguy hiểm, Runner tự bật Safe Mode để bỏ qua các lệnh đó trừ khi người dùng chủ động tắt và xác nhận. Runner cho phép lặp, điều chỉnh tốc độ, tạm dừng/dừng, chạy nhiều profile Trình duyệt, import CSV hoặc Google Sheet, theo dõi bước hiện tại, xem log và chẩn đoán. Khi bật tạo báo cáo, lượt Desktop hoàn tất chỉ ghi JSON; lượt Trình duyệt đa profile ghi JSON và cập nhật CSV kết quả. JSON dùng tên theo RunMacro package và ngày nên lượt sau cùng ngày có thể ghi đè lượt trước; chi tiết Trình duyệt chỉ giữ 1.000 outcome mới nhất. Lập lịch chạy, Cloud/Gist, config chạy và Telegram hỗ trợ vận hành lặp lại.

Khi nào nên dùng

• Khi nhận một file RunMacro package đã đóng gói và chỉ cần điền dữ liệu nghiệp vụ rồi chạy theo cấu hình tác giả cho phép.
• Khi cần chạy Trình duyệt trên danh sách profile từ CSV hoặc Google Sheet với nhiều cửa sổ và báo cáo từng profile.
• Khi cần lịch một lần, hằng ngày, hằng tuần, theo khoảng thời gian, đếm ngược hoặc nối sau lịch khác.
• Khi cần kiểm tra cập nhật, tải/upload RunMacro package qua Gist, nhập/xuất config chạy hoặc gửi kết quả qua Telegram.

Khi nào không nên dùng

• Không dùng Runner để sửa lệnh, selector hoặc cấu trúc workflow; hãy quay lại PMacro nguồn trong Studio.
• Không tắt Safe Mode cho RunMacro package lạ nếu chưa hiểu rõ từng lệnh nguy hiểm được liệt kê.
• Không dùng Xuất config như kho bí mật vì file JSON có thể chứa input hiện tại, đường dẫn và dữ liệu profile.
• Không chọn Trình duyệt nếu chưa có profile source và môi trường provider/API cần thiết; Desktop phù hợp hơn cho điều khiển màn hình trực tiếp.

Các bước cấu hình

1. Mở RunMacro Runner và bấm Mở RunMacro package hoặc nhấn Ctrl+O để chọn file. Bạn cũng có thể chọn một file khác trong cùng cửa sổ khi Runner đang rảnh.
2. Nếu Runner hỏi mật khẩu, nhập mật khẩu RunMacro package. Gói app-key mở không cần hỏi; kiểm tra tên workflow, phiên bản và mô tả sau khi nạp.
3. Nếu xuất hiện thẻ cảnh báo lệnh nguy hiểm, đọc danh sách và giữ Bật Safe Mode cho RunMacro package không phải do máy này tạo.
4. Điền tất cả ô trong Biến đầu vào. Chọn thư mục/file, file TXT, checkbox hoặc select theo form do tác giả đóng gói.
5. Chọn Chế độ, Lặp lại và Tốc độ; khóa của tác giả là trạng thái UI dự kiến, nhưng cache, config import hoặc lịch đã lưu có thể áp lại mode, số luồng hay browser và một số control khác vẫn chỉnh được. Giá trị lặp 0 hiển thị vô hạn.
6. Nếu dùng Trình duyệt, mở Cấu hình chạy ngầm, chọn số cửa sổ, provider, port/viewport, cách xếp và import danh sách profile từ CSV hoặc Google Sheet.
7. Chọn hoặc bỏ Ghi nhớ thông tin cho lần chạy sau. Runner không ghi nhớ input có loại password, nhưng vẫn nên kiểm tra dữ liệu trước khi chia sẻ config.
8. Bấm Chạy. Dùng Tạm dừng/Tiếp tục hoặc nút Dừng xuất hiện trên nút chạy; theo dõi trạng thái, bước hiện tại, thời gian và số bước.
9. Mở Xem log khi cần. Desktop có báo cáo JSON nhưng không tạo CSV ở đường hoàn tất hiện tại. Với Trình duyệt đa profile, xem Kết quả theo profile, JSON và CSV kết quả; bảng chi tiết chỉ giữ 1.000 outcome mới nhất.
10. Khi lượt chạy đã ổn định, dùng Quản lí lịch, Upload/Download/Kiểm tra cập nhật, Telegram hoặc Nhập/Xuất config để lặp lại quy trình có kiểm soát. Sao lưu JSON trước lượt khác cùng ngày nếu cần giữ lịch sử.

Giải thích từng tùy chọn

Kết quả mong đợi

Runner nạp workflow, áp dụng input binding và chuyển trạng thái từ Sẵn sàng sang Đang chạy rồi Hoàn tất, Hoàn tất có lỗi, Đã dừng hoặc Lỗi. Khóa của tác giả định hướng UI nhưng không bảo đảm chống mọi cache/config/lịch ghi đè. Khi bật báo cáo, Desktop ghi JSON Results_*.json nhưng không tạo CSV; Trình duyệt đa profile còn cập nhật CSV và hiển thị tổng OK/lỗi/bỏ qua. JSON cùng RunMacro package trong cùng ngày có thể bị ghi đè, còn chi tiết Trình duyệt giữ tối đa 1.000 outcome mới nhất.

Ví dụ thực tế

Giới hạn và trường hợp lỗi

• Runner không chỉnh sửa workflow; tên trường, binding, lệnh và selector phải được sửa trong PMacro nguồn rồi xuất RunMacro package mới.
• Khóa mode/số luồng/browser của tác giả chỉ là ý định UI, không phải ranh giới bảo mật. Cache theo path, config import hoặc lịch có thể áp giá trị lên các trường khóa và một số control liên quan vẫn chỉnh được.
• Gói đặt mật khẩu không mở nếu thiếu hoặc sai mật khẩu; gói app-key mở được bởi RunMacro tương thích và không nên được xem là bí mật truy cập.
• RunMacro package hiện không có chữ ký tác giả; kiểm tra toàn vẹn mã hóa không thay thế việc xác minh nguồn file.
• Safe Mode chỉ bỏ qua các lệnh mà bộ quét hiện nhận diện là nguy hiểm; nó không chứng minh toàn bộ workflow vô hại.
• Nếu người dùng tắt Safe Mode và xác nhận, RunMacro package lạ có thể chạy các hành động nguy hiểm bằng quyền của phiên RunMacro hiện tại.
• Mọi input hiển thị đều được kiểm tra có giá trị; checkbox bắt buộc phải bật để vượt kiểm tra required và file TXT rỗng làm lượt chạy dừng trước khi bắt đầu.
• Cache nhận diện RunMacro package bằng đường dẫn tuyệt đối, không theo package ID: di chuyển file làm mất cache cũ, còn thay gói khác tại cùng path sẽ kế thừa cache. the local package configuration cache không lưu profile rows/source nhưng lưu các trường mode/provider/local-profile riêng lẻ và hiện có thể ghi provider_token vào settings.json. Xuất config là JSON thường và có thể chứa input, đường dẫn, URL, profile rows và profile source.
• Payload config xuất không chứa provider token, nhưng đây không phải cơ chế xóa bí mật khỏi các input tùy chỉnh; phải tự làm sạch và kiểm tra file trước khi chia sẻ.
• Báo cáo có redaction cho chuỗi nhạy cảm nhưng vẫn có thể chứa đường dẫn local, tên RunMacro package, output, nhãn profile, lý do lỗi và metadata vận hành.
• File chỉ được tạo khi bật báo cáo và thư mục đích ghi được. Desktop hoàn tất ghi JSON nhưng không tạo CSV; Trình duyệt đa profile có thêm CSV. JSON dùng tên RunMacro package + ngày nên lượt sau cùng ngày có thể ghi đè lượt trước, và chi tiết Trình duyệt chỉ giữ 1.000 outcome mới nhất.
• Trình duyệt yêu cầu profile source có ID đúng provider; API URL, token, executable, ứng dụng anti-detect, SDK hoặc license có thể khác nhau theo provider.
• Lịch theo giờ chỉ kích hoạt khi RunMacro đang mở và Lập lịch chạy bật. Chỉ một lịch startup được active; bản Microsoft Store không truyền file macro qua StartupTask nên dùng lịch theo giờ.
• Kiểm tra cập nhật và đồng bộ cần Gist ID, token, channel/ID khớp và mạng. So sánh update dùng version/hash công khai của metadata + lệnh gốc, không so content hash payload mã hóa; thay đổi chỉ ở macro con/ảnh có thể bị bỏ sót. Lỗi kiểm tra trước chạy có thể tiếp tục bản local.
• Tạm dừng và dừng phụ thuộc điểm kiểm tra của engine/lệnh hiện tại; một thao tác hệ điều hành hoặc provider đang chặn có thể không phản hồi tức thì.
• Chụp lỗi toàn trang Trình duyệt dùng kích thước nội dung hiện tại, không cuộn hoặc đổi viewport, và có thể fallback về ảnh viewport nếu đọc kích thước thất bại.

Mẹo & lỗi thường gặp

Thông tin kiểm chứng

• ui/qmacro_runner_window.py
• ui/qmacro_scheduler_dialog.py
• core/qmacro_scheduler.py
• core/qmacro_sync.py
• core/run_report.py
• tests/test_qmacro_scheduler.py

Lệnh liên quan