first commit

README.md

@@ -0,0 +1,25 @@
+# Head CT Morph
+
+头颈部 CT 仰头形变工具与网页工作站。
+
+## 主要入口
+
+- `web_backend.py`: 本地 Python API 后端
+- `head_extension_app.py`: 四状态 DICOM 形变核心逻辑与桌面界面
+- `generate_head_extension_video.py`: 仰头角度变化 MP4 生成
+- `video_generator_app.py`: 视频生成桌面界面
+- `WebSite/`: React/Vite 网页工作站
+
+## 本地运行
+
+```bash
+python -m pip install -r requirements.txt
+cd WebSite
+npm install
+npm run backend
+npm run dev
+```
+
+## 数据说明
+
+仓库默认不提交 DICOM 数据、上传数据、运行结果、视频、ZIP 和 `node_modules`。这些内容会在本地运行时生成或由网页上传。