f3e21c6b98
Accumulated uncommitted work: GHOST Web backend, WebGL/GPU web layer, web workflow engine and protocol, tooling, docs and task records. Large generated evidence, user-testing archives, build snapshots and imported test assets remain untracked. Co-Authored-By: Claude Code <noreply@anthropic.com>
54 lines
3.1 KiB
Markdown
54 lines
3.1 KiB
Markdown
# DW10：雕刻、画笔与多分辨率编辑
|
||
|
||
- stage: `modeling-assets`
|
||
- queueTask: `WBV2-P1424-001`；parent: `WBV2-P1424-000`；nextTask: `null`
|
||
- 包状态：`planned_gap_closure`（并不表示已有源码尚未实现）
|
||
- 完整交付依赖：DW07, DW09
|
||
- 工作量级：XL；不表示日期承诺
|
||
- validation: `NOT_RUN`；acceptance: `NOT_CLAIMED`
|
||
|
||
## 优先复用的十多天成果
|
||
|
||
已有 SCULPT/SCULPT-ADVANCED-AUTHORING 与 paint/sculpt 协议。
|
||
|
||
既有任务：`WEBUI-SCULPT`（记录为 implemented）、`SCULPT-ADVANCED-AUTHORING`（记录为 implemented）。按需读取一个任务结果的 summary/remaining/ownedPaths，不打开完整产品报告。
|
||
|
||
先对照当前小范围源码和最新交接保留已实现子项；只有缺功能、缺接线或缺必要依赖才新增实现。历史状态不自动当作当前缺口。
|
||
|
||
## 操作者工作流与交付
|
||
|
||
进入雕刻模式 → 选择画笔/遮罩 → 连续笔划 → native 数据更新 → 历史/保存
|
||
|
||
操作者能完成真实雕刻和遮罩工作流，而不只是调整画笔参数。
|
||
|
||
## 最小生产入口
|
||
|
||
- `web/protocol/sculpt.ts`
|
||
- `web/protocol/paint.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. 从现有 brush/operator 家族补齐 stroke 生命周期、平滑插值、压力、半径/强度、对称、笔刷纹理与工具设置。
|
||
2. 遮罩、面组、隐藏、裁剪、姿态/抓取等工具按源码语义接入；雕刻拓扑变化仍统一到既有几何出口。
|
||
3. 多分辨率、重网格/动态拓扑涉及的底层能力逐项落实在 OCCT 绑定/适配，不能重造并行算法或静默换语义。
|
||
4. 复用原生空间查询/数据所有权并落实绘制资源更新，Three 层不进行笔划变形。
|
||
5. 同一笔划形成正确 history 单位，处理中断、取消、模式切换及保存中的资源一致性。
|
||
|
||
## 失败边界
|
||
|
||
不把前端变形或笔划预览当原生几何修改；尚未具备的动态拓扑语义必须明确列出。
|
||
|
||
## 实现交接与后续使用
|
||
|
||
交付前必须具有实际入口→原生执行→消费者/结果→错误/取消→适用 history/save 的生产代码。这里是实现交付条件，不运行验收；编译成功不能替代功能。旧的已完成子项可引用并保留，不能声称本轮重新实现。
|
||
|
||
用户使用阶段的场景（现在不执行）：连续雕刻并使用遮罩和对称，取消一笔、撤销另一笔，保存后继续编辑。
|
||
|
||
每次记录保留成果、补齐断点、仍有缺口、必要构件与下一动作。共同规则见同目录 `EXECUTION.md`，首次领取时阅读；不要将完整计划作为后续执行上下文。
|