Dùng Thư viện Template để mở hoặc chèn workflow mẫu

Điều kiện cần

• RunMacro đang ở màn hình soạn macro, không phải cửa sổ RunMacro Runner.
• Muốn lưu template mới thì macro hiện tại phải có ít nhất một lệnh.
• Muốn mở hoặc chèn thì file chính được khai báo trong manifest phải còn tồn tại và đọc được.
• Các file, ảnh hoặc macro con mà template tham chiếu nên có sẵn; nếu thiếu, RunMacro sẽ cảnh báo trước khi mở/chèn.

Chế độ hỗ trợ

• Chế độ Desktop — Gallery và thao tác quản lý dùng được trong Chế độ Desktop. Metadata window, chrome_cdp hoặc mixed chỉ là mode khuyên dùng; bạn vẫn phải kiểm tra các lệnh có phù hợp Desktop hay không.
• Chế độ Browser — Gallery cũng dùng được trong Chế độ Trình duyệt. Template CDP có thể cần Chrome đang kết nối khi chạy, nhưng không cần mở Chrome chỉ để tìm, xem trước, sao chép hoặc chèn.

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

Thư viện Template gom template tích hợp, template do bạn lưu và template đã đồng bộ từ Đội nhóm Cloud vào một gallery. Bạn có thể tìm theo nội dung, lọc category, xem metadata, tối đa 12 lệnh đầu và báo cáo dependency trước khi dùng. Sao chép & mở tạo một bản làm việc riêng; Thêm clone lệnh vào group mới bên dưới vùng đang chọn. Thư viện cũng cho phép lưu macro hiện tại thành template, import file, sửa, nhân bản hoặc xóa template cá nhân mà không sửa bản tích hợp gốc.

Khi nào nên dùng

• Cần bắt đầu nhanh từ một workflow hoàn chỉnh thay vì dựng từng lệnh.
• Muốn chèn một block đăng nhập, kiểm tra hoặc xử lý dữ liệu vào macro đang viết.
• Muốn lưu chuỗi lệnh đã kiểm thử để tái sử dụng trong các macro khác.
• Nhận file .pmacro-template hoặc .pmacro và muốn đưa nó vào mục Template của tôi.

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

• Chỉ cần gọi một file macro ngoài trong lúc chạy — dùng lệnh Chèn PMacro hoặc Chèn RunMacro package.
• Muốn sửa trực tiếp template tích hợp; hãy mở bản sao hoặc lưu thành template của bạn.
• Cần phân phối template hoàn toàn tự động cho nhiều máy — Template Cloud đội nhóm vẫn yêu cầu người nhận bấm Đồng bộ, nên hãy dùng thêm quy trình triển khai khác nếu cần tự động hóa.
• Template có nguồn không tin cậy và bạn chưa xem lệnh, dependency hoặc cảnh báo an toàn.

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

1. Mở File › Mở macro mẫu...; nếu muốn chèn đúng vị trí, chọn một dòng rồi dùng menu chuột phải Chèn macro mẫu.
2. Đợi trạng thái kiểm tra template tích hợp hoàn tất, hoặc bấm Reload để kiểm tra thủ công.
3. Nhập từ khóa vào ô Tìm template..., chọn chip category và mở nhóm Template của tôi, Workflow hoàn chỉnh, Block hoặc Template đội nhóm.
4. Chọn một entry; đọc mô tả, nguồn, trạng thái chuẩn bị, mode khuyên dùng, phiên bản, tags và danh sách lệnh xem trước.
5. Kiểm tra dòng dependency. Nếu báo thiếu, xem chi tiết và chuẩn bị file cần thiết trước khi tiếp tục.
6. Chọn Sao chép & mở để tạo bản macro riêng, hoặc Thêm để clone lệnh vào macro hiện tại.
7. Nếu bấm mở khi bảng lệnh đã có nội dung, chọn Thêm vào macro hiện tại hoặc Tạo macro mới; RunMacro sẽ hỏi về thay đổi chưa lưu khi cần.
8. Xác nhận cảnh báo dependency nếu bạn vẫn muốn tiếp tục. Khi chèn, RunMacro liệt kê và bỏ qua lệnh không hỗ trợ; khi Import, các lệnh đó bị bỏ qua, tên được ghi vào log và hộp thoại vẫn có thể báo import thành công.
9. Kiểm tra group hoặc macro vừa tạo, thay dữ liệu mẫu bằng dữ liệu của bạn, chạy thử rồi lưu xuống đĩa.

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

Kết quả mong đợi

Khi mở, RunMacro copy template vào Downloads/RunMacroTemplates/<id> với tên thư mục riêng rồi nạp bản copy để bạn sửa. Khi chèn, các lệnh clone nằm trong một group mới bên dưới vùng chọn, label được đổi để tránh trùng và macro được đánh dấu chưa lưu; template nguồn không thay đổi.

Ví dụ thực tế

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

• Thư viện nằm trong màn hình soạn macro và không được cung cấp trong RunMacro Runner.
• Mode đề xuất và trạng thái chuẩn bị là metadata hướng dẫn, không tự chuyển workspace hoặc bảo đảm template chạy được ở mode hiện tại.
• Loại command không có trong bản RunMacro hiện tại bị bỏ qua. Khi chèn, app hiển thị cảnh báo và danh sách; khi Import, app chỉ ghi tên vào log, vẫn có thể báo thành công và lưu phần còn lại mà không cảnh báo trong dialog.
• Kiểm tra dependency chỉ cảnh báo. Bạn có thể tiếp tục dù thiếu file, ảnh hoặc macro con, nên lỗi vẫn có thể xuất hiện lúc chạy.
• Đồng bộ template hệ thống chỉ tải ID còn thiếu; entry built-in đã có cùng ID không được nâng version hay ghi đè bởi Reload.
• Template tích hợp không thể sửa hoặc xóa tại chỗ; mọi chỉnh sửa phải thực hiện trên bản copy hoặc template cá nhân.
• Metadata Full và Block dùng để nhóm/hiển thị; thư viện không kiểm tra cấu trúc lệnh có thực sự là workflow hoàn chỉnh hay snippet độc lập.
• Mở template luôn tạo một bản copy mới trong thư mục Downloads mặc định; các bản copy cũ không được dọn tự động.
• Tên ID được slug hóa thành chữ thường, số, - hoặc _, tối đa 80 ký tự; tên khác nhau có thể quy về cùng ID và yêu cầu ghi đè.

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

Thông tin kiểm chứng

• core/template_library.py
• ui/main_window.py
• storage/json_store.py
• tests/test_system_template_sync.py

Lệnh liên quan