SuperAPI AI 工具集

thatopen-errors-loading

智能体与模型

查看项目

更新于 10-15 22:18

技能介绍

用途:该技能用于排查和修复 ThatOpen 组件加载 IFC 文件或初始化 fragment 管线时的各类失败,包括 IFC 解析失败、WASM 初始化报错、加载后视图空白、Fragment Worker 报错以及模型中元素缺失。

主要能力:以“错误信息—根因—修复”映射表的形式覆盖 14 类问题(E-01 至 E-14),例如 RuntimeError: unreachable(WASM 版本不匹配)、CompileError(WASM 文件损坏或 MIME 类型错误)、web-ifc.wasm 404(路径错误)、load 时 undefined 属性读取(未调用 setup())、FragmentsManager 未初始化(未调用 init(workerURL))、模型加载但无渲染、元素缺失(默认 excludedCategories)、data 非 Uint8Array、大坐标导致几何错位或 z-fighting、SharedArrayBuffer 未定义(缺少 COOP/COEP 头)、Worker 404/CORS、布尔运算挂起、IFC 文件损坏、WASM 内存耗尽。

必要用法要点:调用 load() 前必须先 await ifcLoader.setup();任何 fragment 操作前必须先 fragmentsManager.init(workerURL);WASM 文件版本需与已安装的 web-ifc npm 包版本一致;load() 只接受 Uint8Array;WASM 路径需带结尾斜杠;.wasm 需以 application/wasm 提供;多线程 WASM 需配置 COOP/COEP 头;大坐标模型使用 COORDINATE_TO_ORIGIN: true;大模型可设置 MEMORY_LIMIT 并过滤 IFC 类。

适用场景:使用 ThatOpen 技术栈加载 IFC 模型的前端开发与调试,尤其是加载失败、渲染异常、性能与内存问题的定位。

限制:资料未提供该技能的安装方式、收费信息、支持平台与版本范围;具体修复效果依赖项目环境与 web-ifc 版本,需按实际报错对照排查。