# Solidworks Multibody Cleanup

> 审计和清理 SolidWorks 多实体零件中的重复实体、孤立小实体、悬空附件、异常越界体和误建框架，并在删除前后使用文档路径、实体名称、包围盒和数量守卫。适用于照片粗模、导入或脚本生成模型出现多余棍状物、浮空管件、重叠槽钢、画面空白或交付前结构整理的任务。

- Skill: `zhaolong666520/solidworks-multibody-cleanup` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add zhaolong666520/solidworks-multibody-cleanup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zhaolong666520/solidworks-multibody-cleanup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Zhaolong666520 (https://skillmd.com/u/zhaolong666520)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/zhaolong666520/solidworks-multibody-cleanup

---


# SolidWorks 多实体清理

## 核心原则

先审计、再分类、后删除。包围盒重合和“看起来多余”都只能产生候选项，不能直接证明实体应删除。

首次执行清理前读取 [classification-and-deletion.md](references/classification-and-deletion.md)。SolidWorks 操作复用 `solidworks-automation`，机械合理性判断复用 `solidworks-mechanical-assembly-review`。

## 标准流程

1. 核对活动文档路径和类型，保存一个修改前备份或派生版本。
2. 运行 `scripts/audit_multibody.py`，得到实体数量、包围盒、接触计数、孤立小实体、重复包围盒组和可选越界体。
3. 在 SolidWorks 中逐个隔离候选实体，并从等轴测、正、右、俯视图确认其功能。
4. 分类为：正确主体、正确附件、预期接触/插入、重复实体、浮空残片、远端异常体或暂不确定。
5. 只删除已经确认的目标；使用精确实体名称加包围盒守卫，不能按模糊前缀批量删除。
6. 删除后强制重建，验证实体数量恰好减少目标数，关键主体和要求接触仍存在。
7. 重新运行审计，保存派生 SLDPRT、STEP 和四向预览。

## 审计命令

```powershell
python scripts/audit_multibody.py model.SLDPRT --report audit.json
```

需要检查模型是否超出预期设备包络时：

```powershell
python scripts/audit_multibody.py model.SLDPRT --limits-mm -800 -100 -300 800 1200 800 --report audit.json
```

脚本是只读宽相位审计。AABB 接触可能来自包围盒重叠，仍需目视或 SolidWorks 干涉工具确认。

## 删除守卫

删除脚本必须包含：

- 输入文件和输出派生文件的绝对路径；
- 活动文档路径和文档类型检查；
- 每个目标的完整实体名称；
- 每个目标删除前的预期包围盒及容差；
- 选择数量检查；
- 删除前后实体数量检查；
- 重建、保存、STEP 导出和预览检查。

若任何守卫失败，停止删除并重新审计。不要覆盖唯一已知可用文件。

## 完成条件

- 没有未经解释的孤立小实体、悬空管件、顶部短棒或远端几何；
- 重复候选已经逐项分类，已确认重复体被安全删除；
- 主要框架、容器、压缩机、电控柜和关键管路仍完整；
- 四向预览与最终 SolidWorks 文件来自同一版本；
- STEP 打开后仍能看到实体，包络位置正常。