solidworks-threaded-holes

name solidworks-threaded-holes description SolidWorks ISO 公制内螺纹孔自动化子技能。用于创建和审查 M3-M12 粗牙或用户明确底孔的自定义公制内螺纹，覆盖攻丝底孔、盲孔/贯穿孔、孔口倒角、右旋/左旋、ThreadFeatureData/CosmeticThread 降级和交付证据。用户要求 Hole Wizard、修改现有零件、外螺纹、英制/管螺纹或显式牙型时也应读取本技能，但这些能力必须按路线图标为 pilot 或人工复核，不得宣称已稳定实现。 SolidWorks Threaded Holes 先判定能力等级 当前稳定脚本是 scripts/create_threaded_hole_template.py ，它在新建矩形样件上生成 ISO 公制内螺纹孔。 verified ：M3/M4/M5/M6/M8/M10/M12 粗牙内螺纹，盲孔或真正 Through All 底孔，孔口倒角，右旋/左旋，公差属性，真实 Metric Tap Thread 特征，STEP 和审查证据。已在 SolidWorks 2026 实测盲孔与贯穿孔。 reviewed ：表外 ISO 公制规格；必须由用户显式提供 --tap-drill ，不得猜测底孔。 pilot ：对现有零件定位并改孔、Hole Wizard/Advanced Hole、外螺纹、英制/UN/UNF/NPT/BSP、多头螺纹、显式牙型与钻尖/退刀槽。执行前读取 扩展路线图 。 稳定工作流 从仓库根目录运行 python scripts/sw_preflight.py 。 确认螺纹规格、内/外螺纹、公差等级、旋向、盲孔/贯穿、螺纹深度、底孔深度、孔位和是否要求真实牙型。 在 COM 前校验所有值为有限数，底孔小于公称直径，螺纹深度不超过底孔/零件厚度，孔位保留螺纹大径和倒角边界。 先创建真实底孔几何：盲孔用 swEndCondBlind=0 ，贯穿孔必须用 swEndCondThroughAll=1 ，不得用“板厚 + 1 mm”盲孔伪装。 按圆心、半径和入口面枚举圆边，不依赖 Edge1 或屏幕坐标。 尝试真实 Thread： Type="Metric Tap" ，平面圆边使用选择标记 1 ，不要把同一圆边写入 StartEntity ，不要调用不存在的 LoadReferences ，不要用公称直径覆盖底孔圆柱直径。 Thread 失败时尝试 InsertCosmeticThread3 ；贯穿装饰螺纹用 swEndConditionThrough=2 。COM 返回非空不等于持久化成功，必须重建后遍历特征树。 只有真实/装饰螺纹均未留在特征树时， --visible-thread fallback 才创建 3D 草图螺旋线。螺旋线允许小数圈以保持真实螺距；单独导出 *_thread_evidence.bmp 后将草图隐藏，避免污染标准预览。 创建孔口倒角，写入螺纹规格、底孔、深度、公差、旋向、终止条件和最终表达状态。 隐藏参考平面，保存 SLDPRT，导出 STEP，运行 sw_review.run_review() ，目视检查等轴测/三视图。 模板用法 默认 M6×1 右旋 6H 盲孔： python subskills/solidworks-threaded-holes/scripts/create_threaded_hole_template.py ` --thread M6 ` --output-dir C:\CADAutomationWorkbench\solidworks_threaded_hole_output M8×1 表外细牙、左旋、贯穿孔： python subskills/solidworks-threaded-holes/scripts/create_threaded_hole_template.py ` --thread M8x1 ` --tap-drill 7.0 ` --through ` --handedness left ` --thread-class 6H ` --output-dir C:\CADAutomationWorkbench\m8x1_lh_output --visible-thread 支持 fallback （默认）、 always 和 never 。正常交付保持 fallback ；调试螺旋线时才使用 always 。 交付与验证 必须生成： *.SLDPRT *.step *_parameters.json *_review_report.json *_isometric.bmp 及三视图 仅在创建可见螺旋线时生成 *_thread_evidence.bmp *_parameters.json 中必须同时检查 thread_attempts 、 thread_evidence 和 thread_status 。只有下列条件同时满足才可交付： has_tap_drill_cut=true 且 has_mouth_chamfer=true 。 representation 为 real-thread 、 cosmetic-thread 或可解释的 visible-helix ； metadata-only 必须阻断模板交付。 review 的 expected_outputs_exist 和 previews_not_blank 为 true 。 标准预览不显示参考平面，不出现穿透实体的 3D 草图虚线，孔位和倒角正确。 详细实测接口、故障原因和官方文档链接见 螺纹孔实测经验 ；未实现能力和验收门槛见 扩展路线图 。