@alibaba-group/open-code-review 1.8.0 → 1.8.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. package/LICENSE +1 -1
  2. package/README.ja-JP.md +1 -1
  3. package/README.ru-RU.md +9 -9
  4. package/imgs/benchmark-ru.png +0 -0
  5. package/imgs/highlights-ru.png +0 -0
  6. package/package.json +7 -7
package/LICENSE CHANGED
@@ -186,7 +186,7 @@
186
186
  "printed page" as the copyright notice for easier identification within
187
187
  third-party archives.
188
188
 
189
- Copyright 2026 Alibaba
189
+ Copyright 2026 alibaba/open-code-review Contributors
190
190
 
191
191
  Licensed under the Apache License, Version 2.0 (the "License");
192
192
  you may not use this file except in compliance with the License.
package/README.ja-JP.md CHANGED
@@ -181,7 +181,7 @@ ocr delegate rule src/main.go src/handler.go
181
181
 
182
182
  ## コントリビューション
183
183
 
184
- このプロジェクトは、貢献してくださるすべての方々のおかげで成り立っています。開発環境のセットアップ、コーディングガイドライン、プルリクエストの提出方法については[CONTRIBUTING.md](CONTRIBUTING.md)を参照してください。
184
+ このプロジェクトは、貢献してくださるすべての方々のおかげで成り立っています。開発環境のセットアップ、コーディングガイドライン、プルリクエストの提出方法については[CONTRIBUTING.ja-JP.md](CONTRIBUTING.ja-JP.md)を参照してください。
185
185
 
186
186
  <a href="https://github.com/alibaba/open-code-review/graphs/contributors">
187
187
  <img src="https://contrib.rocks/image?repo=alibaba/open-code-review" />
package/README.ru-RU.md CHANGED
@@ -42,13 +42,13 @@ Open Code Review — это CLI-инструмент для код-ревью н
42
42
 
43
43
  Подробнее на [официальном сайте](https://open-codereview.ai).
44
44
 
45
- ![Highlights](imgs/highlights-en.png)
45
+ ![Highlights](imgs/highlights-ru.png)
46
46
 
47
47
  ## Бенчмарк
48
48
 
49
49
  > По сравнению с агентами общего назначения (Claude Code), Open Code Review при той же базовой модели достигает значительно более высоких показателей **Precision** и **F1**, потребляя лишь **~1/9 токенов** и выполняя ревью быстрее. При этом показатель Recall ниже, чем у агентов общего назначения — это осознанный компромисс в пользу точности и минимального шума.
50
50
 
51
- Бенчмарк на основе реальных код-ревью: **50** популярных open-source-репозиториев, **200** реальных Pull Request, **10** языков программирования — перекрёстная валидация 80+ старшими инженерами (**1 505** размеченных дефектов).
51
+ Бенчмарк собран на основе реальных код-ревью и включает **50** популярных open-source-репозиториев, **200** реальных пул-реквестов и **10** языков программирования. Разметку из **1 505** дефектов перекрёстно проверили более 80 ведущих инженеров.
52
52
 
53
53
  | Метрика | Что измеряет | Почему важна |
54
54
  |---------|-------------|--------------|
@@ -58,13 +58,13 @@ Open Code Review — это CLI-инструмент для код-ревью н
58
58
  | **Avg Time** | Время выполнения одного ревью | Влияет на задержки в CI-пайплайне |
59
59
  | **Avg Token** | Суммарное потребление токенов за ревью | Прямо влияет на стоимость API |
60
60
 
61
- ![Benchmark](imgs/benchmark-en.png)
61
+ ![Benchmark](imgs/benchmark-ru.png)
62
62
 
63
63
  ## Почему Open Code Review?
64
64
 
65
65
  ### Проблема агентов общего назначения
66
66
 
67
- Если вы использовали для код-ревью агентов общего назначения, например Claude Code со Skills, вы наверняка сталкивались с этими болевыми точками:
67
+ Если вы использовали для код-ревью агентов общего назначения, например Claude Code со Skills, вы наверняка сталкивались с такими проблемами:
68
68
 
69
69
  - **Неполное покрытие** — на крупных ченджсетах агенты склонны «срезать углы»: выборочно проверяют часть файлов и пропускают остальные.
70
70
  - **Дрейф позиций** — найденные проблемы часто не совпадают с реальным местом в коде: номера строк и ссылки на файлы «уезжают» от цели.
@@ -81,8 +81,8 @@ Open Code Review — это CLI-инструмент для код-ревью н
81
81
  Для тех шагов ревью, где *нельзя ошибаться*, корректность гарантирует инженерная логика, а не языковая модель:
82
82
 
83
83
  - **Точный отбор файлов** — точно определяет, какие файлы нуждаются в ревью, а какие следует отфильтровать, гарантируя, что ни одно важное изменение не будет упущено.
84
- - **Умный бандлинг файлов** — группирует связанные файлы в одну единицу ревью (например, `message_en.properties` и `message_zh.properties` объединяются вместе). Каждый бандл выполняется как суб-агент с изолированным контекстом — стратегия «разделяй и властвуй», которая сохраняет стабильность на очень больших ченджсетах и естественным образом поддерживает конкурентное ревью.
85
- - **Тонкий матчинг правил** — сопоставляет правила ревью с характеристиками каждого файла, удерживая внимание модели сфокусированным и устраняя информационный шум у самого источника. По сравнению с чисто языковым управлением правилами матчинг правил на основе шаблонизатора стабильнее и предсказуемее.
84
+ - **Группировка связанных файлов** — объединяет связанные файлы в одну единицу ревью (например, `message_en.properties` и `message_zh.properties`). Каждая группа обрабатывается отдельным субагентом в изолированном контексте. Подход «разделяй и властвуй» сохраняет стабильность при очень больших изменениях и позволяет выполнять ревью параллельно.
85
+ - **Точное сопоставление правил** — подбирает правила ревью с учётом особенностей каждого файла, удерживая внимание модели на задаче и устраняя лишний информационный шум. Сопоставление по шаблонам работает стабильнее и предсказуемее, чем управление правилами только на естественном языке.
86
86
  - **Внешние модули позиционирования и рефлексии** — независимые модули позиционирования комментариев и рефлексии над комментариями системно повышают точность как расположения, так и содержания замечаний ИИ.
87
87
 
88
88
  **Агент — динамические решения**
@@ -90,7 +90,7 @@ Open Code Review — это CLI-инструмент для код-ревью н
90
90
  Сильные стороны агента сосредоточены там, где они важнее всего, — в динамических решениях и динамическом доборе контекста:
91
91
 
92
92
  - **Промпты, заточенные под сценарий** — шаблоны промптов, глубоко оптимизированные под код-ревью: выше качество при меньшем расходе токенов.
93
- - **Набор инструментов, заточенный под сценарий** — выведен из глубокого анализа трейсов вызовов инструментов на больших продакшен-данных, включая распределение частоты вызовов, долю повторных вызовов каждого инструмента и влияние новых инструментов на всю цепочку вызовов. В результате получился специализированный набор инструментов, который для код-ревью стабильнее и предсказуемее, чем универсальный агентский тулкит.
93
+ - **Специализированный набор инструментов** — создан на основе анализа вызовов инструментов в реальных проектах: частоты вызовов, доли повторных обращений к каждому инструменту и влияния новых инструментов на всю цепочку. Такой набор работает при код-ревью стабильнее и предсказуемее, чем универсальные инструменты агента.
94
94
 
95
95
  ## Как использовать
96
96
 
@@ -149,7 +149,7 @@ ocr review --from main --to feature-branch --resume <session-id>
149
149
  ocr scan # сканировать весь репозиторий
150
150
  ocr scan --path internal/agent # сканировать каталог или конкретные файлы
151
151
 
152
- # Режим делегирования — AI-агент сам выполняет ревью
152
+ # Режим делегирования — ИИ-агент сам выполняет ревью
153
153
  # OCR отвечает за выбор файлов и разрешение правил; настройка LLM не требуется
154
154
  ocr delegate preview
155
155
  ocr delegate rule src/main.go src/handler.go
@@ -181,7 +181,7 @@ ocr delegate rule src/main.go src/handler.go
181
181
 
182
182
  ## Участие в разработке
183
183
 
184
- Этот проект существует благодаря всем, кто вносит свой вклад. В [CONTRIBUTING.ru-RU.md](CONTRIBUTING.ru-RU.md) описаны настройка окружения разработки, рекомендации по коду и порядок отправки pull request'ов.
184
+ Этот проект существует благодаря всем, кто вносит свой вклад. В [CONTRIBUTING.ru-RU.md](CONTRIBUTING.ru-RU.md) описаны настройка окружения разработки, рекомендации по коду и порядок отправки пул-реквестов.
185
185
 
186
186
  <a href="https://github.com/alibaba/open-code-review/graphs/contributors">
187
187
  <img src="https://contrib.rocks/image?repo=alibaba/open-code-review" />
package/imgs/benchmark-ru.png ADDED
Binary file
package/imgs/highlights-ru.png ADDED
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@alibaba-group/open-code-review",
3
- "version": "1.8.0",
3
+ "version": "1.8.2",
4
4
  "description": "OpenCodeReview CLI — AI-powered code review tool",
5
5
  "bin": {
6
6
  "ocr": "bin/ocr.js"
@@ -28,12 +28,12 @@
28
28
  "checksumPattern": "https://github.com/alibaba/open-code-review/releases/download/v{version}/sha256sum.txt"
29
29
  },
30
30
  "optionalDependencies": {
31
- "@alibaba-group/ocr-darwin-arm64": "1.8.0",
32
- "@alibaba-group/ocr-darwin-x64": "1.8.0",
33
- "@alibaba-group/ocr-linux-arm64": "1.8.0",
34
- "@alibaba-group/ocr-linux-x64": "1.8.0",
35
- "@alibaba-group/ocr-win32-arm64": "1.8.0",
36
- "@alibaba-group/ocr-win32-x64": "1.8.0"
31
+ "@alibaba-group/ocr-darwin-arm64": "1.8.2",
32
+ "@alibaba-group/ocr-darwin-x64": "1.8.2",
33
+ "@alibaba-group/ocr-linux-arm64": "1.8.2",
34
+ "@alibaba-group/ocr-linux-x64": "1.8.2",
35
+ "@alibaba-group/ocr-win32-arm64": "1.8.2",
36
+ "@alibaba-group/ocr-win32-x64": "1.8.2"
37
37
  },
38
38
  "engines": {
39
39
  "node": ">=14"