21 KiB
CADmind 生成质量改造方案
日期:2026-09-07。工作分支:chatgpt。分析基线:CADmind 10652b1。
本文最初是实施设计和验收约定。用户随后授权实施,当前进展见下方记录;没有完成的验收不能视为已达到对标目标。
实施进展(2026-09-07)
已实现 M0 的输入与版本留档、模型配置和预算、执行参数及几何检查修正、真实结果状态;M1 的需求对象、主体/特征/精修关卡、独立多视图核对和原子重建已接入 CLI 与网页。局部平面、圆柱面/点材料测量、原图裁切取证和候选恢复也已接入。
尚未完成:需求解歧后带原因的版本更新、截面工具、隔离脚本执行、异步队列与 API 会话原位续传、自动图纸视图配准、独立孔槽拓扑评测及多次盲测。不能将本轮实现等同 M0–M3 全部验收通过。质量流程已作为本开发分支的默认试用入口;正式推广仍须满足第 6 节。
测试与运行说明见 README.md,实施验证记录见 quality-implementation.md。
1. 要达到的结果
目标是让用户直接提交原图或描述,CADmind 自动生成在结构还原、明确尺寸和可修改性上不低于 SimpleCADAPI + Codex 成功案例的零件,进一步提高重复生成的稳定性、减少人工纠错。
不能把这个目标缩减成“能导出有效 STEP”“体积差不多”“工具数量更多”。不宣称所有未知零件都必然成功;对标结论必须附带案例范围、重复次数、模型配置和质量报告。
近期范围:单零件和简单多实体结构,优先覆盖有多视图的薄壁件、机加工件、折弯件。完整运动机构求解、仿真、制造工艺认证不作为本轮质量改造的前置任务。
核心决策:保留现有 build123d 和能力契约,建设能读图、编排建模、观察和修复的后台工作环境。SimpleCADAPI 是可复用的候选 SDK,而不是必须重新实现一遍的功能清单。
2. 对比材料与已验证事实
参考的 SimpleCADAPI 仓库提交为 9f0b5ad92cf8e38c48bb9cfd3167e5c6c928a4f3,项目声明版本 2.1.0。examples/arm_link_3c/ 是该仓库本地未提交的成功案例;不能把这些本地新增内容误当成上游已发布内容。
主要对照材料:
- CADmind:
engine/agent_pipeline.py、agent_session.py、agent_tools.py、executor.py、claims.py、postcondition.py、prompt_builder.py、render.py、pipeline.py。 - CADmind:
scratchpad/gen_cage_test.py、gen_cage_v2.py、gen_cage_v3.py和output/mechanical_arm_link_3C/report.json。 - SimpleCADAPI:
examples/arm_link_3c/{DRAWING_NOTES,REQUIREMENTS,BUILD_PLAN,README}.md、model.py、profiles.py、verify.py、deliver.py、reopen_check.py。 - SimpleCADAPI:
docs/skill/中分阶段建模、几何检查和失败修复的流程;operators/boolean.py、operators/selection.py、recording/graph.py、params/frame.py和inspect/brep/。
对方文档中的指令是研究材料,不自动成为本项目要求。借鉴分阶段验证和修复机制,不照搬要求用户频繁确认、固定角色切换文案等交互。
2.1 当前差距不只是几何操作数量
CADmind 已经有多轮 Agent,支持 48 个能力、状态查询和图片快照。成功对标模型的主体构造是圆柱、平台、内腔、胶囊槽、圆角缺口、局部倒角,当前能力可以表达主要结构。尚未通过同条件生成实验证明当前 Agent 可以稳定组合成功。
历史测试输入存在重大偏差:第一版写成周向均布四槽;第二版写成方形框架且没有传图;第三版仍指定方形框架和有偏差的孔槽布局。最近 CADmind 模型确实从矩形拉伸和抽壳开始。应首先修复输入和结构解释链路。
SimpleCADAPI 成功案例先记录圆弧套筒、上下平台、上下面双长槽、左右每侧 2—1—1—2 短槽、同一端双侧缺口,再分别构建和验证。这种结构完整性,比增加大量不可靠的坐标描述更重要。
2.2 本轮本地探针结果
以下是实际执行结果,不是模型 API 生成实验:
| 检查 | 实测结果 | 改造含义 |
|---|---|---|
| L 形实体的内凹竖边做 R2 圆角 | 合法实体,体积从 5000 增至 5008.584 mm³;当前 volume_decrease 拒绝 |
圆角不能统一按减材验收,错误规则会阻碍正确建模 |
| 两个 10 mm 方块以完整面贴合后融合 | 有效单实体,原始重叠体积为 0 | 面接触与点/边相切要区分,“所有连接必须嵌入几毫米”不成立 |
| 在实体外侧声明贯穿孔 | check_claims 返回无违规 |
无材料不等于存在目标孔,需要材料邻域和孔轮廓证据 |
| Agent 调用缺少参数的布尔操作 | 直接抛 KeyError |
通用校验失败后仍执行自定义校验,破坏了可修复错误反馈 |
同一 build123d 环境重新读取 STEP 的结果:
| 文件 | 体积 mm³ | 包络 X×Y×Z mm | 实体数 | 面数 |
|---|---|---|---|---|
| 原始参考 STEP | 15641.824 | 59×55×58 | 1 | 147 |
| SimpleCADAPI 成功预览 | 15841.498 | 59×55×58 | 1 | 110 |
CADmind mechanical_arm_link_3C |
25159.670 | 59×58×55 | 1 | 139 |
三个文件都通过实体有效性检查。SimpleCADAPI 的体积偏差约 1.28%,上述 CADmind 结果约 60.85%。这仅说明材料量和包络存在差距,不证明形状相似度等于体积相似度,也不是对所有历史结果的最优值排名。面数受曲面分割、圆角和拓扑清理影响,不能用来判定还原准确率。
原始 STEP 只供离线评测使用;图纸生成实验的建模进程不得读取它、成功模型或手写成功脚本。两个文件的原点也不同,几何比较前需要有记录的刚体对齐。
2.3 最近新增改动的判断
当前已提交代码增加了 postcondition_check:值得保留,但应按操作语义校验。boolean_combine 的契约仍为 none,已有 cut 实现另有固定 1 mm³ 变化量检查。它还不是完整的几何效果验收体系。
工作区另外存在未提交的 engine/archetypes/_universal_modeling_method.md 和 scratchpad/bench_3c.py,本轮保留原样、不纳入提交。方法论中的分阶段建模值得借鉴,但仍只是提示词约束;其中将 56.1 当作确定内径的例子不应推广到本图,因为该尺寸的引出对象尚未独立确认。基准脚本的体积/面数比较也需要扩展。
3. 参考什么,避免照搬什么
| 对方做法 | 本项目采用方式 | 必须避免的误区 |
|---|---|---|
REQUIREMENTS.md 和图纸读取记录 |
结构化需求、证据来源和假设台账 | 将推断写成事实;把测试答案塞入通用提示词 |
| S1/S2/S3 分阶段构建 | 主体、关键特征、精修各有可执行关卡 | 只让模型在提示词中承诺检查 |
| 草图局部坐标系 | 显式平面、原点、方向和统一坐标变换 | 为补旋转错误反复换整体轴向 |
| 参数、函数和循环组织模型 | 可审计的参数化源码和可重建特征 | 只保存导出文件或无法重放的临时脚本 |
| QL 按位置、方向、几何类型选边面 | 可组合选择器、数量断言、失败解释 | 认为某个边索引在布尔操作后永远稳定 |
| 独立检查与反例 | 检查孔槽与保留材料,验证漏特征一定会失败 | 把“断言通过”当成断言本身正确 |
| 多视图、导出重开 | 正交视图、局部放大、截面、文件重读 | 只优化展示,不把清晰图像交回建模流程 |
| SDK 的持久化和操作图 | 源码、参数、依赖、版本与导出关联保存 | 一开始复制全套装配、仿真和格式转换体系 |
4. 目标流程与模块边界
原始请求与图片
→ 输入留档与视图整理
→ 带证据的结构需求 / 待解歧义
→ 建模计划和阶段验收标准
→ 主体构建 → 主体核对
→ 关键特征构建 → 特征核对
→ 精修 → 最终核对
→ 源码与模型文件重开验证
→ 交付版本和质量报告
每个核对失败 → 指定受影响的需求与特征 → 修复 → 重建 → 重新核对
阶段核对失败不能继续将该候选当作已验收结果。可以保留候选预览,必须清楚标出未完成项。只有满足关键要求的结果才进入正常交付状态。
建议模块均为待实现设计,当前文件名只作拆分边界:
| 模块 | 责任 | 与现有代码的关系 |
|---|---|---|
engine/config.py |
模型、推理设置、模式、任务预算和版本 | 替代硬编码 MODEL 和固定轮数作为唯一预算 |
engine/jobs/ |
任务 ID、事件、检查点、候选版本和恢复 | 从 agent_pipeline.py 拆出持久任务状态 |
engine/requirements/ |
原图解释、坐标、尺寸来源、特征清单、冲突记录 | 不把它混入长提示词和自由文本 assumptions |
engine/workflow.py |
阶段状态机和可接受的转移 | finish 变成提交候选,不直接等于通过 |
engine/modeling/ |
建模计划、脚本版本、阶段入口和重建 | 支持能力调用及受控源码执行 |
engine/inspection/ |
点分类、截面、表面性质、孔槽和局部尺寸 | 扩展 claims.py,共用可测试的测量基础 |
engine/review/ |
原图对照、需求覆盖、偏差分类和修复请求 | 与建模上下文分开,可串行调用同一强模型 |
engine/rendering/ |
规范视图、局部图、边线和遮挡控制 | 替代仅 400×400 三角网格线快照 |
engine/execution/ |
独立进程、SDK 环境、执行限制与产物清单 | 避免在 Flask 进程中任意执行模型源码 |
benchmarks/ |
固定输入、冻结验收项、对照与重复试验 | 替代将 status=ok 当生成质量通过的统计 |
不在第一轮同时建立全部目录。按下面里程碑引入,保持原有 IR 和 CLI 入口能运行。
4.1 需求是独立对象,claims 是它的检查证据
每条需求至少包含 id、特征类型、数量/布局、尺寸与容差、坐标系、证据来源、确定/推定/待解状态、验收方式和重要程度。证据来源可以指向用户原句或图片视图区域。
区分三个概念:用户约束、根据图推断的结构、模型自行选择的构造参数。建模参数可以改变;不能为让检查通过而直接改用户约束。修正错误读图需要新版本、原因和原图证据,依赖它的检查要失效后重新执行。
每条 claims 带 requirement_id 和被检查的模型版本。明确的用户尺寸由需求对象提供期望值,不能由 finish 临时另填一套值。没有适用检查器时标记“未验证”,不能用无关包围盒检查冒充孔距、壁厚或角度验证。
只增加 claims 数量不是覆盖率。切割体长度也不能证明最终槽长;关键特征应检查最终或已验收阶段几何。
4.2 先让主体正确,再增加构造自由度
读图至少检查主体截面、轴向、内腔、连接关系、各视图的对应特征。对低清晰度细节提供局部放大和视图裁切;裁切必须保留到原图的坐标映射。
主体阶段输出与原图相对应的正交图和至少一张轴测图,核对主体形状及空腔。视图名称由明确相机坐标定义,不能让 CAD 的 Z 顶视与图纸里的“顶视”自动等同。
结构解释错误时修改解释和构造方案;仅局部参数错误时修改相关参数。错误处理依据失败类别和进展判断,不将“任意失败两次就放弃特征”变成新硬规则。
4.3 受控脚本执行与 SDK 选择
质量版允许编写参数化 Python 源码、辅助函数和局部几何诊断。模型读取按需检索的 API 文档;优先使用现有稳定封装,复杂组合可直接使用选定 SDK 的公开接口。
第一步在现有 build123d 上验证该工作方式,再用相同编排与模型测试 SimpleCADAPI。SimpleCADAPI 优先作为依赖使用,避免复制整个源码树。SDK 与文档锁定版本,交付保留建模源码和依赖清单。
两者 OCP 依赖形式不同,应先使用独立环境和工作进程验证,不能直接向当前 .venv 混装后假定兼容。候选 SDK 间交换 STEP/BREP 和报告,不传递 Python 内核对象。一个候选模型原则上由一个 SDK 从头构建,跨内核对象拼接不作为第一轮设计。
工作进程只获得当前任务输入、文档和工作目录。模型 API 凭据留在编排进程;建模任务不读取评测答案或其他任务文件。超时、崩溃、资源限制和结构化日志属于执行器职责,简单地调用 exec 或 subprocess 不构成隔离环境。
先保存版本化源码并全量重建;有性能证据后再增加依赖增量重算。旧操作 ID 的覆盖必须处理,不能让旧下游几何悄悄引用修改前的结果。
5. 按交付物实施
M0:建立可信对照,修正会拦错或放错的基础规则
改动:
- 增加可配置模型、推理设置和任务预算,记录请求输入哈希、代码版本、SDK 版本、图像数量和真实 MIME。
- 固定原图和中性请求。成功模型、原始 STEP 仅提供给评测器。
- 持久保存工具调用、错误、渲染、阶段状态和 API usage;不依赖无法获取的内部推理内容。每次运行使用唯一目录,避免同名覆盖。
- 通用参数检查失败即返回;校验未知参数、非有限数字、重复 ID、悬空引用和无效输出。
- 修正圆角体积符号规则、面接触规则、固定切除阈值;按绝对与相对容差和特征语义检查。
group与融合的验收语义分开。 - 占位、降级、修改失败单独计数;网页显示实际状态,不能统一表现为正常完成。
验收:所有探针反例进入确定性回归;8 个代表性旧 IR 示例和一个历史报告重放无新增回归;同输入的基准运行可完整追踪,密钥和原始 STEP 不进入模型请求。
M1:建立真正的分阶段读图、生成和修复闭环
改动:
- 需求与证据结构、主体阶段关卡、特征清单和固定明确尺寸。
- 提高规范视图清晰度,提供局部放大和截面,减少三角网格边的视觉干扰。
- 评审只接收原始请求、需求版本、测量事实和当前候选视图;将建模模型解释作为待核实材料。
- 针对每条偏差返回可定位的修复任务,修复后重新检查受影响要求。
- 关键要求不允许被自动降级删除。图片无法确定的尺寸可以明确假设;结构歧义只有在自动核对仍不能解决时才询问用户。
验收:3C 主体不能作为方框通过;上下平台两条槽之间的连接条必须保留;左右短槽布局和同端双侧缺口不能漏;固定轴向尺寸不能互换后自证通过。3C 规则只放评测夹具,不写入通用提示词。
M2:扩大表达与诊断能力,选择最有效的执行路线
改动:
- 受控参数化脚本、按需文档、局部试验、检查点和源码重建。
- 显式局部平面、可组合边面选择和数量检查;点分类、表面半径与方向、截面和开口邻域测量。
- 在同一个 M1 工作流下对比 build123d 与 SimpleCADAPI,避免因更换编排而误判 SDK 贡献。
- 验证简单尺寸修改、槽数量修改以及修复后旧特征保留。
选择条件:若 build123d 已达到同等质量,则优先保持较少依赖;若 SimpleCADAPI 在选择、重放或检查上持续带来可重复收益,则接入为质量路线。只保留实际使用的接口,不先开发庞大的通用后端抽象。
M3:对标验收、推广与成本优化
改动:
- 用独立评测集对比端到端质量,保留失败案例和未解决项。
- 合格后将质量流程设为图纸生成默认路径;原有快速概念流程仍可作为明确模式存在。
- 再测试较轻模型承担简单结构、已确认参数修改和确定性操作。复杂读图与疑难修复在降配后必须重新证明质量。
- 扩展装配、特征树和生产交付需求,依据实际案例决定优先级。
发布门槛:见第 6 节。成本下降不得通过遗漏结构、放宽明确尺寸、隐藏失败或增加用户返工实现。
6. “不低于对方”的验收定义
6.1 比较对象与条件
产品比较对象是 SimpleCADAPI + Codex 的完整成功工作方式,不仅是同一 SDK 的某次 API 调用。历史成功 3C 作为可视基准;其完整运行预算未留在本项目中,因此不能直接声称它与新结果成本相同。
建议实验顺序:
- 固定当前编排与 SDK,只改变模型配置,观察模型因素。
- 固定强模型与 SDK,加入 M1,观察读图与纠错流程因素。
- 固定 M1 编排与强模型,对比能力调用、build123d 脚本、SimpleCADAPI 脚本,观察执行环境因素。
- 再与可复现的 Codex + SimpleCADAPI 完整流程比较;记录人工澄清和修复次数。
开发案例每组先运行 5 次作为工程筛查,不将 5 次实验包装成统计显著性。报告逐次结果和波动;对外声称稳定领先前,需要扩充独立案例与重复数并给出区间估计。
6.2 质量必须分项,不能用一个平均分掩盖致命缺陷
| 项目 | 验收方式 |
|---|---|
| 原图明确的关键结构 | 不得遗漏或改写;主体、孔槽数量布局、连接与缺口逐项检查 |
| 明确尺寸与方向 | 按提前约定的尺寸和容差验收;不能事后放宽或用换轴隐藏错误 |
| 外观与轮廓 | 同坐标、同投影多视图比较;检查局部特征,视觉与几何证据分开记录 |
| 有参考 STEP 时的几何差异 | 固定对齐后比较表面距离分布、体积对称差及关键截面;体积差仅辅助 |
| 无参考 STEP 时 | 使用图纸明确尺寸、结构清单、对应投影和独立视觉复核;未标尺寸不能冒充精确还原 |
| 几何与文件 | 有效实体、预期连通关系、STEP 重读、修改后重建 |
| 稳定性 | 报告每个案例的合格次数、失败类别、人工介入和修复次数 |
| 效率 | 总用量、重试成本、完成时间分布;质量达标后再比较 |
对齐只能使用有记录的刚体变换,不能缩放、非刚性变形或偷偷交换明确指定的轴来提高分数。允许的旋转与对称等价应在评测前定义。禁止将三维体积差、面数或渲染像素相似度中的任何单项当唯一判据。
对 3C:先达到主体、上下平台四长槽及中间连接条、左右十二短槽、同端双缺口和小安装孔布局的结构完整性;明确包络保持 59×55×58。槽宽、壁厚和模糊标注按证据状态管理。不能仅凭图上的 55.92 或 56.1 自动宣布获得准确内径。
6.3 首批回归范围与发布门槛
建议初始 12 个案例:3C 类薄壁多视图、安装板、折弯支架、带筋支座、回转件等,保留至少 4 个未参与提示词和实现调优的案例。分开测试图纸还原、文字生成和参数修改。
发布前要求:开发集关键结构和明确尺寸全部满足预定标准;独立集逐例比较没有已知关键质量退步,整体合格率不低于对照;失败和未验证项公开记录。样本不足时只报告“在这批案例上达到对照水平”。超过对方需要在质量相当后进一步证明稳定性、自动修复或成本优势,不能预先宣布。
不把所有 SDK 模块做完当作发布条件,也不将无限重试或永不返回用户当作质量承诺。达到任务预算后保存最好候选与未完成清单,状态为部分完成或失败。
7. 先实施的最小完整改动
第一批开发只覆盖 M0 和 M1 的一条完整纵向路径:原始输入 → 带证据需求 → 主体构建 → 清晰视图核对 → 特征构建与修复 → 真实质量状态 → 可复现评测。
该路径必须真实自动生成一个达到对照结构水平的 3C,并验证其他类型案例,没有效果证据不继续堆功能。若主要失败已经明确是执行表达能力不足,则及时引入 M2 的最小脚本工作进程,不等待所有检查器开发完。
现有 48 个能力、可重放 IR、标准件封装、报告和 Web 入口继续复用。逐步修正过度泛化的经验规则,将正确的语义变成测试和可执行验收。验证帮助发现和定位问题,生成能力和修复能力负责实际改善形状,两者必须一起交付。
8. 本轮完成状态
- 已创建
chatgpt分支。 - 已重新审阅最新 CADmind 检查层与 SimpleCADAPI 实现、成功案例和工作方式。
- 已运行小型确定性几何探针、读取三个 STEP,结果见第 2 节。
- 已形成模块边界、实施顺序、兼容策略和对标验收方案。
- 尚未实施 M0—M3,尚未运行新一轮模型生成对照,不声称质量已经提升。