@ytchuan/flowlink 1.0.3 → 1.0.5

package/README.md

@@ -19,6 +19,7 @@ app/
 ├── scripts/             # 发布辅助脚本
 │   ├── copy-ui.js       # 发布前复制渲染层产物到包内
 │   ├── manifest-electron.js # 切换 electron 依赖位置（保留兼容）
+│   ├── postinstall.js   # 安装后校验/补装 Electron 二进制（国内镜像）
 │   └── release.js       # 发布脚本（处理 electron 依赖 + 调用 npm publish）
 ├── docs/                # 设计文档与 Agent 说明
 └── package.json         # 依赖与 electron-builder 打包配置
@@ -37,7 +38,11 @@ npm install -g @ytchuan/flowlink
 flowlink
 ```
 
-> 首次安装会下载 Electron（~150MB），包内已配置国内镜像加速下载。
+## 首次安装会下载 Electron（~150MB）。已内置国内镜像（npmmirror），无需额外配置；
+### 如仍下载失败，可手动设置镜像后重装：
+```bash
+npm config set electron_mirror https://npmmirror.com/mirrors/electron/
+```
 
 ## 版本更新
 

package/bin/flowlink.js

@@ -3,22 +3,45 @@
 /**
  * FlowLink CLI 入口
  * npm install -g @ytchuan/flowlink 后，用户直接执行 flowlink 即可启动
+ * 
+ * 用法：
+ *   flowlink              # 后台运行（推荐）
+ *   flowlink --foreground # 前台运行（调试用，终端显示日志）
  */
 const { spawn } = require('child_process')
 const path = require('path')
 
+// 兜底：Electron 二进制缺失时会触发运行时按需下载（@electron/get），
+// 默认源是 GitHub Releases，国内容易失败。未显式配置镜像时默认走国内镜像。
+if (!process.env.ELECTRON_MIRROR && !process.env.npm_config_electron_mirror) {
+  process.env.ELECTRON_MIRROR = 'https://npmmirror.com/mirrors/electron/'
+}
+
 // 定位 electron 可执行文件
 const electronPath = require('electron')
 
 // 应用根目录（bin 的上一级）
 const appDir = path.join(__dirname, '..')
 
-// 启动 Electron
-const child = spawn(electronPath, [appDir], {
-  stdio: 'inherit',
-  env: process.env,
-})
+// 检查是否前台模式（调试用）
+const isForeground = process.argv.includes('--foreground') || process.argv.includes('-f')
 
-child.on('close', (code) => {
-  process.exitCode = code
-})
+if (isForeground) {
+  // 前台模式：继承终端，显示日志，Ctrl+C 退出
+  const child = spawn(electronPath, [appDir], {
+    stdio: 'inherit',
+    env: process.env,
+  })
+  child.on('close', (code) => {
+    process.exitCode = code
+  })
+} else {
+  // 后台模式：分离进程，立即返回终端控制权给用户
+  const child = spawn(electronPath, [appDir], {
+    detached: true,
+    stdio: 'ignore',
+    env: process.env,
+  })
+  child.unref() // 允许父进程退出，不等待子进程
+  console.log('FlowLink 已在后台启动')
+}

package/main.js

@@ -248,6 +248,16 @@ function registerIpcHandlers() {
 // ---- App 生命周期 ----
 app.whenReady().then(() => {
   registerIpcHandlers()
+
+  // macOS: 设置 Dock 图标（非打包模式下默认显示 Electron 图标）
+  if (process.platform === 'darwin' && app.dock) {
+    const { nativeImage } = require('electron')
+    const dockIcon = nativeImage.createFromPath(path.join(__dirname, 'assets', 'logo512.png'))
+    if (!dockIcon.isEmpty()) {
+      app.dock.setIcon(dockIcon)
+    }
+  }
+
   createWindow()
 
   // 调度服务不随软件启动，由主页"启动服务"按钮触发（scheduler:start）

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ytchuan/flowlink",
-    "version": "1.0.3",
+    "version": "1.0.5",
     "description": "FlowLink 桌面客户端 - AI 服务调度与管理",
     "main": "main.js",
     "bin": {
@@ -14,6 +14,7 @@
         "app-ui/dist/",
         "assets/",
         "resources/",
+        "scripts/postinstall.js",
         ".npmrc"
     ],
     "engines": {
@@ -31,6 +32,7 @@
         "build:mac": "npm run build:ui && electron-builder --mac",
         "build:mac:zip": "npm run build:ui && electron-builder --mac zip",
         "prepack": "npm run build:ui && node scripts/copy-ui.js",
+        "postinstall": "node scripts/postinstall.js",
         "release": "node scripts/release.js",
         "test": "echo \"Error: no test specified\" && exit 1"
     },

package/scripts/postinstall.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+/**
+ * 安装兜底脚本（postinstall）
+ *
+ * electron 包自带的 postinstall 负责下载二进制，但在网络异常/跳过脚本等情况下
+ * 可能下载失败，导致用户首次运行 `flowlink` 时触发运行时按需下载（默认走 GitHub，
+ * 国内大概率失败）。此脚本在包安装完成后校验二进制是否完整，缺失则用国内镜像补装。
+ */
+const fs = require('fs')
+const path = require('path')
+const { execFileSync } = require('child_process')
+
+const MIRROR = 'https://npmmirror.com/mirrors/electron/'
+
+try {
+  // 定位全局/本地安装的 electron 包目录
+  const electronDir = path.dirname(require.resolve('electron/package.json'))
+  const pathTxt = path.join(electronDir, 'path.txt')
+
+  // 二进制已完整则跳过（path.txt 内容为 dist 内的相对路径）
+  if (fs.existsSync(pathTxt)) {
+    const relPath = fs.readFileSync(pathTxt, 'utf8').trim()
+    if (fs.existsSync(path.join(electronDir, 'dist', relPath))) {
+      process.exit(0)
+    }
+  }
+
+  // 未显式配置镜像时默认走国内镜像
+  const env = { ...process.env }
+  if (!env.ELECTRON_MIRROR && !env.npm_config_electron_mirror) {
+    env.ELECTRON_MIRROR = MIRROR
+  }
+
+  console.log('[flowlink] Electron 二进制缺失，正在通过镜像补装...')
+  execFileSync(process.execPath, [path.join(electronDir, 'install.js')], {
+    stdio: 'inherit',
+    env,
+    cwd: electronDir,
+  })
+} catch (err) {
+  // 补装失败不阻塞安装流程；首次运行 `flowlink` 时会再次尝试（同样走镜像）
+  console.warn('[flowlink] Electron 二进制补装失败，首次运行时将自动重试:', err.message)
+}