Simpan projek anda ke GitHub

GitHub ialah tempat pembangun menyimpan kod, dengan sejarah setiap perubahan. Pautkan projek MonstarX ke repositori GitHub (folder projek di GitHub), dan kedua-duanya kekal selari, dalam dua arah: apa yang dibina oleh MonstarX dihantar ke sana sebagai commit, dan apa yang anda atau pembangun commit di sana kembali ke MonstarX.

Ini berguna apabila pembangun mahu mengusahakan kod dalam editor mereka sendiri, apabila syarikat anda menyimpan semua kod di GitHub, atau apabila anda deploy daripada GitHub — seperti yang dilakukan oleh Railway.

Bagaimanakah saya menyambungkan akaun GitHub saya?

Anda menyambungkan GitHub sekali sahaja untuk keseluruhan akaun MonstarX anda, daripada Tetapan›Integrasi atau daripada butang GitHub dalam mana-mana projek. Cara paling mudah ialah GitHub App MonstarX: tiada token untuk dicipta atau ditampal, dan anda menentukan dengan tepat repositori mana yang boleh dicapai oleh MonstarX.

1. Klik Sambungkan akaun GitHub peribadi.

   

2. GitHub dibuka dan bertanya di mana aplikasi itu hendak dipasang. Pilih akaun peribadi anda (bukan organisasi).

3. Pilih repositori yang boleh digunakan oleh MonstarX: All repositories, atau Only select repositories dan tandakan repositori yang anda mahu. Anda boleh mengubahnya kemudian di GitHub.

4. Klik Install, kemudian Authorize apabila GitHub meminta anda mengesahkan.

5. Anda kembali ke MonstarX. Kad itu memaparkan Disambungkan · GitHub App.

Beberapa perkara yang perlu diketahui tentang GitHub App:

• Tiada kelulusan organisasi. Ia hanya dipasang pada akaun peribadi anda. Jika anda tersilap memilih organisasi, MonstarX akan meminta anda memasangnya pada akaun peribadi anda dan mencuba lagi.
• Repositori baharu dicipta dalam akaun peribadi anda. MonstarX sentiasa boleh mencapai repositori yang diciptanya, walaupun anda memilih Only select repositories.
• Pilihan repositori anda menjadi hadnya. Untuk memautkan repositori sedia ada, repositori itu mesti salah satu yang telah anda berikan kepada aplikasi. Tambah lagi dalam tetapan GitHub untuk aplikasi yang dipasang.
• Akses bersifat jangka pendek dan diperbaharui secara automatik, serta disimpan secara disulitkan. Ia tidak pernah dihantar ke pelayar anda.

Cara lain untuk menyambung

Jika anda lebih suka, dua kaedah lain turut disediakan:

Kaedah	Bila menggunakannya
Repositori peribadi dengan akses terhad (dalam Tetapan: Sambungkan repositori peribadi dengan akses terhad)	Anda mahu MonstarX mencapai satu repositori sahaja menggunakan token akses peribadi (kata laluan yang anda cipta di GitHub untuk satu tujuan). Cipta token fine-grained dengan akaun peribadi anda sebagai pemilik sumber, hanya untuk repositori itu, dengan Contents: read and write. Cipta repositori itu di GitHub dahulu; token jenis ini tidak boleh mencipta repositori baharu.
Gunakan kebenaran GitHub	Anda mahu menghantar ke repositori dalam organisasi yang anda sertai. Skrin log masuk biasa GitHub mungkin merangkumi akses kepada organisasi tersebut, jadi semak dahulu sebelum anda membenarkannya.

Selepas disambungkan, kad itu menunjukkan cara sambungannya (GitHub App, Log masuk dengan GitHub atau Token akses peribadi) dan menyenaraikan setiap repositori yang sentiasa dikemas kini oleh MonstarX, dengan masa penyegerakan terakhir bagi setiap satu dan sama ada ia disegerakkan secara Automatik atau Secara manual. Menyambung dengan cara lain kemudian akan menggantikan sambungan lama; repositori yang sudah dipautkan kekal dipautkan.

Bagaimanakah saya menyimpan projek ke GitHub?

1. Buka projek dan klik GitHub di bar atas. (Ia juga terdapat dalam Tetapan›Eksport projek, di bawah Simpan dalam GitHub.)

2. Jika akaun anda belum disambungkan, sambungkan terus di situ.

   

3. Pilih Repositori baharu atau Repositori sedia ada:

   • Repositori baharu — pilih Pemilik (anda atau salah satu organisasi anda), taip Nama repositori, biarkan Repositori persendirian ditandakan kecuali anda mahu semua orang melihat kod itu, dan klik Cipta repositori dan hantar.
   • Repositori sedia ada — taip owner/repository atau tampal alamat github.com repositori itu, secara pilihan Cabang (cabang lalai jika dibiarkan kosong), dan klik Sambungkan dan segerakkan. Akaun anda memerlukan kebenaran untuk menghantar ke repositori itu.

4. MonstarX menghantar keseluruhan projek sebagai repositori yang sedia untuk deployment. Butang GitHub memaparkan titik hijau apabila ia sudah selari.

Repositori baharu bermula dengan satu commit, “Initial commit from MonstarX”. Dalam repositori sedia ada, projek di-commit di atas cabang itu, dan fail yang tidak diurus oleh MonstarX — LICENSE, aliran kerja CI, dokumentasi — tidak pernah disentuh.

Apakah yang dimasukkan ke dalam repositori?

Semua yang diberikan oleh Eksport: kod aplikasi, fail rangka kerja MonstarX, konfigurasi untuk menjalankan dan deploy, migrasi pangkalan data, senarai nama rahsia yang diperlukan oleh aplikasi (tidak pernah nilainya), dan README.

Sesetengah perkara tidak pernah dihantar ke GitHub:

• Nilai rahsia serta baris pangkalan data dan fail yang dimuat naik aplikasi anda kekal di MonstarX.
• Baris yang diimport daripada hamparan tidak pernah dihantar, kerana repositori mungkin awam dan baris itu mengandungi butiran pelanggan anda.
• Fail binari dan fail melebihi 1 MB dilangkau dan disenaraikan dalam log penyegerakan.

Bilakah MonstarX menyegerakkan?

Selagi Hantar setiap perubahan secara automatik dihidupkan (ia dihidupkan secara lalai), MonstarX menyegerakkan:

• selepas setiap permintaan yang mengubah fail aplikasi — mesej commit ialah permintaan anda;
• selepas pembetulan automatik QA;
• selepas anda memulihkan versi;
• selepas anda menyimpan atau memadam fail dalam paparan Kod.

Segerakkan sekarang dalam menu GitHub menghantar dan mengambil perubahan bila-bila masa anda mahu. Matikan penghantaran automatik jika anda lebih suka menyegerakkan secara manual.

Apakah yang berlaku apabila seseorang menyunting kod di GitHub?

Buat commit di GitHub seperti biasa. Pada penyegerakan seterusnya, MonstarX mengambil perubahan itu ke dalam projek:

• Perubahan pada fail aplikasi itu sendiri (src/, public/, migrations/ dan README.md) masuk ke MonstarX. Pratonton dikemas kini, migrasi pangkalan data baharu dijalankan, dan versi bernama Daripada GitHub: diikuti subjek commit muncul dalam Versi.
• Satu kad dalam perbualan, seperti “Mengambil 3 fail daripada GitHub”, menyenaraikan fail itu, supaya anda dan pembina MonstarX sama-sama tahu apa yang berubah.
• Perubahan pada fail rangka kerja MonstarX, seperti package.json atau konfigurasi, kekal di GitHub sehingga MonstarX sendiri mengubah fail itu pada kali seterusnya.
• Jika fail yang sama berubah di kedua-dua belah, MonstarX mengekalkan versinya dan GitHub menyimpan versi anda dalam sejarah. Kad itu menandakannya “diubah pada kedua-dua belah — versi MonstarX dikekalkan”.

Petua

Jika pembangun sedang mengubah sesuatu fail di GitHub, elakkan meminta MonstarX mengubah fail yang sama pada masa yang sama. Menyegerakkan lebih kerap (Segerakkan sekarang) memastikan kedua-dua belah kekal hampir sama.

Apakah yang ditunjukkan oleh menu GitHub selepas dipautkan?

• Repositori, cabangnya dan sama ada ia Persendirian atau Awam.
• Bila ia terakhir disegerakkan (Disegerakkan beberapa minit yang lalu), atau Penyegerakan terakhir gagal berserta sebabnya.
• Segerakkan sekarang dan Buka repositori.
• Hantar setiap perubahan secara automatik.
• Penyegerakan terkini — lima yang terakhir, setiap satu dengan commitnya.
• Nyahpaut repositori — menghentikan penyegerakan. Repositori kekal di GitHub.
• Putuskan sambungan — memutuskan sambungan akaun GitHub anda. Tiada apa-apa dihantar sehingga anda menyambung semula.

Bagaimana pula dengan aplikasi yang saya import daripada GitHub?

Apabila anda mengimport aplikasi daripada repositori yang boleh anda hantar perubahan kepadanya, projek itu kekal dipautkan kepadanya — pada cabang baharu bernama monstarx, yang bermula daripada commit yang anda import. Cabang anda sendiri tidak pernah berubah. Apabila anda berpuas hati dengan perubahan MonstarX, Buka pull request dalam menu GitHub membawa anda ke GitHub untuk menggabungkannya.

Soalan lazim

Perlukah saya token GitHub?

Tidak. Sambungkan akaun GitHub peribadi memasang GitHub App MonstarX: anda log masuk di GitHub, memilih repositori, dan selesai. Token akses peribadi hanyalah alternatif untuk mereka yang mahu mengehadkan MonstarX kepada satu repositori dengan cara itu.

Bolehkah GitHub App mencapai organisasi syarikat saya?

Tidak — ia hanya dipasang pada akaun peribadi anda, dan mencipta repositori baharu di situ. Untuk menghantar ke repositori sesebuah organisasi, sambungkan dengan Gunakan kebenaran GitHub, atau minta organisasi itu menambah anda supaya anda boleh memautkannya daripada akaun anda.

Bagaimanakah saya memberi MonstarX akses kepada repositori lain kemudian?

Di GitHub, buka tetapan anda untuk GitHub App yang dipasang, pilih MonstarX, dan tambah repositori itu (atau tukar kepada All repositories). Kemudian pautkannya daripada menu GitHub projek.

Adakah repositori saya persendirian?

Repositori baharu bersifat persendirian secara lalai — nyahtanda Repositori persendirian hanya jika anda mahu kod itu terbuka kepada umum. MonstarX tidak pernah menghantar nilai rahsia atau data aplikasi anda.

Bolehkah saya memautkan repositori milik organisasi syarikat saya?

Boleh, jika akaun GitHub anda boleh menghantar perubahan kepadanya. Gunakan Repositori sedia ada, atau pilih organisasi itu sebagai Pemilik semasa mencipta repositori baharu.

Apakah yang berlaku jika saya menyahpaut repositori?

MonstarX berhenti menyegerakkan. Repositori dan seluruh sejarahnya kekal di GitHub, dan anda boleh memautkannya semula kemudian.

Pembangun telah mengubah package.json di GitHub. Mengapakah ia tidak kembali?

Fail rangka kerja seperti package.json dan konfigurasi diurus oleh MonstarX. Suntingan padanya kekal di GitHub sehingga MonstarX mengubah fail itu pada kali seterusnya; penyegerakan kemudian tidak pernah membatalkannya secara senyap.

Bolehkah saya deploy daripada repositori itu?

Boleh. Repositori itu sedia untuk deployment, dan Railway deploy daripadanya. Lihat juga Terbitkan ke hos lain.

Apakah yang berlaku kepada pautan itu jika saya memindahkan projek?

Pautan itu digugurkan, supaya tiada apa-apa dihantar ke akaun GitHub anda bagi pihak pemilik baharu. Repositori itu sendiri tidak disentuh.

Berkaitan

Eksport kod andaMuat turun keseluruhan projek sebagai fail zip.

Import aplikasiBawa masuk aplikasi daripada GitHub atau fail zip.

VersiSetiap perubahan, dan cara memulihkannya.

Ejen pengekodanHantar dan ambil kod dengan Claude Code, Cursor atau Codex.