Advance M8-M11 parity workflows
Some checks failed
M6 deployable RC / quick (push) Has been cancelled
M6 deployable RC / chromium (push) Has been cancelled
M6 deployable RC / release (push) Has been cancelled

This commit is contained in:
mes123456
2026-08-17 04:37:07 -04:00
parent 7c16b279ae
commit 0fe8d2bb56
324 changed files with 31920 additions and 863 deletions

View File

@@ -1,7 +1,9 @@
# N-017 Paint 与权重
状态:`BLOCKED`stroke/patch schema、真实 Three raycast 命中、选择/遮罩门和 Main 顶点色/权重
transaction 已落地PBVH brush、texture paint 和 GPU/image 生命周期未实现)
状态:`BLOCKED`stroke/patch schema、真实 Three raycast 命中、GPU depth 可见性、选择/遮罩门、
单 undo 分块 pointer session、Main 顶点色/权重、浏览器 packed/UDIM 原子资产绑定和
PBVH WASM 入口显式能力门已落地;
PBVH brush、Blender Main image tile 写回、完整色彩转换和 GPU/image 生命周期仍未实现)
## 已验证切片
@@ -12,9 +14,11 @@ transaction 已落地PBVH brush、texture paint 和 GPU/image 生命周期未
tile 256 MiB非法 barycentric、pressure、color、weight 和非有限数会结构化拒绝。
4. N-017-B部分`setVertexColors` 在单用户 Mesh 上创建/转换 `POINT``CORNER`
`FLOAT_COLOR` 属性,并更新 active color`setVertexWeights` 在真实 Object/Mesh 上创建顶点组、
写入/移除 `MDeformWeight`,支持逐顶点 normalize
5. 顶点色和权重都已通过 Main undo/redo 与 `.blend` save/reopen`mirror:true` 在没有已验证
对称拓扑映射时返回 `CAPABILITY_MISSING`,不会伪造镜像结果。
写入/移除 `MDeformWeight`,支持逐顶点 normalize、最多 32 个 influence 的 limit以及
基于局部坐标 reciprocal map 的 mirror。
5. 顶点色和权重都已通过 Main undo/redo 与 `.blend` save/reopen镜像在没有已验证对称映射时
返回 `CAPABILITY_MISSING`不会伪造结果。limit/normalize/mirror 的组合已与 Blender 5.2
desktop golden 逐顶点比较。
6. `paintHitFromIntersection` 消费真实 Three `Raycaster` intersection按 indexed/non-indexed
triangle 解析顶点,输出对象/data stable ID、source face、局部 barycentric、世界法线、
插值 UV 与 pressure测试使用真实 BufferGeometry 射线,不注入伪命中。
@@ -24,7 +28,7 @@ transaction 已落地PBVH brush、texture paint 和 GPU/image 生命周期未
8. N-017-A/C协议边界有界 CPU brush 对候选顶点执行 smoothstep falloff、遮挡标记过滤和
front-face 法线门;它不宣称 PBVH 加速或桌面 brush 等价。`UdimTilePatchIR` 约束 1001-1999
tile、RGBA8、色彩空间、尺寸/256 MiB 预算、revision、base/result SHA-256并在内存中验证
原子 range patch;尚未绑定 Blender packed image/UDIM Main 写回与保存
原子 range patch。
9. N-017-A空间查询部分uniform-grid spatial index 在 1M vertex/1M cell 预算内按 brush AABB
粗筛候选再执行球半径、front-face、falloff 精筛depth-gated 查询必须显式提供已验证可见
vertex ID 集合,缺失或重复会拒绝。该结构减少全量扫描,但不是 Blender PBVH。
@@ -34,14 +38,35 @@ transaction 已落地PBVH brush、texture paint 和 GPU/image 生命周期未
11. Properties paint 面板可对当前真实 VERT selection 执行 selection-masked `Blend Color`
`Blend Weight`,每次仅提交一个 Main transaction。Blender 5.2 reader 从 Mesh
`vertex_group_names` 恢复顶点组摘要及 skin weight 名称;新增组经 undo/redo、保存重开后保持。
12. M9-09主线程和 Offscreen Worker 使用同一 WebGL2 RGBA depth pass/readback
以 Main revision 和稳定顶点索引返回真实可见集;遮挡 fixture 的两后端结果一致。
13. M9-10WebEngine Worker 可序列化接收有界 color/weight chunks一次 pointer
session 仅在 commit 时对 Main 发一个合并命令;真实 Main 历史只产生一个 undo step。
14. M9-11Storage Worker 将 packed/UDIM PNG 解码为 RGBA8复验 dirty range 的
base/result pixel hash新 PNG 经 OPFS content-addressed 临时写、回读验证后,
才以 IndexedDB 单事务切换 tile binding。中途故障保持旧 binding/旧资产可读,
packed 与 UDIM 均已通过 Worker restart 回读。
15. M9-12`WeightPaintOptionsIR` 固定 normalize、limit、mirror axis/tolerance 和 1M
patch budgetWorker 拒绝重复/越界/非法组合native 在 Main 内先写入 patch再做
mirror、limit、normalize。镜像 map 使用 mesh 局部坐标,要求每个顶点都有 reciprocal
counterpart且大于 100k 顶点时结构化预算阻断。`rigged_shape_scene.blend` 的四步
goldeninitial/normalize/limit-normalize/mirror与 WASM snapshot、save/reopen 逐项一致。
16. M9-13按 Blender 5.2 `DNA_brush_enums.h` 冻结 32 个 Sculpt、4 个 Vertex Color、
4 个 Weight 和 6 个 Texture 活跃 brush。生产 WebEngine Worker 探测
`_web_engine_apply_pbvh_stroke`;当前 stable/single/pthread 均无该 WASM 入口,因此 46 项
全部返回 `N-017/BLOCKED/PAINT_PBVH_UNAVAILABLE`。即使未来出现入口session context 和
逐 brush desktop/WASM golden 未就绪时仍分别失败关闭;查询不会修改 Main revision、handle
或 WASM allocated bytes畸形字段返回完整标准 `ErrorReport`
## 仍然阻断
- N-017-A真实 PBVH、由 viewport 深度缓冲生成可见 vertex 集合,以及 brush falloff 桌面
golden基础 Mesh/UV hit、uniform-grid 候选查询可见性硬门已完成。
- N-017-Blimit/clean、已验证拓扑映射上的 mirror、桌面 brush/falloff 对照
- N-017-CBlender packed/UDIM tile Main transaction、dirty tile、色彩转换和原子保存当前
只有内容哈希绑定的浏览器内存 patch 边界
- N-017-A真实 PBVH 与 brush falloff 桌面 golden基础 Mesh/UV hit、uniform-grid 候选
查询可见性硬门和双后端 GPU depth 可见集已完成。当前不存在 PBVH WASM writer完整
brush inventory 由 `PAINT_PBVH_UNAVAILABLE` 明确阻断,不会把 bounded helper 当作成功
- N-017-Bclean/高级 Blender weight-paint operator、真实 PBVH brush/falloff 与更大拓扑的
桌面对照;当前 bounded limit/normalize/verified mirror 已完成
- N-017-CBlender packed/UDIM tile Main transaction、完整色彩转换和 `.blend` 内 image
tile 保存仍阻断;浏览器 dirty tile 的 OPFS 原子 asset/binding 边界已完成。
- N-017-D/Earmature golden、seam bleed、face mask、GPU dispose、quota、坏图和桌面 UI 对照;
vertex selection 与数值 mask 门已完成,不等同于完整 Paint 面/纹理遮罩系统。
@@ -50,7 +75,9 @@ transaction 已落地PBVH brush、texture paint 和 GPU/image 生命周期未
```bash
WEB_TEST_PORT=5203 npm --prefix web run test:e2e -- --grep "N-017 paint"
npm --prefix web run test:paint-roundtrip
WEB_TEST_PORT=5422 npm --prefix web run test:texture-paint-asset
WEB_TEST_PORT=5427 npm --prefix web run test:paint-pbvh-capability
```
`test:paint-roundtrip` 覆盖 CORNER color、vertex group patch、normalize、mirror 错误门、
undo/redo 与 save/reopen。
`test:paint-roundtrip` 覆盖 CORNER color、vertex group patch、normalize、limit、verified
mirror、undo/redo 与 save/reopen`test:weight-paint-golden` 对比 Blender 5.2 desktop golden