Triage peti masuk anda

Panduan ini menunjukkan cara menangani peti masuk: satu-satunya permukaan yang mengumpulkan segala-galanya yang menyekat anda atau secara eksplisit meminta anda — kelulusan ejen yang tertunda, segerak tiket yang gagal dan setiap pull request yang melibatkan anda sebagai penyemak atau pengarang.

Buka peti masuk

1. Klik Peti masuk dalam bar sisi. Lencananya mengira kelulusan ejen yang tertunda, segerak yang gagal dan PR terbuka yang menunggu semakan anda.
2. Atau tekan ⌘K dan jalankan perintah navigasi Peti masuk.
3. Atau paut terus ke /workspaces/<workspace-id>/inbox.

Entri bar sisi sentiasa menunjukkan kiraan langsung, jadi anda boleh melihat kerja triage terkumpul tanpa membuka halaman itu.

Baca keterukan secara sekilas

Imbas dari atas ke bawah; peti masuk sudah disusun mengikut kegentingan:

1. Jalur Memerlukan perhatian anda yang disemat berada di atas bahagian PR. Setiap kad membawa cip keterukan. Sumber berdaftar (ejen yang tersekat pada gesaan pengesahan, segerak tiket yang cermin vendornya basi) mengeluarkan Disekat.
2. Dalam jalur itu, keterukan yang paling mendesak didahulukan; jika sama, item yang paling lama menunggu didahulukan.
3. Di bawah jalur itu, PR dikelompokkan ke dalam bahagian kitaran hayat semakan yang tetap — Memerlukan semakan anda, Dipulangkan kepada anda, Diluluskan, Draf, Menunggu penyemak, Mencantum dan baru dicantum, Menunggu pengarang. Bahagian di atas ialah apa yang memerlukan anda; selebihnya ialah kedudukan PR anda. Memerlukan semakan anda merangkumi PR yang masih meminta pasukan yang anda anggotai pada forge yang menyokongnya (GitHub menggugurkan pasukan itu sebaik sahaja mana-mana rakan sepasukan menyemak).

Sesuatu item hanya masuk ke peti masuk apabila ia menyekat sesuatu atau secara eksplisit meminta anda. Jalur kosong berserta senarai bahagian kosong hanya memaparkan Anda sudah mengejar semuanya apabila kekosongan itu boleh dipercayai.

Satu peti masuk merentas setiap forge

Jika ruang kerja menyimpan repo pada lebih daripada satu hos kod, peti masuk menggabungkannya menjadi satu aliran — pull request GitHub dan pull request Bitbucket duduk dalam bahagian yang sama, disusun mengikut masa dan bukannya dikelompokkan mengikut vendor. Meta repo #number pada baris itulah yang membezakannya.

“Milik anda” dileraikan bagi setiap forge, kerana anda ialah akaun yang berbeza pada setiap satu. Sesuatu pull request hanya dikira milik anda, atau meminta semakan anda, apabila ia memadankan identiti anda pada forge tempat repo itu benar-benar berada.

Forge yang tidak berfungsi atau tidak disambungkan tidak menyumbang apa-apa dan membiarkan seluruh peti masuk tidak tersentuh — satu sambungan yang rosak tidak pernah mengosongkan keseluruhan senarai. Keadaan kosong itu menyatakan satu peringatan dan bukannya Anda sudah mengejar semuanya apabila setiap log masuk forge masih belum dileraikan (Tidak dapat mengesahkan akaun GitHub anda — teks itu masih menamakan GitHub), apabila githubstatus.com melaporkan insiden, atau apabila pemasangan GitHub App yang meliputi repo berpaut digantung.

Kosongkan jalur perhatian

Setiap kad jalur mempunyai satu tindakan seterusnya:

1. Jika sesuatu kad ialah pengesahan ejen yang tertunda, klik Semak — anda mendarat dalam ruang ejen itu dengan pengesahannya yang tertunda. Luluskan atau tolak di situ (lihat Sembang dengan ejen).
2. Jika sesuatu kad menyatakan Segerak gagal bagi sesuatu vendor, klik Buka — anda mendarat pada Tetapan → Ruang kerja → Umum, yang kad Kesihatan segerak-nya menunjukkan segerak terakhir setiap sambungan, rentetan kegagalan berturut-turut dan hasil terkini. Hanya kegagalan terkini bagi setiap vendor muncul dalam peti masuk, jadi segerak yang telah pulih mengosongkan kad itu.
3. Kad hilang dengan sendirinya sebaik sahaja keadaan asasnya selesai (ejen dijawab, segerak pulih) — tiada apa-apa yang perlu dibuang secara manual.

Ini pengesahan setiap giliran, bukan kelulusan tadbir urus

Kad “kelulusan ejen” ialah ejen yang sedang berjalan berhenti sebentar untuk meminta kebenaran bagi satu tindakan, dalam perbualannya sendiri. Ia berbeza daripada rekod Approval tadbir urus yang dicipta oleh ejen dengan alat MCP kelulusan — rekod itu tiada skrin manusia di mana-mana dalam apl dan tidak pernah muncul di sini.

Kesihatan segerak adalah baca sahaja

Kad itu melaporkan tentang sambungan segerak tiket; selain butang Segerak sekarang, ia tidak boleh mencipta, menyunting atau menyambung semula sambungan dan tiada skrin lain yang boleh berbuat demikian. Apabila tiada sambungan dikonfigurasikan, ia hanya membaca “Belum ada sambungan segerak”, iaitu apa yang dipaparkan oleh ruang kerja baharu.

Tapis kepada apa yang menyekat

1. Tekan f (tanpa medan teks difokuskan) untuk membuka menu penapis, atau klik butang penapis pada bar alat.
2. Pilih mana-mana gabungan status, pengarang, penyemak, kandungan, pemilik/nama repo, tetingkap tarikh, atau pantas untuk disemak. Kiraan fasit dalam menu menunjukkan berapa banyak item peti masuk yang dipadankan oleh setiap pilihan.
3. Penapis aktif muncul sebagai cip dalam bar di atas senarai; klik ✕ pada sesuatu cip untuk menggugurkan kriteria itu.
4. Gunakan rel kiri untuk melompat antara bahagian — setiap entri menunjukkan kiraan langsungnya dan sorotan itu mengikut kedudukan tatal anda. Klik pengepala bahagian untuk menguncupkan bahagian yang tidak anda triage (contohnya Draf semasa mengosongkan semakan).
5. Klik pengepala lajur (tajuk, perubahan atau dikemas kini) untuk menyusun setiap bahagian; klik lajur yang aktif sekali lagi untuk membalikkan arah. Butang pilihan paparan mengawal keterlihatan draf, tetingkap baru dicantum, sifat baris, susunan dan pengelompokan (hanya pengelompokan mengikut pengarang mengubah susun atur peti masuk).

Penapis di sini adalah bebas daripada baris gilir PR — menyempitkan peti masuk tidak pernah mengubah penapis baris gilir itu dan sebaliknya.

Bertindak ke atas item PR

1. Klik mana-mana baris untuk membuka halaman butiran PR.
2. Jika PR berada dalam Memerlukan semakan anda, semak ia dan hantar keputusan anda — lihat Semak dan cantumkan PR.
3. Jika PR berada dalam Dipulangkan kepada anda (perubahan diminta atau CI gagal), hantar pembetulan daripada checkout anda atau serahkan susulan itu kepada ejen.
4. Jika PR berada dalam Diluluskan, cantumkannya daripada halaman butiran.
5. Jika anda lebih suka mewakilkan semakan daripada melakukannya sendiri, lihat Hantar ejen penyemak dan kitaran hayat penghantaran ejen.

Sebaik sahaja keadaan asasnya berubah (semakan anda masuk, PR dicantumkan), pengelas memfailkan semula PR itu ke dalam bahagian baharunya secara automatik.

Buat asal tindakan yang tersilap

1. Tekan ⌘Z untuk membuat asal tindakan terakhir, ⌘⇧Z untuk mengulanginya semula.
2. Jika medan teks difokuskan, ⌘Z menyunting teks medan itu sebaliknya — klik di luar medan itu dahulu untuk membuat asal tindakan peringkat apl.

Cari pintasan di tempatnya

Tekan ? (tanpa medan teks difokuskan) untuk membuka helaian rujukan pantas pintasan papan kekunci. Ia menyenaraikan setiap pengikatan yang aktif pada laluan semasa, termasuk pintasan penapis f peti masuk. Peta lengkapnya ada dalam rujukan pintasan papan kekunci.

Kendalikannya daripada palet perintah

1. Tekan ⌘K di mana-mana untuk membuka palet perintah.
2. Taip Peti masuk untuk melompat ke halaman itu, atau taip tajuk PR — palet itu menyenaraikan pull request yang sepadan dan membuka yang anda pilih.
3. Semasa peti masuk terbuka, jalankan Salin pautan ke halaman ini untuk menyalin URL itu bagi tujuan perkongsian. Perintah itu menyalin laluan semasa, jadi ia ialah URL peti masuk hanya apabila anda berada pada halaman ini.

Muat semula atas permintaan

Peti masuk dikemas kini secara langsung, tetapi jika anda mengesyaki data basi, klik kawalan muat semula pada bar alat — ia memaksa sapuan segera di sisi pelayan bagi setiap forge yang disambungkan dan mengambil semula lapisan tindanan cantuman/semakan. Ikon itu berputar sehingga setiap pengambilan selesai.

Panduan berkaitan

• Semak dan cantumkan PR
• Sembang dengan ejen
• Hantar ejen penyemak

Konsep berkaitan

• Kitaran hayat penghantaran ejen