# autos.skills.solidWorks 库模块帮助文档

## autos.skills.solidWorks 成员列表 <a id="autos.skills.solidWorks" href="#autos.skills.solidWorks">&#x23;</a>

SOLIDWORKS 自动化技能包。  
直接复用 com.sldWorks，仅补充纯数据观察与目标身份核对；不自动建模、激活、保存或重试写操作。

### autos.skills.solidWorks.minAutos <a id="autos.skills.solidWorks.minAutos" href="#autos.skills.solidWorks.minAutos">&#x23;</a>
最低 Autos 版本。

### autos.skills.solidWorks.observe(sw,target,options) <a id="autos.skills.solidWorks.observe" href="#autos.skills.solidWorks.observe">&#x23;</a>
只读观察，返回普通表；失败返回 null,说明[,探测详情]。  
sw 为 com.sldWorks 会话；target 为完整路径或准确标题（不接受 COM 对象）。  
省略 target 仅列出会话，绝不把活动文档自动当作修改目标。  
先做不经 COM 的响应探测（probeTimeout 默认 1500 毫秒），主线程挂起时直接返回错误而不发 COM 调用。  
options: features=false,mass=false,faces=false,properties=false,listDocuments=false,featureLimit=60,dimensions=特征名/特征名数组/true,dimensionLimit=100,probeTimeout。  
返回 app,active,document（含 units,configurations,material）,identity；会话列表每项含 document,identity。  
按需返回 features,featureScan（草图项含 constrainedStatusName）,dimensions,dimensionScan,faces,faceScan,properties,mass,massState。  
readOk 仅表示请求的读取成功，不代表模型健康；特征扫描仅顶层，保留 truncated 与非零错误/警告；工程图 massState=not-applicable。  
不激活、不重建、不清选择、不截图、不保存。

### autos.skills.solidWorks.preflight(options) <a id="autos.skills.solidWorks.preflight" href="#autos.skills.solidWorks.preflight">&#x23;</a>
不经 COM 探测 SOLIDWORKS 会话是否可用，返回纯数据 {ok,running,responsive,processes=[{pid,responsive,hungThreads,mainWindow,dialogs}],advice}。  
options 可为超时毫秒或表 {timeout=2000,processId}。  
连接前、长任务每一步前调用；ok=false 时不要发送 COM 调用（会无限等待），先按 advice 与 dialogs 处理。  
不启动、不杀进程、不点击对话框。

### autos.skills.solidWorks.resolveTarget(sw,identity) <a id="autos.skills.solidWorks.resolveTarget" href="#autos.skills.solidWorks.resolveTarget">&#x23;</a>
核对 observe 返回的 processId,revision,path/title,documentType,configuration。  
匹配时返回原生 IModelDoc2 COM 文档；失败返回 null,说明。  
不回退到活动文档、不激活或切换配置。  
不是文件版本/实体 ID/事务锁，不检测关闭重开同一路径或同名未保存文档被替换。  
写入前仍需核对只读状态、编辑上下文、关键尺寸/特征；另存后重新观察。

### autos.skills.solidWorks.version <a id="autos.skills.solidWorks.version" href="#autos.skills.solidWorks.version">&#x23;</a>
技能包版本。
