CodeMender 可以自动生成、验证和应用源代码补丁,以修复已验证的漏洞,并在本地沙盒中进行测试,从而帮助减少回归问题。
生成漏洞修复
使用 cm fix 为经过验证的发现结果生成经过验证的安全补丁:
cm fix FINDING_ID
运行 cm fix 时,CodeMender 会执行以下验证步骤:
- 使用云托管推理引擎生成候选补丁。
- 将补丁应用到本地沙盒内的源代码副本。
- 通过运行您配置的
build.command来编译和测试代码库,以确保项目构建和单元测试通过。 - 重新运行经过验证的 PoC 漏洞利用,以确认该漏洞无法再被利用。
默认情况下,CodeMender 会在将每次文件修改写入工作区磁盘之前提示您进行确认。所有检查都通过后,CodeMender 会将经过验证的补丁应用到您的工作区。然后,您可以暂存更改。
修正标记
- 提供修复上下文(
-c/--context):提供架构限制或编码准则:cm fix FINDING_ID -c "Use the safe parameterized database helper in src/db/query.go"
- 自动批准提示 (
-y/--yes):在修复过程中自动批准所有文件写入和命令确认提示: 注意:您还可以通过设置cm fix FINDING_ID -y
tools.confirm_writes: false和tools.confirm_commands: false,在config.yaml中停用交互式确认提示。停用确认提示后,请先查看测试结果,然后再暂存或提交更改。 - 控制沙盒 (
--sandbox):为此次运行显式启用或停用操作系统级沙盒(例如,使用--sandbox=false停用):cm fix FINDING_ID --sandbox=false
- 绕过路径边界 (
--allow-all-paths):为此运行停用工作区路径边界检查,以便智能体工具可以访问项目根目录和配置的project_paths之外的路径(与--sandbox=false结合使用可访问未装载到沙盒内的主机路径):cm fix FINDING_ID --allow-all-paths
- 绕过命令政策 (
--allow-all-commands):针对此运行,停用command_policy.yaml屏蔽名单强制执行:cm fix FINDING_ID --allow-all-commands
- 绕过缓存 (
--no-cache):强制 CodeMender 生成新补丁:cm fix FINDING_ID --no-cache
- 设置执行时长预算(
--duration/--timeout):为补丁生成和验证设置实际时长上限(例如15m或30m),或在config.yaml中设置CM_DURATION或execution.duration: 达到时长上限后,CodeMender 会给智能体一个短暂的宽限回合,让其完成补丁。如果智能体在宽限轮次期间完成,cm fix FINDING_ID --duration 20m
cm fix会运行构建验证(如果构建通过,则应用补丁并将发现结果标记为FIXED;如果构建失败,则保存pending补丁并保留修改),并仍以状态50退出。如果会话在完成之前达到硬性截止时间,CodeMender 会还原未经验证的工作树修改,将所有正在进行的差异保存为partial补丁(您可以使用cm report --patches进行检查),并以状态50退出。
检查和管理本地 VCS 差异
CodeMender 包含内置 VCS 命令,可帮助您在提交补丁之前检查、暂存和管理补丁引入的代码更改:
查看代码库状态:查看 CodeMender 在本地工作区中修改或创建了哪些文件。
cm vcs status
检查差异:逐行查看代理生成的所有未提交代码修改的统一差异。
cm vcs diff
暂存更改:将经过验证的补丁修改添加到本地暂存环境,以便进行测试和提交。
cm vcs stage
还原会话修改:舍弃 CodeMender 在当前会话期间生成的所有本地文件修改,并将代码库恢复到基准状态。
cm vcs reset