@iamsamyiok/agents-chat 3.21.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,12 +23,11 @@ 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 }); }
-// 数据损坏保护：解析失败（文件存在但 JSON 损坏）时备份原文件并置损坏标记；
-// 后续写入直接拒绝，防止「读到空列表 → 新增一条 → 覆盖写」把用户全部卡牌冲掉
-const corrupted = new Set(); // 已损坏的文件路径
+// 数据损坏保护（safejson 公共层）：解析失败 → 备份 .corrupt-* 并只读；写入一律原子替换
+const corrupted = new Set(); // 已损坏的文件路径（本模块文件）
 function cachedReader(file, cacheBox) {
   return function read() {
-    if (corrupted.has(file)) return [];
+    if (safejson.isCorrupted(file)) return [];
     try {
       const st = fs.statSync(file);
       if (cacheBox.list && st.mtimeMs === cacheBox.mtime) return cacheBox.list;
@@ -39,11 +39,10 @@ function cachedReader(file, cacheBox) {
         cacheBox.mtime = 0; cacheBox.list = null;
         return [];
       }
-      // 文件存在但解析失败：备份损坏现场，进入只读保护
-      try { fs.copyFileSync(file, `${file}.corrupt-${Date.now()}`); } catch { /* ignore */ }
+      // 文件存在但解析失败：经 safejson 备份损坏现场并登记，进入只读保护
+      safejson.readJson(file, []);
       corrupted.add(file);
       cacheBox.mtime = 0; cacheBox.list = null;
-      console.error(`[cards] 数据文件损坏已备份并进入保护：${file}`);
       return [];
     }
   };
@@ -66,7 +65,8 @@ function invalidate(file) {
 }
 // 损坏保护下的写入守卫：拒绝覆盖写（保留备份供人工恢复）
 function guardWrite(file) {
-  if (corrupted.has(file)) {
+  if (corrupted.has(file) || safejson.isCorrupted(file)) {
+    corrupted.add(file);
     throw new Error(`数据文件 ${path.basename(file)} 已损坏（原文件已备份为 .corrupt-*），为防数据丢失已停止写入，请人工检查 ${DATA_DIR} 后删除损坏标记文件`);
   }
 }
@@ -74,9 +74,7 @@ function writeCards(list) {
   ensureDir();
   guardWrite(CARDS_PATH);
   invalidate(CARDS_PATH);
-  const tmp = CARDS_PATH + '.tmp';
-  fs.writeFileSync(tmp, JSON.stringify(list, null, 2), 'utf8');
-  fs.renameSync(tmp, CARDS_PATH);
+  safejson.writeJson(CARDS_PATH, list);
 }
 function readConfig() {
   const v = readConfigRaw();
@@ -86,16 +84,17 @@ function writeConfig(cfg) {
   ensureDir();
   guardWrite(CARDS_CFG_PATH);
   invalidate(CARDS_CFG_PATH);
-  fs.writeFileSync(CARDS_CFG_PATH, JSON.stringify(cfg, null, 2), 'utf8');
+  safejson.writeJson(CARDS_CFG_PATH, cfg);
 }
 function readTrash() {
   const v = readTrashRaw();
   return Array.isArray(v) ? v.slice() : [];
 }
 function writeTrash(list) {
+  ensureDir();
   guardWrite(TRASH_PATH);
   invalidate(TRASH_PATH);
-  fs.writeFileSync(TRASH_PATH, JSON.stringify(list, null, 2), 'utf8');
+  safejson.writeJson(TRASH_PATH, list);
 }
 // 启动时清理超过 30 天的垃圾桶快照，并连带清除其日志，避免占用磁盘
 (function purgeTrash() {
@@ -161,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;
   },
@@ -628,7 +631,7 @@ class CardRunner {
 }
 
 // 数据文件损坏状态（供 API 告警展示）
-function getCorruptedFiles() { return [...corrupted]; }
+function getCorruptedFiles() { return [...new Set([...corrupted, ...safejson.corruptedFiles()])]; }
 
 function isValidDir(p) {
   try { return fs.existsSync(p) && fs.statSync(p).isDirectory(); } catch { return false; }

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}
@@ -175,6 +186,9 @@
   <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="工作文件夹（点右侧选择）" />
@@ -196,6 +210,13 @@
 
 <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">
@@ -264,7 +285,7 @@
     <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>
@@ -332,6 +353,23 @@ async function loadCards(){
   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');
@@ -474,10 +512,20 @@ 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">
@@ -490,6 +538,12 @@ function render(){
     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>'; }
 }
 
@@ -698,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';

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;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iamsamyiok/agents-chat",
-  "version": "3.21.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\""
   }
 }