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

更新日期：2026-11-12，Asia/Shanghai，约16:40。先读本文及[类别补全工作方法](MAINTENANCE.md)，再核对真实文件、进程和队列。本文供维护者使用，不注入生成模型，不自动启动试验。原在途交接保留于[收尾前快照](../reports/five-samples-herringbone-20261112/handoff-before-closeout-v1.txt)。临时PID不是永久配置。

## 1. 当前目标与用户确认

本轮补齐旧六样板中除齿轮外的五类：带孔安装板、台阶轴、简化外六角头螺栓、带筋轴承座裸座体、带盖薄壁壳体。用户另加人字齿，明确**无槽连续人字齿、带中央退刀槽双斜齿两种均覆盖**，分别登记，不互相替代。

用户已确认将同工作区并行出现的“齿轮副名称合并”一起验证和发布。后来共享8091被另一项任务切至新引擎，用户又明确选择**独立8092/8994保留原引擎发布本轮v2**。本轮未停止/重启共享8091/8993，不能把共享环境冒充本轮冻结环境。

保留原17个通用Skill、原指令与模型/工具循环，只由现有只读`knowledge_lookup`按需返回完整短规程。不新增分类Skill、第二个Agent、强制规划或前置读文步骤，不预装分类树/维护报告/旧六族长文，社区聊天助手不接入增强。

不重复发送已执行的模型题目，不人工修补被评分模型，不覆盖历史失败；参考、真实取文、正式模型和副本改参分别报告。新版本不能继承旧版本的模型成绩。

## 2. 本轮已证实结果

- `catalog.json` 0.3.0，28类型、53属性；政策20份`experimental`、1份`retired`、0份`approved`。默认`off`、本机`pilot`开放候选，`enabled`只加载`approved`，没有自动准入。
- 七类的标准参考、参数迁移、有限实际几何采样、多视图、原生设计及标准参考的单参数编辑均已完成。参考不计为模型成功，不证明完整参数域或制造级精度。
- **正式A/B共14次全部结束，每题A/B各一次。** 9个产物通过几何检查，但不能推算总体成功率。A前五类均通过；B板、轴、座体、壳体通过，螺栓B前端交互锁致缺六角头。两种人字齿A/B均未通过，失败保留。
- **B正文实际只送达轴、螺栓、座体、带槽双斜齿。** 板、壳体、无槽人字齿没取得正文，不能因有知识请求就算送达。无槽B两次查询均被拒；第二次仍缺完整显式facts。
- 正式通过产物的独立副本改参5/5通过，模型请求0：B板厚8→10、B轴首段40→50、A螺栓头下长30→40、B座体中心高45→50、B壳体共享退边10→12。两种人字齿无通过正式产物，正式产物编辑未验证；参考编辑另列。
- 两份人字齿正文另存0.1.1，仅将已有参考的两侧方程命令显式列出，防止已观察的符号展开错误。原0.1.0保留，正式A/B版本不替换。命令与已有标准/迁移参考一致；没有新增参考回放或模型试验，**0.1.1模型效果未验证**。
- 独立v2最终114项后端测试通过：知识34、样板4、协议26、客户端31、API19；测试、打包、冻结期间源码一致。原gear-v8的287条、样板v1的129条和v2的26条原字节保留；最终样板v3有34条、v4有25条，共501条固定例，哈希分别冻结。
- 独立v2真实登录接口193/193符合预期：183个路由响应＋10个非法枚举协议400拒绝。七类当前正文的ID、版本、声明SHA及实际文本SHA匹配；两种人字齿实际返回0.1.1。接口验证模型请求0。
- 独立接口首次驱动误将Schema外`type_id`的正确400按直接lookup的`ambiguous`比较，得到192/193；原结果保留。另存协议审计更正为193/193，更正审计网络请求0，未重发查询。
- 离线`check`、60/60固定案例、36项unittest已有通过；不替代Java路由或网页模型证据。整体未证明稳定质量/效率收益，座体与壳体B明显更慢，螺栓B中断也不构成有效收益对照。

完整证据：[本轮报告](../reports/five-samples-herringbone-20261112/README.md)、[正式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)、[收尾检查](../reports/five-samples-herringbone-20261112/closeout-v1.json)。

## 3. 真源目录与职责

| 路径 | 用途 |
| --- | --- |
| `/Users/lk/Projects/vibemake相关项目/community` | 当前仓库，先读AGENTS.md；不reset既有改动，不覆盖并行工作 |
| `community/knowledge/cad-parts` | 唯一正式知识源；类型/属性在catalog，准入/版本/哈希在policy |
| `/Users/lk/Projects/vibemake相关项目/vibemake` | 网页宿主；本轮只另启服务器，不修改宿主源文件 |
| `/Users/lk/Projects/vibemake相关项目/solidcraft-main` | 引擎源码；共享任务的新引擎不在本轮规程兼容证据内 |
| `/Users/lk/Projects/cad-generation-benchmark/experiments/five-samples-herringbone-20261112` | 本轮全部驱动、冻结包、原生设计、真实响应、原图和失败日志 |
| `/Users/lk/Projects/cad-generation-benchmark/experiments/gear-family-expansion-20261111` | 历史齿轮及复用的只读网页helpers；不覆盖旧记录 |

`CadAiKnowledge.java`只校验模型提交的结构化facts，不从自由文本抽取尺寸，也不会纠正错误对象的facts。原17个Skill文件`vibemake-service/src/main/resources/cad/ai/skills.json`的SHA始终为`026284eff26c8b4be1f7864219921a54828338973317c291f7e862b1cc452ef7`。

Java显式类型不用var；不改SQL，不打印密钥/Token等敏感信息。启动器`scripts/java-with-env.py`字面读取`.env`，不能shell source或回显配置。浏览器只用正常登录，不导出Token、不复制登录存储。

## 4. 冻结版本与实际现场

### 正式模型v1：历史冻结，禁止重发

```text
cohort: five-samples-herringbone-v1
JAR: .../five-samples-herringbone-20261112/frozen-backend-samples-v1/vibemake-api-0.0.1-SNAPSHOT.jar
SHA256: 177a1aad09e28fae2308f3cd4d8fd4f4d0cb9967229b95d9906c137b61f9f6b7
engine: f3d62ce93f72db42f311a46e
model: OpenAI gpt-6.1-terra / high
```

原12通用工具、17个Skill、前端和产品300秒单请求超时/262144字节文本预算保留。外部驱动无整轮截止、不补规程、不修形。两正式lane状态均`stopped`、999停止任务有结果、队列为空；参考和副本改参worker亦已停止。`worker-edit-formal-v1`的首次失败状态保留，最终以`worker-edit-formal-v1-r1-status.json`和对应结果为准，不重启旧worker。

### 路由与正文v2：当前独立发布，无新模型成绩

2026-11-12约16:33观察，独立服务启动绑定如下；先核对实际PID命令与监听再操作：

```text
frontend: http://localhost:8092/cad/
backend port / observed PID: 8994 / 8135
frontend observed PID: 8145
JAR: .../five-samples-herringbone-20261112/frozen-backend-samples-v2/vibemake-api-0.0.1-SNAPSHOT.jar
SHA256: 4b7aaa5bd886ccba1ea34b1be1be0789592ebc66ebb1c04f176f0dcab1b7185a
engine: f3d62ce93f72db42f311a46e（v1冻结原字节）
```

`frozen-backend-samples-v2/{deployment,runtime,validation-driver-freeze}.json`绑定源码、JAR、包内资源及验证脚本。用户已在新独立浏览器正常登录；驱动PID观察为10989，只在接口检查完成后保持浏览器供查看，不会自动发模型。原PID23355虽可能仍有node进程，其浏览器已断开，不能继续用旧attach假定可用。

独立验证脚本为`replay-live-v2-r1.mjs`，真实响应在`live-routing-v2-r1-result.json`，最终协议更正审计为`live-routing-v2-audit-v2.json`。不要重新运行覆盖这些文件。第一次`replay-live-v2.mjs`在旧浏览器断开时失败，未进入查询，原中断另存。

源码最终测试为attempt3，`source-v2-tests-final.json`及`source-v2-test-attempt3-boundary.json`固定实际文件；v3评测后来新增的4例已纳入。attempt1哈希冲突、attempt2通过及所有日志保留。中间扩展草稿不再是评测真源；当前冻结分别保存v1-v4完整字节，不改旧例制造通过。

只读现场核对：

```bash
ps -p 8135,8145,10989 -o pid,lstart,comm
lsof -nP -iTCP:8994 -iTCP:8092 -sTCP:LISTEN
```

共享8091/8993另有任务管理，状态可能继续变化，本轮不操作它们。独立8092以原构建核验规程；不要给新引擎登记兼容构建，除非另有真实参考回放与证据。

## 5. 已定位失败与后续方向

- XZ局部第二坐标在原引擎对应世界−Z、法向+Y；轴承座原参考筋向下得到3个shell。r2改局部负坐标后标准/迁移通过，原失败保留。
- 人字齿原参考先根圆芯再Join同根圆完整扫掠出现重合面布尔失败。正确参考先下半完整齿廓new，再镜像合并；带槽者镜像前连接半槽芯。原失败、缺采样v1/v2、原样重载补证及v3审计分别保存。
- 正式螺栓A初始9/10是参数命名映射误判；核对原生注释/表达式后另存v2 10/10，未改几何或容差。B仅在终态后Escape取消未提交预览恢复采集，身份一致，没有补头或重发。
- 无槽A无实体；无槽B经验样条偏离渐开线，体积误差约8.31%、最大侧误差0.677 mm。带槽A半齿角错误用180°/z，且twist误用β20°而非约6.5321°。带槽B取得0.1.0但齿侧符号展开错误，最终无实体。三份failure-diagnosis及原模型完整保留。
- 板/壳/无槽的真实未送达通过局部路由修复处理；正向转折、独立目标、数值矛盾和错误facts仍拒绝。齿轮副名称只在显式当前部件与同一限定名重叠时合并，不吞并其他目标。

下一步应先审阅正式失败与0.1.1命令澄清，再决定新的独立验证是否必要。本轮任务已完成到“知识/参考/路由发布、五类正式产物及其改参验证”的层次；两种人字齿的0.1.1模型效果和正式通过产物改参仍缺证据。**不自动重发已执行题目、不用补测覆盖失败、不自动approved。** 若用户另授权新模型验证，必须另建独立版本/cohort、冻结环境并与原v1分开。

测量语义保持：`model.edges.mid/length`为显示折线拾取信息；`inspect.curvature_comb`的`combs[].teeth[][0]`才是实际有限求值脚点。面度量、smlib积分体积/重心和tight bounds按各自接口解释。有限采样不证明全域、共轭接触、制造或承载。

## 6. 历史齿轮不重做

旧9类单体＋4类机构，v2主对照及v3/v4/v5独立补测均已归档。蜗轮正文0.1.2保留1.5m毛坯余量，不回退旧文。旧worker已停止，不重发。后续B-only不与旧A拼新对照。

- [13类历史覆盖与缺口](../reports/gear-family-expansion-20261112/CURRENT-COVERAGE.md)
- [旧总报告](../reports/gear-family-expansion-20261112/README.md)、[v2主对照](../reports/gear-family-expansion-20261112/FORMAL-AB-V2.md)
- [v3](../reports/gear-family-expansion-20261112/FOLLOWUP-V3.md)、[v4](../reports/gear-family-expansion-20261112/FOLLOWUP-V4.md)、[v5蜗轮14/14](../reports/gear-family-expansion-20261112/FOLLOWUP-V5.md)
- [旧收尾快照](../reports/gear-expansion-closeout-v5-20261112.json)
