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>
56 lines
3.6 KiB
Markdown
56 lines
3.6 KiB
Markdown
# DW18：最终渲染、Cycles 与多通道输出
|
||
|
||
- stage: `nodes-render`
|
||
- queueTask: `WBV2-P1424-001`；parent: `WBV2-P1424-000`；nextTask: `null`
|
||
- 包状态：`planned_gap_closure`（并不表示已有源码尚未实现）
|
||
- 完整交付依赖：DW13, DW17
|
||
- 工作量级：XL；不表示日期承诺
|
||
- validation: `NOT_RUN`；acceptance: `NOT_CLAIMED`
|
||
|
||
## 优先复用的十多天成果
|
||
|
||
已有 native render routing、render job/panel、后台原生能力和本地源码/产物，优先迁移已有真实入口。
|
||
|
||
既有任务：`SERVER-OPERATOR-JOB`（记录为 implemented）、`SERVER-OPERATOR-HTTP-PROVIDER`（记录为 implemented）、`RENDER-CAMERA-LIGHT-COVERAGE`（记录为 implemented）。按需读取一个任务结果的 summary/remaining/ownedPaths，不打开完整产品报告。
|
||
|
||
先对照当前小范围源码和最新交接保留已实现子项；只有缺功能、缺接线或缺必要依赖才新增实现。历史状态不自动当作当前缺口。
|
||
|
||
## 操作者工作流与交付
|
||
|
||
设置渲染引擎/参数 → 单帧或动画渲染 → 结果/通道查看 → 保存图像序列
|
||
|
||
真实最终渲染和持久化输出，明确每个引擎/设备/通道的实现状态与资源成本。
|
||
|
||
## 最小生产入口
|
||
|
||
- `web/protocol/render-routing.ts`
|
||
- `web/protocol/render-capabilities.ts`
|
||
- `web/protocol/animation-render-commands.ts`
|
||
- `blender-5.2.0/source/blender/editors/render/render_internal.cc`
|
||
- `blender-5.2.0/source/blender/web_engine/web_engine_api.cpp`
|
||
- `web/app/src/workers/web-engine.worker.ts`
|
||
- `web/app/src/app/NativeWorkflowPanels.tsx`
|
||
|
||
以上为聚焦入口，非要求全文加载。使用源码聚焦工具、精确 --source/--unit 和函数片段；接入新 operator 时追加其具体原生文件，单次最多 8 个精确源码文件。没有默认测试入口或要运行的 fixture；功能完成前不执行任何验证。
|
||
|
||
## 只补未完成部分
|
||
|
||
1. 定位本地渲染模块和原生引擎注册依赖，保留已可用后台功能，同时实现所需 browser-native 模块及线程/内存/任务入口。
|
||
2. Workbench/EEVEE 最终输出复用 DW17；Cycles 按真实 kernel/设备接口移植，已有原生 CPU 渲染可作为明确的原生执行路径，禁止 JS 模拟。
|
||
3. 完整接通采样、降噪、bake、render region、view layers、passes/AOV、合成和输出格式的源码语义；依赖能力逐项记录。
|
||
4. 实现长任务进度、取消、分帧/分块结果、相机切换、帧范围和输出命名，任务失败不覆盖已有完成结果。
|
||
5. 处理外部资源、色彩管理、多层图像和动画结果保存，使用 DW06/DW13 实际文件服务；编码器依赖交 DW24 共用。
|
||
6. 需要原生桌面特定设备的后端保留平台差异及等价执行方案；仅保留 server job 不构成 browser-native 完成。
|
||
|
||
## 失败边界
|
||
|
||
不能将已有服务端渲染成功记为浏览器 Cycles 完成；没有真实 kernel 的图像或占位进度均不算交付。
|
||
|
||
## 实现交接与后续使用
|
||
|
||
交付前必须具有实际入口→原生执行→消费者/结果→错误/取消→适用 history/save 的生产代码。这里是实现交付条件，不运行验收；编译成功不能替代功能。旧的已完成子项可引用并保留，不能声称本轮重新实现。
|
||
|
||
用户使用阶段的场景（现在不执行）：完成带材质灯光的多通道单帧，取消一次动画渲染，再按指定帧范围输出并保存。
|
||
|
||
每次记录保留成果、补齐断点、仍有缺口、必要构件与下一动作。共同规则见同目录 `EXECUTION.md`，首次领取时阅读；不要将完整计划作为后续执行上下文。
|