@ytchuan/flowlink 1.0.4 → 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,8 +38,11 @@ npm install -g @ytchuan/flowlink
 flowlink
 ```
 
-> 首次安装会下载 Electron（~150MB），包内已配置国内镜像加速下载。
-> `flowlink` 默认后台运行，不占用终端。如需调试，使用 `flowlink --foreground` 前台运行。
+## 首次安装会下载 Electron（~150MB）。已内置国内镜像（npmmirror），无需额外配置；
+### 如仍下载失败，可手动设置镜像后重装：
+```bash
+npm config set electron_mirror https://npmmirror.com/mirrors/electron/
+```
 
 ## 版本更新
 

package/bin/flowlink.js

@@ -11,6 +11,12 @@
 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')
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ytchuan/flowlink",
-    "version": "1.0.4",
+    "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)
+}