从写代码,到创作下一幕

探索 字节跳动 - 火山方舟 的 AI 编程与视频创作活动。

Agent Plan & Coding Plan

一站体验多款热门模型,为 AI 编程与智能体开发提供更多选择。新用户可联系(微信: goo_lvyouyou)免费体验 9.9 agent plan。

Seedance 2.5

让创意,跃然成片。探索 30 秒视频、多模态参考与局部编辑,把脑海中的画面变成下一支作品。

中文

运行深度安全扫描

对仓库或文件夹反复执行安全评审,并设置并发数和时长限制。

深度扫描会对同一仓库或文件夹运行多次独立的标准扫描,并合并发现的问题。如果你希望反复评审,且能接受额外的运行时间和 token 用量,可以使用深度扫描。

先运行一次标准扫描,检查范围和安全上下文是否符合目标。反复评审可能发现先前评审遗漏的问题,但无法保证检测到所有问题,也无法保证各次运行的结果相同。

在标准扫描和深度扫描之间选择

标准扫描 深度扫描
评审 一次标准扫描 多次标准扫描,并合并发现的问题
适用场景 首次扫描或评审明确的范围 对该范围进行额外的独立评审
范围 仓库或文件夹 仓库或文件夹
变更 使用变更评审工作流 不支持

启动深度扫描

为获得最佳扫描质量,请使用 gpt-5.6-sol,并将推理强度设为 xhigh。

  1. 打开 安全(Security) > 扫描,然后选择 + 扫描。
  2. 选择仓库或文件夹,选择代码库,并开启深度扫描。扫描会评审所选仓库或文件夹的全部内容。
  3. 选择模型和推理强度。在附加上下文 中添加威胁模型或部署上下文。
  4. 选择开始扫描。

你也可以从 Codex 对话中启动:

Use $codex-security:deep-security-scan to run a deep security scan of this repository.

对于单个组件,请将 "this repository" 替换为其文件夹路径。

深度扫描工作进程会继承你选择的模型和推理设置。每个工作进程运行一次完整的标准扫描,Codex Security 会汇总已完成的结果。从扫描 中跟踪已保存的扫描,或选择查看活动 以查看其 Codex 任务。如果需要限制并发数或时长,请在开始前设置运行时限制,以控制资源使用。

跟踪当前深度扫描阶段并查看其 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 或桌面应用及插件版本,以及提供商、模型、扫描状态和确切的错误信息。更新后检查到的版本可能有所不同。请参阅检查版本和更新。