Hercules是全球首个开源测试代理，无需编写代码或维护即可实现UI、API、安全、无障碍和视觉验证，让测试自动化变得简单高效。
一分钟了解#
Hercules是一个革命性的开源测试代理，它将简单的Gherkin步骤转换为完全自动化的端到端测试，无需编写任何代码。无论您是在处理像Salesforce这样的复杂平台，还是在CI/CD管道中运行测试，Hercules都能适应您的需求并处理所有细节。它为每个团队提供了一个"测试英雄"，使高质量的测试自动化民主化，不再局限于精英团队。
核心价值：让测试自动化变得简单可靠，无需编程技能即可创建和维护复杂的测试套件。
快速上手#
安装难度：中 - 需要Python环境和一些配置
# 安装Hercules
pip install testzeus-hercules
# 安装Playwright及其依赖
playwright install --with-deps
适合我的场景吗？
- ✅ 复杂Web应用测试：特别是频繁变化和功能复杂的平台
- ✅ CI/CD集成：可以无缝集成到现有开发流程中
- ✅ 跨平台测试：支持Salesforce等难以测试的平台
- ❌ 简单静态网站：对于非常简单的网站可能过于复杂
核心能力#
1. 无代码测试执行 - 解决测试脚本维护难题#
- 将简单的Gherkin步骤转换为完全自动化的端到端测试，无需编写任何代码 实际价值：大幅降低测试维护成本，使非技术人员也能创建测试用例
2. 多类型测试支持 - 解决全面质量保障需求#
- 支持UI、API、安全、无障碍和视觉验证等多种测试类型 实际价值：一站式解决所有质量测试需求，无需使用多种测试工具
3. 自然语言测试 - 解决技术门槛问题#
- 允许使用自然语言编写测试用例，然后由AI转换为可执行测试 实际价值：使业务分析师和产品经理也能参与测试用例创建
4. Python沙箱执行 - 解决复杂测试场景需求#
- 在Gherkin测试中直接执行自定义Python脚本，提供完整的Playwright API访问 实际价值：处理复杂业务逻辑和高级选择器策略，实现更灵活的测试自动化
5. 多AI模型支持 - 解决成本和灵活性需求#
- 支持多种AI模型，包括OpenAI、Anthropic、Gemini等，可根据需求选择 实际价值：优化成本的同时保持测试质量，适应不同预算和需求
技术栈与集成#
开发语言：Python 主要依赖：Playwright、多种AI模型API 集成方式：CLI工具、Python库
维护状态#
- 开发活跃度：高 - 项目有持续更新和功能增强
- 最近更新：近期有新功能发布，包括Python沙箱执行和多AI模型支持
- 社区响应：积极维护Slack社区，提供详细视频教程和文档
文档与学习资源#
- 文档质量：全面 - 提供详细的安装指南、配置选项和API文档
- 官方文档：GitHub仓库中的README和运行指南
- 示例代码：提供完整的测试用例示例和Python脚本示例
使用指南#
基本运行命令#
testzeus-hercules --input-file opt/input/test.feature --output-path opt/output --test-data-path opt/test_data --llm-model gpt-4o --llm-model-api-key sk-proj-xxxxxxx
主要参数说明#
--input-file: Gherkin特性文件路径--output-path: 输出目录路径（包含结果和报告）--test-data-path: 测试数据目录路径--project-base: 项目基础目录路径（可选）--llm-model: 使用的AI模型名称（推荐gpt-4o）--llm-model-api-key: AI模型API密钥
环境变量配置#
BROWSER_TYPE: 浏览器类型（chromium、firefox、webkit）HEADLESS: 是否以无头模式运行（true/false）BROWSER_RESOLUTION: 浏览器分辨率（格式：宽度,高度）RECORD_VIDEO: 是否录制测试视频（true/false）TAKE_SCREENSHOTS: 是否截取测试截图（true/false）