新增快速编辑正向媒体与素材类型白名单
同步浮动工具栏、右键菜单、打开入口和提交门禁
禁用角色动作、序列帧、音频和单个图标的快速编辑
补齐白名单回归测试并更新编辑器文档

@@ -6110,0 +6110,4 @@
+## 2026-08-04 图片画布快速编辑改用统一正向白名单（2026-08-05 修订）
+
+- 背景：画布生成结果统一显示快速编辑，但部分角色动作 / 序列帧和音频结果会进入不受支持的图片编辑链路；不同入口各自判断时也容易继续漂移。
+- 决策：快速编辑只支持普通静态图片、角色图、规范图、完整图标图集、单个拆分图标、UI 设计图、宣发图和视频。角色动作 / 序列帧、音效与背景音乐不支持；新增媒体或素材类型默认不开放。浮动工具栏、图层右键菜单、独立图片菜单、打开面板入口和提交门禁统一调用同一个正向白名单。

@@ -596,3 +596,2 @@
 
-export function isQuickEditUnsupportedAssetKind(layer: CanvasLayer) {
-  return layer.assetKind === 'icon';
+const QUICK_EDIT_SUPPORTED_MEDIA_TYPES = new Set<CanvasLayer['mediaType']>([

@@ -19,6 +19,7 @@
 - 鼠标中键拖拽始终平移画布；长按 Space 临时进入抓手模式，松开后恢复原工具。
 - 图片拖拽时显示水平 / 垂直吸附参考线，吸附到其它图层、生成占位框或画板的边缘与中心线；当移动元素接近两个同轴元素形成的等距位置时，支持横向或纵向等距吸附。
 - 生成资源右上角显示元数据按钮，点击打开独立元数据窗口。图片信息页不展示后端组装后的生图 Prompt，也不提供复制 Prompt；只展示该图片生成时用户在面板里提交的输入快照，包括普通生成提示词、规范表单字段、角色设定、图标素材描述、快速编辑提示词、重绘提示词，以及角色规范 / 常规参考图 / 图标规范 / 编辑参考图等参考图卡片，并提供“复制信息”复制当前可见字段。参考图输入快照只保存 `refType/refId` 行引用，其中 `refType="project-resource"` 指向 `editor_project_resource.resourceId`，`refType="asset"` 指向 `editor_asset.assetId`；不得把图片 Data URL、普通 URL 或 `objectKey` 写入 `generationInputs.references`。旧数据或上传图片没有输入快照时显示 `-`，禁止回退展示内部 Prompt。
+- 快速编辑使用统一正向白名单：只支持普通静态图片、角色图、规范图、完整图标图集、UI 设计图、宣发图和视频；单个拆分图标、角色动作 / 序列帧、音效与背景音乐不支持。浮动工具栏、图层右键菜单、独立图片菜单、打开面板入口和提交门禁必须复用同一白名单，新增媒体或素材类型默认不开放。`/api/editor/images/edits` 的 queue 与 inline 路径还必须基于目标图层的有效 `assetKind + mediaType` 执行后端正向门禁；视频快速编辑只能走视频生成接口，不得进入图片编辑 BFF。下文关于“角色动作素材按当前帧图片快速编辑”的历史表述由本条取代，角色动作只能通过对应的动作生成链路继续编辑。

@@ -2918,3 +2947,3 @@
         .filter(|value| !value.is_empty())
     else {
-        return ensure_editor_image_edit_asset_kind_allowed(payload.asset_kind.as_deref());
+        return ensure_editor_image_edit_source_kind_allowed(payload.asset_kind.as_deref(), None);

@@ -672,0 +685,4 @@
+  'video',
+]);
+
+export function isQuickEditSupportedLayer(layer: CanvasLayer) {

@@ -19,8 +19,9 @@
 - 鼠标中键拖拽始终平移画布；长按 Space 临时进入抓手模式，松开后恢复原工具。
 - 图片拖拽时显示水平 / 垂直吸附参考线，吸附到其它图层、生成占位框或画板的边缘与中心线；当移动元素接近两个同轴元素形成的等距位置时，支持横向或纵向等距吸附。
 - 生成资源右上角显示元数据按钮，点击打开独立元数据窗口。图片信息页不展示后端组装后的生图 Prompt，也不提供复制 Prompt；只展示该图片生成时用户在面板里提交的输入快照，包括普通生成提示词、规范表单字段、角色设定、图标素材描述、快速编辑提示词、重绘提示词，以及角色规范 / 常规参考图 / 图标规范 / 编辑参考图等参考图卡片，并提供“复制信息”复制当前可见字段。参考图输入快照只保存 `refType/refId` 行引用，其中 `refType="project-resource"` 指向 `editor_project_resource.resourceId`，`refType="asset"` 指向 `editor_asset.assetId`；不得把图片 Data URL、普通 URL 或 `objectKey` 写入 `generationInputs.references`。旧数据或上传图片没有输入快照时显示 `-`，禁止回退展示内部 Prompt。
+- 快速编辑使用统一正向白名单：只支持普通静态图片、角色图、规范图、完整图标图集、UI 设计图、宣发图和视频；单个拆分图标、角色动作 / 序列帧、音效与背景音乐不支持。浮动工具栏、图层右键菜单、独立图片菜单、打开面板入口和提交门禁必须复用同一白名单，新增媒体或素材类型默认不开放。`/api/editor/images/edits` 的 queue 与 inline 路径还必须基于目标图层的有效 `assetKind + mediaType` 执行后端正向门禁；视频快速编辑只能走视频生成接口，不得进入图片编辑 BFF；角色动作只能通过对应的动作生成链路继续编辑。画布 Agent 的 `edit_image` 只接收图片输入，新任务按普通静态图片提交空 `assetKind`，不得再生成 `assetKind="editor_agent_edit_image"`；worker 仅对 `dedupeKey` 属于可信 `editor-agent:` 命名空间的历史排队任务把该旧 synthetic 值归一为空，普通请求直接提交旧值仍失败关闭。已持久化项目资源中的该旧值在从真实目标图层解析后按普通静态图片兼容，不把该兼容扩大到客户端请求字段。

@@ -2868,3 +2867,1 @@
-        return Ok(());
-    };
-    if asset_kind != "icon" {
+pub(crate) fn ensure_editor_image_edit_source_kind_allowed(

@@ -2954,3 +2995,3 @@
         .map_err(map_editor_project_error)?;
     let project = editor_project_payload_from_record(project);
-    let asset_kind = resolve_editor_image_edit_target_layer_asset_kind(
+    let (asset_kind, media_type) = resolve_editor_image_edit_target_layer_source_kind(

@@ -3539,3 +3539,3 @@
         "type": "object",
         "required": [
-          "referenceImageSrc",
+          "referenceId",

@@ -1088,6 +1088,7 @@
         ],
         "operationId": "editExternalEditorImage",
         "summary": "重绘/调整编辑器图片素材",
+        "description": "主来源只接受当前账号已登记的项目资源 ID 或素材 ID（sourceReferenceId）；objectKey、URL、Data URL 与 Blob URL 即使归属当前账号也返回 400。服务端从命中的业务记录派生 canonical objectKey、assetObjectId 与权威类型，只允许普通静态图片（类型为 null）、spec、character、icon-spritesheet、icon-spec、publication-material 或 ui-design，其他及未知类型返回 400。提供 targetLayerId 时必须同时提供 projectId，目标图层必须关联有效项目资源；双方都有 assetObjectId 时必须相同，否则回退比较 canonical bucket/objectKey。同一对象的来源默认类型与目标资源默认类型冲突、目标有效类型或媒体类型不允许、来源或目标不存在/越权/缺少对象时均返回 400，任务不会入队。referenceImageSrcs 仍只作为辅助参考图。",

@@ -3458,3 +3459,3 @@
             "minLength": 1
           },
-          "sourceImageSrc": {
+          "sourceReferenceId": {

@@ -676,0 +690,4 @@
+  'video',
+]);
+
+export function isQuickEditSupportedLayer(layer: CanvasLayer) {

@@ -8358,6 +8400,10 @@ fn normalize_optional(value: Option<String>) -> Option<String> {
         .filter(|item| !item.is_empty())
 }
 
+fn normalize_editor_persisted_asset_kind(value: Option<String>) -> Option<String> {

@@ -12430,0 +13163,4 @@
+            &resource_asset_kinds,
+        )?;
+        let integrity = canvas_layout_integrity(structured_layout_json.as_str())?;
+        let migration = refresh_editor_image_asset_kind_layout_migration(

@@ -12430,0 +13340,4 @@
+        };
+        let structured_layout_json = build_structured_canvas_layout_json(ctx, &canvas)?;
+        verify_editor_image_asset_kind_cleanup_migration_state_allowing_prior_resource_cleanup(
+            &canvas,

@@ -12430,0 +13457,4 @@
+        .find(&canvas.project_id);
+    let mut layer_rows = ctx
+        .db
+        .editor_canvas_layer()