Worktree Git
Tạo các bản sao độc lập để thực hiện các nhiệm vụ song song, sau đó hợp nhất, xuất bản hoặc xóa chúng khi công việc được hoàn thành.
Một Git worktree cung cấp một thư mục làm việc riêng biệt cho một nhiệm vụ trong cùng một khoa học. Dream mở nó như một dự án khác, với các cuộc trò chuyện và công cụ riêng. Sử dụng worktrees khi các agent cần sửa đổi độc lập mà không làm thay đổi việc checkout của nhau.
Tạo một worktree#
Bắt đầu từ một dự án là một kho lưu trữ Git có tham chiếu cơ bản đã được ghi lại.
- Mở thanh chuyển nhánh dưới cuộc trò chuyện.
- Chọn Cây công việc mới.
- Nhập tên cho nhánh mới, ví dụ
fix-settings-persistence. - Đặt Tham chiếu cơ sở thành commit hoặc nhánh mà bạn muốn bắt đầu, ví dụ như
main. - Nhấn Tạo cây công việc.
Dream tạo ra bản sao và mở dự án của nó. Kiểm tra nhánh worktree được hiển thị dưới cuộc trò chuyện trước khi gửi nhiệm vụ. Các lệnh và sửa đổi của agent trong dự án này sử dụng thư mục mới.
Tham chiếu cơ bản phải tồn tại trong khoa học địa phương của bạn. Nếu bạn cần các phiên bản mới từ remote, hãy lấy chúng thông qua quy trình Git thông thường trước khi tạo worktree.
Đưa một cuộc trò chuyện vào một worktree#
Từ một tin nhắn, chọn Tiếp tục từ tin nhắn này… → Cây công việc mới. Dream sao chép cuộc trò chuyện qua tin nhắn đó, sử dụng nhánh hiện tại làm cơ sở, và tạo tên nhánh mới.
Sử dụng shortcut này khi bạn muốn agent tiếp tục với cuộc thảo luận trước đó. Sử dụng workflow chuyển nhánh khi bạn cần chọn tên cơ sở và tên nhánh tùy chỉnh. Xem Phân nhánh cuộc trò chuyện để biết sự khác biệt giữa việc sao chép tin nhắn và sao chép tệp.
Worktrees bắt đầu từ lịch sử đã được ghi lại của Git. Các thay đổi chưa được ghi lại trong dự án gốc không được sao chép. Một cuộc trò chuyện được nhánh từ một tin nhắn trước không tái tạo hệ thống tệp tại thời điểm đó trong cuộc trò chuyện.
Chuyển đổi giữa các bản sao#
Sử dụng các tab dự án để chuyển đổi giữa bản kiểm tra gốc và dự án worktree. Các worktree được quản lý bởi ứng dụng cũng xuất hiện trong phần Lịch sử trò chuyện của dự án cha, nơi bạn có thể mở chúng lại.
Xem xét và thực hiện thay đổi từ dự án nơi chúng được tạo ra. Tạo một worktree không hợp nhất các thay đổi vào nhánh gốc; sử dụng Thao tác Git ở phần chân khi công việc đã sẵn sàng.
Hoàn thành một worktree#
Việc hợp nhất, tạo một pull request và xóa một worktree là những hành động riêng biệt trong menu Thao tác Git ở phần dưới. Thực hiện commit các thay đổi bạn muốn bao gồm trước khi hợp nhất.
- Trong dự án worktree, chọn Hợp nhất vào base từ Hành động Git dưới phần chat.
- Xem tóm tắt: nhánh Nhánh cơ sở, số lượng Commit nhánh này đang dẫn trước và dẫn sau, các Tệp đã thay đổi, và nhánh hiện tại của Checkout chính cùng việc có sạch hay không.
- Đọc danh sách commit và mở rộng bất kỳ tệp nào để kiểm tra sự thay đổi của nó.
- Sử dụng Commit thay đổi... nếu cần. Các thay đổi chưa được ghi lại vẫn nằm trong worktree và sẽ không được hợp nhất.
- Chọn Hợp nhất vào base. Dream hợp nhất công việc đã được ghi lại trong bản kiểm tra chính, chuyển sang nhánh base nếu cần thiết.
- Kiểm tra kết quả, sau đó chọn Giữ worktree hoặc Xóa worktree và nhánh. Việc xóa sau khi hợp nhất chỉ được cung cấp khi worktree là sạch.
Để xuất bản để xem xét thay vì đó, hãy sử dụng Thao tác Git → Tạo yêu cầu kéo và tuân theo Quy trình làm việc với Git. Việc tạo pull request sẽ giữ lại worktree.
Sử dụng Thao tác Git → Xóa cây công việc để loại bỏ bản checkout mà vẫn giữ lại nhánh của nó. Nếu nó có các thay đổi chưa được ghi lại, hãy ghi lại trước hoặc chọn rõ ràng Bỏ các thay đổi chưa commit.
Việc xóa một worktree sẽ xóa thư mục của nó và đóng dự án của nó. Các cuộc trò chuyện của dự án worktree sẽ bị xóa bỏ cùng với nó và không xuất hiện trong Lịch sử chat hay Đã đóng gần đây. Nếu bạn muốn giữ lại một cuộc trò chuyện, hãy chuyển nó sang workspace cha trước khi hoàn thành.
Khi một tùy chọn không khả dụng#
| Tin nhắn | Cái gì cần làm |
|---|---|
| Phân nhánh này không có commit nào nằm trước base | Commit công việc bạn muốn giữ lại, hoặc chọn Loại bỏ worktree |
| Phiên bản chính có các tệp chưa được ghi lại | Gửi hoặc lưu thay đổi trong dự án cha trước khi hợp nhất |
| Phiên bản chính có quá trình hợp nhất hoặc thao tác lại đang diễn ra | Hoàn thành hoặc hủy bỏ thao tác đó trong dự án cha |
| Nhánh này không chia sẻ lịch sử nào với base | Hợp nhất qua quy trình Git của bạn riêng |
| Không có remote Git nào được cấu hình | Thêm một remote trước khi tạo pull request |
| GitHub CLI (gh) không khả dụng | Cài đặt và xác thực GitHub CLI |
Nếu việc hợp nhất tạo ra xung đột, Dream sẽ hủy bỏ thao tác đó và báo lỗi Hợp nhất vào base đã tạo ra xung đột. Hợp nhất đã bị hủy và không có gì thay đổi, cùng với các tệp có xung đột. Đưa nhánh base vào worktree, giải quyết các xung đột, thực hiện commit, rồi chạy lại Hợp nhất vào base.
Xóa một worktree khỏi dự án cha#
Bạn cũng có thể xóa một worktree mà không cần hộp thoại hoàn thành:
- Lưu lại công việc bạn cần bằng cách thực hiện commit, và nếu phù hợp thì đẩy nó hoặc mở một pull request.
- Dừng các quá trình sử dụng worktree, chẳng hạn như một ứng dụng cục bộ đang chạy trong terminal của nó.
- Mở panel Lịch sử trò chuyện của dự án cha và tìm worktree.
- Sử dụng hành động loại bỏ và xem xác nhận.
- Xác nhận Xóa cây công việc khi bạn không còn cần kiểm tra đó nữa.
Việc xóa sẽ xóa thư mục worktree khỏi ổ cứng. Git từ chối việc xóa khi nó chứa các thay đổi chưa được ghi lại. Quay lại dự án đó và kiểm tra các thay đổi trước khi cố gắng lại.
Chỉ đóng tab dự án sẽ làm nó bị loại khỏi không gian làm việc đang mở; việc xóa một worktree sẽ xóa bản checkout của nó. Xem Quy trình làm việc với Git để biết thêm về các bước commit và yêu cầu PR.