cskwork/scopeweaver

ScopeWeaver – AI 驱动的多智能体渗透测试平台

简介

• 一个开源系统，允许大语言模型 (LLMs) 作为自主安全测试智能体运行。它结合了 Go 后端、Next.js 前端和 PostgreSQL 存储。
• 作为 ARTEX 项目（上游提交 160fe13）的分支构建，已重新命名并翻译为英语、韩语和简体中文。

核心功能

• LLM 驱动的智能体：规划器生成攻击步骤，工作节点执行这些步骤（例如运行 nmap、curl、自定义脚本），同时“主智能体”允许人工干预。
• 双图数据模型：资产图（目标、域名、IP）和 探索图（发现的节点、活动），智能体可以通过 LLM 暴露的工具进行查询。
• 审批工作流：潜在的危险操作（例如运行漏洞利用）由“拦截审批”UI 组件进行门控，复用了 AegisHook 设计。
• 资产同步：可以直接从配套的 ScopeSentry 服务导入范围。
• LLM 提供商灵活性：通过可配置的 API 密钥支持 Anthropic、OpenAI 和 Z‑AI 的 GLM‑5.3。
• 内置编码智能体集成：Claude Code、Codex 或 Pi 可以通过提供的适配器创建任务、读取进度并控制智能体。
• 实时事件流：任务通过服务器发送事件 (SSE) 或可流式传输的 HTTP 发送进度，实现实时仪表板。

安装选项

方法	功能
一键脚本 (./install.sh)	检测 Docker，允许您在 Docker 中运行所有内容 或 构建本地二进制文件，创建 .env 并在 http://localhost:8787 启动服务。
Docker Compose (手动)	在本地构建镜像，启动 PostgreSQL 容器，挂载 ./skills 和 ./data。
预构建二进制文件 (Releases)	下载适用于您操作系统的 zip 包，运行 ./start.sh（处理更新的守护进程）。
从源码构建	编译 Go 后端并自行嵌入 Next.js 静态文件。
跨平台发布构建器 (./build.sh --release)	为 Linux、macOS 和 Windows 生成自包含的 zip 压缩包。

运行系统

1. 确保 PostgreSQL 实例可访问（默认数据库名称 artex）。
2. 提供 LLM API 密钥（ANTHROPIC_API_KEY 或 OPENAI_API_KEY）——可以通过环境变量或 UI 提供。
3. 打开 Web UI http://localhost:8787；首次访问将引导您完成管理员密码设置。
4. 使用 LLM → New 表单创建渗透测试任务，选择模型，并让智能体探索导入的资产范围。
5. 通过 Approval records 视图批准任何标记的操作；结果将显示在 Findings 页面中。

更新

• 应用内一键更新检查 GitHub 发布版本，验证 SHA‑256 校验和，对二进制文件进行冒烟测试并原子化替换。如果重复失败，将自动回滚。
• CLI 脚本（./update.sh 或 Docker‑compose 重建）提供手动替代方案。

配置要点

• 通过 config.json 或 ARTEX_PG_DSN 环境变量进行数据库连接。
• LLM 提供商设置（ARTEX_LLM_PROVIDER、ARTEX_LLM_MODEL 等）可以在每个任务中覆盖。
• 并发性（每个任务的工作智能体数量）可在 System settings 中调整（默认为 3）。
• 流量捕获代理运行在端口 8788；智能体可以访问该端口进行 MITM 检查。

开发

• ./dev.sh 启动后端、代理和带有热重载的 Next.js 开发服务器。
• 使用 go test ./... 运行测试。
• 代码库遵循 norma SDK 关于智能体、工具和内存的约定。

许可与免责声明

• 根据 AGPL‑3.0 分发（与上游 ARTEX 相同）。README 强调该工具仅用于授权的安全测试；禁止滥用。

适用人群

• 希望通过 LLM 驱动的自动化增强手动渗透测试的安全团队。
• 探索自主攻击链生成的研究人员。
• 寻找 Go 语言中 LLM 多智能体编排参考实现的开发人员。

---

以上所有信息均直接取自存储库的 README；未添加任何外部假设。