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.

feat(desktop): simplify app branding and version reporting

Leggettcc01ca72fec4
diff --git a/.github/workflows/desktop-release.yml b/.github/workflows/desktop-release.yml
index 6e657c1e..7ff4cc1f 100644
--- a/.github/workflows/desktop-release.yml
+++ b/.github/workflows/desktop-release.yml
@@ -123,11 +123,6 @@ jobs:
exit 1
fi
- uses: actions/checkout@v4
- - name: 选择支持自适应图标的 Xcode
- if: matrix.platform == 'darwin'
- uses: maxim-lobanov/setup-xcode@v1
- with:
- xcode-version: latest-stable
- uses: pnpm/action-setup@v4
- uses: actions/setup-node@v4
with:
diff --git a/apps/desktop/electron-builder.yml b/apps/desktop/electron-builder.yml
index 7be9a9d5..d83186a2 100644
--- a/apps/desktop/electron-builder.yml
+++ b/apps/desktop/electron-builder.yml
@@ -68,7 +68,6 @@ afterSign: ./scripts/notarize-after-sign.mjs
mac:
category: public.app-category.developer-tools
extendInfo:
- CFBundleIconName: OpenCreator
CFBundleDevelopmentRegion: zh_CN
CFBundleLocalizations:
- zh_CN
diff --git a/apps/desktop/resources/OpenCreator.icon/Assets/mark.svg b/apps/desktop/resources/OpenCreator.icon/Assets/mark.svg
deleted file mode 100644
index c31142bf..00000000
--- a/apps/desktop/resources/OpenCreator.icon/Assets/mark.svg
+++ /dev/null
@@ -1,4 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="0 0 460 460">
- <polygon points="308,125 292,126 278,135 270,150 272,169 278,178 289,186 296,188 319,186 329,190 337,200 339,213 331,228 217,342 209,360 208,384 214,401 228,419 399,250 405,238 404,217 392,202 381,198 352,199 337,188 331,175 333,151 330,141 319,129" fill="#111113"/>
- <polygon points="230,39 59,208 53,220 54,241 59,250 72,259 96,259 115,246 125,246 137,255 139,270 128,287 125,307 129,319 139,329 150,333 162,333 175,328 261,242 267,231 268,218 264,207 258,199 244,191 227,191 219,195 171,240 155,238 145,225 147,211 234,124 246,106 251,85 249,69 242,53" fill="#111113"/>
-</svg>
diff --git a/apps/desktop/resources/OpenCreator.icon/icon.json b/apps/desktop/resources/OpenCreator.icon/icon.json
deleted file mode 100644
index 1f7c7efa..00000000
--- a/apps/desktop/resources/OpenCreator.icon/icon.json
+++ /dev/null
@@ -1,25 +0,0 @@
-{
- "fill-specializations": [
- { "value": { "solid": "srgb:1.00000,1.00000,1.00000,1.00000" } },
- { "appearance": "dark", "value": { "solid": "srgb:0.06667,0.06667,0.07451,1.00000" } }
- ],
- "groups": [
- {
- "layers": [
- {
- "name": "OpenCreator",
- "image-name": "mark.svg",
- "glass": false,
- "fill-specializations": [
- { "value": { "solid": "srgb:0.06667,0.06667,0.07451,1.00000" } },
- { "appearance": "dark", "value": { "solid": "srgb:1.00000,1.00000,1.00000,1.00000" } }
- ]
- }
- ],
- "shadow": { "kind": "neutral", "opacity": 0 },
- "specular": false,
- "translucency": { "enabled": false, "value": 0 }
- }
- ],
- "supported-platforms": { "squares": ["macOS"] }
-}
diff --git a/apps/desktop/resources/icon.png b/apps/desktop/resources/icon.png
index 9f8a63a3..cb9d58d7 100644
Binary files a/apps/desktop/resources/icon.png and b/apps/desktop/resources/icon.png differ
diff --git a/apps/desktop/scripts/mac-app-icon.mjs b/apps/desktop/scripts/mac-app-icon.mjs
deleted file mode 100644
index e4b8ea3e..00000000
--- a/apps/desktop/scripts/mac-app-icon.mjs
+++ /dev/null
@@ -1,87 +0,0 @@
-import { execFileSync } from 'node:child_process';
-import { copyFileSync, existsSync, mkdirSync, mkdtempSync, rmSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-
-export function assertMacAppIconRenditions(entries) {
- for (const appearance of ['NSAppearanceNameAqua', 'NSAppearanceNameDarkAqua']) {
- const stack = entries.find(entry => (
- entry.AssetType === 'IconImageStack'
- && entry.Name === 'OpenCreator'
- && entry.Appearance === appearance
- ));
- const group = entries.find(entry => (
- entry.AssetType === 'IconGroup'
- && entry.Name === 'OpenCreator/Group'
- && entry.Appearance === appearance
- ));
- if (stack === undefined || group?.Layers?.length !== 1) {
- throw new Error(`macOS app icon catalog is missing the ${appearance} rendition.`);
- }
- if (appearance === 'NSAppearanceNameDarkAqua') {
- const color = entries.find(entry => (
- entry.AssetType === 'Color'
- && entry.Name === group.Layers[0].LayerGradientColorName
- ));
- if (color?.['Color components']?.some(component => component !== 1)
- || color?.['Color components']?.length !== 4) {
- throw new Error('macOS dark app icon must use an opaque white brand mark.');
- }
- }
- }
-}
-
-export function verifyMacAppIconCatalog(path, options = {}) {
- const run = options.execFileSync ?? execFileSync;
- const entries = JSON.parse(run('xcrun', ['assetutil', '--info', path], {
- encoding: 'utf8', timeout: 30_000
- }));
- assertMacAppIconRenditions(entries);
-}
-
-export function prepareMacAppIcon(context, options = {}) {
- if (context.electronPlatformName !== 'darwin') return;
-
- const run = options.execFileSync ?? execFileSync;
- const version = run('xcrun', [
- 'actool', '--version', '--output-format', 'human-readable-text'
- ], { encoding: 'utf8', timeout: 30_000 });
- const majorVersion = Number(version.match(/short-bundle-version:\s*(\d+)/)?.[1]);
- if (!Number.isInteger(majorVersion) || majorVersion < 26) {
- throw new Error('macOS adaptive app icons require Xcode 26 or newer (actool >= 26).');
- }
-
- const iconName = 'OpenCreator';
- const source = join(context.packager.projectDir, 'resources', `${iconName}.icon`);
- const resources = join(
- context.appOutDir,
- `${context.packager.appInfo.productFilename}.app`,
- 'Contents',
- 'Resources'
- );
- const output = mkdtempSync(join(tmpdir(), 'opencreator-app-icon-'));
- try {
- run('xcrun', [
- 'actool', source,
- '--compile', output,
- '--output-format', 'human-readable-text',
- '--output-partial-info-plist', join(output, 'icon-info.plist'),
- '--app-icon', iconName,
- '--include-all-app-icons',
- '--enable-on-demand-resources', 'NO',
- '--target-device', 'mac',
- '--minimum-deployment-target', '12.0',
- '--platform', 'macosx'
- ], { encoding: 'utf8', timeout: 120_000 });
- const catalog = join(output, 'Assets.car');
- if (!existsSync(catalog)) {
- throw new Error('actool did not generate the macOS adaptive icon catalog.');
- }
- verifyMacAppIconCatalog(catalog, { execFileSync: run });
- mkdirSync(resources, { recursive: true });
- // Keep icon.icns as the fallback on macOS versions without adaptive icons.
- copyFileSync(catalog, join(resources, 'Assets.car'));
- } finally {
- rmSync(output, { recursive: true, force: true });
- }
-}
diff --git a/apps/desktop/scripts/sign-creator-runtime-after-pack.mjs b/apps/desktop/scripts/sign-creator-runtime-after-pack.mjs
index 7ea0c3a4..c22ee568 100644
--- a/apps/desktop/scripts/sign-creator-runtime-after-pack.mjs
+++ b/apps/desktop/scripts/sign-creator-runtime-after-pack.mjs
@@ -14,7 +14,6 @@ import { spawnSync } from 'node:child_process';
import { verifyCreatorRuntime } from './creator-runtime-contract.mjs';
import { verifyStickmanRuntime } from './stickman-runtime-contract.mjs';
import { findDeveloperIdIdentity } from './mac-signing.mjs';
-import { prepareMacAppIcon } from './mac-app-icon.mjs';
const machOMagicValues = new Set([
'feedface',
@@ -28,7 +27,6 @@ const machOMagicValues = new Set([
]);
export async function afterPack(context) {
- prepareMacAppIcon(context);
if (process.env.OPENCREATOR_SIGN_CREATOR_RUNTIME !== '1') return;
await signDaemonRuntimeBundle(context);
await signCreatorRuntimeBundle(context);
diff --git a/apps/desktop/scripts/verify-package.mjs b/apps/desktop/scripts/verify-package.mjs
index b6c16a59..db8613e5 100644
--- a/apps/desktop/scripts/verify-package.mjs
+++ b/apps/desktop/scripts/verify-package.mjs
@@ -30,7 +30,6 @@ import { spawnSync } from 'node:child_process';
import { fileURLToPath } from 'node:url';
import { verifyCreatorRuntime } from './creator-runtime-contract.mjs';
import { verifyCodexRuntime } from './codex-runtime-contract.mjs';
-import { verifyMacAppIconCatalog } from './mac-app-icon.mjs';
import {
hashDirectory as hashStickmanDirectory,
hashFile as hashStickmanFile,
@@ -216,25 +215,6 @@ function assertBrandingContents() {
if (process.platform === 'darwin') {
assertExists(join(resourcesDir, 'icon.icns'));
- assertExists(join(resourcesDir, 'Assets.car'));
- verifyMacAppIconCatalog(join(resourcesDir, 'Assets.car'));
- const iconName = spawnSync('plutil', [
- '-extract', 'CFBundleIconName', 'raw', '-o', '-',
- join(packageRoot, 'Contents', 'Info.plist')
- ], { encoding: 'utf8', timeout: 30_000 });
- if (iconName.status !== 0 || iconName.stdout.trim() !== 'OpenCreator') {
- throw new Error('Packaged macOS app does not reference the adaptive icon catalog.');
- }
- assertSameFile(
- 'macOS adaptive icon definition',
- join(desktopResourcesDir, 'OpenCreator.icon', 'icon.json'),
- join(sourceResourcesDir, 'OpenCreator.icon', 'icon.json')
- );
- assertSameFile(
- 'macOS adaptive icon brand mark',
- join(desktopResourcesDir, 'OpenCreator.icon', 'Assets', 'mark.svg'),
- join(sourceResourcesDir, 'OpenCreator.icon', 'Assets', 'mark.svg')
- );
}
}
diff --git a/apps/desktop/src/main/main.ts b/apps/desktop/src/main/main.ts
index 71b0dd63..189a00e2 100644
--- a/apps/desktop/src/main/main.ts
+++ b/apps/desktop/src/main/main.ts
@@ -335,6 +335,7 @@ function registerIpcHandlers(input: {
quit(): void;
reloadWorkspace(): Promise<void>;
}): void {
+ handle(desktopIpc.readAppVersion, input.development, () => app.getVersion());
handle(desktopIpc.readConnection, input.development, () =>
input.bootstrap.rendererConnection());
handle(desktopIpc.readBootstrap, input.development, () =>
diff --git a/apps/desktop/src/preload/index.ts b/apps/desktop/src/preload/index.ts
index 767384a4..e441f2a9 100644
--- a/apps/desktop/src/preload/index.ts
+++ b/apps/desktop/src/preload/index.ts
@@ -21,6 +21,7 @@ const api: DesktopApi = {
: {
integratedTitleBar: false
},
+ readAppVersion: () => ipcRenderer.invoke(desktopIpc.readAppVersion),
readConnectionConfig: () => ipcRenderer.invoke(desktopIpc.readConnection),
subscribeConnectionConfig(listener) {
return subscribe(desktopIpc.connectionChanged, listener);
diff --git a/apps/desktop/src/shared/ipc.ts b/apps/desktop/src/shared/ipc.ts
index be32e41b..4e77e29b 100644
--- a/apps/desktop/src/shared/ipc.ts
+++ b/apps/desktop/src/shared/ipc.ts
@@ -1,4 +1,5 @@
export const desktopIpc = {
+ readAppVersion: 'opencreator:app:version',
readConnection: 'opencreator:connection:read',
connectionChanged: 'opencreator:connection:changed',
readBootstrap: 'opencreator:bootstrap:read',
diff --git a/apps/desktop/src/shared/types.ts b/apps/desktop/src/shared/types.ts
index b44b2887..5b057307 100644
--- a/apps/desktop/src/shared/types.ts
+++ b/apps/desktop/src/shared/types.ts
@@ -102,6 +102,7 @@ export type DesktopHostNotification = {
export type DesktopApi = {
kind: 'desktop';
windowChrome?: DesktopWindowChrome;
+ readAppVersion(): Promise<string>;
readConnectionConfig(): Promise<DesktopConnectionConfig | null>;
subscribeConnectionConfig(
listener: (connection: DesktopConnectionConfig | null) => void
diff --git a/apps/desktop/test/branding-assets-2026-07-27.test.ts b/apps/desktop/test/branding-assets-2026-07-27.test.ts
index b6fabf53..e10e4db7 100644
--- a/apps/desktop/test/branding-assets-2026-07-27.test.ts
+++ b/apps/desktop/test/branding-assets-2026-07-27.test.ts
@@ -31,6 +31,9 @@ describe('品牌资源', () => {
expect(trayManager).toContain('height: size');
expect(existsSync(resolve(desktopRoot, 'resources/tray.png'))).toBe(true);
expect(existsSync(resolve(desktopRoot, 'resources/icon.png'))).toBe(true);
+
+ const icon = readPngMetadata(resolve(desktopRoot, 'resources/icon.png'));
+ expect(icon).toEqual({ width: 1024, height: 1024, colorType: 6 });
});
it('Desktop 图标、托盘和 Web 使用同一枚双链品牌图形', () => {
@@ -104,3 +107,14 @@ describe('品牌资源', () => {
function hash(path: string): string {
return createHash('sha256').update(readFileSync(path)).digest('hex');
}
+
+function readPngMetadata(path: string): { width: number; height: number; colorType: number } {
+ const bytes = readFileSync(path);
+ expect(bytes.subarray(1, 4).toString('ascii')).toBe('PNG');
+ expect(bytes.subarray(12, 16).toString('ascii')).toBe('IHDR');
+ return {
+ width: bytes.readUInt32BE(16),
+ height: bytes.readUInt32BE(20),
+ colorType: bytes.readUInt8(25)
+ };
+}
diff --git a/apps/desktop/test/mac-app-icon.test.mjs b/apps/desktop/test/mac-app-icon.test.mjs
deleted file mode 100644
index 0f416954..00000000
--- a/apps/desktop/test/mac-app-icon.test.mjs
+++ /dev/null
@@ -1,120 +0,0 @@
-import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { afterEach, describe, expect, it, vi } from 'vitest';
-import {
- assertMacAppIconRenditions,
- prepareMacAppIcon
-} from '../scripts/mac-app-icon.mjs';
-
-const temporaryDirectories = [];
-afterEach(() => {
- for (const directory of temporaryDirectories.splice(0)) {
- rmSync(directory, { recursive: true, force: true });
- }
-});
-
-describe('macOS adaptive app icons', () => {
- it('keeps the existing brand geometry and defines a white mark for dark mode', () => {
- const icon = JSON.parse(readFileSync(
- new URL('../resources/OpenCreator.icon/icon.json', import.meta.url), 'utf8'
- ));
- const mark = readFileSync(
- new URL('../resources/OpenCreator.icon/Assets/mark.svg', import.meta.url), 'utf8'
- );
- const legacy = readFileSync(new URL('../resources/icon.svg', import.meta.url), 'utf8');
- expect(mark.match(/<polygon[^>]+>/g)).toEqual(legacy.match(/<polygon[^>]+>/g));
- expect(mark).not.toContain('<rect');
- expect(icon.groups[0].layers[0]['fill-specializations'].find(
- fill => fill.appearance === 'dark'
- ).value.solid).toBe('srgb:1.00000,1.00000,1.00000,1.00000');
- const config = readFileSync(new URL('../electron-builder.yml', import.meta.url), 'utf8');
- expect(config).toContain('CFBundleIconName: OpenCreator');
- expect(config).toContain('icon: resources/icon.png');
- });
-
- it('does not invoke macOS tools for Windows or Linux', () => {
- const run = vi.fn();
- for (const platform of ['win32', 'linux']) {
- prepareMacAppIcon({ electronPlatformName: platform }, { execFileSync: run });
- }
- expect(run).not.toHaveBeenCalled();
- });
-
- it.each(['16.4', 'unknown'])('blocks packaging with unsupported actool %s', version => {
- expect(() => prepareMacAppIcon(
- { electronPlatformName: 'darwin' },
- { execFileSync: () => `short-bundle-version: ${version}` }
- )).toThrow(/Xcode 26 or newer/);
- });
-
- it('compiles and validates the catalog before copying it, without replacing the legacy icon', () => {
- const context = createContext();
- mkdirSync(resources(context), { recursive: true });
- writeFileSync(join(resources(context), 'icon.icns'), 'legacy-icon');
- let output;
- const run = vi.fn((_command, args) => {
- if (args.includes('--version')) return 'short-bundle-version: 26.1';
- if (args[0] === 'assetutil') return JSON.stringify(catalogEntries());
- output = args[args.indexOf('--compile') + 1];
- writeFileSync(join(output, 'Assets.car'), 'adaptive-icon-catalog');
- return '';
- });
- prepareMacAppIcon(context, { execFileSync: run });
- expect(readFileSync(join(resources(context), 'Assets.car'), 'utf8')).toBe('adaptive-icon-catalog');
- expect(readFileSync(join(resources(context), 'icon.icns'), 'utf8')).toBe('legacy-icon');
- expect(run.mock.calls[1][1]).toContain(join(context.packager.projectDir, 'resources', 'OpenCreator.icon'));
- expect(run.mock.calls[1][1]).toContain('12.0');
- expect(existsSync(output)).toBe(false);
- });
-
- it('fails instead of silently packaging an absent catalog and cleans up temporary output', () => {
- const context = createContext();
- let output;
- const run = vi.fn((_command, args) => {
- if (args.includes('--version')) return 'short-bundle-version: 26.1';
- output = args[args.indexOf('--compile') + 1];
- return '';
- });
- expect(() => prepareMacAppIcon(context, { execFileSync: run })).toThrow(/did not generate/);
- expect(existsSync(output)).toBe(false);
- expect(existsSync(join(resources(context), 'Assets.car'))).toBe(false);
- });
-
- it('rejects missing dark mode and a dark brand mark in the compiled catalog', () => {
- const entries = catalogEntries();
- expect(() => assertMacAppIconRenditions(entries)).not.toThrow();
- expect(() => assertMacAppIconRenditions(entries.filter(
- entry => entry.Appearance !== 'NSAppearanceNameDarkAqua'
- ))).toThrow(/missing/);
- entries[0]['Color components'] = [0.067, 0.067, 0.075, 1];
- expect(() => assertMacAppIconRenditions(entries)).toThrow(/opaque white/);
- });
-});
-
-function createContext() {
- const appOutDir = mkdtempSync(join(tmpdir(), 'opencreator-icon-test-'));
- temporaryDirectories.push(appOutDir);
- return {
- electronPlatformName: 'darwin',
- appOutDir,
- packager: { projectDir: appOutDir, appInfo: { productFilename: 'OpenCreator' } }
- };
-}
-
-function resources(context) {
- return join(context.appOutDir, 'OpenCreator.app', 'Contents', 'Resources');
-}
-
-function catalogEntries() {
- return [
- { AssetType: 'Color', Name: 'white', 'Color components': [1, 1, 1, 1] },
- ...['NSAppearanceNameAqua', 'NSAppearanceNameDarkAqua'].flatMap(appearance => [
- { AssetType: 'IconImageStack', Name: 'OpenCreator', Appearance: appearance },
- {
- AssetType: 'IconGroup', Name: 'OpenCreator/Group', Appearance: appearance,
- Layers: [{ LayerGradientColorName: 'white' }]
- }
- ])
- ];
-}
diff --git a/apps/web/src/app/App.test.tsx b/apps/web/src/app/App.test.tsx
index 13c5c774..43c8e078 100644
--- a/apps/web/src/app/App.test.tsx
+++ b/apps/web/src/app/App.test.tsx
@@ -7458,6 +7458,19 @@ describe('App', () => {
expect(window.location.hash).toBe('#/new');
});
+ it('shows the application version reported by the host bridge', async () => {
+ const user = userEvent.setup();
+ const hostBridge = createHostBridge();
+ hostBridge.readAppVersion = vi.fn(async () => '3.2.1');
+
+ render(<App fileService={createFileService()} hostBridge={hostBridge} />);
+ await user.click(await screen.findByRole('button', { name: '设置' }));
+ await user.click(screen.getByRole('button', { name: '关于 OpenCreator' }));
+
+ expect(await screen.findByText('3.2.1')).toBeInTheDocument();
+ expect(hostBridge.readAppVersion).toHaveBeenCalledOnce();
+ });
+
it('uses a solid conversation background without a dynamic background setting', async () => {
const user = userEvent.setup();
diff --git a/apps/web/src/app/AppController.tsx b/apps/web/src/app/AppController.tsx
index 50498022..3068c762 100644
--- a/apps/web/src/app/AppController.tsx
+++ b/apps/web/src/app/AppController.tsx
@@ -303,6 +303,7 @@ export function AppController(props: AppControllerProps) {
const defaultFileService = useMemo(() => createUnavailableFileService(), []);
const fileService = props.fileService ?? defaultFileService;
const hostBridge = props.hostBridge ?? browserBridge;
+ const [appVersion, setAppVersion] = useState<string>();
const integratedTitleBar = hostBridge.windowChrome;
const appShellStyle = integratedTitleBar === undefined
? undefined
@@ -971,6 +972,28 @@ export function AppController(props: AppControllerProps) {
setUnreadTaskIds(notificationService.getUnreadIds());
}, [notificationService]);
+ useEffect(() => {
+ let active = true;
+ const readAppVersion = hostBridge.readAppVersion;
+ if (readAppVersion === undefined) {
+ setAppVersion(undefined);
+ return () => {
+ active = false;
+ };
+ }
+ void readAppVersion()
+ .then(version => {
+ const normalized = version.trim();
+ if (active) setAppVersion(normalized.length > 0 ? normalized : undefined);
+ })
+ .catch(() => {
+ if (active) setAppVersion(undefined);
+ });
+ return () => {
+ active = false;
+ };
+ }, [hostBridge]);
+
useEffect(() => {
let active = true;
if (
@@ -2047,7 +2070,7 @@ export function AppController(props: AppControllerProps) {
const currentRunCanceling = selectedActiveRun === undefined
? selectedPendingRunStart?.cancelRequested === true
: getRunCancelState(runRegistry, selectedActiveRun.id) === 'requested';
- const runtimeStatus = mapRuntimeStatus(connectionState);
+ const runtimeStatus = mapRuntimeStatus(connectionState, appVersion);
const slashCommands = useMemo(
() => buildComposerSlashCommands(codexSkills, codexMcp),
[codexMcp, codexSkills]
@@ -5676,10 +5699,14 @@ function clampPaneWidth(value: number, min: number, max: number): number {
return Math.round(Math.min(Math.max(value, min), max));
}
-function mapRuntimeStatus(connectionState: ConnectionState): RuntimeStatus {
+function mapRuntimeStatus(
+ connectionState: ConnectionState,
+ appVersion: string | undefined
+): RuntimeStatus {
if (connectionState.status !== 'connected') {
return {
connected: false,
+ ...(appVersion === undefined ? {} : { appVersion }),
runtimeVersion: '0.1.0',
lastCheckedAt: '2026-07-07 10:00'
};
@@ -5687,6 +5714,7 @@ function mapRuntimeStatus(connectionState: ConnectionState): RuntimeStatus {
return {
connected: true,
+ ...(appVersion === undefined ? {} : { appVersion }),
runtimeVersion: '0.1.0',
codexVersion: connectionState.codexStatus.codexVersion,
codexPath: connectionState.codexStatus.codexBin,
diff --git a/apps/web/src/features/settings/OpenCreatorSettingsView.test.tsx b/apps/web/src/features/settings/OpenCreatorSettingsView.test.tsx
index 81300bfd..32cf9d65 100644
--- a/apps/web/src/features/settings/OpenCreatorSettingsView.test.tsx
+++ b/apps/web/src/features/settings/OpenCreatorSettingsView.test.tsx
@@ -8,6 +8,7 @@ import { OpenCreatorSettingsView } from './OpenCreatorSettingsView.js';
const runtimeStatus = {
connected: true,
+ appVersion: '3.2.1',
runtimeVersion: '0.9.1',
codexVersion: 'codex-cli 1.2.3',
codexPath: '/opt/homebrew/bin/codex',
@@ -299,6 +300,7 @@ describe('OpenCreatorSettingsView', () => {
fireEvent.click(screen.getByRole('button', { name: '关于 OpenCreator' }));
expect(screen.getByText('OpenCreator 版本')).toBeInTheDocument();
+ expect(screen.getByText(runtimeStatus.appVersion)).toBeInTheDocument();
expect(screen.getByText('Runtime 版本')).toBeInTheDocument();
expect(screen.getByText('数据目录')).toBeInTheDocument();
expect(screen.queryByRole('button', { name: '检查更新' })).not.toBeInTheDocument();
diff --git a/apps/web/src/features/settings/OpenCreatorSettingsView.tsx b/apps/web/src/features/settings/OpenCreatorSettingsView.tsx
index 81ba3c92..46646410 100644
--- a/apps/web/src/features/settings/OpenCreatorSettingsView.tsx
+++ b/apps/web/src/features/settings/OpenCreatorSettingsView.tsx
@@ -35,6 +35,7 @@ import './settings-management.css';
export type RuntimeStatus = {
connected: boolean;
+ appVersion?: string;
runtimeVersion?: string;
codexVersion?: string;
codexPath?: string;
@@ -539,7 +540,10 @@ function AboutSettings(props: { runtimeStatus: RuntimeStatus }) {
<p>{t('settings.about.description')}</p>
</header>
<div className="settings-card">
- <SettingsRow label={t('settings.about.version')} value="0.1.0" />
+ <SettingsRow
+ label={t('settings.about.version')}
+ value={props.runtimeStatus.appVersion ?? t('settings.unknown')}
+ />
<SettingsRow
label={t('settings.about.runtimeVersion')}
value={props.runtimeStatus.runtimeVersion ?? t('settings.unknown')}
diff --git a/apps/web/src/host/bridge.ts b/apps/web/src/host/bridge.ts
index 5c1d67ab..a6a602e6 100644
--- a/apps/web/src/host/bridge.ts
+++ b/apps/web/src/host/bridge.ts
@@ -29,6 +29,7 @@ export type HostWindowChrome = {
export type HostBridge = {
kind: 'browser' | 'desktop';
windowChrome?: HostWindowChrome;
+ readAppVersion?(): Promise<string>;
readConnectionConfig(): Promise<ConnectionConfig | null>;
openExternal(url: string): Promise<void>;
revealPath(path: string): Promise<HostBridgeResult>;
diff --git a/apps/web/src/host/desktop-bridge.ts b/apps/web/src/host/desktop-bridge.ts
index 8454a940..38fdc465 100644
--- a/apps/web/src/host/desktop-bridge.ts
+++ b/apps/web/src/host/desktop-bridge.ts
@@ -12,6 +12,7 @@ type DesktopApi = {
titleBarHeight?: number;
trafficLightInset?: number;
};
+ readAppVersion(): Promise<string>;
readConnectionConfig(): Promise<ConnectionConfig | null>;
subscribeConnectionConfig(
listener: (connection: ConnectionConfig | null) => void
@@ -73,6 +74,7 @@ export function readDesktopHostBridge(): DesktopHostBridge | undefined {
return {
kind: 'desktop',
...(windowChrome === undefined ? {} : { windowChrome }),
+ readAppVersion: () => api.readAppVersion(),
readConnectionConfig: () => api.readConnectionConfig(),
subscribeConnectionConfig: listener => api.subscribeConnectionConfig(listener),
restartRuntime: () => api.restartRuntime(),
diff --git a/docs/operations/opencreator-desktop-release-runbook.md b/docs/operations/opencreator-desktop-release-runbook.md
index c801576f..412a2e5e 100644
--- a/docs/operations/opencreator-desktop-release-runbook.md
+++ b/docs/operations/opencreator-desktop-release-runbook.md
@@ -30,7 +30,7 @@ pnpm desktop:package
1. Node.js 22。
2. pnpm 9.15.0。
-3. macOS 构建机安装完整的 Xcode 26 或更新版本,并通过 `xcode-select` 选中对应 Developer 目录;仅安装 Command Line Tools 不足以编译自适应应用图标。
+3. macOS 签名与公证环境提供 `codesign`、`notarytool` 和 `stapler`;普通本机未签名打包不依赖完整 Xcode。
4. Windows 构建机允许执行 PowerShell 和 NSIS 打包工具。
5. 仓库全量测试、类型检查和构建通过。
6. 打包脚本会删除目标架构旧目录,并要求构建后只找到一个 fresh package root。
@@ -39,7 +39,7 @@ pnpm desktop:package
9. OSV Scanner 2.3.8 扫描发布源码无未解释漏洞。
10. `.github/workflows/desktop-release.yml` 通过 actionlint。
-macOS 打包时,`resources/OpenCreator.icon` 在 `afterPack` 阶段编译为 App 内的 `Assets.car`,由 `CFBundleIconName` 引用;系统暗色图标使用深色背景和白色品牌图形。原有 `icon.icns` 保留用于旧版 macOS。包校验会检查明暗两种 rendition 和暗色品牌图形的白色填充,资源缺失时阻止交付。
+Desktop 使用 `resources/icon.png` 作为各平台统一的应用图标源。Electron Builder 在 macOS 包内生成 `icon.icns`,包校验同时检查正式 PNG 资源与生成后的 macOS 图标存在。
## 3. 版本与标签