本地开发
前置依赖
- Python
3.13+ uv- Node.js
18+，仅当前端开发或 E2E 需要 - Docker / Docker Compose，用于 PostgreSQL、MinIO、Qdrant、Redis 等依赖
安装依赖
uv sync --all-groups
如果你需要提交代码，额外执行仓库约定的 hooks 安装命令。
仅预览文档站
just docs-serve
启动 AI 服务
just docker-infra
uv run python main.py
默认健康检查端点是 GET /healthz。如果本机端口冲突，可以显式设置 AI_SERVICE_PORT。
启动完整本地链路
推荐优先使用仓库的 just 配方，而不是手动拼装：
just docker-infra
just demo-up
如果需要分开启动：
just run-ai-backend
just run-demo-backend
just run-demo-frontend
just run-admin-frontend
验证命令
just test
uv run --group docs mkdocs build