从来源到运行
- 01官方归档校验摘要后原样构建扫描器
- 02网站适配固定源码与现有规则,通过官方 CLI 扫描
- 03独立报告导入结果,生成与更新开发者报告
官方基线
当前固定版本 v1.13.12 · f921d6a0,以 ocr-engine/UPSTREAM.json 的版本记录为准。官方已有增量评审、全量扫描、预览、规则匹配、Agent 工具调用、预算与并发参数、检查点续跑、JSON/SARIF 和会话 HTML 导出。
ocr-engine/UPSTREAM.json 记录官方归档地址和 SHA-256。ocr-engine/source/ 保留同版本未修改的官方源码,升级时用已校验的对应归档整体同步。构建脚本直接使用已校验的归档。
相对 v1.13.8,此次升级包含排除文件的覆盖记录、工作区评审续跑、依赖更新,以及工具调用约束、读取大小限制、会话比较和失败状态修复。网站现有规则来源仍固定于原导入版本;历史报告、规则来源与独立报告工具的来源记录保留原值。
网站自己的功能
ocr_workbench/workspace/official.py 将现有生效规则转换为官方 --rule 输入,排除没有适用规则的文件,固定源码并导入结果。没有规则的类型仍显示覆盖缺口,不新增条款。
ocr-report-renderer/ 是独立 Go 模块,新官方结果仅支持展示与离线导出。模型追加分析代码已删除,只保留历史结果的读取和导出兼容。来源记录为 ocr-report-renderer/ORIGIN.json。旧 Python 关联任务仍由 ocr_workbench/legacy/workflow.py 处理。
独立官方 ocr scan 不会自动读取网页开关;网页工作台负责将规则交给官方命令。旧 --website、--local-rules 及增强版导出参数不再属于扫描器接口。
源码与程序位置
| 位置 | 用途 |
|---|---|
ocr-engine/source/ | 与锁定版本一致的完整官方源码,供阅读参考 |
dist/engine/upstream-f921d6a0.tar.gz | 校验过的官方源码归档 |
dist/engine/bin/ocr | 当前官方扫描程序 |
dist/report/bin/ocr-report-renderer | 当前独立报告程序 |
ocr-report-renderer/ | 网站报告工具源码 |
archive/cleanup-*/ | 本机清理前备份,包含旧增强源码及未提交工作;不参与构建 |
如何确认与升级
./dist/engine/bin/ocr --version
./dist/report/bin/ocr-report-renderer --version
command -v ocr
ocr --version运行版本以以上命令的实际输出为准;每个平台分别构建核验。
管理员可将 OCR_BIN 指向自行安装的官方引擎,并独立设置 OCR_REPORT_BIN。工作台检查必需参数和结果格式;未来官方接口变化只需修改适配层。每个任务记录并保存实际扫描版本与摘要,续跑使用原程序,新扫描使用新版本。旧 fork 会话不直接续跑,已有 HTML 仍可阅读。