From 49b508b09748dea7e860e8fdc6aabd19d8e069a5 Mon Sep 17 00:00:00 2001 From: dongyikuan919 <18511460392@163.com> Date: Wed, 12 Aug 2026 17:26:55 +0800 Subject: [PATCH] docs(cli): document review no-filter option --- pages/src/content/docs/en/cli-reference.md | 1 + pages/src/content/docs/ja/cli-reference.md | 1 + pages/src/content/docs/ru/cli-reference.md | 1 + pages/src/content/docs/zh/cli-reference.md | 1 + pages/src/i18n/en.ts | 2 ++ pages/src/i18n/ja.ts | 2 ++ pages/src/i18n/ru.ts | 2 ++ pages/src/i18n/zh.ts | 2 ++ 8 files changed, 12 insertions(+) diff --git a/pages/src/content/docs/en/cli-reference.md b/pages/src/content/docs/en/cli-reference.md index 5f587c68..6184b6d0 100644 --- a/pages/src/content/docs/en/cli-reference.md +++ b/pages/src/content/docs/en/cli-reference.md @@ -90,6 +90,7 @@ staged + unstaged + untracked changes in the current directory's repo. | `--to ` | — | — | Target ref to end the diff at (e.g., `feature-branch`). When set, OCR computes `merge-base(from, to)..to`. | | `--commit ` | `-c` | — | Single commit to review (vs its parent). | | `--preview` | `-p` | `false` | Run the filter pipeline but skip the LLM. Prints the file list and exclusion reasons. Honors `--format json`; `--format sarif` is not supported (a preview has no completed findings to emit). | +| `--no-filter` | — | `false` | Keep all review comments and skip the per-file `REVIEW_FILTER_TASK` LLM post-processing call. | | `--resume ` | — | — | Resume from a previous compatible range or commit review session. | | `--format ` | `-f` | `text` | `text` (human-readable), `json` (machine-readable comment array), or `sarif` (SARIF 2.1.0 report for GitHub Code Scanning). | | `--audience ` | — | `human` | `human` streams progress lines; `agent` quiets stdout and prints only the final summary / JSON. | diff --git a/pages/src/content/docs/ja/cli-reference.md b/pages/src/content/docs/ja/cli-reference.md index 47a13a12..cd24cc9b 100644 --- a/pages/src/content/docs/ja/cli-reference.md +++ b/pages/src/content/docs/ja/cli-reference.md @@ -86,6 +86,7 @@ ocr r [flags] (alias) | `--to ` | — | — | diff の終了 ref（例: `feature-branch`）。設定すると OCR は `merge-base(from, to)..to` を計算します。 | | `--commit ` | `-c` | — | 単一の commit をレビューします（その親との差分）。 | | `--preview` | `-p` | `false` | フィルタリングのパイプラインを実行しますが LLM はスキップします。ファイル一覧と除外理由を出力します。`--format json` に対応しています。`--format sarif` はサポートされていません（プレビューには出力する完了した指摘がありません）。 | +| `--no-filter` | — | `false` | すべてのレビューコメントを保持し、ファイルごとの `REVIEW_FILTER_TASK` LLM 後処理呼び出しをスキップします。 | | `--resume ` | — | — | 以前の互換性のある範囲または単一 commit レビューセッションから再開します。 | | `--format ` | `-f` | `text` | `text`（人間が読みやすい形式）、`json`（機械可読なコメント配列）または `sarif`（GitHub Code Scanning 用の SARIF 2.1.0 レポート）。 | | `--audience ` | — | `human` | `human` は進捗行をストリーム出力します。`agent` は stdout を静音化し、最終サマリー / JSON のみを出力します。 | diff --git a/pages/src/content/docs/ru/cli-reference.md b/pages/src/content/docs/ru/cli-reference.md index af95256a..3a2d847c 100644 --- a/pages/src/content/docs/ru/cli-reference.md +++ b/pages/src/content/docs/ru/cli-reference.md @@ -90,6 +90,7 @@ ocr r [flags] (alias) | `--to ` | — | — | Целевая ссылка, на которой заканчивается diff (например, `feature-branch`). Если задана, OCR вычисляет `merge-base(from, to)..to`. | | `--commit ` | `-c` | — | Один коммит для ревью (сравнивается с родительским). | | `--preview` | `-p` | `false` | Запускает конвейер фильтрации, но пропускает LLM. Выводит список файлов и причины исключения. Учитывает `--format json`; `--format sarif` не поддерживается (в предпросмотре нет завершённых находок для вывода). | +| `--no-filter` | — | `false` | Сохраняет все комментарии ревью и пропускает вызов LLM постобработки `REVIEW_FILTER_TASK` для каждого файла. | | `--resume ` | — | — | Возобновляет предыдущую совместимую сессию ревью диапазона или коммита. | | `--format ` | `-f` | `text` | `text` (для чтения человеком), `json` (машиночитаемый массив комментариев) или `sarif` (отчёт SARIF 2.1.0 для GitHub Code Scanning). | | `--audience ` | — | `human` | `human` выводит ход выполнения; `agent` отключает этот вывод в stdout и печатает только итоговую сводку / JSON. | diff --git a/pages/src/content/docs/zh/cli-reference.md b/pages/src/content/docs/zh/cli-reference.md index 7f6bc3ff..5cd1542e 100644 --- a/pages/src/content/docs/zh/cli-reference.md +++ b/pages/src/content/docs/zh/cli-reference.md @@ -87,6 +87,7 @@ unstaged + untracked 变更。 | `--to ` | — | — | diff 结束 ref（如 `feature-branch`）。设置后 OCR 计算 `merge-base(from, to)..to`。 | | `--commit ` | `-c` | — | 评审单个 commit（相对其父）。 | | `--preview` | `-p` | `false` | 运行过滤流水线但跳过 LLM。打印文件列表与排除原因。支持 `--format json`；不支持 `--format sarif`（预览没有已完成的发现可供输出）。 | +| `--no-filter` | — | `false` | 保留所有评审评论，并跳过每个文件的 `REVIEW_FILTER_TASK` LLM 后处理调用。 | | `--resume ` | — | — | 从之前兼容的区间或单 commit 评审会话恢复。 | | `--format ` | `-f` | `text` | `text`（人类可读）、`json`（机器可读的评论数组）或 `sarif`（用于 GitHub Code Scanning 的 SARIF 2.1.0 报告）。 | | `--audience ` | — | `human` | `human` 流式输出进度行；`agent` 静默 stdout，只打印最终摘要 / JSON。 | diff --git a/pages/src/i18n/en.ts b/pages/src/i18n/en.ts index 16386080..07023f10 100644 --- a/pages/src/i18n/en.ts +++ b/pages/src/i18n/en.ts @@ -166,6 +166,8 @@ export const en = { 'docs.reviewAgentDesc': 'Output only the final summary without execution process, suitable for automation pipelines.', 'docs.reviewPreviewLabel': 'Dry-Run Preview', 'docs.reviewPreviewDesc': 'Lists the files that would be reviewed along with stats (file count, changed lines) — no LLM calls, no cost. Useful for checking scope before a full review.', + 'docs.reviewToggles': 'Review Stage Toggle: --no-filter', + 'docs.reviewTogglesFilterDesc': 'Keeps all review comments and skips the per-file REVIEW_FILTER_TASK LLM post-processing call.', 'docs.reviewFlags': 'Flag Reference', 'docs.reviewFlagCol1': 'Flag', 'docs.reviewFlagCol2': 'Description', diff --git a/pages/src/i18n/ja.ts b/pages/src/i18n/ja.ts index 56aa919e..0b75c705 100644 --- a/pages/src/i18n/ja.ts +++ b/pages/src/i18n/ja.ts @@ -170,6 +170,8 @@ export const ja: TranslationKeys = { 'docs.reviewAgentDesc': '実行プロセスを表示せず最終サマリーのみ出力。自動化パイプラインに適しています。', 'docs.reviewPreviewLabel': 'Dry-Run プレビュー', 'docs.reviewPreviewDesc': 'レビュー対象のファイル一覧と統計情報（ファイル数、変更行数）を表示します。LLM 呼び出しなし、コストなし —— 本番レビュー前にスコープを確認するのに役立ちます。', + 'docs.reviewToggles': 'レビューステージの切り替え：--no-filter', + 'docs.reviewTogglesFilterDesc': 'すべてのレビューコメントを保持し、ファイルごとの REVIEW_FILTER_TASK LLM 後処理呼び出しをスキップします。', 'docs.reviewFlags': 'フラグリファレンス', 'docs.reviewFlagCol1': 'フラグ', 'docs.reviewFlagCol2': '説明', diff --git a/pages/src/i18n/ru.ts b/pages/src/i18n/ru.ts index ba1e4f80..d25d153e 100644 --- a/pages/src/i18n/ru.ts +++ b/pages/src/i18n/ru.ts @@ -168,6 +168,8 @@ export const ru: TranslationKeys = { 'docs.reviewAgentDesc': 'Показывает только итоговую сводку без хода выполнения. Такой режим удобен для автоматизации.', 'docs.reviewPreviewLabel': 'Предпросмотр без выполнения', 'docs.reviewPreviewDesc': 'Показывает файлы, которые попадут в ревью, их количество и число изменённых строк. LLM не вызывается, токены не расходуются.', + 'docs.reviewToggles': 'Переключатель этапа ревью: --no-filter', + 'docs.reviewTogglesFilterDesc': 'Сохраняет все комментарии ревью и пропускает вызов LLM постобработки REVIEW_FILTER_TASK для каждого файла.', 'docs.reviewFlags': 'Справочник флагов', 'docs.reviewFlagCol1': 'Флаг', 'docs.reviewFlagCol2': 'Описание', diff --git a/pages/src/i18n/zh.ts b/pages/src/i18n/zh.ts index afabd473..b46c4be5 100644 --- a/pages/src/i18n/zh.ts +++ b/pages/src/i18n/zh.ts @@ -170,6 +170,8 @@ export const zh: TranslationKeys = { 'docs.reviewAgentDesc': '仅输出最终摘要，不显示执行过程，适用于自动化流水线。', 'docs.reviewPreviewLabel': 'Dry-Run 预览', 'docs.reviewPreviewDesc': '列出将被审查的文件及统计信息（文件总数、变更行数），但不调用 LLM，不产生费用 —— 适合在正式审查前确认范围。', + 'docs.reviewToggles': '审查阶段开关：--no-filter', + 'docs.reviewTogglesFilterDesc': '保留所有评审评论，并跳过每个文件的 REVIEW_FILTER_TASK LLM 后处理调用。', 'docs.reviewFlags': '参数参考', 'docs.reviewFlagCol1': '参数', 'docs.reviewFlagCol2': '描述',