學習路線

從「裝好」到「讀 Go 源碼」的五層路線

L0裝好它幾分鐘內讓 ocr 跑起來

安裝npm 一行安裝、Homebrew/MacPorts、curl 安裝腳本、GitHub Release 二進位、from source。命令一覽知道 review/scan/rules/config/llm/session/viewer/version 各做什麼。

L1跑起來配置 LLM 並完成第一次評審

快速開始ocr config provider / model → ocr llm test → ocr review。設定18 個內建 provider、OCR_LLM_* 環境變數、超時、max_tokens、extra_body。實作案例看真實 repo 掃描出的互動知識圖譜。

L2用規則與工具理解過濾、規則鏈與 6 個工具

評審規則四層優先級鏈、rule.json 格式、五重門過濾、ocr rules check。 6 個工具task_done / code_comment / file_read / file_read_diff / file_find / code_search。 CLI 進階--preview、--audience agent、--format json、--resume、--background、--concurrency。

L3讀原理理解管線、壓縮與整合

運作原理為什麼「確定性 × Agent」混合勝過純語言驅動的 skill。架構總覽diff provider → 過濾 → per-file 子任務（plan+main）→ 評論流水線 → 持久化。整合Agent Skill、Claude Code 外掛、OpenCode 工具、GitHub Actions / GitLab CI、MCP。委託模式宿主 Agent 提供 LLM、OCR 只做工程架構——不用自己設 API key。 Benchmark50 repo / 200 PR / 10 語言，Precision 與 F1 高、token 約 1/9。 Session Viewer五條泳道看每一輪 LLM 往返。遙測OpenTelemetry span/metric/event，不導出 prompt 內容。

L4讀 Go 源碼直接進 OCR 的逐函數講解

cmd/main.go單一二進位入口、rootCmd 分派。 review_cmd.goreview 命令的參數解析與執行、工具 registry 組裝。 scan_cmd.go全檔掃描模式：不需 Git diff。 delegate_cmd.go委託模式：preview + rule 子命令。 internal/agentAgent.Run、dispatchSubtasks、檔案過濾。 internal/llmloopper-file 迴圈、記憶三分區壓縮、工具執行。 internal/diffGit diff 解析、三種模式、行解析。 internal/config/rules四層規則鏈、system_rules.json。 internal/tool6 個工具的定義、registry、provider。全部程式碼對照10 頁逐函數講解。

看完這條路線你應該能：獨立安裝並用 OCR 評審任何 repo、寫自己的 rule.json、解釋「確定性 × Agent」為何比通用 agent 更省 token 更精準、並能追著 review_cmd.go 看整個執行流程。