7.8 KiB
CADmind 后端
通过自然语言和参考图生成机械零件,支持参数修改、几何核验、网页预览,以及 STEP / STL 导出。
本地运行
创建 Python 虚拟环境并安装依赖:
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
在项目根目录创建 .env,配置自己的 API 密钥:
OPENAI_API_KEY=your_api_key
启动交互式终端:
./start.sh
或启动独立后端 API(本文件中的命令均在 backend/ 目录执行):
.venv/bin/python run.py
API 默认地址 http://127.0.0.1:8080。工作台在独立的 frontend/ 项目中,通过 npm run dev 启动,页面地址为 http://127.0.0.1:8093。后端不托管前端页面或静态文件。
无需模型 API 调用,直接执行已有操作序列示例:
python main.py examples/flange.json
目录
engine/:模型调用、Agent 建模流程、操作执行和几何核验。capabilities/:建模能力的 YAML 契约及 Python 实现。web/:Flask HTTP 接口、异步任务与响应适配;Three.js 页面位于独立前端。examples/:可执行的 JSON 操作序列示例。scripts/:生成、修改和回归测试脚本。tests/:测试用例与历史结果。scratchpad/:实验和诊断脚本,部分依赖本机文件路径。
生成文件保存在 output/。该目录、虚拟环境、本地密钥和缓存不纳入版本控制。
当前网页服务用于内部测试。生成结果可能包含推定尺寸、简化结构或降级占位结果,应结合报告核对。
质量建模流程(chatgpt 分支)
默认入口使用 quality 模式:原图和原话 → 独立读图需求 → 主体 → 主要特征 → 精修 → STEP 回读验证。
每阶段必须通过固定包络检查和重新查看原图的多视图评审,才能推进。核对包含六个正交方向及轴测图;小字或引出线不清楚时,可裁切原图局部,保存像素坐标和来源哈希,并交给独立核对。建模工具可整体重建历史操作,失败时保留上一模型。
在 .env 中参考 .env.example 配置建模模型、核对模型和预算。CADMIND_READ_REASONING 单独控制读图推理强度(默认 medium),CADMIND_REASONING 控制建模与核对(默认 high)。默认沿用原程序的 CADMIND_MODEL(未设置时为 gpt-5.6-luna)和现有 API 凭据;读图、建模、核对默认使用同一模型。对照实验可显式设置 CADMIND_QUALITY_MODEL、CADMIND_REVIEW_MODEL,模型不可用时明确报错,不自动换成其他模型。质量模式消耗更多时间与 token,可用 CADMIND_MAX_CALLS 和 CADMIND_MAX_SECONDS 限制。调用上限包含读图、建模、核对;API 流程检查时间预算;网页的生成、恢复和修改运行在独立子进程中,超过任务预算及退出宽限后会停止子进程。原生 OCCT 崩溃不会直接结束网页服务;仅恢复之前已导出的有效候选,仍标记部分完成。
每次生成使用独立目录 output/quality_<时间>_<随机标识>/,包含原图、原始请求、模型配置、源码摘要、冻结需求、操作序列、API 返回、工具事件、各候选多视图及核对报告。修改质量模型会继承原图和旧操作作为上下文,生成新版本,保留原版本;目前不保证只改变指定的局部拓扑。
连接超时、流式响应中途断开或缺少结束事件,以及 HTTP 408/409/429/5xx,会在当前调用内自动重试。CADMIND_API_ATTEMPTS 默认 3(含首次请求),重试计入总调用次数与时间预算。只执行完整响应中的工具;已完成的几何操作不会因网络重试重复执行。每次中断单独记录响应 ID、部分输出及错误;中断请求的 token 用量可能无法获得,报告用量只累计收到完整用量数据的响应。鉴权、参数错误和输出达到 token 上限不盲目重试。
界面区分“分阶段核对通过”“部分完成,仍需修复”“生成失败”和旧结果“尚未独立核对”。质量模式不会用方块或简化模型冒充成功。passed 表示本轮检查通过,仍然包含模型视觉核对及推定尺寸,不能等同精确复原或制造验收。
旧流程仍可通过 CADMIND_MODE=legacy 或 /api/generate 的 mode: "legacy" 显式调用,用于对照;旧流程可能产生降级结果。网页未指定模式时默认质量模式。
无需 API 的回归测试:
python -m unittest discover -s tests/quality -v
真实图片基准运行(会调用 API,原图按原始字节保存):
python scripts/benchmark_quality.py \
--image /absolute/path/3c1.png --image /absolute/path/3c2.png \
--text '根据两张工程图重建同一个零件,遵循标注尺寸和可见结构。'
可选 --model、--review-model、--max-calls;--reference-step 仅在生成后计算几何指标,参考 STEP 不发送给模型。比较器平移包络中心,再从 24 个正交旋转中选择轴向匹配的方向计算体积交并比,不缩放或镜像;这个分数不能单独当作形状正确的证明。
部分完成的结果可以在网页点击“继续修复并核对”,或运行:
python scripts/benchmark_quality.py --resume quality_<时间>_<标识> --max-calls 30
尚未生成候选就中断的任务也可恢复:本次会话的错误卡片提供“从保存的进度继续”。刷新页面即开始空白会话,不自动加载历史任务;服务器保存的原图、进度和结果文件不随刷新删除。读图尚未完成则使用保存的原图重新读图;已读图则保留冻结需求,有操作记录则重放后继续。POST /api/resume 接受这些任务 ID;失败响应携带 part_name 和 can_resume,GET /api/interrupted 仅作为查询接口,不在页面初始化时调用。
直接打开本分支的 web/static/index.html 会自动转到 http://127.0.0.1:8081/ 测试服务,避免 file:// 页面无法请求 Python API。使用此文件入口时需先启动 8081 服务;HTML 本身不启动 Python 后端。
恢复会创建新任务、验证原图哈希、重放已保存操作,并沿用冻结需求复核当前阶段及此前要求;原任务保持不变。这是候选恢复,不是 API 会话原位续传。单次预算不代表整个恢复链的总预算,应合计相关任务。
也可独立比较已有 STEP:
python scripts/compare_geometry.py --reference reference.step --candidate model.step --output output/comparison.json
这一版完成质量流程与关键执行校验。自由建模脚本的隔离执行、持久化异步任务、自动视图配准与孔槽拓扑评测仍在后续路线中;尚不能据此宣称已经超过 SimpleCADAPI。
模型对照及迭代依据见 3C 零件:GPT-6 与 GPT-5.6 Luna 的程序生成对照。历史 GPT-6 实验结果与当前默认 Luna 配置应分开解读。
GPT-6 案例如何整理给 Luna 参考,见 建模经验的数据与迭代方案。原设计与本轮实现边界见 能力强化实验。
Codex 实操与 Luna API 对照
当前实验明确限定:项目 API 只调用 gpt-5.6-luna,GPT-6 侧由当前 Codex 会话直接操作能力库与 build123d,不调用项目 GPT-6 API。实测分析包含读图差异、阶段状态、修复原因、验证边界;开发案例保留实际编写的 Python、读图结论及失败/修订操作。
本地报告地址:http://127.0.0.1:8081/static/codex-luna-comparison.html。报告与CAD文件保存在本机,不注入生产能力或本轮 Luna 提示。旧的两边均使用API的报告单独标记,不能当作这轮实验。