Merge branch 'master' into fix/agc-vite-target-watch

apps/ai-game-creator-shell/scripts/build-release.mjs

@@ -196,9 +196,21 @@ async function readRemoteChannelManifest(channel = resolveReleaseChannel()) {
   return fetchManifest(updateManifestUrl(channel), 'OSS 渠道清单');
 }
 
+/**
+ * 摘要锚点：上次发布对应的提交。
+ *
+ * 首选渠道清单里的 `commit`（发布产物自己的事实来源）；清单缺该字段时（首次启用
+ * 摘要、或更换渠道后清单还没带过 commit）回退到 CI 传入的 `AGC_UPDATE_PREVIOUS_COMMIT`
+ * —— 它是上一次成功构建的 COMMIT_HASH，同样指向用户拿到的那个版本。
+ */
 export async function resolvePreviousReleaseCommit(
   channel = resolveReleaseChannel(),
+  { override = process.env.AGC_UPDATE_PREVIOUS_COMMIT } = {},
 ) {
+  const explicit = override?.trim();
+  if (explicit && /^[0-9a-f]{7,40}$/u.test(explicit)) {
+    return explicit;
+  }
   const manifest = await readRemoteChannelManifest(channel);
   const commit =
     typeof manifest?.commit === 'string' ? manifest.commit.trim() : '';

apps/ai-game-creator-shell/scripts/build-release.test.mjs

@@ -22,6 +22,7 @@ import {
   formatReleaseNotes,
   nextPatchVersion,
   resolveManifestPlatformKeys,
+  resolvePreviousReleaseCommit,
   resolveReleaseChannel,
   resolveRemoteHighWaterVersion,
   selectReleaseArtifact,
@@ -241,6 +242,41 @@ test('version high water ignores the windows migration pointer for other channel
   );
 });
 
+test('release notes anchor prefers the explicit commit and falls back to the manifest', async () => {
+  await withStubbedFetch(
+    () => jsonResponse({ version: '0.1.61', commit: 'abcdef1234567890' }),
+    async () => {
+      assert.equal(
+        await resolvePreviousReleaseCommit('dev-win', {
+          override: '6017d46088c04199e99cf89f347b12d67591475e',
+        }),
+        '6017d46088c04199e99cf89f347b12d67591475e',
+      );
+      // 覆盖值非法时忽略，继续用清单里的 commit。
+      assert.equal(
+        await resolvePreviousReleaseCommit('dev-win', {
+          override: 'not-a-sha',
+        }),
+        'abcdef1234567890',
+      );
+      assert.equal(
+        await resolvePreviousReleaseCommit('dev-win', { override: '  ' }),
+        'abcdef1234567890',
+      );
+    },
+  );
+
+  await withStubbedFetch(
+    () => jsonResponse({ version: '0.1.61' }),
+    async () => {
+      assert.equal(
+        await resolvePreviousReleaseCommit('dev-win', { override: undefined }),
+        null,
+      );
+    },
+  );
+});
+
 test('release upload forces overwrite for artifact, signature and channel pointers', () => {
   const source = readFileSync(
     new URL('./release-upload.mjs', import.meta.url),
@@ -364,3 +400,30 @@ test('scheduler path filter stays in sync with client release paths', () => {
     );
   }
 });
+
+test('scheduler skips the full build only for non-deploy paths', () => {
+  const jenkinsfile = readFileSync(
+    new URL(
+      '../../../jenkins/Jenkinsfile.scheduled-revision-trigger',
+      import.meta.url,
+    ),
+    'utf8',
+  );
+  const skipLine = jenkinsfile
+    .split('\n')
+    .find((line) => line.includes('docs/*|.codex/*|jenkins/*'));
+  assert.ok(skipLine, '调度管线里应存在 Full Build 跳过模式');
+  for (const pattern of [
+    'docs/*',
+    '.codex/*',
+    'jenkins/*',
+    'apps/ai-game-creator-shell/*',
+    'apps/mobile-shell/*',
+    'apps/desktop-shell/*',
+    'apps/preview-deployer-web/*',
+    'tools/*',
+    '*.md',
+  ]) {
+    assert.ok(skipLine.includes(pattern), `Full Build 跳过模式缺少 ${pattern}`);
+  }
+});