> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alforse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 装配说明

> 在 ERP 中基于自制零件的 CAD 模型创建带动画的分步 3D 装配指南，发布后供操作员在车间跟随操作。

装配说明把自制零件的 CAD 模型变成一份有序的 3D 装配指南：每个步骤指明要安装的组件，并演示它们如何移动到位。作者在 ERP 中创建，操作员在车间的[引导式装配视图](https://docs.alforse.com/zh/docs/reference/mes.md#the-guided-assembly-view)中跟随操作。

## 工作原理

一份说明属于一个自制零件，并基于该零件的 STEP 模型创建。它带有版本：你编辑**草稿**，发布后，类型为**装配**的工单工序会播放已发布的版本。工单保留自己的步骤副本，因此只有在某个版本被设为启用或有人手动同步时，工单上的步骤才会变化。

Alforse screenshot**装配说明编辑器：左侧为步骤列表，中间为 3D 模型，右侧为所选步骤的“详情”选项卡，包含组件和“回放”框**

三个窗格：步骤列表、3D 模型，以及所选步骤的设置。

## 创建说明

### 确认零件有模型

零件必须是自制件，并且在其**模型**选项卡上有 STEP 文件。没有该文件，Alforse 无法生成 3D 视图。

### 开始创建说明

前往**生产 → 装配件**，选择**新建装配说明**，然后选择**零件**。

### 让 Alforse 完成准备

必要时，Alforse 会转换模型以便进行 3D 查看，打开编辑器，并开始生成步骤草稿。

## 版本与状态

<details>
  <summary>**Draft**</summary>

  可编辑。每份新说明和每个新版本都从此状态开始。
</details>

<details open>
  <summary>**Published**</summary>

  已生效。使用该说明的工单工序以此版本为准。
</details>

<details>
  <summary>**Archived**</summary>

  已被更新的启用版本取代；以只读方式保留供参考。
</details>

每个版本都是完整、独立的副本。有两个操作用于在版本之间切换：

| 操作 | 适用对象 | 效果 |
| - | - | - |
| **新版本** | 已发布的说明 | 创建一个可编辑的草稿，初始内容为当前步骤。 |
| **启用** | 草稿 | 发布该草稿，并将此前启用的版本归档。 |

HEADS UP

**启用某个版本会更新正在进行中的工单。**

所有使用本说明其他版本的工单工序都会切换到新版本并同步其步骤，除非该工序已完成或已取消，或其工单已锁定。已结束工单上的工序保留其创建时的步骤，因此记录保持准确。

## 构建步骤

### 生成或添加步骤

新说明在你创建之前没有任何步骤：

* **生成步骤**会运行运动规划器，为每个零件算出装配顺序和无碰撞路径。通常需要一到三分钟。
* **手动添加步骤**会创建一个空白步骤。

已有步骤之后，**添加步骤**可再添加一个，拖动某一行的手柄可重新排序。

**添加步骤**旁边的规划器菜单还有两个选项：

| 选项 | 效果 |
| - | - |
| **运行运动规划** | 重新计算运动路径，并保持当前的步骤顺序。 |
| **重新生成步骤** | 用全新的规划替换所有步骤。 |

只要有任何步骤是手动添加的或已标记为**完成**，就无法重新生成，这样已检查或手写的内容不会被丢弃。

### 步骤状态

点击步骤行末尾的图标可更改其状态：

<details>
  <summary>**Todo**</summary>

  手动添加，尚未检查。
</details>

<details>
  <summary>**Review**</summary>

  由运动规划器创建，等待作者确认文字和动画。
</details>

<details open>
  <summary>**Done**</summary>

  已由作者检查。
</details>

### 规划器警告

步骤列表中的图标指示规划问题：

| 图标 | 含义 |
| - | - |
| 警告三角形 | 规划器未找到无碰撞路径。零件会淡入最终位置，而不是移动过去。 |
| 手形 | 已放置的零件可能会倾倒，可能需要夹具或第二个人协助。 |

## 步骤详情

**详情**选项卡包含操作员在该步骤阅读和记录的内容：

FieldType

<details>
  <summary>**Type**</summary>

  步骤要求输入的类型。**任务**是纯文字说明；其他类型用于记录数值、与最小值和最大值比对的测量值、复选框、列表选项、时间戳、人员、文件或检验结果。
</details>

<details>
  <summary>**Title**</summary>

  可选。为空时，Alforse 会以其组件命名该步骤，例如“Add Bearing (×2)”。
</details>

<details>
  <summary>**Instruction**</summary>

  面向操作员的文字。输入 `@` 可引用物料的物料清单中的零件。
</details>

<details>
  <summary>**Required**</summary>

  开启后，操作员必须记录此步骤才能完成该工序。
</details>

NOTE

**两种保存方式**

这四个字段只有在你选择面板底部的**保存**或按 ⌘/Ctrl+Enter 时才会保存。步骤上的其他所有内容（组件、隐藏零件、回放设置、状态、物料、工具和幻灯片）在你更改后立即保存。

## 组件与隐藏零件

**组件**列出该步骤安装的零件。

### 选择零件

选择**添加**，然后在 3D 视图中点击零件。按住 Shift 点击可一次添加多个。

### 确认

选择**完成添加**。若之后要移除某个零件，使用其所在行的 ✕。

### 隐藏碍事的零件

如果某个零件妨碍操作，点击**组件**选项卡中其所在行的眼睛图标。该零件只在所选步骤中消失，其他步骤不受影响。被隐藏的零件会集中在 **在此步骤中隐藏** 列表中，你可以在其中恢复它们。

有两条规则：步骤自己的组件永远不能在该步骤中隐藏；操作员看到的内容与你隐藏后的结果完全一致。

## 回放设置

**回放**框控制步骤的动画方式。

### 运动

| 状态 | 含义 |
| - | - |
| “Automatic” | 使用规划器找到的路径。 |
| “Custom path” | 路径由你绘制。**重置**可恢复规划器的路径。绘制的路径同时会取代“No clear path”。 |
| “No clear path” | 规划器未找到路径。将鼠标悬停在标题旁的提示上，可查看哪些零件造成阻挡。 |

**编辑路径**会在 3D 视图中以红色路径点显示路径，并在所选路径点的姿态处显示零件的透明副本：

* 拖动路径点可改变路径形状。
* 双击路径可添加路径点。
* 按 Delete 可删除所选路径点。

零件也可以在途中旋转。将查看器的**移动 / 旋转**控件设为**旋转**，所选路径点周围会出现圆环。拖动圆环可让零件在该点以 15° 为增量旋转，这样就可以在零件进入途中将其翻转。切换回**移动**可重新定位路径点。

### 摄像头

| 状态 | 含义 |
| - | - |
| “Automatic” | Alforse 自行为该步骤的零件取景。直立装配时，生成的步骤从规划器选定的角度观看。 |
| “Saved view” | 通过**使用当前视图**设置，它会保存你当前的角度。**清除**（仅在此状态下显示）可恢复为自动。 |

### 朝向

朝向用于在某个步骤中转动整个装配体，例如翻转它，以便把零件装到底面。

| 按钮 | 转动 |
| - | - |
| **Flip over** | 半圈，翻面朝下。 |
| **Tip toward you** / **Tip away from you** | 四分之一圈，侧倒。 |
| **Spin left** / **Spin right** | 在工作台上转四分之一圈。 |

转动相对于你当前的观看角度，装配体转动时摄像头不会移动。转动之后，该行会显示位置为“Upright”、“Upside down”或“On its side”。

朝向如何延续的规则：

* **后续步骤继承朝向。** 同一装配体的后续步骤保持该朝向，显示为例如“Upside down, from step 11”，直到另一个步骤再次转动它。回放时，装配体会在该步骤的零件装入之前先翻转。
* **转动可以保存视图。** 如果该步骤没有已保存的视图，而转动使装配体处于转动后的状态，你当前观看的视图也会被保存，因此“摄像头”行显示“Saved view”，回放时会从该角度展示该步骤。将装配体转回去仍保留该视图；点击“摄像头”行的**清除**可恢复为自动。
* **子装配相互独立。** 子装配从直立开始，并保持自己的朝向。
* **重置**会让该步骤采用上一步的朝向。

### 子装配路径

安装子装配的步骤，每个子装配对应一行。保持“Automatic”时，成品单元会从装配体侧面滑入。**编辑路径**可用与零件相同的路径点和旋转圆环工具绘制单元的路线；**重置**则恢复为自动。

## 子装配

实际生产中，常常先单独装配一个单元，再整体安装。例如，轮毂先在工作台上装好轴承、卡环和制动盘，然后才安装到后摆臂上。子装配就是为此建模：它是一组有名称的步骤，单独构建，然后并入主装配体。

### 创建与整理

| 操作 | 位置 | 效果 |
| - | - | - |
| **自制子装配** | 步骤的菜单 | 创建子装配，以该步骤作为其第一个步骤。 |
| 将步骤拖到子装配上，或**移动到** | 步骤的菜单 | 将该步骤加入子装配。 |
| **移出子装配** | 步骤的菜单 | 将该步骤放回主列表。 |
| **取消分组** | 子装配 | 删除分组，其步骤保留在主列表中。 |
| **删除子装配** | 子装配 | 删除分组及其全部步骤。 |

成员步骤在其分组下编号：子装配 4 包含 4.1、4.2，依此类推。

双击子装配或选择**打开子装配**会将其隔离：步骤列表和 3D 视图仅限于它自己的步骤和零件，**添加步骤**会在其内部创建步骤。选择**所有步骤**可再次查看完整说明。

### 它的位置

选中子装配后，会显示其名称、步骤和**它的位置**部分：

FieldType

<details>
  <summary>**Used in**</summary>

  由后面哪个步骤安装成品单元。默认值 **Main build (after its last step)** 表示没有步骤安装它，它在自己的步骤结束后直接并入装配体。
</details>

<details>
  <summary>**Instruction**</summary>

  仅在默认值下出现。单元并入主装配体时，操作员阅读的文字。
</details>

<details>
  <summary>**Sub-assembly path**</summary>

  仅在默认值下出现。单元进入主装配体的路线，用**编辑路径**绘制。
</details>

<details>
  <summary>**Camera**</summary>

  仅在默认值下出现。该时刻的观看角度，通过**使用当前视图**保存。
</details>

你也可以从安装它的步骤进行关联：在步骤上选择**使用子装配体**，挑选一个已完成的子装配，该步骤的行就会显示例如 **Uses 4**。

### 回放方式

回放首先按顺序运行子装配自己的步骤。到了使用它的步骤，完成的单元会移入：如果绘制了路径则沿路径移动，否则从侧面滑入。

* 有自己路径的单元，会在该步骤的其他零件移动之前到达。
* 当一个步骤安装多个单元时，它们依次到达。
* 选中子装配时点击播放，会从其第一个步骤开始构建。

NOTE

**只支持一层嵌套。**

子装配不能嵌套。若要把一个单元放入另一个单元，请在后者的某个步骤中安装它。该安装步骤必须晚于子装配，并且不能是其成员。

## 物料、工具与幻灯片

| 选项卡或操作 | 用途 |
| - | - |
| **BOM** 选项卡 | 将步骤与其消耗的物料清单中的零件以及所需工具关联。 |
| **匹配 BOM**（在**组件**中） | 将 3D 组件与物料清单项匹配，并填写每个步骤的物料。 |
| **幻灯片**选项卡 | 添加操作员在此步骤看到的照片、PDF 或额外的 3D 模型。 |

## 在工单和车间中的应用

你将说明附加到物料工序清单中类型为**装配**的[工序](https://docs.alforse.com/zh/docs/reference/jobs.md#operation-type)上。每个新工单在创建时会复制一份说明的步骤。

工单不会自动采纳之后的修改。在工单工序上运行**同步装配步骤**即可拉取更新：由说明派生的步骤会被更新或删除以保持一致，而在工单上手动添加的步骤会保留。

操作员在[引导式装配视图](https://docs.alforse.com/zh/docs/reference/mes.md#the-guided-assembly-view)中查看结果，其中的步骤、隐藏零件和子装配与说明相同。他们记录子装配的每个成员步骤，而不是分组本身。说明中的步骤会排在工序已有步骤之后。

## 权限

编辑说明需要同时满足两个条件：版本必须是**草稿**，并且你在生产模块上拥有**更新**权限。没有该权限，即使是草稿，编辑器也以只读方式打开。参见[权限与访问](https://docs.alforse.com/zh/docs/reference/permissions.md)。

## 故障排除

每个条目给出消息或症状、出现原因以及处理方法。

### "The selected item has no 3D model. Upload a STEP file on the item's Model tab first."（所选物料没有 3D 模型。请先在物料的“模型”选项卡上传 STEP 文件。）

* **原因：** 在**新建装配说明**中选择的零件没有 STEP 文件。
* **处理：** 在该物料的**模型**选项卡上传一个，然后重新开始创建说明。

### "Only draft instructions can be edited"（只能编辑草稿说明）

* **原因：** 你正在修改已发布或已归档的版本，这些版本已被冻结。
* **处理：** 在已发布的版本上选择**新版本**，在新草稿中进行修改。

### 草稿的编辑器是只读的

* **原因：** 你的账号没有生产**更新**权限。
* **处理：** 请管理员授予该权限。

### "Steps already exist — delete them before generating from the plan"（步骤已存在，请先删除再根据规划生成）

* **原因：** **生成步骤**只会为尚无步骤的说明生成规划。
* **处理：** 先删除现有步骤，或使用规划器菜单中的**重新生成步骤**。

### "Some steps are locked — cannot regenerate"（部分步骤已锁定，无法重新生成）

* **原因：** 至少有一个步骤是手动编写的或已标记为**完成**；重新生成会丢弃这些工作。
* **处理：** 保留这些步骤，选择**运行运动规划**，它会刷新路径而不改变步骤顺序。

### "The geometry service is offline — motion planning is unavailable right now." / "The geometry service is unavailable — motion planning can't run right now."（几何服务离线，运动规划暂不可用。）

* **原因：** 无法连接运动规划器，因此**生成步骤**被禁用。
* **处理：** 服务恢复后再试。在此期间仍可手动添加步骤。

### "Motion planning is already running"（运动规划已在运行）

* **原因：** 该说明的一次规划运行尚未完成。
* **处理：** 等待其完成；一次运行通常需要一到三分钟。

### "This instruction has no processed model" / "The model must finish converting before planning"（该说明没有已处理的模型 / 模型必须先完成转换才能规划）

* **原因：** CAD 模型尚未完成面向 3D 查看的转换。
* **处理：** 等待转换完成，然后开始规划。

### "This step is already a sub-assembly" / "This step is already in a sub-assembly"（该步骤已是子装配 / 该步骤已在子装配中）

* **原因：** 对已经是子装配或已属于某个子装配的步骤使用了**自制子装配**。
* **处理：** 选择主列表中的步骤，或先用**移出子装配**将其移出。

### "A sub-assembly can't be inside another sub-assembly"（子装配不能放在另一个子装配中）

* **原因：** 嵌套仅限一层。
* **处理：** 让内层分组保持独立，并在外层的某个步骤上用**使用子装配体**来安装它。

### "A sub-assembly can only be used after it is built" / "A sub-assembly can't be used by one of its own steps"（子装配只能在构建完成后使用 / 子装配不能被自己的步骤使用）

* **原因：** 选择用来安装该单元的步骤位于子装配之前，或本身就是其成员。
* **处理：** 选择子装配之外、位置更靠后的步骤。

### "A sub-assembly's steps must come directly before it"（子装配的步骤必须紧挨在它之前）

* **原因：** 子装配的步骤必须位于列表中其标题行的正上方，而这次更改会破坏这一点。
* **处理：** 保持分组完整；用**移动到**或**移出子装配**来更改成员。

### "This job is locked — steps can't be synced to it"（该工单已锁定，无法同步步骤）

* **原因：** **同步装配步骤**从不更改已锁定的工单。
* **处理：** 无需处理；该工单保留其创建时的步骤。

### "Failed to make assembly instruction active"（启用装配说明失败）

* **原因：** 发布草稿未能在服务器上完成。
* **处理：** 重试**启用**。

## 相关内容

**MES 应用**

操作员跟随说明操作的位置，包括 Build、Focus 和 Full visibility 模式。

[Open](https://docs.alforse.com/zh/docs/reference/mes.md#the-guided-assembly-view)

**工单**

装配工序携带步骤副本的生产工单。

[Open](https://docs.alforse.com/zh/docs/reference/jobs.md)

**方法与采购来源**

每个步骤的物料所选自的物料清单。

[Open](https://docs.alforse.com/zh/docs/reference/methods.md)

**权限与访问**

谁可以编辑和发布说明。

[Open](https://docs.alforse.com/zh/docs/reference/permissions.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.