# 插件

{% hint style="warning" %}
此插件目前处于测试版。您可能会遇到错误或意外行为。请在 GitHub 的 [问题区](https://github.com/Carvera-Community/Carvera_Community_FusionPlugin/issues) 和/或 Makera Discord 的 [#3rd-party-cam](https://discord.com/channels/910194756473225269/1243862379322806284) 频道中，或在社区 Discord 的 [Fusion 插件附加组件](https://discord.com/channels/1341908765212934320/1464378831573090448) 频道中报告问题。
{% endhint %}

Fusion 插件（附加组件）通过引导您选择兼容的设置，然后按照您偏好的结构生成 g-code 文件，帮助您从 Fusion 360 生成 GCode 文件。这包括在个人使用 Fusion 时输出包含多个操作的单个大文件。它还包含一些用于在第四轴上处理多个设置的实用小工具。

## 下载

您可以下载 [最新版 Fusion 插件，来自 Github](https://github.com/Carvera-Community/Carvera_Community_FusionPlugin/releases/latest).

## G-code 生成选项

该插件提供了多种 g-code 选项，以支持索引式第四轴工作流：

* **设置之间的 A 轴旋转**：通过让机床在各设置之间旋转第四轴来实现索引铣削
* **旋转时可选的 Y 轴退回**：默认情况下，Z 轴会在旋转 A 轴之前退回，但如果仅 Z 轴退回无法避开毛坯，额外的 Y 轴移动可以帮助降低旋转过程中的碰撞风险。
* **可配置的 Y 轴退回坐标（G53/MCS）**：定义在 Y 方向退回多远以避开工件。这使用 *G53* （机床坐标系 / MCS），因此数值是绝对值，通常为负数。
* **实验性快速移动**：您可以启用更高速的非切削移动。由于无法验证每一种结果， **在实际运行前请检查生成的输出，并在使用此选项时始终观察机床**。在插件仍处于测试版期间，反馈尤其宝贵。
* **快速移动的最小距离策略**：自定义切换到快速移动所需的最小移动距离。
* **可自定义的 g-code 块**：通常不需要自定义 g-code，但如有需要，此选项为未来更改和特殊工作流提供灵活性，包括：
  * 在换刀前插入代码
  * 检测某个操作的结束
  * 检测操作标题的结束

## 输出组织选项

输出旨在保持灵活，同时又可预测：

* **输出位置和命名**：选择一个输出文件夹和一个输出基础名称，然后根据分组选项用于生成最终文件名。
* **仅数字程序名**：为需要数字输出名称的机床强制使用数字名称。
* **序号编号**：可选择在文件名前加上序号（位数可配置），以便在输出文件夹中保持操作顺序。
* **分组策略**：选择输出如何拆分：
  * **单个文件**：一个包含所有设置的大程序
  * **按设置划分（默认）**：每个设置一个程序
  * **按设置和刀具划分**：在每个设置内按刀具拆分；如果多个操作使用同一刀具，它们将合并为每次刀具变更一个文件
  * **按操作划分**：每个操作一个文件
* **合并使用相同刀具的操作**：在适用情况下减少文件数量和刀具更换次数。
* **扁平输出**：通过输出平铺的文件列表，使用设置名和操作名作为文件名，避免子文件夹。
* **覆盖保护**：允许或禁止覆盖现有文件，作为一项安全措施。
* **处理前清空输出文件夹**：可选择移除输出文件夹中的现有文件，以便于重新生成。

## 其他实用功能

除了输出生成之外，该插件还包括：

* **翻译**：界面支持翻译；目前提供英语和瑞典语。欢迎通过 PR 添加语言或改进翻译。
* **批量重命名设置**：批量重命名设置（所有设置或仅当前选中的设置）。如果省略“search”字符串，行为将变为在设置名称前添加“replace”字符串。支持 Python 正则表达式以处理更复杂的模式。
* **按文档设置**：设置会按文档保存，您还可以保存默认值，并将其应用到新文档。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://carvera-community.gitbook.io/docs/stable/zh/fusion-360/plugin.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.