常见失败与能力边界：会话、权限和不支持的操作
归纳 CAD 任务中常见的会话、权限、文档状态、参数和能力范围问题，说明出现失败时应保留什么信息、按什么顺序处理。
适用版本与预计完成时间
适用版本： 适用于当前星罗智算客户端、SOLIDWORKS 2025 会话与官网已列出的工具范围。
预计完成时间： 30–45 分钟。
准备条件
准备一条真实失败或被阻止的教学任务、失败前模型副本和任务记录；生产模型、未保存文档和未知来源文件不用于演示。
任务输入
输入包括任务编号、活动文档、原始任务、最后成功工具、失败工具、错误、权限和文件状态；不输入密钥、模型提供方或配额信息。
编号步骤
- 停止继续提交。
- 保存现场和模型副本。
- 判断连接、会话、权限、文档、参数或能力层。
- 核对是否发生部分修改。
- 保留原始错误。
- 由责任人决定重试、恢复或升级处理。
预期结果与验收方法
失败原因被归入明确层级，模型前后状态有证据，未执行步骤没有被描述为成功；只有原因和恢复条件均确认后才允许重新提交。
先判断失败发生在哪一层
CAD 任务无法执行时，常见原因可以分为连接与会话、账户与权限、当前文档状态、任务参数、文件系统以及产品尚不支持的操作。不同原因需要不同处理方式。把所有问题都概括为“模型没理解”会丢失诊断线索，连续重复提交还可能改变当前文档。正确做法是停止操作、保护模型、保存原始信息，再按固定顺序检查。
本教程说明常见边界，不承诺覆盖每一种 CAD、插件和企业环境。当前支持的软件版本、工具和下载信息以[版本中心](/releases)为准。基础失败原则可先参考[SOLIDWORKS 自动化为什么要明确显示失败](/news/solidworks-explicit-failure)。
连接与会话问题
SOLIDWORKS 或 AutoCAD 窗口已经打开，不代表客户端已经连接到正确进程。多个宿主实例、模态对话框、启动未完成、宿主无响应或活动文档为空，都可能阻止任务。先确认 CAD 本身可以正常操作，再查看客户端会话状态和当前文档摘要。
排查时不要同时启动更多实例，也不要切换到另一个相似模型尝试。若宿主无响应，应按照企业桌面支持流程处理；有未保存生产内容时，不强制结束进程。恢复会话后重新读取当前文档，不能沿用旧任务对新会话的假设。
账户与权限问题
客户端登录成功只说明账户可以进入系统，不表示拥有所有模型和工具权限。模型查看、修改、导出、本地文件访问和管理操作可能分别授权。权限不足时应显示明确阻止状态，由管理员根据岗位和任务范围调整；用户不得切换共享管理员账号、修改本地配置或绕过服务端检查。
提交支持请求时提供账户标识的最少必要信息、任务编号、工具和时间，不发送密码、令牌或完整业务内容。管理员处理后重新建立任务，保留前一次被阻止记录。
当前文档状态问题
CAD 文档可能处于只读、未保存、编辑草图、打开对话框、重建失败、外部引用断开或配置不明确状态。工具需要特定文档类型时，工程图、装配或空白会话也可能不符合条件。开始任务前应确认活动文档、文档类型、配置、保存状态和已有错误。
对生产模型的排查优先使用副本。未经许可，不删除失败特征、不解除只读、不替换引用，也不覆盖原文件。文档已有错误时，先由设计负责人判断基线；自动任务不应在未知基线上继续增加特征。
任务参数与选择问题
缺少单位、基准、目标面、尺寸、终止条件或输出路径，会使任务无法确定操作对象。尺寸矛盾、圆角半径过大、孔位超出边界、阵列实例不成立也会触发 CAD 几何错误。已有模型中的边、面或特征发生变化时，原选择引用可能失效。
处理参数问题应回到任务原文和图纸，补齐明确条件后新建任务。不要让系统自动猜测关键工程参数，也不要为了获得成功状态随意缩小圆角、移动孔位或更换基准。任务书写方法见[如何编写清楚的 CAD 任务](/news/write-clear-cad-task-requirements)。
文件系统与导出问题
保存和导出可能因为目录不存在、没有写权限、文件被占用、名称冲突、磁盘不足或安全策略阻止而失败。先核对脱敏后的目标目录和覆盖规则，再检查 Windows 与企业终端策略。不要改用任意公共目录绕过权限，也不要把旧文件当作本次输出。
STEP 文件写出后仍可能无法解析或包含异常几何。必须把导出状态与独立检查分开记录。详细方法见[STEP 导出与独立几何检查教程](/news/step-export-independent-geometry-check-tutorial)。
不支持的操作
产品只执行当前注册、授权并经过验证的工具。复杂曲面、特定企业插件、某些钣金或焊件操作、装配高级关系、工程图细节、仿真、CAM 和其他专业模块可能不在当前范围内。遇到不支持状态，应明确说明并停止，不能用鼠标脚本、近似特征、预制文件或手工补画作为隐蔽替代。
如果业务确实需要新能力，应整理真实任务、输入文件、验收条件和风险，由产品与工程团队评估和测试后再发布。单次演示或一段生成代码不能视为已具备生产能力。
固定诊断顺序
先记录任务编号、时间、当前文档和原始错误；然后确认宿主是否正常、客户端是否连接到正确会话；再检查账户和工具权限；接着查看文档类型、配置、保存与重建状态；随后核对任务参数、基准、选择对象和文件路径；最后对照当前能力范围。每一步都基于真实状态决定是否继续。
若发现任务已经部分修改模型，应立即检查新增特征并保存诊断副本，由工程师决定保留、撤销或恢复基线。不要在状态不明时重复运行。任务记录中的工具与参数读取方法见[工具调用与任务记录教程](/news/read-tool-calls-task-status)。
操作截图说明
- 配图说明：当前工具目录缺少仿真任务所需步骤的清单；
- 配图说明：任务执行前保持打开状态的安装板源模型；
- 配图说明：客户端明确返回当前工具目录不支持仿真任务；
- 配图说明：不支持任务的原因说明和只读检查要求；
- 配图说明：任务结束后仍保持原状的安装板源模型；
- 配图说明：失败后只读扫描确认文件、实体和模型状态；
- 配图说明：失败后扫描列出的四项主要特征；
- 配图说明：失败后人工选择四个安装孔核对几何；
- 配图说明：失败结论与只读扫描结果的最终对照。
需要保留的信息
保留客户端版本、CAD 版本、任务编号、时间、活动文档类型、配置、工具、参数摘要、原始错误、文件状态和是否发生部分修改。公开或跨团队共享前，对路径、账户和模型信息脱敏。不要记录密码、访问令牌、完整手机号、邮箱、密钥或客户图纸正文。
何时停止并升级处理
涉及生产模型未保存内容、权限异常、宿主反复崩溃、文件可能损坏、任务产生未知修改或无法确认输出来源时，应停止并交由设计负责人、管理员或支持人员处理。只有当前文档恢复到明确状态、原因已确认且下一步经过批准，才能重新提交任务。产品能力和治理说明见[企业 CAD 智能体解决方案](/solutions/enterprise-cad-agent)。
常见问题
失败后可以换一种近似建模方式吗？
未经工程师批准不可以。近似几何会改变任务和验收依据。
什么时候必须停止并交由管理员处理？
权限异常、宿主反复崩溃、文件可能损坏或输出来源不明时应立即停止。
能力限制与相关内容
本教程不承诺覆盖所有 CAD、插件和故障。权限与审计见[企业 CAD 解决方案](/solutions/enterprise-cad-agent)，基础原则见[SOLIDWORKS 明确失败说明](/news/solidworks-explicit-failure)。