Open Code Review Alibaba: pemasangan dan semakan pertama anda

Dokumentasi Ailoot: API, kunci dan integrasi.

Fungsi Open Code Review#

Projek ini diterbitkan dalam repositori rasmi Alibaba di bawah lesen Apache-2.0. Dalam README, pembangun menerangkan gabungan pemilihan fail dan peraturan secara terprogram dengan ejen yang menganalisis kod. Terdapat juga ocr scan untuk fail lengkap apabila tiada diff yang bermakna—satu set perubahan Git.

Mulakan dengan semakan pertama anda dan nilai komen pada kod anda sendiri. Penjimatan token pada projek anda tidak diukur di sini. Artikel tentang dakwaan palsu bahawa sesuatu sudah “selesai” menerangkan sebabnya hasil ejen berguna untuk disemak secara berasingan.

Sediakan repositori dan pasang OCR#

Anda memerlukan Git 2.41 atau yang lebih baharu dan npm untuk kaedah pemasangan ini. Mulakan dengan repositori ujian yang tidak mengandungi rahsia. Ejen boleh membaca fail lengkap dan mencari dalam pangkalan kod, manakala mod direktori kerja turut merangkumi fail yang tidak dijejak. Periksa seluruh repositori, termasuk fail baharu: repositori itu tidak boleh mengandungi kunci atau data yang tidak boleh dihantar kepada model pilihan anda.

git --version
npm install -g @alibaba-group/open-code-review

Selepas pemasangan, perintah ocr tersedia. Semak pilihan pemasangan dan pakej itu sendiri berdasarkan README rasmi, bukannya pakej rawak yang namanya serupa.

Konfigurasikan model dan jalankan semakan#

Dalam terminal, jalankan:

ocr config provider
ocr config model

Antara muka interaktif meminta anda memilih penyedia, memasukkan kunci API dan mengkonfigurasikan model, kemudian menyemak sambungan. Masukkan kunci melalui antara muka yang ditetapkan, bukan dalam fail projek atau mesej commit. Sebelum menjalankan semakan, ketahui cara penyedia pilihan anda mengenakan bayaran: lesen OCR percuma tidak bermakna panggilan model juga percuma.

Pergi ke direktori projek anda dan jalankan semakan. Gantikan your-project dengan laluan ke projek anda:

cd your-project
ocr review

Dalam mod ini, ocr review menyemak perubahan yang dipentaskan, yang belum dipentaskan dan perubahan baharu yang tidak dijejak. Untuk menyimpan komen sebagai JSON, anda boleh menggunakan:

ocr review --format json --output result.json

Jangan tambahkan laporan itu secara automatik pada commit: semak dahulu sama ada laporan tersebut mengandungi kod atau data sensitif. Terdapat perintah berasingan untuk menyemak keseluruhan fail dalam direktori, tanpa mengira perubahan:

ocr scan --path internal/agent

internal/agent ialah contoh daripada README; gantikannya dengan laluan sedia ada dalam projek anda. Mulakan dengan direktori kecil untuk menilai sejauh mana komen itu berguna dan kos sebenar sebelum mengimbas semuanya.

Cara menentukan sama ada sesuatu semakan berguna#

Buka setiap komen, cari baris berkenaan dan semak sama ada masalah itu boleh dihasilkan semula. Sahkan pembaikan dengan ujian dan rekodkan positif palsu secara berasingan. Ketiadaan komen tidak menggantikan ujian fungsi dan pemeriksaan kawalan akses.

Dalam perbandingan mereka, pembangun menyatakan dalam README bahawa OCR mengesan bahagian isu yang lebih kecil berbanding ejen tujuan umum. Ini ialah dakwaan pembangun berdasarkan keadaan kajian mereka, bukannya ukuran kualiti projek anda. Ketepatan OCR tidak diukur secara bebas di sini.

Perbezaan mod delegasi#

Mod biasa menggunakan model yang dikonfigurasikan dalam OCR. Dalam mod delegasi, OCR memilih fail dan menentukan peraturan, manakala ejen AI anda menyemak kod menggunakan modelnya sendiri. Konfigurasi model dan kunci API OCR yang berasingan tidak diperlukan dalam mod ini.

Perintah persediaan daripada README:

ocr delegate preview
ocr delegate rule src/main.go src/handler.go

Gantikan laluan tersebut dengan laluan anda sendiri. Selepas menjalankan perintah ini, serahkan analisis kepada ejen yang disambungkan: menyediakan fail belum lagi bermakna kod telah disemak. Syarat bayaran dan had ejen itu masih terpakai, jadi “tiada kunci berasingan diperlukan” tidak bermakna “semakan percuma”.

Repositori tersebut menerangkan integrasi dengan Claude Code, Codex dan ejen lain. Jika anda menggunakan Codex, biasakan diri dahulu dengan cara kemahiran Codex berfungsi; untuk alat lain yang disokong, terdapat pengenalan kepada Kimi Code. Sambungkan integrasi selepas anda memahami laporan biasa, bukan sebagai ganti membacanya.

Jika proses tidak menghasilkan keputusan#

Semak sama ada versi Git yang diperlukan telah dipasang, sama ada anda berada dalam direktori projek yang betul dan sama ada sambungan kepada model berfungsi. Jika tiada perubahan untuk disemak, jangan anggap hasil kosong sebagai semakan seluruh pangkalan kod: gunakan scan untuk fail lengkap. Jangan sekat commit secara automatik berdasarkan satu laporan yang belum anda kenali.

Perintah tersebut disemak berdasarkan README rasmi pada semakan repositori yang dipinkan. Tiada proses berbayar dijalankan pada projek pengguna. Kriteria kejayaan percubaan pertama ialah komen yang jelas dan dapat anda sahkan atau tolak berserta alasan.

Jika anda memerlukan akses kepada model AI melalui Ailoot, lihat Ailoot.