OpenCodeReview
Dùng aicentos trong OpenCodeReview (OCR) —— kết nối review code qua provider tùy chỉnh
Cập nhật lần cuối:
OpenCodeReview (tên lệnh ocr) là CLI review code AI mã nguồn mở của Alibaba: đọc Git diff rồi gọi mô hình lớn đưa ra ý kiến review. Nó tích hợp sẵn provider OpenAI tương thích, cũng hỗ trợ gateway OpenAI tương thích tùy chỉnh, có thể chuyển yêu cầu sang aicentos.
Chuẩn bị
Tạo một Key chuyên dụng trong Console của aicentos (khuyến nghị đặt tên ocr-ci để dễ theo dõi mức sử dụng). OCR chỉ hỗ trợ hai giao thức OpenAI / Anthropic, ở đây đi đường Chat Completions của OpenAI. Review code phụ thuộc vào khả năng function calling của mô hình, hãy chọn mô hình hỗ trợ gọi công cụ.
Cấu hình cần điền
| Trường | Giá trị |
|---|---|
| provider | openai (tích hợp sẵn, ghi đè URL của nó) hoặc provider tùy chỉnh |
| protocol | openai (Chat Completions) |
| URL | https://aicentos.com/v1 |
| API Key | Key tạo trong Console |
| Mô hình | tên mô hình trong "Model Square" của Console, cần hỗ trợ function calling |
Các bước thiết lập
-
Cài CLI (cần Node.js, hoặc dùng Homebrew trên macOS):
npm install -g open-code-review -
Dùng lệnh phi tương tác để ghi cấu hình, cuối cùng nằm ở
~/.opencodereview/config.json:ocr config set provider openai ocr config set model claude-sonnet-5 ocr config set providers.openai.url https://aicentos.com/v1 ocr config set providers.openai.api_key your_api_key_here -
Nếu thích hướng dẫn đồ hoạ, chạy trực tiếp
ocr config providervàocr config model, trong TUI chọn provider, điền Key, chọn mô hình, đi xong sẽ tự chạy một lần kiểm tra kết nối.
Kiểm tra
Trước tiên xác minh riêng endpoint:
ocr llm testThông qua rồi, thực hiện một lần review thực tế trong bất kỳ Git repo nào:
ocr reviewLưu ý
- URL chỉ điền đến
/v1, đừng bổ sung thành/chat/completionsđầy đủ. - Bộ phân giải cấu hình cần đủ URL, Key, mô hình ba thứ; chỉ
exportbiến môi trường là chưa đủ, phần thiếu vẫn phải ghi vào config.json, nếu không sẽ trả về 401. - Cũng có thể dùng biến môi trường ghi đè tạm thời, độ ưu tiên cao nhất:
OCR_LLM_URL/OCR_LLM_TOKEN/OCR_LLM_MODEL. - Trường của provider tích hợp sẵn là
providers.<name>.url, provider tùy chỉnh ởcustom_providers.<name>.url, đừng viết lẫn hai map này. - Khi không đủ số dư tài khoản sẽ biểu hiện là 401 / 403, trước tiên vào trang Ví xác nhận số dư.
- Repo chính thức:
https://github.com/alibaba/open-code-review