故障排查
本节介绍在使用组合样条工具（Assembly Spline Tool）时常见问题及其解决方法。
套件装配失败
套件组件无法连接在一起
问题：装配套件无法正常构建，或者组件无法连接。
原因：未满足套件验证规则或模型存在问题。
解决方案：
- 检查控制台是否有警告或错误信息
- 查看日志以获取具体的验证失败信息
- 熟悉套件规则（详见套件文档部分）
- 确认所有必需组件均已添加且命名正确
- 检查锚点是否放置在正确的位置
锚点问题
找不到锚点或连接点
问题：锚点缺失或不可见。
原因：锚点名称不规范或未在模型中正确放置。
解决方案：
- 检查控制台是否有关于缺少锚点的警告
- 核查是否遵循了锚点命名规范
- 确保锚点已正确放置在源模型中
- 检查模型文件内是否包含预期的锚点结构
- 参见套件文档，了解锚点的具体要求
COLLADA 导入问题
COLLADA (.dae) 文件无法加载
问题：网格文件无法导入或显示异常。
原因：文件损坏、不支持的特性或格式问题。
解决方案：
- 检查网格文件是否损坏
- 确认文件为有效的 COLLADA (.dae) 格式
- 在 Blender 或其他三维软件中检查几何体问题
- 检查控制台是否有导入警告或错误
- 确保网格的包围盒能够准确地代表几何体
- 此问题同样可能影响 Mesh Spline Tool，请同时检查两个工具
分子间距问题
分子过于接近或过于分散
问题：放置的单元在样条曲线上的间距不正确。
原因：间距设置有误或组件之间存在冲突。
解决方案：
- 在工具窗口调整间距滑块
- 检查分子是否配置正确
- 核查主组件是否已正确标识
- 如有需要，重新排序组件列表
最后一个分子超出终点节点
问题：样条中的最后一个分子超出了最后的节点。
原因：固定尺寸分子（TSStatics）在分布到样条总长度时，不能完全整除，会有剩余部分。
解决方案：
- 对于固定尺寸分子来说这是正常现象
- 工具会按照设定的间距放置分子，并不一定填满整个样条长度
- 可通过移动最后一个节点调整样条长度，更好地适应分子尺寸
- 考虑调整间距，以减少剩余部分
- 也可以用合适的端盖或手动调整最后一个分子的放置位置
桥接组件问题
桥接组件未在分子之间连接
问题：分子之间的桥有断裂或不可见。
原因：分子生成存在问题，或桥接组件被禁用。
解决方案：
- 检查分子构建期间控制台是否有警告或错误
- 确认组件列表中桥接网格已启用
- 检查桥接组件配置是否正确
- 查找可能导致连接异常的网格问题
- 确认分子间距合理，以便桥接组件能正常工作
桥接组件方向问题
桥接组件出现在错误的位置或重叠
问题：桥接组件的起止点位置错误、重叠或出现伪影。
原因：分子的预旋转（prerotation）设置不正确。
解决方案：
- 在工具窗口中用单选按钮选择正确的预旋转
- 在应用桥接组件之前，检查分子方向是否正确
- 确认预旋转设置与源网格的实际朝向一致
网格质量问题
装配组件显示异常
问题：Kit 组件出现视觉伪影或无法正确渲染。
原因：网格文件损坏或使用了不支持的功能。
解决方案：
- 检查网格文件是否损坏
- 确认网格文件格式受支持
- 在 Blender 或其它 3D 软件中检查几何体问题
- 查看控制台是否有导入警告或错误
- 确保网格包围盒能准确表示几何体
性能问题
复杂装配下工具变慢
问题：处理复杂组件时，工具卡顿或无响应。
原因：组件数量过多或样条过长。
解决方案：
- 减少装配中的组件数量
- 将较长的样条拆分为较短的片段
- 简化复杂的 kit 几何体
- 减少不同组件类型的数量
样条线可见性问题
组合样条线消失
问题：样条线变得不可见或无法找到。
原因：样条线可能处于地下、屏幕之外，或存在颜色/光照冲突。
解决方案：
- 使用“定位到样条线”按钮来查找并聚焦样条线
- 检查样条线是否在地下或屏幕外
- 如果存在可见性冲突，调整光照或颜色设置
会话管理
组合样条线在会话之间消失
问题：重启工具后工作内容丢失。
原因：默认情况下，样条线不会在会话间自动保存。
解决方案：
- 使用往返恢复系统导入现有样条线
- 在场景树中选择装配对象以估算样条参数
- 工具可以自动从场景网格中恢复样条线
Kit 组件校验
Kit 组件校验警告或报错
问题：控制台显示校验失败或警告。
原因：未遵循 kit 规则或组件配置有误。
解决方案：
- 仔细阅读所有控制台消息
- 查阅 kit 文档中的具体规则
- 检查组件命名规范
- 确保所有必需组件齐全
- 检查锚点的定位和命名
何时反馈 Bug
如果你遇到以下问题，可能表明存在 Bug：
- 工具窗口无性能瓶颈却卡死
- kit 校验完全失败且没有明显错误
- 撤销/重做功能异常
- 文件损坏或数据无法读取
建议：重新加载工具并重试。如果问题依然存在，请检查控制台错误信息，并附带复现步骤反馈问题。
