@iamsamyiok/agents-chat 3.24.0 → 3.26.0

package/app/lib/store.js

@@ -508,6 +508,13 @@ function getMessages(taskId) {
   return Array.isArray(list) ? list : [];
 }
 
+// 单会话消息上限：防止定时任务长跑数月将会话分片膨胀到读写不可承受
+// 默认 500 条，AGENTS_CHAT_MSG_LIMIT 可调（0 = 不限制）；主会话豁免（已有 epoch + 过期清理机制）
+const MSG_LIMIT = (() => {
+  const n = Number(process.env.AGENTS_CHAT_MSG_LIMIT);
+  return Number.isFinite(n) && n >= 0 ? Math.floor(n) : 500;
+})();
+
 function addMessage(msg) {
   migrateLegacyMessages();
   fs.mkdirSync(MSG_DIR, { recursive: true });
@@ -529,9 +536,38 @@ function addMessage(msg) {
     timestamp: msg.timestamp || new Date().toISOString()
   };
   msgs.push(rec);
+  // 滚动清理：超上限裁掉最旧消息，开头留一条系统标记说明去向（标记本身也会随时间被裁）
+  if (key !== '' && MSG_LIMIT > 0 && msgs.length > MSG_LIMIT) {
+    const kept = msgs.slice(msgs.length - MSG_LIMIT);
+    const first = kept[0];
+    if (!(first && first.role === 'sys' && /已按上限自动清理/.test(String(first.content || '')))) {
+      kept.unshift({ role: 'sys', content: `（已达单会话消息上限 ${MSG_LIMIT} 条，更早的过程消息已自动滚动清理，任务结果以最终结果区为准）`, taskId: key, timestamp: new Date().toISOString() });
+    }
+    msgs.length = 0;
+    msgs.push(...kept);
+  }
   writeJson(msgShardPath(key), msgs);
 }
 
+// 按会话统计消息数（逐分片累加，不合并大数组：统计/导出场景低内存）
+function countMessagesByTask() {
+  migrateLegacyMessages();
+  const counts = {};
+  let main = 0;
+  let files = [];
+  try { files = fs.readdirSync(MSG_DIR); } catch { return { counts, main }; }
+  for (const name of files) {
+    if (!name.endsWith('.json') || name.startsWith('.')) continue;
+    let list;
+    try { list = JSON.parse(fs.readFileSync(path.join(MSG_DIR, name), 'utf8')); } catch { continue; }
+    if (!Array.isArray(list) || !list.length) continue;
+    const tid = list[0].taskId || '';
+    if (tid) counts[tid] = (counts[tid] || 0) + list.length;
+    else main += list.length;
+  }
+  return { counts, main };
+}
+
 function clearMessages() {
   migrateLegacyMessages();
   // 清空全部会话消息：删除所有分片，主会话分片重置为空数组
@@ -754,6 +790,7 @@ module.exports = {
   getMessages,
   addMessage,
   clearMessages,
+  countMessagesByTask,
   addFlowEvent,
   getFlow,
   listFlowRuns,

package/app/lib/updatecheck.js

@@ -0,0 +1,43 @@
+// npm 最新版本检查：供启动横幅、/api/health、CLI update/status 共用
+// Node 18+ 自带全局 fetch；3 秒超时 + 1 小时结果缓存，失败静默（离线/内网不影响启动）
+
+const PKG = require('../../package.json');
+const REGISTRY_URL = `https://registry.npmjs.org/${PKG.name}/latest`;
+
+let cached = { at: 0, latest: null }; // 缓存上次查询结果（1 小时内复用）
+
+// 简化 semver 比较：a > b 返回 true（仅支持 x.y.z 数字段， prerelease 忽略比较）
+function semverGt(a, b) {
+  const pa = String(a || '').split('-')[0].split('.').map(n => parseInt(n, 10) || 0);
+  const pb = String(b || '').split('-')[0].split('.').map(n => parseInt(n, 10) || 0);
+  for (let i = 0; i < 3; i++) {
+    if ((pa[i] || 0) !== (pb[i] || 0)) return (pa[i] || 0) > (pb[i] || 0);
+  }
+  return false;
+}
+
+// 查询 npm registry 最新版本；force=true 跳过缓存（CLI update 用）
+async function checkLatest({ force = false } = {}) {
+  const now = Date.now();
+  if (!force && cached.latest && now - cached.at < 3600 * 1000) {
+    return { latest: cached.latest, updateAvailable: semverGt(cached.latest, PKG.version) };
+  }
+  try {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), 3000);
+    const res = await fetch(REGISTRY_URL, { signal: ctrl.signal, headers: { 'accept': 'application/json' } });
+    clearTimeout(timer);
+    if (!res.ok) return null;
+    const data = await res.json();
+    const latest = String(data.version || '');
+    if (!latest) return null;
+    cached = { at: now, latest };
+    return { latest, updateAvailable: semverGt(latest, PKG.version) };
+  } catch {
+    return null; // 网络不可达/超时：静默，不阻塞调用方
+  }
+}
+
+const UPDATE_COMMAND = `npm install -g ${PKG.name}@latest`;
+
+module.exports = { semverGt, checkLatest, UPDATE_COMMAND, currentVersion: PKG.version };

package/app/public/cards.html

@@ -190,6 +190,18 @@
   /* 空看板引导 */
   .board-guide{grid-column:1/-1;text-align:center;padding:40px 10px;color:var(--dim)}
   .board-guide .bg-actions{display:flex;gap:10px;justify-content:center;margin-top:14px}
+  /* 使用帮助 */
+  .help-sec{margin:0 0 14px}
+  .help-sec h4{margin:0 0 6px;font-size:13.5px;color:var(--acc)}
+  .help-sec ul,.help-sec ol{margin:0;padding-left:20px}
+  .help-sec li{margin:4px 0;font-size:12.5px;line-height:1.65;color:#333}
+  .help-sec code{background:var(--bg2);padding:1px 5px;border-radius:4px;font-size:11.5px;color:var(--acc)}
+  .help-sec p{font-size:12.5px;line-height:1.65;color:#333;margin:6px 0}
+  /* 版本徽标与更新提示条 */
+  .ver-chip{font-size:11px;color:var(--dim);border:1px solid var(--line);border-radius:10px;padding:2px 8px;white-space:nowrap}
+  .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}
 </style>
 </head>
 <body>
@@ -216,6 +228,8 @@
   <button class="btn primary" id="btnRun" title="按依赖与优先级调度全部待执行任务">▶ 开始编排</button>
   <button class="btn danger" id="btnStop" disabled title="停止编排：进行中的任务复位为待执行（不影响追加聊天），未开始的任务保留">⏹ 停止</button>
   <button class="btn" id="btnClear">清空</button>
+  <button class="btn" id="btnHelp" title="多任务编排使用帮助">❓ 帮助</button>
+  <span class="ver-chip" id="verChip" title="当前版本"></span>
 </header>
 
 <div class="kernel-banner" id="kernelBanner"></div>
@@ -316,6 +330,14 @@
 </div>
 
 <!-- 垃圾桶 -->
+<!-- 使用帮助 -->
+<div class="mask" id="helpMask">
+  <div class="modal" style="width:min(720px,94vw);max-height:86vh;overflow-y:auto">
+    <h3>❓ 多任务编排使用帮助</h3>
+    <div id="helpBody"></div>
+    <div class="foot"><button class="btn primary" id="helpClose">关闭</button></div>
+  </div>
+</div>
 <div class="mask" id="trashMask">
   <div class="modal">
     <h3>🗑️ 垃圾桶 <span style="font-size:12px;color:var(--dim)">（保留 30 天内删除的任务快照）</span></h3>
@@ -360,6 +382,7 @@ async function loadCards(){
   if(data.config) $('#wsInput').value = data.config.workspace || '';
   if(data.maxParallel) $('#parallelSel').value = String(data.maxParallel);
   renderKernelBanner();
+  renderUpdateInfo(data);
   render();
   renderGraph();
   loadTrashCount();
@@ -753,7 +776,8 @@ async function openDetail(id){
   const log=$('#dLog'); log.innerHTML=''; TEXT_PARTS.clear();
   if(!msgs.length) log.innerHTML='<span class="empty">暂无过程记录</span>';
   for(const m of msgs){
-    if(m.role==='user') appendLog(log,'👤 '+m.content,'msg-user');
+    if(m.role==='sys') appendLog(log,'ℹ '+m.content,'msg-tool');
+    else if(m.role==='user') appendLog(log,'👤 '+m.content,'msg-user');
     else if(m.phase==='archive') appendLog(log,'📦 '+m.content,'msg-tool');
     else if(m.phase==='system') appendLog(log,'⚠ '+m.content,'msg-err');
     else if(/工具|执行完成/.test(m.content||'')) appendLog(log,'🔧 '+m.content,'msg-tool');
@@ -929,6 +953,83 @@ async function openTrash(){
 }
 $('#trashFab').onclick=openTrash;
 $('#trashClose').onclick=()=>$('#trashMask').classList.remove('show');
+
+// ---------- 使用帮助 ----------
+function openHelp(){
+  $('#helpBody').innerHTML = `
+  <div class="help-sec"><h4>🗂 这是什么</h4>
+    <p>把要做的事写成一张张「任务卡牌」，程序按<b>依赖关系与优先级</b>自动调度 AI 执行：上游完成才启动下游，无依赖的任务并行跑。适合批量任务、流水线作业（翻译→润色→排版）与多分支并行调研。</p>
+    <p>与群聊的关系：群聊是「对话式」由管家现场拆解调度；本页是「清单式」由你预先定义好每张卡，执行过程可暂停、追问、重跑。</p>
+  </div>
+  <div class="help-sec"><h4>🚀 快速开始（三步）</h4>
+    <ol>
+      <li>「＋ 新建任务」：写标题与任务内容（描述越具体越好，支持 Markdown）</li>
+      <li>（可选）在表单里选「依赖任务」：被依赖的卡完成后本卡才执行</li>
+      <li>「▶ 开始编排」：按依赖拓扑 + 优先级自动调度全部待执行卡牌</li>
+    </ol>
+  </div>
+  <div class="help-sec"><h4>⚙ 三种执行模式（新建任务表单）</h4>
+    <ul>
+      <li><b>新进程（new）</b>：独立会话执行，互不影响——默认</li>
+      <li><b>同会话续聊（continue）</b>：接续某张卡（续聊链首）的会话继续，AI 记得之前的成果，适合「初稿→修改→定稿」链</li>
+      <li><b>并行独立进程（parallel）</b>：与前后卡同时开跑，适合批量同类任务（同时查 5 个城市天气）</li>
+    </ul>
+  </div>
+  <div class="help-sec"><h4>🔀 依赖、优先级与并行度</h4>
+    <ul>
+      <li><b>依赖任务</b>可多选：全部完成后本卡才可执行（失败/跳过的依赖会阻断）</li>
+      <li><b>优先级</b>数字越小越先执行；拖拽看板卡到新位置会按新顺序自动重写优先级</li>
+      <li>顶栏 <b>⚡ 并行</b>（1-8）：同时执行的最大任务数，改完即时生效</li>
+      <li>左下角「▶ 依赖图」可视化全部依赖关系，可放大查看</li>
+    </ul>
+  </div>
+  <div class="help-sec"><h4>📌 看板四列</h4>
+    <ul>
+      <li>待执行 → 执行中 → 完成 / 失败；卡牌角标显示该卡过程消息条数</li>
+      <li>失败列的「↻ 全部重跑」把失败卡重置为待执行并立即重新编排</li>
+      <li>顶栏搜索框按标题/内容即时过滤看板；统计条实时显示总数与完成率</li>
+      <li>删除的卡进入回收站，可随时恢复（清空需二次确认）</li>
+    </ul>
+  </div>
+  <div class="help-sec"><h4>💬 追问（完成后继续聊）</h4>
+    <ul>
+      <li>点开已完成的卡，详情页底部可输入追加消息：同一会话继续对话（让它改改措辞、补个章节都行）</li>
+      <li>追问期间不影响其他卡牌执行；追问结果计入该卡日志</li>
+    </ul>
+  </div>
+  <div class="help-sec"><h4>📄 详情、日志与导出</h4>
+    <ul>
+      <li>点任意卡看执行过程（实时滚动，含工具调用）、最终结果与失败原因</li>
+      <li>「⬇ 导出」把该卡导出为 Markdown（元信息 + 过程 + 结果），适合汇报存档</li>
+      <li>「🗑 清空」只清看板卡牌，群聊/单聊数据不受影响</li>
+    </ul>
+  </div>
+  <div class="help-sec"><h4>📁 工作区与内核</h4>
+    <ul>
+      <li>顶栏「工作文件夹」：选定后 Agent 在该目录读写相关文件（写代码、改文档直接落到你指定的目录），可选</li>
+      <li>执行内核与群聊共用同一套（opencode / Claude Code / Codex / pi），在群聊页「⚙ 智能体配置」里切换</li>
+      <li>头部徽标显示当前内核；未检测到内核时顶部横幅会给出安装指引</li>
+    </ul>
+  </div>`;
+  $('#helpMask').classList.add('show');
+}
+$('#btnHelp').onclick=openHelp;
+$('#helpClose').onclick=()=>$('#helpMask').classList.remove('show');
+$('#helpMask').addEventListener('click',e=>{ if(e.target.id==='helpMask') e.target.classList.remove('show'); });
+
+// ---------- 版本徽标与更新提示 ----------
+function renderUpdateInfo(data){
+  if(data.version) $('#verChip').textContent='v'+data.version;
+  if(!data.updateAvailable) return;
+  if(document.getElementById('updateBar')) return;
+  const bar=document.createElement('div');
+  bar.id='updateBar'; bar.className='update-bar';
+  bar.innerHTML='📦 发现新版本 <b>v'+esc(data.latestVersion)+'</b>（当前 v'+esc(data.version)+'）：终端运行 <code>agents-chat update</code> 一键升级，或执行 <code>'+esc(data.updateCommand)+'</code>'
+    +' <button id="updateCopy">复制升级命令</button>';
+  document.body.prepend(bar);
+  document.body.style.paddingTop='34px';
+  $('#updateCopy').onclick=()=>copyText(data.updateCommand||('npm install -g @iamsamyiok/agents-chat@latest'));
+}
 $('#trashEmpty').onclick=async()=>{ if(!confirm('确认清空垃圾桶？所有快照及其过程日志将被永久删除，不可恢复。'))return; const r=await post('/api/cards/trash/empty'); toast('已清空 '+r.cleared+' 项'); await loadCards(); };
 
 // ---- 进程状态条（PID + 工作状态，SSE 事件驱动 + 2s 轮询兜底） ----

package/app/public/index.html

@@ -84,6 +84,9 @@
   #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; }
+  /* 长会话增量渲染：加载更早入口 */
+  .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; }
   .approval-card { max-width: 480px; margin: 10px auto; background: #fff8e6; border: 1px solid #e8a33d; border-radius: 10px; padding: 10px 14px; text-align: left; }
   .approval-card .ap-title { font-weight: 600; font-size: 13px; color: #8a5a00; margin-bottom: 4px; }
   .approval-card .ap-label { font-size: 12px; color: #555; margin-bottom: 8px; word-break: break-all; }
@@ -437,6 +440,7 @@
         <button class="cfg-btn" id="agentsCfgBtn" onclick="openAgents()">⚙ 智能体配置</button>
         <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="helpBtn" onclick="openHelp()" title="使用帮助">❓ 帮助</button>
       </div>
     </header>
@@ -662,7 +666,7 @@
 </div>
 
 <script>
-const PAGE_VERSION = '3.20.0'; // 与服务端 /api/health.version 互检，不一致说明页面缓存过期
+const PAGE_VERSION = '3.26.0'; // 与服务端 /api/health.version 互检，不一致说明页面缓存过期
 const AV_COLORS = ['#5b8def','#07c160','#fa9d3b','#10aeff','#8a6fe8','#fa5151','#e8a33d','#3aa7a3'];
 const PHASE_LABEL = { plan: '调度规划', work: '执行', review: '验收', report: '汇总', talk: '圆桌发言', task: '任务执行' };
 // 职业图标库（智能体配置可选）
@@ -756,6 +760,7 @@ async function init() {
   if (health.version && health.version !== PAGE_VERSION) {
     addSys(`⚠ 页面版本（${PAGE_VERSION}）与服务端（${health.version}）不一致：浏览器缓存了旧页面，请按 Ctrl+F5 强制刷新`);
   }
+  renderUpdateInfo(health);
 
   input.addEventListener('input', handleAtInput);
   input.addEventListener('blur', () => setTimeout(hideAt, 150));
@@ -960,9 +965,36 @@ function soloRenderMessages() {
     return;
   }
   box.innerHTML = '';
-  for (const m of getSess(curOcId)) box.appendChild(soloMsgNode(m));
+  const all = getSess(curOcId);
+  soloShownFrom = Math.max(0, all.length - RENDER_BATCH);
+  if (soloShownFrom > 0) box.appendChild(makeLoadEarlierBtn(loadEarlierSolo));
+  for (let i = soloShownFrom; i < all.length; i++) {
+    const n = soloMsgNode(all[i]);
+    all[i]._dom = n;
+    box.appendChild(n);
+  }
   soloScroll();
 }
+function loadEarlierSolo() {
+  const box = document.getElementById('soloMessages');
+  const all = getSess(curOcId);
+  // 单聊消息节点构造器不同，这里专用批次回填
+  const fromIdx = soloShownFrom;
+  if (fromIdx <= 0) return;
+  const prevHeight = box.scrollHeight, prevTop = box.scrollTop;
+  const from = Math.max(0, fromIdx - RENDER_BATCH);
+  const frag = document.createDocumentFragment();
+  const oldBtn = box.querySelector('.load-earlier'); if (oldBtn) oldBtn.remove();
+  if (from > 0) frag.appendChild(makeLoadEarlierBtn(loadEarlierSolo));
+  for (let i = from; i < fromIdx; i++) {
+    const n = soloMsgNode(all[i]);
+    all[i]._dom = n;
+    frag.appendChild(n);
+  }
+  box.insertBefore(frag, box.firstChild);
+  box.scrollTop = prevTop + (box.scrollHeight - prevHeight);
+  soloShownFrom = from;
+}
 
 function pushSoloMsg(key, m) {
   getSess(key).push(m);
@@ -1795,15 +1827,52 @@ function msgNode(m) {
 }
 
 // 全量重绘当前会话（切换会话 / 载入历史时）
+// ---------- 长会话增量渲染：初始只渲染最近 RENDER_BATCH 条，更早的按需加载 ----------
+// 超长会话（数千条）全量渲染会拖慢浏览器；批次化后 DOM 数量恒定，加载更早时保持视口不跳动
+const RENDER_BATCH = 100;
+function makeLoadEarlierBtn(onClick) {
+  const b = document.createElement('button');
+  b.className = 'load-earlier';
+  b.textContent = '加载更早的消息';
+  b.onclick = onClick;
+  return b;
+}
+function loadEarlierInto(box, all, fromIdx, onClick) {
+  if (fromIdx <= 0) return 0;
+  const prevHeight = box.scrollHeight, prevTop = box.scrollTop;
+  const from = Math.max(0, fromIdx - RENDER_BATCH);
+  const frag = document.createDocumentFragment();
+  const oldBtn = box.querySelector('.load-earlier'); if (oldBtn) oldBtn.remove();
+  if (from > 0) frag.appendChild(makeLoadEarlierBtn(onClick));
+  for (let i = from; i < fromIdx; i++) {
+    const node = msgNode(all[i]);
+    all[i]._dom = node;
+    frag.appendChild(node);
+    finalizeMsgLinks(all[i]);
+  }
+  box.insertBefore(frag, box.firstChild);
+  box.scrollTop = prevTop + (box.scrollHeight - prevHeight); // 视口停在原消息处
+  return from;
+}
+let mainShownFrom = 0; // 主聊天区已渲染起始下标
+let soloShownFrom = 0; // 单聊区已渲染起始下标
+function loadEarlierMain() {
+  const box = document.getElementById('messages');
+  mainShownFrom = loadEarlierInto(box, getSess(curKey()), mainShownFrom, loadEarlierMain);
+}
+
 function renderMessages() {
   const box = document.getElementById('messages');
   box.classList.add('bulk'); // 批量重建：抑制逐条入场动画
   box.innerHTML = '';
-  for (const m of getSess(curKey())) {
-    const node = msgNode(m);
-    m._dom = node;
+  const all = getSess(curKey());
+  mainShownFrom = Math.max(0, all.length - RENDER_BATCH);
+  if (mainShownFrom > 0) box.appendChild(makeLoadEarlierBtn(loadEarlierMain));
+  for (let i = mainShownFrom; i < all.length; i++) {
+    const node = msgNode(all[i]);
+    all[i]._dom = node;
     box.appendChild(node);
-    finalizeMsgLinks(m); // 定稿消息中的 .md 路径变成可点击预览链接
+    finalizeMsgLinks(all[i]); // 定稿消息中的 .md 路径变成可点击预览链接
   }
   scrollBottom();
   requestAnimationFrame(() => requestAnimationFrame(() => box.classList.remove('bulk')));
@@ -3182,8 +3251,31 @@ function openCards() {
   window.open('/cards', '_blank');
 }
 
+// 版本徽标与更新提示条（health 下发；无新版静默）
+function renderUpdateInfo(health) {
+  if (!health) return;
+  const chip = document.getElementById('verChip');
+  if (chip && health.version) chip.textContent = 'v' + health.version;
+  if (!health.updateAvailable || document.getElementById('updateBar')) return;
+  const bar = document.createElement('div');
+  bar.id = 'updateBar';
+  bar.style.cssText = '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';
+  bar.innerHTML = `📦 发现新版本 <b>v${esc(health.latestVersion)}</b>（当前 v${esc(health.version)}）：终端运行 <code>agents-chat update</code> 一键升级，或执行 <code>${esc(health.updateCommand)}</code> <button id="updateCopy" style="border:1px solid #d8b94a;background:#fff;border-radius:5px;padding:2px 10px;font-size:12px;cursor:pointer;color:#614700">复制升级命令</button>`;
+  document.body.prepend(bar);
+  document.body.style.paddingTop = '34px';
+  document.getElementById('updateCopy').onclick = () => copyText(health.updateCommand || 'npm install -g @iamsamyiok/agents-chat@latest');
+}
+
 function openHelp() {
   document.getElementById('helpBody').innerHTML = kernelBanner() + `
+  <div class="help-sec"><h4>🧭 三种使用模式（先选对界面）</h4>
+    <ul>
+      <li><b>👥 群聊</b>（本页默认）：一句话发给整个团队——管家理解需求、拆解任务、调度子智能体协作完成；也可以 <code>@</code> 点名。适合不确定怎么拆、需要 AI 自己规划的事</li>
+      <li><b>👤 单聊</b>（左上角开关切换）：与一个 AI 一对一连续对话，像用普通 AI 助手；同一会话多轮续聊，顶部可选默认模型。适合问答、写作、改代码这类单人事务</li>
+      <li><b>🗂️ 多任务编排</b>（顶栏按钮进入）：把任务写成卡牌清单，按依赖与优先级自动批量执行。适合一次布置一批任务、流水线作业。编排在独立页面，有专属帮助（页面右上角 ❓）</li>
+    </ul>
+    <p>三者数据互通（同一数据目录、同一套内核），随时切换界面，互不干扰。</p>
+  </div>
   <div class="help-sec"><h4>🚀 快速开始</h4>
     <ol>
       <li>本机安装任一执行内核并登录模型（模型与密钥由内核自己管理，本程序不做任何 API 配置）：<br>

package/app/server.js

@@ -1,6 +1,7 @@
 // Agents Chat Portable - 零依赖 HTTP 服务
 // 启动：node app/server.js [--port 3456]
-const APP_VERSION = '3.20.0'; // 页面与服务端版本互检，不一致提示强刷
+const APP_VERSION = require('../package.json').version; // 单源版本：与 package.json 始终一致（页面互检/更新检查共用）
+const { checkLatest, UPDATE_COMMAND } = require('./lib/updatecheck');
 const http = require('http');
 const fs = require('fs');
 const path = require('path');
@@ -16,7 +17,14 @@ loadEnv(path.join(ROOT_DIR, '.env'));
 const LOG_DIR = process.env.AGENTS_CHAT_DATA || path.join(ROOT_DIR, '.data');
 try { fs.mkdirSync(LOG_DIR, { recursive: true }); } catch { /* ignore */ }
 const LOG_PATH = path.join(LOG_DIR, 'server.log');
-try { fs.writeFileSync(LOG_PATH, `=== Agents Chat started ${new Date().toISOString()} ===\n`); } catch { /* ignore */ }
+const LOG_MAX_BYTES = 5 * 1024 * 1024; // 单文件 5MB 滚动：常驻/定时任务长跑不无限增长
+function logRotateIfNeeded() {
+  try {
+    const st = fs.statSync(LOG_PATH);
+    if (st.size > LOG_MAX_BYTES) fs.renameSync(LOG_PATH, LOG_PATH + '.1'); // 保留一代，旧的 .1 被覆盖
+  } catch { /* 无文件 */ }
+}
+try { logRotateIfNeeded(); fs.writeFileSync(LOG_PATH, `=== Agents Chat started ${new Date().toISOString()} ===\n`); } catch { /* ignore */ }
 function teeWrite(args) {
   try { fs.appendFileSync(LOG_PATH, args.map(a => typeof a === 'string' ? a : JSON.stringify(a)).join(' ') + '\n'); } catch { /* ignore */ }
 }
@@ -123,12 +131,19 @@ function sse(req, res) {
     Connection: 'keep-alive'
   });
   sseConns++;
+  // 背压保护：慢客户端的写缓冲积压超 1MB 时主动断开（防内存无限堆积），客户端重连后经 init 补拉状态
   const send = (obj) => {
-    try { res.write(`data: ${JSON.stringify(obj)}\n\n`); } catch { /* closed */ }
+    try {
+      if (res.writableLength > 1024 * 1024) { try { res.destroy(); } catch { /* ignore */ } return; }
+      res.write(`data: ${JSON.stringify(obj)}\n\n`);
+    } catch { /* closed */ }
   };
   // 心跳防止代理断开
   const hb = setInterval(() => {
-    try { res.write(': hb\n\n'); } catch { clearInterval(hb); }
+    try {
+      if (res.writableLength > 1024 * 1024) { res.destroy(); clearInterval(hb); return; }
+      res.write(': hb\n\n');
+    } catch { clearInterval(hb); }
   }, 15000);
   let closed = false;
   const onClose = () => {
@@ -288,9 +303,14 @@ const server = http.createServer(async (req, res) => {
     const { resolveRunner, detectKernels } = require('./lib/agent');
     const runner = resolveRunner();
     const kernels = detectKernels();
+    // 更新检查（1 小时缓存，失败静默返回 null 字段）
+    const upd = await checkLatest().catch(() => null);
     json(res, 200, {
       success: true,
       version: APP_VERSION,
+      latestVersion: upd ? upd.latest : '',
+      updateAvailable: upd ? upd.updateAvailable : false,
+      updateCommand: upd && upd.updateAvailable ? UPDATE_COMMAND : '',
       runner: runner.kind,
       kernelLabel: runner.kernel ? runner.kernel.label : '',
       kernelCmd: runner.cmd || '',
@@ -871,7 +891,8 @@ const server = http.createServer(async (req, res) => {
 
   // ---------- 历史管理：一键清空全部会话 / 导出 sessions.md ----------
   if (p === '/api/history/clear' && req.method === 'POST') {
-    const msgCount = store.getMessages().length;
+    const msgStat = store.countMessagesByTask();
+    const msgCount = msgStat.main + Object.values(msgStat.counts).reduce((a, b) => a + b, 0);
     let outDirs = 0;
     store.clearMessages();
     // 单聊会话记录一并清空（消息已清，保留空会话列表无意义）
@@ -891,18 +912,20 @@ const server = http.createServer(async (req, res) => {
   }
 
   if (p === '/api/history/export' && req.method === 'GET') {
-    const msgs = store.getMessages();
+    // 统计与头部：逐分片计数（低内存）；正文按会话逐段拼接（导出为显式用户动作）
+    const stat = store.countMessagesByTask();
     const tasksAll = store.getTasks();
     const ocAll = store.getOcSessions();
     const fmtTs = (t) => { const d = new Date(t); const p2 = (n) => String(n).padStart(2, '0'); return `${d.getFullYear()}-${p2(d.getMonth() + 1)}-${p2(d.getDate())} ${p2(d.getHours())}:${p2(d.getMinutes())}`; };
     const roleOf = (m) => m.role === 'user' ? '👤 用户' : (m.agentName || '智能体') + (m.phase ? `（${m.phase}）` : '');
+    const total = stat.main + Object.values(stat.counts).reduce((a, b) => a + b, 0);
     const lines = [
       '# Agents Chat 会话导出', '',
       `- 导出时间：${fmtTs(Date.now())}`,
-      `- 会话数：${1 + tasksAll.filter(t => store.getMessages(t.id).length > 0).length + ocAll.filter(s => store.getMessages(s.id).length > 0).length}（主会话 + 任务会话 + 单聊会话）`,
-      `- 消息总数：${msgs.length}`, ''
+      `- 会话数：${1 + tasksAll.filter(t => (stat.counts[t.id] || 0) > 0).length + ocAll.filter(s => (stat.counts[s.id] || 0) > 0).length}（主会话 + 任务会话 + 单聊会话）`,
+      `- 消息总数：${total}`, ''
     ];
-    const main = msgs.filter(m => !m.taskId);
+    const main = store.getMessages('');
     lines.push('---', '', '## 主会话', '');
     for (const m of main) {
       lines.push(`### ${fmtTs(m.timestamp)} · ${roleOf(m)}`, '');
@@ -945,11 +968,9 @@ const server = http.createServer(async (req, res) => {
   // ---------- 事项管控（卡牌）API ----------
   if (p === '/api/cards' && req.method === 'GET') {
     const cards = CardStore.list();
-    // 附带每个卡牌当前过程消息条数（供 UI 角标展示）
-    const counts = {};
-    try {
-      for (const m of store.getMessages()) if (m.taskId) counts[m.taskId] = (counts[m.taskId] || 0) + 1;
-    } catch { /* ignore */ }
+    // 附带每个卡牌当前过程消息条数（供 UI 角标展示）：逐分片计数，不合并全量消息
+    let counts = {};
+    try { counts = store.countMessagesByTask().counts; } catch { /* ignore */ }
     // 执行内核状态（前端据此显示内核徽标/缺失警告）与追加聊天进行中的卡
     let runnerInfo = { kind: 'unknown', label: '' };
     try {
@@ -958,9 +979,13 @@ const server = http.createServer(async (req, res) => {
       runnerInfo = { kind: r.kind, label: r.kernel ? r.kernel.label : '' };
     } catch { /* ignore */ }
     const { getCorruptedFiles } = require('./lib/cards');
+    // 版本与更新信息（cards 页无 health 轮询，随主列表接口下发；1 小时缓存）
+    const upd = await checkLatest().catch(() => null);
     json(res, 200, {
       success: true, cards, running: cardRunner.isRunning(), maxParallel: cardRunner.maxP(), msgCounts: counts, config: CardStore.getConfig(),
-      followupIds: cardRunner.getFollowupIds(), runner: runnerInfo, corrupted: getCorruptedFiles()
+      followupIds: cardRunner.getFollowupIds(), runner: runnerInfo, corrupted: getCorruptedFiles(),
+      version: APP_VERSION, latestVersion: upd ? upd.latest : '', updateAvailable: upd ? upd.updateAvailable : false,
+      updateCommand: upd && upd.updateAvailable ? UPDATE_COMMAND : ''
     });
     return;
   }
@@ -1204,20 +1229,35 @@ const server = http.createServer(async (req, res) => {
 });
 
 // 优雅退出：停掉全部子进程、把执行中任务复位为待执行，避免残留与假死状态
+// 幂等防重入：信号钩子与 exit 钩子可能先后触发，清理只执行一次
+let shutdownDone = false;
 function shutdown(code) {
-  try {
-    if (termProc) { try { termProc.kill(); } catch { /* ignore */ } termProc = null; }
-    const n = stopAllChildren();
-    const m = store.resetRunningTasks();
-    const mc = CardStore.resetRunning();
-    if (n || m || mc) console.log(`退出清理：终止 ${n} 个子进程，复位 ${m} 个执行中任务、${mc} 张卡牌`);
-  } catch (err) {
-    console.error('[shutdown] 清理失败:', err && (err.stack || err));
+  if (!shutdownDone) {
+    shutdownDone = true;
+    try {
+      if (termProc) { try { termProc.kill(); } catch { /* ignore */ } termProc = null; }
+      const n = stopAllChildren();
+      const m = store.resetRunningTasks();
+      const mc = CardStore.resetRunning();
+      if (n || m || mc) console.log(`退出清理：终止 ${n} 个子进程，复位 ${m} 个执行中任务、${mc} 张卡牌`);
+    } catch (err) {
+      console.error('[shutdown] 清理失败:', err && (err.stack || err));
+    }
   }
   process.exit(code);
 }
 process.on('SIGINT', () => shutdown(0));
 process.on('SIGTERM', () => shutdown(0));
+// Windows 关闭控制台窗口（CTRL_CLOSE_EVENT）在 Node 上映射为 SIGHUP，系统给约 5 秒处理宽限：
+// 同步 killTree 足够完成，正在执行的 AI 子进程不再变孤儿
+process.on('SIGHUP', () => shutdown(0));
+// 兜底：显式 process.exit 路径（exit 钩子内仅允许同步操作，killTree 为同步调用）
+process.on('exit', () => {
+  if (!shutdownDone) {
+    shutdownDone = true;
+    try { stopAllChildren(); } catch { /* ignore */ }
+  }
+});
 
 // ---------- 任务批次执行（SSE 手动触发与定时调度共用） ----------
 // send: 事件推送（SSE 为真实推送，定时触发为 no-op，消息仍会持久化）
@@ -1426,8 +1466,27 @@ server.listen(PORT, () => {
   startScheduler();
   startAutoStop();
   startPruneTimer();
-  console.log(`Agents Chat 已启动: http://localhost:${PORT}`);
+  console.log(`Agents Chat v${APP_VERSION} 已启动: http://localhost:${PORT}`);
   console.log(`运行内核: ${kindText}`);
+  console.log('退出提示: 请用 Ctrl+C（或 agents-chat stop）退出，会自动清理执行中的 AI 子进程；直接关闭窗口可能残留正在执行的进程');
   console.log(`本机可用内核: ${avail}（配置页可切换）`);
   console.log(`数据目录: ${store.DATA_DIR}`);
+  // 开发自检：页面内 PAGE_VERSION 落后于服务端 → 提示同步，避免互检误报强刷
+  try {
+    for (const f of ['index.html', 'cards.html']) {
+      const html = fs.readFileSync(path.join(PUBLIC_DIR, f), 'utf8');
+      const m = html.match(/PAGE_VERSION\s*=\s*'([^']+)'/);
+      if (m && m[1] !== APP_VERSION) console.warn(`[版本自检] ${f} 的 PAGE_VERSION（${m[1]}）与服务端（${APP_VERSION}）不一致，发版前请同步`);
+    }
+  } catch { /* ignore */ }
+  // 异步更新检查：不阻塞启动，有新版打印一键升级提示
+  checkLatest().then((upd) => {
+    if (upd && upd.updateAvailable) {
+      console.log(`──────────────────────────────────────────────`);
+      console.log(`📦 发现新版本 v${upd.latest}（当前 v${APP_VERSION}）`);
+      console.log(`   命令行一键升级: agents-chat update`);
+      console.log(`   或手动执行: ${UPDATE_COMMAND}`);
+      console.log(`──────────────────────────────────────────────`);
+    }
+  }).catch(() => { /* ignore */ });
 });

package/bin/agents-chat.js

@@ -1,13 +1,15 @@
 #!/usr/bin/env node
 /**
  * agents-chat CLI 入口
- * 
+ *
  * 用法:
- *   agents-chat          # 启动服务（后台运行）
- *   agents-chat start    # 同上
- *   agents-chat stop     # 停止服务
- *   agents-chat status   # 查看服务状态
- *   agents-chat open     # 仅打开浏览器
+ *   agents-chat            # 启动服务（后台运行）
+ *   agents-chat start      # 同上
+ *   agents-chat stop       # 停止服务
+ *   agents-chat status     # 查看服务状态（含版本与更新检查）
+ *   agents-chat open       # 仅打开浏览器
+ *   agents-chat update     # 检查并一键升级到 npm 最新版
+ *   agents-chat version    # 查看当前版本
  */
 
 const { spawn, execSync } = require('child_process');
@@ -15,6 +17,9 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
+const PKG = require('../package.json');
+const { checkLatest, UPDATE_COMMAND } = require('../app/lib/updatecheck');
+
 const PORT = parseInt(process.env.AGENTS_CHAT_PORT || '3456', 10);
 const PID_FILE = path.join(os.homedir(), '.agents-chat.pid');
 const LOG_FILE = path.join(os.homedir(), '.agents-chat.log');
@@ -216,6 +221,52 @@ function showStatus() {
       console.log('发现残留进程，已清理');
     }
   }
+  console.log(`当前版本: v${PKG.version}`);
+  checkLatest().then((upd) => {
+    if (!upd) { console.log('更新检查: 网络不可用，跳过'); return; }
+    if (upd.updateAvailable) {
+      console.log(`可用更新: v${upd.latest}（运行 agents-chat update 一键升级）`);
+    } else {
+      console.log(`版本状态: 已是最新（npm 最新 v${upd.latest}）`);
+    }
+  });
+}
+
+// 一键升级：检测新版 → 停服务（避免文件占用/旧进程残留）→ npm 全局安装最新版
+async function updateSelf() {
+  console.log(`当前版本: v${PKG.version}`);
+  console.log('正在检查 npm 最新版本...');
+  const upd = await checkLatest({ force: true });
+  if (!upd) {
+    console.error('无法访问 npm registry（网络超时或离线），请稍后重试或手动执行:');
+    console.log(`  ${UPDATE_COMMAND}`);
+    process.exit(1);
+  }
+  if (!upd.updateAvailable) {
+    console.log(`已是最新版本 v${upd.latest}，无需升级`);
+    return;
+  }
+  console.log(`发现新版本 v${upd.latest}，开始升级...`);
+  const check = isRunning();
+  if (check.running) {
+    console.log('先停止运行中的服务（升级完成后需手动重新启动）...');
+    stopServer();
+  }
+  try {
+    execSync(UPDATE_COMMAND, { stdio: 'inherit' });
+    console.log('');
+    console.log(`升级完成: v${PKG.version} -> v${upd.latest}`);
+    console.log('运行 agents-chat 重新启动服务');
+  } catch (err) {
+    console.error('升级失败:', err.message);
+    console.log('可手动执行:');
+    console.log(`  ${UPDATE_COMMAND}`);
+    process.exit(1);
+  }
+}
+
+function showVersion() {
+  console.log(`agents-chat v${PKG.version}`);
 }
 
 // 主逻辑
@@ -235,18 +286,29 @@ switch (command) {
   case 'open':
     openBrowser();
     break;
+  case 'update':
+  case 'upgrade':
+    updateSelf();
+    break;
+  case 'version':
+  case '-v':
+  case '--version':
+    showVersion();
+    break;
   case 'help':
   case '--help':
   case '-h':
     console.log(`
-Agents Chat CLI
+Agents Chat CLI v${PKG.version}
 
 用法:
-  agents-chat          启动服务（后台运行，自动打开浏览器）
-  agents-chat start    同上
-  agents-chat stop     停止服务
-  agents-chat status   查看服务状态
-  agents-chat open     仅打开浏览器
+  agents-chat            启动服务（后台运行，自动打开浏览器）
+  agents-chat start      同上
+  agents-chat stop       停止服务
+  agents-chat status     查看服务状态（含版本与更新检查）
+  agents-chat open       仅打开浏览器
+  agents-chat update     检查并一键升级到 npm 最新版
+  agents-chat version    查看当前版本
 
 环境变量:
   AGENTS_CHAT_PORT     端口号 (默认: 3456)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iamsamyiok/agents-chat",
-  "version": "3.24.0",
+  "version": "3.26.0",
   "description": "多智能体群聊工具 - 支持 OpenCode/Claude Code/Codex/pi 内核，微信风格聊天界面",
   "main": "lib/start.js",
   "bin": {