mingdao-harness 0.2.7 → 0.3.0

package/src/web/app.js

@@ -1,3 +1,6 @@
+import { $, esc, highlight, renderMarkdown, scrollBottom, expandableBody, resultText, truncText, fmtDur, fmtTok, fmtT } from './util.js';
+import { MAX_ATTACHMENTS, MAX_IMAGE_BYTES, MAX_TEXT_BYTES } from './constants.js';
+
 // 访问令牌（P1-3）：地址带 ?token= 时记入 sessionStorage 并从地址栏移除（防截图/历史外泄），
 // 之后所有同源请求统一附加 X-MingDao-Token 头；无令牌时行为与旧版一致。
 const AUTH_TOKEN = (() => {
@@ -18,7 +21,52 @@ if (AUTH_TOKEN) {
     return rawFetch(input, init);
   };
 }
-const $ = (s) => document.querySelector(s);
+
+// —— 自绘悬浮气泡 tooltip（替换原生 title：出现快、样式与暗色主题一致） ——
+let tipEl = null;
+function ensureTip() {
+  if (!tipEl) {
+    tipEl = document.createElement('div');
+    tipEl.className = 'mdtip';
+    document.body.appendChild(tipEl);
+  }
+  return tipEl;
+}
+function showTip(text, anchor) {
+  if (!text || !anchor) return;
+  const t = ensureTip();
+  t.textContent = text;
+  t.style.display = 'block';
+  const r = anchor.getBoundingClientRect();
+  const w = t.offsetWidth, h = t.offsetHeight;
+  let left = r.left + r.width / 2 - w / 2;
+  left = Math.max(8, Math.min(left, window.innerWidth - w - 8));
+  let top = r.top - h - 8;
+  if (top < 8) top = r.bottom + 8;
+  t.style.left = left + 'px';
+  t.style.top = top + 'px';
+}
+function hideTip() { if (tipEl) tipEl.style.display = 'none'; }
+function attachTip(el, text) {
+  if (!el || !text) return;
+  el.removeAttribute('title'); // 去掉原生 title，避免双提示
+  const get = typeof text === 'function' ? text : () => text;
+  el.addEventListener('mouseenter', () => showTip(get(), el));
+  el.addEventListener('mouseleave', hideTip);
+  el.addEventListener('focus', () => showTip(get(), el));
+  el.addEventListener('blur', hideTip);
+  el.addEventListener('mousedown', hideTip); // 打开下拉/点击时隐藏，避免遮挡
+}
+window.addEventListener('scroll', hideTip, true);
+
+// 输入区下拉 / 附件按钮：把原生 title 换成自绘气泡（文本取自原 title，一次性读取后移除）
+function initTips() {
+  const perm = $('#permSel'); if (perm) attachTip(perm, perm.getAttribute('title'));
+  const reas = $('#reasoningSel'); if (reas) attachTip(reas, reas.getAttribute('title'));
+  const model = $('#modelSel'); if (model) attachTip(model, () => { const o = model.options[model.selectedIndex]; return (o && o.title) ? o.title : '切换模型'; });
+  const at = $('#attachBtn'); if (at) attachTip(at, at.getAttribute('title'));
+}
+initTips();
 
 // —— 弹窗三件套（Electron 不实现 window.prompt/confirm/alert：prompt 恒返回 null、confirm 恒 false、
 // alert 静默无反应——桌面版「⚙ 设置里点设Key 没反应」即由此而来）。统一替换为应用内模态框。
@@ -125,61 +173,7 @@ chatEl.addEventListener('click', (e) => {
 let generating = false; // 生成中：发送按钮复用为停止按钮
 let currentSession = null, thinking = null;
 
-function esc(s){return String(s??'').replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;').replace(/'/g,'&#39;')}
 
-function highlight(code, lang){
-  const kws = new Set('const let var function return if else for while import from export class new await async try catch throw null undefined true false def elif raise with as lambda None True False self echo exit if then else fi done local function'.split(' '));
-  const re = /(\/\/[^\n]*|#[^\n]*|"(?:\\.|[^"\\])*"|'[^']*'|`[^`]*`|\b\d[\d._]*\b|[A-Za-z_$][\w$]*)/g;
-  return esc(code).replace(re, (tok)=>{
-    if(tok.startsWith('//')||tok.startsWith('#')) return '<span class="hl-c">'+tok+'</span>';
-    if(/^["'`]/.test(tok)) return '<span class="hl-s">'+tok+'</span>';
-    if(/^\d/.test(tok)) return '<span class="hl-n">'+tok+'</span>';
-    if(kws.has(tok)) return '<span class="hl-kw">'+tok+'</span>';
-    return tok;
-  });
-}
-function renderMarkdown(text){
-  // 块级解析（美化：加粗标题 / 段落 / 真列表 / 引用 / 分割线，参照 DeepSeek-Harness 会话排版）
-  const lines = String(text).split('\n');
-  let out = '', code = null, codeLang = '';
-  const flushCode = () => { if (code !== null) { out += '<div class="codeblock"><div class="cb-banner"><span class="cb-lang"><span class="cb-dot"></span>' + (esc(codeLang) || 'code') + '</span><span class="cb-copy" style="cursor:pointer">复制</span></div><pre><code class="lang-' + esc(codeLang) + '">' + highlight(code.join('\n'), codeLang) + '</code></pre></div>'; code = null; } };
-  let para = [];
-  let list = null; // {type:'ul'|'ol', items:[]}
-  const flushPara = () => { if (para.length) { out += '<p>' + para.join('<br>') + '</p>'; para = []; } };
-  const flushList = () => { if (list) { out += '<' + list.type + '>' + list.items.map((i) => '<li>' + i + '</li>').join('') + '</' + list.type + '>'; list = null; } };
-  // 行内元素（审计 P1-3：内容与 codeLang 均经 esc 转义防 XSS）
-  const inline = (l) => {
-    let s = esc(l);
-    s = s.replace(/`([^`]+)`/g, '<code>$1</code>')
-      .replace(/\*\*([^*]+)\*\*/g, '<b>$1</b>')
-      .replace(/\*([^*\s][^*]*)\*/g, '<i>$1</i>')
-      .replace(/\[([^\]]+)\]\((https?:\/\/[^\s'"<>)]+)\)/g, '<a href="$2" target="_blank" rel="noopener">$1</a>');
-    return s;
-  };
-  for (const line of lines) {
-    const t = line.trim();
-    if (t.startsWith('```')) {
-      if (code === null) { flushList(); flushPara(); code = []; codeLang = (t.slice(3).trim().split(/\s+/)[0] || ''); }
-      else flushCode();
-      continue;
-    }
-    if (code !== null) { code.push(line); continue; }
-    if (t === '') { flushList(); flushPara(); continue; }
-    const h = t.match(/^(#{1,6})\s+(.*)$/);
-    if (h) { flushList(); flushPara(); const level = Math.min(h[1].length, 4); out += '<h' + level + '>' + inline(h[2]) + '</h' + level + '>'; continue; }
-    const ul = t.match(/^([-*+])\s+(.*)$/);
-    if (ul) { flushPara(); if (!list || list.type !== 'ul') { flushList(); list = { type: 'ul', items: [] }; } list.items.push(inline(ul[2])); continue; }
-    const ol = t.match(/^(\d+)[.)]\s+(.*)$/);
-    if (ol) { flushPara(); if (!list || list.type !== 'ol') { flushList(); list = { type: 'ol', items: [] }; } list.items.push(inline(ol[2])); continue; }
-    if (/^>\s?/.test(t)) { flushList(); flushPara(); out += '<blockquote>' + inline(t.replace(/^>\s?/, '')) + '</blockquote>'; continue; }
-    if (/^(-{3,}|\*{3,})$/.test(t)) { flushList(); flushPara(); out += '<hr>'; continue; }
-    flushList();
-    para.push(inline(t));
-  }
-  flushCode(); flushList(); flushPara();
-  return out;
-}
-function scrollBottom(){ const sc=document.querySelector('main'); if(sc) sc.scrollTop = sc.scrollHeight; }
 
 function newAiMsg(){ const el=document.createElement('div'); el.className='msg-ai'; 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;})(); }
@@ -187,15 +181,6 @@ function addReasoning(msg){ const d=document.createElement('details'); d.classNa
 
 function addUser(text){ const el=document.createElement('div'); el.className='msg-user'; el.innerHTML='<div class="bubble">'+esc(text)+'</div>'; chatEl.appendChild(el); scrollBottom(); }
 
-function expandableBody(previewHtml, fullHtml){
-  const b=document.createElement('div'); b.className='body';
-  const prev=document.createElement('div'); const full=document.createElement('div');
-  prev.innerHTML=previewHtml; full.innerHTML=fullHtml; full.style.display='none';
-  const btn=document.createElement('button'); btn.textContent='展开全文'; btn.style.cssText='padding:1px 8px;font-size:11px;margin-top:4px';
-  btn.onclick=()=>{ const open=full.style.display!=='none'; full.style.display=open?'none':'block'; btn.textContent=open?'展开全文':'收起'; scrollBottom(); };
-  b.appendChild(prev); b.appendChild(full); b.appendChild(btn);
-  return b;
-}
 const runningTools = new Map();
 function renderToolStartEvent(ev){
   const card=document.createElement('div'); card.className='tool';
@@ -273,7 +258,7 @@ function renderTodos(todos,msg){
   for(const t of todos){ const li=document.createElement('li'); li.className=t.status==='completed'?'done':t.status==='in_progress'?'doing':''; li.innerHTML=(t.status==='completed'?'✓ ':'○ ')+esc(t.content); ul.appendChild(li); }
   msg.appendChild(ul);
 }
-function renderBanner(ev){ const d=document.createElement('div'); d.className='banner'; d.textContent=ev.text||ev.title||''; insertBeforeActiveMsg(d); scrollBottom(); }
+function renderBanner(ev){ const d=document.createElement('div'); d.className='banner'+(ev.warn?' banner-warn':''); d.textContent=ev.text||ev.title||''; insertBeforeActiveMsg(d); scrollBottom(); }
 // 工具卡/横幅/代码块统一插到「本轮 AI 消息」之前：结论与交付物永远位于消息最底部
 function insertBeforeActiveMsg(el){ if(activeAiMsg && activeAiMsg.parentNode){ chatEl.insertBefore(el, activeAiMsg); } else { chatEl.appendChild(el); } }
 
@@ -302,13 +287,13 @@ let attachments=[];
 $('#attachBtn').onclick=()=>{ $('#fileInput').click(); };
 $('#fileInput').addEventListener('change', async e=>{
   for(const f of e.target.files||[]){
-    if(attachments.length>=4){ uiAlert('最多 4 个附件'); break; }
+    if(attachments.length>=MAX_ATTACHMENTS){ uiAlert('最多 '+MAX_ATTACHMENTS+' 个附件'); break; }
     if(f.type.startsWith('image/')){
-      if(f.size>5*1024*1024){ uiAlert(f.name+' 超过 5MB'); continue; }
+      if(f.size>MAX_IMAGE_BYTES){ uiAlert(f.name+' 超过 5MB'); continue; }
       const dataUrl=await new Promise(r=>{ const fr=new FileReader(); fr.onload=()=>r(fr.result); fr.readAsDataURL(f); });
       attachments.push({type:'image',name:f.name,dataUrl});
     }else if(f.type.startsWith('text/')||/\.(txt|md|json|js|py|log|csv|html|css)$/i.test(f.name)){
-      if(f.size>200*1024){ uiAlert(f.name+' 超过 200KB'); continue; }
+      if(f.size>MAX_TEXT_BYTES){ uiAlert(f.name+' 超过 200KB'); continue; }
       const content=await new Promise(r=>{ const fr=new FileReader(); fr.onload=()=>r(fr.result); fr.readAsText(f); });
       attachments.push({type:'text',name:f.name,content});
     }else{
@@ -420,6 +405,7 @@ function renderWorkStatus(){
   renderLiveBar();
   const el=$('#workStatus'); if(!el) return;
   let html='';
+  let tip='';
   if(generating){
     const secs=curWorkT0?Math.round((Date.now()-curWorkT0)/1000):0;
     html='<span class="ws-busy"><span class="spinner"></span><span class="ws-phase">'+esc(curPhase)+'</span><span>⏳ 第 '+curSteps+' 步 · '+Math.floor(secs/60)+' 分 '+Math.round(secs%60)+' 秒 · '+curTools+' 工具步'+(curTasks>0?' · '+curTasks+' 个子代理':'')+'</span></span>';
@@ -427,12 +413,12 @@ function renderWorkStatus(){
     // 后台任务 chip（非顶部，位于输入框上方）：计数 + 最新任务 + 悬浮详情 tooltip，点击打开详情面板
     const running=bgTasks.filter((/** @type {any} */ t)=>t.status==='running');
     const latest=running.length?running[running.length-1]:null;
-    const tip=bgTasks.map((/** @type {any} */ t)=>(t.kind==='schedule'?'⏰':'🛠')+' '+String(t.message||t.id||'').slice(0,40)+' · '+t.status).join('\n');
-    html='<span class="ws-bg" title="'+esc(String(tip)).replace(/"/g,'&quot;')+'">🛠 '+bgRunning+' 个后台任务运行中'+(latest?' · '+esc(String(latest.message||'').slice(0,22)):'')+' — 点击查看详情</span>';
+    tip=bgTasks.map((/** @type {any} */ t)=>(t.kind==='schedule'?'⏰':'🛠')+' '+String(t.message||t.id||'').slice(0,40)+' · '+t.status).join('\n');
+    html='<span class="ws-bg">🛠 '+bgRunning+' 个后台任务运行中'+(latest?' · '+esc(String(latest.message||'').slice(0,22)):'')+' — 点击查看详情</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'; $('#subPanel').style.display='none'; updateTasksPanel(); } syncPanelLayout(); };
+  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(); } syncPanelLayout(); }; attachTip(bg, tip); }
 }
 // 顶部常驻活动条（静默完美解决层）：生成期间始终可见，滚动不影响
 function renderLiveBar(){
@@ -498,14 +484,6 @@ function syncPanelLayout(){
   document.body.classList.toggle('sub-open', open('subPanel'));
   document.body.classList.toggle('tasks-open', open('tasksPanel'));
 }
-function resultText(r){
-  if(r==null||r===undefined) return '';
-  if(typeof r==='string') return r;
-  if(r.output) return String(r.output);
-  if(r.stdout||r.stderr) return String(r.stdout||'')+String(r.stderr||'');
-  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'; $('#trajRailBtn').classList.remove('on'); syncPanelLayout(); };
 $('#trajRailBtn').onclick=()=>{
   const p=$('#trajPanel');
@@ -602,8 +580,6 @@ async function refreshCostBadge(){
 }
 refreshCostBadge(); setInterval(refreshCostBadge, 15000);
 // 底部状态栏：轮次/步数/LLM 与工具时长/首 token 平均/吞吐/缓存命中/输入输出 tokens
-function fmtDur(ms){ if(!ms) return '0s'; const sec=Math.round(ms/1000); const m=Math.floor(sec/60); return m>0 ? m+'m'+String(sec%60).padStart(2,'0')+'s' : sec+'s'; }
-function fmtTok(n){ if(n>=1e9) return (n/1e9).toFixed(1)+'B'; if(n>=1e6) return (n/1e6).toFixed(0)+'M'; if(n>=1e3) return (n/1e3).toFixed(1)+'K'; return String(n); }
 async function refreshStatusBar(){
   const r=await fetch('/api/cache-stats',{cache:'no-store'}).catch(()=>null); if(!r) return;
   const j=await r.json().catch(()=>null); if(!j) return;
@@ -620,6 +596,18 @@ $('#tpClose').onclick=()=>{ $('#tasksPanel').style.display='none'; syncPanelLayo
 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; }
 let searchTimer=null;
 $('#sessionSearch').addEventListener('input',e=>{ clearTimeout(searchTimer); searchTimer=setTimeout(()=>refreshSessions(e.target.value.trim()),300); });
+// 思考模式 / 推理等级（v0.2.8）：与模型选择并列在输入区，按当前模型独立。
+// 仅 reasoning 模型显示该下拉（关/低/高/最高）；切换模型时随 /api/state 的 reasoning 字段刷新。
+function applyReasoningUI(reasoning){
+  const sel=$('#reasoningSel');
+  if(!sel) return;
+  const supported = Boolean(reasoning && reasoning.supported);
+  sel.style.display = supported ? '' : 'none';
+  if(!supported) return;
+  const effort = reasoning && reasoning.effort ? reasoning.effort : 'high';
+  sel.value = ['off','low','high','max'].includes(effort) ? effort : 'high';
+}
+$('#reasoningSel').onchange=()=>{ applyConfig({reasoningEffort:$('#reasoningSel').value}); };
 async function init(){
   try{
     const r=await fetch('/api/state',{cache:'no-store'}); const j=await r.json();
@@ -628,7 +616,7 @@ async function init(){
     for(const m of (j.models||[])){ const g=m.providerLabel||'其他'; if(!groups[g]){groups[g]=[];order.push(g);} groups[g].push(m); }
     for(const g of order){
       const og=document.createElement('optgroup'); og.label=g;
-      for(const m of groups[g]){ const o=document.createElement('option'); o.value=m.name; o.textContent=m.label; if(m.name===j.model) o.selected=true; og.appendChild(o); }
+      for(const m of groups[g]){ const o=document.createElement('option'); o.value=m.name; o.textContent=m.name; o.title=m.label; if(m.name===j.model) o.selected=true; og.appendChild(o); }
       ms.appendChild(og);
     }
     if(!(j.models||[]).length){ const o=document.createElement('option'); o.value=j.model; o.textContent=j.model; ms.appendChild(o); }
@@ -639,6 +627,7 @@ async function init(){
     $('#budgetInput').value=j.contextBudget||128000;
     $('#autoStartChk').checked=Boolean(j.autostart);
     $('#notifyChk').checked=j.notify!==false;
+    applyReasoningUI(j.reasoning);
     const env = ('路由'+(j.routing?'开':'关')+' · 沙箱'+((j.sandbox&&j.sandbox!=='off')?(j.sandboxSupported?j.sandbox:'降级'):'off'));
     $('#envBadge').textContent=env; $('#envBadge').style.display='';
     // 首次使用引导：无 API Key 时明确提示去设置（桌面版自动初始化后必走这里）
@@ -779,7 +768,6 @@ $('#memDedupe').onclick=async ()=>{
   if(j.ok){ memFlash('✓ 去重完成，移除 '+j.removed+' 行', true); loadMemoryUI(); } else memFlash('✖ '+(j.error||'去重失败'), false);
 };
 // —— 缓存命中率仪表盘 ——
-function fmtT(n){ n=Number(n||0); return n>=1000?(n/1000).toFixed(1)+'k':String(n); }
 // 省钱 B3：费用二级分账面板（模型/工具 Top5 + 近 14 天折线，零依赖 SVG）
 function renderCostBreakdown(bd){
   const models=$('#costTopModels'); models.innerHTML='';
@@ -904,12 +892,13 @@ async function reloadModels(){
     for(const m of (j.models||[])){ const g=m.providerLabel||'其他'; if(!groups[g]){groups[g]=[];order.push(g);} groups[g].push(m); }
     for(const g of order){
       const og=document.createElement('optgroup'); og.label=g;
-      for(const m of groups[g]){ const o=document.createElement('option'); o.value=m.name; o.textContent=m.label; if(m.name===j.model) o.selected=true; og.appendChild(o); }
+      for(const m of groups[g]){ const o=document.createElement('option'); o.value=m.name; o.textContent=m.name; o.title=m.label; if(m.name===j.model) o.selected=true; og.appendChild(o); }
       ms.appendChild(og);
     }
     if(!(j.models||[]).length){ const o=document.createElement('option'); o.value=j.model; o.textContent=j.model; ms.appendChild(o); }
     const env=('路由'+(j.routing?'开':'关')+' · 沙箱'+((j.sandbox&&j.sandbox!=='off')?(j.sandboxSupported?j.sandbox:'降级'):'off'));
     $('#envBadge').textContent=env; $('#envBadge').style.display='';
+    applyReasoningUI(j.reasoning);
   }catch(e){}
 }
 async function refreshModelsCfg(){
@@ -1060,12 +1049,17 @@ async function applyConfig(payload, revertTarget){
 }
 $('#modelSel').addEventListener('change', e=>{ applyConfig({model:e.target.value}, e.target); });
 $('#permSel').addEventListener('change', e=>{ applyConfig({permission:e.target.value}, e.target); });
-async function loadSession(file){ currentSession=file; chatEl.innerHTML=''; 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}); } scrollBottom(); }
+// v0.3.0 P0-3：会话边界收尾（切换/新对话时提取项目记忆+日志，fire-and-forget 不阻塞 UI）
+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=''; 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(); }
 
 sendBtn.onclick=()=>{ if(generating){ abort(); } else { send(); } };
 input.addEventListener('keydown',e=>{ if(e.key==='Enter'&&!e.shiftKey){ e.preventDefault(); send(); } });
 input.addEventListener('input',()=>{ input.style.height='44px'; input.style.height=Math.min(input.scrollHeight,200)+'px'; });
-$('#newChat').onclick=()=>{ currentSession=null; chatEl.innerHTML=''; refreshSessions(); };
+$('#newChat').onclick=()=>{ finalizeCurrentSession(); currentSession=null; chatEl.innerHTML=''; refreshSessions(); };
 $('#sessMgrBtn').onclick=openSessModal;
 $('#sessClose').onclick=()=>{ $('#sessModal').style.display='none'; };
 async function openSessModal(){
@@ -1081,6 +1075,6 @@ async function openSessModal(){
     div.appendChild(rn); div.appendChild(dl); list.appendChild(div);
   }
 }
-$('#sessions').onchange=e=>{ if(e.target.value){ loadSession(e.target.value); } else { currentSession=null; chatEl.innerHTML=''; } };
+$('#sessions').onchange=e=>{ if(e.target.value){ loadSession(e.target.value); } else { finalizeCurrentSession(); currentSession=null; chatEl.innerHTML=''; } };
 if('serviceWorker' in navigator){ navigator.serviceWorker.register('/sw.js').catch(()=>{}); }
 init();

package/src/web/attachments.js

@@ -4,12 +4,11 @@
 //  - 文本文件：直接拼接进消息文本（≤200KB），并留文件名标注
 //  - 返回 { content（模型消息内容：字符串或图文数组）, persistText（落盘文本）, error }
 
-const MAX_IMAGE_DATAURL = 7 * 1024 * 1024; // base64 膨胀 1.33 倍，对应约 5MB 原图
-const MAX_TEXT = 200 * 1024;
+import { MAX_ATTACHMENTS, MAX_IMAGE_DATAURL, MAX_TEXT_BYTES } from './constants.js';
 
 export function buildUserContent(/** @type {any} */ message, /** @type {any} */ attachments, /** @type {any} */ visionSupported) {
   const text = String(message ?? '').trim();
-  const list = Array.isArray(attachments) ? attachments.slice(0, 4) : [];
+  const list = Array.isArray(attachments) ? attachments.slice(0, MAX_ATTACHMENTS) : [];
   const imageParts = [];
   const persistParts = [];
   let finalText = text;
@@ -31,7 +30,7 @@ export function buildUserContent(/** @type {any} */ message, /** @type {any} */
     } else if (a.type === 'text') {
       const content = String(a.content ?? '');
       if (!content.trim()) continue;
-      if (content.length > MAX_TEXT) {
+      if (content.length > MAX_TEXT_BYTES) {
         return { error: `文本文件过大：${a.name || '未命名'}（≤200KB）` };
       }
       finalText += `${finalText ? '\n\n' : ''}[文件 ${a.name || '未命名'}]\n${content}`;

package/src/web/constants.js

@@ -0,0 +1,9 @@
+// 前端 + 服务端共享常量（零依赖纯 ESM，浏览器与 Node 均可 import）。
+// 单源化（v0.2.8 B2）：附件上限 / 并发上限等数值只在此定义，
+// 防 app.js（客户端预检）/ attachments.js（服务端校验）/ fs-tools.js（读取上限）漂移。
+export const MAX_CONCURRENT = 8; // 并发任务上限（server 与任务面板共用）
+export const MAX_ATTACHMENTS = 4; // 单次最多附件数
+export const MAX_IMAGE_BYTES = 5 * 1024 * 1024; // 单张图片原图上限（5MB）
+export const MAX_IMAGE_DATAURL = 7 * 1024 * 1024; // base64 膨胀 1.33 倍后的 dataURL 上限（≈5MB 原图）
+export const MAX_TEXT_BYTES = 200 * 1024; // 文本附件上限（200KB）
+export const MAX_FILE_READ_BYTES = 5 * 1024 * 1024; // read/edit 工具单文件读取上限（独立语义，非附件上限）

package/src/web/index.html

@@ -94,6 +94,7 @@ header select{flex:none}
 #trajPanel{position:fixed;left:42px;top:52px;bottom:0;width:252px;background:var(--bg2);border-right:1px solid var(--border);z-index:40;display:flex;flex-direction:column;box-shadow:4px 0 24px rgba(0,0,0,.35)}
 .tj-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}
 .tj-head button{margin-left:auto}
+#tjClose,#sbClose{font-size:12px;white-space:nowrap;padding:3px 10px}
 #tjList{flex:1;overflow-y:auto;padding:8px}
 .tj-turn{color:var(--accent2);font-size:12px;font-weight:600;margin:8px 2px 4px}
 .tj-item{padding:6px 10px;border:1px solid var(--border);border-radius:8px;margin-bottom:6px;font-size:12.5px;background:var(--bg3);cursor:pointer}
@@ -186,13 +187,18 @@ main{flex:1;overflow-y:auto;padding:18px 0 12px;min-width:0}
 .todo li.doing{color:var(--accent2)}
 .usage{font-size:12px;color:var(--faint);border-top:1px dashed var(--border);padding-top:6px}
 .banner{text-align:center;color:var(--faint);font-size:12.5px}
+.banner-warn{background:rgba(245,158,11,.08);border:1px solid rgba(245,158,11,.35);color:var(--warn);border-radius:12px;padding:8px 14px;text-align:left}
 .errline{color:var(--err);background:rgba(229,83,75,.08);border:1px solid rgba(229,83,75,.3);border-radius:10px;padding:10px 14px;font-size:13.5px}
 footer{flex:none;border-top:1px solid var(--border);background:var(--bg2);padding:12px 18px}
 #composer{max-width:860px;margin:0 auto;display:flex;gap:10px;align-items:flex-end}
-#input{flex:1;background:var(--bg3);border:1px solid var(--border);border-radius:12px;color:var(--text);padding:10px 14px;font:14px/1.6 inherit;resize:none;min-height:44px;max-height:200px}
+#composer #permSel{max-width:96px;min-width:64px;flex:none;padding:8px 8px}
+#composer #reasoningSel{max-width:64px;min-width:48px;flex:none;padding:8px 6px;font-size:12px}
+#composer #modelSel{max-width:150px;min-width:88px;flex:none;padding:8px 8px;font-size:12px}
+#input{flex:1;background:var(--bg3);border:1px solid var(--border);border-radius:12px;color:var(--text);padding:10px 14px;font:14px/1.6 inherit;resize:none;min-height:44px;max-height:200px;min-width:0}
 #input:focus{outline:none;border-color:var(--accent2)}
 #hint{font-size:11.5px;color:var(--faint);margin-top:6px;max-width:860px;margin-left:auto;margin-right:auto}
 #statusBar{font-size:11.5px;color:var(--faint);margin-top:2px;max-width:860px;margin-left:auto;margin-right:auto;font-variant-numeric:tabular-nums;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+@media (max-width:560px){footer{padding:10px 8px}#composer{gap:6px}#composer #permSel{min-width:52px;padding:8px 4px}#composer #reasoningSel{min-width:44px;padding:8px 4px}#composer #modelSel{min-width:72px;padding:8px 4px}#attachBtn{padding:10px 9px}}
 .modal-mask{position:fixed;inset:0;background:rgba(0,0,0,.55);display:flex;align-items:center;justify-content:center;z-index:50}
 .modal{background:var(--panel);border:1px solid var(--border);border-radius:14px;width:min(520px,92vw);padding:18px;max-height:88vh;overflow-y:auto}
 /* 设置多级菜单（审计：一拉到底改为左侧分组导航 + 右侧面板） */
@@ -221,17 +227,13 @@ footer{flex:none;border-top:1px solid var(--border);background:var(--bg2);paddin
 .spinner{display:inline-block;width:14px;height:14px;border:2px solid var(--accent);border-top-color:transparent;border-radius:50%;animation:spin .8s linear infinite;vertical-align:-2px}
   #scrollBottomBtn{position:fixed;right:26px;bottom:118px;width:40px;height:40px;border-radius:50%;background:linear-gradient(135deg,var(--accent),var(--accent2));color:#06121a;font-size:20px;font-weight:800;border:none;cursor:pointer;box-shadow:0 4px 16px rgba(0,0,0,.45);z-index:30;display:none;align-items:center;justify-content:center}
 @keyframes spin{to{transform:rotate(360deg)}}
+/* 自绘悬浮气泡 tooltip（替换原生 title）：暗色悬浮层 + 阴影，跟随锚点居中，越界自动回弹 */
+.mdtip{position:fixed;z-index:1000;max-width:320px;background:var(--bg3);color:var(--text);border:1px solid var(--border);border-radius:8px;padding:7px 11px;font-size:12px;line-height:1.6;box-shadow:0 8px 24px rgba(0,0,0,.55);pointer-events:none;white-space:pre-line;word-break:break-word;display:none}
 </style>
 </head>
 <body>
 <header>
   <div class="logo">MingDao <span>Harness</span></div>
-  <select id="modelSel" title="切换模型"></select>
-  <select id="permSel" title="权限模式">
-    <option value="ask">权限 ask</option>
-    <option value="auto">权限 auto</option>
-    <option value="readonly">权限 readonly</option>
-  </select>
   <span id="cfgMsg" class="badge" style="display:none"></span>
   <button id="cfgBtn" title="设置">⚙</button>
   <select id="wsSel" title="工作空间（切换 / 新建，目录自动创建）"></select>
@@ -266,6 +268,18 @@ footer{flex:none;border-top:1px solid var(--border);background:var(--bg2);paddin
   <div id="composer">
     <button id="attachBtn" title="上传图片或文本文件（图片需视觉模型，如 deepseek-v4-flash-vision-exp）">📎</button>
     <textarea id="input" rows="1" placeholder="输入任务…（Enter 发送，Shift+Enter 换行）"></textarea>
+    <select id="permSel" title="权限模式：询问＝写文件/执行命令前先确认（推荐） · 自动＝全部直接放行 · 只读＝禁止修改与执行">
+      <option value="ask">询问</option>
+      <option value="auto">自动</option>
+      <option value="readonly">只读</option>
+    </select>
+    <select id="modelSel" title="切换模型"></select>
+    <select id="reasoningSel" title="思考模式（推理等级）：关＝不推理省 token · 低 · 高（默认）· 最高＝最强推理" style="display:none">
+      <option value="off">关</option>
+      <option value="low">低</option>
+      <option value="high">高</option>
+      <option value="max">最高</option>
+    </select>
     <button id="sendBtn" class="primary">发送</button>
   </div>
   <div id="hint"><span id="hintText">工具执行与权限确认会实时展示；生成中可点「中断」停止。</span><label style="margin-left:12px;cursor:pointer;user-select:none"><input type="checkbox" id="journalChk" style="vertical-align:-2px;margin:0 4px 0 0">📌 带上文（最近会话日志，默认关＝新会话全新开始）</label></div>
@@ -442,6 +456,6 @@ footer{flex:none;border-top:1px solid var(--border);background:var(--bg2);paddin
     </div>
   </div>
 </div>
-<script src="/app.js"></script>
+<script type="module" src="/app.js"></script>
 </body>
 </html>

package/src/web/routes/api.js

@@ -31,7 +31,7 @@ export function createApiDispatch(deps) {
     // 访问控制（P1-3/P1-4）：token 校验覆盖数据与操作接口；壳页面与 PWA 静态资源公开
     // （壳不含任何数据，SPA 需要先加载才能读取 ?token=）；Host 白名单覆盖一切请求
     const isStaticAsset =
-      p === '/' || p === '/index.html' || p === '/app.js' || p === '/favicon.ico' || p === '/icon.svg' || p === '/icon-192.png' || p === '/icon-512.png' || p === '/manifest.webmanifest' || p === '/sw.js';
+      p === '/' || p === '/index.html' || p === '/app.js' || p === '/util.js' || p === '/constants.js' || p === '/favicon.ico' || p === '/icon.svg' || p === '/icon-192.png' || p === '/icon-512.png' || p === '/manifest.webmanifest' || p === '/sw.js';
     if (authEnabled && !isStaticAsset && !tokenMatches(requestToken(req, url))) {
       return json(res, 401, { error: '未授权：缺少或无效的访问令牌（地址需带 ?token=…，或请求头携带 X-MingDao-Token）' });
     }
@@ -60,15 +60,17 @@ export function createApiDispatch(deps) {
     }
 
     // —— 静态壳资源（公开；不经过域分发） ——
-    if (method === 'GET' && p === '/app.js') {
-      // 质检 Q2/S5：SPA 外部 JS——从磁盘读取（与 index.html 同目录）
+    // 质检 Q2/S5：SPA 外部 JS——从磁盘读取（与 index.html 同目录）。
+    // v0.2.8 C2：app.js 拆分为 ES Modules（app.js / util.js / constants.js），统一从此处伺服。
+    const WEB_JS_FILES = new Set(['app.js', 'util.js', 'constants.js']);
+    if (method === 'GET' && WEB_JS_FILES.has(p.slice(1))) {
       try {
-        const js = fs.readFileSync(path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'app.js'), 'utf8');
+        const js = fs.readFileSync(path.join(path.dirname(fileURLToPath(import.meta.url)), '..', p.slice(1)), 'utf8');
         res.writeHead(200, { 'Content-Type': 'text/javascript; charset=utf-8', 'Cache-Control': 'no-cache' });
         res.end(js);
       } catch {
         res.writeHead(500, { 'Content-Type': 'text/plain; charset=utf-8' });
-        res.end('app.js 加载失败');
+        res.end(p.slice(1) + ' 加载失败');
       }
       return;
     }
@@ -124,8 +126,8 @@ export function createApiDispatch(deps) {
     }
     if (method === 'GET' && p === '/sw.js') {
       res.writeHead(200, { 'Content-Type': 'application/javascript; charset=utf-8' });
-      // 缓存键去掉 query（?token= 不落缓存）；mingdao-v4：随 token 认证版本升版本号，强制替换旧 SW 缓存
-      res.end(`self.addEventListener('install',()=>self.skipWaiting());self.addEventListener('activate',e=>e.waitUntil(caches.keys().then(ks=>Promise.all(ks.filter(k=>k!=='mingdao-v4').map(k=>caches.delete(k)))).then(()=>clients.claim())));self.addEventListener('fetch',e=>{if(e.request.method==='GET'&&new URL(e.request.url).origin===location.origin&&!e.request.url.includes('/api/')){const u=new URL(e.request.url);u.search='';e.respondWith(fetch(e.request).then(r=>{const c=r.clone();caches.open('mingdao-v4').then(cache=>cache.put(u.toString(),c));return r;}).catch(()=>caches.match(u.toString()).then(m=>m||caches.match('/'))));}});`);
+      // 缓存键去掉 query（?token= 不落缓存）；mingdao-v5：随 token 认证版本升版本号，强制替换旧 SW 缓存
+      res.end(`self.addEventListener('install',()=>self.skipWaiting());self.addEventListener('activate',e=>e.waitUntil(caches.keys().then(ks=>Promise.all(ks.filter(k=>k!=='mingdao-v5').map(k=>caches.delete(k)))).then(()=>clients.claim())));self.addEventListener('fetch',e=>{if(e.request.method==='GET'&&new URL(e.request.url).origin===location.origin&&!e.request.url.includes('/api/')){const u=new URL(e.request.url);u.search='';e.respondWith(fetch(e.request).then(r=>{const c=r.clone();caches.open('mingdao-v5').then(cache=>cache.put(u.toString(),c));return r;}).catch(()=>caches.match(u.toString()).then(m=>m||caches.match('/'))));}});`);
       return;
     }
 

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

@@ -6,7 +6,7 @@ import { loadConfig, saveConfig } from '../../../config.js';
 import { setStoredKey, removeStoredKey, getStoredKey, maskKey } from '../../../credentials.js';
 import { availableModels, fetchProviderModels, providerHasKey } from '../../../model-discovery.js';
 import { createProvider, resolveProviderConfig } from '../../../providers/index.js';
-import { MODELS, PROVIDERS } from '../../../models.js';
+import { MODELS, PROVIDERS, modelPreset } from '../../../models.js';
 import { detectSandbox } from '../../../tools/bash.js';
 import { enableAutostart, disableAutostart, autostartStatus } from '../../../autostart.js';
 import { PRICE_DATA_AS_OF } from '../../../pricing.js';
@@ -29,6 +29,14 @@ export async function handle({ req, res, method, p, url }, deps, shared) {
       .map((s) => ({ file: s.name, mtime: s.mtime, label: `${relativeTime(s.mtime)} · ${sessionPreview(s.file)}` }));
     // 模型列表：只列已设置 Key 的服务商，名称以 /models 接口线上名单为准（预设仅回退与补价）
     const models = await availableModels(cfg, state.modelName);
+    // 思考模式 / 推理等级（v0.2.8）：当前模型是否支持 reasoning、当前档位与可选档位。
+    // 按模型独立：reasoningByModel[当前模型] 覆盖 > 全局 reasoningEffort（旧配置兼容）> 模型预设默认。
+    const rp = modelPreset(state.modelName);
+    const reasoning = {
+      supported: Boolean(rp?.supportsReasoning),
+      effort: cfg.reasoningByModel?.[state.modelName] ?? cfg.reasoningEffort ?? rp?.reasoningEffort?.default ?? (rp?.supportsReasoning ? 'high' : 'off'),
+      options: rp?.reasoningEffort?.options ?? ['low', 'high', 'max'],
+    };
     json(res, 200, {
       ok: true,
       model: state.modelName,
@@ -40,6 +48,7 @@ export async function handle({ req, res, method, p, url }, deps, shared) {
       sandbox: cfg.sandbox || 'off',
       sandboxSupported: detectSandbox() !== 'none',
       routing: cfg.routing?.enabled ? cfg.routing : null,
+      reasoning,
       contextBudget: cfg.contextBudget || 128000,
       pricingAsOf: PRICE_DATA_AS_OF,
       autostart: autostartStatus(),
@@ -103,6 +112,15 @@ export async function handle({ req, res, method, p, url }, deps, shared) {
       next.contextBudget = n;
       cfg.contextBudget = n;
     }
+    if (body.reasoningEffort !== undefined) {
+      const re = String(body.reasoningEffort);
+      if (!['off', 'low', 'high', 'max'].includes(re)) {
+        return json(res, 400, { error: '思考强度必须是 off / low / high / max' });
+      }
+      // 按模型独立：写入当前模型的覆盖档位（不污染其他模型）
+      cfg.reasoningByModel = cfg.reasoningByModel || {};
+      cfg.reasoningByModel[state.modelName] = re;
+    }
     let autostartChanged = false;
     if (body.autostart !== undefined) {
       autostartChanged = true;
@@ -121,7 +139,7 @@ export async function handle({ req, res, method, p, url }, deps, shared) {
     cfg.model = next.model;
     cfg.permission = next.permission;
     saveConfig(cfg);
-    json(res, 200, { ok: true, model: state.modelName, permission: cfg.permission, sandbox: cfg.sandbox, routing: cfg.routing?.enabled, contextBudget: cfg.contextBudget, autostart: autostartChanged ? autostartStatus() : undefined, notify: cfg.notify !== false });
+    json(res, 200, { ok: true, model: state.modelName, permission: cfg.permission, sandbox: cfg.sandbox, routing: cfg.routing?.enabled, contextBudget: cfg.contextBudget, reasoningEffort: cfg.reasoningByModel?.[state.modelName] ?? cfg.reasoningEffort, autostart: autostartChanged ? autostartStatus() : undefined, notify: cfg.notify !== false });
     return true;
   }
 

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

@@ -9,7 +9,8 @@ import {
   relativeTime,
   sessionPreview,
 } from '../../../session.js';
-import { sanitizeTitle, renameSessionFile } from '../../../titles.js';
+import { sanitizeTitle, renameSessionFile, titleModel } from '../../../titles.js';
+import { loadTaskState } from '../../../task-state.js';
 import {
   workspaceForDir,
   touchWorkspace,
@@ -53,6 +54,8 @@ export async function handle({ req, res, method, p, url }, deps, shared) {
         ok: true,
         messages: loaded.messages.filter((m) => m.role === 'user' || m.role === 'assistant').map((m) => ({ role: m.role, content: m.content ?? '' })),
         workspace: ws?.name || null,
+        // v0.3.0 P0-2：未完成检查点（供前端提示续跑）
+        taskState: loadTaskState(path.basename(file)),
       });
     } catch {
       json(res, 404, { error: '会话不存在' });
@@ -84,6 +87,38 @@ export async function handle({ req, res, method, p, url }, deps, shared) {
     return json(res, 400, { error: '未知操作：rename|delete' });
   }
 
+  // v0.3.0 P0-3：会话收尾（前端「新对话/切换会话」时调用）——在会话边界提取项目记忆+日志，
+  // 而非逐轮提取，避免项目记忆文件在会话中途变化破坏前缀缓存（省钱核心）。
+  if (method === 'POST' && p === '/api/session-finalize') {
+    const body = await readBody(req, MAX_API_BODY);
+    const file = path.basename(String(body.file || ''));
+    if (!file) return json(res, 400, { error: '缺少 file 参数' });
+    try {
+      const loaded = loadSession(path.join(home, 'sessions', file));
+      if (loaded.messages.length) {
+        const wsDir = getSessionWorkspace(file) || state.workingDir;
+        const { finalizeSession } = await import('../../../memory.js');
+        const lastAsst = [...loaded.messages].reverse().find((/** @type {any} */ m) => m.role === 'assistant');
+        await finalizeSession({
+          cfg: deps.cfg,
+          provider: deps.provider,
+          model: titleModel(deps.cfg, state.modelName),
+          home,
+          workingDir: wsDir,
+          messages: loaded.messages,
+          turns: loaded.messages.filter((/** @type {any} */ m) => m.role === 'user').length,
+          lastText: lastAsst?.content || '',
+        });
+      }
+      // 清掉该会话的项目记忆快照：下次重新打开会用最新记忆重建系统提示
+      if (deps.sessionMemoryCache) deps.sessionMemoryCache.delete(file);
+      json(res, 200, { ok: true });
+    } catch (/** @type {any} */ e) {
+      json(res, 500, { error: String(e?.message || e) });
+    }
+    return true;
+  }
+
   if (method === 'GET' && p === '/api/draft') {
     // 质检 A5：按会话维度读取（无 file 参数用全局槽，兼容旧客户端）
     const key = String(url.searchParams.get('file') || '');