Codex Security 插件更新日志

通过此更新日志了解 Codex Security 插件的变更。

最新插件版本： 0.1.24。

在使用较新版本的功能前，请先检查您当前 Codex 环境中的插件版本。

更新日志条目按插件版本记录，而非软件包版本。CLI 和 SDK 用户可以运行 npx @openai/codex-security info --json，同时查看 软件包及其内置插件的版本。

0.1.24（2026 年 9 月 9 日）

通过插件检查 Daybreak 访问权限

• 在使用 ChatGPT 登录的桌面端和 CLI 会话中，可在扫描前检查 Daybreak 访问权限，无需连接单独的 Codex Security Access 应用。
• 未获得访问权限时显示申请链接，无法验证访问权限时显示警告。仅使用 API 密钥的会话无法验证账户访问权限。
• 显示提示后继续扫描，即使没有访问权限或检查失败也不例外。该提示不会授予访问权限，也不决定扫描是否运行。

按请求验证安全修复

• 仅在您明确要求验证安全修复时， 才运行 $codex-security:verify-fix。
• 普通的修复实施、代码审查和测试请求仍沿用各自现有的工作流，不会自动切换为验证结果格式。

0.1.23（2026 年 9 月 8 日）

评估拟议补丁的风险

• 使用 $codex-security:assess-patch-risk，根据 确切的修订版本和源代码证据审查拟议变更。
• 将影响、发生可能性和恢复难度与回归防护分开评估，并指出会影响建议的证据缺口。
• 获得合并、修改或不做更改的参考建议。评估不会合并代码，也不会取代代码仓库的审批规则。

恢复失败扫描中保留的结果

• 根据您的请求，从选定的失败扫描中恢复已保存的有效发现项，无需重复扫描。
• 浏览已保存的扫描和发现项，不会自动恢复所有失败扫描。恢复操作会保留扫描失败的状态，不适用于正在运行、已完成或已取消的扫描。
• 当执行智能体复用候选项标识符时，仍保留不同的发现项，并在恢复期间保留有效证据和根因详情。

让扫描设置和报告更清晰

• 在标准扫描和变更扫描中，查看各项就绪检查及其阻塞问题或警告详情。
• 在您决定如何解决设置问题期间，扫描保持可继续的状态。交互式会话中的持久性配置更改仍需您的审批。
• 在深度扫描报告中查看已配置的包含路径和排除路径。
• 上下文更新仅作用于选定的扫描，不会替换已保存的工作空间默认设置。

改进启动和 GitHub 问题分诊

• 插件工具服务器的启动等待时间最长为两分钟，并将 OpenAI API 密钥身份验证传递给深度扫描执行智能体。
• 导入发现项进行分诊时，使用明确选定的 GitHub 连接器，并在切换到其他连接或账户前询问您。

0.1.22（2026 年 8 月 25 日）

验证现有安全修复

• 使用 $codex-security:verify-fix 检查现有补丁是否解决了 已报告的安全发现项，且不会更改代码仓库文件或 问题跟踪系统。
• 每个发现项都会获得 fixed、still_vulnerable 或 inconclusive 结果， 并附有支持证据和验证局限说明。
• 在发现项修复工作流中加入补丁实施前的调查和实施后的审查。

扫描停止时保留发现项

• 随着深度扫描执行智能体的工作推进，保存发现项和待处理候选项。
• 即使后续结果整合遗漏了已接受的执行智能体发现项，或整合失败，这些发现项仍会保留在结果中。
• 保留失败、已取消或已中断扫描的有效结果，同时保留其未成功状态和覆盖不完整的记录。
• 将提供的扫描提示传递给深度扫描执行智能体，并保留父会话中受支持的文件系统拒绝访问规则。

改进 Windows 和文件系统兼容性

• 在扫描历史记录中匹配等价的 Windows 路径，并从预期位置加载 Windows 系统配置。
• 阻止使用 Windows 解析时可能产生歧义的扫描产物路径。
• 在不支持硬链接的文件系统上保存扫描结果。
• 在 Python 3.10 中以一致的方式读取 UTC 扫描时间戳。

0.1.21（2026 年 8 月 21 日）

提高插件安装和启动的可靠性

• 安装插件无需依赖可选的 Codex Security Access 应用。托管环境中的访问权限检查仍仅供参考。
• 启动插件时使用 Codex 内置的 Node.js 运行时，包括在无法直接运行打包可执行文件的 Windows 安装环境中。
• 在 Windows 上以 UTF-8 编码读取 Git 元数据。

保留发现项详情并改进 SARIF 导出

• 确保已保存的发现项、报告和安全工作台中的验证信息、攻击路径证据和根因详情保持一致。
• 为 GitHub 代码扫描导出易读的规则名称、修复指导、CWE 标签和安全严重性级别，同时保留发现项标识、指纹和源代码位置。

0.1.20（2026 年 8 月 17 日）

以完整的独立审计方式运行深度扫描

• 让每个深度扫描执行智能体都执行与标准扫描相同的端到端审计，包括威胁建模、验证、攻击路径分析和覆盖情况报告。
• 将执行智能体已完成的报告合并到一次扫描中，同时保留已配置的时间限制、部分覆盖记录、重启恢复和取消功能。
• 默认使用四个并发执行智能体，连续四次完成的扫描 均未新增发现项后停止，每次深度扫描最多运行执行智能体 40 次。现有的 workers = "auto" 设置现在会解析为四个执行智能体。请参阅 配置深度扫描运行时。
• 对于已完成源代码审查但丢失最终草稿的执行智能体，恢复其工作，无需重复完整审计。

在托管扫描前检查 Trusted Access for Cyber

• 在提供 Codex Security Access 应用的 Codex 主机中，标准扫描、变更扫描和深度扫描开始前会检查 Trusted Access 状态。
• 受保护的扫描输出可能不可用时，会显示醒目的警告；未获得访问权限时，还会显示申请链接。
• 当检查无法验证 Trusted Access 状态或未获得访问权限时，扫描仍会继续；该提示不决定扫描是否运行。
• 公开发布的 CLI 和 SDK 包在 0.1.20 版本中不运行这项提示性检查。

在更多环境中运行深度扫描

• 从打包安装的 CLI 和 SDK 启动深度扫描工作智能体，包括 未安装全局 codex 可执行文件的 Windows 环境。
• 将独立 CLI 和 SDK 的深度扫描设置与其他正在运行的扫描隔离。
• 在嵌套的深度扫描工作智能体中保留非交互式审批设置。

在更多故障情况下保留扫描结果

• 在重启、归档和交接恢复流程中，保留更多已保存的扫描和工作智能体已完成的结果。
• 从旧版或不完整的扫描数据中恢复有效的发现项。
• 在独立覆盖情况报告存在重叠时仍能完成扫描。
• 无论提供商返回的是当前版本还是旧版响应，都能在 Token 用量汇总中正确报告缓存输入。

0.1.19（2026 年 8 月 13 日）

为深度扫描设置时间限制

• 将 [deep_scan].max_time_hours 设为大于零且不超过 96 小时的时长。 您可以使用小数小时。
• 达到时限后保留已完成的发现阶段结果，然后继续验证和报告。
• 如果达到时限前未完成任何源代码审查，则将报告标记为部分完成。

提高扫描可靠性

• 在工作智能体停止或归并器重试时，保留已完成的发现阶段工作。
• 读取更大的源文件并生成报告，不再受先前固定大小限制的约束。
• 从所选修订版本读取已提交的更改，并在 Windows 上保留相对于代码仓库的路径。
• 将 OpenRouter 和 Fireworks 凭据传递给深度扫描工作智能体。

0.1.18（2026 年 8 月 7 日）

使用 Amazon Bedrock 进行安全扫描

• 使用 Amazon Bedrock 持有者 Token 以及 AWS 配置方案、区域设置、Web 身份或容器凭据运行扫描。
• 让受委派的深度扫描工作智能体能够继续使用 AWS 身份验证。

减少标准扫描所需的协调工作

• 使用更简单的工作流程，对代码仓库或限定路径进行标准扫描。
• 保留嵌套目录中的 SECURITY.md 指导、精确的扫描范围、进度更新 和最终扫描报告。

更可靠地启动和完成扫描

• 通过提示启动扫描时，为大型代码仓库提供最长五分钟的初始化时间，不再在 30 秒后超时。
• 在主机限制工具名称长度时仍能完成标准扫描和深度扫描。

文件系统变更后仍可进行修复

• 即使重新挂载文件系统导致其设备标识符发生变化，仍可修复已完成扫描中的发现项。
• 应用修复前，仍须使用原始检出目录和 Git 修订版本。

0.1.17（2026 年 8 月 5 日）

实时跟踪扫描进度

• 在同一个实时进度视图中跟踪当前扫描阶段、已用时间、活跃工作智能体、已审查文件和 Token 用量。
• 每个文件审查完成后即可看到代码仓库审查进度更新，无需等待扫描结束。

恢复中断的深度扫描

• 协调器重启后继续正在进行的深度扫描，无需重复已完成的文件审查。
• 在应用更新或扫描会话中断后，保留已完成的发现阶段结果、扫描归属和待处理工作。

以更低的开销启动和完成扫描

• 直接在原生工作流中启动标准扫描、变更扫描和深度扫描，无需打开已停用的嵌入式扫描组件。
• 复用已完成的扫描摘要，无需重新加载每个发现项，除非您请求完整的结构化结果。

0.1.16（2026 年 8 月 4 日）

跟踪实测扫描用量

• 查看主扫描及其受委派工作智能体的 Token 总用量，以及输入、缓存输入和输出 Token 用量。
• 区分完整、部分和不可用的测量数据，不再将缺失的用量显示为零。

进行更深入的扫描并保持结果一致

• 标准扫描和深度扫描采用相同的威胁建模、发现、验证、攻击路径分析和报告阶段。
• 通过 CLI 或 SDK 配置深度扫描工作智能体、各工作智能体的委派设置、饱和条件和发现阶段限制。
• 使用模型支持的工作智能体运行时进行深度扫描，并在恢复旧版扫描状态时保留现有扫描历史。
• 为变更扫描和深度扫描生成主报告，无需单独的漏洞说明或加固建议。

保持扫描指导和代码仓库目标准确

• 在扫描进行期间更新安全指导，并将其传递到后续阶段和受委派的深度扫描工作智能体。
• 保留代码仓库 URL、Pull Request 引用和更长的安全上下文，同时不允许您未请求的网络访问。
• 如果代码仓库或扫描目标在执行期间发生变化，则将扫描判定为失败，避免自动化接受过时的发现项。
• 在受管网络环境中遵循企业代理和受信任证书设置。

撰写更清晰的漏洞报告

• 生成有源代码证据支持的漏洞报告，区分已观察到的行为与未经验证的假设。
• 如实说明概念验证的局限，并包含受影响版本、安全边界和可执行的修复指导。

0.1.15（2026 年 7 月 30 日）

代码仓库变更时保留扫描结果

• 即使扫描运行期间文件或代码仓库修订版本发生变化，仍将已完成的发现项和报告关联到原始修订版本或工作树快照。
• 当所选代码发生变化或目标不可用时，在扫描完成时显示警告，而不是丢弃扫描结果。
• 将现有扫描的输出目录用于另一次扫描之前，先归档现有扫描。

应用已审查的发现项反馈

• 将发现项作为误报关闭时，记录原因。
• 在后续扫描同一目标时沿用已审查的误报判定，但不将其应用于另一个检出目录或无关目标。
• 仅当先前的理由仍适用于当前代码和安全控制措施时，才抑制重复出现的发现项。

恢复有效发现项，不夸大覆盖范围

• 当其他发现项、报告或加固产物格式有误时，保留有效发现项，并针对跳过的数据显示警告。
• 移除重复发现项，并根据严重程度、置信度和支撑证据，保留其中最有力的发现项。
• 当 Codex 无法核实发现项、审查回执或待跟进区域时，将覆盖情况标记为部分覆盖。
• 在 SARIF 导出内容中包含覆盖不完整和审查推迟的警告。

持续显示扫描设置和进度

• 随标准扫描和深度扫描保存所选模型及推理强度，确保重新加载后扫描历史记录和进度保持一致。
• 显示正在进行和已完成的独立深度扫描审查数量，以及结果整合的开始时间。
• 根据可用的工作智能体容量调整标准扫描的发现阶段，同时保留一份扫描范围内的文件列表，并对候选发现项进行一轮审查。

支持更多代码仓库和文件系统布局

• 捕获工作树快照时包含嵌套的 Git 代码仓库。
• 原样保留扫描范围内的文件路径，并处理不区分大小写的 Windows 路径。
• 在扫描预检期间，展开配置中以 ~ 开头的 CODEX_HOME。

0.1.14（2026 年 7 月 28 日）

查看扫描历史记录和重复出现的发现项

• 筛选代码仓库、发现项和扫描历史记录，每页结果数量有限，并提供更清晰的状态详情。
• 使用已保存的设置重新运行扫描，并比较已完成的扫描，以区分新增、持续存在、已解决和尚未重新扫描的发现项。
• 将同一代码仓库的工作树归为一组，并在各个视图中使用稳定的代码仓库和发现项标识。

定义代码仓库安全策略

• 使用 $codex-security:define-security-policy 审查或更新指定范围内的 SECURITY.md 指导，涵盖信任边界、安全不变量、可报告的发现项、 严重程度、排除项和已接受的风险。
• 应用最近的策略文件，同时限制其大小，并拒绝指向代码仓库外部的符号链接。

跟踪发现项前先进行审查

• 从已完成的扫描中选择最多 25 个发现项，在 Linear 或 GitHub 议题中跟踪。
• 将所选发现项返回 Codex 进行审查和审批，而不是直接从发现项工作空间创建议题。

以更简单的工作流程运行标准扫描

• 对代码仓库和指定路径进行标准扫描时，使用一份以确定性方式生成的扫描范围内文件列表，以及一份精简的候选发现项台账。
• 减少重复的扫描阶段，同时保留现有的清单、发现项、覆盖情况、报告和 SARIF 输出。

0.1.13（2026 年 7 月 25 日）

审查更多环境中的发现项

• 即使受影响的代码位于本地、仅供内部使用、用于训练或尚未部署到生产环境，也保留真实的安全发现项。
• 根据部署和暴露情况校准严重程度与置信度，而不是自动抑制发现项。

0.1.12（2026 年 7 月 23 日）

运行更深入的扫描，更清晰地查看进度

• 运行深度扫描，协调工作智能体扫描整个代码仓库或选定目录。
• 将您的模型和推理设置沿用到委派的扫描工作中。
• 在扫描前和扫描过程中，查看预检结果、扫描进度、可用的工作智能体容量和回退行为。

查看并重新运行先前的扫描

• 从安全扫描列表中打开当前和先前的扫描。
• 在发现项工作空间中重新打开已保存的扫描，或重新运行扫描以刷新结果。
• 查看更清晰的完成状态，以及更一致的发现项详情和扫描历史记录。

减少配置扫描时的打断

• 通过原生设置流程启动扫描，无需离开当前任务。
• 即使 Codex 处于全屏模式，扫描设置也会保留在侧面板中。
• 不需要时关闭设置界面，并为后续扫描保留这一偏好。

审查并修复已验证的发现项

• 在已完成的结果中保留经过验证的低严重程度发现项。
• 在扫描、报告和导出内容中查看更一致的发现项详情。
• 重试修复，并将相关扫描上下文沿用到后续修复中。

导出结果以用于现有安全工作流

• 将已完成的发现项导出为 JSON、CSV 或 SARIF。
• 在本地生成 SARIF 结果，以便与代码扫描和安全工具集成。
• 在各种导出格式中保持发现项详情一致。

0.1.11（2026 年 7 月 10 日）

生成详细的发现项报告和加固报告

• 为每个可报告的扫描发现项生成一份有源代码证据支撑的漏洞报告，并在有概念验证文件时一并提供。
• 审查一套结构性加固方案，其中包含对完整发现项集合、工程权衡、迁移选项和辅助图表的分析。
• 使用 report.md 作为入口，访问 findings/ 和 hardening/ 下的这些衍生输出。共享或 归档结果时，请完整保留整个扫描目录。

直接运行报告工作流

• 使用 $codex-security:vulnerability-writeup 将披露文档、 初步发现项、PoC 和源代码整理成完善的报告，无需先 运行 Codex Security 扫描。
• 使用 $codex-security:propose-security-hardening，根据扫描结果、发现项、事件或评估文档以及源代码， 制定有证据支持的结构或架构 方案。

一致地应用代码仓库指导规则和覆盖范围

• 在根目录或子目录的 SECURITY.md 文件中定义威胁模型上下文、安全不变量、 可报告发现项的判定标准、排除项以及严重程度评估所需的上下文。 优先采用目录层级中最近的适用文件。
• 在验证前提高代码仓库的审查覆盖度，同时保留明确暂缓审查的部分和证据缺口。
• 在变更扫描中审查已删除的源文件，并在验证前扩大默认的代码仓库审查覆盖范围。
• 在深度扫描开始前，检查各扫描阶段的技能、受委派的工作智能体及其可用容量。

0.1.10（2026 年 6 月 23 日）

改进 Jira 和 Linear 工单导入

• 在导入 Linear 子议题前询问您，并在结果中保留父子关系。
• 区分未建立连接、权限不足、工单无法访问和连接器临时故障等情况。
• 当无法获取所请求的工单内容时停止处理，不生成判定结论。
• 在每个已确认或待审查队列中， 分配从 1 开始且不重复的正整数排序编号。

更可靠地审查代码更改

• 将待检查的提交与其实际父提交进行比较，并在发现项工作空间中保留差异比较目标。
• 报告补丁状态不可用，而不是转去审查另一项更改。
• 查看一致性更好的分诊结果和发现项上下文。

0.1.9（2026 年 6 月 18 日）

在发现项工作空间中审查扫描结果

• 在专用工作空间中审查已完成的扫描，集中查看发现项、覆盖范围、严重程度、置信度和扫描产物。
• 筛选发现项并对其排序，包括按置信度从高到低排序，同时在刷新时保留您的工作空间状态。
• 打开发现项，在同一处查看源代码证据、验证详情、可达性、影响和修复指导。

简化扫描设置

• 对 Git 代码仓库、单个文件夹或没有 Git 历史记录的代码库运行标准扫描。深度扫描也可以针对特定文件夹运行。
• 主动取消正在运行的扫描，恢复中断的扫描而无需再次响应设置提示，并在启动并发深度扫描前收到警告。
• 查看更清晰的设置和进度状态，以及更精简的进度摘要；错误信息会持续显示，直到您处理为止。

导出可移植、可验证的结果

• 使用一致的已完成扫描格式，其中包含清单、结构化发现项、覆盖范围数据，以及基于同一份权威结果生成的 Markdown 报告。
• 将发现项导出为 JSON、CSV 或 SARIF，用于分析、归档以及与其他安全工具集成。
• 更可靠地完成扫描，包括 Windows 路径或扫描锁定影响文件系统访问的情况。

对现有发现项进行分诊和跟踪

• 结合当前代码库，对来自扫描器、安全公告、漏洞赏金报告、GitHub、Jira、Linear 或 Codex Security 结果的现有发现项进行分诊。分诊工作流程会返回有证据支持的判定结论和按优先级排列的操作队列。
• 在 Linear、Jira 或 GitHub 议题中跟踪选定的已验证发现项，或在代码仓库满足安全公告要求时创建私密的 GitHub 安全公告草稿。
• 批准写入前，审查重复项检查结果、源代码上下文、目标位置的可见性以及拟写入的确切内容。Codex 会在创建或更新后重新读取结果以进行验证。

0.1.7（2026 年 6 月 4 日）

开展有证据支持的安全审查

• 扫描已获授权的代码仓库或选定文件夹，查找安全漏洞。
• 需要更全面的覆盖时，对整个代码仓库运行多轮漏洞发现。
• 审查 Pull Request、提交、分支差异和本地补丁，检查是否存在安全回归问题。
• 在生成扫描报告前，让每个候选发现项都经过威胁建模、发现项挖掘、验证和影响分析。
• 使用有针对性的补丁修复一个已采纳的发现项，补充回归测试覆盖，并验证原始问题。