Chia sẻ template qua Template Cloud đội nhóm bằng GitHub Gist

Điều kiện cần

• Một GitHub Gist dành riêng cho Template Cloud đội nhóm và Gist ID chính xác.
• Kết nối Internet tới GitHub API với chứng chỉ HTTPS hợp lệ.
• Token GitHub có quyền ghi Gist trên máy upload, sửa hoặc xóa; máy chỉ đọc Gist công khai có thể không cần token.
• Muốn upload thì template phải nằm trong Template của tôi và file chính vẫn tồn tại local.

Chế độ hỗ trợ

• Chế độ Desktop — Cấu hình, đồng bộ và quản lý Đội nhóm Template dùng được từ Studio ở Chế độ Desktop. Template được tải về vẫn phải chứa lệnh tương thích Desktop nếu bạn định chạy ở mode này.
• Chế độ Browser — Các thao tác cloud cũng dùng được ở Chế độ Trình duyệt. Metadata chrome_cdp chỉ hướng dẫn mode; Chrome/CDP chỉ cần khi chạy hoặc kiểm thử lệnh web của template.

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

Template Cloud đội nhóm dùng một GitHub Gist riêng làm nguồn phát template. Gist chứa manifest team_templates_manifest.json và mỗi template dưới dạng file Base64. Khi bấm Đồng bộ, RunMacro tải nội dung Gist, dựng lại cache local rồi hiển thị entry trong nhóm Template đội nhóm. Template của tôi có thể được tải lên theo ID; metadata, version và timestamp đi cùng manifest. Người có cấu hình đọc dùng template qua Sao chép & mở hoặc Thêm, còn thao tác upload, sửa và xóa cần token có quyền ghi Gist.

Khi nào nên dùng

• Nhiều máy cần lấy cùng một bộ workflow hoặc block đã chuẩn hóa.
• Một người duy trì template và các máy khác chủ yếu tải xuống để sử dụng.
• Cần cập nhật hoặc gỡ template dùng chung theo ID từ một Gist do bạn kiểm soát.
• Muốn tách kho template nhóm khỏi Gist Đồng bộ đám mây dùng cho PMacro/RunMacro package thông thường.

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

• Chỉ cần dùng template trên một máy — lưu vào Template của tôi là đủ.
• Cần phân quyền thành viên, quy trình duyệt hoặc chỉnh sửa đồng thời; tính năng chỉ thao tác với Gist và không cung cấp lớp quản trị đó.
• Muốn đồng bộ toàn bộ macro đang mở hoặc macro con — dùng Đồng bộ đám mây PMacro/RunMacro package.
• Template chứa bí mật viết thẳng trong lệnh và Gist có thể bị người khác đọc.

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

1. Tạo một GitHub Gist riêng cho template nhóm và copy Gist ID từ URL.
2. Trên máy sẽ upload, chuẩn bị GitHub token có quyền ghi Gist; máy chỉ đọc Gist công khai có thể bỏ qua bước này.
3. Trong RunMacro, mở Cloud › Cài đặt hoặc Cài đặt › Cloud, tìm thẻ Template Cloud đội nhóm.
4. Nhập Gist ID và, nếu cần ghi hoặc đọc Gist riêng tư, nhập Gist access token; bấm Lưu cấu hình. Có Gist ID là tính năng được bật.
5. Mở File › Mở macro mẫu..., mở nhóm Template đội nhóm và bấm Đồng bộ.
6. Chọn một template Đội nhóm, xem metadata và lệnh rồi dùng Sao chép & mở hoặc Thêm.
7. Để phát hành, lưu và kiểm thử macro thành Template của tôi, đặt ID ổn định và Version phù hợp.
8. Chọn entry My Template và bấm Upload Đội nhóm. Nếu cùng ID đã tồn tại với version bằng hoặc cao hơn, đọc cảnh báo rồi quyết định có ghi đè hay không.
9. Sau khi upload, sửa metadata hoặc xóa Đội nhóm entry, bảo các máy khác bấm Đồng bộ để cache phản ánh manifest mới.

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

Kết quả mong đợi

Gist có manifest team_templates_manifest.json và file team_template__<id>.pmacro-template.b64 cho mỗi entry. Sau khi đồng bộ, các file được giải Base64 vào cache local và xuất hiện trong nhóm Template đội nhóm. Khi người dùng mở hoặc chèn, RunMacro làm việc trên bản copy/clone chứ không chỉnh trực tiếp file cache.

Ví dụ thực tế

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

• Template Cloud đội nhóm dùng Gist làm nơi lưu; RunMacro không cung cấp danh sách thành viên, vai trò, phê duyệt hoặc khóa chỉnh sửa đồng thời.
• Entry được nhận diện bằng ID và upload thay thế entry cùng ID. Không có merge, check-out hoặc lịch sử version trong giao diện RunMacro.
• Version là metadata so sánh. Người dùng vẫn có thể xác nhận ghi đè bằng version thấp hơn hoặc bằng version remote.
• Template Đội nhóm không tự đồng bộ chỉ vì mở thư viện; các máy nhận phải bấm Đồng bộ để lấy manifest mới.
• Mỗi lần sync xóa thư mục cache Đội nhóm hiện tại rồi dựng lại từ Gist. File remote bị gỡ cũng biến mất khỏi cache local.
• ID remote được slug hóa thành chữ thường, chỉ giữ chữ/số/-/_, cắt tối đa 80 ký tự; ID rỗng trở thành template, vì vậy ID lạ không nhất thiết bị bỏ qua và nhiều ID có thể quy về cùng giá trị. Entry thiếu file Base64 hoặc có Base64 sai bị bỏ qua khi dựng cache.
• Base64 không phải mã hóa bảo mật. Ai đọc được Gist có thể lấy gói template và xem nội dung PMacro không được bảo vệ.
• Luồng Đội nhóm không có SHA-256 hoặc chữ ký nội dung riêng như đồng bộ template hệ thống; hãy chỉ dùng Gist mà bạn tin cậy.
• Upload Đội nhóm chỉ nhận nguồn thuộc Template của tôi; không thể upload lại trực tiếp một entry built-in hoặc Đội nhóm bằng nút này.
• Upload chỉ gửi file macro chính và metadata manifest, không gửi một file README riêng; nút View có thể không có README để mở cho entry Đội nhóm.
• Đồng bộ Đội nhóm yêu cầu HTTPS được xác thực; tùy chọn bỏ qua SSL dành cho tải Cloud thông thường không tạo chế độ TLS riêng cho đường Đội nhóm này.

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

Thông tin kiểm chứng

• core/team_template_cloud.py
• core/template_library.py
• ui/main_window.py
• ui/cloud_sync_dialog.py
• core/settings.py

Lệnh liên quan