SOLIDWORKS 工业设计

概述

从自然语言或受信设计定义形成可复核的机械三维设计，并交付便携工程产物。SOLIDWORKS 是产品领域名称；本 Skill 的本地执行权威只有 OCCT，不包含 COM、PIA、Bridge Host 或年度适配器。

保留同一任务

当前 Agent 保留原文和附件，将实际读图观察交给云端设计 Agent；云端围绕同一任务的公共草稿组合造型、测量和局部修改，审核后生成签名 solidworks.design-plan。不要在外部重写一份几何规格替代原始需求。缺失会改变几何或验收的事实时合并提问，其余事实作显式假设。

用户可以直接说：

• “设计一个 4 吸头柔性上料设备，给我 STEP、GLB 和四视图。”
• “把上一版夹具底板宽度改为 320 mm，其余结构不变。”
• “按这份受信尺寸表生成法兰接管的精确三维模型。”

按需读取

• 自动化设备或产线：先读 [工艺拓扑规划](references/process-topology.md) 和 [整机概念设计](references/equipment-concept.md)，选型时再读 [模块资产](references/module-assets.md)。
• CAD Layout 续建：继承 factoryLayout.concept3dHandoff 的注册表版本、资产、坐标、安装关系、端口和路线，不另建资产体系。
• 已有完整、受信 designSpec：读 [精确设计](references/design-spec.md)。
• 图片、扫描件或多张工程视图：读 [源图与产物核对](references/source-drawing-review.md)。由当前 Agent 实际读图，用带来源哈希的观察摘要衔接云端文本规划，导出后仍由当前 Agent 看图验收。
• 多零件机械装配、传动或承载机构：生成前读 [机械装配规划与核对](references/mechanical-assembly-review.md)。
• 续改已有签名项目或处理上传文件：读 [Agent 执行契约](references/agent-execution-contract.md)。
• CLI 返回失败后再读 [错误恢复](references/error-recovery.md)。
• 需要材料、工艺、公式或接口证据时，读 [工程事实与采用](references/engineering-knowledge.md)，从包内目录按需选择事实；历史项目可通过 knowledge --request - --json 查询。简单明确的任务可不使用知识。适用性和数值计算不代替下面的实体与实际多视图验收。

Runtime 安装与更新

每个新设计任务前从实际 Skill 目录运行：

powershell -NoProfile -File scripts/check-update.ps1

优先使用用户提供或 PATH 中的 solidworks-cli。找不到时读取 references/runtime-manifest.json，展示固定版本、大小、SHA-256、解析地址和下载域名；仅经用户同意后运行：

powershell -NoProfile -File scripts/install-runtime.ps1 -ConfirmedByUser

下载、Schema、本地校验和本地执行免费；云端规划使用 LLMRouter Token，可能收费。安装器不得修改永久 PATH，不得寻找 SOLIDWORKS 安装或加载系统 COM 组件。先运行 <executable> --version 和 doctor --json；doctor 只能报告 portable3dHost。

生成与续改

自然语言新设计省略 designSpec，由服务端设计 Agent 形成特征、装配和便携交付定义。用户已提供受信 designSpec 时保留其有效尺寸、稳定 ID 和材料作为原始约束。

用户限定供应商时，在请求的 supplyProvider 填入已核实的供应商 ID；不能从模型名称猜供应商。该约束覆盖需求解析、规划、复核和修订，指定路线不可用时应报告失败，不能删除约束或换用其他供应商。模型货架可用标记不等同于上游权限，实际供应商仍须以本次调用证据核对。

组织请求时区分可执行文件与 Agent 的交付说明。STEP/STP、GLB、PNG 由签名 Plan 和 Runtime 生成；概念用途、假设、源图冲突解释和未验证事项由 Agent 在最终交付消息中逐项说明，并在云端请求中明确这个责任边界。不要把“交付时说明”改成要求几何作者生成 README、报告或其他未支持文件。若用户确实要求某种说明文件，保留该要求并说明能力缺口，不能伪造文件或删除几何要求来满足它。

缺少特征、只有零件名/材料或需要从附件补全的定义都不属于完整 designSpec。保留原始要求和附件，由 Agent 选择自然语言生成入口；不要先提交空特征，再用付费重试补救。

solidworks-cli generate --request <request.json|-> --output <grant.json> --progress-jsonl --json
solidworks-cli revise --from <上一轮项目或续接回执> --request <request.json|-> --output <grant-r2.json> --progress-jsonl --json
solidworks-cli plan validate --grant <grant.json> --json
solidworks-cli portable-3d export --grant <grant.json> --output-dir <directory> --progress-jsonl --json

规划返回 INTERACTION_REQUIRED 且 data.job.agentInteraction.artifactReview 非空时，由当前 Agent 读取 [同任务看图与修正](references/agent-execution-contract.md#同任务看图与修正)，实际查看候选视图并提交带哈希绑定的反馈，再等待同一 job。这个暂停不表示任务失败或已完成，不创建替代请求，也不把检查图片转成重复询问用户。普通澄清问题仍按其实际缺失信息处理。

精确小改先按稳定 ID 和原 Plan 哈希准备变更，再走原历史重签：

solidworks-cli schema design-change-set --example --json
solidworks-cli plan prepare-revision --grant <prior-grant> --change-set <changes.json> --output <request.json> --json
solidworks-cli revise --from <prior-project> --request <request.json> --output <revised-grant.json> --progress-jsonl --json

哈希、稳定 ID、类型或依赖闭包不匹配即拒绝。没有签名 Plan 的 SLDPRT、SLDASM、SLDDRW 只能作为不透明参考附件上传；本 Runtime 不直接解析、转换或原位修改专有文件，也不得从二进制文件猜测稳定 ID。

便携交付门槛

portable-3d export 是唯一执行命令。签名 Plan 必须授权至少一个 STEP/STP B-Rep；正常产品交付还应包含 GLB 和等轴、正、右、顶 PNG。所有文件需通过格式回读、B-Rep 有效性、引用闭合、包围盒和预览解码/裁切检查，随后按目录原子发布。

输出目录可复用：无关文件保留；同名同内容幂等接受；同名不同内容在写入前拒绝。只交付当前 stdout 结果绑定的产物和 portable-3d-evidence.json，不得搜索旧临时目录补结果。

退出成功只证明技术执行完成。交付前逐项核对尺寸、孔槽、材料、装配接口及载荷路径，实际打开 GLB 与等轴/前/右/顶 PNG，并将源图与输出并排检查。任何未闭合要求都应标为未通过；概念装配另检查关键接口和运动极限位置，不能以外形相似或实体数量代替工程验收。

尺寸核对同时比较包围盒最小值、最大值和中心坐标；长度正确不证明原点、局部特征位置或朝向正确。以本次几何回读和实际视图为证据，不以 Plan 中的 intent 描述或云端 aligned 标签代替测量。发现偏差后先核对同一 job 的终态、实际用量与结算，再用自然语言 revise 引用当前项目，给出受影响对象、请求目标、实际测量及未满足的关系；由模型决定特征修正，不编辑 Grant 或注入手写 designSpec。没有新诊断证据时不重复付费请求，修订后的全部声明产物须重新生成并验收。

通孔、盲孔和槽还需核对实际轴向范围与开口：声明的切削深度等于板厚，并不证明切削从实体外表面开始。实体偏离基准平面时，结合孔底面、轴向截面、实体体积或背面视图确认贯通；带底面的孔不能按通孔交付。将测得的起止位置和目标关系反馈给模型，保留其自主选择特征与切削方式的空间。

OCCT 执行 signed Plan 中的 fixed/revolute/prismatic 关系、极限位、初始姿态和运动包络，但不生成 SOLIDWORKS 特征树、mate、SLDPRT/SLDASM/SLDDRW、工程图、BOM 或 Simulation。概念方案必须注明“概念模型，不用于直接制造”。

Agent 事件、费用与安全

遵守 [统一 Agent 长任务事件](references/agent-execution-contract.md#统一-agent-长任务事件)：并发排空 stderr/stdout，心跳不代表完成，不猜百分比或 ETA，正式交付只认成功退出码和 stdout JSON。

真实 Provider 用量即使最终失败也可能按量结算并返回 billingState: applied；调用前拒绝且无用量才不结算。付费请求失败时先对账，不自动重发。

认证只使用 auth status/login/logout --json 和高级 auth configure --stdin --json。不得暴露 Key、Grant、绝对路径或私有诊断，不自动充值。