3365 Commits

This Branch

This Branch

All Branches

Author	SHA1	Message	Date
suzmii	a5aba86493	修 rustfmt：editor_project 新增行按仓库格式折行 ... - `ensure_editor_image_edit_source_kind_allowed` 的 `is_none_or(...)` 折叠为仓库 rustfmt 口径的换行 - 白名单用例里 `ensure_editor_image_edit_source_kind_allowed(Some("art-spritesheet"), Some("video"))` 断行 - `is_game_creator_resource_editor_generation(Some(&json!({})))` 断言断行 - `let queued_payload: Value = serde_json::from_str(...)` 折行 - 仅 `server-rs/crates/api-server/src/editor_project.rs` 一个文件，无其他文件被 rustfmt 改动	2026-09-11 12:08:06 +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	364492de37	Revert "文档同步：资源管理页改为栏目分页纵向滚动网格" ... This reverts commit c2b851cc36.	2026-09-11 11:07:59 +08:00
suzmii	c2b851cc36	文档同步：资源管理页改为栏目分页纵向滚动网格 ... - PRD §3.3：栏目页改为纵向滚动网格，顺序由 sidecar 记录的 (y, x, resourceId) 读序推出，新增列数控件与栏目内拖拽排序条文 - PRD §3.3.1：三阶段改写为当前形态（本体卡保留；阶段二改为栏目分页网格；阶段三改为未排序栏目的初始顺序派生） - PRD §3.3.2：可见性预取口径改为以栏目滚动容器为交叉根 - PRD §5.2：实现状态与字段语义改为「x / y 只承载栏目内顺序」，新增顺序阶梯、已排序栏目新资源追加末尾、列数偏好与关系说明条文 - PRD §5.2.4：删除 viewport、wheel、拖动改写坐标等画布条文，改为网格、列数与拖拽排序 - PRD §5.2.5：手动拖动合同改为拖拽排序合同 - PRD §5.2.6：删除资源依赖关系图层整节 - PRD §7.2：验收改为顺序持久化；§7.3 依赖关系图验收整节删除；§7.5 重写为栏目分页纵向网格验收，新增「纵向滚动无横向溢出」与「列数被记住」两条判据 - PRD §6/§8：分阶段范围与非目标同步 - 技术方案：原《GameAgent资源自由画板与快速编辑》改名为《AGC资源管理页纵向网格与排序》，重写为当前形态（页面形态、栏目内顺序、列数偏好、拖拽排序、关系说明），保留权威数据、焦点竞态与派生编辑条文 - 实施计划：资源卡与资源管理页边界改为栏目网格、顺序落盘、列数偏好与滚动容器可见性 - decision-log：新增 2026-09-11 决策（含用户明确判断优于 PRD 的事实依据，以及有意推翻 1da7dc62a） - pitfalls：整体改写「AGC 资源管理页真正自制的交互面」条目 - docs/README.md 与 document-map.md：更新改名后的专题文档入口	2026-09-11 11:00:31 +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	dcb750c318	补记跨层字段名静默忽略的排障口径，并把逐栏目用例提为首选证据 ... - `pitfalls.md` 新增「manifest 资产分类字段写错名会被静默忽略，跨层字段名相近时尤其危险」：manifest 上的字段名是 `category`，而 `assetCategory` 是前端投影后 `ProjectResource` 的字段名，写错层不报错也不告警，本文档记录现象、原因、处理与通用规则（「设置无效但没有任何报错」时第一优先怀疑字段名或层级错配）。 - 同文件「预览 Hook 的资源入参收窄会连带收窄 identity map」那条的验证行改为以新用例 `mounts a real card body in every non-empty resource section overview` 为首选证据：它逐栏目覆盖五个非空栏目并含变异验证；既有 `uses one full-page canvas per resource section with dependency-only guide lines` 降为补充（只覆盖一两个栏目）。 - 只追加与就地更正该条验证行，未重排任何既有条目。	2026-09-11 02:00:38 +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	1ac8cc3eca	补记本轮 AGC 修复的排障口径与既有约定 ... - pitfalls.md 新增「资源搜索栏改成临时叫出的浮层」条目：写清"回到资源总览点不动"的两层成因（横跨整行、z-index 40 的透明工具条带盖在 z-index 30 的栏目标题栏上吃掉命中区域；管理区 padding-top 与场景 inset 只为给搜索框腾带子）、浮层的几何口径（bottom: 58px = Dock 14px + 34px 高 + 10px 间隙，刻意不写 top；提示层 top: 58px = 标题栏 42px + 16px）、必须钉住的两条（提示层 pointer-events: none + 提示条 auto；收起不清搜索条件、由 Dock 按钮 is-active 表达），以及门禁为什么抓不到（jsdom 不做命中判定）。 - pitfalls.md 新增「画布侧分类筛选条已移除」条目：记录用户口径、只移除画布这一处用法而保留共享组件、随它删掉的画布筛选轴，以及"不要顺手改分区、将来恢复要重新设计入口"。 - pitfalls.md 新增「项目对话输入区必须留在对话框内部」条目：记录两只绝对定位盒子上下紧贴的成因、对话框=消息列表盒子 + 输入区三边内缩 12px 的做法，以及列表留白 256px 与编辑器 min/max 高度必须成对维护。 - 本次只补文档，不改代码；编码检查 4374 文件通过，文件保持 LF。	2026-09-11 01:24:17 +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
lhk229	11c8cbdf67	Merge pull request '修复 AGC Direct 写通道项目锁零等待与持锁方不可诊断' (#320) from fix/issue-318-direct-write-lock-wait into master ... Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/320	2026-09-10 21:43:37 +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	df9c32b5ea	记录 kind 别名只救新登记不救存量 category 的陷阱 ... - 补记 ui 资产落待归类的完整成因链：kind 兜底 image 再经 image → unclassified 误分 - 写明 register_local_asset_entry 命中同路径时不重算 category，故存量 57 条无法自愈 - 写明读取侧必须信任落盘 category 的原因：存在用户手动改分类的正式链路 - 列出三个根治选项供拍板：读时重派生 / 一次性回填 / 只改写入侧 - 记录别名表在 TS 与 Rust 各有一份实现、必须成对维护，以及交叉守卫位置	2026-09-10 21:19:19 +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
lhk229	e8c5d2e247	Merge branch 'master' into fix/issue-318-direct-write-lock-wait	2026-09-10 21:13:23 +08:00
lhk229	ab86efa421	Merge pull request '停止追踪误提交的本地文档' (#323) from rm/local-docs into master ... Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/323	2026-09-10 21:12:38 +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	df4168f71f	记录资源预览读取分支与版本时间的排查口径 ... - PRD 明确队列身份用的 category 是资源分区栏目、只用于前端去重与布局，不作为 IPC 入参 - PRD 明确 read_local_project_media_preview 的线上 category 是原生读取分支，只接受 art / audio，须由卡片预览类型派生 - pitfalls 新增「媒体预览 category 是读取分支而非栏目」：记录阶段二把用例一起改成错误行为导致门禁失守，并写明现有守卫位置与实测失败口径 - pitfalls 新增「versions[].createdAt 是 Unix 秒」：记录夹具与实现一起错导致门禁失真，以及已知秒值断言年月日的验收口径	2026-09-10 21:05: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
lhk229	a12d18c1cd	停止追踪误提交的本地文档 ... 从仓库索引移除 local-docs 下的 11 份本地过程文档 保留当前工作区本地文件，不新增或修改忽略规则	2026-09-10 13:00:26 +00: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	bf63766d88	给 SpacetimeDB 冒烟用例的杀进程断言加局部有界超时：只改这一条，不动全局预算 ... - spacetime-editor-idempotency-smoke.test.ts：terminates a live standalone-shaped child process 补第三参 20_000，并加注释写明这是负载敏感的局部超时。 - 性质说明：这是局部有界超时，不是放宽判据。断言 child.exitCode !== null || child.signalCode !== null 一字未动，全局 testTimeout 与 maxThreads 也未动。 - 为什么不加注入桩：该用例的存在意义就是验真实杀进程路径（spawn 真实常驻 node → stopStandalone → Windows 上 spawn taskkill /PID /T /F 杀进程树并等退出）。加桩等于把被测对象换掉，比放宽断言更隐蔽，因此明确不采用注入桩。 - 为什么需要：这两个真实进程的启动与回收在全并行负载下会明显超过默认 5000ms；单独跑实测 167ms，全仓并行时曾撞满 5000ms 上限。 - 上限仍具约束力：stopStandalone 自身对 SIGTERM → SIGKILL 只有 5s 有界等待，而 runTaskKill 与 SIGKILL 之后的 once(child, 'exit') 都没有内部超时，20s 外层上限仍能抓住真实挂死。 - 已实测第三参在当前 vitest 0.34.6 生效：临时把该值改成 1 时复现 Test timed out in 1ms，改回 20_000 后该文件 4 passed。	2026-09-10 20:00:58 +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
suzmii	180a157982	同步 pitfalls 中失效的 ACL 桩名称并补注入点说明 ... - pitfalls.md：把「测试超时补充」里引用的 persistenceOptions 改为当前实际使用的 skippedWindowsAclOptions，避免文档指向已不存在的名称。 - pitfalls.md：补一句 prepareSwarmTestRuntimeConfig 暴露的可选 secureWindowsPath 注入点、默认 null 走真实实现，以及单次调用最多加固 3 次的事实。	2026-09-10 19:56:02 +08:00
suzmii	a698c9170c	AGC 配置向导与隔离配置用例统一改传 ACL no-op 桩 ... - agentSwarmTestEntry.test.ts：新增模块级 skippedWindowsAclOptions，仅 win32 下为 { secureWindowsPath: async () => {} }，其它平台为空对象。 - agentSwarmTestEntry.test.ts：atomically replaces a private AppData config file 的两次 writeGameCreatorConfigAtomically 传入该桩，3663ms → 24ms，不再只剩 27% 超时余量。 - agentSwarmTestEntry.test.ts：moves the default LLM to primary config and lets later GUI saves win 原本的局部 persistenceOptions 收敛为同一份模块级常量，去掉重复声明。 - agentSwarmTestEntry.test.ts：isolated Swarm runtime config 的三处 prepareSwarmTestRuntimeConfig 传入该桩，privately copies 1948ms → 84ms，refuses to delete 1331ms → 79ms。 - 断言零改动：这几条用例在 win32 下本就不校验 ACL（mode / dev / ino 断言全部在 process.platform !== 'win32' 分支内），非 win32 下该常量为空对象、行为逐字不变。 - 实测：该文件 13.59s → 1.35s，文件内最慢用例从 3663ms 降到 84ms。	2026-09-10 19:55:58 +08:00
suzmii	ec6973605b	给隔离测试配置加上可选的 Windows ACL 加固注入点：默认真实实现 ... - agent-swarm-test-chat.mjs：secureWindowsPrivateRuntimePath 增加可选第三参 secureWindowsPath，传入时直接调用它，不传时完整保留原有的 await import + secureWindowsGameCreatorPathForCurrentUser 调用。 - agent-swarm-test-chat.mjs：copyPrivateRuntimeConfigEntry 增加可选第五参 secureWindowsPath，并透传给上面的加固函数。 - agent-swarm-test-chat.mjs：prepareSwarmTestRuntimeConfig 增加可选第三参 { secureWindowsPath = null } = {}，透传给运行配置目录加固与两次配置文件复制。 - 生产路径行为逐字不变：默认值为 null 时 if 分支不进入，执行的原语句与改动前完全一致；唯一生产调用点仍按单参调用（prepareSwarmTestRuntimeConfig(sourceConfigDir)）。 - 加这个接缝的原因：Windows 上每次私有路径加固都要拉起一个真实 powershell.exe（本机实测约 0.6 秒 / 次），一次 prepareSwarmTestRuntimeConfig 在双配置文件场景最多加固 3 次，只校验隔离与清理语义的用例不该为此耗掉 vitest 的 5000ms 默认预算。	2026-09-10 19:55:52 +08:00
suzmii	fc5adf48aa	记录 AGC 配置向导单测的 Windows DACL 子进程超时坑 ... - pitfalls.md：在「终端真实测试不能混用配置参数、stdin EOF 和持续预览」下补一条测试超时补充，紧接既有的 Windows PowerShell 参数条目。 - 内容：配置向导读路径与写路径都会加固私有目录与配置文件，没拿到 secureWindowsPath 桩时 Windows 上每次调用各拉起一个真实 powershell.exe（本机实测约 0.6s / 次）；只桩写不桩读会累计 9 次加固、约 5.5s，稳定撞上 vitest 默认 5000ms 并报 Test timed out in 5000ms。 - 结论口径：只校验配置分层优先级、不校验 ACL 的用例，读写路径必须带同一份 persistenceOptions；确实要覆盖私有 ACL 的用例才保留真实加固并自行留足超时预算。	2026-09-10 19:34:04 +08:00
suzmii	2570831779	修复 AGC 配置向导持久化用例在 Windows 上稳定超时：读路径补上 ACL 桩 ... - agentSwarmTestEntry.test.ts：readGameCreatorWizardConfigState 的三处调用补传 persistenceOptions，读路径不再拉起真实 powershell.exe 去加固私有 DACL。 - agentSwarmTestEntry.test.ts：在 persistenceOptions 定义处补注释，说明读路径同样会加固、读写都要带桩，避免后续再漏。 - 失败形态：单跑该文件稳定 1 failed | 124 passed，报错为 Test timed out in 5000ms，不是 expected / actual 断言不符。 - 根因：该用例只校验配置分层优先级（local 覆盖 primary → 向导写入后剥离 local 的 llm → GUI 后写 primary 获胜），但三处读路径都没传桩；每次 readGameCreatorWizardConfigState 会加固目录、主配置、本地配置各一次，三处读累计 9 次 powershell.exe 子进程。逐段实测 5474.9ms / 5494.9ms，正好压过 vitest 默认 5000ms。 - 基线定性：8f96b05f6 上同一用例同样失败（连续两次 1 failed | 124 passed，同样报 5000ms 超时），且该用例与 game-creator-config-wizard.mjs、agent-swarm-test-chat.mjs 在本批前后逐字节一致（blob 相同），故不是本批引入的回归。 - 未放宽任何断言：补桩后该用例 5500ms → 39ms，本文件 13.6s → 8.7s，断言与断言语义均未改动。	2026-09-10 19:33:58 +08:00
suzmii	cb76aadb48	AGC 输入区三处观感修复：AI 润色归位、@ 面板筛选条单行、引用 chip 原子化 ... - styles.css：把 direct-codex composer 下广播式的 `.project-supervisor-composer button` 规则 收窄到 `.project-supervisor-submit-button`（含 svg 那条与 media query 里那条）， 并给 `.resource-reference-input-actions` 补 `grid-column: 1 / -1` 让输入区操作排独占一行 - styles.css：`.resource-reference-input-actions` / `.resource-reference-input-at` 撤掉绝对定位， 操作排回到网格文档流，与输入框右下角对齐，不再浮在文本区中间 - styles.css：`.resource-reference-input-polish` 与 `.resource-reference-input-restore` 并入 `@` 按钮同一条尺寸规则（28px 方钮、8px 圆角、同 hover/disabled 观感） - styles.css：输入区状态行（润色中/润色失败）改为与应用排同一行，不再单独占一行顶高 22.8px - styles.css：direct-codex 输入框 padding 收为 `12px 15px 6px`，窄屏 `10px 12px 6px` - styles.css：`.resource-reference-chip` 的 `×` 删除按钮不再被 broadcast 规则摘出 chip - PlatformSegmentedTabs.tsx：分段页签 item 加 `whitespace-nowrap`，中文不再逐字竖排 - packages/shared/styles.css：补 `.scrollbar-hide` 实现（该类名一直被 `layout="scroll"` 引用但仓库未定义） - ResourceReferenceNode.tsx：`getTextContent()` 改为单个 U+FFFC 占位符并显式实现 `getTextContentSize()`，引用成为真正的原子内联节点（1 个引用 = 1 个字符） - tests/resourceReferenceInput.test.tsx：新增「1 个引用 = 1 个字符」与「chip 自带删除、一次删净」两条断言 - tests/appSurface/project-development.suite.ts：把 composer 按钮样式断言收窄到提交按钮， 并新增一条反向断言，钉住「广播到 composer 下所有 button」的规则不再出现	2026-09-10 19:05:57 +08:00