快速开始

🎯 环境要求

🚀 快速部署 - AI-Digest-Pro

步骤 1: 克隆项目

git clone <repository-url>
cd ai-digest-pro

步骤 2: 安装依赖

pip install -r requirements.txt

步骤 3: 配置环境变量

复制环境变量模板并编辑：

cp .env.example .env

编辑 .env 文件，配置 AI API：

# 云端API配置
CLOUD_API_KEY=your_api_key_here
CLOUD_BASE_URL=https://api.openai.com/v1
CLOUD_MODEL=gpt-3.5-turbo

# 速率和成本限制
MAX_API_CALLS_PER_MINUTE=60
MAX_DAILY_COST=10.0

步骤 4: 配置数据源

编辑 config.yaml 文件，选择需要的资讯源：

mode: "cloud"  # 或 "local" 使用本地模型

sources:
  - { name: "OpenAI Blog", url: "https://openai.com/news/rss.xml", type: "rss" }
  - { name: "Anthropic News", url: "https://www.anthropic.com/index.xml", type: "rss" }
  # ... 更多源

步骤 5: 运行程序

python main.py

步骤 6: 查看结果

使用本地服务器查看生成的网站：

# Windows 用户
start_server.bat

# Linux/Mac 用户
cd output && python -m http.server 8010

然后访问：http://localhost:8010

🐳 快速部署 - Docker 完整系统

步骤 1: 准备配置文件

cd ai-digest-os
cp .env.example .env

步骤 2: 编辑环境变量

# GitHub 配置
GITHUB_TOKEN=your_github_token
GITHUB_API_URL=https://api.github.com/repos/username/repo/commits/branch

# JWT 配置
JWT_SECRET_KEY=your_generated_secret_key

# 项目路径
PROJECT_PATH=/app/repo

步骤 3: 启动服务

docker-compose up -d

步骤 4: 访问服务

• 后端 API: http://localhost:8000
• API 文档: http://localhost:8000/docs
• 默认账户: admin / admin123

💻 快速部署 - 前端管理界面

步骤 1: 安装依赖

cd ai-digest-ui
npm install

步骤 2: 配置后端地址

创建 .env 文件：

VITE_API_BASE_URL=http://localhost:8000

步骤 3: 启动开发服务器

npm run dev

步骤 4: 访问界面

访问：http://localhost:5173

✅ 验证部署

🔧 常见问题

1. Python 版本过低

问题：运行时提示 Python 版本不兼容

解决：升级到 Python 3.9+

# 检查版本
python --version

# 安装最新版本
# 访问 https://www.python.org/downloads/

2. API Key 未配置

问题：运行时提示 API Key 错误

解决：确保 .env 文件中配置了正确的 API Key

3. 端口被占用

问题：Docker 或服务器启动失败

解决：修改 docker-compose.yml 或配置文件中的端口号

4. 依赖安装失败

问题：pip install 或 npm install 失败

解决：使用国内镜像源

# Python 使用清华镜像
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

# Node.js 使用淘宝镜像
npm install --registry=https://registry.npmmirror.com

📚 下一步