@vincentbanana/banana-gui 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,39 @@
-# Temporary Holding Version
+# @vincentbanana/banana-gui
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Banana 的图形界面：本地起一个服务，用浏览器打开。黑白主题、只用自绘 SVG 图标、无 emoji、无第三方 UI 依赖。
+
+## 安装
+
+```bash
+npm install -g @vincentbanana/banana-gui
+banana-gui
+```
+
+首次启动会进配置向导（选 provider、贴 API key、选权限、测连接），配置与 CLI 共用 `~/.banana/config.json`。
+
+## 用法
+
+```bash
+banana-gui                      # 随机端口，自动开浏览器
+banana-gui --port 8080          # 指定端口
+banana-gui --cwd D:/project     # 指定工作区
+banana-gui --provider deepseek --model deepseek-chat
+```
+
+## 特性
+
+- 左侧会话列表：新建 / 切换 / 删除，切换即续上下文
+- 流式回复、工具调用实时状态（自绘图标：文件、终端、搜索、编辑…）
+- 危险操作弹出确认框，附变更预览（写文件前给 diff）
+- 一键撤销上一轮文件改动
+- 粘贴或拖拽图片，随消息一起发送
+- 模型、权限、工作区、系统提示词在设置面板里改，改完立刻生效
+- 深浅色跟随系统，纯黑白，无渐变无彩色
+
+## 安全
+
+服务只监听 `127.0.0.1`，所有接口都需要 URL 里的 token；无 token 访问一律 404。URL 等同于登录凭证，不要分享。
+
+## 依赖
+
+运行时依赖只有 `@vincentbanana/bananacli`（agent 内核），界面资源全部在本包里，零第三方前端依赖。

package/bin/banana-gui.mjs

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+// Banana GUI 启动器：复用 CLI 包的 agent 内核，用本包自带的界面资源。
+// 安装：npm install -g @vincentbanana/banana-gui
+// 启动：banana-gui（首次会进配置向导）
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { spawn } from 'node:child_process';
+
+const here = dirname(fileURLToPath(import.meta.url));
+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           显示帮助');
+    process.exit(0);
+  }
+  if (arg === '--open') {
+    forwarding = false;
+    continue;
+  }
+  forwarding = passthrough.includes(arg) || forwarding;
+  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']) {
+  process.on(signal, () => child.kill(signal));
+}

package/package.json

@@ -1,6 +1,36 @@
 {
   "name": "@vincentbanana/banana-gui",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Banana 的图形界面：本地服务 + 浏览器。黑白主题，自绘图标，无第三方 UI 依赖",
+  "type": "module",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "bin": {
+    "banana-gui": "bin/banana-gui.mjs"
+  },
+  "files": [
+    "bin",
+    "ui",
+    "README.md"
+  ],
+  "scripts": {
+    "sync": "node ../scripts/sync-gui.mjs",
+    "test": "node test/gui-package.test.mjs"
+  },
+  "dependencies": {
+    "@vincentbanana/bananacli": "^0.2.0"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "gui",
+    "web-ui",
+    "llm",
+    "terminal"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
 }