# DW07：网格建模与 OCCT 几何出口

- stage: `modeling-assets`
- queueTask: `WBV2-P1424-001`；parent: `WBV2-P1424-000`；nextTask: `null`
- 包状态：`planned_gap_closure`（并不表示已有源码尚未实现）
- 完整交付依赖：DW05, DW06
- 工作量级：XL；不表示日期承诺
- validation: `NOT_RUN`；acceptance: `NOT_CLAIMED`

## 优先复用的十多天成果

MESH/MESH-EXTENDED-AUTHORING/MESH-EDITOR-COVERAGE 已有命令与 UI，复用本机 OCCT WASM/绑定。

既有任务：`MESH-EXTENDED-AUTHORING`（记录为 implemented）、`MESH-EDITOR-COVERAGE`（记录为 implemented）。按需读取一个任务结果的 summary/remaining/ownedPaths，不打开完整产品报告。

先对照当前小范围源码和最新交接保留已实现子项；只有缺功能、缺接线或缺必要依赖才新增实现。历史状态不自动当作当前缺口。

## 操作者工作流与交付

添加网格 → 点边面编辑 → 原生 operator/OCCT → 属性与拓扑回写 → 保存

网格建模工具族的完整原生业务路由与 OCCT 适配说明，真实编辑结果可保存和继续加工。

## 最小生产入口

- `web/protocol/mesh-authoring-commands.ts`
- `web/protocol/web-engine.ts`
- `blender-5.2.0/source/blender/web_engine/web_engine_main_state.cpp`
- `blender-5.2.0/source/blender/web_engine/web_engine_api.cpp`
- `web/app/src/workers/web-engine.worker.ts`
- `web/app/src/app/App.tsx`

以上为聚焦入口，非要求全文加载。使用源码聚焦工具、精确 --source/--unit 和函数片段；接入新 operator 时追加其具体原生文件，单次最多 8 个精确源码文件。没有默认测试入口或要运行的 fixture；功能完成前不执行任何验证。

## 只补未完成部分

1. 从当前网格家族的已实现命令开始，绑定源 operator 和现有 OCCT adapter，定位缺口而非重新实现整套网格内核。
2. 按连贯工具组补齐 primitive、extrude/inset/bevel/loop-cut/subdivide、merge/split/separate、bridge/fill、dissolve/delete。
3. 补齐布尔、切割、对称、法线、平滑/锐边、材质索引、属性层、选择映射和拓扑版本。
4. 统一 Blender 数据结构与 OCCT 的单位/坐标/容差/拓扑身份、返回属性与撤销；不得让 Three.js 或 JS 算法承担几何运算。
5. OCCT 不具备现有语义时在该统一出口扩展必要绑定/适配并保留具体阻塞，不能另造平行几何内核。
6. 原生 operator 参数、repeat/redo、modal 取消和 UI 更新覆盖每个工具组；历史已实现命令保留。

## 失败边界

路由存在不等于 operator case 完整；失败必须保留原拓扑和属性。

## 实现交接与后续使用

交付前必须具有实际入口→原生执行→消费者/结果→错误/取消→适用 history/save 的生产代码。这里是实现交付条件，不运行验收；编译成功不能替代功能。旧的已完成子项可引用并保留，不能声称本轮重新实现。

用户使用阶段的场景（现在不执行）：创建机械零件，挤出倒角与布尔切割后编辑边面，保存重开继续加工。

每次记录保留成果、补齐断点、仍有缺口、必要构件与下一动作。共同规则见同目录 `EXECUTION.md`，首次领取时阅读；不要将完整计划作为后续执行上下文。