如何选对 open-code-review 的 --format 与 --audience输出形式完全指南【免费下载链接】open-code-reviewFast, efficient, battle-tested at Alibabas scale. Hybrid architecture code review tool: deterministic pipelines LLM Agent, precise line-level comments, built-in multi-language ruleset (NPE, thread-safety, XSS, SQL injection), OpenAI Anthropic compatible.项目地址: https://gitcode.com/GitHub_Trending/op/open-code-reviewopen-code-reviewocr是阿里巴巴开源的 AI 代码评审工具混合架构确定性流水线 LLM Agent在阿里规模下经过实战检验。跑一次ocr review之后评审结果以什么形式输出直接决定了它是给人看的、还是给脚本和 CI 流水线消费的。本文用最短的路径讲清两个关键参数——--format和--audience的作用、区别与组合方式帮你一次选对输出形式。 完整参数说明可查阅官方中文文档cli-reference.md一张表看懂--format 与 --audience 各管什么参数可选值默认控制什么--format-ftext/json/sariftext输出内容的结构人类可读文本、机器可解析 JSON或 SARIF 2.1.0 报告--audiencehuman/agenthuman进度行的开关human实时打印[ocr]进度agent完全静默只出最终结果一个最易踩的坑先说在前面--audience agent并不隐含--format json。两者控制的是不同的事——前者管屏蔽 UI后者管结构化载荷。需要 JSON 时请显式加上--format json。三种 --format 输出形式详解1. text人类可读默认默认形式。评审运行时流式打印进度行文件读取、code_search、Plan 完成等随后每条评论一个分块ocr review --commit abc123─── src/foo.go:42-47 ─── Concurrent map access without a lock — wrap with sync.RWMutex. - m[k] v mu.Lock(); defer mu.Unlock(); m[k] v结尾附一份摘要评审文件数、评论数、token 用量与耗时。适合自己在终端里跑评审。2. json机器可读ocr review --format json result.json # 进度仍显示在终端上 ocr review --format json | jq .summary # stdout 是单个 JSON 文档JSON 文档始终独占 stdout顶层字段包括status、llm、summary、comments含path、start_line、end_line、suggestion_code、可选的warnings与session_id可用于--resume恢复中断的评审。这是写脚本、做自动化、接入其他工具时的首选形式。3. sarif接入平台代码扫描ocr review --format sarif report.sarif输出 SARIF 2.1.0 报告专为 GitHub Code Scanning 等平台代码扫描入口设计。注意两点--preview与--format sarif不能同时使用预览没有已完成的发现可供输出delegate 模式仅支持text与json。实现见 sarif.go。两种 --audiencehuman 还是 agenthuman默认流式打印进度行。当--format为json或sarif时进度行会自动改道 stderr保证 stdout 是一份干净的、可被解析器直接消费的结构化文档——这解决了边看进度边管道解析的经典冲突。agent完全抑制所有进度行只输出最终摘要 / 结果文档。适合 CI / 流水线中把结果交给另一个 agent 消费的场景。底层逻辑非常清晰--audience agent时进度直接丢弃human 结构化格式时进度重定向到 stderr。参见 shared.go 中的newQuietHandle实现。快速决策清单怎么选场景推荐组合本地终端自己看--format text默认即可想看进度 结果给脚本解析--format json默认human进度自动走 stderrCI / 流水线静默执行--format json --audience agent接入代码扫描平台--format sarif把结果写入文件加--output result.json文本格式会自动剥离 ANSI 颜色码几个实用提示 退出码0表示评审完成可能零评论、可能带警告1表示致命错误参数错误、端点无法解析等错误文本打印到 stderr——CI 里直接用它判断成败。区分无变更与无发现没有可评审文件时JSON 模式会输出status: skipped的空外壳调用方据此区分两种情况。重试报告想看每次尝试的细节用--format jsonretry_report字段。delegate 模式--format只接受text或json不支持sarif。传了非法值会直接报错并提示合法取值如invalid --audience value robot: must be human or agent。相关源码与文档参数定义与校验shared_flags.go进度静默/重定向机制shared.goSARIF 生成sarif.go结果渲染与重试报告output.go完整 CLI 参考中文cli-reference.md一句话总结--format决定输出长什么样--audience决定过程显不显示。本地看结果用默认组合脚本消费加--format json流水线静默再加--audience agent接代码扫描用--format sarif。【免费下载链接】open-code-reviewFast, efficient, battle-tested at Alibabas scale. Hybrid architecture code review tool: deterministic pipelines LLM Agent, precise line-level comments, built-in multi-language ruleset (NPE, thread-safety, XSS, SQL injection), OpenAI Anthropic compatible.项目地址: https://gitcode.com/GitHub_Trending/op/open-code-review创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
如何选对 open-code-review 的 --format 与 --audience：输出形式完全指南
如何选对 open-code-review 的 --format 与 --audience输出形式完全指南【免费下载链接】open-code-reviewFast, efficient, battle-tested at Alibabas scale. Hybrid architecture code review tool: deterministic pipelines LLM Agent, precise line-level comments, built-in multi-language ruleset (NPE, thread-safety, XSS, SQL injection), OpenAI Anthropic compatible.项目地址: https://gitcode.com/GitHub_Trending/op/open-code-reviewopen-code-reviewocr是阿里巴巴开源的 AI 代码评审工具混合架构确定性流水线 LLM Agent在阿里规模下经过实战检验。跑一次ocr review之后评审结果以什么形式输出直接决定了它是给人看的、还是给脚本和 CI 流水线消费的。本文用最短的路径讲清两个关键参数——--format和--audience的作用、区别与组合方式帮你一次选对输出形式。 完整参数说明可查阅官方中文文档cli-reference.md一张表看懂--format 与 --audience 各管什么参数可选值默认控制什么--format-ftext/json/sariftext输出内容的结构人类可读文本、机器可解析 JSON或 SARIF 2.1.0 报告--audiencehuman/agenthuman进度行的开关human实时打印[ocr]进度agent完全静默只出最终结果一个最易踩的坑先说在前面--audience agent并不隐含--format json。两者控制的是不同的事——前者管屏蔽 UI后者管结构化载荷。需要 JSON 时请显式加上--format json。三种 --format 输出形式详解1. text人类可读默认默认形式。评审运行时流式打印进度行文件读取、code_search、Plan 完成等随后每条评论一个分块ocr review --commit abc123─── src/foo.go:42-47 ─── Concurrent map access without a lock — wrap with sync.RWMutex. - m[k] v mu.Lock(); defer mu.Unlock(); m[k] v结尾附一份摘要评审文件数、评论数、token 用量与耗时。适合自己在终端里跑评审。2. json机器可读ocr review --format json result.json # 进度仍显示在终端上 ocr review --format json | jq .summary # stdout 是单个 JSON 文档JSON 文档始终独占 stdout顶层字段包括status、llm、summary、comments含path、start_line、end_line、suggestion_code、可选的warnings与session_id可用于--resume恢复中断的评审。这是写脚本、做自动化、接入其他工具时的首选形式。3. sarif接入平台代码扫描ocr review --format sarif report.sarif输出 SARIF 2.1.0 报告专为 GitHub Code Scanning 等平台代码扫描入口设计。注意两点--preview与--format sarif不能同时使用预览没有已完成的发现可供输出delegate 模式仅支持text与json。实现见 sarif.go。两种 --audiencehuman 还是 agenthuman默认流式打印进度行。当--format为json或sarif时进度行会自动改道 stderr保证 stdout 是一份干净的、可被解析器直接消费的结构化文档——这解决了边看进度边管道解析的经典冲突。agent完全抑制所有进度行只输出最终摘要 / 结果文档。适合 CI / 流水线中把结果交给另一个 agent 消费的场景。底层逻辑非常清晰--audience agent时进度直接丢弃human 结构化格式时进度重定向到 stderr。参见 shared.go 中的newQuietHandle实现。快速决策清单怎么选场景推荐组合本地终端自己看--format text默认即可想看进度 结果给脚本解析--format json默认human进度自动走 stderrCI / 流水线静默执行--format json --audience agent接入代码扫描平台--format sarif把结果写入文件加--output result.json文本格式会自动剥离 ANSI 颜色码几个实用提示 退出码0表示评审完成可能零评论、可能带警告1表示致命错误参数错误、端点无法解析等错误文本打印到 stderr——CI 里直接用它判断成败。区分无变更与无发现没有可评审文件时JSON 模式会输出status: skipped的空外壳调用方据此区分两种情况。重试报告想看每次尝试的细节用--format jsonretry_report字段。delegate 模式--format只接受text或json不支持sarif。传了非法值会直接报错并提示合法取值如invalid --audience value robot: must be human or agent。相关源码与文档参数定义与校验shared_flags.go进度静默/重定向机制shared.goSARIF 生成sarif.go结果渲染与重试报告output.go完整 CLI 参考中文cli-reference.md一句话总结--format决定输出长什么样--audience决定过程显不显示。本地看结果用默认组合脚本消费加--format json流水线静默再加--audience agent接代码扫描用--format sarif。【免费下载链接】open-code-reviewFast, efficient, battle-tested at Alibabas scale. Hybrid architecture code review tool: deterministic pipelines LLM Agent, precise line-level comments, built-in multi-language ruleset (NPE, thread-safety, XSS, SQL injection), OpenAI Anthropic compatible.项目地址: https://gitcode.com/GitHub_Trending/op/open-code-review创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
