553 Commits

Author	SHA1	Message	Date
suzmii	e4c2f2466f	合并资源工作台分支：卡片从所属摞浮现与既有三条修复并存 ... - 把远端最新 05612c46a（弹窗宿主类样式迁共享表 + 标签统计刷新 + 工具条分隔线去重）合入本分支 b41b26cab（卡片全部从所属摞浮现） - 冲突零：仅 pitfalls.md 两侧追加记录自动合并，两条都保留 - 验证：npm run typecheck exit 0；resourceBookController / resourceBookLayout / resourceTagStatsRefresh / projectAssetPickerDialogShellStyle / selectedLayerToolbarDividerDedupe 五文件全绿	2026-09-12 18:58:52 +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	05612c46ae	合并资源工作台分支：弹窗宿主类样式迁到共享表与既有修复并存 ... - 把远端最新 b498c2780（标签统计刷新 + 工具条分隔线去重）合入本分支 074924190（弹窗宿主类 platform-modal-shell/overlay/backdrop 迁到共享样式表） - 冲突零：src/index.css 自动合并（本分支删除三条宿主类规则，远端最新新增分隔线去重规则） - 验证：npm run typecheck exit 0；projectAssetPickerDialogShellStyle + selectedLayerToolbarDividerDedupe + resourceTagStatsRefresh 三个用例文件全绿	2026-09-12 18:51:33 +08:00
suzmii	0749241908	修复 AGC「选择替换素材」弹窗面板透明：平台弹窗外壳规则移入共享样式表 ... - 根因：弹窗面板用的 `platform-modal-shell`（遮罩 `platform-overlay`）规则原先只写在网页端整站样式表 src/index.css；AGC 只加载 packages/shared/src/components/styles.css 与 theme.css，类名挂上了但一条声明都没命中，面板因此无底色、无边框、无阴影，背后模糊的资源画布直接透出 - 把 platform-modal-shell / platform-modal-backdrop / platform-overlay 三条宿主类规则从 src/index.css 移进 packages/shared/src/components/styles.css：两个宿主都 import 这张表，规则只保留一份，不在 AGC 业务样式里复制平行副本；三处声明逐字照搬，网页端层叠结果不变 - 新增 apps/ai-game-creator-shell/tests/projectAssetPickerDialogShellStyle.test.tsx：从 src/main.tsx 按真实 import 关系解析出「AGC 到底加载了哪些样式表」，断言清单里有这三条规则、背景引用主题 token、light 主题下 --platform-modal-fill 各色停 alpha ≥ 0.9；DOM 契约断言面板挂 platform-modal-shell、遮罩带 platform-overlay 与 platform-theme--light；并断言这三条规则只在共享表里各定义一次（禁止平行拷贝） - docs/project-memory/shared-memory/pitfalls.md 记录「共享弹窗的宿主类必须落在所有宿主都会加载的样式表里」的排障经验	2026-09-12 18:48:31 +08:00
suzmii	b498c2780e	修复改完素材标签后聊天侧标签统计与候选不刷新 ... - App.tsx：新增跟随工作台壳清单快照的 effect（`manifestRef` + 同一 `projectId` 且内容确实变了才 `setManifest`）， 让聊天侧 `@` 选择器的标签计数与候选在资源命令写入后跟上画布那份清单 - tests/resourceTagStatsRefresh.test.tsx（新增）：真宿主链路用例 —— 资源画布「编辑标签」保存后， 聊天 `@` 选择器出现该标签 chip 与计数、并按它收窄候选；反向用例钉住未标注标签时不渲染标签 chip - docs/project-memory/shared-memory/decision-log.md：记录标签派生数据的三处来源与各自数据源、 根因（`initialProjectManifest` 只是 `useState` 初值，壳里换清单不会再进来）、修复口径与已知未覆盖项	2026-09-12 18:48:04 +08:00
suzmii	bb91e8909d	修复选中资源工具条出现两条相邻分隔线 ... - 成因：共享工具条在 showQuickEdit 分支于「快速编辑」后输出一条分隔线，同时为 extraActions 自动生成前置分隔线（extraActionDivider）；AGC 资源卡是「快速编辑可用 + 中间动作未接通不渲染」的组合，两条因此相邻 - 修法：样式层去重（相邻的两条只显示一条），不改 JSX 结构，对美术画布与资源画布两端都成立，也不会隐藏任何真正起分隔作用的那一条 - 新增契约用例 selectedLayerToolbarDividerDedupe.test.ts 钉住去重规则与它的成因两端 - 验证：该用例 3 passed；变异验证（删掉去重规则）→ 1 failed，还原后 3 passed	2026-09-12 18:23:02 +08:00
suzmii	4c180ac29a	合并 fix/agc-manifest-revision-cas：钉住的栏目标题栏移出画布缩放层（解 pitfalls.md 冲突） ... - 合并来源：ff0bc5a3e（fix/agc-manifest-revision-cas）。 - 冲突只有 1 个文件 1 处：docs/project-memory/shared-memory/pitfalls.md（两侧都在文件末尾追加了一条 2026-09-12 记录，文本上是同一个插入点）。 - 解冲突（两侧内容逐字都保留，都不改写、不删）： - 保留 HEAD 侧 6618207b5 的「运行模块切换版本报 listeners[eventId].handlerId」一节（pitfalls.md:5397）。 - 追加 ff0bc5a3e 的「资源工作台顶部那一行发虚」一节（pitfalls.md:5407）。 - 同一天的记录之间没有排序语义，取「HEAD 内容不动、新记录追加在末尾」，这样两侧 diff 都是纯插入。 - 另外两处自动合并（git 未报冲突）已逐段语义核对，两侧行为都在： - apps/ai-game-creator-shell/src/view/project-development/index.tsx：ff0bc5a3e 的 renderTitlebar 结构完整保留（:1187 定义、:1244 总览态在 world 内渲染、:1313-1317 钉住的那一条渲染在 world 之外、作为 world 的兄弟节点）；ff0bc5a3e 删掉的 titlebarTransform / safeViewport / safeMainViewport 已无残留；本分支 V3 的行为同时保留（:1234 plan.map 栏目卡、:1250 card.presentation、:1279 isResourceBookAllTarget 预览卡、:1307 worldOverlay、:1318 overlay）。 - apps/ai-game-creator-shell/tests/appSurface/project-development.suite.ts：ff0bc5a3e 钉的新不变量（:782-800 钉住标题栏不在 world 内、内联 transform 为空、父节点是场景根）与本分支 V3 既有用例都在。 - resourceBookController.ts 未冲突：nodeWorldTransform（:221）、readWorld 补的 element 输出、nodeWorld 贯穿 cleanRect / FLIP / worldScale（:457、:521）都在。 - 自证： - 仓库内 git grep '^<<<<<<<|^>>>>>>>' 无命中。 - git diff --name-only 87fbf92c5 <本提交> 恰好 18 个文件 = 6618207b5(10) + ff0bc5a3e(5，与前者共用 pitfalls.md) + 46458a825(2) + DesignWorkspacePanel.tsx(1)，没有多余文件。 - git diff ff0bc5a3e <本提交> -- resourceBookController.ts resourceBookController.test.ts 为空（这两个文件 ff0bc5a3e 改过、master 没碰，因此必须逐字一致）；与 ff0bc5a3e 的差异只落在双方都改过的 index.tsx / project-development.suite.ts / pitfalls.md 三个文件上。 - 验证（两条修复都并入后统一执行，全绿）：npm run typecheck exit 0；npm --prefix apps/ai-game-creator-shell run typecheck exit 0；npx vitest run apps/ai-game-creator-shell/tests → 98 files / 1394 passed | 4 skipped（0 failed）；npm run check:encoding → 4489 file(s) passed；git diff --check 干净；npm run check:rustfmt exit 0（这两笔修复都没动 Rust，额外确认一次）。	2026-09-12 18:09:57 +08:00
suzmii	46458a8253	修复运行模块版本菜单「点了选项没反应」：portal 菜单被「点外部」判定吃掉 click ... 与 665982eb9 的 tauri 事件注销竞态是两个独立原因，用户看到的是同一个症状： ① 切换版本时的重载被事件竞态报错打断（665982eb9，已并入 6618207b5）； ② 版本菜单在选项收到 click 之前被「点外部」判定收掉，onSelectVersion 永远不被调用（本提交）。 - 现象：在运行模块点版本菜单里的选项没有任何反应（菜单直接消失、当前版本不切换）。 - 原因：菜单用 createPortal 挂到 document.body（运行画面会缩放，挂 body 才不跟着画布跑偏），DOM 上不在触发按钮 rootRef 的子树里；而「点外部关闭」判定只认 rootRef，落在选项上的那一次按下就被当成点外部，菜单在选项收到 click 之前被卸载，选项的 onClick 永远不会触发。 - 改法：删掉自建的 window mousedown 判定，复用共享 hook useImageCanvasFloatingOptionDismiss（AGC 的 view/project-development/index.tsx:1661 已在用同一份口径，不新造第二套判定），并把 portal 菜单登记成第二个边界：GameRunVersionPicker.tsx:35 新增 menuRef、:37-41 传 boundaryRefs: [rootRef, menuRef]、:69 把 menuRef 挂到菜单容器上。菜单的关闭时机随之从 mousedown 变为 click，与画布浮层口径一致。 - 回归用例（apps/ai-game-creator-shell/tests/resourceVersionSwitch.test.tsx，全部走真实指针序列 mousedown → mouseup → click，不再像旧用例那样只派发 click）： - does not dismiss the portal version menu when an option is pressed down：mousedown 后菜单必须还在，随后 mouseup+click 必须调用 onSelectVersion('version-root')。 - selects the version from the run module when the option is clicked after a real press：真实 launcher + 运行模块，走完真实序列后宿主必须收到 onActiveVersionChange('version-root')。 - keeps the portal menu mounted when the click lands on the menu itself：点 portal 菜单自身（非选项区）不算点外部。 - 变异验证（两条，都先红后绿）： - 还原旧实现（window mousedown + 只认 rootRef）→ 3 条新用例全红：2 条 AssertionError: expected null not to be null（菜单被关掉），1 条 expected "spy" to be called with arguments: [ 'version-root' ] / Number of calls: 0（onActiveVersionChange 没被调用，正是用户症状）。 - 只把边界收回 boundaryRefs: [rootRef]（仍复用 hook，但不登记 portal 菜单）→ keeps the portal menu mounted when the click lands on the menu itself 变红（expected null not to be null）。注意另两条此时仍绿：共享 hook 的判定在 click 而非 mousedown，所以要复现用户现象必须连旧的 mousedown 判定一起还原，这也是本次把判定整体换成共享 hook 的直接理由。 - 验证：npx vitest run apps/ai-game-creator-shell/tests/resourceVersionSwitch.test.tsx 7 passed（原 4 条 + 新 3 条）；npm --prefix apps/ai-game-creator-shell run typecheck exit 0。	2026-09-12 18:02:13 +08:00
suzmii	665982eb99	合并 fix/agc-version-switch-event：切换版本报 listeners[eventId].handlerId 的订阅竞态修复并入资源工作台 V3（解 App.tsx 冲突） ... - 合并来源：6618207b5（fix/agc-version-switch-event）。冲突只有 1 个文件 1 处：apps/ai-game-creator-shell/src/App.tsx:1889-1940。 - 冲突成因：master 侧（策划 agent 重构）在 planning-session-v2-stream 之后新增了一条 design-agent-update 订阅（App.tsx:1888）；6618207b5 则把这处相邻的 manifest-invalidated 守卫 `const listen = window.__TAURI__?.event?.listen; if (!listen)` 换成 `canSubscribeTauriEvents()`，两段文本相邻导致冲突。 - 解冲突（两侧都保留，未删任何一侧）： - 保留 master 新增的 design-agent-update effect 及其全部行为符号：designAgentTurnRef 轮次配对、payload.projectPath 比对、setPlanningV2TransientReply、setPlanningV2Reasoning、applyDesignView（App.tsx:1888-1931）；只把它的订阅方式换成 6618207b5 的入口（subscribeTauriEvent<DesignEvent> + canSubscribeTauriEvents 守卫）。 - 采用 6618207b5 对 manifest-invalidated 的写法：canSubscribeTauriEvents() 守卫 + subscribeTauriEvent<GameCreatorManifestInvalidatedEvent>（App.tsx:1933-1940），refreshManifest 行为不变。 - 冲突区外补齐同一件修复：apps/ai-game-creator-shell/src/features/project-workspace/DesignWorkspacePanel.tsx:264-301 是 master 新增、而 6618207b5 基于共同祖先 46788edbb 写作时还没出现（base 里没有这个文件）的一处订阅，事件同为 design-agent-update、写法同为「订阅后立刻注销」，会同样踩 React.StrictMode 的注销竞态，因此一并改走订阅入口；否则「唯一订阅入口」不成立、该竞态在本次要打包的版本里仍然活着。 - docs/project-memory/shared-memory/pitfalls.md 自动合并成功，6618207b5 与 ff0bc5a3e 两条 2026-09-12 记录都在（无手工取舍）。 - 自证：git grep '^<<<<<<<|^>>>>>>>' 无命中；AGC 内除 services/tauriEventSubscription.ts 自身外，已无 __TAURI__?.event?.listen 直连订阅。 - 验证（本提交时点）：npm --prefix apps/ai-game-creator-shell run typecheck exit 0；npx vitest run apps/ai-game-creator-shell/tests/resourceVersionSwitch.test.tsx 7 passed。全量验证（两侧 typecheck、AGC 全量用例、encoding、git diff --check）在两条修复都并入后统一执行。	2026-09-12 18:01:38 +08:00
suzmii	87fbf92c58	合并 origin/master 到资源工作台 V3 分支：解 4 处冲突并保留两侧行为 ... - WorkspaceLauncher.tsx：保留本分支清单快照 CAS 拒收提示（manifestMergeNotice 提示条、data-manifest-merge-* 观察点、recoverRejectedManifestSnapshot「重新读取清单」）与 activeVersionId/onActiveVersionChange 版本口径，并入 master 的策划/游戏运行态切换（onMakeGame + switchToGameRuntime、suppressInitialGameTurn 抑制首轮、supervisor key 带 agentRuntimeMode、onSwitchToGameRuntime），planningStartMode 统一取 master 的派生值（上下文 startMode 为 planning 且未切到 game 运行时） - ProjectSupervisorView.tsx：props 同时保留本分支 versions/activeVersionId 与 master 的 designView/onDesignApprove/onDesignClarify/onDesignRetry，DesignAgentSurface 审批链路与本分支资源引用输入区并存；directCodex 输入区保留本分支 @ 引用按钮 + 模型选择 + 发送按钮控制条，发送按钮禁用条件并入 master 的 designView 审批待定口径，模型选择沿用 master 的「对话中可切换」口径 - styles.css：本分支追加的资源画布/输入区样式块与 master 追加的 .design-agent-reasoning 样式块都保留，并补上本分支最后一条规则的收尾大括号 - view/project-development/index.tsx：保留本分支的 image-editor 引用（ImageCanvasProjectAssetPickerDialog、ImageCanvasQuickEditPanelView、ImageCanvasSelectedLayerToolbarView、useImageCanvasFloatingOptionDismiss），去掉 master 对已退役 features/asset-canvas 的 import（本分支已由 resource-canvas 取代），保留 master 的 DesignWorkspacePanel 与 planningStartMode 策划工作台分支 - tests/workspaceLauncherManifestMerge.test.tsx：补 master 新引入的 get_design_agent_runtime_mode mock（返回 null，与 master 各套件同口径），拒收提示断言不变 - tests/appSurface/design-agent.suite.ts：审批待定禁用输入的断言改用本分支 Lexical 输入区的禁用口径（容器 data-disabled + editor.setEditable(false)），断言意图不变 - 验证：npm run typecheck 通过；apps/ai-game-creator-shell typecheck 通过；apps/ai-game-creator-shell/tests 96 个测试文件 1380 通过 4 跳过 0 失败；全仓 vitest 297 通过 2 失败（scripts 下两例为 Windows 权限语义导致的既有失败，相关文件与实现均未参与本次合并）；npm run check:encoding 与 git diff --check 通过	2026-09-12 17:31:51 +08:00
suzmii	6618207b5b	修复运行模块切换版本报 listeners[eventId].handlerId：事件订阅改为自建登记 + 幂等注销 ... - 新增 apps/ai-game-creator-shell/src/services/tauriEventSubscription.ts：AGC 唯一的事件订阅入口。真实 WebView 内用 plugin:event|listen + transformCallback 自建登记，注销时先 unregisterCallback(handlerId)（callbacks.delete，幂等、缺条目也不抛）再发 plugin:event|unlisten，并对重复注销去重，注销失败只在 console.warn 显式记录；非原生环境沿用注入的 event.listen（两参调用形状不变），未接桥接时返回空操作。tauri 2.11 的注销脚本会先读注册表条目再摘回调，而条目由注册 eval 异步写入，与 IPC 返回无序，这一层自建登记正好绕开该竞态（上游 tauri-apps/tauri#15799 / #15800，2.12 起脚本自带判空，升级后可删掉 internals 分支）。 - App.tsx：5 处事件订阅（game-creator-direct-turn-update / agent-progress / agent-runtime-update / planning-session-v2-stream / manifest-invalidated）与角色 Agent 流式回复监听改用订阅入口，守卫由 window.__TAURI__?.event?.listen 换成 canSubscribeTauriEvents()。 - features/app-shell/useDeveloperAgentPanel.ts：Agent Runtime 与角色 Agent 流式回复两处订阅改用订阅入口。 - services/errorReportingBridge.ts：error-report-updated 订阅改用订阅入口，不再直接依赖库内 listen。 - components/AppUpdateNotice.tsx：更新下载进度订阅改用订阅入口。 - components/WindowChrome.tsx：窗口尺寸监听不再走 nativeWindow.onResized，改为订阅 tauri://resize（限定当前窗口），避开库内注销竞态。 - 新增 tests/tauriEventFake.ts：与 tauri 2.11.3 等价的 Tauri 事件替身（注册表条目由注册 eval 异步写入、库内注销脚本读缺失条目即抛并留痕、全局桥 event.listen 按库内实现返回会读条目的注销函数）。 - 新增 tests/tauriEventSubscription.test.ts（7 例）：注册 eval 未落地就注销、重复注销只摘一次、注册落地后能投递且注销后不再投递、真实 WebView 不走库内注销脚本、无 internals 时回落注入桥接、无桥接时空操作。 - 新增 tests/runVersionSwitchEventSubscription.test.tsx（2 例）：真实 launcher + 运行模块连续切换两次版本（断言 start_local_game_preview 被调用）、卸载后后端订阅与 JS 回调都不泄漏、切换版本后清单失效事件仍能送达并重读清单。 - docs/project-memory/shared-memory/pitfalls.md：记录该竞态的成因、触发面、处理取舍与变异验证结论。	2026-09-12 17:23:22 +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	2d40f02286	合并资源工作台分支：素材类型可由用户变更与角标显示资源类型并入 ... - 把 v3 顶端 ace31a5f1（快速编辑 @ 引用素材 + @ 面板标签筛选）合入本分支，与本分支 1079f6c91（用户可变更素材类型、角标改显示资源类型）并存 - 冲突零：index.tsx 两侧改动落点不同（快速编辑 promptInputSlot 接线 vs 角标取值点），projectResourceLiveIntegration 与验收文档自动合并 - 验证：npm run typecheck exit 0；resourceClassificationPanel + projectResourceLiveIntegration 共 45 tests 全绿；check:encoding 4409 文件通过；git diff --check 干净	2026-09-12 16:57:28 +08:00
suzmii	1079f6c91b	资源工作台可变更素材类型：面板加类型选择器、卡片角标改显示资源类型 ... - ResourceClassificationPanel.tsx：加素材类型（功能分类）选择器，与标签同一次保存、同一条写入路径；选项 = GAME_CREATION_APP_ASSET_CATEGORIES × resourceReferenceCategoryLabel，不新造第二套中文译名 - ResourceClassificationPanel.tsx：选择器读显示口径（与画布栏目 projectResourceAssetCategory 同源，选中项就是卡片所在栏目）；写回分两路——没碰过类型控件回传 gameCreationAppAssetPersistedCategory 的落盘原值，主动选过才写用户选的值（categoryChoice ?? persisted），保证「只改标签」不漂移分类 - index.tsx：资源卡右上角角标由「文件/媒体类型」改为「资源类型」，取 categoryLabels[resource.category]（栏目与筛选共用的同一份文案），角标恒等于该卡所在栏目；projectResourceTypeLabel 仍服务资源管理面板小字与总览摞分列，不再用于角标 - tests/resourceClassificationPanel.test.tsx：新增「变更素材类型」6 条用例（选择器 6 项与中文口径、选择器显示显示口径自愈值、主动选值写入载荷、只改标签回传落盘原值对照、显式待归类写入 unclassified、连续两次各带当次选择且不关窗），并按新增控件更新既有按钮序与「分类不再由面板编辑」两条断言 - tests/projectResourceLiveIntegration.test.tsx：新增真宿主跟随链用例（角标显示资源类型并与栏目同名、改类型后卡片进目标栏目且角标跟着变、原栏目不再有它），配套状态化宿主 fixture、分类写入与 get_local_game_manifest 两条命令桩、切栏目与读角标助手 - tests/appSurface/project-development.suite.ts：原 data-resource-type 媒体类型断言改为资源类型（角色与对象 / 待归类 / 音频），并说明卡面正文走媒体分支、角标走资源类型这两个独立轴 - docs：PRD §5.3 由「分类没有用户手动设置入口」改为当前两口径分叉（选择器读显示口径、写回按是否主动选过分流）与「显式待归类被读时自愈覆盖」盲区 - docs：AGC 资源工作台 V3 端到端验收 S5 的「前端交互不能改分类」改写为可改分类，补判据（角标读 .game-resource-card-type-badge）与盲区说明；实施计划写入命令一节的面板名与职责同步为「编辑素材标签（标签 + 素材类型）」 - docs：decision-log 新增条目记录本次决策（Rust 无需改动、画布跟随链无需额外迁移代码、待归类盲区、四条变异验证结果与一条不可构造的变异） - 说明：Rust、manifest 字段构成与 SpacetimeDB 均不改；写入命令 update_local_project_resource_classification 早已接受任意合法 category	2026-09-12 16:54:24 +08:00
suzmii	ace31a5f19	合并资源工作台分支：快速编辑 @ 引用素材与标签面板不关窗两套行为并存 ... - 把 v3 顶端 46788edbb（「编辑素材标签」保存后不关窗）合入本分支，与 35d3a92af（快速编辑支持 @ 引用素材、@ 面板补标签筛选）并存 - 冲突零：index.tsx 两侧改动落在不同位置（keepClassificationPanelOpen 与 quickEditReferences/promptInputSlot 接线），自动合并 - 验证：npm run typecheck exit 0；resourceClassificationPanel + resourceVersionReplacement + resourceReferenceInput + projectResourceLiveIntegration 共 4 files / 73 tests 全绿	2026-09-12 16:51:56 +08:00
suzmii	35d3a92afd	快速编辑提示词支持 @ 引用素材，@ 面板补标签筛选 ... - 快速编辑面板提示词换成与聊天同一个 `ResourceReferenceInput`，`@` 候选、插入动作与引用模型全部复用聊天那一套 - 共享 composer / 快速编辑面板新增 `promptInputSlot` 注入位，宿主控件替换默认 textarea，不传时 DOM 与行为逐字不变 - `ResourceReferenceInput` 新增 `showPolishAction`：快速编辑的润色仍由 ResourcePromptPolishSlot 承担，面板里不再出现第二个润色入口 - `ResourceReferenceInput` 的多行输入区把 Enter 留给换行，只有单行输入区才用 Enter 提交 - `@` 面板的搜索与筛选改用共享 `PlatformResourceFilterBar`，搜索 + 功能分类 + 标签三者在面板内叠加生效 - 新增 `resourceReferenceMatchesTagSelection` / `resourceReferenceTagLibrary`，标签口径（多标签 AND、计数与排序）落在共享标签库，两个页签各持一份 - 宿主新增 `quickEditReferences` 与 `applyResourceQuickEditDraft`，派生请求的 prompt 就是输入区回填的那份文本（`@显示名`），不引入第二种引用格式 - `useImageCanvasFloatingOptionDismiss` 新增 `isInsideExtraOverlay`：宿主 portal 到 body 的 `@` 选择器与候选菜单不再被判成点外部而收起快速编辑面板 - 资源画布快速编辑提示词输入区补样式（铺满 composer 一整行、高度上限），`@` 面板去掉手写搜索行样式 - 用例：新增标签库口径、标签筛选（多标签叠加 + 关键字 + 功能分类）、两页签独立标签、聊天与快速编辑草稿一致性、快速编辑内 `@` 出选择器且派生 payload 断言；扩展 AGC 资源工作台 V3 端到端验收用例	2026-09-12 16:44:55 +08:00
suzmii	46788edbb8	修复「编辑素材标签」保存后关窗：点「添加」成功后面板保持打开，可连续添加 ... - 定位关窗来源：面板的 saveResourceClassification 只调 onSaved、从不调 onClose；真正卸载面板的是宿主 index.tsx 的 setResourceClassificationAssetId(null)（在 reloadManifestAfterAssetCommand 里，由 handleResourceClassificationSaved 触发） - 在宿主层给 reloadManifestAfterAssetCommand 加 keepClassificationPanelOpen 开关：默认仍然收起，删除素材 / 版本替换 / 重命名的既有行为不变，只有标签保存显式传 true - 标签保存后不再清 resourceClassificationAssetId：面板保持打开，新标签已落成 pill、输入框已清空，用户可以接着加下一个标签 - 关闭面板仍只走头部 ×；标签 pill 内的「删除标签」按钮与删除素材流程都不受影响 - 面板用例：添加后不得调用 onClose、面板仍在、新标签出现在已有标签列表、输入框清空；连续两次「添加」各自写盘且第二次带上累计标签、category 仍原样回传落盘值 - 工台用例（resourceVersionReplacement.test.tsx）补真宿主链路：经工具条「编辑标签」打开面板 → 添加 → 断言写入载荷与面板仍在 → 再添加一次 → 两次写入各自发生且面板依然打开（只测面板组件看不出宿主把面板卸载了）	2026-09-12 15:59:44 +08:00
suzmii	dc243b0d57	资源工作台「替换素材」候选窗接上预览管线，补齐候选排序、禁用态可读性与删除素材入口 ... - 「替换素材」候选卡缩略图接入资源卡同一条预览管线：新增 ResourcePreviewMedia，复用同一份预览身份、同一条队列与 LRU 缓存，不再只渲染类型占位图标 - 预览 hook 暴露 sweepVisiblePreviews：弹窗内容挂在 portal 下、不在资源画本 observer 的 root 子树内，改为在「弹窗打开」与「候选区滚动」两个几何变化点显式按同一套视口几何判据兜底放行，不新增第二条加载通路 - 候选排序抽出纯函数 sortResourceReplacementCandidates：可替换（无硬门禁失败）的排最前，其余按后端原名次跟随且仍渲染但禁用；判据与弹窗禁用状态同源，不会出现「排最前却点不动」 - 抽出纯函数 projectResourcesByManifestAssetId，让弹窗素材映射与候选缩略图共用同一份资源投影口径 - 共享选择弹窗的禁用态不再整卡压透明度：变灰只压在缩略图与名称上，「分类不同」这类禁用原因保持全对比度可读（网页端美术画布不传禁用原因，视觉逐字不变） - 资源卡选中工具条末位新增「删除素材」，前置共享工具条同一套分隔线与前面的非破坏性动作隔开，只在 manifestAssetId 存在时才渲染 - 删除流程抽成 useResourceAssetDeleteFlow（读引用信息 → ResourceAssetDeleteDialog 二次确认 → delete_local_project_asset 的 deleteReferencedVersions 三分支），工具条与面板共用同一份实现，没有第二套删除 - 「编辑素材标签」面板底部只留右下角一个「添加」：点它把输入框内容（含未按回车的尾巴）落成 pill 并按现有写入路径保存，分类仍原样回传落盘原值；删除素材/取消/保存标签三个按钮移除，关闭仍走头部 × - 标签 pill 内的删除标签按钮保持不变 - 更新与补充用例：候选排序、排序与禁用同源、候选缩略图真链路与滚动兜底放行、工具条删除入口位置与 IPC 载荷、连带删除分支、面板无删除入口与「添加」语义、禁用态可读性类名契约、工具条动作清单	2026-09-12 15:30:38 +08:00
lhk229	832f1e8b59	修复策划项目重开运行态恢复 ... 持久化策划项目 design 运行模式并在重开时恢复 design/game 工作台。 补充旧策划会话兼容判断、前端夹具和恢复回归测试。	2026-09-12 06:41:49 +00:00
suzmii	e4ee6c2be8	合并 feat/agc-resource-replace：把「替换素材」接进资源工作台 ... - 解冲突 project/manifest.rs：保留版本写入公共体 write_manifest_locked_with_version_guard（版本只追加 + 绑定改写放行），并把 schema 校验并入该公共体，两侧语义都不丢 - 解冲突 shared-contracts：取当前分支的读显示口径 game_creation_app_asset_effective_category（含与 TS 交叉钉住的 EFFECTIVE_CATEGORY_CONTRACT 矩阵），同步改写 version_resource_replacement 对旧函数名的调用 - 解冲突 index.tsx：两处均为纯 import 追加，两侧都保留 - 解冲突 decision-log 与技术方案文档：两侧条目都是追加，全部保留 - 随之进入本分支：版本绑定改写窄放行通道、直接替换命令与其兼容性判据、资源卡工具条「替换素材」入口	2026-09-12 14:19:03 +08:00
suzmii	3015370286	补 C7 版本切换「重载当前预览」验收测试 ... - resourceVersionSwitch 新增用例：运行模块内切换版本必须既上报宿主又触发 onPlay 重载预览 - 覆盖验收用例 S16 的「并重载当前预览」条款（此前版本入口只测了记录层与高亮，重载没有守卫） - 变异验证：摘掉 selectActiveVersion 里的 onPlay 调用后，该用例以 expected "spy" to be called at least once 失败 - 定向验证：resourceVersionSwitch 4 passed	2026-09-12 13:34:32 +08:00
suzmii	028b20a590	修复清单快照误判：CAS 判据面收窄为「资源 + 版本」，预览起停不再触发用户可见拒收 ... - projectResourceLiveUpdateModel 新增 manifestCasFingerprint，按 { assets, versions } 判定同版本号冲突 - 同 revision 且判据面一致时，仅非 CAS 账目状态（preview 运行地址/端口、任务进度、项目名）变化改为 accepted 并让内容落地，revision 不推不退 - 判据面变化仍判 revision-conflict，保留「改了被保护内容却没推 revision」的可观测信号，不吞真实缺陷 - 新增回归用例：同 revision 仅预览状态变化必须被接受；同 revision 资产变化必须仍被拒收 - 变异验证：把判据改回整份 JSON 指纹后，新用例以 expected 'revision-conflict' to be 'accepted' 失败 - 定向验证：projectResourceLiveUpdateModel 17 passed、workspaceLauncherManifestMerge 5 passed、appSurface 413 passed、npm run typecheck exit 0、npm run check:encoding 4399 files passed、git diff --check 干净 - 同步 decision-log 与 pitfalls 记录 CAS 判据面契约与本次取证	2026-09-12 13:30:18 +08:00
lhk229	34616e1631	修复 CI 调试工作区测试 ... 格式化 design runtime 调试命令 为 debug fixture 测试显式开启并清理 debug 环境变量	2026-09-12 05:21:21 +00:00
lhk229	8853e3b48e	完善策划调试入口与顾问态切换 ... 统一策划 Debug 日志、快速推进按钮和快速推进命令的开关。 将做成游戏入口放到顾问阶段条末尾并接入正常运行时切换。 登记策划产物资产并补充工作区调试入口测试与技术文档。	2026-09-12 05:06:48 +00:00
suzmii	349c9d80ce	修复「所有资源」页面缩放读取错误视口 ... 展开态缩放、滚轮、平移和卡片拖动改读 all 专用内存视口 ref 避免复用普通栏目页视口导致按钮按下后倍率被旧状态覆盖 补充所有资源连续缩放 appSurface 回归断言，并同步更新项目决策与踩坑记录	2026-09-12 12:25:27 +08:00
suzmii	3f7e41e466	「所有资源」展开态改回平铺画布：不再为每个栏目渲染标题栏 ... 展开态真实栏目不再渲染栏目标题栏，整个场景只留 all 那一条钉在视口上、带「资源总览」收起入口的标题栏 原因是分带只为有可见资源的栏目生成，空栏目拿不到标题栏矩形后全部回落到世界原点叠成一摞（空项目必现，现场是 7 条） ResourceBookSceneCategoryPlan 新增 titlebar 字段，渲染层按它决定是否产出标题栏节点 分带去掉标题栏横带的高度预留与矩形换算，删除 RESOURCE_BOOK_ALL_BAND_TITLE_HEIGHT 与 resourceBookAllTitlebarRects 拖动写回口径不变（resourceBookAllBandLocalPoint 一行未改），零 CSS 变更 resourceBookLayout.test 与 appSurface 两条「所有资源」用例加反向守卫；变异验证改回旧行为时两条同时红（got 7） decision-log 与 pitfalls 记这次倒因为「缺一路坐标输入时不要静默回落到原点」	2026-09-12 09:38:03 +08:00
suzmii	f11942f357	展开态补回空态提示：复用栏目页同一个 .game-resource-page-empty 与文案，不新增样式 ... - index.tsx：展开态在"可见资源为 0"时渲染 <p class="game-resource-page-empty">没有匹配资源</p>，与栏目页那一条同一条判据口径与同一句文案 - 它挂在既有的画布浮层 host 下（该 host 自身不定位），因此按画本场景根居中，观感与栏目页一致，不需要任何新 CSS - 测试：空项目的「所有资源」用例补三条断言——进入展开态后标题栏是 .is-active[data-resource-book-category="all"]、卡片宿主数为 0、空态文案是「没有匹配资源」（把"复用既有空态、不新增样式"变成可执行判据）	2026-09-11 23:55:36 +08:00
suzmii	9788248d9b	「所有资源」页改走画本场景：与栏目页同一套卡片宿主与几何，并可拖动 ... - 新增 resourceBookShowsAllCategories：把"子画布里的 all"这一态判定收在 resourceBookModel 一处 - resourceBookCategoryCardPresentation：展开态下真实栏目返回 child（卡片仍由各栏目组承载，每张资源只有一个宿主）、all 自己返回 null（只出标题栏与全量计数） - 新增纯函数 buildResourceBookAllLayout：按栏目顺序纵向排"分带"，用各栏目可见资源的 extent 定带宽高；卡片世界坐标 = 栏目内局部坐标 + 带原点 - 新增 resourceBookAllTitlebarRects：分带 → 栏目标题栏矩形，让展开态复用总览态"按矩形钉标题栏"的同一条渲染路径（ResourceBookScene 不需要知道"展开态"这个概念） - 新增 resourceBookAllBandLocalPoint：展开态世界坐标 → 栏目内局部坐标，这是落盘前唯一的换算（减带原点） - buildResourceBookScenePlan：展开态下 all 只出标题栏（钉在视口 + 全量计数），真实栏目按带偏移铺满 child 卡；真实栏目这一支仍按 presentation === child 取卡，"能出卡的判定"只有一处 - buildResourceBookScenePlan：返回总览的淡出改为按"刚离开的那段子画布"判定（exitingCategory 传 all 时覆盖所有栏目），并用带偏移位置淡出，否则返回动画会跳位置 - buildResourceBookScenePlan：「所有资源」组不再接 child / exiting 卡，避免同一张卡在两组里各挂一份（DOM 查询与 FLIP 键撞车） - index.tsx：删掉独立网格页组件、其 host 块与 resourceBookAllResourcesSections memo，展开态整体交给画本场景 - index.tsx：新增内存态 resourceBookAllViewport（不落盘、不进按真实栏目键的 resourceCanvasViewports），滚轮 / 缩放 / 适应 / 平移 / 框选都作用到它 - index.tsx：分带几何按"项目 + 排序 + 可见资源集"冻结（签名 + ref 短路；签名不含 state.token——返回总览时 token 也会变，含它会在淡出期间重算），拖动不重算带高，避免"拖上面一带让后面所有带整体位移" - index.tsx：拖动放开——展开态下每张卡都能拖，section 取 resource.category（栏目页仍只拖当前分页栏目） - index.tsx：提交前用 resourceBookAllBandLocalPoint 把世界坐标减回带原点，写回的仍是同一 mode 同一 sidecar 的同一 section（.agent/workbench/resource-layouts/{dependency,type}.json），没有第二份空间，不改契约与 schema - index.tsx：renderResourceBookCard 去掉 options.draggable：展开态已可拖，这个"只读"开关没有调用方了 - 测试：resourceBookModel.test 钉住展开态 presentation 与"栏目页仍是原判据"；resourceBookLayout.test 退役旧分组函数用例，新增分带几何 / 标题栏矩形 / 减带原点换算 / 展开态计划（含"每张资源只有一个宿主"与按带位置淡出）断言 - 测试：appSurface 两处「所有资源」判据从旧网格宿主改为画本场景（.game-resource-book-scene-card[data-resource-book-category] 与 .is-active[data-resource-book-category="all"]），并断言旧网格容器 / 宿主一个都不再存在	2026-09-11 23:33:08 +08:00
suzmii	28781a420c	补资源总览网格的声明级断言：钉住 width:100% 与 max-width 并存，防止退回单列 ... - 新增用例「keeps the resource overview grid off fit-content so its columns stay responsive」：断言 .game-resource-book-main-grid 同时声明 width: 100% / max-width: 1120px / margin: 0 auto / repeat(auto-fit …)，并同款断言 .game-resource-book-main-heading 的 width: 100% - 取声明体前先剥掉 CSS 注释：本次修复的注释里就写着 width: 100% 等字样，不剥掉会让断言匹配到注释而假绿（删掉真正的声明也照样通过） - 注释里写明这条断言**验不到布局**：AGC 的 vitest 没开 css: true、styles.css 不会被加载、jsdom 也没有布局引擎，gridTemplateColumns 的解析结果与缩略卡列数只能在真机量；真机判据（3 个非 0 轨道 / grid 宽 432→1120 / 8 张缩略卡 top 只有 3 个取值，且需在总览态取样）写在用例注释里 - 变异验证：临时删掉 .game-resource-book-main-grid 的 width: 100% → 用例变红且失败信息打印的是真实声明体（证明注释剥离生效）；还原后 styles.css 逐字节哈希与已提交版本一致，复跑绿灯 - 门禁：npm run typecheck exit 0；npm run check:encoding exit 0（4399 files）；npx vitest run apps/ai-game-creator-shell/tests/appSurface.test.ts 本用例 1 passed	2026-09-11 22:50:01 +08:00
suzmii	1b7261685c	登记素材上传配对的踩坑与覆盖边界：断言打在生产函数上，端到端 UI 未覆盖 ... - `pitfalls.md` 新增「素材上传不要把『上传前读到的 revision』贴到『上传后读到的清单』上」：现象（每次上传都先吃一条拒收提示）、根因（上传本身推进 revision，错配必然发生而非竞态）、处理（上传动作与配对读收进同一个函数，调用方拿不到中间那个 revision，也就没机会贴错）、同类文案坑（`unresolved` 三条进入路径里有两条重读是**成功**的，写成"读取磁盘清单失败"就是误报）、验证与变异，并记录关联文件与提交。 - 覆盖边界（按当下口径写清，防止后人误读）：断言打在生产函数 `uploadProjectAssetFilesAndReadSnapshot` 上 —— 它同时拥有上传与配对读，所以配对语义是真测的；但 AGC 侧**没有**「资源面板上传 → 拒收提示条」的端到端 UI 用例（现有 harness 只有聊天入口的 `/asset.upload`，资源面板 file input 无用例），因此「界面上不再出现拒收提示」是推理结论而非端到端断言，禁止当成端到端覆盖引用。 - 同一条边界同时写进 `projectResourceLiveUpdateModel.test.ts` 用例组头部，随断言一起走，避免只看测试文件的人误读。 - 纯文档 + 测试注释，无功能改动。	2026-09-11 22:19:14 +08:00
suzmii	c3ccae75af	按实测收回 cfd89ba57 顺手加宽的一处测试超时，并写明另一处保留的理由 ... - `prefetches only cards that are actually in view, and still fills the first screen` 的 `}, 30000)` 收回（回到 vitest 默认 5 s）：实测 93 ms，约 54 倍余量，而且真正的时间门是内层 `waitFor` 自带的 1 s。cfd89ba57 那次只是给负载留余量，没有对应的结构性成本 —— 对照 `releases Blob URLs while continuously browsing beyond the cache limit`（79 轮串行读盘、实测 6120 ms、超默认 5 s）那条的预算属结构性必需，保持不动。 - `keeps a visible card cached when later loads push the cache over its limit` 的 `}, 60000)` **保留**并写明理由：它的职责是挂起护栏，必须大于内层 `waitFor` 的 20 s 断言预算，否则内层断言自己的失败信息永远不出现（vitest 会先在测试超时处中止，只剩笼统的 "test timed out"）。用例实测 120 ms，20 s 与 60 s 都不是耗时预期；硬收会让内层预算变成不可达配置，是更差的诊断而不是更紧的门禁。 - 无功能改动。	2026-09-11 22:18:40 +08:00
suzmii	e98066ee7e	驱逐后不再补扫：删掉那条会把可见卡反复重读的自激回路，并如实标注超时预算 ... - 删掉 publishPreview 里"驱逐后立刻补一次可见性扫描"（原 useProjectResourceCardPreviews.ts 的 `if (evictedCount > 0) sweepVisiblePreviews()`）。它原先的注释宣称"递归深度恒为 1、不自激"，该不变量是假的，判据有三条：(1) 触发条件是"本轮驱逐了任意条目"，而第一轮只淘汰视口外条目，那种情况下根本没有可见卡丢状态，补扫却照样把空闲且可见的卡重新入队；(2) 真正驱逐到可见卡时（全表都在视口内且仍超预算，第二轮全表 LRU 回退）补扫把刚被驱逐的卡重新入队 → 读回来又超预算 → 再驱逐 → 再补扫，每个周期跨一次异步读取，是不收敛的回路；(3) 那种回读换不来稳定结果，读回的卡立刻被下一轮 LRU 淘汰（第二轮回退是全表 LRU，刚读回的卡恰好最新），只在可见集合里轮转。因此正确反应是接受这次有界淘汰（由「全可见且超预算时仍必须淘汰」钉住），而不是反复重读；代码注释按这三条重写，不留误导后人的陈述。 - 顺带删掉只为那段补扫存在的 `evictedCount`（否则是死变量）。 - 断言：新增 useProjectResourceCardPreviews.test.ts「settles instead of re-reading evicted visible cards forever」——全部登记且都在视口内（第一轮无从下手），断言读取次数在观察窗口内不再增长、且缓存稳定在上限。 - 变异验证（提交前已跑）：把补扫加回去 → 该用例**不是断言变红而是 worker 被撑爆**（`ERR_WORKER_OUT_OF_MEMORY`，约 74 秒后终止），即回路真的不收敛；还原后复跑 32 passed，该用例 2.1s 通过。 - 超时预算改为"标注并给出实测依据"，不再用放宽时间门吸收负载代价：`releases Blob URLs while continuously browsing beyond the cache limit` 的 `}, 30000)` 保留，并在用例前写明理由 —— 它逐个 waitFor 等 79 张卡串行读完，轮数由条目上限 48→72 机械地从 55 涨到 79（+44%），实测 6120 ms，已超 vitest 默认 5s，属结构性必需。同一提交里的 `waitFor({ timeout: 30000 })`（由 20000 顺手放大）按实测**回到 20000** 并写明依据（该用例实测 124 ms，约 160 倍余量）。 - 门禁：useProjectResourceCardPreviews 32 passed。	2026-09-11 22:02:31 +08:00
suzmii	b12b0998d0	分类改动不再丢弃已落盘的画布坐标：分区不一致时归并到资源当前分类并保留 x / y ... - 原缺陷（3082c3e85 的连带副作用）：`kind:"UI"` 的资产投影分类由「待归类」修到「UI 交互」后，它们落盘的坐标 section 仍是现行栏目值 `unclassified`，于是 resolveResourceCanvasSection 走「现行栏目值 != 资源当前分类 ⇒ null」直接判丢弃，8 条用户手摆的坐标没能跟过来、被自动排布重算。 - resourceCanvasSectionMapping.ts：现行栏目值改为返回**资源当前分类**（"这张卡属于哪一栏"的唯一真源本来就是 resource.category，协调时也按它分组），与旧栏目归并支路同一条语义 —— 只改写 section，x / y / manuallyPlaced 原样保留。判据：坐标是栏目内局部坐标（reconcileResourceCanvasLayout 先按 section 分组再算栏目带原点），所以换栏目保留 x / y 得到的正是"这张卡在新栏目里的同一个槽位"；而"丢弃 + 自动重排"会连 manuallyPlaced 一起抹掉，是用户可见的损失。 - 判断与理由：**保坐标重写 section 可行**。同一函数对更难的旧栏目 case（旧 `art` 可能归并到 4 个不同栏目）已经在做同样的事，对 `unclassified → ui-interaction` 反而更窄；拒绝它是自相矛盾。 - 丢弃口径收窄：resolveResourceCanvasSection 只在**确实无从归并**时返回 null —— 无法识别的分区值，以及旧栏目归并目标集合不含资源当前分类（如旧 `code` 遇到已归为 `document` 的资源）。useProjectResourceCanvasLayout.ts 的 droppedSectionMismatch 文档与读盘统计注释按此更新（用户可见文案未变，它对新口径仍然成立）。 - 断言：resourceCanvasSectionMapping.test.ts 把原「沿用既有行为丢弃该坐标」用例改写为守新契约（归并 + changed=true），并新增 x / y / manuallyPlaced 逐项不变用例；resourceCanvasLayoutModel.test.ts 原「drops a persisted position…」改写为「rewrites … keeping the coordinates」；useProjectResourceCanvasLayout.test.ts 的读盘统计由 normalized 1 / droppedSectionMismatch 1 改为 normalized 2 / droppedSectionMismatch 0，并新增"归并必须连坐标一起保住"的断言，另补一条用例钉住 droppedSectionMismatch 只剩"无从归并"两类来源；appSurface/project-development.suite.ts 的提示文案与 data-* 计数同步，并新增写盘坐标断言。 - 变异验证（提交前已跑）：把 resolveResourceCanvasSection 还原成 `section === resourceCategory ? section : null` → 6 条用例变红（映射 2 条、布局模型 1 条、读盘统计 2 条、appSurface 1 条），还原后复跑 83 passed + appSurface 该条 passed。 - 门禁：resourceCanvasSectionMapping 9 passed、resourceCanvasLayoutModel 47 passed、useProjectResourceCanvasLayout 27 passed。	2026-09-11 21:48:43 +08:00
suzmii	006e9cc2f3	素材上传不再每次触发一次拒收提示：上传与清单配对读放进同一个函数 ... - 原缺陷：上传路径在上传**前**读 get_local_game_project_revision，上传完把那个**旧 revision** 交给 reloadManifestAfterAssetCommand；后者重新读盘拿**新清单**再打上旧 revision。上传本身会推进项目 revision（Rust advance_agent_runtime_project_revision_locked），于是这一对是撕裂的，「同 revision 不同指纹」被 projectResourceLiveUpdateModel 判成 revision-conflict —— 用户每上传一次素材就先看到一条「资源清单更新被拒收…」。 - projectResourceLiveUpdateModel.ts 新增 uploadProjectAssetFilesAndReadSnapshot：上传动作与"配对读"由同一个函数拥有，配对读复用既有 rereadAuthoritativeProjectManifestSnapshot（同一次读里配对 revision + 清单，并再读一次 revision 确认没被写盘插队）。调用方拿不到中间那个 revision，也就没有机会把它贴错。 - index.tsx 的 uploadResourcePanelFiles 改用它，删掉上传前那次 revision 读取与旧 revision 的传递。 - 附带文案误报：describeProjectManifestMergeRejection 的 unresolved 文案由「重新读取磁盘清单失败，请重新打开项目」改为「未能按磁盘清单重新对齐，请重新打开项目」。unresolved 有三条进入路径，其中两条**重读是成功的**（读到的一对比手上旧、或读到的是撕裂的一对），写成"读盘失败"是误报；新文案对所有路径都成立。WorkspaceLauncher.tsx 在"读到了但不采用"那一支补注释说明 stage 不是读失败。 - 断言：projectResourceLiveUpdateModel.test.ts 新增「素材上传后的清单快照必须配对」——假后端在上传时推进 revision，断言 merge 判 accepted 且 projectManifestMergeRejectionDecision 为 null（即"上传一次不产生拒收提示"），并附一条对照钉子显式写出旧形状、断言它必被判 revision-conflict；另新增 unresolved 文案不得包含"读取磁盘清单失败"的用例。 - 变异验证（提交前已跑）：把 uploadProjectAssetFilesAndReadSnapshot 还原成"上传前读 revision + 上传后读清单"→ 配对用例变红（并给出 revision-conflict 的失败信息），还原后复跑 15 passed。 - 门禁：projectResourceLiveUpdateModel 15 passed、workspaceLauncherManifestMerge 5 passed。	2026-09-11 21:33:54 +08:00
suzmii	09ed7b099b	视图切换取消排队预取在生产路径上真正生效：视图标识改为必填 ... - 原缺陷：预览 Hook 的预取作用域 key 缺省退化为"被喂进来的资源集合签名"，而宿主按设计要求恒传**全量投影**（传全量才不会让总览里其它栏目只剩栏目标题栏），换栏目/换视图一字不改 ⇒ key 不变 ⇒ 取消上一视图排队预取的 effect 永不执行，"同级裁决"一并退化为 no-op。已有用例用"改 resources"模拟切视图，测的是生产不存在的调用方形状。 - resourceCanvasController.ts 新增 createResourceCanvasPrefetchScopeKey({ view, target, mode })：由视图身份（main / child:<栏目>）加排序模式算出标识。 - index.tsx 在资源画布处显式算出该标识并传给预览 Hook（栏目取 resourceBookState.view / resourceBookState.category，排序取 sortMode）。 - useProjectResourceCardPreviews.ts 把 prefetchScopeKey 由可选改为**必填**并删掉那段兜底：它能"看起来还在工作"，正是它掩盖了漏接线；现在漏传是类型错误而不是静默少取消一次。 - 断言：resourceCanvasController.test.ts 新增标识派生两组用例（换栏目/换视图/换排序模式必须变，同一视图必须稳定）；useProjectResourceCardPreviews.test.ts 改写两条既有切视图用例为生产形状（resources 恒为全量、只改视图标识与 eagerResources），并在用例内前置断言"换栏目必须换标识"；其余既有用例经用例侧包装补齐标识，形状与生产一致，断言一条未放宽。 - 变异验证（提交前已跑）：把 createResourceCanvasPrefetchScopeKey 的栏目分量去掉（只留 view + mode）→ 3 条用例变红（标识派生 / 取消上一视图排队预取 / 取消后重新可见再入队），还原后复跑 34 passed。 - 门禁：`npx vitest run` 上述两文件 34 passed；typecheck 见随后整轮。	2026-09-11 21:31:30 +08:00
suzmii	4175d82fa1	工具条「引用」不再渲染成「@ @引用」：@ 只留图标，文案去掉重复的 @ ... - index.tsx 选中工具条的引用按钮：title 由「@引用」改为「引用」，可见文案 <span>@引用</span> 改为 <span>引用</span>。图标 AtSign 本身就是 `@`，文案再写一次就渲染成「@ @引用」。 - label={`引用资源 ${selectedResource.label}`} 保持不变：无障碍名仍要能读出「引用资源 <素材名>」，本次只去掉可见文案与 title 里的 `@`。 - 断言（appSurface/project-development.suite.ts）：静态形状用例改判 title="引用" / <span>引用</span>，并新增 not.toContain('@引用') 反向守卫；键盘通路用例改判 title === '引用'、可见标签 .genarrative-image-canvas__chrome-button-label 文本为「引用」，并新增 aria-label === '引用资源 hero.png'，钉住无障碍名没有被一起去掉。 - 变异验证（提交前已跑）：把 index.tsx 的 title 与可见文案一起改回「@引用」→ appSurface 两条用例变红（资源卡的 @ 引用入口只留在选中工具条里 / 工具条里的「引用」用键盘也能插进聊天输入框），还原后复跑 412 passed。 - 门禁：`npx vitest run apps/ai-game-creator-shell/tests/appSurface.test.ts` 412 passed（改动前后同一时刻对照，均为 412 passed）。	2026-09-11 21:25:14 +08:00
suzmii	87968e3be3	布局落盘 / 读盘失败不再吞掉原因：脱敏后留一行日志 ... - 两处 .catch(() => {…}) 没有 message 参数，失败原因被整个吞掉：用户只看到「布局保存失败」「布局读取失败」，排障端也拿不到为什么（revision 越界 / IPC 拒绝 / 权限）； - 写回失败（update_local_project_resource_canvas_layout 的 .catch）与读盘失败（read_local_project_resource_canvas_layout 的 .catch）都补上 error 参数，并落一行 console.warn； - 新增 describeResourceCanvasLayoutFailure：把 error.message 压成一行、截断 400 字，并复用 errorReporting 的 normalizeDiagnosticText 脱敏（路径 / token / URL / 长 id 打码）； - errorReporting 的 normalizeDiagnosticText 改为导出：脱敏口径只留一份，业务文件不再各写一套正则； - 用户可见文案一字不改（LayoutNotice 联合类型与既有四条用例的断言原样保留），原因只进日志；日志由客户端已装的 webview→application.log 桥带进诊断日志； - 新增两条用例：写回失败必须留下原因（并断言可见文案仍是「布局保存失败，已恢复上次布局」）、IPC 拒绝且原因里带本机绝对路径与 token 时必须脱敏成 <path> 且压成一行； - 变异验证：把写回那处改回吞掉原因 → 写回用例红灯；把读盘那处改回吞掉原因 → 脱敏用例红灯（各自只红对应一条，既有 24 条全绿）。	2026-09-11 21:00:16 +08:00
suzmii	3a4f95d7ca	Merge remote-tracking branch 'origin/master' into feat/agc-canvas-resource-workbench-v3 ... # Conflicts: # apps/ai-game-creator-shell/src/App.tsx	2026-09-11 20:56:14 +08:00
suzmii	2ea3bcbb07	驱逐改为可见性优先，条目上限 48→72：图片不再自己消失又回来 ... 用户报「图片会自己消失然后重新加载」。根因是**淘汰完全按 LRU 插入顺序、且完全不看"是否仍然可见"**：缓存条目顺序是「最近一次被请求」的顺序，而停在屏幕上不动的卡片不会产生新的请求 —— 于是恰恰是用户正看着的那几张排在队首被首选淘汰，`disposeCachedPreview` 释放 Blob 后图片凭空消失，再被兜底扫描重新读回来，表现为闪烁。上一轮「驱逐后补一次可见性复核」只是把"掉了不回来"变成"掉了再加载"，是治标。 - `projectResourceCardPreviewEvictionIdentities` 新增 `visibleIdentities` 参数，淘汰改两轮：**第一轮只淘汰视口外的条目**（可见卡一律跳过）；**第二轮才回退** —— 只有"剩余条目全部仍在视口内且依旧超预算"时才按全表 LRU 淘汰。回退不可省略，否则"可见即永不淘汰"会造成无界内存，该回退由用例钉住。 - `useProjectResourceCardPreviews` 在淘汰前按几何算出可见集合（复用既有的视口档位判据 `viewportBandOfElement <= 1`，经 ref 转发生效，避免定义顺序耦合）。 - `PROJECT_RESOURCE_CARD_PREVIEW_CACHE_LIMIT` 由 `48` 提到 `72`。依据是真机实测：该项目「UI 交互」栏目有 **51 张**可预览卡，而原上限 48 **小于一栏的规模** ⇒ 滚满该栏目必然驱逐；取 72 覆盖 51 张并留约 40% 余量，按真机单张均值 591 KB 外推 ≈ **43 MiB**，**仍在既有 64 MiB 字节预算之内**（真机 52 张 blob 合计 29.32 MiB，仅用掉 45.8%）。**字节预算未动，也不是把上限放大到任意大。** 断言（`tests/useProjectResourceCardPreviews.test.ts`）： 1. 「可见卡不得成为首选淘汰对象」：最老的 3 张都在屏幕上时，淘汰必须跳过它们、改淘汰视口外的第 4 张；对照用例同时钉住"不给可见信息时退化为纯 LRU"； 2. 「全可见且超预算时仍必须淘汰」（防无界内存），条目上限与字节上限两侧各一条； 3. 「51 张整栏零淘汰」：真机栏目规模下 `projectResourceCardPreviewEvictionIdentities` 必须返回空数组，且断言字节侧余量。 另把原先守旧行为的用例改写为守新契约：可见卡被后续加载挤出缓存上限时**必须仍保持 `loaded` 且不产生第二次读取**（不再依赖"掉了再补读"）。既有用例一条未放宽。 变异验证： - 去掉可见性过滤（第一轮不再跳过可见卡）→ 断言 1 所属用例立即失败（`expected [ [ …(2) ], [ …(2) ] ] to have a length of 1 but got 2`，即目标卡被驱逐并重读）； - 去掉"全可见时回退全表 LRU"→ 断言 2 立即失败（`expected [] to deeply equal [ 'item-0' ]`，即缓存无界）。 验证：定向 `useProjectResourceCardPreviews` 31 passed；typecheck exit 0；prettier 干净。（全量 AGC 子集的前后对照见随后的回报。）	2026-09-11 20:39:59 +08:00
suzmii	0ef1a4ec15	接线资源筛选浮层并把资源卡旁两个浮层改成互斥 ... - index.tsx：新增 resourceFilterOpen 与 resourceFilterTags 两个 state，区域不新增 state（唯一新增的筛选相关 state 是已选标签） - index.tsx：可见资源由内联关键词过滤改为调用 filterCanvasResources，维度为区域 / 标签 / 关键词；区域由 resourceBookState 派生（不在分页栏目里时为「全部区域」），因此用户用滚轮 / 总览卡片 / 下一页换栏目时区域自动跟随，无需双向同步 - index.tsx：标签库按「区域 + 关键词」派生并故意不含已选标签——若拿已按标签收窄的集合派生，选了一个标签后列表只剩该标签，用户再也选不出第二个标签，AND 多选会形同废掉 - index.tsx：Dock 上紧邻搜索按钮新增筛选按钮，复用 game-resource-book-zoom-button 与 is-active 口径；两个浮层共用同一个右下角锚点，因此开筛选即收起搜索、开搜索即收起筛选 - index.tsx：挂载 ResourceFilterPanel，区域变更转交既有 openResourceBookChild（与栏目切换同一条路径），关键词与搜索浮层共用同一份 searchText - resourceCanvasFilterModel.ts：resourceFilterIsActive 只看关键词与标签、不含区域——区域就是画布当前栏目，用户换栏时它照样在变，算进高亮会让按钮在「只是换了一栏看」时也常亮 - 新增 resourceFloatingPanelModel.ts 与其测试：资源卡旁「快速编辑」与「生成动画」的互斥规则收在一处并被两个开启入口共用，修掉「先开生成动画再点快速编辑两个浮层并存」的缺口；关闭仍只关自己，生成收尾不会吞掉用户刚打开的另一个面板 - 断言：新增 5 条互斥用例（含两个方向各自一条与来回点击序列），加上既有筛选用例；变异验证实测——把互斥模型的 closed 写成恒为 quick-edit（等价只修一个方向）→ 4 failed，还原后 5 passed	2026-09-11 20:29:45 +08:00
suzmii	cfd89ba570	③ 驱逐用例抗并发负载：一次灌满替代 48 轮逐张等待 ... - 现象：驱逐用例逐张 waitFor 48 张（3 个读取槽 + 48 轮 act/轮询）在同树多个写者并发跑测试时，会把用例 5s 超时耗光（Test timed out in 5000ms），红的是超时不是断言； - 改法：48 张一次性入队，只等"读取都已发出"（read 次数 ≥ 49），不再逐张断言 48 个卡的状态； - 原因说明：驱逐本来就会连锁（目标卡被驱逐 → 补扫描重读 → 再挤掉一张未被观察的填充卡），逐张断言会在链条行进中读到 undefined，红的是时序不是契约； - 核心断言一条不动：目标卡必须被重新请求（读次数 1 → 2）且最终回到 loaded；本用例超时放宽到 60s、内部 waitFor 20s； - 验证：改动前后各连跑 6 轮 + 4 路并发同时跑两个用例文件，全绿。	2026-09-11 20:23:10 +08:00
suzmii	a0d1fca30a	拒收提示不再被"进入项目"那一次清除吃掉：只在真的换项目时清 ... - 现象：打开项目这一提交里刚落下的拒收提示，会被同一次 [projectPath] 变化的清除 effect 清掉 —— 资产命令在项目刚打开后马上推送清单快照正是主场景，提示于是时有时无； - 改法：新增 manifestMergeNoticeScopeRef 记录上一次观察到的项目路径，undefined → 路径（首次进入）时不清；只有真正的 A→B 换项目或关掉项目才清提示与在飞标记； - 断言：新增"换项目必须清掉上一个项目的拒收提示"用例（确定性反向钉子，防止把清除整个删掉）； - 用例加固：拒收提示的三处断言改为每轮重新查询 DOM（阶段切换时 React 可能替换节点，抓着旧引用会在负载下瞬时红），异步恢复等待放宽到 4s； - 说明：这次加固的起因是一次偶发红（expected undefined to be 'revision-conflict'）。事后在改动前后各跑 18/28 轮未能复现"去掉护栏必红"，所以此处不声称护栏就是那次偶发的成因；护栏本身修的是同一提交窗口被清除这一确定性缺陷，长时压测（4 路并发同时跑两个用例文件）全绿。	2026-09-11 20:22:52 +08:00
suzmii	e765c9f8a6	资源卡工具条接通「生成动画」：只放行真能跑通的角色图派生 ... - resourceCanvasToolbarModel：只有在「已登记的栅格角色图」上放行 character-animation （非角色 / 未登记为正式素材 / 非栅格三类都不放行；Rust 侧角色动画要解码源图取宽高，SVG 必失败）；其余动作仍按 opt-in 不渲染，并写明不做它们各自的阻塞证据。 - index.tsx：把源解析与 revision 缓存抽成 resolveResourceDeriveSource，快速编辑与生成动画共用，避免同一个源在两条链路上得到两份 manifest 视图；新增生成动画的源/浮层状态、请求身份（与快速编辑同一套「提示词变了才重铸」口径）与打开/提交/关闭时机。 - 面板复用共享 ImageCanvasCharacterAnimationPanelView，参数入口显式关闭（比例/时长/清晰度与模型由客户端 Rust 固定为 same/720p/32 帧/4 秒/seedance2.0-fast，改它不改变请求）；档位常量与 Rust 常量同值，泥点价按同一算法算，避免按钮上出现与实际计费不符的数字。 - 「改造」(redraw) 不再另起入口：其语义由既有「快速编辑」承担，接独立按钮只是同链路重复入口。 - 断言改写（四不写）：角色资源那条由「只放行快速编辑与下载」改写为「放行生成动画」，并新增三条反向守卫（非角色图片 / 角色图未登记 / 非栅格角色图均不放行）。 - 端到端新增「从角色资源卡生成动画」：断言 editKind/generationMode/prompt/assetName/sourceAssetId 与泥点价档位，并断言参数入口不存在。	2026-09-11 20:08:22 +08:00
suzmii	3245739385	前端改成直接替换：不切版本、尺寸规格降级为提示 ... - 口径跟进：前端从「版本级替换」改成「直接替换」——成功后**不再切换版本**（没有新版本可切），只重读 manifest；「当前使用」高亮会随新绑定自动移动（改的仍是同一个源版本） - resourceVersionReplacementModel：兼容性判据的展示口径收窄为「硬门禁只有分类与类型」，尺寸规格不再产生禁用原因，改为非阻断提示「格式与源素材不同」；新增 resourceReplacementWarning 与 resourceReplacementAssetHints；类型去掉 parentVersionId、加上 warning - index.tsx：confirmResourceVersionReplacement 去掉 selectActiveVersion 调用，失败仍保留弹窗与选择并显示原因（不切版本、不动高亮、不提示成功）；新增 hint 映射并传给弹窗 - ImageCanvasProjectAssetPickerDialog：以可选 prop assetHints 扩展（默认 undefined → 不渲染），用于展示"可选但有差异"的提示；与 assetBlockedReasons 的区别是提示不改变可点性，默认行为仍逐字不变 - 失败文案补一条：版本写入边界拒绝（「不可修改、删除或重排」）翻成「替换被项目版本写入边界拒绝，请刷新项目后重试」，不让用户看到内部口径原文 - 用例改造：模型 9 条（尺寸规格不再禁用、提示表只收可选候选、提示不覆盖真正的不兼容原因、边界拒绝文案）、真链路 4 条（候选弹窗禁用硬门禁项 + 格式提示仍可选、写入载荷精确、成功后不切版本且不重载预览、失败保留弹窗且不重读 manifest、候选读取失败不弹空壳弹窗） - 验证：两个前端用例文件 13 passed / 0 failed；npm run ai-game-creator-shell:typecheck（含 check-config）exit 0	2026-09-11 20:03:44 +08:00
suzmii	149c0b591a	冷启动首屏：热预取过可见性判据，相交卡按视口内 / 余量圈两档放行 ... - A 热预取不再按投影顺序盲取前 N：eager effect 现在只预取已登记且几何上可见（档 0 / 档 1）的卡，按两档顺序入队，eagerPreviewLimit 仍是硬上限； - A 保留首屏兜底：一张可见卡都判不出来时（卡片尚未注册 / 容器还没布局出尺寸）退回原顺序预取，绝不把首屏热预取削成 0； - B 新增 viewportBandOfElement：0 = 视口内、1 = 只落在 rootMargin(160px) 圈里、2 = 放行范围外（含量不出尺寸）；门禁与放行顺序共用同一套几何口径； - B 新增 requestPreviewCardsByViewportBand：先档 0 再档 1，只改入队顺序、不改总量（档 1 在同一次调用里一样放行），3 槽 / 48 项 / 64 MiB 合同不动； - B 兜底扫描改用两档放行（门禁语义不变：只有档 0 / 档 1 才放行），不会退化成"只补第一档"； - B observer 回调一次报来十几二十张相交卡时，只把"视口内"的插到前面，其余一张不丢，既有"相交即放行"语义不变； - 新增用例：视口外卡片不得进入热预取（改前首屏 distinct 读 20 张、含 8 张视口外；改后 12 张全部可见）；相交一次性放行时先视口内后余量圈且总量不变（6 张全放行）； - 变异验证：整份还原成改前版本 → 两条用例分别红（20 vs 12、放行顺序反了）；只把 observer 回调改回单趟 → 只有两档那条红。	2026-09-11 19:58:09 +08:00
suzmii	1c43f2c2b2	新增资源筛选浮层组件与右下角锚点样式 ... - ResourceFilterPanel.tsx：AGC 侧筛选浮层，领域规则留在这一层——区域取值就是画布当前栏目（只把选择交回宿主，面板自己不改栏目也不另存区域），关键词与画布搜索浮层共用同一份状态，标签走 AND 语义；共享层只提供浮层外壳与表单原语 - ResourceFilterPanel.tsx：不渲染「状态」字段，并按注释写明理由——manifest 资产与资源投影都没有状态事实源，唯二候选（任务状态、附件导入状态）在投影里已被上游过滤，硬用即恒单值假筛选 - ResourceFilterPanel.tsx：「点外部 / Esc 关闭」按既有搜索浮层口径在 document 上同时接管 click 与 Escape，点触发按钮不被判成外部；不复用美术画布那个 dismiss hook，因为它判定焦点是否在浮层里用的是自己的 portal-menu 类，本浮层不匹配会导致 Esc 关闭后焦点不回触发按钮 - ResourceFilterPanel.tsx：区域下拉由 RESOURCE_FILTER_REGION_OPTIONS 派生，显示名与 @ 面板同一份口径；标签 chip 用既有 platform-category-chip 类，选中态不另造样式 - resourceCanvasFilterModel.ts：筛选生效判据 resourceFilterIsActive 落在模型层，供宿主给 Dock 按钮打高亮（条件不随浮层收起一起消失）；纯空白关键词不计入，避免按钮为一次空输入长期高亮 - styles.css：新增 .game-resource-filter-panel 右下角锚点（与搜索浮层同一 bottom / z-index 口径，向上展开），定位留在宿主，共享浮层外壳保持不自带 position - tests/resourceFilterPanel.test.tsx 与 tests/resourceCanvasFilterModel.test.ts：覆盖三字段渲染且无「状态」占位、区域选项取值与中文显示名逐个钉住、关键词回显与回调、区域切换只回调、标签受控多选与 aria-pressed、空标签库隐藏该字段、关闭键 / Escape / 点外部 / 点触发按钮四种关闭口径、Escape 后焦点回触发按钮、筛选生效判据	2026-09-11 19:55:22 +08:00
suzmii	70256c7585	新增资源画布筛选纯函数与三条变异验证用例 ... - resourceCanvasFilterModel.ts：把画布筛选收成一处纯函数——区域判据做恒等比较表达「只筛当前区域」，「全部区域」放行全量；标签复用共享 assetTagsMatchSelection（AND 语义）；关键词沿用既有搜索的名称 / 路径 / 媒体类型 / 任务名四字段与大小写不敏感口径，使搜索浮层与筛选面板对同一关键词给出同一结果 - resourceCanvasFilterModel.ts：区域选项由 PROJECT_RESOURCE_CANVAS_SECTIONS 派生，中文显示名复用 @ 面板那份唯一权威口径 resourceReferenceCategoryLabel，不为「项目版本」以外的栏目另写译名表 - resourceCanvasFilterModel.ts：标签库只统计当前区域内的资源，切换区域后不残留只属于别的区域的标签 - tests/resourceCanvasFilterModel.test.ts：覆盖区域选项顺序与显示名、空筛选不重排、区域恒等比较、关键词四字段与空白归一、标签 AND 语义、无标签事实源资源的口径、三维度叠加、标签库计数与排序 - 三条变异验证实测均变红后还原：把区域判据改成恒 true → 4 failed；去掉关键词判据 → 3 failed；去掉标签判据 → 4 failed；还原后 13 passed	2026-09-11 19:50:19 +08:00
suzmii	1be5218aeb	kind 别名表查表加 Object.hasOwn 守卫：原型键不再被误当成别名 ... - `canonicalGameCreationAppAssetKind`（TS）此前用对象字面量直接下标查别名表：`kind` 是外部输入，`constructor` / `__proto__` / `toString` / `valueOf` / `hasOwnProperty` 会命中 `Object.prototype` 上的成员，被当成 canonical kind 返回（`__proto__` 返回原型对象本身）；Rust 侧是 `match` 字面量，只会落 `image` 兜底，同一输入两侧分叉 - 改用 `Object.hasOwn(GAME_CREATION_APP_LEGACY_ASSET_KINDS, normalized)` 先确认命中的是表自己的键，再取值；`noUncheckedIndexedAccess` 下仍保留一次取值后的 truthy 判定 - 补断言（无断言的边界修法下次会被改回去）：`gameCreationApp.test.ts` 对 `constructor` / `__proto__` / `toString` / `valueOf` / `hasOwnProperty` 逐条断言 `canonicalGameCreationAppAssetKind` 落 `image`、`gameCreationAppAssetCategoryForKind` 落 `unclassified` - 跨语言对照：`assetKindCanonicalMapping.test.ts` 的 `decided` 表新增 `constructor` 与 `__proto__` 两行（`image` / `unclassified`），与 TS 同一份口径对照 - Rust 侧同步断言：`game_creation_app.rs` 的 `asset_category_mapping_covers_every_canonical_kind` 补 `constructor` / `__proto__` / `toString` / `valueOf` 必须落 `image` 与 `unclassified`，把「两侧一致」这件事写进两侧各自的用例 - 边界范围：只收口「原型成员被当成别名」这一种极端输入；`kind` 的正常词表、大小写口径与读时自愈规则不变，manifest 字段构成与顺序不变	2026-09-11 19:44:04 +08:00
suzmii	d4e7b8bbaf	队列满时被吞掉的按需请求留痕：点播放没反应不再是静默 ... - requestPreview 在队列达上限且没有可顶掉的可见性预取时，按需请求（detail/play）此前直接 return，用户在可见卡上点播放没有任何请求与痕迹； - 新增 droppedRequestsRef：单调计数 + 最近一条明细（identity / reason / queueLength / at），并补一条 [preview-queue] console.warn； - previewQueueSnapshot 暴露 droppedRequestCount 与 lastDroppedRequest，排障与用例可直接观测； - 可见性预取撞上限属于设计内背压（下一轮兜底扫描会补），不计入丢弃口径； - 队列上限、3 个并发槽、优先级顺序（play > detail > visible）全部不动； - 新增用例：压满 96 条 detail 后 play 被丢弃必须留下标记，且 visible 背压不计数。	2026-09-11 19:35:25 +08:00
suzmii	56a8c2c32c	驱逐仍可见的卡之后补一次可见性复核：图片不再凭空消失 ... - publishPreview 记录本轮驱逐条数，驱逐发生后在 previewsRef 落盘之后补一次 sweepVisiblePreviews； - 被驱逐的 identity 状态正好回到 undefined，而 sweepVisiblePreviews 只对 undefined 的卡重新入队，此前只差不这一次调用； - 调用点必须在 previewsRef.current = next 之后，否则扫描看到被驱逐卡仍是 loaded 而不做任何事； - 注释写明重入有界：重新入队走 publishPreview({status:'loading'})，不进 loaded/failed 驱逐分支，递归深度恒为 1； - 只在真的发生驱逐时补扫，普通 loading/loaded 发布不增加扫描开销； - 新增用例：灌满 48 张缓存把仍可见的目标卡挤出（LRU 不看可见性），断言该卡被重新请求读成 loaded。	2026-09-11 19:28:47 +08:00