[break] feat(animation-graph): enrich state and motion inspector forms

[looopmax]

Summary

• merge speedMultiplierEnabled into a combined speedMultiplier property ({ enabled, multiplier }) rendered as checkbox + variable select
• publish Blend 2D variableX/variableY as variable-select fields (FLOAT variables) and hide constant valueX/valueY
• add Animation Clip Motion group metadata and displayName for clip
• copy scalar createArg fields onto created pose nodes (variableName, stashName)
• propagate ui attributes through property dumps for inspector custom UI overrides

Test plan

• npx jest animation-graph-service — 14/14 passed

[looopmax]

Review 问题修复结果（de104e43）

针对 review 提出的 3 个 P2 已全部修复并推送（87d45f7f → de104e4）：

P2-1 · Reset 静默失效 ✅

• 组合属性 speedMultiplier 的 default 由 null 改为完整对象工厂 () => ({ enabled: false, multiplier: '' })，Reset 时 setter 同时恢复两个字段。
• 回归测试：set {enabled:true, multiplier:'speed'} → Reset → 断言 snapshot 为 {enabled:false, multiplier:''} → 重新设置 → save/reload 断言保持一致，全程 revision 链路正确。

P2-2 · 图集子帧解析错误 ✅

• 新增 resolveSpriteFrameSourceUuid()：优先从 SpriteFrame 的原始纹理引用解析（动态合图取 original.texture 持久化纹理），剥离 Texture2D 子资源后缀后回退帧自身 UUID。
• 覆盖普通散图 / plist 图集子帧 / 动态合图三种用例。

P2-3 · 绕过导入转换产物 ✅

• 新增 resolveImagePixelSource(asset)（image-processing.ts）：转换型格式（TGA/BMP/PSD/HDR/EXR/ZNT/TIFF）优先读取 importer 的 library PNG 产物（含存在性校验），其余格式直接读源文件；单一扩展名清单与导入器转换分支对齐，避免两处漂移。
• AssetManager.extractImagePixels() 改用该 helper。

验证

• npx jest animation-graph-service image-processing polygon-collider-2d：29/29 通过（含新增回归），多次重复运行稳定。
• npx tsc --noEmit -p tsconfig.json：无错误。

遗留说明

• 真实资源（TexturePacker plist / TGA / PNG fixture）端到端导入回归尚未补齐，建议在后续迭代结合 tests/fixtures 扩充；当前以单元级回归 + 既有 40 个定向用例覆盖。
• 另包含 motion preview 数据查询与 Preview 服务接线的延续工作（queryMotionPreviewData / AnimationGraphMotionPreview），为动画图预览功能做准备。

[looopmax]

Review scope

基于 5d07a6f7abff9f71508388b16b02ae9bb4d2b28d → 921d92a4e9289926dc6247f1b614ca640ad65765 的完整 diff 审查（31 files，+5067/-38），并检查了现有讨论、提交快照与远端 checks。当前 PR head 与本地工作树一致；本次未修改代码。

Standards

• Standards：按类型契约、资源导入后的真实运行路径、错误/边界处理、测试可复现性和最小改动原则审查。
• Spec：PR 描述覆盖了 inspector 表单字段、Motion Preview 和 PolygonCollider2D 等实现，但没有给出转换图片、SpriteAtlas/动态合图、薄精灵轮廓、DTS 快照和真实资源 fixture 的完整验收矩阵。

Findings

1. [P1] DTS 快照仍声明 void，而 generate:dts 产物已变为 Promise<void>，本地 dts-snapshot 失败 3 个 suite，远端 check-dts 也失败。请更新提交快照并重新跑兼容性检查。
2. [P1] extractImagePixels 对根资源直接读取 asset.source，没有选择 importer 的 library 图片。TGA/BMP/PSD/HDR/EXR/ZNT 等转换格式仍可能把原始文件交给 Sharp，导致 PolygonCollider2D 像素读取失败。请复用统一且带存在性校验的图片源解析。
3. [P1] SpriteAtlas 子帧的 UUID 前缀是 SpriteAtlas/plist，而不是图片纹理 UUID；动态合图还需要优先 original texture。当前逻辑会把 plist 交给像素读取，图集子帧无法得到像素。请解析原始/当前纹理 UUID，再走统一图片源解析。
4. [P1] 闭环起点在 contour 循环回到 start 时已经 push 一次，循环结束后又 push 一次；默认 threshold=1 下，1x1/1xN/2x1 等合法薄精灵会折叠为重复端点，最终少于 3 个点而无法 regenerate。请只保留一个闭环端点并补薄图回归。
5. [P2] queryMotionPreviewData 的 JSDoc 写的是目标不存在返回 motion: null，但实现会抛 TARGET_NOT_FOUND，新增测试也明确断言 reject。请统一公开契约与实现。

减法复核

当前 PR 的标题和主体主要描述 inspector 表单增强，但完整 diff 同时加入 PolygonCollider2D 像素/轮廓能力、Motion Preview facade/runtime，以及 HTML+Markdown 数据结构文档（合计 31 个文件）。这扩大了审查和回归边界；建议拆分为相互独立的变更，或至少在 PR 描述中补齐每条能力的范围、失败路径和 fixture/test matrix。

验证

• PASS：npx tsc --noEmit -p tsconfig.json。
• PASS：PolygonCollider2D、regenerate API、prefab UI handling 定向测试 24/24。
• FAIL：npm run generate:dts:ci 生成的 hideMotion/playMotion/setMotionTime/setMotionVariable/setMotionParameter 为 Promise<void>，而提交快照为 void；本地 dts-snapshot 定向运行 3 个 suite 失败、8 个通过。
• FAIL：远端 check-dts（run 34010901472 / job 101426429190）报告相同的 DTS API breaking/signature mismatch。
• 未覆盖：完整构建、Windows/macOS 运行时、真实 TGA/PSD/HDR/EXR/ZNT/TIFF、TexturePacker/dynamic atlas fixture，以及 Motion Preview UI/runtime 回归。

Verdict

本次以 COMMENT 发布（GitHub 不允许 PR 作者对自己的 PR 使用 REQUEST_CHANGES）。审查结论仍为需要修改：4 个 P1 问题需要在合并前修复——DTS 快照、转换图片源解析、图集/动态合图纹理解析、薄精灵闭环端点；同时请修正 Motion Preview 的 JSDoc 契约，并在修复后重新验证远端 checks 与真实资源路径。

[looopmax]

PR #2 修复与验证汇总

当前 head 0cd49e38370f02f1f6457a14cff551d1384ac79d 已包含此前 5 条 review comment 的修复：DTS 快照、转换图片 library 源解析、SpriteFrame 图集/动态合图纹理 UUID、薄精灵闭环，以及 Motion Preview 错误契约。对应修复提交为 5a5e3188 与 766bc7ef。本轮未新增业务代码提交。

验证结果：

• 本地 npx jest animation-graph-service image-processing polygon-collider-2d --runInBand --no-cache：34/34 通过。
• 本地 npm run generate:dts:ci + DTS snapshot：11/11 通过。
• 本地 npx tsc -b：通过。
• 远端 pr-test (macos-latest)：通过；pr-test (windows-2022)：通过；check-changes：通过。

剩余红灯是 check-dts 的 Windows runner 环境故障：11 个 DTS 入口均已生成，随后 npm ci 的 postinstall 在 npm run generate:dts 的 Jest 更新快照子进程退出 3221226356（Windows 0xc0000374 heap corruption），并非 DTS 快照断言或 API compatibility 失败。相同崩溃已在前一轮 Windows run 重现；本地生成与快照通过，且 766bc7ef 的此前 check-dts run 曾全量通过。当前 token 无仓库管理员权限，GitHub 拒绝了 gh run rerun 34088336941 --failed；请管理员重跑该 check-dts job。