如何阅读工具调用、执行状态与任务记录
解释客户端中工具调用、参数摘要、执行状态、耗时和输出记录分别表示什么，以及工程师应如何把记录与当前 CAD 文档对应起来。
适用版本与预计完成时间
适用版本： 适用于当前星罗智算客户端任务记录与 SOLIDWORKS 2025 教学任务。
预计完成时间： 25–40 分钟。
准备条件
准备一条已结束的教学任务、对应的 SOLIDWORKS 源文件和允许公开的脱敏记录；失败样例必须保留原始状态。
任务输入
输入是任务编号、原始任务、活动文档、工具名称、参数摘要、状态、错误和输出文件标识，不包含完整账户信息或生产正文。
编号步骤
- 核对任务原文。
- 确认活动文档与时间。
- 逐项阅读工具和参数。
- 区分等待、执行、完成与失败。
- 查看原始错误。
- 回到特征树核对变化。
- 形成交接记录。
预期结果与验收方法
每项工具都能与任务要求和 CAD 变化对应，失败步骤没有被后续摘要掩盖，源文件、导出文件和人工检查结论各自有明确标识。
任务记录解决什么问题
星罗智算客户端中的任务记录用于回答三个基本问题：提交了什么任务，软件实际调用了哪些工具，每一步返回了什么状态。它帮助工程师从自然语言要求回到具体 CAD 操作，也为失败诊断和结果复核提供线索。任务记录不是质量证书，显示成功也不能代替对源模型、图纸和导出文件的人工检查。
阅读记录时应把客户端和当前 CAD 文档放在同一上下文中。先确认任务编号、时间和活动文档，再查看工具调用；如果文档已经切换、另存或关闭，记录中的对象可能不再对应屏幕当前文件。首次使用者可先阅读[连接 SOLIDWORKS 2025](/news/connect-solidworks-2025-first-modeling-task)，了解任务与活动文档的关系。
从任务原文开始
记录顶部的任务原文是检查依据。重新阅读单位、基准、尺寸、特征、保存和导出要求，判断任务本身是否完整。若原文含有“按常规”“和之前一样”“适当圆角”等歧义，即使后续工具返回成功，也不能据此确认设计符合要求。应先补充明确条件，再建立新的任务记录。
任务可能在执行前被系统拆分或组织为多个步骤。工程师要检查步骤是否覆盖了原文中的关键要求，并注意是否出现原文没有要求的修改。系统对任务的文字解释只能作为导航，真正需要核对的是后续工具和 CAD 文档变化。
理解工具调用
工具调用通常包含工具名称、参数摘要、开始与结束状态，以及宿主返回的信息。工具名称说明系统尝试执行的操作类型，例如读取当前文档、创建草图、建立特征、保存或导出；参数摘要说明该次操作采用的对象和关键数值。公开页面不应展示密钥、完整业务正文、账户令牌或未经脱敏的路径。
阅读参数时，不仅比较数值，还要看单位、选择对象、方向和终止条件。相同的拉伸深度作用于不同草图或方向会得到不同结果；相同圆角半径选择了不同边线也不是同一设计。记录中的参数摘要若不足以判断，应回到 SOLIDWORKS 打开对应特征，而不是从日志猜测。
一项工具调用的返回对象可能成为下一项工具的输入。检查连续步骤时，要确认前一步确实返回了预期对象，后一步没有引用到已删除、抑制或其他文档中的对象。涉及多个文件或配置时，记录还应能辨认活动文档发生过何种变化。
区分执行状态
常见状态可以归纳为等待、执行中、完成、失败或被阻止，但具体名称以当前客户端为准。等待表示尚未进入宿主操作，不能当作失败；执行中表示工具仍在处理，用户不应手工编辑当前文档；完成表示该工具返回了预期协议状态，不等于整个工程任务验收通过；失败表示工具或宿主明确返回问题；被阻止通常说明权限、会话、文档条件或安全规则不满足。
总任务结束时还要查看各步骤是否全部到达终态。中间步骤失败而后续没有执行，不能只看最后一行摘要。若系统显示部分完成，应明确哪些特征已经进入模型、哪些没有执行，并在继续前检查文档状态。
查看错误与原始返回
失败信息应尽可能保留原始工具、参数摘要、宿主错误和发生时间。不要把多个不同错误改写成“系统异常”，也不要只截图红色状态而忽略前一项调用。诊断时先判断错误来自连接与会话、权限、当前文档、选择对象、参数组合、文件系统还是能力范围。
原始返回可能包含技术字段，公开教程只解释必要含义，不展示敏感环境信息。若错误提到本地路径，应脱敏后再用于支持沟通。需要管理员介入时提供任务编号和错误分类，不发送完整账户信息或生产文件。
将记录与 SOLIDWORKS 对照
任务返回后回到 SOLIDWORKS，确认活动文档、配置和特征树。按记录顺序找到草图、基体、孔、阵列、圆角或保存操作，打开关键特征核对参数。执行一次重建，观察是否存在记录未反映的新警告。模型外形与记录一致还不够，应确认特征保持可编辑、引用稳定且源文件已经保存。
对于模型扫描和 STEP 检查，应分别记录各自实际返回的字段，并与具体文件关联。本次模型扫描只记录实体、特征、状态和粗粒度基础属性；STEP 独立检查记录包围盒、体积与拓扑。不要把前一次结果复制到新文件，也不要在文件被修改后继续沿用旧结论。基础字段可先参考[STEP 包围盒与体积核对方法](/news/step-bounding-box-volume)。
对本次安装板，应把客户端执行的建模步骤、SOLIDWORKS 界面人工另存 SLDPRT、STEP 路径写出成功和 STEP 独立解析结果分别记录。人工另存不能归入客户端自动工具调用；独立解析返回的 1 个实体、20 个面、108 条边、216 个顶点、100×60×10 mm 包围盒和 55,412.673 mm³ 体积，也不能反推源模型全部参数化特征已通过检查。
操作截图说明
- 配图说明：基体工具调用的参数和返回状态；
- 配图说明：中心孔与安装孔的连续任务记录；
- 配图说明：圆角工具调用和对应特征名称；
- 配图说明：四项主要特征的任务完成摘要；
- 配图说明：客户端确认会话与活动文档的只读扫描记录；
- 配图说明：不支持任务的原始返回和停止处理说明；
- 配图说明：失败后模型扫描列出的基体、孔和圆角特征；
- 配图说明：STEP 文件新生成状态与独立几何摘要。
形成可交接的检查记录
团队交接时至少保留任务编号、操作者、活动文档、客户端和 CAD 版本、开始与结束时间、关键工具、最终状态、源文件、导出文件和人工检查结论。成功与失败都应记录；人工修正过的模型要单独说明，不能继续标记为原任务自动完成。
日志应遵循最少信息原则。记录参数摘要和错误分类即可满足多数排查，不要写入完整手机号、邮箱、访问令牌、客户图纸正文或密钥。正式审计要求以企业制度为准，客户端页面不是绕过审批的替代渠道。
局限与下一步
任务记录反映的是软件执行过程，不判断设计是否满足法规、材料、强度、装配、公差、加工和检验要求。显示完成后仍需工程师验收；显示失败时先按[SOLIDWORKS 明确失败说明](/news/solidworks-explicit-failure)处理。若需要了解权限和企业审计，可查看[企业 CAD 智能体解决方案](/solutions/enterprise-cad-agent)。
常见问题
工具显示完成是否代表整个任务通过？
不代表。完成只说明该次调用返回终态，仍需检查后续步骤和 CAD 结果。
记录太技术化看不懂怎么办？
先保留原文、工具和时间，再由管理员或设计负责人解释；不要自行改写成笼统成功或失败。
能力限制与相关内容
任务记录不是设计质量证书。进一步了解字段可查看[CAD 审计字段清单](/news/cad-audit-field-checklist)，错误原则见[SOLIDWORKS 明确失败说明](/news/solidworks-explicit-failure)。