网格修复/拓扑修复
网格拓扑与流形检查（本地）
在浏览器本地通过半边遍历、顶点扇与自交分析检查流形与水密拓扑。Worker 解析 STL、OBJ、PLY、3MF、GLB 或自包含 glTF，报告壳、边界环、欧拉示性数、亏格、非流形边、领结顶点与相交三角面对，不上传文件。
拓扑报告
零上传拓扑报告
检查半边遍历、边关联与顶点扇面；三角面不超过 200,000 时检测三角面对自交。边界、补洞与有符号体积属于其他检查。
拖入要检查的网格
支持 STL、OBJ、PLY、3MF、GLB 或自包含 glTF；Worker 检查半边壳、绕序、顶点扇面与三角面自交。
拖入要检查的网格
支持 STL、OBJ、PLY、3MF、GLB 或自包含 glTF；Worker 检查半边壳、绕序、顶点扇面与三角面自交。
选择文件文件上限: 500 MB · 零上传
零上传 · File.slice() / ArrayBuffer → Worker → 边拓扑报告。
使用步骤
- 1
拖入任意支持格式的网格文件。
- 2
Worker 解析文件并构建半边关联图，为共享边配对 twin。
- 3
统计只出现一次的边界边、出现三次以上的非流形边，并检查绕序一致性。
- 4
半边遍历把表面分成边连通壳，统计边界环与顶点扇面，并计算欧拉示性数与亏格。
- 5
三角面未超过自交上限时，用三角面 BVH 检测非相邻面对，包括共面重叠。
- 6
在本地查看拓扑报告，文件不会上传。
数值怎么读
流形边应恰好属于两个三角面。本工具检查半边关联、顶点扇面、壳、边界环、欧拉示性数与亏格，并检测三角面对自交；自交修复属于其他工作。
水密表示没有边界边，也没有非流形边。闭合网格仍可能存在自交或薄壁等问题。
半边分析上限为 2,000,000 个三角面，自交检测上限为 200,000 个三角面。ASCII STL 会先焊接，再做拓扑检查。
领结顶点是只在一点相连的两个或多个表面扇面。此时每条关联边仍可能有两个面，只检查边会漏掉它。半边扇面遍历即使存在非流形边也会统计这些顶点。
壳是一个边连通的三角面组件。闭合壳没有边界半边；开放壳由边界环围绕。欧拉示性数为 V − E + F。亏格按 (2 − b − χ) / 2 计算，仅当所有壳方向一致、边与顶点均流形、没有退化三角面且边界环明确时显示；多个壳报告亏格之和。
自交检测在 BVH 下比较非相邻三角面对，报告相交面对数与涉及的唯一三角面数，并覆盖共面重叠；共享顶点或重合位置的面对视为相邻接触。这里只做检测，不做修复。
打印建议
- 水密报告只是拓扑信号，不代表切片一定成功；薄壁与悬垂需要单独检查。
- 非流形边通常需要修复操作后才能正常切片。
- 自交会让内外区域变得歧义；打印前请在 CAD 或布尔运算中修复。
- 可以先用 clean-mesh 移除退化/重复三角面，再重新检查。
- 单壳亏格为 0 通常表示简单实体；贯穿孔等手柄会提高亏格。
常见问题
参考
- · ISO/ASTM 52900
- · 网格拓扑：边界边、非流形边与自交