@iamsamyiok/agents-chat 3.30.0 → 3.32.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

@@ -349,10 +349,13 @@ function runAgent(agent, prompt, onChunk, scope) {
 }
 
 // 智能体工作目录（全局统一）：
-// - 环境变量 AGENTS_CHAT_CWD 优先（卡牌 workspace 等单次执行场景注入）
+// - 任务隔离上下文优先（worktree 任务执行期间注入，见 lib/worktree.js runWithTaskCwd）
+// - 环境变量 AGENTS_CHAT_CWD 次之（卡牌 workspace 等单次执行场景注入）
 // - 配置了有效 globalCwd → 所有智能体共用该目录（文件资料集中在一处）
 // - 否则默认 <数据目录>/workspace/ 共享目录
 function resolveCwd() {
+  const wtCwd = require('./worktree').currentTaskCwd();
+  if (wtCwd) return wtCwd;
   const envCwd = String(process.env.AGENTS_CHAT_CWD || '').trim();
   if (envCwd) {
     try { if (fs.existsSync(envCwd) && fs.statSync(envCwd).isDirectory()) return envCwd; } catch { /* ignore */ }

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

@@ -193,9 +193,16 @@ function chatSolo(runnerKind, runner, opts, onEvent) {
   const ocSessionId = String(opts.ocSessionId || '');
   // 进程归属 scope：停止编排（stopScope('solo')）只杀编排任务，追加聊天用独立 scope 免受牵连
   const scope = String(opts.scope || 'solo');
-  // 工作区：指定后 Agent 在该目录读写文件（卡牌可选 workspace）
-  const cwd = opts.cwd && fs.existsSync(opts.cwd) && fs.statSync(opts.cwd).isDirectory() ? opts.cwd : '';
-  const cwdEnv = cwd ? { ...process.env, AGENTS_CHAT_CWD: cwd } : process.env;
+  // 工作区：指定后 Agent 在该目录读写文件（卡牌可选 workspace；任务隔离 worktree 经 ALS 注入）
+  const alsCwd = require('./worktree').currentTaskCwd();
+  const cwdInput = opts.cwd || alsCwd;
+  const cwd = cwdInput && fs.existsSync(cwdInput) && fs.statSync(cwdInput).isDirectory() ? cwdInput : '';
+  // 演示模式按调用场景选择 mock 行为（solo-task 会真实写产出文件，供隔离区 diff 演示）
+  const cwdEnv = {
+    ...process.env,
+    ...(cwd ? { AGENTS_CHAT_CWD: cwd } : {}),
+    ...(runnerKind === 'demo' ? { MOCK_BEHAVIOR: String(opts.behavior || 'echo') } : {})
+  };
 
   // ---- 演示模式：mock 子进程 + 快照模拟 ----
   if (runnerKind === 'demo') {

package/app/lib/orchestrator.js

@@ -1076,32 +1076,37 @@ async function runTasks(tasks, butler, subAgents, opts, emit, onMessage, onTaskS
       emit({ type: 'notice', content: '已手动停止，剩余任务保持待执行状态' });
       break;
     }
-    const prompt = `请完成以下任务并给出结果：\n${task.title}${task.notes ? `\n\n补充说明：${task.notes}` : ''}`;
-    // 先建历史背景（不含本任务的起始消息），再写入任务会话首条消息
-    const history = opts.getHistory ? opts.getHistory(task.id) : '';
-    if (onTaskStart) onTaskStart(task);
-    // 该任务产生的全部消息都归入对应任务会话
-    const persistTask = (m) => onMessage({ ...m, taskId: task.id });
-
-    const assigned = opts.resolveAssign ? opts.resolveAssign(task) : null;
-    let r;
-    if (assigned && assigned.id !== butler.id) {
-      // 指派子智能体：独立完成，无管家编排
-      emit({ type: 'task_start', taskId: task.id, title: task.title, agentName: assigned.name });
-      emit({ type: 'notice', content: `本任务由 @${assigned.name} 独立完成（无管家调度）`, taskId: task.id });
-      r = await runMentioned([assigned], prompt, { taskId: task.id, history, scope: opts.scope, isStopped }, emit, persistTask);
-    } else {
-      emit({ type: 'task_start', taskId: task.id, title: task.title, agentName: butler.name });
-      r = await runButler(butler, subAgents, prompt, { taskId: task.id, history, scope: opts.scope, isStopped }, emit, persistTask);
-    }
-    let status = r.ok ? 'done' : 'failed';
-    let resultText = (r.finalText || '').trim() || '执行失败';
-    if (isStopped() && !r.ok) {
-      status = 'pending'; // 手动停止的任务回到待执行，可随时重跑
-      resultText = '已手动停止，可重新执行';
-    }
-    onTaskDone(task.id, { status, result: resultText.slice(0, 10000) });
-    emit({ type: 'task_done', taskId: task.id, status, title: task.title });
+    // 任务隔离 worktree：opts.taskCwd(task) 返回隔离目录（空 = 共享目录），整任务执行期间注入 cwd 上下文
+    const taskCwd = opts.taskCwd ? String(opts.taskCwd(task) || '') : '';
+    if (taskCwd) emit({ type: 'notice', content: `🌿 本任务在 Git 隔离区执行：${taskCwd}`, taskId: task.id });
+    await require('./worktree').runWithTaskCwd(taskCwd, async () => {
+      const prompt = `请完成以下任务并给出结果：\n${task.title}${task.notes ? `\n\n补充说明：${task.notes}` : ''}`;
+      // 先建历史背景（不含本任务的起始消息），再写入任务会话首条消息
+      const history = opts.getHistory ? opts.getHistory(task.id) : '';
+      if (onTaskStart) onTaskStart(task);
+      // 该任务产生的全部消息都归入对应任务会话
+      const persistTask = (m) => onMessage({ ...m, taskId: task.id });
+
+      const assigned = opts.resolveAssign ? opts.resolveAssign(task) : null;
+      let r;
+      if (assigned && assigned.id !== butler.id) {
+        // 指派子智能体：独立完成，无管家编排
+        emit({ type: 'task_start', taskId: task.id, title: task.title, agentName: assigned.name });
+        emit({ type: 'notice', content: `本任务由 @${assigned.name} 独立完成（无管家调度）`, taskId: task.id });
+        r = await runMentioned([assigned], prompt, { taskId: task.id, history, scope: opts.scope, isStopped }, emit, persistTask);
+      } else {
+        emit({ type: 'task_start', taskId: task.id, title: task.title, agentName: butler.name });
+        r = await runButler(butler, subAgents, prompt, { taskId: task.id, history, scope: opts.scope, isStopped }, emit, persistTask);
+      }
+      let status = r.ok ? 'done' : 'failed';
+      let resultText = (r.finalText || '').trim() || '执行失败';
+      if (isStopped() && !r.ok) {
+        status = 'pending'; // 手动停止的任务回到待执行，可随时重跑
+        resultText = '已手动停止，可重新执行';
+      }
+      onTaskDone(task.id, { status, result: resultText.slice(0, 10000) });
+      emit({ type: 'task_done', taskId: task.id, status, title: task.title });
+    });
   }
   emit({ type: 'all_done' });
 }

package/app/lib/store.js

@@ -397,7 +397,7 @@ function importTasks(text, mode, runner, model) {
   for (const t of tasks) { if (t.seq === undefined) t.seq = next++; else next = Math.max(next, t.seq + 1); }
   for (const t of parsed) { t.seq = next++; if (runner === 'solo' && model) t.model = String(model); }
   saveTasks(tasks.concat(parsed));
-  return { added: parsed.length, warnings };
+  return { added: parsed.length, warnings, addedTasks: parsed };
 }
 
 // 拖拽排序：按给定 id 顺序重编 seq（ids 应为全量，未包含的追加在末尾）
@@ -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/lib/worktree.js

@@ -0,0 +1,192 @@
+// Git worktree 任务隔离：
+// 创建任务时可选在独立 git worktree 中执行（每任务独立分支+目录，互不污染），
+// 完成后可查看改动 diff、合并回主工作目录或整体丢弃。
+// 工作目录（resolveCwd()）不是 git 仓库时功能自动降级（任务照常在共享目录执行）。
+//
+// cwd 传递：AsyncLocalStorage 按任务执行上下文注入（agent.js/oc.js 的 resolveCwd 优先读取），
+// 与并发的聊天请求互不干扰（聊天不在该 async 上下文内）。
+const fs = require('fs');
+const path = require('path');
+const { execFile } = require('child_process');
+const { AsyncLocalStorage } = require('node:async_hooks');
+const store = require('./store');
+
+const WT_ROOT = path.join(store.DATA_DIR, 'worktrees');
+const BRANCH_PREFIX = 'ac/';
+const DIFF_MAX_FILES = 50;          // diff 视图最多展示文件数
+const DIFF_MAX_PATCH = 20 * 1024;   // 单文件 patch 截断
+const DIFF_MAX_TOTAL = 200 * 1024;  // 总 patch 截断
+
+// ---------- 任务级 cwd 注入（AsyncLocalStorage） ----------
+const taskCwdStorage = new AsyncLocalStorage();
+function runWithTaskCwd(cwd, fn) {
+  return cwd ? taskCwdStorage.run({ cwd }, fn) : fn();
+}
+function currentTaskCwd() {
+  const s = taskCwdStorage.getStore();
+  if (!s || !s.cwd) return '';
+  try { if (fs.existsSync(s.cwd) && fs.statSync(s.cwd).isDirectory()) return s.cwd; } catch { /* ignore */ }
+  return '';
+}
+
+// ---------- git 基础 ----------
+function git(args, opts = {}) {
+  return new Promise((resolve) => {
+    execFile('git', args, {
+      cwd: opts.cwd,
+      timeout: opts.timeout || 30000,
+      maxBuffer: 8 * 1024 * 1024,
+      windowsHide: true
+    }, (err, so, se) => {
+      resolve({ code: err ? (err.code === undefined ? 1 : err.code) : 0, so: String(so || ''), se: String(se || '') });
+    });
+  });
+}
+
+// 工作目录是否为可用 git 仓库（有至少一个提交）
+async function isGitRepo(dir) {
+  if (!dir) return false;
+  const r = await git(['rev-parse', '--is-inside-work-tree'], { cwd: dir });
+  if (String(r.so).trim() !== 'true') return false;
+  const h = await git(['rev-parse', 'HEAD'], { cwd: dir });
+  return h.code === 0 && h.so.trim() !== '';
+}
+
+function wtDirOf(taskId) { return path.join(WT_ROOT, String(taskId).replace(/[^\w-]/g, '')); }
+function branchOf(taskId) { return BRANCH_PREFIX + String(taskId).replace(/[^\w-]/g, ''); }
+
+// ---------- 创建 / 清理 ----------
+// 为任务创建隔离 worktree；返回 { dir, branch, base } 或 null（非 git 仓库 / git 不可用 / 目录残留等）
+async function createForTask(taskId) {
+  try {
+    const { resolveCwd } = require('./agent');
+    const baseCwd = resolveCwd();
+    if (!(await isGitRepo(baseCwd))) return null;
+    const head = await git(['rev-parse', 'HEAD'], { cwd: baseCwd });
+    const base = head.so.trim();
+    if (!base) return null;
+    const dir = wtDirOf(taskId);
+    const branch = branchOf(taskId);
+    // 残留清理（上次异常退出可能留下同名 worktree/分支）
+    await git(['worktree', 'remove', '--force', dir], { cwd: baseCwd });
+    await git(['branch', '-D', branch], { cwd: baseCwd });
+    const r = await git(['worktree', 'add', '-b', branch, dir, 'HEAD'], { cwd: baseCwd });
+    if (r.code !== 0) return null;
+    return { dir, branch, base, createdAt: Date.now() };
+  } catch {
+    return null;
+  }
+}
+
+// 从 worktree 目录反查主仓库根目录
+async function findMainRepo(dir) {
+  const g = await git(['rev-parse', '--git-common-dir'], { cwd: dir });
+  if (g.code !== 0) return '';
+  const common = g.so.trim();
+  if (!common) return '';
+  let main = path.resolve(dir, common.replace(/[/\\]\.git$/, ''));
+  try { if (!fs.statSync(main).isDirectory()) return ''; } catch { return ''; }
+  return main;
+}
+
+// 删除 worktree 与对应分支；返回 { ok, error }
+async function removeForTask(worktree, { keepBranch = false } = {}) {
+  if (!worktree || !worktree.dir) return { ok: false, error: '无隔离区信息' };
+  let mainRepo = worktree.mainRepo || '';
+  if (!mainRepo && fs.existsSync(worktree.dir)) mainRepo = await findMainRepo(worktree.dir);
+  const r1 = await git(['worktree', 'remove', '--force', worktree.dir], { cwd: mainRepo || undefined });
+  let r2 = { code: 0 };
+  if (!keepBranch && worktree.branch) r2 = await git(['branch', '-D', worktree.branch], { cwd: mainRepo || undefined });
+  const ok = r1.code === 0; // 分支删除失败不阻塞（可能已被合并删除）
+  return { ok, error: ok ? '' : String((r1.se || r1.so || '').split('\n')[0] || '清理失败').slice(0, 200) };
+}
+
+// ---------- 改动查看 ----------
+// 统计与明细：base（创建时 HEAD）→ 当前工作区（含未提交与未跟踪）
+async function diff(worktree, { withPatch = true } = {}) {
+  if (!worktree || !worktree.dir) throw new Error('无隔离区信息');
+  const dir = worktree.dir;
+  const base = worktree.base || 'HEAD';
+  // add -A 仅为了让未跟踪文件进入 diff（不动分支指针）
+  await git(['add', '-A'], { cwd: dir });
+  const st = await git(['diff', '--numstat', base, '--'], { cwd: dir });
+  const stat = [];
+  for (const line of st.so.split('\n')) {
+    if (!line.trim()) continue;
+    const parts = line.split('\t');
+    if (parts.length < 3) continue;
+    stat.push({ file: parts[2], add: parts[0] === '-' ? null : Number(parts[0]), del: parts[1] === '-' ? null : Number(parts[1]) });
+    if (stat.length >= DIFF_MAX_FILES) break;
+  }
+  const out = { base, branch: worktree.branch, dir, stat, files: [] };
+  if (!withPatch || !stat.length) return out;
+  let total = 0;
+  for (const s of stat) {
+    if (total >= DIFF_MAX_TOTAL) { out.truncated = true; break; }
+    const p = await git(['diff', base, '--', s.file], { cwd: dir });
+    let patch = p.so;
+    if (patch.length > DIFF_MAX_PATCH) { patch = patch.slice(0, DIFF_MAX_PATCH) + '\n…（已截断）'; out.truncated = true; }
+    total += patch.length;
+    out.files.push({ path: s.file, patch });
+  }
+  return out;
+}
+
+// ---------- 合并回主工作目录 ----------
+// worktree 内未提交改动先提交，再在主仓库 merge 该分支
+async function mergeToMain(worktree, title) {
+  if (!worktree || !worktree.dir) throw new Error('无隔离区信息');
+  const dir = worktree.dir;
+  // 找主仓库：worktree 里 git rev-parse --git-common-dir 指向主 .git
+  const mainRepo = await findMainRepo(dir);
+  // 1. worktree 内提交全部改动
+  const hasChange = await git(['status', '--porcelain'], { cwd: dir });
+  if (hasChange.code === 0 && hasChange.so.trim()) {
+    await git(['add', '-A'], { cwd: dir });
+    const cm = await git(['commit', '-m', `agents-chat: ${String(title || '任务').slice(0, 60)}`], { cwd: dir });
+    if (cm.code !== 0) return { ok: false, error: `隔离区提交失败：${String((cm.se || cm.so).split('\n')[0]).slice(0, 200)}` };
+  }
+  // 2. 主仓库合并（--no-edit 保留默认合并信息；无改动则 nothing to commit）
+  const mr = await git(['merge', '--no-edit', worktree.branch], { cwd: mainRepo || undefined });
+  const mOut = String((mr.so || '') + (mr.se || '')).trim();
+  if (/Already up to date|已是最新|Nothing to merge/i.test(mOut)) return { ok: true, already: true };
+  if (mr.code !== 0) {
+    // 合并冲突：回滚合并状态，让用户在隔离区自行处理后再试
+    await git(['merge', '--abort'], { cwd: mainRepo || undefined });
+    return { ok: false, error: `合并冲突（已还原主目录）：${mOut.split('\n')[0].slice(0, 200)}` };
+  }
+  return { ok: true };
+}
+
+// ---------- 数据治理 ----------
+// 清理无主（任务已删）或完结超期的 worktree；liveTasks: 当前任务数组
+async function pruneStale(days, liveTasks) {
+  const stat = { worktrees: 0 };
+  const cutoff = Date.now() - Math.max(1, Number(days) || 15) * 24 * 3600 * 1000;
+  const live = new Map((liveTasks || []).filter(t => t.worktree).map(t => [wtDirOf(t.id), t]));
+  let names = [];
+  try { names = fs.readdirSync(WT_ROOT); } catch { return stat; }
+  for (const name of names) {
+    const dir = path.join(WT_ROOT, name);
+    try {
+      if (!fs.statSync(dir).isDirectory()) continue;
+      const task = live.get(dir);
+      const w = task ? task.worktree : { dir, branch: branchOf(name), mainRepo: '' };
+      let stale = !task;
+      if (task) {
+        const end = Number(task.updatedAt || task.createdAt) || 0;
+        stale = (task.status === 'done' || task.status === 'failed') && end && end < cutoff;
+      }
+      if (!stale) continue;
+      const r = await removeForTask(w);
+      if (r.ok) stat.worktrees++;
+    } catch { /* 单项失败跳过 */ }
+  }
+  return stat;
+}
+
+module.exports = {
+  WT_ROOT, DIFF_MAX_FILES,
+  runWithTaskCwd, currentTaskCwd,
+  isGitRepo, createForTask, removeForTask, diff, mergeToMain, pruneStale
+};

package/app/mock/mock-agent.js

@@ -33,10 +33,15 @@ if (behavior === 'solo-chat') {
     `已处理完成 ${DEMO_TAG}`
   ]);
 } else if (behavior === 'solo-task') {
-  // 单聊任务执行演示：输出任务结果（作为 result 持久化）
+  // 单聊任务执行演示：在工作目录真实写入一个成果文件（供 Git 隔离 diff 演示），再流式输出任务结果
+  try {
+    const fs = require('fs');
+    const path = require('path');
+    fs.writeFileSync(path.join(process.cwd(), 'demo-solo-output.md'), '# 单聊任务演示产出\n\n演示模式下写入工作目录的成果文件。\n');
+  } catch { /* 只读目录时跳过 */ }
   streamOutput([
     `[单聊任务] 开始处理：${prompt.slice(0, 120)}`,
-    `任务完成：产出模拟结果 ${DEMO_TAG}`
+    `任务完成：产出模拟结果（已写入 demo-solo-output.md） ${DEMO_TAG}`
   ]);
 } else if (behavior === 'echo') {
   if (prompt.includes('【委派背景】')) {

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>