From 59759360b78627a16eef23cfc35437e0508bcfba Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=8E=8B=E5=BE=B7=E5=AE=87?= <kvtodev@outlook.com>
Date: Mon, 27 Jul 2026 17:10:08 +0800
Subject: [PATCH] =?UTF-8?q?=E5=90=8C=E6=AD=A5=E7=B4=A0=E6=9D=90=E5=A4=9A?=
 =?UTF-8?q?=E9=80=89=E5=AF=BC=E5=87=BA=E6=8A=80=E6=9C=AF=E5=8F=A3=E5=BE=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

记录全选与取消全选清空范围锚点

记录四路并发读取、同步互斥和确定性 ZIP 顺序验收
---
 docs/technical/【前端架构】图片画布素材导出方案-2026-06-15.md  | 3 +++
 .../【前端架构】图片画布编辑器MVP接入方案-2026-06-11.md        | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/technical/【前端架构】图片画布素材导出方案-2026-06-15.md b/docs/technical/【前端架构】图片画布素材导出方案-2026-06-15.md
index 598069637..1c6cbb25b 100644
--- a/docs/technical/【前端架构】图片画布素材导出方案-2026-06-15.md
+++ b/docs/technical/【前端架构】图片画布素材导出方案-2026-06-15.md
@@ -166,6 +166,7 @@ assetObjectId > objectKey > sourceAssetId > src
 2. 过滤无效图层，保留隐藏图层。
 3. 按去重 key 合并图片源或序列帧源。
 4. 对每个素材源读取 Blob：
+   - 集合导出先按图层顺序完成去重和文件名规划，再用同一个四路并发读取器读取 / 转换普通素材与序列帧，最后按规划和原帧顺序写入 ZIP；不得让响应完成顺序改变导出目录或帧顺序。
    - `data:image/...` 直接转换为 Blob。
    - 同源或可访问 URL 使用 `fetch` 拉取 Blob。
    - 私有 generated / OSS 素材先走 `/api/assets/read-url` 换签并由浏览器直接 `fetch` OSS 签名 URL；只有换签或 OSS 字节读取失败时，才 fallback 到同源 `/api/assets/read-bytes`。
@@ -201,6 +202,8 @@ assetObjectId > objectKey > sourceAssetId > src
 - 序列帧导出的 `skeleton.json` 可被独立验证器解析并预览。
 - 左侧素材库只选一个素材时直接下载该素材，不创建集合 ZIP。
 - 左侧素材库选择多个素材时只把选中素材写入 `项目名-选中素材-YYYYMMDD-HHmmss.zip`，不混入未选素材，并继续覆盖部分失败和全部失败边界。
+- 同一事件循环内重复触发集合导出时只启动一次读取和下载；单个选中素材下载成功后显示 `选中素材已导出`。
+- 多素材与长序列帧集合导出同时读取不超过四项，外层素材无需等待前一个序列全部完成，异步读取逆序完成时 ZIP 文件与帧顺序仍保持稳定。
 
 ## Spine JSON 验证器
 
diff --git a/docs/technical/【前端架构】图片画布编辑器MVP接入方案-2026-06-11.md b/docs/technical/【前端架构】图片画布编辑器MVP接入方案-2026-06-11.md
index cc70c368d..d7529dbee 100644
--- a/docs/technical/【前端架构】图片画布编辑器MVP接入方案-2026-06-11.md
+++ b/docs/technical/【前端架构】图片画布编辑器MVP接入方案-2026-06-11.md
@@ -146,7 +146,7 @@
 - 音频 / 视频素材卡和画布媒体图层必须提供稳定的非文字视觉预览：优先使用 `thumbnailSrc` / 视频 `poster`，没有真实首帧或音频封面时使用由媒体类型、素材名和地址派生的确定性视觉底图。视频图层使用原生 `<video controls preload="metadata" playsInline>` 播放，外层图层仍承接选择和拖拽语义；音频图层播放前继续通过 `/api/assets/read-url` 换签。画布素材导出按 `mediaType` 保留真实媒体格式：图片进入 `images/`，音频 / 视频进入 `media/`，文件扩展名从响应 MIME、`objectKey` 或源 URL 推断，不得把音频 / 视频导出成 PNG。
 - 画布素材 ZIP 的 `metadata.json` 只保存前端信息弹窗和导出文件列表可见的展示快照：项目标题、导出时间、图层标题、文件路径、类型、生成输入、模型显示名、Task 短 ID、Object 显示值、Resolution / 时长和导出错误。导出的生成输入只保留用户实际填写或选择的内容；系统默认兜底提示词、固定工作流提示词、内置图标描述、UI 提取素材固定提示词等内置提示词即使存在于历史 `generationInputs`，也不得写入导出元数据。不得把 `projectId`、`layerId`、`resourceId`、`sourceAssetId`、`sourceResourceId`、原始 `prompt` / `actualPrompt` / `provider` 或画布坐标、锁定、隐藏等布局状态写入导出元数据；Object 字段仅沿用信息弹窗当前可见值。
 - `生成角色动作` 的完成结果按序列帧素材处理：图层主 `src` 使用 `frames[0].imageSrc`，`mediaType` 固定为 `image-sequence`，`assetKind` 固定为 `character-animation`，完整帧列表写入 `imageSequenceFrames`；`previewVideoPath` 只保留为上游预览视频来源，不作为画布主媒体。下载和 ZIP 导出必须因此得到序列帧 ZIP / frames 目录，不能回退为预览视频或首帧 PNG；后端抽帧后逐帧保存带绿幕源图，上传时消费并释放原帧字节，再用该对象的 600 秒 OSS URL 完成透明化并落盘透明帧素材。
-- 素材面板支持按素材名、文件夹名、生成信息、模型、任务和媒体类型搜索。选择模式只作用于左侧素材库当前搜索结果中已展开、上传完成且媒体地址有效的可见素材，素材缩略图、标题、元数据和卡片空白区统一作为整行选择命中区：桌面鼠标 / 键盘普通点击替换选择，`Ctrl / Cmd + 点击` 切换追加，`Shift + 点击` 按当前可见顺序选择连续区间，`Ctrl / Cmd + Shift + 点击` 追加区间；触摸和笔输入单击采用切换选择。搜索或折叠变化后必须剔除已不可见选择，退出选择模式、关闭素材栏或切换到图层栏时必须同时清空选择锚点、选中集合和框选状态，非选择模式不得残留选中高亮。
+- 素材面板支持按素材名、文件夹名、生成信息、模型、任务和媒体类型搜索。选择模式只作用于左侧素材库当前搜索结果中已展开、上传完成且媒体地址有效的可见素材，素材缩略图、标题、元数据和卡片空白区统一作为整行选择命中区：桌面鼠标 / 键盘普通点击替换选择，`Ctrl / Cmd + 点击` 切换追加，`Shift + 点击` 按当前可见顺序选择连续区间，`Ctrl / Cmd + Shift + 点击` 追加区间；触摸和笔输入单击采用切换选择。搜索或折叠变化后必须剔除已不可见选择，全选 / 取消全选必须清空上次单项选择的范围锚点；退出选择模式、关闭素材栏或切换到图层栏时必须同时清空选择锚点、选中集合和框选状态，非选择模式不得残留选中高亮。
 - 素材选择模式的批量工具栏是素材列表滚动区之外的固定底栏，始终显示当前已选数量、当前可见素材全选 / 取消全选、下载、删除和取消；工具栏自身禁止横向溢出和滚动，空间不足时按钮在工具栏内部换行。不得把工具栏作为滚动列表末项或依赖 `position: sticky` 的自然位置。移动端进入素材选择模式时必须提高素材侧栏高度并允许素材列表纵向滚动，为固定底栏之上至少保留一张素材卡的可操作空间，不得沿用普通模式 `14rem` 上限压扁列表。选择模式隐藏单素材下载 / 重命名动作并禁用素材拖拽和右键菜单，避免批量意图回退成单素材操作。
 - 图层面板支持按图层名、生成信息、模型、任务和媒体类型搜索；支持选择多个图层后创建图层组，组名和 groupId 随画布布局保存。
 - 小地图支持拖拽视口框，拖动时画布 viewport 跟随移动；`pointermove` 更新必须通过 `requestAnimationFrame` 合帧，结束拖拽时 flush 最后一帧，避免高频 pointermove 直接压垮 React 渲染和项目持久化链路。