chore: 更新 .gitignore 忽略二进制文件，新增 Deploy.md 部署文档

.gitignore

@@ -15,4 +15,8 @@ test/
 # DevTools
 devtools/node_modules/
 devtools/logs/
-devtools/package-lock.json
+devtools/package-lock.json
+
+# Go 编译二进制
+backend/ai-core/main
+backend/gateway/main

Deploy.md

@@ -0,0 +1,106 @@
+# Cyrene 部署指南
+
+## 环境要求
+- Go 1.21+
+- Node.js 20+
+- Docker & Docker Compose
+
+## 快速启动
+
+### 1. 启动基础设施
+基础设施包括 PostgreSQL (pgvector)、Redis、Qdrant (向量数据库)、MinIO (对象存储) 和 NATS (消息队列)。
+
+```bash
+docker-compose -f docker-compose.dev.db.yml up -d
+```
+
+### 2. 编译并启动后端服务
+
+```bash
+# AI-Core (LLM 推理服务)
+cd backend/ai-core && go build -o main ./cmd/main.go && ./main
+
+# Gateway (API 网关)
+cd backend/gateway && go build -o main ./cmd/main.go && ./main
+```
+
+### 3. 安装依赖并启动前端
+
+```bash
+cd frontend/web && npm install && npm run dev
+```
+
+### 4. 启动 DevTools (可选)
+
+```bash
+cd devtools && npm install && npm start
+```
+
+## 使用 Docker Compose 完整启动
+
+```bash
+docker-compose -f docker-compose.dev.yml up -d
+```
+
+此命令将启动所有基础设施服务以及 AI-Core 和 Gateway 后端服务。
+
+## 生产环境部署
+
+```bash
+docker-compose -f docker-compose.yml up -d
+```
+
+生产环境额外包含 Caddy 反向代理（自动 TLS）。
+
+## 环境变量
+
+参考 `backend/.env.example` 配置以下变量：
+
+| 变量 | 说明 |
+|------|------|
+| `ENV` | 运行环境 (`development` / `production`) |
+| `LLM_API_URL` | LLM API 地址 |
+| `LLM_API_KEY` | LLM API 密钥 |
+| `LLM_MODEL` | 主模型 (默认 `gpt-4o`) |
+| `LLM_FALLBACK_MODEL` | 回退模型 (默认 `gpt-4o-mini`) |
+| `POSTGRES_HOST` / `POSTGRES_PORT` / `POSTGRES_USER` / `POSTGRES_PASSWORD` / `POSTGRES_DB` | PostgreSQL 连接信息 |
+| `REDIS_HOST` / `REDIS_PORT` / `REDIS_PASSWORD` | Redis 连接信息 |
+| `JWT_SECRET` | JWT 签名密钥 |
+| `JWT_EXPIRY_HOURS` | JWT 过期时间 (默认 720 小时) |
+| `MINIO_ENDPOINT` / `MINIO_ACCESS_KEY` / `MINIO_SECRET_KEY` / `MINIO_BUCKET` | MinIO 对象存储配置 |
+| `VECTOR_DB_URL` / `VECTOR_DB_COLLECTION` | Qdrant 向量数据库配置 |
+| `ADMIN_USERNAME` / `ADMIN_PASSWORD` | 管理员账户 (开发阶段) |
+| `TTS_PROVIDER` / `TTS_VOICE` | TTS 语音合成配置 |
+| `ASR_PROVIDER` / `ASR_MODEL` | ASR 语音识别配置 |
+
+## 项目结构
+
+```
+Cyrene/
+├── frontend/web/          # React 前端 (Vite + TypeScript)
+├── backend/ai-core/       # AI 推理核心 (LLM 对话、记忆、人设)
+├── backend/gateway/       # API 网关 (路由、鉴权、WebSocket)
+├── backend/memory-service/ # 记忆服务 (规划中)
+├── backend/tool-engine/   # 工具引擎 (规划中)
+├── backend/voice-service/ # 语音服务 (规划中)
+├── backend/proto/         # Protobuf 定义 (规划中)
+├── devtools/              # 管理面板
+└── scripts/               # 辅助脚本
+```
+
+## 端口
+
+| 端口 | 服务 |
+|------|------|
+| 5173 | 前端开发服务器 (Vite) |
+| 8080 | Gateway API |
+| 8081 | AI-Core API |
+| 3001 | DevTools 管理面板 |
+| 5432 | PostgreSQL |
+| 6379 | Redis |
+| 6333 | Qdrant HTTP API |
+| 6334 | Qdrant gRPC API |
+| 9000 | MinIO S3 API |
+| 9001 | MinIO Console |
+| 4222 | NATS |
+| 8222 | NATS HTTP Monitoring |