# 生成知识:由助手选择文件,按需读取 知识源已归入 community 的 `knowledge/cad-parts/`,旧独立路径及其兼容链接已删除。CAD网页助手使用只读`knowledge_lookup({document_id})`:助手从[阅读目录](reading-catalog.json)自主选文档,文件存在就返回原文,不再先申请分类、补参数或通过准入检查。首轮真实网页 A/B 和组合结构结果见[齿轮实测与截图](../reports/gear-integration-20261111/README.md),配置与接口见[项目维护入口](../../../docs/cad-part-knowledge.md)。 原版通用 Skill 全部保留。知识库入口 `SKILL.md`、下述维护规则、分类与证据不常驻注入;助手只需要简短的查询说明,以及命中后真正有用的正文。重复与过期知识由程序处理。 新增类型和后续修订统一使用[类别补全工作方法与验收](MAINTENANCE.md);新对话先读[现场交接](HANDOFF.md)。两份文档只供维护者使用,明确如何区分参考回放、正文送达、实际几何和收益证据,不增加模型侧的读取步骤。 知识库仍有用途:分类用于定位,属性用于参数校验,历史资料用于分析。但这不代表整份族文档值得放进每次生成上下文。此前长文方案没有证明收益;无效内容占比、与工具不对应、重复要求和示例锚定都是待检验原因,不能仅凭变差就认定是 token 多导致。 现在把实际生成文本单独存放。`references/` 的分类树、YAML 参数字典、来源、长推导、完整示例与通用解释均保留供离线使用,默认不注入。历史 `context` API 与旧六族测试程序保持可复现,但不作为正式助手的推荐接入方式。 ## 文本保留标准 一段补充应解决实际观察到的生成错误,并说明在当前工具中怎样操作。例如齿轮候选保留角度单位转换、单齿闭合、先 Join 后特征阵列、键槽连通及实际坐标检查;这些直接对应原失败。零件是什么、分类历史、重复的常识、未经试验的建议不进入生成补充。篇幅短是手段,最终依据是生成结果与耗时。 候选规程先在同版本真实引擎回放,再保持正式助手的模型、思考程度、指令、技能、工具、题目及引擎一致,比较 A 无补充与 B 仅追加规程。记录原生设计、过程、用时与截图;更换齿数或模数检查迁移。每次失败均保留,不用重试覆盖失败。服务异常且没有执行建模的案例单独归类,不计作几何质量失败。 生成收益记录在独立试验与人工证据索引中,几何结论需要审查产物。旧`policy.json`中的`approved`、`experimental`和证据字段只保留维护与历史意义,不控制生产读取。单次变好不足以宣称所有齿轮或所有模型都会提升;扩大适用范围需要新证据。若质量不提升且更慢,则缩减、修改或撤回该文本。 ## 当前状态 2026-11-12新增[球轴承短规程](candidates/ball-bearing-open-deep-groove-v1.md),阅读ID为`ball-bearing`。目录覆盖轴承、球轴承、滚珠轴承、深沟球轴承及英文名称,保留原助手自主选文。针对“单环无滚珠”和内置标准件仅包络的实际缺口,补充独立内外圈、滚道、滚珠与保持架;不扩写所有轴承类别。源码、共享8993增量发布、参考构造与效果边界见[球轴承报告](../reports/ball-bearing-knowledge-20261112/README.md)。以下状态标签保留此前齿轮恢复的历史含义。 当前目录0.3.0保留28个工程类型、53个登记属性。按用户纠正,**原有13类齿轮相关规程完整保留**,两类人字齿也恢复原完整正文;仅精简五类基础样板。当前15份齿轮相关完整规程+1份XZ筋风险提示,共16份experimental、5份retired、0份approved。此前收至5份的齿轮撤下/缩写决定已撤销,不能把“未证明稳定收益”当作“无收益”。见[恢复更正](../reports/gear-knowledge-restoration-20261112/README.md)及[当前交接](HANDOFF.md)。 板、轴、螺栓、普通座体和壳体沿原通用Skill;仅XZ造筋按需提示方向风险。原齿轮[收益和覆盖记录](../reports/gear-family-expansion-20261112/CURRENT-COVERAGE.md)、七类[正式A/B与失败](../reports/five-samples-herringbone-20261112/README.md)完整保留,不重发模型题或把未通过改成通过。`experimental`是历史实验状态标签,并非无用结论,也不再作为读取门槛。下述外直齿首轮记录保留历史背景。 第一版[逐点展开规程](archive/involute-spur-gear-expanded-v1.md)已归档且未列入当前阅读目录(历史标签`retired`):24齿生成的工作齿廓正确,但缺键槽;32齿迁移时模型漏掉半径增长项,生成一圈圆包,不能准入。历史文件保留用于复现。 当前候选为[第二版方程曲线规程](candidates/involute-spur-gear-equation-v2.md),状态 `experimental`,原始验证引擎 build 为 `5707e4ae25621c4a32c40108`,该构建号仅记录历史证据。2026-11-12 按用户要求取消部署版本匹配,前后端可以独立更新,不再按 `compatible_builds` 拒绝知识。它使用原有 `sketch.equation_curve`,避免模型展开几十个采样点;20/24/32齿已完成真实引擎参考回放,LLM试验独立记录。尚不宣称全部生成流程已稳定通过。确定性回放是验证操作可执行,不能冒充 LLM 生成成功。 第二版真实网页助手试验中,20齿完整生成并通过实际曲线采样、体积与截图复核;24齿完成齿圈和轮毂后服务中断,未切孔槽;32齿完成正确单齿后服务中断,未阵列。三个单齿曲线均与解析渐开线相符,但整题完成尚不稳定;不将局部收益夸大为全流程稳定提升,保持实验状态。完整过程、原生设计和截图见独立项目 `cad-generation-benchmark/reports/gear-recipe-pilot-20261111/`。 集成后的新一轮正式网页测试单独记录:最终同版本 20 齿题 A 未生成实体,B 只读取一次 v2 后完成轮毂、孔、键槽和正确齿形;20 齿与独立轴的组合也通过两实体及齿形复核。另有较早后端的 24 齿纯圆孔、无轮毂/键槽成功样例,不混入最终配对。测试未人工修补几何;同版本质量收益已在这一题观察到,仍不估计总体成功率或速度。详细证据及两次无效接入试运行保存在[本轮报告](../reports/gear-integration-20261111/README.md)。 ## 网页按目录读取 运行时真源为[reading-catalog.json](reading-catalog.json),当前登记17份原文。每项包含ID、名称、短用途、Markdown路径及原文档标识/版本;目录摘要在工具说明中提供给原助手,正文按需读取。模型调用: ```json {"document_id":"involute-spur-gear"} ``` 读取器仅按目录ID定位文件;存在则返回原文,不比较关键词、分类、参数、文档状态、构建版本或预登记哈希。适用范围与近似限制由助手结合正文理解。文件未找到返回`not_found`,不能据此认定工具没有该建模能力,也不能擅自省略轮齿。 同一轮有效上下文去重,正文被裁剪后允许重读;原始记录与推理状态保留。实际SHA只用于内容身份与去重。`CAD_AI_KNOWLEDGE_MODE=off`关闭模型侧工具展示,`pilot`与`enabled`展示同一阅读工具,不再按状态区分文件。 ## 离线资料与历史边界 `catalog.json`、`policy.json`、族长文、参数字典与历史检索用例继续用于维护和复现,不作为网页读取门槛。Python `generation-context`保留原离线政策行为,与新的网页直读接口分开,不能用它的跳过原因解释生产助手是否能读文件。它的`--engine-build`仍仅是诊断标签。 旧申请式路由的源码和固定案例已归档;对应历史成绩不算新接口测试。新增目录文件应核对实际读取和上下文去重,再由正式网页助手生成并保留原生设计和截图。读取成功、参考回放成功与生成效果提升分别记录。发布现场见[交接](HANDOFF.md),接口与测试命令见[项目维护入口](../../../docs/cad-part-knowledge.md)。