Chuyển tới nội dung chính

Nhập & Xuất toàn bộ (Global Import & Export)

Global Import/Export đóng gói toàn bộ cấu hình Rephlo của bạn vào một tệp lưu trữ duy nhất, trong một thao tác. Khác với các bản xuất theo từng loại dữ liệu riêng lẻ (xem Nhập & Xuất), tính năng này gộp mọi loại dữ liệu vào một tệp ZIP toàn diện.

Những gì được xuất ra​

Global Export có thể bao gồm toàn bộ dữ liệu Rephlo của bạn. Mỗi loại dữ liệu là một ô chọn (checkbox) độc lập:

Loại dữ liệuMô tảMặc định
CommandsTất cả các lệnh, nhóm và mục yêu thíchĐã chọn
SpacesCác Space cùng toàn bộ tệp và nội dungĐã chọn
HistoryLịch sử sử dụng kèm đầu vào/đầu raĐã chọn
ProvidersCấu hình nhà cung cấp LLM (khóa API được mã hóa)Đã chọn
ConversationsCác phiên chat kèm toàn bộ lịch sử tin nhắnĐã chọn
SettingsTùy chọn ứng dụngĐã chọn

Khóa API và các thông tin bí mật vẫn được mã hóa gắn với máy đã tạo ra bản xuất. Chúng chỉ có thể được giải mã trên chính máy đó — xem Nhập trên máy khác.

Xuất dữ liệu của bạn​

Bước 1: Mở Global Export​

  1. Vào menu File.
  2. Nhấn Export All Data…

Bước 2: Chọn dữ liệu cần xuất​

Hộp thoại Global Export hiển thị một ô chọn cho mỗi loại dữ liệu, kèm số lượng hiện tại (ví dụ: "45 commands, 5 groups"; "28 conversations, 412 messages"). Tích vào các loại bạn muốn xuất.

Bảng Export Everything — chọn nội dung muốn bao gồm (loại trừ khóa API) và lưu một bản sao lưu đầy đủ

Hộp thoại Export All Data liệt kê Commands, Spaces, History, Providers, Conversations và Settings — mỗi mục kèm số lượng mục chứa trong đó và một ô chọn. Một dòng tóm tắt hiển thị tổng số đã chọn, và nút Cancel / Export… nằm ở phía dưới.

Bước 3: Chọn vị trí và xuất​

  1. Nhấn Export….
  2. Chọn vị trí và tên tệp. Tên mặc định bao gồm ngày tháng, ví dụ rephlo-backup-2026-01-20.zip.
  3. Nhấn Save.

Bước 4: Chờ hoàn tất​

Một hộp thoại tiến trình báo cáo từng giai đoạn khi nó chạy — chuẩn bị commands, đóng gói spaces, xuất history, providers, conversations, settings, và cuối cùng là tạo tệp lưu trữ. Khi hoàn tất, bạn sẽ thấy bản tóm tắt những gì đã được xuất. Bạn có thể hủy giữa chừng nếu cần.

Nhập dữ liệu của bạn​

Bước 1: Mở Global Import​

  1. Vào menu File.
  2. Nhấn Import All Data…
  3. Chọn tệp xuất .zip của bạn.

Bước 2: Xem trước nội dung nhập​

Rephlo kiểm tra tính hợp lệ của tệp lưu trữ và đọc manifest của nó, sau đó hiển thị những gì sẽ được nhập: ngày tạo tệp lưu trữ, phiên bản ứng dụng đã tạo ra nó, số lượng theo từng loại dữ liệu, và bất kỳ xung đột nào. Nếu bản xuất đến từ một máy khác, một cảnh báo sẽ cho biết các khóa API của nhà cung cấp sẽ cần được nhập lại.

Bảng Import Backup — thả một tệp sao lưu vào, xem trước nội dung, và gộp hoặc thay thế

Hộp thoại Import All Data hiển thị tên tệp lưu trữ, ngày tạo và phiên bản ở phía trên. Bên dưới, mỗi loại dữ liệu liệt kê số lượng mục, số xung đột phát hiện được, và một danh sách xổ xuống để chọn cách xử lý (Skip / Replace / Duplicate). History được nối thêm thay vì xử lý xung đột. Một dải cảnh báo xuất hiện khi bản xuất được tạo trên một máy khác.

Bước 3: Cấu hình cách xử lý xung đột​

Với mỗi loại dữ liệu có xung đột, hãy chọn cách xử lý:

Tùy chọnHành vi
SkipGiữ lại dữ liệu hiện có; không nhập các mục xung đột
ReplaceGhi đè dữ liệu hiện có bằng phiên bản được nhập vào
DuplicateNhập như mục mới với tên đã được sửa đổi (ví dụ: "Command (Imported)")

Mẹo: Dùng Skip khi gộp vào một môi trường đang hoạt động. Dùng Replace khi khôi phục một bản sao lưu lên một bản cài đặt mới. Các bản ghi History được nối thêm, không được gộp theo xung đột.

Bước 4: Nhập​

  1. Nhấn Import.
  2. Một hộp thoại tiến trình báo cáo từng giai đoạn (commands, spaces, conversations, …).
  3. Xem bản tóm tắt khi hoàn tất.

Giải thích cách xử lý xung đột​

Xung đột xảy ra khi một mục được nhập vào có cùng tên hoặc định danh với một mục đã tồn tại.

Khi nào dùng từng tùy chọn​

Tình huốngTùy chọn khuyến nghị
Khôi phục một bản sao lưu lên bản cài đặt mớiReplace
Gộp dữ liệu từ một đồng nghiệpSkip hoặc Duplicate
Cập nhật từ một bản sao lưu cũ hơnReplace
Dùng thử các lệnh được chia sẻDuplicate

Cấu trúc tệp ZIP​

Hiểu cấu trúc tệp lưu trữ giúp ích cho việc khắc phục sự cố hoặc kiểm tra thủ công:

Tệp Manifest​

manifest.json ghi lại:

  • Phiên bản schema (để tương thích ngược) và phiên bản ứng dụng đã tạo ra bản xuất.
  • Dấu thời gian xuất theo UTC.
  • Một định danh máy đã băm (hash), dùng để phát hiện việc nhập trên máy khác.
  • Số lượng theo từng loại (commands, spaces, bản ghi history, providers, conversations, tin nhắn, cộng thêm số lượng command/space đã lưu trữ) và tổng dung lượng tệp lưu trữ.

Lưu ý về providers và settings: các thông tin bí mật của provider nằm trong thư mục providers/ (đã mã hóa), nên các khóa liên quan đến provider được loại trừ có chủ đích khỏi bản xuất settings/ để tránh trùng lặp.

Nhập trên máy khác​

Khi nhập một tệp lưu trữ được tạo trên một máy tính khác:

Những gì hoạt động bình thường​

  • Commands (chỉ dẫn, nhóm, cài đặt)
  • Spaces (tệp và nội dung)
  • History (bản ghi sử dụng)
  • Conversations (phiên chat)
  • Settings (tùy chọn)

Những gì cần lưu ý​

  • Khóa API của Provider — việc mã hóa gắn liền với từng máy cụ thể. Sau khi nhập trên máy khác, các provider bị ảnh hưởng sẽ được nhập vào với khóa đã bị xóa, và bạn phải nhập lại từng khóa.

Vì sao đây là chủ ý: khóa không bao giờ được xuất dưới dạng văn bản thuần, nên thông tin xác thực của bạn vẫn được bảo vệ ngay cả khi tệp sao lưu vô tình bị chia sẻ. Các provider Gateway (Dedicated API) hoàn toàn không được xuất — chúng được khôi phục tự động khi bạn đăng nhập.

Các trường hợp sử dụng phổ biến​

Sao lưu toàn bộ trước khi cài đặt lại​

  1. File > Export All Data…
  2. Chọn tất cả các loại dữ liệu.
  3. Lưu vào ổ đĩa ngoài hoặc lưu trữ đám mây.
  4. Ghi lại khóa API của bạn riêng (chúng không thể giải mã được sau khi cài đặt lại).
  5. Sau khi cài đặt lại, dùng File > Import All Data…
  6. Nhập lại khóa API trong Settings.

Thiết lập một máy tính mới​

  1. Trên máy tính cũ, xuất toàn bộ dữ liệu.
  2. Chuyển tệp ZIP sang máy tính mới.
  3. Cài đặt Rephlo và nhập tệp ZIP.
  4. Nhập lại khóa API cho từng provider.

Chia sẻ cấu hình với nhóm​

  1. Xuất với Commands và Spaces được chọn.
  2. Bỏ chọn History, Providers, Conversations và Settings (dữ liệu cá nhân).
  3. Chia sẻ tệp ZIP.
  4. Đồng nghiệp nhập bằng Duplicate để tránh ghi đè lên các lệnh của riêng họ.

Một bản sao lưu sạch, an toàn về quyền riêng tư​

Nếu bạn muốn một bản sao lưu không chứa dữ liệu nhạy cảm:

  1. Bỏ chọn Providers (khóa đã mã hóa), History (văn bản đã xử lý) và Conversations (tin nhắn chat).
  2. Chỉ xuất Commands và Spaces.

Thực hành tốt nhất​

  1. Sao lưu định kỳ — xuất hằng tuần hoặc trước các thay đổi lớn.
  2. Tên tệp mô tả rõ ràng — bao gồm ngày tháng, ví dụ rephlo-backup-2026-01-20.zip.
  3. Lưu trữ an toàn — giữ các bản sao lưu trong lưu trữ đám mây được mã hóa hoặc trên ổ đĩa ngoài.
  4. Kiểm thử khôi phục — thỉnh thoảng xác minh một bản sao lưu nhập vào sạch sẽ.
  5. Ghi lại khóa API — lưu chúng trong một trình quản lý mật khẩu; chúng không thể khôi phục được từ một bản sao lưu trên máy khác.
  6. Đánh phiên bản cho các bản sao lưu — giữ lại nhiều hơn chỉ bản mới nhất.

Khắc phục sự cố​

Lỗi "Invalid archive" khi nhập

  • Tệp ZIP có thể bị hỏng — hãy tải lại hoặc sao chép lại.
  • Đảm bảo tệp được tạo bởi Global Export của Rephlo (nó phải chứa manifest.json).

Thiếu dữ liệu sau khi nhập

  • Kiểm tra xem loại dữ liệu đó đã được chọn để nhập chưa.
  • Xem lại cách xử lý xung đột — các mục có thể đã bị Skipped (bỏ qua).

Provider hiển thị "API key required" sau khi nhập

  • Điều này là bình thường khi nhập từ một máy khác. Nhập lại khóa trong Settings > Providers.

Việc nhập có vẻ chậm

  • Các tệp history lớn cần nhiều thời gian xử lý hơn.
  • Các Space có nhiều tài liệu được xử lý riêng lẻ.
  • Cân nhắc loại trừ History để nhập nhanh hơn.

Phần tiếp theo: Cấu hình Rephlo theo sở thích của bạn trong Settings.