mnote/wolai-backend/README.md

# wolai-backend

本目录现在只保留轻量 FastAPI 辅助后端。OpenAI Agents 文档代理、Celery/Redis 队列和旧 OCR 占位链路已退役到仓库 `recycle/`，当前 AI 主链转向 OpenHub / LightRAG；Hermes / Reasonix 只保留为 legacy/debug 边界。

当前保留：

1. 健康检查：`GET /health`
2. CORS 配置：读取仓库根目录 `.env.all` 与环境变量
3. 依赖列表：`requirements.txt`

## 环境初始化

```powershell
python -m venv venv
.\venv\Scripts\activate

# 如遇代理报错，可在同一终端先运行：
#   set HTTP_PROXY=
#   set HTTPS_PROXY=
#   set ALL_PROXY=
#   set NO_PROXY=*

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

> MinerU 已位于 `services/mineru`，按 README 启动为独立 OCR 服务，无需作为 Python 包安装。

## 运行服务

```powershell
# FastAPI
uvicorn app.main:app --reload --port 8000
```

## 目录速览

```
app/
├── config.py           # Pydantic 设置，统一读取仓库根目录 .env.all
├── routers/
│   ├── health.py       # GET /health
```