workinf_Blender_Wasm/AGENTS.md

执行上下文规则

本仓库的任务执行必须使用最小上下文。不要把完整路线图、项目状态、parity ledger 或全部 docs/status/ 日志作为默认上下文。

领取任务时只做以下操作：

1. 阅读 docs/EXECUTION_QUEUE.md。
2. 运行 node tools/web/print-task-context.mjs；它只会输出当前任务、parent manifest、parent status 和聚焦命令。
3. 只打开输出中列出的任务卡、生产入口、测试入口和最小 fixture。
4. 全部功能实现前不运行上下文检查或其他验证命令。直接依据当前任务卡与 parent nextTask 工作，不要手工推进队列。

默认上下文预算：队列 4 KiB、任务卡 8 KiB、parent manifest 24 KiB、parent status 6 KiB，合计约 3,500 tokens。历史和长期文档只能按任务卡列出的具体小节追加读取。

实现阶段只记录任务报告、manifest、status 和聚焦实现变更，不运行验证命令。下一任务只认新 manifest 的 nextTask。

移植铁律

• 为了正常推进移植项目工作，用户已授权执行代理在无人值守流程中自主完成必要工作，包括自行修改 Blender 源码、Web/WASM 适配层、协议、Worker、前端入口、构建脚本和任务交接产物；无需为常规实现动作重复请求确认。所有修改仍须遵守本文件其余铁律，并如实记录未验证状态。

• 功能先打通，只有全部功能实现完成后，用户才在使用时验证。全部功能完成是主要工作，中途不进行任何形式的验证，包括测试、回归、冒烟、浏览器验收、类型检查、独立语法检查、上下文检查和证据审计。优先复用本机源码和产物，集中实现真实业务入口；仅为生成所需产物进行增量编译，不把编译成功当作功能完成或验收通过。未验证功能如实记录，不得伪造通过结果。

• 遇到阻塞项，必须优先利用用户提供的 Blender 源码及本地资料定位并修复；不得仅因缺少执行契约、适配层或验收证据就停止推进或反复空转。暂未解决时记录具体失败业务、源码依据和下一步修复动作，保留已有产物并继续独立实现任务。全部功能实现完成后，才进入用户使用验证阶段。

• OCCT WASM 已提供，几何算法必须统一到这一内核出口；优先复用已有 OCCT WASM 产物、绑定和适配接口，不另造或并行维护同类几何算法实现。

• Three.js 只负责显示，消费几何内核输出；不得承担几何算法、拓扑计算或几何布尔运算。

• 优先复用本机现有源码、WASM、模块和有效证据，不重复造轮子。先核对产物版本、接口与哈希；仅在产物缺失、失效或必要修改时增量构建受影响模块。

• 坚持以功能模块业务和功能路由带动桌面 Blender 到 Web Blender 的移植，按“模块 -> 用户工作流 -> 功能路由 -> 源码/operator case”落实实现与验收。

• 遇到问题先检索用户提供的 blender-5.2.0 对应源码，再查当前模块相关资料；源码行为优先于路由分类、前端近似实现或外部资料。

• 源码检索使用聚焦工具，可通过 --unit <source-unit-id> 限定当前源码单元；禁止默认加载完整源码 inventory 或历史计划。

• 计时、索引、构建和验证是执行保障，不能代替业务功能完成；报告必须说明工作流、具体功能路由及源码依据。