mingdao-harness 0.1.69 → 0.1.70

package/package.json

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

package/src/web/index.html

@@ -43,6 +43,26 @@ header select{flex:none}
 /* 输入框上方工作状态条（审计：长任务静默硬伤——实时显示执行步数/耗时与后台任务数）。
    与输入框同宽对齐（复用 #composer 的居中容器），不再横贯整个聊天窗口 */
 #workStatus{max-width:860px;margin:0 auto 4px;display:flex;align-items:center;gap:10px;padding:6px 14px;background:var(--panel);border:1px solid var(--border);border-radius:12px;font-size:12.5px;color:var(--dim);flex:none}
+/* 顶部常驻活动条（静默深度优化）：与输入框同列、生成期间常驻——即使滚动离开消息区也始终可见 */
+#liveBar{position:sticky;top:0;z-index:20;max-width:860px;margin:0 auto 8px;display:flex;align-items:center;gap:10px;padding:8px 16px;background:linear-gradient(135deg,rgba(61,220,151,.12),rgba(34,184,207,.12));border:1px solid rgba(61,220,151,.45);border-radius:12px;font-size:13px;color:var(--text);box-shadow:0 2px 14px rgba(0,0,0,.25)}
+#liveBar .spinner{margin-right:2px}
+#liveBar .lb-phase{color:var(--accent2);font-weight:600;white-space:nowrap}
+#liveBar .lb-stat{color:var(--dim);white-space:nowrap}
+/* 左侧轨迹固定栏 + 右侧子代理面板（布局重构：轨迹在左、子代理在右） */
+#trajRail{position:fixed;left:0;top:52px;bottom:0;width:42px;background:var(--bg2);border-right:1px solid var(--border);z-index:35;display:flex;flex-direction:column;align-items:center;padding-top:10px;gap:10px}
+#trajRail .rail-btn{width:34px;height:34px;border-radius:10px;border:1px solid var(--border);background:var(--bg3);cursor:pointer;font-size:15px;display:flex;align-items:center;justify-content:center}
+#trajRail .rail-btn:hover{border-color:var(--accent2);color:var(--accent2)}
+#trajRail .rail-btn.on{background:linear-gradient(135deg,var(--accent),var(--accent2));color:#06121a;border:none}
+#subPanel{position:fixed;right:0;top:52px;bottom:0;width:320px;background:var(--bg2);border-left:1px solid var(--border);z-index:40;display:flex;flex-direction:column}
+.sb-head{padding:12px 14px;font-size:14px;font-weight:600;border-bottom:1px solid var(--border);color:var(--accent2);display:flex;align-items:center;gap:8px}
+.sb-head button{margin-left:auto}
+#sbList{flex:1;overflow-y:auto;padding:8px}
+.sb-item{padding:8px 10px;border:1px solid var(--border);border-radius:10px;margin-bottom:8px;font-size:12.5px;background:var(--bg3);cursor:pointer}
+.sb-item:hover{border-color:var(--accent2)}
+.sb-item .sb-q{color:var(--text);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.sb-item .sb-meta{color:var(--faint);font-size:11.5px;margin-top:3px}
+.sb-item .sb-body{display:none;color:var(--dim);font-size:11.5px;margin-top:6px;white-space:pre-wrap;word-break:break-word;max-height:240px;overflow-y:auto;border-top:1px dashed var(--border);padding-top:6px}
+.sb-item.open .sb-body{display:block}
 #workStatus .ws-busy{color:var(--accent2);display:flex;align-items:center;gap:8px;flex:1;min-width:0}
 #workStatus .ws-bg{cursor:pointer;color:var(--warn);white-space:nowrap}
 #workStatus .ws-bg:hover{color:var(--text)}
@@ -199,9 +219,16 @@ footer{flex:none;border-top:1px solid var(--border);background:var(--bg2);paddin
   <div class="spacer"></div>
   <input id="sessionSearch" placeholder="搜索会话…" title="关键词检索历史会话">
   <select id="sessions" title="历史会话"><option value="">历史会话</option></select>
-  <button id="tasksBtn" title="任务面板">任务</button><button id="sessMgrBtn" title="管理会话（重命名/删除）">✎</button>
+  <button id="tasksBtn" title="任务面板">任务</button><button id="subsBtn" title="子代理面板">🤖 子代理</button><button id="sessMgrBtn" title="管理会话（重命名/删除）">✎</button>
   <button id="newChat">新对话</button>
 </header>
+<div id="trajRail">
+  <button class="rail-btn" id="trajRailBtn" title="轨迹（点击查看详情）">🧭</button>
+</div>
+<aside id="subPanel" style="display:none">
+  <div class="sb-head">🤖 子代理<span id="sbCount" style="font-size:11.5px;color:var(--faint);font-weight:400"></span><button id="sbClose">关闭</button></div>
+  <div id="sbList"></div>
+</aside>
 <aside id="trajPanel" style="display:none">
   <div class="tj-head">🧭 任务轨迹<span id="tjSummary" style="font-size:11.5px;color:var(--faint);font-weight:400"></span><button id="tjClose">关闭</button></div>
   <div id="tjList"></div>
@@ -210,7 +237,7 @@ footer{flex:none;border-top:1px solid var(--border);background:var(--bg2);paddin
   <div class="tp-head">任务面板 <span id="tpCount"></span><button id="tpClose" style="float:right">✕</button></div>
   <div id="tpList"></div>
 </aside>
-<main><div id="chat"></div></main>
+<main><div id="liveBar" style="display:none"></div><div id="chat"></div></main>
 <footer>
   <div id="workStatus" style="display:none"></div>
   <input type="file" id="fileInput" accept="image/png,image/jpeg,image/gif,image/webp,.txt,.md,.json,.js,.py,.log,.csv,.html,.css" multiple style="display:none">
@@ -485,7 +512,9 @@ $('#dirPickOk').onclick = () => { const cb = pickerCb; pickerCb = null; $('#dirM
 $('#dirPickNone').onclick = () => { const cb = pickerCb; pickerCb = null; $('#dirModal').style.display = 'none'; if (cb) cb(null); };
 $('#dirPickCancel').onclick = () => { pickerCb = null; $('#dirModal').style.display = 'none'; };
 const chatEl = $('#chat'), input = $('#input'), sendBtn = $('#sendBtn');
-let activeAiMsg=null, bgRunning=0, curSteps=0, curWorkT0=0; // 本轮进度/后台任务数（工作状态条与轨迹共用）
+let activeAiMsg=null, bgRunning=0, curSteps=0, curWorkT0=0, curTools=0, curTasks=0; // 本轮进度（活动条/状态条/轨迹共用）
+let curPhase='模型推理中'; // 阶段语义（服务端 progress 事件下发）
+const sessionSubs=[]; // 本会话全部子代理（task 工具）条目：{seq, question, result, msg}
 // 回到底部悬浮按钮：滚动容器为 main；上滚超过 300px 时出现，点击平滑回底
 (function(){
   const scroller = document.querySelector('main');
@@ -775,14 +804,14 @@ async function send(){
     await handleEvents(resp.body, ev=>{
       if(ev.taskId){ taskId=ev.taskId; curTaskId=taskId; } // 质检 L1：主停止按钮只断本任务
       if(ev.type==='ask') disarm(); else arm(); // 有活动→重置；权限等待→暂停计时
-      if(ev.type==='progress'){ const p=ev.seconds||0; showThink(); think.textContent='💭 正在工作 '+Math.floor(p/60)+' 分 '+Math.round(p%60)+' 秒 · 第 '+msg._steps+' 回合 · 已执行 '+ev.steps+' 步…'; renderWorkStatus(); }
-      if(ev.type==='text'){ onActivity(); raw+=ev.delta; update(); }
+      if(ev.type==='progress'){ const p=ev.seconds||0; if(ev.phase) curPhase=String(ev.phase); curTools=Number(ev.steps)||0; curTasks=Number(ev.tasks)||0; showThink(); think.textContent='💭 正在工作 '+Math.floor(p/60)+' 分 '+Math.round(p%60)+' 秒 · 第 '+msg._steps+' 回合 · '+curPhase+' · 已执行 '+ev.steps+' 步…'; renderWorkStatus(); }
+      if(ev.type==='text'){ curPhase='模型输出中'; onActivity(); raw+=ev.delta; update(); }
       else if(ev.type==='reasoning'){ if(!reason){ reason=addReasoning(msg); reason.dataset.full=''; } if(!reason.parentElement.open) reason.parentElement.open=true; reason.parentElement.querySelector('summary').classList.add('live'); reason.dataset.full+=ev.delta; const full=reason.dataset.full; reason.textContent=(full.length>9000?full.slice(-9000)+'\n…（思考内容较长，仅显示末尾；已 '+full.length+' 字符）':full); reason.scrollTop=reason.scrollHeight; scroll(); }
-      else if(ev.type==='turnStart'){ stepsCount+=1; curSteps+=1; msg._steps=curSteps; msg._traj.push({kind:'turn', t:Date.now()}); showThink(); think.textContent='💭 第 '+msg._steps+' 回合：模型推理中…'; renderWorkStatus(); scroll(); }
-      else if(ev.type==='turnEnd'){ showThink(); think.textContent='⏸ 第 '+msg._steps+' 回合完成（累计 '+(ev.toolSteps||0)+' 工具步）· 进入下一回合…'; renderWorkStatus(); }
-      else if(ev.type==='toolStart'){ stepsCount+=1; curSteps+=1; msg._steps=curSteps; msg._traj.push({kind:'tool', seq:ev.seq, name:ev.name, args:ev.args, t:Date.now(), done:false}); onActivity(); update(); renderToolStartEvent(ev); renderWorkStatus(); }
+      else if(ev.type==='turnStart'){ stepsCount+=1; curSteps+=1; msg._steps=curSteps; curPhase='模型推理中'; msg._traj.push({kind:'turn', t:Date.now()}); showThink(); think.textContent='💭 第 '+msg._steps+' 回合：模型推理中…'; renderWorkStatus(); scroll(); }
+      else if(ev.type==='turnEnd'){ curPhase='回合完成，进入下一回合'; showThink(); think.textContent='⏸ 第 '+msg._steps+' 回合完成（累计 '+(ev.toolSteps||0)+' 工具步）· 进入下一回合…'; renderWorkStatus(); }
+      else if(ev.type==='toolStart'){ stepsCount+=1; curSteps+=1; curPhase=ev.name==='task'?'子代理执行中':'执行工具中'; msg._steps=curSteps; msg._traj.push({kind:'tool', seq:ev.seq, name:ev.name, args:ev.args, t:Date.now(), done:false}); onActivity(); update(); renderToolStartEvent(ev); renderWorkStatus(); }
       else if(ev.type==='code'){ onActivity(); const pre=document.createElement('pre'); pre.innerHTML='<code>'+highlight(ev.code,ev.lang)+'</code>'; insertBeforeActiveMsg(pre); scroll(); }
-      else if(ev.type==='tool'){ onActivity(); update(); const pending=runningTools.get(ev.seq); if(pending){ pending.remove(); runningTools.delete(ev.seq); } const tj=msg._traj.find(x=>x.kind==='tool'&&x.seq===ev.seq); if(tj){ tj.done=true; tj.result=ev.result; tj.durationMs=ev.durationMs; tj.card=pending||null; } renderToolEvent(ev); }
+      else if(ev.type==='tool'){ onActivity(); update(); const pending=runningTools.get(ev.seq); if(pending){ pending.remove(); runningTools.delete(ev.seq); } const tj=msg._traj.find(x=>x.kind==='tool'&&x.seq===ev.seq); if(tj){ tj.done=true; tj.result=ev.result; tj.durationMs=ev.durationMs; tj.card=pending||null; } if(ev.name==='task'){ sessionSubs.push({seq:ev.seq, question:String(ev.args?.question||ev.args?.prompt||''), result:ev.result, durationMs:ev.durationMs, msg}); renderSubPanel(); } renderToolEvent(ev); }
       else if(ev.type==='toolDenied'){ onActivity(); const tj=msg._traj.find(x=>x.kind==='tool'&&x.seq===ev.seq); if(tj){ tj.done=true; tj.denied=ev.reason||'未授权'; } const d=document.createElement('div'); d.className='errline'; d.textContent='✖ '+(ev.reason==='未授权'||!ev.reason?'未授权':ev.reason)+'：'+ev.name; msg.appendChild(d); scroll(); }
       else if(ev.type==='banner'){ renderBanner(ev); }
       else if(ev.type==='ask'){ update(); askModal(ev).then(a=>fetch('/api/permission',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({id:ev.id,answer:a,taskId})}).then(()=>arm()).catch(()=>{})); }
@@ -791,7 +820,7 @@ async function send(){
       else if(ev.type==='done'){ console.log('[MingDao] done 事件：session=' + ev.session); onActivity(); if(ev.budget){ const b=ev.budget; if(hintTextEl) hintTextEl.textContent='预算 '+Math.round(b.used/1000)+'K/'+Math.round(b.total/1000)+'K（'+Math.round(b.used/b.total*100)+'%）· 本轮完成 · 提示栏右侧为今日费用与命中率'; } refreshStatusBar(); if(ev.stats&&ev.stats.deliverables&&ev.stats.deliverables.length){ const card=document.createElement('div'); card.className='deliver'; card.innerHTML='<div class="t">📦 交付物（'+ev.stats.deliverables.length+' 个文件）</div>'+ev.stats.deliverables.map(f=>'<div class="i">'+esc(f)+(f.toLowerCase().endsWith('.html')?' <span style="color:var(--accent2)">— 浏览器打开即可运行</span>':'')+'</div>').join(''); msg.appendChild(card); } if(ev.note){ const d=document.createElement('div'); d.className='errline'; d.style.color='var(--warn)'; d.textContent=ev.note; msg.appendChild(d); } currentSession=ev.session; update(); refreshSessions(); updateTasksPanel(); }
     });
   }catch(e){ onActivity(); const d=document.createElement('div'); d.className='errline'; d.textContent=(e&&e.name==='AbortError')?(killedByWatchdog?'响应超时已中断（120 秒无任何响应），请重试':'已中断'):(e&&e.message)||'网络错误'; msg.appendChild(d); scroll(); }
-  finally{ clearInterval(hintTimer); disarm(); generating=false; setBtn(); curTaskId=null; console.log('[MingDao] 回合收尾：generating=false，按钮恢复发送'); hintEl.classList.remove('working'); if(hintTextEl) hintTextEl.textContent=defaultHint; pending=false; content.innerHTML=renderMarkdown(raw); attachTrajMeta(msg); activeAiMsg=null; curWorkT0=0; renderWorkStatus(); scroll(); updateTasksPanel(); }
+  finally{ clearInterval(hintTimer); disarm(); generating=false; setBtn(); curTaskId=null; curPhase='模型推理中'; console.log('[MingDao] 回合收尾：generating=false，按钮恢复发送'); hintEl.classList.remove('working'); if(hintTextEl) hintTextEl.textContent=defaultHint; pending=false; content.innerHTML=renderMarkdown(raw); attachTrajMeta(msg); activeAiMsg=null; curWorkT0=0; renderWorkStatus(); scroll(); updateTasksPanel(); }
 }
 
 let curTaskId=null; // 本轮 SSE 任务 id（质检 L1：主停止按钮只断本任务，不再误伤其他 tab）
@@ -799,17 +828,27 @@ function abort(){ fetch('/api/abort',{method:'POST',headers:{'Content-Type':'app
 
 // —— 输入框上方工作状态条（审计：长任务静默硬伤 → 实时进度可见） ——
 function renderWorkStatus(){
+  renderLiveBar();
   const el=$('#workStatus'); if(!el) return;
   let html='';
   if(generating){
     const secs=curWorkT0?Math.round((Date.now()-curWorkT0)/1000):0;
-    html='<span class="ws-busy"><span class="spinner"></span>任务执行中：第 '+curSteps+' 步 · 已 '+Math.floor(secs/60)+' 分 '+Math.round(secs%60)+' 秒 — 完成后总结与交付物显示在本轮消息底部（停止请用输入框右侧「■ 停止」按钮）</span>';
+    html='<span class="ws-busy"><span class="spinner"></span>⏳ '+curSteps+' 步 · '+Math.floor(secs/60)+' 分 '+Math.round(secs%60)+' 秒 · '+curTools+' 工具步</span>';
   } else if(bgRunning>0){
     html='<span class="ws-bg">🛠 '+bgRunning+' 个后台任务运行中 — 点击查看</span>';
   }
   el.style.display=html?'flex':'none';
   el.innerHTML=html;
-  const bg=el.querySelector('.ws-bg'); if(bg) bg.onclick=()=>{ const tp=$('#tasksPanel'); tp.style.display = tp.style.display==='none'?'flex':'none'; if(tp.style.display==='flex'){ $('#trajPanel').style.display='none'; updateTasksPanel(); } };
+  const bg=el.querySelector('.ws-bg'); if(bg) bg.onclick=()=>{ const tp=$('#tasksPanel'); tp.style.display = tp.style.display==='none'?'flex':'none'; if(tp.style.display==='flex'){ $('#trajPanel').style.display='none'; $('#subPanel').style.display='none'; updateTasksPanel(); } };
+}
+// 顶部常驻活动条（静默完美解决层）：生成期间始终可见，滚动不影响
+function renderLiveBar(){
+  const el=$('#liveBar'); if(!el) return;
+  if(!generating){ el.style.display='none'; el.innerHTML=''; return; }
+  const secs=curWorkT0?Math.round((Date.now()-curWorkT0)/1000):0;
+  el.style.display='flex';
+  el.innerHTML='<span class="spinner"></span><span class="lb-phase">正在执行：'+esc(curPhase)+'</span>'+
+    '<span class="lb-stat">第 '+curSteps+' 步 · 已 '+Math.floor(secs/60)+' 分 '+Math.round(secs%60)+' 秒 · '+curTools+' 工具步'+(curTasks>0?' · '+curTasks+' 个子代理':'')+'</span>';
 }
 // 轨迹元行：任务完成后附在本轮消息顶部（步数/子代理数，点击打开轨迹面板）
 function attachTrajMeta(msg){
@@ -855,6 +894,8 @@ function openTraj(msg){
   }
   $('#trajPanel').style.display='flex';
   $('#tasksPanel').style.display='none';
+  $('#subPanel').style.display='none';
+  $('#trajRailBtn').classList.add('on');
 }
 function resultText(r){
   if(r==null||r===undefined) return '';
@@ -864,7 +905,43 @@ function resultText(r){
   return JSON.stringify(r);
 }
 function truncText(t,n){ t=String(t||''); return t.length>n?t.slice(0,n)+'\n…（截断，共 '+t.length+' 字）':t; }
-$('#tjClose').onclick=()=>{ $('#trajPanel').style.display='none'; };
+$('#tjClose').onclick=()=>{ $('#trajPanel').style.display='none'; $('#trajRailBtn').classList.remove('on'); };
+$('#trajRailBtn').onclick=()=>{
+  const p=$('#trajPanel');
+  const willShow=p.style.display==='none';
+  if(willShow){ const m=lastMsgWithTraj(); if(!m){ uiAlert('本轮还没有可展示的轨迹（先发起一个任务）'); return; } openTraj(m); }
+  else p.style.display='none';
+  $('#trajRailBtn').classList.toggle('on', willShow);
+};
+function lastMsgWithTraj(){
+  const msgs=[...document.querySelectorAll('#chat .msg-ai')].reverse();
+  for(const m of msgs){ if(m._traj && m._traj.length) return m; }
+  return msgs.length ? msgs[0] : null;
+}
+function renderSubPanel(){
+  const count=sessionSubs.length;
+  const btn=$('#subsBtn'); if(btn) btn.textContent='🤖 子代理'+(count>0?' '+count:'');
+  $('#sbCount').textContent=count>0?('（'+count+' 个）'):'';
+  if($('#subPanel').style.display!=='flex') return;
+  const list=$('#sbList'); list.innerHTML='';
+  for(const sub of [...sessionSubs].reverse()){
+    const div=document.createElement('div'); div.className='sb-item';
+    div.innerHTML='<div class="sb-q">🤖 '+esc(sub.question.slice(0,60))+'</div><div class="sb-meta">'+(sub.durationMs!=null?sub.durationMs+'ms · ':'')+((sub.result&&sub.result.ok===false)?'失败':'完成')+'</div>';
+    const body=document.createElement('div'); body.className='sb-body';
+    body.textContent='任务：'+sub.question+'\n\n结果：'+truncText(resultText(sub.result), 1500);
+    div.appendChild(body);
+    div.onclick=(e)=>{ if(e.target.closest('.sb-body')) return; div.classList.toggle('open'); };
+    list.appendChild(div);
+  }
+  if(!count) list.innerHTML='<div class="empty" style="color:var(--faint);font-size:12px;padding:10px">本会话还没有子代理（task 工具会派生子代理）</div>';
+}
+$('#subsBtn').onclick=()=>{
+  const p=$('#subPanel');
+  const willShow=p.style.display==='none';
+  p.style.display=willShow?'flex':'none';
+  if(willShow){ $('#tasksPanel').style.display='none'; $('#trajPanel').style.display='none'; $('#trajRailBtn').classList.remove('on'); renderSubPanel(); }
+};
+$('#sbClose').onclick=()=>{ $('#subPanel').style.display='none'; };
 // —— 任务面板（多会话并行） ——
 function setBtn(){
   sendBtn.textContent = generating ? '■ 停止' : '发送';
@@ -912,7 +989,7 @@ async function refreshStatusBar(){
   $('#statusBar').textContent = s.turns+' 轮 · '+s.steps+' 步 | LLM '+fmtDur(s.llmMs)+' · 工具调用 '+fmtDur(s.toolMs)+' | 首 token 平均 '+ft+' · '+tps+' | 缓存命中 '+rate+' | 输入 '+fmtTok(s.prompt)+' tok · 输出 '+fmtTok(s.completion)+' tok';
 }
 refreshStatusBar(); setInterval(refreshStatusBar, 15000);
-$('#tasksBtn').onclick=()=>{ const p=$('#tasksPanel'); p.style.display = p.style.display==='none'?'flex':'none'; if(p.style.display==='flex') updateTasksPanel(); };
+$('#tasksBtn').onclick=()=>{ const p=$('#tasksPanel'); p.style.display = p.style.display==='none'?'flex':'none'; if(p.style.display==='flex'){ $('#subPanel').style.display='none'; $('#trajPanel').style.display='none'; $('#trajRailBtn').classList.remove('on'); updateTasksPanel(); } };
 $('#tpClose').onclick=()=>{ $('#tasksPanel').style.display='none'; };
 
 async function refreshSessions(q){ const u=q?'/api/sessions?q='+encodeURIComponent(q):'/api/sessions'; const r=await fetch(u).catch(()=>null); if(!r)return; const j=await r.json(); const sel=$('#sessions'); sel.innerHTML='<option value="">历史会话</option>'; for(const s of j.sessions){ const o=document.createElement('option'); o.value=s.file; o.textContent=s.label; sel.appendChild(o); } if(currentSession&&!q) sel.value=currentSession; }

package/src/web/server.js

@@ -248,7 +248,15 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
     // 同时充当客户端无活动看门狗的活动源）
     const progressTimer = setInterval(() => {
       try {
-        send({ type: 'progress', seconds: Math.round((Date.now() - entry.startedAt) / 1000), steps: io?.stats?.().toolCount || 0 });
+        // 质检（静默深度优化）：progress 附带阶段语义与子代理数，客户端顶部常驻活动条据此实时播报
+        const phase = entry.pendingAsk ? '等待权限确认' : io?._turnActive ? '模型推理中' : '执行工具中';
+        send({
+          type: 'progress',
+          seconds: Math.round((Date.now() - entry.startedAt) / 1000),
+          steps: io?.stats?.().toolCount || 0,
+          tasks: io?.stats?.().taskCount || 0,
+          phase,
+        });
       } catch {}
     }, 5000);
     const userMessage = String(body.message ?? '').trim();
@@ -435,7 +443,7 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
         durationMs: r.durationMs,
         truncated: r.truncated,
         aborted: r.aborted,
-        note: r.note || (r.text ? '' : '（模型本轮没有输出正文）'),
+        note: r.note || (r.text ? '' : `（本轮共执行 ${io.stats().toolCount} 步工具操作${io.stats().deliverables.length ? `、交付 ${io.stats().deliverables.length} 个文件` : ''}，但模型没有输出总结文字——可追问「总结一下刚才的工作」）`),
         stats: io.stats(),
         session: path.basename(session.file),
       });

package/src/web/web-io.js

@@ -9,11 +9,12 @@ export function createWebIO({ send, askHandler, setAbortHandler }) {
     showReasoning: true,
     _pending: null,
     _toolCount: 0,
+    _taskCount: 0, // 子代理（task 工具）次数：进度心跳与轨迹面板用
     _deliverables: [],
     _activeTools: [], // {seq, key}：并行批次下 toolStart↔tool 按 name+args 配对（审计 P2-7）
     // 交付物与步数统计：写/编辑成功的文件路径（去重）
     stats() {
-      return { toolCount: io._toolCount, deliverables: [...new Set(io._deliverables)] };
+      return { toolCount: io._toolCount, taskCount: io._taskCount, deliverables: [...new Set(io._deliverables)] };
     },
     setShowReasoning(v) {
       io.showReasoning = !!v;
@@ -57,6 +58,7 @@ export function createWebIO({ send, askHandler, setAbortHandler }) {
     },
     renderTool(name, args, result, durationMs) {
       io._toolCount += 1;
+      if (name === 'task') io._taskCount += 1;
       if ((name === 'write' || name === 'edit') && args?.path && result && result.ok !== false) {
         io._deliverables.push(String(args.path));
       }