Repository navigation
Releases
v2.2.0:建完要核实,没核实的不说「已验证」
v2.2.0:建完要核实,没核实的不说「已验证」
这一版的目标:建好的零件要逐项对照图纸,对不上或没核实的地方如实报出来。 另外,读零件状态快了约 100 倍;有几类注定失败的几何,现在在计划阶段就会被拦下。
建完后的核实
-
每次建模完成后,结果里附带零件的主视、俯视、左视和等轴测图,并和图纸拼成一张 1568×980 的对照图。隐藏线显示为灰色,对应图纸上的虚线。
-
finish_job要求逐个视图写对照结论,每个视图写清四项:图纸上有什么、零件上有什么、差异、PASS/FAIL/N/A。至少要覆盖主视、俯视和一个侧视。- 没写或写得敷衍:报
VIEW_REVIEW_REQUIRED。 - FAIL 只用于结构问题:孔、槽、台阶、凸台、筋、轮廓或标注过的圆角缺失、多余或位置不对。拿简化的替代体凑数也算 FAIL。
- 出现 FAIL 时,要求按修正后的特征图重建,不能直接收尾。
- 没写或写得敷衍:报
-
新增可选的尺寸表
dimension_ledger。每个决定零件形状的图纸尺寸写一条,建好后服务端在真实零件上测量比对。能测三类:- 某个轴向的包络;
- 圆柱的直径和轴线位置;
- 平面间距,用于台阶和厚度。
不符或测不到时给出警告,但不回滚零件。
-
verified的条件收紧。 以下两种情况,finish_job都只给built_unverified,并在verification_gaps里列出原因:- 还有任何完整性警告:体积不符、包络没核对、计划中的特征缺失、新零件没保存、尺寸表不符或测不到;
- 特征图里没有一个实测过的尺寸(
LEDGER_ABSENT)。
因此桌面版里「已验证」会比以前少,这是有意为之。
-
校验时检查
schema_version:只接受 0.8.0-draft 及之前的草案版本,其他版本在执行前就会被拒绝。
计划阶段拦下注定失败的几何
-
以下三类错误在执行前就报
VALIDATION_FAILED,并指出出问题的两段图元:- 闭合轮廓自交或折返;
- 旋转轮廓跨过旋转轴;
- 扫掠路径没有穿过轮廓平面,或者弯曲半径不大于轮廓尺寸。
前两项用本机历史会话里的特征图回放过,已经建成的图一张都没有被误拦。扫掠检查目前只有合成测试,因为本机还没有用到扫掠的历史特征图。
-
新增草图圆角图元
{"kind": "fillet", "radius": r},由编译器计算精确切点。以前切点靠手算,脚踏座的 R100 过渡就因此偏了 0.75 mm。 -
旋转圆弧的极值改为解析计算。
-
字段类型写错时,
validate()不再崩溃,而是指出是哪个字段。 -
expect.features可以写 0,表示没有这类特征。圆角和倒角按边数计,草图圆角也计入。
失败后接着修,而不是停下
- 圆角或倒角找不到边时,跳过这个节点,保留零件,并给出
EDGE_FEATURE_SKIPPED警告和候选边,之后可以在已建零件上补加。以前一条边找不到,整个零件就被丢掉。 - 拉伸失败时,根据编译器自己的记录说明三件事:草图平面在哪、当时已有哪些实体、哪些轮廓在两个方向上都碰不到材料。
- 还有修复次数时,失败结果附带
next_step,说明怎么提交修复、还剩几次。 - 把同一张特征图原样重交时,提示应该改哪里。只有超时或断线后才允许原样重交。
- 修复证据可以是对象或列表,不再只接受文本。
- 执行层超时报
EXECUTION_TIMEOUT,并说明下一步要先读状态。
速度与执行可靠性
- 每次工具请求都设置
CommandInProgress。在一个 73 个面的零件上,每个面的读取从 1436 ms 降到 14.7 ms,读全部面从约 105 秒降到 0.7 秒。 - 每次请求都检查被驱动的 SolidWorks 窗口,隐藏了就重新显示,不抢焦点。
- 新增执行健康熔断。参考几何类 COM 调用 5 分钟没有响应时,停止后续操作,并提示重启 SolidWorks;检测到新的健康实例后自动恢复。
- 保存、导出和关闭绑定到文档的唯一 ID。活动文档换了,或者身份核实不了,就拒绝写文件。这一项需要新的 C# 执行服务,见下方「升级」。
- DSH 工具调用超时从 5 分钟放宽到 30 分钟,长特征图不会建到一半被切断。
读图
read_drawing_region和read_drawing_text支持 PDF 图纸:把指定页按 300 dpi 渲染后,再裁图和 OCR。尺寸只从渲染出的图像读,不用 PDF 的文字层和矢量几何。
技能文档
- 新增通用构造策略参考
construction-strategies.md。 - 说明旋转只用于真正回转的部分。
- 说明单独一条 "Request timed out" 表示调用可能还在执行,应该先读状态,不要重交。
实测(作者本机评测台,gpt-6.1-sol high,11-10 至 11-13)
评测规则:包络 ±0.5 mm、体积 ±1%、单一实体、已保存、无人工干预。
| 组 | 结果 | 说明 |
|---|---|---|
| 开发组 7 张图 | 71 次中通过 30 次(42%) | 缺口块 9/14、阀体 7/13、2-25 支架 6/14、ZCT01 4/12、脚踏座 1/14 |
| 新测试组 5 张图,每张 3 次 | 15 次中通过 13 次 | 没通过的两次都被视图对照的 FAIL 拦下,没有当成合格交付 |
| 旧判定的错误接受 | 54 次 verified 中 11 次实际不合格 |
统计于 verified 收紧之前 |
| 构造策略 A/B,每边 10 次 | 不加 5/10,加了 6/10 | 差异不显著 |
- 新测试组的图偏小、偏简单,其中两张没有体积标准,三张的体积容差放宽到 ±5%。这个结果不能说明「首次通过率 ≥80%」的目标已经达到。
- 收紧
verified之后的效果,还没有在评测台上复测。
测试
- CI run 43432627893:Python 920 项全部通过,Node 54 项全部通过。
- 本机 Python 919 项通过,1 项跳过(这台机器不能创建符号链接)。
- C# 执行服务已编译,并已在真实 SolidWorks 上验证,确认文件写入的身份保护已开启。
升级
- 重新安装 Python 依赖,新增了
pypdfium2:pip install -r mcp-server-solidworks-main\adapters\claude\requirements.txt。 - 重新编译 C# 执行服务。 旧的执行服务不支持文档身份核对,新版 Python 端会拒绝保存,报
EXECUTION_SERVICE_UPGRADE_REQUIRED。 - 重新运行
Install-SolidWorksDsh.ps1,把 30 分钟的超时写进 DSH 配置。然后彻底退出 DSH(包括托盘)再重开。
已知限制
- 复杂铸件的通过率仍然很低,波动也大:脚踏座 1/14,ZCT01 4/12。
- 读错图纸尺寸时,尺寸表照样会对上,因为它比对的是模型自己写下的数值(例如 2-25 支架的 81 被读成 70)。尺寸表能抓住建模偏差,抓不住读图错误。
- 撤销只覆盖一步范围,不是完整事务。
- 扫掠的计划期检查只在两张草图都位于基准面上时生效,草图在实体面上的情况仍在建模时才发现。
- CI 不运行真实的 SolidWorks 建模,因为云端没有授权,真实建模仍在本机验证。
v2.1.0:建对了才算数,一次失败不再连环卡死
v2.1.0:建对了才算数,一次失败不再连环卡死
这一版的目标:新零件必须对得上批准的方案,失败或中断后下一次建模照常进行。另外加上了 Windows CI。
新零件对照批准方案自查
- 新零件的 Feature Graph 必须带上批准方案里的
expect:包络尺寸bbox_mm,可选体积volume_mm3和特征数下限。缺少圆角或倒角节点时,执行前就会被拒绝。 - 建好后用实测包络比对,每个轴的容差为 max(1 mm, 2%)。不符时报
PLAN_MISMATCH,丢弃零件并计入修复预算。体积偏差超过 2% 记为警告,finish_job时会再次提示。 - 选边失败(
REFERENCE_UNRESOLVED/REFERENCE_AMBIGUOUS)时列出最多 3 条候选边,每条附一个可直接使用的 near 点。
一次失败不再拖住后面的建模
- 上一个任务里已经干净丢弃的失败链,不再拦住下一个任务(另一张图、另一个会话)的首次建模去要求"设计已变更"确认。
- 执行服务按文档身份跟踪撤销范围。所属文档关闭后自动释放,中途被杀掉的构建不会再让之后每次构建都报
UNDO_SCOPE_ACTIVE。 - 构建中途抛异常时,只回滚本次打开且尚未提交的撤销范围,并报告真实的恢复结果。
- 超时提示改为"结果未知,先读状态再重试"。
- 过期的待确认 Feature Graph 不再占住任务的写权限。
- 审批策略为 never 的会话中,
confirm_action不再被升级成一个注定被 DSH(0.2.1-rc.5 起)拒绝的询问,失败后的修复可以继续。
读图与交互
- 圆弧终点偏离起点半径不超过 0.1 mm 时自动校正圆心。这修复了脚踏座轮廓开口导致三个拉伸为空的问题,已在真实 SolidWorks 上验证。
- 读图结论和计划放在消息正文里,审批问题控制在 600 字符、10 行以内,桌面版的提交按钮不再被挤出屏幕。
- 区域参数只写了视图名时,报错会给出图片尺寸和
主视: x0,y0,x1,y1示例。
演示与文档
batch_build.py新增--pace,用于录屏慢放:每个特征后切到等轴测视图并停顿。另有--lead-in倒计时。按一次 Ctrl+C 会先建完当前零件再停止。- 新增
docs/workflow.html工作流总览页。
测试
- 新增 Windows CI(GitHub Actions,windows-latest),每次推送自动运行所有不需要 SolidWorks 的测试。
- 首次 CI 运行(run 42350039312):Python 767 项全部通过,Node 53 项全部通过。本机 Python 为 766 通过、1 跳过(这台机器不能创建符号链接)。
- 撤销范围的修复已在真实 SolidWorks 上用临时零件验证,15/15 通过。
已知限制
- CI 不运行真实 SolidWorks 建模(云端没有授权),真实建模仍在本机验证。
- 方案自查目前只比对包络和体积,还没有做到逐个关键尺寸比对。
- 人设、策略插件和执行服务的修改,需要关闭 DSH 后用安装脚本重新部署才能生效。
演示录像(附件)
footpedal-full-run-2026-11-01.mp4:脚踏座从发图纸到出零件的一次完整运行,未剪辑,16 分钟。2026-11-01 录制,使用 v2.0.0 之后的开发版本,模型为 gpt-6.1-sol high。这次运行中,读图到提问约 11.5 分钟,批准后约 2 分钟零件出现在 SolidWorks 中。原片为 2.5K 画质,此附件压缩到 1080p,无音轨。- SHA-256:
1cc702535dd3d6c36193da64308450784542712a7a49ed8944ec62c077b04876
v2.0.0:读图到出零件回到分钟级
v2.0.0:读图到出零件回到分钟级
这一版的目标:看图、问一轮、批准后马上建模,同时保证尺寸准确。
实测数据(gpt-6.1-sol + high,桌面版)
- 2-25 支架:提问 5.8 分钟,批准到出模型 1.3 分钟;
- 脚踏座:提问从 12.5 分钟降到 5.5 分钟,只问一次批准;
- 每次请求带的工具从 177 个降到 25 个,技能目录从 164 个降到 1 个;简单步骤从 25–50 秒降到约 9 秒。
读图
- 直接看原图。尺寸分四类:明示 / 唯一推导 / 用户给值 / 真正未知,只问真正未知的,而且和计划批准合成一轮。
- 整个视图一次批量裁图(2 倍),不再切网格小块;工程图惯例直接采用;拿不准的地方附上推荐解读,一键批准。
- 聊天附件(sha256:…)自动解析成本地文件;去掉裁图次数闸门,改为只拦截原地打转。
流程
- 开任务、零件卡、映射、读图在提问前一步并行完成;批准后的下一步就是提交建模。
- 新建零件不再弹批量确认;本任务新建零件第一次保存到新文件不再弹窗(用唯一文档 ID 核对归属)。
- 校验失败、编译报错、体积/包络自查不符这类实施错误,直接修正后重新提交;需要确认的操作统一走 DSH 弹窗。
- 图纸分简单/复杂两级;建好之后的验证、保存等步骤自动降到 medium 档,出错或开始新一轮时恢复原档位。
预设范围
- SolidWorks 预设只暴露 16 个工具、1 个技能(插件在预设层屏蔽,其他预设不受影响)。
- 安装脚本会同步桌面版的人设和策略插件,Doctor 检查两者是否一致。
执行可靠性
- 没写坐标系的基准面草图采用规范坐标系,改用实体面时按实测坐标系转换(修复背面轴孔镜像)。
- 倒角/圆角选边:先按中点匹配,再判断是否在直线或整圆上,最后请 SolidWorks 精确计算点到边的距离(覆盖圆弧、样条、相交曲线)。
- 新建失败会核实文档清单后丢弃;定位类错误可自动修复 2 次(持久计数);其余情况转为一次用户确认,不会卡死。
- 切除切空时反向重试,并报告 DIRECTION_FLIPPED。
- 结束任务时报告漏建的特征和未保存的新零件。
测试
Python 724 项通过,Node 50 项通过;C# 执行服务编译通过,并已在真实 SolidWorks 中验证。
已知限制
- 修改已有零件时如果失败,SolidWorks 的撤销是否真正恢复原状还没有验证,所以报告为 recovery_unverified,不自动重试。
- 经过第三方中转时,偶尔会断线重试,单次最多多出约 1–2 分钟。