OnebotCatalog/occt-service/README.md

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 二进制

调用示例

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 库）。