ARTEX双图架构入门:资产图+探索图如何支撑AI自主攻击路径推演
ARTEX双图架构入门:资产图+探索图如何支撑AI自主攻击路径推演
ARTEX 是一个 LLM 驱动的多 agent 自主渗透测试框架,它的核心是双图架构:全局共享的资产图(Asset Graph)与每任务独立的探索图(Exploration Graph)。两张图通过"锚点"相连,让 AI 规划者(planner)看清"还有哪些方向没测"、派意图(intent)给执行者(worker),再把新资产、事实与漏洞写回两图——由此形成自主攻击路径推演的闭环。
⚠️ 仅用于自有系统或已获书面授权的环境,本文只做架构原理讲解。
一分钟看懂:ARTEX 双图架构总览
可以把一次渗透测试想象成"探索一栋陌生的大楼":
- 资产图=大楼的档案台账:有哪些房间、设施、出入口(域名、子域、IP、服务、端点);
- 探索图=你的行动日志:先去哪、发现了什么、拿到了什么钥匙(目标、意图、事实、漏洞)。
台账是整栋楼共用的(跨任务共享),行动日志则是每次任务单独记一本。ARTEX 正是把"目标是什么"和"测到了什么程度"拆成这两张相互独立、又通过锚点相连的图:
- 资产图(全局共享):跨任务同一份的资产真值库,节点为
root_domain / subdomain / ip / service / app / endpoint,归属公司;域名→子域→服务→端点的父子关系与去重 key 全部由程序计算,agent 只提交原始信息; - 探索图(每任务独立):一次任务的"思考与推进"过程,节点为
goal(目标)/ intent(意图)/ fact(事实)/ finding(漏洞)/ hint(提示),靠spawns / derived_from / yields / proves等边连成血缘链,回答"哪个方向派生自哪些事实、产出了什么"。

资产图:全局共享的"资产真值库"
资产图回答"有什么可测"。它的节点类型覆盖从宏观到微观的完整链路:
| 节点类型 | 含义 | 例子 |
|---|---|---|
root_domain |
根域名 | acme.com |
subdomain |
子域名 | admin.acme.com |
ip |
IP 地址 | 203.0.113.10 |
service |
服务(主机+端口) | :443 · API Gateway |
app |
应用指纹 | Element-UI 后台 |
endpoint |
端点(接口/页面) | /search |
两个关键设计让资产图可以"越用越准":
- 程序负责结构,agent 只报事实:父子关系(子域挂在根域下、服务挂在子域上)和去重 key 都由后端计算。比如 worker 上报一个新子域时,UpsertSubdomain 会自动幂等地合并/去重,并顺手登记其根域名、绑定 IP;
- 跨任务共享:同一个公司域名下的资产在多个任务间复用同一份台账,新任务不必从零重新扫描,直接站在已有资产上继续探索。
资产的管理入口在 Web 界面「资产」页签,可以按公司查看资产数与资产范围(域名 / CIDR)。
探索图:每任务独立的"思考推进链"
探索图回答"我是怎么一步步推到漏洞的"。它是 AI 自主推演的舞台,节点类型见 db/constants.go:
- goal 目标:任务要证明什么(例如"拿到后台权限");
- intent 意图:planner 派出的探索方向,进 frontier 队列等待领取;
- fact 事实:worker 的探索结论——包括否定结论("端口关闭""参数不可注入");
- finding 漏洞:真实触发、拿到可复现证据的确认漏洞(区别于 fact);
- hint 提示:人(主 agent)注入的战略提示,planner 下次生成意图时会读到。
节点之间用四种边(db/constants.go)连成血缘链:
| 边 | 含义 |
|---|---|
spawns |
目标/起点 生发 出意图 |
derived_from |
新意图 派生自 已有事实 |
yields |
意图 产出 事实 |
proves |
漏洞 证明 目标达成 |
于是整条攻击链在图上可追溯:起点 → 目标"获取后台权限" → 意图"子域枚举" → 事实"发现 admin.acme.com" → 意图"后台注入" → 漏洞"error-based 注入" → 证明目标。这正是"攻击路径推演"的字面呈现。

锚点:两图如何连成一张网
资产图与探索图各自独立存储,靠 anchor(锚点) 相连:exploration_anchors(node_id, asset_id) 把意图/事实/漏洞锚定到具体资产上,于是查询可以是双向的:
- 从探索方向看:这条意图打的是哪些资产;
- 从某个资产反查:它在本任务被哪些意图测过、得出过哪些事实与漏洞。
这直接支撑了两个实用功能:
- 资产测试覆盖度:统计范围内资产"已测/未测"比例(Coverage 的计算逻辑);
- 资产覆盖图:把范围内资产画成一张力导向图,已测节点高亮、未测节点置灰——planner 和人都能一眼看出"还有哪块没碰",避免重复劳动,也避免漏测(BuildCoverageGraph)。

AI 自主推演闭环:planner 派意图,worker 写回双图
双图不是静态展示,而是一个事件驱动的闭环(引擎实现见 server/engine.go):
- 唤醒:双图任意一张发生变化(防抖后)唤醒 planner;
- 读态势:planner 用
graph_overview读探索图——资产计数、frontier、未覆盖方向(graph_overview 工具),并只看本任务的探索节点;资产图全局共享,多任务同一份; - 派意图:只在有未覆盖的新方向时派 0..N 个 intent 进 frontier——大多数唤醒派 0 个,无新方向即收敛;
- 执行与写回:worker 领一条意图,用真实工具执行,把新资产写进资产图(
insert_assets)、把事实/漏洞写进探索图(record_fact / report_finding); - 再唤醒:写回触发下一轮,直到目标被
proves证明、或再无新方向。

值得强调的是职责边界:planner 是唯一意图生成者,只读态势、不执行;worker 只看领到的那一条意图,执行完写回两图即停。信息在 worker 之间还能以"执行过程"为粒度流动(search_all_worker_traces 检索他人步骤),而边界不变。配合 planner 跨轮共享的规划待办(todolist),多步利用链(发现注入点 → 取凭据 → 横向 → 提权)能按依赖逐步推进、不重复、不错序——这是 ARTEX 能自主走完攻击路径的关键。
在哪里看到双图(界面与源码位置)
- 任务详情页签:「测试资产」管资产、「资产覆盖图」看覆盖、「探索路径」看完整血缘链(任务详情/function/tasks/detail/page.tsx#L60-L61));
- 漏洞详情页的血缘视图:展示从任务起点到该漏洞的子图(lineage.tsx/function/findings/detail/lineage.tsx));
- 后端 API:
GET /api/exploration/graph返回整条探索链的 nodes+edges(server.go),覆盖图见 taskCoverageGraph; - 双图落库:exploration.go(探索图节点/边/锚点)、assets.go(资产图)、task_scope.go(范围与覆盖图),建表语句在 schema.sql。
小结与安全须知
| 图 | 作用域 | 节点 | 边 |
|---|---|---|---|
| 资产图 | 全局共享 | 域名/子域/IP/服务/应用/端点 | 父子包含 |
| 探索图 | 每任务独立 | 目标/意图/事实/漏洞/提示 | spawns/derived_from/yields/proves |
一句话总结:资产图是"测到什么"的真值库,探索图是"怎么想的"推进链,锚点把两者焊成一张网——planner 与 worker 围绕双图形成闭环,AI 的每一步推演都留痕、可追溯、可反查。
🔒 ARTEX 的 agent 可执行 shell 命令并发送真实网络流量,请务必只在自有系统或书面授权的隔离环境中验证。本仓库是基于审计过的 v0.3.15 源码构建的 FailSafe 发行版(控制台绑定 localhost、不发布代理端口),可参考 audit/artex-v0.3.15-audit.md 与 docker-compose.safe.yml 了解部署加固细节。