Open Code Review dari Alibaba: instalasi dan tinjauan pertama Anda

Dokumentasi Ailoot: API, kunci, dan integrasi.

Fungsi Open Code Review#

Proyek ini diterbitkan di repositori resmi Alibaba dengan lisensi Apache-2.0. Dalam README, para pengembang menjelaskan penggabungan pemilihan file dan aturan secara terprogram dengan agen yang menganalisis kode. Tersedia juga ocr scan untuk memeriksa seluruh file saat tidak ada diff yang bermakna—sekumpulan perubahan Git.

Mulailah dengan tinjauan pertama Anda dan nilai sendiri komentar pada kode Anda. Penghematan token pada proyek Anda belum diukur di sini. Alasan hasil agen perlu diperiksa secara terpisah dijelaskan dalam artikel tentang klaim palsu bahwa pekerjaan sudah “selesai”.

Siapkan repositori dan instal OCR#

Untuk metode instalasi ini, Anda memerlukan Git 2.41 atau yang lebih baru dan npm. Mulailah dengan repositori uji yang tidak berisi rahasia. Agen dapat membaca seluruh file dan menelusuri basis kode, dan mode direktori kerja juga mencakup file yang belum dilacak. Periksa seluruh repositori, termasuk file baru: repositori tidak boleh berisi kunci atau data yang tidak dapat dikirimkan ke model pilihan Anda.

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

Setelah instalasi, perintah ocr tersedia. Periksa opsi instalasi dan paketnya dengan README resmi, bukan paket acak dengan nama serupa.

Konfigurasikan model dan jalankan tinjauan#

Di terminal, jalankan:

ocr config provider
ocr config model

Antarmuka interaktif akan meminta Anda memilih penyedia, memasukkan kunci API, dan mengonfigurasi model, lalu memeriksa koneksi. Masukkan kunci melalui antarmuka yang disediakan, bukan dalam file proyek atau pesan commit. Sebelum menjalankan tinjauan, cari tahu cara penyedia pilihan Anda mengenakan biaya: lisensi gratis OCR tidak berarti pemanggilan model gratis.

Buka direktori proyek Anda dan jalankan tinjauan. Ganti your-project dengan jalur ke proyek Anda:

cd your-project
ocr review

Dalam mode ini, ocr review memeriksa perubahan yang sudah di-stage, yang belum di-stage, dan perubahan baru yang belum dilacak. Untuk menyimpan komentar sebagai JSON, Anda dapat menggunakan:

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

Jangan otomatis menambahkan laporan ke commit: periksa dahulu apakah laporan berisi kode atau data sensitif. Ada perintah terpisah untuk meninjau seluruh file dalam sebuah direktori, terlepas dari perubahan:

ocr scan --path internal/agent

internal/agent adalah contoh dari README; ganti dengan jalur yang ada di proyek Anda. Mulailah dengan direktori kecil untuk menilai kegunaan komentar dan biaya sebenarnya sebelum memindai semuanya.

Cara mengetahui apakah tinjauan berguna#

Buka setiap komentar, temukan barisnya, lalu periksa apakah masalahnya dapat direproduksi. Konfirmasikan perbaikan dengan pengujian, dan catat positif palsu secara terpisah. Tidak adanya komentar bukan pengganti pengujian fungsional dan pemeriksaan kontrol akses.

Dalam perbandingan mereka, para pengembang menyebutkan di README bahwa OCR mendeteksi proporsi masalah yang lebih kecil daripada agen serbaguna. Ini adalah klaim para pengembang dalam kondisi penelitian mereka, bukan pengukuran kualitas proyek Anda. Tidak ada pengukuran independen terhadap akurasi OCR yang dilakukan di sini.

Perbedaan mode delegasi#

Mode normal menggunakan model yang dikonfigurasi di OCR. Dalam mode delegasi, OCR memilih file dan menentukan aturan, sedangkan agen AI Anda meninjau kode menggunakan modelnya sendiri. Dalam mode ini, konfigurasi model terpisah dan kunci API untuk OCR tidak diperlukan.

Perintah persiapan dari README:

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

Ganti jalurnya dengan jalur Anda sendiri. Setelah menjalankan perintah ini, serahkan analisis kepada agen yang terhubung: menyiapkan file belum berarti tinjauan kode sudah dilakukan. Ketentuan pembayaran dan batasannya tetap berlaku, jadi “tidak perlu kunci terpisah” bukan berarti “tinjauan gratis”.

Repositori tersebut menjelaskan integrasi dengan Claude Code, Codex, dan agen lainnya. Jika Anda menggunakan Codex, pelajari dahulu cara kerja skill Codex; untuk alat lain yang didukung, tersedia pengantar Kimi Code. Hubungkan integrasi setelah Anda memahami laporan normal, bukan sebagai pengganti membacanya.

Jika proses tidak menghasilkan apa pun#

Periksa apakah versi Git yang diwajibkan sudah terinstal, apakah Anda berada di direktori proyek yang benar, dan apakah koneksi ke model berfungsi. Jika tidak ada perubahan untuk ditinjau, jangan sebut hasil kosong sebagai tinjauan seluruh basis kode: gunakan scan untuk seluruh file. Jangan memblokir commit secara otomatis berdasarkan satu laporan yang belum Anda pahami.

Perintah-perintah tersebut diperiksa terhadap README resmi pada revisi repositori yang dipatok. Tidak ada proses berbayar yang dijalankan pada proyek pengguna. Kriteria keberhasilan percobaan pertama adalah adanya komentar yang jelas dan dapat Anda konfirmasikan atau bantah dengan alasan.

Jika Anda memerlukan akses ke model AI melalui Ailoot, kunjungi Ailoot.