新增 AssetCanvasSurface 点击重构前备份。

新增素材画布样式点击重构前备份。

@@ -2482,3 +3362,3 @@
             root,
             &mut ledger,
-            GenerationLedgerPhase::AssetDurableCommitted,
+            GenerationLedgerPhase::CandidateReady,

@@ -2575,0 +3496,4 @@
+            }
+            ledger.phase = GenerationLedgerPhase::Archived;
+            ledger.archived_at = Some(asset_canvas_now());
+            write_generation_ledger(root, &mut ledger)?;

@@ -1751,0 +2360,4 @@
+        createdAt: Date.now(),
+        updatedAt: Date.now(),
+      };
+      const initialGenerationRecord: ImageCanvasGenerationRecord = {

@@ -1769,0 +2489,4 @@
+        result.value.images.forEach((image) =>
+          URL.revokeObjectURL(image.previewUrl),
+        );
+        await hydrateDraft(result.value.draft, epoch);

@@ -1923,0 +2706,4 @@
+    quickEditOpen && quickEditSourceLayerId
+      ? (layers.find((layer) => layer.id === quickEditSourceLayerId) ?? null)
+      : null;
+  const quickEditPanelStyle: CSSProperties | null = quickEditSourceLayer

@@ -676,2 +748,4 @@
+          '--resource-card-height': `${cardSize.height}px`,
         } as CSSProperties
       }
+      onPointerDown={(event) => onPointerDown(event, resource, x, y)}

@@ -1439,2 +1774,4 @@
     };
     const wheel = (event: WheelEvent) => {
+      const target = event.target instanceof Element ? event.target : null;
+      if (target?.closest('button, input, textarea, select, a')) {

@@ -2084,0 +2627,4 @@
+      }
+      if (!drag.captured) {
+        drag.captured = true;
+        event.currentTarget.setPointerCapture?.(event.pointerId);

@@ -3434,0 +3893,4 @@
+            />
+          ) : mode === 'resources' ? (
+            <>
+              {focusedResource ? (

@@ -966,1 +1265,3 @@
-          position.x + RESOURCE_CANVAS_CARD_WIDTH + RESOURCE_CANVAS_COLUMN_GAP,
+      ...positions.map((position) =>
+        Math.ceil(
+          position.x +

@@ -345,3 +345,3 @@
 ### 5.3 资源类型与替换兼容性（P1）
 
-实现状态（2026-08-10）：当前资源投影已收口到固定的“文档 -> 项目版本 -> 美术资源 -> 音乐音效资源”四区。文档接收受支持的 UTF-8 文档/代码和合法 Agent 文本回执；项目版本只接收显式 `ProjectVersionResourceSummary` read model，未知任务产物不得兜底为版本；美术接收图片、SVG、动画和视频类产物；音频接收 manifest 资产、上传登记资产和已完成任务 `artifacts` 明确声明的音频产物。无法识别的二进制任务产物和附件不进入资源画布。受控读取、中央聚焦、失败空态与媒体播放不改变 manifest 真相；编辑成功后只追加新的 asset 或版本子记录。
+实现状态（2026-08-22）：当前资源投影与栏目页顺序收口为“文档 -> 美术资源 -> 音乐音效资源 -> 游戏代码 -> 项目版本”。文档接收受支持的 UTF-8 文档、代码资产中的文档类型和合法 Agent 文本回执；项目版本只接收显式 `ProjectVersionResourceSummary` read model，未知任务产物不得兜底为版本；美术接收图片、SVG、动画和视频类产物；音频接收 manifest 资产、上传登记资产和已完成任务 `artifacts` 明确声明的音频产物；游戏代码接收 Direct Codex / 任务产物登记的 HTML、CSS 和 JavaScript。无法识别的二进制任务产物和附件不进入资源画布。受控读取、中央聚焦、失败空态与媒体播放不改变 manifest 真相；编辑成功后只追加新的 asset 或版本子记录。

@@ -0,0 +13,4 @@
+### 栏目分页投影与设计文档缺失边界
+
+- 非空栏目页只由当前权威资源投影构造：manifest assets、已完成任务的 artifacts、用户已导入附件和持久化 Agent 文本回执。前端不得扫描项目目录自行发明资源。
+- 设计文档栏因此只有在上述来源存在 Markdown / TXT / JSON / YAML 等文档类条目，或存在 Agent 文本回执时才出现。若 manifest 没有文档资产、任务 artifacts 未完成且没有附件 / 回执，资源页不显示设计文档页；这是生成或登记缺失，不由 UI 补假数据。

@@ -193,6 +200,11 @@ export interface ImageCanvasProjectPort {
 }
 
 export interface ImageCanvasAssetPort {
+  importLocalImages?(input: {

@@ -56,2 +55,2 @@
-2. 阶段二“分区独立缩放”（已完成）只适用于 `type` 模式，同时包含互不替代的分区可视高度和内容倍率。文档、项目版本、美术资源、音乐音效资源的标题栏分别保留高度减小 / 恢复 / 增大，并新增 `50%..200%` 内容缩放减小 / 百分比复位 / 增大；触摸板捏合、`Ctrl/Cmd + wheel` 与按钮使用同一倍率模型，普通双指滚动仍只滚动。高度与倍率都以 `projectId + type + category` 隔离并只保留在当前会话内存；倍率以分区 viewport 中的手势中心为锚点，逻辑 `x / y` 和媒体比例不变；非图片资源维持 `180×128`，美术图片按真实比例和统一边界计算本体矩形。最小高度固定容纳标题操作与至少一排卡片，最大高度以中央资源画布当前可用高度为上限。分区保持正常文档流，后续分区由外层资源画布滚动访问，单区内容在缩放后仍只在该区内部滚动。两类表现态都不修改 manifest、`game-creator-resource-layout.v1`、布局 CAS 或资源身份，不重建媒体控件、不抢走焦点，也不恢复卡片拖动。`dependency` 模式使用统一世界自由画板，不展示这些分区滚动与缩放操作。
-3. 阶段三“依赖布局聚类”（已完成）：仅在 `dependency` 模式中，按固定资源分类对当前 Rust 只读图返回的同类型精确引用边和同类型聚合任务流做弱连通分组；任务流以流节点连接其成员，绝不展开成资源笛卡尔积，但只作为布局邻近提示，不绘制虚线、不进入画布关系说明。`dependencyDepth` 是唯一横向层级权威；每个相关簇先按“最小深度 -> 最小稳定资源 ID”排序，再在同层进行固定两轮由左至右、由右至左的中位数扫描，平局回退稳定资源 ID；同 SCC/环成员保持连续，环后资源继续按 Rust 深度推进。孤立资源是稳定单例组，紧凑排在相关簇之后，簇之间保持固定留白。跨分类精确引用不参与前端布局邻接，但会在统一世界 SVG 中显示并进入同源的无障碍关系说明；搜索只隐藏卡片及任一端点被隐藏的橙色精确引用边，不重算组或压缩坐标。历史 `manuallyPlaced=true` 坐标继续原样保留并参与自动坐标避让。聚类是可派生表现，不新增 manifest 字段、sidecar schema、SpacetimeDB 表或第二套依赖真相。
+1. 阶段一“资源卡本体化”：`dependency / type` 两种布局共用同一个资源卡组件和预览调度器。图片与安全 SVG 直接显示主体并保留透明棋盘底；图片卡按真实纵横比在统一边界内计算展示矩形，视频、音频、文档和项目版本继续使用稳定固定卡片。资源详情是叠加在原画板上的非模态独立卡片，以元数据、Rust 权威依赖关系和版本信息为主；打开详情不得卸载“按依赖 / 按类型 / 复位”等现役画布级动作、资源卡、依赖连线或重置 viewport、搜索和排序模式。
+2. 阶段二“分区独立缩放”是历史实现；2026-08-22 起仅在项目完全没有任何资源投影时保留“按类型式分区展览”作为空态。任一栏目出现资源后，`dependency / type` 两种模式均切换为栏目分页画布，默认停留在固定栏目顺序中的第一个非空栏目；大纲展示全部栏目，空栏目计数为 0 且可打开空画布，不再提供分区高度、分区滚动和分区倍率操作。