跳到正文
Code Review
文档中心 / 报告阅读与导出

文档中心 · 使用指南

报告阅读与导出

核对检查覆盖与官方结果,搜索问题,下载报告并处理导出失败。

使用指南更新于 2026-11-18正文约 2 分钟

先看结论

  1. 01

    先确认覆盖

    计划内完成不等于整个仓库都已检查。

  2. 02

    保留官方判断

    描述、分级、代码引用和扫描建议来自官方输出。

  3. 03

    离线也能阅读

    HTML 内嵌样式、数据和脚本,搜索与下载不调用模型。

推荐的阅读顺序

从工作台「查看扫描报告」或扫描报告进入。扫描后直接生成报告,报告发布后任务结束。

流程图阅读官方扫描结果
  1. 01看覆盖核对完成、失败、复用与排除
  2. 02找问题用关键词、文件和原始分级筛选
  3. 03核对原文阅读官方描述、引用代码与扫描建议
  4. 04下载存档保存 HTML 或 JSON

严重程度的统计、排序与筛选使用官方原始分级,网站不重新评分。

覆盖与原始结果

计划内 80/80 完成只表示计划文件都已处理,包含有效复用的结果。排除、上下文和缺少适用规则的文件仍不算已检查。

官方输出未记录行号或未提供可匹配的规则引用时,报告明确显示缺失;网站不补造结论或规则。代码上下文来自扫描时固定的源码。

当前可用操作

可搜索、按文件或原始分级筛选、切换问题,导出筛选结果 JSON 或完整扫描报告 JSON。网站已移除证据核验、分级复核、项目总结、单条分析和修复候选入口。

历史报告保留原内容与来源,不能把历史网站分析当作新的官方结果。

下载、离线与打印

下载 HTML 保存当前已发布修订,离线仍可阅读、搜索和筛选。打印会展开全部问题及折叠内容,打印结束后恢复阅读状态。

HTML 下载是快照,之后重新导出的版本需要另行下载。

失败时如何恢复

扫描中断时,可在输入未变化且会话可用时继续未完成扫描。报告生成失败时点击「重新生成报告」,无需重新扫描或配置模型。

导出先写临时文件,验证会话身份后原子发布,失败时保留上一版报告。历史报告不会自动改写。

独立 CLI 的对应命令

使用该任务保存的报告输入:

bash
ocr-report-renderer process --session-file /path/to/run/report.jsonl --stage export --output review.html

新官方结果标记为 result_mode: official,仅允许导出,其他处理阶段会被拒绝。此命令不调用模型。详见CLI 手册。

实现依据

ocr_workbench/workspace/manager.py 管理原子发布;ocr-report-renderer/internal/report/official.go、ocr-report-renderer/internal/report/assets/official.html 与 ocr-report-renderer/internal/report/assets/official.js 负责官方结果排版、搜索、下载和打印。