solidworks-threaded-holes

1# SolidWorks Threaded Holes
2 
3## 先判定能力等级
4 
5当前稳定脚本是 `scripts/create_threaded_hole_template.py`，它在新建矩形样件上生成 ISO 公制内螺纹孔。
6 
7- `verified`：M3/M4/M5/M6/M8/M10/M12 粗牙内螺纹，盲孔或真正 `Through All` 底孔，孔口倒角，右旋/左旋，公差属性，真实 `Metric Tap` Thread 特征，STEP 和审查证据。已在 SolidWorks 2026 实测盲孔与贯穿孔。
8- `reviewed`：表外 ISO 公制规格；必须由用户显式提供 `--tap-drill`，不得猜测底孔。
9- `pilot`：对现有零件定位并改孔、Hole Wizard/Advanced Hole、外螺纹、英制/UN/UNF/NPT/BSP、多头螺纹、显式牙型与钻尖/退刀槽。执行前读取 [扩展路线图](references/threaded-hole-roadmap.md)。
10 
11## 稳定工作流
12 
131. 从仓库根目录运行 `python scripts/sw_preflight.py`。
142. 确认螺纹规格、内/外螺纹、公差等级、旋向、盲孔/贯穿、螺纹深度、底孔深度、孔位和是否要求真实牙型。
153. 在 COM 前校验所有值为有限数，底孔小于公称直径，螺纹深度不超过底孔/零件厚度，孔位保留螺纹大径和倒角边界。
164. 先创建真实底孔几何：盲孔用 `swEndCondBlind=0`，贯穿孔必须用 `swEndCondThroughAll=1`，不得用“板厚 + 1 mm”盲孔伪装。
175. 按圆心、半径和入口面枚举圆边，不依赖 `Edge1` 或屏幕坐标。
186. 尝试真实 Thread：`Type="Metric Tap"`，平面圆边使用选择标记 `1`，不要把同一圆边写入 `StartEntity`，不要调用不存在的 `LoadReferences`，不要用公称直径覆盖底孔圆柱直径。
197. Thread 失败时尝试 `InsertCosmeticThread3`；贯穿装饰螺纹用 `swEndConditionThrough=2`。COM 返回非空不等于持久化成功，必须重建后遍历特征树。
208. 只有真实/装饰螺纹均未留在特征树时，`--visible-thread fallback` 才创建 3D 草图螺旋线。螺旋线允许小数圈以保持真实螺距；单独导出 `*_thread_evidence.bmp` 后将草图隐藏，避免污染标准预览。
219. 创建孔口倒角，写入螺纹规格、底孔、深度、公差、旋向、终止条件和最终表达状态。
2210. 隐藏参考平面，保存 SLDPRT，导出 STEP，运行 `sw_review.run_review()`，目视检查等轴测/三视图。
23 
24## 模板用法
25 
26默认 M6×1 右旋 6H 盲孔：
27 
28```powershell
29python subskills/solidworks-threaded-holes/scripts/create_threaded_hole_template.py `
30  --thread M6 `
31  --output-dir C:\CADAutomationWorkbench\solidworks_threaded_hole_output
32```
33 
34M8×1 表外细牙、左旋、贯穿孔：
35 
36```powershell
37…