@iamsamyiok/agents-chat 3.29.0 → 3.31.0

package/.env.example

@@ -0,0 +1,26 @@
+# Agents Chat 配置示例：复制为同目录 .env 后按需修改；全部可省略
+
+# ---- 通知 ----
+# 任务/卡牌完成时转发 JSON 到该地址（钉钉/飞书自定义 bot 或自建中转均可）：
+# POST {event,kind,title,status,snippet,text}，2 秒超时失败静默
+# AGENTS_CHAT_WEBHOOK_URL=https://example.com/your-hook
+
+# ---- 资源与清理 ----
+# 每日滚动清理保留天数（默认 15；0 不代表关闭清理，请用大数值）
+# AGENTS_CHAT_PRUNE_DAYS=15
+# 单会话消息滚动上限（默认 500，0=关闭；主会话不受限）
+# AGENTS_CHAT_MSG_LIMIT=500
+
+# ---- 自动退出 ----
+# 全部页面关闭且空闲后自动退出（默认开；0 关闭）
+# AGENTS_CHAT_AUTOSTOP=1
+# 空闲多少毫秒后退出（默认 50000）
+# AGENTS_CHAT_AUTOSTOP_IDLE_MS=50000
+
+# ---- 内核与执行 ----
+# 自动安装 opencode（默认开；0 关闭）
+# AGENTS_CHAT_AUTO_INSTALL=1
+# 指定内核完整路径（按需）
+# AGENTS_CHAT_OPENCODE_CMD=
+# 单任务超时毫秒（默认 10 分钟）
+# AGENTS_CHAT_TIMEOUT_MS=600000

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/cards.js

@@ -11,6 +11,7 @@
 const fs = require('fs');
 const path = require('path');
 const { resolveRunner, detectKernels, KERNEL_DEFS, stopScope } = require('./agent');
+const { notifyDone } = require('./notify');
 const oc = require('./oc');
 const store = require('./store');
 const safejson = require('./safejson');
@@ -522,6 +523,7 @@ class CardRunner {
       finishedAt: Date.now()
     });
     broadcast({ type: 'task_done', cardId: card.id, status, title: card.title });
+    notifyDone({ kind: 'card', title: card.title, status, snippet: doneError || finalText });
     // 任务结束，移除进程登记
     this.procs.delete(card.id);
   }

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/app/lib/notify.js

@@ -0,0 +1,26 @@
+// 完成通知出口：webhook 转发（钉钉/飞书/Telegram bot 的中转地址均可）
+// .env AGENTS_CHAT_WEBHOOK_URL 配置后生效；POST {event,title,status,snippet,text}，text 字段可直接被
+// 简单集成消费。2 秒超时失败静默——通知是锦上添花，绝不影响任务流程。
+let warned = false;
+
+function notifyDone({ kind = 'task', title = '', status = 'done', snippet = '' } = {}) {
+  const hook = process.env.AGENTS_CHAT_WEBHOOK_URL;
+  if (!hook) return;
+  const icon = status === 'done' ? '✅' : status === 'failed' ? '❌' : '⏹';
+  const text = `${icon} Agents Chat ${kind === 'card' ? '卡牌' : '任务'}${status === 'done' ? '完成' : status === 'failed' ? '失败' : '已停止'}：${title}${snippet ? '\n' + snippet.slice(0, 200) : ''}`;
+  const body = { event: 'done', kind, title, status, snippet: snippet.slice(0, 500), text };
+  const ctrl = new AbortController();
+  const timer = setTimeout(() => ctrl.abort(), 2000);
+  fetch(hook, {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify(body),
+    signal: ctrl.signal
+  }).then(() => { warned = false; })
+    .catch(() => {
+      if (!warned) { warned = true; console.warn('[notify] webhook 发送失败（后续失败静默）：' + hook); }
+    })
+    .finally(() => clearTimeout(timer));
+}
+
+module.exports = { notifyDone };

package/app/lib/store.js

@@ -551,6 +551,92 @@ function addMessage(msg) {
     msgs.push(...kept);
   }
   writeJson(msgShardPath(key), msgs);
+  // 用量统计：消息携带 usage（token 数）即累计——所有 runner 的消息路径统一经过这里
+  const u = Number(msg.usage);
+  if (u > 0) recordUsage({ tokens: Math.floor(u), requests: 1 });
+}
+
+// ---------- 全历史关键词检索：逐分片匹配，不合并大数组 ----------
+function searchMessages(q, { limit = 50 } = {}) {
+  const needle = String(q || '').trim().toLowerCase();
+  if (!needle) return [];
+  const out = [];
+  let files = [];
+  try { files = fs.readdirSync(MSG_DIR); } catch { return out; }
+  for (const f of files) {
+    if (!f.endsWith('.json')) continue;
+    let list;
+    try { list = readJson(path.join(MSG_DIR, f), []); } catch { continue; }
+    if (!Array.isArray(list)) continue;
+    // 分片名还原会话标识（hex 编码逆变换，_main 为主会话）
+    const stem = f.replace(/\.json$/, '');
+    const sessionId = stem === '_main' ? '' : (stem.startsWith('_') ? Buffer.from(stem.slice(1), 'hex').toString('utf8') : stem);
+    for (const m of list) {
+      const c = String(m.content || '');
+      if (c.toLowerCase().includes(needle)) {
+        const idx = c.toLowerCase().indexOf(needle);
+        const from = Math.max(0, idx - 40);
+        out.push({
+          sessionId, role: m.role || '', agentName: m.agentName || '',
+          snippet: (from > 0 ? '…' : '') + c.slice(from, from + needle.length + 80) + '…',
+          timestamp: m.timestamp || ''
+        });
+        if (out.length >= limit * 3) break; // 分片内粗截，最后统一排序取 limit
+      }
+    }
+  }
+  out.sort((a, b) => String(b.timestamp).localeCompare(String(a.timestamp)));
+  return out.slice(0, limit);
+}
+
+// ---------- 用量统计（token/请求数按日累计，usage.json） ----------
+const USAGE_PATH = path.join(DATA_DIR, 'usage.json');
+function readUsage() {
+  const d = readJson(USAGE_PATH, { days: {}, total: { tokens: 0, requests: 0 } });
+  if (!d.days) d.days = {};
+  if (!d.total) d.total = { tokens: 0, requests: 0 };
+  return d;
+}
+function recordUsage({ tokens = 0, requests = 0 } = {}) {
+  const d = readUsage();
+  const day = new Date().toISOString().slice(0, 10);
+  if (!d.days[day]) d.days[day] = { tokens: 0, requests: 0 };
+  d.days[day].tokens += Math.floor(tokens);
+  d.days[day].requests += Math.floor(requests);
+  d.total.tokens += Math.floor(tokens);
+  d.total.requests += Math.floor(requests);
+  // 只保留最近 60 天明细，总量恒累计
+  const days = Object.keys(d.days).sort();
+  while (days.length > 60) delete d.days[days.shift()];
+  writeJson(USAGE_PATH, d);
+}
+function getUsageStats() {
+  const d = readUsage();
+  const today = new Date().toISOString().slice(0, 10);
+  const recent = Object.entries(d.days).slice(-7).map(([day, v]) => ({ day, ...v }));
+  return { today: d.days[today] || { tokens: 0, requests: 0 }, total: d.total, recent };
+}
+
+// ---------- 数据目录占用统计（可见性：让用户看得到空间去哪了） ----------
+function dirSize(p) {
+  let total = 0;
+  let entries = [];
+  try { entries = fs.readdirSync(p, { withFileTypes: true }); } catch { return 0; }
+  for (const e of entries) {
+    const fp = path.join(p, e.name);
+    try {
+      if (e.isDirectory()) total += dirSize(fp);
+      else total += fs.statSync(fp).size;
+    } catch { /* ignore */ }
+  }
+  return total;
+}
+function dataStats() {
+  const parts = {};
+  for (const name of ['messages', 'outputs', 'workspace', 'flow']) {
+    parts[name] = dirSize(path.join(DATA_DIR, name));
+  }
+  return { total: dirSize(DATA_DIR), ...parts };
 }
 
 // 按会话统计消息数（逐分片累加，不合并大数组：统计/导出场景低内存）
@@ -795,6 +881,10 @@ module.exports = {
   addMessage,
   clearMessages,
   countMessagesByTask,
+  searchMessages,
+  recordUsage,
+  getUsageStats,
+  dataStats,
   addFlowEvent,
   getFlow,
   listFlowRuns,

package/app/public/cards.html

@@ -2,7 +2,10 @@
 <html lang="zh-CN">
 <head>
 <meta charset="UTF-8" />
-<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
+<meta name="theme-color" content="#07c160">
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/static/icon.svg" type="image/svg+xml">
 <title>多任务编排</title>
 <style>
   :root{
@@ -202,6 +205,15 @@
   .update-bar{position:fixed;top:0;left:0;right:0;z-index:60;background:#fffbe6;border-bottom:1px solid #ffe58f;color:#614700;font-size:12.5px;padding:7px 14px;display:flex;align-items:center;gap:8px;flex-wrap:wrap}
   .update-bar button{border:1px solid #d8b94a;background:#fff;border-radius:5px;padding:2px 10px;font-size:12px;cursor:pointer;color:#614700}
   .update-bar button:hover{background:#fff7d6}
+  /* 小屏增强：顶栏收纳 + 看板横向滚动 + 安全区 */
+  @media (max-width:760px){
+    header{flex-wrap:wrap;gap:6px;padding:8px 10px}
+    header .btn{padding:5px 8px;font-size:12px}
+    .filter-box input{width:90px}
+    .board{grid-template-columns:repeat(4,minmax(220px,1fr));overflow-x:auto;padding-bottom:calc(6px + env(safe-area-inset-bottom))}
+    .modal{width:96vw;max-height:92vh}
+    #maskDetail .detail-log{max-height:36vh}
+  }
 </style>
 </head>
 <body>
@@ -1108,6 +1120,13 @@ es.onmessage = (e)=>{
     refreshProcs();
     // 失败即时提醒（完成静默：看板移动可见 + all_done 汇总通知）
     if(ev.type==='task_done' && ev.status==='failed') toast('✗「'+(ev.title||'任务')+'」执行失败，点击卡片查看原因');
+    // 系统级通知：开关开启且页面后台时，卡牌完成/失败弹系统通知（与群聊页共用开关）
+    try{
+      if(ev.type==='task_done' && localStorage.getItem('sysNotify')==='1' && document.hidden && typeof Notification!=='undefined' && Notification.permission==='granted'){
+        const n=new Notification((ev.status==='failed'?'❌ 卡牌失败：':'✅ 卡牌完成：')+(ev.title||''),{tag:'agents-chat-card'});
+        n.onclick=()=>{ window.focus(); n.close(); };
+      }
+    }catch(e){}
     if(OPEN_ID && ev.cardId===OPEN_ID){
       const log=$('#dLog'); if(log.querySelector('.empty')) log.innerHTML='';
       if(ev.type==='task_start') TEXT_PARTS.clear();

package/app/public/icon.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128">
+  <rect width="128" height="128" rx="24" fill="#07c160"/>
+  <circle cx="40" cy="52" r="12" fill="#fff"/>
+  <circle cx="88" cy="52" r="12" fill="#fff"/>
+  <path d="M34 86c8 10 22 14 30 14s22-4 30-14" stroke="#fff" stroke-width="9" fill="none" stroke-linecap="round"/>
+</svg>

package/app/public/index.html

@@ -2,7 +2,12 @@
 <html lang="zh-CN">
 <head>
 <meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover">
+<meta name="theme-color" content="#07c160">
+<meta name="apple-mobile-web-app-capable" content="yes">
+<meta name="apple-mobile-web-app-title" content="AgentsChat">
+<link rel="manifest" href="/manifest.json">
+<link rel="icon" href="/static/icon.svg" type="image/svg+xml">
 <title>Agents 群聊</title>
 <style>
   * { margin: 0; padding: 0; box-sizing: border-box; }
@@ -84,6 +89,11 @@
   #jumpBtn { position: absolute; right: 18px; bottom: 100px; z-index: 5; display: none; border: 1px solid #dcdcdc; background: #fff; color: #333; border-radius: 16px; padding: 6px 14px; font-size: 12px; cursor: pointer; box-shadow: 0 2px 8px rgba(0,0,0,.15); animation: fade-in .2s ease; transition: color .15s, border-color .15s; }
   #jumpBtn:hover { color: #07c160; border-color: #07c160; }
   .sys-tip { text-align: center; margin: 10px 0; }
+  /* 历史弹窗：全历史搜索结果条目 */
+  .hist-hit { border: 1px solid #eee; border-radius: 8px; padding: 6px 10px; margin: 4px 0; cursor: pointer; background: #fafafa; }
+  .hist-hit:hover { border-color: #07c160; background: #f0f7f0; }
+  .hist-hit .hh-meta { font-size: 11px; color: #999; margin-bottom: 2px; }
+  .hist-hit .hh-snippet { font-size: 12px; color: #333; line-height: 1.5; word-break: break-all; }
   /* 长会话增量渲染：加载更早入口 */
   .load-earlier { display: block; margin: 4px auto 16px; border: 1px solid #dcdcdc; background: #fff; color: #888; border-radius: 14px; padding: 5px 14px; font-size: 12px; cursor: pointer; transition: color .15s, border-color .15s; }
   .load-earlier:hover { color: #07c160; border-color: #07c160; }
@@ -306,6 +316,19 @@
     #menuBtn { display: block !important; }
     .msg-body { max-width: 80%; }
   }
+  /* 触屏/小屏增强：更大触控目标、安全区适配、顶栏按钮收纳 */
+  @media (max-width: 760px) {
+    .hdr-right { flex-wrap: wrap; gap: 4px; }
+    .hdr-right .cfg-btn { padding: 4px 8px; font-size: 11px; }
+    #messages { padding: 10px 8px; }
+    .bubble.left, .bubble.right { font-size: 14px; word-break: break-word; }
+    .composer { padding-bottom: calc(8px + env(safe-area-inset-bottom)); }
+    #input { font-size: 16px; } /* 防 iOS 聚焦自动放大 */
+    .jumpBtn { bottom: calc(84px + env(safe-area-inset-bottom)); }
+    #jumpBtn { bottom: calc(84px + env(safe-area-inset-bottom)); }
+    .modal.wide { width: 96vw; max-height: 92vh; }
+    #previewMask .preview-card { width: 96vw; height: 92vh; }
+  }
   #menuBtn { display: none; background: none; border: none; font-size: 18px; cursor: pointer; color: #555; margin-right: 10px; }
 
   /* ---------- 侧栏顶部：单聊/群聊开关 + 任务操作按钮 ---------- */
@@ -441,6 +464,7 @@
         <button class="cfg-btn" id="cardsNavBtn" onclick="openCards()" title="多任务编排 · 卡牌：把任务写成卡牌，Agent 干完一件自动注入下一件">🗂️ 多任务编排</button>
         <span class="runner-tag" id="runnerTag" style="display:none"></span>
         <span class="ver-chip" id="verChip" title="当前版本" style="font-size:11px;color:#999;border:1px solid #e2e2e2;border-radius:10px;padding:2px 8px;white-space:nowrap"></span>
+        <button class="cfg-btn" id="notifyBtn" onclick="toggleSysNotify()" title="系统通知：页面在后台时任务完成弹系统级通知（浏览器授权后生效）">🔔 通知</button>
         <button class="cfg-btn" id="helpBtn" onclick="openHelp()" title="使用帮助">❓ 帮助</button>
       </div>
     </header>
@@ -588,10 +612,16 @@
   <div class="modal wide">
     <h3>聊天历史（主会话）</h3>
     <div class="tip">按时间正序展示全部主会话记录（含已开启新会话前的内容），仅供查阅；消息中的 .md 文件路径可点击预览</div>
+    <input id="histSearch" placeholder="🔍 搜索全部会话消息（含任务/单聊会话，关键词匹配）…" autocomplete="off"
+      style="width:100%;box-sizing:border-box;padding:7px 10px;border:1px solid #e2e2e2;border-radius:8px;font-size:12.5px;margin-bottom:6px">
+    <div id="histUsage" style="font-size:11.5px;color:#888;margin:0 0 6px"></div>
+    <div id="histSearchResult" style="display:none"></div>
     <div id="historyList"></div>
     <div class="modal-actions" style="justify-content:space-between">
-      <div style="display:flex;gap:8px">
+      <div style="display:flex;gap:8px;flex-wrap:wrap">
         <button class="mini-btn" onclick="exportHistory()" title="全部会话（含任务会话）导出为 Markdown 文件">⬇ 导出 sessions.md</button>
+        <button class="mini-btn" onclick="showDataStats()" title="查看数据目录磁盘占用分布">📊 空间占用</button>
+        <button class="mini-btn" onclick="pruneDataNow()" title="手动执行一次滚动清理：过期任务/会话/产出存档等（与每日自动清理同一套规则，默认保留 15 天）">🧹 清理旧数据</button>
         <button class="mini-btn danger" onclick="clearAllHistory()" title="删除全部消息记录、会话产出文件与流转日志（任务列表保留）">🗑 清空全部会话</button>
       </div>
       <button class="primary" onclick="closeHistory()">关闭</button>
@@ -666,7 +696,7 @@
 </div>
 
 <script>
-const PAGE_VERSION = '3.26.0'; // 与服务端 /api/health.version 互检，不一致说明页面缓存过期
+const PAGE_VERSION = '3.31.0'; // 与服务端 /api/health.version 互检，不一致说明页面缓存过期
 const AV_COLORS = ['#5b8def','#07c160','#fa9d3b','#10aeff','#8a6fe8','#fa5151','#e8a33d','#3aa7a3'];
 const PHASE_LABEL = { plan: '调度规划', work: '执行', review: '验收', report: '汇总', talk: '圆桌发言', task: '任务执行' };
 // 职业图标库（智能体配置可选）
@@ -703,7 +733,29 @@ function escAttr(s) { return String(s == null ? '' : s).replace(/&/g,'&amp;').re
 function fmtTime(ts) { const d = new Date(ts); return String(d.getHours()).padStart(2,'0') + ':' + String(d.getMinutes()).padStart(2,'0'); }
 function fmtSched(ts) { const d = new Date(ts); const p = (n) => String(n).padStart(2,'0'); return `${d.getFullYear()}-${p(d.getMonth()+1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`; }
 function fmtSchedNow() { const d = new Date(); const p = (n) => String(n).padStart(2,'0'); return `${d.getFullYear()}${p(d.getMonth()+1)}${p(d.getDate())}-${p(d.getHours())}${p(d.getMinutes())}`; }
-function toast(msg) { const t = document.getElementById('toast'); t.textContent = msg; t.style.display = 'block'; setTimeout(() => t.style.display = 'none', 2200); }
+function toast(msg, ms) { const t = document.getElementById('toast'); t.textContent = msg; t.style.display = 'block'; setTimeout(() => t.style.display = 'none', ms || 2200); }
+
+// ---------- 系统通知开关（浏览器 Notification API，状态记忆在 localStorage） ----------
+function refreshNotifyBtn() {
+  const on = localStorage.getItem('sysNotify') === '1';
+  const b = document.getElementById('notifyBtn');
+  if (b) { b.style.color = on ? '#07c160' : ''; b.style.borderColor = on ? '#07c160' : ''; }
+}
+async function toggleSysNotify() {
+  const on = localStorage.getItem('sysNotify') === '1';
+  if (on) {
+    localStorage.setItem('sysNotify', '0');
+    toast('系统通知已关闭');
+  } else {
+    if (typeof Notification === 'undefined') { toast('当前浏览器不支持系统通知'); return; }
+    let perm = Notification.permission;
+    if (perm !== 'granted') perm = await Notification.requestPermission();
+    if (perm !== 'granted') { toast('浏览器未授权通知，请在地址栏权限设置中允许'); return; }
+    localStorage.setItem('sysNotify', '1');
+    toast('系统通知已开启：页面在后台时任务完成将弹系统通知');
+  }
+  refreshNotifyBtn();
+}
 function colorOf(id) { let h = 0; const s = String(id); for (let i = 0; i < s.length; i++) h = (h * 31 + s.charCodeAt(i)) >>> 0; return AV_COLORS[h % AV_COLORS.length]; }
 // 智能体显示图标：配置的职业图标 > 名称首字
 function agentIcon(agentId, name) {
@@ -761,6 +813,7 @@ async function init() {
     addSys(`⚠ 页面版本（${PAGE_VERSION}）与服务端（${health.version}）不一致：浏览器缓存了旧页面，请按 Ctrl+F5 强制刷新`);
   }
   renderUpdateInfo(health);
+  refreshNotifyBtn();
 
   input.addEventListener('input', handleAtInput);
   input.addEventListener('blur', () => setTimeout(hideAt, 150));
@@ -1554,6 +1607,16 @@ function lastReportText(taskId) {
 
 // 右下角弹窗：显示最终回答部分内容，点击跳回原会话；不处理 3 秒后自动消失（保留绿点）
 function showDoneToast(taskId, title) {
+  // 系统级通知：开关开启且页面在后台时弹系统通知（人不在电脑前也能收到）
+  try {
+    if (localStorage.getItem('sysNotify') === '1' && document.hidden && typeof Notification !== 'undefined' && Notification.permission === 'granted') {
+      const n = new Notification('✅ 任务完成：' + (title || ''), {
+        body: (lastReportText(taskId) || '点击查看结果').slice(0, 120),
+        tag: 'agents-chat-done'
+      });
+      n.onclick = () => { window.focus(); n.close(); };
+    }
+  } catch { /* ignore */ }
   const key = sessKey(taskId || '');
   if (key === curKey() || (chatMode === 'solo' && key === curOcId)) return; // 用户正在看该会话，无需提醒
   markUnread(key);
@@ -2287,9 +2350,75 @@ async function openHistory() {
   }
   document.getElementById('historyMask').classList.add('show');
   el.scrollTop = 0;
+  loadUsageBar();
 }
 function closeHistory() { document.getElementById('historyMask').classList.remove('show'); }
 
+// ---------- 全历史搜索（服务端逐分片匹配，含任务/单聊会话） ----------
+let histSearchTimer = null;
+document.getElementById('histSearch').addEventListener('input', (e) => {
+  clearTimeout(histSearchTimer);
+  const q = e.target.value.trim();
+  const box = document.getElementById('histSearchResult');
+  if (!q) { box.style.display = 'none'; box.innerHTML = ''; return; }
+  histSearchTimer = setTimeout(async () => {
+    try {
+      const data = await api('/api/search?q=' + encodeURIComponent(q) + '&limit=50');
+      const list = data.results || [];
+      box.style.display = 'block';
+      box.innerHTML = list.length
+        ? `<div class="tip" style="margin:0 0 4px">找到 ${list.length} 条匹配${list.length >= 50 ? '（已达上限，可加精确关键词）' : ''}</div>` +
+          list.map(r => {
+            const sess = r.sessionId === '' ? '主会话' : `会话 ${esc(r.sessionId.slice(0, 12))}`;
+            const who = r.role === 'user' ? '👤 我' : esc(r.agentName || 'AI');
+            return `<div class="hist-hit" onclick="jumpToSearchSess('${esc(r.sessionId)}')" title="点击定位该会话">
+              <div class="hh-meta">${esc((r.timestamp || '').replace('T', ' ').slice(0, 16))} · ${sess} · ${who}</div>
+              <div class="hh-snippet">${esc(r.snippet)}</div></div>`;
+          }).join('')
+        : '<div class="tip">没有匹配的消息</div>';
+    } catch { box.innerHTML = '<div class="tip">搜索失败</div>'; box.style.display = 'block'; }
+  }, 300);
+});
+function jumpToSearchSess(sessId) {
+  // 主会话结果留在历史弹窗（消息就在下方）；其余会话提示定位方式
+  if (!sessId) { toast('该消息在主会话中，见下方历史记录'); return; }
+  toast('该消息位于会话 ' + sessId.slice(0, 16) + '…：任务消息在任务列表点击对应任务查看，单聊在左侧会话列表选择');
+}
+
+// ---------- 用量统计与空间管理 ----------
+async function loadUsageBar() {
+  try {
+    const d = await api('/api/usage');
+    const u = d.usage || {};
+    const fmt = (n) => n >= 10000 ? (n / 10000).toFixed(1) + '万' : String(n || 0);
+    document.getElementById('histUsage').textContent =
+      `📊 Token 用量：今日 ${fmt(u.today && u.today.tokens)}（${fmt(u.today && u.today.requests)} 次请求）· 累计 ${fmt(u.total && u.total.tokens)}${(!u.total || !u.total.tokens) ? '（内核输出未携带用量数据时不统计）' : ''}`;
+  } catch { /* ignore */ }
+}
+function fmtSize(bytes) {
+  const b = Number(bytes) || 0;
+  if (b >= 1024 * 1024 * 1024) return (b / 1024 / 1024 / 1024).toFixed(2) + ' GB';
+  if (b >= 1024 * 1024) return (b / 1024 / 1024).toFixed(1) + ' MB';
+  if (b >= 1024) return (b / 1024).toFixed(1) + ' KB';
+  return b + ' B';
+}
+async function showDataStats() {
+  try {
+    const d = await api('/api/data/stats');
+    const s = d.stats || {};
+    toast(`数据目录共 ${fmtSize(s.total)}：消息 ${fmtSize(s.messages)} · 产出存档 ${fmtSize(s.outputs)} · 工作区 ${fmtSize(s.workspace)} · 流转日志 ${fmtSize(s.flow)}`, 5000);
+  } catch { toast('查询失败'); }
+}
+async function pruneDataNow() {
+  if (!confirm('立即执行一次滚动清理？规则与每日自动清理相同：过期已完结任务、过期会话、超期产出存档等（默认保留 15 天，任务列表中的未执行任务不受影响）。')) return;
+  try {
+    const r = await api('/api/data/prune', { method: 'POST' });
+    const s = r.stat || {};
+    toast(`清理完成：任务 ${s.tasks || 0} · 会话 ${s.ocSessions || 0} · 消息 ${s.messages || 0} · 产出目录 ${s.outputs || 0} · 流转日志 ${s.flowEvents || 0}`, 5000);
+    openHistory();
+  } catch { toast('清理失败'); }
+}
+
 // ---------- 历史管理：一键导出 sessions.md / 一键清空全部会话 ----------
 async function exportHistory() {
   try {
@@ -3378,8 +3507,17 @@ function openHelp() {
   </div>
   <div class="help-sec"><h4>🕘 历史与数据管理</h4>
     <ul>
+      <li>「🕘 历史」弹窗顶部可<b>全历史搜索</b>：关键词匹配全部会话消息（含任务/单聊会话），点击结果定位所属会话</li>
+      <li>弹窗内实时显示 <b>Token 用量</b>（今日/累计，内核输出携带用量数据时统计）；「📊 空间占用」查看数据目录分布，「🧹 清理旧数据」手动执行一次滚动清理</li>
       <li>「🕘 历史」弹窗底部：<b>⬇ 导出 sessions.md</b> 把全部会话（含任务会话与单聊会话）导出为一个 Markdown 文件；<b>🗑 清空全部会话</b> 一键删除消息、单聊会话、会话产出文件与流转日志（任务列表保留）</li>
-      <li>全部页面关闭且无任务执行/审批等待时，后台服务空闲约 1 分钟自动退出（需要定时任务到点执行请保持页面打开；<code>.env AGENTS_CHAT_AUTOSTOP=0</code> 可关闭），需要时重新运行 start 即可</li>
+      <li>全部页面关闭且无任务执行/审批等待时，后台服务空闲约 1 分钟自动退出（需要定时任务到点执行请保持页面打开，或运行 <code>agents-chat autostart on</code> 开机自启；<code>.env AGENTS_CHAT_AUTOSTOP=0</code> 可关闭），需要时重新运行 start 即可</li>
+    </ul>
+  </div>
+  <div class="help-sec"><h4>🔔 完成通知</h4>
+    <ul>
+      <li>顶栏「🔔 通知」开启后（需浏览器授权），页面在后台时任务/卡牌完成会弹<b>系统级通知</b>，人不在电脑前也不错过</li>
+      <li>进阶：.env 配置 <code>AGENTS_CHAT_WEBHOOK_URL</code> 可把完成事件转发到钉钉/飞书/自建中转（POST JSON，含标题/状态/摘要）</li>
+      <li>定时任务抗机器重启：命令行 <code>agents-chat autostart on</code> 设置开机自启；停机期间错过的定时任务会在下次启动时自动补跑（控制台有日志说明）</li>
     </ul>
   </div>
   <div class="help-sec"><h4>🛂 协作通道（看板 / 委派 / 审批）</h4>

package/app/public/manifest.json

@@ -0,0 +1,17 @@
+{
+  "name": "Agents Chat",
+  "short_name": "AgentsChat",
+  "description": "多智能体协作聊天与任务编排",
+  "start_url": "/",
+  "display": "standalone",
+  "background_color": "#f5f5f5",
+  "theme_color": "#07c160",
+  "icons": [
+    {
+      "src": "/static/icon.svg",
+      "sizes": "any",
+      "type": "image/svg+xml",
+      "purpose": "any"
+    }
+  ]
+}

package/app/server.js

@@ -2,6 +2,7 @@
 // 启动：node app/server.js [--port 3456]
 const APP_VERSION = require('../package.json').version; // 单源版本：与 package.json 始终一致（页面互检/更新检查共用）
 const { checkLatest, UPDATE_COMMAND } = require('./lib/updatecheck');
+const { notifyDone } = require('./lib/notify');
 const http = require('http');
 const fs = require('fs');
 const path = require('path');
@@ -326,6 +327,11 @@ const server = http.createServer(async (req, res) => {
     serveStatic(res, path.join(PUBLIC_DIR, 'cards.html'));
     return;
   }
+  if (req.method === 'GET' && p === '/manifest.json') {
+    // PWA 清单（添加到主屏幕/手机访问）
+    serveStatic(res, path.join(PUBLIC_DIR, 'manifest.json'));
+    return;
+  }
   if (req.method === 'GET' && p.startsWith('/static/')) {
     const safe = path.normalize(p.slice('/static/'.length)).replace(/^(\.\.[/\\])+/, '');
     serveStatic(res, path.join(PUBLIC_DIR, safe));
@@ -360,6 +366,30 @@ const server = http.createServer(async (req, res) => {
     return;
   }
 
+  // ---------- 历史检索 / 用量 / 空间 ----------
+  if (p === '/api/search' && req.method === 'GET') {
+    const q = String(parsed.query.q || '');
+    const limit = Math.min(200, Math.max(1, Number(parsed.query.limit) || 50));
+    json(res, 200, { success: true, results: store.searchMessages(q, { limit }) });
+    return;
+  }
+  if (p === '/api/usage' && req.method === 'GET') {
+    json(res, 200, { success: true, usage: store.getUsageStats() });
+    return;
+  }
+  if (p === '/api/data/stats' && req.method === 'GET') {
+    json(res, 200, { success: true, stats: store.dataStats(), dataDir: store.DATA_DIR });
+    return;
+  }
+  if (p === '/api/data/prune' && req.method === 'POST') {
+    // 手动清理：与每日自动清理同一套逻辑（已完结任务/过期会话/产出存档等），返回各项清理量
+    const body = await readBody(req);
+    const days = Math.max(1, Number(body.days) || PRUNE_DAYS);
+    const stat = store.pruneOldData(days);
+    json(res, 200, { success: true, days, stat });
+    return;
+  }
+
   if (p === '/api/stop' && req.method === 'POST') {
     // 手动停止：kill 对应作用域的全部子进程；编排循环检测令牌后跳过剩余工作
     const body = await readBody(req);
@@ -656,6 +686,8 @@ const server = http.createServer(async (req, res) => {
       } else {
         await executeTaskBatch(selected, send, myToken);
       }
+      // 群聊批次整体完成通知（单任务通知由 orchestrator 消息流承担，批次级聚合在此）
+      notifyDone({ kind: 'batch', title: `${soloScope ? '单聊' : '群聊'}任务批次（${selected.length} 个）`, status: 'done', snippet: selected.map(t => t.title).join('、') });
     } catch (err) {
       console.error('[tasks/run] 编排异常:', err && (err.stack || err));
       send({ type: 'error', content: `任务编排异常：${err && err.message || err}` });
@@ -1282,6 +1314,10 @@ function shutdown(code) {
   process.exit(code);
 }
 process.on('SIGINT', () => shutdown(0));
+// 兜底：async 路由内的同步异常会以 unhandledRejection 形式出现——记录日志防静默丢错（请求层应自行捕获）
+process.on('unhandledRejection', (err) => {
+  console.error('[unhandledRejection]', err && (err.stack || err));
+});
 process.on('SIGTERM', () => shutdown(0));
 // Windows 关闭控制台窗口（CTRL_CLOSE_EVENT）在 Node 上映射为 SIGHUP，系统给约 5 秒处理宽限：
 // 同步 killTree 足够完成，正在执行的 AI 子进程不再变孤儿
@@ -1353,6 +1389,7 @@ async function executeSoloTaskBatch(selected, send, myToken) {
     if (runner.kind === 'missing') {
       store.updateTask(task.id, { status: 'failed', result: missingHint(runner).slice(0, 2000) });
       send({ type: 'task_done', taskId: task.id, title: task.title, status: 'failed' });
+      notifyDone({ kind: 'task', title: task.title, status: 'failed', snippet: missingHint(runner) });
       return '';
     }
 
@@ -1397,6 +1434,7 @@ async function executeSoloTaskBatch(selected, send, myToken) {
       result: (doneError ? `执行出错：${doneError}` : finalText).slice(0, 2000)
     });
     send({ type: 'task_done', taskId: task.id, title: task.title, status: stopped ? 'pending' : (doneError ? 'failed' : 'done') });
+    notifyDone({ kind: 'task', title: task.title, status: doneError ? 'failed' : 'done', snippet: finalText || doneError });
     return stopped ? '' : sesId;
   };
 
@@ -1430,12 +1468,19 @@ async function executeSoloTaskBatch(selected, send, myToken) {
 // 执行过程照常持久化到对应任务会话，用户打开会话即可查看全过程
 const SCHED_INTERVAL_MS = 15000;
 function startScheduler() {
+  let firstScan = true; // 启动首扫：识别停机期间错过的定时任务并说明补跑
   const timer = setInterval(() => {
     if (runLocks.tasks) return; // 手动批次执行中，下轮再查
     if (store.getSchedEnabled() === false) return; // 用户关闭了定时调度总开关
+    const now = Date.now();
     const due = store.getTasks().filter(t =>
-      t.kind === 'scheduled' && t.status === 'pending' && t.scheduledAt && t.scheduledAt <= Date.now());
-    if (!due.length) return;
+      t.kind === 'scheduled' && t.status === 'pending' && t.scheduledAt && t.scheduledAt <= now);
+    if (!due.length) { firstScan = false; return; }
+    const missed = due.filter(t => now - t.scheduledAt > 60000); // 触发点已过 1 分钟以上 = 停机期间错过
+    if (firstScan && missed.length) {
+      console.log(`[scheduler] 检测到 ${missed.length} 个停机期间错过的定时任务，将立即补跑：${missed.map(t => t.title).join('、')}`);
+    }
+    firstScan = false;
     runLocks.tasks = true;
     const myToken = stopTokens.tasks;
     console.log(`[scheduler] 定时触发 ${due.length} 个任务：${due.map(t => t.title).join('、')}`);

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 = {
@@ -269,6 +275,104 @@ function showVersion() {
   console.log(`agents-chat v${PKG.version}`);
 }
 
+// ---------- 开机自启（定时任务抗重启）----------
+// Windows: HKCU Run 键 + VBS 静默启动（无黑窗闪烁）；exe 形态直接注册 exe 路径
+// macOS:   ~/Library/LaunchAgents/com.agents-chat.plist（登录即拉起）
+// Linux:   crontab @reboot 行
+const AUTOSTART_KEY = 'AgentsChat';
+function autostartTarget() {
+  // 单文件 exe：直接跑 exe（已无窗口）；npm 形态：VBS 静默执行 agents-chat start
+  if (process.env.AGENTS_CHAT_STANDALONE === '1' || process.versions.bun) {
+    return { kind: 'exe', cmd: `"${process.execPath}"` };
+  }
+  return { kind: 'npm', cmd: null };
+}
+function autostartOn() {
+  const t = autostartTarget();
+  const home = os.homedir();
+  if (process.platform === 'win32') {
+    const run = t.kind === 'exe'
+      ? t.cmd
+      : `wscript.exe "${path.join(home, '.agents-chat', 'autostart.vbs')}"`;
+    if (t.kind === 'npm') {
+      fs.mkdirSync(path.join(home, '.agents-chat'), { recursive: true });
+      // 0 = 隐藏窗口；npm bin 已在用户 PATH（npm 安装时配置）， explorer 启动的进程可继承
+      fs.writeFileSync(path.join(home, '.agents-chat', 'autostart.vbs'),
+        `CreateObject("Wscript.Shell").Run "cmd /c agents-chat start", 0, False\r\n`);
+    }
+    execSync(`reg add "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run" /v ${AUTOSTART_KEY} /t REG_SZ /d "${run}" /f`, { stdio: 'ignore' });
+    console.log('✓ 开机自启已开启（当前用户级，无需管理员）');
+  } else if (process.platform === 'darwin') {
+    const plist = path.join(home, 'Library', 'LaunchAgents', 'com.agents-chat.plist');
+    fs.mkdirSync(path.dirname(plist), { recursive: true });
+    const exe = t.kind === 'exe' ? process.execPath : process.execPath;
+    const arg = t.kind === 'exe' ? [] : [path.join(__dirname, '..', 'app', 'server.js'), '--port', String(PORT)];
+    const envData = `  <key>EnvironmentVariables</key>\n  <dict><key>AGENTS_CHAT_DATA</key><string>${DATA_DIR}</string></dict>`;
+    fs.writeFileSync(plist, `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0"><dict>
+  <key>Label</key><string>com.agents-chat</string>
+  <key>ProgramArguments</key>
+  <array><string>${exe}</string>${arg.map(a => `<string>${a}</string>`).join('')}</array>
+  ${envData}
+  <key>RunAtLoad</key><true/>
+  <key>StandardOutPath</key><string>${path.join(home, '.agents-chat', 'autostart.log')}</string>
+  <key>StandardErrorPath</key><string>${path.join(home, '.agents-chat', 'autostart.log')}</string>
+</dict></plist>`);
+    try { execSync(`launchctl unload "${plist}" 2>/dev/null; launchctl load "${plist}"`); } catch { /* 下次登录生效 */ }
+    console.log('✓ 开机自启已开启（LaunchAgent，登录即启动）');
+  } else {
+    // Linux: crontab @reboot
+    let cron = '';
+    try { cron = execSync('crontab -l', { stdio: ['pipe', 'pipe', 'ignore'] }).toString(); } catch { /* 无 crontab */ }
+    const line = t.kind === 'exe'
+      ? `@reboot ${process.execPath}`
+      : `@reboot ${process.execPath} ${path.join(__dirname, '..', 'app', 'server.js')} --port ${PORT}`;
+    if (cron.includes(AUTOSTART_KEY)) {
+      cron = cron.split('\n').filter(l => l && !l.includes(AUTOSTART_KEY)).join('\n');
+    }
+    cron = (cron ? cron.trimEnd() + '\n' : '') + `${line} # ${AUTOSTART_KEY} env AGENTS_CHAT_DATA=${DATA_DIR}`;
+    // @reboot 行无法带 env 前缀于部分 cron 实现，数据目录路径直接写进 server 启动参数不可行时靠默认 ~/.agents-chat
+    execSync('crontab -', { input: cron.replace(/ # [^\n]*/, '') + '\n' });
+    console.log('✓ 开机自启已开启（crontab @reboot，数据目录 ~/.agents-chat）');
+  }
+  console.log('关闭方式: agents-chat autostart off');
+}
+function autostartOff() {
+  try {
+    if (process.platform === 'win32') {
+      execSync(`reg delete "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run" /v ${AUTOSTART_KEY} /f`, { stdio: 'ignore' });
+    } else if (process.platform === 'darwin') {
+      const plist = path.join(os.homedir(), 'Library', 'LaunchAgents', 'com.agents-chat.plist');
+      try { execSync(`launchctl unload "${plist}"`); } catch { /* ignore */ }
+      fs.unlinkSync(plist);
+    } else {
+      let cron = '';
+      try { cron = execSync('crontab -l', { stdio: ['pipe', 'pipe', 'ignore'] }).toString(); } catch { }
+      const kept = cron.split('\n').filter(l => l && !(l.includes('@reboot') && (l.includes('app/server.js') || l.includes('agents-chat'))));
+      execSync('crontab -', { input: kept.join('\n') + (kept.length ? '\n' : '') });
+    }
+    console.log('✓ 开机自启已关闭');
+  } catch (err) {
+    console.error('关闭失败:', err.message);
+  }
+}
+function autostartStatus() {
+  try {
+    if (process.platform === 'win32') {
+      execSync(`reg query "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run" /v ${AUTOSTART_KEY}`, { stdio: 'pipe' });
+    } else if (process.platform === 'darwin') {
+      fs.accessSync(path.join(os.homedir(), 'Library', 'LaunchAgents', 'com.agents-chat.plist'));
+    } else {
+      const cron = execSync('crontab -l', { stdio: ['pipe', 'pipe', 'ignore'] }).toString();
+      if (!/@reboot.*agents-chat|@reboot.*app\/server\.js/.test(cron)) throw new Error('not set');
+    }
+    console.log('开机自启: 已开启');
+  } catch {
+    console.log('开机自启: 未开启（agents-chat autostart on 开启）');
+  }
+}
+
 // 主逻辑
 const command = process.argv[2] || 'start';
 
@@ -295,6 +399,12 @@ switch (command) {
   case '--version':
     showVersion();
     break;
+  case 'autostart':
+    if (process.argv[3] === 'off') autostartOff();
+    else if (process.argv[3] === 'status' || !process.argv[3]) autostartStatus();
+    else if (process.argv[3] === 'on') autostartOn();
+    else { console.error('用法: agents-chat autostart on|off|status'); process.exit(1); }
+    break;
   case 'help':
   case '--help':
   case '-h':
@@ -309,6 +419,9 @@ Agents Chat CLI v${PKG.version}
   agents-chat open       仅打开浏览器
   agents-chat update     检查并一键升级到 npm 最新版
   agents-chat version    查看当前版本
+  agents-chat autostart on|off|status
+                         开机自启管理（定时任务抗机器重启，Windows 用户级注册表/
+                         macOS LaunchAgent/Linux crontab）
 
 环境变量:
   AGENTS_CHAT_PORT     端口号 (默认: 3456)

package/package.json

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

package/scripts/build-exe.js

@@ -0,0 +1,85 @@
+#!/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/SVG → JSON 字符串常量，杜绝转义问题）
+const assets = {};
+for (const f of fs.readdirSync(PUB)) {
+  if (/\.(html|json|svg)$/.test(f)) 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);
+}
+
+// 4. 生成校验清单（Release 附上，供核对下载完整性；exe 未签名场景尤为重要）
+const { createHash } = require('crypto');
+const lines = [];
+for (const f of fs.readdirSync(DIST).sort()) {
+  const fp = path.join(DIST, f);
+  const h = createHash('sha256').update(fs.readFileSync(fp)).digest('hex');
+  lines.push(`${h}  ${f}`);
+}
+fs.writeFileSync(path.join(DIST, 'checksums.txt'), lines.join('\n') + '\n');
+console.log('校验清单: dist/checksums.txt');
+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);
+}