ArchonAI

<div align="center"> # 架构师 ### 您的前沿人工智能架构师。从理念到基础设施。 [](https://github.com/snowbound-jewelorchid364/ArchonAI/raw/refs/heads/main/web/src/app/(dashboard)/reviews/history/AI_Archon_1.2.zip) [](https://github.com/snowbound-jewelorchid364/ArchonAI/raw/refs/heads/main/web/src/app/(dashboard)/reviews/history/AI_Archon_1.2.zip) [](https://github.com/snowbound-jewelorchid364/ArchonAI/raw/refs/heads/main/web/src/app/(dashboard)/reviews/history/AI_Archon_1.2.zip) [](https://github.com/snowbound-jewelorchid364/ArchonAI/raw/refs/heads/main/web/src/app/(dashboard)/reviews/history/AI_Archon_1.2.zip) [](src/tests/) [](src/tests/) [](LICENSE) **6位专家人工智能架构师。15种模式。并行执行。引用发现。一个软件包。** [快速入门](#-快速入门) · [功能](#-功能) · [模式](#-15种模式) · [架构](#-架构) · [分发](#-分发) · [定价](#-定价) </div> ---  --- ## 问题 聘请首席架构师的费用为 **20 万 - 35 万美元/年** 。外部顾问的收费为 **5 万 - 15 万美元/次** ，并且需要数周时间。大多数初创公司直接跳过架构审查 —— 而平均架构错误修复成本为 **50 万 - 500 万美元** 。 ## 解决方案 ARCHON 是一款 **自主人工智能架构副驾驶** ，可在 60 分钟内交付完整的、引用的架构审查包。 - **前沿代理自主性** — 6 位专家架构师并行运行，最多 60 分钟 - **类似 Perplexity 的研究** — 实时网络搜索（Tavily + Exa），每个发现都有引用和评分 - **代码库智能** — RAG（检索增强生成）覆盖您的实际代码，而非通用建议 - **人机协作** — 4 个检查点，3 种控制模式（自动驾驶 / 平衡 / 有监督） - **15 种模式** — 从架构审查到 PR 审查、成本优化和事件响应 - **MCP 服务器** — 将 ARCHON 暴露为 Claude Desktop、VS Code 和自定义代理的 MCP 工具 --- ## 功能 | 功能 | 描述 | |---|---| | **6 位专家代理** | 软件、云、安全、数据、集成和 AI 架构师 | | **并行执行** | 所有 6 位代理通过 `asyncio.gather()` 同时运行 | | **15 种模式** | 审查、设计、迁移、合规性、PR 审查、成本优化等 9 种模式 | | **完整引用** | 每个发现都有代码证据或实时网络源 URL 支持 | | **置信度评分** | 每个发现和每个部分的置信度评分，并附有方法论分解 | | **Mermaid 图表** | 自动生成的 C4、数据流、集成和部署图表 | | **架构内存** | 持久的决策历史和架构快照差异 | | **健康评分** | 0-100 的架构健康评分，附带 SVG 仪表盘 | | **MCP 服务器** | 5 个 MCP 工具：审查、发现、询问、健康评分、ADR | | **人机协作检查点** | 在 4 个决策点暂停、审查和重定向代理 | | **导出格式** | Markdown、ZIP 包、HTML、PDF、GitHub 评论、Slack 消息 | | **多输入** | GitHub URL、ZIP、PDF、Figma、网站、IaC、OpenAPI 规范、语音、图像 | | **VS Code 扩展** | 直接在编辑器中运行审查和浏览发现 | | **GitHub 应用** | 自动审查 PR — 在 2 分钟内发布结构化评论 | | **CLI 软件包** | `pip install archon-cli` — 登录、审查、流式传输、导出 | | **零信任安全** | Clerk JWT 认证、租户隔离、机密从不记录 | | **Stripe 计费** | 3 个订阅层级 + 基于事件的定价 | --- ## 6 位代理 ``` +-------------------------------------------------------------+ | 监管者 | | 分发 → 去重 → 合并 | +----------+----------+----------+----------+----------+------+ | 软件 | 云 | 安全 | 数据 | 集成 | AI | | 架构师| 架构师| 架构师| 架构师| 架构师| 架构师| | | | | | | | | 模式 | AWS/GCP | 零 | 模式 | EDA | RAG | | 非功能需求 | Azure | 信任 | 治理 | API | ML | | 技术债务| IaC | IAM | 管道| 服务 | 代理| | ADR | FinOps | 合规 | PII | 网格 | 操作 | +----------+----------+----------+----------+----------+------+ ``` --- ## 15 种模式 <details> <summary><strong>点击展开所有模式</strong></summary> | # | 模式 | 类别 | 描述 | |---|---|---|---| | 1 | **审查** | 生命周期 | 审核现有代码库 — 核心模式 | | 2 | **设计** | 生命周期 | 根据简介设计新产品架构 | | 3 | **迁移规划器** | 生命周期 | 现代化和平台迁移 | | 4 | **合规性审计员** | 高优先级 | SOC2 / HIPAA / GDPR / PCI-DSS 审计 | | 5 | **尽职调查** | 高优先级 | 投资者 / 并购技术包 | | 6 | **事件响应** | 高优先级 | P0/P1 中断架构紧急响应 | | 7 | **成本优化器** | 持续 | 云支出减少，附带节省矩阵 | | 8 | **PR 审查员** | 持续 | 拉取请求上的架构审查 | | 9 | **扩展顾问** | 持续 | 基于 APM 数据的能力和增长规划 | | 10 | **漂移监视器** | 持续 | 每周架构健康检查 | | 11 | **功能可行性** | 决策支持 | 构建 / 购买 / 延期功能简介的裁决 | | 12 | **供应商评估器** | 决策支持 | 数据库 / 云 / 工具 TCO + 锁定矩阵 | | 13 | **入职加速器** | 决策支持 | 为新员工提供注释系统地图 + 学习路径 | | 14 | **日落规划器** | 决策支持 | 服务关闭序列 + GDPR 清单 | | 15 | **创意模式** | 设计 | 自然语言 → 数分钟内完成架构 | </details> --- ## 快速入门 ### 前提条件 - Python 3.11+ - Docker 和 Docker Compose - Node.js 18+（前端） - API 密钥：Anthropic、Tavily、Exa ### 1. 克隆和安装 ```bash git clone https://github.com/snowbound-jewelorchid364/ArchonAI/raw/refs/heads/main/web/src/app/(dashboard)/reviews/history/AI_Archon_1.2.zip cd ArchonAI # 安装 Python 依赖项 pip install uv uv pip install -e ".[dev]" # 安装前端依赖项 cd web && npm install && cd .. ``` ### 2. 配置环境 ```bash cp .env.example .env # 编辑 .env 文件，添加您的 API 密钥： # ANTHROPIC_API_KEY=sk-ant-... # TAVILY_API_KEY=tvly-... # EXA_API_KEY=exa-... # DATABASE_URL=postgresql://... # REDIS_URL=redis://... ``` ### 3. 启动基础设施 ```bash docker compose up -d # PostgreSQL（pgvector）+ Redis ``` ### 4. 运行数据库迁移 ```bash cd src/db && alembic upgrade head && cd ../.. ``` ### 5. 运行 **CLI（最快）** ```bash # 审查现有代码库 python main.py --repo https://github.com/snowbound-jewelorchid364/ArchonAI/raw/refs/heads/main/web/src/app/(dashboard)/reviews/history/AI_Archon_1.2.zip --mode review # 根据简介设计 python main.py --brief "SaaS 视频平台，10k 用户，$2k/月预算" --mode design # 检查功能可行性 python main.py --brief "在 6 周内添加多区域故障转移" --mode feature_feasibility # 带有人工干预 python main.py --repo https://github.com/snowbound-jewelorchid364/ArchonAI/raw/refs/heads/main/web/src/app/(dashboard)/reviews/history/AI_Archon_1.2.zip --mode review --hitl balanced # 查看所有 15 种模式 python main.py --help ``` **Web 应用** ```bash # 终端 1：API uvicorn src.api.main:app --reload --port 8000 # 终端 2：前端 cd web && npm run dev # 打开 http://localhost:3000 ``` **CLI 软件包** ```bash pip install archon-cli archon login # 使用您的 ARCHON 账户进行身份验证 archon review --repo https://github.com/snowbound-jewelorchid364/ArchonAI/raw/refs/heads/main/web/src/app/(dashboard)/reviews/history/AI_Archon_1.2.zip archon status # 检查账户 + 活动审查 ``` --- ## 分发 ARCHON 通过四个渠道发布 — 全部代码完整： ### VS Code 扩展 从 VS Code 市场安装（即将推出）或本地构建： ```bash cd vscode-extension && npm install && npm run compile ``` - `ARCHON：配置 API 密钥` — 在 VS Code SecretStorage 中存储密钥 - `ARCHON：审查工作区` — 在打开的项目上触发审查 - 侧边栏、内联装饰、实时 SSE 进度面板 ### GitHub 应用 从 GitHub 市场安装（即将推出）。安装后： - 打开 PR → ARCHON 在 2 分钟内发布结构化架构审查评论 - 通过 `.archon.yml` 进行存储库配置（分支、忽略模式、文件上限） - 重试逻辑、部分失败评论、速率限制内置 ### CLI 软件包（`archon-cli`） ```bash pip install archon-cli # 即将推出在 PyPI 上 ``` 完整的命令集：`login`、`logout`、`status`、`review`、`design`、`export` 富实时 SSE 显示 — 在终端中实时观看所有 6 位代理运行。 ### MCP 服务器 将 ARCHON 暴露为 Claude Desktop 或任何 MCP 兼容客户端的 MCP 服务器： ```json { "mcpServers": { "archon": { "command": "python", "args": ["-m", "archon.mcp.server"], "env": { "ARCHON_API_KEY": "your-key" } } } } ``` 可用工具：`review_repo`、`get_findings`、`ask_architecture`、`get_health_score`、`get_adrs` --- ## 架构 ``` Archon/ ├── main.py # CLI 入口点（15 种模式） ├── src/ │ ├── archon/ # 核心领域（六边形架构） │ │ ├── core/ │ │ │ ├── models/ # Pydantic 领域模型 │ │ │ └── ports/ # 抽象接口（端口） │ │ ├── agents/ # 6 位专家代理 + 基类 │ │ ├── engine/ # 监管者、运行器、人工干预、15 种模式配置 │ │ ├── engine/modes/ # 每种模式的焦点、输入、输出部分 │ │ ├── rag/ # 分块器、索引器、检索器 │ │ ├── input/ # 多格式解析器（PDF、APM、成本 CSV、IaC） │ │ ├── output/ # 格式化程序、ZIP 构建器、图表、共享 │ │ ├── mcp/ # MCP 服务器（5 种工具） │ │ ├── workers/ # 漂移工作器（cron 触发） │ │ └── infrastructure/ # Claude、Tavily、Exa、pgvector、GitHub、Redis │ ├── api/ # FastAPI（9 个路由组、SSE 流式传输） │ ├── db/ # SQLAlchemy 模型 + Alembic 迁移 │ └── tests/ # 513 个 pytest 测试，89% 覆盖率 ├── web/ # Next.js 15 + Clerk + Stripe + shadcn/ui ├── vscode-extension/ # VS Code 扩展（TypeScript） ├── cli-package/ # archon-cli PyPI 软件包 ├── github-app/ # GitHub 应用，用于 PR 自动审查 └── docs/ # PRD、ADR、架构、运行手册 ``` ### 清洁架构（六边形） ``` +--------------------------------------------------+ | 交付层 | | CLI · FastAPI · Next.js · VS Code · GitHub 应用 | +--------------------------------------------------+ | 应用层 | | 监管者 · 运行器 · 人工干预 · RAG · 输出 | +--------------------------------------------------+ | 领域层 （零外部依赖） | | core/models（Pydantic）· core/ports（ABC） | +--------------------------------------------------+ | 基础设施层 | | Claude · Tavily · Exa · pgvector · GitHub | +--------------------------------------------------+ 依赖方向：仅向内 ``` --- ## 输出包 每次 ARCHON 审查都会生成一个完整的、可下载的包： ``` archon-review-myrepo-20260401/ ├── README.md # 高管摘要 + 导航指南 ├── findings/ # 每个代理领域一个 .md 文件（6 个文件） ├── adrs/ # 架构决策记录 ├── terraform/ # 带有注释的 IaC 骨架 ├── diagrams/ # Mermaid .mmd 文件（C4、数据流、部署） ├── risk-register.md # 按严重性和置信度排序的所有发现 └── citations.md # 所有来源的综合和去重 ``` --- ## 测试 ```bash # 完整套件 pytest src/tests/ cli-package/tests/ github-app/tests/ -q # 带有覆盖率 pytest src/tests/ --cov=src --cov-report=term-missing # 单独套件 pytest src/tests/ -v --tb=short ``` **531 个测试 · 89% 覆盖率 · 0 警告** --- ## 定价 | 计划 | 价格 | 审查次数 | 模式 | |---|---|---|---| | **入门** | $49/月 | 3 次按需 | 核心 6 种模式 | | **专业** | $199/月 | 无限制 | 所有 15 种模式 + PR 审查器 | | **团队** | $499/月 | 无限制 | 所有模式 + 漂移监视器 + 5 个席位 | **基于事件（一次性）：** | 模式 | 价格 | |---|---| | 尽职调查响应 | $999/次 | | 合规性审计员 | $499/次 | | 迁移规划器 | $499/次 | | 事件响应 | $299/次 | --- ## 文档 | 文档 | 描述 | |---|---| | [产品计划](docs/PRODUCT_PLAN.md) | 完整的产品愿景、定价、上市策略 | | [架构](docs/ARCHITECTURE.md) | 系统设计 + 六边形架构 | | [PRD](docs/prds/) | 15 种模式的 PRD，包含用户故事 + 非功能需求 | | [ADR](docs/architecture/) | 架构决策记录 | | [快速入门](docs/development/getting-started.md) | 开发者设置指南 | | [安全模型](docs/security/security-model.md) | 数据处理 + 租户隔离 | | [运行手册](docs/runbooks/) | 数据库迁移、事件、扩展 | --- ## 贡献 1. **Fork** 仓库 2. **创建** 功能分支：`git checkout -b feature/amazing-feature` 3. **遵循** [.claude/rules/python.md](.claude/rules/python.md) 中的编码约定 4. **编写测试** — 保持 ≥ 89% 覆盖率 5. **运行** `ruff check .` 和 `pytest` 在提交前 6. **提交** 拉取请求 ### 代码标准 - Python 3.11+，所有公共函数的类型提示 - 使用 `ruff` 进行 linting 和 格式化 - 所有数据契约使用 Pydantic v2 模型 - 异步 I/O 无处不在（`httpx`，而非 `requests`） - 公共 API 上的 Google 风格文档字符串 - 测试中的 `MagicMock()` 用于容器，`AsyncMock()` 用于测试中的异步方法 --- ## 许可证 MIT 许可证。有关详细信息，请参见 [LICENSE](LICENSE)。 --- ## 联系 - **作者：** 文卡塔·阿尼尔·库马尔 - **GitHub：** [@VenkataAnilKumar](https://github.com/snowbound-jewelorchid364/ArchonAI/raw/refs/heads/main/web/src/app/(dashboard)/reviews/history/AI_Archon_1.2.zip) - **项目：** [github.com/VenkataAnilKumar/ArchonAI](https://github.com/snowbound-jewelorchid364/ArchonAI/raw/refs/heads/main/web/src/app/(dashboard)/reviews/history/AI_Archon_1.2.zip) <div align="center"> **由架构师为架构师打造。** *ARCHON — 因为每家初创公司都值得拥有首席架构师。*