AGC 运行画面点选：canvas 玩法上识别 Phaser 4 / three.js 的已登记素材（#612） #624

Merged

suzmii merged 16 commits from feat/agc-runtime-picking-engines into master 2026-10-05 19:16:03 +08:00

Conversation 7 Commits 16 Files Changed 21

+3931 -532

16 Commits

Author	SHA1	Message	Date
suzmii	df221f4eb9	收口评审 P2：点选条款限定引擎档、对象名上限入边界、素材 id 格式写入 skill ... - 功能说明第 8 条「命中区域裁剪在画布内」限定为引擎档，并说明 DOM 档仍是元素矩形；证据表对应行同步对齐 - 功能说明「边界与非目标」新增一条：引擎档对象名超过 40 字符按取不到处理（有意保留），宿主侧标签上限另为 120 - SKILL.md「运行画面点选契约」第 3 条补一句：素材 id 不含空白与路径分隔符（localAssetId 由客户端生成） - skill-pack 指纹同步（agc-web-game-development version 2026-08-26.42 与 sha256）	2026-10-05 18:31:59 +08:00
suzmii	364b1aa342	Merge remote-tracking branch 'origin/master' into feat/agc-runtime-picking-engines ... - 冲突解决（3 处）： - agc-game-production-workflow/SKILL.md：双方都保留——第 4 条用本分支版本（含「运行画面点选契约」指针），第 5 条用 master 的新构建验证口径 - agc-skills/manifest.json：先取 master 侧，再用 `agc:skill-pack:sync` 按合并后内容重新生成 version 与指纹（2026-08-26.41），`skill-pack:check` 通过 - pitfalls.md：两侧新增条目全部保留（按日期倒序：本分支 10-05 / 10-04 条目在前，master 的 10-04 / 10-03 条目紧随，未改动任一方内容） - 无冲突但人工核对：`agc-web-game-development/SKILL.md`（本分支「运行画面点选契约」小节 + master 内容都在）、 `index.tsx`（我们的 `handleRuntimeInspectSelection` 回调体逐字不变，master 新增内容都在） - 桥脚本 sha256 未变（9513020cfffa79128fb6355d44cdaabe666eefecbd96b7e807b15d2c4601bf76），真机证据对应字节不变	2026-10-05 18:25:49 +08:00
suzmii	985b8f9fa6	去掉长期文档里过期的桥脚本哈希 ... - 功能说明「验收标准与证据」条款 2、3 行：删掉「被测桥脚本 sha256 `6276ac48…917a`」这句（实现产物哈希会随桥改动过期，取证时点与版本由 PR 评论承载），其余行为证据与 Tauri 链路结论原样保留	2026-10-05 17:12:59 +08:00
suzmii	582fabdfbb	补点选不改变预览适配的行为合同与证据 ... - 功能说明「必须成立的行为」新增第 7、8 条：点选不改变预览适配、命中区域裁剪在画布内 - 功能说明「验收标准与证据」补两行：尺寸稳定性用例（5 例）与真实 Chromium 对照值、命中区域裁剪与退化证据 - PRD §3.4「点选素材」条款末尾补一句：点选不得改变预览的内容尺寸与适配缩放，命中区域只取画布内可见部分	2026-10-05 17:11:45 +08:00
suzmii	7ad412f0ec	修运行画面点选后预览自己缩放：高亮框不再参与尺寸上报，命中矩形裁剪到画布 ... - 根因：高亮框（body 下 data-genarrative-preview-inspect，position:fixed）被尺寸上报的 measureContentBounds 遍历计入内容尺寸；three 投影盒超出画布时把内容尺寸撑到 3756×2643（视口 900×560），宿主改 iframe 尺寸触发游戏 resize 重算相机，形成自激振荡 - 桥：measureContentBounds 的 TreeWalker 对 data-genarrative-preview-fit / data-genarrative-preview-inspect 返回 FILTER_REJECT（桥自己的节点不参与内容测量） - 桥：新增 clipInspectRect，引擎档（three 投影盒、Phaser 世界包围盒）命中矩形统一裁剪到画布可见范围；与画布无交集时退化为指针点矩形（不出现 0/负尺寸） - 测试：新增 localPreviewInspectSizeStability.test.ts（5 例：桥节点不参与测量、同尺寸普通节点仍计入的对照组、进入检查模式与 hover 后尺寸与宿主适配布局不变、投影盒超出画布时载荷被裁剪、与画布无交集时退化为 1×1）；runtimeInspectEngines 的字段换算用例改到画布内的等价参数（原矩形落在画布外，裁剪后按新规则退化为指针点矩形） - 文档：pitfalls 记一条「高亮框被尺寸上报当成页面内容」的根因、口径与回归	2026-10-05 17:08:03 +08:00
suzmii	8d1980488e	补预览桥注入与去重的覆盖空白说明 ... - 踩坑记录新增 2026-10-05 条：preview.rs 的标签注入与去重没有用例覆盖，列出 4 个既有用例并给出人工验证清单	2026-10-05 15:43:41 +08:00
suzmii	629369eb0c	补齐运行画面点选的两条真机踩坑与阶段二真机复验状态 ... - pitfalls：新增「three 档句柄少构造器会整体失效」（Raycaster/Vector2/Vector3/Box3 缺任一即不进引擎档、芯片回落 canvas 且不报错，含四步排查顺序）与「预览桥脚本是编译期内嵌的：改完必须重启 AGC 客户端」 - 实施计划·阶段二进展：补真机复验环境已就绪（客户端自本分支编译启动、exe 内 6 处新代码标记已核实、CDP 可用）与「点选复验待执行」（客户端登录态过期停在登录页）	2026-10-05 15:31:44 +08:00
suzmii	19d179bde4	运行画面点选：three 句柄瘦身 + 命中对象 label 兜底 ... - 桥：three 句柄改读 `handle.three || handle.THREE`（旧整命名空间形态仍兼容），四个构造器缺任一即按未命中退化 - 桥：three label 链补 `object.name` → `geometry.type` → `object.type`，Phaser 补 `name` → `type`（取值超 40 字符丢弃）；命中对象但取不到素材身份时芯片不再一律是 `@canvas` - 契约：agc-web-game-development 的「运行画面点选契约」改用瘦身句柄 `three: { Raycaster, Vector2, Vector3, Box3 }`，并写明整命名空间会破坏 tree-shaking（同一 Vite 构建 517,682 B → 730,831 B，+41%）；skill-pack 指纹同步到 2026-08-26.39 - 模板：threejs-3d-starter 与 blank-3d-scene 的句柄源改成瘦身形态 - 测试：runtimeInspectEngines 新增 6 例（瘦身句柄命中、旧命名空间兼容、name / geometry.type / object.type 兜底、缺构造器退化），共 33 例 - 文档：功能说明补 label 兜底与瘦身句柄的验收行和边界；pitfalls 记一条 tree-shaking 口径；实施计划阶段二进展补该轮结论	2026-10-05 15:23:46 +08:00
suzmii	7d205c8da0	去掉长期文档里的阶段性措辞 ... - 功能说明「边界与非目标」的生成期契约条目：删掉「本里程碑阶段二，同一 PR 落位」这类开发过程话，保留可长期成立的口径	2026-10-05 00:01:59 +08:00
suzmii	0aed0faa9a	运行画面点选：生成期契约落进 AGC 玩法 Skill（阶段二） ... - agc-web-game-development/SKILL.md 新增「运行画面点选契约」：发布只读引擎句柄、Phaser 图片用 Image 标签装载、素材渲染对象标注 manifest 身份、素材进 dist 走与 localPath 对齐的稳定路径 - game-quality-checklist.md 与 agc-game-production-workflow/SKILL.md 只补指针，不在副本里复制契约 - skill-pack:sync 更新 manifest version=2026-08-26.38 与 agc-web-game-development、agc-game-production-workflow 的 sha256（未新增 skill 文件、未改 Rust） - 文档：功能说明边界补生成期契约来源；里程碑把「生成期契约另立里程碑」改为同一 PR 阶段二；实施计划新增「阶段二进展」	2026-10-04 23:54:37 +08:00
suzmii	b2307a5c5c	Merge remote-tracking branch 'origin/master' into feat/agc-runtime-picking-engines ... # Conflicts: # docs/project-memory/shared-memory/pitfalls.md	2026-10-04 21:47:51 +08:00
suzmii	df76a665d4	补运行画面点选验收证据与里程碑勾选 ... - 功能说明的验收证据表填入自动化与真实浏览器实测结果 - 里程碑验收标准按证据逐条勾选并补未覆盖项 - 实施计划补四个提交的落盘记录	2026-10-04 21:02:50 +08:00
suzmii	f729203c6c	补运行画面点选的行为规范、踩坑与实施记录 ... - 功能说明新增运行画面素材点选的行为合同、退化条款与边界（贴图地址不可得、只认显式句柄） - PRD 补点选素材条款与更新时间摘要 - 踩坑记录新增 Phaser 命中顺序与默认 XHR 装载两条 - 新增本里程碑与实施计划文档	2026-10-04 20:50:44 +08:00
suzmii	ab518ea574	AGC 起步工程与新建脚手架发布点选所需引擎句柄 ... - 新建项目默认脚本创建 Phaser 实例后发布只读句柄 - Phaser 与 three.js 两个起步模板及空白三维场景模板同样发布句柄 - Phaser 脚手架与模板改用 Image 标签装载图片，让贴图保留原始素材地址	2026-10-04 20:50:33 +08:00
suzmii	6264fed6b4	运行画面点选结果收敛到 manifest 现有素材 id ... - 新增匹配纯函数：显式 id、精确路径后缀、文件名、序列帧地址四档，未知值一律丢弃 - 恰好命中一个素材且标签由文件名派生时，芯片名归一化为资源显示名 - 点选处理改为调用该纯函数，派发载荷字段与顺序不变 - 新增匹配与标签归一化的单元用例	2026-10-04 20:50:26 +08:00
suzmii	6c6850352e	AGC 运行画面点选新增 Phaser 4 与 three.js 引擎档 ... - 预览桥脚本从 preview.rs 的 Rust 字符串常量搬到 resources/preview/local-preview-fit.js，改由 include_str! 引用，尺寸上报与 DOM 点选行为逐字不变 - 抽出共享命中解析，DOM 档语义保持原样 - 新增 canvas 引擎档：只认玩法发布的只读句柄，实现 Phaser 4 与 three.js 两条适配与几何兜底 - 素材身份显式标注优先于贴图地址推断，取不到时退化为不带素材的区域引用，不伪造 id - 新增引擎档用例，直接加载随包桥脚本文件断言消息载荷 - 随包桥脚本加入 prettier 排除，保持逐字内容	2026-10-04 20:45:48 +08:00