# CAD 零件分类知识库 · 0.1.0 community 项目内的中文 CAD 零件知识库,正式维护目录为 `knowledge/cad-parts/`。以 MCB 公开分类树作初始目录,借鉴 ISO 13584-42 的属性字典方法,保留离线资料、参数规则和有实测依据的生成规程。 原独立路径的兼容链接已删除,只维护 community 内这一份知识源。虚拟环境、私有配置和历史运行目录继续由 `.gitignore` 排除;生产构建不应打包它们。迁移记录见[迁移校验](reports/community-migration-20261111.json),旧路径删除与离线复核见[清理记录](reports/community-path-cleanup-20261111.json)。 **CAD 网页助手的知识工具与运行接线已实现,首轮真实网页 A/B 已完成。** 原版 17 个通用 Skill 保留,仅增加一个只读 `knowledge_lookup`,精确命中直接取得短规程;上下文由程序去重并管理失效。同题关闭知识未生成实体,开启后完成 20 齿完整结构;齿轮加独立轴也通过几何复核,见[题目、截图与实测报告](reports/gear-integration-20261111/README.md)。默认关闭,本机受控试验使用 `pilot`;少量样例不能证明总体成功率或速度提高。配置、接口、构建、测试和扩展见[项目维护入口](../../docs/cad-part-knowledge.md),完整设计见[实施方案](plans/cad-assistant-knowledge-integration-plan-20261111.md)。 当前交付 **203 类目录、6 个完整零件族、9 份共享特征、6 个完整示例和 60 条固定离线评测**。知识库检索和参数校验保持离线运行;另提供独立的豆包 → makeCAD CLI A/B 测试程序,用于实际生成、测量和截图,不经过 Codex 或应用内置聊天。 **生成用途已调整:旧六族长文保留为离线资料,不再推荐整包注入生成。** 新增 `generation-context` 只返回与引擎匹配、明确准入的短规程;没有合格规程就返回空文本,不增加提示词。当前有20份生成实验候选:原13份齿轮/机构规程,加上五个样板和两种人字齿;另保留1份退出加载的历史版本,均无正式准入条目。网页`pilot`按类型、条件和精确构建加载,`enabled`及离线`generation-context`默认不加载候选。参见[生成文本规则与证据](generation/README.md)、[本轮七类补全](reports/five-samples-herringbone-20261112/README.md)和[历史齿轮扩展](reports/gear-family-expansion-20261112/README.md)。 首轮齿传动扩展与定向补测已完成,逐类状态见 [当前覆盖与证据边界](reports/gear-family-expansion-20261112/CURRENT-COVERAGE.md)。9类单体已有有限正确实例,4类机构分别记录静态通过、证据不足或失败;不把目录覆盖解释为所有类别稳定成功。题目、原生设计、截图、公式错误与修订版本均保留。 五个旧样板与两种人字齿本轮已收尾:[14次正式A/B](reports/five-samples-herringbone-20261112/FORMAL-V1.md)、[五类产物副本改参](reports/five-samples-herringbone-20261112/EDITS-V1.md)、[独立v2取文发布](reports/five-samples-herringbone-20261112/ROUTING-V2.md)。两种人字齿已分别登记并有参考验证,正式生成仍未通过;0.1.1修订尚无新模型效果证据。原Skill和模型/工具循环不变,历史失败及未送达原始响应保留。 ## 先阅读 - [新对话交接:当前版本、现场与下一步](generation/HANDOFF.md) - [类别补全的工作方法与验收规范](generation/MAINTENANCE.md) - [中文完整分类目录](references/classification/mcb-taxonomy.zh-CN.md) - [可放进 Markdown 的 Mermaid 分类树](references/classification/mcb-taxonomy-mermaid.zh-CN.md) - [六族知识覆盖清单](references/coverage.md) - [Agent 入口 Skill](SKILL.md) - [统一模板与属性规范](references/family-template.md) - [接口与后续扩展](references/maintenance.md) - [来源和翻译疑点](references/classification/sources.md) - [验收报告](reports/acceptance.md) - [豆包直接调用的六族 A/B 生成测试](benchmark/README.md) ## 六个样板 | 基础族 | 复杂族 | | --- | --- | | [带孔安装板](references/families/mounting-plate.md) | [带筋轴承座座体](references/families/ribbed-bearing-housing.md) | | [台阶轴](references/families/stepped-shaft.md) | [渐开线直齿圆柱齿轮](references/families/involute-spur-gear.md) | | [六角头螺栓](references/families/hex-head-bolt.md) | [带盖薄壁壳体](references/families/covered-thin-wall-enclosure.md) | 各族主文档的 YAML 保存属性真源,正文解释结构与策略;完整示例独立按需加载。索引和覆盖表由元数据生成,不维护重复的人工分类清单。 上述六族是离线资料入口。生成助手使用的新短规程、支持变体、参考/正式模型证据和缺口以`generation/catalog.json`、`generation/policy.json`及[七类补全报告](reports/five-samples-herringbone-20261112/README.md)为准;两种人字齿独立登记,不用带槽结构替代无槽连续结构。 ## 快速运行 ```bash 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 ...`。验证全部资料: ```bash 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 的长文策略不作为当前正式生成的默认策略。 按照 [测试程序说明](benchmark/README.md) 配置本机 CLI 和豆包 Key 后运行: ```bash 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 结果不能证明总体成功率的提升。