GenarrativeAI/Genarrative
11
0
Fork 0
Code Issues 21 Pull Requests 4 Actions Packages Projects 3 Releases Wiki Activity
3,372 Commits 24 Branches 4 Tags
669c71d7e8975d96c06441fb589710020685edfa
Commit Graph

1383 Commits

Author SHA1 Message Date
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 分支
Project CI / Repository checks (pull_request) Failing after 1m3s
Details
Project CI / Frontend tests (pull_request) Failing after 2m48s
Details
Project CI / Backend tests (pull_request) Failing after 4m27s
Details
Project CI / Native shell tests (pull_request) Successful in 17m21s
Details 
- 三个文档冲突按两边都保留解决：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 记账
Project CI / Repository checks (pull_request) Successful in 3m18s
Details
Project CI / Frontend tests (pull_request) Successful in 4m3s
Details
Project CI / Backend tests (pull_request) Successful in 7m25s
Details
Project CI / Native shell tests (pull_request) Successful in 19m35s
Details 
- 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 CI / Repository checks (pull_request) Successful in 6m17s
Details
Project CI / Frontend tests (pull_request) Successful in 8m23s
Details
Project CI / Backend tests (pull_request) Successful in 12m7s
Details
Project CI / Native shell tests (pull_request) Successful in 25m6s
Details 
- 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 CI / Repository checks (pull_request) Successful in 2m37s
Details
Project CI / Frontend tests (pull_request) Successful in 3m30s
Details
Project CI / Backend tests (pull_request) Successful in 6m36s
Details
Project CI / Native shell tests (pull_request) Failing after 13m57s
Details 
- 新建 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
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 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 原子化
Project CI / Repository checks (pull_request) Failing after 15s
Details
Project CI / Backend tests (pull_request) Failing after 15s
Details
Project CI / Frontend tests (pull_request) Successful in 3m5s
Details
Project CI / Native shell tests (pull_request) Successful in 18m26s
Details 
- 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
suzmii c20e28bed0 修正 AGC 快速编辑 4xx 失败原因取值：优先 details.message 并附 provider 与素材类型上下文 
- `editor_api_rejection_reason` 取值顺序改为 `error.details.message` → `details.message` → `error.message` → `error` 文本 → 顶层 `message`
- 平台把所有 4xx 兜底成「请求参数不合法」，真实原因写在 `details.message`，原实现只读 `error.message` 导致用户永远看不到原因
- `details` 有值时附带 `provider`，并透出 `assetKind` / `mediaType`，非 BAD_REQUEST 的稳定错误码照旧透出
- 抽出同步函数 `editor_api_rejection_reason_from_body` 并补定向用例，钉住取值顺序、截断与兜底行为
 2026-09-10 19:01:09 +08:00
suzmii 8c74e5f97c 修正 AGC 图片快速编辑的 400 判据测试：补 art-spritesheet / ui 正向用例并钉住请求级链路 
- 服务端白名单用例改为按静态图集合断言，新增 `art-spritesheet` / `ui` / `ui-prototype` / `game-art` / `game-background` / `art-spritesheet-slice` 正向用例
- 保留 `future-kind` / `video` / `audio` / `image-sequence` / `character-animation` / `document` / `code` 负向用例，并补 mediaType AND 门用例
- 新增请求级回归用例 `game_creator_client_quick_edit_accepts_local_manifest_static_image_kinds`，按 AGC 客户端真实请求体（source 已改写为 ai-game-creator-client）覆盖放行与拒绝两侧
- 新增 `game_creator_client_source_is_recognized_as_game_creator_resource_editor`，把 source 别名与队列 consumer 判定钉在同口径
- 修正 icon 相关旧断言：`icon` 已是共享契约静态图类型，改断言 non-static 媒体仍被拒
 2026-09-10 19:01:04 +08:00
suzmii 7d0f5c68fe 快速编辑浮层样式照搬美术画布：逐条搬真实规则，补回共享组件的 Tailwind 来源 
- resourceCanvasChrome.css：删掉手写的近似样式，从网页端 src/index.css 逐条搬入 AGC 实际用到的 image-canvas-editor__* 规则——生成 composer 基座（grid 布局、42rem 宽、1.45rem 圆角、双阴影）、generation-prompt（--auto-grow-editor-* 变量 + 聚焦态）、composer-footer 五列网格（修掉底部一行挤在一起、对齐混乱）、option-cluster / option-popover-anchor 及其 --dimensions / --model 变体、option-popover 与它的 sections / section / title / items / items--card / items--model、option-popover-choice 及 --ratio / --model 与 aria-pressed 选中态、ratio-wireframe 六个比例线框、option-selected-check、mud-point-inline、generation-submit 三态、quick-edit-panel / --quick-edit / quick-edit-footer / quick-edit-prompt / quick-edit-submit 这一组面板专属覆盖。
- resourceCanvasChrome.css：补入提示词输入框依赖的 auto-grow-text-area 一族规则（外层尺寸变量、content 内边距、placeholder、viewport 与 OverlayScrollbars 竖条），原来只给了裸边框和 padding，所以输入框看着很素。
- resourceCanvasChrome.css：保留/新增的宿主规则只有美术画布没有的那几项——工具条与面板的层级、锚点 transform、窄屏宽度；面板的 overflow 由 auto 改成 visible，因为 AGC 的下拉弹层是就地渲染、没有 portal，滚动容器会把它裁掉。
- styles.css：新增 @source 指向 src/components/image-editor 与 src/components/common。这两个目录不在 AGC app 根下，Tailwind 自动探测扫不到，组件自带的工具类（h-3 / rounded-full / inline-flex / text-slate-700 …）在 AGC 里根本没生成，是「样式和美术画布对不齐」的另一半根因。
- 选中工具条上一轮已按真实规则改好的部分原样保留，未回退。
 2026-09-10 18:59:33 +08:00
suzmii f49ff61ddc 资源画布浮层接上美术画布的关闭时机：空白/Esc 清焦点，快速编辑点外部即收 
- 新增 resourceCanvasFocusModel：把「这次 pointerdown 要不要清画布焦点」「快速编辑浮层是否接管点外部关闭」「宿主 Escape 是否归资源画布」抽成纯判据，逐条对齐美术画布 clearCanvasFocus() / closeTransientEditorPanels() / clearCanvasSelection()。
- index.tsx 画布空白左键 pointerdown 调 clearResourceCanvasFocus()：清空选中（选中工具条随之收起）并关闭快速编辑浮层，与美术画布 useImageCanvasStageInteractions 的空白分支一致；中键/空格平移分支不清，避免平移顺手丢选中。
- 快速编辑浮层复用共享 hook useImageCanvasFloatingOptionDismiss：document 上接管 click 与 Escape，点整个资源画布以外即关，点边界内（含模型/比例下拉 .image-canvas-editor__portal-menu）保留；宿主弹窗（资源面板/生成素材/分类与标签/重命名/恢复队列）开着时不接管，避免清掉资源面板共用的多选。
- 选中工具条补 window 级 Escape：与美术画布 clearCanvasSelection() 同口径清空选中；下拉弹层打开时共享 hook 在 document 上截断，浮层优先收内层。
- 生成为中的快速编辑面板不关（status === 'generating'），保留「修改中」状态与失败重试入口。
- 新增定向测试：交互目标判据、生成中不关、宿主弹窗让位、点边界外关闭、Esc 两态关闭、只有工具条时点外部不清选中、模型/比例下拉点外部与 Esc 关闭。
 2026-09-10 18:58:15 +08:00
suzmii 8f96b05f6e 资源画布工具条接回下载按钮：走资源面板同一条真链路并收紧放行判据 
- index.tsx 把资源面板的保存流程抽成共用 saveProjectResourcesToDisk（原生保存对话框 + save_local_project_asset_file），资源面板改为委派调用，不再有第二份保存实现

- index.tsx 工具条 onDownloadLayer 由空回调改为调用该共用 handler，回执写进 resourceWorkbenchNotice；不可导出的资源仍直接返回

- resourceCanvasToolbarModel.ts 把 download 加回 supportedActions，判据是 isResourceCanvasExportable（拿不到本地文件路径就不渲染），不按媒体类型放行

- resourceCanvasToolbarModel.test.ts 期望值随判据重算为 [quick-edit, download] 或 [download]，并补 download 放行与拒绝两侧用例（空 path、虚拟版本条目）

- project-development.suite.ts 音频工具条按钮集合断言更新为 [分类与标签, 重命名, 下载按钮]，并新增两条真链路断言：工具条下载打到 save_local_project_asset_file、资源面板下载仍打到同一命令

- appSurface.test.ts 在入口文件 mock 原生对话框，只替代用户选择目标路径这一步；放别处注册会晚于真实模块实例化
 2026-09-10 18:05:15 +08:00
suzmii 93ddb841cd 抽出资源落盘判据 isResourceCanvasExportable，资源面板与工具条共用一条口径 
- resourceCanvasAssetTransferModel.ts 新增 isResourceCanvasExportable：只有拿得到可落盘本地文件路径的资源（version 为空且 path 非空）才允许保存

- resolveResourceCanvasPanelEntries 的 downloadable 改为调用该判据，去掉内联的同一段表达式

- 纯重构，资源面板行为不变；目的是让画布工具条的下载放行判据与资源面板使用同一个权威口径，不再写第二份
 2026-09-10 18:05:02 +08:00
suzmii c9413fae0c 补资源画布工具条动作模型定向测试，把放行判据钉在测试里 
- 新增 tests/resourceCanvasToolbarModel.test.ts：直接覆盖 resolveResourceCanvasToolbarActions，此前该模型零直接覆盖

- 逐条钉住当前真实接通的动作集合：栅格图片与角色资源只放行 quick-edit，音频/视频不再放行 redraw，角色资源不再放行 character-animation

- 覆盖派生门禁：未登记 manifest 资产且无已完成任务产物背书不放行、只认已完成任务的栅格产物、非栅格图片不放行

- 判据出处为 docs/project-memory/shared-memory/pitfalls.md 的「渲染出来的动作必须真的能跑通」
 2026-09-10 17:53:25 +08:00
suzmii ecca7050b5 音频资源工具条断言改判据：不再要求渲染空回调的改造按钮 
- project-development.suite.ts 的音频工具条断言由「必须存在改造按钮」改为「不得存在改造按钮」+「按钮集合精确等于分类与标签、重命名」

- fed17ea08 已按共享记忆 pitfalls.md 的判据（渲染出来的动作必须真的能跑通）把 redraw 与 character-animation 移出 supportedActions，音频分支只剩宿主编排层真实接通的分类与标签、重命名，原断言断言的是被该提交推翻的旧合同

- 新断言比旧断言更严：除钉住音频分支仍在渲染，还钉住整条工具条的按钮集合，避免再出现点了没反应的假按钮
 2026-09-10 17:53:15 +08:00
lhk229 89447ed432 按评审意见强化回退模板读取通道回归测试
Project CI / Repository checks (pull_request) Successful in 2m47s
Details
Project CI / Frontend tests (pull_request) Successful in 3m44s
Details
Project CI / Backend tests (pull_request) Successful in 7m1s
Details
Project CI / Native shell tests (pull_request) Successful in 18m11s
Details
Project CI / Backend tests (push) Has been cancelled
Details
Project CI / Native shell tests (push) Has been cancelled
Details
Project CI / Frontend tests (push) Has been cancelled
Details
Project CI / Repository checks (push) Has been cancelled
Details 
- tests/configuration.rs 回退模板测试改用与模板无关的 runtime dir，分类断言覆盖按路径归属而非 runtime dir 为 None 的恒真分支，并补充 runtime dir 内路径的 managed 正向断言
- tests/mod.rs 移除不再使用的 clear_test_runtime_config_dir 辅助
 2026-09-10 09:46:48 +00:00
suzmii 7fe1fd9b64 Merge branch 'feat/agc-v3-canvas-generation-entry' into feat/agc-canvas-resource-workbench-v3 2026-09-10 17:40:49 +08:00
suzmii fed17ea08c 工具条只渲染真实接通的动作，去掉两个点了没反应的按钮 
- resolveResourceCanvasToolbarActions 不再把 redraw 与 character-animation 放进支持集合：这两个动作在宿主编排层仍是空回调，放进去会让工具条渲染出点了没反应的按钮
- 判据收敛为一条：放进来就必须真能跑通，当前真实接通的只有快速编辑（normalize → derive(editKind='image-reference')）
- 补注释写明接上真实链路后再放回来
 2026-09-10 17:39:17 +08:00