FreeCAD 插件库

这个仓库是由 FreeCAD 社区成员制作的有用的附加工作台和模块的集合，可以方便地无缝集成到应用程序中。

重要提示：

1. 由于这些插件不属于官方 FreeCAD 软件包，也不受 FreeCAD 团队支持，尽管此列表由 FreeCAD 团队管理和维护，但在安装任何插件之前，您应该阅读每个插件页面上提供的信息，以确保您了解所安装的内容。

2. **错误报告和功能请求应直接在每个插件页面上提出。**在此仓库中提出的任何报告都应与插件管理器本身直接相关。

3. 上面 GitHub 树中指示的提交编号不被插件管理器考虑。安装或更新的总是每个插件指定分支的最新 HEAD。如果在 .gitmodules 文件中未指定分支，则假定为"master"。

插件描述

要了解每个插件的描述，您可以：

• 在 FreeCAD 中使用插件管理器浏览所有可用的插件/外部工作台。
• 点击此仓库中每个单独链接的插件以阅读其 README 文件。

安装

重要提示：从 FreeCAD v0.17.9940 开始，插件管理器已正式集成到 FreeCAD 中。可以通过工具 → '插件管理器'下拉菜单访问。对于早期版本（≤v0.16），请参阅废弃安装方法部分。

1. 内置插件管理器

推荐的方式是使用内置的插件管理器来安装第三方工作台、插件和宏。通过工具 → 插件管理器访问：

2. 手动安装

如果第一种方法不可用，那么手动安装始终是可能的。GitHub 允许用户"克隆或下载"此仓库中列出的每个插件。可以通过以下方式下载：

• 导航到特定插件仓库
• 点击每个插件页面右上角的绿色"克隆或下载" → 下载 ZIP"按钮 或者
• 使用 git clone <github 仓库 URL> 大多数插件必须放在用户的 FreeCAD/Mod 文件夹或宏文件夹中。请参阅每个插件页面上的说明。

注意：您可以通过在 FreeCAD 的 Python 控制台中键入以下内容来获取用户的 FreeCAD 文件夹位置：FreeCAD.ConfigGet("UserAppData")，而宏文件夹位置在从*宏 -> 宏...*下拉菜单打开的对话框中指示。

将您的工作台添加到集合中

您是否制作了我们不知道的有趣工作台或模块？请在 FreeCAD 论坛上告诉我们，以便我们在此处添加！

要将您的工作台提交到仓库

1. 在 FreeCAD 论坛上宣布您的工作台
2. 在 FreeCAD wiki 上为您的工作台创建一个专门的页面（别忘了添加 [[Category:Addons]]）+ 将其添加到 https://freecadweb.org/wiki/External_workbenches
3. 用以下标签标记您的 GitHub 仓库：freecad、addons 和 workbench
4. 确保您有一个简单的工作台 SVG 徽标（不大于 10kb），可以在插件管理器对话框中用来表示它。
5. 请以易于从插件管理器对话框中理解的方式构建 README.md 文件。示例：SheetMetal 工作台 **注意使用：**截图、屏幕录像、提及许可证、更新日志等...
6. 确保您的插件包含一个 package.xml 元数据文件，并且该文件包含图标、仓库 URL 和 readme URL。readme URL 应该是 README.md 文件的直接链接（例如 https://github.com/shaise/FreeCAD_SheetMetal/blob/master/README.md）
7. 向此仓库提交一个拉取请求，将您的插件添加到 .gitmodules 文件中。支持的 git 托管平台有 GitHub、Gitlab、Framagit、salsa.debian.org 和 Codeberg。

翻译外部工作台

为了更广泛地使用外部工作台，我们建议工作台开发人员集成翻译他们的工作台的功能。FreeCAD 使用名为 Crowdin 的第三方众包翻译服务。我们使用一些自动化脚本通过他们的 API 推送和拉取翻译。我们邀请开发人员帮助改进这些脚本，以便在此过程中包含他们自己的工作台。更多讨论请见此论坛帖子。

插件管理器源代码

插件管理器的源代码位于 FreeCAD master FreeCAD/src/Mod/AddonManager/。

废弃安装方法

<details> <summary>在 FreeCAD v. 0.17.9940 之前，使用以下方法来自动安装工作台和宏。此部分保留用于历史目的。 </summary>

1. 使用安装程序宏

安装程序宏可以从 FreeCAD 内部启动，并自动下载和安装上述任何插件。要安装安装程序宏：

1. 下载 addons_installer.FCMacro
2. 将下载的宏放在您的FreeCAD 宏文件夹中。FreeCAD 宏文件夹位置在菜单宏 -> 宏 -> 用户宏位置中指示：
3. 重新启动 FreeCAD。插件安装程序现在将列在菜单宏 -> 宏中，可以通过选择它然后点击执行按钮来启动：

2. 使用"pluginloader"插件

插件加载器是一种更精细的方式来安装和管理 FreeCAD 的附加内容。使用上述方法安装它，或按照pluginloader 页面上的说明进行操作。

</details>