-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathlearning-path.html
More file actions
97 lines (89 loc) · 7.5 KB
/
Copy pathlearning-path.html
File metadata and controls
97 lines (89 loc) · 7.5 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
<!DOCTYPE html>
<html lang="zh-Hant">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link rel="icon" href="assets/favicon.svg" type="image/svg+xml">
<title>學習路線 · OpenCodeReview 繁中教學站</title>
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@400;600;700&family=Noto+Sans+TC:wght@400;500;700&family=JetBrains+Mono:wght@400;600&display=swap" rel="stylesheet">
<link rel="stylesheet" href="assets/site.css">
</head>
<body>
<div class="container">
<nav class="topnav">
<a href="index.html">首頁</a>
<a href="map.html">概念地圖</a>
<a href="learning-path.html">學習路線</a>
<a href="install.html">安裝指南</a>
<a href="docs/index.html">文件教學</a>
<a href="docs/code/index.html">程式碼對照</a>
<a href="docs/worked.html">實作案例</a>
<a href="about.html">關於</a>
</nav>
<div class="back-link"><a href="index.html">← 回首頁</a></div>
<header>
<h1>學習路線</h1>
<div class="subtitle">從「裝好」到「讀 Go 源碼」的五層路線</div>
</header>
<div class="guide">
<div class="level lv-emerald">
<div class="level-head"><span class="level-badge">L0</span><span class="level-title">裝好它</span><span class="level-sub">幾分鐘內讓 ocr 跑起來</span></div>
<div class="card-grid">
<a class="card" href="install.html"><span class="c-name">安裝</span><span class="c-zh">npm 一行安裝、Homebrew/MacPorts、curl 安裝腳本、GitHub Release 二進位、from source。</span></a>
<a class="card" href="docs/cli.html"><span class="c-name">命令一覽</span><span class="c-zh">知道 review/scan/rules/config/llm/session/viewer/version 各做什麼。</span></a>
</div>
</div>
<div class="level lv-cyan">
<div class="level-head"><span class="level-badge">L1</span><span class="level-title">跑起來</span><span class="level-sub">配置 LLM 並完成第一次評審</span></div>
<div class="card-grid">
<a class="card" href="docs/quickstart.html"><span class="c-name">快速開始</span><span class="c-zh">ocr config provider / model → ocr llm test → ocr review。</span></a>
<a class="card" href="docs/configuration.html"><span class="c-name">設定</span><span class="c-zh">18 個內建 provider、OCR_LLM_* 環境變數、超時、max_tokens、extra_body。</span></a>
<a class="card" href="docs/worked.html"><span class="c-name">實作案例</span><span class="c-zh">看真實 repo 掃描出的互動知識圖譜。</span></a>
</div>
</div>
<div class="level lv-amber">
<div class="level-head"><span class="level-badge">L2</span><span class="level-title">用規則與工具</span><span class="level-sub">理解過濾、規則鏈與 6 個工具</span></div>
<div class="card-grid">
<a class="card" href="docs/rules.html"><span class="c-name">評審規則</span><span class="c-zh">四層優先級鏈、rule.json 格式、五重門過濾、ocr rules check。</span></a>
<a class="card" href="docs/tools.html"><span class="c-name">6 個工具</span><span class="c-zh">task_done / code_comment / file_read / file_read_diff / file_find / code_search。</span></a>
<a class="card" href="docs/cli.html"><span class="c-name">CLI 進階</span><span class="c-zh">--preview、--audience agent、--format json、--resume、--background、--concurrency。</span></a>
</div>
</div>
<div class="level lv-fuchsia">
<div class="level-head"><span class="level-badge">L3</span><span class="level-title">讀原理</span><span class="level-sub">理解管線、壓縮與整合</span></div>
<div class="card-grid">
<a class="card" href="docs/how-it-works.html"><span class="c-name">運作原理</span><span class="c-zh">為什麼「確定性 × Agent」混合勝過純語言驅動的 skill。</span></a>
<a class="card" href="docs/architecture.html"><span class="c-name">架構總覽</span><span class="c-zh">diff provider → 過濾 → per-file 子任務（plan+main）→ 評論流水線 → 持久化。</span></a>
<a class="card" href="docs/integrations.html"><span class="c-name">整合</span><span class="c-zh">Agent Skill、Claude Code 外掛、OpenCode 工具、GitHub Actions / GitLab CI、MCP。</span></a>
<a class="card" href="docs/delegate.html"><span class="c-name">委託模式</span><span class="c-zh">宿主 Agent 提供 LLM、OCR 只做工程架構——不用自己設 API key。</span></a>
<a class="card" href="docs/benchmarks.html"><span class="c-name">Benchmark</span><span class="c-zh">50 repo / 200 PR / 10 語言，Precision 與 F1 高、token 約 1/9。</span></a>
<a class="card" href="docs/viewer.html"><span class="c-name">Session Viewer</span><span class="c-zh">五條泳道看每一輪 LLM 往返。</span></a>
<a class="card" href="docs/telemetry.html"><span class="c-name">遙測</span><span class="c-zh">OpenTelemetry span/metric/event，不導出 prompt 內容。</span></a>
</div>
</div>
<div class="level lv-violet">
<div class="level-head"><span class="level-badge">L4</span><span class="level-title">讀 Go 源碼</span><span class="level-sub">直接進 OCR 的逐函數講解</span></div>
<div class="card-grid">
<a class="card" href="docs/code/main.html"><span class="c-name">cmd/main.go</span><span class="c-zh">單一二進位入口、rootCmd 分派。</span></a>
<a class="card" href="docs/code/review-cmd.html"><span class="c-name">review_cmd.go</span><span class="c-zh">review 命令的參數解析與執行、工具 registry 組裝。</span></a>
<a class="card" href="docs/code/scan-cmd.html"><span class="c-name">scan_cmd.go</span><span class="c-zh">全檔掃描模式：不需 Git diff。</span></a>
<a class="card" href="docs/code/delegate-cmd.html"><span class="c-name">delegate_cmd.go</span><span class="c-zh">委託模式：preview + rule 子命令。</span></a>
<a class="card" href="docs/code/agent.html"><span class="c-name">internal/agent</span><span class="c-zh">Agent.Run、dispatchSubtasks、檔案過濾。</span></a>
<a class="card" href="docs/code/llmloop.html"><span class="c-name">internal/llmloop</span><span class="c-zh">per-file 迴圈、記憶三分區壓縮、工具執行。</span></a>
<a class="card" href="docs/code/diff.html"><span class="c-name">internal/diff</span><span class="c-zh">Git diff 解析、三種模式、行解析。</span></a>
<a class="card" href="docs/code/rules-engine.html"><span class="c-name">internal/config/rules</span><span class="c-zh">四層規則鏈、system_rules.json。</span></a>
<a class="card" href="docs/code/tool.html"><span class="c-name">internal/tool</span><span class="c-zh">6 個工具的定義、registry、provider。</span></a>
<a class="card" href="docs/code/index.html"><span class="c-name">全部程式碼對照</span><span class="c-zh">10 頁逐函數講解。</span></a>
</div>
</div>
<div class="callout"><strong>看完這條路線你應該能</strong>：獨立安裝並用 OCR 評審任何 repo、寫自己的 rule.json、解釋「確定性 × Agent」為何比通用 agent 更省 token 更精準、並能追著 review_cmd.go 看整個執行流程。</div>
</div>
<footer>
<div>這是 <a href="https://github.com/alibaba/open-code-review">alibaba/open-code-review</a> 的非官方繁體中文教學站。</div>
<div>內容 © <a href="https://github.com/alibaba/open-code-review">alibaba/open-code-review Contributors</a>（Apache-2.0）· 本站與 Alibaba 無關 · 對齊上游 main @ 9148bfd</div>
</footer>
</div>
</body>
</html>