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