PLW轻量化平台 · 工业模型轻量化平台用户操作手册
MCP get_task 另返回有界的 mechanicalPreparation:仅转发服务端明确记录的 sourceOnly、consumerOutputAvailable、sourceGeometryComplete 布尔值与诊断码;缺省为 null,部分缺省保持未知。completed 不能单独证明已生成 DPE 可用成果,也不表示预算、机构或帧率通过。REST 与 JavaScript SDK 继续读取 task.stats.mechanicalPreparation;工具数量、请求参数、授权及下载流程不变。
官网客户端下载列表显示服务器已发布且通过校验的安装包及其实际版本。网站升级不会自动生成客户端安装包;部署管理员须保留下载目录和有效清单,网站与客户端可以独立升级;清单顶层版本可省略,列表仍显示安装包文件名中的真实版本。列表为空或校验失败时,请联系部署管理员确认清单和安装包。
版本 0.4.2。PLW 将模型转换、构件检查、成果交付和 GIS 服务集中在同一工作流中。
查看带 DGN 来源场景信息的兼容 GLB 时,可在同一视口查看配对实体与索引网格。点选实体面可核对元素、单元、面索引及实体内节点编号,并查看保留面或边归属的本地属性;点选网格面可核对原始元素内的面序号与带符号点索引。网格序号不作为 B-Rep 持久面编号,也不表示已解释原生业务属性。此类成果采用明确的诊断材质和显示比例,坐标不代表物理米;浏览器校验成果中的来源记录及显示几何,不重新读取原始 DGN,也不据此认定完整 DGN 导入或工程精度。任务继续使用现有上传、提交、查询和下载接口;DGN 源显示增加显式用途及未输出元素处理参数。
DGN 源显示兼容同时包含受验配对圆柱实体、索引网格的单模型 V8 CFB,并保留受验三维折线的原始顶点顺序,服务端需配置 Windows x64 独立读取运行时和受验组件。仅输出 GLB / DPEPack 的 LOD0 诊断场景,保留来源记录,不执行几何压缩、减面、焊接、轴向或物理单位覆盖。显示比例为原始 UOR 的 1/10000,坐标不代表物理米。折线保留线段来源及原始附属记录,未将这些记录认定为已解释的业务属性,原始线型外观须按兼容说明核对。当前配置、完整原生外观、V7、其它原生几何及完整 DGN 导入不在等价保证范围。未兼容的输入明确停止任务。
在“新建转换”上传独立 DGN 后,选择“源显示”用途,再选择未输出元素处理方式。“输出兼容几何,报告逐项列出未输出元素”允许查看受支持部分;“遇未输出元素即停止任务”要求所有图形记录均有输出归属,仍需按兼容说明核对原生语义。转换后可在任务警告和产物的来源信息中核对未输出元素;平台包另附 source-report.json。选择和切换用途时,单位、轴向、减面及压缩控制不参与提交。
STEP 原装配与机构整理
原生 STEP 机械转换可保留原 CAD 装配发生项、FACE 来源和实体连通边界。进入“机构与预算”,检查源场景并下载原装配模板;所有未确认组保持禁止跨实体合并。选择按计划输出后,平台可整理同一原 CAD 连通体内部的显示面,保留不同发生项、未知边界、原属性与材质。源壳和连通体只是显示构件边界,不能据此认定刚体、关节或柔性连接;需要动画的组件仍须逐项核对父子关系、枢轴及运动。
大 STEP 原场景已准备、首次派生尚未满足 DPE 场景头预算时,任务显示“原始场景就绪,待机构整理”。点击“继续机构整理”,选择该原始场景取得模板,预检后另名导出。此时不提供直接置入 DPE 的入口。最终构件数、面数、外观和目标软件帧率以新产物的实际结果为准;超预算成果不能当作流畅交付。原源保留在任务中,普通保留模式不自动减少构件或三角形。
1. 登录与快速开始
在线平台使用漂视账号登录。打开 PLW 时,如果地址栏和本站会话缓存中都没有登录凭据,将直接进入 PiAdmin 首页,不附带登录回调地址,登录后不会由此入口自动返回 PLW。请从 PiAdmin 中的 PLW 入口携带登录凭据进入平台;已有有效会话时可直接打开 PLW,系统显示当前账号可访问的任务与模型。登录凭据刷新后继续使用当前账号;验证服务暂时不可用时可等待自动重试。点击右上角“退出登录”退出本站;切换账号后重新载入对应账号的数据。
创建转换任务时,依次选择输入源、转换目标和参数。文件上传与 ZIP 条目检查完成后,提交按钮开放;切换输入文件时,系统按当前文件重新确认转换选项。提交后在任务中心查看状态。任务完成后打开成果预览,核对模型并下载所需文件。
机械任务成功生成整理成果后,任务警告分别标注“来源读取/保留基线阶段”和“机构整理结果”。前者描述后续处理之前的输入准备,后者描述处理后的成果;是否达到构件和面数预算,以最终产物诊断为准。阶段标注不改变请求字段、任务查询、授权或成果下载流程。
在任务中心取消排队或运行中的任务,不删除任务记录及已有任务目录。取消可能需等待当前同步计算段结束或协作检查点,界面以服务端返回状态为准;未确认取消时显示错误,不视为已停止。删除任务是独立操作,会移除任务记录及任务目录,请按需选择。
2. 客户端安装与升级
在官网选择与操作系统和 CPU 架构一致的客户端,核对版本及 SHA-256 后完整解压,按包内启动说明运行。首次使用输入公司签发的授权码,在客户端设置本地数据目录、可访问的模型目录和并发任务数。
各平台的下载卡片分别标明安装包版本,选择时以对应卡片与文件名为准。在线平台和各操作系统客户端可按各自发布版本使用。
升级前保存正在编辑的工程并正常退出程序。使用新程序目录启动,保留原业务数据与授权配置。启动后在系统状态中核对版本、运行环境和存储目录。
浏览器提前建立但尚未发送请求的连接不再阻止本机服务正常退出。正在传输的响应仍沿原关闭流程处理,任务保存和授权方式保持不变。
官网记录安装包下载点击及网站打开记录。同一标签页会话首次打开上报一次,刷新不重复上报,不持续记录在线时长。下载点击不等于文件下载完成;已登录时可关联漂视账号,未登录时匿名记录。统计不包含模型或工程内容,不影响下载及转换流程,网络上报失败仍可正常使用。离线客户端不启用该官网统计。
3. 输入模型与配套资源
输入源可来自浏览器上传、已配置的服务器样本或允许访问的本地路径。包含外部贴图、材质、属性文档或装配引用的模型,应连同原目录结构打包 ZIP 后提交。
3DXML 的 XML Tessellation 输入保留装配结构与位置、三角网格、内联颜色和已有属性。世界坐标在局部坐标编码前保持双精度,以保留大坐标装配中的小构件细节。同一模型包可包含互相引用的多个 ProductStructure 文档;不同文档中的相同局部 ID 按各自文档区分。请将引用的文档及几何资源保留在包内原路径;缺失、重复、歧义或循环引用会停止整个任务并返回具体诊断。二进制 CGR / V5_CFV3 不属于该 XML 网格读取能力。
同包 XML 材质支持单层 Rendering 的漫反射、贴图和自发光、一维及二维 UV 通道 0,以及完整的 24 位 BI_RGB BMP(40 字节 BITMAPINFOHEADER,无 alpha) 图片;图片以 PNG 无损保留。纹理支持显式原网格 UV 映射(IMPLICIT_MAPPING)、无额外变换的 MODULATE、CLAMP/REPEAT 与近邻、线性、三线性采样。同时有颜色与材质时采用 Rendering 材质显示,内联颜色另存于材质属性。Phong 高光、环境和反射与 PBR 的外观差异会写入任务警告,原始材质属性保留在成果中。其他图片编码、纹理变换、材质层或发生项及默认视图覆盖会停止转换;请按任务报告处理具体兼容边界,完整外观仍需核对。
各级发生项的原始局部矩阵和累积矩阵数值可在构件属性 OccurrenceTransforms 中核对,并区分未声明矩阵与显式单位矩阵。导出网格已应用装配变换,查看这些属性时无需再次变换模型。已声明矩阵为空、重复或结构异常时,任务会停止并给出诊断。
RVM / ASCII REV 的同名 ATT / TXT 属性文档应与模型放在一起。固定列数值记录中的相邻负坐标按原数值字段读取,局部精度处理保留原坐标与法线的十进制文本及源变换。STEP / IGES 可设置曲面显示精度;静态曲面在构件局部坐标编码前保留世界位置计算精度。极窄解析圆柱面通过完整边界、法向和距离检查后生成显示网格;需要额外编码精度的曲面使用逐面局部坐标与原始变换保留结构和位置。无法满足几何或精度要求时,任务会返回具体诊断。以上处理沿用现有转换选项,REST、MCP 与 JavaScript SDK 的提交参数保持一致。glTF 的外部 BIN 和图片应与主文件共同提供。源格式及可选输出以当前部署的转换选项为准。
CIS/2 板件按原轮廓的分段连接顺序和方向读取,支持由多段折线组成的连续边界。圆形开孔按原解析圆参与板件切割,显示精度参数控制输出曲面的细分。
DXF 二维直线折线按原标高和挤出方向转换到世界坐标,再应用所在块实例的变换;三维折线和 LINE 使用原世界坐标。闭合折线保留末顶点返回首顶点的原线段,包括两顶点的往返线段。源单位换算区分原声明的微英寸与微米、国际英尺与美国测量英尺,保留相应物理尺寸。检查成果时,应同时核对折线的高度、方向和源单位。
DXF 多面网格按原面记录的连续索引读取三角面或四边面,遇到首个零索引或缺省索引即结束该面。面记录中的占位坐标不参与顶点编号;索引不足或越界时停止转换,避免把后续索引误接成新的面。
DXF SOLID 无厚度平面实体按原角点、挤出方向和所在块实例变换读取三角面或四边面,并保留源颜色。含厚度声明的实体按原声明检查,处理结果以转换报告为准。SOLID 平面实体与 3DSOLID 实体属于不同类型。
DXF 3DFACE 按原组码读取世界坐标角点、图层、颜色和可见性,属性出现在角点之后或穿插其间时仍保留完整原面。应用自定义组中的内容不作为面角点或显示属性;检查成果时,应同时核对面覆盖、图层和实例位置。
上传的源文件直接保存到企业云盘,云端是持久副本。转换时服务端按需将其拉取到本地临时目录,任务完成后自动释放本地副本;新建转换使用云盘源时可按需重新拉取;新任务记录服务端计算的内容指纹,重试时重新拉取并核对内容,旧任务缺少可信指纹时请重新选择源文件创建任务。云盘容量不足时界面提供购买入口,未保存成功的文件不会进入转换。
4. 输出与交付
机械动画保留与目标预算
在“新建转换”中显式启用“机械动画保留”,选择兼容的静态源和 GLB / DPEPack 输出。完整保留模式保持原构件、三角形、材质与层级,禁用删除小构件、全局合并、焊接和 LOD 简化。无损缓存整理只调整体内完全相同的属性记录及兼容索引布局,不把两个运动件合并成一个。
源任务完成后,点击“机构与预算”检查源 SHA、源网格节点、普通和实例绘制对象、primitive、预计绘制次数及展开三角形数量。默认预算参考 3000 个绘制对象、200 万展开三角形,应按实际目标环境选择。同一节点包含多个 primitive 时分别计数,三角带和三角扇也计入面数;实例几何的面数按实例数量展开一次。超限的完整保留成果仍可另存,但不能视为已满足承载量;目录规模、材质和动画也会影响目标软件的运行表现。
需合并同一刚体内的显示几何时,导入匹配当前源的机构方案,核对组成员、米制世界坐标枢轴及父子联动。默认禁止跨未确认边界合并;只有已确认属于同一刚体的组才可允许组内合并。需单独点选、显示信息或制作动画的部件继续独立分组。源不匹配、节点遗漏或重复、父组缺失或循环均会停止处理。导出使用新成果,原任务文件不被覆盖。
静态检查不确认机械运动约束或帧率,不自动创建动画。交付前应在 DPE / CIMPro 实际导入,验证独立选择、父子联动、枢轴、动画、外观和帧率;不能仅凭任务完成或预算数值判定通过。当前完整保留模式不减少三角形,不能为了达到预算而把未知运动件合并或删除。
“机构与预算”同时显示 DPE 场景头的 64 MiB 预算。预检只显示当前大小;导出时,兼容的源范围及质量审计数据自动无损编码,几何、材质、动画、分组和常用业务字段保持。不能无损满足预算或完整格式检查未通过时停止导出,原成果继续保留。已有审计归档的派生模型可原样保留;需要继续合并或减面时,重新选择对应的机械原始场景包。场景头达标仍须进行目标应用的机构和流畅度验收。
大型质量减面成果可通过经过校验的原范围引用减少审计重复,完整原字段、来源场景和减面记录继续保留,原始模型不被覆盖。重复几何还可复用同一次导出中完全相同的质量检查,分组、枢轴及未确认边界继续独立处理。上述优化不扩大场景头或审计恢复预算,也不自动确认运动关系;错误或未知审计布局仍明确停止。
使用新的规范引用成果时,下载独立 GLB 应同时保存机械报告和“机械审计附件”ZIP;完整 DPEPack 已包含完整资料。审计附件不作为模型预览或置入 DPE。该类成果可检查及原样下载,不能再次进行机构预检或导出;需要继续整理时回到原始场景。已有旧版兼容归档的保留范围不变。
已确认刚体的坐标合并还会核对原三角形方向、退化和法线。细小面、源法线或物理单位不适合重新编码时,对应片段保留原局部坐标和原变换,控制组、父子关系和指定枢轴保持。界面提示保留数量,最终构件数可能增加;请按最终预算和目标软件的实际动画、外观及帧率验收。
若允许显示网格减面,可另行启用质量约束减面,填写目标三角形比例、算法误差及双向有限采样距离上限。界面距离单位为毫米,不默认替用户接受显示误差。算法在各独立原体内核对边界、拓扑、完整源属性、面积和法线方向,并以数值自控及双向有限采样检查偏差;不通过的原体温和重试或恢复原几何。保护组保持原几何,最终面数可能超过目标,应按实际值判断。有限采样不能替代连续全域偏差证书。未启用该项时保持原三角形。
只读候选发现可辅助审查孔图案与几何轴。从源组填入或输入需要检查的源网格节点后点击发现,单次最多 512 个节点,默认不扫描整机。结果保留当前源身份、primitive 及三角见证,可保存 JSON 报告。孔、同轴、母线或交会关系不自动证明关节、固定副或刚体归属,不会直接更新合并方案;须结合原装配与实际运动核对。只有明确物理米坐标才使用物理孔径和距离门槛,显示诊断坐标或单位不明时停止此分析。
| 成果 | 用途 |
|---|---|
| GLB | 单文件模型预览、传输与编辑器接入 |
| DPEPack | 场景、属性及资源目录交付 |
| 3D Tiles | 分层空间数据与地理场景加载 |
| FBX | 对应转换任务的三维交换成果 |
| GIS 切片 | 影像、地形与矢量服务发布 |
FBX 静态成果采用 FBX 7.4 文本格式,保留共享几何和各发生项的位置。导入目标软件后,应核对构件位置、法线和材质。
导入二进制 FBX 静态三角网格时,可选择“完整场景保留”并输出 GLB 或 DPEPack。此方式保留原节点、局部变换、实例、类型属性及 Autodesk 逐面材质代理引用;不接受动画、蒙皮、非三角面、标准材质或贴图。若源文件仅带材质名称和代理 ID,缺少实际颜色或贴图资源,平台会保留引用并提示外观未恢复。请准备完整的材质资源后再验收材质外观。
任务产物列表记录文件大小和下载入口。交付按钮登记所选产物并打开配置的 DPE 编辑器;随后在编辑器中确认导入结果。内网客户端可在对接设置中填写企业 DPE 地址。
产物仓库中的每个产物可单独删除。删除会同时移除该产物的磁盘文件与产物清单条目,任务记录保留并在任务中心标注「产物已清理」;源文件、交付台账与属性变更记录不受影响。删除后该产物无法下载、预览或交付。任务仍在排队或运行时不能删除产物,需等待完成或先取消任务。若该产物已被 GIS 私有服务版本引用,界面会提示并再次确认;已发布服务保存的是发布时的独立副本,删除后仍可正常出图,但这些版本记录的来源任务将无法再回溯。
5. 转换参数
按用途选择场景保留、显示精度、LOD、压缩、单位和坐标系。需要保留原构件与层级时选择场景保留及 LOD0,并查看任务报告中的原始统计和成果统计。
原型装配 GLB 默认使用“普通节点 · 源装配目录”及 LOD0,将每个构件的位置写入普通场景节点,供目标编辑器读取。显式选择“高效实例化”时,目标读取器必须支持 GPU 实例扩展;不支持该扩展的读取器应拒绝文件。需要高 LOD 的实例化交付时,应先确认目标读取器兼容。“源装配目录”保留装配关系,不恢复已烘焙的原局部轴心。
静态 GLB 场景保留将原节点、属性、局部变换和相机与成果一起保留。内嵌 PNG / JPEG 图片按原字节交付,保留 PBR 与 unlit 材质、纹理引用、UV 和采样设置;几何压缩逐视图回解核对,不修改原法线或合并构件。
该场景保留路径支持由独立线段组成的 GLB,以及线段与三角面混合的 GLB。线段保留原顶点、索引、节点变换与颜色;线段数量单独统计,不计为三角面。成果仓库显示线段数量,交付前仍应核对目标编辑器中的线形、位置与属性。
上传独立 .nwd 文件后,在转换参数中选择「RVM 结构 NWD 448 · 保存显示 · GLB」。该配置读取兼容 RVM 生成的 448 版保存场景。GLB 输出所选范围内保存为可见的构件、原层级、米制位置和源漫反射色,并携带原始编号、分类、受支持的内联属性和源材质颜色系数。原始视点、照明和完整 Navisworks 着色效果超出该转换范围。若文件布局超出兼容范围,任务会给出诊断。
选择读取配置后,可按任务需要调整以下参数。
- 转换范围默认选择「全部保存显示构件」。需要导出局部时,选择「指定源节点及其子级」。在同一份 NWD 的成果预览中打开「装配」目录,查找构件并核对「源节点编号」,再填入 1–128 个互不重复的正整数。多个编号用逗号分隔。系统合并这些分支中保存为可见的内容,并保留原父级路径。
- 圆周网格精度默认选择「标准 · 24 段」。还可选择「轻量 · 12 段」「精细 · 48 段」「高精细 · 96 段」,或通过「自定义段数」填写 8–128 的整数。该值控制圆盘边缘和开口圆柱的周向采样。增加分段可让圆周更平滑,同时增加生成的三角面。所选范围内的源三角网格和线段按原记录导出。
- GLB 体积上限(MiB)可填写 1–1024 的整数。系统以最终 GLB 的实际字节数核对。超出上限时,任务以
PLW_NWD_OUTPUT_BUDGET失败,产物列表为空。留空时采用常规文件限制。 - 无损压缩默认启用。交付需要 Meshopt 扩展的 GLB 时,使用支持该扩展的查看器。关闭压缩可生成普通 GLB。
新建任务选择 RVM / ASCII REV 文件或 ZIP 中的对应入口时,表单默认使用场景保留及 LOD0,支持 GLB / DPEPack 输出。此模式保留源局部坐标与变换,不应用静态网格的 LOD 简化、顶点焊接或小构件移除。曲面弦差使用毫米,默认 0.1 mm;修改显示精度会影响曲面采样密度和成果容量。文件容量与模型实际尺寸分别核对。
配置原生读取组件的 STEP / IGES 显示网格使用局部坐标场景交付,支持 GLB / DPEPack 与 LOD0。极薄三角形需要独立局部变换时,原构件下面会保留相应的显示子节点及源三角形对应记录;原面、索引顺序、UV、颜色材质和原世界位置保持关联。已有法线保持原方向,缺失法线沿用原生写出器的曲面求值规则。打包保留局部变换,不再烘焙成世界坐标后重新居中。
该原生场景路径不执行减面、焊接、小构件移除、重算法线或强制双面;不兼容的输出目标或编辑选项会在原生读取前明确报错。LOD 参数未应用时会在任务警告中列出。无损压缩可能使用必需的 EXT_meshopt_compression,目标软件需支持该扩展;也可关闭压缩后导入。显示精度参数是曲面细分请求,导出编码误差检查不代表整模型源曲面精度已验收。交付前应逐模型检查 DPE、CIMPro 的实际导入、位置、层级和材质结果。
6. 构件与属性
兼容的 GLB 和 3D Tiles 可按图元携带的构件编号读取结构属性,支持多个属性类、有符号整数、双精度数值和布尔值;空字符串、零值及业务属性中的原始作用域予以保留。一个网格的不同图元可以对应不同构件,当前要求每个图元内部使用同一个构件编号。此项成果查看能力不改变原生输入格式的转换兼容范围,也不推定工程坐标系或高程基准。
在构件目录搜索名称,选择构件后可定位、隔离、显示或隐藏。面与线发生项各自保留目录记录。属性面板区分原始字段与业务编辑字段,并提供源层级、原始参数和来源身份查询。
切换构件选择时保留其他构件的显隐状态和材质编辑。分块模型中已绑定同一来源身份的发生项同步选择状态;选择与取消选择只影响当前预览,不修改原始模型或下载成果。
模型名称、实例发生项、原父子层级和共享几何分别管理。构件数量、几何数量、三角形数量与绘制批次数分别统计。
普通 GLB 的构件目录按文件中的场景网格节点组织,保留同名发生项、原节点层级和原 extras 字段。选择、定位和显隐操作作用于当前预览,下载模型保持原字节。
在产物仓库预览由「RVM 结构 NWD 448 · 保存显示 · GLB」生成且带有源记录的成果。点击视口中的模型片段,在属性面板的「NWD 源构件」中查看该片段所属的原构件及其层级位置。「源节点编号」标识该构件在本文件源层级中的发生项,「源对象编号」标识对应的原始对象。面板按成果随附记录显示「源分类」和受支持的内联「源属性记录」。「源片段漫反射色」对应所点击片段的原材质,同一构件的不同片段可分别核对。打开目录的「装配」模式,可按构件名称或源节点编号搜索。点选可见片段时,已打开的源装配树会展开相应的父级并高亮该构件。
JT 源显示:上传独立 .jt,选择 GLB 或 DPEPack,再明确选择“源显示 · 按源顺序首个 LOD 分支”。可使用源材质数值的 PBR 近似,未解决材质显示为明确诊断色,或选择统一诊断色。适用兼容 JT10.1/10.3 静态三角场景及单一内含根分区;无法解释的节点状态或嵌套分区停止任务。原始单位必须完整一致,服务端须具备独立读取运行时;不接受 ZIP 入口或减面、坐标修改参数。首个分支依据文件顺序,不代表原生当前配置或最高精度。源轴向按原数值方向显示,原生世界轴向、当前状态、完整外观、外部引用和 B-Rep 工程精度不在等价保证范围。不兼容输入停止任务,请查看失败原因及转换报告。
携带 JT 原始源记录的 GLB / DPEPack 按原始发生路径显示源装配目录,共享几何发生项可分别选择和显隐。本地属性以原始字符串、整数、浮点、日期字段和资源引用类型只读显示;缺少本地表与原始空表分别记录。拾取三角面后,可在“原始来源记录”查询发生路径、本地对象 ID 和角点数组序号;这些序号不作为原生 B-Rep 持久实体 ID。浏览器核对已有场景记录,原始 JT 的读取在转换任务中执行。
DXF 块实例保留原 INSERT 及其附属 ATTRIB 的完整有序组码,包括文字样式、重复扩展字段和内嵌文字记录。原记录随实例层级交付,标签和值继续分别提供;文字记录的保留不代表已生成对应的文字显示几何。
7. 颜色、材质与贴图
围绕完整模型和局部细节检查颜色、透明度、表面方向、纹理位置及动画。使用不同观察方向与照明检查表面;选择高亮与原材质显示分别观察。
OSGB 贴图保留源纹理的重复、边缘夹取或镜像重复设置。读取组件提供明确的放大、缩小滤波设置时,成果保留对应的采样方式;不支持或不完整的设置会明确报错。检查纹理边界时,应同时核对模型的 UV、透明度和图片内容。
OSGB 分页读取按每次页面引用处理父级状态,标准材质和二维贴图仅在支持的静态状态范围内转换。自定义着色器、动态回调、额外纹理单元以及不支持的图元、图像层级或采样设置会明确报错,避免按空状态导出。读取组件版本不匹配时,请更新完整客户端。
成果报告记录源资源、材质映射、数据完整性检查和具体文件的转换结果。截图应保留实际视口和观察信息,便于与源模型对照。
8. 模型视口
普通三维视图支持旋转、平移、缩放、框选、定位与构件检查。地理视图用于具有空间参考的数据,可结合影像、地形和矢量图层查看。保存检查截图时记录任务、视角与所选构件。
9. 容量与质量报告
源文件、显示模型、完整工程包和压缩交付包分别记录容量。界面 KiB / MiB / GiB 采用 1024 进制;API bytes 保留原字节数。输出报告分别记录构件数量、属性、材质图片、法线、尺寸和转换结果。
10. GIS 服务
选择 GIS 数据及对应的坐标系、层级和样式后创建切片任务。完成后在服务目录发布、暂停或更新服务,并检查地图中的空间位置、图层范围与样式。
11. API、SDK 与 MCP
REST、JavaScript 和 MCP 通过同一任务链路提交和查询转换。先查询 GET /api/v1/formats 的 outputs、inputSupport 和 upload,再提交任务。接口参考页提供 REST 路由、JavaScript 示例与从当前服务生成的 MCP 参数。
业务凭据由宿主运行时提供,不写入示例文件或模型包。任务、下载和 GIS 服务按登录身份授权。
12. 任务处理
任务中心显示排队、运行、完成、失败与取消状态。页面在前台时约每两秒自动同步任务状态,同时显示当前阶段、阶段说明、已运行时间和最近同步时间;转换结束后自动显示完成状态、预览入口和可下载产物,无需点击刷新。STEP / IGES 读取器完成读取、装配传输、网格离散及读取器输出后逐项更新;输出后仍可能继续核验和整理。没有可量化进度时显示“处理中”,不使用虚构的百分比或剩余时间。任务查询暂时失败时保留已确认的服务连接和上次结果,查询超时后自动重试,无需重新加载页面;切回页面或网络恢复后立即同步。搜索与筛选条件会保留,任务完成后会从“转换中”筛选结果移出。失败记录可展开完整详情,按源文件、构件定位及错误码处理后重新提交;原任务记录保留用于追溯。自动同步沿用现有任务查询、授权和取消接口。
13. 数据保管与许可
按企业制度保存原件、转换报告、成果清单和编辑工程,定期备份业务数据。客户端及服务器随包提供相应第三方许可;公司授权与业务数据独立保存。
在模型预览的装配树中,点击源节点旁的“属性”可查询该原组的来源字段。原组即使没有可绘制几何,也会保留其层级和属性;几何数量与来源节点数量分别统计。
RVM / REV 成果的装配目录还提供“原始属性文档”。展开原文档层级并点击“属性”,可查询对应原组的完整路径、原组起始行和原始字段;同名组按原路径分别显示,原属性组数量与几何映射数量分别统计。
同一源构件的其他装配放置沿用其核对后的原属性,同时保留各放置的位置与几何。属性归属以原组层级及明确的构件、数据库和属主标识为准;无法确认归属的字段仍可在“原始属性文档”中查询。
RVM 旧失败任务重试
旧 RVM / ASCII REV 任务因源精度或原拓扑记录失败时,兼容默认设置的任务会显示“按保真模式重试 · LOD0”。点击后,新任务保留原局部坐标、层级与源拓扑,交付保真 LOD0;旧任务、错误和原参数继续保留。
含自定义高级设置或其它输出目标的旧任务显示“检查参数后重试”,提交前请核对设置。新建、重新选择文件和 ZIP 入口仍使用当前表单默认值。任务卡的“LOD proto”标签来自旧请求字段,本身不说明是否启用了简化或场景保留。
显式离线显示减重
已转换的米制静态原型 DPEPack 可通过 node bin/optimize-model-pack.js model.dpepack display.glb --lod 2 --small-part-mm 30 --merge-materials 导出显示减重版。尺寸过滤按原 LOD0 构件包围盒的最大边长判断,单位毫米;原材质数值保留。同材质合并会改变单构件选择粒度,原 ID 和过滤清单保存在输出旁的 JSON。默认使用 meshopt 压缩,接收端须支持对应扩展;无压缩输出使用 --no-compress。材质合并仅兼容无贴图、无顶点色且有源法线的静态三角网格,未兼容属性明确停止。详见 docs/offline-mesh-reduction.md。
需要保留机构的独立变换时,可在离线命令中使用 --motion-groups groups.json,按已核对的构件 ID 与世界坐标枢轴逐组输出;不完整或重复分组会停止。组内构件合并后不能逐个选择,可用 parentId 指定父子联动。分组须自行确认,工具不自动识别运动关系或创建动画;目标应用中的机构运动仍需验收。该选项保持 LOD0 和全部构件,不能与全局材质合并同时使用。
该能力为显式离线命令,不自动接入普通转换任务。现有 REST 路由/参数、MCP 工具名称/schema 和 JavaScript SDK 方法均保持不变;现有按三角数处理的小构件参数不等同于此尺寸阈值。
诊断场景的显示单位
诊断坐标显示产物在视口、测距和导航中使用显示单位,不能据此解释为米或原生物理尺寸。诊断材质不表示原生外观;查看器读取显示产物中的声明和属性,不重新读取原始工业文件,也不由预览推断整类原生导入完成。现有任务、REST、MCP及JavaScript SDK接口和原生输入兼容范围保持不变。
带有明确 RVT 原始属性档案声明的 GLB 可沿用“完整场景保留”通道。预览中选中构件后可只读查看源文件保存的参数、全部字段及原始 JSON,并沿类型、族、标高、管段及材质引用查阅关联记录,类型参数与管段材质保持各自的原始记录;属性档案随模型保存,不依赖源 RVT 路径。原始保存值不代表公式已重新计算,也不代表完整 RVT 几何、材质和外观已通过转换验收。REST、MCP 与 SDK 的方法、参数及返回字段保持不变;属性面板不新增远程文件读取接口。对明确声明为未放置类型定义的档案,原始几何记录随模型保留,且不计入项目实体的渲染和构件数量。此类记录的父级与放置字段仍属源数据,不能据此认定原生可编辑枢轴或完整实例范围已经通过验收。交付验收应区分实体实例、类型定义与目录容器,并逐项核对原始构件身份、父级、参数和外观,并在实际显示分辨率下检查旋转、缩放及选中时的帧率与表面稳定性。参数档案完整或转换任务成功,不能替代这些检查。RVT 导入对象所引用的外部图形、字体及材质资源应随原工程提供。仅保留引用、没有图形缓存的对象无法据此恢复其显示内容;原始属性档案仍可保留这些引用和参数。源构件的 UniqueId 与当前记录定位编号分别保留;两者编号不同时,按源索引对应关系核验,不能改写原始身份。
对已核验的原生曲面,模型保留构件及类型的原始图形记录、源材质引用、参数与层级。转换后按源面核对位置、法线及索引的一致性,有效阶段引用仍可查阅。无法完整解读边界的构件保持未通过状态。REST、MCP 与 JavaScript SDK 的公开方法、参数及返回字段保持不变。
对边界可完整核实的非等参直纹面交线,转换按两侧原始曲面和完整参数范围恢复显示边界,并逐面校验法线、覆盖及编码后的闭合性。原始双 UV、图形记录、实际材质引用和全部随包属性继续保留;无法唯一核实的交线仍报告兼容性限制。此项不表示整份原生模型或缺失的材质资源已通过验收,REST、MCP 与 JavaScript SDK 的公开方法、参数及返回字段保持不变。
对可唯一核实的原始平面墙体交点,转换保留完整原始图形与显式 UV 派生记录,并校验原始拓扑、交点范围、材质引用、法线及实际编码缓冲区;预览和再次压缩时执行相同的来源校验。楼层、阶段、类型和填充参数继续作为原始属性保留。该能力不替代缺失的外链或外部材质资源,无法完整核实的几何仍报告兼容性限制;REST、MCP 与 JavaScript SDK 的公开方法、参数和返回字段保持不变。
对已完整核实、但直接编码后会退化的窄小墙体,转换可使用独立的局部显示坐标节点,保留原始构件坐标、顶点、法线、索引和层级。加载与再次压缩时同时校验局部坐标、原始交点、完整面覆盖及实际显示缓冲区,并保持原有位置误差范围;不满足条件的几何仍报告兼容性限制。REST、MCP 与 JavaScript SDK 的公开方法、参数和返回字段保持不变。
兼容的 RVT 保留场景可保留大坐标下的细小几何,同时保持原构件身份、层级、源坐标和参数引用。墙体类型参数可沿原始类型链接查阅。绘制优化不增加源构件,也不替代原始外观与整模性能核验;REST、MCP 和 SDK 的既有方法签名不变。
兼容转换包可压缩保存解析校验记录,加载时校验并还原原值,源参数及材质绑定保持保留。受支持平面的显示三角形划分可在面内调整,并保留完整原始索引;面边界、三角形总数和法线须保持一致。此项不扩大原生格式或原始外观的兼容范围,REST、MCP 和 SDK 的既有方法签名不变。 材质来源记录随兼容包校验还原;档案不完整或校验失败时拒绝加载。源参数和材质来源中的数值保留负零符号,既有材质绑定与源记录引用保持不变。 对于已核验的幕墙宿主与面板引用,PLW 预览区分内部宿主几何与可见面板;宿主原始几何、身份、参数和父子关系仍随包保留。加载前核对随包原始记录,引用缺失或不一致时拒绝加载。此项不代表完整建筑几何和原始外观已经通过验收,既有 REST、MCP、SDK 方法签名保持不变。 已解析的源材质图形颜色或外观预览色,在 GLB 中按标准线性 RGB 编码,原始 RGB 字节与透明度记录保持保留。预览的不透明度范围为 0–100%,包含完全透明;此范围不改变原始参数,也不代替纹理与完整外观验收。REST、MCP 与 SDK 方法签名保持不变。 对同时包含原始平面和圆柱面的兼容构件,依据可唯一核实的原始共边坐标表达显示边界,并保留原始图形记录、参数和面样式引用。加载时校验原始身份、UV 历史及几何覆盖;不能唯一核实时仍报兼容性未通过。此项不代表完整 RVT 几何、材质外观或帧率验收,REST、MCP 与 SDK 既有方法签名保持不变。 对兼容曲面,预览可采用有来源校验的舍入退化处理:仅排除编码后已无面积且原始端点位于双精度舍入范围内的绘制项;完整原始索引、面引用、属性、材质和层级继续随模型保存。未满足条件时仍报告兼容性限制。 对具有可验证共面四边形的兼容网格,显示时可仅交换同一面内的内部对角线;保留原始索引存档、完整面边界、三角形总数、顶点、法线、材质及层级。局部显示原点可取自原始边界、顶点,或使用边界中心搭配单个原始坐标分量,并继续校验世界坐标误差、朝向和闭合性;不扩大原生几何或外观的验收范围。 对已编码为零面积的绘制项,还可采用独立的来源容差校验;仅在原有来源拼接预算内、完整源面仍被表示且非零线框边集合不变时优化绘制索引。原始索引、顶点、法线、属性和层级继续保留,校验不通过时仍拒绝兼容。 对受支持的共线退化绘制项,可在严格来源校验下验证同一源面的精确线段覆盖和相应法线,并将完整原始索引无损压缩随包保存。加载时按声明预算回读索引档案;超限、损坏或来源不符的档案拒绝加载,不据此省略原始构件或扩大原生几何验收范围。 对同一兼容构件中互不相交的原始面,可按声明顺序组合面内对角线调整与共线零面积绘制处理;各步骤独立回读校验,完整原始索引、源面、顶点、法线、材质、属性和层级继续保留。源面重叠、步骤次序或数据校验不符时拒绝加载。 对具有可核实重叠剖分的兼容不透明楼板,可逐步校验原始平面的覆盖关系及局部替换前后表面并集相等,并无损保存完整原始双精度顶点、法线和索引。每个原始面仍保留显示表示,材质绑定、参数及源层级不变;不支持的材质映射或不能核实的几何继续报告兼容性限制。 平面边界的兼容读取同时校验原始实体内的端点见证、源面范围及闭合关系,并保留原始 UV 和图形记录;不满足核验要求时仍报告兼容性限制。 构件目录支持按名称、构件编号及保留的原始元素 ID、源 UID 搜索,便于定位同名构件并查看源参数。
兼容 RVT 便携模型可使用无损压缩的原始属性档案,按构件读取时还原原始 JSON 字节,保留大整数及负零等保存值。属性档案随模型交付,不依赖源 RVT 路径或外部属性服务;旧版兼容档案仍可读取。无法识别的档案版本、压缩声明或校验失败会明确报错。此行为不表示缺失的外部资源、原始几何或材质外观已恢复;REST、MCP 与 JavaScript SDK 的公开方法、参数及返回字段保持不变。
同一模型无损重新封装后,可继续读取随包保存的原始属性。每次导入仍校验属性档案的完整性;档案声明或压缩内容不一致时拒绝加载。
兼容的柔性管解析结果可按原始曲面和封闭边界保留显示几何,并保留源面记录、材质引用及保存参数。曲面边界或显示状态无法核实时,构件仍标为未通过。几何恢复不表示源材质外观或整个原生模型已经完成转换验收;REST、MCP 与 JavaScript SDK 的公开方法、参数及返回字段保持不变。相邻圆柱段沿轴向连接的兼容圆弧边界,还须核对两侧原始曲面、参数范围及完整闭合构件;无法核实的边界继续保留未通过状态。兼容的复合封闭构件按原始边界连接关系分别核验各封闭部分,保留接触位置的全部原始面及构件身份;渲染坐标调整只作用于显示表示。重复导入同一源文件时,兼容的无损属性存储布局会核对全部原始记录及定义几何;原始内容不一致时拒绝复用属性缓存。DPE 中兼容的源构件批处理保留原始层级与属性,透明度后处理使用当前渲染表示;源构件的材质与编辑状态继续随工程保存。
普通 FBX 的程序贴图缺少可验证的 Mono/Output 设置,或反射贴图需要未支持的渲染器语义时,任务会以 PLW_FBX_MATERIAL_CONTRACT_UNSUPPORTED 停止,并给出源材质、贴图 ID 和缺项。请保留原模型及任务错误,避免以猜测的颜色或贴图替代。
批量转换
在“新建转换”中展开“批量转换模型路径”,每行填写一个已允许访问的完整模型路径,一批可提交 1 至 128 个模型。各模型使用本批选择的输出目标和参数,分别建立任务并按配置的转换并发执行。任务列表在可见且登录有效时约每两秒更新,重新聚焦时立即查询。提交结果逐项显示任务编号或错误;响应未确认的模型应先核对任务列表再重试。ZIP 资源包请使用单模型入口选择流程。各格式的读取、资源完整性和成果验收要求按相应兼容说明执行。
原生 CAD 失败记录
STEP / IGES 任务失败时,详情可能附带读取器已报告完成的读取、转入、网格化或导出阶段及累计毫秒数。这些记录用于核对失败前的进展,不能据此认定下一阶段就是故障位置,也不表示已有可交付成果。未记录的阶段表示没有可用观察,不代表耗时为零;任务状态、错误说明及产物校验仍是交付判断依据。
SolidWorks 保存显示
兼容的独立 SLDASM 可显式选择保存显示通道,输出 GLB / DPEPack。该通道完整读取文件内保存的显示数据,保留源发生项层级、局部变换、具名显示状态及源面颜色记录;不执行减面、焊接、重算法线或重复单位换算。源颜色整数保留供核对,显示采用明确的显示色映射与无光照材质;参数化 CAD、外部文件实体和原着色器或环境光照等价不在此通道范围。文件损坏、未兼容的保存数据或状态名称不匹配会停止任务。
预览状态使用精确的源名称;不指定时选择源顺序首个状态,该状态可能为空,不能认定为源当前状态。所有源具名状态仍保留在 GLB 的 scenes 中。任务警告与 artifacts[].meta.nativeSource 提供原 SLDASM 身份、所选状态、保存网格范围和兼容边界;原 SLDASM SHA-256 与派生显示 GLB SHA-256 分别记录。下载的压缩 GLB 需要支持 EXT_meshopt_compression 的查看器。
选择独立 SLDASM 文件后,在“SolidWorks 转换用途”中选择“保存显示”。如需指定预览,填写与源文件完全一致的显示状态名称;留空按源顺序选择。选择 GLB 或平台原生包,提交后查看任务警告及成果来源。
保存显示的外观与可见性
普通显示 RGB 使用明确的显示色到线性颜色映射。源着色器、法向纹理和环境数据保留为来源信息,不保证与原应用的渲染一致;兼容材料的透明度采用已披露的属性映射,尚无源应用接口对照。源状态中隐藏的组件几何仍保留在成果中。显示全部已保存几何的派生检查视图,不代表源当前状态。预览状态名称最多 4096 个字符。
STEP AP242 源镶嵌显示
对于可完整识别的纯镶嵌 AP242 文件,GLB / DPEPack 转换自动保留源面、三角形、坐标与法线对应、产品层级、发生项姿态和已指派样式;按源单位换算为米,保留原坐标轴。该路径使用文件已有三角网格,不重建参数化 CAD,CAD 重新镶嵌公差不会应用,任务会记录相应提示。
源未指派材质的壳保持未指派。原退化三角形完整保留;若其源法线为零向量,该向量以自定义属性保留,该图元省略非法标准法线。源样式按明确的颜色映射传输,不保证原照明效果一致。原声明和兼容性差异记录在成果来源信息中,不代表文件通过全部 STEP EXPRESS 规则。混合表示、未知结构或不能证明完整覆盖的数据继续使用标准 CAD 读取路径及其完整性检查。
REST、MCP 和 JavaScript SDK 的 AP242 入口及函数签名不变,无需新增格式选项;接入方仍应核对任务警告、来源身份与下载成果。压缩成果需要支持 EXT_meshopt_compression 的查看器。
源报告的 sourceDeclaredMotionEvidence 记录已检查配置内的运动声明诊断。status: complete 且计数为零,仅表示已检查的原始实体与复杂实体类型名中未发现已识别的运动声明;不表示所有运动语义均不存在。未完成检查或未提供该字段时按未知处理。静态产品发生项和位置变换不能作为刚体合并、关节或运动范围的确认依据。诊断不改变原几何、名称和属性;REST、MCP 与 JavaScript SDK 的入口、参数和调用签名保持不变。
STEP 源缺陷的显示恢复
STEP 读取会核对源引用和完整面覆盖。只有原闭环与原曲线能唯一确定端点,或原壳中的既有解析边能唯一确定空面边界时,才生成任务内派生读取文件;不覆盖原文件。端点阶段保留原面记录,空边界阶段明确记录被修改的面边界列表,并保留原曲面、曲线、顶点、装配和材料。不能证明唯一恢复时任务停止,不以部分面作为完整成果。
任务警告和 artifacts[].meta.sourceCAD.sourceReadPreparation 分别记录原文件与各阶段输入身份、修复范围及来源边界。源中与该恢复无关的原有开口继续保留。这类成果用于完整显示,不代表原 STEP 无误或已经通过闭实体 CAD 验收;参数化重建及工程曲面精度仍需相应验证。
STEP 源缺陷面的显式显示恢复
普通 STEP 任务默认保持严格读取。只有明确接受显示恢复用途时,才提交 options.cadDisplayRecovery: {profile: 'source-geometric-inconsistency-c0/1', maximumDeviationMm: 0.5}。该选项仅用于 STEP → GLB / DPEPack;省略即不启用,null、false、字符串容差、其它 profile、额外字段及其它输出目标均拒绝。当前 profile 的容差固定为数值 0.5 毫米,不能调大。
恢复范围限于源文件没有已验网格的缺陷面;已有合格源网格不由此替换。任务必须取得全域 C0 偏差证书并核验最终输出,无法证明时停止任务。显示恢复不验收原始 CAD 的几何一致性、解析法线等价或闭实体,不能据此作精确 CAD 交付。请同时检查任务警告、恢复证书与成果核验结果,不能只凭预览判断验收。
保持 LOD0、原装配层级与源单位,禁止减面、焊接、删除小构件、重算法线和单位覆盖;本 profile 使用 linearDeflection: 0.5、linearDeflectionType: 'absolute_value'。刚体轴向转换仍按既有选项核验。
在新建任务中选择 STEP 文件和 GLB / DPEPack,主动勾选“STEP 源缺陷面显示恢复(0.5 mm)”。该项默认未选;更换源文件或 ZIP 入口会清除选择。启用后,表单固定上述显示选项并关闭不兼容设置。离线客户端进入同一任务表单,选择和验收要求一致。
DGN 原生记录显示
提交前读取服务返回的 dgnProfiles。仅当 profile: "source-native-display-v2" 且 available: true 时使用此用途;现阶段服务端须使用受验 Windows x64 运行时;安装包须完成包内依赖探测与实际转换配置。缺少受验读取组件或运行时会明确拒绝任务。已有 source-display 的 32 MiB、单模型、GLB / DPEPack 约束保持不变。
新用途使用 targets: ["glb", "3dtiles"] 及 options: {dgnProfile: "source-native-display-v2", dgnRemainderPolicy: "report-unrendered"},也可只选其中一个目标。只接收独立 DGN V8 CFB,来源大小上限为 256 MiB;上限不表示任意文件或全部原生几何均兼容。选择 require-complete 时,有未输出几何即停止。MCP 对应 dgn_profile / dgn_remainder_policy,工具名称和 SDK 提交函数不变;通过既有任务查询、取消和成果下载链路交付。
此用途固定局部诊断坐标、LOD0、不压缩,不接受源单位、轴向、锚点、法线重算、减面、工作程序或依赖路径覆盖。业务属性按原始 owner、类、属性身份及类型保留;重复名称、空字符串和数值零分别保留。原始样式、可见性、填充、物理 SI 单位或源坐标系未获验证时,报告明确标识其边界,不据任务完成状态认定完整原生导入、测绘定位或工程精度。服务未提供此用途时,前端不启用该选项。
视口随附脚本与模块需要完整部署,用于构件属性、诊断显示单位和本地预览。补齐静态查看器资源不改变转换任务参数、REST 接口、MCP 工具 schema 或 JavaScript SDK 函数签名。
STEP 显示成果可在本地视口的“目录树→构件”中按显示节点搜索、选择和定位,并查看该节点随文件保留的属性。目录数量按当前 GLB 的显示网格发生项统计;同一节点的多个材质 primitive 共享一个目录身份。显示节点数不等于原 CAD 实体数,也不证明机械刚体或关节关系。
旧版 STEP 显示成果未记录原 STEP 文件指纹时,原文件身份显示为未知;目录仍按当前 GLB 节点建立,不以原生显示场景的指纹代替 STEP 源文件指纹。
从产物仓库预览派生成果时,视口链接保留该产物的身份,重新打开链接不会改为同任务的主成果。原有 GLB、STEP 原生 GLB、DPEPack 和 3D Tiles 链接继续可用;访问链接仍须具备该任务的权限。成功安装另一个模型时清除之前的构件多选与范围选择锚点;同一模型的 LOD 切换保留多选状态。
RVM 原生显示遇到参数退化、无法确定有效显示法线的几何时,会明确停止并保留失败原因;不会通过任意补造法线或删除原始几何来完成转换。此兼容边界不改变任务提交、查询、重试及成果下载接口。
DGN 原生记录显示可用于随附相应读取组件的 Windows x64 客户端,以及由管理员配置对应 Linux x64 组件的服务;是否可选以当前服务能力为准。仅输出读取器可核验的兼容显示元素,未输出记录与几何错误在任务报告中保留;不据转换完成认定物理单位、完整外观、有效可见性或全部原生几何已验证。此平台适配不改变 REST 路径、MCP 工具名称或 JavaScript SDK 函数签名。
原生 STEP / IGES 对兼容的大型装配减少重复处理,读取时继续保留源几何、材质、命名、属性、父子层级及局部坐标,并在写出前后核对来源与世界变换。读取优化不自动确认机械刚体或运动副,也不改变 REST、MCP 和 JavaScript SDK 的请求参数。
柔性平移审查方案
先在“机构与预算”选择已完成任务的原始场景并检查来源。服务能力 capabilities.flexEndpointReview.available 为真时,可使用“导入柔性审查方案”选择已有的源 SHA 绑定方案文件。界面显示两个包含原几何的父子控制组的名称、局部方向及最大正负行程、原柔性件和局部或完整覆盖范围;不需要手工输入矩阵或逐顶点权重。核对摘要并确认后点击“生成工程候选”。完整方案可在高级区下载。方案不匹配当前源、包含未知字段、源单位不明确或来源不兼容时停止处理。
方案当前限定一个真实源柔性件、两个包含原几何的父子控制组和显式方向的平移,每驱动最大正负行程不超过 0.2 米,不自动发现或确认整机运动机构,也不执行刚体合并。局部成果明确列出覆盖范围,不能代表完整机器。候选保存完整原始来源档案及方案、报告,只支持校验和下载;新的转换、缓存、减面、重分组或机构导出须回原始场景。普通 glTF 不能强制消费端遵守这些行程及方向限制。
生成成功不等于原安装、旋转、独立动画、外观、预算或帧率已通过验收。此类候选不能一键正式交付 DPE;应在目标软件中核验实际效果,并保留完整 DPEPack 及来源档案,不能只分发脱离档案的 GLB。
只读源几何关系候选
在“机构与预算”选择已完成任务的原始 DPEPack,点击“检查源场景”。来源兼容且 capabilities.autoRelationCandidates.available 为真时,“源几何关系候选”显示当前任务、原产物和精确源 SHA。确认“仅生成候选报告”后点击“生成只读候选报告”,可查看完成扫描、进入数值分析及其余保持未知的覆盖数量,并下载完整报告。结果不会写入机构方案,也不会开启合并许可。
算法从原世界几何提出尺度、方向和邻接候选;相似、同色、几何环路闭合或目录关系都不证明同一刚体、销轴配合或机械关节。未匹配或超出工作预算的原件保留未知,不能据此宣称整机运动已识别。生成报告不等于独立动画、外观、预算或目标软件帧率验收,不能直接作为正式 DPE 模型交付。
原始源包仍保留在任务中。候选 JSON 绑定源 SHA、源清单及原 primitive 见证,但不是模型文件或自带全部几何的独立来源包。移交时请同时保存完整原始 DPEPack 与报告,不删除配套文件或将报告当已确认机构方案。归档派生成果若仅支持检查与下载,应回到原始源包进行候选分析。
已有无损压缩的静态 GLB
完整场景保留可直接接收本平台先前输出的静态无损压缩 GLB。兼容范围为核心场景、核心或无光照材质、必需的 EXT_meshopt_compression、一个内嵌数据缓冲与一个无 URI 的虚拟回退缓冲,以及 ATTRIBUTES / NONE 视图。转换核验完整文件布局、实际及展开预算、每个视图的解码数据、有限坐标和索引范围后,保持输入文件的完整 SHA 与原编码,不重排构件、改变层级、重算法线或删减三角形。
compress: false 关闭本次新增压缩,不表示解压输入文件中已有的编码。成果 meta.inputCompressionRetained 及场景保留审计中的同名字段为真时,表示保留已有压缩;目标软件仍须支持该扩展。其它压缩模式、过滤方式、动画、蒙皮、形变及有独立原生数据消费合同的场景使用各自兼容通道,不能通过此静态通道绕过来源检查。接口名称和现有请求参数保持不变。这项保留不确认原 CAD 的运动副、世界朝向、工程精度或运行帧率。
机构保留时的主交付模型
机械处理选择 mode: "preserve"、losslessCache: false 且不减面时,平台会核对处理结果是否确实没有几何、层级、材质或业务信息改动。符合上述静态压缩兼容范围、没有需要恢复或重包的既有审计,并且原编码本身满足 64 MiB 场景头预算时,主交付 GLB 可保持输入的完整文件字节;配套 DPEPack 继续保存完整当前机械报告、来源校验及原有附件。目标软件仍须支持输入中必需的压缩扩展。
主成果的 meta.sourceFileByteExact 表示交付模型是否与所绑定源场景的完整 SHA 相同;meta.inputCompressionRetained 表示主模型保留了已有压缩。原始场景与主交付成果分别核对,不以原始场景的 SHA 代替主模型的 SHA。启用缓存、减面、机构方案、实际业务修改或审计重包时继续使用相应处理路径,不撤销这些修改来追求原文件相同。源读取内容发生变化时停止并要求重新载入。
原样保留不会减少构件、面数或绘制数量,也不表示机构、动画或帧率通过。来源准入的场景头上限不能替代 64 MiB 输出预算。原有 REST、MCP 和 JavaScript SDK 提交、检查、导出参数保持不变,不接受客户端声明的无修改或可信来源开关。
原 CAD 体内显示整理
在“机构与预算”选择后端原生 STEP 任务的 mechanical-source,检查来源后选择“原 CAD 体内显示整理”。也可在普通任务显式传入 options.mechanical: {mode: "source-body", losslessCache: false}。默认仍为 preserve,不会自行整理。该模式复用后端维护的原 CAD 来源证明、原装配模板及原 EDGE 引用形成的连通显示体白名单,不需要客户端传入逐节点方案。来源、单位或静态布局不兼容、没有可恢复原体、模板超过既有安全上限时明确停止;上传的原生声明及调用方的可信标记不能替代后端证明。
只在同一原发生项及原 CAD 连通显示体内部整理 FACE 显示碎片,保留三角形数量、材质和业务来源、原父子上下文及经守门的源坐标框架。未知归属片段独立保留。所有自动生成的模板组仍为 mergeAllowed: false、rigidBoundaryVerified: false,枢轴是原发生项原点,不是关节识别结果。此模式不接受 plan 或 reduction,不授权跨原体合并;需要已核对机械分组或减面时使用相应显式模式。原始源包和完整来源映射继续保留。CAD 连通体不是机械刚体或运动副证明,数量下降不表示机构、外观或帧率已验收。
REST 检查与导出沿用 /api/v1/tasks/:id/mechanical-review/check、/export,传入 {artifactId: "mechanical-source", sourceSceneSHA256, mode: "source-body", losslessCache: false},预算沿用原字段及默认值。原 SHA 可取自已验证任务成果信息;需要检查来源时,GET .../mechanical-review?artifactId=mechanical-source&summaryOnly=true 仅返回 SHA、统计、能力和模板计数,不返回大型模板或完整身份目录。summaryOnly 仅接受 true / false,省略时保持原完整检查响应。capabilities.sourceBody 表示本来源是否能进入该模式,不表示运动或消费端验收通过。
MCP 不新增工具。convert_model.mechanical_options.mode 或 optimize_mechanical_artifact.mechanical_options.mode 可显式为 source-body;后者只需 task_id、实际 artifact_id、source_scene_sha256 和原 action。inspect_mechanical_artifact 可设 summary_only: true 获取小摘要,避免搬运完整分组。完整映射仍通过机械报告下载,而非删去审计记录。
JavaScript 可调用 require('./src/mechanical-source-body-client').processSourceBodyArtifact({base, token, taskId, artifactId: 'mechanical-source', sourceSceneSHA256, action: 'check'}),确认后将 action 改为 export。客户端只接受已归属任务及成果身份,响应读取有字节上限,返回不超过32KiB的统计和成果链接。命令行使用 node cli.js source-body TASK_ID SOURCE_SCENE_SHA256 --artifact mechanical-source --action check;正式生成另名成果时显式 --action export,连接由 --api / PLW_API 指定,鉴权通过 PLW_TOKEN。不接收服务器文件路径或来源证明开关。既有本地离线包命令不能凭包内声明取得后端任务来源资格。
DGN 显示构件的目录定位与属性读取支持已绑定的线段图元。显示身份按当前模型的构件元数据区分;这些操作不会验证原始 DGN 记录真实性、物理单位、坐标参考系或原生外观,也不会改写几何。REST、MCP 与 JavaScript SDK 的调用签名保持不变。
支承轴对应分析:可选 analysis: "support-sections" 使用固定有界预算,自动从各原体三角几何提取连通挤出截面候选,记录原装配父子、原壳声明、原世界轴线残差、有限跨度重叠及竞争解释。原体不拆分、不合并,法线及自定义属性不改。截面分区不等于原CAD面证明;同轴与相接不确认刚体、关节或安装。当前对应检索仅覆盖近坐标轴方向,其它方向与超预算原体明确保持未知;不强制闭环。每体最多250000顶点、200000三角、128截面,全源最多50000节点、12000000顶点、6000000三角;分析二进制暂存不超过384MiB、完整报告不超过64MiB、摘要不超过32KiB,服务工作时间上限保持180秒。此分析不接受输送区域的可选 limits。省略 analysis 或选择 transport-regions 保持原输送区域分析及降低预算参数。原REST路由及MCP工具数量不变。
机械减面任务在任务进度中区分源几何准备、候选尝试和独立核验;数量按实际处理的网格图元定义计数,不等于发生项或绘制对象预算。常规计数更新限频,源准备、候选开始和候选结束有明确边界。尝试次数显示上限,不估算总百分比或剩余时间;progress.percent保持null。候选结束后完整校验和归档仍可继续,只有任务最终完成才可下载正式登记成果。取消会在阶段、图元和候选尝试检查点生效,单次同步几何计算或运行时调用内部不可即时中断。进度观察不改变原有几何、质量容差、权限或交付资格;REST、MCP及SDK提交参数保持不变。
地理模型视点
地理模型视口中,点击“适配模型”后,可在近距离使用 Ctrl / Shift 左拖或中键拖动围绕当前模型中心旋转。普通左拖仍是地理平移;平移、切换目标或离开适配范围后,如需继续围绕模型检查,请重新适配模型。停止操作或关闭视口会还原地理导航状态。如果宿主应用更改导航按键设置,将保留该设置并停止模型环绕。此操作只调整视点,不改变模型几何、工程坐标或格式兼容性。 REST、MCP 和 JavaScript SDK 的公开方法、参数及返回字段保持不变。
完整来源场景与质量归档
对于携带完整内嵌来源资料的兼容静态场景,可使用场景保留方式导入;未请求几何编辑时保留原 GLB 字节。来源资料不完整、布局不受支持或请求了不兼容的缩放、重写和 LOD 时停止处理,不以返回原文件代替执行该请求。
在“机构与预算”选择原始场景,检查当前来源后再显式启用质量减面。原来源片段分别保留,同名或相同的归属文字不代表已确认同一刚体。缺少约束的运动关系保持未知,构件数和面数目标仍须按实际报告判断;完成任务不表示目标预算、独立动画或运行帧率已通过。
优化成果连同完整原始来源和质量资料组成配套归档。此类归档仅支持完整检查和下载,继续转换、缓存、减面或重分组应选择原始场景。不要只分发脱离配套资料的 GLB。
保存成果时会尽量减少同一工作卷上的模型、报告重复存储;原始来源、检查点和附件仍独立保留。应为完整来源、质量记录和成果留足空间,临时占用与可用空间会随文件系统和并发任务变化。保存失败时不登记不完整成果。
智能体任务控制与 stdio 连接
WorkBuddy、Codex 等支持 MCP stdio 的智能体可查询格式与能力,上传小文件、提交单任务或批量请求、读取实际阶段与诊断、取消任务并下载成果,也可按已有工具管理 GIS 服务。此接口不代替全部桌面操作;没有声明 HTTP MCP 服务端、OAuth 登录或实验性 MCP tasks 能力。当前协议为2024-11-05,使用 tools/list 获取实际工具与参数。
本机客户端的 PLW 后台须已运行。桥接进程不自动启动软件或发现端口;从当前实例取得真实地址及端口,设置 PLW_API。使用安装/解压目录中的 runtime/node/node.exe 启动同一目录下 src/mcp-server.js。鉴权通过用户自己的安全环境向子进程提供 PLW_TOKEN,不把令牌放在命令参数、URL、聊天或共享配置中。
以下为常见 JSON 客户端配置示例(替换安装目录和当前实例端口);不同智能体须按自身配置格式填写同样的 command、args 与 env:
~~~json {"mcpServers":{"plw":{"command":"<客户端 resources/app 目录>/runtime/node/node.exe","args":["<客户端 resources/app 目录>/src/mcp-server.js"],"env":{"PLW_API":"http://127.0.0.1:<实际端口>"}}}} ~~~
连接在线 PLW 时,仍在智能体所在电脑运行这个 stdio 桥,只把 PLW_API 改为 https://plw.picimos.com;本机须能连接服务且具备有效鉴权。账号或授权过期、401/403失败应先处理鉴权,批量提交不会继续尝试后续项或自动重试。配置 URL 不接受用户名、密码、query 或 fragment;末尾斜杠会规范化,可保留服务已有代理路径前缀。启动日志只显示安全 origin,不显示鉴权信息或代理路径。
source_path 是 PLW 服务端已授权的路径;已有允许的源路径可直接用于 convert_model,不扩大文件访问权限。在线服务不能读取客户电脑盘符或 UNC 路径;先用 upload_model 上传不超过64MiB的标准 base64 文件,或通过已有 HTTP 流上传/客户端已授权来源流程传输大文件,再使用服务返回的 path。标准 base64 应由宿主文件读取工具从原始字节生成并直接传送,避免让模型手写或复述。提交转换前核对 upload_model 返回的 bytes 与原文件字节数;不一致就停止并重新传输,不继续批量提交该 path。MCP 不提供任意本机文件读取或权限扩张,也不把大文件内容通过工具参数反复搬运。
batch_convert_models 接受 requests 数组,1至128项,整个arguments JSON合计不超过1MiB,每项复用 convert_model 的参数和校验。较大的单个方案可使用convert_model,原单plan上限8MiB不变。每项独立设置来源、目标及机械预算;按顺序仅提交一次,返回来源关联、已受理 task_id、明确 rejected、unknown 或 not_submitted。提交成功不等待全部转换结束;智能体应保存 task_id 并继续 get_task 读取真实 progress、warnings、产物及报告 URI,再用 get_artifact_url 取得受鉴权保护的成果地址。网络中断或5xx可能发生在服务已受理之后;该项标记unknown及mayHaveBeenAccepted,停止后续提交并不自动重试。请通过任务列表和各项名称核对,避免重复任务。
若只需保留原构件与原面,选择机械 preserve 并不传 reduction;显式 reduction 才申请有限采样质量约束减面,失败部分保留原几何。预算 maxOrdinaryMeshes 按 renderObjectOccurrences 统计,同一节点的多个 primitive 或实例可能产生多个渲染对象,不能用目录节点数代替;maxTriangles 是面数目标。completed 不表示达到预算、机构正确、外观或帧率通过,需核对 withinBudget、motionVerified、fpsVerified 和完整报告。未知运动边界不能由智能体自行合并。
客户端可给批量 tools/call 请求设置 _meta.progressToken,服务按实际已处理 index/total发送 notifications/progress,不估计转换百分比或ETA。notifications/cancelled 中断对应当前在途批量请求尚未发出的提交,并按协议不再响应该已取消RPC;stdin关闭也停止后续提交。桥接进程会取消该请求的HTTP等待,但已发请求仍可能被服务受理,已受理业务任务不会因此取消。服务端同步计算段不因此立即退出,需通过进度返回的 task_id 或 list_tasks 核对已受理记录。
实际任务取消使用 cancel_task({task_id}),复用 POST /api/v1/tasks/:id/cancel,保留任务记录。取消可能等待同步计算段或协作检查点;只在服务确认 cancelled 后返回成功,失败不改用 DELETE。REST 与 JavaScript SDK 的已有方法签名保持;新增的是 MCP 的批量提交与任务取消工具,不授予新的任务读取、来源或物理机构权限。
原生 STEP 装配的来源标签
独立原生 STEP 装配输出须先确认服务提供 native-step-glb 且能力可用;该目标独占提交,继续使用已有轴向与三角化参数。成果保留原构件的来源标签、装配层级、颜色和单位。坐标转换与精度表达需要的中性包装层保留在场景中,不生成虚构的源标签,也不表示新的 CAD 实体、刚体或运动副。显示节点总数与来源标签条数可以不同。
成果的 meta.sourceLabels 只列有真实来源标签的节点。业务节点缺少标签、包装层级不符合读取器约定或几何核验失败时,任务停止,不发布不完整成果。REST、MCP 和 JavaScript SDK 的方法、请求参数、返回字段及资源预算保持不变。
通过 MCP 读取文件字节
需要通过MCP取得文件内容时,调用 read_artifact({task_id,artifact_id})。首次会完整抓取不超过64MiB的文件并保留本连接私有快照;max_bytes仅控制每次返回块,默认16KiB、最多64KiB。结果包含content_b64、file_sha256、read_handle、next_offset与eof。按顺序解码并拼接到eof后校验完整SHA,不能把URL或handle当作已经下载。后续每块仍检查当前任务访问权限;文件替换不混入这份已捕获快照。读取完成后调用相同task_id、artifact_id和read_handle的 action:"release",只释放本连接快照,不删除成果或取消任务。最多4个快照、合计64MiB、10分钟到期,断开连接也会释放;取多模型成果时及时release。超过64MiB使用原get_artifact_url及受鉴权HTTP下载。真实目录返回DIR,不虚构ZIP;目录或缺少可靠文件信息的成果仍按原HTTP目录清单流程处理,单文件DPEPack不因类型名被误认成目录。取消MCP读取或关闭连接只中止本次下载等待,不取消已受理转换任务。桥内凭据不返回客户端,完整SHA只校验下载文件字节。
命令行客户端沿用MCP stdio:tools/call 的 name 为 read_artifact,arguments 首次传 task_id 与 artifact_id,继续读取时同时传 read_handle、offset:next_offset。释放时传 action:"release"。现有本地CLI命令、REST下载路由和JavaScript SDK函数签名不变,没有新增对外下载服务;宿主仍可沿原鉴权HTTP下载大文件。
高斯瓦片的单位与放置
转换兼容高斯 PLY、SPLAT 或 LCC2 时,选择高斯源包与真高斯瓦片成果,并按原始数据确认源单位及轴向。下载完整成果目录后,在目标 GIS 中核对单位并设置地理锚点。
生成的局部高斯瓦片在 asset.extras.localFrame.upAxis 中声明 Z,用于解释瓦片包围盒及地理放置。原始数据轴向处理继续由 axisPolicy 记录。只有已确认源单位并按实际输出比例换算,或显式给出数值 unitScale 完成换算时,才写入 localFrame.metersPerUnit: 1。单位未知、自动识别失败及 keep 均保留长度单位未知状态,省略该字段。unitScale: 1 单独出现不能证明单位为米。
接收端应核对局部单位、轴向、sourceOrigin 及内容扩展,再设置地理锚点。此声明只描述输出局部坐标,地理位置及高程基准仍由调用方提供。压缩或混合编码的成果须由接收端完整支持实际使用的高斯内容扩展。
源单位确为米且来源路径已获当前服务授权时,命令行可使用 node cli.js convert <服务器高斯路径> --source-unit m --targets gaussian,gaussian-3dtiles。其他长度单位按真实源单位填写。需要指定轴向和叶瓦片点数预算时,可追加 --up-axis zup2yup --gaussian-tile-budget 25000。--up-axis 接受 keep 或 zup2yup。预算适用于 gaussian-3dtiles,接受 100 至 100000 的整数。LCC2 的预算用于细分最细场景和环境节点,原生粗层完整保留。
SPZ v2 的 GLB 以 asset.extras.plwSpzCoordinateSystem: "LUF" 声明解包目标轴约定。接收端先按 LUF 将压缩位置、椭球旋转与方向球谐统一恢复至 glTF 坐标,再应用节点及瓦片变换。axisPolicy 继续记录源轴向处理,localFrame 描述瓦片坐标与长度单位。
传统 LCC 源包的附属资源
传统 LCC 4.0/5.0 的高斯源包保留索引、高斯数据及已有固定附属文件。提供 JSON 对象形式的 attrs.lcp 时,按其中的 collider.simpleMesh.path、poses.path 和 thumbnail 保留声明的本地资源,沿用相对目录结构并逐文件校验 SHA-256。缺少属性文件或这些字段为空值时,沿用原有源包流程。同一相对路径重复引用只保留一份文件。
上述引用须为数据集内的安全相对文件路径。路径越界、符号链接逃逸、声明文件缺失、属性 JSON 无效或保留文件名大小写冲突时,转换明确失败。发布源包前再次核对已保存的引用资源。其他属性字段按原字节随源包保留,当前资源解析范围为上述已知字段。任务、成果下载与鉴权沿用现有接口。
静态分片的多级显示输出
本地 build 可显式使用 --render-fragment-lods 生成分片的几何层级,默认关闭。它必须与 --no-lod --lod-arch proto 及 --compact-unused-render-vertices 或 --lossless-sector-partitions 同用,并保持零焊接;此模式不接受 --compress。例如:
node cli.js build input.glb model.dpepack --format glTF --no-lod --lod-arch proto --lossless-sector-partitions --compact-unused-render-vertices --render-fragment-lods --source-graph --face-side source --normal-mode preserve
原始细层文件保持不变;符合条件的静态不透明三角形分片可生成简化层级,无法满足边界条件或不能继续简化时复用已有较细层。未生成简化层级的构件保留原始细层作为各级显示内容,不以省略构件实现减面。该选项只控制几何层级,不自动改变纹理分辨率。
需要交付原始节点层级、空节点及构件对应关系时,同时使用 --source-graph。此 CLI 分片模式接受 POSITION、NORMAL、TANGENT、TEXCOORD_0 至 TEXCOORD_15、COLOR_0 和 COLOR_1 源顶点语义,并保留材质引用的 UV 通道;其它源顶点语义会明确提示不支持。
该选项仅提供给本地 build 和低层 PackWriter 配置。低层配置为 renderFragmentLods:true,同时指定 lods:false、lodArch:'proto'、零焊接及上述一种分片配置;网页、REST、MCP 和公开 JavaScript SDK 目前不提供对应选项。
STEP 源实体整理
兼容的 STEP 进行源实体整理时,按可唯一核实的原始实体引用恢复壳体归属;缺少子形状名称时仍核对读取器中的源实体身份。存在歧义的边界不会被自动归并。该能力整理显示实体,不补建源文件未提供的 CAD 配合、运动轴、轴心、行程或联动约束。REST、MCP 与 JavaScript SDK 的公开方法、请求参数及交付流程保持不变。