CLI-Anything 3MF 网格几何编辑器：圆柱孔检测、缩放与 3D 打印文件修复实战指南-北京尧图网络

CLI-Anything 3MF 网格几何编辑器圆柱孔检测、缩放与 3D 打印文件修复实战指南【免费下载链接】CLI-AnythingCLI-Anything: Making ALL Software Agent-Native -- CLI-Hub: https://clianything.cc/项目地址: https://gitcode.com/GitHub_Trending/cl/CLI-Anythingcli-anything-3mf是 CLI-Anything 生态中面向 3D 打印场景的 3MF 网格几何编辑工具能够对 BambuStudio、PrusaSlicer 导出的.3mf文件完成圆柱孔检测、按目标直径缩放孔位、网格修复与文件差异对比且在重新打包时无损保留切片器元数据。读完本文你将掌握该工具的完整安装方式、五个核心命令的实战用法、--json机器可读输出以及多平面截面圆拟合、径向顶点缩放、法线方向内孔判定等底层实现原理可直接用它批量调整打印件的孔位尺寸。工具定位与适用场景3MF3D Manufacturing Format是面向增材制造的标准文件格式其本质是一个 ZIP 压缩包内部包含描述网格对象的 XML通常位于3D/3dmodel.model以及缩略图、切片配置、Bambu/Prusa 等切片器的附加元数据。在日常打印建模中最常见的返工需求就是把某个圆柱孔从原有直径改成目标直径例如把 3.0 mm 孔扩到 4.2 mm 以适配标准螺丝。cli-anything-3mf正是为此设计的命令行工具它支持检测网格中的圆柱孔返回圆心、直径、轴向范围与置信度通过径向缩放顶点把指定孔改为目标直径且不改变网格拓扑修复修改过程中产生的退化面、重复顶点等问题对比两个 3MF 文件的顶点数、面数、体积与封闭性差异与任何符合 3MF Core Specification 的文件兼容并优先保证 BambuStudio / PrusaSlicer 文件的切片配置不被破坏。该工具以 Python 实现入口为 threemf_cli.py几何核心拆分为parser解析/写回、inspector孔检测、modifier孔缩放、repair网格修复四个模块结构清晰、便于 Agent 程序化调用。安装与环境要求安装方式为通过 pip 直接安装仓库子目录也可以进入 3MF/agent-harness 目录后执行pip install -e .[dev]进行开发模式安装pip install githttps://github.com/HKUDS/CLI-Anything.git#subdirectory3MF/agent-harness安装后即获得cli-anything-3mf命令行入口由 setup.py 中的console_scripts注册。运行环境要求 Python 3.10主要依赖包括依赖用途click8.0.0命令行参数解析与子命令框架prompt-toolkit3.0.0交互式 REPL 的输入体验numpy1.24.0顶点/三角面数组运算scipy1.10.0分层聚类circle 分组trimesh4.0.0截面计算、水密性/体积统计、法线修复五个核心命令实战不带子命令直接运行cli-anything-3mf会进入交互式 REPL 模式支持info、inspect、resize、repair、compare、help、quit等指令。下面逐一讲解每个命令的参数与输出。info查看网格统计信息cli-anything-3mf info file.3mf该命令解析 3MF 后对每个网格对象输出顶点数、面数、包围盒min/max/size单位为毫米、是否水密watertight、体积mm³非水密时为 N/A与表面积mm²。其数据来自parser.parse_3mf()与backend.compute_mesh_stats()见 threemf_backend.py水密性判断与体积计算基于 trimesh只有水密网格才报告体积否则返回None。inspect检测圆柱孔cli-anything-3mf inspect file.3mf [--planes 20] [--min-diameter 0.5] [--min-confidence 0.7] [--axis 0] [--mesh 0]这是缩放孔位的前置步骤输出每个孔的编号hole_id、直径、圆心坐标、轴向0X、1Y、2Z及其轴向范围、置信度0~1和构成孔壁的顶点数。参数含义与默认值参数默认值说明--planes / -n20沿孔轴方向均匀布置的截面平面数--min-diameter0.5最小可接受孔直径mm低于此值忽略--min-confidence0.7最小检测置信度阈值--axis / -a0孔的轴向0X、1Y、2Z多数 3D 打印孔沿 X 轴方向故默认 X--mesh / -m0多对象文件中要检测的网格对象索引inspect输出的hole_id编号是本次检测运行内的编号后续resize必须引用同一检测配置下的编号尤其是--axis必须一致否则编号对不上。resize把孔缩放到目标直径cli-anything-3mf resize file.3mf --hole 0 --hole 1 --diameter 4.2 -o output.3mf参数包括--hole / -h可多次传入指定要缩放的孔 ID必填、--diameter / -d目标直径 mm必须为正数必填、--output / -o输出路径必填、--overwrite允许覆盖已存在的输出文件。--planes、--min-diameter、--min-confidence、--axis、--mesh与inspect保持一致——因为resize_holes内部会重新检测网格孔位来把hole_id解析为几何检测参数不一致会导致Unknown hole_ids错误。命令完成后会输出每个孔的变化报告旧直径 → 新直径、移动的顶点数并在缩孔后自动执行网格修复见下节。注意输出文件已存在且未加--overwrite时会抛出FileExistsError拒绝执行。repair修复网格问题cli-anything-3mf repair file.3mf -o repaired.3mf [--mesh 0] [--overwrite]修复管线包含四步见 repair.py合并重复顶点按坐标四舍五入到 6 位小数后去重并重映射三角面索引删除退化面移除存在两个及以上相同顶点索引的三角形零面积三角形删除未引用顶点清理不被任何三角形引用的孤立顶点并压缩索引输出报告包含vertices_merged合并数、degenerate_faces_removed退化面数、unreferenced_vertices_removed未引用顶点数及修复后的最终顶点/面数。另外还提供fix_normals()函数需 trimesh用于修复面绕序winding保证法线朝外这对后续体积计算和内孔判定很关键。compare对比两个 3MF 文件cli-anything-3mf compare file1.3mf file2.3mf [--mesh 0]以表格形式对比两个文件同一索引网格的顶点数、面数、体积mm³与水密状态并给出差异diff。典型用法是验证resize前后的改动是否符合预期——顶点数可能因修复略有变化而体积差应大致对应孔容积变化。对比逻辑见 inspector.py 的compare_meshes()。JSON 输出为 Agent 与自动化而生所有命令都支持在全局位置子命令之前添加--json输出机器可读的 JSONcli-anything-3mf --json inspect model.3mf{ file: model.3mf, object: part, hole_count: 2, holes: [ { hole_id: 0, center: [5.0, 5.0], diameter: 3.0, axis_min: 2.0, axis_max: 8.0, axis: 0, confidence: 0.95, vertex_count: 128 } ] }这是该工具“Agent-Native”特性的核心LLM/Agent 可以通过--json inspect拿到结构化孔位数据再据hole_id构造resize命令实现“感知—决策—执行”的闭环。错误也会以 JSON 形式返回{error: ..., type: ...}便于程序化处理。源码级原理孔检测与缩放的实现细节多平面截面最小二乘圆拟合检测圆柱孔检测流程inspector.py分为四步截面采样沿指定轴在num_planes个等距平面距网格边界内缩PLANE_INSET_FRACTION 0.02比例避免在端面切出退化轮廓上对网格求截面cross_section_circles见 threemf_backend.py。圆拟合对每个截面的轮廓点用Kasa 代数最小二乘法拟合圆fit_circle_least_squares解超定线性系统x²y²a·xb·yc0得到圆心(-a/2, -b/2)与半径并计算 RMS 拟合误差相对误差超过半径 5% 的轮廓被判定为“不够圆”而丢弃。跨平面聚类同属一个孔的不同截面圆具有一致的圆心和半径因此以(center_x, center_y, radius)为特征向量、以 0.5 mm 为距离阈值做 scipy 层次聚类把同一孔的各截面圆归为一组避免把“孔的内圆”和“实体的外轮廓圆”混在一起取平均。置信度与过滤confidence 检测到圆的平面占比 × (1 - 平均拟合误差/半径)低于min_confidence或平均直径小于min_diameter的候选被剔除。此外还有两处值得注意的细节轴向范围优先从真实孔壁顶点计算截面平面内缩会导致通孔两端顶点落在采样范围外_wall_axial_extent会按一个内缩量扩展搜索窗口_is_interior_hole通过孔壁面的法线径向分量区分“孔”法线指向轴线即指向空腔与“外轮廓/实心圆柱”法线背离轴线从而正确保留通孔和盲孔。径向顶点缩放保持拓扑不变缩放逻辑modifier.py不改变三角面连接关系只移动顶点坐标对每个顶点计算到孔轴的径向距离在垂直于轴的二维平面上选中径向距离在当前孔半径 ±0.06 mm_WALL_RADIUS_TOLERANCE以内、且轴向坐标落在孔范围含容差内的顶点作为孔壁顶点把这些顶点按new_radius / current_radius的比例沿径向缩放_scale_wall_radially并保持其角度位置不变——缩放只修改垂直于轴的两个坐标分量轴向坐标原样保留。由于拓扑与角度位置不变缩放后的孔仍是规则圆柱且原有三角面、材质属性不丢失。缩放完成后resize命令会自动调用修复管线清理可能产生的退化面。无损往返切片器元数据与材质属性保留parser是整套工具的“无损保障”parser.py 与 write_3mf解析时把除模型 XML 之外的所有 ZIP 成员按原始字节保存缩略图、Bambu 配置文件、OPC 关系文件等写回时逐字节复制模型 XML 采用“重建”策略重新解析原始 XML仅用新顶点/三角面数组替换被编辑object的mesh子树其余元素metadata、build 项、扩展命名空间、切片器设置属性原样保留预注册http://schemas.microsoft.com/3dmanufacturing/core/2015/02与http://schemas.bambulab.com/package/2021命名空间前缀避免 ElementTree 序列化时生成ns0之类的破坏性前缀每个三角形的非v1/v2/v3属性如pid、p1、p2、p3材质属性及其他厂商属性在编辑后按索引对齐保留组件对象与 build 的transform属性按原始 XML 保留。因此经resize或repair输出的文件可以直接在 BambuStudio、PrusaSlicer 中重新打开切片配置不丢失。验证与扩展测试与数据模型仓库在 3MF/agent-harness/cli_anything/threemf/tests/test_core.py 中提供了大量单元测试使用合成 numpy 数据与内存生成的 3MF 夹具无需外部文件覆盖解析器、几何后端、检测器、修复器与修改器五个模块。内部数据模型是冻结frozendataclassMeshData对象 id、名称、顶点数组、三角面数组与逐三角面属性和ThreeMFData网格元组、单位、模型路径、元数据、原始 ZIP 条目与源路径所有几何函数均为“纯函数”——返回新对象、绝不修改输入这保证了多次编辑、对比时数据的一致性与可复现性。如果你需要把该能力集成到自己的自动化管线推荐的工作流是# 1) 先检查孔位与当前尺寸 cli-anything-3mf --json inspect model.3mf --axis 0 # 2) 把 0、1 号孔缩放到 4.2mm 并自动修复 cli-anything-3mf resize model.3mf --hole 0 --hole 1 --diameter 4.2 -o output.3mf # 3) 对比前后差异确认改动符合预期 cli-anything-3mf compare model.3mf output.3mf结合--json与--axis的正确使用这套流程可以安全、可审计地批量处理大量打印模型。【免费下载链接】CLI-AnythingCLI-Anything: Making ALL Software Agent-Native -- CLI-Hub: https://clianything.cc/项目地址: https://gitcode.com/GitHub_Trending/cl/CLI-Anything创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

CLI-Anything 3MF 网格几何编辑器：圆柱孔检测、缩放与 3D 打印文件修复实战指南

相关推荐

Python包标准化实践：WeClaw框架发布全流程

SystemInformer 多语言切换：3 分钟看懂界面语言，附汉化教程

ESP32-P4 USB开发实战：从协议原理到枚举排坑

更多资讯

Agent Skills工程化实战：跨平台可复用能力设计

planning-with-files 的 /pwf 命令实战：用三文件模式启动持久化文件规划

AI全栈开发工程化实践：从模型选型到持续优化

Midscene Chrome扩展：AI浏览器自动化，3分钟跑通第一条指令

如何用AlphaFold从蛋白序列预测3D结构：5分钟跑通，附pLDDT读数完整指南

安全锥AI检测系统：YOLO多版本实战选型与边缘部署

今日更新

Linux 内核 ARM 虚拟内存布局全解析：从 4GB 地址空间划分到源码级验证

AIGC降重工具测评与教育应用指南

数据容灾核心指标与实战方案解析

本周精选

超人会飞不算本事：系统稳定依赖清晰规则与边界设计

超人VS蜘蛛侠：拆解超级IP的影响力与传播方法论

基于CNN的调制信号识别：MATLAB实现时频图分类实战

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？