3433 Commits

This Branch

This Branch

All Branches

Author	SHA1	Message	Date
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	fcaf1a8e91	补坑位记录：新增文件后必须重跑完整 typecheck ... - pitfalls.md 新增 2026-09-11 条目，记 lint-staged 只做 eslint 与 prettier、不做 tsc，因此 pre-commit 绿不等于类型正确 - 按体例写现象（第 113 行 TS2322、ref 元素类型不匹配）、原因（typecheck 是在新增该文件之前跑的）、处理（每新增或改名源文件后重跑完整 typecheck，门禁顺序固定为改完 → 全量 typecheck → 定向测试 → 其余门禁） - 验证写明：修复后 exit 0、修复前 exit 2，而定向测试修复前后都是 22 passed，说明测试通过推不出类型正确；并推广到未使用 import、类型层 props 不匹配、只有 tsc 才发现的 .tsx 泛型推断失败 - 该文件原本结尾没有换行符，追加后上一行必须重写为带换行，因此 diff 记为 11 增 1 删；已逐字核对被删行原样出现在新增行中，实际无内容丢失	2026-09-11 20:39:19 +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	d3b341948a	文档收口：工具条动作放行口径、生成动画接通与「改造 = 快速编辑」 ... - pitfalls.md：把「资源画布工具条的『改造』『角色动画』按钮点了没反应」按四不写改成已收口状态（不再写"尚未修"）：生成动画已接真实链路 + 参数入口为什么关、改造由快速编辑承担、其余 5 个动作逐项不做的证据；补记两条连带经验（复用共享面板时要逐个确认"可选参数在该宿主是否影响请求"；面板的泥点价就是提交按钮本身，档位常量必须与后端固定值一致）。 - decision-log.md：新增 2026-09-11 条目，记录四条决策（接通生成动画的门禁与链路、复用共享动画面板并关参数入口、改造认定为快速编辑、其余动作不接的逐项证据）与三条变异验证结果。 - AGC 技术方案「操作边界」：补 4 条当前口径（动作集合按"放进来就必须真能跑通"放行、生成动画的面板与固定档位、改造=快速编辑、未接通动作各自缺什么）。 - Issue #309 与 PR #316 正文未改：远程写操作需用户确认，decision-log 里已记录这两处需要怎么改。	2026-09-11 20:09:51 +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	4be88f177f	角色动画面板新增可选参数入口开关：AGC 固定档位不再渲染假控件 ... - 新增可选 prop showParameters（默认 true）：为 false 时不渲染「比例 / 时长 / 清晰度」 入口按钮与对应浮层菜单，默认值等于网页端美术画布今天的渲染，行为逐字不变。 - 关闭理由写进注释：宿主若不能把这三个值送进请求，渲染出来就是点了不生效的假控件。 - 单独成一个提交，便于共享面板被其它改动覆盖时单独摘取或回退。	2026-09-11 20:07:38 +08:00
suzmii	5f03f050ad	修正筛选浮层 panelRef 的元素类型，补回漏跑的类型检查 ... - ResourceFilterPanel.tsx：panelRef 由 HTMLElement 改为 HTMLDivElement。该 ref 挂在外层 div 上，React 的 Ref<HTMLDivElement> 不接受 RefObject<HTMLElement>，此前 typecheck 报 TS2322 - 漏跑原因：提交浮层组件那一笔时，我是在新增该文件之前跑的 typecheck，之后只跑了定向测试与 pre-commit 的 lint-staged（它对暂存文件只做 eslint 与 prettier，不做 tsc），因此这个类型错误当时没有被拦住；补跑 ai-game-creator-shell:typecheck 后修复 - 行为不变：只收窄 ref 的静态类型，关闭口径与渲染结构都不动；定向测试复跑 22 passed	2026-09-11 20:07:04 +08:00
suzmii	86d55a1aba	补资源筛选浮层的 PRD 条款与共享决策记录 ... - docs/prd/...PRD-2026-07-20.md：§5.2.4 新增资源筛选条款——按需弹出的独立浮层取代常驻筛选条（常驻条已移除、不回归）、固定三个字段（查找素材 / 所在区域 / 自定义标签）与各自口径、不提供「状态」字段及其理由、区域既是筛选维度也是画布当前栏目且必须是同一份状态、两种区域语义共用一份过滤实现、浮层与搜索浮层同锚点不得同时展开、关闭与高亮口径、筛选后空态要求 - docs/project-memory/shared-memory/decision-log.md：新增 2026-09-11 决策条目，按体例写背景 / 决策 / 影响范围 / 验证方式 / 关联文档 - decision-log 如实记录：已落地的部分是共享外壳、纯函数与 AGC 侧组件样式（各自独立提交），而 index.tsx 的 3 处接线因该文件被另一条线占用尚未提交，并写明接线完成后应补记——不把未落地行为写成已实现 - decision-log 记录「状态」字段不做的三条证据链（manifest 资产无 status、资源投影无 status、唯二候选任务状态与附件导入状态在投影里已被上游过滤故恒单值），以及区域用派生而非新增第二份 state、「全部区域」复用既有所有资源分组网格的取舍 - decision-log 记录 PlatformResourceFilterBar 不碰不扩的理由（横向常驻条且被主站参考图弹窗在役使用）与既有断言零放宽、三条变异验证实测结果	2026-09-11 20:04:33 +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	eb6f72ab9d	新增共享筛选浮层外壳 PlatformFilterPanel ... - packages/shared/src/components/PlatformFilterPanel.tsx：新增按需弹出的筛选浮层外壳，只承载通用表现——竖向字段容器、右上角关闭键与 role=dialog 语义；字段名与控件全部由宿主经 children 传入 - 字段排布约定收敛到 PlatformFilterPanelField：字段名在上、控件在下，可用 controlId 把字段名与控件关联；字段名复用既有 PlatformFieldLabel，不另写标签样式 - 不下沉任何领域规则：外壳不知道区域 / 标签 / 状态等概念，不接后端，不算过滤；筛选取值与判据都由宿主持有，因此同一外壳可在不同页面各装一套字段 - 不自带 position：定位与层级由宿主经 className 注入，避免共享层猜宿主布局 - packages/shared/src/components/PlatformFilterPanel.test.tsx：覆盖 dialog 语义与关闭转发、字段逐个渲染且不出现外壳自带的「状态」占位字段、controlId 字段名关联、以及宿主定位类注入且组件不自带 absolute / fixed	2026-09-11 19:43:51 +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
suzmii	f88e6aa5fe	清单快照被拒收不再静默：可见提示 + 强制重读磁盘真相 ... - WorkspaceLauncher：applyManifestSnapshot 拒收分支此前直接 return，改为必须先留痕（console.warn 记 decision/source/两个 revision）再走恢复； - 新增 manifestMergeNotice 状态与提示条，DOM 暴露 data-manifest-merge-decision / -stage / -source / -held-revision / -snapshot-revision 作为排障观察点； - 新增 recoverRejectedManifestSnapshot：重读磁盘 revision + 清单并重建 merge 状态，把被拒快照漏掉的新资源真正带进项目上下文； - 同一项目只允许一条恢复在飞，避免拒收成串到达时打满读取槽； - 重读期间若有更新的快照已被接受，绝不回退 revision（宁可报未解决，不放宽 CAS）； - scope-mismatch 仍只记日志不弹提示：串项目的快照对用户没有可执行语义； - projectResourceLiveUpdateModel：新增拒收判定、三阶段文案与 rereadAuthoritativeProjectManifestSnapshot（两次读 revision 夹一次读清单，撕裂就放弃）； - styles.css：新增 .launcher-manifest-merge-notices 绝对定位提示位，容器不吃点击，与 .game-resource-book-notices 同口径； - 新增 apps/ai-game-creator-shell/tests/workspaceLauncherManifestMerge.test.tsx：拒收可见 + 重读采纳 + 重读失败报未解决 + 不回退 revision + 串项目快照保持静默； - projectResourceLiveUpdateModel.test.ts 追加拒收可见性/重读三读/撕裂放弃/跨项目拒绝/revision 非法/三阶段文案可区分六条断言。	2026-09-11 19:23:25 +08:00
suzmii	ee8e12783e	校准读时重写的文档口径：写回一次 + 丢弃可见，并补一条口径变更决策 ... - decision-log 2026-09-10 那条把「不写迁移脚本、不删除、不重置」改成当前事实：读时会把 legacy 分区（art / code）坐标归并到新分区并写回一次 sidecar（revision +1）；不写迁移脚本、不重置坐标位置；但无法归并的坐标会被跳过（跳过条数在画布提示条上可见）。 - 新增 2026-09-11 decision-log 条目：背景（审计查实「读时原地重写」112 条 + 27%（66 + 16）丢弃与旧文档字面冲突）、决策（用户选 A：保留重写、不静默、改文档）、影响范围、验证方式（含两处变异验证）、关联文档。 - 技术方案【GameAgent资源自由画板与快速编辑】：同一句改成读路径写回一次 + 无法归并的坐标被跳过且可在提示条 / data-resource-canvas-layout-* 上读到。 - PRD【项目开发工作台】第 325 行同一句同样校准（避免权威文档里留着「不写迁移脚本、不删除、不重置」这句会误导排障）。 - 测试用例【AGC资源工作台V3端到端验收】S21 台账那格补上「存量项目第一次打开时读路径也会写回一次、并给一次性提示条」，避免把 revision 从 1 开始误判成异常。 - 行为、sidecar schema（v1）与跨端契约均未改动。	2026-09-11 19:19:51 +08:00
suzmii	e15456ea14	读时丢弃的坐标不再静默：提示条带条数并在 DOM 上分开三类计数 ... - readReport 增加 droppedMissingResource（资源已不在 manifest）/ droppedSectionMismatch（分区与资源分类不匹配）/ dropped（两者之和），判据仍是 normalizeResourceCanvasPosition，未改 resourceCanvasLayoutModel 的丢弃语义。 - 文案补上跳过条数与两类原因：归并与丢弃同时发生时用「另有 N 条坐标无法对齐已跳过（…）」；只有丢弃时用「打开项目时有 N 条坐标无法对齐已跳过（…）」。 - 提示条暴露 data-resource-canvas-layout-normalized / -dropped / -dropped-missing-resource / -dropped-section-mismatch，供排障直接读 DOM；完全没丢时四个值都是 0。 - 读盘触发条件放宽为「有归并或有丢弃」，避免只有丢弃时什么都不提示。 - 断言：读盘统计用例覆盖三种情况分离；文案用例覆盖四形态（含真机 112 / 66 / 16 口径）；appSurface 用例断言四个 data-* 与完整文案。 - 变异验证：把 dropped 计数改成恒 0 → 统计用例、读盘报告用例、提示条用例三处变红；去掉 data-resource-canvas-layout-dropped → 提示条用例变红。	2026-09-11 19:18:12 +08:00
suzmii	18361f8585	读时归并不再静默：打开项目归并旧分区坐标后给一次性提示 ... - useProjectResourceCanvasLayout 新增读盘只读统计 inspectProjectResourceCanvasLayoutRead 与文案 describeProjectResourceCanvasLayoutRead。 - 读盘判定 changed 时写入 readReport（项目作用域身份 + 排序模式 + 旧分区归并条数），判据复用 normalizeResourceCanvasPosition，只统计、不改写回与丢弃语义。 - index.tsx 在既有 game-resource-book-notices 提示层内渲染一次性提示条，复用 .game-resource-live-notice 样式与「知道了」关闭按钮；每个项目只提示一次，切换项目清空。 - 断言：useProjectResourceCanvasLayout.test.ts 覆盖归并时 readReport 与文案、无需归并且不写盘、只补新资源落位的写回不报读时统计；appSurface/project-development.suite.ts 覆盖提示条出现（data-resource-canvas-layout-normalized、可关闭）与无需归并时不出现。 - 变异验证：去掉 setReadReport → 上述读盘统计与提示条用例变红。	2026-09-11 19:14:44 +08:00
suzmii	27be57bf68	修正上一条提交里错位的别名表用例行 ... - 现象：提交 3082c3e85 把两条新增的 `decided` 表行（`'UI'`、`'font'`）插到了 `test.each(decided)` 的实参位置，`test.each` 拿到的是对象而不是回调，原来 7 条 `decided` 用例全部报 `fn2 is not a function` - 成因：pre-commit 的 lint-staged 对**部分暂存**文件做「隐藏未暂存改动 → 跑 prettier → 还原未暂存改动」时会重新落位 hunk，本次两条新增行落错了位置；该文件当时是部分暂存（提交 ① 只暂存了其中 3 个 hunk），因此被波及 - 修法：把两条行移回 `decided` 数组内的正确位置，`test.each(decided)` 恢复成「表 + 单回调」形态 - 本提交只暂存这一个文件（不部分暂存），避开同一成因	2026-09-11 18:57:42 +08:00
suzmii	d9822eca05	同步资源分类口径的文档：读显示 / 写回两个口径、别名表大小写不敏感 ... - PRD 的分类取值段落改为「读显示 / 写回两个口径」：写清跨端同构的两个函数名、Agent 投影不许再透传落盘 `category`、面板保存回传落盘原值、别名表大小写不敏感（`"UI"`、`font`） - 技术方案（AI游戏创作智能体App实施计划）的 manifest `category` 段落同步：`"UI" → ui-interaction`、`font → document`，其余映射不到的 kind 才落 `unclassified`；补上两侧口径函数名 - `pitfalls.md`：把「补别名只影响新登记，不重算 `category`」这条坑更新为已修形态，并写明「同 kind 重登记禁止动 `category`」这条必须保留的不变量；「读时重派生」条目补上两个口径不能混用与跨端必须同构两条 - `pitfalls.md` 新增条目「大写 `UI` / `font` 不在 alias 表 → 8 条真机 UI 资产永远落「待归类」，且自愈救不回」，记录成因链与三层守卫 - `decision-log.md` 新增决策条目：口径拆两半、自愈不下沉到反序列化、别名表大小写不敏感、重登记重派生但不抹掉显式分类，含变异验证与影响范围 - 端到端验收用例文档的 S5 栏目归属补一句：判定「编辑标签后分类有没有被改」必须比 manifest 文件，不能拿自愈后的显示值当落盘值	2026-09-11 18:49:32 +08:00
suzmii	f476eb89e5	同路径重登记：kind 变化时重派生 category，同 kind 时保留落盘分类 ... - `register_local_asset_entry`（`assets.rs`）命中同 `localPath` 的既有资产时，旧实现只覆盖 `kind` / `media_type` / `source`，**从不重算 `category`**：`kind` 变了而 `category` 停在旧值，且陈旧的非 `unclassified` 值会被读侧无条件信任（自愈只在落盘值是 `unclassified` 时才触发），该资产就永远停在错误栏目 - 修法：只在 `existing.kind != kind` 时重派生 `category`；`kind` 未变时刻意不动 `category`——落盘分类是权威值，同 kind 重登记不得抹掉它 - `register_local_asset_records_existing_asset_with_canvas_source` 补上 `category` 断言：首次登记 `kind:"character"` 落 `character`，重登记改成 `kind:"ui"` 后必须变 `ui-interaction`（旧用例只断言 `kind` 与 `source.kind`，正好走更新分支却漏掉 `category`，所以这条错位一直没被抓住） - 新增用例 `register_local_asset_keeps_explicit_category_when_kind_is_unchanged`：显式设成 `audio` 后同 kind 重登记，`category` 与 `tags` 必须原样保留，把「不能无条件重派生」这条不变量钉死 - 新增用例 `register_local_asset_derives_category_from_real_write_side_kinds`：用与现役写入侧逐字一致的字面量（`"UI"` / `"font"`）走真实 `register_local_asset_at`，断言落到 `ui-interaction` / `document`；它属于同一套 `register_local_asset_*` 写 API 的派生行为，因此与上面的更新分支断言放在同一个提交	2026-09-11 18:48:03 +08:00
suzmii	3082c3e854	kind 别名表大小写不敏感并收口 font：堵住 8 条 UI 资产永远落「待归类」 ... - `canonical_game_creation_app_asset_kind`（Rust）与 `canonicalGameCreationAppAssetKind`（TS）改为对 trim 后的小写值查别名表与 canonical 目录，修正「UI 设计资产的现役写入侧写的是大写 `"UI"`」这条真机事实 - 别名表补 `font → document`：字体上传（`ttf / otf / woff / woff2`）登记的 manifest `kind` 就是 `font` - 为什么必须在别名表收口、读时自愈救不回来：`"UI"` 与 `"font"` 的派生结果本身就是 `unclassified`，自愈规则「派生值不是 unclassified 才触发」永不成立；真机 8 条 `kind:"UI"` + `mediaType:"application/json"` + `localPath:"ui/UI 设计 N.json"` 与写入路径逐字段吻合 - 改写 Rust 断言 `game_creation_app_asset_category_for_kind("UI") == Unclassified` → `UiInteraction`，并补 `canonical_...("UI") == "ui-design"` 与 `font == Document`：旧断言把这条 bug 钉成了「期望行为」，新形态才是唯一真源——写入侧真实写出的 kind 必须能落进明确栏目，否则真机资产永远归不了类 - 改写 TS 断言 `gameCreationAppAssetCategoryForKind('UI') == 'unclassified'` → `'ui-interaction'`，理由同上 - `game_creation_app.rs` 里「现役写入侧仍会写出这些非 canonical 值，必须在这里收口」的注释此前只收口了小写 `ui`，与大写写入侧矛盾，现按注释本意收口 - 新增写侧→分类的端到端契约用例：`resource_bridge.rs` 的 `bridge_is_idempotent_and_installs_source_image` 走真实生产函数 → 真实 `register_local_asset_at(..., "UI", ...)` → 断言落盘 `category` 为 `ui-interaction` - 新增 `assetKindCanonicalMapping.test.ts` 的「写侧 kind 字面量 → 分类」用例组：直接解析 UI 编辑器写侧源码第 3 个实参，写点换个新字面量就会红，防下次再漏	2026-09-11 18:46:58 +08:00
suzmii	576786324f	编辑标签面板回传落盘原值：堵住「只改标签」静默改分类 ... - 新增 `gameCreationAppAssetPersistedCategory`：写回口径，只做「缺失或非法 → 按 kind 派生」兜底，不套用读时自愈；它必然等于 Rust 反序列化后的落盘 `category` - `ResourceClassificationPanel` 的分类初值从 `gameCreationAppAssetCategory`（读显示口径、会把落盘 `unclassified` 自愈成派生值）改为 `gameCreationAppAssetPersistedCategory`，保存时回传落盘原值 - 修掉真机上「同一 `kind:"ui"` 资产同时存在 55 条 `unclassified` 与 2 条 `ui-interaction`」的漂移签名——后者正是自愈值被回写持久化的结果 - 面板注释更正：原注释写「保证『只改标签』不会顺带改动分类」，但那行读的是自愈后的值，这个保证是假的 - `gameCreationAppAssetCategory` 的文档补上「这是读显示口径，回写必须用 `gameCreationAppAssetPersistedCategory`」，避免下次再混用 - 新增面板用例「保存标签不改动落盘 category：自愈值不得被回写」：夹具 `{kind:'ui', category:'unclassified'}`，断言写入命令收到的 `category` 仍是 `unclassified` - 既有面板夹具 `{kind:'character', category:'character'}` 是自愈 no-op，永远测不出漂移，因此保留它作为对照、另加自愈夹具 - 新增契约用例「写回口径保留落盘 unclassified，读显示口径才自愈」，把两个口径的差集钉死	2026-09-11 18:45:38 +08:00
suzmii	458a65cb5e	资源分类读显示口径下沉到 Rust：Agent 投影与 UI 同构 ... - 新增 `game_creation_app_asset_effective_category`：读显示口径的唯一实现——落盘 `category` 权威，仅在落盘值为 `unclassified` 且该资产 `kind` 能派生出明确的非 `unclassified` 分类时采用派生值，其余信任落盘值 - `GameCreationAppAssetManifestEntry` 的反序列化刻意不做自愈：反序列化结果就是落盘原值，「编辑标签」面板要靠它原样回写；自愈只属于读显示口径 - Agent 资源投影 `bridge_registered_resource` 不再直接透传 `asset.category`，改走有效分类，修掉真机 122 条资产里 55 条「UI 显示 UI 交互、Agent 读到待归类」的跨端口径分歧 - 新增 Rust 决策矩阵 `EFFECTIVE_CATEGORY_CONTRACT` 与用例 `asset_effective_category_follows_the_shared_contract_matrix`，矩阵是「落盘值 / kind 派生 / 读时自愈」三个口径的唯一真源 - 新增跨语言契约：`assetKindCanonicalMapping.test.ts` 解析 Rust 源码里的决策矩阵与 canonical kind→栏目表，逐条喂给 TS `gameCreationAppAssetCategory` 对照，任一侧改口径都会红 - `direct_tool_bridge` 新增 Agent 侧回归用例：`kind:"ui" + category:"unclassified"` 必须投影成 `ui-interaction` - 既有用例 `..._projects_manifest_classification_verbatim` 更名为 `..._keeps_explicit_manifest_classification`：逐字透传只在落盘值不是 `unclassified` 时成立，旧名字会与新的有效分类语义矛盾	2026-09-11 18:43:39 +08:00
suzmii	c527c19bf8	校准 DirectProject 历史兼容口径的技术方案与共享决策记录 ... - 技术方案：把「不迁移旧 {role,content} 行 / 不会对旧格式做迁移或兼容」改成当前状态——读侧白名单兼容 legacy 行（含 tool 行只识别不注入）、写侧 DirectProject 自己的旧行写点已收口 - 技术方案：修正「Rust 是该历史文件的唯一写入方」，写清 project.jsonl 同时被通用对话链（agent_id=None 的项目主对话与 Runtime 公开状态消息）读写，并记录两条链互读兼容的规则 - 技术方案：说明为什么故意不给通用对话写入器加「Direct-owned 就拒写」的硬报错（会把旧行噪声换成任务起不来），以及这类失败为何按不可重试处理 - 技术方案：更新时间改 2026-09-11 - decision-log：新增 2026-09-11 条目，记录格式切换当年「唯一写入方 + 测试手动清理」的前提在存量用户项目上不成立、现改为「读侧白名单兼容 + 写侧统一」，以及为什么不做数据迁移	2026-09-11 18:36:29 +08:00
suzmii	2b44b62599	DirectProject 历史格式类失败给出专门提示并按不可重试处理 ... - direct_runtime.rs：新增 direct_project_history_shape_failure 白名单（历史记录类型无效 / 缺少 payload / 解析历史失败） - direct_codex_failure_recovery_hint 增加专门 hint，指向真实现象与动作：该类旧格式已被读侧兼容，仍失败说明记录不在白名单内，请检查项目诊断后修复该历史文件 - direct_codex_failure_is_retryable 对该类失败返回 false，前端不再显示「可直接重试」（同一份历史每次读得到同一结论） - 打开/读取类 IO 失败不在白名单内，仍按可重试处理 - 补断言：hint 文案、IO 失败边界、诊断 message 里的 retryable=false 与 sidecar 的 "retryable": false	2026-09-11 18:36:19 +08:00
suzmii	5ac26b99c9	显式 Codex 返回不再往项目主对话投影旧格式行 ... - direct_tools_mcp.rs：删除 conversation.record_codex_response 末尾往 project.jsonl 追加 legacy 行的投影，它写的是 {schemaVersion:game-creator-conversation.v1,...} 旧行，会毒化共用该文件的 DirectProject 历史 - 顺带删掉只为那条投影存在的 key/message_id 计算与描述它的注释，不留墓碑 - 该工具的事实来源仍是自己的只读 journal .agent/conversations/codex-responses.jsonl，返回内容与 conversation.list/read 行为不变 - 补断言：record_codex_response 只写 codex-responses.jsonl，project.jsonl 保持为空	2026-09-11 18:36:16 +08:00
suzmii	f0d5687ab7	共享的 project.jsonl 让两条对话链互读对方的行，混合历史不再双向失败关闭 ... - project/conversation.rs：read_persisted_local_conversation_records_unlocked 跳过 type=response_item 且带 payload 的行（DirectProject 写给同一份「项目主对话」的行），其余解析失败仍按「解析对话记录失败」失败关闭 - 新增 is_direct_project_history_row 做行信封白名单，只认对方那一种明确枚举的形状，不放宽成「什么都跳过」 - 不把 response_item 行二次投影成 LocalConversationMessageRecord：DirectProject 侧已经拥有那份 Responses item → 聊天内容的投影，再造一份平行投影会与它漂移 - 不加「文件已属于 DirectProject 就拒绝追加旧行」的硬报错：runtime_driver/task_start.rs 在 ensure_..._accepted_public_status_at 返回 Err 时会中止后台任务（「后台任务启动确认落盘失败，任务未执行」），runtime_protocol/steering.rs:572/604/1300 也用 ? 上抛，加硬报错会把旧行噪声换成任务起不来；毒化本身已由读侧白名单堵住 - 补断言：混合文件里通用链只读自己的 legacy 行且坏行仍失败关闭、混合文件从两条链都能读（DirectProject 把两种行都读出来）、纯旧格式文件的写入行为不变	2026-09-11 18:36:07 +08:00
suzmii	bfb928295e	DirectProject 读侧白名单兼容格式切换前的旧行，存量项目不再全部读不动 ... - direct_project_history.rs：两处行信封判定收敛到 direct_project_history_item_from_parsed_line，response_item 与白名单化的 legacy 行走同一条判定路径 - 新增 direct_project_legacy_row：只认 schemaVersion=game-creator-conversation.v1、无 type、role 落在该写入器自己的角色集合（user/assistant/tool）内、content 为非空字符串的行，其余形状继续按损坏失败关闭 - user/assistant 旧行投影成与 direct_project_local_message_item 同形状的 message item：role 与 content 逐字节保留、不 trim、不改写、未知字段忽略，有 messageId 才带 id - tool 旧行已识别但不进 Codex 上下文：它不是 Responses item，无法还原成真正的工具 item，混入会造出假的工具消息；聊天投影本来也只展示 user/assistant - 抽出 direct_project_message_item 供本地补写与 legacy 投影共用，保证两种来源的 item 形状一致 - 补断言：旧行投影（role/content 逐字节、无 messageId 时无 id）、旧行与新行交替的混合文件按行顺序读取、tool 行被识别且不进上下文、非白名单异常行（role=system/developer、content 非字符串或为空、缺 role、缺 payload、坏 JSON）仍失败关闭、通用对话写入器产出的旧行形状落在白名单内 - 变异验证：去掉 legacy 兼容分支→投影/混合文件/通用写入器形状 3 个用例变红；把白名单放宽成「任意行都接受」→失败关闭用例变红	2026-09-11 18:35:26 +08:00
suzmii	f5b381dbd8	视图切换时只取消上一视图排队中的可见性预取 ... 用户离开某个视图后，继续为它排队读图没有任何收益，而这些排队的预取会**排在新视图按需请求的前面**（3 槽跨视图共享），把"进入总览后等图"变成纯等待。这是"进总览要等图"的主因，单张读取本身只有 5–15ms。 - `cancelQueuedVisiblePrefetches()`：只下掉**还在队列里**的 `visible` 理由任务。语义边界刻意收窄 —— - `detail` / `play` 理由的排队**保留**； - **在途请求不打断**（只占 3 槽中的 1 个，打断它拿不回已花的读盘成本，且切回来要重读）； - **缓存与身份不失效**（不触发 `disposeAllCachedPreviews`），切回原视图不重读已拿到的图。 - 修法 4 一并收口：视图切换 effect 在取消后**立即按几何复核一次**（`sweepVisiblePreviews`），仍然可见的卡重新入队、不可见的自然不再请求 —— 因此不存在"取消后永不重试"的死角。 - 依赖使用**派生后的** `prefetchScopeKey`（不是可能为 `undefined` 的 `input.prefetchScopeKey`）。这修掉了本轮自查发现的一个真 bug：早期写法在调用方未传该 prop 时直接 `return`，整段取消逻辑成了**永不执行的死代码**；由下面的断言暴露。 断言（`tests/useProjectResourceCardPreviews.test.ts` 新增 2 条）： 1. 「切视图只取消上一作用域排队中的可见性预取」：登记 6 张（3 在途占满槽 + 3 排队，其中 1 张为 `detail`），切视图后断言队列从 3 → 1、**留下的正是 `detail`**、且 `activeReadCount` 仍为 3（在途不被取消）、新视图 identity 立刻可用； 2. 「取消后再次可见会重新入队」：切走再切回，卡片重新注册且几何可见后，断言该卡**重新进入队列** —— 直接守住"不留永不重试死角"这条硬要求。 变异验证：把取消那一步去掉（effect 内只保留复核）→ 第 1 条断言立即失败（`expected [ …(3) ] to have a length of 1 but got 3`）；恢复后 24/24 通过。 验证（同一时刻、同一命令的前后对照；当时树上有并发改动：`src-tauri/.../direct_project_history.rs`）： - 改动前（只 stash 我的两个文件）：`86 files / 1236 passed / 4 skipped / 0 failed` - 改动后：`86 files / 1238 passed / 4 skipped / 0 failed`（多出的 2 条为本提交新增用例） - `src/components/image-editor` 1387 passed；typecheck exit 0；check:encoding 4388 文件；prettier 与 eslint 干净；`git diff --check` 干净。	2026-09-11 17:55:22 +08:00
suzmii	8edee9eef4	预览队列改为同级裁决：当前预取作用域优先，但不越过 play ... 背景：全局 3 槽跨视图共享，而 hook 的 scopeKey 只含 `projectPath + projectId`（不含视图）。用户在栏目页滚一遍会按可见性入队最多 51 个预览 job；点「回到资源总览」时它们仍排在同一个队列里，总览自己那几张「该出图」的卡只能排在后面 —— 这就是「进总览要等图」的真实来源。 - `nextPreviewJob` 改为两级裁决：**理由优先级固定 `play > detail > visible` 不变**，只在**同一理由内部**让当前预取作用域的请求优先。 - ⚠️ 早期写法用「作用域匹配则权值 +3」，会让当前视图的 `visible` 压过上一视图的 `play` —— 直接破坏 PRD §3.3.2 的固定调度优先级。这个错误是被本提交新增的契约用例抓到的，已改为同级裁决，并把该约束写进函数注释。 - 新增 `prefetchScopeKey`：优先取调用方显式传入的值；未传时退化为**被喂进 hook 的资源集合签名**，因此调用方（`index.tsx`）无需改动即可生效。 - 队列任务记录入队时的 `prefetchScopeKey`，供同级裁决使用。 - 新增只读 `previewQueueSnapshot()`：暴露「谁在排队、属于哪个预取作用域、当前活动读取数」。队列病理此前只能靠猜，有了它「当前视图的卡是否真的进了队列」可直接断言。不参与渲染、无副作用。 断言（`tests/useProjectResourceCardPreviews.test.ts`）：新增「当前预取作用域越过上一作用域的排队预取」契约用例，三条： 1. 当前作用域的 `visible` 越过上一作用域排队的 `visible`； 2. **但不得越过 PRD 优先级** —— 当前作用域的 `visible` 仍排在 `play` 之后； 3. 同一作用域内仍是 `detail > visible`。 变异验证：把作用域偏好关掉（`&& false`）→ 第 1 条断言立即失败（`expected 'previous' to be 'current'`）；恢复后 22/22 通过。断言不是恒真假守卫。 验证：typecheck exit 0；该测试文件 22 passed；check:encoding 4388 文件；`git diff --check` 干净。（AGC 全量与本条无关的并发改动混跑，故此处只报本文件的定向结果；全量对照见后续提交的回报。）	2026-09-11 17:44:21 +08:00
suzmii	a4bec3d018	记下「不再提醒」偏好保持单键、不按入口分域的理由 ... - 该键关掉的只有聊天输入区的「发送前提醒」；资源侧生成素材与快速编辑没有可关的提醒，润色是显式按钮动作 - 分域只在「每个入口都有可关的提醒」时才有意义，现在分域等于给不存在的提醒提前留位 - 只补注释，不改行为与断言	2026-09-11 17:06:35 +08:00
suzmii	327a5d38ee	同步验收文档里 #309 C3 的口径与两条入口的润色判据 ... - S9 行与 7.4 差异表补一句：只读信息浮层已回归（工具条「信息」动作），C3 取消的仍只是可编辑详情面板与全屏编辑路由 - S10 / S11 行补上两处入口的「AI 润色」判据：按钮 aria-label 与 aria-busy、成功回填与「恢复原文」、失败保留原文、超类型上限截断并提示「已按长度上限截断」 - 纯文档改动，不动代码与断言	2026-09-11 17:03:04 +08:00
suzmii	c2d3292769	快速编辑浮层接入提示词润色，提示词变了就重铸请求身份 ... - 选中工具条的快速编辑面板通过共享 composer 的注入位渲染同一个 ResourcePromptPolishSlot，场景约束为「图片素材的快速编辑提示词」 - 润色回填走 applyResourceQuickEditPrompt：与共享 composer 的 resetFailedDialogStatus 同口径，提示词变了就把上一次的失败状态清掉 - 提交侧请求身份按提示词收口：同 sourceLayerId 且提示词未变时复用（失败重试仍命中同一 operation 账本），提示词变了则重铸 operationId / 幂等键——Rust 的 request_fingerprint 含 prompt，复用旧身份会被判「已绑定到不同资源编辑请求」；正规化结果与 revision 属于别的事实，换身份时原样保留 - 打开面板时的初始身份改用统一的 createResourceEditRequestIdentity（绑定面板草稿提示词） - 测试：live integration 补两条——润色成功回填并换身份（断言 prompt 与 operationId/幂等键同时变化）、润色失败保留原文且身份不变 - 变异验证：提交侧去掉按提示词重铸（同 sourceLayerId 直接复用旧身份）→ 「润色后换身份」用例红灯（两次 operationId 相同，实测）	2026-09-11 17:02:17 +08:00
suzmii	d44e1ae8ea	生成素材弹窗接入提示词润色，并让请求身份绑住它铸造时的那句提示词 ... - 新增 ResourcePromptPolishSlot：素材侧两处入口共用的「AI 润色 / 恢复原文 / 润色中…」动作，取数走 AGC 侧 usePromptPolish，聊天框同款失败态（失败保留原文、可重试文案） - 场景约束走 polish_local_project_prompt 的 context：「这是素材生成提示词（音效）」+「只润色这一句、不要扩写成需求/方案/验收标准、不要新增事实」（本批不动后端提示词文件），文案落在 resourceCanvasPromptPolishModel - resourceEditModel 新增 truncateResourceEditPrompt：超上限先按类型截断（背景音乐 140 / 音效 1900 / 视频与角色动画 4000 / 其余 32000）再回填，并在状态行给出「已按长度上限截断」，不静默丢内容；后端上限未改 - resourceEditModel 新增 resolveResourceEditRequestIdentity：请求身份绑定到铸造时的 prompt（Rust request_fingerprint 含 prompt，改了提示词还复用同一 operationId 会被判「已绑定到不同资源编辑请求」）；提示词没变时仍复用，失败重试照旧命中同一账本 - 生成素材弹窗用注入位渲染润色动作（共享 composer 只提供插槽，不上 Tauri 调用），提交时按同一口径解析身份；原先只在这一处使用的 createResourceCanvasGenerationRequest 随之下线 - 样式落在 resourceCanvasChrome.css（resource-prompt-polish 一族），弹窗与 composer 共用一行 - 测试：模型层补截断边界与身份复用/重铸；弹窗层补润色回填与上下文、超限截断提示、失败保留原文、失败后提示词与润色一起锁定且重试复用同一请求 - 变异验证：截断改成恒等 → 模型用例与「超限截断」用例双双红灯（实测字段长度 206 ≠ 140）；身份去掉重铸 → 模型用例红灯	2026-09-11 16:58:49 +08:00
suzmii	62029fdc23	给共享生成 composer 加一个可选的提示词动作注入位 ... - ImageCanvasBasicGenerationComposerView 新增 promptActionSlot（可选）：不传时整块不渲染，默认 DOM 与行为逐字不变 - 注入位紧跟在提示词输入框之后，节点由宿主提供并自己负责在 composer 网格里的落位；共享组件内不做任何 Tauri 调用 - ImageCanvasQuickEditPanelView 原样透传该 prop，网页端两条调用链不传即不受影响 - 测试：composer 与快速编辑面板各补一条「不传时无占位节点、传入时落在提示词之后」，默认不变由既有用例继续覆盖	2026-09-11 16:54:57 +08:00
suzmii	25c55fcb7f	把提示词润色的状态机抽成 usePromptPolish，聊天输入区先迁过去 ... - 新增 features/project-workspace/usePromptPolish.ts：失败保留原文、首次成功落原文快照（反复润色只覆盖结果）、可重入保护、可注入的上下文与规范化回调，Tauri 调用固定在 AGC 侧（默认 requestChatPromptPolish） - 聊天输入区改用它，行为逐字不变：润色按钮 aria-busy/disabled、Loader2/Sparkles、「润色中…」/失败文案、失败保留原文、恢复原文回到最初原文、草稿清空后重置 - 聊天特有的「发送前提醒」留在输入区：提醒偏好、本轮已确认草稿指纹、表单捕获拦截、面板内润色用另一句失败文案 - chatPromptPolish.ts 的 requestChatPromptPolish 及其单测未改动，继续作为这条 LLM 通道的契约测试 - 护栏：chatPromptPolish.test.tsx（16 条）与 resourceReferenceInput.test.tsx（20 条）全绿	2026-09-11 16:53:33 +08:00
suzmii	3de2ec734b	预览门禁去掉单点依赖：observer 必定建出，并加可见性兜底扫描 ... 真机现场：整个「UI 交互」栏（51 项）全部只剩占位图标。根因链是**同一对文件里的两个缺陷叠加**，因此作为一个原子提交收口（拆成两半任一半都不足以独立成立：光修 observer 仍可能被回调时序漏掉，光加扫描则 observer 根本不存在时的判定精度无从恢复）。 一、确认 2a157ea6f 引入的回归：observer 可能永远不建 - 那次改动把「root 为 null」当成「不建 observer」，并指望「卡片注册」作为 root 就绪信号重建。 - 但那个 effect 每个 scope **实际只跑一次**（`requestPreview` 是稳定引用，其余依赖在 scope 内不变），一旦这一轮因 root 为 null 直接返回就再无第二次机会； - 而「卡片注册」信号只在**后续还有新注册**时才来 —— 初次挂载时 51 张卡一次性注册完，之后再没有新注册，信号永不再来。 - 结果：observer 永不创建、所有卡永不被观察、永远停在 `idle`，整栏只剩占位图标（`categoryIcons['ui-interaction'] = LayoutGrid`）。 - 修复：**绝不拿"root 未就绪"当作"不建 observer"的理由**。拿到容器 root 最好；拿不到就退到 canvas、再退到视口（`root: null`）。视口判定严格优于"没有 observer"——屏幕上真实可见的卡一定落在视口矩形内；代价只是视口外但仍在画布内的卡晚一步由滚动触发。容器 root 迟到时再有界重试（5 次、退避到 512ms）重建一次，恢复按画本容器裁剪的精确判定。 二、系统性防线：可见性兜底扫描（去掉单点依赖） - 门禁原先只有 `IntersectionObserver` 一条路，observer 没建出来 / 回调没送达 / 注册与创建交错，卡片就再无第二次机会。 - 新增 `sweepVisiblePreviews()`：按**与 observer 对齐的视口几何判据**（含 160px 余量）独立复核登记表，只对 `idle`（从未请求）的卡补一次 `visible`，`loading`/`queued`/`loaded`/`failed` 一律不碰。 - **不是第二条加载通路**：仍经 `requestPreview` 走同一条队列，受同一套去重、优先级、全局 3 槽与 `48` 项 / `64 MiB` 预算约束；**只补"可判定为可见"的卡，不退化成全量预读**（PRD §3.3.2 合同不变）。 - 触发点：scope 变化后 0 / 250 / 1000ms 各扫一次（覆盖晚挂载的卡）、observer 就绪后立即扫一次、每次卡片注册时扫一次、窗口 resize 与页面重新可见时各扫一次。 测试（`tests/useProjectResourceCardPreviews.test.ts`） - 更新「等真正的 root 就绪」这条契约：它原先断言"root 为 null 时不得建 observer"——那正是本轮回归的语义，改为断言"**仍然必须建出 observer**（`root: null` 视口判定）"，并要求容器 root 迟到后重建为容器 root； - 新增「不在热预取窗口内的可见卡不得停在 idle」（20 张 / 热预取 12）； - 新增「没有任何 observer 回调时，可见卡也必须被放行」——完全不触发回调，只靠几何可见性，专门守住兜底扫描； - 新增「视口外的已登记卡不得被请求」——守住"不退化成全量预读"。 变异验证：把兜底扫描改成直接 `return 0`（等价于去掉扫描）→ 「没有任何 observer 回调时可见卡也必须被放行」立即失败（`expected undefined to be 'loaded'`）；恢复后 21/21 通过。断言不是恒真假守卫。 可观测性：`data-preview-status` / `data-preview-error` 已在位，因此"可见却 idle"这类问题以后读一个 DOM 属性即可判定，不再需要解码图片或猜调度。 验证（同一时刻、同一命令的前后对照；树上另有并发改动）：改动前 `86 files / 1225 passed / 4 skipped / 0 failed`；改动后 `86 files / 1227 passed / 4 skipped / 0 failed`（多出的 2 条为本提交新增用例）。`src/components/image-editor` 1385 passed；typecheck exit 0；check:encoding 4384 文件；prettier 与 eslint 干净；`git diff --check` 干净。	2026-09-11 16:49:09 +08:00
suzmii	e088ede217	让「当前使用」的资源卡真的发光，并修掉版本高亮的两处既有缺陷 ... - .game-resource-card.is-current-version 的外向扩散层从 0 0 0 2px /14%（那是描边）改成 0 0 0 3px /32% + 0 0 20px /34% 的真发光，边框口径仍是 1px - 新增 game-resource-card-current-version-breathe 关键帧与 ::after 光环（只呼吸 opacity，照本页 .ui-editor-status-attention 的既有写法）：声明档位 38%，呼吸区间 0.58 ↔ 1，视觉上约 22% ↔ 38% - prefers-reduced-motion 下关掉动画但保留可见档位（opacity 0.75），收敛动画不收敛可见性 - 缺陷①：.game-resource-card.is-relation-version-binding 原本只写 border-color，而卡片本体 border: 0，规则从未生效（「点击版本卡后高亮绑定资源」这条 PRD 语义一直看不见）；改为真实的 1px 边框 + ring，并把该规则移到 .is-current-version 之前，让常驻光环在两者同时命中时仍然赢 - 缺陷②：当前版本规则与 hover/focus/selected 同权重且在后，导致当前版本卡几乎看不出被选中；新增 .is-current-version.is-selected / :hover / :focus-within / .is-dragging 变体，显式提权到 (0,3,0) 并带上选中态自己那层阴影 - 测试：新增 resourceCardCurrentVersionStyle.test.ts（外向扩散层档位、呼吸实现方式与关键帧区间、选中态变体权重更高、reduced-motion 下仍可见、版本聚焦规则不再是死规则） - 测试：resourceVersionSwitch 补 data-used-by-current-version 的 DOM 断言（命中为 "true"、未命中不含该属性、切版本后跟着换手） - 测试夹具修正：project-development.suite 的版本夹具把 slotId 从 'player' 改成恒等映射 'asset:asset-player'（'historical' → 'asset:asset-removed'），否则「当前版本」判定永远不命中、照它写断言必成假守卫；并补一条自证断言钉住它真的命中	2026-09-11 16:42:58 +08:00
suzmii	082d8d62de	把运行页签的资源信息搬到画布选中工具条，两处共用一份只读字段 ... - 新增「信息」动作：排在「@引用」之后、「编辑标签」之前，点开非模态信息浮层，再点一次即收起（aria-pressed 反映开合） - 新增只读字段组件 ResourceInfoFieldsView（ResourceInfoPanelView.tsx），运行页签的「信息展示」与画布浮层共用，字段清单只在 resolveResourceInfoFieldRows 单点定义 - 字段口径：名称 / 路径 / 类型 + 只读分类与标签（分类取画布栏目口径，标签为空时给「暂无标签」），刻意不含来源任务、资产 ID 等 manifest 内部标识 - 浮层 chrome 与快速编辑浮层同族（同一锚点、同档圆角与阴影），样式落在 resourceCanvasChrome.css；关闭入口三处：动作按钮、面板关闭按钮、画布浮层统一的 Esc / 点边界外 - 关闭判据收口：resolveResourceCanvasQuickEditDismissOpen 更名为 resolveResourceCanvasFloatingPanelDismissOpen、参数改为 isFloatingPanelOpen，宿主把「快速编辑开」与「信息开」合成一个布尔 - .game-resource-info-panel 补进 RESOURCE_CANVAS_INTERACTION_SELECTOR，否则点在只读字段值上会被判成点画布空白而清掉选中 - 换选 / 清空选中 / 切项目时信息浮层自动收起：在选中派生处按 selectedResourceId 收口，不在每个重置点各补一行 - 测试：新增 resourceCanvasInfoModel 三条与「信息面板在画布浮层与运行页签里渲染同一份只读字段」（工具条顺序、开合、关闭按钮只收面板、点画布以外收起、Esc 连工具条一起收、运行页签字段逐行相同）；resourceCanvasFloatingDismiss 的判据用例与交互选择器夹具改为浮层通用口径 - resourceCanvasChrome.css 的字段排版收在浮层选择器下，不跨上下文改运行页签的字号与列宽 - decision-log 新增一条：记录这次对 Issue #309 C3「取消资源详情面板」的有意局部回退（只回退「看信息」，不恢复可编辑详情面板与全屏编辑路由），并登记需要同步的 C3 引用位置	2026-09-11 16:42:40 +08:00
suzmii	d80011656b	把资源卡的 @ 引用入口挪进选中资源工具条 ... - 删除资源卡右上角的 @ 引用圆钮，连同它的 44×44 热区伪元素与全部样式一起退役 - 选中资源的画布工具条新增「@引用」动作，排在「UI 编辑器」之后，出站负载与来源逐字未变（source: 'resource-card'） - 测试：原「卡片圆钮视觉尺寸」用例改写为「入口只留在工具条里」的源级 + 样式级断言，并补反向断言卡片组件内不再出现插入调用 - 测试：新增键盘通路用例，聚焦后回车必须真正派发 agc-resource-reference-insert，且两条通路负载逐字相同、每次激活只派发一次 - harness 注释同步：资源卡本体只剩「选中资源」与媒体播放钮	2026-09-11 16:28:48 +08:00
suzmii	3bfc3f0849	新增 AGC 资源工作台 V3 端到端验收用例 ... - 新增 docs/technical/【测试用例】AGC资源工作台V3端到端验收-2026-09-11.md - 给出从建项、对话生成素材到运行收尾的一条主线，按 S1–S21 分步列出操作、期望结果、对应 PRD 条款、可观察判据与已知例外 - 落定每步的可观察形态：资源卡 data-preview-kind / data-preview-status / data-preview-error、data-used-by-current-version、data-resource-book-category、data-resource-view-state 与控制台判据脚本 - 记录前置条件与门禁口径：dev 态前端走 Vite HMR、Rust 侧改动需重启客户端、服务端改动需重启 api-server、build-gate 代理假红需清代理变量 - 列出只靠视频或截图表达的 7 处条款清单与补齐方式，并更正 F12 无法观察 Rust 到 api-server 的 HTTP 这一前提 - 列出已知未做与已取消项，以及文档与代码的四处偏差（资源卡打开详情按钮、运行入口提示文案、画布生成入口进度、真机落盘分类分布） - 附验收记录表与逐步骤失败排查索引	2026-09-11 15:45:01 +08:00
suzmii	5bf348d88a	把误入上一个提交的验收文档移出提交，交回其作者 ... - 81482b458 原本只应包含 tests/appSurface/project-development.suite.ts 一条断言同步， 但该验收文档当时已被预置在索引里，随那次提交一起被带走；这里只做「移出提交」， 不改动文档内容，文档仍完整保留在工作区，由它的作者自行提交 - 未使用 --amend：按纪律不改写已有提交	2026-09-11 15:42:24 +08:00
suzmii	81482b4587	同步「编辑标签」入口文案的既有断言 ... - tests/appSurface/project-development.suite.ts：跟随 6bdc8bbd9 把资源卡工具条入口由 「分类与标签」改为「编辑标签」，同步音频资源工具条那条既有断言（否则 HEAD 的树是红的） - 同一处注释同步说明：该面板只编辑 manifest `assets[].tags`，分类不再有手动入口	2026-09-11 15:41:17 +08:00
suzmii	ea9668e4a9	资源总览「所有资源」卡补上资源预览 ... - 现象与归因：「所有资源」卡的预览区一直是空的，原因是我在 1cc9a2381 里加的闸 `!isResourceBookAllTarget(category)`（当时为避开"同一张资源卡挂两份"）让它一张卡片计划都不生成；预览卡从来只由画本场景注入，占位摞本身不含卡片 - 改为真正生成卡片计划：喂进去的仍是全量投影（与标题栏计数徽标同一份口径），但当成一摞交给栏目卡同一个选取函数 `selectResourceBookOverviewCards`——没有视图中心时按投影顺序取前 `RESOURCE_BOOK_OVERVIEW_STACK_LIMIT`(=3) 张，与栏目卡每摞上限同口径；不分类型列，避免 66 项一口气铺出十几列 - 预览用同一个 `renderCard` 与同一套 `resourceBookOverviewCardLayout` 几何渲染，唯一差别是宿主类名换成 `.game-resource-book-preview-card`：转场层按 `.game-resource-book-scene-card` 收集 FLIP 节点并以 `card:${resourceId}` 为键，同一张卡两个宿主会让两条记录互相顶掉，因此预览宿主不进收集范围（`resourceBookController` 一行未改） - 预览宿主带 `aria-hidden` + `pointer-events: none`：无障碍树与 `getByRole` 里每张资源卡仍然只有栏目卡那一份，不会重复命中；点预览区仍走进「所有资源」页，栏目卡预览卡仍可选中 - 转场淡出集合（`resourceBookPlanKeysRef` 那段）跳过「所有资源」组，避免预览节点被当成"离开视图的卡片"按子画布坐标重新贴到画布别处 - `ResourceBookThumbnail`：该卡正文的占位摞从最多 3 摞改为对齐真实摞数的 1 摞，卡片高度回到与栏目卡同一条口径 - `styles.css`：把 `.game-resource-book-preview-card` 并进 `.game-resource-book-scene-card` 的两条既有规则（宿主几何、主态卡片圆角/阴影）与 `prefers-reduced-motion`；没有新写一套预览样式 - 断言（`project-development.suite.ts`）：预览卡的 `data-resource-card-id` 序列恰等于全量投影前 3 个、条数 == `min(3, 计数徽标)`、预览里是完整卡片（视觉体 + 选中按钮）、宿主在 `aria-hidden` 子树里、宿主几何规则与栏目卡共用同一条 - 断言（新增用例）：空项目下沿用既有空态「暂无资源」、预览节点 0 个、计数 `0 项`、入口行仍在，卡片不破版 - 单测（`resourceBookLayout.test.ts`）：把已被新行为取代的旧断言（`all` 组不出卡片、全计划无重复卡片键）删掉，换成新合同（预览 = 全量投影前 3 张、只铺一列、各栏目摞不变），并补空投影 → 0 张 - 变异验证（两条都跑过并已还原）：① 喂进去的资源改回空数组 → `AssertionError: expected +0 to be 4`；② 恢复旧闸（计数仍正确、预览为 0）→ `AssertionError: expected [] to deeply equal [ Array(3) ]`	2026-09-11 15:37:17 +08:00
suzmii	6bdc8bbd93	AGC 资源分类面板改为「编辑素材标签」：只编辑标签、分类不再有手动入口 ... - ResourceClassificationPanel.tsx：面板改为只编辑 manifest `assets[].tags`，移除分类 6 类 chip 那一排；标题与 aria-label 改「编辑素材标签」，副标题由资源路径改为素材名 （`localPath` 的 basename，仓库没有独立显示名字段） - ResourceClassificationPanel.tsx：标签状态由「整段逗号分隔字符串」改为字符串数组， 每个已有标签渲染成自带删除按钮的胶囊 pill；保存时把未落成 pill 的输入尾巴一并切分， 归一化仍走 `normalizeGameCreationAppAssetTags`，回车 / 中英文逗号 / 顿号提交方式不变 - ResourceClassificationPanel.tsx：写入命令 `category` 是必填，读一次当前权威值并 在保存时原样回传，保证「只改标签」不漂移分类；底部按钮「保存」改「保存标签」， 删除资源入口按既有保留（截图未画，但它是唯一的资源删除入口） - resourceClassificationTagPanel.css：新增标签 pill 样式，删除按钮嵌在 pill 内部 （视觉图标 11px、热区 32×32、负外边距抵消不撑高 pill）；若第二处出现带删除按钮的 标签 pill，抽到 `packages/shared` 做 `PlatformRemovableTagPill`，不要复制这份实现 - index.tsx：资源卡工具条入口 label / title / 文案由「分类与标签」改「编辑标签」， 与面板标题一致（否则入口写着分类、打开的是纯标签面板） - tests/resourceClassificationPanel.test.tsx：断言对齐截图文案、逐个 pill 自带删除、 点某个 × 只删对应标签、aria-label 可区分、保存 payload 的 tags 数组与 category 原样回传、 取消不写盘、入口 label 与面板标题一致、删除热区不小于 32px - 文档：PRD §5.3「分类取值优先级」改写为当前状态（分类没有用户手动设置入口、 该面板只编辑标签），并新增 decision-log 条目记录本次产品决策与「用户手动设 category 的能力就此移除」这一事实 - 说明：截图文案（编辑素材标签 / 新增标签，多个用逗号分隔 / 保存标签）在全仓检索 无命中，属仓库之外来源，本次按用户截图对齐，不是 PRD 明文	2026-09-11 15:34:36 +08:00
suzmii	2a157ea6f8	预览可见性门禁等 root 就绪再建 observer，并把登记表补挂齐 ... 真机现场：同一屏里 `idle` 与 `loaded` 交错，12 张相交卡从未入队（`idle` 的语义就是「从未请求」，不是被淘汰回退）。根因在 observer 的**创建时机**：`useProjectResourceCardPreviews` 建 IntersectionObserver 时把 `intersectionRootRef.current ?? canvasRef.current` 直接当 root 传下去，而 root 是资源画本容器、由被观察卡片所在的子树持有。创建那一刻 root 还是 `null` 时，浏览器会**退回按视口判定**，于是被画本容器裁掉的卡片永远报「不可见」，可见性门禁再也不放行它们 —— 卡面只剩占位图标，且没有任何错误提示。 - `useProjectResourceCardPreviews`：root 为 `null` 时**不建 observer**，等 root 就绪后由卡片注册触发的 `rootEpoch` 重建。判据是「卡片一定渲染在画本容器内部」，所以**有卡片注册本身就等价于 root 已就绪**，不需要新增跨组件契约、也不必改 `index.tsx`。 - 新增 `attachObservedCards()`：observer 就绪或重建后，按登记表把**每一张已注册卡片**补挂一遍。此前只在新 observer 创建时补挂一次，注册与创建分属不同 effect 存在时序窗口，错过那次补挂的卡会停在登记表里却从未被观察。 - root 未变且 observer 已在时只补挂、不重建，避免每次渲染重建观察器。 - `observePreview` 在没有 `IntersectionObserver` 的环境（如单测）保持静默，不制造多余渲染。 测试（`tests/useProjectResourceCardPreviews.test.ts` 新增 3 条契约）： - 「不在热预取窗口内的可见卡不得停在 idle」：注册 20 张、`eagerPreviewLimit: 12`，断言注册进 observer 的元素数等于注册数、回调报可见后全部落 `loaded`、且没有一张停留在未请求状态； - 「等真正的 root 就绪后再观察并加载」：root 首次为 `null` 时**不得建 observer**（否则按视口判定），注册后必须以真正的 root 建出来并完成加载； - 「建 observer 之前就注册的卡要被补挂」：断言 observer 就绪后登记表里的每一张都在观察集合内，且报可见后全部 `loaded`。 变异验证：把 root 守卫退回旧行为（允许 root 为 `null` 时照建 observer）后，「等真正的 root 就绪」这条立即失败（`expected [] to have a length of 0 but got 1`）；恢复后 19/19 通过。断言不是恒真假守卫。 边界说明：只改预览 hook 与它的测试，未动 `index.tsx` / `styles.css` / `resourceBookLayout.ts`（均在他人手上），未放宽任何既有断言、未取消可见性门禁（仍是按需加载）。 验证：`npm run test -- apps/ai-game-creator-shell/tests` 84 files passed / 1216 passed / 4 skipped / 0 failed；`src/components/image-editor` 1385 passed；typecheck exit 0；check:encoding 4379 文件；prettier 与 eslint 干净；`git diff --check` 干净。	2026-09-11 15:31:29 +08:00