外观
装配、数据与认证排障
装配体同时依赖项目结构、零部件版本、模型文件、配合引用和访问权限。排障时先确认数据是否完整加载，再判断几何或命令问题。
项目无法打开或模型为空
按顺序检查：
- 当前登录会话是否有效，是否被跳转到认证错误页。
- 当前账号是否拥有项目、仓库和目标分支的访问权限。
- 项目根节点是否已经加载完成，页面是否仍显示“正在打开项目”。
- 设计树是否出现根装配体及子节点。
- 模型可能只是离开视口，按
F执行适合窗口。 - 模型是否被隐藏；从设计树检查显示状态。
- 切换文档标签后是否只显示当前子装配上下文。
不要在项目仍加载时连续切换标签、版本或插入组件。若错误可重试，先保留页面并使用重试入口；重新登录或刷新前先评估未提交修改风险。
插入零部件失败
| 阶段 | 检查项 |
|---|---|
| 选择来源 | 已选择可访问的零件或装配节点及有效版本 |
| 加载预览 | 等待文件和 CAD 数据加载完成；不要重复单击插入 |
| 放置 | 指针位于视口内，当前没有移动、配合、测量或其他放置会话 |
| 确认 | 预览已落到目标位置，装配结构没有处于只读或待重载状态 |
| 插入后 | 设计树出现新节点，视口位置正确，提交前可撤销 |
按 Esc 可取消当前插入或放置。若取消后仍有透明预览，等待当前异步加载结束，再重新进入命令。
零部件无法移动或旋转
- 固定零部件按设计不能自由移动；在设计树确认固定/浮动状态。
- 标准配合会限制自由度，拖动结果可能带动关联零部件或只允许特定方向。
- 编辑零部件焦点、插入、配合、测量和其他命令会阻止普通拖动。
- 选择了子网格或实体而非组件时，从设计树重新选择零部件节点。
- 历史版本预览是只读的，不能拖动组件。
诊断配合限制时，先记录现有配合，再临时抑制可疑配合进行对比。不要直接删除全部配合。
配合失败、过定义或引用丢失
- 两个配合选择应来自不同组件。
- 根据点、线、轴、平面、圆柱等组合选择已启用的兼容配合类型。
- 切换同向/反向对齐并观察预览，避免确认明显跳转的分支。
- 固定组件加上多条重复配合容易过定义；每条配合只应消除需要的自由度。
- 上游版本切换、组件删除或几何拓扑变化可能使原点、边、面引用失效。
- 抑制状态下配合不参与求解；检查是否误抑制。
- 同心配合的“锁定旋转”会额外消除转动自由度，仅在需要时启用。
优先修复设计树中第一条引用失效或求解失败的配合，再检查其后的关系。
删除范围与关联影响
删除嵌套零部件或子装配体时，系统可能要求选择删除当前组件还是其所属子树。确认前检查：
- 对话框显示的目标名称和类型。
- 将被一并删除的子节点。
- 引用这些组件的配合。
- 删除后当前装配文档和底部标签的范围。
删除属于模型主状态，可在当前会话中撤销；但对外提交前仍应重新检查结构和配合。关闭或刷新页面后不要依赖旧撤销栈恢复删除。
导入、导出失败
| 现象 | 处理方式 |
|---|---|
.puppy 导出提示没有可见模型 | 显示真实模型，结束预览命令并重试 |
.puppy 提示缺少 CAD 几何或拓扑 | 回到原始 CAD 来源重新加载；仅显示网格不能作为完整离线包来源 |
.puppy 无法导入 | 确认扩展名、文件完整性和客户版本兼容性；不要手工改包 |
| STEP 导出失败 | 确认当前文档含可导出的真实 CAD 实体且已经加载完成 |
| GLB 缺少对象 | 检查导出前可见性和当前活动文档 |
| 下载没有开始 | 检查浏览器下载拦截，等待当前导出结束后只重试一次 |
详细步骤参见导出 STEP、GLB 与离线包和.puppy 离线包。
版本切换或预览失败
- 确认版本记录属于当前项目和分支。
- 等待当前版本加载完成后再选择下一条。
- 切换子装配体版本前阅读影响范围确认，避免误替换整个根装配。
- 历史预览加载失败时，系统会尽量保留原可见模型；不要把错误状态当作目标版本已加载。
- “基于此版本继续编辑”可能丢失当前未提交修改，操作前先提交或导出离线包。
认证错误
项目编辑、项目预览和版本预览都需要认证。出现认证错误页、无权限或资源请求失败时：
- 记录当前项目和目标入口。
- 重新登录平台。
- 确认账号已被授予项目、仓库和分支权限。
- 从平台项目入口重新打开，不要复用已过期的临时地址。
- 若仍失败，向管理员提供发生时间、项目名称、页面入口和完整错误文案。
不要通过反复刷新绕过认证错误；这不会增加权限，还可能让当前未提交工作更难判断。
提交支持请求的最小材料
- 项目、分支、零件/装配体名称。
- 问题发生的提交或版本标题和时间。
- 从打开项目开始的可重复步骤。
- 界面完整截图，包含设计树、视口、属性面板和错误提示。
- 导入/导出问题的格式、文件大小和来源版本；涉及客户数据时按组织规则安全传输。
- 预期结果与实际结果，以及是否能在新空项目复现。