open-code-review: OpenCodeReview – 為任何 Git 儲存庫提供 AI 驅動、行級精準的程式碼審查

open-code-review: OpenCodeReview – 為任何 Git 儲存庫提供 AI 驅動、行級精準的程式碼審查

OpenCodeReview – AI 驅動的程式碼審查 CLI

產品定義 – 一款命令列工具，讓您可以在任何 Git 儲存庫上執行由 LLM 驅動的程式碼審查。它會讀取 diff（或整個檔案），將相關片段傳送至可配置的大語言模型，並回傳結構化的行級評論。該專案源自阿里巴巴內部的程式碼審查助手，現在已開源。

核心能力

  • 感知 Diff 的審查 – 解析 git diff 輸出，精確選取變更的檔案，打包相關檔案並提供給模型。
  • 全檔案掃描 (ocr scan) – 在沒有 Git 歷史紀錄的情況下，可以審核整個程式碼庫。
  • 確定性工程層 – 透過硬編碼的檔案選取、打包、規則匹配和評論定位，確保審查結果穩定且精準。
  • Agent 層 – 使用經過微調的提示詞（prompt）和小型專用工具集，讓 LLM 可以獲取額外上下文（完整檔案內容、搜尋儲存庫）並產生更深入的反饋。
  • 多模型支援 – 內建 Anthropic、OpenAI 等供應商；您也可以透過簡單的 JSON 設定或環境變數添加自定義端點。
  • 整合鉤子 – 作為 Claude Code、Codex、Cursor 和通用 AI 編碼代理的技能/外掛提供，並提供如 /open-code-review:review 之類的斜線指令。

安裝方式

  • NPM (推薦): npm install -g @alibaba-group/open-code-review → 提供 ocr 指令。
  • 二進位發行版: macOS/Linux 使用單行指令 curl …/install.sh | sh 或 Windows PowerShell irm …/install.ps1 | iex。內建 SHA-256 驗證。
  • 從原始碼安裝: git clone … && make build && sudo cp dist/opencodereview /usr/local/bin/ocr。

首次設定

  1. 執行 ocr config provider（互動式）或 ocr config set …（對 CI 友善）來選擇供應商、提供 API key 並選擇模型。
  2. 使用 ocr llm test 測試連線。
  3. 在 Git 儲存庫中，只需執行 ocr review 即可審查所有已暫存/未暫存的變改動，或使用 --from main --to feature 或 --commit <sha> 等參數來指定特定範圍。
  4. 若要進行全儲存庫審核，請使用 ocr scan（可選擇性使用 --path <dir>）。

典型工作流程

# 設定一次即可
ocr config provider            # 選擇 Anthropic, OpenAI 等
ocr config model               # 選擇 claude-sonnet-4-6, gpt-4o, …
ocr llm test                   # 驗證連線性

# 在本地審查一個 PR
cd my-project
ocr review                     # diff 模式審查

# CI 整合
ocr config set provider openai
ocr config set providers.openai.api_key $OPENAI_API_KEY
ocr review --from $BASE --to $HEAD --no-interactive

重要性所在 – 與通用代理（例如 Claude Code）相比，OpenCodeReview 實現了更高的精準度，且消耗的 token 數量大幅減少（約為 1/9），這使得它在 CI 流水線中更便宜且雜訊更少。確定性的預處理保證了每個變更的檔案都會被檢查，且評論會落在正確的行號上。

進一步了解 – 官方網站 https://open-codereview.ai、儲存庫中的基準測試圖表，以及多語言 README（英文、中文、日文、韓文、俄文）。

Sources