系列目录 · 第 02 篇
改造保留了 CodeScan-Artex 的 Go 后端、任务编排、双图和 PostgreSQL,把其他项目中有价值的机制落到已有执行路径里。
我首先关注的是材料能否在系统里流转:模型提到的威胁、接口、源码、漏洞和 PoC,怎样对应到同一个版本?
0x01 分别吸收了什么
| 来源 | 借鉴重点 | 主项目落点 |
| — | — | — | — |
| 威胁建模项目 | STRIDE、组件、数据流、信任边界和源码引用校验 | 模型契约、源码校验与威胁模型工作区 |
| VeriAudit | Source→Sink、传播关系、安全控制、PoC 和验证分工 | audit.Case、audit.PoC 与独立复核 |
| 知弈 AgentOS | 内容摘要、追加版本、前序哈希、归属校验和幂等 | 审计记录链、归档恢复与证据包校验 |
当次记录还保留了各仓库的许可核对结果,因此没有直接搬入大段实现或提示词。
0x02 用一份漏洞契约串起材料
audit.Case 保存一条候选漏洞的关键内容:
- 审计时的源码版本与文件摘要。
- Source、Sink、逐跳传播证据及安全控制。
- 攻击者能力、成立前提、影响和修复建议。
- PoC 环境、准备步骤、载荷、成功判据、阴性对照和清理。
- 威胁模型关联与保存时的模型快照。
这份结构要能被 Agent 提交、后端读取、页面展示和报告导出。只在提示词里要求“给出完整证据链”,无法保证后面的系统接得到这些材料。
0x03 源码证据由宿主重新读取
源码引用包含相对路径、精确行范围、原样片段和 SHA-256。保存时,服务端从本任务源码根目录重新读取并核对。
这样可以发现路径越界、文件变化、片段不匹配和引用缺失。重复代码片段也不能通过“随便找一个相似位置”来通过检查。
但引用匹配只回答“这段内容是否在这个版本中”。从公开入口是否可达、上游有没有鉴权、攻击者能否控制这个值,仍需要沿调用与数据流检查。
0x04 把几种状态分清楚
| 状态 | 含义 |
|---|---|
needs_validation |
材料存在缺口,返回具体待补项 |
poc_generated |
结构化材料和引用检查满足要求,PoC 已生成 |
oracle_matched |
本地观测满足所配置的判据,阴性对照未命中 |
not_reproduced |
本次运行没有观察到判据 |
blocked |
运行失败、响应不完整或缺少条件 |
独立复核另有 confirmed / refuted / inconclusive。这两套状态分别表达材料及观测质量、漏洞判断,不能用一个布尔字段把它们合并。
0x05 PoC 分为材料和实际观测
Agent 继续保持静态分析边界。它生成复现步骤和载荷,操作员再在明确的本地环境运行。
新增的 HTTP 运行器只接受显式回环 IP,不跟随重定向,也不启动任意目标进程。请求参数、HTTP 解析后的响应头、原始正文和摘要都会保留。响应截断或解析失败时,应保持受阻状态。
平台导入执行记录时还会核验签名、Case/PoC 摘要和当前证据版本。签名表达的是持有密钥的操作员提交了这份记录;目标的构建来源和漏洞语义仍要另外证明。
0x06 版本链和报告如何联动
模型、漏洞契约和执行记录采用追加版本,保留前序摘要。写入带当前读取的 expected_revision,并发冲突时重新读取,避免后保存的草稿覆盖别人已经补好的内容。
还有一个容易混淆的字段:evidence_version 表示报告所依据的整体证据版本,审计材料链的 revision 表示对应记录链的修订。两者用途不同。
材料变化后,旧报告应显示待更新。归档恢复和 ZIP 导出也要保留这些版本关系,使复核者知道报告依据的是哪一批材料。
0x07 这一轮留下的基础
这一轮把“能够写出分析”推进到“材料可以保存、展示、复核、导出”。接下来还需要解决覆盖范围:即使每条漏洞材料都完整,也无法据此回答整个仓库审到了哪里。
源码入口:audit/model.go、audit/source.go、db/audit.go、agent/audit_tools.go。
