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>
60 lines
3.9 KiB
Markdown
60 lines
3.9 KiB
Markdown
# DW31：完整主应用候选、操作手册与交付
|
||
|
||
- stage: `integration-remainder`
|
||
- queueTask: `WBV2-P1424-001`；parent: `WBV2-P1424-000`；nextTask: `null`
|
||
- 包状态：`planned_gap_closure`（并不表示已有源码尚未实现）
|
||
- 完整交付依赖：DW29, DW30
|
||
- 工作量级：L；不表示日期承诺
|
||
- validation: `NOT_RUN`；acceptance: `NOT_CLAIMED`
|
||
|
||
## 优先复用的十多天成果
|
||
|
||
保留所有已有本地候选、已发布资源和构件记录；优先以 cycle 157 及后续已交接增量为基础。
|
||
|
||
相关交接仅作按需引用：
|
||
|
||
- `tests/golden/WBV2-P1424-001/unattended-implementation/cycle-000157/result.json`
|
||
|
||
先对照当前小范围源码和最新交接保留已实现子项；只有缺功能、缺接线或缺必要依赖才新增实现。历史状态不自动当作当前缺口。
|
||
|
||
## 操作者工作流与交付
|
||
|
||
一个明确主入口 → 匹配的界面/原生引擎/资源 → 完整操作工作流 → 用户交付
|
||
|
||
可由操作者实际使用的完整主应用候选与使用说明、源版本/构件对应关系；验证仍未声明通过。
|
||
|
||
## 最小生产入口
|
||
|
||
- `web/app/src/main.tsx`
|
||
- `web/app/src/app/App.tsx`
|
||
- `web/app/src/workers/web-engine.worker.ts`
|
||
- `blender-5.2.0/source/blender/web_engine/CMakeLists.txt`
|
||
- `tests/golden/WBV2-P1424-001/desktop-delivery-manifest.json`
|
||
- `tests/golden/WBV2-P1424-001/desktop-completion-manifest.json`
|
||
|
||
以上为聚焦入口，非要求全文加载。使用源码聚焦工具、精确 --source/--unit 和函数片段；接入新 operator 时追加其具体原生文件，单次最多 8 个精确源码文件。没有默认测试入口或要运行的 fixture；功能完成前不执行任何验证。
|
||
|
||
## 只补未完成部分
|
||
|
||
1. 各包已持续维护生产接线和必要候选；本包收敛为一套匹配 frontend/Worker/protocol/WebEngine/Python/Naga/OCCT/startup/fonts/media 资源的应用交付。
|
||
2. 以实际 source/package/interface 版本决定复用或必要增量重编译，构件生成时记录 SHA-256 和来源；保留旧版本，避免重复全量 build。
|
||
3. 主入口、loader URL、cross-origin isolation、Worker/WASM MIME 与本地离线资源包形成实际配置，不仅交付 build/bin 内一个 WASM。
|
||
4. 操作手册按工程/建模/材质渲染/动画/模拟/媒体/脚本任务编排，写清保存、资源管理、取消/恢复与平台等价行为，不把内部技术细节塞给用户。
|
||
5. 每一功能族的实现剩余、占位、无 producer/consumer、必要辅助服务依赖均完成处理后，才记录 implementation_complete_unverified。
|
||
6. 交付记录接受条件为所有实际功能实现已闭合，非“31 张卡都写报告”；build/package 成功不能自动认定实现完成或验证通过。
|
||
7. 用户使用阶段由 USER01 承接；只生成本地候选，不在计划阶段部署或发布。
|
||
|
||
compute 专项引用：`CS13`。卡位于 `docs/tasks/WBV2-P1424-001-compute-ssbo/`；一次只读当前一张，既有实现不重复，状态依据后续真实交接更新。CS09 在 DW19 负责消费者，CS12 在 DW26 负责原生 Python 入口，CS13/CS14 分别归 DW31/USER01；不要另起平行路线。
|
||
|
||
## 失败边界
|
||
|
||
任一未解决的功能缺口仍保持 in_progress；不能用“稍后测试会发现”掩盖已知未实现项。
|
||
|
||
## 实现交接与后续使用
|
||
|
||
交付前必须具有实际入口→原生执行→消费者/结果→错误/取消→适用 history/save 的生产代码。这里是实现交付条件，不运行验收；编译成功不能替代功能。旧的已完成子项可引用并保留，不能声称本轮重新实现。
|
||
|
||
用户使用阶段的场景（现在不执行）：用户按同一手册从启动到保存与交付输出完成全部业务，无需手动拼装多个候选。
|
||
|
||
每次记录保留成果、补齐断点、仍有缺口、必要构件与下一动作。共同规则见同目录 `EXECUTION.md`，首次领取时阅读；不要将完整计划作为后续执行上下文。
|