本地开发
启动后端
cd backend
cp .env.example .env
uv sync
uv run uvicorn app.main:app --reload --host 0.0.0.0 --port 8000启动前端
cd front
pnpm install
pnpm dev默认端口
- 前端：
http://localhost:7788 - 后端：
http://localhost:8000 - Swagger：
http://localhost:8000/docs
OpenAPI 更新
cd front
pnpm run openapi:update官网与文档站本地预览
cd site
hugo mod tidy
hugo server --buildDrafts --disableFastRender推荐的联调顺序
- 启动后端，确认
/docs和/health正常。 - 启动前端，确认页面能访问并能请求后端。
- 如果修改了接口定义，再执行
openapi:update。 - 如果同时在维护官网，再单独启动
site/预览。