这是什么

Hemlock 不是"抓包工具 + AI 插件"的简单拼装，而是从零以 Agent 为核心设计的全栈一体化渗透测试工具：

• 对小白友好——不需要先懂渗透，装好、配好 LLM Key、说一句「帮我测试 https://xxx.com」，Agent 就自动完成 侦察 → 测试 → 验证 → 报告 全流程
• 对专业不妥协——Agent 全程可中断、可干预、可深查；抓包代理、Repeater、Intruder、漏洞管理都在同一应用内闭环
• 人工验证闭环——每个漏洞都带原始请求/响应证据，规则验证 + 三态语义判定帮你过滤误报，关键结论随时可人工复核，AI 不背锅、你说了算

🚀 三步上手

1. 装：下载安装包，双击安装（Windows x64）
2. 配：设置页填入 LLM API Key（DeepSeek / OpenAI / 通义都行）
3. 测：创建项目，说一句「帮我测试 https://xxx.com」

Agent 跑起来，你只需要看着它干活、在关键节点点头放行、最后复核结论。

🏆 核心技术优势

1. ReAct 自主编排引擎（43 个内置工具）

• 工具链覆盖 侦察 / 测试 / 验证 / 报告 全阶段：send_request、run_intruder、verify_vulnerability、report_finding、fuzz_paths、analyze_js、run_command…
• N-day 漏洞情报：识别出组件+版本（如 nginx 1.18.0）可 load_tools 后查已知漏洞（cve_lookup）+ 联网搜利用细节（web_search）——先思考后查证，大多数测试靠推理不联网
• 工具按需加载：30 个核心工具（HTTP 主循环）始终注入，14 个发现 / 文件类工具（含 cve_lookup/web_search）通过 load_tools 按需启用——用户说一句话不会全量塞满工具定义
• 支持工具结果自动化蒸馏：超大 HTTP 输出按需截断 + 摘要压缩，保留 flow_id 等关键引用，Agent 可随时深查，省 Token 不伤判断力
• 预留 200 次工具调用上限作为防死循环兜底，长流程测试（弱口令爆破等）不被硬切

2. 上下文智能管理（缓存友好的 system 拆分 + 索引 + 渐进式压缩）

• 缓存友好的 system 拆分：system prompt 拆为「稳定段 + 动态段」两条消息——稳定段（角色设定 + 渗透策略）逐字节不变，位于缓存断点之前，命中 Anthropic 显式断点 / DeepSeek-OpenAI 自动前缀缓存；动态段（技能索引 + MCP 列表 + 长期记忆）位于断点之后，改动不影响稳定前缀
• 确定性索引排序：技能 / 记忆索引按名称确定性排序，集合不变时注入文本逐字节一致——「没变就是没变」，缓存不会因排列不同而失效
• 记忆放在 system 内、断点之外：长期记忆留在 system（auto-compact 永不压缩），又位于缓存断点之后（技能/记忆增删不影响缓存命中）
• 索引 + 按需：技能 / 记忆只向 Agent 注入「名称 + 描述」索引，完整内容按需读取（get_memory / invoke_skill）
• 渐进式压缩：Session Memory 免费摘要 → LLM 驱动 AutoCompact → 确定性压缩兜底，熔断自动回退，绝不让长任务断链
• checkpoint 断点续跑：任务每 3 步自动保存快照，崩溃后重跑同一任务自动从断点续跑
• 可量化的成本优势：同一渗透任务跑 60 轮，普通 Agent（技能全文全塞 + 历史全量重发 + 无缓存优化）累计输入约 26.4 元；Hemlock 靠上面整套策略（渐进式披露 + 前缀稳定 + 截断/蒸馏 + 渐进压缩）降到约 0.16 元——省约 169 倍。详见 docs/context-management-cost.md

3. 多 Agent 协作（5 个内置角色）

• 侦察员 / 攻击手 / 验证员 / 情报员 / 报告员 共享渗透测试上下文
• Coordinator 编排全流程，每个子 Agent 专职一块，像一支真实渗透小队

4. 漏洞证据链闭环

• 每个漏洞附带原始请求/响应包作为证据
• 三态语义判定漏洞验证器 + 7 种验证方法，区分真漏洞与误报
• 支持自动复测（retest）确认修复状态

5. 人在环安全控制

• 敏感操作（DoS / 注入 / RCE / 数据删除）强制人工确认，300s 超时自动拒绝
• 明确区分"Agent 能碰什么、必须你点头才碰什么"

6. 渐进式技能披露（99 个内置安全技能）

• system prompt 只注入技能名称 + 简短描述，完整指令按需加载
• 技能库覆盖：Web 漏洞（SQLi/XSS/SSRF/SSTI/反序列化…）、系统渗透（提权/横向/域渗透）、密码学、云原生、移动安全等

🎯 核心功能优势

快速开始

方式一：安装包（推荐）

1. 下载 Hemlock_x.x.x_x64-setup.exe 并安装
2. 设置页配置 LLM API Key（DeepSeek / OpenAI / 通义 等均可）
3. 启动抓包代理（默认 8080），浏览器配置代理并安装 mitmproxy CA 证书
4. 创建项目，开始抓包或与 Agent 对话

方式二：开发模式

# 后端
cd backend
python -m virtualenv .venv && .\.venv\Scripts\activate
pip install -e ".[dev]"
cp .env.example .env   # 编辑配置 LLM API Key
python -m hemlock.cli

# 前端
cd frontend
npm install && npm run dev

• API：http://127.0.0.1:9876（文档 /docs）
• 抓包代理：127.0.0.1:8080
• 前端：http://localhost:5173

打包桌面应用

powershell -ExecutionPolicy Bypass -File build.ps1

技术栈

文档

• 技术文档：系统架构、Agent 实现、渗透测试引擎（9 章）
• 上下文管理设计
• 部署指南
• 变更日志

测试

cd backend && .\.venv\Scripts\python.exe -m pytest -v

贡献

欢迎提交 Issue 和 PR，详见 贡献指南。

联系我们

有问题、建议或合作需求，欢迎联系：

📧 邮箱：[email protected]

致谢

借鉴并致敬了 Burp Suite、Nuclei、mitmproxy、Claude Code 等优秀项目，详见 致谢清单。

免责声明

Hemlock 仅供安全研究和授权测试使用。使用者需确保已获得目标系统的合法授权，并遵守当地法律法规。对未经授权的测试行为，开发者不承担任何责任。

License

MIT