Archon – 构建AI编程助手的智能控制中心
“
让AI编程助手拥有自定义知识库和任务管理能力，就像为它们配备了专属指挥中心
什么是Archon？
Archon是AI编程助手的指挥中心。它既是一个管理项目知识、上下文和任务的用户界面，又是一个支持**模型上下文协议(MCP)**的服务端。无论您使用Claude Code、Cursor还是其他AI编程工具，Archon都能让它们共享：
-
您的专属文档库（抓取的网站、上传的PDF/文档） -
智能检索能力（先进的RAG策略） -
统一任务管理系统 -
实时更新的协作环境
“
当前版本为测试阶段！功能可能不完全稳定，欢迎反馈与贡献。
Archon如何改变开发体验？
想象一下：当您开始新项目时，AI助手能立即访问所有相关文档；当您添加需求时，任务自动同步给所有协作AI。Archon让这个场景成为现实：
-
新旧项目通用：无论新老代码库都能受益 -
统一知识源：避免不同AI助手信息不一致 -
动态上下文：实时更新所有连接的工具 -
协作效率：人机协作管理任务更流畅
核心功能解析
🧠 智能知识管理
graph LR
A[上传文档] --> B[智能分块]
C[抓取网站] --> B
B --> D[向量化处理]
D --> E[存储到数据库]
E --> F[语义搜索]
🤖 AI深度集成
MCP协议是Archon的核心创新，它定义了AI助手与知识库的标准交互方式：
-
10种标准工具：涵盖检索、任务管理、项目操作等 -
多模型支持： -
OpenAI系列模型 -
Google Gemini -
本地部署的Ollama
-
-
进阶RAG策略： -
混合搜索（关键词+语义） -
上下文感知嵌入 -
结果重排序（需启用额外组件）
-
“
启用重排序功能：取消
python\requirements.server.txt中20-22行的注释，注意这会显著增加容器大小
📋 项目与任务管理
# 示例：AI生成的任务结构
project = {
"name": "电商平台开发",
"features": [
{
"title": "用户认证",
"tasks": [
"实现OAuth登录",
"设计权限管理系统",
"编写测试用例"
]
}
]
}
-
层级化管理：项目>功能>任务的树形结构 -
AI辅助创建：自动生成任务清单和需求文档 -
版本控制：文档变更历史追踪 -
实时看板：任务状态可视化监控
五分钟快速上手
准备工作
-
Docker Desktop -
Supabase账号（免费版足够） -
OpenAI API密钥
安装步骤
# 1. 克隆仓库
git clone https://github.com/coleam00/archon.git
cd archon
# 2. 配置环境
cp .env.example .env
# 编辑.env文件添加Supabase凭证：
# SUPABASE_URL=https://your-project.supabase.co
# SUPABASE_SERVICE_KEY=your-service-key-here
注意：使用Supabase的旧版服务密钥（较长的那个）
关键步骤：
-
在Supabase控制台执行 migration/complete_setup.sql -
启动服务： docker-compose up --build -d -
访问 http://localhost:3737 -
设置→选择LLM提供商→输入API密钥
服务架构
技术架构深度解析
微服务架构
┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ 前端UI │ │ API服务 │ │ MCP服务 │ │ 代理服务 │
│ (React+Vite)◄──►(FastAPI) ◄──►(HTTP包装层)◄──►(PydanticAI)│
└─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘
│ │ │
└───────┬───────┘ │
│ │
┌───────▼───────┐ │
│ Supabase ◄───────────────┘
│ PostgreSQL │
│ PGVector │
└───────────────┘
服务分工
设计优势
-
独立扩展：各服务可按需扩容 -
技术多样性：为不同场景选择最佳技术 -
开发隔离：团队可并行开发不同模块 -
轻量容器：最小化依赖，快速部署
实用操作指南
首次功能测试
-
网站抓取测试：
-
访问 http://localhost:3737 -
知识库 → “抓取网站” → 输入文档URL（如 https://ai.pydantic.dev/llms-full.txt）
-
-
文档上传测试：
-
知识库 → 上传PDF/Word文档 -
观察自动分块和索引过程
-
-
项目管理测试：
-
创建新项目 → 添加功能模块 → 生成任务 -
在任务描述中使用 @doc引用知识库内容
-
-
AI助手连接：
-
MCP面板 → 复制连接配置 -
粘贴到您使用的AI编程工具中
-
自定义配置
修改.env文件调整服务设置：
# 端口配置示例
ARCHON_UI_PORT=3737 # 主界面
ARCHON_SERVER_PORT=8181 # API服务
ARCHON_MCP_PORT=8051 # MCP协议端口
ARCHON_AGENTS_PORT=8052 # 代理服务
# 主机配置示例
HOST=192.168.1.100 # 局域网访问
HOST=archon.yourdomain.com # 域名访问
变更后重启：docker-compose down && docker-compose up -d
数据库管理技巧
安全重置数据库
当需要完全重新开始时：
-
在Supabase执行
migration/RESET_DB.sql“
⚠️ 警告：这将删除所有Archon数据！
-
重新执行
migration/complete_setup.sql -
重启服务：
docker-compose up -d -
重新配置LLM密钥和知识库
开发模式指南
# 后端热重载
docker-compose up archon-server archon-mcp archon-agents --build
# 前端热更新
cd archon-ui-main && npm run dev
# 文档服务
cd docs && npm start
开发提示：后端服务配置了--reload参数，代码修改会自动生效。
常见问题解答（FAQ）
❓ Archon支持本地模型吗？
✅ 支持！通过Ollama可集成本地运行的LLM，在设置中选择”Ollama”并指定本地API地址即可
❓ 需要多少存储空间？
基础安装约2GB，启用重排序功能后需额外1.5GB空间。文档存储取决于您的知识库规模
❓ 能协作使用吗？
✅ 支持多用户！Supabase数据库天然支持团队协作，所有变更实时同步
❓ 现有项目如何接入？
-
上传项目文档到知识库 -
抓取项目相关网站 -
创建对应项目结构 -
将MCP配置添加到您使用的AI工具
❓ 是否支持代码库索引？
当前版本专注于文档管理，代码库索引功能在开发路线图中
项目资源
-
GitHub讨论区 – 加入社区讨论 -
贡献指南 – 参与项目开发 -
介绍视频 – 15分钟上手演示 -
Dynamous AI社区 – Archon的发源地
授权信息
采用Archon社区许可证(ACL) v1.2 – 详见LICENSE文件
核心原则：可自由使用、修改和分享，但禁止未经授权的商业化SaaS服务
“
在AI时代，知识管理能力决定开发效率上限。Archon为您构建的不只是工具，而是人机协作的新范式。
