@iamsamyiok/agents-chat 3.20.0 → 3.22.0

package/app/lib/cards.js

@@ -13,6 +13,7 @@ const path = require('path');
 const { resolveRunner, detectKernels, KERNEL_DEFS, stopScope } = require('./agent');
 const oc = require('./oc');
 const store = require('./store');
+const safejson = require('./safejson');
 
 const ROOT = path.join(__dirname, '..', '..');
 const DATA_DIR = process.env.AGENTS_CHAT_DATA || path.join(ROOT, '.data');
@@ -22,28 +23,78 @@ const TRASH_PATH = path.join(DATA_DIR, 'cards_trash.json');
 const TRASH_TTL = 30 * 24 * 3600 * 1000; // 垃圾桶默认保留 30 天
 
 function ensureDir() { if (!fs.existsSync(DATA_DIR)) fs.mkdirSync(DATA_DIR, { recursive: true }); }
+// 数据损坏保护（safejson 公共层）：解析失败 → 备份 .corrupt-* 并只读；写入一律原子替换
+const corrupted = new Set(); // 已损坏的文件路径（本模块文件）
+function cachedReader(file, cacheBox) {
+  return function read() {
+    if (safejson.isCorrupted(file)) return [];
+    try {
+      const st = fs.statSync(file);
+      if (cacheBox.list && st.mtimeMs === cacheBox.mtime) return cacheBox.list;
+      const list = JSON.parse(fs.readFileSync(file, 'utf8'));
+      cacheBox.mtime = st.mtimeMs; cacheBox.list = list;
+      return list;
+    } catch (err) {
+      if (err && err.code === 'ENOENT') { // 文件不存在：正常的初始状态
+        cacheBox.mtime = 0; cacheBox.list = null;
+        return [];
+      }
+      // 文件存在但解析失败：经 safejson 备份损坏现场并登记，进入只读保护
+      safejson.readJson(file, []);
+      corrupted.add(file);
+      cacheBox.mtime = 0; cacheBox.list = null;
+      return [];
+    }
+  };
+}
+const _cardsCache = { mtime: 0, list: null };
+const _cfgCache = { mtime: 0, list: null };
+const _trashCache = { mtime: 0, list: null };
+const readCardsRaw = cachedReader(CARDS_PATH, _cardsCache);
+const readConfigRaw = cachedReader(CARDS_CFG_PATH, _cfgCache);
+const readTrashRaw = cachedReader(TRASH_PATH, _trashCache);
 function readCards() {
-  try { return JSON.parse(fs.readFileSync(CARDS_PATH, 'utf8')); } catch { return []; }
+  // 返回浅拷贝：调用方（list 的 sort 等）对数组的操作不影响缓存
+  const v = readCardsRaw();
+  return Array.isArray(v) ? v.slice() : [];
+}
+function invalidate(file) {
+  if (file === CARDS_PATH) { _cardsCache.mtime = 0; _cardsCache.list = null; }
+  else if (file === CARDS_CFG_PATH) { _cfgCache.mtime = 0; _cfgCache.list = null; }
+  else if (file === TRASH_PATH) { _trashCache.mtime = 0; _trashCache.list = null; }
+}
+// 损坏保护下的写入守卫：拒绝覆盖写（保留备份供人工恢复）
+function guardWrite(file) {
+  if (corrupted.has(file) || safejson.isCorrupted(file)) {
+    corrupted.add(file);
+    throw new Error(`数据文件 ${path.basename(file)} 已损坏（原文件已备份为 .corrupt-*），为防数据丢失已停止写入，请人工检查 ${DATA_DIR} 后删除损坏标记文件`);
+  }
 }
 function writeCards(list) {
   ensureDir();
-  const tmp = CARDS_PATH + '.tmp';
-  fs.writeFileSync(tmp, JSON.stringify(list, null, 2), 'utf8');
-  fs.renameSync(tmp, CARDS_PATH);
+  guardWrite(CARDS_PATH);
+  invalidate(CARDS_PATH);
+  safejson.writeJson(CARDS_PATH, list);
 }
 function readConfig() {
-  try { return JSON.parse(fs.readFileSync(CARDS_CFG_PATH, 'utf8')); } catch { return { workspace: '' }; }
+  const v = readConfigRaw();
+  return (v && typeof v === 'object' && !Array.isArray(v)) ? v : { workspace: '' };
 }
 function writeConfig(cfg) {
   ensureDir();
-  fs.writeFileSync(CARDS_CFG_PATH, JSON.stringify(cfg, null, 2), 'utf8');
+  guardWrite(CARDS_CFG_PATH);
+  invalidate(CARDS_CFG_PATH);
+  safejson.writeJson(CARDS_CFG_PATH, cfg);
 }
 function readTrash() {
-  try { return JSON.parse(fs.readFileSync(TRASH_PATH, 'utf8')); } catch { return []; }
+  const v = readTrashRaw();
+  return Array.isArray(v) ? v.slice() : [];
 }
 function writeTrash(list) {
   ensureDir();
-  fs.writeFileSync(TRASH_PATH, JSON.stringify(list, null, 2), 'utf8');
+  guardWrite(TRASH_PATH);
+  invalidate(TRASH_PATH);
+  safejson.writeJson(TRASH_PATH, list);
 }
 // 启动时清理超过 30 天的垃圾桶快照，并连带清除其日志，避免占用磁盘
 (function purgeTrash() {
@@ -109,11 +160,15 @@ const CardStore = {
   // 拖拽重排：order 重编 + priority 按新顺序重映射（保值域、变归属），
   // 使调度顺序恒等于看板顺序（priority 仍是排序主键，但层内次序由拖拽决定）
   reorder(ids) {
+    // 全量重编：传入 ids 按新顺序排前，未涉及的卡保持原相对顺序排后，
+    // 保证全表 order/priority 唯一且连续（部分重排不再产生并列 order）
     const list = readCards();
-    const map = new Map(list.map(c => [c.id, c]));
-    const ordered = ids.map(id => map.get(id)).filter(Boolean);
-    const prios = ordered.map(c => (c.priority === undefined ? 999 : c.priority)).sort((a, b) => a - b);
-    ordered.forEach((c, i) => { c.order = i + 1; c.priority = prios[i]; });
+    const idSet = new Set(ids);
+    const ordered = ids.map(id => list.find(c => c.id === id)).filter(Boolean);
+    const rest = list.filter(c => !idSet.has(c.id));
+    const seq = [...ordered, ...rest];
+    const prios = seq.map(c => (c.priority === undefined ? 999 : c.priority)).sort((a, b) => a - b);
+    seq.forEach((c, i) => { c.order = i + 1; c.priority = prios[i]; });
     writeCards(list);
     return true;
   },
@@ -246,10 +301,16 @@ class CardRunner {
     this.timer = null;
     this.procs = new Map(); // cardId -> { pid, child, lastActive, status }
     this.followups = new Set(); // 追加聊天中的卡牌（并发防护）
+    this.killedCards = new Set(); // 本轮编排中被单卡停止的卡：跳过调度直到本轮结束
     this.baseline = null; // 本轮编排开始时的 done/failed 基线（all_done 报增量）
   }
   isRunning() { return this.running; }
 
+  // 并行度热更新：调大后立即补齐在跑任务（无需等下一个任务完成触发 tick）
+  onConfigChanged() {
+    if (this.running) this.tick();
+  }
+
   // 并行度：cards_config.maxParallel 可热更新（1-8），未配置时用 env 默认
   maxP() {
     try {
@@ -259,7 +320,7 @@ class CardRunner {
     return MAX_PARALLEL;
   }
 
-  // 终止单个任务对应的子进程
+  // 终止单个任务对应的子进程（删除卡等场景：不改变调度语义）
   killCard(cardId) {
     this.active.delete(cardId);
     const p = this.procs.get(cardId);
@@ -267,6 +328,21 @@ class CardRunner {
     this.procs.delete(cardId);
   }
 
+  // 单卡停止：杀进程 + 标记本轮不再自动调度（状态回待执行，与全局停止的复位语义一致）
+  stopOne(cardId) {
+    const card = CardStore.get(cardId);
+    if (!card || card.status !== 'running') return false;
+    if (this.followups.has(cardId)) return false; // 追加聊天进行中：走 chatFollowup 自己的错误路径
+    this.killedCards.add(cardId);
+    this.killCard(cardId);
+    // 主动复位状态：以这里为准（子进程 close 回调到达时 runCard 会再写一次 pending，幂等），
+    // 避免回调异常丢失时卡片永远停留在 running
+    CardStore.update(cardId, { status: 'pending', result: '', error: '', finishedAt: Date.now() });
+    broadcast({ type: 'notice', content: `⏹ 已停止任务「${card.title}」，该任务回到待执行（本轮编排不再自动调度它）` });
+    broadcast({ type: 'task_done', cardId, status: 'stopped', title: card.title });
+    return true;
+  }
+
   // 供前端展示：当前存活进程 + opencode 是否在工作中（近 5s 有活动即视为工作中）
   getProcesses() {
     const out = [];
@@ -280,6 +356,7 @@ class CardRunner {
   stop() {
     this.token++;
     this.running = false;
+    this.killedCards.clear();
     if (this.timer) { try { this.timer.unref(); } catch { /* ignore */ } }
     try { stopScope('solo'); } catch { /* ignore */ }
     this.procs.clear();
@@ -291,6 +368,7 @@ class CardRunner {
     if (this.running) return;
     this.running = true;
     this.token++;
+    this.killedCards.clear();
     // 记录基线：all_done 时报告本轮增量（成功/失败数），避免混入历史任务
     const all0 = CardStore.list();
     this.baseline = { done: all0.filter(c => c.status === 'done').length, failed: all0.filter(c => c.status === 'failed').length };
@@ -302,7 +380,8 @@ class CardRunner {
     if (!this.running) return;
     const myToken = this.token;
     const all = CardStore.list();
-    const eligible = pickEligible(all, this.active);
+    // 单卡停止的任务本轮跳过（用户已明确表示停它，不让调度器立刻拉起）
+    const eligible = pickEligible(all, this.active).filter(c => !this.killedCards.has(c.id));
     if (!eligible.length) {
       if (this.active.size === 0) {
         this.running = false;
@@ -349,6 +428,12 @@ class CardRunner {
     if (card.mode === 'continue' && card.chainId) {
       const prev = CardStore.get(card.chainId);
       ocSessionId = prev && prev.ocSessionId ? prev.ocSessionId : '';
+      // 语义降级显式提示：避免「名义续聊、实际新会话」静默发生
+      if (!ocSessionId) {
+        const warn = '续聊链首无可用会话（可能已被重置，或由不支持会话续聊的内核执行），本任务将以全新会话执行';
+        store.addMessage({ role: 'assistant', agentId: 'solo', agentName: 'Agent', actor: 'assistant', phase: 'system', taskId: card.id, content: `[系统提示] ${warn}` });
+        broadcast({ type: 'notice', content: `⚠ ${card.title}：${warn}` });
+      }
     }
 
     CardStore.update(card.id, { status: 'running', startedAt: Date.now(), error: '', result: '' });
@@ -417,16 +502,18 @@ class CardRunner {
 
     const finalText = order.map(id => texts.get(id)).join('\n\n').trim();
     const stopped = myToken !== this.token;
+    const cardStopped = this.killedCards.has(card.id); // 单卡停止：与全局停止同样复位为待执行
     if (finalText) {
       store.addMessage({ role: 'assistant', agentId: 'solo', agentName: 'Agent', actor: 'assistant', phase: 'work', taskId: card.id, content: finalText.slice(0, 20000) });
     }
-    const status = stopped ? 'pending' : (doneError ? 'failed' : 'done');
+    const stoppedAny = stopped || cardStopped;
+    const status = stoppedAny ? 'pending' : (doneError ? 'failed' : 'done');
     CardStore.update(card.id, {
       status,
       ocSessionId: sesId,
       // 手动停止回到待执行：清掉残留，避免 pending 卡带着脏结果/错误
-      result: stopped ? '' : (doneError ? `执行出错：${doneError}` : finalText).slice(0, 20000),
-      error: stopped ? '' : (doneError || ''),
+      result: stoppedAny ? '' : (doneError ? `执行出错：${doneError}` : finalText).slice(0, 20000),
+      error: stoppedAny ? '' : (doneError || ''),
       finishedAt: Date.now()
     });
     broadcast({ type: 'task_done', cardId: card.id, status, title: card.title });
@@ -489,7 +576,8 @@ class CardRunner {
             model: card.model || '',
             ocSessionId: sesId,
             behavior: 'card',
-            cwd
+            cwd,
+            scope: 'card-fu' // 独立进程域：停止编排不牵连追加聊天
           }, (ev) => {
             const proc = this.procs.get(cardId);
             if (proc) proc.lastActive = Date.now();
@@ -539,12 +627,16 @@ class CardRunner {
   }
 
   isFollowupRunning(cardId) { return !!this.followups && this.followups.has(cardId); }
+  getFollowupIds() { return [...this.followups]; }
 }
 
+// 数据文件损坏状态（供 API 告警展示）
+function getCorruptedFiles() { return [...new Set([...corrupted, ...safejson.corruptedFiles()])]; }
+
 function isValidDir(p) {
   try { return fs.existsSync(p) && fs.statSync(p).isDirectory(); } catch { return false; }
 }
 
 const runner = new CardRunner();
 
-module.exports = { CardStore, CardRunner, runner, sseSubscribe, buildCardPrompt, isEligible, pickEligible, wouldCycle, MAX_PARALLEL, CARDS_PATH, CARDS_CFG_PATH };
+module.exports = { CardStore, CardRunner, runner, sseSubscribe, buildCardPrompt, isEligible, pickEligible, wouldCycle, MAX_PARALLEL, CARDS_PATH, CARDS_CFG_PATH, getCorruptedFiles };

package/app/lib/oc.js

@@ -4,6 +4,7 @@
 // - 首个 sessionID 事件回填 store，实现同一网页会话跨轮次续聊
 // - 非 opencode 内核（claude/codex/pi）无 -s 续聊能力：单聊退化为一次性对话，每轮全新上下文
 // - 演示模式（AGENTS_CHAT_MOCK=1）走 mock 子进程，输出模拟为快照事件
+const fs = require('fs');
 const path = require('path');
 const { spawn, execFileSync } = require('child_process');
 const { registerChild, describeTool, resolveCwd } = require('./agent');
@@ -98,7 +99,7 @@ function parseSoloEventLine(line, onEvent, state) {
 
 // ---------- 通用子进程运行器 ----------
 // runnerSpec: { cmd, shell, json, cwd }；json=false 时把输出行累积为快照（演示模式用）
-function spawnSoloRunner(runnerSpec, args, prompt, env, onEvent, finish) {
+function spawnSoloRunner(runnerSpec, args, prompt, env, onEvent, finish, scope) {
   let child;
   try {
     child = spawn(runnerSpec.cmd, args, {
@@ -112,7 +113,7 @@ function spawnSoloRunner(runnerSpec, args, prompt, env, onEvent, finish) {
     finish(`启动失败：${error.message}`);
     return null;
   }
-  registerChild(child, 'solo'); // 停止/退出清理复用 agent.js 的登记表（scope='solo'）
+  registerChild(child, scope || 'solo'); // 停止/退出清理复用 agent.js 的登记表（scope 可区分编排与追加聊天）
 
   child.stdin.on('error', () => { /* stdin 已关闭则忽略 */ });
   if (prompt) child.stdin.write(prompt);
@@ -190,6 +191,8 @@ function chatSolo(runnerKind, runner, opts, onEvent) {
   const prompt = String(opts.prompt || '');
   const model = String(opts.model || '');
   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;
@@ -206,7 +209,8 @@ function chatSolo(runnerKind, runner, opts, onEvent) {
         // 演示模式的会话 ID：续聊时复用传入 ID（打通链路），新任务本地生成（无真实续聊）
         onEvent({ type: 'session', ocSessionId: ocSessionId || 'ses_demo-' + Date.now().toString(36) });
         onEvent({ type: 'done', error });
-      }
+      },
+      scope
     );
   }
 
@@ -222,7 +226,8 @@ function chatSolo(runnerKind, runner, opts, onEvent) {
       { cmd: runner.cmd, shell: runner.shell, json: true, cwd: cwd || resolveCwd() },
       args, prompt, cwdEnv,
       onEvent,
-      (error) => onEvent({ type: 'done', error })
+      (error) => onEvent({ type: 'done', error }),
+      scope
     );
   }
 

package/app/lib/orchestrator.js

@@ -1173,5 +1173,7 @@ module.exports = {
   // 测试导出（单测用，业务代码请勿依赖）
   testBoardInit: boardInit, testBoardAppend: boardAppend, testBoardRead: boardRead,
   testExtractBoardNote: extractBoardNote, testParseHandoff: parseHandoff,
-  testApprovalGate: approvalGate
+  testApprovalGate: approvalGate,
+  testExtractPlanJSON: extractPlanJSON, testResolveAgentRef: resolveAgentRef,
+  testSplitByDependency: splitByDependency, testNormalizePhases: normalizePhases
 };

package/app/lib/safejson.js

@@ -0,0 +1,34 @@
+// 数据文件损坏保护 + 原子写公共层（零依赖）
+// 策略：解析失败（文件存在但 JSON 损坏）→ 备份现场为 .corrupt-<ts> 并登记；
+// 之后该文件的写请求一律抛错，防止「读到空数据 → 全量覆盖写」冲掉用户数据。
+// 正常写入走 tmp + rename 原子替换，进程中断不会留下半截文件。
+const fs = require('fs');
+const path = require('path');
+
+const corrupted = new Set(); // 已损坏的文件绝对路径
+
+function isCorrupted(file) { return corrupted.has(file); }
+function corruptedFiles() { return [...corrupted]; }
+
+function readJson(file, fallback) {
+  try {
+    return JSON.parse(fs.readFileSync(file, 'utf8'));
+  } catch (err) {
+    if (err && err.code === 'ENOENT') return fallback; // 文件不存在：正常初始状态
+    try { fs.copyFileSync(file, `${file}.corrupt-${Date.now()}`); } catch { /* 备份失败也要继续登记 */ }
+    corrupted.add(file);
+    console.error(`[safejson] 数据文件损坏，已备份并进入只读保护：${file}`);
+    return fallback;
+  }
+}
+
+function writeJson(file, data) {
+  if (corrupted.has(file)) {
+    throw new Error(`数据文件 ${path.basename(file)} 已损坏（原文件已备份为 .corrupt-*），为防数据丢失已停止写入，请人工检查 ${path.dirname(file)} 后处理备份文件`);
+  }
+  const tmp = file + '.tmp';
+  fs.writeFileSync(tmp, JSON.stringify(data, null, 2), 'utf8');
+  fs.renameSync(tmp, file);
+}
+
+module.exports = { readJson, writeJson, isCorrupted, corruptedFiles };

package/app/lib/store.js

@@ -1,13 +1,16 @@
 // 数据存储：纯 JSON 文件，零依赖
 // 文件位于数据目录（默认 <root>/.data），任务与消息持久化
+// 损坏保护与原子写由 safejson 公共层提供：损坏文件备份 .corrupt-* 后只读，防覆盖丢数据
 const fs = require('fs');
 const path = require('path');
+const safejson = require('./safejson');
 
 const ROOT = path.join(__dirname, '..', '..');
 const DATA_DIR = process.env.AGENTS_CHAT_DATA || path.join(ROOT, '.data');
 const CONFIG_PATH = path.join(DATA_DIR, 'config.json');
 const TASKS_PATH = path.join(DATA_DIR, 'tasks.json');
-const MESSAGES_PATH = path.join(DATA_DIR, 'messages.json');
+const MESSAGES_PATH = path.join(DATA_DIR, 'messages.json'); // 旧版单文件（启动时一次性迁移到 messages/ 分片）
+const MSG_DIR = path.join(DATA_DIR, 'messages');
 const MEMORY_PATH = path.join(DATA_DIR, 'memory.json');
 const OC_SESSIONS_PATH = path.join(DATA_DIR, 'oc-sessions.json');
 
@@ -16,18 +19,12 @@ function ensureDir() {
 }
 
 function readJson(file, fallback) {
-  try {
-    return JSON.parse(fs.readFileSync(file, 'utf8'));
-  } catch {
-    return fallback;
-  }
+  return safejson.readJson(file, fallback);
 }
 
 function writeJson(file, data) {
   ensureDir();
-  const tmp = file + '.tmp';
-  fs.writeFileSync(tmp, JSON.stringify(data, null, 2), 'utf8');
-  fs.renameSync(tmp, file);
+  safejson.writeJson(file, data);
 }
 
 // ---------- 内置管家智能体（不可修改、不可删除，始终置顶） ----------
@@ -87,7 +84,7 @@ function getConfig() {
   let cfg = readJson(CONFIG_PATH, null);
   if (!cfg || !Array.isArray(cfg.agents)) {
     cfg = defaultConfig();
-    writeJson(CONFIG_PATH, cfg);
+    try { writeJson(CONFIG_PATH, cfg); } catch { /* config 处于损坏保护：本次运行用默认配置，文件保留待人工恢复 */ }
   }
   // 管家始终置顶且使用内置定义（保证内置人设更新后自动生效）
   cfg.agents = [BUTLER, ...cfg.agents.filter(a => a && a.id !== 'butler')];
@@ -442,16 +439,80 @@ function getTask(id) {
   return getTasks().find(x => x.id === id) || null;
 }
 
-// ---------- 消息 ----------
-// taskId 为空 = 主会话；否则属于对应任务会话（每个任务一个独立会话）
+// ---------- 消息（分片存储：messages/<key>.json，每个会话一个文件） ----------
+// taskId 为空 = 主会话；否则属于对应任务/单聊会话
+// 旧版全部消息集中在单个 messages.json：每条消息都要全量读写整个文件，历史越长 IO 越大；
+// 分片后单会话读写只涉及自己的文件；旧文件在首次访问时一次性迁移（原件保留为 .migrated 备份）
+let msgMigrated = false;
+function migrateLegacyMessages() {
+  if (msgMigrated) return;
+  msgMigrated = true;
+  let raw = null;
+  try {
+    raw = fs.readFileSync(MESSAGES_PATH, 'utf8');
+  } catch { return; } // 无旧文件
+  let all;
+  try {
+    all = JSON.parse(raw);
+  } catch {
+    // 旧文件损坏：备份现场后放弃迁移（各会话从空开始，原件可供人工恢复）
+    try { fs.copyFileSync(MESSAGES_PATH, `${MESSAGES_PATH}.corrupt-${Date.now()}`); } catch { /* ignore */ }
+    console.error(`[store] 旧版 messages.json 损坏，已备份并跳过迁移：${MESSAGES_PATH}`);
+    return;
+  }
+  if (!Array.isArray(all)) {
+    try { fs.renameSync(MESSAGES_PATH, MESSAGES_PATH + '.migrated'); } catch { /* ignore */ }
+    return;
+  }
+  const groups = new Map();
+  for (const m of all) {
+    const k = (m && m.taskId) || '';
+    if (!groups.has(k)) groups.set(k, []);
+    groups.get(k).push(m);
+  }
+  try {
+    fs.mkdirSync(MSG_DIR, { recursive: true });
+    for (const [k, list] of groups) writeJson(msgShardPath(k), list);
+    fs.renameSync(MESSAGES_PATH, MESSAGES_PATH + '.migrated'); // 保留备份供人工核对
+  } catch (err) {
+    console.error('[store] messages 迁移失败（下次启动重试）:', err && err.message);
+    msgMigrated = false;
+  }
+}
+
+// 会话 key -> 分片文件名：常规 id 原样使用；其余（空/特殊字符）十六进制编码，避免文件名问题
+function msgShardName(key) {
+  const k = key == null ? '' : String(key);
+  if (k === '') return '_main.json';
+  if (/^[A-Za-z0-9_-]{1,80}$/.test(k)) return k + '.json';
+  return '~' + Buffer.from(k).toString('hex').slice(0, 160) + '.json';
+}
+function msgShardPath(key) { return path.join(MSG_DIR, msgShardName(key)); }
+
 function getMessages(taskId) {
-  const msgs = readJson(MESSAGES_PATH, []);
-  if (taskId === undefined) return msgs;
-  return msgs.filter(m => (m.taskId || '') === taskId);
+  migrateLegacyMessages();
+  if (taskId === undefined) {
+    // 全量视图：合并所有分片，按时间排序还原全局顺序
+    let files = [];
+    try { files = fs.readdirSync(MSG_DIR); } catch { return []; }
+    const all = [];
+    for (const name of files) {
+      if (!name.endsWith('.json') || name.startsWith('.')) continue;
+      const list = readJson(path.join(MSG_DIR, name), []);
+      if (Array.isArray(list)) all.push(...list);
+    }
+    all.sort((a, b) => ((a && a.timestamp) || '') < ((b && b.timestamp) || '') ? -1 : 1);
+    return all;
+  }
+  const list = readJson(msgShardPath(String(taskId)), []);
+  return Array.isArray(list) ? list : [];
 }
 
 function addMessage(msg) {
-  const msgs = readJson(MESSAGES_PATH, []);
+  migrateLegacyMessages();
+  fs.mkdirSync(MSG_DIR, { recursive: true });
+  const key = msg.taskId || '';
+  const msgs = readJson(msgShardPath(key), []);
   // 主会话消息记录所属 epoch：新会话开启后，旧 epoch 消息不再传入上下文
   const rec = {
     id: msg.id || `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
@@ -468,11 +529,19 @@ function addMessage(msg) {
     timestamp: msg.timestamp || new Date().toISOString()
   };
   msgs.push(rec);
-  writeJson(MESSAGES_PATH, msgs);
+  writeJson(msgShardPath(key), msgs);
 }
 
 function clearMessages() {
-  writeJson(MESSAGES_PATH, []);
+  migrateLegacyMessages();
+  // 清空全部会话消息：删除所有分片，主会话分片重置为空数组
+  try {
+    for (const name of fs.readdirSync(MSG_DIR)) {
+      if (!name.endsWith('.json') || name.startsWith('.')) continue;
+      try { fs.unlinkSync(path.join(MSG_DIR, name)); } catch { /* ignore */ }
+    }
+  } catch { /* 目录不存在 */ }
+  writeJson(msgShardPath(''), []);
 }
 
 // ---------- 流转日志（智能体之间的派发/交接/返工/验收事件，append-only） ----------
@@ -566,7 +635,7 @@ function getOcSession(id) {
 
 function deleteOcSession(id) {
   saveOcSessions(getOcSessions().filter(s => s.id !== id));
-  writeJson(MESSAGES_PATH, readJson(MESSAGES_PATH, []).filter(m => (m.taskId || '') !== id));
+  try { fs.unlinkSync(msgShardPath(id)); } catch { /* 分片不存在 */ }
 }
 
 // ---------- 管家长期记忆（跨会话偏好与教训，读写由 memory.js 负责） ----------
@@ -614,16 +683,27 @@ function pruneOldData(days) {
     // 其消息由下方第 3 步统一按孤儿清理并计数（避免重复统计）
   }
 
-  // 3. 消息：孤儿任务消息（任务已删）+ 过期的主会话/单聊会话消息（timestamp 超 cutoff）
+  // 3. 消息（分片）：孤儿会话分片整文件删除；主会话分片按 timestamp 过滤
   const validIds = new Set([...keptTasks.map(t => t.id), ...keptSess.map(s => s.id)]);
-  const keptMsgs = readJson(MESSAGES_PATH, []).filter(m => {
-    const tid = m.taskId || '';
-    if (tid && !validIds.has(tid)) { stat.messages++; return false; } // 孤儿消息
-    if (!tid && tsOf(m) && tsOf(m) < cutoff) { stat.messages++; return false; } // 过期主会话
-    return true;
-  });
-  const allMsgs = readJson(MESSAGES_PATH, []);
-  if (keptMsgs.length !== allMsgs.length) writeJson(MESSAGES_PATH, keptMsgs);
+  try {
+    for (const name of fs.readdirSync(MSG_DIR)) {
+      if (!name.endsWith('.json') || name.startsWith('.')) continue;
+      const fp = path.join(MSG_DIR, name);
+      let list;
+      try { list = JSON.parse(fs.readFileSync(fp, 'utf8')); } catch { continue; } // 损坏分片留给损坏保护处理
+      if (!Array.isArray(list)) continue;
+      const tid = list.length ? (list[0].taskId || '') : '';
+      if (tid && !validIds.has(tid)) {
+        // 孤儿会话（任务/单聊已删或超期）：整分片删除
+        stat.messages += list.length;
+        try { fs.unlinkSync(fp); } catch { /* ignore */ }
+      } else if (!tid) {
+        // 主会话：按时间过滤
+        const kept = list.filter(m => !tsOf(m) || tsOf(m) >= cutoff);
+        if (kept.length !== list.length) { stat.messages += list.length - kept.length; writeJson(fp, kept); }
+      }
+    }
+  } catch { /* 无目录 */ }
 
   // 4. 流转日志：超期事件行过滤重写
   try {
@@ -682,5 +762,6 @@ module.exports = {
   upsertOcSession,
   getOcSession,
   deleteOcSession,
-  pruneOldData
+  pruneOldData,
+  getCorruptedFiles: () => safejson.corruptedFiles()
 };

package/app/public/cards.html

@@ -29,6 +29,17 @@
   .btn.danger{border-color:var(--err);color:var(--err)}
   .btn:disabled{opacity:.45;cursor:not-allowed}
   .status-pill{font-size:12px;color:var(--dim)}
+  .filter-box{display:flex;align-items:center;gap:4px;background:var(--panel);border:1px solid var(--line);border-radius:8px;padding:5px 8px}
+  .filter-box input{border:none;outline:none;font-size:12px;width:130px;background:transparent;color:inherit}
+  /* 详情复制按钮 */
+  .copy-btn{border:1px solid var(--line);background:transparent;color:var(--dim);font-size:11px;border-radius:4px;padding:1px 8px;cursor:pointer;margin-left:6px}
+  .copy-btn:hover{color:var(--acc2);border-color:var(--acc2)}
+  .copy-btn.done{color:#2f9e44;border-color:#2f9e44}
+  /* 看板统计条：总览 + 完成率进度 */
+  #boardStats{display:flex;align-items:center;gap:10px;padding:8px 18px;font-size:12px;color:var(--dim);border-bottom:1px solid var(--line);background:var(--panel)}
+  #boardStats b{color:inherit}
+  .done-bar{flex:1;height:6px;border-radius:3px;background:var(--line);overflow:hidden;max-width:360px}
+  .done-bar i{display:block;height:100%;background:linear-gradient(90deg,var(--acc2),#2f9e44);border-radius:3px;transition:width .4s}
   .ws-box{display:flex;align-items:center;gap:6px;background:var(--panel);border:1px solid var(--line);border-radius:8px;padding:5px 8px}
   .ws-box input{border:none;outline:none;font-size:12px;width:200px;background:transparent}
   .ws-box .ws-save{font-size:12px;color:var(--acc);cursor:pointer;white-space:nowrap}
@@ -148,6 +159,25 @@
   .trash-item .ti-info{flex:1;min-width:0}
   .trash-item .ti-title{font-weight:600;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
   .trash-item .ti-sub{font-size:11px;color:var(--dim)}
+  /* 内核状态横幅（缺失/演示模式/数据保护时显示） */
+  .kernel-banner{display:none;gap:8px;align-items:center;padding:8px 18px;font-size:12.5px;line-height:1.6;border-bottom:1px solid var(--line)}
+  .kernel-banner.show{display:flex}
+  .kernel-banner.kb-missing{background:#fdeceb;color:#b03a31}
+  .kernel-banner.kb-demo{background:#fdf6ec;color:#8a5a00}
+  .kernel-banner.kb-corrupt{background:#fdeceb;color:#b03a31}
+  /* 内核徽标（正常时显示在状态胶囊旁） */
+  .kernel-chip{display:inline-flex;align-items:center;gap:4px;font-size:11px;color:var(--dim);background:#eef0f3;border:1px solid var(--line);border-radius:6px;padding:2px 7px}
+  /* 执行中卡的运行时长徽标 */
+  .badge.run-elapsed{background:#eef7ff;color:var(--acc2);border-color:#c4e2ff;font-variant-numeric:tabular-nums}
+  /* 追加聊天进行中徽标 */
+  .badge.fu-live{background:#f1e9ff;color:#8a6fe8;border-color:#ddd0ff}
+  /* 单卡停止按钮 */
+  .icon-btn.danger:hover{color:var(--err);border-color:var(--err)}
+  /* 详情弹窗：任务内容块 */
+  .detail-content{background:#fafbfc;border:1px solid var(--line);border-radius:10px;padding:12px;margin:2px 0 10px;white-space:pre-wrap;word-break:break-word;max-height:18vh;overflow:auto;line-height:1.6;font-size:13px}
+  /* 空看板引导 */
+  .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}
 </style>
 </head>
 <body>
@@ -155,6 +185,10 @@
   <a class="backlink" href="/" title="返回 Agents Chat 群聊">← 群聊</a>
   <h1>🗂️ 多任务编排</h1>
   <span class="status-pill" id="statusPill">空闲</span>
+  <span class="kernel-chip" id="kernelChip" style="display:none"></span>
+  <div class="filter-box" title="按标题或内容即时过滤看板">
+    🔍 <input id="cardFilter" placeholder="搜索任务…" autocomplete="off" />
+  </div>
   <span class="sp"></span>
   <div class="ws-box" title="工作区：选定后 Agent 在该目录读写相关文件（可选）">
     📁 <input id="wsInput" placeholder="工作文件夹（点右侧选择）" />
@@ -167,13 +201,22 @@
     </select>
   </div>
   <button class="btn" id="btnNew">＋ 新建任务</button>
-  <button class="btn primary" id="btnRun">▶ 开始编排</button>
-  <button class="btn danger" id="btnStop" disabled>⏹ 停止</button>
+  <button class="btn primary" id="btnRun" title="按依赖与优先级调度全部待执行任务">▶ 开始编排</button>
+  <button class="btn danger" id="btnStop" disabled title="停止编排：进行中的任务复位为待执行（不影响追加聊天），未开始的任务保留">⏹ 停止</button>
   <button class="btn" id="btnClear">清空</button>
 </header>
 
+<div class="kernel-banner" id="kernelBanner"></div>
+
 <div class="procbar" id="procBar"><span class="ptitle">进程：</span><span class="proc-empty">无运行中的 opencode 进程</span></div>
 
+<div id="boardStats">
+  <b id="stTotal">0</b> 项任务
+  <span id="stDoneRate">完成率 0%</span>
+  <div class="done-bar"><i id="stDoneBar" style="width:0%"></i></div>
+  <span id="stFailed" style="color:#c92a2a"></span>
+</div>
+
 <main>
   <!-- 左侧：依赖图面板（约 1/4 宽，可收起） -->
   <aside id="graphPanel">
@@ -209,7 +252,7 @@
     <label>任务内容（描述，支持 Markdown）</label>
     <textarea id="fContent" placeholder="把要做的事详细写在这里，Agent 会据此执行"></textarea>
     <div class="row">
-      <div><label>优先级（数字越小越优先）</label><input id="fPriority" type="number" value="999" /></div>
+      <div><label>优先级（数字越小越优先；拖拽看板卡会按新顺序重写优先级）</label><input id="fPriority" type="number" value="999" /></div>
       <div><label>执行模式</label>
         <select id="fMode">
           <option value="new">新进程（new）</option>
@@ -237,10 +280,12 @@
     <h3 id="dTitle">任务详情</h3>
     <div id="dMeta" class="meta" style="margin-bottom:10px"></div>
     <div class="dep-tag" id="dDeps"></div>
+    <label>任务内容</label>
+    <div class="detail-content" id="dContent"><span class="empty">（无任务内容）</span></div>
     <div class="detail-err" id="dError" style="display:none"></div>
     <label>执行过程（实时）</label>
     <div class="detail-log" id="dLog"><span class="empty">暂无过程记录</span></div>
-    <label>最终结果</label>
+    <label>最终结果 <button class="copy-btn" id="dResultCopy" title="复制完整结果文本">复制</button></label>
     <div class="detail-result" id="dResult"><span class="empty">尚未产生结果</span></div>
     <div class="followup-box" id="fuBox">
       <div class="fu-head">💬 追加聊天 <span class="fu-st" id="fuState"></span></div>
@@ -280,24 +325,81 @@ const $ = s => document.querySelector(s);
 const api = async (url, opt) => { const r = await fetch(url, opt); return r.json(); };
 const post = (url, body) => api(url, {method:'POST', headers:{'Content-Type':'application/json'}, body: JSON.stringify(body||{})});
 function toast(msg){ const t=$('#toast'); t.textContent=msg; t.classList.add('show'); setTimeout(()=>t.classList.remove('show'),1800); }
-function esc(s){const d=document.createElement('div');d.textContent=s==null?'':String(s);return d.innerHTML;}
+function esc(s){const d=document.createElement('div');d.textContent=s==null?'':String(s);return d.innerHTML.replace(/"/g,'&quot;').replace(/'/g,'&#39;');}
 
 let CARDS = [];
 let OPEN_ID = null;
+let FOLLOWUP_IDS = [];   // 追加聊天进行中的卡 id
+let RUNNER_INFO = null;  // { kind, label }
+let CORRUPTED = [];      // 已进入损坏保护的数据文件
+let LOAD_SEQ = 0;        // loadCards 响应乱序守卫：快速触发多次时只认最新请求
 
 async function loadCards(){
+  const seq = ++LOAD_SEQ;
   const data = await api('/api/cards');
+  if (seq !== LOAD_SEQ) return; // 已有更新的请求发出：丢弃本次过期响应
   CARDS = data.cards || [];
+  FOLLOWUP_IDS = data.followupIds || [];
+  RUNNER_INFO = data.runner || null;
+  CORRUPTED = data.corrupted || [];
   $('#statusPill').textContent = data.running ? '编排中…' : '空闲';
   $('#btnRun').disabled = data.running;
   $('#btnStop').disabled = !data.running;
   if(data.config) $('#wsInput').value = data.config.workspace || '';
   if(data.maxParallel) $('#parallelSel').value = String(data.maxParallel);
+  renderKernelBanner();
   render();
   renderGraph();
   loadTrashCount();
 }
 
+// 文本复制（优先剪贴板 API，旧环境回退 execCommand）
+function copyText(text, btn){
+  const done=()=>{ if(!btn) return; const old=btn.textContent; btn.textContent='已复制'; btn.classList.add('done'); setTimeout(()=>{ btn.textContent=old; btn.classList.remove('done'); },1200); };
+  const s=String(text==null?'':text);
+  if(navigator.clipboard && navigator.clipboard.writeText){ navigator.clipboard.writeText(s).then(done).catch(()=>{ fallbackCopy(s); done(); }); }
+  else { fallbackCopy(s); done(); }
+}
+function fallbackCopy(s){
+  const ta=document.createElement('textarea');
+  ta.value=s; ta.style.cssText='position:fixed;opacity:0';
+  document.body.appendChild(ta); ta.select();
+  try{ document.execCommand('copy'); }catch(e){}
+  document.body.removeChild(ta);
+}
+// 搜索过滤：输入即时重渲染
+$('#cardFilter').addEventListener('input', render);
+
+// 内核状态展示：正常=头部小徽标；缺失/演示模式/数据保护=醒目横幅
+function renderKernelBanner(){
+  const chip=$('#kernelChip'), banner=$('#kernelBanner');
+  const k = RUNNER_INFO && RUNNER_INFO.kind;
+  if (CORRUPTED.length){
+    chip.style.display='none';
+    banner.className='kernel-banner show kb-corrupt';
+    banner.innerHTML='⚠ <b>数据保护已触发</b>：'+CORRUPTED.map(f=>'<code>'+esc(f.split(/[\\/]/).pop())+'</code>').join('、')+' 解析失败（原文件已备份为 .corrupt-*），为防数据丢失写入已暂停。请检查数据目录后恢复备份文件。';
+    return;
+  }
+  if (k === 'missing'){
+    chip.style.display='none';
+    banner.className='kernel-banner show kb-missing';
+    banner.innerHTML='❌ <b>未检测到执行内核</b>：任务无法真实执行。请安装 opencode（推荐）：终端运行 <code>npm install -g opencode-ai</code>，安装并登录后刷新本页。';
+    return;
+  }
+  if (k === 'demo'){
+    chip.style.display='none';
+    banner.className='kernel-banner show kb-demo';
+    banner.innerHTML='⚠ <b>演示模式</b>（AGENTS_CHAT_MOCK=1）：输出均为模拟结果，任务执行不可用。删除 .env 中该配置并安装内核后即为真实执行。';
+    return;
+  }
+  banner.className='kernel-banner';
+  if (RUNNER_INFO && RUNNER_INFO.label){
+    chip.style.display='inline-flex';
+    chip.textContent='⚡ '+RUNNER_INFO.label;
+    chip.title='当前执行内核：'+RUNNER_INFO.label;
+  }
+}
+
 function badge(card){
   let p = card.priority;
   let pc = p<=100?'prio-high':(p<=500?'prio-mid':'');
@@ -346,11 +448,16 @@ function cardEl(card){
   const blkHtml = blk ? `<div class="card-blocked${blk.kind==='wait'?' wait':''}">${blk.kind==='fail'?'⛔':'⏳'} ${esc(blk.text)}</div>` : '';
   const resetHtml = (card.status==='pending' && /服务重启/.test(card.error||''))
     ? `<div class="card-reset">↻ ${esc(errSummary(card.error))}</div>` : '';
+  // 执行中：实时运行时长徽标（每秒刷新）；追加聊天中：紫色徽标
+  const elapsedHtml = (card.status==='running' && card.startedAt)
+    ? `<span class="badge run-elapsed" data-start="${card.startedAt}">⏱ ${fmtElapsed(Date.now()-card.startedAt)}</span>` : '';
+  const fuHtml = FOLLOWUP_IDS.includes(card.id) ? '<span class="badge fu-live">💬 回复中</span>' : '';
   el.innerHTML = `<div class="title">${esc(card.title)}</div>
-    <div class="meta">${badge(card)} ${card.status!=='pending'&&card.status!=='running'?`<span class="badge">${card.status}</span>`:''}</div>
+    <div class="meta">${badge(card)} ${elapsedHtml} ${fuHtml} ${card.status!=='pending'&&card.status!=='running'?`<span class="badge">${card.status}</span>`:''}</div>
     ${errHtml}${blkHtml}${resetHtml}
     <div class="op">
-      <button class="icon-btn" data-act="run" title="执行">▶</button>
+      ${card.status==='running'?'<button class="icon-btn danger" data-act="stop" title="停止该任务（复位为待执行，本轮编排不再自动调度）">⏹</button>':''}
+      <button class="icon-btn" data-act="run" title="执行${card.status==='pending'?'（若依赖未完成将先确认）':'（旧结果先归档）'}">▶</button>
       <button class="icon-btn" data-act="reset" title="重置（清除结果回到待执行）">⟲</button>
       <button class="icon-btn" data-act="copy" title="复制为新任务">⧉</button>
       <button class="icon-btn" data-act="edit" title="编辑">✎</button>
@@ -360,6 +467,7 @@ function cardEl(card){
     if(a==='del') delCard(card.id);
     else if(a==='edit') openEdit(card);
     else if(a==='run') runOne(card.id);
+    else if(a==='stop') stopOne(card.id);
     else if(a==='reset') resetCard(card.id);
     else if(a==='copy') copyCard(card);
     return; }
@@ -371,6 +479,20 @@ function cardEl(card){
   el.addEventListener('drop', e=>{ e.preventDefault(); el.classList.remove('drag-over'); onDrop(card.id, el); });
   return el;
 }
+// 运行时长格式化：ms -> "1:05" / "12:03:44"
+function fmtElapsed(ms){
+  const s = Math.max(0, Math.floor(ms/1000));
+  const h = Math.floor(s/3600), m = Math.floor((s%3600)/60), sec = s%60;
+  const p2 = n => String(n).padStart(2,'0');
+  return h ? `${h}:${p2(m)}:${p2(sec)}` : `${m}:${p2(sec)}`;
+}
+// 每秒刷新执行中卡片的运行时长（不重建 DOM，只更新徽标文本）
+setInterval(()=>{
+  document.querySelectorAll('.badge.run-elapsed').forEach(b=>{
+    const st = Number(b.dataset.start);
+    if (st) b.textContent = '⏱ ' + fmtElapsed(Date.now()-st);
+  });
+}, 1000);
 let dragId=null;
 function onDrop(targetId, targetEl){
   if(!dragId || dragId===targetId) return;
@@ -390,13 +512,61 @@ document.addEventListener('dragover', e=>{ window.__dropY = e.clientY; }, true);
 function render(){
   const cols = {pending:$('#colPending'),running:$('#colRunning'),done:$('#colDone'),failed:$('#colFailed')};
   for(const k in cols) cols[k].innerHTML='';
+  // 搜索过滤：按标题 + 内容即时匹配（空串 = 全部）
+  const q=(($('#cardFilter').value||'').trim().toLowerCase());
+  const shown = q ? CARDS.filter(c=>((c.title||'')+'\n'+(c.content||'')).toLowerCase().includes(q)) : CARDS;
   let counts={pending:0,running:0,done:0,failed:0};
-  for(const c of CARDS){ counts[c.status]=(counts[c.status]||0)+1; (cols[c.status]||cols.pending).appendChild(cardEl(c)); }
+  for(const c of shown){ counts[c.status]=(counts[c.status]||0)+1; (cols[c.status]||cols.pending).appendChild(cardEl(c)); }
   $('#cntPending').textContent=counts.pending||''; $('#cntRunning').textContent=counts.running||'';
   $('#cntDone').textContent=counts.done||''; $('#cntFailed').textContent=counts.failed||'';
+  // 统计条：全部卡的总览（不受过滤影响）+ 完成率
+  const total=CARDS.length, doneN=CARDS.filter(c=>c.status==='done').length, failedN=CARDS.filter(c=>c.status==='failed').length;
+  $('#stTotal').textContent=total;
+  const pct= total? Math.round(doneN/total*100):0;
+  $('#stDoneRate').textContent=`完成率 ${pct}%（${doneN}/${total}）`;
+  $('#stDoneBar').style.width=pct+'%';
+  $('#stFailed').textContent= failedN? `失败 ${failedN}` : '';
+  // 空看板引导：一个任务都没有时给出上手入口（含示例）
+  if(!CARDS.length){
+    cols.pending.innerHTML=`<div class="board-guide">
+      还没有任何任务<br/>把要做的事写成一张张卡牌，Agent 会按依赖与优先级自动调度执行
+      <div class="bg-actions">
+        <button class="btn primary" onclick="openEdit(null)">＋ 新建第一个任务</button>
+        <button class="btn" id="btnExamples">📦 载入示例任务</button>
+      </div></div>`;
+    const be=$('#btnExamples'); if(be) be.onclick=loadExamples;
+    for(const k of ['running','done','failed']) cols[k].innerHTML='<div class="empty">—</div>';
+    return;
+  }
+  // 搜索无匹配：给出明确反馈与一键清除
+  if(q && !shown.length){
+    cols.pending.innerHTML=`<div class="board-guide">没有匹配「${esc(q)}」的任务<div class="bg-actions"><button class="btn" onclick="document.getElementById('cardFilter').value='';render()">清除搜索</button></div></div>`;
+    for(const k of ['running','done','failed']) cols[k].innerHTML='<div class="empty">—</div>';
+    return;
+  }
   for(const k in cols){ if(!cols[k].children.length) cols[k].innerHTML='<div class="empty">—</div>'; }
 }
 
+// 载入示例：三张卡展示三种执行模式与依赖关系（可编辑/删除，当作模板随意改造）
+async function loadExamples(){
+  const mk = (title, content, extra) => post('/api/cards', Object.assign({ title, content }, extra||{})).then(r=>r.card);
+  const a = await mk('示例A · 独立任务', '列出当前工作目录下的全部文件，并统计各类型文件的数量。', { priority: 1 });
+  await mk('示例B · 续聊任务', '接续上一个任务的结论：把统计结果整理成一份 markdown 表格。', { priority: 2, mode: 'continue', chainId: a.id, dependsOn: [a.id] });
+  await mk('示例C · 并行任务', '查询今日天气概况并给出一句话总结（与示例A/B 互不依赖，可同时执行）。', { priority: 3, mode: 'parallel' });
+  await loadCards();
+  toast('已载入 3 个示例任务，点击「开始编排」体验');
+}
+
+// 单卡停止：执行中的任务杀进程并复位为待执行（本轮编排不再自动调度）
+async function stopOne(id){
+  const c=CARDS.find(x=>x.id===id);
+  if(!c || c.status!=='running') return;
+  if(!confirm(`停止任务「${c.title}」？该任务将复位为待执行，本轮编排不再自动调度它。`)) return;
+  const r=await post('/api/cards/'+id+'/stop');
+  if(!r.success) toast(r.error||'停止失败');
+  await loadCards();
+}
+
 // ---- 编辑/新建 ----
 // 候选列表排除自身：禁止把自己选为依赖/链首（防自环）
 function fillSelectors(){
@@ -458,7 +628,11 @@ $('#btnEditSave').onclick=async()=>{
     dependsOn:deps };
   if(EDIT_ID) await api('/api/cards/'+EDIT_ID,{method:'PUT',headers:{'Content-Type':'application/json'},body:JSON.stringify(body)});
   else await post('/api/cards',body);
-  $('#maskEdit').classList.remove('show'); await loadCards(); toast('已保存');
+  $('#maskEdit').classList.remove('show');
+  await loadCards();
+  // 编排状态联动提示：编排进行中=新卡自动加入调度；空闲=明确告知需手动开始
+  if(!EDIT_ID) toast($('#btnRun').disabled ? '已保存，新任务将自动加入本轮调度' : '已保存。当前编排空闲，点「▶ 开始编排」执行');
+  else toast('已保存');
 };
 async function delCard(id){ if(!confirm('确认删除该任务？将移入垃圾桶（30 天内可还原）。'))return; await api('/api/cards/'+id,{method:'DELETE'}); await loadCards(); toast('已移入垃圾桶'); }
 $('#btnClear').onclick=async()=>{ if(!confirm('清空全部任务？将移入垃圾桶（30 天内可还原）。'))return; await post('/api/cards/clear'); await loadCards(); };
@@ -481,6 +655,13 @@ $('#parallelSel').onchange=async()=>{
 $('#dExport').onclick=()=>{ if(!OPEN_ID)return; window.open('/api/cards/'+encodeURIComponent(OPEN_ID)+'/export.md','_blank'); };
 async function runOne(id){
   const c=CARDS.find(x=>x.id===id);
+  // 依赖未完成时显式确认：让「立即执行会绕过依赖」这件事说清楚
+  if(c && c.status==='pending' && c.dependsOn && c.dependsOn.length){
+    const undone = c.dependsOn.filter(d=>{ const dc=CARDS.find(x=>x.id===d); return !dc || dc.status!=='done'; });
+    if(undone.length){
+      if(!confirm(`该任务还有 ${undone.length} 个依赖未完成（调度器会等它们完成后才自动执行）。\n立即执行将忽略依赖直接运行，确认？`)) return;
+    }
+  }
   // 重跑保护：已有结果时先确认（旧结果会归档进过程日志）
   if(c && (c.status==='done'||c.status==='failed') && c.result){
     if(!confirm('重新执行将把上次结果归档到过程日志，然后开始新一轮执行。确认？')) return;
@@ -548,6 +729,10 @@ async function openDetail(id){
   $('#dMeta').innerHTML=badge(card)+`<span class="badge">${card.status}</span>`;
   const depTitles = (card.dependsOn||[]).map(d=>{const c=CARDS.find(x=>x.id===d);return c?c.title:d;});
   $('#dDeps').textContent = depTitles.length ? ('依赖：'+depTitles.join('、')) : '';
+  // 任务内容：详情首先呈现「这个任务要求做什么」，不必再点编辑查看
+  const cbox=$('#dContent');
+  if(card.content) cbox.textContent=card.content;
+  else cbox.innerHTML='<span class="empty">（无任务内容）</span>';
   // 失败原因块：任务执行错误优先，其次追加聊天的错误
   const errBox=$('#dError');
   const errText = card.error || card.followupError || '';
@@ -567,6 +752,8 @@ async function openDetail(id){
   log.scrollTop=log.scrollHeight;
   const res=$('#dResult');
   if(card.result) res.textContent=card.result; else res.innerHTML='<span class="empty">尚未产生结果</span>';
+  const rCopy=$('#dResultCopy');
+  if(rCopy){ rCopy.disabled=!card.result; rCopy.title=card.result?'复制完整结果文本':'尚无结果可复制'; rCopy.onclick=()=>copyText(card.result||'', rCopy); }
   $('#dRun').style.display = (card.status==='running')?'none':'inline-block';
   // 追加聊天：任务结束（非 pending/running）即可用；无会话时提示限制
   const fuOk = card.status!=='pending' && card.status!=='running';
@@ -738,7 +925,8 @@ async function refreshProcs(){
     const d = await api('/api/cards/processes');
     const procs = d.processes||[];
     const bar=$('#procBar');
-    if(!procs.length){ bar.innerHTML='<span class="ptitle">进程：</span><span class="proc-empty">无运行中的 opencode 进程</span>'; return; }
+    const kname = (RUNNER_INFO && RUNNER_INFO.label) || 'opencode';
+    if(!procs.length){ bar.innerHTML='<span class="ptitle">进程：</span><span class="proc-empty">无运行中的 '+esc(kname)+' 进程</span>'; return; }
     bar.innerHTML='<span class="ptitle">进程：</span>'+procs.map(p=>{
       const working=p.working;
       return `<span class="proc-chip ${working?'':'idle'}"><span class="dot"></span><span class="pid">PID ${p.pid}</span><span class="st">${working?'工作中':'空闲'}</span></span>`;
@@ -773,8 +961,17 @@ function notifyDone(done,failed){
   }catch{ /* ignore */ }
 }
 const es = new EventSource('/api/cards/stream');
+// 断线重连后补拉：错过的状态迁移事件靠全量刷新弥补（init 只恢复按钮态）
+es.onopen = ()=>{ loadCards(); refreshProcs(); };
 es.onmessage = (e)=>{
   let ev; try{ ev=JSON.parse(e.data); }catch{ return; }
+  if(ev.type==='init'){ // 连接建立时的初始状态（含断线重连场景）
+    $('#statusPill').textContent = ev.running ? '编排中…' : '空闲';
+    $('#btnRun').disabled = !!ev.running; $('#btnStop').disabled = !ev.running;
+    if(ev.maxParallel) $('#parallelSel').value = String(ev.maxParallel);
+    return;
+  }
+  if(ev.type==='notice'){ toast(ev.content); }
   if(ev.type==='runner_started'){ $('#statusPill').textContent='编排中…'; $('#btnRun').disabled=true; $('#btnStop').disabled=false; }
   if(ev.type==='runner_stopped'){ $('#statusPill').textContent='空闲'; $('#btnRun').disabled=false; $('#btnStop').disabled=true; }
   if(ev.type==='all_done'){
@@ -783,17 +980,25 @@ es.onmessage = (e)=>{
   }
   if(ev.type==='ws_warning'){ toast('⚠ 工作区路径无效：'+ev.path+'，任务将在默认目录执行'); }
   if(ev.type==='followup_start'||ev.type==='followup_done'){ loadCards(); }
-  // text 为正文快照（不改变卡片状态）：仅实时渲染，不触发全量刷新，避免流式期间频繁重建 DOM
-  if(['task_start','tool','task_done','proc'].includes(ev.type)){
+  // 状态迁移事件：才触发全量刷新（text/tool 快照不改变卡片状态）
+  if(['task_start','task_done'].includes(ev.type)){
     loadCards();
     refreshProcs();
+    // 失败即时提醒（完成静默：看板移动可见 + all_done 汇总通知）
+    if(ev.type==='task_done' && ev.status==='failed') toast('✗「'+(ev.title||'任务')+'」执行失败，点击卡片查看原因');
     if(OPEN_ID && ev.cardId===OPEN_ID){
       const log=$('#dLog'); if(log.querySelector('.empty')) log.innerHTML='';
       if(ev.type==='task_start') TEXT_PARTS.clear();
-      else if(ev.type==='tool'){ appendLog(log,'🔧 ['+ev.name+'] '+(ev.summary||''),'msg-tool'); log.scrollTop=log.scrollHeight; }
       else if(ev.type==='task_done'){ loadCards().then(()=>{ if(OPEN_ID===ev.cardId) openDetail(ev.cardId); }); }
     }
   }
+  // proc 仅刷新进程条（另有 2s 轮询兜底），不重建看板 DOM
+  if(ev.type==='proc'){ refreshProcs(); }
+  // tool 事件仅在打开对应详情时追加过程日志，避免工具密集时高频全量刷新
+  if(ev.type==='tool' && OPEN_ID===ev.cardId){
+    const log=$('#dLog'); if(log.querySelector('.empty')) log.innerHTML='';
+    appendLog(log,'🔧 ['+ev.name+'] '+(ev.summary||''),'msg-tool'); log.scrollTop=log.scrollHeight;
+  }
   // 正文快照独立渲染（不依赖上面的状态事件）
   if(ev.type==='text' && OPEN_ID===ev.cardId) renderSnapText(ev);
   if(ev.type==='followup_start' && OPEN_ID===ev.cardId) TEXT_PARTS.clear();

package/app/public/index.html

@@ -66,6 +66,14 @@
   .hdr-right { display: flex; align-items: center; gap: 10px; }
 
   #messages { flex: 1; overflow-y: auto; padding: 16px 18px; }
+  /* 消息复制按钮：hover 消息行时浮现 */
+  .copy-btn { border: none; background: rgba(0,0,0,.05); color: #888; font-size: 11px; border-radius: 4px; padding: 2px 7px; cursor: pointer; opacity: 0; transition: opacity .15s; vertical-align: middle; }
+  .msg-row:hover .copy-btn, .copy-btn:focus { opacity: 1; }
+  .copy-btn:hover { background: rgba(0,0,0,.1); color: #333; }
+  .copy-btn.done { color: #07c160; opacity: 1; }
+  /* 回到最新：阅读历史时新消息不再强制拽底，悬浮按钮一键回底 */
+  #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); }
+  #jumpBtn:hover { color: #07c160; border-color: #07c160; }
   .sys-tip { text-align: center; margin: 10px 0; }
   .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; }
@@ -413,8 +421,9 @@
         <button class="cfg-btn" id="helpBtn" onclick="openHelp()" title="使用帮助">❓ 帮助</button>
       </div>
     </header>
-    <div id="groupView" style="flex:1;min-height:0;display:flex;flex-direction:column">
+    <div id="groupView" style="flex:1;min-height:0;display:flex;flex-direction:column;position:relative">
       <div id="messages"></div>
+      <button id="jumpBtn" onclick="jumpBottom()" title="有新消息了，点击回到最新">↓ 新消息</button>
       <footer class="composer" id="groupComposer">
         <div class="input-row">
           <button id="rtBtn" onclick="toggleRoundtable()" title="圆桌讨论模式：所有被 @ 的智能体（未 @ 则全体）围绕主题轮流发言、互相反驳，管家当主持人控制轮数并总结共识与分歧">💬 圆桌</button>
@@ -666,7 +675,7 @@ let curOcModel = '';           // 当前选中模型（localStorage 记忆）
 
 const input = document.getElementById('input');
 
-function esc(s) { const d = document.createElement('div'); d.textContent = s == null ? '' : String(s); return d.innerHTML; }
+function esc(s) { const d = document.createElement('div'); d.textContent = s == null ? '' : String(s); return d.innerHTML.replace(/"/g, '&quot;').replace(/'/g, '&#39;'); }
 function escAttr(s) { return String(s == null ? '' : s).replace(/&/g,'&amp;').replace(/"/g,'&quot;').replace(/</g,'&lt;'); }
 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())}`; }
@@ -731,6 +740,17 @@ async function init() {
 
   input.addEventListener('input', handleAtInput);
   input.addEventListener('blur', () => setTimeout(hideAt, 150));
+  // 消息区滚动：贴底时收起「新消息」悬浮按钮
+  document.getElementById('messages').addEventListener('scroll', () => {
+    if (atBottom()) { const j = document.getElementById('jumpBtn'); if (j) j.style.display = 'none'; }
+  });
+  // 输入历史回填：输入框为空时按 ↑ 调出最近发送的一条（再按 Enter 直接重发）
+  input.addEventListener('keydown', (e) => {
+    if (e.key === 'ArrowUp' && input.value === '' && lastSentInputs.length) {
+      e.preventDefault();
+      input.value = lastSentInputs[lastSentInputs.length - 1];
+    }
+  });
   input.addEventListener('keydown', (e) => {
     if (atState) {
       if (e.key === 'ArrowDown') { e.preventDefault(); atState.active = (atState.active + 1) % atState.items.length; renderAt(); return; }
@@ -897,7 +917,7 @@ function soloMsgNode(m) {
     row.className = 'msg-row self';
     row.innerHTML = `
       <div class="avatar me">我</div>
-      <div class="msg-body"><div class="bubble right">${esc(m.content)}</div></div>`;
+      <div class="msg-body"><div class="msg-name" style="text-align:right"><button class="copy-btn" onclick="copyText(decodeURIComponent('${encodeURIComponent(m.content || '')}'), this)">复制</button></div><div class="bubble right">${esc(m.content)}</div></div>`;
     return row;
   }
   // assistant：Markdown 渲染（opencode 输出天然是 Markdown）
@@ -906,7 +926,7 @@ function soloMsgNode(m) {
   row.innerHTML = `
     <div class="avatar solo-av">🤖</div>
     <div class="msg-body">
-      <div class="msg-name">${esc(m.agentName || 'OpenCode')}</div>
+      <div class="msg-name">${esc(m.agentName || 'OpenCode')} <button class="copy-btn" onclick="copyText(decodeURIComponent('${encodeURIComponent(m.content || '')}'), this)" title="复制原始文本（含 Markdown 源码）">复制</button></div>
       <div class="bubble left solo-bubble"><div class="solo-part-md">${renderMd(m.content || '')}</div></div>
     </div>`;
   return row;
@@ -1542,6 +1562,30 @@ function renderHeader() {
 
 // ---------- 消息渲染 ----------
 function scrollBottom() { const box = document.getElementById('messages'); box.scrollTop = box.scrollHeight; }
+// 贴底判定：滚离底部超过 80px 视为「正在阅读历史」，新消息不再强制拽底
+function atBottom() { const b = document.getElementById('messages'); return !b || (b.scrollHeight - b.scrollTop - b.clientHeight < 80); }
+// 跟随滚动：贴底时自动滚到最新；阅读历史时改亮「新消息」按钮
+function followScroll() {
+  if (atBottom()) scrollBottom();
+  else { const j = document.getElementById('jumpBtn'); if (j) j.style.display = 'block'; }
+}
+function jumpBottom() { scrollBottom(); const j = document.getElementById('jumpBtn'); if (j) j.style.display = 'none'; }
+
+// 文本复制（优先剪贴板 API，旧环境回退 execCommand），按钮成功后短暂反馈
+function copyText(text, btn) {
+  const done = () => { if (!btn) return; const old = btn.textContent; btn.textContent = '已复制'; btn.classList.add('done'); setTimeout(() => { btn.textContent = old; btn.classList.remove('done'); }, 1200); };
+  const s = String(text == null ? '' : text);
+  if (navigator.clipboard && navigator.clipboard.writeText) {
+    navigator.clipboard.writeText(s).then(done).catch(() => { fallbackCopy(s); done(); });
+  } else { fallbackCopy(s); done(); }
+}
+function fallbackCopy(s) {
+  const ta = document.createElement('textarea');
+  ta.value = s; ta.style.cssText = 'position:fixed;opacity:0';
+  document.body.appendChild(ta); ta.select();
+  try { document.execCommand('copy'); } catch { /* ignore */ }
+  document.body.removeChild(ta);
+}
 
 function planNode(m) {
   const row = document.createElement('div');
@@ -1559,7 +1603,7 @@ function planNode(m) {
   row.innerHTML = `
     <div class="avatar butler">🎩</div>
     <div class="msg-body">
-      <div class="msg-name">管家 · 调度规划</div>
+      <div class="msg-name">管家 · 调度规划 <button class="copy-btn" onclick="copyText(decodeURIComponent('${encodeURIComponent((p && p.thought) || m.content || '')}'), this)" title="复制规划思路">复制</button></div>
       <div class="bubble left plan-card">${inner}</div>
     </div>`;
   return row;
@@ -1708,7 +1752,7 @@ function msgNode(m) {
     row.className = 'msg-row self';
     row.innerHTML = `
       <div class="avatar me">我</div>
-      <div class="msg-body"><div class="bubble right">${esc(m.content)}</div></div>`;
+      <div class="msg-body"><div class="msg-name" style="text-align:right"><button class="copy-btn" onclick="copyText(decodeURIComponent('${encodeURIComponent(m.content || '')}'), this)">复制</button></div><div class="bubble right">${esc(m.content)}</div></div>`;
     return row;
   }
   if (m.phase === 'plan') return planNode(m);
@@ -1722,7 +1766,7 @@ function msgNode(m) {
   row.innerHTML = `
     <div class="avatar ${m.agentId === butlerId ? 'butler' : ''}" style="${m.agentId === butlerId ? '' : `background:${colorOf(m.agentId || 'x')}`}">${avIcon}</div>
     <div class="msg-body">
-      <div class="msg-name">${esc(m.agentName || m.agentId || 'AI')}${m.agentId === butlerId ? ' · 管家' : ''}</div>
+      <div class="msg-name">${esc(m.agentName || m.agentId || 'AI')}${m.agentId === butlerId ? ' · 管家' : ''} <button class="copy-btn" onclick="copyText(decodeURIComponent('${encodeURIComponent(m.content || '')}'), this)" title="复制原始文本（含 Markdown 源码）">复制</button></div>
       ${bodyHtml}
       ${m.outputPath ? `<div class="msg-file" ${/\.md$/i.test(m.outputPath) ? `data-path="${escAttr(m.outputPath)}" title="点击预览该 Markdown 存档"` : `title="系统过程存档：该智能体本阶段完整输出（内部交接用）。用户最终要的成果文件在产出存档目录中，以管家交付清单里的完整路径为准"`}>📄 过程存档 ${fileNodeText(m.outputPath)}</div>` : ''}
     </div>`;
@@ -1742,17 +1786,18 @@ function renderMessages() {
     finalizeMsgLinks(m); // 定稿消息中的 .md 路径变成可点击预览链接
   }
   scrollBottom();
+  const jb = document.getElementById('jumpBtn'); if (jb) jb.style.display = 'none';
 }
 
 // 追加或更新一条流式消息（仅当前会话操作 DOM）
 function ensureMsgDom(m) {
   const key = sessKey(m.taskId || curTaskId);
   if (key !== curKey()) return;
-  if (m._dom && document.contains(m._dom)) { if (m._tx) m._tx.textContent = m.content; scrollBottom(); return; }
+  if (m._dom && document.contains(m._dom)) { if (m._tx) m._tx.textContent = m.content; followScroll(); return; }
   const node = msgNode(m);
   m._dom = node;
   document.getElementById('messages').appendChild(node);
-  scrollBottom();
+  followScroll();
 }
 
 function pushMsg(m) {
@@ -1851,7 +1896,7 @@ function onSaved(ev) {
         }
         file.innerHTML = '📄 过程存档 ' + fileNodeText(ev.path);
         m._dom.querySelector('.msg-body').appendChild(file);
-        scrollBottom();
+        followScroll();
       }
       finalizeMsgLinks(m); // 交付文本中的成果文件路径也变成可点击链接
       return;
@@ -1940,6 +1985,7 @@ async function stopRun(scope) {
   } catch { toast('停止请求失败，请重试'); }
 }
 
+let lastSentInputs = []; // 输入历史（空输入框按 ↑ 回填最近一条）
 async function send() {
   const text = input.value.trim();
   if (!text || chatBusy) return;
@@ -1950,6 +1996,10 @@ async function send() {
   try {
     input.value = '';
     hideAt();
+    if (lastSentInputs[lastSentInputs.length - 1] !== text) {
+      lastSentInputs.push(text);
+      if (lastSentInputs.length > 20) lastSentInputs.shift();
+    }
     pushUser(text);
     typing = addSys('智能体处理中…');
 
@@ -2131,7 +2181,7 @@ async function openHistory() {
       if (m.role === 'sys') {
         html += `<div class="sys-tip"><span>${esc(m.content)}</span></div>`;
       } else if (m.role === 'user') {
-        html += `<div class="msg-row self"><div class="avatar me">我</div><div class="msg-body"><div class="bubble right">${esc(m.content)}</div></div></div>`;
+        html += `<div class="msg-row self"><div class="avatar me">我</div><div class="msg-body"><div class="msg-name" style="text-align:right"><button class="copy-btn" onclick="copyText(decodeURIComponent('${encodeURIComponent(m.content || '')}'), this)">复制</button></div><div class="bubble right">${esc(m.content)}</div></div></div>`;
       } else if (m.phase === 'plan' && m.plan) {
         html += `<div class="msg-row"><div class="avatar butler">🎩</div><div class="msg-body"><div class="msg-name">${esc(m.agentName || '管家')} · 调度规划</div><div class="bubble left plan-card"><div class="plan-thought">${esc(m.plan.thought || '')}</div>${(m.plan.phases || []).map((g, gi) => `<div class="plan-phase"><b>阶段 ${gi + 1}</b>（${g.length > 1 ? g.length + ' 项并行' : '单执行'}）${g.map(s => `<div class="plan-step">▸ <b>${esc(s.agentName)}</b>：${esc(s.instruction)}</div>`).join('')}</div>`).join('')}</div></div></div>`;
       } else {
@@ -2140,7 +2190,7 @@ async function openHistory() {
         const contentHtml = isFoldPhase(m.phase)
           ? `<div class="bubble left"><div class="fold-wrap">${tag}${linkifyMd(esc(m.content))}</div><div class="fold-toggle" onclick="toggleFoldEl(this)">展开全文 ▾</div></div>`
           : `<div class="bubble left">${tag}${linkifyMd(esc(m.content))}</div>`;
-        html += `<div class="msg-row"><div class="avatar ${m.agentId === butlerId ? 'butler' : ''}" style="${m.agentId === butlerId ? '' : `background:${colorOf(m.agentId || 'x')}`}">${esc(agentIcon(m.agentId, m.agentName))}</div><div class="msg-body"><div class="msg-name">${esc(m.agentName || m.agentId || 'AI')}</div>${contentHtml}${fileTag}</div></div>`;
+        html += `<div class="msg-row"><div class="avatar ${m.agentId === butlerId ? 'butler' : ''}" style="${m.agentId === butlerId ? '' : `background:${colorOf(m.agentId || 'x')}`}">${esc(agentIcon(m.agentId, m.agentName))}</div><div class="msg-body"><div class="msg-name">${esc(m.agentName || m.agentId || 'AI')} <button class="copy-btn" onclick="copyText(decodeURIComponent('${encodeURIComponent(m.content || '')}'), this)" title="复制原始文本（含 Markdown 源码）">复制</button></div>${contentHtml}${fileTag}</div></div>`;
       }
     }
     el.innerHTML = html;

package/app/server.js

@@ -298,7 +298,9 @@ const server = http.createServer(async (req, res) => {
       configKernel: String(store.getConfig().kernel || 'auto'),
       model: process.env.AGENTS_CHAT_MODEL || '',
       autoApprove: process.env.AGENTS_CHAT_AUTO_APPROVE !== '0',
-      port: PORT
+      port: PORT,
+      // 数据损坏保护：损坏数据文件清单（已备份 .corrupt-*，写入已冻结，需人工处理）
+      corruptedDataFiles: store.getCorruptedFiles()
     });
     return;
   }
@@ -948,7 +950,18 @@ const server = http.createServer(async (req, res) => {
     try {
       for (const m of store.getMessages()) if (m.taskId) counts[m.taskId] = (counts[m.taskId] || 0) + 1;
     } catch { /* ignore */ }
-    json(res, 200, { success: true, cards, running: cardRunner.isRunning(), maxParallel: cardRunner.maxP(), msgCounts: counts, config: CardStore.getConfig() });
+    // 执行内核状态（前端据此显示内核徽标/缺失警告）与追加聊天进行中的卡
+    let runnerInfo = { kind: 'unknown', label: '' };
+    try {
+      const { resolveRunner } = require('./lib/agent');
+      const r = resolveRunner();
+      runnerInfo = { kind: r.kind, label: r.kernel ? r.kernel.label : '' };
+    } catch { /* ignore */ }
+    const { getCorruptedFiles } = require('./lib/cards');
+    json(res, 200, {
+      success: true, cards, running: cardRunner.isRunning(), maxParallel: cardRunner.maxP(), msgCounts: counts, config: CardStore.getConfig(),
+      followupIds: cardRunner.getFollowupIds(), runner: runnerInfo, corrupted: getCorruptedFiles()
+    });
     return;
   }
 
@@ -979,6 +992,7 @@ const server = http.createServer(async (req, res) => {
     }
     if (parallelBad) { json(res, 400, { success: false, error: 'maxParallel 需在 1-8 之间' }); return; }
     const cfg = Object.keys(patch).length ? CardStore.setConfig(patch) : CardStore.getConfig();
+    if (patch.maxParallel !== undefined) cardRunner.onConfigChanged(); // 并行度调大时立即补齐
     // 工作区校验：保存允许（可能是尚未创建的目录），但路径不存在时显式警告
     let warning = '';
     const ws = (cfg.workspace || '').trim();
@@ -1113,6 +1127,12 @@ const server = http.createServer(async (req, res) => {
   if (p.startsWith('/api/cards/') && req.method === 'PUT') {
     const id = p.slice('/api/cards/'.length);
     const body = await readBody(req);
+    // 运行中/追加聊天中的卡禁止编辑与重置：子进程结束时会回写状态，中途改写会产生竞争
+    const target = CardStore.get(id);
+    if (target && (target.status === 'running' || cardRunner.isFollowupRunning(id))) {
+      json(res, 409, { success: false, error: target.status === 'running' ? '任务正在执行中，无法编辑或重置，请等待完成或先停止编排' : '该任务追加聊天进行中，稍后再修改' });
+      return;
+    }
     const patch = {};
     if (body.title !== undefined) patch.title = String(body.title).slice(0, 500);
     if (body.content !== undefined) patch.content = String(body.content).slice(0, 20000);
@@ -1150,6 +1170,14 @@ const server = http.createServer(async (req, res) => {
     return;
   }
 
+  // 单卡停止：杀掉该卡子进程，状态复位为待执行（本轮编排不再自动调度它）
+  if (p.startsWith('/api/cards/') && req.method === 'POST' && p.endsWith('/stop')) {
+    const id = p.slice('/api/cards/'.length, -'/stop'.length);
+    const ok = cardRunner.stopOne(id);
+    json(res, ok ? 200 : 409, { success: ok, error: ok ? '' : '任务不在执行中，无法停止' });
+    return;
+  }
+
   // 追加聊天：任务完成后复用其 opencode 会话续聊（同一进程的第二轮输入）
   if (p.startsWith('/api/cards/') && req.method === 'POST' && p.endsWith('/chat')) {
     const id = p.slice('/api/cards/'.length, -'/chat'.length);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iamsamyiok/agents-chat",
-  "version": "3.20.0",
+  "version": "3.22.0",
   "description": "多智能体群聊工具 - 支持 OpenCode/Claude Code/Codex/pi 内核，微信风格聊天界面",
   "main": "lib/start.js",
   "bin": {
@@ -34,6 +34,6 @@
   "homepage": "https://github.com/iamsamyiok/agents-chat",
   "scripts": {
     "start": "node app/server.js",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "node --test \"test/*.test.js\""
   }
 }