小乐 AI 助手后端项目 - FastAPI + PostgreSQL

• FastAPI - 现代高性能 Web 框架
• SQLAlchemy - Python ORM
• PostgreSQL - 关系型数据库
• APScheduler - 定时任务调度
• OpenAI API - AI 对话能力

# 创建虚拟环境
python3 -m venv venv
source venv/bin/activate

# 安装依赖
pip install -r requirements.txt

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件，填写必要的配置

# 启动服务
uvicorn main:app --reload --host 0.0.0.0 --port 8000

# 构建镜像
docker build -t xiaole-backend .

# 运行容器
docker run -d -p 8000:8000 --env-file .env xiaole-backend

• GET /health - 健康检查
• POST /token - 用户登录
• GET /sessions - 获取会话列表
• POST /chat - 发送消息
• GET /memory/{user_id} - 获取记忆
• GET /documents/users/{user_id} - 获取文档
• GET /tasks/users/{user_id} - 获取任务
• GET /reminders/users/{user_id} - 获取提醒

xiaole-backend/
├── main.py              # 应用入口
├── agent.py             # AI Agent 核心逻辑
├── memory.py            # 记忆管理
├── conversation.py      # 对话管理
├── scheduler.py         # 定时任务
├── routers/             # API 路由
├── tools/               # Agent 工具
├── db_migrations/       # 数据库迁移
├── Dockerfile           # Docker 构建
├── docker-compose.yml   # Docker Compose
└── requirements.txt     # Python 依赖

项目部署到 NAS + Cloudflare Tunnel：

• API 地址: https://api.leke.xyz
• Docker Hub: rockts/xiaole-backend

推送到 main 分支时自动：

1. 构建 Docker 镜像
2. 推送到 Docker Hub
3. NAS 通过 Watchtower 自动拉取更新

• xiaole-web - 前端 UI
• xiaole-ai - 项目文档

MIT