Update 2026-05-13 16:43:53

2026-05-13 16:43:53 +08:00
parent 6af5c584f4
commit afd7c5fe85
490 changed files with 850 additions and 922 deletions
@@ -0,0 +1,18 @@
+# Backend 打包说明
+
+## Wheel 内置前端产物
+
+- 前端构建目录固定为 `frontend/dist`
+- wheel 构建时通过 `backend/pyproject.toml` 中的 `tool.hatch.build.targets.wheel.force-include` 映射到包内 `app/webui`
+- 安装后可通过 `importlib.resources.files("app").joinpath("webui/index.html")` 读取前端入口文件
+
+## 构建顺序
+
+```bash
+cd frontend
+npm install
+npm run build
+
+cd ../backend
+uv build
+```