运行深度安全扫描
对仓库或文件夹反复执行安全评审,并设置并发数和时长限制。
深度扫描会对同一仓库或文件夹运行多次独立的标准扫描,并合并发现的问题。如果你希望反复评审,且能接受额外的运行时间和 token 用量,可以使用深度扫描。
先运行一次标准扫描,检查范围和安全上下文是否符合目标。反复评审可能发现先前评审遗漏的问题,但无法保证检测到所有问题,也无法保证各次运行的结果相同。
在标准扫描和深度扫描之间选择
| 标准扫描 | 深度扫描 | |
|---|---|---|
| 评审 | 一次标准扫描 | 多次标准扫描,并合并发现的问题 |
| 适用场景 | 首次扫描或评审明确的范围 | 对该范围进行额外的独立评审 |
| 范围 | 仓库或文件夹 | 仓库或文件夹 |
| 变更 | 使用变更评审工作流 | 不支持 |
启动深度扫描
为获得最佳扫描质量,请使用 gpt-5.6-sol,并将推理强度设为 xhigh。
- 打开 安全(Security) > 扫描,然后选择 + 扫描。
- 选择仓库或文件夹,选择代码库,并开启深度扫描。扫描会评审所选仓库或文件夹的全部内容。
- 选择模型和推理强度。在附加上下文 中添加威胁模型或部署上下文。
- 选择开始扫描。
你也可以从 Codex 对话中启动:
Use $codex-security:deep-security-scan to run a deep security scan of this repository.对于单个组件,请将 "this repository" 替换为其文件夹路径。
深度扫描工作进程会继承你选择的模型和推理设置。每个工作进程运行一次完整的标准扫描,Codex Security 会汇总已完成的结果。从扫描 中跟踪已保存的扫描,或选择查看活动 以查看其 Codex 任务。如果需要限制并发数或时长,请在开始前设置运行时限制,以控制资源使用。
评审结果
只有收尾处理成功并生成
report.md 后,扫描才算完成。仅有聚合已完成的消息或 scan-manifest.json
文件,并不能确认扫描已完成。
深度扫描与标准扫描使用相同的已保存扫描详情和完整扫描目录。在扫描 中打开已完成的扫描,或在
发现的问题 中评审其问题。当你请求相应输出时,生成的 report.md 会链接到详细的漏洞报告或结构性加固指导。共享或归档结果时,请将链接的 findings/ 和 hardening/ 目录与报告一并保留。
先查看覆盖范围摘要,再评审发现的问题。即使深度扫描也有局限,因此在得出结论前,请检查暂缓评审的范围和仍然存在的证据缺口。对于已确认的问题,请继续修复并验证问题。
要评审 PR、提交、分支范围或本地补丁,请使用评审代码变更。深度扫描不接受差异作为目标。
配置深度扫描的运行时间
若要控制深度扫描的并发数和持续时间,请创建或编辑
~/.codex/codex-security/config.toml。如果设置了 CODEX_HOME,请改用
$CODEX_HOME/codex-security/config.toml。
例如,以下配置文件会以有限的并发数运行一次较短的扫描:
[deep_scan]
workers = 2
subagents = 0
stop_after_no_new = 3
max_discovery_runs = 10
max_time_hours = 1.5| 设置 | 默认值 | 说明 |
|---|---|---|
workers |
4 |
允许同时运行的独立标准扫描工作进程数量。旧版 "auto" 也会解析为 4。 |
subagents |
3 |
每个工作进程可以启动的子智能体数量。设为 0 可将其禁用。 |
stop_after_no_new |
4 |
连续完成这么多次工作进程扫描且均未产生新发现后停止。 |
stop_after_consecutive_errors |
3 |
连续出现这么多次工作进程错误后停止。 |
max_discovery_runs |
40 |
限制聚合前独立标准扫描的运行次数。 |
max_time_hours |
96 |
将工作进程执行时间限制为不超过 96 的正小时数;可按需使用小数。 |
较低的值可以减少扫描时间和token 用量,但可能遗漏发现。配置更改仅适用于新启动的深度扫描,不适用于已经在进行的扫描。
达到时间限制时,Codex Security 会停止尚未完成的工作进程,保留已完成的扫描结果,并将其聚合到最终报告中。如果截止时间前没有任何工作进程完成源代码评审,报告会记录覆盖范围不完整。
max_time_hours 设置要求插件版本为 0.1.19 或更高版本。有关发布详情,请参阅
插件更新日志。
处理中断或失败
开始另一次扫描前,先检查已保存扫描的状态。在桌面应用中,从扫描 中打开该扫描。在 Codex 对话中,让 Codex 检查现有扫描。
- 如果等待结束时扫描仍在运行,请返回同一个扫描或对话,让 Codex 继续执行。响应结束或等待超时不会取消扫描。
- 如果扫描报告终止性故障或已被取消,请保留错误信息和已保存的扫描目录。查看已保存的发现时,请将其与尚未确认的待处理候选项分开。由于覆盖范围不完整,发现列表为空并不能证明代码没有漏洞。
寻求帮助时,请提供失败运行所用的 Codex CLI 或桌面应用及插件版本,以及提供商、模型、扫描状态和确切的错误信息。更新后检查到的版本可能有所不同。请参阅检查版本和更新。