由 LLM 驱动的安全测试代理,针对目标运行持续的工具调用循环,内置 160+ 个侦察、Web、云、AD 和后渗透工具适配器,并持久化保存运行报告。
一个由 LLM 驱动的安全测试代理:单一连续的 tool-calling 循环,而非分阶段的 recon→exploit 流水线。模型逐轮决定下一步 运行什么,针对真实目标。
免责声明: 如果配置不当,Tradecraft 中的工具可能造成 永久性损害。仅对你拥有或获得明确许可测试的目标使用它。 不要依赖默认值——在首次行动前理解 配置(
docs/tools.md、docs/policy.md、docs/profiles.md)。
Tools 是模型可以调用的动作——每一个都是一个 YAML 契约
(它做什么、需要什么输入)加上一个适配器,该适配器执行
真实命令并将其输出解析为结构化数据。参见
docs/tools.md 了解工具如何构建,或查看
已注册工具的完整列表——涵盖 recon、web、cloud、AD、
Kubernetes 和 post-exploitation 的 160+ 个工具——见 docs/tool-list.md。
Skills 是提供建议的 markdown 笔记,为模型提供跨工具的
tradecraft 知识——何时优先选择某个工具而非另一个、两个
工具的输出如何串联。它们从来不是强制阶段,
并且始终完整呈现。参见 docs/skills.md。
每次行动运行都会持久化到磁盘,并且可以转换为
报告(--report)、之后在问答控制台(tradecraft chat)中探索,或导出为 SFT/DPO 微调数据(tradecraft dataset)。
参见 docs/report.md、docs/post-engagement.md
和 docs/finetune.md。
config/tools/<id>.yaml model-facing contract (description, params, scope_param)
config/profiles/ curated tool sets per engagement shape (web, cloud, ad-network, ...)
tradecraft/domain.py pure shared types
tradecraft/adapters/<tool>/ execute.py (subprocess) + parse.py (pure parsing)
tradecraft/tools/ glues a YAML contract + adapter into one Tool.run()
tradecraft/memory/ append-only engagement log, facts, and evidence store
tradecraft/policy/ destructive-tool gate
tradecraft/skills/ advisory tradecraft markdown, rendered in full
tradecraft/execution/ the agentic loop + system-prompt assembly
tradecraft/reporting/ report generation + post-run investigation console
tradecraft/dataset/ offline SFT/DPO dataset extraction from persisted runs
tradecraft/cli.py entrypoint
依赖方向是单向的:domain → adapters → tools → execution → cli。
python -m venv .venv && source .venv/bin/activate
pip install -e ".[test]"
cp .env.example .env # configure LLM_MODEL, LLM_BASE_URL, and LLM_API_KEY
为 LLM_MODEL 使用一个 abliterated(已移除安全拒绝)模型——标准的安全对齐模型会在交战过程中拒绝本 agent 需要执行的大部分操作。
每个工具所需的二进制文件(见其 config/tools/<id>.yaml)必须位于 PATH 中;缺失的二进制文件会作为工具错误返回给模型,而不是导致崩溃。scripts/verify_container_tools.py 会检查已注册工具中哪些二进制文件存在。若想获得一个已知可用的完整工具集而无需自行安装所有内容,请参阅 docs/setup.md 以了解如何构建和运行 Docker 镜像。
tradecraft 10.0.0.5 --profile web
--profile 会为交战形态选择一套精选工具集(web、ad-network、cloud、kubernetes、post-exploitation,或 full 表示所有已注册工具);--tools 会用显式列表覆盖它。破坏性工具默认关闭——传入 --allow-destructive 以启用它们。运行 tradecraft --help 查看完整标志列表,或参阅 docs/cli.md 一览所有子命令(chat、report、dataset、memory)。
网络路由/出口(VPN、SOCKS/TUN 网关,或容器 network_mode)在环境层处理,而非在适配器内部处理;如果设置 HTTP_PROXY/HTTPS_PROXY,请将 LLM_BASE_URL 主机添加到 NO_PROXY。
pytest
docs/cli.md —— 一览所有 tradecraft 子命令与参数。docs/setup.md —— 构建/运行 Docker 镜像、获取日志、提取运行数据。docs/tools.md —— 工具、适配器。docs/tool-list.md —— 一览所有已注册工具。docs/policy.md —— 破坏性工具门控、影响范围类别、账户锁定预算。docs/skills.md —— 什么是 skill,如何/何时添加。docs/profiles.md —— 交战形态 profile、重叠、如何添加。docs/report.md —— 从一次运行生成报告。docs/post-engagement.md —— 运行后问答控制台。docs/finetune.md —— 将交战运行转化为 SFT/DPO 微调数据。CONTRIBUTING.md —— 如何添加新工具。