# Open Code Review Alibaba: pemasangan dan semakan pertama anda

> Sediakan model untuk Open Code Review, semak perubahan Git dan teliti hasilnya. Mod delegasi menggunakan model ejen anda.

Source: https://ailoot.ai/blog/ms/alibaba-open-code-review/
Canonical: https://ailoot.ai/blog/ms/alibaba-open-code-review/
Language: ms
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-187
Revision: sha256-7216460c53b0df0b5b88be706831d665e380009d3f1e2e988a778f16644ab67f


[Dokumentasi Ailoot: API, kunci dan integrasi](https://ailoot.ai/docs/).

## Fungsi Open Code Review

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Inti pati utama untuk bahagian ini">

Inti pati utama

Open Code Review, atau OCR, ialah alat baris perintah untuk menyemak kod. Alat ini membaca perubahan Git, menghantar fail kepada model bahasa yang dikonfigurasikan dan memulangkan komen yang dikaitkan dengan baris tertentu. Ini ialah semakan tambahan, bukannya bukti bahawa kod tersebut tiada ralat.

</div>

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”](https://ailoot.ai/blog/ms/ai-agent-says-done/) 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.

```bash
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:

```bash
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:

```bash
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:

```bash
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:

```bash
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:

```bash
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](https://ailoot.ai/blog/ms/codex-skills/); untuk alat lain yang disokong, terdapat [pengenalan kepada Kimi Code](https://ailoot.ai/blog/ms/kimi-code-install/). 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.

<div class="section" role="doc-bibliography" aria-label="Sumber">

### Sumber

- [Dokumentasi rasmi](https://raw.githubusercontent.com/alibaba/open-code-review/486022daaf14f7142275eddb9b3cacc3cc5dadfa/README.md)

</div>



Jika anda memerlukan akses kepada model AI melalui Ailoot, lihat [Ailoot](https://ailoot.ai/).

## Soalan lazim: Open Code Review Alibaba: pemasangan dan semakan pertama anda

### Adakah laporan OCR tanpa komen membuktikan kod betul?

Tidak. Pastikan perubahan Git yang dikehendaki benar-benar disemak dan kekalkan ujian fungsi serta kawalan akses. Bagi setiap isu dilaporkan, periksa baris dirujuk dan hasilkan semula masalah; jejak positif palsu secara berasingan.

### Adakah mod delegasi menjadikan semakan percuma?

Tidak. Ia mengelakkan konfigurasi model OCR berasingan dengan menyerahkan analisis kepada ejen yang disambungkan, dan syarat pembayaran serta had ejen itu masih terpakai. Arahan pratonton dan peraturan menyediakan serahan; ia bukan semakan yang telah selesai.


## Ailoot · Syarikat dan portfolio projeknya

Ailoot berteraskan pengalaman operasi yang mantap, pangkalan pelanggan yang besar, perkhidmatan yang stabil dan pemantauan KPI berterusan.

Syarikat dan portfolio projeknya: jutaan pelanggan; jualan bernilai berbilion setiap bulan.

Ailoot menggunakan pengalaman operasi ini untuk akses API kepada ciri AI dalam produk pelanggan, ejen, aplikasi dan automasi.