Memindahkan projek daripada Codex ke Hermes pada pelayan

Untuk mendapatkan bantuan menggunakan perkhidmatan ini, lihat dokumentasi Ailoot.

Perkara yang perlu disediakan sebelum pemindahan#

Repositori ialah folder projek yang mengandungi sejarah perubahan Git. Salinan kerja mengandungi fail yang anda edit. Tugas di sini ialah memindahkan salinan itu ke pelayan dan meneruskan pembangunan. Anda belum perlu menyediakan aplikasi untuk dilawati pengguna.

Jika ejen belum dipasang pada pelayan, mulakan dengan memasang Hermes Agent pada VPS. Di sini, anda memerlukan pemasangan Hermes yang berfungsi, terminal pelayan dan Git. Anda memerlukan repositori jauh yang boleh diakses dari pelayan; jika anda belum memilikinya, cipta repositori itu dahulu dan simpan projek di situ tanpa rahsia. Untuk repositori peribadi, sediakan akses baca daripada akaun anda sendiri terlebih dahulu; jangan letakkan token dalam URL repositori atau dalam mesej kepada ejen.

Hentikan pengeditan projek secara serentak semasa pemindahan. Pada komputer sumber, buka terminal terus dalam folder projek dan jalankan:

git status --short --branch
git status --short --ignored

Arahan pertama memaparkan cabang dan status fail. M bermaksud perubahan, manakala ?? bermaksud fail yang belum dijejak oleh Git. Dalam arahan kedua, fail yang diabaikan ditandakan dengan !!. Status bersih yang biasa tidak membuktikan bahawa anda tidak mempunyai fail yang diperlukan di luar Git.

Simpan perubahan yang diperlukan dalam commit berasingan dan hantar cabang yang betul ke repositori jauh dengan cara biasa anda. Sebelum menghantarnya, semak kandungan commit itu: kunci, kata laluan dan data pengguna sebenar tidak boleh disertakan. Jika anda tidak tahu perubahan mana yang perlu disimpan, minta Codex menyenaraikannya dan menerangkan tujuannya dahulu, tanpa memadamkan fail atau menghantar apa-apa ke repositori.

Jangan anggap bahawa pengklonan repositori akan memindahkan pangkalan data luaran, kandungan folder yang diabaikan atau perbualan anda dengan Codex. Sejarah sembang, langganan, profil dan tetapan ejen itu sendiri bukan sebahagian daripada kaedah pemindahan ini.

Salin cabang yang betul ke pelayan#

Mula-mula, simpan output arahan ini pada komputer sumber:

git status --porcelain=v2 --branch

Baris # branch.oid menunjukkan commit semasa, manakala # branch.head menunjukkan cabang. Commit ialah versi projek yang disimpan. Untuk projek biasa yang sudah mempunyai commit, ini membolehkan anda membandingkan salinan sumber dengan salinan baharu; perbandingan ini tidak menyemak perubahan yang belum di-commit.

Pada pelayan, pergi ke direktori tempat anda akan menyimpan projek. Klon repositori anda ke dalam folder baharu. Dalam templat di bawah, gantikan REPOSITORY_URL dengan URL repositori anda, BRANCH_NAME dengan nama cabang yang telah anda simpan dan hantar, serta my-project dengan nama yang anda mahu gunakan untuk folder baharu itu:

git clone --branch BRANCH_NAME REPOSITORY_URL my-project
cd my-project
git status --porcelain=v2 --branch

Ini ialah templat, bukannya URL sedia untuk disalin. git clone mencipta folder dan salinan kerja bagi cabang yang dipilih. Jika folder destinasi sudah wujud, folder itu mestilah kosong: jangan padam kandungannya untuk menjalankan semula arahan tersebut; pilih nama baharu.

Bandingkan # branch.oid dalam kedua-dua salinan. Jika nilainya berbeza, jangan mula membaiki kod pada pelayan: semak cabang yang dipilih, commit yang telah dihantar dan sama ada perubahan serentak telah dibuat. Jika output status menunjukkan fail yang diubah suai, siasat fail tersebut secara berasingan. Jangan gunakan pembersihan atau tetapan semula paksa untuk “menyamakan” kedua-duanya.

Repositori yang mempunyai submodul Git—repositori bersarang—juga memerlukan anda mendapatkan kandungannya. git clone menyediakan pilihan --recurse-submodules untuk tujuan ini; gunakan pilihan itu jika projek benar-benar mengandungi submodul dan URL submodul tersebut telah disemak. Projek yang mempunyai sumber luaran lain mungkin memerlukan prosedur tambahan yang diterangkan dalam README.

Pulihkan kebergantungan mengikut peraturan projek#

Mula-mula, baca README dan fail konfigurasi projek. Ketahui versi masa jalan yang diperlukan dan pengurus pakej yang digunakan untuk memasang kebergantungan. Jangan gantikan alat biasa projek dengan npm hanya kerana alat itu muncul dalam contoh di bawah.

Contoh hipotesis untuk Node.js dan npm: repositori mempunyai fail package.json dan package-lock.json yang konsisten, dan versi Node.js yang sesuai untuk projek telah dipasang pada pelayan. Dalam keadaan itu, jalankan arahan ini dalam folder projek:

npm ci

Menurut dokumentasi npm ci, arahan ini memasang kebergantungan untuk keseluruhan projek daripada fail kunci tanpa menulis semula package.json atau package-lock.json. Jika kandungan fail tersebut tidak konsisten, pemasangan akan gagal. Mana-mana folder node_modules yang sedia ada akan dipadamkan sebelum pemasangan.

Jika fail kunci dicipta menggunakan pilihan yang mempengaruhi pepohon kebergantungan, seperti --legacy-peer-deps, npm ci memerlukan pilihan yang sama. Semak arahan dan tetapan projek sumber. Jangan padam fail kunci atau kemas kini semua kebergantungan untuk menyembunyikan ralat pemindahan yang pertama.

Sebelum memasang, semak arahan pemasangan dan permulaan dalam projek anda sendiri. Jalankannya dalam salinan kerja yang berasingan tanpa akses kepada data produksi, dan tetapkan sebarang nilai persekitaran yang diperlukan di luar sembang dan Git. Jika boleh, gunakan kelayakan ujian dengan kebenaran terhad untuk menyemak projek. Jika projek bergantung pada pangkalan data atau fail, pulihkan dahulu set data ujian yang dibenarkan mengikut arahannya; fail sumber yang sama tidak menggantikan data tersebut.

Selepas pemasangan, jalankan semakan sedia ada daripada README: ujian dan binaan, jika disediakan. Nama arahan bergantung pada projek. Pemasangan kebergantungan yang berjaya belum bermakna aplikasi berfungsi.

Buka salinan kerja dalam Hermes#

Dalam terminal pelayan, pergi ke akar salinan baharu dan mulakan ejen yang sudah dipasang:

cd /absolute/path/to/my-project
hermes

Di sini, /absolute/path/to/my-project ialah pemegang tempat untuk laluan penuh ke projek anda. Pada skrin permulaan Hermes, semak direktori kerja dan persekitaran tempat arahan terminal dijalankan. Kaedah permulaan ini ditujukan untuk persekitaran terminal setempat Hermes pada pelayan. Jika SSH atau Docker dikonfigurasikan, ejen mungkin menjalankan arahan dalam persekitaran lain; sahkan dahulu laluan projek yang tersedia di situ.

Minta ejen mengesahkan folder kerja sebenar menggunakan alat terminalnya, kemudian baca README dan arahan projek. Jangan anggap nama folder yang disebut dalam mesej sebagai pengesahan yang mencukupi.

Susunan di bawah dinyatakan dalam versi dokumentasi yang dipinkan dan mungkin berbeza daripada versi Hermes yang anda pasang. Semak arahan semasa dalam sesi anda. Hermes menyokong AGENTS.md, tetapi sama ada fail itu dibaca bergantung pada keutamaan fail konteks. Menurut dokumentasi rasmi Hermes, satu jenis fail arahan dipilih: .hermes.md, kemudian AGENTS.override.md, AGENTS.md, CLAUDE.md dan .cursorrules. Sebelum mula bekerja, semak sama ada terdapat .hermes.md lama atau AGENTS.override.md peribadi: jangan anggap ejen semestinya akan menggunakan AGENTS.md yang terletak bersamanya.

Dalam arahan yang dipilih, kekalkan tujuan projek, arahan semakan dan sekatan terhadap perubahan. Jangan jadikannya arkib perbualan. Jika anda perlu memindahkan tetapan ejen itu sendiri, itu proses yang berlainan; skopnya diterangkan dalam panduan untuk berhijrah daripada Claude Code ke Codex.

Berikan satu tugas kepada ejen dan semak hasilnya#

Mulakan dengan membaca projek tanpa membuat perubahan. Contohnya:

Kami sedang bekerja dengan projek sedia ada dalam folder yang saya nyatakan.
Sahkan direktori kerja sebenar menggunakan alat terminal.
Baca README dan arahan projek semasa.
Jangan buka fail yang mengandungi rahsia atau paparkan nilai persekitaran.
Senaraikan arahan semakan dan prasyarat untuk menjalankannya.
Buat masa ini, jangan ubah atau pasang apa-apa, atau hantar perubahan ke repositori.

Kemudian, persetujui satu tugas kecil, seperti membetulkan teks dalam antara muka. Nyatakan fail atau kawasan yang perlu diubah dan larang kemas kini kebergantungan sampingan. Jika anda mahu mengasingkan eksperimen daripada salinan utama, ketahui dahulu tentang salinan kerja Git worktree yang berasingan.

Terima hasil berdasarkan perubahan fail dan semakan projek yang dijalankan semula. Sebelum eksperimen yang mungkin gagal, simpan salinan sumber dan titik pemulihan; jangan minta ejen menetapkan semula semua perubahan secara pukal. Jika semakan gagal, bandingkan ralat itu dengan salinan sumber: ini membantu membezakan masalah pemindahan daripada kecacatan yang memang sudah wujud.

Pemindahan boleh dianggap selesai apabila versi fail sumber yang diperlukan tersedia, persekitaran telah dipulihkan, data yang diperlukan tersedia dalam persekitaran ujian yang selamat, semakan lulus dan Hermes bekerja tepat dalam folder ini. Penerbitan aplikasi untuk pengguna ialah peringkat seterusnya yang berasingan dan bukan sebahagian daripada semakan ini.

Kenali Ailoot.