EntroVyx/hermes-agent-offsec

# Hermes Agent Offsec ☤

Repository | Desktop App

**Hermes Agent Offsec** 与原始的 [Hermes Agent](https://github.com/NousResearch/hermes-agent) 并非同一产品。 原始的 Hermes 是一款通用型个人 AI agent。Hermes Agent Offsec 保留了其强大的多面基础，但围绕授权的攻击性安全重塑了操作员体验：漏洞赏金、渗透测试、侦察、手动测试、漏洞链利用、目标档案以及可报告的证据。 此 fork 是在 Hermes Agent 的基础上公开构建的。它不是抄袭镜像，也不是对上游的盲目重新上传。区别在于使命：**原始的 Hermes 是广泛的 AI 助手；而 Hermes Agent Offsec 是专为影响驱动型狩猎构建的攻击性安全操作员。** ## 有何不同 Hermes Agent Offsec 增加了以攻击性安全优先的工作流层： - **核心资产狩猎**：从最高价值的影响开始，而不是通用的检查清单。 - **深度手动攻击模式**：专注于业务工作流，如恢复、计费、GraphQL、导入、导出、角色、支持、AI/RAG 和竞态条件。 - **持久化目标档案**：跨会话保留参与者、对象族、状态、请求映射、假设、证据和漏洞链候选。 - **HAR/Burp 请求导入**：将捕获的流量转化为 endpoint 集群、高风险参数、对象 ID 和建议的攻击模式。 - **可视化漏洞链引擎**：每个原语都朝着 `原语 -> 支点 -> 影响` 的方向推进。 - **攻击性安全技能库**：涵盖侦察、Web2/Web3、云、CI/CD、OAuth/SAML、GraphQL、SSRF、IDOR、业务逻辑、移动端、AI、报告和验证技能。 核心理念很简单：扫描器发现的是攻击面；而 Hermes Agent Offsec 试图像手动狩猎者一样进行推理。 ## 攻击模式 在 `hermes` 中，使用以下的斜杠模式： ``` /crown-jewel /target-dossier /request-import /deep-hunt /attack-chain ``` 推荐流程： ``` /crown-jewel example.com /target-dossier example.com /request-import traffic.har /deep-hunt billing /attack-chain "refund succeeds while entitlement stays active" ``` 实用的深度狩猎工作流： ``` recovery, invite, billing, graphql, import, export, roles, support, ai, race, oauth, saml, upload, webhook, generic ``` 各模式的功能说明： - `/crown-jewel` 选择最高影响的目标：ATO、租户越权、财务影响、数据泄露、CI/CD 沦陷、云/控制平面访问或 AI/RAG 泄露。 - `/target-dossier` 创建或更新 `.offsec/campaigns//TARGET.md`、`CAMPAIGN.md`、`request-map.md`、`chains/`、`evidence/` 和 `imports/`。 - `/request-import` 解析 HAR 或原始 Burp/Caido 请求，并提取方法、路径、参数、认证凭据、对象 ID 候选项和建议的深度狩猎模式。 - `/deep-hunt` 跨越参与者、对象、状态、结构、时间和副作用边界攻击单个工作流。 - `/attack-chain` 将原语转换为可视化的漏洞链卡片，包含缺失的证明、下一步的支点、可链性评分和可报告方向。 ## 快速安装 ### Linux、macOS、WSL2 ``` git clone https://github.com/EntroVyx/hermes-agent-offsec.git cd hermes-agent-offsec curl -LsSf https://astral.sh/uv/install.sh | sh uv venv ~/.hermes/venvs/hermes-offsec --python 3.11 source ~/.hermes/venvs/hermes-offsec/bin/activate uv pip install -e ".[all]" hermes setup hermes ``` ### Windows (原生, PowerShell) ``` git clone https://github.com/EntroVyx/hermes-agent-offsec.git cd hermes-agent-offsec py -3.11 -m pip install uv uv venv $HOME\.hermes\venvs\hermes-offsec --python 3.11 & "$HOME\.hermes\venvs\hermes-offsec\Scripts\Activate.ps1" uv pip install -e ".[all]" hermes setup hermes ``` ## 入门指南 ``` hermes # Interactive CLI — start a conversation hermes model # Choose your LLM provider and model hermes tools # Configure which tools are enabled hermes config set # Set individual config values hermes gateway # Start the messaging gateway (Telegram, Discord, etc.) hermes setup # Run the full setup wizard (configures everything at once) hermes claw migrate # Migrate from OpenClaw (if coming from OpenClaw) hermes update # Update to the latest version hermes doctor # Diagnose any issues ``` `/update` 和 `hermes update` 现在会遵循此 fork 自身的仓库和安装程序路径。 ## 示例会话 ``` hermes > /crown-jewel acme.example > /target-dossier acme.example > /request-import ./traffic/acme.har > /deep-hunt recovery > /attack-chain "stale invite token can be redeemed after role change" ``` Agent 应当维护档案、更新假设、避免重复死胡同，并不断推动弱原语朝向具体的业务影响。 ## 文档 所有内容均位于 [`website/docs`](https://github.com/EntroVyx/hermes-agent-offsec/tree/main/website/docs)。 - [快速开始](https://github.com/EntroVyx/hermes-agent-offsec/tree/main/website/docs/getting-started/quickstart.md) - [配置](https://github.com/EntroVyx/hermes-agent-offsec/tree/main/website/docs/user-guide/configuration.md) - [CLI 使用](https://github.com/EntroVyx/hermes-agent-offsec/tree/main/website/docs/user-guide/cli.md) - [工具、技能和 MCP](https://github.com/EntroVyx/hermes-agent-offsec/tree/main/website/docs/user-guide/features) - [架构与贡献](https://github.com/EntroVyx/hermes-agent-offsec/tree/main/website/docs/developer-guide) ## 故障排除 关于平台特性、围绕 `uv` 的杀毒软件误报以及更多边缘情况的安装修复，除了此 fork 的文档外，请查阅原始 Hermes 文档和 README： - [Hermes 原始仓库](https://github.com/NousResearch/hermes-agent) - [Hermes Agent Offsec 文档](https://github.com/EntroVyx/hermes-agent-offsec/tree/main/website/docs) ## 许可证 MIT — 见 [许可证](LICENSE)。 由 [EntroVyx](https://github.com/EntroVyx) 维护。

标签：AI安全工具, XXE攻击, 密码管理, 文档结构分析, 自动化侦察, 逆向工具