Workflow /backup tạo bản snapshot có đánh dấu ngày cho các file workspace quan trọng vào .para/backups/. Bảo tồn session logs, artifacts, workflows, và cấu hình — tất cả những gì không thể khôi phục từ Git.
Tổng quan Lệnh
/backup all # Backup toàn bộ: config + sessions + tất cả projects
/backup workflows # Chỉ workflows
/backup rules # Chỉ rules
/backup skills # Chỉ skills (v1.6.4+)
/backup metadata # .para-workspace.yml + workspace sessions
/backup project <tên> # Một project (loại trừ repo/)
/backup project-all # Tất cả projects (loại trừ repo/)
Luồng Backup
Tạo thư mục snapshot → Copy theo target → Dọn snapshot cũ → Báo cáo
1. Tạo Thư mục Snapshot
Tạo thư mục có đánh dấu ngày tại .para/backups/YYYY-MM-DD/.
2. Copy theo Target
Copy file dựa trên target đã chọn. Mỗi target độc lập và có thể chạy riêng hoặc trong all.
3. Dọn Snapshot Cũ
Tự động giữ chỉ 5 snapshot gần nhất và xóa các bản cũ hơn.
4. Báo cáo
Hiển thị tóm tắt những gì đã backup kèm số lượng file.
Phạm vi Backup
Cấp Workspace
| Thành phần | Backup? | Lý do |
|---|---|---|
.para-workspace.yml | ✅ Có | Config workspace cốt lõi |
Areas/Workspace/sessions/ | ✅ Có | File session workspace |
Areas/Workspace/SYNC.md | ✅ Có | Hàng đợi sync xuyên dự án |
Areas/Workspace/audits/ | ✅ Có | Báo cáo kiểm tra |
.agent/workflows/ | ✅ Có | Workflows đã tùy chỉnh |
.agent/rules/ | ✅ Có | Rules đã tùy chỉnh |
.agent/skills/ | ✅ Có | Skills đã tùy chỉnh |
Mỗi Dự án
| Thành phần | Backup? | Lý do |
|---|---|---|
sessions/ | ✅ Có | Session logs — duy nhất, không thể thay thế |
artifacts/ | ✅ Có | Plans, backlogs — sản phẩm công việc |
docs/ | ✅ Có | Tài liệu nội bộ |
project.md | ✅ Có | Hợp đồng dự án — YAML config + mục tiêu |
.agent/ | ✅ Có | Rules và overrides riêng dự án |
repo/ | ❌ Không | Mã nguồn — khôi phục bằng git clone |
Khôi phục
# Khôi phục workflows
cp .para/backups/YYYY-MM-DD/workflows/* .agent/workflows/
# Khôi phục dữ liệu dự án
cp -r .para/backups/YYYY-MM-DD/projects/<tên>/* Projects/<tên>/
# Khôi phục repo (từ GitHub)
cd Projects/<tên> && git clone <repo-url> repo
→ Workflow /install — Cài đặt từ catalog → Workflow /para — Bộ điều khiển chính workspace