d1e6b63d54
- update native web_engine sources and rebuilt wasm artifacts - add task cards, status notes and tooling scripts - add web e2e specs, tutorial UI sources and tutorial assets - sync golden task manifests and audit records Co-Authored-By: Claude Code <noreply@anthropic.com>
56 lines
4.0 KiB
Markdown
56 lines
4.0 KiB
Markdown
# Web Blender 短周期执行入口
|
||
|
||
更新时间：2026-08-22（America/New_York）
|
||
|
||
本页仅存当前任务指针，以功能模块生产。领取只读本页、当前任务及parent manifest/status；规则见 [`CONTEXT_BUDGET.md`](CONTEXT_BUDGET.md)。
|
||
|
||
按能力工作流实现，legacy `M16-GAP-*`仅作覆盖回归；矩阵/runner见 [`BLENDER_WEB_EXECUTION_CONTROL_PLANE.md`](BLENDER_WEB_EXECUTION_CONTROL_PLANE.md)。
|
||
|
||
当前阶段以全部功能实现为主；中途不执行验证。全部功能完成后由用户使用验证，编译成功不等于功能完成。此规则优先于历史文档中的中间验收要求。
|
||
|
||
无人值守：复用 `wbv2-implementation.service --max-iterations 0`，交接后自动补缺；不暂停健康服务、不重复启动，保留退避、故障恢复和单写入。全部实现后用户验证。
|
||
|
||
跨会话入口：`node tools/web/run-wbv2-scheduler.mjs --max-iterations 0 --commit --push`；源码映射、队列交接及远端提交安全才续nextTask。实现期复用现有服务，不并启。
|
||
|
||
## 当前指针
|
||
|
||
| 字段 | 值 |
|
||
| --- | --- |
|
||
| 里程碑 | 三域全量对标（创建模型 / 模型化 / 模型层级） |
|
||
| 当前任务 | `WBV2-P1425-001` |
|
||
| parent manifest | `tests/golden/WBV2-P1425-000/manifest.json` |
|
||
| 任务卡 | [`tasks/WBV2-P1425-001.md`](tasks/WBV2-P1425-001.md) |
|
||
| 专项验收 | `node tools/web/check-execution-control-plane.mjs` |
|
||
| legacy coverage checkpoint | `M16-GAP-00282` |
|
||
| legacy coverage parent | `tests/golden/M16-GAP-00281/manifest.json` |
|
||
|
||
领取时读取当前任务：
|
||
|
||
```bash
|
||
node tools/web/print-task-context.mjs
|
||
```
|
||
|
||
如果任务卡缺失，运行 `node tools/web/generate-task-card.mjs --task <task-id>`；如果索引过期，运行 `node tools/web/generate-task-index.mjs` 后再生成任务卡；不要打开或复制完整 `next-task-plan.json`。
|
||
|
||
## 铁律
|
||
|
||
- 单次读源码≤30行、改≤2文件且增删合计≤10行（含交接）；输出仅短摘要和关键片段。每批写 `continuationNotes`，下批续断点，不全库重搜。
|
||
- 移植过程的功能不得使用 JS 模拟；功能实现必须调用 Blender 5.2 源码编译出的原生 WebEngine/WASM 路径，并由 Chromium 生产证据验证。
|
||
- 浏览器执行、CI、验收证据和发布声明永久仅限 Chromium；禁止领取 Firefox/WebKit 任务。
|
||
- 当前任务必须等于 parent manifest 的 `nextTask`；不得从 Markdown 历史编号手工推导。
|
||
- 一个模块任务覆盖一个连贯功能边界，可包含多个共享命令和 operator case；必须完成 source/协议/Worker/前端接线，以及模块契约规定的正例 Main mutation 或精确 Main reader/context 证据、负例 no-mutation、undo/redo、save/reopen、Chromium 和聚合 manifest。
|
||
- generic continuation、QUEUE_ENABLEMENT、索引生成和单纯 build 只能作为模块前置或证据，不得单独计入移植完成。
|
||
- 模块完成必须有真实命令、退出码、构件 SHA-256、正负例和恢复证据、聚合 manifest 和 status；协议、fixture 或测试文件存在不等于完成。
|
||
- 每完成一个段落或模块，报告必须明确列出源码动态 inventory 的 unitCount、verifiedUnits、unverifiedUnits、sourceTreeSha256，以及本段绑定的 unit 增量；历史 `6900-entry` 只读保留，未绑定源码单元不得计为覆盖进度。
|
||
- 失败、环境缺失或 hash 漂移保持 `in_progress`/`blocked`，不得推进指针。
|
||
|
||
源码检索强制使用 `node tools/web/search-wbv2-batch-source.mjs --pattern <text>`（可重复 `--runtime`）；禁止全量 `rg`/`sed`，完整 inventory 仅显式 `--full-inventory` 审计。
|
||
|
||
## 交接
|
||
|
||
实现阶段不运行上下文、类型、语法、测试或证据验证命令。
|
||
|
||
完成后只写入 `tests/golden/<task>/task-context.json`、任务报告、manifest 和 `docs/status/<task>.md`。下一任务只读新 manifest 的 `nextTask`；长日志留在构件目录。
|
||
|
||
保留原任务与 parent 指针，不得手工推进 `nextTask`；全部功能实现前只记录实现进度，不生成验收通过声明。
|