Bảng Git

Nhấn Cmd+Shift+G. Bảng mở tại kho mà dự án gắn vào; xem thư mục dự án để biết cách Zshell chọn.

Mỗi thao tác là lệnh Git Zshell chạy thay bạn, và hiển thị đầu ra khi có nhiều thông tin hơn lời “xong”. Không viết lại lịch sử, squash hay force push trừ khi bạn yêu cầu.

Thanh công cụ GitSao chép liên kết

Zshell có thể hiện thanh công cụ gọn dưới tab hoạt động. Trong kho, nó hiển thị nhánh hiện tại và tổng số dòng thêm/xóa; cây không đổi có trạng thái xanh Sạch. Tệp chưa theo dõi được tính vào số dòng thêm.

• Nhấn nhánh để tìm và chuyển nhánh cục bộ. Nhánh mặc định của kho được đánh dấu.
• Nhấn số thay đổi để mở bảng Git.
• Ngoài kho, chế độ Luôn hiện để lại nút Không có kho Git, mở trạng thái khởi tạo của bảng.

Chọn Ẩn, Tự động hoặc Luôn hiện tại Cài đặt → Chung, hoặc đặt toolbar.visibility. Mặc định là Ẩn. Có thể ẩn thanh đang hiện bằng menu ngữ cảnh của nó.

Tệp đã thay đổiSao chép liên kết

Tệp được nhóm thành xung đột, đã stage và chưa stage. Rê chuột lên hàng để thấy nút hoặc dùng menu ngữ cảnh:

Hủy mọi thay đổi nằm ở đầu bảng và hỏi xác nhận trước; đây là thao tác không thể hoàn tác bằng một lệnh Git khác.

Tệp xung đột hiện Đánh dấu đã giải quyết (Stage) thay cho nút stage thường, để giải quyết là bước có chủ ý chứ không phải tác dụng phụ.

Nút phễu ở đầu lọc theo tên tệp, là cách nhanh nhất đi qua tập thay đổi lớn.

Đọc diffSao chép liên kết

Nhấn tệp thay đổi để mở diff trong ô cạnh terminal thay vì đè lên nó. Menu ngữ cảnh còn có Mở tệp (chính tệp, có thể sửa) và Mở tệp bên cạnh.

Diff lớn vẫn phản hồi nhanh. Tập nghìn tệp mở nhanh như thay đổi một dòng và cuộn mượt.

Điều khiển trên diff nhớ hai lựa chọn trên toàn ứng dụng:

• Hợp nhất / Chia đôi đổi giữa một cột và hai cột cạnh nhau.
• Xem xét / Chỉnh sửa có với tệp chưa stage trong worktree hiện hành. Sửa trực tiếp phía mới và Cmd+S để lưu; đóng tệp chưa lưu được xử lý như trình soạn thảo thường.

Diff đã stage và commit lịch sử chỉ đọc vì là ảnh chụp trạng thái, không phải tệp Zshell có thể ghi an toàn. Chuyển một diff sang Chỉnh sửa hoặc Chia đôi cập nhật tùy chọn của diff đang mở khác nhưng không làm diff không đủ điều kiện trở nên sửa được.

CommitSao chép liên kết

Nhập thông điệp và dùng nút commit hoặc chọn từ menu:

• Commit phần đã stage — commit đúng phần bạn đã stage
• Stage tất cả & commit — stage mọi tệp được theo dõi rồi commit
• Sửa commit cuối — gộp thay đổi đã stage vào commit trước
• Stage tất cả & sửa commit cuối

Commit gần đây được liệt kê bên dưới; menu có Sao chép mã commit và Sao chép thông điệp commit.

NhánhSao chép liên kết

Tên nhánh ở đầu là menu: chọn nhánh khác để chuyển hoặc Tạo nhánh mới… từ vị trí hiện tại.

WorktreeSao chép liên kết

Bảng Git liệt kê mọi worktree của kho, cùng nhánh và đường dẫn checkout. Checkout hoạt động có nhãn Hiện tại. Nhấn worktree để mở tab terminal trong thư mục đó; mỗi checkout giữ ngữ cảnh shell riêng nhưng vẫn cùng dự án. Danh sách dài cuộn trong vùng giới hạn riêng; đầu mục, điều khiển commit và danh sách tệp thay đổi giữ nguyên. Nhấn tiêu đề worktree để thu gọn/mở rộng.

Worktree ở trạng thái tách HEAD hiện Detached HEAD thay tên nhánh. Kho bare vẫn được liệt kê đầy đủ nhưng không có thư mục làm việc nên không mở được bằng tab terminal.

Phiên worktreeSao chép liên kết

Trong terminal của kho Git cục bộ, chọn Terminal → Phiên mới trong worktree… hoặc nhấn Cmd+Opt+T. Menu ngữ cảnh của tab và nút + cũng có thao tác này. Chọn nhánh cục bộ mới hoặc hiện có và thư mục chưa tồn tại. Nhánh mới bắt đầu từ nhánh mặc định của kho; có thể chọn rõ HEAD hiện tại. Nhánh hiện có giữ nguyên commit hiện tại. Thư mục đề xuất nằm cạnh bản checkout nguồn.

Các ô được chia kế thừa liên kết worktree của phiên, và bố cục đã lưu cũng khôi phục liên kết này. Khi đóng phiên liên kết, chọn Giữ worktree, Xóa worktree hoặc Hủy. Chỉ được xóa khi không có tệp đã thay đổi, chưa được theo dõi hoặc bị bỏ qua, commit ngoài mốc đã ghi, khóa hay phiên đang mở khác dùng bản checkout. Nhánh Git luôn được giữ lại.

Terminal bên ngoài có thể tạo và đóng phiên bằng zshell +session. Dùng ID do projects trả về với --project; trong Zshell, dự án của terminal gọi lệnh được dùng tự động. Phiên được tạo ở nền trừ khi thêm --focus. --base HEAD hoặc --base REF chọn mốc khác và --worktree NEW_DIR đặt thư mục. --connection FILE chọn phiên bản đang chạy khi cần. Đóng giữ lại worktree nếu không có --remove-worktree rõ ràng; check báo việc dọn dẹp hiện có an toàn không.

zshell +session projects
zshell +session new --project PROJECT_ID --cwd /path/to/repo --branch feat/task
zshell +session list --project PROJECT_ID
zshell +session check --project PROJECT_ID --session SESSION_ID
zshell +session close --project PROJECT_ID --session SESSION_ID --remove-worktree

Kho từ xaSao chép liên kết

Menu ⋯ có mọi thao tác giao tiếp kho từ xa:

Huy hiệu bên cạnh nhánh cho biết ↓ chậm hơn và ↑ đi trước upstream bao nhiêu commit.

Menu còn có Sao chép đường dẫn thay đổi, Sao chép đường dẫn kho và Hiển thị kho trong Finder.

Chưa phải kho mãSao chép liên kết

Nếu thư mục dự án chưa có kho, bảng cung cấp Khởi tạo kho, chạy git init tại đó. Trước khi ấy bảng không làm phiền.

Xem lại lượt của tác nhânSao chép liên kết

Nhấn Xem lại thay đổi… trong bảng Git.

• Lượt gần nhất so sánh ảnh chụp đầu và cuối của tác nhân đã chọn, bao gồm mọi chỉnh sửa trong khoảng đó, bất kể tác giả.
• Chưa commit so sánh HEAD với cây làm việc, bao gồm tệp đã stage và chưa được theo dõi.
• Toàn bộ nhánh so sánh tổ tiên chung với nhánh cơ sở đã chọn với cây làm việc, bao gồm commit và tệp chưa commit.

Chọn tệp và đoạn thay đổi. Ở Lượt gần nhất, Giữ đoạn thay đổi ghi nhận việc xem lại; Hoàn tác đoạn thay đổi đảo thay đổi trong cây làm việc. Cả hai đều không thay đổi chỉ mục Git. Ảnh chụp gốc và các quyết định vẫn được hiển thị.

Hoàn tác bị từ chối nếu tệp hoặc HEAD đã thay đổi, đường dẫn không an toàn, tác nhân đang hoạt động hoặc các lượt chồng lấn. Thay đổi nhị phân và chỉ quyền truy cập chỉ có thể xem. Tệp trên 5 MiB không khả dụng; ảnh chụp vượt 2.048 đường dẫn thay đổi, 25 MiB nội dung hoặc thời gian chụp cũng vậy.

Ảnh chụp tồn tại trong phiên ứng dụng hiện tại. Cần sự kiện bắt đầu và hoàn tất đáng tin cậy. Pi, OpenCode và Grok có tích hợp sẵn. Lời nhắc được bảo vệ chụp lúc bắt đầu nhưng vẫn cần sự kiện hoàn tất. Nếu thiếu, không có ảnh chụp lượt đã hoàn tất.