安装部署
部署方式
方式一：Docker Compose（推荐）
bash
git clone <your-repo-url> forgexa
cd forgexa
docker compose up -d启动服务：
| 服务 | 端口 | 说明 |
|---|---|---|
api | 8000 | FastAPI 后端 |
web | 3000 | React 前端（Nginx） |
postgres | 5432 | PostgreSQL 16 + pgvector |
redis | 6379 | Redis 7（事件总线） |
minio | 9000/9001 | MinIO（制品存储） |
pgadmin | 5050 | pgAdmin（可选） |
方式二：宿主机模式
开发环境下，直接在宿主机运行后端和前端：
bash
# 后端
cd backend
pip install -e ".[dev]"
uvicorn app.main:app --reload --port 8000
# 前端
cd frontend
npm install
npm run dev运行时守护进程配置
守护进程可在任何安装了 AI Agent 的机器上运行。
前置条件
安装至少一个 AI 编码 Agent：
bash
# Claude Code（推荐）
npm install -g @anthropic-ai/claude-code
# 或 Codex
npm install -g @openai/codex
# 或 OpenCode
go install github.com/opencode-ai/opencode@latest启动守护进程
bash
# 连接本地/自托管服务时建议设置
export DAEMON_SERVER_URL=http://your-server:8000
export DAEMON_API_TOKEN=your-api-token
# 可选配置
export DAEMON_MAX_CONCURRENT=5 # 最大并行任务数
export DAEMON_POLL_INTERVAL=3 # 轮询间隔（秒）
export DAEMON_WORKSPACES_ROOT=~/.ai-factory/workspaces
# 启动
forgexa daemon start多服务器模式
单个守护进程可连接多个 API 服务器：
bash
export DAEMON_SERVER_URLS=http://server1:8000,http://server2:8000
forgexa daemon startCLI 安装
推荐安装独立 CLI 包：
bash
pip install forgexa-cli
# 登录
forgexa login --server http://localhost:8000 --email admin@example.com --password admin123
# 检查守护进程状态
forgexa daemon status环境变量
API 服务器
| 变量 | 默认值 | 说明 |
|---|---|---|
DATABASE_URL | postgresql+asyncpg://... | PostgreSQL 连接串 |
REDIS_URL | redis://localhost:6379 | Redis 连接串 |
SECRET_KEY | （必需） | JWT 签名密钥 |
LITELLM_MODEL | claude-sonnet-4-20250514 | AI 分析模型 |
守护进程
| 变量 | 默认值 | 说明 |
|---|---|---|
DAEMON_SERVER_URL | https://api.forgexa.net | API 服务器地址 |
DAEMON_API_TOKEN | （可选） | 认证令牌（如已通过 CLI 登录可自动读取） |
DAEMON_MAX_CONCURRENT | 5 | 最大并行任务数 |
DAEMON_POLL_INTERVAL | 3 | 轮询间隔（秒） |
DAEMON_ID | 主机名 | 守护进程唯一标识 |
FACTORY_CLAUDE_MODEL | （无） | 覆盖 Claude 模型 |