整理你的收件箱

本指南說明如何操作收件箱：這個單一介面會彙集一切阻塞你、或明確要求你處理的事項 —— 待處理的代理核准、失敗的工單同步，以及每一個以審查者或作者身分涉及你的 pull request。

開啟收件箱

在側邊欄按一下 收件箱。它的徽章會顯示待處理的代理核准、失敗的同步，以及等待你檢閱的開啟中 PR 數量。
或按 ⌘K，執行 收件箱 導覽指令。
或直接深層連結至 /workspaces/<workspace-id>/inbox。

側邊欄的項目一律顯示即時數量，因此你不必開啟頁面，也能看到待整理的工作不斷累積。

一眼看出嚴重程度

由上而下掃視；收件箱本身已按迫切程度排序：

置頂的 需要你的注意 關注列位於各 PR 區段之上。每張卡片都帶有一個嚴重程度標籤。已登記的來源（卡在確認提示的代理、供應商鏡像已過期的工單同步）會發出 已封鎖。
在關注列內，最迫切的嚴重程度會排在前面；同級時，等待最久的項目優先。
關注列之下，PR 會歸入固定的審查生命週期區段 —— 需要你檢閱、 退回給你、已核准、草稿、等待檢閱者、 合併中與最近合併、等待作者。上方各區段代表需要你處理的事項；其餘區段則顯示你的 PR 處於甚麼狀態。需要你檢閱 也包含在支援團隊審查要求的託管平台上、仍要求你所屬團隊檢閱的 PR（在 GitHub 上，只要任何隊友完成檢閱，就會移除該團隊）。

只有當某個項目阻塞了某件事，或明確要求你處理時，它才會進入收件箱。關注列為空、區段清單也為空時，只有在這個「空」值得信賴的情況下，才會顯示 全部處理完畢。

一個收件箱，涵蓋每個託管平台

如果工作區在多個程式碼託管平台上都有程式庫，收件箱會把它們合併成單一資料流 —— 一個 GitHub pull request 和一個 Bitbucket pull request 會並排在同一個區段，按時間排序，而不是按供應商分組。它們的分別就在於列上的 repo #number 中繼資料。

「你的」是按託管平台解析的，因為你在每個平台上都是不同的帳戶。只有當某個 pull request 符合該程式庫實際所在託管平台上你的身分時，才會算作你的，或算作要求你檢閱。

故障或未連接的託管平台不會貢獻任何內容，也不會影響收件箱其餘部分 —— 一個中斷的連線永遠不會令整份清單變空。當所有託管平台登入都仍未解析（無法確認你的 GitHub 帳戶 —— 文案仍會寫明 GitHub）、當 githubstatus.com 報告事故，或當涵蓋已連結程式庫的 GitHub App 安裝被暫停時，空狀態會說明這項注意事項，而不是顯示 全部處理完畢。

清空關注列

關注列上每張卡片都只有一個下一步動作：

如果卡片是待處理的代理確認，按一下檢閱 —— 你會進入該代理的空間，並帶著它的待處理確認。在那裡核准或拒絕（參見與代理聊天）。
如果卡片顯示某個供應商的 同步失敗，按一下開啟 —— 你會進入 設定 → 工作區 → 一般，其中的 同步健康狀況 卡片會顯示每個連線的最後同步時間、連續失敗次數與最新結果。收件箱只會顯示每個供應商最新的一次失敗，因此同步一旦恢復，卡片就會消失。
一旦底層狀態解決（代理得到答覆、同步恢復），卡片就會自行消失 —— 沒有需要手動關閉的東西。

篩選出正在阻塞的事項

在沒有文字欄位取得焦點時按 f，即可開啟篩選選單；或按一下工具列的篩選按鈕。
任意組合狀態、作者、檢閱者、內容、程式庫擁有者／名稱、日期範圍，或可快速審查等條件。選單中各選項的計數會顯示每個選項符合多少個收件箱項目。
已啟用的篩選條件會以標籤形式顯示在清單上方的橫列中；按一下標籤的 ✕ 即可移除該條件。
使用左側導覽列在各區段之間跳轉 —— 每個項目都會顯示即時數量，而反白會跟隨你的捲動位置。按一下區段標題，即可收合你不需要整理的區段（例如在清空檢閱時收合草稿）。
按一下欄標題（標題、變更或更新時間）即可排序所有區段；再按一次目前作用中的欄，即會反轉方向。顯示選項按鈕可控制草稿可見度、最近合併的時間範圍、列屬性、排序與分組（只有按作者分組會改變收件箱的版面）。

這裡的篩選條件與 PR 佇列各自獨立 —— 收窄收件箱永遠不會改變佇列的篩選條件，反之亦然。

對 PR 項目採取行動

按一下任何一列，即可開啟 PR 詳情頁。
如果 PR 位於 需要你檢閱，請審查它並提交你的決定 —— 參見審查並合併 PR。
如果 PR 位於 退回給你（已要求變更或 CI 失敗），請從你的檢出推送修正，或把後續工作交給代理。
如果 PR 位於 已核准，請從詳情頁合併它。
如果你寧願把審查派發出去，而不是自己動手，請參見派發審查代理與派發生命週期。

一旦底層狀態改變（你的審查送達、PR 完成合併），分類器就會自動把該 PR 重新歸入它的新區段。

復原誤操作

按 ⌘Z 復原上一個動作，按 ⌘⇧Z 重做。
如果文字欄位取得焦點，⌘Z 會改為編輯該欄位的文字 —— 請先按到欄位以外，才能復原應用程式層級的動作。

就地查閱快捷鍵

在沒有文字欄位取得焦點時按 ?，即可開啟鍵盤快捷鍵速查表。它會列出目前路由上所有生效的按鍵綁定，包括收件箱的 f 篩選快捷鍵。完整的對照表請參見鍵盤快捷鍵參考。

從命令面板操作

在任何地方按 ⌘K，即可開啟命令面板。
輸入 收件箱 即可跳至該頁，或輸入 PR 標題 —— 命令面板會列出相符的 pull request，並開啟你選擇的那一個。
當收件箱開啟時，執行 複製此頁面的連結 即可複製該 URL 以便分享。這個指令複製的是目前的路由，因此只有當你身處此頁面時，它才是收件箱的 URL。

按需要重新整理

收件箱會即時更新，但如果你懷疑資料過時，請按一下工具列的重新整理控制項 —— 它會強制伺服器立即掃描每個已連接的託管平台，並重新擷取合併／已檢閱的疊加資料。圖示會一直旋轉，直到所有擷取都完成。