代码审查工具 1.13.12 将操作性部分失败反馈为非零退出状态,同时对文件读取增加字节边界。接入自动化时,既要保留已完成的结果,也要检查失败分类;仅因配置预算用尽而形成的部分评审,仍可能以零状态退出。

哪些部分失败会让流水线失败?
Open Code Review 1.13.12 的正式发布说明列出了部分操作失败的退出码修复。对应版本的 CLI 文档区分了两类结果:评审完成或跳过返回 0,仅由已配置预算限制导致的部分评审也返回 0;超时、provider 错误、配置错误等操作性失败返回 1,已有结果会在返回错误前输出。
因此,“有报告文件”不等于“所有目标都已评审”,而“返回 0”也不能单独证明覆盖完整。处理自动化结果时,应结合 JSON 中的 warnings 和 manifest.coverage.failed 判断受影响的文件及失败分类。这里的退出码表示执行结果,不能直接当作代码不存在缺陷的证明。

怎样保留报告并传递真实退出状态?
先在已安装该工具的终端运行下面两条命令。版本信息应与 1.13.12 对应,帮助信息用于确认当前二进制的命令接口;若仍显示旧版本,不能仅凭仓库发布说明认定本机已经具有这些修复。
ocr version ocr review --help
下面是依据该版本 CLI 参数编写的 POSIX shell 接入示例,适用于已配置 provider 的 Git 仓库。HEAD 指当前提交;运行会调用已配置的模型,产生相应请求。标准输出写入 review.json,诊断写入 review.stderr,脚本最终保留原命令状态。此处给出接入示例,实际输出以运行结果为准。
#!/bin/sh # 在已配置 provider 的 Git 仓库中执行;HEAD 表示当前提交。 # 以 1.13.12 的 ocr 为前提,保存标准输出与诊断。 review_status=0 ocr review --commit HEAD --format json > review.json 2> review.stderr || review_status=$? printf 'OCR exit status: %s\n' "$review_status" exit "$review_status"
预期结果是保留本次输出并打印原退出状态;是否为完整评审仍需读取报告。不要在命令失败后无条件返回成功,也不要把所有 partial 都一律判为同一种故障。若输出不是有效报告,应先处理诊断,不把空文件当作成功结果。
文件读取为什么还要限制字节?
固定在 v1.13.12 标签的 file_read 源码仍保留最多 500 行的限制,并增加单行 2048 字节和结果正文 256 KiB 的边界。压缩后的脚本、生成文件或单行 JSON 即使行数少,也可能携带大量内容,单纯限制行数无法约束这类输出。
单行截断会避开 UTF-8 字符中间位置并附带省略提示;结果正文预算计算包含行号前缀、内容和换行。IS_TRUNCATED 会反映字节截断,LINE_RANGE 则按实际显示的行计算。256 KiB 是渲染正文的预算,不能扩展解释为整个文件大小上限、总内存上限或模型输入总量上限。
看到截断标记时,只能依据可见片段作判断。较窄的行范围有助于继续定位后续行,但单行本身超长时,缩小行范围并不会自动恢复该行被省略的全部内容。
其他修复和适用范围
本次还列出 finding 身份字段分离、遥测惰性初始化串行化、取消后用 WaitDelay 约束 git 子进程等待,以及 Windows 测试清理相关修复。Windows 这一条是测试清理行为,不能据此宣称所有 Windows 运行问题都已修复。
这是 GitHub 标记为非预发布的 1.13.12,发布页提供 macOS、Linux、Windows 的 amd64 与 arm64 资产。发布说明和固定标签源码、文档说明了该版本的设计行为;具体平台二进制仍需在部署环境验证,包管理器或本机也不一定已自动更新。优先评估依赖退出码判断执行结果、或经常读取长行生成文件的使用场景。










