# Đồng bộ GitHub

Kết nối GitHub bằng mã thiết bị hoặc token, xuất bản dự án thành kho mới hoặc kho sẵn có, push và pull giữa các máy, và token của bạn được bảo vệ ra sao.

Đồng bộ GitHub là bản sao lưu ngoài máy và bàn giao giữa nhiều máy tính dạng tùy chọn, được xây trên [kho Git thật](/docs/git-history/) mà mỗi dự án vốn đã là. Commit cục bộ hoạt động mà không cần GitHub. Khi bạn kết nối, vẫn không có tài khoản Oleafly nào xuất hiện: chỉ có GitHub của bạn thôi.

## Kết nối tài khoản của bạn

Vào Settings, **Integrations**, **GitHub**, rồi chọn một trong hai cách:

- **Connect GitHub** (khuyên dùng): luồng mã thiết bị. Oleafly hiển thị một mã ngắn, trình duyệt của bạn mở `github.com/login/device` (kèm nút **Copy** cho mã), bạn phê duyệt, và ứng dụng phát hiện được trong vài giây. Kết nối chỉ yêu cầu các phạm vi `repo` và `read:user`.
- **Personal access token**: mở rộng "Advanced: use a personal access token" và dán một PAT nếu bạn thích tự tạo thông tin xác thực của riêng mình.

Sau khi kết nối, ảnh đại diện và tên người dùng của bạn xuất hiện trong Settings và trong menu GitHub của thanh công cụ trên cùng. Nút **Disconnect** sẽ quên token.

### Token của bạn được bảo vệ như thế nào

Token được lưu trong một tệp cục bộ mã hóa AES-256-GCM, chỉ hạn chế cho chủ sở hữu, và không bao giờ được đưa xuống tầng giao diện của ứng dụng; giao diện chỉ biết được mỗi cụm "connected as @you". Khi Git cần xác thực, token được đưa vào qua một trình hỗ trợ thông tin xác thực nằm trong bộ nhớ, nên nó không bao giờ xuất hiện trên dòng lệnh, trong `.git/config`, hay trong lịch sử shell của bạn. Các bản cũ có nhúng token vào URL remote sẽ được dọn dẹp tự động khi khởi động.

## Xuất bản một dự án

Trong bảng Source Control, nhấp **Publish to GitHub**:

- **Create new repository**: chọn một tên (được điền sẵn từ dự án), quyết định giữ hay bỏ tùy chọn **Private** (khuyên dùng bật), rồi nhấn **Create and push**. Oleafly tạo kho, commit các tệp của dự án, nối `origin`, và push.
- **Link existing**: chọn từ danh sách kho của bạn có thể tìm kiếm (kho riêng tư có biểu tượng ổ khóa) rồi nhấn **Link and push**.

Sau khi xuất bản, menu GitHub của thanh công cụ có **Open in GitHub** và **Copy repository link**.

### Các tệp trông giống thông tin bí mật sẽ ở lại cục bộ

Việc xuất bản không bao giờ commit các tệp thường chứa khóa hoặc mật khẩu, chẳng hạn `.env`, `*.pem`, khóa riêng SSH, hoặc `credentials.json`. Chúng ở lại trong thư mục dự án, không được đưa vào stage, và hộp thoại sẽ nêu tên chúng. Để vẫn xuất bản một tệp như vậy, hãy tự đưa vào stage và commit trong Source Control. Các mẫu như `.env.example`, khóa công khai, và tệp `.key` của Keynote vẫn được xuất bản như thường lệ.

Một lệnh push sẽ tải lên toàn bộ lịch sử. Nếu một tệp mang một trong những tên này từng được commit, Oleafly liệt kê nó và chờ bạn chọn **Cancel** hoặc **Publish anyway** trước khi tạo bất cứ thứ gì trên GitHub.

## Đồng bộ hằng ngày

Hai nút **Push** và **Pull** của bảng Source Control làm đúng như tên gọi, với `origin` trên nhánh hiện tại của bạn. **Fetch** và **Sync** nằm trong menu **More Source Control actions**, còn **Commit & Push** và **Commit & Sync** nằm trong menu bên cạnh **Commit**. Chỉ báo **ahead/behind** (↑ ↓) bên cạnh nhãn nhánh cho bạn biết khi có thứ gì đó cần push hoặc pull.

### Hai máy tính

1. Trên máy A: xuất bản dự án, làm việc, **Push**.
2. Trên máy B: kết nối cùng tài khoản GitHub, rồi chọn **Import a project → GitHub** và chọn kho đó. Xem [hướng dẫn nhập dự án](/docs/import-project/#import-from-github). Từ đó trở đi, **Pull**, làm việc, **Push**.
3. Quay lại máy A: **Pull** trước khi bắt đầu. Chỉ báo sẽ nhắc bạn.

Màu bìa, lựa chọn tài liệu chính, và toàn bộ lịch sử đều đi theo, vì chúng nằm ngay trong thư mục dự án.

## Khi đổi ý

Một khi remote đã được đặt, menu **More Source Control actions** có thêm hai mục:

- **Change repo** mở lại hộp thoại xuất bản để trỏ `origin` sang nơi khác.
- **Unlink** xóa remote; dự án cục bộ và lịch sử của nó không bị ảnh hưởng.

## Xung đột và nhánh

Nếu một lệnh pull gặp xung đột hợp nhất, Source Control liệt kê các tệp bị xung đột. Chọn **Use current** hoặc **Use incoming** cho từng tệp, hoặc chỉnh sửa tệp rồi chọn **Mark resolved**, sau đó **Complete merge**. Nút **Abort merge** đưa các tệp trở lại như cũ. Push và Pull hoạt động trên nhánh bạn đang kiểm out, và menu nhánh ở đầu bảng dùng để chuyển hoặc tạo nhánh. Xem [Git và quản lý mã nguồn](/docs/git-history/#branches-and-stashes).

## Giới hạn, nói rõ

Oleafly xác thực các remote HTTPS. Chức năng xuất bản sẽ thiết lập đúng một remote như vậy cho bạn.

## Nếu có gì đó thất bại

- "No remote 'origin'": hãy xuất bản trước đã; Push và Pull cần một remote.
- Push bị từ chối vì remote đã có các commit: pull trước, rồi push.
- "No GitHub token set": hãy kết nối trong Settings, Integrations, GitHub.

Xem thêm trong [FAQ](/docs/faq/#history-and-collaboration).
