@vincentbanana/banana-gui 0.2.0 → 0.3.0

package/README.md

@@ -6,9 +6,18 @@ Banana 的图形界面：本地起一个服务，用浏览器打开。黑白主
 
 ```bash
 npm install -g @vincentbanana/banana-gui
-banana-gui
 ```
 
+装完有两种启动方式，**同一份安装，不用额外装东西**：
+
+```bash
+banana-gui              # 浏览器版：启动后自动开浏览器，最轻
+banana-gui --desktop    # 桌面版：直接开独立窗口
+banana-gui-desktop      # 同上，等价的独立命令
+```
+
+electron 是可选依赖（`optionalDependencies`），npm 安装时会自动带上；万一某个平台装不上，`banana-gui` 仍然照常工作，只是 `--desktop` 会提示你用浏览器版。
+
 首次启动会进配置向导（选 provider、贴 API key、选权限、测连接），配置与 CLI 共用 `~/.banana/config.json`。
 
 ## 用法
@@ -35,17 +44,27 @@ banana-gui --provider deepseek --model deepseek-chat
 - 三态主题：跟随系统 / 浅色 / 深色，纯黑白无渐变
 - 没配 API Key 也能打开界面，照着引导填完即可用
 
-## 桌面版
+## 两种方式对比
+
+| | 启动命令 | 需要什么 | 说明 |
+| --- | --- | --- | --- |
+| 浏览器版 | `banana-gui` | 任何装了 Node 20+ 的系统 | 启动后自动打开浏览器，几十 MB |
+| 桌面版 | `banana-gui --desktop` | 同一个 npm 包 | 独立窗口，约 200MB（内含 electron） |
+
+两者用的是同一套 agent 内核和同一份界面资源，功能完全一致，只是外壳不同。
+
+## 打包成安装包（可选）
 
-仓库里有 Electron 主进程，可以打包成独立应用：
+想出 `.exe` / `.dmg` / `AppImage` 的话，在源码仓库里构建：
 
 ```bash
-npm install          # 装 electron 与 electron-builder
-npm run desktop      # 本地直接跑桌面版
-npm run dist:win     # 出 Windows 安装包（也支持 dist:mac / dist:linux）
+git clone <这个仓库>
+cd banana-gui
+npm install          # 装 electron-builder
+npm run dist:win     # 也支持 dist:mac / dist:linux
 ```
 
-npm 安装的 `banana-gui` 仍是浏览器版，零原生依赖，任何装了 Node 20+ 的系统都能跑。
+产物在 `gui/release/`。
 
 ## 配置
 

package/bin/banana-gui-desktop.mjs

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+// 桌面版启动器：npm 安装后直接开一个独立窗口，不用浏览器。
+//
+//   npm install -g @vincentbanana/banana-gui
+//   banana-gui-desktop        开窗口
+//   banana-gui-desktop --port 8080
+//
+// electron 是 optionalDependencies：装得上就能用，装不上会提示改用浏览器版
+// （banana-gui）。本文件不直接依赖 electron 的 API，只负责把它拉起来。
+import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const here = dirname(fileURLToPath(import.meta.url));
+const require_ = createRequire(import.meta.url);
+const args = process.argv.slice(2);
+
+if (args.includes('--help') || args.includes('-h')) {
+  console.log('banana-gui-desktop — Banana 的桌面版（独立窗口）');
+  console.log('');
+  console.log('用法: banana-gui-desktop [选项]');
+  console.log('  --port <端口>    指定端口（默认随机）');
+  console.log('  --cwd <目录>     指定工作区');
+  console.log('  --provider <名>  指定 provider');
+  console.log('  --model <名>     指定模型');
+  console.log('  --help           显示帮助');
+  console.log('');
+  console.log('提示：日常使用建议用 banana-gui（浏览器版，更轻）。');
+  process.exit(0);
+}
+
+/** electron 装在依赖里；require('electron') 返回的是可执行文件路径。 */
+function electronBinary() {
+  for (const specifier of ['electron', '@vincentbanana/banana-gui/node_modules/electron']) {
+    try {
+      const resolved = require_.resolve(specifier);
+      // electron 主入口导出的是 exe 路径；解析失败时退回到包目录里的 dist
+      const binary = require_(resolved);
+      if (typeof binary === 'string') return binary;
+      return join(dirname(resolved), 'dist', process.platform === 'win32' ? 'electron.exe' : 'electron');
+    } catch {
+      /* 换下一个候选 */
+    }
+  }
+  return null;
+}
+
+const binary = electronBinary();
+if (!binary) {
+  console.error('没找到 electron，桌面版暂时用不了。');
+  console.error('');
+  console.error('可以先继续用浏览器版，功能完全一样：');
+  console.error('  banana-gui');
+  console.error('');
+  console.error('想用桌面版，试着补装一次：');
+  console.error('  npm install -g electron');
+  process.exit(1);
+}
+
+const main = join(here, '..', 'desktop', 'main.cjs');
+const child = spawn(binary, [main, ...args], { stdio: 'inherit' });
+child.on('error', (error) => {
+  console.error('桌面版启动失败：' + error.message);
+  console.error('可以先用浏览器版：banana-gui');
+  process.exit(1);
+});
+child.on('exit', (code) => process.exit(code ?? 0));
+for (const signal of ['SIGINT', 'SIGTERM']) {
+  process.on(signal, () => child.kill(signal));
+}

package/bin/banana-gui.mjs

@@ -4,8 +4,11 @@
 // 启动：banana-gui（首次会进配置向导）
 import { createRequire } from 'node:module';
 import { spawn } from 'node:child_process';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
 
 const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
 
 function resolveCli() {
   // 依赖可能被 npm 提升到上层 node_modules，用 require 解析更稳；
@@ -17,23 +20,43 @@ function resolveCli() {
   }
 }
 
+/** electron 是可选依赖：装上了就能开独立窗口，没装就走浏览器。 */
+function electronBinary() {
+  for (const specifier of ['electron', '@vincentbanana/banana-gui/node_modules/electron']) {
+    try {
+      const resolved = require.resolve(specifier);
+      const binary = require(resolved);
+      if (typeof binary === 'string') return binary;
+    } catch {
+      /* 换下一个候选 */
+    }
+  }
+  return null;
+}
+
 const args = process.argv.slice(2);
 const passthrough = ['--port', '--cwd', '--provider', '--model', '--base-url', '--api-key', '--setup'];
 
-if (args.some((arg) => arg === '--help' || arg === '-h' || args.length === 0 || arg === '--version' || arg === '-v')) {
-  if (args.includes('--version') || args.includes('-v')) {
-    console.log('0.1.1');
-    process.exit(0);
-  }
+if (args.includes('--version') || args.includes('-v')) {
+  console.log(pkg.version);
+  process.exit(0);
+}
+
+if (args.includes('--help') || args.includes('-h')) {
   console.log('banana-gui — Banana 的图形界面');
   console.log('');
   console.log('用法: banana-gui [选项]');
+  console.log('  --desktop        用独立窗口打开（需要已安装 electron）');
   console.log('  --port <端口>    指定端口（默认随机）');
   console.log('  --cwd <目录>     指定工作区');
   console.log('  --provider <名>  指定 provider');
   console.log('  --model <名>     指定模型');
   console.log('  --open           启动后打开浏览器（默认已开启）');
+  console.log('  --version        显示版本');
   console.log('  --help           显示帮助');
+  console.log('');
+  console.log('提示：默认用浏览器打开。想要独立窗口就加 --desktop，');
+  console.log('      或直接运行 banana-gui-desktop。');
   process.exit(0);
 }
 
@@ -43,7 +66,42 @@ if (!entry) {
   process.exit(1);
 }
 
-const cliArgs = ['--ui'];
+// --desktop：交给 electron 开独立窗口，本进程不参与
+if (args.includes('--desktop')) {
+  const binary = electronBinary();
+  if (!binary) {
+    console.error('没装 electron，用不了独立窗口。补装一次即可：npm install -g electron');
+    console.error('（不装也没关系，直接运行 banana-gui 用浏览器版，功能完全一样）');
+    process.exit(1);
+  }
+  const rest = args.filter((arg) => arg !== '--desktop');
+  const desktop = spawn(binary, [join(dirname(fileURLToPath(import.meta.url)), '..', 'desktop', 'main.cjs'), ...rest], {
+    stdio: 'inherit',
+  });
+  desktop.on('exit', (code) => process.exit(code ?? 0));
+  for (const signal of ['SIGINT', 'SIGTERM']) process.on(signal, () => desktop.kill(signal));
+} else {
+  startBrowser(entry);
+}
+
+function startBrowser(entry) {
+  const cliArgs = ['--ui'];
+  let forwarding = false;
+  for (const arg of args) {
+    if (arg === '--open') {
+      forwarding = false;
+      continue;
+    }
+    forwarding = passthrough.includes(arg) || forwarding;
+    cliArgs.push(arg);
+  }
+
+  const child = spawn(process.execPath, [entry, ...cliArgs], { stdio: 'inherit' });
+  child.on('exit', (code) => process.exit(code ?? 0));
+  for (const signal of ['SIGINT', 'SIGTERM']) {
+    process.on(signal, () => child.kill(signal));
+  }
+}
 let forwarding = false;
 for (const arg of args) {
   if (arg === '--open') {

package/desktop/main.cjs

@@ -8,12 +8,35 @@ const require_ = createRequire(__filename);
 let child = null;
 let win = null;
 
-function startServer() {
-  const entry = require_.resolve('@vincentbanana/bananacli');
+// electron 自带的 node 运行 CLI 内核；ELECTRON_RUN_AS_NODE 让 electron.exe 当纯 node 用，
+// 否则会再开一个 Electron 窗口，而不是执行脚本。
+const PASSTHROUGH = ['--port', '--cwd', '--provider', '--model', '--base-url', '--api-key'];
+
+function serverArgs() {
+  const argv = process.argv.slice(2).filter((arg) => arg.startsWith('--'));
+  const extra = [];
+  for (const arg of argv) {
+    if (PASSTHROUGH.includes(arg)) {
+      extra.push(arg);
+      const value = process.argv[process.argv.indexOf(arg) + 1];
+      if (value && !value.startsWith('--')) extra.push(value);
+    }
+  }
   // 端口交给 CLI 随机分配，避免多开时互相抢占
-  child = spawn(process.execPath, [entry, '--ui', '--no-open'], {
+  return ['--ui', '--no-open', ...extra];
+}
+
+function startServer() {
+  let entry;
+  try {
+    // 依赖可能被提升到上层 node_modules；只能解析包根（子路径受 exports 限制）
+    entry = require_.resolve('@vincentbanana/bananacli');
+  } catch (error) {
+    throw new Error('找不到依赖 @vincentbanana/bananacli，请重新安装：npm install -g @vincentbanana/banana-gui');
+  }
+  child = spawn(process.execPath, [entry, ...serverArgs()], {
     stdio: ['ignore', 'pipe', 'pipe'],
-    env: process.env,
+    env: { ...process.env, ELECTRON_RUN_AS_NODE: '1' },
   });
   return new Promise((resolve, reject) => {
     let buffer = '';

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@vincentbanana/banana-gui",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Banana 的图形界面：本地服务 + 浏览器。黑白主题，自绘图标，无第三方 UI 依赖",
   "type": "module",
   "engines": {
     "node": ">=20.0.0"
   },
   "bin": {
-    "banana-gui": "bin/banana-gui.mjs"
+    "banana-gui": "bin/banana-gui.mjs",
+    "banana-gui-desktop": "bin/banana-gui-desktop.mjs"
   },
   "files": [
     "bin",
@@ -15,6 +16,16 @@
     "desktop",
     "README.md"
   ],
+  "keywords": [
+    "ai",
+    "agent",
+    "gui",
+    "web-ui",
+    "llm",
+    "terminal",
+    "desktop",
+    "electron"
+  ],
   "scripts": {
     "sync": "node ../scripts/sync-gui.mjs",
     "test": "node test/gui-package.test.mjs",
@@ -34,6 +45,7 @@
       "bin/**/*",
       "package.json"
     ],
+    "npmRebuild": false,
     "mac": {
       "category": "public.app-category.developer-tools",
       "target": [
@@ -52,21 +64,15 @@
       "category": "Development"
     }
   },
+  "optionalDependencies": {
+    "electron": "^33.0.0"
+  },
   "devDependencies": {
-    "electron": "^33.0.0",
     "electron-builder": "^25.0.0"
   },
   "dependencies": {
     "@vincentbanana/bananacli": "^0.3.0"
   },
-  "keywords": [
-    "ai",
-    "agent",
-    "gui",
-    "web-ui",
-    "llm",
-    "terminal"
-  ],
   "license": "MIT",
   "publishConfig": {
     "access": "public"