# CAD 零件知识库：当前交接

更新：2026-11-12。先读本文及[维护规范](MAINTENANCE.md)，再核对实际文件、进程和队列。本文不注入生成模型。[精简前交接快照](../reports/utility-pruning-20261112/handoff-before-utility-v1.txt)保存此前发布和试验细节。

## 当前目标与用户原则

用户要求只保留有用且尽可能少的知识：简单类别不补整套规程；没有额外收益则撤下；具体高风险只给短提示。保留原17个通用Skill、原指令/模型工具循环，不加分类Skill、第二Agent或强制读取步骤。

本轮正在将此原则落实到源码与独立发布，不能仅回复建议。不要重跑已执行模型题、修补被评分产物或覆盖历史失败。Java显式类型，不改SQL，不输出配置、Token等敏感信息。

## 已完成的源码精简

- policy由20份experimental收为5份、retired由1变16，approved仍0。
- 外渐开线直齿0.2.0原文保留，有局部实际收益信号；完成稳定性仍不足。
- 四份0.2.0风险提示：示意蜗轮根圆/喉部余量；XZ轴承座筋方向；无槽人字与带槽双斜的半齿角、twist、符号和连接风险。新短文本模型效果未验证，不能继承旧成绩。
- 普通板、轴、螺栓、座体、壳体及其他无增益证据的整套规程不再加载。普通座体不需查知识；明确当前XZ造筋操作才返回方向提示，且不为方向提示追问全套尺寸。
- 可加载正文总量48936→8576字符，减少82.48%；非单次上下文或token测量。原文、原失败、原501条固定例与原Skill均保留。
- 历史路由用SHA锁定的精简前政策回归；当前政策另测，不能以历史绿例冒充当前运行验证。见[本轮报告](../reports/utility-pruning-20261112/README.md)。

## 前阶段已证实，不重做

七类（五基础样板＋两种人字）正式A/B14次已结束。A前五类均通过，B板/轴/座体/壳体通过，螺栓B交互锁缺头；两种人字A/B均未通过。B正文只送达轴、螺栓、座体、带槽双斜。座体与壳体B明显更慢，整体未证明收益。正式通过产物独立副本改参5/5，模型请求0。

前阶段v2路由114项后端测试、501条固定例、真实接口193/193通过；这是旧全量政策证据。0.1.1人字文本的模型效果未验证。[正式证据](../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)。旧齿轮v2-v5亦已归档，不重发；[历史覆盖](../reports/gear-family-expansion-20261112/CURRENT-COVERAGE.md)。

## 实际环境与发布边界

- community：`/Users/lk/Projects/vibemake相关项目/community`，唯一知识真源`knowledge/cad-parts`。
- 本轮外部证据：`/Users/lk/Projects/cad-generation-benchmark/experiments/utility-pruning-20261112`。
- 用户已确认将齿轮副名称合并一起验证发布，并使用独立8092/8994保留原引擎。共享8091/8993由其他任务管理，不能停止/重启。
- 精简前现场：8092前端PID8145、8994后端PID8135、已登录只读验证浏览器驱动PID10989。PID为临时观察值，操作前必须核对命令和监听。
- 精简前JAR在`.../five-samples-herringbone-20261112/frozen-backend-samples-v2/`，SHA `4b7aaa5bd886ccba1ea34b1be1be0789592ebc66ebb1c04f176f0dcab1b7185a`。不能覆盖该目录。
- 引擎`f3d62ce93f72db42f311a46e`原字节保留。按用户2026-11-12的明确要求，前端、后端和引擎允许独立更新；构建号不再作为知识加载门槛，也不再维护构建白名单。历史构建号只供诊断和证据检索；类型、条件、状态、权限和正文完整性校验保留。原Skill SHA `026284eff26c8b4be1f7864219921a54828338973317c291f7e862b1cc452ef7`。
- 浏览器正常登录，不复制登录存储/Token。只读接口验证禁止`/chat`，模型请求必须0。旧PID23355的浏览器已断开，不再attach。
- JDK21：`/opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk/Contents/Home`。启动器`scripts/java-with-env.py`字面读.env，不能source或回显。

## 本轮已收尾与下一步

2026-11-12约17:16，精简版已在独立8092/8994发布。后端PID观察为52488，前端PID8145，正常登录验证浏览器驱动PID10989；操作前仍需核对实际监听与命令。

冻结JAR：`/Users/lk/Projects/cad-generation-benchmark/experiments/utility-pruning-20261112/frozen-backend-utility-v1/vibemake-api-0.0.1-SNAPSHOT.jar`，SHA `2550956bef3c00956d0d2ea5b41b01e499875dee0eca95b660df89a604b2ffbc`。构建来源`build-source-v4`及`source-boundary-v4.json`，121项后端测试通过。正式登录取文/不取文接口27/27，未知构建仍被拒；通用工具、Skill、原引擎和已观察前端文件哈希保持。模型请求0。离线check、60案例、36 unittest通过。见[最终核验](../reports/utility-pruning-20261112/verification-v1.json)。

用户已确认**本轮只发布知识精简，保留原构建约束**；工作区另有取消版本限制与后续路由修改，本次冻结包不含该策略。不要把当前工作区自动当作已发布源码；以本轮冻结源码/包为准，不回滚并行改动。初次打包混入并行测试、测试依赖和浏览器初始化等失败日志完整保留；最终只发布通过的隔离包。

当前目标已完成。后续按具体失败决定是否缩短/修订提示，不为“类别齐全”恢复15份全文；简单类别允许无知识。四份新0.2.0提示的实际模型收益尚未验证，不能宣称质量或速度提升。没有新授权不重发旧模型题；如另做验证，必须独立cohort与版本、保留旧失败。
