源码开发部署

源码运行适合贡献者和功能开发，不等同于生产部署。后端使用 Python 3.13、FastAPI、Celery；前端使用 Next.js 16 与 Bun。

基础依赖

启动 PostgreSQL 17 + pg_search、Redis 7 和 Qdrant 1.18.3。复制根目录 .env.example 为 .env，设置数据库、Redis、Qdrant、前后端 URL 和 NEXT_PUBLIC_API_URL。

后端

在 backend/ 安装 pyproject.toml 中的依赖，初始化数据库后启动 FastAPI API 和 Celery Worker/Beat。开发服务监听 API 8000，OpenAPI 页面为 /docs。

前端

在 frontend/ 安装 Bun 依赖，设置 NEXT_PUBLIC_API_URL=http://localhost:8000/api/v1，运行 Next.js 开发服务，默认端口 3000。