13 Commits

Author	SHA1	Message	Date
k88936	513c25898c	Merge remote-tracking branch 'origin/master' into feat/ui-editor-auto-seperation ... # Conflicts: # apps/ai-game-creator-shell/src/view/project-development/index.tsx	2026-09-14 11:32:17 +08:00
suzmii	b41b26cab8	修复资源画本进栏目只有少数卡片有位移：没有 First 帧的卡片改从那一摞起飞 ... - apps/ai-game-creator-shell/src/view/project-development/resourceBookController.ts：begin() 顺带按 (栏目, 类型摞列号) 记下同一摞最深那张卡的 First 矩形当"堆锚点"，play() 时没有 First 帧的卡片认领它当合成 First（仍是同一套 FLIP，不新增动画系统、不为动画多渲染节点）；堆锚点只在本次转场有效（maybeFinish / settle / invalidate 清掉），转场中重基（已在跑动画）不认领锚点，起点仍是"此刻像素"。 - apps/ai-game-creator-shell/src/view/project-development/resourceBookLayout.ts：展开态（allOpen）的卡片补上真实类型摞列号，不再一律 0——否则第 2 摞之后的卡片会全从第 1 摞飞出来。 - apps/ai-game-creator-shell/src/view/project-development/index.tsx：卡片宿主补 data-resource-book-stack-column / data-resource-book-stack-index，把"哪一摞"的摞身份交给转场层。 - apps/ai-game-creator-shell/tests/resourceBookController.test.ts：新增 3 条用例——每一张卡都从自己那一摞位移出来（含第 0/1 摞分别认领各自锚点、总览已渲染的仍用自己 First）、转场中重基从此刻像素而不是被拉回摞上、转场收尾后挂载的卡片不从过期锚点飞出。 - apps/ai-game-creator-shell/tests/resourceBookLayout.test.ts：新增"展开态每张卡带自己那一摞的列号"用例（同栏目两摞 ⇒ [0,0,1]）。 - apps/ai-game-creator-shell/tests/appSurface/project-development.suite.ts：在既有总览/进栏目用例里钉住宿主上的摞身份属性（总览 3 张 = 下标 0,1,2；进栏目后 5 张 = 下标 0..4、同类型列号 0）。 - docs/technical/【技术方案】GameAgent资源自由画板与快速编辑-2026-08-20.md：把资源画本转场一节更新为当前状态（堆锚点来源、锚点生命周期、展开态列号）。 - docs/project-memory/shared-memory/pitfalls.md：记录本次排障——现象、已用代码核实的原因（总览每摞只铺 3 张 ⇒ 其余卡片没有节点、没有 First 帧）、"钉住的标题栏移出 world"那笔改动不是原因的证据、处理、变异验证与真机判据。	2026-09-12 18:56:43 +08:00
suzmii	ff0bc5a3e7	资源工作台钉住的标题栏移出画布缩放层：整行文字不再发虚 ... - 钉在视口上的栏目标题栏（栏目名 / 计数徽标 / 资源总览入口）改挂场景根，成为带 scale() 的 .game-resource-book-scene-world 的兄弟节点，不再用 scale(1 / s) 抵消 world；总览态的栏目标题栏仍留在 world 里与缩略卡对齐 - index.tsx 抽出 ResourceBookScene.renderTitlebar(placement.pinned) 一处产出两种宿主，删除只服务抵消变换的 titlebarTransform 与 safeViewport/safeMainViewport 中间量 - resourceBookController 按节点自己的坐标系换算：world 内用 world 缩放，world 外（钉住标题栏）用 1；新增 nodeWorldTransform，readWorld 补 element 输出，nodeWorld 贯穿 cleanRect / FLIP 反向 transform / worldScale - 更新 resourceBookFlipValues 与 readOrigin 的口径注释：translate 单位是宿主自身坐标系，不再假定所有宿主都在 world 里 - appSurface 用例改钉新不变量：钉住的标题栏内联 transform 必须为空、不在 world 内、父节点为场景根，卡片必须仍在 world 内；并说明标题栏宿主不再跨视图同一节点、转场仍由控制器按 key 记录的 First 屏幕矩形驱动 - resourceBookController 用例新增「屏幕坐标系的宿主不被 world 缩放除」，并保留 world 内卡片仍按缩放除的对照 - 技术方案 2026-09-05 段落同步新结构；pitfalls 增记取证（截图墨色峰值 98.6 vs 同色正文 91.7、点阵周期反推 dpr=1）、本机复现尝试与结论、三处变异验证和真机判据	2026-09-12 17:09:42 +08:00
suzmii	4a5b2ad524	修复返回总览时非活动栏目标题栏从屏幕外飞入 ... - begin 只记录当时可见的节点：不可见节点（内联 opacity 0）的屏幕矩形不是可信的 First - 非活动栏目标题栏在子画布态保留总览布局坐标，却被子画布 world 变换推到屏幕外，返回总览时不再以它作为动画起点 - 没有 First 的节点只走淡入，位置保持不动；活动栏目标题栏仍按原有观感收回到总览位置 - 进入栏目方向不受影响：标题栏当时可见，仍钉在原地淡出 - 新增回归用例：不可见标题栏几何首末相等、活动标题栏仍有几何动画、进入方向标题栏原地淡出 - 同步技术方案转场段与 pitfalls 经验条目	2026-09-09 21:39:20 +08:00
suzmii	4fb0de2c94	C3 资源画本转场改为真实元素 FLIP ... - resourceBookController 重写为真实元素 FLIP：begin 在提交前记录 First，play 测 Last 后给同一节点加反向 transform，sync 按布局签名做可中断重基 - 转场进行中重基用剩余时长（下限 80ms），空闲布局变化用完整 420ms，预览图尺寸晚到的二次布局变化不再瞬移 - 宿主节点几何基准改存 world 局部坐标，平移和缩放不会让上一次的干净矩形过期 - 不可见节点钉在 First 淡出、挂载节点淡入；搜索/排序导致的卸载保留一帧淡出；返回总览时源栏目未回到摞上的卡片按子画布布局淡出 - 新增 buildResourceBookScenePlan 渲染计划，渲染、转场签名与淡出集合共用同一份数据 - 删除 ResourceBookTransitionLayer 与克隆快照逻辑，清理 styles.css 的转场层和 data-book-motion 隐藏规则 - 重写 resourceBookController.test.ts，补 resourceBookLayout/resourceBookModel 用例与 appSurface 同节点断言 - 同步技术方案转场段与 pitfalls 经验条目	2026-09-09 20:24:10 +08:00
suzmii	91f335468a	修复资源画本动画期间布局变化导致的跳变 ... 上一版在布局变化时重启整段动画，导致此前修好的遮挡顺序与加载态全部复现，已回滚该做法 控制器新增 retarget：临时解除场景隐藏后重新测量真实卡片，只把运行中动画的结束帧改成映射到新几何；克隆几何、动画进度与叠加层都不重建 布局变化 effect 在动画期间调用 retarget，空闲时才 settle 补充 resourceBookController 用例：重定向不新建动画，结束帧映射到新目标	2026-09-09 17:24:00 +08:00
suzmii	0914703032	修复资源画本飞行期间遮挡沿用错误一侧顺序 ... 卡片真正重叠的是堆叠那一侧：进入时重叠在总览摞（来源），返回时重叠在摞（目标）。原先统一按目标顺序排，进入时就用错了顺序，堆叠里下面两张飞到上面，结束才回到下方 play 增加 stacking 参数：进入用来源顺序，返回用目标顺序；不在该侧的卡片压到最底层 补充 resourceBookController 用例覆盖来源顺序	2026-09-09 16:58:44 +08:00
suzmii	a655ee1b1e	修复资源画本转场克隆遮挡顺序的第二次跳变 ... 两个场景的 z-index 数值本身不同（总览 1-3、子画布 25），只搬数值无法保证顺序一致；且只存在于来源里的淡出克隆被排在最后会盖住存活卡片，消失时表现为跳变 改为按目标场景的最终绘制顺序（z-index 升序，同值再按 DOM 顺序）给克隆分配单调层级，淡出项统一压到最底层 快照记录 DOM 序号，补充 resourceBookController 用例断言层级单调与标题栏在卡片之上	2026-09-09 16:49:53 +08:00
suzmii	9a3313fe56	修复资源画本转场克隆的遮挡顺序跳变 ... 层级相同的卡片由 DOM 顺序决定遮挡，而转场层原先按来源 key 在前追加克隆，和动画结束后的目标场景顺序不一致，结束瞬间会跳变 改为先按目标场景 DOM 顺序排列，再补只存在于来源里的 key 补充 resourceBookController 用例覆盖来源与目标顺序不同时的克隆顺序	2026-09-09 16:43:54 +08:00
suzmii	985db358a7	修复资源画本转场克隆的层级与静态不一致 ... 转场层里的克隆只按自身 DOM 顺序叠放，而静态场景中卡片是 25、标题栏是 30，导致动画期间卡片盖住标题栏、结束后又瞬间跳回下方 快照记录元素自身或最近定位祖先的 z-index，克隆按该值设置层级，保持静态层叠关系 补充 resourceBookController 层级回归用例	2026-09-09 16:22:07 +08:00
suzmii	79cf932cba	修复资源画本转场快照丢失卡片预览图 ... 快照克隆原先直接复制 blob: 对象 URL，源卡片卸载或预览缓存驱逐后该 URL 被 revoke，克隆里的图片随即失效，表现为进入/退出子画布时卡片框在动而图片不跟着展开和复原 对 blob: 来源且已解码的图片在克隆时栅格化为 data URL 冻结，与既有视频快照处理保持一致 补充 resourceBookController 快照图片冻结回归用例	2026-09-09 15:55:05 +08:00
suzmii	ba718e3d4b	重构资源画本独立转场与中断处理 ... 使用独立FLIP快照层和Web Animations统一动画收尾 统一分类导航并保留滚轮节流和各画布视口 修复快照缩放与悬停导致的终点偏移 补充动画回归测试并更新资源画本技术文档	2026-09-05 11:21:17 +08:00
suzmii	5bcaca7233	重构资源画本画布与转场状态 ... 统一主画布与子画布的可见渲染层和 viewport 状态管理。 将子画布改为固定视口加无限平移 world，并保证首次 fit 的可读比例。 补充转场、滚轮、viewport 和资源画本回归测试，更新技术方案文档。	2026-09-05 09:10:56 +08:00