Phân loại hộp thư

Hướng dẫn này chỉ cho bạn cách làm việc với hộp thư: bề mặt duy nhất tập hợp mọi thứ chặn bạn hoặc chủ động yêu cầu bạn — những phê duyệt agent đang chờ, những lần đồng bộ phiếu thất bại và mọi pull request liên quan đến bạn với tư cách người đánh giá hoặc tác giả.

Mở hộp thư

1. Nhấp Hộp thư trên thanh bên. Huy hiệu của nó đếm số phê duyệt agent đang chờ, số lần đồng bộ thất bại và số PR đang mở chờ bạn đánh giá.
2. Hoặc nhấn ⌘K và chạy lệnh điều hướng Hộp thư.
3. Hoặc liên kết sâu thẳng tới /workspaces/<workspace-id>/inbox.

Mục trên thanh bên luôn hiển thị số đếm trực tiếp, nên bạn thấy được công việc phân loại đang dồn lại mà không cần mở trang.

Đọc mức độ nghiêm trọng trong nháy mắt

Quét từ trên xuống; hộp thư đã được sắp theo mức độ khẩn cấp:

1. Dải Cần bạn xử lý được ghim nằm phía trên các mục PR. Mỗi thẻ mang một chip mức độ nghiêm trọng. Những nguồn đã đăng ký (một agent mắc kẹt ở lời nhắc xác nhận, một lần đồng bộ phiếu có bản sao nhà cung cấp đã cũ) phát ra Bị chặn.
2. Trong dải, mức độ nghiêm trọng khẩn cấp nhất đứng trước; khi ngang nhau thì mục chờ lâu nhất được ưu tiên.
3. Bên dưới dải, các PR được nhóm vào những mục cố định theo vòng đời đánh giá — Cần bạn đánh giá, Được trả lại cho bạn, Đã duyệt, Bản nháp, Đang chờ người đánh giá, Đang gộp và vừa gộp, Đang chờ tác giả. Những mục trên cùng là thứ cần bạn; phần còn lại là tình trạng các PR của chính bạn. Cần bạn đánh giá bao gồm cả những PR vẫn đang yêu cầu một nhóm mà bạn thuộc về, trên những máy chủ mã có hỗ trợ điều đó (GitHub bỏ yêu cầu nhóm ngay khi bất kỳ đồng đội nào đánh giá).

Một mục chỉ vào hộp thư khi nó chặn điều gì đó hoặc chủ động yêu cầu bạn. Một dải trống cùng một danh sách mục trống chỉ hiển thị Bạn đã xem hết khi sự trống rỗng đó đáng tin.

Một hộp thư cho mọi máy chủ mã

Nếu không gian làm việc có kho mã trên nhiều hơn một máy chủ mã, hộp thư hợp nhất chúng thành một dòng duy nhất — một pull request GitHub và một pull request Bitbucket nằm trong cùng một mục, sắp theo thời gian thay vì nhóm theo nhà cung cấp. Phần meta repo #number của hàng là thứ phân biệt chúng.

“Của bạn” được phân giải theo từng máy chủ mã, vì bạn là một tài khoản khác nhau trên mỗi cái. Một pull request chỉ được tính là của bạn, hoặc là đang yêu cầu bạn đánh giá, khi nó khớp với danh tính của bạn trên máy chủ mã mà kho mã đó thực sự nằm trên.

Một máy chủ mã bị sập hoặc chưa kết nối thì không đóng góp gì và để phần còn lại của hộp thư nguyên vẹn — một kết nối hỏng không bao giờ làm trống toàn bộ danh sách. Trạng thái trống nêu một lời cảnh báo thay vì Bạn đã xem hết khi mọi lần đăng nhập máy chủ mã vẫn chưa được phân giải (Không xác nhận được tài khoản GitHub của bạn — nội dung vẫn nêu tên GitHub), khi githubstatus.com báo có sự cố, hoặc khi một bản cài GitHub App bao phủ các kho mã được liên kết bị tạm ngưng.

Xử lý dải cần chú ý

Mỗi thẻ trong dải có một hành động kế tiếp duy nhất:

1. Nếu một thẻ là xác nhận agent đang chờ, hãy nhấp Đánh giá — bạn đến space của agent đó cùng xác nhận đang chờ của nó. Phê duyệt hoặc từ chối tại đó (xem Chat với một agent).
2. Nếu một thẻ ghi Đồng bộ thất bại cho một nhà cung cấp, hãy nhấp Đang mở — bạn đến trang Cài đặt → Không gian làm việc → Chung, nơi thẻ Tình trạng đồng bộ hiển thị lần đồng bộ gần nhất, chuỗi thất bại liên tiếp và kết quả mới nhất của từng kết nối. Chỉ lần thất bại mới nhất của mỗi nhà cung cấp xuất hiện trong hộp thư, nên một lần đồng bộ đã hồi phục sẽ xóa thẻ đó.
3. Các thẻ tự biến mất khi trạng thái bên dưới được giải quyết (agent được trả lời, lần đồng bộ hồi phục) — không có gì phải tự tay bỏ đi.

Đây là những xác nhận theo từng lượt, không phải phê duyệt quản trị

Một thẻ “phê duyệt agent” là một agent đang chạy tạm dừng để xin phép cho một hành động, trong cuộc hội thoại của chính nó. Đó là chuyện khác với bản ghi Approval thuộc quản trị mà agent tạo bằng các công cụ MCP phê duyệt — những bản ghi đó không có màn hình nào cho con người ở bất kỳ đâu trong ứng dụng và không bao giờ xuất hiện ở đây.

Tình trạng đồng bộ là chỉ đọc

Thẻ này báo cáo về các kết nối đồng bộ phiếu; ngoài nút Đồng bộ ngay, nó không thể tạo, sửa hay kết nối lại một kết nối nào và cũng không có màn hình nào khác làm được điều đó. Khi chưa cấu hình kết nối nào, nó chỉ ghi “Chưa có kết nối đồng bộ”, đúng như những gì một không gian làm việc mới hiển thị.

Lọc tới những gì đang chặn

1. Nhấn f (khi không có trường văn bản nào đang được chọn) để mở menu lọc, hoặc nhấp nút lọc trên thanh công cụ.
2. Chọn bất kỳ tổ hợp nào của trạng thái, tác giả, người đánh giá, nội dung, chủ sở hữu/tên kho mã, khoảng ngày, hoặc dễ đánh giá nhanh. Số đếm theo khía cạnh trong menu cho biết mỗi tùy chọn khớp với bao nhiêu mục trong hộp thư.
3. Các bộ lọc đang bật xuất hiện dưới dạng chip trên thanh phía trên danh sách; nhấp ✕ của một chip để bỏ tiêu chí đó.
4. Dùng ray bên trái để nhảy giữa các mục — mỗi mục hiển thị số đếm trực tiếp và phần tô sáng bám theo vị trí cuộn của bạn. Nhấp vào tiêu đề một mục để thu gọn những mục bạn không phân loại (chẳng hạn Bản nháp trong lúc dọn đánh giá).
5. Nhấp vào tiêu đề một cột (tiêu đề, thay đổi hoặc cập nhật) để sắp xếp mọi mục; nhấp lại vào cột đang hoạt động để đảo chiều. Nút tùy chọn hiển thị điều khiển việc ẩn/hiện bản nháp, cửa sổ vừa gộp gần đây, thuộc tính hàng, thứ tự và cách nhóm (chỉ nhóm theo tác giả mới thay đổi bố cục hộp thư).

Các bộ lọc ở đây độc lập với hàng đợi PR — thu hẹp hộp thư không bao giờ thay đổi bộ lọc của hàng đợi và ngược lại.

Thao tác trên một mục PR

1. Nhấp vào bất kỳ hàng nào để mở trang chi tiết PR.
2. Nếu PR nằm trong Cần bạn đánh giá, hãy đánh giá nó và gửi quyết định của bạn — xem Xem xét và merge một PR.
3. Nếu PR nằm trong Được trả lại cho bạn (có yêu cầu thay đổi hoặc CI thất bại), hãy đẩy các bản sửa từ bản checkout của bạn hoặc giao phần việc tiếp theo cho một agent.
4. Nếu PR nằm trong Đã duyệt, hãy merge nó từ trang chi tiết.
5. Nếu bạn muốn giao một lượt đánh giá cho người khác thay vì tự làm, xem Điều phối agent đánh giá và vòng đời điều phối agent.

Khi trạng thái bên dưới thay đổi (lượt đánh giá của bạn được ghi nhận, PR được merge), bộ phân loại tự động xếp PR vào mục mới của nó.

Hoàn tác một thao tác nhầm

1. Nhấn ⌘Z để hoàn tác thao tác cuối, ⌘⇧Z để làm lại.
2. Nếu một trường văn bản đang được chọn, ⌘Z sẽ sửa văn bản của trường đó thay vì hoàn tác — hãy nhấp ra ngoài trường trước để hoàn tác một thao tác ở cấp ứng dụng.

Tra cứu phím tắt ngay tại chỗ

Nhấn ? (khi không có trường văn bản nào đang được chọn) để mở bảng tra phím tắt. Bảng này liệt kê mọi tổ hợp đang hoạt động trên tuyến hiện tại, kể cả phím tắt lọc f của hộp thư. Bản đồ đầy đủ nằm trong tham chiếu phím tắt.

Điều khiển từ bảng lệnh

1. Nhấn ⌘K ở bất kỳ đâu để mở bảng lệnh.
2. Gõ Hộp thư để nhảy tới trang, hoặc gõ tiêu đề một PR — bảng lệnh liệt kê các pull request khớp và mở cái bạn chọn.
3. Khi hộp thư đang mở, chạy Sao chép liên kết tới trang này để sao chép URL đó cho việc chia sẻ. Lệnh này sao chép tuyến hiện tại, nên nó chỉ là URL của hộp thư khi bạn đang ở trang này.

Làm mới theo yêu cầu

Hộp thư cập nhật trực tiếp, nhưng nếu bạn nghi ngờ dữ liệu đã cũ, hãy nhấp vào điều khiển làm mới trên thanh công cụ — nó buộc máy chủ quét ngay lập tức mọi máy chủ mã đã kết nối và tải lại các lớp phủ đã merge/đã đánh giá. Biểu tượng quay cho tới khi mọi lượt tải xong.

Hướng dẫn liên quan

• Xem xét và merge một PR
• Chat với một agent
• Điều phối agent đánh giá

Khái niệm liên quan

• Vòng đời điều phối agent