# OCCT 转换服务

把 STEP 文件转成 glTF/GLB，供网页 3D 轻量化预览用。**只做转换，不做参数化建模**（升级 2 已决策不做）。

## 依赖

- Python 3.x
- `OCP`（OpenCASCADE Python 绑定，本机已验证可用）

## 启动

```
start-service.bat
```

或命令行：`python occt_service.py`（端口默认 8090，可用环境变量 `OCCT_PORT` 改）。

## 接口

| 接口 | 方法 | 说明 |
|---|---|---|
| `/health` | GET | 存活探测 → `{"ok":true,"port":8090}` |
| `/convert` | POST | 请求体 = STEP 文件二进制，query `deflection=0.5`（弦偏差，越大越轻）→ 返回 GLB 二进制 |

## 调用示例

```bash
curl -X POST --data-binary @model.step "http://localhost:8090/convert?deflection=0.5" -o model.glb
```

## 设计说明

- 零新依赖：HTTP 用标准库 `http.server`，几何用 OCP。
- 单线程：OCP 非线程安全，避免并发崩溃。
- 临时文件用完即删，不落盘。
- deflection 默认 0.5mm（屏幕预览够用，体积小）；要更精细可调小到 0.1，要更小可调大到 2.0。

## 与主项目的关系

- 这是升级 1（网页 3D 轻量化）的转换后端，独立进程、独立端口，不依赖 NX。
- 生产部署时可放服务器（服务器无需装 NX，OCP 是纯 Python 库）。