【免费下载链接】cain-agentReal-world AI penetration testing engineer for authorized assessments — built-in cloud module covering AWS/Azure/GCP Aliyun/Tencent/Huawei clouds. Built on Claude Agent SDK项目地址https://gitcode.com/gh_mirrors/ca/cain-agent点击查看免费下载cain-agent 是一个面向真实授权安全评估的实战型 AI 渗透测试工程师AI Penetration Testing Engineer基于 Claude Agent SDK 构建内置覆盖 AWS / Azure / GCP / 阿里云 / 腾讯云 / 华为云 的云渗透模块。无论你是想亲手跑通它的第一次授权测试还是准备为这个开源项目提交第一个 PR这份 cain-agent 开发者快速上手指南都能帮你在半小时内走完「克隆 → 安装 → 本地三绿 → 提交 PR」的完整路径。⚠️ 先划重点cain-agent 仅用于已获授权的安全测试。贡献与使用都必须遵守这一边界详见 docs/community.md。一、5 分钟完成克隆与安装最快上手步骤1. 克隆仓库并 editable 安装cain-agent 要求Python ≥ 3.11见 pyproject.toml。克隆后建议用 editable 模式安装方便你直接改源码调试git clone https://gitcode.com/gh_mirrors/ca/cain-agent cd cain-agent pip install -e . # 或用 uv: uv pip install -e .按需启用可选组件pip install -e .[cloud] # 可选AWS S3 / 华为 OBS / Kubernetes 检测 pip install -e .[dev] # 可选ruff / pyright / pytest 开发工具链 如果你使用 pi 执行后端还需要 Node.js ≥ 20 并一次性安装桥依赖npm ci --prefix toolchain/pi说明见 toolchain/pi/README.md。2. 验证安装一行命令确认版本cain-agent --version # 输出形如cain-agent 0.2.0看到版本号即安装成功。CLI 入口定义在 src/cain_agent/cli.py。3. 第一次运行先用 dry-run 预览执行计划不必急着真跑。--dry-run会打印目标 / 工作区 / 阶段计划 / 后端配置但不启动任何 Agent是理解 cain-agent 三阶段流水线recon → test → report的最低成本方式cain-agent run --target https://app.example.com --dry-run正式运行时目标会写入scope.yaml并在每次工具调用前被 PreToolUse 钩子强制校验——范围控制是工程强制的不依赖模型自觉。完整参数与输出产物说明见用户指南 docs/usage.md。二、读懂项目结构贡献前先熟悉这张地图目录 / 文件作用贡献新手关注度src/cain_agent/核心源码CLI、编排器、门禁、报告⭐⭐⭐skills/技能知识库OWASP Top 10 各云攻击面⭐⭐⭐tests/100 测试文件含技能格式校验⭐⭐⭐bench/自建 vulnerable-terraform 靶场与基准评测⭐⭐toolchain/pi/pi 执行后端的 Node 桥⭐docs/用户指南、社区指引、技能编写规范⭐⭐⭐其中几个高频接触的核心模块src/cain_agent/orchestrator.py — 确定性状态机驱动 recon → test → reportsrc/cain_agent/gates.py — 覆盖率退出门等「验证纪律」纯函数src/cain_agent/cloud/ — 七大云厂商检测模块aliyun_oss.py、aws_s3.py、huawei_obs.py等。三、提交前的「本地三绿」cain-agent 开发环境标准流程1. 一键配置开发环境pip install -e .[dev,cloud]这一条命令装齐 lint、类型检查、测试与云依赖与 CI 保持一致CI 工作流见 .github/workflows/ci.yml。2. 提交前本地三绿社区约定docs/community.md要求 PR 提交前在本地跑通ruff check src tests # 1. 代码风格 pytest -q # 2. 全量测试 python -m bench.run_benchmark --suite vuln-tf \ --output /tmp/bench.md # 3. 涉及检测逻辑时当前测试基线已 1000 用例全绿演进记录见 CHANGELOG.md新增逻辑必须有测试修 bug 时先写复现测试再修。3. 分支命名与提交约定从main拉独立分支命名规范feat/主题/fix/主题/test/主题。commit 使用真实姓名 noreply 邮箱。四、你的第一个 PR从 Issue 到合入的完整流程第一步提 Issue选对模板仓库提供三套 Issue 模板.github/ISSUE_TEMPLATE/模板适用场景必填信息bug_report复现行为异常版本cain-agent --version、复现步骤、期望 vs 实际行为feature_request新能力 / 改进使用场景、为什么现有能力不够security_issue检测规则 / 脱敏 / scope 缺陷⚠️ 不要公开描述可利用细节走 Security Advisory 私下报告通用要求一个 Issue 一个主题先搜索是否已有同类标题一句话说清问题。第二步开发并跑通「本地三绿」第三步写好 PR 描述PR 模板.github/pull_request_template.md固定四个问题逐条回答即可改了什么— 改动清单为什么— 动机与背景怎么验证的— 附本地三绿输出安全语义影响— scope / 只读约束 / 双会话校验是否受影响不受影响请注明。第四步等待 review涉及安全语义scope、只读约束、finder≠validator 双会话校验的改动会被重点审查这是该项目质量护城河的一部分请对较长的 review 周期保持耐心。五、新手友好四类高价值贡献方向1. 新增一个技能SKILL.md⭐ 最推荐技能是 cain-agent 的知识单元放在skills/分类/技能名/SKILL.md。编写规范有统一模板且由测试强制校验——写完跑一次pytest tests/test_skill_format.py绿了才算达标。要点详见 docs/skill-authoring-guide.mdfrontmatter 四字段齐全正文必含「触发条件 / 三层测试模型L1 探测 → L2 验证 → L3 绕过/ 证据要求 / 禁止事项」四节。可参考已落地的 skills/web/sqli/ 等 13 个 OWASP Top 10 技能。2. 修 Bug从 Issue 里挑good first issue类的行为异常先写复现测试再修复附ruffpytest输出提 PR。3. 云模块扩展src/cain_agent/cloud/ 下各厂商模块结构清晰新增检测逻辑需同步补测试并保持「零凭证」——测试与 fixture 一律 mock不出现真实 AK/SK/token。4. 文档完善面向用户的行为变更需同步更新 README.md 与 README.zh-CN.md。中文文档的贡献门槛最低非常适合作为第一个 PR。六、合规红线安全测试项目贡献者必读 不在 Issue / PR / 讨论中粘贴真实凭证、内网拓扑或未脱敏证据 不测试未授权目标——任何贡献讨论都围绕授权测试场景展开 检测到检测绕过、凭证泄露、scope 逃逸类问题不要开公开 Issue走仓库 Security → Report a vulnerability 私下报告72 小时内响应 单元测试不得依赖外网零触网新增第三方依赖需在 PR 中说明理由。 想了解项目下一步做什么查看任务看板 ROADMAP.md 与近期交付记录 CHANGELOG.md从中找未勾选的条目就是你的下一个 Issue。下一步行动清单克隆并pip install -e .[dev,cloud]跑通cain-agent --version--dry-run看一遍执行计划读懂 docs/usage.md在 docs/community.md 对照贡献约定从修文档或补一个SKILL.md开始你的第一个 PR。祝你在 cain-agent 社区写出漂亮的第一个 PR 赞分享【免费下载链接】cain-agentReal-world AI penetration testing engineer for authorized assessments — built-in cloud module covering AWS/Azure/GCP Aliyun/Tencent/Huawei clouds. Built on Claude Agent SDK项目地址https://gitcode.com/gh_mirrors/ca/cain-agent点击查看免费下载相关推荐从克隆声音到贡献代码OpenVoice社区贡献者成长指南从克隆声音到贡献代码OpenVoice社区贡献者成长指南 你是否曾想过参与开源项目却被复杂的贡献流程吓退作为MyShell AI开源的即时语音克隆技术O人工智能语音音频深度学习1小时上手GitHub社区贡献从克隆到PR的新手通关指南1小时上手GitHub社区贡献从克隆到PR的新手通关指南 你是否在开源社区门外徘徊看着别人提交PRPull Request拉取请求却不知从何下手本文教程PMD 新手贡献者指南从克隆仓库到合并第一个 Pull Request 的完整流程PMD 新手贡献者指南从克隆仓库到合并第一个 Pull Request 的完整流程 本篇指南以 PMD 官方为 GSoC 学生和新贡献者编写的入门文档为主线静态分析代码质量上一篇MDN学习区深入理解JavaScript ES2015类继承机制下一篇Material Components Web 的 Tab Indicator 组件完全指南安装、动画原理与定制创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 从克隆到第一个 PR：cain-agent 开发者快速上手与社区贡献指南
【免费下载链接】cain-agentReal-world AI penetration testing engineer for authorized assessments — built-in cloud module covering AWS/Azure/GCP Aliyun/Tencent/Huawei clouds. Built on Claude Agent SDK项目地址https://gitcode.com/gh_mirrors/ca/cain-agent点击查看免费下载cain-agent 是一个面向真实授权安全评估的实战型 AI 渗透测试工程师AI Penetration Testing Engineer基于 Claude Agent SDK 构建内置覆盖 AWS / Azure / GCP / 阿里云 / 腾讯云 / 华为云 的云渗透模块。无论你是想亲手跑通它的第一次授权测试还是准备为这个开源项目提交第一个 PR这份 cain-agent 开发者快速上手指南都能帮你在半小时内走完「克隆 → 安装 → 本地三绿 → 提交 PR」的完整路径。⚠️ 先划重点cain-agent 仅用于已获授权的安全测试。贡献与使用都必须遵守这一边界详见 docs/community.md。一、5 分钟完成克隆与安装最快上手步骤1. 克隆仓库并 editable 安装cain-agent 要求Python ≥ 3.11见 pyproject.toml。克隆后建议用 editable 模式安装方便你直接改源码调试git clone https://gitcode.com/gh_mirrors/ca/cain-agent cd cain-agent pip install -e . # 或用 uv: uv pip install -e .按需启用可选组件pip install -e .[cloud] # 可选AWS S3 / 华为 OBS / Kubernetes 检测 pip install -e .[dev] # 可选ruff / pyright / pytest 开发工具链 如果你使用 pi 执行后端还需要 Node.js ≥ 20 并一次性安装桥依赖npm ci --prefix toolchain/pi说明见 toolchain/pi/README.md。2. 验证安装一行命令确认版本cain-agent --version # 输出形如cain-agent 0.2.0看到版本号即安装成功。CLI 入口定义在 src/cain_agent/cli.py。3. 第一次运行先用 dry-run 预览执行计划不必急着真跑。--dry-run会打印目标 / 工作区 / 阶段计划 / 后端配置但不启动任何 Agent是理解 cain-agent 三阶段流水线recon → test → report的最低成本方式cain-agent run --target https://app.example.com --dry-run正式运行时目标会写入scope.yaml并在每次工具调用前被 PreToolUse 钩子强制校验——范围控制是工程强制的不依赖模型自觉。完整参数与输出产物说明见用户指南 docs/usage.md。二、读懂项目结构贡献前先熟悉这张地图目录 / 文件作用贡献新手关注度src/cain_agent/核心源码CLI、编排器、门禁、报告⭐⭐⭐skills/技能知识库OWASP Top 10 各云攻击面⭐⭐⭐tests/100 测试文件含技能格式校验⭐⭐⭐bench/自建 vulnerable-terraform 靶场与基准评测⭐⭐toolchain/pi/pi 执行后端的 Node 桥⭐docs/用户指南、社区指引、技能编写规范⭐⭐⭐其中几个高频接触的核心模块src/cain_agent/orchestrator.py — 确定性状态机驱动 recon → test → reportsrc/cain_agent/gates.py — 覆盖率退出门等「验证纪律」纯函数src/cain_agent/cloud/ — 七大云厂商检测模块aliyun_oss.py、aws_s3.py、huawei_obs.py等。三、提交前的「本地三绿」cain-agent 开发环境标准流程1. 一键配置开发环境pip install -e .[dev,cloud]这一条命令装齐 lint、类型检查、测试与云依赖与 CI 保持一致CI 工作流见 .github/workflows/ci.yml。2. 提交前本地三绿社区约定docs/community.md要求 PR 提交前在本地跑通ruff check src tests # 1. 代码风格 pytest -q # 2. 全量测试 python -m bench.run_benchmark --suite vuln-tf \ --output /tmp/bench.md # 3. 涉及检测逻辑时当前测试基线已 1000 用例全绿演进记录见 CHANGELOG.md新增逻辑必须有测试修 bug 时先写复现测试再修。3. 分支命名与提交约定从main拉独立分支命名规范feat/主题/fix/主题/test/主题。commit 使用真实姓名 noreply 邮箱。四、你的第一个 PR从 Issue 到合入的完整流程第一步提 Issue选对模板仓库提供三套 Issue 模板.github/ISSUE_TEMPLATE/模板适用场景必填信息bug_report复现行为异常版本cain-agent --version、复现步骤、期望 vs 实际行为feature_request新能力 / 改进使用场景、为什么现有能力不够security_issue检测规则 / 脱敏 / scope 缺陷⚠️ 不要公开描述可利用细节走 Security Advisory 私下报告通用要求一个 Issue 一个主题先搜索是否已有同类标题一句话说清问题。第二步开发并跑通「本地三绿」第三步写好 PR 描述PR 模板.github/pull_request_template.md固定四个问题逐条回答即可改了什么— 改动清单为什么— 动机与背景怎么验证的— 附本地三绿输出安全语义影响— scope / 只读约束 / 双会话校验是否受影响不受影响请注明。第四步等待 review涉及安全语义scope、只读约束、finder≠validator 双会话校验的改动会被重点审查这是该项目质量护城河的一部分请对较长的 review 周期保持耐心。五、新手友好四类高价值贡献方向1. 新增一个技能SKILL.md⭐ 最推荐技能是 cain-agent 的知识单元放在skills/分类/技能名/SKILL.md。编写规范有统一模板且由测试强制校验——写完跑一次pytest tests/test_skill_format.py绿了才算达标。要点详见 docs/skill-authoring-guide.mdfrontmatter 四字段齐全正文必含「触发条件 / 三层测试模型L1 探测 → L2 验证 → L3 绕过/ 证据要求 / 禁止事项」四节。可参考已落地的 skills/web/sqli/ 等 13 个 OWASP Top 10 技能。2. 修 Bug从 Issue 里挑good first issue类的行为异常先写复现测试再修复附ruffpytest输出提 PR。3. 云模块扩展src/cain_agent/cloud/ 下各厂商模块结构清晰新增检测逻辑需同步补测试并保持「零凭证」——测试与 fixture 一律 mock不出现真实 AK/SK/token。4. 文档完善面向用户的行为变更需同步更新 README.md 与 README.zh-CN.md。中文文档的贡献门槛最低非常适合作为第一个 PR。六、合规红线安全测试项目贡献者必读 不在 Issue / PR / 讨论中粘贴真实凭证、内网拓扑或未脱敏证据 不测试未授权目标——任何贡献讨论都围绕授权测试场景展开 检测到检测绕过、凭证泄露、scope 逃逸类问题不要开公开 Issue走仓库 Security → Report a vulnerability 私下报告72 小时内响应 单元测试不得依赖外网零触网新增第三方依赖需在 PR 中说明理由。 想了解项目下一步做什么查看任务看板 ROADMAP.md 与近期交付记录 CHANGELOG.md从中找未勾选的条目就是你的下一个 Issue。下一步行动清单克隆并pip install -e .[dev,cloud]跑通cain-agent --version--dry-run看一遍执行计划读懂 docs/usage.md在 docs/community.md 对照贡献约定从修文档或补一个SKILL.md开始你的第一个 PR。祝你在 cain-agent 社区写出漂亮的第一个 PR 赞分享【免费下载链接】cain-agentReal-world AI penetration testing engineer for authorized assessments — built-in cloud module covering AWS/Azure/GCP Aliyun/Tencent/Huawei clouds. Built on Claude Agent SDK项目地址https://gitcode.com/gh_mirrors/ca/cain-agent点击查看免费下载相关推荐从克隆声音到贡献代码OpenVoice社区贡献者成长指南从克隆声音到贡献代码OpenVoice社区贡献者成长指南 你是否曾想过参与开源项目却被复杂的贡献流程吓退作为MyShell AI开源的即时语音克隆技术O人工智能语音音频深度学习1小时上手GitHub社区贡献从克隆到PR的新手通关指南1小时上手GitHub社区贡献从克隆到PR的新手通关指南 你是否在开源社区门外徘徊看着别人提交PRPull Request拉取请求却不知从何下手本文教程PMD 新手贡献者指南从克隆仓库到合并第一个 Pull Request 的完整流程PMD 新手贡献者指南从克隆仓库到合并第一个 Pull Request 的完整流程 本篇指南以 PMD 官方为 GSoC 学生和新贡献者编写的入门文档为主线静态分析代码质量上一篇MDN学习区深入理解JavaScript ES2015类继承机制下一篇Material Components Web 的 Tab Indicator 组件完全指南安装、动画原理与定制创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考