2026-05-04-03-50-07 完善项目库可视化和项目管理

WebSite/README.md

@@ -1,20 +1,62 @@
-<div align="center">
-<img width="1200" height="475" alt="GHBanner" src="https://github.com/user-attachments/assets/0aa67016-6eaf-458a-adb2-6e31a0763ed6" />
-</div>
+# 模型逆向系统 WebSite
 
-# Run and deploy your AI Studio app
+本目录是“基于模型逆向体素化及 DICOM 分割标注系统”的前后端一体服务。
 
-This contains everything you need to run your app locally.
+## 环境要求
 
-View your app in AI Studio: https://ai.studio/apps/2e2bd558-1bd5-4424-b1b2-07238ed56ff7
+- Node.js 18 或更高版本
+- npm
 
-## Run Locally
+当前版本的 DICOM 预览、STL 预览和 NIfTI 演示导出均由 Node/React/Three.js 完成，不需要 Python 或 conda 环境。
 
-**Prerequisites:**  Node.js
+后续若接入真实医学级 STL 反向体素化算法，建议单独创建 Python conda 环境，例如：
 
+```bash
+conda create -n revoxelseg python=3.11
+conda activate revoxelseg
+```
 
-1. Install dependencies:
-   `npm install`
-2. Set the `GEMINI_API_KEY` in [.env.local](.env.local) to your Gemini API key
-3. Run the app:
-   `npm run dev`
+再按真实算法依赖安装 SimpleITK、nibabel、numpy、trimesh、vtk 等包。
+
+## 安装依赖
+
+```bash
+npm ci
+```
+
+## 开发运行
+
+前后端统一由 Express + Vite 中间件托管：
+
+```bash
+npm run serve -- --host 0.0.0.0 --port 4000
+```
+
+访问：
+
+```text
+http://192.168.3.11:4000/
+```
+
+## 构建检查
+
+```bash
+npm run lint
+npm run build
+```
+
+## 数据目录
+
+默认演示项目读取仓库根目录：
+
+- `Head_CT_DICOM/`：DICOM 序列。
+- `Head_CT_ReConstruct/`：STL 重建模型。
+
+这些医学影像和模型数据默认不提交到 Git。
+
+## 运行态目录
+
+- `WebSite/data/`：后端共享状态。
+- `WebSite/exports/`：生成的 NIfTI 导出文件。
+
+这些目录是运行态产物，默认不提交到 Git。