程序员阿江(Relakkes) 386a41e606 feat(desktop): enable Electron migration path
Introduce the Electron desktop shell alongside the existing React renderer and local Bun server boundary. The migration keeps the DesktopHost contract explicit across Tauri, Electron, and browser runtimes while adding Electron main/preload services for dialogs, shell, notifications, updates, tray/window lifecycle, terminal, preview WebContentsView, app mode, and release/package validation.

The commit also carries the latest local main desktop command updates, including agent slash entries and hidden-by-default markdown thinking details, so the packaged Electron build matches the current main UX surface.

Constraint: React renderer, local Bun server, REST/WebSocket, and sidecar boundaries must remain reusable during the migration
Constraint: macOS dev packages are ad-hoc signed and cannot prove Developer ID notarization or Gatekeeper release launch
Rejected: Browser-only smoke validation | it cannot exercise native dialogs, keychain prompts, notification behavior, or packaged app startup
Confidence: medium
Scope-risk: broad
Directive: Do not remove Tauri host support until signed Electron release artifacts pass native OS smoke on macOS, Windows, and Linux
Tested: bun run check:desktop
Tested: cd desktop && bun run check:electron
Tested: CSC_IDENTITY_AUTO_DISCOVERY=false bun run electron📦dir
Tested: bun run test:package-smoke --platform macos --package-kind dir --artifacts-dir desktop/build-artifacts/electron
Tested: Computer Use read packaged Electron app window at desktop/build-artifacts/electron/mac-arm64/Claude Code Haha.app
Not-tested: Developer ID signed/notarized Gatekeeper launch
Not-tested: Real OS notification click-to-session action
Not-tested: Windows and Linux packaged app smoke on real hosts
2026-06-01 22:43:16 +08:00

181 lines
5.6 KiB
TypeScript

import type { DesktopUpdateDownloadEvent } from '../../src/lib/desktopHost/types'
import { existsSync } from 'node:fs'
export type ElectronUpdateInfo = {
version: string
body?: string | null
releaseNotes?: string | Array<{ note?: string | null }> | null
}
export type ElectronUpdateCheckResult = {
updateInfo?: ElectronUpdateInfo
} | null
export type ElectronUpdateCheckOptions = {
proxy?: string
}
export type ElectronUpdaterLike = {
autoDownload: boolean
logger?: unknown
checkForUpdates(): Promise<ElectronUpdateCheckResult>
downloadUpdate(): Promise<unknown>
quitAndInstall(isSilent?: boolean, isForceRunAfter?: boolean): void
on(event: 'download-progress', handler: (progress: { transferred?: number, total?: number }) => void): ElectronUpdaterLike
off(event: 'download-progress', handler: (progress: { transferred?: number, total?: number }) => void): ElectronUpdaterLike
}
export type ElectronUpdateMetadata = {
version: string
body: string | null
}
export type ElectronUpdaterProxyController = {
apply(proxy: string | null): Promise<void>
}
export type ElectronUpdaterRuntimeOptions = {
updateConfigPath?: string
}
export function normalizeUpdateInfo(info: ElectronUpdateInfo | undefined): ElectronUpdateMetadata | null {
if (!info?.version) return null
const releaseNotes = Array.isArray(info.releaseNotes)
? info.releaseNotes.map(note => note.note).filter(Boolean).join('\n\n')
: info.releaseNotes
return {
version: info.version,
body: info.body ?? releaseNotes ?? null,
}
}
function isMissingUpdateMetadataError(error: unknown): boolean {
if (!error) return false
const maybeError = typeof error === 'object'
? error as { code?: unknown, message?: unknown, path?: unknown }
: {}
const code = typeof maybeError.code === 'string' ? maybeError.code : ''
const path = typeof maybeError.path === 'string' ? maybeError.path : ''
const message = typeof maybeError.message === 'string' && maybeError.message
? maybeError.message
: String(error)
const referencesChannelMetadata = /latest(?:-[a-z0-9]+)?(?:-[a-z0-9]+)?\.ya?ml/i.test(message)
if (code === 'ENOENT') {
return path.endsWith('app-update.yml') || message.includes('app-update.yml')
}
if (code === 'ERR_UPDATER_CHANNEL_FILE_NOT_FOUND') {
return referencesChannelMetadata
}
return referencesChannelMetadata && /cannot find|not found|404/i.test(message)
}
export class ElectronUpdaterService {
private readonly updater: ElectronUpdaterLike
private readonly proxyController?: ElectronUpdaterProxyController
private readonly updateConfigPath?: string
private pendingUpdate: ElectronUpdateMetadata | null = null
private downloaded = false
private proxyKey: string | null = null
constructor(
updater: ElectronUpdaterLike,
proxyController?: ElectronUpdaterProxyController,
runtimeOptions: ElectronUpdaterRuntimeOptions = {},
) {
this.updater = updater
this.proxyController = proxyController
this.updateConfigPath = runtimeOptions.updateConfigPath
this.updater.autoDownload = false
this.updater.logger = null
}
private async applyProxy(options?: ElectronUpdateCheckOptions) {
if (!this.proxyController) return
const proxy = options?.proxy?.trim() || null
const nextProxyKey = proxy ? `manual:${proxy}` : 'system'
if (this.proxyKey === nextProxyKey) return
await this.proxyController.apply(proxy)
this.proxyKey = nextProxyKey
}
async checkForUpdates(options?: ElectronUpdateCheckOptions): Promise<ElectronUpdateMetadata | null> {
let result: ElectronUpdateCheckResult
try {
await this.applyProxy(options)
if (this.updateConfigPath && !existsSync(this.updateConfigPath)) {
result = null
} else {
result = await this.updater.checkForUpdates()
}
} catch (error) {
if (!isMissingUpdateMetadataError(error)) throw error
result = null
}
this.pendingUpdate = normalizeUpdateInfo(result?.updateInfo)
this.downloaded = false
return this.pendingUpdate
}
async downloadUpdate(emit: (event: DesktopUpdateDownloadEvent) => void): Promise<void> {
if (!this.pendingUpdate) {
throw new Error('No Electron update is available to download')
}
if (this.downloaded) {
emit({ event: 'Finished' })
return
}
let lastTransferred = 0
let started = false
const onProgress = (progress: { transferred?: number, total?: number }) => {
const transferred = Math.max(0, progress.transferred ?? 0)
if (!started) {
started = true
emit({ event: 'Started', data: { contentLength: progress.total ?? null } })
}
const chunkLength = Math.max(0, transferred - lastTransferred)
lastTransferred = transferred
if (chunkLength > 0) {
emit({ event: 'Progress', data: { chunkLength } })
}
}
this.updater.on('download-progress', onProgress)
try {
await this.updater.downloadUpdate()
if (!started) {
emit({ event: 'Started', data: { contentLength: null } })
}
emit({ event: 'Finished' })
this.downloaded = true
} finally {
this.updater.off('download-progress', onProgress)
}
}
cancelInstall() {
this.pendingUpdate = null
this.downloaded = false
}
stageDownloadedUpdate() {
if (!this.pendingUpdate) {
throw new Error('No Electron update is ready to install')
}
if (!this.downloaded) {
throw new Error('Electron update has not finished downloading')
}
}
hasDownloadedUpdate(): boolean {
return !!this.pendingUpdate && this.downloaded
}
quitAndInstallDownloadedUpdate() {
this.stageDownloadedUpdate()
this.updater.quitAndInstall(false, true)
}
}