Apa Itu GitHub? Kawalan Versi untuk Bukan Pembangun

GitHub ialah laman web yang menyimpan kod untuk projek perisian beserta sejarah lengkapnya, supaya anda boleh melihat setiap perubahan, membetulkan kesilapan, dan bekerja pada projek yang sama bersama orang lain. Ia dibina di atas Git, perisian percuma yang merekod gambar pantas fail projek dari masa ke masa. Git ialah alat yang menyimpan sejarah; GitHub ialah rumah dalam talian tempat sejarah itu dikongsi, disimpan sebagai sandaran dan dibincangkan.

Jika anda membina dengan AI, GitHub pada dasarnya berkaitan dua perkara: memiliki salinan kod anda di luar alat yang anda gunakan untuk membinanya, dan menyerahkannya kepada pembangun dalam format yang sudah mereka gunakan.

Mengapa ia penting apabila membina dengan AI

Pembina aplikasi AI menulis dan menukar banyak kod dengan pantas, dan tidak setiap perubahan itu penambahbaikan. Kawalan versi ialah cara anda memastikannya selamat.

• Buat asal dengan yakin. Setiap perubahan yang disimpan ialah satu gambar pantas. Jika AI merosakkan sesuatu, anda kembali ke versi baik yang terakhir.
• Pemilikan. Kod dalam akaun GitHub anda sendiri kekal milik anda jika anda bertukar alat, berhenti membayar untuk satu alat, atau mahukan pendapat kedua.
• Bekerja dengan pembangun. Hampir setiap pembangun menggunakan Git setiap hari. Repositori membolehkan mereka menyemak apa yang AI tulis, membetulkannya, dan menghantar perubahan semula.
• Menggunakan di tempat lain. Banyak platform hosting boleh melancarkan aplikasi terus daripada repositori GitHub.

Analogi harian: jejak perubahan ditambah pemacu kongsi

Bayangkan dokumen dengan jejak perubahan dihidupkan, disimpan dalam pemacu kongsi.

• Git ialah jejak perubahan: setiap suntingan direkodkan, dengan siapa yang membuatnya, bila dan kenapa, dan anda boleh kembali ke mana-mana versi.
• GitHub ialah pemacu kongsi: dokumen itu tinggal dalam talian, orang lain boleh mendapat salinan, dan ada tempat untuk memberi ulasan dan meluluskan.
• Cawangan (branch) seperti menyimpan salinan bernama “draf — bahagian harga baharu” supaya anda boleh mencuba tanpa menyentuh versi yang semua orang bergantung padanya. Jika percubaan itu berjaya, anda gabungkannya kembali.

Perbezaannya dengan dokumen ialah skala. Sebuah aplikasi mempunyai ratusan fail, dan Git menjejaki kesemuanya bersama-sama, jadi satu gambar pantas ialah keadaan seluruh projek pada satu masa.

Istilah Git dan GitHub yang akan anda temui

Dua perkara ini wajar ditekankan. Pertama, sejarah Git kekal secara reka bentuk: jika kata laluan dikomit dan dipush, memadamkannya dalam komit kemudian tidak membuangnya daripada sejarah. Kedua, komit hanya berguna setakat mesejnya. “Betulkan pengiraan dua kali tempahan apabila dua orang menempah serentak” membantu anda kemudian; “kemas kini” tidak membantu.

Contoh kerja: menyerahkan aplikasi yang dibina AI kepada freelancer

Anda telah membina portal pelanggan dengan pembina aplikasi AI. Ia berfungsi, tetapi anda mahu seorang pembangun bebas menambah integrasi yang rumit dengan perisian perakaunan anda.

1. Sambungkan projek ke repositori GitHub persendirian yang baharu dan push. Repositori kini memegang kod dan sejarahnya.
2. Semak apa yang ada di dalamnya. Buka repositori di GitHub. Tidak sepatutnya ada fail .env dan tiada kunci API dalam kod. Rahsia kekal dalam tetapan platform anda dan dikongsi dengan freelancer secara berasingan, jika perlu — lihat pembolehubah persekitaran dan rahsia.
3. Jemput freelancer sebagai kolaborator pada repositori itu sahaja.
4. Mereka bekerja pada cawangan yang dinamakan seperti accounting-sync, mengkomit semasa bekerja, dan membuka pull request apabila selesai.
5. Anda menyemak pull request itu. Walaupun tanpa membaca kod, anda boleh membaca penerangannya, menyemak fail mana yang berubah, dan bertanya soalan dalam ulasan.
6. Gabungkan apabila anda berpuas hati, kemudian pull perubahan itu kembali ke pembina anda supaya anda dan AI meneruskan kerja daripada versi baharu.

Sepanjang proses ini, anda boleh melihat dengan tepat apa yang berubah dan membatalkannya jika perlu. Itulah keseluruhan nilai kawalan versi dalam satu aliran kerja. Jika anda masih menimbang sama ada perlu membawa pembangun, lihat upah pembangun atau bina dengan AI.

Kesilapan dan salah faham lazim

• “GitHub dan Git itu sama.” Git berfungsi tanpa GitHub; alternatif seperti GitLab dan Bitbucket juga menghoskan repositori Git.
• “GitHub akan menjalankan aplikasi saya.” GitHub menyimpan kod. Menjalankannya untuk orang ramai ialah web hosting, perkhidmatan berasingan (walaupun sesetengah hos melancarkan dari GitHub).
• Mengkomit rahsia. Kesilapan paling merosakkan dan paling biasa. Gunakan .gitignore untuk fail .env, dan tukar mana-mana kunci yang pernah dipush.
• Hanya satu cawangan dan tiada mesej. Tidak mengapa untuk eksperimen solo, tetapi beri komit mesej yang jelas dan gunakan cawangan untuk apa-apa yang berisiko.
• Menyunting di dua tempat serentak. Jika anda menukar kod di GitHub dan di pembina AI tanpa menarik perubahan di antara keduanya, anda akan mencipta konflik. Pilih satu tempat untuk menyunting pada satu masa, dan segerakkan sebelum bertukar.
• Menganggap repo persendirian ialah sandaran untuk semua. Ia menyimpan kod, bukan kandungan pangkalan data atau fail yang dimuat naik. Semua itu memerlukan sandaran sendiri.

Apa yang patut diminta kepada pembina AI anda

• “Tambah .gitignore yang mengecualikan .env, folder dependensi dan output binaan.”
• “Tulis README yang menerangkan cara pemasangan, pembolehubah persekitaran yang diperlukan (nama sahaja), dan cara menjalankan aplikasi.”
• “Tambah .env.example dengan setiap nama pembolehubah dan tanpa nilai sebenar.”
• “Gunakan mesej komit yang jelas dan deskriptif untuk setiap perubahan.”

Empat permintaan ini menghasilkan repositori yang boleh diambil alih oleh pembangun dalam beberapa minit. Untuk memindahkan aplikasi ke pelayan anda sendiri, lihat cara mengeksport dan menghoskan sendiri aplikasi yang dibina AI, dan untuk mengukuhkannya sebelum pengguna sebenar, lihat membawa prototaip AI ke pengeluaran.

GitHub dan Mythex

Mythex menyimpan sejarah untuk anda pada setiap pelan: selepas setiap giliran ejen yang berjaya, ia menyimpan checkpoint, iaitu gambar pantas Git yang boleh anda kembali kepadanya. Pada Pro, anda boleh menyambungkan GitHub dan push atau pull projek dengan repositori anda sendiri, atau muat turun keseluruhan projek sebagai arkib; rahsia dan dependensi yang dipasang dikecualikan daripada eksport. GitHub di sini digunakan untuk menyegerakkan kod, bukan untuk log masuk ke Mythex. Lihat GitHub, eksport dan import dalam dokumentasi, dan halaman harga untuk apa yang disertakan dalam setiap pelan.

Soalan lazim