80 lines
7.1 KiB
Markdown
80 lines
7.1 KiB
Markdown
# 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 结果不能证明总体成功率的提升。
|