7.1 KiB
CAD 零件分类知识库 · 0.1.0
community 项目内的中文 CAD 零件知识库,正式维护目录为 knowledge/cad-parts/。以 MCB 公开分类树作初始目录,借鉴 ISO 13584-42 的属性字典方法,保留离线资料、参数规则和有实测依据的生成规程。
原独立路径的兼容链接已删除,只维护 community 内这一份知识源。虚拟环境、私有配置和历史运行目录继续由 .gitignore 排除;生产构建不应打包它们。迁移记录见迁移校验,旧路径删除与离线复核见清理记录。
CAD 网页助手的知识工具与运行接线已实现,首轮真实网页 A/B 已完成。 原版 17 个通用 Skill 保留,仅增加一个只读 knowledge_lookup,精确命中直接取得短规程;上下文由程序去重并管理失效。同题关闭知识未生成实体,开启后完成 20 齿完整结构;齿轮加独立轴也通过几何复核,见题目、截图与实测报告。默认关闭,本机受控试验使用 pilot;少量样例不能证明总体成功率或速度提高。配置、接口、构建、测试和扩展见项目维护入口,完整设计见实施方案。
当前交付 203 类目录、6 个完整零件族、9 份共享特征、6 个完整示例和 60 条固定离线评测。知识库检索和参数校验保持离线运行;另提供独立的豆包 → makeCAD CLI A/B 测试程序,用于实际生成、测量和截图,不经过 Codex 或应用内置聊天。
生成用途已调整:旧六族长文保留为离线资料,不再推荐整包注入生成。 新增 generation-context 只返回与引擎匹配、明确准入的短规程;没有合格规程就返回空文本,不增加提示词。当前有20份生成实验候选:原13份齿轮/机构规程,加上五个样板和两种人字齿;另保留1份退出加载的历史版本,均无正式准入条目。网页pilot按类型、条件和精确构建加载,enabled及离线generation-context默认不加载候选。参见生成文本规则与证据、本轮七类补全和历史齿轮扩展。
首轮齿传动扩展与定向补测已完成,逐类状态见 当前覆盖与证据边界。9类单体已有有限正确实例,4类机构分别记录静态通过、证据不足或失败;不把目录覆盖解释为所有类别稳定成功。题目、原生设计、截图、公式错误与修订版本均保留。
五个旧样板与两种人字齿本轮已收尾:14次正式A/B、五类产物副本改参、独立v2取文发布。两种人字齿已分别登记并有参考验证,正式生成仍未通过;0.1.1修订尚无新模型效果证据。原Skill和模型/工具循环不变,历史失败及未送达原始响应保留。
先阅读
- 新对话交接:当前版本、现场与下一步
- 类别补全的工作方法与验收规范
- 中文完整分类目录
- 可放进 Markdown 的 Mermaid 分类树
- 六族知识覆盖清单
- Agent 入口 Skill
- 统一模板与属性规范
- 接口与后续扩展
- 来源和翻译疑点
- 验收报告
- 豆包直接调用的六族 A/B 生成测试
六个样板
| 基础族 | 复杂族 |
|---|---|
| 带孔安装板 | 带筋轴承座座体 |
| 台阶轴 | 渐开线直齿圆柱齿轮 |
| 六角头螺栓 | 带盖薄壁壳体 |
各族主文档的 YAML 保存属性真源,正文解释结构与策略;完整示例独立按需加载。索引和覆盖表由元数据生成,不维护重复的人工分类清单。
上述六族是离线资料入口。生成助手使用的新短规程、支持变体、参考/正式模型证据和缺口以generation/catalog.json、generation/policy.json及七类补全报告为准;两种人字齿独立登记,不用带槽结构替代无槽连续结构。
快速运行
cd '/Users/lk/Projects/vibemake相关项目/community/knowledge/cad-parts'
python3 -m venv .venv
.venv/bin/python -m pip install -e .
.venv/bin/python -m cad_knowledge search '制作带筋轴承座'
.venv/bin/python -m cad_knowledge validate ribbed-bearing-housing --example
.venv/bin/python -m cad_knowledge generation-context involute-spur-gear --engine-build 5707e4ae25621c4a32c40108
如当前 Python 已有 PyYAML 与 jsonschema,可直接运行 python3 -m cad_knowledge ...。验证全部资料:
python3 -m cad_knowledge check
python3 -m cad_knowledge evaluate --report reports/acceptance.json
python3 -m unittest discover -s tests -v
文档修改后运行 python3 -m cad_knowledge build 更新分类视图、索引和覆盖清单。固定评测不需要网络或 Key。Skill 位于本目录,未自动安装到个人全局技能目录。
实际生成 A/B 测试
下述六族 CLI 程序保留用于复现历史实验;它自行运行工具循环,不能代表 community 正式网页助手。当前齿轮试点使用独立 cad-generation-benchmark 项目的网页脚本,复用正式助手,冻结原版指令、技能、工具、引擎和模型设置,仅 B 开放按需查询短操作规程。历史 B 的长文策略不作为当前正式生成的默认策略。
按照 测试程序说明 配置本机 CLI 和豆包 Key 后运行:
python3 -m pip install -e '.[benchmark]'
python3 benchmark/run.py --out runs/doubao-ab-new
A 不加载零件族知识,B 加载对应零件族及共享特征;其余输入和预算相同。默认六族共 12 次生成,每次保存独立设计、逐轮模型与工具记录,以及 iso/top/front 截图。模型 HTTP 请求和 CAD 操作均不设置超时。
证据边界
分类目录覆盖不等于工程知识全覆盖。retrieval_verified 表示离线检索和参数规则验证,geometry_validated=false。真实生成测试的结果保存在各次运行目录,不自动提升知识文档的验证等级。自动检查只覆盖已实现的几何项目,单轮 A/B 结果不能证明总体成功率的提升。