From fb8720e3afb026c1df29d99ab99932dcd5f3e489 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=8E=8B=E5=BE=B7=E5=AE=87?= <kvtodev@outlook.com>
Date: Sat, 5 Sep 2026 12:42:42 +0800
Subject: [PATCH 01/10] =?UTF-8?q?=E8=B5=84=E6=BA=90=E9=A1=B5=E5=A4=8D?=
 =?UTF-8?q?=E7=94=A8=E5=85=B1=E4=BA=AB=20CanvasWorld?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

移除项目开发页自有 world 变换与动态矩形尺寸

通过共享 CanvasWorld 提供资源卡控件反向缩放变量
---
 apps/ai-game-creator-shell/src/styles.css     | 10 ++++++++++
 .../src/view/project-development/index.tsx    | 12 ++++-------
 .../image-canvas-react/src/CanvasWorld.tsx    | 20 ++++++++++++-------
 3 files changed, 27 insertions(+), 15 deletions(-)

diff --git a/apps/ai-game-creator-shell/src/styles.css b/apps/ai-game-creator-shell/src/styles.css
index dbac2f8dc..b1748b822 100644
--- a/apps/ai-game-creator-shell/src/styles.css
+++ b/apps/ai-game-creator-shell/src/styles.css
@@ -5900,6 +5900,16 @@ iframe.preview-frame {
   text-overflow: ellipsis;
   white-space: nowrap;
   box-shadow: 0 8px 18px rgb(96 62 47 / 20%);
+  transform: scale(var(--genarrative-image-canvas-inverse-scale, 1));
+  transform-origin: top right;
+}
+
+.game-resource-card-media-control,
+.game-resource-card-placeholder > svg,
+.game-resource-card-version-visual > svg,
+.game-resource-card-audio-visual > svg {
+  transform: scale(var(--genarrative-image-canvas-inverse-scale, 1));
+  transform-origin: center;
 }
 
 .game-resource-card-open {
diff --git a/apps/ai-game-creator-shell/src/view/project-development/index.tsx b/apps/ai-game-creator-shell/src/view/project-development/index.tsx
index f539fc02f..6735ec1b4 100644
--- a/apps/ai-game-creator-shell/src/view/project-development/index.tsx
+++ b/apps/ai-game-creator-shell/src/view/project-development/index.tsx
@@ -3,6 +3,7 @@ import {
   type CanvasViewport,
   resolveViewportFromWheel,
 } from '@genarrative/image-canvas-core';
+import { CanvasWorld } from '@genarrative/image-canvas-react';
 import {
   Code2,
   FileText,
@@ -4906,17 +4907,12 @@ export default function ProjectDevelopmentView({
                             >
                               <RotateCcw size={15} aria-hidden="true" />
                             </button>
-                            <div
+                            <CanvasWorld
                               className="game-resource-page-world"
+                              viewport={activeResourceCanvasViewport}
                               data-resource-boundary={`${resourceCanvasNavigationBounds.x},${resourceCanvasNavigationBounds.y},${resourceCanvasNavigationBounds.width},${resourceCanvasNavigationBounds.height}`}
                               data-resource-fit-boundary={`${resourceCanvasFitBounds.x},${resourceCanvasFitBounds.y},${resourceCanvasFitBounds.width},${resourceCanvasFitBounds.height}`}
                               data-resource-viewport={`${activeResourceCanvasViewport.x},${activeResourceCanvasViewport.y},${activeResourceCanvasViewport.scale}`}
-                              style={{
-                                width: `${resourceCanvasNavigationBounds.width}px`,
-                                height: `${resourceCanvasNavigationBounds.height}px`,
-                                transform: `translate(${activeResourceCanvasViewport.x}px, ${activeResourceCanvasViewport.y}px) scale(${activeResourceCanvasViewport.scale})`,
-                                transformOrigin: '0 0',
-                              }}
                             >
                               {sortMode === 'dependency' ? (
                                 <ResourceDependencyOverlay
@@ -5016,7 +5012,7 @@ export default function ProjectDevelopmentView({
                                   />
                                 );
                               })}
-                            </div>
+                            </CanvasWorld>
                             {(
                               visibleResourcesByCategory.get(
                                 activePageCategory,
diff --git a/packages/image-canvas-react/src/CanvasWorld.tsx b/packages/image-canvas-react/src/CanvasWorld.tsx
index 3437360ab..4dd6bd889 100644
--- a/packages/image-canvas-react/src/CanvasWorld.tsx
+++ b/packages/image-canvas-react/src/CanvasWorld.tsx
@@ -2,7 +2,7 @@ import {
   CANVAS_WORLD_SIZE,
   type CanvasViewport,
 } from '@genarrative/image-canvas-core';
-import type { HTMLAttributes, ReactNode } from 'react';
+import type { CSSProperties, HTMLAttributes, ReactNode } from 'react';
 
 export function CanvasWorld({
   children,
@@ -16,16 +16,22 @@ export function CanvasWorld({
   viewport: CanvasViewport;
   worldSize?: number;
 }) {
+  const viewportScale =
+    Number.isFinite(viewport.scale) && viewport.scale > 0 ? viewport.scale : 1;
+
   return (
     <div
       {...props}
       className={`genarrative-image-canvas__world ${className}`.trim()}
-      style={{
-        ...style,
-        width: worldSize,
-        height: worldSize,
-        transform: `translate(${viewport.x}px, ${viewport.y}px) scale(${viewport.scale})`,
-      }}
+      style={
+        {
+          ...style,
+          width: worldSize,
+          height: worldSize,
+          transform: `translate(${viewport.x}px, ${viewport.y}px) scale(${viewportScale})`,
+          '--genarrative-image-canvas-inverse-scale': String(1 / viewportScale),
+        } as CSSProperties
+      }
     >
       {children}
     </div>
-- 
2.52.0


From a3dfd37576bf0e188030333e9f543174559c47cf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=8E=8B=E5=BE=B7=E5=AE=87?= <kvtodev@outlook.com>
Date: Sat, 5 Sep 2026 12:43:22 +0800
Subject: [PATCH 02/10] =?UTF-8?q?=E8=A1=A5=E5=85=85=E5=85=B1=E4=BA=AB?=
 =?UTF-8?q?=E7=94=BB=E5=B8=83=E8=B6=85=E9=87=87=E6=A0=B7=E5=86=B3=E7=AD=96?=
 =?UTF-8?q?=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

记录 CanvasWorld 默认 2 倍超采样与 viewport.scale 视觉比例契约

记录资源页继续使用 12000 正方形 world 且不新增矩形尺寸 API

记录 SVG 描边与资源页迁移验收边界
---
 docs/project-memory/shared-memory/decision-log.md          | 7 +++++++
 .../【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md  | 1 +
 2 files changed, 8 insertions(+)

diff --git a/docs/project-memory/shared-memory/decision-log.md b/docs/project-memory/shared-memory/decision-log.md
index 470f41c17..801395146 100644
--- a/docs/project-memory/shared-memory/decision-log.md
+++ b/docs/project-memory/shared-memory/decision-log.md
@@ -7949,6 +7949,13 @@ CI 上 `background_agent_runtime_recovers_stale_running_before_pending_task` 在
 - 新建/恢复 ephemeral Codex thread 时，replay 使用 `contextWindowTokens`、`autoCompactTokenLimit`、本次 `maxOutputTokens` 与 4096 安全余量计算预算，从最新记录向前选择连续完整的 `user` / `assistant` / `tool` 行；超预算旧前缀被省略，单条记录不截断，当前 user request 始终保留。
 - 发生省略时在 prompt 开头加入普通 `system: Earlier conversation history was omitted due to context budget.` 提示；当前请求本身超过硬上下文预算则直接失败。该策略是 Direct 专用滑动窗口，不复用 Runtime Agent 的摘要、tail 或 session compaction 生命周期。
 
+## 2026-09-05 共享 CanvasWorld 统一超采样与资源页迁移
+
+- 背景：资源总览页曾在业务层重复实现 world 的 transform、动态矩形尺寸和 2× `zoom`，与网站 / Tauri 共用的 `@genarrative/image-canvas-react` 形成第二套缩放逻辑；超采样还会让 SVG 卡片图标的线条产生视觉加粗。
+- 决策：`CanvasWorld` 默认统一采用 2× 超采样，内容按 `zoom: 2` 排版，外层使用 `viewport.scale / 2`，最终视觉比例仍由 `viewport.scale` 定义。所有调用方继续使用共享默认正方形 `CANVAS_WORLD_SIZE = 12000`，不引入 `worldWidth/worldHeight` 等矩形 API。资源页 `navigationBounds` 只保留布局、fit、依赖线 geometry 和 data 属性用途，不再驱动 world DOM 尺寸。非缩放描边只应用于资源依赖关系线等几何 overlay，静态卡片图标不继承统一 SVG 描边规则；位图维持浏览器默认插值，不全局启用 `pixelated`。
+- 影响范围：资源总览迁移为直接渲染共享 `CanvasWorld`，卡片控件通过共享 inverse-scale CSS 变量保持屏幕级尺寸；Asset Canvas、UI Editor 和依赖线继续消费相同 viewport 坐标与事件换算，不改变业务状态或持久化合同。
+- 验证方式：共享包与 AGC 定向类型 / 测试、资源页集成测试、`npm run check:encoding` 和 `git diff --check`；重点检查 `scale=1/2` 的最终 transform、SVG 描边、拖拽坐标、关系线端点和默认 `12000 × 12000` world。
+
 ## 2026-08-31 AGC 错误报告与诊断上传
 
 - AGC 采用 IDEA 风格的当前进程错误池：按 fingerprint 合并 React / window / Promise / Tauri / Agent 错误，重启后不恢复，不使用 run 或 run_id。
diff --git a/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md b/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md
index 8e886e8a4..dff11a4ee 100644
--- a/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md
+++ b/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md
@@ -549,6 +549,7 @@ game-project/
 - 中间主视窗提供 `资源管理 / 运行` 切换。`code-prototype` 任务完成前运行入口保持视觉不可用，但仍可点击查看“当前无可运行版本”，不能使用会阻断说明交互的原生 `disabled` 或 `aria-disabled`；完成后才允许进入运行表现层。切回资源管理只修改前端展示态，不伪造后端预览暂停结果。
 - 资源管理从当前 `GameCreationAppManifest`（包含可选 `versions`）、合法 Agent 文本回执和已导入附件派生资源，固定按文档、项目版本、美术资源、音乐音效资源分区；未知任务产物不再兜底为版本，任务声明中的未登记音频也不冒充正式音频。`按依赖 / 按类型` 使用各自前端排列，dependency 模式额外绘制当前 manifest 与资源投影可证明的依赖关系。排列与图层都不写回 manifest，不能推断或伪造缺失依赖。
 - 资源卡支持点击聚焦、搜索和类型筛选。2026-07-28 起完成两套二维坐标与本地 CAS sidecar；2026-07-31 起 dependency 模式增加不持久化的原生 SVG 关系图层。2026-08-03 mentor 决定暂缓资源卡拖动，当前卡片不挂载 Pointer Down / Move / Up / Cancel 拖动入口，只允许自动布局和点击聚焦。聚焦态替换中央主视窗内容，保留左侧导航、右侧对话和底部 Agent 状态栏，退出后恢复搜索、布局模式、滚动位置与选中资源；不提供工具栏、工具侧边栏或可拖动标题栏。2026-08-10 起聚焦态以资源元数据、Rust 权威深度、同类型上下游 / 任务流和版本信息为首屏；美术图片与视频只保留卡内本体，不在详情重复放大。安全文档正文与按意图读取的音频控制位于元数据之后；美术编辑、音频编辑 / 替换、版本替换或运行模块仍不在本阶段。
+- 2026-09-05 起所有 `@genarrative/image-canvas-react` 的 `CanvasWorld` 默认使用统一 2× 超采样：内容层按 `zoom: 2` 排版，外层 transform 使用 `viewport.scale / 2`，因此 `viewport.scale` 仍表示最终视觉比例（`1` 为原始大小，`2` 为放大两倍）。world 继续使用共享默认正方形 `CANVAS_WORLD_SIZE = 12000`，不新增矩形尺寸 API；资源页的 `navigationBounds` 只用于布局、fit、关系线 geometry 和数据属性，不能再设置 world DOM 宽高。非缩放描边只应用于资源依赖关系线等几何 overlay，Lucide 等静态卡片图标保持自身正常缩放，避免被统一 SVG 规则压窄；普通位图不强制 `pixelated` 插值。依赖线、卡片拖拽、平移和滚轮锚点继续使用同一逻辑 viewport 坐标。
 
 #### 资源管理串行改造：本体卡、分区缩放与依赖聚类
 
-- 
2.52.0


From f24949f7327f750292b60b447c5be7fac3c6e33d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=8E=8B=E5=BE=B7=E5=AE=87?= <kvtodev@outlook.com>
Date: Sat, 5 Sep 2026 12:45:00 +0800
Subject: [PATCH 03/10] =?UTF-8?q?=E5=85=B1=E4=BA=AB=20CanvasWorld=20?=
 =?UTF-8?q?=E7=BB=9F=E4=B8=80=E8=B6=85=E9=87=87=E6=A0=B7?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

默认以 2 倍内容分辨率渲染并保持 viewport.scale 的最终视觉比例

用反向 stroke-width 抵消资源卡 SVG 图标的超采样线宽

补充共享 CanvasWorld 超采样契约测试
---
 apps/ai-game-creator-shell/src/styles.css     | 11 ++++++----
 .../image-canvas-react/src/CanvasWorld.tsx    | 16 ++++++++++++--
 .../src/sharedCanvasReact.test.tsx            | 21 ++++++++++++++++++-
 3 files changed, 41 insertions(+), 7 deletions(-)

diff --git a/apps/ai-game-creator-shell/src/styles.css b/apps/ai-game-creator-shell/src/styles.css
index b1748b822..3914a60db 100644
--- a/apps/ai-game-creator-shell/src/styles.css
+++ b/apps/ai-game-creator-shell/src/styles.css
@@ -5904,14 +5904,17 @@ iframe.preview-frame {
   transform-origin: top right;
 }
 
-.game-resource-card-media-control,
-.game-resource-card-placeholder > svg,
-.game-resource-card-version-visual > svg,
-.game-resource-card-audio-visual > svg {
+.game-resource-card-media-control {
   transform: scale(var(--genarrative-image-canvas-inverse-scale, 1));
   transform-origin: center;
 }
 
+.game-resource-card-placeholder > svg *,
+.game-resource-card-version-visual > svg *,
+.game-resource-card-audio-visual > svg * {
+  stroke-width: calc(2px * var(--genarrative-image-canvas-inverse-scale, 1));
+}
+
 .game-resource-card-open {
   position: absolute;
   z-index: 1;
diff --git a/packages/image-canvas-react/src/CanvasWorld.tsx b/packages/image-canvas-react/src/CanvasWorld.tsx
index 4dd6bd889..d5ab20e97 100644
--- a/packages/image-canvas-react/src/CanvasWorld.tsx
+++ b/packages/image-canvas-react/src/CanvasWorld.tsx
@@ -4,6 +4,8 @@ import {
 } from '@genarrative/image-canvas-core';
 import type { CSSProperties, HTMLAttributes, ReactNode } from 'react';
 
+const CANVAS_RENDER_SUPERSAMPLE = 2;
+
 export function CanvasWorld({
   children,
   className = '',
@@ -28,12 +30,22 @@ export function CanvasWorld({
           ...style,
           width: worldSize,
           height: worldSize,
-          transform: `translate(${viewport.x}px, ${viewport.y}px) scale(${viewportScale})`,
+          transform: `translate(${viewport.x}px, ${viewport.y}px) scale(${viewportScale / CANVAS_RENDER_SUPERSAMPLE})`,
           '--genarrative-image-canvas-inverse-scale': String(1 / viewportScale),
         } as CSSProperties
       }
     >
-      {children}
+      <div
+        className="genarrative-image-canvas__world-content"
+        style={{
+          position: 'relative',
+          width: worldSize,
+          height: worldSize,
+          zoom: CANVAS_RENDER_SUPERSAMPLE,
+        }}
+      >
+        {children}
+      </div>
     </div>
   );
 }
diff --git a/packages/image-canvas-react/src/sharedCanvasReact.test.tsx b/packages/image-canvas-react/src/sharedCanvasReact.test.tsx
index 81304b756..1be34a166 100644
--- a/packages/image-canvas-react/src/sharedCanvasReact.test.tsx
+++ b/packages/image-canvas-react/src/sharedCanvasReact.test.tsx
@@ -1,10 +1,11 @@
 /* @vitest-environment jsdom */
 
 import type { CanvasLayer } from '@genarrative/image-canvas-core';
-import { act, renderHook } from '@testing-library/react';
+import { act, render, renderHook, screen } from '@testing-library/react';
 import { createRef } from 'react';
 import { afterEach, describe, expect, it, vi } from 'vitest';
 
+import { CanvasWorld } from './CanvasWorld';
 import { useImageCanvasViewportControls } from './useImageCanvasViewportControls';
 
 function layer(id: string, x: number): CanvasLayer {
@@ -52,6 +53,24 @@ afterEach(() => {
 });
 
 describe('shared canvas React lifecycle', () => {
+  it('renders a supersampled world while preserving the public viewport scale', () => {
+    render(
+      <CanvasWorld viewport={{ x: 12, y: 24, scale: 2 }}>
+        <span>content</span>
+      </CanvasWorld>,
+    );
+
+    const world = screen.getByText('content').parentElement?.parentElement;
+    const content = screen.getByText('content').parentElement;
+    expect(world?.style.width).toBe('12000px');
+    expect(world?.style.height).toBe('12000px');
+    expect(world?.style.transform).toBe('translate(12px, 24px) scale(1)');
+    expect(
+      world?.style.getPropertyValue('--genarrative-image-canvas-inverse-scale'),
+    ).toBe('0.5');
+    expect(content?.style.zoom).toBe('2');
+  });
+
   it('removes every native listener across repeated mounts', () => {
     const viewport = createViewport();
     const addListener = vi.spyOn(viewport, 'addEventListener');
-- 
2.52.0


From be0ae6d716a696c7b1c71f4b345d2ac280676adc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=8E=8B=E5=BE=B7=E5=AE=87?= <kvtodev@outlook.com>
Date: Sat, 5 Sep 2026 14:52:24 +0800
Subject: [PATCH 04/10] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E7=94=BB=E5=B8=83?=
 =?UTF-8?q?=E6=97=A7=E6=B5=8B=E8=AF=95=E7=9A=84=E9=80=BB=E8=BE=91=E7=BC=A9?=
 =?UTF-8?q?=E6=94=BE=E6=96=AD=E8=A8=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

抽取并导出逻辑 viewport 到渲染 transform 的共享转换函数

更新网站与 Tauri 画布测试，通过逻辑坐标和缩放值验证实际样式

同步画布公开契约和测试边界文档
---
 .../tests/assetCanvasSurface.test.tsx         | 33 ++++++++++++++-----
 .../shared-memory/decision-log.md             |  6 ++--
 ...�案】AI游戏创作智能体App实施计划-2026-06-24.md |  2 +-
 .../image-canvas-react/src/CanvasWorld.tsx    |  7 ++--
 .../src/canvasWorldRendering.ts               | 10 ++++++
 packages/image-canvas-react/src/index.ts      |  1 +
 .../src/sharedCanvasReact.test.tsx            | 10 ++++--
 .../ImageCanvasEditorView.test.tsx            | 13 +++++---
 .../ImageCanvasWorldView.test.tsx             |  9 +++--
 9 files changed, 68 insertions(+), 23 deletions(-)
 create mode 100644 packages/image-canvas-react/src/canvasWorldRendering.ts

diff --git a/apps/ai-game-creator-shell/tests/assetCanvasSurface.test.tsx b/apps/ai-game-creator-shell/tests/assetCanvasSurface.test.tsx
index 10ff7a0c7..8e69a5476 100644
--- a/apps/ai-game-creator-shell/tests/assetCanvasSurface.test.tsx
+++ b/apps/ai-game-creator-shell/tests/assetCanvasSurface.test.tsx
@@ -11,6 +11,7 @@ import type {
   ImageCanvasHostScope,
   ImageCanvasProjectPort,
 } from '@genarrative/image-canvas-core';
+import { canvasViewportToWorldTransform } from '@genarrative/image-canvas-react';
 import {
   act,
   fireEvent,
@@ -1125,7 +1126,7 @@ describe('Tauri 素材创作无限画布独立 Surface', () => {
     expect(
       document.querySelector<HTMLElement>('.genarrative-image-canvas__world')
         ?.style.transform,
-    ).toBe('translate(-2570px, -2495px) scale(1)');
+    ).toBe(canvasViewportToWorldTransform({ x: -2570, y: -2495, scale: 1 }));
     expect(screen.getByText('已定位当前最终图')).toBeTruthy();
   });
 
@@ -1170,7 +1171,7 @@ describe('Tauri 素材创作无限画布独立 Surface', () => {
     expect(
       document.querySelector<HTMLElement>('.genarrative-image-canvas__world')
         ?.style.transform,
-    ).toBe('translate(-2570px, -2495px) scale(1)');
+    ).toBe(canvasViewportToWorldTransform({ x: -2570, y: -2495, scale: 1 }));
     expect(screen.getByText('已定位当前最终图')).toBeTruthy();
 
     fireEvent.click(layerButton);
@@ -2062,7 +2063,9 @@ describe('Tauri 素材创作无限画布独立 Surface', () => {
       clientY: 60,
     });
     await waitFor(() =>
-      expect(world.style.transform).toBe('translate(30px, 30px) scale(0.5)'),
+      expect(world.style.transform).toBe(
+        canvasViewportToWorldTransform({ x: 30, y: 30, scale: 0.5 }),
+      ),
     );
     fireEvent.pointerMove(window, {
       pointerId: 16,
@@ -2070,7 +2073,9 @@ describe('Tauri 素材创作无限画布独立 Surface', () => {
       clientY: 30,
     });
     await waitFor(() =>
-      expect(world.style.transform).toBe('translate(0px, 0px) scale(0.5)'),
+      expect(world.style.transform).toBe(
+        canvasViewportToWorldTransform({ x: 0, y: 0, scale: 0.5 }),
+      ),
     );
     fireEvent.pointerUp(window, {
       pointerId: 16,
@@ -2315,7 +2320,9 @@ describe('Tauri 素材创作无限画布独立 Surface', () => {
     const world = document.querySelector(
       '.genarrative-image-canvas__world',
     ) as HTMLElement;
-    expect(world.style.transform).toBe('translate(0px, 0px) scale(0.5)');
+    expect(world.style.transform).toBe(
+      canvasViewportToWorldTransform({ x: 0, y: 0, scale: 0.5 }),
+    );
 
     fireEvent.wheel(viewport, {
       deltaX: 4,
@@ -2324,7 +2331,9 @@ describe('Tauri 素材创作无限画布独立 Surface', () => {
       clientY: 80,
     });
     await waitFor(() =>
-      expect(world.style.transform).toBe('translate(-4px, -10px) scale(0.5)'),
+      expect(world.style.transform).toBe(
+        canvasViewportToWorldTransform({ x: -4, y: -10, scale: 0.5 }),
+      ),
     );
     fireEvent.wheel(viewport, {
       deltaX: 0,
@@ -2334,7 +2343,9 @@ describe('Tauri 素材创作无限画布独立 Surface', () => {
       shiftKey: true,
     });
     await waitFor(() =>
-      expect(world.style.transform).toBe('translate(-14px, -10px) scale(0.5)'),
+      expect(world.style.transform).toBe(
+        canvasViewportToWorldTransform({ x: -14, y: -10, scale: 0.5 }),
+      ),
     );
     fireEvent.wheel(viewport, {
       deltaX: 0,
@@ -2344,7 +2355,13 @@ describe('Tauri 素材创作无限画布独立 Surface', () => {
       ctrlKey: true,
     });
     await waitFor(() =>
-      expect(world.style.transform).not.toContain('scale(0.5)'),
+      expect(world.style.transform).toBe(
+        canvasViewportToWorldTransform({
+          x: 100 - 228 * 0.55,
+          y: 80 - 180 * 0.55,
+          scale: 0.55,
+        }),
+      ),
     );
   });
 
diff --git a/docs/project-memory/shared-memory/decision-log.md b/docs/project-memory/shared-memory/decision-log.md
index 801395146..7328416f7 100644
--- a/docs/project-memory/shared-memory/decision-log.md
+++ b/docs/project-memory/shared-memory/decision-log.md
@@ -7951,10 +7951,10 @@ CI 上 `background_agent_runtime_recovers_stale_running_before_pending_task` 在
 
 ## 2026-09-05 共享 CanvasWorld 统一超采样与资源页迁移
 
-- 背景：资源总览页曾在业务层重复实现 world 的 transform、动态矩形尺寸和 2× `zoom`，与网站 / Tauri 共用的 `@genarrative/image-canvas-react` 形成第二套缩放逻辑；超采样还会让 SVG 卡片图标的线条产生视觉加粗。
-- 决策：`CanvasWorld` 默认统一采用 2× 超采样，内容按 `zoom: 2` 排版，外层使用 `viewport.scale / 2`，最终视觉比例仍由 `viewport.scale` 定义。所有调用方继续使用共享默认正方形 `CANVAS_WORLD_SIZE = 12000`，不引入 `worldWidth/worldHeight` 等矩形 API。资源页 `navigationBounds` 只保留布局、fit、依赖线 geometry 和 data 属性用途，不再驱动 world DOM 尺寸。非缩放描边只应用于资源依赖关系线等几何 overlay，静态卡片图标不继承统一 SVG 描边规则；位图维持浏览器默认插值，不全局启用 `pixelated`。
+- 背景：资源总览页曾在业务层重复实现 world 的渲染与尺寸逻辑，需与网站 / Tauri 共用的 `@genarrative/image-canvas-react` 统一。
+- 决策：`CanvasWorld` 的公开契约为逻辑 `viewport`，最终视觉比例由 `viewport.scale` 定义。渲染细节由共享包封装，调用方不得自行换算。所有调用方继续使用共享默认正方形 `CANVAS_WORLD_SIZE = 12000`，不引入 `worldWidth/worldHeight` 等矩形 API。资源页 `navigationBounds` 只保留布局、fit、依赖线 geometry 和 data 属性用途，不再驱动 world DOM 尺寸。非缩放描边只应用于资源依赖关系线等几何 overlay，静态卡片图标不继承统一 SVG 描边规则；位图维持浏览器默认插值，不全局启用 `pixelated`。
 - 影响范围：资源总览迁移为直接渲染共享 `CanvasWorld`，卡片控件通过共享 inverse-scale CSS 变量保持屏幕级尺寸；Asset Canvas、UI Editor 和依赖线继续消费相同 viewport 坐标与事件换算，不改变业务状态或持久化合同。
-- 验证方式：共享包与 AGC 定向类型 / 测试、资源页集成测试、`npm run check:encoding` 和 `git diff --check`；重点检查 `scale=1/2` 的最终 transform、SVG 描边、拖拽坐标、关系线端点和默认 `12000 × 12000` world。
+- 验证方式：调用方测试以预期逻辑 `{ x, y, scale }` 调用公开 helper `canvasViewportToWorldTransform`，再与实际 world 的 `style.transform` 比较；不手写渲染换算，不以缩放按钮文案替代 viewport 断言。运行共享包与 AGC 定向类型 / 测试、资源页集成测试、`npm run check:encoding` 和 `git diff --check`，覆盖 SVG 描边、拖拽坐标、关系线端点和默认 world 尺寸。
 
 ## 2026-08-31 AGC 错误报告与诊断上传
 
diff --git a/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md b/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md
index dff11a4ee..16d1896f1 100644
--- a/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md
+++ b/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md
@@ -549,7 +549,7 @@ game-project/
 - 中间主视窗提供 `资源管理 / 运行` 切换。`code-prototype` 任务完成前运行入口保持视觉不可用，但仍可点击查看“当前无可运行版本”，不能使用会阻断说明交互的原生 `disabled` 或 `aria-disabled`；完成后才允许进入运行表现层。切回资源管理只修改前端展示态，不伪造后端预览暂停结果。
 - 资源管理从当前 `GameCreationAppManifest`（包含可选 `versions`）、合法 Agent 文本回执和已导入附件派生资源，固定按文档、项目版本、美术资源、音乐音效资源分区；未知任务产物不再兜底为版本，任务声明中的未登记音频也不冒充正式音频。`按依赖 / 按类型` 使用各自前端排列，dependency 模式额外绘制当前 manifest 与资源投影可证明的依赖关系。排列与图层都不写回 manifest，不能推断或伪造缺失依赖。
 - 资源卡支持点击聚焦、搜索和类型筛选。2026-07-28 起完成两套二维坐标与本地 CAS sidecar；2026-07-31 起 dependency 模式增加不持久化的原生 SVG 关系图层。2026-08-03 mentor 决定暂缓资源卡拖动，当前卡片不挂载 Pointer Down / Move / Up / Cancel 拖动入口，只允许自动布局和点击聚焦。聚焦态替换中央主视窗内容，保留左侧导航、右侧对话和底部 Agent 状态栏，退出后恢复搜索、布局模式、滚动位置与选中资源；不提供工具栏、工具侧边栏或可拖动标题栏。2026-08-10 起聚焦态以资源元数据、Rust 权威深度、同类型上下游 / 任务流和版本信息为首屏；美术图片与视频只保留卡内本体，不在详情重复放大。安全文档正文与按意图读取的音频控制位于元数据之后；美术编辑、音频编辑 / 替换、版本替换或运行模块仍不在本阶段。
-- 2026-09-05 起所有 `@genarrative/image-canvas-react` 的 `CanvasWorld` 默认使用统一 2× 超采样：内容层按 `zoom: 2` 排版，外层 transform 使用 `viewport.scale / 2`，因此 `viewport.scale` 仍表示最终视觉比例（`1` 为原始大小，`2` 为放大两倍）。world 继续使用共享默认正方形 `CANVAS_WORLD_SIZE = 12000`，不新增矩形尺寸 API；资源页的 `navigationBounds` 只用于布局、fit、关系线 geometry 和数据属性，不能再设置 world DOM 宽高。非缩放描边只应用于资源依赖关系线等几何 overlay，Lucide 等静态卡片图标保持自身正常缩放，避免被统一 SVG 规则压窄；普通位图不强制 `pixelated` 插值。依赖线、卡片拖拽、平移和滚轮锚点继续使用同一逻辑 viewport 坐标。
+- `@genarrative/image-canvas-react` 的 `CanvasWorld` 接收逻辑 `viewport`，`viewport.scale` 表示最终视觉比例；渲染细节由共享包封装。调用方测试将预期逻辑 `{ x, y, scale }` 传入公开 helper `canvasViewportToWorldTransform`，再比较实际 world 的 `style.transform`；不自行换算渲染值，不以缩放按钮文案替代 viewport 断言。world 继续使用共享默认正方形 `CANVAS_WORLD_SIZE = 12000`，不新增矩形尺寸 API；资源页的 `navigationBounds` 只用于布局、fit、关系线 geometry 和数据属性，不能再设置 world DOM 宽高。非缩放描边只应用于资源依赖关系线等几何 overlay，Lucide 等静态卡片图标保持自身正常缩放，避免被统一 SVG 规则压窄；普通位图不强制 `pixelated` 插值。依赖线、卡片拖拽、平移和滚轮锚点继续使用同一逻辑 viewport 坐标。
 
 #### 资源管理串行改造：本体卡、分区缩放与依赖聚类
 
diff --git a/packages/image-canvas-react/src/CanvasWorld.tsx b/packages/image-canvas-react/src/CanvasWorld.tsx
index d5ab20e97..7698a9d23 100644
--- a/packages/image-canvas-react/src/CanvasWorld.tsx
+++ b/packages/image-canvas-react/src/CanvasWorld.tsx
@@ -4,7 +4,10 @@ import {
 } from '@genarrative/image-canvas-core';
 import type { CSSProperties, HTMLAttributes, ReactNode } from 'react';
 
-const CANVAS_RENDER_SUPERSAMPLE = 2;
+import {
+  CANVAS_RENDER_SUPERSAMPLE,
+  canvasViewportToWorldTransform,
+} from './canvasWorldRendering';
 
 export function CanvasWorld({
   children,
@@ -30,7 +33,7 @@ export function CanvasWorld({
           ...style,
           width: worldSize,
           height: worldSize,
-          transform: `translate(${viewport.x}px, ${viewport.y}px) scale(${viewportScale / CANVAS_RENDER_SUPERSAMPLE})`,
+          transform: canvasViewportToWorldTransform(viewport),
           '--genarrative-image-canvas-inverse-scale': String(1 / viewportScale),
         } as CSSProperties
       }
diff --git a/packages/image-canvas-react/src/canvasWorldRendering.ts b/packages/image-canvas-react/src/canvasWorldRendering.ts
new file mode 100644
index 000000000..83b1a120a
--- /dev/null
+++ b/packages/image-canvas-react/src/canvasWorldRendering.ts
@@ -0,0 +1,10 @@
+import type { CanvasViewport } from '@genarrative/image-canvas-core';
+
+export const CANVAS_RENDER_SUPERSAMPLE = 2;
+
+/** 将逻辑 viewport 转换为 world 的渲染 transform。 */
+export function canvasViewportToWorldTransform(viewport: CanvasViewport) {
+  const scale =
+    Number.isFinite(viewport.scale) && viewport.scale > 0 ? viewport.scale : 1;
+  return `translate(${viewport.x}px, ${viewport.y}px) scale(${scale / CANVAS_RENDER_SUPERSAMPLE})`;
+}
diff --git a/packages/image-canvas-react/src/index.ts b/packages/image-canvas-react/src/index.ts
index bb4023c2c..ea4d68259 100644
--- a/packages/image-canvas-react/src/index.ts
+++ b/packages/image-canvas-react/src/index.ts
@@ -2,6 +2,7 @@ export * from './CanvasChrome';
 export * from './CanvasPortal';
 export * from './CanvasViewport';
 export * from './CanvasWorld';
+export { canvasViewportToWorldTransform } from './canvasWorldRendering';
 export * from './LayerRenderer';
 export * from './Minimap';
 export * from './SelectionOverlay';
diff --git a/packages/image-canvas-react/src/sharedCanvasReact.test.tsx b/packages/image-canvas-react/src/sharedCanvasReact.test.tsx
index 1be34a166..56ffd5145 100644
--- a/packages/image-canvas-react/src/sharedCanvasReact.test.tsx
+++ b/packages/image-canvas-react/src/sharedCanvasReact.test.tsx
@@ -6,6 +6,10 @@ import { createRef } from 'react';
 import { afterEach, describe, expect, it, vi } from 'vitest';
 
 import { CanvasWorld } from './CanvasWorld';
+import {
+  CANVAS_RENDER_SUPERSAMPLE,
+  canvasViewportToWorldTransform,
+} from './canvasWorldRendering';
 import { useImageCanvasViewportControls } from './useImageCanvasViewportControls';
 
 function layer(id: string, x: number): CanvasLayer {
@@ -64,11 +68,13 @@ describe('shared canvas React lifecycle', () => {
     const content = screen.getByText('content').parentElement;
     expect(world?.style.width).toBe('12000px');
     expect(world?.style.height).toBe('12000px');
-    expect(world?.style.transform).toBe('translate(12px, 24px) scale(1)');
+    expect(world?.style.transform).toBe(
+      canvasViewportToWorldTransform({ x: 12, y: 24, scale: 2 }),
+    );
     expect(
       world?.style.getPropertyValue('--genarrative-image-canvas-inverse-scale'),
     ).toBe('0.5');
-    expect(content?.style.zoom).toBe('2');
+    expect(content?.style.zoom).toBe(String(CANVAS_RENDER_SUPERSAMPLE));
   });
 
   it('removes every native listener across repeated mounts', () => {
diff --git a/src/components/image-editor/ImageCanvasEditorView.test.tsx b/src/components/image-editor/ImageCanvasEditorView.test.tsx
index 8012511cb..32d777569 100644
--- a/src/components/image-editor/ImageCanvasEditorView.test.tsx
+++ b/src/components/image-editor/ImageCanvasEditorView.test.tsx
@@ -1,5 +1,6 @@
 /* @vitest-environment jsdom */
 
+import { canvasViewportToWorldTransform } from '@genarrative/image-canvas-react';
 import {
   act,
   fireEvent,
@@ -2412,11 +2413,13 @@ describe('ImageCanvasEditorView', () => {
     act(() => rafCallbacks.shift()?.(210));
     expect(world.style.transform).not.toBe(initialTransform);
     expect(world.style.transform).not.toBe(
-      'translate(-840px, -246.5px) scale(1)',
+      canvasViewportToWorldTransform({ x: -840, y: -246.5, scale: 1 }),
     );
 
     act(() => rafCallbacks.shift()?.(420));
-    expect(world.style.transform).toBe('translate(-840px, -246.5px) scale(1)');
+    expect(world.style.transform).toBe(
+      canvasViewportToWorldTransform({ x: -840, y: -246.5, scale: 1 }),
+    );
     expect(screen.getByLabelText('发送给画布 Agent')).toBeTruthy();
     expect(
       puzzleLayer.classList.contains('image-canvas-editor__layer--selected'),
@@ -2532,7 +2535,9 @@ describe('ImageCanvasEditorView', () => {
       clientX: 400,
       clientY: 280,
     });
-    expect(world.style.transform).toBe('translate(-80px, -120px) scale(0.5)');
+    expect(world.style.transform).toBe(
+      canvasViewportToWorldTransform({ x: -80, y: -120, scale: 0.5 }),
+    );
     expect(
       screen.getByRole('button', { name: '当前缩放比例 100%' }),
     ).toBeTruthy();
@@ -2567,7 +2572,7 @@ describe('ImageCanvasEditorView', () => {
     ).toBeTruthy();
     expect(
       (screen.getByTestId('image-canvas-world') as HTMLElement).style.transform,
-    ).toBe('translate(0px, 0px) scale(0.5)');
+    ).toBe(canvasViewportToWorldTransform({ x: 0, y: 0, scale: 0.5 }));
   });
 
   it('selects multiple canvas layers with shift click', async () => {
diff --git a/src/components/image-editor/ImageCanvasWorldView.test.tsx b/src/components/image-editor/ImageCanvasWorldView.test.tsx
index cc98a733e..ebc0b3b75 100644
--- a/src/components/image-editor/ImageCanvasWorldView.test.tsx
+++ b/src/components/image-editor/ImageCanvasWorldView.test.tsx
@@ -1,5 +1,6 @@
 /* @vitest-environment jsdom */
 
+import { canvasViewportToWorldTransform } from '@genarrative/image-canvas-react';
 import {
   act,
   fireEvent,
@@ -416,13 +417,15 @@ describe('ImageCanvasWorldView', () => {
     ).toBe('344px');
     expect(screen.getByText('生成中')).toBeTruthy();
 
-    const world = document.querySelector('.image-canvas-editor__world');
+    const world = document.querySelector<HTMLElement>(
+      '.image-canvas-editor__world',
+    );
     const marquee = world?.querySelector(
       '.image-canvas-editor__canvas-marquee',
     );
 
-    expect(world?.getAttribute('style')).toContain(
-      'transform: translate(10px, 20px) scale(1.5)',
+    expect(world?.style.transform).toBe(
+      canvasViewportToWorldTransform({ x: 10, y: 20, scale: 1.5 }),
     );
     expect((marquee as HTMLElement | null)?.style.width).toBe('100px');
     expect((marquee as HTMLElement | null)?.style.height).toBe('120px');
-- 
2.52.0


From 398ee643883685336d184077f21f1f568a367482 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, 7 Sep 2026 10:38:36 +0800
Subject: [PATCH 05/10] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E7=94=BB=E5=B8=83?=
 =?UTF-8?q?=E5=86=85=E5=B1=82=E7=A9=BA=E7=99=BD=E5=8C=BA=E5=9F=9F=E6=A1=86?=
 =?UTF-8?q?=E9=80=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

框选命中判断支持 world 的真实后代元素

回归测试覆盖共享 CanvasWorld 内层 pointerdown 冒泡

同步记录共享画布框选命中排障经验
---
 docs/project-memory/shared-memory/pitfalls.md |  8 +++++
 .../src/useImageCanvasStageInteractions.ts    |  5 +--
 .../useImageCanvasStageInteractions.test.tsx  | 35 +++++++++++++++----
 3 files changed, 39 insertions(+), 9 deletions(-)

diff --git a/docs/project-memory/shared-memory/pitfalls.md b/docs/project-memory/shared-memory/pitfalls.md
index 722ae47c9..575e20a4d 100644
--- a/docs/project-memory/shared-memory/pitfalls.md
+++ b/docs/project-memory/shared-memory/pitfalls.md
@@ -4983,3 +4983,11 @@
 - 原因：Tauri Windows bundler 执行自己的 `<tauri_tools_path>\NSIS\makensis.exe`，默认位于当前用户 `%LOCALAPPDATA%\tauri`，不使用 PATH 中预装的 `makensis.exe`；Jenkins LocalSystem/systemprofile 的 AppData 可能无法启动该缓存程序。
 - 处理：Windows 专用 Tauri 配置设置 `bundle.useLocalToolsDir: true`，把工具缓存到 `src-tauri/target/.tauri/NSIS`；Jenkins 预检验证实际用户、项目工具目录可写，并在构建失败时打印实际缓存路径和绝对路径执行结果。
 - 验证：不要把 PATH 中 `makensis` 可发现当作 Tauri bundler 工具可执行的充分证据；需要在 Windows Agent 上检查 `target/.tauri/NSIS/makensis.exe`、ACL、EDR/Defender 和直接 `-VERSION` 结果。
+
+## 共享画布框选需要识别 world 的真实后代命中
+
+- 现象：共享 `CanvasWorld` 在 world 外层增加 `.genarrative-image-canvas__world-content` 后，点击或拖拽空白画布时事件 `target` 是内层 div；框选逻辑若只检查外层 world 本身，就会只清除焦点而不创建选框。
+- 原因：viewport 上的 pointer 事件通过冒泡接收，`event.currentTarget` 是 viewport，空白区域的 `event.target` 可能是 world 的任意后代，不保证命中外层元素。
+- 处理：框选命中判断使用 `Element.closest('.genarrative-image-canvas__world')`，并保留 viewport 自身命中路径；回归测试通过真实 `CanvasWorld` DOM 的 `pointerdown` 冒泡覆盖内层 world content。
+- 验证：`src/components/image-editor/useImageCanvasStageInteractions.test.tsx` 覆盖内层 world content 命中，定向交互测试通过。
+- 关联：`packages/image-canvas-react/src/useImageCanvasStageInteractions.ts`、`packages/image-canvas-react/src/CanvasWorld.tsx`。
diff --git a/packages/image-canvas-react/src/useImageCanvasStageInteractions.ts b/packages/image-canvas-react/src/useImageCanvasStageInteractions.ts
index d5b3411cc..ce106893e 100644
--- a/packages/image-canvas-react/src/useImageCanvasStageInteractions.ts
+++ b/packages/image-canvas-react/src/useImageCanvasStageInteractions.ts
@@ -342,11 +342,12 @@ export function useImageCanvasStageInteractions({
         event.preventDefault();
         return;
       }
-      const target = event.target as HTMLElement;
+      const target = event.target;
       if (
         effectiveTool === 'select' &&
         (event.target === event.currentTarget ||
-          target.classList.contains('genarrative-image-canvas__world'))
+          (target instanceof Element &&
+            target.closest('.genarrative-image-canvas__world') !== null))
       ) {
         event.preventDefault();
         const rect = canvasViewportRef.current?.getBoundingClientRect();
diff --git a/src/components/image-editor/useImageCanvasStageInteractions.test.tsx b/src/components/image-editor/useImageCanvasStageInteractions.test.tsx
index d50e63623..fc510d559 100644
--- a/src/components/image-editor/useImageCanvasStageInteractions.test.tsx
+++ b/src/components/image-editor/useImageCanvasStageInteractions.test.tsx
@@ -1,5 +1,6 @@
 /* @vitest-environment jsdom */
 
+import { CanvasWorld } from '@genarrative/image-canvas-react';
 import { act, fireEvent, render, screen } from '@testing-library/react';
 import {
   type PointerEvent as ReactPointerEvent,
@@ -150,7 +151,6 @@ function StageInteractionsHarness({
   ) => void;
 }) {
   const canvasViewportRef = useRef<HTMLDivElement | null>(null);
-  const worldRef = useRef<HTMLDivElement | null>(null);
   const [activeTool, setActiveTool] = useState<'select' | 'hand'>('select');
   const [layers, setLayers] = useState<CanvasLayer[]>(() => [
     createLayer({ id: 'first', x: 40, y: 40, zIndex: 1 }),
@@ -288,11 +288,9 @@ function StageInteractionsHarness({
         onPointerMove={interaction.handlePointerMove}
         onPointerUp={interaction.finishDrag}
       >
-        <div
-          ref={worldRef}
-          className="genarrative-image-canvas__world"
-          data-testid="world"
-        />
+        <CanvasWorld viewport={viewport} data-testid="world">
+          <span aria-hidden="true" />
+        </CanvasWorld>
         {layers.map((layer) => (
           <button
             key={layer.id}
@@ -565,7 +563,8 @@ function StageInteractionsHarness({
               pointerId: 3,
               clientX: 20,
               clientY: 20,
-              target: worldRef.current ?? undefined,
+              target:
+                document.querySelector('[data-testid="world"]') ?? undefined,
             }),
           );
         }}
@@ -1240,6 +1239,28 @@ describe('useImageCanvasStageInteractions', () => {
     );
   });
 
+  it('starts a marquee when the real world content receives the pointer down', () => {
+    render(<StageInteractionsHarness />);
+
+    const worldContent = screen
+      .getByTestId('world')
+      .querySelector('.genarrative-image-canvas__world-content');
+    expect(worldContent).not.toBeNull();
+    const pointerDown = new Event('pointerdown', { bubbles: true });
+    Object.defineProperties(pointerDown, {
+      pointerId: { configurable: true, value: 30 },
+      clientX: { configurable: true, value: 20 },
+      clientY: { configurable: true, value: 20 },
+      button: { configurable: true, value: 0 },
+      buttons: { configurable: true, value: 1 },
+    });
+    act(() => {
+      worldContent?.dispatchEvent(pointerDown);
+    });
+
+    expect(screen.getByTestId('marquee').textContent).toBe('20,20');
+  });
+
   it('shows snap guides when generation frames drag near layer alignment', () => {
     render(<StageInteractionsHarness />);
 
-- 
2.52.0


From cd75b9a1b973320855d97e18a7265f46b31abf1b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=8E=8B=E5=BE=B7=E5=AE=87?= <kvtodev@outlook.com>
Date: Tue, 8 Sep 2026 11:06:03 +0800
Subject: [PATCH 06/10] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E8=B5=84=E6=BA=90?=
 =?UTF-8?q?=E7=94=BB=E5=B8=83=E6=92=AD=E6=94=BE=E6=8E=A7=E4=BB=B6=E7=BC=A9?=
 =?UTF-8?q?=E6=94=BE=E8=B6=8A=E7=95=8C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

将资源卡音视频播放控件的缩放原点固定到右下角。

增加播放控件缩放原点的样式回归断言。
---
 apps/ai-game-creator-shell/src/styles.css                      | 2 +-
 .../tests/appSurface/project-development.suite.ts              | 3 +++
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/apps/ai-game-creator-shell/src/styles.css b/apps/ai-game-creator-shell/src/styles.css
index 0d2c3bd9f..e5e46e627 100644
--- a/apps/ai-game-creator-shell/src/styles.css
+++ b/apps/ai-game-creator-shell/src/styles.css
@@ -5979,7 +5979,7 @@ iframe.preview-frame {
 
 .game-resource-card-media-control {
   transform: scale(var(--genarrative-image-canvas-inverse-scale, 1));
-  transform-origin: center;
+  transform-origin: bottom right;
 }
 
 .game-resource-card-placeholder > svg *,
diff --git a/apps/ai-game-creator-shell/tests/appSurface/project-development.suite.ts b/apps/ai-game-creator-shell/tests/appSurface/project-development.suite.ts
index 79815398b..e8a003398 100644
--- a/apps/ai-game-creator-shell/tests/appSurface/project-development.suite.ts
+++ b/apps/ai-game-creator-shell/tests/appSurface/project-development.suite.ts
@@ -1986,6 +1986,9 @@ export function registerProjectWorkbenchFoundationTests() {
     expect(styles).toMatch(
       /\.game-resource-card-open\s*\{[^}]*cursor:\s*pointer[^}]*touch-action:\s*manipulation/s,
     );
+    expect(styles).toMatch(
+      /\.game-resource-card-media-control\s*\{[^}]*transform:\s*scale\(var\(--genarrative-image-canvas-inverse-scale,\s*1\)\)[^}]*transform-origin:\s*bottom\s+right/s,
+    );
     expect(styles).toMatch(
       /\.game-resource-canvas\s*\{[^}]*user-select:\s*none/s,
     );
-- 
2.52.0


From e9ca9a456bf7f622012733a633b5b88f27281052 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=8E=8B=E5=BE=B7=E5=AE=87?= <kvtodev@outlook.com>
Date: Tue, 8 Sep 2026 17:43:09 +0800
Subject: [PATCH 07/10] =?UTF-8?q?=E4=BF=AE=E6=AD=A3=E9=A2=84=E8=A7=88?=
 =?UTF-8?q?=E7=94=BB=E5=B8=83=E5=BF=AB=E6=8D=B7=E7=BC=A9=E6=94=BE=E6=B5=8B?=
 =?UTF-8?q?=E8=AF=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

预览缩放测试改按逻辑 viewport.scale 断言

补充超采样渲染与用户缩放比例的验证约定
---
 .../tests/previewWorkspaceZoom.test.tsx       | 38 +++++++++++--------
 ...【交互设计】预览画布缩放滑杆-2026-09-05.md |  1 +
 2 files changed, 23 insertions(+), 16 deletions(-)

diff --git a/apps/ai-game-creator-shell/tests/previewWorkspaceZoom.test.tsx b/apps/ai-game-creator-shell/tests/previewWorkspaceZoom.test.tsx
index 908086f1d..50a89c1e2 100644
--- a/apps/ai-game-creator-shell/tests/previewWorkspaceZoom.test.tsx
+++ b/apps/ai-game-creator-shell/tests/previewWorkspaceZoom.test.tsx
@@ -87,13 +87,17 @@ function createCanvas(
   };
 }
 
-function renderedScale(container: HTMLElement) {
-  const transform = (
-    container.querySelector('.genarrative-image-canvas__world') as HTMLElement
-  ).style.transform;
-  const scale = /scale\(([^)]+)\)/.exec(transform)?.[1];
-  if (!scale) throw new Error(`无法从 ${transform} 读取缩放值`);
-  return Number(scale);
+function logicalViewportScale(container: HTMLElement) {
+  const world = container.querySelector(
+    '.genarrative-image-canvas__world',
+  ) as HTMLElement;
+  const inverseScale = Number(
+    world.style.getPropertyValue('--genarrative-image-canvas-inverse-scale'),
+  );
+  if (!Number.isFinite(inverseScale) || inverseScale <= 0) {
+    throw new Error(`无法从 world 读取逻辑缩放值`);
+  }
+  return 1 / inverseScale;
 }
 
 beforeEach(() => {
@@ -110,7 +114,7 @@ describe('PreviewWorkspace quick zoom', () => {
   it('uses the toolbar zoom step while the preview is hovered', () => {
     const rendered = render(<PreviewWorkspace canvas={createCanvas()} />);
     const preview = screen.getByRole('region', { name: 'UI 预览画布' });
-    const before = renderedScale(rendered.container);
+    const before = logicalViewportScale(rendered.container);
 
     fireEvent.pointerEnter(preview);
     const wasNotCancelled = fireEvent.keyDown(window, {
@@ -121,14 +125,14 @@ describe('PreviewWorkspace quick zoom', () => {
     });
 
     expect(wasNotCancelled).toBe(false);
-    expect(renderedScale(rendered.container)).toBeCloseTo(before * 1.16);
+    expect(logicalViewportScale(rendered.container)).toBeCloseTo(before * 1.16);
   });
 
   it('requires hover or focus and ignores interactive targets', () => {
     const rendered = render(<PreviewWorkspace canvas={createCanvas()} />);
     const preview = screen.getByRole('region', { name: 'UI 预览画布' });
     const zoomButton = screen.getByRole('button', { name: '放大画布' });
-    const initial = renderedScale(rendered.container);
+    const initial = logicalViewportScale(rendered.container);
 
     expect(
       fireEvent.keyDown(window, {
@@ -137,7 +141,7 @@ describe('PreviewWorkspace quick zoom', () => {
         cancelable: true,
       }),
     ).toBe(true);
-    expect(renderedScale(rendered.container)).toBe(initial);
+    expect(logicalViewportScale(rendered.container)).toBe(initial);
 
     fireEvent.pointerEnter(preview);
     expect(
@@ -147,7 +151,7 @@ describe('PreviewWorkspace quick zoom', () => {
         cancelable: true,
       }),
     ).toBe(true);
-    expect(renderedScale(rendered.container)).toBe(initial);
+    expect(logicalViewportScale(rendered.container)).toBe(initial);
 
     fireEvent.pointerLeave(preview);
     fireEvent.focus(preview);
@@ -157,13 +161,15 @@ describe('PreviewWorkspace quick zoom', () => {
       ctrlKey: true,
       cancelable: true,
     });
-    expect(renderedScale(rendered.container)).toBeCloseTo(initial * 0.86);
+    expect(logicalViewportScale(rendered.container)).toBeCloseTo(
+      initial * 0.86,
+    );
   });
 
   it('keeps actual-size and fit shortcuts within the preview scope', () => {
     const rendered = render(<PreviewWorkspace canvas={createCanvas()} />);
     const preview = screen.getByRole('region', { name: 'UI 预览画布' });
-    const fitted = renderedScale(rendered.container);
+    const fitted = logicalViewportScale(rendered.container);
 
     fireEvent.focus(preview);
     fireEvent.keyDown(window, {
@@ -171,14 +177,14 @@ describe('PreviewWorkspace quick zoom', () => {
       ctrlKey: true,
       cancelable: true,
     });
-    expect(renderedScale(rendered.container)).toBe(1);
+    expect(logicalViewportScale(rendered.container)).toBe(1);
 
     fireEvent.keyDown(window, {
       key: '0',
       ctrlKey: true,
       cancelable: true,
     });
-    expect(renderedScale(rendered.container)).toBe(fitted);
+    expect(logicalViewportScale(rendered.container)).toBe(fitted);
   });
 
   it('leaves browser zoom untouched when the preview has no content', () => {
diff --git a/docs/【交互设计】预览画布缩放滑杆-2026-09-05.md b/docs/【交互设计】预览画布缩放滑杆-2026-09-05.md
index 198d7788a..497fb7e85 100644
--- a/docs/【交互设计】预览画布缩放滑杆-2026-09-05.md
+++ b/docs/【交互设计】预览画布缩放滑杆-2026-09-05.md
@@ -19,6 +19,7 @@
 - 事件来自输入框、文本编辑区、按钮、链接、缩放工具栏或其他可操作控件时不拦截；不向 iframe 子文档注入监听。
 - 仅在存在可缩放视口且确认命中快捷键时调用 `preventDefault()` 与 `stopPropagation()`，防止浏览器页面同时缩放。
 - 保留现有 `Ctrl/Cmd+0` 适配画布与 `Ctrl/Cmd+1` 恢复 100% 行为，不增加其他重置快捷键。缩放仍是当前预览实例的临时 UI 状态。
+- 快捷键和百分比使用逻辑 `viewport.scale` 作为缩放真相；共享 `CanvasWorld` 的渲染 transform 可能包含超采样换算，验证时不得直接把 CSS transform 值当作用户可见比例。
 - 保留快捷键与缩放焦点边界的组件级回归测试，不扩展端到端测试。
 
 ## 验收
-- 
2.52.0


From b4595d312533748d24b88f0be779c89139de8815 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=8E=8B=E5=BE=B7=E5=AE=87?= <kvtodev@outlook.com>
Date: Wed, 9 Sep 2026 11:23:10 +0800
Subject: [PATCH 08/10] =?UTF-8?q?=E7=BB=9F=E4=B8=80=E7=94=BB=E5=B8=83?=
 =?UTF-8?q?=E8=A7=86=E5=8F=A3=E7=BC=A9=E6=94=BE=E5=85=9C=E5=BA=95=E9=80=BB?=
 =?UTF-8?q?=E8=BE=91?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

提取 getSafeViewportScale 供 world transform 与逆缩放变量复用

导出共享缩放辅助函数并保持现有渲染行为
---
 packages/image-canvas-react/src/CanvasWorld.tsx        |  4 ++--
 .../image-canvas-react/src/canvasWorldRendering.ts     | 10 ++++++++--
 packages/image-canvas-react/src/index.ts               |  5 ++++-
 3 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/packages/image-canvas-react/src/CanvasWorld.tsx b/packages/image-canvas-react/src/CanvasWorld.tsx
index 7698a9d23..bc089d1ce 100644
--- a/packages/image-canvas-react/src/CanvasWorld.tsx
+++ b/packages/image-canvas-react/src/CanvasWorld.tsx
@@ -7,6 +7,7 @@ import type { CSSProperties, HTMLAttributes, ReactNode } from 'react';
 import {
   CANVAS_RENDER_SUPERSAMPLE,
   canvasViewportToWorldTransform,
+  getSafeViewportScale,
 } from './canvasWorldRendering';
 
 export function CanvasWorld({
@@ -21,8 +22,7 @@ export function CanvasWorld({
   viewport: CanvasViewport;
   worldSize?: number;
 }) {
-  const viewportScale =
-    Number.isFinite(viewport.scale) && viewport.scale > 0 ? viewport.scale : 1;
+  const viewportScale = getSafeViewportScale(viewport);
 
   return (
     <div
diff --git a/packages/image-canvas-react/src/canvasWorldRendering.ts b/packages/image-canvas-react/src/canvasWorldRendering.ts
index 83b1a120a..c298c716c 100644
--- a/packages/image-canvas-react/src/canvasWorldRendering.ts
+++ b/packages/image-canvas-react/src/canvasWorldRendering.ts
@@ -2,9 +2,15 @@ import type { CanvasViewport } from '@genarrative/image-canvas-core';
 
 export const CANVAS_RENDER_SUPERSAMPLE = 2;
 
+/** 将 viewport scale 规范化为可用于渲染和反向缩放的正有限值。 */
+export function getSafeViewportScale(viewport: CanvasViewport) {
+  return Number.isFinite(viewport.scale) && viewport.scale > 0
+    ? viewport.scale
+    : 1;
+}
+
 /** 将逻辑 viewport 转换为 world 的渲染 transform。 */
 export function canvasViewportToWorldTransform(viewport: CanvasViewport) {
-  const scale =
-    Number.isFinite(viewport.scale) && viewport.scale > 0 ? viewport.scale : 1;
+  const scale = getSafeViewportScale(viewport);
   return `translate(${viewport.x}px, ${viewport.y}px) scale(${scale / CANVAS_RENDER_SUPERSAMPLE})`;
 }
diff --git a/packages/image-canvas-react/src/index.ts b/packages/image-canvas-react/src/index.ts
index ea4d68259..a1ea0ab9d 100644
--- a/packages/image-canvas-react/src/index.ts
+++ b/packages/image-canvas-react/src/index.ts
@@ -2,7 +2,10 @@ export * from './CanvasChrome';
 export * from './CanvasPortal';
 export * from './CanvasViewport';
 export * from './CanvasWorld';
-export { canvasViewportToWorldTransform } from './canvasWorldRendering';
+export {
+  canvasViewportToWorldTransform,
+  getSafeViewportScale,
+} from './canvasWorldRendering';
 export * from './LayerRenderer';
 export * from './Minimap';
 export * from './SelectionOverlay';
-- 
2.52.0


From 96e95ae155b3e19ddf634ea2e19406442bfaee99 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=8E=8B=E5=BE=B7=E5=AE=87?= <kvtodev@outlook.com>
Date: Wed, 9 Sep 2026 11:25:12 +0800
Subject: [PATCH 09/10] =?UTF-8?q?=E6=81=A2=E5=A4=8D=E8=B5=84=E6=BA=90?=
 =?UTF-8?q?=E5=8D=A1=E7=89=87=E9=9D=99=E6=80=81=E5=9B=BE=E6=A0=87=E6=8F=8F?=
 =?UTF-8?q?=E8=BE=B9=E7=BC=A9=E6=94=BE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

移除占位图标继承 inverse-scale 的统一 stroke-width 规则

保留资源依赖关系线的 non-scaling-stroke 几何覆盖行为
---
 apps/ai-game-creator-shell/src/styles.css | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/apps/ai-game-creator-shell/src/styles.css b/apps/ai-game-creator-shell/src/styles.css
index eaa412a88..67974305a 100644
--- a/apps/ai-game-creator-shell/src/styles.css
+++ b/apps/ai-game-creator-shell/src/styles.css
@@ -5982,12 +5982,6 @@ iframe.preview-frame {
   transform-origin: bottom right;
 }
 
-.game-resource-card-placeholder > svg *,
-.game-resource-card-version-visual > svg *,
-.game-resource-card-audio-visual > svg * {
-  stroke-width: calc(2px * var(--genarrative-image-canvas-inverse-scale, 1));
-}
-
 .game-resource-card-open {
   position: absolute;
   z-index: 1;
-- 
2.52.0


From 25df114b934b638da407f2c8391210b87892a39a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=8E=8B=E5=BE=B7=E5=AE=87?= <kvtodev@outlook.com>
Date: Wed, 9 Sep 2026 11:28:14 +0800
Subject: [PATCH 10/10] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E8=B5=84=E6=BA=90?=
 =?UTF-8?q?=E5=8D=A1=E7=89=87=E7=BC=A9=E6=94=BE=E6=8E=A7=E4=BB=B6=E8=A3=81?=
 =?UTF-8?q?=E5=89=AA?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

将卡片容器改为可见溢出，避免逆缩放徽标和媒体控件在低缩放时被截断

保留视觉内容层的溢出裁剪并继承卡片圆角
---
 apps/ai-game-creator-shell/src/styles.css | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/apps/ai-game-creator-shell/src/styles.css b/apps/ai-game-creator-shell/src/styles.css
index 67974305a..c6c0e33a4 100644
--- a/apps/ai-game-creator-shell/src/styles.css
+++ b/apps/ai-game-creator-shell/src/styles.css
@@ -5869,7 +5869,7 @@ iframe.preview-frame {
   height: var(--resource-card-height);
   min-height: var(--resource-card-height);
   padding: 0;
-  overflow: hidden;
+  overflow: visible;
   border: 1px solid #eadbd4;
   border-radius: 12px;
   background: #fff;
@@ -5912,6 +5912,7 @@ iframe.preview-frame {
   inset: 0;
   display: grid;
   overflow: hidden;
+  border-radius: inherit;
   background: linear-gradient(145deg, #fffaf6, #f6ece6);
   color: #c46a40;
   place-items: center;
-- 
2.52.0