修复正式序列帧稳定引用持久化

正式序列帧强制携带 objectKey 与 assetObjectId，并按 objectKey 重建持久路径

同步收紧 External v1 OpenAPI 并补充签名 URL 负向测试

保留异步生成紧凑结果中的逐帧 assetObjectId 并更新架构文档

docs/openapi/genarrative-external-v1.openapi.json

@@ -4047,6 +4047,8 @@
         "type": "object",
         "required": [
           "imageSrc",
+          "objectKey",
+          "assetObjectId",
           "width",
           "height"
         ],
@@ -4055,16 +4057,14 @@
             "type": "string"
           },
           "objectKey": {
-            "type": [
-              "string",
-              "null"
-            ]
+            "type": "string",
+            "minLength": 1,
+            "description": "帧对应的稳定 OSS Object Key；服务端据此重建持久 imageSrc，不能只提交临时签名 URL。"
           },
           "assetObjectId": {
-            "type": [
-              "string",
-              "null"
-            ]
+            "type": "string",
+            "minLength": 1,
+            "description": "帧对应的稳定资产对象 ID。"
           },
           "width": {
             "type": "integer",
@@ -4076,7 +4076,7 @@
           }
         },
         "additionalProperties": false,
-        "description": "图片序列帧。数组位置是唯一播放顺序，不携带额外序号字段。"
+        "description": "图片序列帧。数组位置是唯一播放顺序，不携带额外序号字段；每帧必须同时携带 objectKey 与 assetObjectId，imageSrc 按 objectKey 规范化为持久站内路径。"
       },
       "EditorCharacterAnimationGenerationResponse": {
         "type": "object",

docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md

@@ -676,6 +676,7 @@ Responses 的终态载荷既是工具调用的恢复源，也是正文的恢复
 - Rust 结构体：`EditorAsset`
 - 源码：`server-rs/crates/spacetime-module/src/editor_project_storage.rs`
 - 说明：图片画布账号级素材表，保存用户上传 / 生成素材的名称、文件夹、媒体读取地址、可选封面 `thumbnail_src`、OSS 引用、尺寸、来源类型、prompt、provider、真实操作 `task_id`、可选后台归组 `group_task_id`、拆分批次预期数量 `group_task_expected_asset_count`、`asset_kind`、`generation_inputs_json`、可选 `source_resource_id`、`generation_cost_mud_points` 和序列媒体结果字段。`asset_kind` 是唯一权威媒体类别；`image_sequence_frames_json` 与 `image_sequence_duration_ms` 保存角色动作正式结果，数组长度派生帧数、数组顺序决定播放顺序、FPS 按需推导，`generation_inputs_json` 只保存用户可见生成 / 重放输入。`prompt` 固定表示规范化后的用户原始意图，供跨资源搜索和用户侧元数据使用；provider 实际返回的改写只写 `actual_prompt`，提交给 provider 的系统 / 工程化 prompt 不得写入 `prompt`。角色透明图、图标透明图和自动切片等派生产物继承源用户 prompt，并用 `source_resource_id`、`generation_inputs_json`、provider / asset kind 表达处理来源。归组字段只用于稳定派生任务的后台分组，不替代 `task_id`；批次是否初始完整以独立完成事实为准，不按当前剩余素材数反推。素材在同一账号的所有项目中可见；图片 / 图标 / UI 提取等生成 BFF 在请求携带 `asset_folder_id` 时负责创建账号级生成素材并返回 asset 快照，若同次生成也创建了 `editor_project_resource`，则把该 `resource_id` 写入 `source_resource_id`。角色动作生成把原始绿幕预览视频作为独立 `asset_kind = video` 素材保存，再把最终帧序列作为一条 `asset_kind = character-animation` 素材入库：首帧写入 `image_src` / `thumbnail_src`，完整帧数组与图片序列毫秒时长写入两个正式媒体结果字段；生成端确认每个最终帧对象后，必须把该帧的 `objectKey` 与 `assetObjectId` 同时写入正式帧 payload，不能只在内部处理中暂存或仅保留首帧引用；存在项目上下文时，最终动作的 `source_resource_id` 指向预览视频资源。不把每帧拆成独立素材，也不重复保存预览路径。生成视频会抽取首帧封面写入 `thumbnail_src`，素材库和再次放入画布时用它作为 video poster。素材库快照通过 `asset_id` 回查对应 `editor_showcase_asset`，供左侧素材菜单展示 `pending` / `approved` / `rejected` 审核状态；公开事实不落在账号素材表，素材库只发起提交审核。素材放入画布时复制为 `editor_project_resource` 并由图层引用 resourceId，画布从 resource / asset 级元数据恢复素材类别、媒体结果和用户可见生成输入快照。
+- 正式序列帧写入边界：写入端必须逐帧取得非空 `objectKey` 与 `assetObjectId`，并始终按 `objectKey` 重建 `imageSrc` 的持久站内路径。只有临时签名 URL 而没有这两项稳定引用的 External v1 请求返回 `400`，不能进入正式素材或项目资源。
 - 索引：`by_editor_asset_owner_user_id`、`by_editor_asset_folder_id`。
 
 ### `editor_asset_group_source_provenance`