You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.
# DIN 导轨端子片模型设计
## 目标
生成一个可复用的单片 DIN 导轨端子模型，用于后续复制排列成端子排。交付物同时包含 `.FCStd` 和 `.step` ：
- `.FCStd` 作为正式 FreeCAD 设备模板，保存几何和模板端子 LCS 语义。
- `.step` 作为纯几何交换文件，方便外部软件预览或复用。
## 参考与外观
参考视频中的端子排形态：多个窄端子片紧贴排列，安装在 DIN 导轨上，主体为绿色，上下有接线区域，中间有绿色窗口/主体分隔。
第一版采用可复用端子片深度，不追求品牌级完全复刻。模型需要清楚表达：
- 绿色主体外壳。
- 白色上接线区。
- 黑色下接线区。
- 绿色透明或浅绿色中窗。
- 背部 DIN 导轨卡槽/让位。
- 上下各一个接线孔/螺钉视觉特征。
## 尺寸
单片端子采用常见模块端子比例：
- 宽度： ，
- 高度：
- 深度：
坐标约定：
- X 轴为宽度方向，后续端子排按 X 方向复制。
- Y 轴为深度方向。
- Z 轴为高度方向。
- 模型原点位于端子片底部中心附近，便于在 DIN 导轨上排列。
## FreeCAD 模板端子语义
`.FCStd` 内包含两个模板端子 LCS：
| 对象名 | 槽位名 | 标签 | 位置语义 |
| --- | --- | --- | --- |
| `Terminal_Top` | `Top` | `Top` | 上接线口中心 |
| `Terminal_Bottom` | `Bottom` | `Bottom` | 下接线口中心 |
每个 LCS 写入：
- `Role = "Terminal"`
- `CanWire = true`
- `QetTemplateSlotName`
- `QetTerminalLabel`
- `QetTerminalType = "generic"`
模板端子禁止写入工程级字段：
- `QetProjectUuid`
- `QetElementUuid`
- `QetTerminalUuid`
- `QetInstanceId`
端子方向采用现有 FreeCADExchange 约定： `+Z` 表示出线方向。第一版上下端子均让 `+Z` 朝模型正面外侧的可接线方向，避免后续手动布线从设备内部穿出。
## 输出位置
生成文件放在：
```text
```
计划文件：
- `qet_terminal_slice.FCStd`
- `qet_terminal_slice.step`
- `create_qet_terminal_slice.py`
- `README.md`
`create_qet_terminal_slice.py` 用 FreeCAD Python API 生成几何、端子 LCS 和导出文件，便于后续调整尺寸或重新生成。
## 验收标准
1. 生成的 `.FCStd` 能被 FreeCAD 打开。
2. 文档中能看到端子片几何主体。
3. 文档中存在 `Terminal_Top` 和 `Terminal_Bottom` 两个模板端子对象。
4. 两个模板端子对象包含 `Role="Terminal"` 和 `CanWire=true` 。
5. `.step` 文件成功导出并包含端子片主要几何。
6. 文件生成不修改现有代码模块，也不依赖数据库或旧 3D 场景表。
## 自检
- 本设计只创建模型资产，不改 QET/FreeCAD 协同代码。
- 端子绑定语义遵守第一版约束，只在 FCStd 模板中保存模板槽位，不保存工程绑定字段。
- `.FCStd` 是正式资产，`.step` 是同步几何交换文件。
- 尺寸、输出路径、对象命名和验收标准均已明确。