Tài liệu

Tài liệu RunMacro

Tạo robot đầu tiên, rồi tiến xa theo nhu cầu.

Hướng dẫn rõ ràng từng bước để tạo, chạy và cải thiện robot cho công việc máy tính lặp lại.

Ctrl K

🎬 Tính năng

Ghi thao tác web thành workflow bằng Smart Record

Chuyển sang Chế độ Trình duyệt, mở Smart Record, bấm nút tròn đỏ, chờ đếm ngược 5 giây rồi thao tác bình thường trong Chrome. Bấm Dừng ghi, xóa dòng không cần, rồi bấm Thêm vào macro hiện tại.

Điều kiện cần

Workspace đang ở Chế độ Trình duyệt (Chrome CDP). Ở mode khác nút Smart Recorder bị ẩn.
Tiện ích RunMacro Smart HTML đã được nạp vào cửa sổ Chrome dùng để ghi.
Có một cửa sổ Chrome record đang mở (nút Mở Chrome trong popup sẽ mở lại nếu chưa có).
Chế độ ghi bằng AI cần license trả phí. Bản ghi thường không gọi AI và không dùng credit, nhưng Smart Record vẫn thuộc Chế độ Trình duyệt nên cần license để mở.

Chế độ hỗ trợ

Chế độ Browser — Chỉ dùng được ở Chế độ Trình duyệt. Trong một phiên ghi, RunMacro chạy song song ba đường thu: recorder trong trang web, watcher cho popup tiện ích mở rộng (vì content script không chèn được vào đó), và một đường dự phòng ghi click desktop — dòng loại này hiện trong bảng với tiền tố [Desktop candidate].

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

Smart Record theo dõi những gì bạn làm trong cửa sổ Chrome do RunMacro điều khiển — click, gõ chữ, chọn dropdown, scroll, nhấn phím, chuyển trang, mở tab mới — rồi đưa từng hành động vào một bảng để bạn xem lại. Khi bấm lưu, RunMacro biên dịch cả chuỗi thành lệnh Smart HTML / CDP và thêm vào cuối macro đang mở. Selector được lấy trực tiếp từ trang, không do AI đoán.

Khi nào nên dùng

Trang web có nhiều bước và bạn không muốn dò selector từng ô bằng tay.
Muốn có bản nháp workflow đúng thứ tự để sửa lại cho gọn.
Cần ghi cả thao tác trong popup của tiện ích mở rộng (ví dụ cửa sổ xác nhận của ví).
Luồng đăng nhập / điền form dài, gõ tay lại từng lệnh sẽ mất nhiều thời gian.

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

Tự động hóa phần mềm desktop — dùng nút Record thường ở Chế độ Desktop.
Luồng đi qua iframe khác tên miền hoặc popup OAuth (ví dụ nút "Continue with Google") — hiện chưa ghi/chạy lại ổn định.
Phiên ghi rất dài: xem mục hạn chế bên dưới về lỗi badge ON/OFF.

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

Chuyển workspace sang Chế độ Trình duyệt, rồi bấm nút Smart Recorder (biểu tượng chấm đỏ) trên thanh công cụ.
Hộp chọn chế độ mở ra: chọn Smart recorder (không dùng AI credit) hoặc Smart recorder bằng AI. Với bản AI, chọn thêm provider và mức Nhanh & tiết kiệm / Thông minh. Bấm Bắt đầu ghi.
Popup ghi mở ngay. Nếu chưa có cửa sổ Chrome record, bấm Mở Chrome.
Bấm nút tròn đỏ lớn. Một đồng hồ đếm ngược 5 giây chạy để tiện ích kịp gắn vào trang — chưa thao tác gì trong Chrome lúc này.
Khi dòng trạng thái chuyển sang xanh, thao tác bình thường trong Chrome. Mỗi hành động hiện thành một dòng trong bảng.
Bấm Dừng ghi. RunMacro chờ các tab xác nhận đã gửi hết hành động cuối.
Xem lại bảng, chọn dòng thừa rồi bấm Xóa dòng. Muốn ghi thêm thì bấm Ghi tiếp.
Kiểm tra hai ô tùy chọn ở dưới, rồi bấm Thêm vào macro hiện tại.

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

Smart recorder (không dùng AI credit)

Bản ghi thường: selector lấy trực tiếp từ trang, không gọi AI và không dùng credit. Smart Record vẫn cần license Chế độ Browser. Đây là lựa chọn mặc định.

Smart recorder bằng AI

Gọi AI một lần duy nhất lúc lưu để đặt tên nhóm và viết tóm tắt. AI không sửa selector, không đổi thứ tự, không đổi giá trị. Cần license trả phí.

MODEL (PROVIDER) và LEVEL

Chỉ hiện khi chọn bản AI. Provider gồm openai, anthropic, gemini, deepseek, openrouter. LEVEL có Nhanh & tiết kiệm hoặc Thông minh (mặc định Thông minh).

Chờ + tự thử lại khi chuyển trang (Vòng lặp)

Bật sẵn. Sau mỗi hành động làm trang chuyển (click, gõ rồi Enter, nhấn Enter), macro chờ trang mới xuất hiện; nếu chưa thấy thì làm lại hành động đó tối đa 5 lần thay vì dừng cả macro.

Cắt bớt thời gian chờ thừa trước thao tác web

Bật sẵn. Lệnh web đã tự chờ phần tử của nó, nên các Delay dài đứng trước một lệnh web là chờ thừa; tùy chọn này cắt xuống còn khoảng 800ms. Không ảnh hưởng Delay đứng trước lệnh phím, scroll hay combo.

Xóa dòng / Ghi tiếp / Dừng ghi

Xóa dòng bỏ các dòng đang chọn. Ghi tiếp ghi thêm vào cùng danh sách sau khi đã dừng. Dừng ghi kết thúc và chốt danh sách để xem lại.

Mở Chrome

Chỉ hiện lúc chưa ghi. Mở lại cửa sổ Chrome record khi cửa sổ cũ bị đóng hoặc mở lỗi.

Kết quả mong đợi

Một nhóm lệnh Smart HTML/CDP được thêm vào cuối macro đang mở, theo đúng thứ tự bạn đã thao tác, kèm thời gian chờ giữa các bước. Thao tác tải file lên và hộp thoại JavaScript của trình duyệt chỉ tạo dòng ghi chú [Cần cấu hình] — bạn phải tự hoàn thiện hai loại này.

Ví dụ thực tế

Ví dụ: ghi luồng đăng nhập rồi vào trang tài khoản

Đổi sang Chế độ Trình duyệt, bấm Smart Recorder, chọn Smart recorder, bấm Bắt đầu ghi.
Bấm nút tròn đỏ, đợi hết 5 giây đếm ngược.
Trong Chrome: mở trang đăng nhập, gõ email, gõ mật khẩu, bấm nút Đăng nhập, chờ vào trang chính, bấm menu Tài khoản.
Bấm Dừng ghi. Bảng có khoảng 6 dòng.
Xóa dòng click nhầm nếu có, giữ nguyên hai ô tùy chọn, bấm Thêm vào macro hiện tại.
Trong danh sách lệnh, đổi giá trị mật khẩu thành biến {mat_khau} để không lưu chuỗi thật trong macro.

Ví dụ: ghi thao tác trong popup của tiện ích mở rộng

Mở sẵn tiện ích mở rộng cần dùng trong cửa sổ Chrome record.
Bắt đầu ghi như bình thường, đợi hết đếm ngược.
Bấm vào biểu tượng tiện ích, thao tác trong cửa sổ popup của nó.
Dừng ghi. Các dòng thu từ popup nằm cùng bảng với dòng thu từ trang web.
Nếu dòng trạng thái báo popup chưa xác nhận gửi hết, kiểm tra lại vài thao tác cuối trước khi lưu.

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

Tải file lên không được lưu đường dẫn file cục bộ — chỉ tạo dòng ghi chú, bạn phải tự nối nguồn file.
Hộp thoại JavaScript (alert/confirm/prompt) cần cấu hình cách xử lý trước hành động làm nó bật ra; nội dung hộp thoại không được lưu.
iframe khác tên miền và popup OAuth (ví dụ "Continue with Google" nhúng trong trang khác) hiện chỉ ghi và chạy lại được một phần.
Phiên ghi dài có lỗi chưa xử lý được: badge của tiện ích nhảy qua lại giữa ON và OFF giữa phiên, khiến chỉ một phần thao tác vào được bảng. Nếu thấy số dòng ít hơn thao tác thật, hãy ghi lại thành nhiều đoạn ngắn.
Thứ tự các hành động xảy ra gần như đồng thời có thể chưa hoàn toàn chính xác; hãy xem lại bảng trước khi lưu.
Đếm ngược 5 giây không đảm bảo tiện ích đã gắn xong; nếu không có xác nhận trong 8 giây, popup báo lỗi và về trạng thái chờ.

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

Trong 5 giây đếm ngược, đừng thao tác gì trong Chrome. Thao tác lúc này thường không được ghi.

Ghi thành nhiều đoạn ngắn rồi dùng Ghi tiếp đáng tin hơn một phiên dài, và cũng dễ xem lại hơn.

Smart Record ghi đúng chuỗi ký tự bạn gõ. Sau khi lưu, hãy thay mật khẩu và mã OTP bằng biến để macro không chứa thông tin thật.

Số trong ngoặc (delay NNNms) ở cột Chi tiết là khoảng nghỉ tới hành động tiếp theo, tức thời gian bạn dừng sau bước đó.

Nếu bảng trống dù đã thao tác, kiểm tra tiện ích Smart HTML còn bật trên trang đó và bấm F5 rồi ghi lại.

Thông tin kiểm chứng

ui/smart_record_dialog.py
ui/smart_record_mode_dialog.py
core/smart_record_compiler.py