本地开发¶
后端测试¶
.venv/bin/python -m pytest . -q
后端本地启动¶
python -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
.venv/bin/python run.py
默认后端地址：
http://localhost:8000
健康检查：
http://localhost:8000/api/health
前端开发¶
pnpm install
pnpm dev
默认前端开发服务器：
http://localhost:5173
文档预览¶
文档依赖独立放在 mkdocs/requirements.txt。
uv pip install -r mkdocs/requirements.txt
mkdocs serve
默认访问：
http://127.0.0.1:8000
完整检查¶
.venv/bin/python -m pytest . -q
pnpm lint
pnpm build
mkdocs build --strict