CodeScan 实战(00):从一次代码审计需求,到一套可追溯的工程实践

最初的需求很直接:从GitHub上发现CodeScan-Artex,以及自己收集、改写的其他代码审计Skills、威胁建模Skills、代码审计智能体等等,希望以 CodeScan-Artex 为主,把其余项目中有用的威胁建模、漏洞分析、PoC 和证据管理机制接进来。

真正开始运行后,问题很快从“怎么让模型多找漏洞”,变成了另一组更具体的问题:任务是否真的被拆解?接口和权限有没有源码依据?模型说已经派发,数据库里为什么没有意图?一轮结束时,哪些事实实际保存了?

这个系列按改造过程逐篇记录。它既包含部署步骤,也保留那些没有完成、不能确认和需要继续验证的部分。

0x01 系列范围

文章标题里的序号表示阅读顺序。

系列记录的主线是:

1
2
3
4
5
6
取得对应源码
→ 独立部署与配置
→ 建模、入口和权限复核
→ 按入口与边界分批审计
→ 保存源码链、反证、PoC 和未知项
→ 独立复核、报告与版本校验

其中,“独立威胁建模”“独立代码审计”“完整审计”是三个不同工作流。

0x02 全系列目录

篇目 要解决的问题
01|本地部署 Compose 如何与原 Artex 共存,更新时怎样保住状态
02|项目集成 如何把其他项目优势统一成主项目里的材料契约
03|审计方法与覆盖 怎样知道审了什么,还有哪些没审
04|建模生命周期 创建任务后,谁来建模,何时允许进入审计
05|工具空参数 save_threat_model({}) 到底在哪一层失败
06|目标拆解恢复 前两轮模型失败后,拆解会不会被跳过
07|逐次请求时间 怎样把耗时、用量和具体请求对起来
08|任务类型与长上下文 如何缩小一轮工作的范围,并改善模型页面
09|模型性能指标 TTFT、Prefill、Decode 的采集边界是什么
10|完整审计模式 同一个任务里如何先建模、再审计
11|SSE 重连 两个端口同时登录,为什么实时列表仍然失败
12|超时、循环与断点 79 轮之后,程序应该如何停止并交接
13|Planner 实际进展 怎样识别“说已经做了”,却没有执行动作
14|四任务复盘 怎样限制长时间空转,并避免保存时丢材料
15|借鉴 Mantis 如何接入版本化批次、累计预算和代码导航
16|资源清理 如何清理测试产物,同时保留状态和证据
17|SDL 路线图 怎样通过旁路 Hook 接入研发流程

每篇都可以单独阅读;遇到术语和状态不清楚时,建议先看第 02、03 篇。

下一篇:用 Docker Compose 部署,与原 Artex 共存。

http://www.pa55w0rd.online/codescan-00/