1398 Commits

Author	SHA1	Message	Date
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	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
suzmii	39a96aa418	模型下拉菜单高度有界：健壮性补强，条目多时不再盖住消息 ... - 性质说明：本条是**健壮性补强**，不是用户本轮报的那几条之一；由上一提交（锚点修复）排查时顺手发现的未修观察收尾。 - styles.css：`.conversation-model-menu` 补 `max-height: min(240px, 40vh)` + `overflow: auto` + `overscroll-behavior: contain`。菜单此前没有高度上限，模型条目很多时会长到 composer 顶边以上、盖住消息；240px 与视口 40vh 取小者，矮窗 / 窄屏（移动端优先）更稳。`overscroll-behavior: contain` 与既有 `.resource-reference-menu` 同一口径，菜单内滚动不传染给背后的消息列表。不新增视觉：border / radius / padding 与 token 全部沿用原值。 - 语义零改动：锚点与流式归属不变（`position: absolute; right: 0; bottom: calc(100% + 8px)` 未动），打开 / 选择 / 刷新模型列表的交互不变。 - project-development.suite.ts：新增声明级守卫「bounds the model dropdown height so a long catalog cannot cover the composer」——菜单规则必须同时声明 `max-height: min(240px, 40vh)`、`overflow: auto`、`overscroll-behavior: contain`，并仍是 `position: absolute`（高度有界不改锚点）。 - 变异验证（已实测）：把 `max-height` 摘掉 → 用例红灯（expected '…' to match /max-height:\s*min\(\s*240px\s*,\s*40vh\s*\)/u）。 - 门禁：typecheck exit 0；AGC 子集 1206 passed / 4 skipped / 0 failed（基线 1205 + 本次新增 1 条）；src/components/image-editor 1385 passed；check:encoding 4379 文件通过；`git diff --check` 全量与本次两个文件范围均 exit 0。	2026-09-11 14:59:42 +08:00
suzmii	4f3516a5d9	修复分类 chip 条叠字：分段页签子项补内容宽度下限 ... - packages/shared/src/components/PlatformSegmentedTabs.tsx：容器补 `platform-segmented-tabs` 稳定钩子类，供共享样式表精确命中子项（不依赖 Tailwind 任意值扫描） - packages/shared/src/components/styles.css：新增 `.platform-segmented-tabs > button` 的 `min-width: max-content`，给每个子项一个「内容宽度」下限；放不下时由容器横向滚动兜底 - apps/ai-game-creator-shell/src/view/project-development/ResourceClassificationPanel.tsx： 「资源分类与标签」的 6 类分类条由 `columns="threeToSix"` 改为 `layout="scroll"` + `frame="bare"` + `surface="transparent"`，与 `@` 面板和资源画布的分类条同一条既有形态 - packages/shared/src/components/PlatformResourceFilterBar.test.tsx：新增两条声明级断言， 钉住「子项不换行 + 容器横向可滚 + 子项有不低于内容宽度的下限」	2026-09-11 14:54:27 +08:00
suzmii	ff287c19fc	模型下拉弹层改回以触发钮为锚点，输入区高度变化不再牵动它 ... - styles.css：direct-codex 控制排里的 .conversation-model-select 由 position: static !important 改为 position: relative !important（只改这一个词，另补一段注释说明它同时是弹层锚点）。这颗容器是 .conversation-model-menu（position: absolute; right: 0; bottom: calc(100% + 8px)）与模型提示（[role='alert'] / [role='status']，position: absolute; bottom: 36px）的包含块；写成 static 时包含块回落到最近的有定位祖先——也就是 position: absolute 的 composer 盒子，菜单于是出现在整个 composer 上方、与触发钮之间隔着整个输入区，输入区一变高（多行、引用 chip、AI 润色）菜单与提示跟着往上飘：这就是"编辑框把元素挤开"的形态。 - styles.css：right/bottom: auto、flex: 0 1 auto、min-width: 0、max-width: 180px 全部保持原样——relative 不会把模型选择钮移出控制排，也不改它被压缩换行的行为；交互语义零改动（打开/选择/刷新模型、发送、@ 引用、快速模式全在原位）。 - project-development.suite.ts：新增一条声明级守卫。① 弹层不参与父容器流式布局（菜单与模型提示都是 absolute，菜单 bottom: calc(100% + …)、right: 0）；② 锚点必须是有定位的容器（relative 且不是 static），同时仍在原位（right/bottom auto、flex 0 1 auto、min-width 0）；③ 输入区高度变化不得推动同排操作元素（composer 是底边锚定的两行网格：position: absolute + bottom: 12px + grid-template-rows: auto auto；控制排是单行 flex 且不换行，@ 与发送钮 flex: 0 0 30px 不可压缩，窄屏下被压缩的是可收缩的模型选择钮）。 - conversationModelSelect.test.tsx：新增一条 DOM 守卫——菜单必须是 .conversation-model-select 的直接子节点，且不得成为控制排容器 .project-supervisor-composer-controls-right 的流式子节点。 - 变异验证（均已实测红灯）：① 锚点改回 static → "expected … to match /position:\s*relative\s*!important/"；② 菜单改成 position: static（弹层回流式）→ "expected … to match /position:\s*absolute/"；③ 把菜单渲染挪出触发钮容器（变成同排容器的流式子节点）→ DOM 守卫 "expected null not to be null"。 - 门禁：typecheck exit 0；AGC 子集 1205 passed / 4 skipped / 0 failed（基线 1203 + 本次新增 2 条）；src/components/image-editor 1385 passed；check:encoding 4379 文件通过；本次三个文件单独 `git diff --check` exit 0（全量 `git diff --check` 目前报的是另一位 Agent 在途修改的 packages/shared/src/components/styles.css:1281 EOF 空行，与本次无关）。	2026-09-11 14:53:11 +08:00
suzmii	9c4778c881	把资源卡右下角的 @ 引用按钮做小：视觉缩到 0.8×，热区保持 44×44 ... - styles.css：`.game-resource-card-reference` 视觉尺寸 30×30 → 24×24（0.8×），新加 `.game-resource-card-reference svg` 把内部 `AtSign` 图标同步从 16px 收到 13px，圆角/描边/底色/阴影 token 全部沿用原值。 - styles.css：`bottom` 由 9px 调到 14px，与右侧 34px 播放钮圆心对齐（9 + 34 / 2 = 14 + 24 / 2），避免缩小后两颗圆钮错位。 - styles.css：新增 `.game-resource-card-reference::before` 伪元素撑出 44×44 热区（本仓 window chrome / 素材选择列表同口径的最小可点尺寸），只扩命中范围、不参与布局也不改变绘制；整体向左让 4px，让热区右边缘与播放钮的盒子恰好相邻，不覆盖它。 - 语义未动：仍是「插入素材引用」入口，className、`aria-label={\`引用资源 ${resource.label}\`}`、key 与 `dispatchResourceReferenceInsert` 调用一行未改，本次只改 CSS 声明。 - 测试：新增 CSS 声明级用例，断言按钮与图标确实变小（24 < 30、13 < 16）、热区不小于 44×44、热区右边缘不越过播放钮盒子，并顺带钉住 `index.tsx` 里 @ 入口的 className / aria-label / 插入动作仍在。 - 变异验证：把按钮改回 30px、热区改回 24px、图标改回 16px → 用例红灯；只把热区缩回 24px → 用例同样红灯（均已实测，随后原样还原）。	2026-09-11 14:00:32 +08:00
suzmii	29b99f213d	删除资源画布左侧的栏目大纲导航：切栏目改由总览卡片、所有资源入口与下一页承担 ... - index.tsx：整条删除 `ResourceBookOutlineNav` 组件（`.game-resource-outline` / `aria-label="资源栏目大纲"` / 栏目图标 + 栏目文字 + 未读红点）以及栏目页与「所有资源」页两处挂载点；`ResourceBookAllResourcesPage` 不再接收只服务导航的 `unreadCategories` / `onOpen`。 - index.tsx：一并清掉只服务这条导航的「未读红点」状态链（`unreadResourceCategoryState`、`resourceCategorySnapshotRef`、`resourceIdsByCategory`、`viewedResourceCategory` 与对应 effect），不留死代码、不留墓碑注释。 - styles.css：删除全部 `.game-resource-outline*` 规则（悬浮 Dock、常态/悬停态、图标列宽、`.game-resource-outline-label`、`.game-resource-outline-unread`，共 106 行）。 - 保留未动：分区栏目本身、栏目标题栏、资源卡、总览缩略卡片、第 0 张「所有资源」入口、「所有资源」汇总页、搜索、总览、快速编辑与选中工具条。 - 测试：切栏目 helper（appSurface/project-development、appSurface/home、resourceRename、resourceVersionSwitch）改为走「资源总览」缩略卡片（需要时先点「收起资源」回总览），不再点导航；栏目顺序断言改钉在总览缩略卡片的 `aria-label` 序列上（第 0 张「所有资源」+ 固定七栏目），断言内容未放宽。 - 测试：按「四不写」删除只守这条导航的断言——大纲常态可读性的 CSS 声明用例、大纲条目图标/文字的 DOM 用例（该用例保留其中与搜索浮层相关的断言并改名）、未读红点用例（该用例保留"只登记游戏代码的项目照常分页并落在待归类"的部分并改名）、空项目与「所有资源」页里的导航存在性断言。 - 测试：新增反向守卫 + 切栏目链路用例（`has no outline nav and keeps every section reachable through the remaining entries`）：断言 `资源栏目大纲` 标签、`.game-resource-outline` 类名与对应 `<nav>` 都不再渲染，并逐条走通总览缩略卡片（含空栏目）→ 下一页 → 标题栏「资源总览」→ 「所有资源」入口往返。 - 测试：`preserves independent art viewports across sort and workbench mode switches` 保留全部原断言，只去掉排序模式切换后那些"点当前栏目"的空操作往返（旧导航点在同栏目上是提前返回，改 helper 后变成真实往返，会在 jsdom 里触发重新 fit）。	2026-09-11 13:54:12 +08:00
suzmii	083df0aa2c	类型判定改为内容证据优先：消除 kind 与内容证据同权的脆弱点 ... **口径更正（后加的）**：本条提交**不是**"修复真机那 8 张卡"。经用真源码复算真机 manifest 确认，当前 HEAD 上这 8 张 `.json` 本就正确落 `document`、角标「文档」，该现象不复现——用户看到的是更早构建的行为。本条的真实价值是**消除 `kind` 与内容证据同权的脆弱点，并把「派发决策由内容证据决定」钉成不变量**，见下。 - 背景：真机「待归类」栏目曾出现 8 张卡——角标写「图片」、卡面却只有占位图标。该现象在当前 HEAD 上不复现（见上），但它对应一个**真实存在且此前只是碰巧没被踩中的脆弱点**：`projectedResourceKind` 里 `kind` 与内容证据**同权**，而 `artKind` 含 `ui`；一旦界面规格类资产丢了 `.json` 扩展名，预览派发就会翻车。原先能通过**完全依赖 `.json` 恰好在那张扩展名表里**，属巧合而非设计。 - 机制（旧行为）：`kind:"UI"` 被 `artKind` 命中 → 判定为 `art`；预览调度再按 `art` 走图像分支，又因 `mediaType:"application/json"` 不是图像而兜底成 `placeholder`，而 `requestPreview` 对 `placeholder` 直接返回——**一次 IPC 都不发**，卡片既不报错也没有图。 - `resourceProjectionModel.ts` 的 `projectedResourceKind` 改为两趟判定：第一趟只看 `mediaType` 与路径扩展名（文件内容的可验证证据），第二趟才看 `kind`（登记标签，可能过时或宽泛）。`kind` 不再与内容证据同权，因此 `kind:"ui"` 无法再把 `application/json` 改写成 `art`。 - 不改 `artKind` 的取值（`ui` 仍在表内），只调整判定顺序：最小改动面，`kind:"ui"` + `image/png` 这类正常资产行为不变（仍由 `mediaType` 命中）。 - 界面规格 JSON 现在落 `document` 分支，走 `read_local_project_text_preview`（Rust 侧 `.json` 与 `application/json` 本就在支持范围内且这些条目已登记），卡面渲染 JSON 文本摘要，角标随 `projectResourceTypeLabel` 变为「文档」。预览链条数、缓存、并发与门禁一律未动。 - `tests/resourceCardPreviewRealManifest.test.ts` 中记录旧行为的用例同步跟上新合同：`placeholder: 8` 改为 `document: 8`，用例名与注释改写为「52 张 PNG 走图片分支，8 条 UI 规格走文档分支，无一落占位」，并新增「角标与预览分支必须说同一件事」的逐条断言。旧断言记录的是缺陷本身，按「四不写」直接更新为当前权威行为，不做兼容保留；其余既有断言一条未放宽。 - 验证：`npm run test -- apps/ai-game-creator-shell/tests` 1202 passed / 4 skipped / 0 failed；`src/components/image-editor` 1385 passed；typecheck exit 0；check:encoding 通过；`git diff --check` 干净。	2026-09-11 13:30:14 +08:00
suzmii	5a37ccfd2b	资源卡暴露预览状态，并补「派发决策由内容证据决定」的契约用例 ... 占位分支对「还没读 / 读失败 / 压根不适用」给的是同一个图标，卡面也没有任何文字提示，现场只能看到「没有图」，无法区分是调度没发请求、原生拒绝了读取，还是这类资源本来就没有预览。本轮排查「图片加载不出来」时，这个不可观测性正是反复误判的来源。 - `index.tsx` 的 `ResourceCard` 根节点新增 `data-preview-status`（`idle` / `loading` / `loaded` / `failed`）与 `data-preview-error`（仅失败态给出原因）。排障从此只需读一个 DOM 属性，而不必去猜调度层。纯新增属性，不改变任何渲染分支与调度行为。 - 新增 `tests/resourcePreviewPredicateContract.test.ts`：把「派发决策必须由可验证的内容证据（mediaType，缺失时退路径扩展名）决定，登记标签 `kind` 只能在两者都给不出结论时兜底」钉成不变量。用 7 组「mediaType + 同通道扩展名」× 20 个 `kind` 的全量笛卡尔积断言 `kind` 不能改写预览分支，并断言组合总数等于笛卡尔积（防止将来收窄枚举让断言悄悄变弱）。另附本轮缺陷形状的最小复现（`application/json` + 任意图片类 `kind` 必须落 `document` 而不是 `placeholder`）、mediaType 缺失时由扩展名决定、以及扩展名与 mediaType 冲突时按既有设计由扩展名决定这三组显式合同。 - 该用例在**变异验证**下确实会红：把 `kind` 判定移回第一趟（还原本轮的分叉）后，本文件 4 条用例失败（不变量报出 56 处违规），恢复后全绿。断言不是恒真假守卫。 - 验证：`npm run test -- apps/ai-game-creator-shell/tests` 84 files passed / 1202 passed / 4 skipped / 0 failed；`src/components/image-editor` 1385 passed；typecheck exit 0；prettier 与 eslint 干净；check:encoding 4378 文件；`git diff --check` 干净。	2026-09-11 13:26:17 +08:00
suzmii	cd1aceb3d9	按 rustfmt 折行退出收尾用例：纯格式，无逻辑变更 ... - tests/project.rs：gui_exit_stops_the_preview_and_clears_the_stale_record 里 init_existing_html_project_at 那行超过 rustfmt 行宽（中文按双宽计），按 `cargo fmt --all --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml` 的结果折成两行。 - 用 cargo fmt（不是裸 rustfmt）：裸 rustfmt 会把文件当模块根、跟随 mod 递归格式化整个模块树，本次已有人因此误改 50 个文件。 - 范围核对：`git diff --stat` 只有 apps/ai-game-creator-shell/src-tauri/src/tests/project.rs（1 file changed, 2 insertions(+), 1 deletion(-)），crate 里其余文件本来就是 rustfmt 干净的，未被牵连。 - 门禁：`cargo fmt --all --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml -- --check` 与 `... --manifest-path server-rs/Cargo.toml -- --check` 均 exit 0；`cargo check --locked --all-targets` exit 0；AGC 子集 1198 passed / 4 skipped / 0 failed；四条预览定向用例仍各 1 passed。	2026-09-11 12:47:22 +08:00
suzmii	531392e506	退出路径统一收尾本地预览，陈旧预览记录不再留给下次进入 ... - preview.rs：新增 stop_local_game_preview_on_exit——退出时若 registry 里确有 running 预览，就用 stop_local_game_preview_for_root 把它真正停掉并写 stopped（顺带落 preview.log 与 trace 收尾）。预览服务器是进程内线程，进程一退 URL 就永久失效；不在这里收尾，.agent/manifest.json 会一直写着 running。 - main.rs：handle_game_creator_gui_run_event 的 RunEvent::Exit 分支先做预览收尾，再做既有的 Agent server / runner 关闭；失败按 `preview.gui_exit.stop_failed` 记日志，不阻断退出。 - 语义变更（用户已确认接受）：关窗不再保留预览——退出即停止预览并把记录写成 stopped，下次进项目一律落到资源管理。与"进入项目时按 registry 活体核对"配套：退出路径覆盖正常关闭，强杀 / 断电那类不走退出路径的情况由进入时的核对自愈。不引入 stale DTO 字段（判定仍要活体探测，且会把状态扩到跨端契约与全部消费方）。 - tests/project.rs：新增 gui_exit_stops_the_preview_and_clears_the_stale_record——退出收尾后 registry 归零且 manifest 记录为 stopped。 - tests/sessionPreview.test.ts：补两条 Rust 侧结构性守卫（本仓既有做法：直接解析源码）。① RunEvent::Exit 分支必须出现 preview::stop_local_game_preview_on_exit——这条接线没有别的行为测试覆盖（注册全局 registry 的用例会互相打架）；② 同项目重启预览的替换分支里，收尾必须排在"旧预览是否属于另一个项目"的判定之后。变异验证：把 main.rs 的退出收尾摘掉 → 守卫①立即红灯（已实测）。 - decision-log.md：新增 2026-09-11 决策条目，逐条写下背景（偶发进运行界面的成因链：进程内预览线程 + 随机临时端口 + 退出零清理 + 进门不核对 + 同项目重启覆盖刚写的 running）、A/B/C 三项决策、关窗不再保留预览这条语义变更及"为什么两者都做而不加 stale 字段"、不做什么与验证方式。同文件被 prettier 补了几处标题前空行（格式规范化，无内容变化）。 - 验证：cargo check --locked --all-targets exit 0；Rust 定向用例 restarting_preview_for_the_same_project / replacing_preview_for_another_project / stopping_without_a_live_preview / gui_exit_stops_the_preview 各 1 passed；AGC 子集 1198 passed / 4 skipped / 0 failed；共享组件 1385 passed；typecheck exit 0；编码 4378 文件；git diff --check 干净。	2026-09-11 12:36:08 +08:00
suzmii	66bb240115	进项目时按内存 registry 核对预览活体，陈旧记录不再冒充可运行预览 ... - 新增 features/app-shell/sessionPreview.ts 的 resolveSessionPreviewOnProjectOpen：进入项目时问一次 get_local_game_preview_status（内存 registry 是活体的唯一真相），确实 running 才把它作为本次会话的预览；记录写着 running 而 registry 没有活体时判为陈旧，复用现役 stop_local_game_preview 把落盘记录对齐成 stopped，并同时把会话 manifest 按真相投影成 stopped（否则运行入口会继续拿着打不开的 URL 渲染运行画面）。 - useHomeProjectCreation.ts：enterProjectDevelopment 改为 async，先做这次核对再进工作台，并按核对结果决定会话预览与 manifest 投影；三个调用点（新建项目、创建项目、打开项目）都改为 await。 - preview.rs：同一个项目重启预览时，旧 registry 身份的收尾不再覆盖刚落盘的 running——只有当旧预览属于**另一个项目**时才替它收尾。此前同项目重启会把刚写进去的 running 覆盖成 stopped，下次进项目便丢掉"预览在跑"这条事实（记录反方向失真）。 - preview.rs：stop_local_game_preview_for_root 在没有活体可停、但落盘记录仍是 running 时也把记录收尾成 stopped（stop 的语义变成"真的停干净，包括记录"），因此陈旧记录既可由进入项目触发对齐，也可由用户显式停止对齐。 - tests/project.rs：新增三条 Rust 定向用例——同项目重启后记录仍为 running 且端口是新预览的；换项目启动时旧项目记录写 stopped、新项目写 running；registry 无活体而记录写着 running 时 stop 会把记录对齐成 stopped。 - tests/sessionPreview.test.ts（新增）：五条用例覆盖活体优先、陈旧记录对齐并投影、registry 不可读按没有在跑处理、记录本来不是 running 时不发多余停止命令、无 invoke 时零请求。变异验证：把活体核对去掉（直接信落盘记录）→「registry 里没有活体时不给会话预览」与「registry 不可读」两条立即红灯（已实测）。 - project-development.suite.ts：把「打开项目不查预览状态」那条断言改为「恰好核对一次预览活体」，并保留邻近的 start_local_game_preview 必须为 0 的断言——被新行为取代的是"从不核验"，"开项目不偷偷启动预览"这条原意一字未改。 - PRD §4.1：状态机按当前实现改写（进入项目一律落到 resource-overview；run 的自动进入只认内存 registry 的活体确认；落盘 preview 是记录而非活体，陈旧记录不触发切换也不参与渲染），并把退出收尾一并写进该节说明。	2026-09-11 12:27:31 +08:00
suzmii	1801d2b227	清 AGC src-tauri 既有 rustfmt 欠账：5 个文件纯格式化，无逻辑变更 ... - `check:rustfmt` 跑 server-rs 与 AGC src-tauri 两条命令，CI 在 server-rs 那条就退出，AGC 侧欠账从未被跑到；本提交只做格式化，不改任何语义 - `src/agent.rs`：`mod` 声明与 `pub(crate) use` 按 rustfmt 排序口径调整 `direct_codex_references` 的位置（声明顺序无语义影响） - `src/assets.rs`：`infer_canvas_export_asset_kind` 的 `else if` 条件行重排；两处 `assert!` 参数按 use_small_heuristics 折叠；两个返回 `Result<..>` 的函数签名断行 - `src/project/asset_export.rs`：`resolve_export_source_file` 签名折成单行，`File::open`/`File::create` 两行重排，用例里 `SaveLocalProjectAssetFileInput` 实参折叠 - `src/tests/asset_rename.rs`：两处用例断行/折叠 - `src/tests/asset_delete.rs`：一处 `assert!` 实参折叠及连带重排 - 已用 `cargo fmt -p genarrative-ai-game-creator-shell -- --check <这 5 个文件>` 与整 crate `cargo fmt --all -- --check` 双重验证通过	2026-09-11 12:25:49 +08:00
suzmii	775b3792cd	修 rustfmt：resource_editor 新增用例按仓库格式折行 ... - `editor_api_rejection_reason_from_body` 用例里 3 处 `serde_json::json!(...).to_string().as_str()` 实参按 rustfmt 口径断行 - `editor_api_rejection_reason_from_body("<html>502</html>")` 断言折行 - 连带收掉 `remote-terminal-failed` 的 match 分支：该 arm 因上一提交改宽而超行宽，按 rustfmt 折成块 - `resource_editor.rs` 现在通过 `cargo fmt --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml -- --check`	2026-09-11 12:21:04 +08:00
suzmii	3ed567d99a	运行视图的自动切换只认会话内确认过的预览 ... - index.tsx：自动切运行的那条 effect 从「合并后的预览 URL」收窄为「会话预览 URL」（resolveEmbeddedPreviewUrl(previewOverride)）。manifest.preview 是"上次留下的一条落盘记录"：预览服务器是进程内线程、非 Linux 端口还是随机临时端口，客户端退出后记录仍会写着 running，照着它自动切视图就是把用户丢进一个打不开的运行界面。运行入口（运行 tab、播放按钮）与 runAvailable 一行未动，PRD §4.1「运行入口不可用时仍允许点击…但不切换状态」继续成立。 - useHomeProjectCreation.ts：enterProjectDevelopment 不再把 context.manifest.preview 播种成本次会话的预览（改为 null）。会话预览此后只由活体确认（下一提交）与本次会话里 preview.start / preview.status 的返回值经 onPreviewChange 回流两处写入。 - 有意接受的代价：「回到仍在运行的预览」从自动变成用户点一下「运行」；下一提交会把"确实还在跑"这条路径按活体确认接回自动进入。 - project-development.suite.ts：新增两条用例——① 仅 manifest.preview 为 running（不传 preview）时初始仍是「资源管理」、运行 tab 仍可用、点一下仍能进运行视图；② 会话预览为 running 时自动切到运行表现层。 - 变异验证：把这条 effect 还原成读合并后的 URL（即撤掉本次收窄），用例①立即红灯（已实测）。	2026-09-11 12:07:44 +08:00
suzmii	95c5418c0f	合并 master（#318 写锁等待与可诊断）入 V3 分支 ... - 三个文档冲突按两边都保留解决：decision-log.md、pitfalls.md、实施计划技术方案；两边追加的是不同主题（资源画布/预览/聊天区 vs 写锁），语义无冲突 - Rust 侧 direct_runtime.rs、direct_tool_bridge.rs、project_gates.rs、project.rs 自动合并成功，无手工介入 - 冲突处仅移除 Git 标记行，未删改任何一方内容（每个文件恰好减少 3 行）	2026-09-11 11:33:12 +08:00
suzmii	28bb5800ea	资源总览去掉大标题旁的副标题 ... - 删除资源总览标题栏里那颗副标题的**两个分支**：`${canvasResources.length} 项正式与候选资源` 与空项目时的 `从资源栏目开始整理资源` - 位置：`apps/ai-game-creator-shell/src/view/project-development/index.tsx` 的 `<header className="game-resource-book-main-heading">`（基线 364492de3 的 5867-5871 行那颗 `<span>`，标题栏自 5863 行起） - 同步删除只服务于它的 `.game-resource-book-main-heading > span` 样式，模块内不再留墓碑规则 - 该文案没有承载 `aria-label` 等语义（区域语义一直在容器的 `aria-label="资源总览"` 上），因此不需要把语义迁移到容器，也没有改成"更短的说明" - 全量计数没有丢：同一次改动后由总览第 0 张「所有资源」卡的计数徽标承载，仍是同一份画布投影 - 卡片内部的说明/装饰文案（「打开 UI 交互」「打开角色与对象」「1 个直接子版本」等）保持不动 - 断言：资源总览标题栏整段 `textContent` 恰为「资源总览」（精确相等，不放宽成 `not.toContain`），并复核总览第 0 张卡与「文档」栏目卡的内部文案仍在 - 既有用例没有任何一条断言过这段副标题文案（全仓检索只命中源文件），因此没有"按文案已删更新"或"按四不写删除"的对象；本用例是补上的正向合同断言	2026-09-11 11:28:59 +08:00
suzmii	1cc9a23815	资源总览新增「所有资源」汇总卡与全部资源页 ... - 渲染层新增 `RESOURCE_BOOK_ALL_TARGET = 'all'` 特殊项：跨端契约 `ProjectResourceCanvasCategory` 不加 `'all'`，sidecar schema 不升版，落盘布局的 `section` 也不会出现它 - 资源总览第 0 张卡即「所有资源」：排在全部栏目卡之前，复用同一套缩略图类名/圆角/底色/阴影与栏目标题栏组件，不新增卡片样式 - 该卡的计数徽标取全量资源数，口径等于各栏目计数之和（同一份画布投影，不另算一套） - 画本场景的栏目顺序与资源分组各多一个渲染层入口；`buildResourceBookScenePlan` 对特殊项只出计数与标题栏，不铺卡片，避免同一张资源卡在总览里挂载两份（`data-resource-card-id` 查询与 FLIP 的 `card:*` 键都会撞车） - 新增「所有资源」页：栏目大纲 + 收起资源按钮 + 按栏目分组的滚动卡片网格；卡片复用栏目页同一颗渲染器与卡宽高，容器与网格样式补齐在 styles.css - 该页的卡片显式关掉拖拽（卡片坐标不属于任何栏目画布，写回会污染布局 sidecar），保留选中/播放/菜单交互，并把光标与 `touch-action: pan-y` 交给滚动容器 - 栏目大纲抽成 `ResourceBookOutlineNav`，栏目页与全部资源页共用同一条入口带；渲染出的 DOM 与抽取前一致 - `renderResourceBookCard` 增加可选 `draggable` 参数，`ResourceCard` 的三个移动端指针回调改为可选 - 断言：总览存在「所有资源」卡且为第 0 张、计数等于全量资源数且等于各栏目计数之和、点它进入的页面按栏目分组且每组都挂真实资源卡、场景计划里特殊项不出卡片且整份计划无重复卡片键、全部资源页分组只保留非空栏目且保持总览顺序 - 既有「N 项」徽标断言从全文档文本查找收窄到 character 栏自己的标题栏（新增第 0 张卡后同文案会撞车，收窄而非放宽）	2026-09-11 11:21:03 +08:00
suzmii	6cc929e47d	修复陶泥儿对话外框没把输入区包住：外框底边不再与输入区重合 ... - 根因：`.project-supervisor-message-list` 在文件末尾还留着一条同选择器、同权重的 `bottom: 156px`（"列表在上、输入区在下"那版两盒布局的残留）。它按"后写胜出"把上一轮 bdb07c141 改的 `bottom: 0` 悄悄顶掉，外框底边落在输入区腰上、输入区下半截露在框外， 真机上看到的就是"消息区外框底边与输入区压在一起、外框没把输入区完整包住"。 - styles.css：把那条残留规则换成对话框盒子的最终几何（top/right/bottom/left 全 0， `padding-bottom` 与 `scroll-padding-bottom` 都是 256px）。它位置在文件靠后，同权重后写 胜出，顺带把 `:has(.plan-gdd-surface, .planning-lane-runtime-strip)` 给列表留的 `padding-bottom: 12px` 压回去，滚到底时最后一条消息不会被输入区盖住。 - styles.css：输入区补上第四条边——`max-height: calc(100% - 24px)`（24px = 上下各 12px）。 左右下三边仍显式内缩 12px，上边由 max-height 兜底，于是外框完整包住输入区：四条边都不 与外框描边重合，底边留出 12px 边距（外框底边 0 / 输入区底边 12px）。 - styles.css：窄屏（≤760px）改成一个模型——外框画在列表与输入区共同的父节点 `.project-supervisor-conversation` 上，列表撤掉自己那只框（框里不套框），输入区回到 文档流，靠外框 12px 内边距四周留白、随列高增长不溢出。原来那条窄屏输入区规则权重低于 `.project-supervisor-composer.is-direct-codex` 那条，其实一直是死声明，这次才真正生效。 - tests/chatDialogFrameLayout.test.ts：新增用例，先按真实层叠（媒体查询是否命中 -> 特异性 -> 源码顺序）求生效值，再断言外框四边归 0、输入区四边内缩同一个值、底边与左右留白严格 大于 0、留白 256 = 12px 内缩 + 228px 输入区最高高度 + 16px 间距（228 由编辑器 max-height 140、输入框行距 8、操作排 28px 方钮、输入框下内边距 4、输入区上下内边距 16、 操作条 2 + 30 方钮逐项从真实声明里算出来），以及窄屏下外框/列表/输入区各自落位、输入区 仍在外框节点子树里且交互控件原位。 - tests/appSurface/project-development.suite.ts：把那条按"第一条匹配规则"取值、用 230 估 算的留白断言同步成按声明算出的 228 与实际间距 16，并注明层叠生效值的守卫在新用例里。 - 变异验证：输入区 `bottom: 12px -> 0`（还原"贴死重合"）时新断言失败；外框 `bottom: 0 -> 156px`（还原上一轮残留）时"外框底边必须严格低于输入区底边"失败（-144）。 - 说明：本机无无头浏览器、vitest 未开 `css: true`，像素级观感只能真机复核；这里钉的是 层叠生效的声明级几何关系与"输入区仍在外框节点的子树里"。	2026-09-11 10:36:45 +08:00
suzmii	1da7dc62a0	fix(资源画布): 拖拽写入不再触发其它自动卡重派生补位 ... - useProjectResourceCanvasLayout 新增 AutomaticPositionPolicy（rederive / preserve），取代原先裸布尔 rederiveAutomaticPositions 传参 - 拖拽（manual 意图）写链固定用 preserve：不再丢弃其它自动坐标，其余自动卡原地不动，也不再补位到被拖走的空位 - 资源集合与拓扑身份签名变化仍按 PRD 用 rederive 重派生，关系图就绪后的深度修正不受影响 - 新增 automaticCoordinatesMatch（忽略数组顺序的坐标比较）：手动写入后只在坐标真的变化或有新资源需要落位时才继续排一次资源同步，避免只由排序归一触发的第二次 CAS 写入再次把其它卡补位 - 写入后的 updated / conflict 分支统一按 writePolicy 计算 reconciledAfterWrite，并据此判定是否需要资源同步 - rebuildOptimisticLayout 改为接收策略参数，手动写入后的会话布局同样保持其它自动卡不动 - 新增用例：拖走一张后其余自动卡在所有写入里坐标逐项不变、视图里也不补位；变异验证（把拖拽路径改回 rederive）后该断言失败 - 副作用（已确认接受）：把卡正好丢在另一张卡上时不再自动挪开它，直到下一次资源集合或拓扑变化触发重派生 - 门禁：AGC 1178 passed / 4 skipped / 0 failed，共享组件 1385 passed，typecheck exit 0，编码检查 4374 通过	2026-09-11 10:27:32 +08:00
suzmii	921d86ed44	feat(资源画布): dependency 默认铺排改为层内网格平面，不再退化成一列 ... - 新增 RESOURCE_CANVAS_DEPENDENCY_LAYER_MAX_COLUMNS = 6 与槽位宽高比常量，作为层内网格列数上限 - 新增 normalizedDependencyDepth：落位、层带与层内网格共用同一深度归一，避免同一深度被当成两层 - 新增 dependencyLayerColumnCount：列数 = clamp(floor(sqrt(卡数 × 槽位宽高比)), 1, 6)，是卡片数量的纯函数 - 新增 dependencyLayerGrid：层内网格几何，行高统一取该层最高卡，使层高与层内顺序无关（中位数扫描重排后几何不抖） - 用 dependencyColumnGeometryByDepth 取代 dependencyColumnXByDepth：x 仍只由 dependencyDepth 决定层带基址（depth 仍是唯一横向层级权威），层带宽度 = 列数 × 列间距；全部层为单列时与旧值逐值一致 - 层内按行优先落位，层内排序（稳定 ID 初序 + 两轮左至右/右至左中位数扫描）与深度层级语义不变；网格之外仍按既有向下找空位回避手动坐标与饱和层带 - 移除 dependencyBucketHeight，簇高、簇行数与层内 rank 改用层内网格行数 - 同步 resourceCanvasLayoutModel 测试：新增层内网格平面（12 张同深度 → 4 列 3 行）、重复计算与输入顺序稳定、层带随深度单调且不与换行层重叠、列数封顶 6、手动坐标在自动网格重派生前后逐项不变；同层 3 张卡的环连续性用例改为行优先网格口径 - 影响面：既有项目里已落盘的自动坐标（manuallyPlaced=false）会在下次协调时按新口径一次性重排成平面；manuallyPlaced=true 的历史手动坐标不删除、不迁移、不被自动排序覆盖 - 不新增持久化字段、sidecar schema 不升版，ProjectResourceCanvasSection/Position 契约与 RESOURCE_CANVAS_INITIAL_FIT_MAX_SCALE 均未改动	2026-09-11 10:16:01 +08:00
suzmii	e3616a44cc	补逐栏目断言：资源总览每个非空栏目都必须挂载真实卡片本体 ... 上一轮把「总览其它栏目不画卡片」的回归结论建立在推理上（identity map 由全量投影构建 ⇒ 不会有卡片因身份缺失而不挂载）。本轮把它变成实测。 - 新增 `appSurface > mounts a real card body in every non-empty resource section overview`：自带 manifest，把 `category` 显式写死，让 `character` / `audio` / `document` / `unclassified` / `version` 五个栏目同时非空（外加空的 `ui-interaction` / `scene`），再逐栏目断言 `.game-resource-book-scene-card[data-resource-book-category=…]` 内存在 `.game-resource-card` 本体，并用 `.game-resource-card` 的 `data-resource-card-id` 回查投影结果，证明卡片确实落在被断言的栏目（不是靠「有子节点」这种恒真守卫蒙过去）。`audio` 刻意保持 `idle`（音频不接受可见性预取），用来证明卡片挂载不依赖预览是否已就绪。 - 自带 manifest 而不是改共用 fixture：`addSectionResources` 的四个资产被同一测试后续多处断言引用（例如 `选中资源：待归类 section.md`），给它补 `category` 会把 `section.md` 从「待归类」挪进「文档」，连带打挂那些既有断言。新用例因此只新增、不改动既有断言。 - 分类字段名踩坑记录：manifest 资产上的字段名是 `category`，不是 `assetCategory`（`assetCategory` 是前端投影后的 `ProjectResource` 字段）。先写成 `assetCategory` 时它被静默忽略，`gameCreationAppAssetCategory` 只能按 `kind` 派生，`design-document` / `game-code` 都不是 canonical kind，于是 `section.md` 落在「待归类」、`document` 栏目为空。 - 变异验证（本断言的价值所在）：把 `resources` 改回 `activePageResources`（即回到回归状态）后，本用例与既有 `uses one full-page canvas per resource section with dependency-only guide lines` **双双失败**（`expected null not to be null`）；恢复后两者通过。断言确实守住了这条回归。 - 验证：`npm run test -- apps/ai-game-creator-shell/tests` 81 files passed，1172 passed / 4 skipped / 0 failed；typecheck exit 0；eslint 与 prettier 干净；check:encoding 4374 文件；`git diff --check` 干净。本轮只改测试文件，`src/**` 与 HEAD 逐字节一致（变异验证后已还原并核对）。	2026-09-11 01:59:21 +08:00
suzmii	84b8f5130b	修复资源总览只画当前栏目卡片的问题：拆开身份口径与热预取口径 ... 前一次改动（60d8b8fbb）把 `useProjectResourceCardPreviews` 的 `resources` 从全量投影收窄成当前分页栏目，造成产品回归：该入参不只喂热预取，它同时决定返回的 `identityByResourceId`，而 `renderResourceBookCard` 在身份缺失时 `return null`，于是资源总览（main 态）只有当前分页栏目画出真实卡片，其余栏目只剩栏目标题栏加空的层叠占位。 - 拆成两个入参：`resources` 恢复全量资源投影语义（决定 `identityByResourceId`、缓存与卡片挂载），新增 `eagerResources` 只用于 `eagerPreviewLimit` 计数的热预取，缺省回退 `resources`。两个入参的语义写进 Hook 参数注释，调用方 `index.tsx` 在传参处注明「收窄 `resources` 会让其它栏目只剩标题栏」。 - 纠正前一次提交的说法：**identity map 必须保持全量**，不能跟着热预取一起收窄。热预取可以只喂当前栏目（上一个提交的意图保留、`A → B → 回 A` 会重读 A 可见卡的已知代价也保留），但身份 / 渲染口径收窄会让总览其它栏目不再挂载卡片——技术方案要求「主画布展示各子画布的缩略入口，内部按资源类型显示有限层叠卡片……主画布预览和子画布展开态复用同一套卡片视觉」，这是产品回归而非可接受的行为变更。 - 不使用「身份未知时用 idle 占位兜底渲染」这条备选：它会让总览卡片失去真实预览，观感更差。 - `pitfalls.md` 追加同题排障口径，含通用规则：凡 Hook 入参同时参与「身份 / 缓存 key」与「调度 / 预热」，就不能为优化调度去收窄它，应先确认它还有没有别的消费者。 - 回归用例 `appSurface > uses one full-page canvas per resource section with dependency-only guide lines` 已自行变绿（未改该断言）。验证：`npm run test -- apps/ai-game-creator-shell/tests` 1171 passed / 4 skipped / 0 failed；`appSurface.test.ts` + `useProjectResourceCardPreviews.test.ts` 415 passed；`src/components/image-editor` 1385 passed；typecheck exit 0；check:encoding 4374 文件；`git diff --check` 干净。	2026-09-11 01:47:04 +08:00
suzmii	7fa61231ae	AGC 资源画布两条过期断言跟上新合同，并补项目切换的预览缓存清理行为断言 ... - appSurface > renders one body-first card system：把原先钉「全局只读 1 次」的断言收窄成「同一身份不因重复请求新增物理读取」——热预取之后先让 IntersectionObserver 再报一次可见、再打开一次详情，读取次数必须与快照一致；并先钉住快照非空且读取目标都是 assets/hero.png，避免空集恒真。60d8b8fbb 把热预取改成只喂当前栏目后，用例里每进出一次「角色与对象」都会重读该栏目的可见卡（该 commit 已明确接受这个代价），全局总次数会随进出次数漂移；「同一身份同时只读一次」是 PRD 里真实存在的合同，比总次数更精确，没有放宽。 - appSurface > keeps the resource preview version cache wired and cleared on project switch：60d8b8fbb 删掉了从未被写入的 resourcePreviewVersionByResourceId 死接线（只被 new Map() 初始化与清空，previewVersionByResourceId 恒为空串），断言守的 prop 与其清空语句都已不存在，按「四不写」删除这条形态断言；用例改名 clears the resource preview cache and cancels the old preview scope on project switch。 - 同用例把意图从源码正则换成可执行行为断言（原断言只证明接线存在，不证明缓存真被清）：渲染 A 项目并等卡片预览落到 Blob URL 后切到 B 项目，断言 ① 旧卡片预览的 Blob URL 被撤销、② 旧 scope 的在途读取按旧 scopeId 取消、③ 同一资源以新项目身份与新 scopeId 重新读取。 - 变异验证在 %TEMP% 下的独立 worktree 沙箱里做（未改本工作树产品代码）：去掉预览 Hook 里 loaded 早退 → 第二条用例失败（同身份读取 6→7）；去掉 cancelLocalProjectResourcePreviewScope(previousScopeId) → 第三条 ② 失败；切项目不复用新 scopeId → ③ 失败；拆掉两条撤销 Blob URL 的路径 → ① 失败。 - 未改 uses one full-page canvas per resource section with dependency-only guide lines：沙箱实验证明只把预览 Hook 入参从 activePageResources 换回 canvasResources，该用例即整体通过。它守的「总览逐栏绘制各栏目真实卡片」是被 60d8b8fbb 意外收窄的（renderResourceBookCard 在 identityByResourceId 缺该资源时返回 null，而该 map 从该 commit 起只覆盖当前栏目；其 commit message 只声明了预取口径与重读代价，未声明总览不再绘制其它栏目卡片），属产品回归，已上报，不以改断言掩盖。 - 门禁：ai-game-creator-shell:typecheck exit 0；apps/ai-game-creator-shell/tests 1 failed / 1170 passed / 4 skipped（唯一失败即上面上报的回归；改前 3 failed / 1168 passed）；src/components/image-editor 1385 passed；check:encoding 4374 文件；git diff --check 干净。	2026-09-11 01:33:10 +08:00
suzmii	60d8b8fbb2	资源卡异步解码、热预取只喂当前栏目，并删掉未接线的预览版本 map ... - 资源卡 `<img>` 补 `decoding="async"`，把真机 37.2 MPx 量级的 PNG 解码移出主线程。刻意不加 `loading="lazy"`：卡片已经由资源画本的 `IntersectionObserver`（`rootMargin: 160px`，root 指向真正包含卡片的容器）精确门禁，只对进入可见区及预取边界的卡片发 IPC；再叠一层浏览器视口懒加载会让「预取边界 + 热预取 12 张」读到的视口外卡片被压住不解码，等于白预取。`decoding="async"` 不改变何时加载，与既有调度正交。 - 卡片预览的热预取改为只喂当前分页栏目：原先传的是 61 项全量投影，前 12 张可能落在别的栏目，用户看不到的卡片先占满全局 3 个物理读取槽，看得见的卡片反而要排队。 - 为此把 `projectResourcesByCategory`、`resourcePageCategoryKey`、`resourcePageCategories`、`activePageCategory`、`activePageResources` 整块上移到 `useProjectResourceCardPreviews` 之前并删除原位置定义；`projectResourcesByCategory` 只依赖 `canvasResources` 与 `categoryOrder`，其余只在既有依赖之上派生，上移不引入前向引用。`activePageResources` 合并为单一声明（原先在 `activePageLayoutReady` 之前另有一份同定义局部变量）。 - 已知副作用并接受：Hook 的 `identityByResourceId` 只覆盖当前栏目，因此「A 栏目 → B 栏目 → 回到 A」会重新读取 A 的可见卡。这正是「栏目级热预取」的定义，也符合 PRD §3.3.2「项目 / mode 切换必须清理预览缓存」的口径；代价是来回切换栏目各重读一次可见卡，单张实测 1–7 ms 且仍受全局 3 槽限制。 - 删除 `resourcePreviewVersionByResourceId` 的三处引用与 `useState` 声明。它从未被写入过：只被 `new Map()` 初始化和清空，`previewVersionByResourceId` 恒为空串，属死代码。 - 选择「删」而不是「填真值」：填真 manifest revision 会让每次 manifest 变更把全部缓存 identity 失效并触发全量重读；而现有 identity（`projectPath` / `projectId` / `id` / `category` / `path` / `mediaType`）对不可变素材已经足够——路径变了就是另一个资源。本轮不新增失效判据。 - 遗留：`appSurface > keeps the resource preview version cache wired and cleared on project switch` 断言的是刚被删除的 prop 接线，需要同步删掉该断言；该测试文件当时正被另一个 Agent 在途编辑，按分工不在本次改动内，已上报由主人处理。	2026-09-11 01:04:06 +08:00
suzmii	bdb07c141b	聊天输入区收回对话框内部 ... - 根因：`.project-supervisor-surface.is-direct-codex` 下消息列表与输入区是两只各自带边框、 各自绝对定位的盒子——列表 `bottom: 104px`、输入区 `bottom: 0; left/right: 0`，两盒上下 紧贴。输入区自己那只盒子的左右描边与列表的左右描边接成两条贯穿整栏的竖线，加上列表 只留 24px 底部内边距，最后一条消息还会被不透明的输入区盖住。观感就是"输入框紧挨着 对话框、两侧有突兀竖条"。 - styles.css：消息列表（direct-codex）改为铺满整个会话区（`bottom: 104px` → `0`），它自己 那只带描边和圆角的盒子就是"对话框"；`padding-bottom` 与 `scroll-padding-bottom` 由 24px 提到 256px，给框内输入区留出位置（256 ≈ 输入区最高 230px + 12px 内缩 + 约 14px 间距）。 - styles.css：输入区（direct-codex，含同类选择器共两条绝对定位规则）由贴边改为框内内聚 区块：左右下三边各内缩 12px，圆角 14px 收到与外框同一档 12px；边框、底色、阴影继续用 既有 token（`--platform-surface-border` / `--platform-input-fill`），不新增配色。 - 不改交互语义：输入区仍是同一棵 DOM（编辑器、@ 引用、AI 润色、模型选择、提交按钮全部 原位），只改它在对话框里的落点与留白。 - project-development.suite.ts：新增守卫——对话框盒子四边归 0、输入区三边内缩同一个值、 仍是绝对定位且保留边框与底色、消息列表留白 ≥ 输入区最高高度 + 内缩且与 `scroll-padding-bottom` 同值、编辑器 min/max 高度就是留白算式的来源；并同步既有那条 钉 `bottom: 104px` 的断言为 `bottom: 0`。 - 说明：本机无无头浏览器、vitest 未开 `css: true`，像素级观感只能靠真机复核；这里钉的是 声明级几何关系与"输入区仍在同一棵渲染树里"。	2026-09-11 01:00:10 +08:00
suzmii	3bd4daf5d5	补「回到资源总览」命中区域的守卫断言 ... - 成因回填：分页态标题栏右端的「资源总览」（回到资源总览）按钮点不动，是常驻工具条带 `.game-resource-book-tools` 造成的——它是横跨整行、`z-index: 40` 的绝对定位层，正好盖在栏目标题栏那条带（`z-index: 30`）上，把按钮的命中区域整段吃掉。上一提交撤掉这条带后问题已消失，本次只补守卫，不改实现。 - project-development.suite.ts：新增声明级守卫，钉住浮层提示层（`.game-resource-book-notices`）与返回按钮所在标题栏的层级关系——提示层 `z-index` 高于标题栏（提示要看得见），因此容器必须 `pointer-events: none`、只有提示条自己 `pointer-events: auto`；提示条顶边 ≥ 标题栏 `min-height`，连视觉重叠都不发生；并反向断言常驻工具条带在 styles.css 与 index.tsx 里都已不存在（变异实测：把容器改回 `pointer-events: auto` 该用例立即红灯）。 - project-development.suite.ts：新增渲染级守卫——附件导入失败条在场（提示层挂载）时进入分页态，断言返回按钮不在提示层容器内、不是 disabled，点击后 `data-resource-book-view` 回到 `main` 且「资源总览」region 在场。 - 说明：jsdom 不做布局命中判定，像素级"是否被盖住"只能由声明级的层级/命中声明 + 真机复核确认；渲染级用例钉的是"提示层在场时返回入口仍然渲染、可点、并真的接在返回总览上"。	2026-09-11 00:57:52 +08:00
suzmii	5e29b1bb57	预览链去掉无消费者的摘要计算，并为预览读取加进程内 manifest 缓存 ... - 资源卡预览不再计算 SHA-256：`AgentRuntimeInspectionImage.sha256` 改为 `Option<String>`，读取函数新增 `include_sha256` 开关，门禁、分块读取、漂移与重开身份复核、签名与尺寸校验仍只有一份实现，只在末尾按调用方决定是否算摘要。预览路径传 `false`（它的 `LocalProjectImagePreview` 从来不消费摘要），Agent `image.inspect` 路径继续传 `true`。 - 取摘要改为 `sha256_digest() -> Result`，缺摘要失败关闭；`project_gates.rs` 提前算成 `image_sha256` 再进判定闭包，避免退化成「空摘要 == 记录里的空摘要」而静默通过视觉检查复核；`runtime_tools/media.rs` 改用仓库既有的 `match { Err => return failed observation }` 风格，不引入新的 panic 面。 - 新增 `read_manifest_cached_for_preview`，只接到 `read_local_project_image_preview_at`、`read_local_project_text_preview_at`、`read_local_project_media_preview_at` 三个预览命令，消掉一次画布装载中「每张卡片各读并解析一遍同一份 manifest」的重复开销。`read_manifest` 本体、`read_manifest_for_project` 和写入路径的安装后回读一字未动。 - 缓存命中判据每次重新获取当前文件身份：路径复核 + 非符号链接或 reparse point + 普通文件 + 长度 + mtime + 文件身份（Windows `(volume serial, file index)`，Unix `(dev, ino)`）；失败一律不入缓存，错误语义与 `read_manifest` 完全一致。为此放开 `metadata_is_windows_reparse_point` 为 `pub(crate)` 并新增跨平台 `open_file_identity_key`。 - 写入侧硬做失效：`write_manifest_with_lock_hook` 成功写入后调用 `forget_preview_manifest`。只靠长度 + mtime + 身份堵不住同长度原地改写，显式失效后正确性不再依赖时间戳粒度，读取侧身份复核保留为兜底。 - 收益如实记录：真机项目实测 52 次 manifest 读加解析约 10 ms 量级，并省下约 3.15 MiB 重复磁盘读取。这是消除重复工作的正确改动，但不是性能救命项；用户感知的加载耗时大头仍在资源卡图片解码。 - 决策记录补「AGC 资源卡预览维持 data URL 加纯内存 LRU，不引入 Tauri asset 协议」：正式否决该候选路径，写明原始合同原文（不向 WebView 暴露任意本机文件协议或绝对路径）、打通所需配置（`assetProtocol` 加 `protocol-asset` feature 加 scope 只能 `**/*`）、会绕过的全部门禁（`file.read` 权限、项目边界、登记复核、敏感路径、父目录链接、硬链接、读取漂移与重开身份、按魔术字类型校验、尺寸上限、取消语义与全局 3 permit），以及收益与代价不成比例；同时否决磁盘缩略图缓存。 - `pitfalls.md` 补同题排障口径，含判据陷阱：把「每次启动重读」当成本瓶颈是错的，真机 52 张 PNG 分层实测 Rust 加 JS 合计仅约 0.3 s。	2026-09-11 00:57:33 +08:00
suzmii	f7831348c6	搜索栏改成「临时叫出」的浮层，并撤掉为它引入的工具条带 ... - index.tsx：搜索框不再常驻。常态只在右下角缩放 Dock 末尾留一颗搜索按钮（复用 `game-resource-book-zoom-button`），`Ctrl/Cmd+F` 或点它把浮层叫出来；关闭走本仓既有浮层口径——直接复用美术画布的 `useImageCanvasFloatingOptionDismiss`（Esc / 点外部，Escape 在 document 上截断，不会连带触发画布清选中）。 - index.tsx：浮层打开后自动聚焦搜索框，`resourceSearchRef` 不再是死 ref（PRD「焦点落到资源搜索框」的入口接上了）。 - index.tsx：搜索语义零改动——`setSearchText`、`visibleResources` 过滤、「清除搜索并定位」原样保留；浮层收起不清条件（`type=search` 的原生 Esc 清空被 preventDefault 挡掉），条件生效时 Dock 搜索按钮带 `is-active` 高亮，用户看得出"当前有搜索"。 - index.tsx：撤掉常驻搜索条连带的那条排布带——删除 `resourceBookToolsRef`、`resourceBookToolsHeight`、`resourceCanvasSceneSize()`、ResizeObserver 测高 effect，以及缩放锚点 / 滚轮锚点里减掉工具条带的两处算式；`resourceBookSceneSize` 重新等于管理区盒子。 - index.tsx：状态提示与附件导入失败条移出排布带，落到新的浮层容器 `game-resource-book-notices`（顶部绝对定位，不占流内高度）。 - styles.css：`.game-resource-manager` 去掉 `padding-top: var(--game-resource-book-tools-height)`，`.game-resource-book-scene` 恢复 `inset: 0`，删除 `.game-resource-book-tools` 规则与窄屏 560px 那条只为常驻搜索框写的宽度规则；搜索框改为贴右下角 Dock 向上展开的浮层（`bottom: 58px` = Dock 的 14px + 34px 高 + 10px 间隙，`z-index: 40`）。 - styles.css：新增 `.game-resource-book-notices` 浮层与 `.game-resource-book-zoom-button.is-active`（复用 Dock 按钮的 hover 色，不新增配色 token）。 - tests/appSurface/harness.ts：新增 `openResourceSearch()`——按产品入口打开浮层再返回输入框，`getByLabelText` 在浮层未打开时直接抛错，堵掉"元素在但点不到"那类假绿。 - tests/appSurface/project-development.suite.ts：重写搜索可见性守卫为「浮层不落在标题栏那条带上」（管理区不再有 padding-top、场景 `inset: 0`、浮层底边 ≥ Dock 底边 + Dock 高度、浮层不带 top、提示层顶边 ≥ 标题栏高度），新增浮层开合用例（按钮 / Ctrl+F 打开、焦点落在输入框、Esc 与点外部收起都不清条件），并把既有 5 处搜索用例改为先叫出浮层。 - tests/projectResourceLiveIntegration.test.tsx：「清除搜索并定位」用例改为重新叫出浮层读条件与清空后的值。 - 验证：新增的两条断言已用变异实测不是恒真守卫——去掉自动聚焦、或让关闭顺手清条件，对应用例都会红灯。	2026-09-11 00:56:52 +08:00
suzmii	bb48345206	移除资源画布上的分类筛选条 ... - index.tsx：删掉画布侧 PlatformResourceFilterBar 的用法（「全部 / UI 交互 / 角色与对象 / 场景与环境 / 音频 / 文档 / 待归类」分类 chip 与画布标签 chip）；@ 素材面板与参考图弹窗继续用同一个共享组件，共享组件本身不动。 - index.tsx：随筛选条一起摘掉只为它存在的画布筛选轴——resourceCanvasCategoryFilters / showResourceCategoryFilter / resourceCanvasActiveTags / resourceTagLibrary，并把 visibleResources 里「分类不等于 all 才过滤」「标签必须命中已选标签」两个此后恒真的条件删掉，画布可见资源只由搜索框收窄。 - index.tsx：移除只被筛选条用到的导入（PlatformResourceFilterBar、RESOURCE_REFERENCE_FILTERS、type ResourceReferenceFilter、assetTagsMatchSelection、buildGameCreationAppAssetTagLibrary）与 ResourceCanvasCategoryFilterBySortMode 类型及其默认值构造函数。 - styles.css：删除只服务画布筛选条的 .game-resource-category-filter 规则。 - 不动分区栏目：栏目大纲、栏目标题栏、categoryOrder、projectResourcesByCategory 与「资源总览」入口保持原样。	2026-09-11 00:38:02 +08:00
suzmii	30acd9552c	写入侧产出 canonical kind，读取侧读时重派生自愈存量分类 ... - 写入侧：infer_canvas_export_asset_kind 直接返回 canonical kind（animation → character-animation、ui → ui-design、asset → image），不再让别名表替写入侧兜底 - 写入侧补防御性归一，并新增 canvas_export_asset_kind_is_always_canonical 逐分支钉死返回值为 canonical、且不再写回 ui / animation / asset - 读取侧：gameCreationAppAssetCategory 加收窄覆盖规则——落盘 category 为 unclassified 且 kind 能派生出明确非 unclassified 分类时采用派生值 - 该规则不写迁移脚本、永久自愈：真机 57 条 ui 资产待归类从 58 降到 1，UI 交互从 2 升到 59，仅剩 code 类 game-entry 在待归类（分类表设计口径） - 收窄条件把覆盖窗口压到最小：落盘值本身是明确分类时仍信任落盘值（保留用户在分类与标签面板手动设置的权威性） - kind 派生结果本身即 unclassified 的 image / video / code / publication-material 不受影响，补断言钉住 - resourceCardPreviewRealManifest 由「记录缺陷」改为「守住修复」：断言归位后的 58 → 1 分布与 57 条 ui 全部落 UI 交互 - PRD 与 pitfalls 补记分类取值优先级、读时自愈规则、唯一盲区（手动把可明确分类的资产设为待归类会被覆盖）及写入侧 canonical 化	2026-09-10 23:15:04 +08:00
suzmii	ff42fff61c	按评审意见把写锁等待挪出 runtime worker 并收紧 wait_exhausted 记账 ... - agc_write_file 写路径改经 bridge_write_file_in_blocking_pool 走 tokio::task::spawn_blocking：有界等待是同步轮询（最多约 10 秒），直接在 async handler 里跑会占住 tokio worker，争用窗口内同一轮并行写多个文件时会波及共享同一 runtime 的只读端点与 UI 命令 - 新增用例用默认 current_thread runtime 加心跳任务锁住该性质；把 handler 临时改回同步直调时该用例按预期失败，确认有区分度 - project.write_lock.wait_exhausted 与终态改判一起改为只在真的等过（max_attempts > 1）时发生：hydrate 的单次试探不再写 waitedMs 近似 0 的“耗尽”日志 - 技术方案、decision-log、pitfalls 同步这两条，并补“同步有界等待不能直接跑在 async handler 里”的排障经验	2026-09-10 21:38:48 +08:00
suzmii	b87120445c	Merge remote-tracking branch 'origin/master' into feat/agc-canvas-resource-workbench-v3	2026-09-10 21:24:05 +08:00
suzmii	c5df56d855	补齐资源 kind 别名表：ui 归 UI 交互，game-* 归代码，animation 归角色 ... - TS 侧 GAME_CREATION_APP_LEGACY_ASSET_KINDS 补 5 条别名：ui → ui-design、game-entry/game-script/game-style → code、animation → character-animation、asset → image - Rust 侧 canonical_game_creation_app_asset_kind 同步补齐同一批别名，两侧必须成对维护 - 按拍板口径不往 GAME_CREATION_APP_CANONICAL_ASSET_KINDS 加新 kind，避免出现 ui 与 ui-design 两个同义 kind - 保持 art-spritesheet-slice → icon → ui-interaction 不动 - 补注释写明别名表的职责是「线上值 → canonical」而非仅收历史遗留，画板导出等现役写入侧同样要在这里收口 - 新增 assetKindCanonicalMapping.test.ts：解析 Rust 源码交叉钉住两侧 canonical 目录与别名映射逐条一致，并逐条断言已拍板的 kind → canonical → 栏目口径 - 新增 resourceCardPreviewRealManifest.test.ts：按真机 manifest 逐条形状可执行地数出预览分支与栏目分布（raster-image 52 / placeholder 8 / code 1；unclassified 58 / ui-interaction 2 / scene 1） - 真机取证用例同时钉住「别名只救新登记、不救存量」：57 条 ui 的落盘 category 仍是 unclassified，需读时重派生或一次性回填才能归位 - 修正两条按旧错误栏目断言的既有用例：kind=ui 的上传图归「UI 交互」、animation 视频归「角色与对象」	2026-09-10 21:18:55 +08:00
suzmii	2fefb373d1	修复 AGC 资源搜索框与栏目标题栏挤在同一水平带的重叠 ... - styles.css：新增 `.game-resource-book-tools` 工具条带，搜索框、筛选条与状态提示在里面按流式排布；`.game-resource-search` 去掉 `margin: 10px 12px 0`，尺寸与间距交给工具条带。 - styles.css：`.game-resource-manager` 加 `padding-top: var(--game-resource-book-tools-height, 0px)`，`.game-resource-book-scene` 的 `inset: 0` 改成同一变量让出顶边；管理区与画本场景共用一条实测高度，两者不再落在同一条排布带上（总览态标题栏与分页态栏目标题栏都整体下移）。 - styles.css：`@media (max-width: 560px)` 下搜索框独占整行，窄屏筛选条换行时工具条带变高、场景按实测高度继续下移，不靠 z-index 硬压。 - styles.css：更新工具条带注释，说明 `z-index: 40` 仍保留（高于场景的 20），作用只剩"工具条内容溢出时不被画本盖住"。 - index.tsx：把画本场景以外的流式工具条包进 `game-resource-book-tools`，搜索框挂 `resourceBookToolsRef`，用 ResizeObserver 实测 `offsetTop + offsetHeight` 写入 `--game-resource-book-tools-height`；搜索、筛选、「清除搜索并定位」与 `resourceSearchRef` 全部零改动。 - index.tsx：新增 `resourceCanvasSceneSize()`，视口居中、「适应内容」、总览入场中心、滚轮与缩放锚点都按"管理区盒子减掉工具条带"计算，不再按"场景一直顶到管理区顶端"排布；`handleResourceBookWheel` 与 `zoomResourceBookBy` 补上新增依赖。 - index.tsx：`measureResourceBookOverview()` 改用画本场景自己的 rect 作为总览栏目矩形原点，场景盒子上移后栏目矩形与世界坐标仍严格同源。 - project-development.suite.ts：在既有 CSS 声明级守卫里补断言——管理区 `padding-top` 与场景 `inset` 必须指向同一个 `--game-resource-book-tools-height` 变量，工具条带是绝对定位的独立排布行，栏目标题栏 z-index 低于工具条带；选择器加行首断言，避免误取 `.game-workbench-stage > .game-resource-manager`。 - project-development.suite.ts：在栏目大纲用例里补真实渲染的 DOM 归属断言——搜索框的父链不得命中画本场景或资源总览层，工具条带是管理区直接子节点；该断言在改动前失败、改动后通过，已用"把工具条带类名改掉"的变异验证它不是恒真假守卫。	2026-09-10 21:12:30 +08:00
suzmii	14d1635858	修复游戏版本时间显示 1970 年：createdAt 按 Unix 秒换算成毫秒 ... - 写入侧真实单位是 Unix 秒：project/manifest.rs 的 GameIterationVersion.created_at 赋值为 unix_timestamp()，该函数返回 duration.as_secs() - formatIterationVersionLabel 原来把秒值直接交给 new Date()，被当成毫秒解释，真机因此显示 1970/1/22（1788075047 毫秒 = 1970/1/22 00:41:15，与截图逐秒吻合） - 显示侧改为 new Date(version.createdAt * 1000)，与 ResourceAssetDeleteDialog 和待确认资源编辑创建时间标签的既有秒口径一致 - 给 GameIterationVersion.createdAt 补契约注释，写明单位是 Unix 秒及换算要求，避免后续再按毫秒消费 - resourceCanvasVersionBindingModel 夹具由毫秒改为真实秒值，并用真机取值 1788075047 补断言：年月日必须是 2026/8/30 而不是 1970 - resourceVersionSwitch 夹具同步改为真实秒值，避免继续沿用误导性的毫秒夹具	2026-09-10 21:00:54 +08:00
suzmii	dde860716e	修复资源卡片媒体预览发不出请求：线上 category 改回原生读取分支 ... - 新增 projectResourceMediaPreviewCategory：从卡片预览类型派生原生侧线上 category（art / audio），与画布分区栏目轴解耦 - read_local_project_media_preview 调用点不再传 job.resource.category：该字段自 6 类资产分类轴落地后是画布栏目（unclassified / ui-interaction / …），传给原生侧会被 read_local_project_media_preview_at 以「媒体预览类别只支持 art 或 audio」直接拒绝 - 该回归导致所有走媒体分支的卡片（GIF / SVG / AVIF / BMP / MP4 / WebM / MOV 与音频）读不出预览，只显示占位图标 - previewReadErrorMessage 与 resourceReadKindLabel 改用卡片预览类型判定文案，不再依赖已换语义的 category - 废弃 useProjectResourceCardPreviews 对 projectResourceDisplayKind 的引用，错误文案与读取路由共用同一分类口径 - 预览 Hook 用例补「扩展名图片按 art 分支发出请求」与「音频仅在播放意图后按 audio 分支发出请求」两条断言，直接钉住原生侧线上取值 - 应用层媒体用例补 icon.svg 的 category 必须是 art 的断言，并修正原先描述「媒体读取改传画布栏目」的过期注释	2026-09-10 20:59:22 +08:00
suzmii	71e9ad3133	修复锁失败终态判据漏传平台导致 CI 把权限改判成争用 ... - project_write_lock_permission_is_ambiguous 改为按平台加原始错误码判定（Windows 的 ACCESS_DENIED(5)）；只看 ErrorKind 在 Linux 上会得出相反结论：errno 5 在 Windows 是 ACCESS_DENIED、在 Linux 是 EIO - ProjectWriteLockFailure::Retryable 携带 platform，终态改判与争用文案都用同一次分类的平台，不再依赖宿主 errno 语义 - 终态投影用例显式用 Windows 平台构造失败并补 Unix 反例，两个平台上结论一致；CI 首次推送正是在此失败（2358 passed / 1 failed，left contention / right permission_denied） - pitfalls 补充“判据的每一环都要带平台”的排障经验	2026-09-10 20:46:10 +08:00
suzmii	2f8753f597	AGC 资源画布切换为 6 类资产分类加项目版本栏目（阶段二：投影轴与栏目表落地） ... - 契约层把 ProjectResourceCanvasPosition.section 加宽为 PersistedProjectResourceCanvasSection 并删除旧 ProjectResourceCanvasSection 联合 - 七个分区类型消费点改用 ProjectResourceCanvasCategory：投影、布局模型、布局 Hook、分区高度、依赖图层与画布历史 - RESOURCE_CANVAS_SECTION_ORDER 改为 PROJECT_RESOURCE_CANVAS_SECTIONS，删除 RESOURCE_CANVAS_VISIBLE_SECTION_ORDER - reconcileResourceCanvasLayout 接入读时归一化：旧栏目值按资源当前分区改写 section，坐标与手动标记原样保留 - 归并后的布局与原布局逐项不同，由既有协调路径判定 changed 并写回一次新分区，不引入迁移脚本 - 投影层五个资源入表点统一走 projectResourceCanvasCategory：项目版本独立成栏、Agent 回执归文档、其余按资产分类 - 新增 projectResourceDisplayKind 收敛 manifest 资产 subtype 即 kind 的显示类型口径，projectResourceTypeLabel 不再依赖旧栏目 - 卡片预览、编辑分流、媒体工具条、预览文案与画布历史快照改用显示类型与新分区，历史快照入栈时收窄到现行分区 - index.tsx 删除可见栏目导入与 visibleCategoryOrder，栏目标签由资源筛选唯一中文口径派生并补齐 7 栏 - index.tsx 补齐 7 栏默认视口与 7 个栏目图标（新增 LayoutGrid、Users、PackageOpen，移除已无用的 Code2） - index.tsx 删除 canvasResources 的 code 过滤：只登记游戏代码的项目现在落在待归类栏目并正常显示卡片 - 新增只登记游戏代码项目的 UI 回归用例，覆盖栏目大纲、默认落地栏目与代码卡片渲染 - 测试夹具按新分区轴迁移，新增旧栏目 sidecar 读时归并用例与栏目顺序用例 - 共享测试 harness 的资源卡查询正则允许栏目标签自带空格（UI 交互） - 同步 PRD 与共享记忆决策记录的栏目口径描述	2026-09-10 20:41:19 +08:00
suzmii	06f738dc99	将项目写锁从 project/filesystem.rs 纯搬移到 project/write_lock.rs ... - 新建 project/write_lock.rs：取锁、等待分类、持锁方诊断、残留回收与 4 条锁用例整体搬移，逻辑不变 - project/filesystem.rs 只保留项目文件 IO（1533 → 680 行），锁相关常量、结构、进程判据与用例全部移出 - project.rs 注册 mod write_lock 并 pub(crate) use write_lock::*，crate::project:: 与 crate:: 既有路径不变 - windows_metadata_is_reparse_point 提为 pub(crate)，供 write_lock 复用同一条 reparse point 判据 - agent_db.rs 与 checkpoint.rs 的 PROJECT_FILE_FLAG_OPEN_REPARSE_POINT 导入路径改为 super::write_lock - 同步修正技术方案、Fast GDD 技术方案、decision-log、pitfalls 中指向锁实现的文件路径，并把“拆锁”从后续事项改为已完成	2026-09-10 20:12:28 +08:00
suzmii	eda34187fc	修复 AGC 资源栏目大纲常态不可读：恢复 Dock 底板、栏目图标与完整文字 ... - styles.css：`.game-resource-outline` 常态从 `opacity: 0.68` + `scale(0.86)` + 透明底 + 无阴影，改回完整尺寸（`opacity: 1`、`transform: translateY(-50%)`）并给现有视觉语言的 Dock 底板（`--platform-subpanel-border` 边框 + `--platform-nav-fill` 背景 + 与右下角缩放 Dock 同款阴影 + `blur(6px)`）。 - styles.css：`.game-resource-outline button` 常态列宽由 `0 minmax(0,1fr)` 改为 `18px minmax(0,1fr)`、`gap: 6px`，栏目图标常态 width 14px / opacity 1，不再只在悬停时才出现。 - styles.css：栏目文字 11px → 12px；当前栏目（`.is-active`）常态就带 `--platform-nav-active-*` 的边框、底色和阴影，用户一眼能认出当前分区。 - styles.css：悬停/键盘聚焦保留为同一套 token 的加强（更深的边框、`--platform-nav-active-shadow`、`blur(10px)`），不再靠"常态缩到只剩文字"表达层级。 - 不改交互语义：大纲仍然是 `openResourceBookChild` 的入口，按钮 key、aria-label、aria-current 与未读小圆点全部保持原样。 - 测试：新增 CSS 声明级断言，钉住常态不降透明度、不 scale、有底板，图标常态 14px 且文字 12px（jsdom 不加载 styles.css，可见性只能钉声明）。 - 测试：新增 DOM 用例，断言每条栏目入口同时具备图标与栏目文字，且切换栏目后当前项带 `aria-current="page"`。 - 文档：同步《GameAgent资源自由画板与快速编辑》的「操作边界」与「验收」两条，把"常态缩小、只露栏目文字"改成"常态即可读可点"，并同步 pitfalls 里的对应口径。	2026-09-10 20:11:09 +08:00
suzmii	8c639e5d13	修复项目写锁重试判据用一次元数据观察误判瞬时争用 ... - 项目写锁分类改为只按错误码判定重试性，不再用 path.exists() 决定“要不要等”：真机 6 万次建锁/删锁竞争实测 396-538 例命中“ACCESS_DENIED(5) + 目标不可见”，旧判据会让等待层立刻失败关闭，把毫秒级竞争换成更误导的 ACL 文案 - 新增 ProjectWriteLockFailure（Retryable / Terminal）与 acquire_project_write_lock_failure，有界等待改按类型分流，acquire_project_write_lock 退化为它的文案包装 - Windows 的 ACCESS_DENIED(5) 终态改判移到等待预算耗尽之后：只有真的等过预算且目标此刻仍不存在时才投影成权限拒绝，单次试探保持争用语义 - 锁分类判据改为平台参数传入（project_write_lock_open_failure_for），Linux CI 可覆盖 Windows 分支；替换原先只在 Windows 本地执行的分类用例 - 零等待入口在错误码不可区分时补一句“可能是删除挂起、删除拆链窗口或权限 / ACL 拒绝”，争用前缀逐字不变，调用方既有重试语义不受影响 - PROJECT_WRITE_LOCK_CONTENTION_PREFIX 收口 provider_recovery.rs、planning_session_v2.rs、direct_runtime.rs 三处手写文案 - project.write_lock.wait_exhausted 日志补 projection= 分类，attempts 记为实际尝试次数 - 同步更新技术方案、decision-log、pitfalls，并修正 ownerIsSelf 只比 PID 的表述	2026-09-10 20:07:28 +08:00
suzmii	9196ba3c96	修复 AGC 资源画本框选没有任何颜色：给画本场景根补共享画布根类 ... - index.tsx：`ResourceBookScene` 的场景根 `.game-resource-book-scene` 补上 `genarrative-image-canvas` 类，让共享 `SelectionOverlay` 的框选 token 有定义它的祖先。 - 根因：共享选择框的 `border: 1px solid var(--genarrative-image-canvas-selection-border)` / `background: var(--genarrative-image-canvas-selection-fill)` 没有 fallback，这两个 token 只声明在 `packages/image-canvas-react/src/styles.css` 的 `.genarrative-image-canvas` 根类里，而该根类由共享 `CanvasViewport` 渲染；AGC 只渲染 `SelectionOverlay`、从不渲染根类，声明在计算值阶段被整条丢弃，用户框选时看不到任何选择框。 - 安全性：该根类只有 3 条自定义属性声明、无布局副作用，加 className 不改布局。 - 测试：新增真实 `pointerdown` / `pointermove` 框选用例，断言选择框存在、内联几何非空，且最近的 `.genarrative-image-canvas` 祖先就是画本场景根；去掉根类后该用例失败（已实测）。 - 测试：新增 CSS 声明级断言，钉住根类的描边/底色 token 存在且非透明，消费端仍按 var() 取值（jsdom 拿不到计算色，这里只能钉声明）。 - pitfalls.md：补记"复用共享画布子组件要自己渲染根类"的排查口径。	2026-09-10 20:00:42 +08:00
suzmii	7e6f7555eb	修复 AGC 资源搜索框被 display: none 误关导致的搜索链路死代码 ... - styles.css：`.game-resource-search` 的 `display: none` 恢复成 `display: flex`（原始提交 3a8dff140 里就是 flex，PR #193 重排工作台时被改成 none），并补 `position: relative; z-index: 40`、常态 `align-self: center`、与右下角缩放 Dock 同款的浮层阴影。 - styles.css：`.game-resource-live-notice` 同样补 `position: relative; z-index: 40`；「清除搜索并定位」按钮只在这条提示条里，提示条被画本场景盖住时搜索链路依旧是断的。 - 根因（堆叠顺序）：资源卡与栏目标题栏都画在 `.game-resource-book-scene`（absolute + z-index 20，子画布态还有一层不透明点阵底）里，而搜索框与提示条是 `.game-resource-book-manager` 的流式子节点；定位元素按绘制顺序整体盖在流内内容之上，所以只放开 display 等于"画了但看不见、点不到"。 - 可见性口径：AGC 的 vitest 没开 `css: true`、不加载 styles.css，`toBeVisible()` 在这里是恒真的假守卫；新增的守卫按本仓既有口径读 CSS 源文件做声明级断言（不是 display:none、z-index 高于画本场景）。 - 行为用例：总览态输入即过滤总览摞上的卡片；分页画布态同一搜索条件继续生效、清空后卡片恢复，证明这条链路确实由搜索框驱动。 - 端到端用例：搜索条件挡掉刚提交的新素材时保留条件并提示，点「清除搜索并定位」后清空搜索并定位选中新素材。	2026-09-10 19:59:52 +08:00
suzmii	59cab3d9fd	Merge remote-tracking branch 'origin/master' into fix/issue-318-write-lock-classification	2026-09-10 19:58:05 +08:00
suzmii	6f09bf3a00	AGC 资源画布分区轴改为 6 类资产分类加独立项目版本栏目（阶段一：契约与读时映射） ... - 契约层新增 PROJECT_RESOURCE_CANVAS_SECTIONS：6 类资产分类加末尾独立的项目版本栏目，并补齐分区类型 - 契约层新增旧四 / 五栏目取值白名单、Persisted 联合类型与两个类型守卫 - Rust 契约 ProjectResourceCanvasSection 增补 7 个现行 variant 并保留 Code / Art 旧值，新增同名分区常量 - Rust 契约不升 game-creator-resource-layout.v1 版本、不给未知 section 加兜底，损坏 payload 继续失败关闭 - 新增 resourceCanvasSectionMapping.ts：旧栏目到现行分区的映射表、回落栏目与读时归一化 - 读时归一化只改写 section，x / y / manuallyPlaced 原样保留，无法归并时沿用既有丢弃行为 - resourceProjectionModel 把扩展名分类器更名为 projectedResourceKind 并收敛为准入与显示类型 - resourceProjectionModel 新增 projectResourceCanvasCategory：项目版本独立成栏、Agent 回执归文档、其余按资产分类 - Rust resource_layout 测试夹具改用现行分区值，并新增既有旧 section sidecar 仍可读取的用例 - 新增 resourceCanvasSectionMapping 测试：旧值乘目标栏目矩阵覆盖坐标保留、section 改写、changed 判定与回落列不变量 - projectResourceProjectionModel 测试新增 7 栏分区投影、项目版本独立成栏与只登记游戏代码项目落在待归类 - 同步 PRD、GameAgent 资源自由画板技术方案、AGC 实施计划与共享记忆决策记录的分区口径	2026-09-10 19:57:34 +08:00