mingdao-harness 0.6.21 → 0.6.22

package/docs/CONFIG.md

@@ -394,6 +394,22 @@ completion 计费，防止推理吃满上限时空轮白烧）、`compactTrigger
 
 长期偏好仍走用户记忆（`AGENTS.md`，见上），不受此开关影响。
 
+### WebUI 会话列表字段与消息时间（v0.6.22，§3.84）
+
+`GET /api/sessions` 的每一项在既有 `file` / `mtime` / `label` 之外**只增**三个只读字段：
+
+| 字段 | 含义 | 来源 |
+| --- | --- | --- |
+| `updatedAt` | 会话最后更新时间，ISO 字符串 | 会话文件 mtime |
+| `messageCount` | 该会话的 JSONL 消息条数（坏行跳过） | 只读解析文件 |
+| `title` | 会话标题（已有文件名即标题；自动标题/重命名都落在文件名上） | 文件名去 `.jsonl` |
+
+`GET /api/session?file=` 的每条消息**只增** `ts`（ISO 字符串）。旧会话（v0.6.21 及以前写的
+JSONL 没有 `ts`）返回 `"ts": null`，其余字段语义不变；WebUI 对 `ts` 为 `null` 的消息不渲染时间，
+不会出现 `Invalid Date` / `undefined`。新消息在**服务端落盘时**写入 `ts`（压缩重写保留已有值），
+前端不自行推算历史消息时间。分组（今天/昨天/本周/更早）与时间显示都在 `src/web/app.js`；
+分组只在会话列表刷新时计算一次，不引入轮询。
+
 ## 模型名称以 API 为准（v0.6.19，§3.67）
 
 **仓库不维护具体版本号，只维护「家族能力 / 定价模式」。** 官方改名、升版本（例如

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mingdao-harness",
-  "version": "0.6.21",
+  "version": "0.6.22",
   "description": "MingDao Harness —— 开源智能体框架（Agent Harness）。零依赖、开箱即用，针对 DeepSeek-V4 系列优化，开放主流模型接入。",
   "type": "module",
   "bin": {

package/src/web/app.js

@@ -224,16 +224,87 @@ chatEl.addEventListener('click', (e) => {
   const done = () => { b.textContent = '已复制'; setTimeout(() => { b.textContent = '复制'; }, 1200); };
   if (navigator.clipboard?.writeText) navigator.clipboard.writeText(t).then(done).catch(() => {});
 });
+// ==== v0.6.22 §3.84 会话分组 + 消息时间（纯函数，test/ui-sessions.js 可直接抽取执行）====
+// 只做展示：分组顺序固定「今天 → 昨天 → 本周 → 更早」，组标题不可点击/不可折叠。
+// 「现在」一律由调用方传入（默认 new Date()），测试用固定 now 避免跨午夜抖动。
+const SESSION_GROUP_ORDER = ['today', 'yesterday', 'week', 'earlier'];
+const SESSION_GROUP_TITLES = { today: '今天', yesterday: '昨天', week: '本周', earlier: '更早' };
+
+/** 取本地时区某一天的 00:00（用日期构造器而非减 86400000，跨夏令时也不会偏一小时）。 */
+function localDayStart(d) {
+  return new Date(d.getFullYear(), d.getMonth(), d.getDate()).getTime();
+}
+
+/**
+ * 单个会话落在哪个分组。时间不可解析/缺失 → earlier（绝不抛错）。
+ * 边界：今天 00:00 起算今天；昨天 00:00 起算昨天；本周从周一 00:00 起算。
+ * @param {string|number|Date|undefined|null} updatedAt
+ * @param {Date} [now]
+ * @returns {string}
+ */
+function sessionGroupKey(updatedAt, now) {
+  const t = new Date(updatedAt == null ? NaN : updatedAt).getTime();
+  const n = now instanceof Date ? now : new Date(now == null ? Date.now() : now);
+  if (!Number.isFinite(t) || Number.isNaN(n.getTime())) return 'earlier';
+  const today = localDayStart(n);
+  if (t >= today) return 'today';
+  const yesterday = new Date(n.getFullYear(), n.getMonth(), n.getDate() - 1).getTime();
+  if (t >= yesterday) return 'yesterday';
+  const dow = (n.getDay() + 6) % 7; // 周一 = 0
+  const weekStart = new Date(n.getFullYear(), n.getMonth(), n.getDate() - dow).getTime();
+  if (t >= weekStart) return 'week';
+  return 'earlier';
+}
+
+/**
+ * 一次性把会话列表分到四个桶（空桶不返回；顺序固定）。调用方只在数据刷新时调用一次，
+ * 渲染函数只读 `sessionsGroupedCache`——不得在每次渲染时重算。
+ * @param {any[]} sessions
+ * @param {Date} [now]
+ * @returns {{key:string,title:string,items:any[]}[]}
+ */
+function groupSessionsByUpdatedAt(sessions, now) {
+  /** @type {Record<string, any[]>} */
+  const buckets = { today: [], yesterday: [], week: [], earlier: [] };
+  for (const s of sessions || []) {
+    // updatedAt 是 v0.6.22 新增字段；mtime 是旧接口既有字段（毫秒），两者都能分组。
+    buckets[sessionGroupKey(s && (s.updatedAt ?? s.mtime), now)].push(s);
+  }
+  return SESSION_GROUP_ORDER
+    .filter((key) => buckets[key].length > 0)
+    .map((key) => ({ key, title: SESSION_GROUP_TITLES[key], items: buckets[key] }));
+}
+
+/**
+ * 消息时间文案：同一天 `14:32`；跨天 `10-19 14:32`；缺失/非法 → ''（前端不渲染任何节点，
+ * 所以不会出现 "Invalid Date" / "undefined"）。
+ * @param {any} ts
+ * @param {Date} [now]
+ * @returns {string}
+ */
+function msgTimeText(ts, now) {
+  if (typeof ts !== 'string' || !ts.trim()) return '';
+  const d = new Date(ts);
+  if (Number.isNaN(d.getTime())) return '';
+  const n = now instanceof Date ? now : new Date(now == null ? Date.now() : now);
+  if (Number.isNaN(n.getTime())) return '';
+  const hm = String(d.getHours()).padStart(2, '0') + ':' + String(d.getMinutes()).padStart(2, '0');
+  const sameDay = d.getFullYear() === n.getFullYear() && d.getMonth() === n.getMonth() && d.getDate() === n.getDate();
+  if (sameDay) return hm;
+  return String(d.getMonth() + 1).padStart(2, '0') + '-' + String(d.getDate()).padStart(2, '0') + ' ' + hm;
+}
+// ==== /v0.6.22 §3.84 ====
+
 let generating = false; // 生成中：发送按钮复用为停止按钮
 let currentSession = null, thinking = null;
 
 
 
-function newAiMsg(){ const el=document.createElement('div'); el.className='msg-ai'; chatEl.appendChild(el); scrollBottom(); return el; }
+function newAiMsg(ts){ const el=document.createElement('div'); el.className='msg-ai'; const t=msgTimeText(ts); if(t){ const m=document.createElement('div'); m.className='msg-time'; m.textContent=t; el.appendChild(m); } chatEl.appendChild(el); scrollBottom(); return el; }
 function aiContent(msg){ const c=msg.querySelector('.content'); return c || (()=>{const d=document.createElement('div');d.className='content';msg.appendChild(d);return d;})(); }
 function addReasoning(msg){ const d=document.createElement('details'); d.className='reasoning'; d.innerHTML='<summary>思考过程</summary><div class="body"></div>'; msg.appendChild(d); return d.querySelector('.body'); }
 
-function addUser(text){ const el=document.createElement('div'); el.className='msg-user'; el.innerHTML='<div class="bubble">'+esc(text)+'</div>'; chatEl.appendChild(el); renderEmptyState(); scrollBottom(); }
+function addUser(text, ts){ const el=document.createElement('div'); el.className='msg-user'; const t=msgTimeText(ts); el.innerHTML='<div class="bubble">'+esc(text)+(t?'<span class="msg-time">'+esc(t)+'</span>':'')+'</div>'; chatEl.appendChild(el); renderEmptyState(); scrollBottom(); }
 
 const runningTools = new Map();
 // P1-1 工具时间线（v0.6.19 §3.70）保留为轨迹详情的渲染原语（toolStepNode/paintToolStep/
@@ -484,8 +555,8 @@ async function send(){
   if(attachments.length) payload.attachments=attachments;
   const sentAttachments=attachments;
   attachments=[]; renderAttachments();
-  addUser(text||(sentAttachments.map(a=>(a.type==='image'?'🖼 ':'📄 ')+a.name).join(' ')));
-  const msg=newAiMsg(); const content=aiContent(msg); let raw='';
+  addUser(text||(sentAttachments.map(a=>(a.type==='image'?'🖼 ':'📄 ')+a.name).join(' ')), new Date().toISOString());
+  const msg=newAiMsg(new Date().toISOString()); const content=aiContent(msg); let raw='';
   activeAiMsg=msg; msg._traj=[]; msg._steps=0; msg._round=++turnSeq; msg._startedAt=Date.now(); msg._endedAt=null; pendingSubagent=null; curSteps=0; curWorkT0=Date.now();
   // P0-1：本轮开始 → 运行状态条归零（上一轮的费用/首帧/工具数不许泄漏到本轮；上下文基数保留）
   runState.rawPhase='发请求（等首帧）'; runState.phase='等首帧'; runState.aborted=false;
@@ -1159,6 +1230,8 @@ function layoutClassesFor(width) {
 // 快捷键表 / 会话设置 / 空态 / 设置搜索 / 诊断。全部消费上面纯函数的结果。
 // ============================================================================
 let sessionsCache = [];
+// §3.84：分组只在 refreshSessions 里算一次；下拉/会话管理列表都只读这份缓存（不随渲染重算）。
+let sessionsGroupedCache = [];
 let workspacesCache = [];
 let currentWorkspaceName = '';
 let modelsCache = [];
@@ -2273,8 +2346,14 @@ async function refreshSessions(q){
   const r=await fetch(u).catch(()=>null); if(!r)return;
   const j=await r.json();
   sessionsCache=Array.isArray(j.sessions)?j.sessions:[];
+  sessionsGroupedCache=groupSessionsByUpdatedAt(sessionsCache); // 一次性分组（性能：不在渲染时重算）
   const sel=$('#sessions'); sel.innerHTML='<option value="">历史会话</option>';
-  for(const s of sessionsCache){ const o=document.createElement('option'); o.value=s.file; o.textContent=s.label; sel.appendChild(o); }
+  for(const g of sessionsGroupedCache){
+    // 原生 optgroup 的组标题由系统渲染：不可点击、不可折叠——正好符合"保持简单"。
+    const og=document.createElement('optgroup'); og.label=g.title;
+    for(const s of g.items){ const o=document.createElement('option'); o.value=s.file; o.textContent=s.label; og.appendChild(o); }
+    sel.appendChild(og);
+  }
   if(currentSession&&!q) sel.value=currentSession;
   renderCrumb();
 }
@@ -2850,7 +2929,7 @@ function finalizeCurrentSession(){
   if(!currentSession) return;
   fetch('/api/session-finalize',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({file:currentSession})}).catch(()=>{});
 }
-async function loadSession(file){ if(currentSession && currentSession!==file) finalizeCurrentSession(); currentSession=file; chatEl.innerHTML=''; resetTraceState(); const r=await fetch('/api/session?file='+encodeURIComponent(file)); const j=await r.json(); for(const m of j.messages||[]){ if(typeof m.content==='string'&&m.content.startsWith('（系统提示）')) continue; if(m.role==='user') addUser(m.content); else { const el=newAiMsg(); aiContent(el).innerHTML=renderMarkdown(m.content); } } if(j.workspace){ const sel=$('#wsSel'); const has=[...sel.options].some(o=>o.value===j.workspace); if(has){ sel.value=j.workspace; } else { refreshWsSel(); } renderBanner({text:'↩ 已回到该会话的工作空间：'+j.workspace}); } if(j.taskState&&(j.taskState.status==='cap'||j.taskState.status==='interrupted')){ renderBanner({text:'⚠ 该会话有未完成任务（步数上限中断）——直接发送消息即可从断点续跑，已完成文件不会重复做。', warn:true}); } scrollBottom(); renderEmptyState(); renderCrumb(); }
+async function loadSession(file){ if(currentSession && currentSession!==file) finalizeCurrentSession(); currentSession=file; chatEl.innerHTML=''; resetTraceState(); const r=await fetch('/api/session?file='+encodeURIComponent(file)); const j=await r.json(); for(const m of j.messages||[]){ if(typeof m.content==='string'&&m.content.startsWith('（系统提示）')) continue; if(m.role==='user') addUser(m.content, m.ts); else { const el=newAiMsg(m.ts); aiContent(el).innerHTML=renderMarkdown(m.content); } } if(j.workspace){ const sel=$('#wsSel'); const has=[...sel.options].some(o=>o.value===j.workspace); if(has){ sel.value=j.workspace; } else { refreshWsSel(); } renderBanner({text:'↩ 已回到该会话的工作空间：'+j.workspace}); } if(j.taskState&&(j.taskState.status==='cap'||j.taskState.status==='interrupted')){ renderBanner({text:'⚠ 该会话有未完成任务（步数上限中断）——直接发送消息即可从断点续跑，已完成文件不会重复做。', warn:true}); } scrollBottom(); renderEmptyState(); renderCrumb(); }
 
 // §138：主按钮在生成态=停止，必须走**同一个**停止出口（stopTurnFromButton → stopTurn → POST /api/abort）
 sendBtn.onclick=()=>{ if(generating){ stopTurnFromButton(); } else { send(); } };
@@ -2861,15 +2940,19 @@ $('#sessMgrBtn').onclick=openSessModal;
 $('#sessClose').onclick=()=>{ $('#sessModal').style.display='none'; };
 async function openSessModal(){
   $('#sessModal').style.display='flex';
-  const r=await fetch('/api/sessions',{cache:'no-store'}); const j=await r.json();
+  await refreshSessions(); // 复用同一次分组缓存：打开管理面板不再单独算一遍
   const list=$('#sessList'); list.innerHTML='';
-  if(!j.sessions.length){ list.innerHTML='<div style="color:var(--faint);font-size:12px;padding:6px">暂无会话</div>'; return; }
-  for(const s of j.sessions){
-    const div=document.createElement('div'); div.style.cssText='display:flex;align-items:center;gap:8px;padding:6px 0;border-bottom:1px solid var(--border);font-size:12.5px';
-    div.innerHTML='<span style="flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap">'+esc(s.label)+'</span>';
-    const rn=document.createElement('button'); rn.textContent='重命名'; rn.style.cssText='padding:1px 8px;font-size:11px'; rn.onclick=async()=>{ const t=await uiPrompt('新标题：', s.file.replace(/\.jsonl$/,'')); if(!t) return; const rr=await fetch('/api/session',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'rename',file:s.file,title:t})}); const jj=await rr.json().catch(()=>({error:'失败'})); if(jj.ok){ refreshSessions(); openSessModal(); } else uiAlert(jj.error||'重命名失败'); };
-    const dl=document.createElement('button'); dl.textContent='删除'; dl.className='danger'; dl.style.cssText='padding:1px 8px;font-size:11px'; dl.onclick=async()=>{ if(!await uiConfirm('删除会话 '+s.file+'？此操作不可恢复。')) return; const rr=await fetch('/api/session',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'delete',file:s.file})}); const jj=await rr.json().catch(()=>({error:'失败'})); if(jj.ok){ if(currentSession===s.file){ currentSession=null; chatEl.innerHTML=''; renderEmptyState(); } refreshSessions(); openSessModal(); } else uiAlert(jj.error||'删除失败'); };
-    div.appendChild(rn); div.appendChild(dl); list.appendChild(div);
+  if(!sessionsCache.length){ list.innerHTML='<div style="color:var(--faint);font-size:12px;padding:6px">暂无会话</div>'; return; }
+  for(const g of sessionsGroupedCache){
+    // 小号次要文本、不可点击、不可折叠；只是分组标签。
+    const gh=document.createElement('div'); gh.className='sess-group'; gh.textContent=g.title; list.appendChild(gh);
+    for(const s of g.items){
+      const div=document.createElement('div'); div.style.cssText='display:flex;align-items:center;gap:8px;padding:6px 0;border-bottom:1px solid var(--border);font-size:12.5px';
+      div.innerHTML='<span style="flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap">'+esc(s.label)+'</span>';
+      const rn=document.createElement('button'); rn.textContent='重命名'; rn.style.cssText='padding:1px 8px;font-size:11px'; rn.onclick=async()=>{ const t=await uiPrompt('新标题：', s.file.replace(/\.jsonl$/,'')); if(!t) return; const rr=await fetch('/api/session',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'rename',file:s.file,title:t})}); const jj=await rr.json().catch(()=>({error:'失败'})); if(jj.ok){ await refreshSessions(); openSessModal(); } else uiAlert(jj.error||'重命名失败'); };
+      const dl=document.createElement('button'); dl.textContent='删除'; dl.className='danger'; dl.style.cssText='padding:1px 8px;font-size:11px'; dl.onclick=async()=>{ if(!await uiConfirm('删除会话 '+s.file+'？此操作不可恢复。')) return; const rr=await fetch('/api/session',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'delete',file:s.file})}); const jj=await rr.json().catch(()=>({error:'失败'})); if(jj.ok){ if(currentSession===s.file){ currentSession=null; chatEl.innerHTML=''; renderEmptyState(); } await refreshSessions(); openSessModal(); } else uiAlert(jj.error||'删除失败'); };
+      div.appendChild(rn); div.appendChild(dl); list.appendChild(div);
+    }
   }
 }
 $('#sessions').onchange=e=>{ if(e.target.value){ loadSession(e.target.value); } else { finalizeCurrentSession(); currentSession=null; chatEl.innerHTML=''; resetTraceState(); renderEmptyState(); renderCrumb(); } };

package/src/web/index.html

@@ -173,6 +173,12 @@ main{flex:1;overflow-y:auto;padding:18px 0 12px;min-width:0}
 .msg-user{display:flex;justify-content:flex-end}
 .msg-user .bubble{background:var(--user);border:1px solid rgba(255,255,255,.08);border-radius:22px;padding:10px 16px;max-width:min(525px,82%);white-space:pre-wrap;word-break:break-word;font-size:16px;line-height:24px}
 .msg-ai{display:flex;flex-direction:column;gap:10px;font-size:15px;color:var(--text)}
+/* §3.84：消息时间——小号次要文本；缺失 ts 时前端根本不渲染此节点（不会出现 Invalid Date / undefined）。 */
+.msg-time{font-size:11px;line-height:1.4;color:var(--dim);font-variant-numeric:tabular-nums}
+.msg-user .bubble .msg-time{display:block;text-align:right;margin-top:4px}
+.msg-ai>.msg-time{margin-bottom:-4px}
+/* §3.84：会话分组标题（今天/昨天/本周/更早）——不可点击、不折叠。 */
+.sess-group{font-size:11px;line-height:1.6;color:var(--dim);padding:7px 4px 2px;letter-spacing:.02em}
 .msg-ai .content{white-space:normal;word-break:break-word;line-height:1.75}
 .msg-ai .content h1,.msg-ai .content h2,.msg-ai .content h3,.msg-ai .content h4{color:var(--text);font-weight:700;line-height:1.4}
 .msg-ai .content h1{font-size:20px;margin:18px 0 10px;padding-bottom:8px;border-bottom:1px solid var(--border)}

package/src/web/routes/domains/sessions.js

@@ -19,6 +19,35 @@ import {
   removeSessionWorkspace,
 } from '../../../workspace.js';
 
+/**
+ * v0.6.22（§3.84）：会话列表的**只增**元数据。
+ *
+ * 只读文件、绝不改写；坏行/不可读文件按 0 条处理，不得让整个列表接口 500——
+ * 真机上确实存在历史遗留的半截 JSONL（进程被 kill 时最后一行可能不完整）。
+ * 标题沿用既有事实来源：会话文件名（自动标题 / 手工重命名都会落到文件名）。
+ * @param {string} file 会话文件绝对路径
+ * @param {string} name 会话文件名
+ * @returns {{messageCount:number,title:string}}
+ */
+function sessionMeta(file, name) {
+  let messageCount = 0;
+  try {
+    const raw = fs.readFileSync(file, 'utf8');
+    for (const line of raw.split('\n')) {
+      if (!line.trim()) continue;
+      try {
+        const m = JSON.parse(line);
+        if (m && typeof m === 'object' && ['system', 'user', 'assistant', 'tool'].includes(m.role)) messageCount += 1;
+      } catch {
+        // 单行损坏只跳过该行：旧会话/半截写入都不能把整个列表打挂。
+      }
+    }
+  } catch {
+    // 文件在 readdir 之后被删除/无权限：计数按 0，元数据仍可返回。
+  }
+  return { messageCount, title: name.replace(/\.jsonl$/, '') };
+}
+
 /**
  * 会话域路由。命中返回 true，未命中返回 false。
  * @param {{req:any,res:any,method:any,p:any,url:any}} ctx
@@ -33,9 +62,22 @@ export async function handle({ req, res, method, p, url }, deps, shared) {
 
   if (method === 'GET' && p === '/api/sessions') {
     const q = url.searchParams.get('q');
+    // v0.6.22（§3.84）：每项**只增** updatedAt / messageCount / title 三个字段；
+    // file / mtime / label 的既有语义与顺序不变（前端 crumb、命令面板、同步等仍按旧字段消费）。
+    const decorate = (/** @type {any} */ s, /** @type {string} */ label) => {
+      const meta = sessionMeta(path.join(home, 'sessions', path.basename(s.name)), s.name);
+      return {
+        file: s.name,
+        mtime: s.mtime,
+        label,
+        updatedAt: new Date(s.mtime).toISOString(),
+        messageCount: meta.messageCount,
+        title: meta.title,
+      };
+    };
     const found = q
-      ? searchSessions(home, q, { limit: 30 }).map((/** @type {any} */ s) => ({ file: s.name, mtime: s.mtime, label: `${relativeTime(s.mtime)} · ${s.snippet}` }))
-      : listSessions(home).slice(0, 30).map((s) => ({ file: s.name, mtime: s.mtime, label: `${relativeTime(s.mtime)} · ${sessionPreview(s.file)}` }));
+      ? searchSessions(home, q, { limit: 30 }).map((/** @type {any} */ s) => decorate(s, `${relativeTime(s.mtime)} · ${s.snippet}`))
+      : listSessions(home).slice(0, 30).map((s) => decorate(s, `${relativeTime(s.mtime)} · ${sessionPreview(s.file)}`));
     json(res, 200, { ok: true, sessions: found });
     return true;
   }
@@ -54,7 +96,11 @@ export async function handle({ req, res, method, p, url }, deps, shared) {
       }
       json(res, 200, {
         ok: true,
-        messages: loaded.messages.filter((m) => m.role === 'user' || m.role === 'assistant').map((m) => ({ role: m.role, content: m.content ?? '' })),
+        // v0.6.22（§3.84）：只增 ts。旧会话消息没有 ts → **null**（前端据此不显示时间），
+        // 绝不在这里用文件 mtime 冒充消息时间，也绝不因缺字段报错。
+        messages: loaded.messages
+          .filter((m) => m.role === 'user' || m.role === 'assistant')
+          .map((m) => ({ role: m.role, content: m.content ?? '', ts: typeof m.ts === 'string' && m.ts ? m.ts : null })),
         workspace: ws?.name || null,
         // v0.3.0 P0-2：未完成检查点（供前端提示续跑）
         taskState: loadTaskState(path.basename(file)),

package/src/web/server.js

@@ -77,6 +77,25 @@ import { syncStatus, syncLogin, syncLogout, syncPush, syncPull, syncRemoteList,
 
 const INDEX_HTML = path.join(path.dirname(fileURLToPath(import.meta.url)), 'index.html');
 
+/**
+ * v0.6.22（§3.84）：落盘前给**新增**消息补 ISO 时间戳。
+ *
+ * 只补缺 ts 的消息（`{...m, ts}` 不改动原对象），已有 ts 的原样保留：
+ * 旧会话/旧消息不会被"补写"成另一个时间；压缩重写时也不会把历史时间冲掉。
+ * 时间只在服务端落盘这一刻取，前端渲染用同一字段——不引入第二套时间来源。
+ * @template T
+ * @param {T[]} messages
+ * @param {Date} [now]
+ * @returns {T[]}
+ */
+function stampMessageTs(messages, now = new Date()) {
+  const ts = now.toISOString();
+  return messages.map((/** @type {any} */ m) => {
+    if (!m || typeof m !== 'object' || m.ts) return m;
+    return { ...m, ts };
+  });
+}
+
 /** 合法权限模式（与 /api/config 的校验同一口径：非法值一律忽略，绝不 fail-open）。 */
 const PERMISSION_MODES = new Set(['ask', 'auto', 'readonly']);
 /** 各档位的"会发生什么"人话说明（可见说明与前端提示共用同一份文案）。 */
@@ -882,8 +901,15 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken,
       }
     }
     messages.push({ role: 'user', content: built.content });
-    // 落盘用文本版（图文数组只发给模型，会话文件保持字符串可渲染）
-    await withSessionLock(session.file, () => appendMessages(session.file, [{ role: 'user', content: built.persistText }]));
+    // 落盘用文本版（图文数组只发给模型，会话文件保持字符串可渲染）。
+    // v0.6.22（§3.84）：同一次落盘的时间戳也写回内存里的这条消息——后续自动压缩整文件重写时
+    // 不会把这一轮刚写下的 ts 冲掉；历史消息（已有/缺失 ts）不在这里补。
+    const userTs = new Date().toISOString();
+    await withSessionLock(session.file, () => appendMessages(session.file, [{ role: 'user', content: built.persistText, ts: userTs }]));
+    {
+      const lastUserMsg = messages[messages.length - 1];
+      if (lastUserMsg && typeof lastUserMsg === 'object' && !lastUserMsg.ts) lastUserMsg.ts = userTs;
+    }
     let persistedBefore = messages.length;
 
     // 权限/选择类交互：发 ask 事件（带 taskId），等待 POST /api/permission 应答
@@ -1065,7 +1091,14 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken,
       // 会话级路由统计（Hermes C2 升级检测）：累计工具步数与截断次数，粘滞 flash 会话复杂度上来后自动升 planner
       const st = session.routeStats || { steps: 0, truncated: 0 };
       session.routeStats = { steps: st.steps + (io.stats().toolCount || 0), truncated: st.truncated + (r.truncated ? 1 : 0) };
-      await withSessionLock(session.file, () => appendMessages(session.file, messages.slice(persistedBefore)));
+      // v0.6.22（§3.84）：本回合新增的 assistant/tool 消息落盘时补 ts，并同步回内存数组，
+      // 让之后发生的自动压缩整文件重写保留这些时间戳（历史消息不动）。
+      {
+        const tail = messages.slice(persistedBefore);
+        const stamped = stampMessageTs(tail);
+        for (let i = 0; i < stamped.length; i += 1) messages[persistedBefore + i] = stamped[i];
+        await withSessionLock(session.file, () => appendMessages(session.file, stamped));
+      }
       io.printUsageLine({ modelName: runModel, usage: r.usage, durationMs: r.durationMs });
       // v0.4.4：补记最后一轮 + 兜底总结的剩余 usage（自动续跑轮已在 onUsage 逐轮入账，避免重复计）
       const remaining = {