@bolloon/bolloon-agent 0.4.14 → 0.4.15

package/scripts/build-web.ts

@@ -1,149 +1,162 @@
-/**
- * Web 构建脚本
- */
-import * as fs from 'fs/promises';
-import * as path from 'path';
-import { execSync } from 'child_process';
-import * as esbuild from 'esbuild';
-
-const ROOT = path.resolve(import.meta.dirname, '..');
-const DIST_WEB = path.join(ROOT, 'dist', 'web');
-
-async function main() {
-  console.log('[build-web] 开始构建...');
-
-  // 重要: 不能 rm -rf 整个 dist/web/, 否则会删掉 build:main 编译出来的
-  // dist/web/server.js. 只清理 web 静态资源, 保留 server.js.
-  for (const f of ['index.html', 'api-config.html', 'style.css', 'client.js', 'mobile.html', 'mobile.css', 'mobile.js', 'components']) {
-    await fs.rm(path.join(DIST_WEB, f), { recursive: true, force: true });
-  }
-  await fs.mkdir(DIST_WEB, { recursive: true });
-  await fs.mkdir(path.join(DIST_WEB, 'components', 'p2p'), { recursive: true });
-
-  // 编译 TypeScript 模块
-  console.log('[build-web] 编译 TypeScript 模块...');
-  const moduleFiles = [
-    'src/web/components/p2p/types.ts',
-    'src/web/components/p2p/p2p-store-memory.ts',
-    'src/web/components/p2p/p2p-identity.ts',
-    'src/web/components/p2p/p2p-connection.ts',
-    'src/web/components/p2p/p2p-messages.ts',
-    'src/web/components/p2p/p2p-manager.ts',
-  ];
-
-  try {
-    execSync(`npx tsc --ignoreConfig --outDir dist/web/components/p2p --declaration false --skipLibCheck --target ES2022 --module ESNext --moduleResolution bundler ${moduleFiles.join(' ')}`, {
-      cwd: ROOT,
-      stdio: 'inherit'
-    });
-  } catch {
-    console.log('[build-web] TypeScript 编译有警告，继续...');
-  }
-
-  // 编译 P2P Modal UI（esbuild）
-  console.log('[build-web] 编译 P2P Modal UI...');
-  await esbuild.build({
-    entryPoints: [path.join(ROOT, 'src/web/components/p2p/index.ts')],
-    outfile: path.join(DIST_WEB, 'components/p2p/index.js'),
-    format: 'esm',
-    target: 'es2022',
-    platform: 'browser',
-    minify: false,
-  });
-
-  // 2026-06-15: 编译 message-renderer.ts (对话显示 UI 模块)
-  //   esbuild 编译 .ts → dist/web/ui/message-renderer.js (ESM, 浏览器侧 <script type="module"> 加载)
-  console.log('[build-web] 编译 message-renderer.ts...');
-  await fs.mkdir(path.join(DIST_WEB, 'ui'), { recursive: true });
-  await esbuild.build({
-    entryPoints: [path.join(ROOT, 'src/web/ui/message-renderer.ts')],
-    outfile: path.join(DIST_WEB, 'ui/message-renderer.js'),
-    format: 'esm',
-    target: 'es2022',
-    platform: 'browser',
-    minify: false,
-  });
-
-  // 2026-06-15: 编译 step-timeline.ts (气泡内 4 状态步骤条)
-  console.log('[build-web] 编译 step-timeline.ts...');
-  await esbuild.build({
-    entryPoints: [path.join(ROOT, 'src/web/ui/step-timeline.ts')],
-    outfile: path.join(DIST_WEB, 'ui/step-timeline.js'),
-    format: 'esm',
-    target: 'es2022',
-    platform: 'browser',
-    minify: false,
-  });
-
-  // 编译主客户端入口 (classic script, 非 module; 由 index.html 以 /client.js 加载)
-  // 2026-07-06: client.ts 加了 import { safeChannelName } from './util/safe-name.js'.
-  //   不开 bundle 的话, esbuild 把 require("./util/safe-name.js") 内联到 IIFE 顶层
-  //   → 浏览器无 require → ReferenceError → init() 没跑 → UI 全空 (channels 不显示).
-  //   开 bundle=true 让 esbuild 把 safe-name 全部 inline 进 client.js (1.8KB, 无影响).
-  console.log('[build-web] 编译 client.ts...');
-  await esbuild.build({
-    entryPoints: [path.join(ROOT, 'src/web/client.ts')],
-    outfile: path.join(DIST_WEB, 'client.js'),
-    format: 'iife',
-    target: 'es2022',
-    platform: 'browser',
-    minify: false,
-    bundle: true,
-  });
-
-  // 2026-08-12: 编译 A2UI 前端渲染器 (a2ui-client.tsx → a2ui-client.js)
-  //   react + @a2ui/react + @a2ui/web_core 全部打包进 bundle (手机端 webview 无 CDN)
-  console.log('[build-web] 编译 a2ui-client.tsx...');
-  await esbuild.build({
-    entryPoints: [path.join(ROOT, 'src/web/a2ui-client.tsx')],
-    outfile: path.join(DIST_WEB, 'a2ui-client.js'),
-    format: 'iife',
-    target: 'es2022',
-    platform: 'browser',
-    minify: false,
-    bundle: true,
-    jsx: 'automatic',
-    loader: { '.tsx': 'tsx' },
-  });
-
-  // 复制静态文件
-  console.log('[build-web] 复制静态文件...');
-  await fs.copyFile(path.join(ROOT, 'src/web/index.html'), path.join(DIST_WEB, 'index.html'));
-  await fs.copyFile(path.join(ROOT, 'src/web/api-config.html'), path.join(DIST_WEB, 'api-config.html'));
-  await fs.copyFile(path.join(ROOT, 'src/web/style.css'), path.join(DIST_WEB, 'style.css'));
-  // 2026-08-12: 手机端 UI (微信风格, Capacitor webview 加载) — 纯静态复制
-  await fs.copyFile(path.join(ROOT, 'src/web/mobile.html'), path.join(DIST_WEB, 'mobile.html'));
-  await fs.copyFile(path.join(ROOT, 'src/web/mobile.css'), path.join(DIST_WEB, 'mobile.css'));
-  await fs.copyFile(path.join(ROOT, 'src/web/mobile.js'), path.join(DIST_WEB, 'mobile.js'));
-  // 复制 PWA manifest (index.html 里有 <link rel="manifest">, 否则浏览器会 404)
-  await fs.copyFile(path.join(ROOT, 'src/web/manifest.json'), path.join(DIST_WEB, 'manifest.json'));
-  // 复制 icons 目录 (manifest.json 里引用了 favicon 等)
-  await fs.cp(path.join(ROOT, 'src/web/icons'), path.join(DIST_WEB, 'icons'), { recursive: true });
-
-  // 复制 system-prompt layer .md 文件到 dist/llm/system-prompt/layers/
-  //   原因: tsc 不复制 .md, src/llm/system-prompt/layers/{core,role,channel,tool}/*.md
-  //   在 dist 里完全不存在, registry.ts 用 __dirname + 'layers' 读它们时 100% ENOENT.
-  //   这里全量复制 25 个 .md, 不过滤 'never' 层 — registry.matchesContext 已做过滤.
-  const srcLayers = path.join(ROOT, 'src/llm/system-prompt/layers');
-  const dstLayers = path.join(ROOT, 'dist/llm/system-prompt/layers');
-  await fs.cp(srcLayers, dstLayers, { recursive: true });
-  console.log('[build-web] system-prompt layers copied →', path.relative(ROOT, dstLayers));
-
-  // 复制 components/ 下的独立 ESM 模块 (非 p2p 那些, 已被 esbuild 单独编译)
-  // 例如 wallet-viem.mjs: 浏览器侧 viem 封装, 被 index.html 引用
-  const extraComponentsDir = path.join(ROOT, 'src/web/components');
-  for (const entry of await fs.readdir(extraComponentsDir)) {
-    if (entry === 'p2p') continue;
-    const src = path.join(extraComponentsDir, entry);
-    const dest = path.join(DIST_WEB, 'components', entry);
-    const stat = await fs.stat(src);
-    if (stat.isFile()) {
-      await fs.mkdir(path.dirname(dest), { recursive: true });
-      await fs.copyFile(src, dest);
-    }
-  }
-
-  console.log('[build-web] 完成!');
-}
-
-main().catch(console.error);
+/**
+ * Web 构建脚本
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { execSync } from 'child_process';
+import * as esbuild from 'esbuild';
+
+const ROOT = path.resolve(import.meta.dirname, '..');
+const DIST_WEB = path.join(ROOT, 'dist', 'web');
+
+async function main() {
+  console.log('[build-web] 开始构建...');
+
+  // 重要: 不能 rm -rf 整个 dist/web/, 否则会删掉 build:main 编译出来的
+  // dist/web/server.js. 只清理 web 静态资源, 保留 server.js.
+  for (const f of ['index.html', 'api-config.html', 'style.css', 'client.js', 'mobile.html', 'mobile.css', 'mobile.js', 'mobile-core.js', 'components']) {
+    await fs.rm(path.join(DIST_WEB, f), { recursive: true, force: true });
+  }
+  await fs.mkdir(DIST_WEB, { recursive: true });
+  await fs.mkdir(path.join(DIST_WEB, 'components', 'p2p'), { recursive: true });
+
+  // 编译 TypeScript 模块
+  console.log('[build-web] 编译 TypeScript 模块...');
+  const moduleFiles = [
+    'src/web/components/p2p/types.ts',
+    'src/web/components/p2p/p2p-store-memory.ts',
+    'src/web/components/p2p/p2p-identity.ts',
+    'src/web/components/p2p/p2p-connection.ts',
+    'src/web/components/p2p/p2p-messages.ts',
+    'src/web/components/p2p/p2p-manager.ts',
+  ];
+
+  try {
+    execSync(`npx tsc --ignoreConfig --outDir dist/web/components/p2p --declaration false --skipLibCheck --target ES2022 --module ESNext --moduleResolution bundler ${moduleFiles.join(' ')}`, {
+      cwd: ROOT,
+      stdio: 'inherit'
+    });
+  } catch {
+    console.log('[build-web] TypeScript 编译有警告，继续...');
+  }
+
+  // 编译 P2P Modal UI（esbuild）
+  console.log('[build-web] 编译 P2P Modal UI...');
+  await esbuild.build({
+    entryPoints: [path.join(ROOT, 'src/web/components/p2p/index.ts')],
+    outfile: path.join(DIST_WEB, 'components/p2p/index.js'),
+    format: 'esm',
+    target: 'es2022',
+    platform: 'browser',
+    minify: false,
+  });
+
+  // 2026-06-15: 编译 message-renderer.ts (对话显示 UI 模块)
+  //   esbuild 编译 .ts → dist/web/ui/message-renderer.js (ESM, 浏览器侧 <script type="module"> 加载)
+  console.log('[build-web] 编译 message-renderer.ts...');
+  await fs.mkdir(path.join(DIST_WEB, 'ui'), { recursive: true });
+  await esbuild.build({
+    entryPoints: [path.join(ROOT, 'src/web/ui/message-renderer.ts')],
+    outfile: path.join(DIST_WEB, 'ui/message-renderer.js'),
+    format: 'esm',
+    target: 'es2022',
+    platform: 'browser',
+    minify: false,
+  });
+
+  // 2026-06-15: 编译 step-timeline.ts (气泡内 4 状态步骤条)
+  console.log('[build-web] 编译 step-timeline.ts...');
+  await esbuild.build({
+    entryPoints: [path.join(ROOT, 'src/web/ui/step-timeline.ts')],
+    outfile: path.join(DIST_WEB, 'ui/step-timeline.js'),
+    format: 'esm',
+    target: 'es2022',
+    platform: 'browser',
+    minify: false,
+  });
+
+  // 编译主客户端入口 (classic script, 非 module; 由 index.html 以 /client.js 加载)
+  // 2026-07-06: client.ts 加了 import { safeChannelName } from './util/safe-name.js'.
+  //   不开 bundle 的话, esbuild 把 require("./util/safe-name.js") 内联到 IIFE 顶层
+  //   → 浏览器无 require → ReferenceError → init() 没跑 → UI 全空 (channels 不显示).
+  //   开 bundle=true 让 esbuild 把 safe-name 全部 inline 进 client.js (1.8KB, 无影响).
+  console.log('[build-web] 编译 client.ts...');
+  await esbuild.build({
+    entryPoints: [path.join(ROOT, 'src/web/client.ts')],
+    outfile: path.join(DIST_WEB, 'client.js'),
+    format: 'iife',
+    target: 'es2022',
+    platform: 'browser',
+    minify: false,
+    bundle: true,
+  });
+
+  // 2026-08-14: 编译 mobile-core.ts (手机端内化内核 → mobile-core.js)
+  //   IIFE + bundle: WebView 无 module 解析, 必须全内联 (IndexedDB/WebCrypto 为浏览器原生, 无需 polyfill)
+  console.log('[build-web] 编译 mobile-core.ts...');
+  await esbuild.build({
+    entryPoints: [path.join(ROOT, 'src/web/mobile-core.ts')],
+    outfile: path.join(DIST_WEB, 'mobile-core.js'),
+    format: 'iife',
+    target: 'es2022',
+    platform: 'browser',
+    minify: false,
+    bundle: true,
+  });
+
+  // 2026-08-12: 编译 A2UI 前端渲染器 (a2ui-client.tsx → a2ui-client.js)
+  //   react + @a2ui/react + @a2ui/web_core 全部打包进 bundle (手机端 webview 无 CDN)
+  console.log('[build-web] 编译 a2ui-client.tsx...');
+  await esbuild.build({
+    entryPoints: [path.join(ROOT, 'src/web/a2ui-client.tsx')],
+    outfile: path.join(DIST_WEB, 'a2ui-client.js'),
+    format: 'iife',
+    target: 'es2022',
+    platform: 'browser',
+    minify: false,
+    bundle: true,
+    jsx: 'automatic',
+    loader: { '.tsx': 'tsx' },
+  });
+
+  // 复制静态文件
+  console.log('[build-web] 复制静态文件...');
+  await fs.copyFile(path.join(ROOT, 'src/web/index.html'), path.join(DIST_WEB, 'index.html'));
+  await fs.copyFile(path.join(ROOT, 'src/web/api-config.html'), path.join(DIST_WEB, 'api-config.html'));
+  await fs.copyFile(path.join(ROOT, 'src/web/style.css'), path.join(DIST_WEB, 'style.css'));
+  // 2026-08-12: 手机端 UI (微信风格, Capacitor webview 加载) — 纯静态复制
+  await fs.copyFile(path.join(ROOT, 'src/web/mobile.html'), path.join(DIST_WEB, 'mobile.html'));
+  await fs.copyFile(path.join(ROOT, 'src/web/mobile.css'), path.join(DIST_WEB, 'mobile.css'));
+  await fs.copyFile(path.join(ROOT, 'src/web/mobile.js'), path.join(DIST_WEB, 'mobile.js'));
+  // 复制 PWA manifest (index.html 里有 <link rel="manifest">, 否则浏览器会 404)
+  await fs.copyFile(path.join(ROOT, 'src/web/manifest.json'), path.join(DIST_WEB, 'manifest.json'));
+  // 复制 icons 目录 (manifest.json 里引用了 favicon 等)
+  await fs.cp(path.join(ROOT, 'src/web/icons'), path.join(DIST_WEB, 'icons'), { recursive: true });
+
+  // 复制 system-prompt layer .md 文件到 dist/llm/system-prompt/layers/
+  //   原因: tsc 不复制 .md, src/llm/system-prompt/layers/{core,role,channel,tool}/*.md
+  //   在 dist 里完全不存在, registry.ts 用 __dirname + 'layers' 读它们时 100% ENOENT.
+  //   这里全量复制 25 个 .md, 不过滤 'never' 层 — registry.matchesContext 已做过滤.
+  const srcLayers = path.join(ROOT, 'src/llm/system-prompt/layers');
+  const dstLayers = path.join(ROOT, 'dist/llm/system-prompt/layers');
+  await fs.cp(srcLayers, dstLayers, { recursive: true });
+  console.log('[build-web] system-prompt layers copied →', path.relative(ROOT, dstLayers));
+
+  // 复制 components/ 下的独立 ESM 模块 (非 p2p 那些, 已被 esbuild 单独编译)
+  // 例如 wallet-viem.mjs: 浏览器侧 viem 封装, 被 index.html 引用
+  const extraComponentsDir = path.join(ROOT, 'src/web/components');
+  for (const entry of await fs.readdir(extraComponentsDir)) {
+    if (entry === 'p2p') continue;
+    const src = path.join(extraComponentsDir, entry);
+    const dest = path.join(DIST_WEB, 'components', entry);
+    const stat = await fs.stat(src);
+    if (stat.isFile()) {
+      await fs.mkdir(path.dirname(dest), { recursive: true });
+      await fs.copyFile(src, dest);
+    }
+  }
+
+  console.log('[build-web] 完成!');
+}
+
+main().catch(console.error);

package/scripts/postinstall.js

@@ -1,153 +1,153 @@
-/**
- * Postinstall 脚本
- * npm 安装后自动执行
- *
- * 主要任务：
- * 1. 确保 bin 目录存在且可执行
- * 2. 初始化本地配置
- * 3. 检查依赖完整性
- */
-
-import * as fs from 'fs';
-import * as path from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const rootDir = path.join(__dirname, '..');
-
-const RESET = '\x1b[0m';
-const GREEN = '\x1b[32m';
-const YELLOW = '\x1b[33m';
-const CYAN = '\x1b[36m';
-
-function log(msg, color = RESET) {
-  console.log(color + msg + RESET);
-}
-
-function initUserDirs() {
-  // 创建用户数据目录
-  const home = process.env.HOME || process.env.USERPROFILE || '/tmp';
-  const bolloonDir = path.join(home, '.bolloon');
-
-  const dirs = [
-    bolloonDir,
-    path.join(bolloonDir, 'sessions'),
-    path.join(bolloonDir, 'peer-store'),
-  ];
-
-  for (const dir of dirs) {
-    if (!fs.existsSync(dir)) {
-      fs.mkdirSync(dir, { recursive: true });
-      log(`  ✓ 创建目录: ${dir}`, GREEN);
-    }
-  }
-
-  // 初始化配置文件
-  const configPath = path.join(bolloonDir, 'config.json');
-  if (!fs.existsSync(configPath)) {
-    const defaultConfig = {
-      version: '0.1.12',
-      initializedAt: new Date().toISOString(),
-      defaults: {
-        port: 54188,
-        theme: 'dark',
-        autoConnect: true,
-      },
-      providers: {
-        minimax: { enabled: false },
-        openai: { enabled: false },
-        anthropic: { enabled: false },
-      }
-    };
-    fs.writeFileSync(configPath, JSON.stringify(defaultConfig, null, 2));
-    log(`  ✓ 创建配置: ${configPath}`, GREEN);
-  }
-
-  return bolloonDir;
-}
-
-function checkNativeDeps() {
-  // 检查必要的原生依赖
-  const nativeDeps = [
-    'libp2p',
-    '@diap/sdk',
-  ];
-
-  let allOk = true;
-
-  for (const dep of nativeDeps) {
-    const depPath = path.join(rootDir, 'node_modules', dep);
-    if (!fs.existsSync(depPath)) {
-      log(`  ⚠ 缺少依赖: ${dep}`, YELLOW);
-      allOk = false;
-    }
-  }
-
-  return allOk;
-}
-
-function setupPlatform() {
-  const platform = process.platform;
-
-  log(`\n  平台: ${platform}`, CYAN);
-
-  if (platform === 'win32') {
-    // Windows: 确保 .cmd 文件存在
-    const binDir = path.join(rootDir, 'bin');
-    const cmdPath = path.join(binDir, 'bolloon.cmd');
-
-    if (fs.existsSync(binDir) && !fs.existsSync(cmdPath)) {
-      const cmdContent = `@echo off
-node "%~dp0..\\dist\\cli.js" %*
-`;
-      fs.writeFileSync(cmdPath, cmdContent);
-      log('  ✓ Windows 入口已创建', GREEN);
-    }
-  } else {
-    // Unix/Linux/Mac: 确保 bin 文件可执行
-    const binDir = path.join(rootDir, 'bin');
-    const binPath = path.join(binDir, 'bolloon.js');
-
-    if (fs.existsSync(binPath)) {
-      try {
-        fs.chmodSync(binPath, 0o755);
-        log('  ✓ bin/bolloon.js 已设为可执行', GREEN);
-      } catch (err) {
-        log(`  ⚠ 无法设置执行权限: ${err.message}`, YELLOW);
-      }
-    }
-  }
-}
-
-function main() {
-  console.log('\n📦 Bolloon 安装后处理...\n');
-
-  try {
-    // 1. 初始化用户目录
-    const bolloonDir = initUserDirs();
-    log(`  ✓ 用户数据目录: ${bolloonDir}`, GREEN);
-
-    // 2. 检查依赖
-    const depsOk = checkNativeDeps();
-    if (!depsOk) {
-      log('\n  ⚠ 部分依赖缺失，建议运行: npm install', YELLOW);
-    }
-
-    // 3. 平台特定设置
-    setupPlatform();
-
-    console.log('\n✅ 安装完成！\n');
-    console.log('  使用方式:');
-    console.log('    bolloon              # 启动 GUI');
-    console.log('    bolloon --web        # 启动 Web UI');
-    console.log('    bolloon --cli        # 命令行模式');
-    console.log('    bolloon --help       # 显示帮助\n');
-    console.log(`  配置文件: ${path.join(bolloonDir, 'config.json')}\n`);
-  } catch (err) {
-    console.error('\n❌ 安装后处理失败:', err.message);
-    console.error('  这通常不影响基本功能，继续安装...\n');
-  }
-}
-
+/**
+ * Postinstall 脚本
+ * npm 安装后自动执行
+ *
+ * 主要任务：
+ * 1. 确保 bin 目录存在且可执行
+ * 2. 初始化本地配置
+ * 3. 检查依赖完整性
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const rootDir = path.join(__dirname, '..');
+
+const RESET = '\x1b[0m';
+const GREEN = '\x1b[32m';
+const YELLOW = '\x1b[33m';
+const CYAN = '\x1b[36m';
+
+function log(msg, color = RESET) {
+  console.log(color + msg + RESET);
+}
+
+function initUserDirs() {
+  // 创建用户数据目录
+  const home = process.env.HOME || process.env.USERPROFILE || '/tmp';
+  const bolloonDir = path.join(home, '.bolloon');
+
+  const dirs = [
+    bolloonDir,
+    path.join(bolloonDir, 'sessions'),
+    path.join(bolloonDir, 'peer-store'),
+  ];
+
+  for (const dir of dirs) {
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+      log(`  ✓ 创建目录: ${dir}`, GREEN);
+    }
+  }
+
+  // 初始化配置文件
+  const configPath = path.join(bolloonDir, 'config.json');
+  if (!fs.existsSync(configPath)) {
+    const defaultConfig = {
+      version: '0.1.12',
+      initializedAt: new Date().toISOString(),
+      defaults: {
+        port: 54188,
+        theme: 'dark',
+        autoConnect: true,
+      },
+      providers: {
+        minimax: { enabled: false },
+        openai: { enabled: false },
+        anthropic: { enabled: false },
+      }
+    };
+    fs.writeFileSync(configPath, JSON.stringify(defaultConfig, null, 2));
+    log(`  ✓ 创建配置: ${configPath}`, GREEN);
+  }
+
+  return bolloonDir;
+}
+
+function checkNativeDeps() {
+  // 检查必要的原生依赖
+  const nativeDeps = [
+    'libp2p',
+    '@diap/sdk',
+  ];
+
+  let allOk = true;
+
+  for (const dep of nativeDeps) {
+    const depPath = path.join(rootDir, 'node_modules', dep);
+    if (!fs.existsSync(depPath)) {
+      log(`  ⚠ 缺少依赖: ${dep}`, YELLOW);
+      allOk = false;
+    }
+  }
+
+  return allOk;
+}
+
+function setupPlatform() {
+  const platform = process.platform;
+
+  log(`\n  平台: ${platform}`, CYAN);
+
+  if (platform === 'win32') {
+    // Windows: 确保 .cmd 文件存在
+    const binDir = path.join(rootDir, 'bin');
+    const cmdPath = path.join(binDir, 'bolloon.cmd');
+
+    if (fs.existsSync(binDir) && !fs.existsSync(cmdPath)) {
+      const cmdContent = `@echo off
+node "%~dp0..\\dist\\cli.js" %*
+`;
+      fs.writeFileSync(cmdPath, cmdContent);
+      log('  ✓ Windows 入口已创建', GREEN);
+    }
+  } else {
+    // Unix/Linux/Mac: 确保 bin 文件可执行
+    const binDir = path.join(rootDir, 'bin');
+    const binPath = path.join(binDir, 'bolloon.js');
+
+    if (fs.existsSync(binPath)) {
+      try {
+        fs.chmodSync(binPath, 0o755);
+        log('  ✓ bin/bolloon.js 已设为可执行', GREEN);
+      } catch (err) {
+        log(`  ⚠ 无法设置执行权限: ${err.message}`, YELLOW);
+      }
+    }
+  }
+}
+
+function main() {
+  console.log('\n📦 Bolloon 安装后处理...\n');
+
+  try {
+    // 1. 初始化用户目录
+    const bolloonDir = initUserDirs();
+    log(`  ✓ 用户数据目录: ${bolloonDir}`, GREEN);
+
+    // 2. 检查依赖
+    const depsOk = checkNativeDeps();
+    if (!depsOk) {
+      log('\n  ⚠ 部分依赖缺失，建议运行: npm install', YELLOW);
+    }
+
+    // 3. 平台特定设置
+    setupPlatform();
+
+    console.log('\n✅ 安装完成！\n');
+    console.log('  使用方式:');
+    console.log('    bolloon              # 启动 GUI');
+    console.log('    bolloon --web        # 启动 Web UI');
+    console.log('    bolloon --cli        # 命令行模式');
+    console.log('    bolloon --help       # 显示帮助\n');
+    console.log(`  配置文件: ${path.join(bolloonDir, 'config.json')}\n`);
+  } catch (err) {
+    console.error('\n❌ 安装后处理失败:', err.message);
+    console.error('  这通常不影响基本功能，继续安装...\n');
+  }
+}
+
 main();