suzmii
2407295363
Project CI / Repository checks (push) Successful in 2m58s
Project CI / Frontend tests (push) Successful in 3m23s
Project CI / Backend tests (push) Successful in 5m0s
Project CI / Native shell tests (push) Successful in 13m37s
修复资源管理滚轮翻页偶发失效 (#197)
## 变更背景
资源管理画布在连续滚轮翻页时，可能出现偶发失效或中间栏目被逐页渲染，导致后续滚轮输入被资源渲染阻塞；同时，缩放、手动切页、排序和拖拽过程中还可能执行已经过期的翻页任务。
本 PR 将翻页意图与资源渲染提交解耦，并补齐交互取消边界，让连续输入始终基于最新逻辑目标栏目计算。
## 主要修改
- 滚轮分页改为同步维护逻辑目标栏目，可见栏目通过 React transition 异步提交；渲染尚未完成时，新滚轮事件仍基于最新逻辑目标继续计算，不逐页加载中间栏目。
- 待执行翻页队列改为有界合并与延迟 flush，修复旧定时器清理不完整的问题。
- Ctrl/Meta 缩放、触控板缩放手势、手动点击切页、切换排序、开始画布空白拖拽或资源卡拖拽时，取消尚未执行的过期翻页任务。
- viewport 更新显式携带目标栏目，画布拖拽记录发起时的栏目，避免过渡渲染期间把旧栏目 viewport 写入新栏目。
- 每个排序模式和栏目继续保留独立 viewport，复位、首次 fit 与保留用户当前平移缩放的路径统一使用同一套数据流。
- 依赖浮层的 ResizeObserver、scroll 和 resize 监听只在挂载时建立一次；viewport / 几何 revision 变化时通过 ref 合并调度一帧测量，避免连续输入时重复重建观察器。
- 更新资源自由画板技术方案，并补充回归测试覆盖连续滚轮、缩放取消、大步跳转、切页边界和依赖浮层观察器生命周期。
## 验证
- `npm run test -- apps/ai-game-creator-shell/tests/ResourceDependencyOverlay.test.ts apps/ai-game-creator-shell/tests/appSurface.test.ts --run`
- 2 个测试文件通过
- 393 / 393 tests passed
- `npm run agc:typecheck`
- `npm run lint:eslint -- apps/ai-game-creator-shell/src/view/project-development/index.tsx apps/ai-game-creator-shell/src/view/project-development/ResourceDependencyOverlay.tsx apps/ai-game-creator-shell/tests/ResourceDependencyOverlay.test.ts apps/ai-game-creator-shell/tests/appSurface/project-development.suite.ts`
- `npm run check:encoding`
- `git diff --check`
以上均为合并 `origin/master@2f3c578db` 后在 `b5c98af42` 上执行。
Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/197
Co-authored-by: suzmii <suzmii@qq.com>
Co-committed-by: suzmii <suzmii@qq.com>
2026-08-26 15:29:35 +08:00
..
2026-08-22 13:17:26 +08:00
2026-08-26 15:29:35 +08:00
2026-08-24 16:27:33 +08:00
2026-08-24 16:27:33 +08:00
2026-08-22 13:17:26 +08:00