合并：同步最新master

合并 origin/master 8f19964e3 到 BGM 优化分支

保留 BGM 记录、完美像素改动及双方前端测试

通过冲突相关前端定向测试（61项）

packages/shared/src/contracts/gameCreationApp.test.ts

@@ -638,6 +638,16 @@ describe('AI 游戏创作 App 共享契约', () => {
           updatedAt: 123,
         },
       ],
+      versions: [
+        {
+          versionId: 'version-1',
+          parentVersionId: null,
+          projectRevision: 7,
+          resourceBindings: [{ slotId: 'player', resourceId: 'asset-player' }],
+          createdReason: 'initial',
+          createdAt: 456,
+        },
+      ],
       assets: [
         {
           id: 'asset-player',
@@ -678,6 +688,16 @@ describe('AI 游戏创作 App 共享契约', () => {
           logPath: '.agent/logs/command.log',
         },
       ],
+      versions: [
+        {
+          versionId: 'version-1',
+          parentVersionId: null,
+          projectRevision: 7,
+          resourceBindings: [{ slotId: 'player', resourceId: 'asset-player' }],
+          createdReason: 'initial',
+          createdAt: 456,
+        },
+      ],
     });
   });
 });

packages/shared/src/contracts/gameCreationApp.ts

@@ -537,6 +537,25 @@ export interface GameCreationAppCommandRunState {
   updatedAt: number;
 }
 
+export type GameIterationVersionCreatedReason =
+  | 'initial'
+  | 'resource-replacement'
+  | 'agent-revision';
+
+export interface GameIterationVersionResourceBinding {
+  slotId: string;
+  resourceId: string;
+}
+
+export interface GameIterationVersion {
+  versionId: string;
+  parentVersionId: string | null;
+  projectRevision: number;
+  resourceBindings: GameIterationVersionResourceBinding[];
+  createdReason: GameIterationVersionCreatedReason;
+  createdAt: number;
+}
+
 export interface GameCreationAppManifest {
   schemaVersion: string;
   projectId: string;
@@ -546,6 +565,7 @@ export interface GameCreationAppManifest {
   assets: GameCreationAppAssetManifestEntry[];
   preview?: GameCreationAppPreviewState | null;
   commandRuns?: GameCreationAppCommandRunState[];
+  versions?: GameIterationVersion[];
 }
 
 export interface GameCreationAgentToolCallTrace {