项目简介
AI Architect是Bito开发的一款强大的系统智能工具,它能够为您的编程智能体构建并提供代码库的知识图谱。通过理解您的仓库、模块和API,AI Architect为LLM客户端提供深入的上下文信息,从而帮助LLM生成更符合您代码风格和架构模式的生产级代码,加速开发、优化代码审查、并辅助故障排查。您可以选择在本地、团队服务器或企业环境中部署,确保代码数据的安全和私密性。
主要功能点
- 代码知识图谱构建: 自动分析和索引您的代码仓库,构建详细的模块、API、依赖关系和设计模式的知识图谱。
- 增强代码生成: 为编码智能体提供深度上下文,使其能够生成高质量、符合规范且生产就绪的代码。
- 统一设计模式: 确保生成的代码遵循您的架构模式和编码约定,提高代码一致性。
- 高效故障排查: 辅助智能体从错误日志和其他信号中快速定位问题根源。
- 加速团队融入: 帮助新工程师或AI智能体更快地理解系统结构。
- 智能代码审查: 为代码审查提供全面的系统级上下文,识别潜在的跨服务或跨模块影响。
- 灵活部署选项: 支持个人本地部署、团队共享部署(通过HTTPS访问)和企业级部署。
安装步骤
- 准备环境: 确保您的系统满足要求(macOS, Unix-based, Windows via WSL2),并已安装Docker Desktop。对于Windows用户,WSL2是必需的。
- 下载软件包: 从AI Architect的GitHub仓库下载最新的发布包。
- 启动Docker Desktop: 在开始安装前,请确保Docker Desktop已运行。
- 解压文件: 打开终端(Windows用户请打开Ubuntu WSL应用),导航到下载文件所在目录,使用命令 'tar -xzf bito-cis-.tar.gz' 解压软件包(请将'bito-cis-.tar.gz'替换为实际文件名)。然后进入解压后的目录:'cd bito-cis-*'。
- 运行设置脚本: 执行 './setup.sh' 脚本,它会引导您配置Git提供商、Git访问令牌、Bito API Key以及LLM API Keys(Anthropic和Grok推荐,以获得最佳成本和覆盖)。您还可以选择生成一个安全的MCP访问令牌。
- 添加代码仓库: 设置完成后,'.bitoarch-config.yaml' 文件会列出检测到的仓库。您可以编辑此文件,添加或移除需要索引的仓库。然后,选择自动配置(推荐)或手动运行 'bitoarch add-repos .bitoarch-config.yaml' 来保存配置。
- 启动索引: 运行 'bitoarch index-repos' 命令启动代码库的索引过程。根据仓库大小,可能需要3-10分钟/仓库。
- 获取MCP连接信息: 索引完成后,使用 'bitoarch mcp-info' 命令可以获取AI Architect MCP服务器的URL和访问令牌,这些信息将用于配置您的AI编码工具。
服务器配置
您的AI编码客户端(如Claude Code, Cursor, Windsurf, GitHub Copilot (VS Code)等)将需要配置AI Architect MCP服务器的连接信息。以下是一个示例配置,您的MCP客户端可能需要类似的信息:
{ "server_name": "AI Architect MCP Server", "command": "bitoarch", "args": ["connect", "--mcp-url", "您的Bito MCP URL", "--mcp-token", "您的Bito MCP Access Token"], "description": "连接到AI Architect MCP服务器,获取代码库的深度上下文,以增强LLM的编码能力。", "notes": "AI Architect MCP服务器是一个在后台运行的服务。MCP客户端在配置时,通常会要求提供一个命令(Command)来启动或连接到MCP服务器,以及相应的参数(Args)。这里提供的是一个参考示例,假定客户端会通过执行 'bitoarch' 命令并传入MCP服务器的URL和Access Token来建立连接。请务必运行 'bitoarch mcp-info' 命令获取您部署的服务器的实际 'Bito MCP URL' 和 'Bito MCP Access Token',并替换掉上述示例中的占位符。对于团队部署,URL需要是可通过HTTPS访问的地址,并且服务器需要持续运行。" }
基本使用方法
一旦AI Architect MCP服务器配置完成并在您的AI编码工具中启用,当您在IDE中与LLM进行交互时,AI Architect将自动为LLM提供相关的代码库上下文。例如,当您请求代码生成、进行代码审查或寻求解释时,LLM将利用AI Architect提供的深度代码知识来生成更准确、更符合项目约定的回应。您可以在AI编码工具中像往常一样工作,AI Architect在后台提供智能支持。
信息
分类
开发者工具