@ytchuan/flowlink 1.0.2 → 1.0.4

package/README.md

@@ -18,7 +18,8 @@ app/
 │   └── updater.js       # 更新检查
 ├── scripts/             # 发布辅助脚本
 │   ├── copy-ui.js       # 发布前复制渲染层产物到包内
-│   └── manifest-electron.js # 发布时切换 electron 依赖位置
+│   ├── manifest-electron.js # 切换 electron 依赖位置（保留兼容）
+│   └── release.js       # 发布脚本（处理 electron 依赖 + 调用 npm publish）
 ├── docs/                # 设计文档与 Agent 说明
 └── package.json         # 依赖与 electron-builder 打包配置
 ```
@@ -31,14 +32,26 @@ app/
 
 ## 用户安装与运行
 
-### 前置注意事项
-
 ```bash
-export ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/
 npm install -g @ytchuan/flowlink
 flowlink
 ```
 
+> 首次安装会下载 Electron（~150MB），包内已配置国内镜像加速下载。
+> `flowlink` 默认后台运行，不占用终端。如需调试，使用 `flowlink --foreground` 前台运行。
+
+## 版本更新
+
+```bash
+npm update -g @ytchuan/flowlink
+```
+
+## 卸载
+
+```bash
+npm uninstall -g @ytchuan/flowlink
+```
+
 ## 注意事项
 1. macOS 打包可能需要在「系统设置 > 隐私与安全性」中允许相关权限。
 2. 本地调度服务端口默认为 `51173`，如果`51173`被占用时自动回退到 `51172`、`51171`。

package/bin/flowlink.js

@@ -3,6 +3,10 @@
 /**
  * FlowLink CLI 入口
  * npm install -g @ytchuan/flowlink 后，用户直接执行 flowlink 即可启动
+ * 
+ * 用法：
+ *   flowlink              # 后台运行（推荐）
+ *   flowlink --foreground # 前台运行（调试用，终端显示日志）
  */
 const { spawn } = require('child_process')
 const path = require('path')
@@ -13,12 +17,25 @@ 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.2",
+    "version": "1.0.4",
     "description": "FlowLink 桌面客户端 - AI 服务调度与管理",
     "main": "main.js",
     "bin": {
@@ -13,7 +13,8 @@
         "services/",
         "app-ui/dist/",
         "assets/",
-        "resources/"
+        "resources/",
+        ".npmrc"
     ],
     "engines": {
         "node": ">=22"
@@ -30,10 +31,8 @@
         "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",
-        "prepublishOnly": "node scripts/manifest-electron.js rewrite",
-        "postpack": "node scripts/manifest-electron.js restore",
-        "test": "echo \"Error: no test specified\" && exit 1",
-        "release:publish": "npm version patch && npm publish"
+        "release": "node scripts/release.js",
+        "test": "echo \"Error: no test specified\" && exit 1"
     },
     "author": "ytchuan",
     "license": "ISC",