@vincentbanana/banana-gui 0.1.0 → 0.2.0

package/README.md

@@ -22,13 +22,38 @@ banana-gui --provider deepseek --model deepseek-chat
 
 ## 特性
 
-- 左侧会话列表：新建 / 切换 / 删除，切换即续上下文
-- 流式回复、工具调用实时状态（自绘图标：文件、终端、搜索、编辑…）
-- 危险操作弹出确认框，附变更预览（写文件前给 diff）
+- **和 CLI 同一套内核**：agent 循环、工具、权限、斜杠命令全部来自 `@vincentbanana/bananacli`，两边行为完全一致
+- 左侧会话列表：新建 / 切换 / 重命名 / 导出（Markdown、JSON）/ 删除
+- 输入 `/` 调出命令面板（`/help` 看全部），输入 `@` 补全项目文件
+- 流式回复、工具调用实时状态，点工具行可展开完整输出
+- 危险操作弹窗确认，写文件前给 diff
 - 一键撤销上一轮文件改动
+- 右侧项目文件面板：浏览目录、预览文件、一键插入引用
 - 粘贴或拖拽图片，随消息一起发送
-- 模型、权限、工作区、系统提示词在设置面板里改，改完立刻生效
-- 深浅色跟随系统，纯黑白，无渐变无彩色
+- 模型、权限、API Key、工作区、系统提示词在设置里改，改完立刻生效
+- 权限设置写清了每种模式的含义和风险，新手也不会懵
+- 三态主题：跟随系统 / 浅色 / 深色，纯黑白无渐变
+- 没配 API Key 也能打开界面，照着引导填完即可用
+
+## 桌面版
+
+仓库里有 Electron 主进程，可以打包成独立应用：
+
+```bash
+npm install          # 装 electron 与 electron-builder
+npm run desktop      # 本地直接跑桌面版
+npm run dist:win     # 出 Windows 安装包（也支持 dist:mac / dist:linux）
+```
+
+npm 安装的 `banana-gui` 仍是浏览器版，零原生依赖，任何装了 Node 20+ 的系统都能跑。
+
+## 配置
+
+首次启动会提示配置向导。GUI 与 CLI 共用 `~/.banana/config.json`：
+
+- 也可以直接在界面的设置面板里填 API Key、切换模型和权限
+- 环境变量优先级更高，例如 `DEEPSEEK_API_KEY`
+- API Key 只写在你自己的机器上，不会进代码仓库
 
 ## 安全
 

package/bin/banana-gui.mjs

@@ -2,29 +2,50 @@
 // Banana GUI 启动器：复用 CLI 包的 agent 内核，用本包自带的界面资源。
 // 安装：npm install -g @vincentbanana/banana-gui
 // 启动：banana-gui（首次会进配置向导）
-import { fileURLToPath } from 'node:url';
-import { dirname, join } from 'node:path';
+import { createRequire } from 'node:module';
 import { spawn } from 'node:child_process';
 
-const here = dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+
+function resolveCli() {
+  // 依赖可能被 npm 提升到上层 node_modules，用 require 解析更稳；
+  // 注意只能解析包根（子路径受 exports 限制）
+  try {
+    return require.resolve('@vincentbanana/bananacli');
+  } catch {
+    return null;
+  }
+}
+
 const args = process.argv.slice(2);
 const passthrough = ['--port', '--cwd', '--provider', '--model', '--base-url', '--api-key', '--setup'];
 
-const cliArgs = ['--ui', '--no-open'];
-let forwarding = false;
-for (const arg of args) {
-  if (arg === '--help' || arg === '-h' || arg === '--version' || arg === '-v') {
-    console.log('banana-gui — Banana 的图形界面');
-    console.log('');
-    console.log('用法: banana-gui [选项]');
-    console.log('  --port <端口>    指定端口（默认随机）');
-    console.log('  --cwd <目录>     指定工作区');
-    console.log('  --provider <名>  指定 provider');
-    console.log('  --model <名>     指定模型');
-    console.log('  --open           启动后打开浏览器（默认已开启）');
-    console.log('  --help           显示帮助');
+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);
   }
+  console.log('banana-gui — Banana 的图形界面');
+  console.log('');
+  console.log('用法: banana-gui [选项]');
+  console.log('  --port <端口>    指定端口（默认随机）');
+  console.log('  --cwd <目录>     指定工作区');
+  console.log('  --provider <名>  指定 provider');
+  console.log('  --model <名>     指定模型');
+  console.log('  --open           启动后打开浏览器（默认已开启）');
+  console.log('  --help           显示帮助');
+  process.exit(0);
+}
+
+const entry = resolveCli();
+if (!entry) {
+  console.error('找不到依赖 @vincentbanana/bananacli，请重新安装：npm install -g @vincentbanana/banana-gui');
+  process.exit(1);
+}
+
+const cliArgs = ['--ui'];
+let forwarding = false;
+for (const arg of args) {
   if (arg === '--open') {
     forwarding = false;
     continue;
@@ -33,7 +54,6 @@ for (const arg of args) {
   cliArgs.push(arg);
 }
 
-const entry = join(here, '..', 'node_modules', '@vincentbanana', 'bananacli', 'dist', 'index.js');
 const child = spawn(process.execPath, [entry, ...cliArgs], { stdio: 'inherit' });
 child.on('exit', (code) => process.exit(code ?? 0));
 for (const signal of ['SIGINT', 'SIGTERM']) {

package/desktop/main.cjs

@@ -0,0 +1,113 @@
+// Banana 桌面版主进程：拉起本地 GUI 服务，再用窗口加载它。
+// 界面资源仍来自本包 ui/，agent 内核来自 @vincentbanana/bananacli。
+const { app, BrowserWindow, Menu, shell, dialog } = require('electron');
+const { spawn } = require('node:child_process');
+const { createRequire } = require('node:module');
+
+const require_ = createRequire(__filename);
+let child = null;
+let win = null;
+
+function startServer() {
+  const entry = require_.resolve('@vincentbanana/bananacli');
+  // 端口交给 CLI 随机分配，避免多开时互相抢占
+  child = spawn(process.execPath, [entry, '--ui', '--no-open'], {
+    stdio: ['ignore', 'pipe', 'pipe'],
+    env: process.env,
+  });
+  return new Promise((resolve, reject) => {
+    let buffer = '';
+    const onData = (chunk) => {
+      buffer += chunk.toString('utf8');
+      const match = buffer.match(/http:\/\/127\.0\.0\.1:\d+\/t\/[a-f0-9]+\//);
+      if (match) {
+        child.stdout.off('data', onData);
+        resolve(match[0]);
+      }
+    };
+    child.stdout.on('data', onData);
+    child.stderr.on('data', (chunk) => process.stderr.write(`[banana] ${chunk}`));
+    child.on('error', reject);
+    child.on('exit', (code) => {
+      if (!win) return;
+      dialog.showErrorBox('Banana 已退出', `本地服务意外结束（退出码 ${code}）。`);
+      app.quit();
+    });
+    setTimeout(() => reject(new Error('启动超时：本地服务没有在 30 秒内就绪')), 30_000);
+  });
+}
+
+async function createWindow() {
+  const url = await startServer();
+  win = new BrowserWindow({
+    width: 1180,
+    height: 820,
+    minWidth: 720,
+    minHeight: 520,
+    backgroundColor: '#ffffff',
+    title: 'Banana',
+    autoHideMenuBar: true,
+    webPreferences: { contextIsolation: true, nodeIntegration: false, sandbox: true },
+  });
+  await win.loadURL(url);
+  win.on('closed', () => {
+    win = null;
+  });
+  // 外部链接交给系统浏览器，窗口只负责本地界面
+  win.webContents.setWindowOpenHandler(({ url: target }) => {
+    shell.openExternal(target);
+    return { action: 'deny' };
+  });
+}
+
+const menuTemplate = [
+  ...(process.platform === 'darwin' ? [{ role: 'appMenu' }] : []),
+  {
+    label: '文件',
+    submenu: [
+      {
+        label: '新建对话',
+        accelerator: 'CmdOrCtrl+N',
+        click: () => win?.webContents.executeJavaScript("document.getElementById('newChat')?.click()"),
+      },
+      { type: 'separator' },
+      process.platform === 'darwin' ? { role: 'close' } : { role: 'quit', label: '退出' },
+    ],
+  },
+  { role: 'editMenu', label: '编辑' },
+  {
+    label: '视图',
+    submenu: [
+      {
+        label: '项目文件',
+        accelerator: 'CmdOrCtrl+Shift+F',
+        click: () => win?.webContents.executeJavaScript("document.getElementById('filesBtn')?.click()"),
+      },
+      { type: 'separator' },
+      { role: 'reload', label: '重新加载' },
+      { role: 'toggleDevTools', label: '开发者工具' },
+      { role: 'togglefullscreen', label: '全屏' },
+    ],
+  },
+  { role: 'windowMenu', label: '窗口' },
+];
+
+app.whenReady().then(() => {
+  Menu.setApplicationMenu(Menu.buildFromTemplate(menuTemplate));
+  createWindow().catch((error) => {
+    dialog.showErrorBox('Banana 启动失败', String(error?.message ?? error));
+    app.quit();
+  });
+  app.on('activate', () => {
+    if (BrowserWindow.getAllWindows().length === 0) createWindow();
+  });
+});
+
+app.on('window-all-closed', () => {
+  if (process.platform !== 'darwin') app.quit();
+});
+
+app.on('before-quit', () => {
+  child?.kill();
+  child = null;
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vincentbanana/banana-gui",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Banana 的图形界面：本地服务 + 浏览器。黑白主题，自绘图标，无第三方 UI 依赖",
   "type": "module",
   "engines": {
@@ -12,14 +12,52 @@
   "files": [
     "bin",
     "ui",
+    "desktop",
     "README.md"
   ],
   "scripts": {
     "sync": "node ../scripts/sync-gui.mjs",
-    "test": "node test/gui-package.test.mjs"
+    "test": "node test/gui-package.test.mjs",
+    "desktop": "electron desktop/main.cjs",
+    "pack": "electron-builder --dir",
+    "dist": "electron-builder",
+    "dist:win": "electron-builder --win",
+    "dist:mac": "electron-builder --mac",
+    "dist:linux": "electron-builder --linux"
+  },
+  "build": {
+    "appId": "dev.banana.gui",
+    "productName": "Banana",
+    "files": [
+      "desktop/**/*",
+      "ui/**/*",
+      "bin/**/*",
+      "package.json"
+    ],
+    "mac": {
+      "category": "public.app-category.developer-tools",
+      "target": [
+        "dmg"
+      ]
+    },
+    "win": {
+      "target": [
+        "nsis"
+      ]
+    },
+    "linux": {
+      "target": [
+        "AppImage"
+      ],
+      "category": "Development"
+    }
+  },
+  "devDependencies": {
+    "electron": "^33.0.0",
+    "electron-builder": "^25.0.0"
   },
   "dependencies": {
-    "@vincentbanana/bananacli": "^0.2.0"
+    "@vincentbanana/bananacli": "^0.3.0"
   },
   "keywords": [
     "ai",
@@ -33,4 +71,4 @@
   "publishConfig": {
     "access": "public"
   }
-}
+}