3.2 KiB
主工作区 Part 实体业务
2026-09-09。本轮交付的是默认页面可操作的业务，不是新增调度统计或固定样例回执。OCCT、FreeCAD WASM、Three.js、React、OPFS 路线不变。
实际能力
- 当前文档中创建圆柱、圆锥、球和圆环；原对象修改半径、高度和角度后重算，不重复创建对象。
- 原生特征直接使用已有 Part::Cylinder/Cone/Sphere/Torus，由 FreeCAD/OCCT 产生形状、体积和网格；JS 不计算权威 CAD 几何。
- 原生和 Facade 均检查参数范围；错误输入不改变原对象。实际返回的类型、参数和文档身份必须与请求一致。
- 原生 FCStd 保留特征类型、参数和体积；主页面通过 OPFS 保存，重载后仍能编辑恢复的参数，支持对象移除。
- 使用已有 Three.js 场景显示 native 网格。Playwright 在 1440x1000、390x844 检查实际截图像素及旋转视角后的帧变化，无横向溢出。
复用和构建
复用 PrimitiveFeature.cpp、现成 Part/OCCT 库、DocumentProbe 文档会话、Part 保存 Worker、项目状态与 Three.js 显示桥。不新增几何内核，不重编译 OCCT，不建立每个形状一个 WASM。原生适配仅增加 part.document/setPrimitive 和参数快照，沿用原有事务、重算、错误与保存链。
同一 Part 模块存在 PartBoxProbe 与 DocumentProbe 两种实际所有者。新增用例合同 buildOverrides 将四项业务指向 DocumentProbe，规划器按原生目标分组，防止用错误目标反复构建。有效证据同时检查 manifest 对应的原生源文件，不因 DocumentProbe 不以 Part 命名而漏记依赖。
验证
| 检查 | 结果 |
|---|---|
| 四项原生及默认页面业务 | 4/4，通过；开发版首次完整回合 18.502 秒 |
| Part 新旧业务组合 | 15/15，通过；30.253 秒 |
| 发布版四项业务 | 4/4，通过；20.079 秒 |
| 发布版工作区回归 | 10/10，通过；16.522 秒 |
| TypeScript 项目检查 | 通过 |
| 参数、路由、几何边界 Node 回归 | 14 项通过 |
| 业务复用、规划、上下文等 Python 回归 | 94 项通过，18.745 秒 |
| 发布构建 | 8.20 秒，其中公共产物增量同步 6.849 秒 |
证据在 docs/current/business-evidence/：
- Part 15 项：
52be7ce72cada00371451daf-20260909T021532520100.json。 - 发布版四项：
bcc8ff9f019467b877cc488c-20260909T021946822941.json。 - Web 十项：
815a9219e10b1a8b04f5db32-20260909T021944435759.json。
截图在 docs/current/part-primitives-browser/，按形状与视口保存。测试从实际浏览器截图读取像素，避免直接读取已清空的 WebGL 帧缓冲造成假空白；没有因此改变生产渲染设置。
剩余范围
本轮新增四项完整可操作业务；没有宣称所有 Part 命令、布尔/倒角/圆角、Sketcher/PartDesign 跨工作台或整个项目已完成。10:20 总量快照为 82/1503，后台仍在处理其余模块。总数会受其它模块当前指纹变化影响，不把本轮回归通过数或所有截图数当成新业务数。
本轮后台保持运行，没有暂停 watchdog。继续按 v3 恢复/开发轮转，优先成组打通用户当前文档和已有原生能力；通过证据有效时直接复用，不重做这些实体。