跳到正文
Code Review
文档中心 / 扫描进度、性能与用量

文档中心 · 使用指南

扫描进度、性能与用量

理解并发、Token 预算、各类超时、进度估算与结果复用,按实际瓶颈调整。

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

先看结论

  1. 01

    预算用于官方扫描

    Token 预算 0 表示不限,文件任务和阶段仍有时限保护。

  2. 02

    报告不调用模型

    扫描完成后只导出 HTML,没有追加分析用量。

  3. 03

    统计按实际能力展示

    官方未提供的请求次数显示未记录。

先判断慢在哪一步

流程图当前执行阶段
  1. 01范围准备读取仓库、匹配规则并固定源码
  2. 02官方扫描模型工具调用、审查与检查点
  3. 03报告发布用保存的官方结果生成 HTML

任务详情每 2 秒局部更新检查进度、文件状态和任务状态,保留已打开的日志、文本选择与滚动位置。正在分析的文件会标为“检查中”。文件完成数来自扫描期间持续写入的会话检查点,官方引擎通常在一批文件处理完后集中保存,因此完成数可能按批次增加。最终覆盖以保存的扫描结果为准,代码改动评审还会校验运行清单。页面不推算精确剩余时间。

当前网页默认值

设置默认值说明
文件任务并发8,可设 1–20引擎同时推进的任务数
每个任务时限30 分钟,可设 0–120,0 为不限与阶段总时限不同
扫描 Token 预算0,不限交给官方预算参数
单次模型请求600 秒实际执行以官方版本支持为准
无新进度等待1800 秒长期无可观察进展时中断并保留结果
阶段最长耗时0,不限管理员可按阶段覆盖
已有结果复用仅续跑新建检查重新分析;继续未完成时才复用兼容检查点

独立 CLI 默认值不同:scan 默认并发 8、每任务 15 分钟;明确不限预算使用 --max-tokens-budget 0。详见CLI 用量设置。

为什么提高并发不一定更快

扫描默认最多同时执行 2 个项目任务,由 OCR_LLM_MAIN_CONCURRENCY 控制;每个任务的 --concurrency 默认 8。这限制文件任务并行度,不是官方内部 HTTP 请求的全局硬上限。

模型响应、上下文大小和服务限流都会影响速度。原报告辅助请求队列不再用于扫描流程。

用量如何统计

配置预算交给官方 --max-tokens-budget。用量来自官方结果,异常中断缺失的用量不能推断为零。查看和导出报告不新增模型用量。

失败恢复与重复扫描

官方扫描器沿用自身 SDK 重试和检查点。选择「继续未完成」且完整源码身份、规则、模型、范围与引擎摘要兼容时可复用;源码变化或修复后验证应重新预览并新建检查。

报告导出失败可以独立重试,不重扫代码,也不需要模型连接。

管理员可调整什么

阶段覆盖变量为 OCR_<PHASE>_IDLE_SECONDS 与 OCR_<PHASE>_MAX_SECONDS,当前流程的 PHASE 为 SCAN、EXPORT。官方单请求超时以对应版本实现为准;网站用无输出等待和阶段最长时间保护子进程。

GOMEMLIMIT 默认 512MiB,是 Go 回收软限制。每个任务记录并固定官方程序版本和 SHA-256,报告工具独立记录导出版本。

实现:ocr_workbench/workspace/engine.py、manager.py。版本见版本说明。