@iamsamyiok/agents-chat 3.29.0 → 3.30.0

package/app/lib/agent.js

@@ -49,6 +49,8 @@ const KERNEL_DEFS = [
 // Windows 下 npm 安装的 CLI 是 .cmd 垫片，Node 18.20+ 禁止直接 spawn，须走 shell
 // 显式路径优先级：AGENTS_CHAT_<ID>_CMD（如 AGENTS_CHAT_OPENCODE_CMD）> PATH 查找
 let detectCache = { ts: 0, map: null };
+// 安装新内核后刷新缓存（否则同进程 10 秒内仍认为未安装）
+function resetDetectCache() { detectCache = { ts: 0, map: null }; }
 
 function findCli(def) {
   const custom = process.env[`AGENTS_CHAT_${def.id.toUpperCase()}_CMD`];
@@ -484,4 +486,4 @@ function spawnMock(args, agent, env, onChunk, scope) {
   return child;
 }
 
-module.exports = { runAgent, resolveRunner, detectKernels, KERNEL_DEFS, missingHint, describeTool, stopScope, stopAllChildren, resolveCwd, registerChild };
+module.exports = { runAgent, resolveRunner, detectKernels, resetDetectCache, KERNEL_DEFS, missingHint, describeTool, stopScope, stopAllChildren, resolveCwd, registerChild };

package/app/lib/kernel-setup.js

@@ -0,0 +1,43 @@
+// 内核自动安装：npm 包安装（postinstall）与 CLI 启动共用
+// 策略：一个内核都没有时自动安装 opencode（默认推荐内核）；任一内核已存在则跳过；
+//       单文件 exe 形态无 npm，跳过；AGENTS_CHAT_AUTO_INSTALL=0 可关闭。
+// 原则：任何失败只提示，绝不抛错（postinstall 失败会连带 npm install 整体失败）。
+const { execSync } = require('child_process');
+
+// 纯决策函数（单测覆盖）：给定 detectKernels() 的 map，判断是否需要自动安装
+function shouldAutoInstall(kernelMap, { standalone = false, disabled = false } = {}) {
+  if (standalone) return { need: false, reason: 'standalone' };      // exe 无 npm
+  if (disabled) return { need: false, reason: 'disabled' };          // 用户显式关闭
+  if (!kernelMap || typeof kernelMap !== 'object' || !Object.keys(kernelMap).length) return { need: false, reason: 'badmap' };
+  const anyOk = Object.values(kernelMap).some(k => k && k.ok);
+  if (anyOk) return { need: false, reason: 'has-kernel' };
+  return { need: true, reason: 'none' };
+}
+
+// 执行安装并返回结果；log/inject 可注入（postinstall 用 console，单测用收集器）
+function ensureDefaultKernel({ log = console.log, standalone = !!process.versions.bun || process.env.AGENTS_CHAT_STANDALONE === '1' } = {}) {
+  const { detectKernels } = require('./agent');
+  const decision = shouldAutoInstall(detectKernels(), {
+    standalone,
+    disabled: process.env.AGENTS_CHAT_AUTO_INSTALL === '0'
+  });
+  if (!decision.need) {
+    if (decision.reason === 'standalone') log('ℹ 单文件版内置 npm 不可用：未检测到内核时请手动安装 opencode（npm install -g opencode-ai）');
+    return { installed: false, reason: decision.reason };
+  }
+  log('未检测到任何 AI 执行内核，正在自动安装 opencode（约 1-2 分钟，仅此一次）...');
+  try {
+    execSync('npm install -g opencode-ai', { stdio: 'inherit', timeout: 300000 });
+    // 刷新检测缓存，让随后的启动横幅直接看到新内核
+    try { require('./agent').resetDetectCache(); } catch { /* 旧版无此函数则忽略 */ }
+    log('✓ opencode 安装完成（PATH 由 npm 自动配置，重开终端生效）');
+    return { installed: true };
+  } catch (err) {
+    log('✗ 自动安装失败（通常是全局目录权限不足），请手动执行其中一条：');
+    log('    Windows:        npm install -g opencode-ai');
+    log('    Linux/macOS:    sudo npm install -g opencode-ai');
+    return { installed: false, reason: 'install-failed', error: err && err.message };
+  }
+}
+
+module.exports = { shouldAutoInstall, ensureDefaultKernel };

package/bin/agents-chat.js

@@ -70,6 +70,12 @@ function startServer() {
     cleanupDeadProcess(check.pid);
   }
 
+  // 兜底自动安装：postinstall 被跳过（yarn/pnpm/离线装包）时，首次 start 补装 opencode
+  try {
+    const { ensureDefaultKernel } = require('../app/lib/kernel-setup');
+    ensureDefaultKernel();
+  } catch { /* 任何失败不阻塞启动 */ }
+
   console.log(`启动 Agents Chat 服务 (端口 ${PORT})...`);
   
   const env = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iamsamyiok/agents-chat",
-  "version": "3.29.0",
+  "version": "3.30.0",
   "description": "多智能体群聊工具 - 支持 OpenCode/Claude Code/Codex/pi 内核，微信风格聊天界面",
   "main": "lib/start.js",
   "bin": {
@@ -9,7 +9,8 @@
   "files": [
     "bin",
     "lib",
-    "app"
+    "app",
+    "scripts"
   ],
   "keywords": [
     "ai",
@@ -35,6 +36,7 @@
   "scripts": {
     "start": "node app/server.js",
     "test": "node --test \"test/*.test.js\"",
-    "build:exe": "node scripts/build-exe.js"
+    "build:exe": "node scripts/build-exe.js",
+    "postinstall": "node scripts/postinstall.js"
   }
 }

package/scripts/build-exe.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+/**
+ * 单文件 exe 构建（bun compile）
+ *
+ * 用法:
+ *   node scripts/build-exe.js                # 全部平台（windows-x64 / linux-x64 / darwin-x64 / darwin-arm64）
+ *   node scripts/build-exe.js windows-x64    # 只构建指定平台
+ *
+ * 产物: dist/agents-chat-<platform>[.exe]（Windows 为 .exe）
+ * 原理: 先把 app/public/*.html 生成内嵌资源模块（app/lib/embedded-assets.js），
+ *       再由 bun build --compile 把 server.js + 内嵌资源打包成单可执行文件；
+ *       运行时 serveStatic 优先读内嵌资源，磁盘 public 目录仅开发模式使用。
+ */
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const ROOT = path.join(__dirname, '..');
+const PUB = path.join(ROOT, 'app', 'public');
+const EMBED = path.join(ROOT, 'app', 'lib', 'embedded-assets.js');
+const DIST = path.join(ROOT, 'dist');
+const PKG = require(path.join(ROOT, 'package.json'));
+
+const ALL_TARGETS = ['windows-x64', 'linux-x64', 'darwin-x64', 'darwin-arm64'];
+const targets = process.argv[2] ? [process.argv[2]] : ALL_TARGETS;
+for (const t of targets) {
+  if (!ALL_TARGETS.includes(t)) {
+    console.error(`未知平台: ${t}（可选: ${ALL_TARGETS.join(' / ')}）`);
+    process.exit(1);
+  }
+}
+
+// 1. 生成内嵌资源模块（HTML → JSON 字符串常量，杜绝转义问题）
+const assets = {};
+for (const f of fs.readdirSync(PUB)) {
+  if (f.endsWith('.html')) assets[f] = fs.readFileSync(path.join(PUB, f), 'utf8');
+}
+fs.writeFileSync(EMBED, [
+  '// 本文件由 scripts/build-exe.js 构建时自动生成，勿手工编辑、勿提交仓库',
+  `// 内嵌页面资源（构建于 ${new Date().toISOString()}，v${PKG.version}）`,
+  'module.exports = ' + JSON.stringify(assets, null, 2) + ';',
+  ''
+].join('\n'));
+console.log(`已生成内嵌资源: ${Object.keys(assets).join('、')}`);
+
+// 2. bun compile 各平台
+fs.mkdirSync(DIST, { recursive: true });
+let failed = [];
+for (const t of targets) {
+  const out = path.join(DIST, t === 'windows-x64' ? `agents-chat-${t}.exe` : `agents-chat-${t}`);
+  console.log(`构建 ${t} -> ${path.relative(ROOT, out)} ...`);
+  // windows: 双击运行不弹命令行窗口（日志自动落到 exe 旁 .data/agents-chat.log）
+  // 注：--windows-title/icon 需在 Windows 本机构建，交叉编译只加 hide-console
+  const extra = t === 'windows-x64' ? ' --windows-hide-console' : '';
+  try {
+    execSync(`bun build --compile --minify --define "process.env.AGENTS_CHAT_STANDALONE=\\"1\\"" --target=bun-${t}${extra} app/server.js --outfile "${path.relative(ROOT, out)}"`, {
+      cwd: ROOT, stdio: 'inherit'
+    });
+    const mb = (fs.statSync(out).size / 1024 / 1024).toFixed(1);
+    console.log(`  完成: ${path.relative(ROOT, out)} (${mb} MB)`);
+  } catch (e) {
+    console.error(`  ${t} 构建失败: ${e.message}`);
+    failed.push(t);
+  }
+}
+
+// 3. 清理中间产物（下次构建重新生成；源码运行不需要它）
+try { fs.unlinkSync(EMBED); } catch { /* ignore */ }
+
+if (failed.length) {
+  console.error(`失败平台: ${failed.join(', ')}`);
+  process.exit(1);
+}
+console.log('全部构建完成');

package/scripts/postinstall.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+// npm 安装钩子：全无 AI 内核时自动安装 opencode，小白开箱即用
+// 铁律：任何失败只提示不抛错——postinstall 非零退出会连带 npm install 整体报错
+try {
+  const { ensureDefaultKernel } = require('../app/lib/kernel-setup');
+  const r = ensureDefaultKernel();
+  if (r.reason === 'has-kernel') console.log('✓ 已检测到 AI 执行内核，跳过自动安装');
+} catch (err) {
+  console.warn('内核自动安装检查跳过:', err && err.message);
+}