AGC 画布：生成期间可退出与任务侧栏（高优）、画布手动整理、透明底判据、素材类型独立入口 #358

Merged

suzmii merged 38 commits from fix/agc-canvas-acceptance-batch into master 2026-09-14 20:31:21 +08:00

Conversation 0 Commits 38 Files Changed 40

+8890 -527

38 Commits

Author	SHA1	Message	Date
suzmii	aeac6c7b74	合并 origin/master（279a5e8e0，#356 UI 编辑器返回后资源画布平移）到验收批次 ... - 合并最新 master，使 PR #358 的头包含当前 master 顶端（CI 门禁要求） - 冲突按「两侧语义都保住」解： - docs/project-memory/shared-memory/pitfalls.md：保留我方新增的「严格 IPC 桩缺登记新命令」 与上游新增的「UI 编辑器返回后资源画布滚轮平移失效」两条，只删除冲突标记行 - index.tsx / tests/appSurface/harness.ts / project-development.suite.ts：保留本批生成任务与 资源画布改动，同时并入上游的资源画布平移回归用例与共享 ResizeObserver 桩 - 工作树里另有 5 个版本号改动（package.json / Cargo.toml / Cargo.lock / tauri.conf.json / package-lock.json，0.1.29 → 0.1.34）属发布动作，**本次刻意未提交**，原样留在工作树	2026-09-14 20:27:05 +08:00
suzmii	2292ae1fc1	Merge branch 'master' into fix/agc-canvas-acceptance-batch	2026-09-14 19:59:44 +08:00
suzmii	b077cb5277	更正 decision-log：「整理画布」最终位置固定在「生成素材」之后、「管理未完成编辑」之前（不在行尾）	2026-09-14 19:30:02 +08:00
suzmii	8ad0487b8d	合并 fix/agc-resource-layout-manual：「整理画布」移入资源动作簇（离开行尾） ... - 冲突解在 index.tsx 工具条动作区：两侧都要在同一位置插入按钮（WS1 的「生成任务」入口 + WS2 把「整理画布」从行尾移到「生成素材」之后），按「两侧语义都保住」解—— 「整理画布」在前（紧邻「生成素材」，满足其 previousElementSibling 断言与「不是行尾」断言）， 「生成任务」紧随其后，共用同一个闭合标签；行尾那份旧「整理画布」由 WS2 的删除 hunk 干净应用 - 已核对：ria-label="整理画布" 与 ria-label="生成任务" 在文件中各恰好一处 - 合并后实测：gc:typecheck 通过；resourceCanvasManualLayout 9 + appSurface 439 = 448 passed	2026-09-14 19:29:51 +08:00
suzmii	417b5ec630	「整理画布」移入资源动作簇：排在「生成素材」之后，不再挂在这一行行尾 ... - index.tsx：把「整理画布」从 game-workbench-view-actions 行尾（排序 tab 之后） 移到「生成素材」之后、「管理未完成编辑」之前，与其它资源动作同类相邻， 标签仍为 aria-label=\"整理画布\"，零 CSS 改动 - index.tsx：语义与行为一字未改——disabled={!resourceLayoutReady}、 aria-busy={resourceLayoutSaving}、onClick 仍调 activeResourceLayout.rederiveNow()， 反馈仍走既有 resourceLayoutNotice / resourceLayoutSaving，changed 门保留 - resourceCanvasManualLayout.test.tsx：位置断言改为钉新位置——该行最后一个按钮不是它、 它在「生成素材」之后（previousElementSibling）、在排序组左侧； 继续保留「资源排列方式」组内只有「按依赖 / 按类型」与本按钮不在该组 / 不在 .game-resource-sort-tabs 内的断言	2026-09-14 19:25:21 +08:00
suzmii	5adc16fbda	Merge branch 'feat/agc-generation-task-progress' into fix/agc-canvas-acceptance-batch	2026-09-14 19:16:16 +08:00
suzmii	6c98c19c12	更正 decision-log：「整理画布」是资源工具条动作区里的独立动作按钮，不在「资源排列方式」分组内	2026-09-14 19:11:33 +08:00
suzmii	41c59a37a0	style(agc): 「生成任务」侧栏做视觉与信息层级收口（行为与语义一个不动） ... - 新增 `resourceCanvasAssetGenerationTasksSidebar.css`：侧栏样式独立成文件，取值全部走平台设计 token （`--platform-subpanel-fill/-border`、`--platform-panel-shadow`、`--platform-text-muted`、`--platform-line-soft`、 `--platform-neutral-*`、`--platform-accent`、`--platform-success-*`、`--platform-button-danger-*`、 `--platform-input-focus-ring`），不硬编码任何颜色，也不新增第二套色板 - 条目卡片化：素材名为主信息（加粗、单行省略）、阶段文案为次要信息（muted、小一号）、 已耗时 `font-variant-numeric: tabular-nums` + 右对齐（秒数跳动不抖）、失败原因 `overflow-wrap: anywhere` 折行不截断、「定位到素材」轻量下划线按钮 + hover 换色 - 状态徽标成体系：`data-tone` 四档——排队中 `--platform-neutral-*`（中性）、生成中 `--platform-accent` （品牌色 + 呼吸感圆点，**不做百分比**）、已完成 `--platform-success-*`、失败 `--platform-button-danger-*`； tone 映射提到模型层 `resourceCanvasAssetGenerationTaskTone`（组件只导出组件与常量，保住 react-refresh 边界） - 分栏标题小字 + 条数胶囊，两栏之间用 `--platform-line-soft` 分隔；空态只给一句简短文案 - 侧栏容器圆角 + 边框 + `--platform-panel-shadow` + `backdrop-filter: blur(10px)`；展开/折叠各有进场动画 （位移 + 淡入，不做宽度 reflow 抖动）；折叠把手是竖向标签 + 在途数量胶囊；列表滚动条细样式 - 无障碍与降级：`:focus-visible` 用 `--platform-accent` 焦点环 + `--platform-input-focus-ring`； `@media (prefers-reduced-motion: reduce)` 关掉全部 animation / transition 与 hover 位移； `@media (max-width: 480px)` 下侧栏撑满可用宽度、把手收窄，不挡画布操作 - 测试：新增 `resourceCanvasAssetGenerationTasksSidebarStyle.test.ts`（用仓库既有 `tests/styleCascade.ts` 按真实层叠断言：四档 tone 互不相同且只引平台 token、tabular-nums + 右对齐、卡片圆角与 hover、 过渡与把手、细滚动条、360px 降级、reduced-motion 关动效、焦点环）； 侧栏行为用例补「四种状态各自输出对应 data-tone」，并把原先断言 Tailwind 类名的部分交还给样式用例 - 未改任何行为：分栏、条数、已完成封顶 20、折叠不清列表、提交后自动展开、入口在途计数、 定位终局化、非模态（无遮罩 / 无焦点陷阱 / 不进模态遮挡判据）全部保持原样	2026-09-14 19:11:21 +08:00
suzmii	a6de1b5570	Merge remote-tracking branch 'origin/master' into fix/agc-canvas-acceptance-batch	2026-09-14 19:07:46 +08:00
suzmii	444bf9bc24	Merge branch 'fix/agc-resource-layout-manual' into fix/agc-canvas-acceptance-batch	2026-09-14 19:07:45 +08:00
suzmii	21c85c4dd1	「整理画布」移出「资源排列方式」分组，成为独立动作按钮 ... - index.tsx：把「整理画布」从 aria-label=\"资源排列方式\" 的 role=group 里搬出来， 紧跟排序 tab 之后、作为 game-workbench-view-actions 动作区里的独立按钮， 外观直接复用该容器既有动作按钮样式（有边圆角 + secondary 填充），不新增 CSS - index.tsx：语义与行为一字未改——aria-label=\"整理画布\"、disabled={!resourceLayoutReady}、 aria-busy={resourceLayoutSaving}、onClick 仍调 activeResourceLayout.rederiveNow()， 成功/失败反馈仍复用既有 resourceLayoutNotice / resourceLayoutSaving，changed 门保留 - resourceCanvasManualLayout.test.tsx：新增结构断言——「资源排列方式」分组里只有 「按依赖 / 按类型」两枚按钮、「整理画布」不在该容器内也不在 .game-resource-sort-tabs 里， 同时仍是动作区内可用按钮（布局就绪后不再 disabled）	2026-09-14 19:07:22 +08:00
suzmii	a45172e055	同步文档：生成进度面收敛为常驻可折叠侧栏、提交即关面板、定位终局化、类型选项纵向列表 ... - PRD §3.10：进度面由「非模态浮层」改为「常驻画布的可折叠任务侧栏」（折叠把手带在途计数、两个分栏、已完成封顶 20、左侧覆盖式、提交后自动展开）；定位动作终局化（跨栏目先切栏目 / 不在投影给结论 / 3 秒有界兜底） - PRD §3.10 面板形态：改为「点「生成」即同步关闭面板、面板内不出现阶段文案；只有点击瞬间失败才带草稿重开；受理后失败只在侧栏收口」 - 栏目画布入口矩阵 §4/§4a：同步上述两条，并把 4a 标题由「「生成任务」面板」改为「「生成任务」侧栏」 - decision-log：新增 2026-09-14 条目（进度面收敛为常驻可折叠侧栏 + 提交即关面板 + 定位终局化，含位置取舍与覆盖式理由、五条变异证据）；并在「素材类型」条目补记选项形态修订（纵向单选列表、radio 语义、方向键只移焦点、行列与滚动口径、建议后续抽 PlatformRadioList）	2026-09-14 18:50:48 +08:00
suzmii	e6d92b2d98	Merge branch 'feat/agc-generation-task-progress' into fix/agc-canvas-acceptance-batch	2026-09-14 18:50:00 +08:00
suzmii	ec02c39a5d	feat(agc): 「生成任务」改造成常驻画布的可折叠侧栏（分栏 / 计数 / 自动展开 / 折叠不影响任务） ... - ResourceCanvasAssetGenerationTasksPanelView 由非模态浮层改造成任务侧栏：展开时是贴边 `<aside>`（`role="region"`、`aria-label="生成任务"`、不铺遮罩、不做焦点陷阱、不进模态遮挡判据）， 折叠时只留一个可点的贴边把手（`aria-label="展开生成任务"`）并带在途数量角标 - 位置取舍：右侧是「智能创作」对话面板、底部是栏目工具栏、顶部是栏目标题栏，所以挂在**左侧、标题栏 之下、工具栏之上**（`top-16 / bottom-24 / left-3 / w-[300px]`）且是**覆盖式**而不是把画布挤窄—— 画布视口数学与资源卡排布都不被 reflow 动到，收起即完全让出画布；不再保留原来的浮层形态，没有平行入口 - 两个分栏：「排队/生成中」与「已完成」各带条数，只做客户端分组；「已完成」条数封顶 20 条（超出给出 还剩多少条的说明），列表自身 `overflow-y-auto`，侧栏高度有界 - 入口按钮常驻可见并显示在途数量（`生成任务 · N`，无在途时仍是「生成任务」，`aria-label="生成任务"` 保留）， 把手上的角标同步；提交受理后侧栏自动展开（对齐网页端排队提交后主动弹任务栏） - index.tsx：新增在途数量派生；侧栏常驻渲染并受同一个开合开关控制，折叠只影响这个视图， 任务本身仍活在账本与本地队列里 - 测试：任务侧栏用例改为侧栏形态并补「两个分栏 + 条数」「高度有界 + 列表滚动 + 已完成封顶 20」 「折叠后把手带上在途计数（0 / 2）」；AppSurface 补「提交后自动展开」「折叠期间任务照常推进、 在途计数归零、再展开仍能看到结果」	2026-09-14 18:49:22 +08:00
suzmii	14a0286f70	fix(agc): 生成面板点击即关闭、面板内不再出现阶段文案，只有即时失败才把草稿带回来 ... - ResourceCanvasAssetGenerationPanelView：删掉 `phaseDetail` 通道与整套在途状态（`submitting` / 禁用输入 / 「后台运行并关闭」），主按钮文案恒为动作名；提交时**同步**调用 onSubmit 并 onClose， 面板不等 IPC、不等排队、不等生成。新增 `draft` / `error` 两个入参：只有「后端从未受理」的即时 失败重开时，宿主才把草稿与原因带回来（`role="alert"` 可见、改完即可重试） - index.tsx：`submitResourceAssetGeneration` 改为同步返回（不再 await 终局），记录本次提交上下文 （taskId / action / 草稿 / 是否本来就该立刻派发），提交后自动开任务面板并给一次提示条； 收尾回调里区分两类失败：`record === null` 且本来就该立刻派发 → 重开提交面板并带回草稿； 受理之后才失败 → 不重开面板，只在任务面板收口为失败 + 提示条 - index.tsx：删掉只为旧「在途阶段文案」服务的 `resourceAssetGenerationPanelTaskIdRef` 与成功后的 自动收面板逻辑（面板此时已关闭） - 测试：`resourceCanvasAssetGenerationBackgroundClose.test.tsx` 的图片类用例改写为「点击即关闭 + 面板 DOM 里从不出现 排队中。/正在生成。/提交中…」+「即时失败重开带回草稿与原因」；音频面板用例不变 - 测试：`resourceCanvasBottomToolbar.test.tsx` 的失败重试用例按新语义改写（点击即关闭、重开时显示原因） - 测试：AppSurface 新增三条（同步关闭且面板无阶段文案、后端未受理时重开并保留草稿、受理后失败不重开 只在任务面板收口），并把既有生成任务 e2e 的提交步骤改为「点击即关闭」 - 顺带按仓库规范修正以上文件的 eslint import sort 与 prettier 格式（未触碰无关文件）	2026-09-14 18:35:11 +08:00
suzmii	2f47540eeb	fix(agc): 「定位到素材」每次点击都终局化，不再卡在「正在定位生成的素材…」 ... - index.tsx 新增 `resourceAssetGenerationFocusRequest` 序号并加进聚焦 effect 的依赖：手动点定位不改画布 任何状态，原依赖一个都不变 → effect 不重跑、intent 永远没人消费，这正是「点了没反应 + 提示条永久 停在中转文案」的根因 - index.tsx `focusResourceAssetGenerationTask` 重写：先按当前投影与清单判一次目标——不在投影里就当场给 结论（素材已不在项目里 / 已登记但尚未同步），不挂 intent 也不留中转提示；在别的栏目先切栏目再定位； 挂 intent 后推进聚焦请求序号，并起一个 3 秒有界兜底：仍停在中转文案就收口成可执行提示，intent 被判 invalid 被静默清掉时也给一条「定位请求已失效」的结论，绝不留下悬而未决的状态 - index.tsx 聚焦 effect 的 `focusedCommitIdsRef` 提前返回分支补 `setResourceWorkbenchNotice('')`： 已聚焦过时把中转提示一并收掉，不再永久留在提示条上（自动落卡那条链同源问题） - index.tsx `resourceAssetGenerationContextRef` 扩到带 `manifest` / `resources` / `activePageCategory` 并在每次渲染刷新：定位回调据此取权威目标与栏目，不再依赖可能过期的闭包值 - 新增 4 条 AppSurface 用例（同栏目直点定位并选中卡片、素材在另一个栏目先切栏目再定位、被搜索挡住时给出 既有「清除搜索并定位」、素材不在项目里时给明确结论且清掉中转提示）	2026-09-14 18:20:50 +08:00
suzmii	a2b016bb9b	Merge branch 'feat/agc-generation-task-progress' into fix/agc-canvas-acceptance-batch	2026-09-14 18:18:45 +08:00
suzmii	b898590c7d	合并 feat/agc-resource-type-entry：类型选项改纵向单选列表 ... - 合并 WS4 追加修复（928a0ea13：类型选项由横排 PlatformSegmentedTabs 改为 role=radiogroup 纵向单选列表， 复用共享 PlatformNavigableListItem，列表有界独立滚动，rogiving tabindex + 方向键移焦点、Enter 落盘） - 同时并入 origin/master a70ef2d6e（PR #354 Windows sccache / CI 分片改「一片一 job」） - decision-log.md / pitfalls.md 冲突按「上游改写优先、我方新增保留」解： 保留我方新增的「放开手工图片生成本地并发」「素材类型独立入口」「退役同步命令」三条与 「严格 IPC 桩缺登记新命令」一条；AGC 壳 Rust 套件条目采用上游改写后的新标题（「一片一 job」）， 删掉被它取代的旧标题（旧正文早已被上游替换），不留自相矛盾的两条	2026-09-14 18:18:30 +08:00
suzmii	4e277798b8	Merge remote-tracking branch 'origin/master' into feat/agc-resource-type-entry	2026-09-14 18:17:10 +08:00
suzmii	928a0ea13e	素材类型选项改成纵向单选列表，不再横排成一条 ... - ResourceTypePanel：选项区从 PlatformSegmentedTabs（3~6 列网格，6 项正好挤成一行）换成纵向单选列表，复用共享的 PlatformNavigableListItem 作行骨架 - ResourceTypePanel：容器改为 role="radiogroup" + aria-label，每项 role="radio" + aria-checked，选中态与读屏读的是同一个属性 - ResourceTypePanel：roving tabindex（只有选中项 tabIndex=0）与方向键在选项间移动焦点，走到头不越界；方向键不顺手选中，Enter/Space 才落盘（选中=一次 CAS 写盘，浏览选项不该连环写盘） - ResourceTypePanel：选中行额外渲染勾选图标作为第二视觉线索，图标 aria-hidden 不污染可读名字 - resourceTypePanel.css：选项容器改成单列网格（grid-template-columns: minmax(0, 1fr) + grid-auto-flow: row + align-content: start），一行一个选项 - resourceTypePanel.css：选项行补 width/min-width/min-height: 44px 与 overflow-wrap，移动端热区与窄屏换行都不依赖共享件的工具类 - resourceTypePanel.css：选中态由 [aria-checked='true'] 驱动并显式提权到 (0,3,0) 以上（含覆盖 :hover:not(:disabled)），避免被共享列表行的悬停底色顶掉 - resourceTypePanel.css：滚动从 body 挪到选项列表（列表现有 max-height: min(320px, 40dvh) + overflow-y: auto），body 改为 auto/minmax(0,1fr)/auto 三段，标题、素材名与错误提示不跟着滚 - 测试：新增「选项区是纵向单列列表」用例，按 styleCascade 解析真实生效声明（360/390/1440 三档宽度都是单列、行满宽、热区 44px），并断言 6 项都是 radiogroup 的直接子元素 - 测试：新增「单选语义与键盘」用例（radiogroup/radio + aria-checked + roving tabindex，方向键只移焦点不落盘，Enter 才写盘） - 测试：新增「选中态由 aria-checked 驱动并压过共享列表行悬停底色」用例 - 测试：把「面板有高度上界且中间行可滚动」改成「选项区有上界并独立滚动，标题与错误提示不滚」 - 测试：集成用例的类型选项查询从 button/aria-pressed 改为 radio/aria-checked	2026-09-14 18:16:56 +08:00
suzmii	cdc0e3d163	fix(agc): 生成任务读门禁用合法 command id、中断任务按清单核对不谎报未完成，并同步注释事实 ... - asset_generation_tasks.rs：`list_local_project_asset_generations` 的读门禁 command id 由 `asset.read` 改为契约里真实存在的 `asset.list`（`asset.read` 不在命令表里，写进 `denied_commands` 也不可能命中 → 原门禁恒不生效）；补用例把 `asset.list` 放进项目策略 `denied_commands` 后读账本必须被拒 - asset_generation_tasks.rs：中断任务收口改为与 manifest 交叉核对（新增账本字段 `output_path`，serde 默认值 兼容旧账本）：能找到本次请求的精确落点 → 按事实收口为已完成并带上 assetId；落点存在但清单里没有 → 报「目标素材未登记，生成未完成」；没有精确落点或清单读不到 → 只报「状态未知（可能已完成）」，不再 对「素材已登记、账本还停在 running」的窗口谎报「生成未完成」 - asset_generation_tasks.rs：补四条用例（已登记→已完成、未登记→未完成、无落点→状态未知、读门禁可拒绝）， 并把既有的两条中断用例按新语义改为断言「状态未知」 - resourceCanvasBottomToolbarModel.ts：两处注释的入口命令名改为 `start_local_project_asset_generation` - check-config.mjs：`generate_local_project_asset` 白名单注释改为「没有生产调用方，只有 Rust 集成测试与 commands.rs 单测在调，待后续批次删除或改为转调 start_local_project_asset_generation」 - resourceCanvasAssetGenerationTaskModel.ts / resourceCanvasAssetGenerationQueue.ts：把「远端 single-flight 输出槽会拒绝并发」这个已不成立的排队理由改为当前事实——本地 durable 输出槽已按精确动作指纹分槽， 本批仍按「同一时刻只派发一条」排队是**提交节流**，真并行派发需要并发收口设计，留待下一批	2026-09-14 18:13:12 +08:00
suzmii	8ac77cb090	同步共享记忆与专题文档：并发槽身份、素材类型入口、退役同步命令 ... - PRD §3.10 本地排队一条：删掉已失效的「共用 single-flight 输出槽」理由，改为「本地槽已按精确动作指纹分槽（具备并行能力），本批前端仍按单条在途排队，真并行派发留待下一批」 - 栏目画布底部工具栏入口矩阵 §4a：同上更正，并写明槽身份材料的 8 个字段与旧槽懒迁移 - decision-log：追加三条 2026-09-14 条目（放开手工图片生成本地并发 / 素材类型拆成独立入口 / 同步命令 generate_local_project_asset 退役为仅测试调用） - decision-log：更正同日「图片类生成后台化」条目里已被同批次推翻的两处表述（槽身份、本地排队的理由），并给 2026-09-11 的类型选择器入口决策加「已被取代」标记 - decision-log/pitfalls：把「严格 IPC 桩缺登记新命令」的排障经验记入共享记忆（unhandled rejection 与不相干提示断言的组合症状、桩必须返回数组、形状错会「看着绿」） - 端到端验收用例 S12：更正「用户手动设置 category 已移除」与「面板内删除资源是唯一入口」两处与当前实现不符的描述	2026-09-14 17:52:27 +08:00
suzmii	7240b3793f	Merge branch 'feat/agc-generation-task-progress' into fix/agc-canvas-acceptance-batch	2026-09-14 17:50:40 +08:00
suzmii	4fff733516	fix(agc): 生成任务账本读不到时不再抛未处理拒绝，改为保留本地状态并给出提示 ... - resourceCanvasAssetGenerationTaskModel.applyLocalProjectAssetGenerationRecords：入参在函数入口归一化， 非数组（undefined / null / 字符串 / 数字 / 对象）一律按「没有后端记录」处理，数组内的垃圾条目 （null / 数字 / 缺 taskId）逐条丢弃；类型放宽为 `readonly …[] | null | undefined` - resourceCanvasAssetGenerationQueue：轮询 `list_local_project_asset_generations` 的 IPC 拒绝与非数组 返回值都在本地接住，按「本轮读不到」计数；到上限后按「账本不可用」与「账本里没有这条」两种原因分别收口； 派发循环再补两道兜底（dispatch 意外抛出、宿主 onSettled 抛出），保证 `void (async …)()` 不产生未处理拒绝、 也不会把任务永远卡在「已派发但未终态」 - index.tsx 恢复任务账本的 effect：IPC 拒绝与返回非数组都落到既有提示条 「生成任务列表读取失败，暂时无法恢复历史任务」，本地任务列表保持原样不清空 - 测试：模型层补「undefined / 非数组 / 垃圾条目不抛错且列表不变」，驱动器层补 「轮询返回 undefined」「轮询 IPC reject」两条（收口原因、不产生未处理拒绝、后续排队任务照常补发） - AppSurface 补两条：账本返回 undefined / 读取被拒绝时视图照常渲染、生成入口还在、提示可见 - AppSurface 既有的「布局读时提示」用例显式登记 `list_local_project_asset_generations` 返回空账本： 该命令是只读的独立链路，严格桩把它判成 unexpected invoke 会让新提示混进「没有任何提示」的断言	2026-09-14 17:47:03 +08:00
suzmii	5d336bf147	Merge branch 'fix/agc-resource-layout-manual' into fix/agc-canvas-acceptance-batch	2026-09-14 17:40:50 +08:00
suzmii	3d6d51737c	测试 harness 登记 WS1 新增的后台生成任务账本 IPC ... - resourceCanvasManualLayout.test.tsx：installLayoutTauri 登记 list_local_project_asset_generations（工作台打开 / 切项目时由 WS1 的生成任务面板读取）， 回空账本，形状按 src-tauri/src/asset_generation_tasks.rs 的 list_local_project_asset_generations 返回值核对为数组（Vec<AssetGenerationTaskRecord>）， 与前端 invoke<LocalProjectAssetGenerationTaskRecord[]> 一致，不是 { tasks: [] } - 保留 unexpectedCommands 断言不放宽，也不删除：这条门禁继续拦截意外 IPC	2026-09-14 17:38:21 +08:00
suzmii	1de661df10	Merge branch 'feat/agc-generation-concurrency' into fix/agc-canvas-acceptance-batch	2026-09-14 17:31:40 +08:00
suzmii	6b5f67d207	Merge branch 'feat/agc-generation-task-progress' into fix/agc-canvas-acceptance-batch	2026-09-14 17:31:32 +08:00
suzmii	74b3760d0f	docs(prd): 同步功能画布生成入口的后台化事实 ... - 头部更新时间改为 2026-09-14 并说明本次同步内容，2026-09-13 的原口径与其余合同保持不变的声明保留 - §3.10 实现状态补 2026-09-14 后台化口径（提交即返回 + 项目内任务账本 + 本地排队 + 非模态「生成任务」面板） - §3.10 接线：图片类入口由 `generate_local_project_asset` 改写为 `start_local_project_asset_generation` + `list_local_project_asset_generations` + 项目内账本 `.agent/runtime/asset-generation-tasks/tasks.json`；音频 / 上传两条接线不变 - §3.10 新增「本地排队与进度可见」一条：第二条停在本地队列不调用提交 IPC、阶段文案由后端账本提供、 非模态「生成任务」浮层与按素材卡定位 - §3.10 面板形态：补「提交期间面板不锁关闭」（×/遮罩/Esc/「后台运行并关闭」），并明确关闭不等于取消请求 - §3.10 前置规范图：命令名同步，并明确「后台化没有改这条前置判据」（`ui-prototype` / `art-spritesheet` 判据不变） - §7.9 第 3 条：改写为 `start_local_project_asset_generation` 的载荷与「提交即返回」事实， 保留「原载荷字段名与取值口径逐字不变」的说明，并补 `projectId` / `taskId` 两个新增字段 - §7.9 第 6 条：配对读改为「发生在该任务收口之后（提交命令不再等待生成）」，音频入口描述不变 - §7.9 新增第 8 条：生成期间可退出、面板关闭后进度可见、第二条本地排队（IPC 次数 1→2）、 两条各自完成后各走一次「配对读 + 落卡」且 revision 单调	2026-09-14 17:30:08 +08:00
suzmii	53026fe8f3	放开 AGC 手工图片生成的 durable 输出槽并发生成限制 ... - canvas_generation.rs：standalone 图片生成的 durable 输出槽身份改为由精确动作身份派生（run_id = slot-<actionFingerprint>），同一项目里不同 prompt/素材名/参数的生成各自独立成槽，可以同时在途 - canvas_generation.rs：动作指纹材料逐字节保持升级前取值，新增 legacy_standalone_platform_art_generation_run_id 复现升级前 {outputPath, requireSlices} 槽公式，只用于定位升级前遗留账本 - canvas_generation.rs：在取得 durable guard 之后、任何远端 POST 之前调用旧槽账本一次性迁移 - external_generation_state.rs：新增 adopt_legacy_standalone_platform_art_generation_runtime_state_at，在项目写锁内把仍属于本次精确动作的旧 slot- 账本迁移到新身份路径并保留原 idempotencyKey 与 operationId；属于其他动作的旧账本原样保留，不迁移、不删除、不阻塞 - external_generation_state.rs：新增三个 #[cfg(test)] 只读访问器，供跨模块用例断言账本身份 - canvas_generation.rs：新增两条不同动作并发都成功且远端各 POST 一次、不同动作的 durable 槽互不阻塞、旧槽账本仅被同一精确动作迁移三组用例；同动作并发冲突用例改用同一精确动作以钉住幂等语义	2026-09-14 17:30:00 +08:00
suzmii	bb7cbae118	feat(agc): 图片类生成后台化，生成面板可随时关闭并新增「生成任务」进度面板 ... - Rust 新增 asset_generation_tasks.rs：图片类生成拆成「提交即返回任务记录 + 后台 spawn 生成」， 生成本身仍转调既有 generate_platform_art_asset_with_options_at（不复制生成 / 幂等 / 登记逻辑） - 任务账本落项目内 .agent/runtime/asset-generation-tasks/tasks.json（复用 agent runtime sidecar 原语）， 阶段文案 phaseDetail 由后端拥有，读取时把上次运行留下的非终态记录收口为「中断失败」，账本上限 50 条 - Rust 新增 IPC start_local_project_asset_generation / list_local_project_asset_generations 并在 main.rs 注册； 同步命令 generate_local_project_asset 保留不动 - 新增前端纯模型 resourceCanvasAssetGenerationTaskModel.ts：任务状态机、在途判据、账本恢复、耗时文案 - 新增 resourceCanvasAssetGenerationQueue.ts：本地排队驱动器，第二条不发提交 IPC、前一条终态后自动补发， 状态与阶段一律以后端账本为准，账本查不到该任务时按上限停止等待 - 两块生成浮层在提交期间放开 × / 遮罩 / Esc，次按钮在途时改为「后台运行并关闭」（关闭不等于取消请求）， 图片类面板的在途文案改为渲染后端 phaseDetail - 新增非模态「生成任务」面板（不铺遮罩 / 不做焦点陷阱 / 不进模态遮挡判据），显示状态、后端阶段、 已耗时与素材名，已完成条目复用 pendingResourceFocusRef 聚焦链定位素材卡 - index.tsx 宿主接线：任务列表状态与 ref、提交回调不再读面板状态、按项目恢复任务账本、 工具栏「生成任务」入口按钮与面板渲染点 - check-config.mjs：把已无前端调用方的同步命令 generate_local_project_asset 登记进 native-only 白名单 - 测试：新增「生成面板提交期间可关闭」「本地排队驱动器」「生成任务面板」三组用例； appSurface 生成载荷断言改为 start_local_project_asset_generation + list 轮询桩 - 文档：入口矩阵补 §4a 与验证命令、V3 验收 S11a 判据、decision-log 记录本次决策	2026-09-14 17:26:36 +08:00
suzmii	0b3bf3e52d	合并 fix/agc-resource-layout-manual：资源画布改为手动整理口径 ... - 合并 WS2 分支（新素材不再自动重排 + 显式「整理画布」+ 生成后自动聚焦） - index.tsx 与 useProjectResourceCanvasLayout.ts 自动合并成功，无需手工介入 - decision-log.md / pitfalls.md 冲突按「两侧语义都保住」解：保留 origin/master 新增的 「AGC 壳 Rust 套件分片并行」与「根门禁 label 字面量契约」两条，同时保留 WS2 新增的 「AGC 资源画布改为手动整理」与「不要恢复无条件重派生」两条，只删除冲突标记行 - 新增 tests/resourceCanvasManualLayout.test.tsx	2026-09-14 17:16:58 +08:00
suzmii	6d5cd51649	Merge branch 'fix/agc-preview-alpha-background' into fix/agc-canvas-acceptance-batch	2026-09-14 17:16:30 +08:00
suzmii	181e364d80	AGC 资源卡棋盘格底改按图像真实 alpha 判定 ... - 原生预览新增头部级 alpha 判据：`LocalProjectImagePreview.hasAlpha`（PNG colorType 4/6 或 tRNS、WebP VP8X/VP8L alpha 标志；JPEG 恒 false），只读签名与 chunk 头、不做像素解码。 - 前端预览 payload 增加可选 `hasAlpha`，并在 `materializeProjectResourceCardPreview` 的两条分支里透传。 - 资源卡根节点新增排障属性 `data-preview-has-alpha`：只有预览已加载且判据为真才写 `'true'`，其余一律不写（缺属性与不透明同档）。 - 棋盘格底选择器加 `[data-preview-has-alpha='true']` 条件；无 alpha 时退回卡片既有纯色底，不引入第二套底色。 - 新增 TS 用例（真渲染资源卡 + styles.css 声明级层叠求值）与 Rust 用例（PNG/WebP/JPEG 头部判据、tRNS、坏文件失败关闭、非解码证明、IPC 字段序列化契约）。 - 验收文档补记 `data-preview-has-alpha` 判据与「真假棋盘格」取证脚本，便于现场区分真透明底与 AI 画出的假棋盘格。	2026-09-14 17:13:43 +08:00
suzmii	3b8ecb02d4	记录 AGC 资源画布「手动整理」口径变更 ... - decision-log：追加 2026-09-14 条目，记录默认 preserve、显式「整理画布」、 依赖侧关系图首次就绪的一次性重派生、新素材按 manifest 新增 id 聚焦四条决策与变异验证 - pitfalls：追加「不要恢复无条件重派生」条目，含 changed 门、ready 时序、 项目作用域 flag 与新素材基线四个易错点	2026-09-14 17:08:00 +08:00
suzmii	d02d0ed7a4	AGC 资源画布：新素材不再自动重排，改为显式「整理画布」并在生成后自动聚焦新素材 ... - useProjectResourceCanvasLayout：资源写意图新增 rederive 标记，显式整理那一笔按 rederive 策略重算自动坐标（手动坐标原样保留），自动同步仍是 preserve 只补新卡 - useProjectResourceCanvasLayout：新增 rederiveNow()，复用既有写队列 / sidecar 写回链路， 只在坐标确有变化时落盘，成功复用既有「布局已保存」提示 - index.tsx：两个排序模式的 rederiveAutomaticPositions 都固定 false，画布不再因为资源 协调签名变化（新增素材、改标签、改分类、拓扑重建）整体重排 - index.tsx：依赖侧「关系图首次就绪」改为按项目作用域的一次性 flag，等该侧 sidecar ready 后调用一次 rederiveNow()，之后一律只补新卡（切排序 tab 不重新武装） - index.tsx：依赖/类型 tab 组新增「整理画布」按钮，作为整张画布重排的唯一显式入口 - index.tsx：新增 manifest.assets 新增 id 检测（seenManifestAssetIdsRef），把新卡交给既有 pendingResourceFocusRef + advanceFocusGeneration() 裁决链聚焦；首次打开 / 切项目只登记 基线不聚焦，重命名不改 id 天然不触发，已有同目标意图时不重复挂 - 新增 tests/resourceCanvasManualLayout.test.tsx（8 条）：新素材入库后既有自动坐标逐值不变、 依赖侧首次就绪后不再重排、新素材自动聚焦、被搜索挡住走既有「清除搜索并定位」、 「整理画布」重算并保留手动坐标、已经整齐时再按一次不写盘、首次打开与切项目不聚焦	2026-09-14 17:07:55 +08:00
suzmii	ef3e783ab1	Merge remote-tracking branch 'origin/master' into feat/agc-resource-type-entry	2026-09-14 17:07:36 +08:00
suzmii	7ce4a3a9c6	把素材类型从「编辑素材标签」面板拆成独立入口 ... - 新增 ResourceTypePanel（src/view/project-development/ResourceTypePanel.tsx）：类型选一项即落盘，category 传用户选中值、tags 逐字回传落盘原值，保存在飞时沿用 closeOnBackdrop/closeOnEscape = !saving - 新增 resourceAssetDisplayName.ts：两块面板共用同一个素材名副标题口径（localPath basename），不再各写一份 - 新增 resourceTypePanel.css：类型面板的弹窗骨架与信息浮层「分类」行入口样式，按 AGC 内独立文件约定，不动 packages/** 与 styles.css - ResourceClassificationPanel 删掉类型 chip 与 categoryChoice：保存时恒回传 gameCreationAppAssetPersistedCategory(asset)，「只改标签不动分类」由结构保证 - index.tsx 新增 resourceTypeAssetId 与 resourceTypeAsset；工具条在「编辑标签」旁新增「素材类型」按钮（Shapes 图标） - index.tsx 用合并后的 resourceClassificationOverlayOpen 纳入点外部/Esc 浮层遮挡判据，并同步 useEffect 依赖项 - index.tsx 渲染新面板：保存成功后由宿主收起面板并沿用 manifest 重载路径，让卡片立刻落到新栏目 - 信息浮层「分类」行接出第二入口：按钮渲染在 dd 之外，不污染 dt/dd 字段读取口径；非 manifest 资产不给入口 - resourceCanvasInfoModel 导出 RESOURCE_INFO_CATEGORY_FIELD_LABEL，模型与入口共用同一行标识 - 新增 tests/resourceTypePanel.test.tsx：选中即落盘、tags 逐字回传、没碰过不写盘、显式待归类、失败回退、saving 锁、Esc/遮罩、面板骨架共 11 条 - 迁移「没碰过分类就回传落盘原值」对照用例并保留两条（标签面板侧），chip 用例搬到新面板文件 - 集成用例改走新入口：选中即落盘并自动关窗，另补 Esc/点外部不串台、只改标签后 manifest category 逐字不变两条宿主级用例 - appSurface 工具条清单补上「素材类型」	2026-09-14 17:07:15 +08:00