fix(electron): decouple icon generation from build

Author: wynxing

README.en.md

@@ -126,6 +126,8 @@ neocode web
 
 Tagged release builds already embed Web UI assets (`web/dist`) into the `neocode` binary, so running `neocode web` does not require Node.js or npm on the target machine. If you run from source with `go run ./cmd/neocode web`, NeoCode will still automatically try to build the frontend when `web/dist` is missing.
 
+Electron desktop releases use the checked-in `web/build/icon.png`, `web/build/icon.ico`, and `web/build/icon.icns` assets. Only run `npm run generate:icons` from `web/` after replacing the source `web/build/icon.png`; the command uses PowerShell/.NET image APIs on Windows, `sips` on macOS, and requires ImageMagick's `magick` command on Linux.
+
 ### 4. Quick Web / Feishu Entry
 
 ```bash

README.md

@@ -133,6 +133,8 @@ neocode web
 
 标签发布版已经将 Web UI 的 `web/dist` 内嵌进 `neocode` 二进制，执行 `neocode web` 时不再要求用户机器安装 Node.js 或 npm。如果你在源码仓库里运行 `go run ./cmd/neocode web`，当本地缺少 `web/dist` 时仍会自动尝试构建前端。
 
+Electron 桌面端发布图标使用已提交的 `web/build/icon.png`、`web/build/icon.ico` 和 `web/build/icon.icns`。只有替换 `web/build/icon.png` 源图时，才需要在 `web/` 目录手动运行 `npm run generate:icons` 重新生成 Windows 与 macOS 图标；该命令在 Windows 使用 PowerShell/.NET 图像能力，在 macOS 使用 `sips`，在 Linux 需要 ImageMagick 的 `magick` 命令。
+
 ### 4. Web / 飞书快速入口
 
 ```bash

web/package.json

@@ -10,7 +10,7 @@
     "dev": "vite",
     "dev:electron": "node scripts/clean-electron.js && node scripts/build-gateway.js && vite --mode electron",
     "build": "tsc -b && vite build",
-    "build:electron": "node scripts/clean-electron.js && node scripts/generate-icons.js && vite build --mode electron && node scripts/build-gateway.js && node scripts/verify-electron-preload.js && electron-builder --config electron-builder.config.cjs",
+    "build:electron": "node scripts/clean-electron.js && vite build --mode electron && node scripts/build-gateway.js && node scripts/verify-electron-preload.js && electron-builder --config electron-builder.config.cjs",
     "generate:icons": "node scripts/generate-icons.js",
     "preview": "vite preview",
     "test": "vitest run",

web/scripts/generate-icons.js

@@ -20,10 +20,14 @@ const tempDir = mkdtempSync(join(tmpdir(), 'neocode-icons-'))
 
 try {
 	const resizedPngs = resizeImages(sourceIcon, tempDir, iconSizes)
-	writeFileSync(outputIco, buildIco(resizedPngs))
-	writeFileSync(outputIcns, buildIcns(resizedPngs))
-	console.log(`Generated ${outputIco}`)
-	console.log(`Generated ${outputIcns}`)
+	if (resizedPngs === null) {
+		console.log(`Existing ${outputIco} and ${outputIcns} are up to date.`)
+	} else {
+		writeFileSync(outputIco, buildIco(resizedPngs))
+		writeFileSync(outputIcns, buildIcns(resizedPngs))
+		console.log(`Generated ${outputIco}`)
+		console.log(`Generated ${outputIcns}`)
+	}
 } finally {
 	rmSync(tempDir, { recursive: true, force: true })
 }
@@ -41,7 +45,7 @@ function resizeImages(inputPath, outputDir, sizes) {
 	}
 	if (outputsAreFresh()) {
 		console.warn('No local image resizer found; existing icon.ico and icon.icns are up to date.')
-		process.exit(0)
+		return null
 	}
 	throw new Error('No local image resizer found. Install ImageMagick or run this script on Windows/macOS.')
 }