iii Contents 1 KiCad 插件系统简介 2 1.1 插件类 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 1.1.1 插件类：PLUGIN_3D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2 教程：3D 插件类 4 2.1 基本的 3D 插件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.2 高级 3D 插件 . 12 3 应用程序编程接口（API） 21 3.1 插件类 API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 3.1.1 API：Base Kicad 插件类 . . . . . . . . . . . . . . . .

入器和导出器。 1.1. 插件类 插件分为插件类，因为每个插件都解决了特定域中的问题，因此需要该域独有 的接口。 例如，3D 模型插件从文件加载 3D 模型数据并将该数据转换为可由 3D 查看器显示的格式。 PCB 导入/导出插件将获取 PCB 数据并导出为其他电 气或机械数据格式，或将外部格式转换为 KiCad PCB。 目前只开发了 3D 插件 类，它将成为本文档的重点。 实现插件类需要在 KiCad 源代码树中，文件 ‘plugins/ldr/pluginldr.h’ 声明了所有插件加载器的基 类。这个类声明了我们期望在任何 KiCad 插件（样板代码）中找到的最基本的 函数，它的实现提供了对插件加载器和可用插件之间的版本兼容性的基本检 查。标题 ‘plugins/ldr/3d/pluginldr3D.h’ 声明了 3D 插件类的加载器。加载器负 责加载给定的插件并使其功能可用于 KiCad。插件加载器的每个实例代表一个 S3D_CACHE 类中。 除非正在开发新的插件类，否则插件开发人员不需要关心 KiCad 管理插件的内 部代码的细节; 插件只需要定义其特定插件类声明的函数。 标题 ‘include/plugins/kicad_plugin.h’ 声明了所有 KiCad 插件所需的泛型函数; 这 些函数标识插件类，提供特定插件的名称，提供插件类 API 的版本信息，提供 特定插件的版本信息，并提供插件类 API 的基本版本兼容性检查。

快捷键 鼠标操作和选择 左侧工具栏显示控制 原理图创建和编辑 简介 原理图编辑操作 Grids and snapping 编辑对象属性 使用符号 位号和符号批注 电气连接 网络类 图形对象 Schematic editing convenience functions 原理图设置 Opening legacy schematics 层次原理图 简介 在设计中添加原理图 将其与相邻的导线分开。 通常情况下，导线的样式遵照网络的网络类设置（如果没有指定其他网络类，网络就属于 默认 网络类）。然而，所 选导线的样式可以在导线的属性对话框中被覆盖（当导线被选中时点击 ）。可以设置导线的宽度、颜色和导线的 样式（实线、虚线、点线等）。将宽度设置为 0 ，清除颜色，并使用 默认 导线样式，将分别使用网络类设置中的默 认宽度、颜色和样式。如果在选择中包含了一个导线结点，结点的大小也可以在这里进行编辑。 18、19、20、21、22 和 23 的导线上使用了结点。 结点大小自动遵循原理图的 结点大小 设置，在 原理图设置 → 通用 → 格式化。颜色遵循 网络类设置。自动尺寸和颜 色可以在每个连接点的属性中被覆盖；尺寸为 0 相当于原理图的默认尺寸，而清除颜色则使用网络类颜色。 标签 标签是用来给导线和引脚分配网络名称的。具有相同网络名称的导线被认为是连接在一起的，所以标签可以用来进行 连接，而不需要直接画线连接。

在编辑画布上导航 快捷键 鼠标操作和选择 左侧工具条显示控制 原理图创建和编辑 简介 原理图编辑操作 网格 捕捉 编辑对象属性 使用符号工作 位号和符号注释 电气连接 网络类 图形项目 原理图设置 Opening legacy schematics 层次原理图 简介 在设计中添加图框 原理图之间导航器 原理图之间的电气连接 层次设计实例 检查原理图 筛选工具 效果 禁用网格捕捉。 禁用将导线捕捉在引脚上。 编辑对象属性 所有对象都有可在对话框中编辑的属性。使用快捷键 或从右键菜单中选择属性来编辑所选项目的属性。只有当你 选择的所有项目都是同一类型时，你才能打开属性对话框。要想一次编辑不同类型的项目的属性，请参阅下面关于批 量编辑工具的章节。 在属性对话框中，任何包含数字值的字段也可以接受一个基本的数学表达式，从而得到一个数字值。例如，一个尺寸 将其与相邻的线段分开。 通常情况下，线的线型是按照网的《原理图设置网络类，网络类设置》（如果没有指定其他网络类，网就处于 默认 网络类）。然而，所选线段的线型可以在线段的属性对话框中被覆盖（当线段被选中时 ）。可以设置线的宽度、 颜色和线的样式（实线、虚线、点线等）。将宽度设置为 0 ，清除颜色，并使用 默认 线条样式，分别使用网络类设 置中的默认宽度、颜色和样式。如果在选择中包含了一个导线结点，结点的大小也可以在这里进行编辑。

选项，并从列表中选择要删除的预设。 网络和网络类控件 外观面板的网络选项卡显示电路板中所有网络和网络类的列表。每个网都有一个可见性控件，用于控制该网在飞线中 的可见性。在飞线中隐藏网络不会改变电路板的连接性，也不会影响设计规则检查器；这只是为了使飞线更容易理 解。 每个网络和网络类还可以指定一种颜色。默认情况下，此颜色适用于网络 (或网络类中的所有网络) 的飞线。默认情 况下，网络没有 况下，网络没有颜色；这由色样中的棋盘格图案指示。双击或右键单击网络或网络类颜色样本以设置颜色。 NOTE 默认网络类不能分配颜色， 因为该类中的网络将仅使用颜色主题定义的默认飞线最高颜色。 您还可以通过外观面板选择并高亮网络和网络类：右击网络或网络类以在菜单中显示这些选项。 网络类列表下面是一个包含网络显示选项的可扩展面板。第一个选项控制如何应用网络颜色。当选择了“所有”时，属 于网络或网络类别的所有铜项 于网络或网络类别的所有铜项 (焊盘、布线、过孔和区域) 都将呈现所选的颜色。当选中“飞线”(默认值)时，只有飞线 受网络和网络类别颜色的影响。 当选择“没有”时，网络和网络类颜色被忽略。 第二个选项控制如何绘制飞线。“所有图层”表示将在所有未连接的项目之间绘制飞线。“可见层”意味着不会向隐藏层 上的项目绘制任何最新的飞线，即使这些项目是未连接的。 选择和选择筛选器 Selecting items in the editing

来源：根据专家访谈、公开资料，由艾瑞咨询研究院自主研究及绘制。 对于这四类基础软件（操作系统、数据库、AI框架、中间件），其编写者将实现功能的代码按照一定的开源规范 开放，任何人可以查看、使用、贡献，同时，使用者也要遵循一定的开源规范。 基础软件开源范畴界定 国内基础软件开源界定 基础软件 具备能衍生出并支撑 多个技术簇的一类根 技术软件，拥有技术 门槛高、衍生场景复 杂等特点 中间件：不同系统和应用程序之间交互 常见许可证： • MIT • Apache2.0 • BDS2.0-clause • 木兰宽松许可证 类别二 一定条件下允许二 次闭源发行 常见许可证： • LGLP2.1，商业 软件通过代码类 库引用（软件代 码与引用的源代 码 呈 “ 松 耦 合 性” ）的方式 下可以闭源发行 类别三 不允许二次闭源发 行 常见许可证： • GPL （ 其 2.0 版 本不允许闭源发 行，3.0版本在 建议。 企业开发者旨在实现商业收益，选取优秀开源代码，并根据自身的行业Knowhow，在其上二次开发产出定制化的行业发行版本。 来源：根据专家访谈、公开资料，由艾瑞咨询研究院自主研究及绘制。 两类开源开发者行为差异 参与开源目的 代码贡献特征 付费意愿 平台权益 个人开发者 企业开发者 出于兴趣或求知欲进入 开源社区，希望学习社 区内优秀代码，并与 “大神”交流 以商业视角出发，希望

Cmd+Y 勾选/取消勾选 需要编辑 复选框。 虚拟键盘 一个小的可视键盘行显示在翻译字段的正上方。这对于记住本地标点符号（因 为行是每种语言的本地行）或具有难以键入的字符非常有用。 显示的符号分为三类： 用户配置的 特殊字符 定义在 用户个人资料 中 Weblate 提供的每种语言字符（例如引号或 RTL 特定字符） 使用 SPECIAL_CHARS 配置的字符 翻译上下文 此上下文说明提供有关当前字符串的相关信息。 Weblate 对字符串进行了广泛的质量检查。以下部分将对它们进行更详细的描 述。还有针对特定语言的检查。如果有错误报告，请将缺陷提交。 概要:: 范围:: 检查的类:: 检查的标识符:: 忽略的标记:: 概要:: 范围:: 检查的类:: 检查的标识符:: 忽略的标记:: 参见 CHECK_LIST, 使用标记定制行为 译文检查 在每次翻译更改时执行，帮助译者提交高质量的翻译。 BBCode duplicate ignore-duplicate 检查译文中是否有连续重复的单词出现。这通常表示译文中存在错误。 提示 概要:: 范围:: 检查的类:: 检查的标识符:: 启用的标记:: 忽略的标记:: 概要:: 范围:: 检查的类:: 检查的标识符:: 忽略的标记:: 此检查包括特定语言的规则，以避免误报。如果在您的情况下错误触发，请 告诉我们。请参阅 在 Weblate 中汇报问题。

Cmd+Y 勾选/取消勾选 需要编辑 复选框。 虚拟键盘 一个小的可视键盘行显示在翻译字段的正上方。这对于记住本地标点符号（因 为行是每种语言的本地行）或具有难以键入的字符非常有用。 显示的符号分为三类： 用户配置的 特殊字符 定义在 用户个人资料 中 Weblate 提供的每种语言字符（例如引号或 RTL 特定字符） 使用 SPECIAL_CHARS 配置的字符 翻译上下文 此上下文说明提供有关当前字符串的相关信息。 一旦提交了未通过检查的译文，会立即向用户显示： 自动修正 除了 质量检查 外，Weblate 还可以自动修复翻译字符串中的一些常见错误。 谨慎使用它，不要使其增加翻译错误。 概要:: 范围:: 检查的类:: 检查的标识符:: 忽略的标记:: 参见 AUTOFIX_LIST 质量检查 Weblate 对字符串进行了广泛的质量检查。以下部分将对它们进行更详细的描 述。还有针对特定语言的检查。如果有错误报告，请将缺陷提交。 此检查确保在翻译中也找到它们。 备注 目前检测 BBCode 的方法非常简单，所以此检查可能会产生误报。 连续重复的单词 在 4.1 版本加入. 概要:: 范围:: 检查的类:: 检查的标识符:: 忽略的标记:: 概要:: 范围:: 检查的类:: 检查的标识符:: 启用的标记:: 忽略的标记:: 概要:: 一行文本中包含同一单词两次： 已翻译字符串 weblate.checks.duplicate.DuplicateCheck

Cmd+Y 勾选/取消勾选 需要编辑 复选框。 虚拟键盘 一个小的可视键盘行显示在翻译字段的正上方。这对于记住本地标点符号（因 为行是每种语言的本地行）或具有难以键入的字符非常有用。 显示的符号分为三类： 用户配置的 特殊字符 定义在 用户个人资料 中 Weblate 提供的每种语言字符（例如引号或 RTL 特定字符） 使用 SPECIAL_CHARS 配置的字符 翻译上下文 此上下文说明提供有关当前字符串的相关信息。 一旦提交了未通过检查的译文，会立即向用户显示： 自动修正 除了 质量检查 外，Weblate 还可以自动修复翻译字符串中的一些常见错误。 谨慎使用它，不要使其增加翻译错误。 概要:: 范围:: 检查的类:: 检查的标识符:: 忽略的标记:: 参见 AUTOFIX_LIST 质量检查 Weblate 对字符串进行了广泛的质量检查。以下部分将对它们进行更详细的描 述。还有针对特定语言的检查。如果有错误报告，请将缺陷提交。 此检查确保在翻译中也找到它们。 备注 目前检测 BBCode 的方法非常简单，所以此检查可能会产生误报。 连续重复的单词 在 4.1 版本加入. 概要:: 范围:: 检查的类:: 检查的标识符:: 忽略的标记:: 概要:: 范围:: 检查的类:: 检查的标识符:: 启用的标记:: 忽略的标记:: 概要:: 一行文本中包含同一单词两次： 已翻译字符串 weblate.checks.duplicate.DuplicateCheck

Cmd+Y 勾选/取消勾选 需要编辑 复选框。 虚拟键盘 一个小的可视键盘行显示在翻译字段的正上方。这对于记住本地标点符号（因 为行是每种语言的本地行）或具有难以键入的字符非常有用。 显示的符号分为三类： 用户配置的 特殊字符 定义在 用户个人资料 中 Weblate 提供的每种语言字符（例如引号或 RTL 特定字符） 使用 SPECIAL_CHARS 配置的字符 翻译上下文 此上下文说明提供有关当前字符串的相关信息。 一旦提交了未通过检查的译文，会立即向用户显示： 自动修正 除了 质量检查 外，Weblate 还可以自动修复翻译字符串中的一些常见错误。 谨慎使用它，不要使其增加翻译错误。 概要:: 范围:: 检查的类:: 检查的标识符:: 忽略的标记:: 参见 AUTOFIX_LIST 质量检查 Weblate 对字符串进行了广泛的质量检查。以下部分将对它们进行更详细的描 述。还有针对特定语言的检查。如果有错误报告，请将缺陷提交。 此检查确保在翻译中也找到它们。 备注 目前检测 BBCode 的方法非常简单，所以此检查可能会产生误报。 连续重复的单词 在 4.1 版本加入. 概要:: 范围:: 检查的类:: 检查的标识符:: 忽略的标记:: 概要:: 范围:: 检查的类:: 检查的标识符:: 启用的标记:: 忽略的标记:: 概要:: 一行文本中包含同一单词两次： 已翻译字符串 weblate.checks.duplicate.DuplicateCheck