Design.Entities与SketchManager.Entities的区别及适用场景问询

核心区别 #

• Design.Entities：这是整个3D场景的全局实体仓库，所有最终要在视图里显示、参与3D运算（布尔操作、测量、渲染等）的实体，最终都得归入这个集合。
• SketchManager.Entities：这是专门服务于2D草图的工作集合，仅在激活草图编辑模式时生效，用于构建二维轮廓——比如做拉伸、旋转特征前，得先在这儿画好截面。

适用场景 #

• 使用Design.Entities的情况：
  • 添加已完成的3D实体（比如直接创建的立方体、生成的曲面）
  • 导入外部模型（STEP/IGES格式的实体）
  • 添加不需要依托草图的独立2D/3D几何图形
• 使用SketchManager.Entities的情况：
  • 进入草图模式后，绘制直线、圆、多边形等基础二维元素，为后续生成3D特征做准备
  • 编辑现有草图的轮廓时，直接操作这个集合里的元素

集合包含关系 #

• SketchManager中的实体不会自动存在于Design.Entities中，只有当你基于草图生成3D特征（比如调用SketchManager.Extrude()），或者手动将草图实体复制/移动到全局集合时，这些几何才会进入Design.Entities。
• Design.Entities中的实体和SketchManager.Entities是完全独立的存储容器，全局集合里的实体不会出现在草图集合中，除非你特意将其转化为草图元素。

补充：Eyeshot的示例覆盖场景确实全面，但基础API概念的文档解释不够系统，建议结合示例源码+官方内置API参考手册交叉验证，重点关注类的继承关系和成员注释，能更快理清逻辑。

内容的提问来源于stack exchange，提问作者Carlos Perez