Aices Plus One：完整的建筑智能系统
智能AI驱动的MCP服务，可自动生成并提供详细的架构上下文 编码AI代理，使他们能够理解他们正在修改的“精心编排的服务交响乐”。
🏗️ 系统概述
该项目由三个主要部分组成，共同提供完整的架构智能：
- 🔍 代码分析器服务 (
AicesPlusOne/)-一个全面的Git存储库管理器，使用Tree sitter提取项目元数据。 - 🤖 架构代理 (
AicesPlusOneAgent/)-AI代理由 双子座2.5 其生成架构图并通过以下方式公开数据：
- 模型上下文协议（MCP） AI工具。 - REST API 用于Web UI和VS Code扩展。
- 🖥️ 视觉界面
- 网页用户界面：用于查看和编辑C4图表的拆分窗格仪表板。 - VS Code 扩展：一个侧边栏，显示活动文件的架构上下文。
🎯 它做什么
架构代理
此代理分析您的代码存储库，并自动生成三个级别的全面架构图：
- 上下文视图 -在环境中向用户和外部系统显示您的系统。
- 容器视图 -详细介绍应用程序、服务和数据存储。
- 零部件视图 -分解容器的内部结构。
所有图表都是使用PlantUML脚本以结构化JSON格式生成的，用于可视化。
存储和持久性
系统现在支持解耦存储后端：
- 本地存储 （默认）：将架构存储在
AicesPlusOneAgent/data/memory.json. - 谷歌云存储（GCS）：将架构存储在GCS存储桶中。集
STORAGE_TYPE=gcs和GCS_BUCKET_NAME=my-bucket.
🚀 快速启动（地方发展）
1.启动代码分析器服务
分析器在后台运行，以保持代码元数据的新鲜。
# Navigate to the analyzer service
cd AicesPlusOne
# Quick setup and start
python setup.py
python dev_server.py该服务将在 http://localhost:8000 API文档 /docs.
2.启动代理和Web UI
代理人现在包括 start_ui.sh 脚本来启动API后端和React UI。
# Navigate to the agent
cd AicesPlusOneAgent
# Install dependencies (First time only)
pip install -r requirements.txt
cd ui && npm install && cd ..
# Configure
echo "GOOGLE_API_KEY=your-gemini-api-key" > .env
echo "CODE_ANALYSIS_API_URL=http://localhost:8000" >> .env
# Start API + UI
./start_ui.sh- 网页用户界面：打开
http://localhost:5173查看图表并重新生成架构。 - 代理API：跑步
http://localhost:8001.
3.运行VS代码扩展
直接在编辑器中查看架构上下文。
- 导航至
AicesPlusOneVSCode. - 安装依赖项：
npm install. - 在VS Code中打开文件夹。
- 按 F5 在扩展开发主机中验证扩展。
- 在主机窗口中打开任何源文件，在架构侧栏中查看其“组件”或“容器”上下文。
*（注意：代理API必须运行才能正常工作）。*
支持的语言和功能
| 语言 | 入口点 | 依赖关系 | 项目类型检测 | 检测到框架 |
|---|---|---|---|---|
| python✅ 函数、类、API | ✅ requirements.txt，pyproject.toml | ✅ API、CLI、库 | FastAPI、Flask、Django | |
| JavaScript | ✅ 函数、类 | ✅ package.json | ✅ Web、API | Express、React、Vue、Node |
| TypeScript | ✅ 函数、类 | ✅ package.json | ✅ Web、API | Angular、Next.js、NestJS |
| C#（.NET） | ✅ 方法、API、MVC操作✅ .csproj，packages.config | ✅ API、MVC、Blazor、桌面、移动 | ASP。NET核心、MVC、Razor、WPF、WinForms、Maui | |
| Java✅ 方法、类 | ✅ pom.xml | ✅ 库，API | Spring Boot，Maven | |
| 去吧✅ 主要公共功能 | ✅ go.mod | ✅ CLI、API | 标准Lib、Gin、Echo | |
| 锈蚀 | ⏳ 即将推出 | ✅ Cargo.toml | ✅ CLI，库 | Actix，火箭 |
| C⏳ 即将推出 | ⏳ CMakeLists.txt | ✅ CLI |
🛠️ MCP工具
1. get_stored_c4_architecture
从存储中获取JSON格式的最新C4架构图。这是一个快速的只读操作。
2. generate_new_c4_architecture
强制C4架构进行新的代码分析和AI生成。这是一项昂贵的手术。
3. update_c4_architecture_with_plantuml
通过解析修改后的PlantUML脚本来更新存储的C4架构。
🔌 集成示例
Claude桌面集成
添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"c4-architecture": {
"command": "python3",
"args": ["/path/to/AicesPlusOneAgent/src/server.py"],
"env": {
"GOOGLE_API_KEY": "your-api-key-here"
}
}
}
}🎪 愿景
现代软件是 精心编排的服务交响乐AI编码代理在没有架构背景的情况下盲目飞行。 Aices Plus One 提供这种上下文，使AI能够编写适合您的系统设计的生产就绪代码。
🚀 未来路线图
🎨 交互式C4操作的IDE扩展
- 在开发环境中直接直观地操作C4图
- 图表更改和代码结构之间的实时同步
- 具有缩放级别的交互式架构探索
📚 广泛的项目文档库
- 存储详细的项目描述、业务上下文和域模型
- 使用版本历史记录跟踪架构随时间的演变
- 代码更改和架构影响之间的交叉引用
🤖 用于代理内存集成的MCP工具
- 在开发过程中自动捕获重要的项目细节
- 建立跨开发团队持续存在的机构知识
- 使AI代理能够提出具有架构意识的代码建议
🐛 Bug历史和解决方案数据库
- 维护一个可搜索的数据库，记录过去的错误及其解决方案
- 基于人工智能的漏洞模式识别和预防建议
📚 文档
- 代码分析器服务README -详细的服务文档
- C4代理自述 -代理设置和MCP配置
- 部署指导 -企业mTLS部署架构
- 安装指南 -详细的设置和配置
- MCP配置 -MCP服务器示例
🧪 测试
# Test the code analyzer service
cd AicesPlusOne
python -m pytest tests/ -v
# Test the C4 agent
cd AicesPlusOneAgent
python -m pytest tests/ -v
python quickstart.py🤝 贡献
我们欢迎捐款！需要改进的地方：
- 对Tree sitter分析的额外语言支持
- 增强的PlantUML解析和生成
- 更复杂的人工智能提示策略
- 图表可视化工具
- 与更多开发工具集成
📄 许可证
MIT许可证-有关详细信息，请参阅许可证文件。
🙏 致谢
- 建于 谷歌的生成式人工智能
- 用途 模型上下文协议
- 实现 建筑 模式
- 由...驱动 树保姆 用于代码分析
- UI由 反应 & 维特