Skip to content

Formerly KrillinAI, VideoTranslation and Dubbing Tool for 120+ Languages. Open-source AI workspace for creators, powered by Codex. Video downloader, video translation, create videos, images, audios, and edits with Agents in one place. For your Social Media like YouTube, TikTok, Instagram, etc.

Refresh release metadata from verified notarized artifacts

Leggett54fffbafa298
diff --git a/.github/workflows/desktop-release.yml b/.github/workflows/desktop-release.yml
index 578cefab..884b168b 100644
--- a/.github/workflows/desktop-release.yml
+++ b/.github/workflows/desktop-release.yml
@@ -13,6 +13,11 @@ on:
- macos-x64
- macos-arm64
- windows-x64
+ - publish
+ release_tag:
+ description: 仅 target=publish 时使用的现有发布标签(保留标签和候选安装包)
+ required: false
+ type: string
push:
tags:
- 'v*'
@@ -33,30 +38,60 @@ jobs:
timeout-minutes: 5
outputs:
matrix: ${{ steps.release-matrix.outputs.matrix }}
+ release-tag: ${{ steps.release-target.outputs.tag }}
+ release-sha: ${{ steps.release-target.outputs.sha }}
steps:
- uses: actions/checkout@v4
+ with:
+ fetch-depth: 0
- name: 校验 Desktop 发布标签
- if: startsWith(github.ref, 'refs/tags/')
- run: node apps/desktop/scripts/verify-desktop-release-tag.mjs "${{ github.ref_name }}"
+ id: release-target
+ env:
+ TARGET: ${{ inputs.target }}
+ RELEASE_TAG: ${{ inputs.release_tag }}
+ shell: bash
+ run: |
+ if [[ "$GITHUB_EVENT_NAME" == workflow_dispatch && "$TARGET" == publish ]]; then
+ if [[ "$GITHUB_REF" != refs/heads/master ]]; then
+ echo '::error::手动提升现有标签只能从 master 运行。'
+ exit 1
+ fi
+ release="$(node apps/desktop/scripts/release-build-input.mjs promotion-target "$RELEASE_TAG")"
+ echo "tag=$(jq -r '.tag' <<< "$release")" >> "$GITHUB_OUTPUT"
+ echo "sha=$(jq -r '.sha' <<< "$release")" >> "$GITHUB_OUTPUT"
+ elif [[ "$GITHUB_REF" == refs/tags/* ]]; then
+ node apps/desktop/scripts/verify-desktop-release-tag.mjs "$GITHUB_REF_NAME"
+ echo "tag=$GITHUB_REF_NAME" >> "$GITHUB_OUTPUT"
+ echo "sha=$GITHUB_SHA" >> "$GITHUB_OUTPUT"
+ else
+ if [[ -n "$RELEASE_TAG" ]]; then
+ echo '::error::release_tag 只能与 target=publish 一起使用。'
+ exit 1
+ fi
+ echo "sha=$GITHUB_SHA" >> "$GITHUB_OUTPUT"
+ fi
- name: 校验同一提交的 CI 已通过
env:
GH_TOKEN: ${{ github.token }}
GH_REPO: ${{ github.repository }}
+ RELEASE_SHA: ${{ steps.release-target.outputs.sha }}
run: |
- successful_runs="$(
- gh run list \
- --workflow ci.yml \
- --commit "$GITHUB_SHA" \
- --event push \
- --status success \
- --limit 1 \
- --json databaseId \
- --jq 'length'
- )"
- if [[ "$successful_runs" != "1" ]]; then
- echo "::error::提交 $GITHUB_SHA 尚无成功的 master push CI,请等待 CI 通过后再创建发布标签。"
- exit 1
- fi
+ for sha in $(printf '%s\n' "$GITHUB_SHA" "$RELEASE_SHA" | sort -u); do
+ successful_runs="$(
+ gh run list \
+ --workflow ci.yml \
+ --commit "$sha" \
+ --event push \
+ --status success \
+ --limit 1 \
+ --json databaseId \
+ --jq 'length'
+ )"
+ if [[ "$successful_runs" != "1" ]]; then
+ echo "::error::提交 $sha 尚无成功的 master push CI,请等待 CI 通过后再创建发布标签。"
+ exit 1
+ fi
+ done
- name: 选择 Desktop 构建平台
id: release-matrix
shell: bash
@@ -64,7 +99,7 @@ jobs:
TARGET: ${{ inputs.target || 'all' }}
run: |
case "$TARGET" in
- all)
+ all|publish)
matrix='{"include":[{"name":"macos-x64","os":"macos-15-intel","platform":"darwin","arch":"x64","artifact":"opencreator-desktop-macos-x64"},{"name":"macos-arm64","os":"macos-15","platform":"darwin","arch":"arm64","artifact":"opencreator-desktop-macos-arm64"},{"name":"windows-x64","os":"windows-latest","platform":"win32","arch":"x64","artifact":"opencreator-desktop-windows-x64-unsigned"}]}'
;;
macos-x64)
@@ -84,7 +119,7 @@ jobs:
echo "matrix=$matrix" >> "$GITHUB_OUTPUT"
package:
- if: github.event_name == 'workflow_dispatch'
+ if: github.event_name == 'workflow_dispatch' && inputs.target != 'publish'
needs: verify
timeout-minutes: 90
strategy:
@@ -323,18 +358,25 @@ jobs:
retention-days: 90
publish:
- if: startsWith(github.ref, 'refs/tags/v')
+ if: startsWith(github.ref, 'refs/tags/v') || (github.event_name == 'workflow_dispatch' && inputs.target == 'publish')
needs: verify
runs-on: ubuntu-latest
timeout-minutes: 20
permissions:
actions: read
contents: write
+ env:
+ TAG: ${{ needs.verify.outputs.release-tag }}
+ RELEASE_SHA: ${{ needs.verify.outputs.release-sha }}
steps:
- uses: actions/checkout@v4
+ - uses: pnpm/action-setup@v4
- uses: actions/setup-node@v4
with:
node-version: 22
+ cache: pnpm
+ - name: 安装发布元数据解析依赖
+ run: pnpm install --filter @opencreator/daemon --frozen-lockfile --ignore-scripts
- name: 计算应用构建输入指纹
id: build-input
run: echo "digest=$(node apps/desktop/scripts/release-build-input.mjs digest)" >> "$GITHUB_OUTPUT"
@@ -359,7 +401,7 @@ jobs:
run="$(gh api "repos/$GH_REPO/actions/runs/$candidate_run_id")"
candidate_sha="$(jq -r '.head_sha' <<< "$run")"
comparison_status="$(
- gh api "repos/$GH_REPO/compare/$candidate_sha...$GITHUB_SHA" --jq '.status'
+ gh api "repos/$GH_REPO/compare/$candidate_sha...$RELEASE_SHA" --jq '.status'
)"
if [[ "$(jq -r '.event' <<< "$run")" != "workflow_dispatch" \
|| "$(jq -r '.head_branch' <<< "$run")" != "master" \
@@ -416,15 +458,25 @@ jobs:
NODE
- name: 校验发布附件并生成下载说明
env:
- TAG: ${{ github.ref_name }}
GH_REPO: ${{ github.repository }}
run: node apps/desktop/scripts/release-assets.mjs artifacts "$TAG" "$GH_REPO" release-notes.md
- name: 发布 GitHub Release
env:
GH_TOKEN: ${{ github.token }}
GH_REPO: ${{ github.repository }}
- TAG: ${{ github.ref_name }}
+ PROMOTION_ONLY: ${{ inputs.target == 'publish' }}
run: |
- gh release view "$TAG" >/dev/null 2>&1 || gh release create "$TAG" --verify-tag --draft --title "OpenCreator $TAG" --notes-file release-notes.md
- find artifacts -maxdepth 1 -type f -print0 | xargs -0 gh release upload "$TAG" --clobber
+ if [[ "$PROMOTION_ONLY" == true ]]; then
+ gh api "repos/$GH_REPO/releases/tags/$TAG" > published-release.json
+ node --input-type=module <<'NODE'
+ import { readFileSync } from 'node:fs';
+ import { verifyPublishedPayloads } from './apps/desktop/scripts/release-assets.mjs';
+ const { assets } = JSON.parse(readFileSync('published-release.json', 'utf8'));
+ verifyPublishedPayloads({ directory: 'artifacts', assets });
+ NODE
+ gh release upload "$TAG" artifacts/latest*.yml artifacts/SHA256SUMS.txt --clobber
+ else
+ gh release view "$TAG" >/dev/null 2>&1 || gh release create "$TAG" --verify-tag --draft --title "OpenCreator $TAG" --notes-file release-notes.md
+ find artifacts -maxdepth 1 -type f -print0 | xargs -0 gh release upload "$TAG" --clobber
+ fi
gh release edit "$TAG" --draft=false --latest --title "OpenCreator $TAG" --notes-file release-notes.md
diff --git a/apps/desktop/scripts/release-assets.mjs b/apps/desktop/scripts/release-assets.mjs
index 26326bef..f2df75a9 100644
--- a/apps/desktop/scripts/release-assets.mjs
+++ b/apps/desktop/scripts/release-assets.mjs
@@ -2,6 +2,12 @@ import { createHash } from 'node:crypto';
import { copyFileSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs';
import { basename, join, resolve } from 'node:path';
import { fileURLToPath } from 'node:url';
+import { createRequire } from 'node:module';
+
+// Reuse the YAML parser already pinned by the Daemon workspace.
+const { parse: parseYaml, stringify: stringifyYaml } = createRequire(
+ new URL('../../daemon/package.json', import.meta.url)
+)('yaml');
const scriptDir = resolve(fileURLToPath(new URL('.', import.meta.url)));
const desktopDir = resolve(scriptDir, '..');
@@ -93,6 +99,64 @@ function writeChecksums(directory, names) {
writeFileSync(join(directory, 'SHA256SUMS.txt'), `${lines.join('\n')}\n`);
}
+export function refreshUpdaterMetadata({ directory, version }) {
+ const updates = releasePlatforms.map(({ platform, arch }) => {
+ const names = releaseAssetNames(version, platform, arch);
+ const metadataName = names.find(name => name.endsWith('.yml'));
+ const primaryName = names.find(name => name.endsWith(platform === 'darwin' ? '.zip' : '.exe'));
+ const metadata = parseYaml(readFileSync(join(directory, metadataName), 'utf8'), {
+ maxAliasCount: 0
+ });
+ if (metadata?.version !== version || metadata.path !== primaryName || !Array.isArray(metadata.files)) {
+ throw new Error(`Invalid updater target or version: ${metadataName}`);
+ }
+ const allowed = names.filter(name => /\.(zip|dmg|exe)$/.test(name));
+ const seen = new Set();
+ for (const file of metadata.files) {
+ if (!allowed.includes(file.url) || seen.has(file.url)) {
+ throw new Error(`Unexpected updater file in ${metadataName}: ${file.url}`);
+ }
+ seen.add(file.url);
+ const path = join(directory, file.url);
+ const size = statSync(path).size;
+ const sha512 = createHash('sha512').update(readFileSync(path)).digest('base64');
+ // Stapling changes the DMG after Electron Builder writes its metadata.
+ // The ZIP/EXE update payload must already match the verified candidate.
+ if (!file.url.endsWith('.dmg') && (
+ file.sha512 !== sha512 || (file.size !== undefined && file.size !== size)
+ )) {
+ throw new Error(`Updater payload does not match its candidate metadata: ${file.url}`);
+ }
+ file.sha512 = sha512;
+ file.size = size;
+ if (file.url === primaryName && metadata.sha512 !== sha512) {
+ throw new Error(`Updater primary checksum is inconsistent: ${metadataName}`);
+ }
+ }
+ if (!seen.has(primaryName)) throw new Error(`Missing updater payload: ${metadataName}`);
+ return { path: join(directory, metadataName), metadata };
+ });
+ // Validate every platform before writing any derived metadata.
+ for (const update of updates) {
+ writeFileSync(update.path, stringifyYaml(update.metadata, { lineWidth: 0 }));
+ }
+}
+
+export function verifyPublishedPayloads({ directory, assets }) {
+ const names = readdirSync(directory).sort();
+ if (JSON.stringify(assets.map(asset => asset.name).sort()) !== JSON.stringify(names)) {
+ throw new Error('Published release asset list differs from the verified candidate');
+ }
+ const checksums = new Map(readFileSync(join(directory, 'SHA256SUMS.txt'), 'utf8')
+ .trim().split('\n').map(line => [line.slice(66), `sha256:${line.slice(0, 64)}`]));
+ for (const asset of assets) {
+ if (asset.name === 'SHA256SUMS.txt' || asset.name.endsWith('.yml')) continue;
+ if (asset.digest !== checksums.get(asset.name)) {
+ throw new Error(`Published payload differs from the verified candidate: ${asset.name}`);
+ }
+ }
+}
+
export function finalizeReleaseAssets({ directory, version, repository, highlights = '' }) {
const desktopAssets = releasePlatforms.flatMap(
({ platform, arch }) => releaseAssetNames(version, platform, arch)
@@ -111,6 +175,7 @@ export function finalizeReleaseAssets({ directory, version, repository, highligh
for (const name of expected) {
if (!actual.some(entry => entry.name === name)) throw new Error(`Missing release asset: ${name}`);
}
+ refreshUpdaterMetadata({ directory, version });
writeChecksums(directory, expected);
return renderReleaseNotes({ version, repository, highlights });
}
diff --git a/apps/desktop/scripts/release-build-input.mjs b/apps/desktop/scripts/release-build-input.mjs
index 4826749d..2f642425 100644
--- a/apps/desktop/scripts/release-build-input.mjs
+++ b/apps/desktop/scripts/release-build-input.mjs
@@ -1,7 +1,9 @@
import { createHash } from 'node:crypto';
import { execFileSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
import { resolve } from 'node:path';
import { fileURLToPath } from 'node:url';
+import { verifyDesktopReleaseTag } from './verify-desktop-release-tag.mjs';
const scriptPath = fileURLToPath(import.meta.url);
@@ -51,6 +53,20 @@ export function buildInputDigest(ref = 'HEAD', cwd = process.cwd()) {
return digestBuildEntries(parseTreeEntries(output));
}
+export function resolvePromotionTarget(tag, cwd = process.cwd()) {
+ const { version } = JSON.parse(readFileSync(resolve(cwd, 'apps/desktop/package.json'), 'utf8'));
+ if (!tag) throw new Error('An existing release tag is required for promotion');
+ verifyDesktopReleaseTag(tag, version);
+ const sha = execFileSync('git', ['rev-parse', '--verify', `refs/tags/${tag}^{commit}`], {
+ cwd, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe']
+ }).trim();
+ execFileSync('git', ['merge-base', '--is-ancestor', sha, 'HEAD'], { cwd, stdio: 'pipe' });
+ if (buildInputDigest(sha, cwd) !== buildInputDigest('HEAD', cwd)) {
+ throw new Error('Promotion requires identical application build inputs at the tag and workflow commit');
+ }
+ return { tag, sha };
+}
+
export function changedPaths(base, head, cwd = process.cwd()) {
if (!base || /^0+$/.test(base)) return null;
try {
@@ -85,6 +101,8 @@ if (process.argv[1] && resolve(process.argv[1]) === scriptPath) {
} else if (command === 'release-only') {
if (args.length !== 2) throw new Error('release-only requires <base> <head>');
console.log(changesAreReleaseOnly(changedPaths(args[0], args[1])) ? 'true' : 'false');
+ } else if (command === 'promotion-target') {
+ console.log(JSON.stringify(resolvePromotionTarget(args[0])));
} else {
throw new Error(`Unknown command: ${command}`);
}
diff --git a/apps/desktop/test/release-assets.test.mjs b/apps/desktop/test/release-assets.test.mjs
index 86b98970..17219fe3 100644
--- a/apps/desktop/test/release-assets.test.mjs
+++ b/apps/desktop/test/release-assets.test.mjs
@@ -3,17 +3,43 @@ import { spawnSync } from 'node:child_process';
import { mkdtempSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
import { tmpdir } from 'node:os';
import { join, resolve } from 'node:path';
+import { createRequire } from 'node:module';
import { afterEach, describe, expect, it } from 'vitest';
import {
finalizeReleaseAssets,
krillinReleaseAssetNames,
releaseAssetNames,
+ refreshUpdaterMetadata,
+ verifyPublishedPayloads,
remotionReleaseAssetName,
stageReleaseAssets
} from '../scripts/release-assets.mjs';
const version = '3.0.0';
const directories = [];
+const targets = [['darwin', 'arm64'], ['darwin', 'x64'], ['win32', 'x64']];
+const { parse: parseYaml } = createRequire(new URL('../../daemon/package.json', import.meta.url))('yaml');
+
+function updaterFixture(directory, platform, arch) {
+ const names = releaseAssetNames(version, platform, arch);
+ const files = names.filter(name => /\.(dmg|zip|exe)$/.test(name)).map(url => {
+ const bytes = readFileSync(join(directory, url));
+ return { url, sha512: createHash('sha512').update(bytes).digest('base64'), ...(platform === 'darwin' ? { size: bytes.length } : {}) };
+ });
+ const primary = files.find(file => file.url.endsWith(platform === 'darwin' ? '.zip' : '.exe'));
+ writeFileSync(join(directory, names.find(name => name.endsWith('.yml'))), JSON.stringify({
+ version, files, path: primary.url, sha512: primary.sha512, releaseDate: '2026-10-16T00:00:00.000Z'
+ }));
+}
+
+function completeUpdaterFixtures(directory) {
+ for (const [platform, arch] of targets) {
+ for (const name of releaseAssetNames(version, platform, arch)) {
+ writeFileSync(join(directory, name), `verified content for ${name}`);
+ }
+ updaterFixture(directory, platform, arch);
+ }
+}
afterEach(() => {
for (const directory of directories.splice(0)) rmSync(directory, { recursive: true, force: true });
@@ -30,6 +56,12 @@ function fixture(platform = 'darwin', arch = 'arm64') {
writeFileSync(path, content);
return { path, bytes: content.length, sha256: createHash('sha256').update(content).digest('hex') };
});
+ updaterFixture(directory, platform, arch);
+ for (const artifact of artifacts) {
+ const bytes = readFileSync(artifact.path);
+ artifact.bytes = bytes.length;
+ artifact.sha256 = createHash('sha256').update(bytes).digest('hex');
+ }
return { directory, assetsDir, manifest: { platform, arch, artifacts } };
}
@@ -88,6 +120,7 @@ describe('Desktop release assets', () => {
for (const [platform, arch] of [['darwin', 'x64'], ['win32', 'x64']]) {
for (const name of releaseAssetNames(version, platform, arch)) writeFileSync(join(data.directory, name), name);
}
+ for (const [platform, arch] of targets) updaterFixture(data.directory, platform, arch);
for (const [platform, arch] of [['darwin', 'arm64'], ['darwin', 'x64'], ['win32', 'x64']]) {
const name = remotionReleaseAssetName(version, platform, arch);
writeFileSync(join(data.directory, name), name);
@@ -122,6 +155,12 @@ describe('Desktop release assets', () => {
expect(notes).toContain('[SHA-256 Checksums]');
expect(notes).toContain('<summary>Automatic Update Assets</summary>');
expect(notes).not.toMatch(/[\u3400-\u9fff]/u);
+ const published = readdirSync(data.directory).map(name => ({ name, digest: `sha256:${createHash('sha256').update(readFileSync(join(data.directory, name))).digest('hex')}` }));
+ expect(() => verifyPublishedPayloads({ directory: data.directory, assets: published })).not.toThrow();
+ const installer = published.find(asset => asset.name.endsWith('.exe'));
+ installer.digest = 'sha256:changed';
+ expect(() => verifyPublishedPayloads({ directory: data.directory, assets: published })).toThrow('Published payload differs');
+ expect(() => verifyPublishedPayloads({ directory: data.directory, assets: published.slice(1) })).toThrow('asset list differs');
writeFileSync(join(data.directory, 'builder-debug.yml'), 'private diagnostic');
expect(() => finalizeReleaseAssets({
directory: data.directory,
@@ -155,6 +194,7 @@ describe('Desktop release assets', () => {
writeFileSync(join(data.directory, name), name);
}
}
+ for (const [platform, arch] of targets) updaterFixture(data.directory, platform, arch);
for (const [platform, arch] of [
['darwin', 'arm64'],
['darwin', 'x64'],
@@ -181,3 +221,40 @@ describe('Desktop release assets', () => {
rmSync(notesPath);
});
});
+
+describe('Updater metadata after notarization', () => {
+ it('refreshes stapled DMG checksums and sizes while retaining the update payload identity', () => {
+ const { directory } = fixture();
+ completeUpdaterFixtures(directory);
+ const before = parseYaml(readFileSync(join(directory, 'latest-mac.yml'), 'utf8'));
+ const dmgName = releaseAssetNames(version, 'darwin', 'arm64')[0];
+ writeFileSync(join(directory, dmgName), 'signed DMG with its stapled ticket');
+ refreshUpdaterMetadata({ directory, version });
+ const after = parseYaml(readFileSync(join(directory, 'latest-mac.yml'), 'utf8'));
+ const dmg = after.files.find(file => file.url === dmgName);
+ const bytes = readFileSync(join(directory, dmgName));
+ expect(dmg.size).toBe(bytes.length);
+ expect(dmg.sha512).toBe(createHash('sha512').update(bytes).digest('base64'));
+ expect(after.path).toBe(before.path);
+ expect(after.sha512).toBe(before.sha512);
+ expect(after.files.find(file => file.url === before.path)).toEqual(before.files.find(file => file.url === before.path));
+ const windows = parseYaml(readFileSync(join(directory, 'latest.yml'), 'utf8'));
+ expect(windows.files[0].size).toBe(readFileSync(join(directory, windows.path)).length);
+ });
+
+ it.each(['payload', 'primary-checksum', 'architecture', 'unsafe-url'])('rejects inconsistent %s before modifying any metadata', problem => {
+ const { directory } = fixture();
+ completeUpdaterFixtures(directory);
+ const path = join(directory, 'latest-x64-mac.yml');
+ const metadata = parseYaml(readFileSync(path, 'utf8'));
+ if (problem === 'payload') writeFileSync(join(directory, metadata.path), 'changed ZIP');
+ if (problem === 'primary-checksum') metadata.sha512 = 'incorrect';
+ if (problem === 'architecture') metadata.path = `OpenCreator-${version}-mac-arm64.zip`;
+ if (problem === 'unsafe-url') metadata.files[0].url = '../unverified.dmg';
+ writeFileSync(path, JSON.stringify(metadata));
+ const before = targets.map(([platform, arch]) => readFileSync(join(directory, releaseAssetNames(version, platform, arch).find(name => name.endsWith('.yml'))), 'utf8'));
+ expect(() => refreshUpdaterMetadata({ directory, version })).toThrow();
+ const after = targets.map(([platform, arch]) => readFileSync(join(directory, releaseAssetNames(version, platform, arch).find(name => name.endsWith('.yml'))), 'utf8'));
+ expect(after).toEqual(before);
+ });
+});
diff --git a/apps/desktop/test/release-build-input.test.mjs b/apps/desktop/test/release-build-input.test.mjs
index 1f66f8ea..edc54d61 100644
--- a/apps/desktop/test/release-build-input.test.mjs
+++ b/apps/desktop/test/release-build-input.test.mjs
@@ -8,7 +8,8 @@ import {
changesAreReleaseOnly,
digestBuildEntries,
isReleaseOnlyPath,
- parseTreeEntries
+ parseTreeEntries,
+ resolvePromotionTarget
} from '../scripts/release-build-input.mjs';
const appEntry = {
@@ -25,6 +26,36 @@ const releaseEntry = {
};
describe('release build input identity', () => {
+ it('promotes an existing tag only when the workflow changes are release-only', () => {
+ const cwd = mkdtempSync(join(tmpdir(), 'opencreator-promotion-'));
+ const git = (...args) => execFileSync('git', ['-c', 'user.name=Release Test', '-c', '[email protected]', ...args], { cwd, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] }).trim();
+ const commit = message => {
+ git('add', '.');
+ git('commit', '-m', message);
+ };
+ try {
+ git('init', '-q');
+ mkdirSync(join(cwd, 'apps/desktop'), { recursive: true });
+ writeFileSync(join(cwd, 'apps/desktop/package.json'), JSON.stringify({ version: '3.0.0' }));
+ commit('Prepare release');
+ git('tag', '-a', 'v3.0.0', '-m', 'OpenCreator v3.0.0');
+ const sha = git('rev-parse', 'HEAD');
+ mkdirSync(join(cwd, '.github/workflows'), { recursive: true });
+ writeFileSync(join(cwd, '.github/workflows/desktop-release.yml'), 'name: Release');
+ commit('Correct release infrastructure');
+ expect(resolvePromotionTarget('v3.0.0', cwd)).toEqual({ tag: 'v3.0.0', sha });
+ expect(() => resolvePromotionTarget('', cwd)).toThrow('tag is required');
+ expect(() => resolvePromotionTarget('v3.1.0', cwd)).toThrow('does not match');
+ expect(() => resolvePromotionTarget('../unsafe', cwd)).toThrow('must use');
+ writeFileSync(join(cwd, 'product.txt'), 'changed application inputs');
+ commit('Change product inputs');
+ expect(() => resolvePromotionTarget('v3.0.0', cwd)).toThrow('identical application build inputs');
+ git('tag', '-d', 'v3.0.0');
+ expect(() => resolvePromotionTarget('v3.0.0', cwd)).toThrow();
+ } finally {
+ rmSync(cwd, { recursive: true, force: true });
+ }
+ });
it('classifies only explicit release infrastructure as release-only', () => {
expect(isReleaseOnlyPath(releaseEntry.path)).toBe(true);
expect(isReleaseOnlyPath('apps/desktop/release-notes/v3.2.2.md')).toBe(true);
diff --git a/apps/desktop/test/release-workflow.test.mjs b/apps/desktop/test/release-workflow.test.mjs
index 3d489548..e6295d4b 100644
--- a/apps/desktop/test/release-workflow.test.mjs
+++ b/apps/desktop/test/release-workflow.test.mjs
@@ -113,7 +113,7 @@ describe('Desktop release workflow', () => {
expect(releaseWorkflow).toContain("if: github.event_name == 'workflow_dispatch'");
expect(releaseWorkflow).toContain('name: 查找可复用的完整候选构建');
expect(releaseWorkflow).toContain('release-build-input.mjs digest');
- expect(releaseWorkflow).toContain('repos/$GH_REPO/compare/$candidate_sha...$GITHUB_SHA');
+ expect(releaseWorkflow).toContain('repos/$GH_REPO/compare/$candidate_sha...$RELEASE_SHA');
expect(releaseWorkflow).toContain('comparison_status');
expect(releaseWorkflow).toContain('CANDIDATE_BUILD_INPUT_DIGEST');
expect(releaseWorkflow).toContain('candidate.schemaVersion === 2');
@@ -127,6 +127,20 @@ describe('Desktop release workflow', () => {
expect(releaseWorkflow).not.toContain("startsWith(github.ref, 'refs/tags/') || inputs.target == 'all'");
});
+ it('republishes an existing tag only from master with matching inputs and successful CI', () => {
+ expect(releaseWorkflow).toContain(' - publish');
+ expect(releaseWorkflow).toContain('release_tag:');
+ expect(releaseWorkflow).toContain('promotion-target "$RELEASE_TAG"');
+ expect(releaseWorkflow).toContain('"$GITHUB_REF" != refs/heads/master');
+ expect(releaseWorkflow).toContain("inputs.target != 'publish'");
+ expect(releaseWorkflow).toContain('TAG: ${{ needs.verify.outputs.release-tag }}');
+ expect(releaseWorkflow).toContain('RELEASE_SHA: ${{ needs.verify.outputs.release-sha }}');
+ expect(releaseWorkflow).toContain('"$GITHUB_SHA" "$RELEASE_SHA"');
+ expect(releaseWorkflow).toContain('pnpm install --filter @opencreator/daemon --frozen-lockfile --ignore-scripts');
+ expect(releaseWorkflow).not.toContain('git tag -f');
+ expect(releaseWorkflow).not.toContain('git push --force');
+ });
+
it('keeps build diagnostics separate from validated public release assets', () => {
expect(releaseWorkflow).toContain(
'opencreator-desktop-build-manifest-${{ matrix.platform }}-${{ matrix.arch }}.json'
diff --git a/docs/operations/opencreator-desktop-release-runbook.md b/docs/operations/opencreator-desktop-release-runbook.md
index 3b113f22..f8d8ea57 100644
--- a/docs/operations/opencreator-desktop-release-runbook.md
+++ b/docs/operations/opencreator-desktop-release-runbook.md
@@ -51,6 +51,16 @@ Desktop 使用 `resources/icon.png` 作为各平台统一的应用图标源。ma
6. 候选全绿后才创建并推送 `v<version>` Git tag。标签版本必须与 `apps/desktop/package.json` 完全一致。通常 tag 指向候选 commit;候选后只有发布基础设施变化且应用构建输入 SHA-256 不变时,可以复用原候选。
7. tag 工作流不再重复构建、签名、公证或 E2E;它按应用构建输入 SHA-256 查找成功的 `target=all` 候选,并确认候选 commit 是 tag commit 的祖先。任何 App、Runtime、依赖或打包输入变化都会产生不同指纹并要求新候选。随后工作流复核 run 与候选身份凭据,下载已验证附件,校验附件白名单并发布 GitHub Release。
+发布阶段会按最终候选文件重新计算更新元数据和总校验清单。DMG 写入公证票据后大小和 SHA-512 会改变,不能沿用 Electron Builder 在公证前写入的 DMG 字段;ZIP/EXE 的更新校验必须与原候选完全一致。候选安装包、ZIP、blockmap、Runtime 和组件归档保持原始字节。
+
+如果发布后仅需修复元数据,可在发布基础设施修复通过 master push CI 后运行:
+
+```bash
+gh workflow run desktop-release.yml --ref master -f target=publish -f release_tag=v3.2.7
+```
+
+该入口要求现有 tag 是 master 的祖先,tag 与当前提交的应用构建指纹完全一致,并且两个提交的 CI 均成功。它仍须校验完整候选的来源,逐一确认已发布的程序附件 SHA-256 与候选一致,最终只替换三个 latest YAML 与总校验清单;不会修改 tag 或重新构建、替换安装包。
+
CI 变更分类始终以最近一次成功的 `master` push CI 为基线,而不是只比较直接父提交。这样,失败的产品提交后即使只修复 workflow,也必须重新执行完整 CI,不会被 release-only 快速路径掩盖。
如果该基线对象已不在远端历史中,或不再是当前提交的祖先,分类器回退为完整 CI,不阻断分类步骤,也不将未知变更按纯发布改动处理。
@@ -122,14 +132,15 @@ repo: OpenCreator
生产运行时不依赖 `OPENCREATOR_UPDATE_URL`。测试通过注入 fake updater 隔离,不允许把开发覆盖写入正式包。
-GitHub Release 发布 21 个附件,另外 2 个源码归档由 GitHub 自动生成:
+GitHub Release 发布 24 个附件,另外 2 个源码归档由 GitHub 自动生成:
1. macOS arm64:`OpenCreator-<version>-mac-arm64.dmg`、对应 ZIP、ZIP blockmap 和 `latest-mac.yml`。
2. macOS x64:`OpenCreator-<version>-mac-x64.dmg`、对应 ZIP、ZIP blockmap 和 `latest-x64-mac.yml`。
3. Windows x64:`OpenCreator-<version>-win-x64.exe` 和 `latest.yml`。
4. KrillinAI Server:macOS arm64、macOS x64、Windows x64、Linux x64 和 Linux arm64 共 5 个独立程序包。
5. KrillinAI CLI:macOS arm64、macOS x64、Windows x64、Linux x64 和 Linux arm64 共 5 个独立程序包。
-6. 一份 `SHA256SUMS.txt`,覆盖以上 20 个文件。
+6. macOS arm64、macOS x64 和 Windows x64 三个独立 Remotion 组件归档。
+7. 一份 `SHA256SUMS.txt`,覆盖以上 23 个文件。
安装包、更新文件的文件名、版本和 SHA512 保持 Electron Builder 原始输出,不在构建后重命名。macOS 更新使用 ZIP,其 DMG blockmap 不进入发布附件;Windows 当前关闭差分包,不生成独立 blockmap。