GenarrativeAI/Genarrative
11
0
Fork 0
Code Issues 35 Pull Requests 13 Actions Packages Projects 1 Releases Wiki Activity

同步文档：生成进度面收敛为常驻可折叠侧栏、提交即关面板、定位终局化、类型选项纵向列表

Browse Source 
- PRD §3.10：进度面由「非模态浮层」改为「常驻画布的可折叠任务侧栏」（折叠把手带在途计数、两个分栏、已完成封顶 20、左侧覆盖式、提交后自动展开）；定位动作终局化（跨栏目先切栏目 / 不在投影给结论 / 3 秒有界兜底）
- PRD §3.10 面板形态：改为「点「生成」即同步关闭面板、面板内不出现阶段文案；只有点击瞬间失败才带草稿重开；受理后失败只在侧栏收口」
- 栏目画布入口矩阵 §4/§4a：同步上述两条，并把 4a 标题由「「生成任务」面板」改为「「生成任务」侧栏」
- decision-log：新增 2026-09-14 条目（进度面收敛为常驻可折叠侧栏 + 提交即关面板 + 定位终局化，含位置取舍与覆盖式理由、五条变异证据）；并在「素材类型」条目补记选项形态修订（纵向单选列表、radio 语义、方向键只移焦点、行列与滚动口径、建议后续抽 PlatformRadioList）
This commit is contained in:
董羽秦
2026-09-14 18:50:48 +08:00
parent e6d92b2d98
commit a45172e055
3 changed files with 18 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/technical/【AGC】栏目画布底部工具栏入口矩阵-2026-09-13.md
+4 -4
View File
@@ -44,13 +44,13 @@
| 生成音效 | `derive_local_project_resource` | `editKind: 'sound-effect'`、其余同上 |
| 上传 | `upload_local_asset` | `{ projectPath, fileName, mediaType, bytes }` |
`start_local_project_asset_generation` 的完整参数是 `{ projectPath, projectId, taskId, kind, prompt, aspectRatio, imageSize, assetName, outputPath }`（Rust `src-tauri/src/asset_generation_tasks.rs`），**提交即返回**一条任务记录（`taskId / status / phaseDetail / assetId / error` 等）；生成在 `tauri::async_runtime::spawn` 出来的后台任务里跑，账本落在项目内 `.agent/runtime/asset-generation-tasks/tasks.json`，进度由 `list_local_project_asset_generations` 读回。截图面板不再「等生成结束」，所以提交期间 × / 遮罩 / Esc /「后台运行并关闭」都能关面板（关闭 ≠ 取消）。
`start_local_project_asset_generation` 的完整参数是 `{ projectPath, projectId, taskId, kind, prompt, aspectRatio, imageSize, assetName, outputPath }`（Rust `src-tauri/src/asset_generation_tasks.rs`），**提交即返回**一条任务记录（`taskId / status / phaseDetail / assetId / error` 等）；生成在 `tauri::async_runtime::spawn` 出来的后台任务里跑，账本落在项目内 `.agent/runtime/asset-generation-tasks/tasks.json`，进度由 `list_local_project_asset_generations` 读回。截图面板不再「等生成结束」，所以**点「生成」即同步关闭面板**（不等 IPC），面板内不出现阶段文案；只有「点击瞬间就失败」才带草稿重开（关闭 ≠ 取消）。
## 4a. 本地排队与「生成任务」面板
## 4a. 本地排队与「生成任务」侧栏
- **本地排队**：AGC 本地 durable 输出槽按**精确动作指纹**分槽（`run_id = slot-<sha256(动作材料)>`，材料为 prompt / outputPath / 比例 / 尺寸 / assetKind / assetLabel / replaceExisting / requireSlices；不同 prompt 或素材名各自独立成槽，不再按 `outputPath` 共用；旧 `{outputPath,requireSlices}` 槽账本由同一精确动作懒迁移）。因此后端已具备并行能力，但**本批前端仍按「同一时刻只派发一条」排队**——真并行派发需要并发收口设计（配对读 + manifest CAS + 聚焦意图互不覆盖），留待下一批。所以第二条提交停在**前端本地队列**里（不调用提交 IPC，阶段显示本地排队的「排队中。」），第一条终态后由同一条循环自动补发；判据是「存在 `dispatched && 未终态` 的任务时不派发下一条」。
- **阶段文案只来自后端**：派发之后面板与任务列表渲染的都是后端账本给的 `phaseDetail`（「排队中。」/「正在生成。」/「生成已完成。」/失败原因），前端不拼阶段、不做百分比。
- **「生成任务」面板是非模态浮层**：不铺全屏遮罩、不做焦点陷阱，**不参与** `isResourceCanvasFloatingPanelOpen` / `resourceCanvasHostGenerationPanelOpen` 的遮挡判据；入口按钮在 `index.tsx` 工具栏区（`aria-label="生成任务"`）。已完成任务可用「定位到素材」复用既有 `pendingResourceFocusRef` 聚焦链。
- **阶段文案只来自后端，且只出现在任务侧栏**：派发之后由任务侧栏渲染后端账本给的 `phaseDetail`（「排队中。」/「正在生成。」/「生成已完成。」/失败原因），提交面板已关闭、不渲染任何阶段文案；前端不拼阶段、不做百分比。
- **「生成任务」是常驻画布的可折叠侧栏**（形态对齐网页端美术画布的任务侧栏）：折叠时留贴边把手并在把手上显示在途数量；展开是两个分栏「排队/生成中」与「已完成」（各带条数，「已完成」封顶 20 条 + 列表滚动 + 高度有界）；位置在画布左侧标题栏之下、**覆盖式**（不 reflow 挤窄画布视口）。侧栏非模态（不铺全屏遮罩、不做焦点陷阱、**不参与** `isResourceCanvasFloatingPanelOpen` / `resourceCanvasHostGenerationPanelOpen` 的遮挡判据），提交受理后自动展开；工具栏入口按钮常驻并显示 `生成任务 · N`。每项的「定位到素材」**每次点击都终局化**（含跨栏目先切栏目、不在投影里给结论、3 秒有界兜底），不允许提示条永久停在「正在定位生成的素材…」。
## 5. 参数口径与复用程度