CadQuery中如何在任意面上创建沉孔和倒角孔

在CadQuery建模过程中，创建沉孔(cboreHole)和倒角孔(cskHole)是常见的机械设计需求。许多用户可能只熟悉在Z轴方向上创建这些特征，但实际上CadQuery提供了更灵活的功能，可以在任意平面上创建这些孔特征。

基本用法与常见误区

初学者通常会使用如下代码在Z轴方向创建倒角孔：

cq.Workplane('XY').box(10, 10, 10).faces('>Z').cskHole(1, 2, 90)

这种方法确实有效，但当尝试在其他面上创建时，比如在Y轴方向的面上，直接使用.faces('>Y').cskHole(...)会导致孔方向不正确。

正确的多方向孔创建方法

关键在于正确建立工作平面。CadQuery需要在目标面上先建立工作平面，然后再创建孔特征。以下是正确示例：

import cadquery as cq

# 创建一个立方体
box = cq.Workplane().box(100, 100, 100)

# 在Y轴正方向的面上创建倒角孔
box = box.faces(">Y").workplane().cskHole(10, 20, 90)

# 显示结果
show_object(box)

技术原理分析

CadQuery的工作平面决定了特征的创建方向。当直接使用.faces()选择面后，如果不显式调用.workplane()，系统不会自动将工作平面切换到所选面。.workplane()方法的作用是将当前工作平面切换到所选面上，这样后续的特征操作就会沿着该面的法线方向进行。

实际应用建议

1. 多方向孔创建：在复杂零件上创建多个方向的孔时，务必在每个新面上先建立工作平面
2. 参数理解：对于cskHole方法，参数依次为：孔径、倒角直径、倒角角度
3. 沉孔创建：cboreHole方法类似，参数为：孔径、沉孔直径、沉孔深度
4. 组合使用：可以链式调用多个孔创建操作，只需在每次切换面时正确建立工作平面

掌握这一技巧后，用户可以在任意方向的面上创建精确的孔特征，大大提高了建模的灵活性和效率。