mingdao-harness 0.1.62 → 0.1.64

package/package.json

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

package/src/cli.js

@@ -266,14 +266,14 @@ async function runWorkerTask(id, question, { permission, model, offpeak }) {
       session: path.basename(session.file),
       note,
     });
-    if (cfg.notify !== false) notifyTaskDone(question, finalStatus === 'killed' ? 'failed' : finalStatus);
+    if (cfg.notify !== false && !process.env.MINGDAO_TASK_QUIET_NOTIFY) notifyTaskDone(question, finalStatus === 'killed' ? 'failed' : finalStatus);
     try {
       await maybeAutoSync();
     } catch {}
     process.exitCode = res.truncated ? 1 : 0;
   } catch (err) {
     finish({ status: 'failed', error: String(err?.message || err) });
-    if (cfg?.notify !== false) notifyTaskDone(question, 'failed');
+    if (cfg?.notify !== false && !process.env.MINGDAO_TASK_QUIET_NOTIFY) notifyTaskDone(question, 'failed');
     process.exitCode = 2;
   } finally {
     if (mcpFacade) mcpFacade.stop();
@@ -377,14 +377,30 @@ async function main() {
   // 单守护进程调度器（评估 P3-5）：一进程监督全部调度任务（协程复用 runSleeper），无任务自动退出
   if (opts.prompt[0] === 'schedule-daemon') {
     const home0 = ensureHome();
-    const { listSchedules, runSleeper, sleeperAlive, daemonPidFile } = await import('./schedule.js');
+    const { listSchedules, runSleeper, sleeperAlive, daemonPidFile, writeSchedule } = await import('./schedule.js');
     const { readTask } = await import('./tasks.js');
     const handled = new Set();
+    const supervising = new Set(); // 本 daemon 正在监督的任务（防崩溃恢复误判正在执行的任务）
     try {
       for (;;) {
         const jobs = listSchedules(home0);
         if (!jobs.some((j) => j.status === 'pending' || j.status === 'running')) break;
         for (const j of jobs) {
+          // 崩溃恢复（审计）：'running' 但无人监督且 worker 已死 → 按任务结果定案或重新排队，
+          // 避免任务永久卡在 running（此前 daemon 重启后既不重跑也不收尾）
+          if (j.status === 'running' && !supervising.has(j.id) && !sleeperAlive(j.pid)) {
+            const t = j.lastTaskId ? readTask(home0, j.lastTaskId) : null;
+            if (!t) {
+              await writeSchedule(home0, { ...j, status: 'pending' });
+              continue;
+            }
+            if (t.status !== 'running') {
+              const result = t.status === 'done' ? 'done' : t.status === 'timedout' ? 'timedout' : 'failed';
+              await writeSchedule(home0, { ...j, status: result, lastRunAt: t.startedAt || j.lastRunAt, runs: (j.runs || 0) + 1 });
+              continue;
+            }
+            continue; // worker 仍在跑：等它（外层 2s 轮询）
+          }
           if (j.status !== 'pending' || handled.has(j.id)) continue;
           if (sleeperAlive(j.pid)) continue; // 旧式 sleeper 仍在：交回给它，避免双跑
           if (j.lastTaskId) {
@@ -392,9 +408,13 @@ async function main() {
             if (t && t.status === 'running') continue; // worker 仍在跑（异常窗口），不重拉
           }
           handled.add(j.id);
+          supervising.add(j.id);
           runSleeper(home0, j.id)
             .catch(() => {})
-            .finally(() => handled.delete(j.id));
+            .finally(() => {
+              handled.delete(j.id);
+              supervising.delete(j.id);
+            });
         }
         await new Promise((r) => setTimeout(r, 2000));
       }

package/src/config.js

@@ -33,6 +33,26 @@ export function loadConfig() {
   }
 }
 
+/** 桌面版首次运行：无配置时自动创建最小可用配置（引导在 WebUI 内完成，
+ * 不再要求先去终端跑 mingdao init）。CLI 的 mingdao init 向导不受影响。 */
+export function ensureMinimalConfig() {
+  const existing = loadConfig();
+  if (existing) return existing;
+  ensureHome();
+  const pp = PROVIDERS['deepseek'] || Object.values(PROVIDERS)[0];
+  const model = modelPreset('deepseek-v4-flash') ? 'deepseek-v4-flash' : pp.models[0];
+  const cfg = {
+    provider: 'deepseek',
+    model,
+    baseUrl: pp.baseUrl,
+    permission: 'ask',
+    sandbox: 'off',
+    contextBudget: 128000,
+  };
+  saveConfig(cfg);
+  return cfg;
+}
+
 export function saveConfig(cfg) {
   ensureHome();
   const p = configPath();

package/src/providers/openai-compatible.js

@@ -25,7 +25,11 @@ export async function chat({ baseUrl, apiKey, model, messages, tools, temperatur
   try {
     res = await fetch(url, {
       method: 'POST',
-      headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${apiKey}` },
+      // 审计（桌面版「第二问挂起」修复）：Node 全局 fetch(undici) 默认连接保活，
+      // 与部分网关/NAT 组合下复用已断开的 keep-alive 连接会静默挂起——首个请求正常、
+      // 后续请求无响应，重启进程恢复。显式 Connection: close 每次新建连接，可靠性优先
+      // （模型请求本身是长流式调用，建连开销占比可忽略）。
+      headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${apiKey}`, Connection: 'close' },
       body: JSON.stringify(payload),
       signal,
     });

package/src/schedule.js

@@ -342,10 +342,15 @@ export async function runSleeper(home, id) {
       if (st === false) return 'pending';
       if (st === 'failed') return 'skipped';
     }
+    // 连续失败熔断（审计：右下角「失败：避峰任务」通知刷屏根因）——周期任务失败后按原周期
+    // 无限重试且每次失败都弹系统通知；这里记录连续失败次数：重试轮次静默（quietNotify），
+    // 连续 3 次失败由 every 主循环熔断停止
+    const prevFails = Number(readSchedule(home, id)?.consecutiveFailures) || 0;
     const task = startTask(home, job.question, {
       permission: job.permission || undefined,
       model: job.model || undefined,
       cwd: job.cwd || process.cwd(),
+      quietNotify: prevFails >= 1,
     });
     // 轮询 worker 状态直至结束（最长 2 小时）；超时清理 worker 防孤儿（审计 P2-8）
     let t = readTask(home, task.id);
@@ -369,14 +374,16 @@ export async function runSleeper(home, id) {
       text: (t?.text || t?.error || '').slice(0, 200),
     });
     if (history.length > 50) history.shift();
+    const result = t?.status === 'done' ? 'done' : t?.status === 'timedout' ? 'timedout' : 'failed';
     writeSchedule(home, {
       ...cur0,
       lastRunAt: Date.now(),
       lastTaskId: task.id,
       runs: (cur0?.runs || 0) + 1,
       history,
+      consecutiveFailures: result === 'done' ? 0 : prevFails + 1,
     });
-    return t?.status === 'done' ? 'done' : t?.status === 'timedout' ? 'timedout' : 'failed';
+    return result;
   };
 
   for (;;) {
@@ -389,9 +396,18 @@ export async function runSleeper(home, id) {
         continue;
       }
       writeSchedule(home, { ...cur, status: 'running' });
-      await runOnce();
+      const result = await runOnce();
       const cur2 = readSchedule(home, id);
       if (!cur2) return;
+      // 连续失败熔断（审计：通知刷屏修复）——3 次失败即停止，避免无限重试 + 无限弹通知
+      if (result !== 'done' && (cur2.consecutiveFailures || 0) >= 3) {
+        writeSchedule(home, {
+          ...cur2,
+          status: 'failed',
+          note: '连续失败 3 次已停止重试：请检查 API Key / 模型 / 网络（mingdao schedule list 查看历史）',
+        });
+        return;
+      }
       // 下次 = 完成时间 + 周期（不追赶错过的档期）；有每日锚点时对齐锚点，避免逐日漂移
       const next = cur2.anchor ? nextAnchorAfter(cur2.anchor, cur2.interval) || Date.now() + cur2.interval : Date.now() + cur2.interval;
       writeSchedule(home, { ...cur2, status: 'pending', nextRunAt: next });

package/src/skill-registry.js

@@ -116,6 +116,9 @@ export async function installFromRegistry(name) {
 
   const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'mingdao-reg-'));
   try {
+    // 逐文件下载按镜像回退（审计：国内网络下 raw.githubusercontent 常超时/被断，
+    // 此前只试首选主机 → 安装报「This operation was aborted」；gitee/gitcode 国内秒开）
+    const hosts = [r.host, ...registryBase().hosts.filter((h) => h !== r.host)];
     let verified = false; // 是否至少一个文件做了 sha256 校验（索引声明了哈希才校验）
     for (const f of entry.files) {
       const rel = String(f.path || '').replace(/\\/g, '/');
@@ -124,12 +127,17 @@ export async function installFromRegistry(name) {
       }
       const dest = path.join(tmp, rel);
       fs.mkdirSync(path.dirname(dest), { recursive: true });
-      let text;
-      try {
-        text = await fetchText(`${r.host}/skills-lib/${encodeURI(name)}/${rel.split('/').map(encodeURIComponent).join('/')}`, 30000, MAX_FILE);
-      } catch (e) {
-        return { error: `下载 ${name}/${rel} 失败：${e.message}` };
+      let text = null;
+      let lastErr = '';
+      for (const host of hosts) {
+        try {
+          text = await fetchText(`${host}/skills-lib/${encodeURI(name)}/${rel.split('/').map(encodeURIComponent).join('/')}`, 30000, MAX_FILE);
+          break;
+        } catch (e) {
+          lastErr = e?.name === 'AbortError' ? '下载超时' : String(e?.message || e);
+        }
       }
+      if (text === null) return { error: `下载 ${name}/${rel} 失败：${lastErr}（已尝试全部镜像）` };
       if (text.length > MAX_FILE) return { error: `${name}/${rel} 超过 512KB 上限` };
       // 完整性校验（P3-3）：索引声明 sha256 时逐文件比对，不符即拒绝安装（供应链防护）
       if (f.sha256 && typeof f.sha256 === 'string') {

package/src/tasks.js

@@ -54,7 +54,7 @@ export function isValidTaskId(id) {
   return typeof id === 'string' && /^[a-z0-9]+$/.test(id) && id.length >= 4 && id.length <= 40;
 }
 
-export function startTask(home, question, { permission, model, cwd, offpeak } = /** @type {any} */ ({})) {
+export function startTask(home, question, { permission, model, cwd, offpeak, quietNotify } = /** @type {any} */ ({})) {
   const id = Date.now().toString(36) + Math.random().toString(36).slice(2, 6) + process.pid.toString(36);
   const task = {
     id,
@@ -78,7 +78,8 @@ export function startTask(home, question, { permission, model, cwd, offpeak } =
     cwd: cwd || process.cwd(),
     detached: true,
     stdio: 'ignore',
-    env: { ...process.env, MINGDAO_HOME: home },
+    // 连续失败的重试轮次静默：只保留首次失败的系统通知，避免右下角刷屏（审计）
+    env: { ...process.env, MINGDAO_HOME: home, ...(quietNotify ? { MINGDAO_TASK_QUIET_NOTIFY: '1' } : {}) },
   });
   task.pid = child.pid;
   writeTask(home, task);

package/src/titles.js

@@ -18,37 +18,48 @@ function cleanTitle(s) {
     .slice(0, 20);
 }
 
-export async function generateTitle(provider, model, firstUserText) {
+export async function generateTitle(provider, model, firstUserText, { timeoutMs = 10000 } = {}) {
+  // 硬超时护栏（审计：「第二问无反应」根因）：标题生成发生在回合收尾阶段，若网关/网络层
+  // 挂起（不抛错），回合永远无法 complete——前端停在生成态、后续发送全部静默。20s 兜底：
+  // 超时放弃标题（会话仍以时间戳命名），绝不阻塞下一问。
+  const ctrl = new AbortController();
+  const timer = setTimeout(() => ctrl.abort(new Error('标题生成超时')), timeoutMs);
   const user = { role: 'user', content: String(firstUserText).slice(0, 300) };
-  // 结构化输出（评估 4.2-4）：json_object，maxTokens 120→50，解析零失败；网关不支持时回退纯文本
   try {
-    const res = await provider.chat({
-      model,
-      messages: [
-        { role: 'system', content: '为下面的对话开头生成一个简短标题（≤12 字，中文，不要引号、句号、markdown 符号）。只输出 JSON：{"title":"标题"}。' },
-        user,
-      ],
-      tools: [],
-      temperature: 0.3,
-      maxTokens: 50,
-      responseFormat: { type: 'json_object' },
-    });
-    const j = JSON.parse(String(res.text || '').trim());
-    const t = cleanTitle(j?.title);
-    if (t) return t;
-  } catch {}
-  try {
-    const res = await provider.chat({
-      model,
-      messages: [{ role: 'system', content: '为下面的对话开头生成一个简短标题（≤12 字，中文，不要引号、句号、markdown 符号，直接输出标题本身）。' }, user],
-      tools: [],
-      temperature: 0.3,
-      maxTokens: 120,
-    });
-    const t = cleanTitle(res.text);
-    return t || null;
-  } catch {
-    return null;
+    // 结构化输出（评估 4.2-4）：json_object，maxTokens 120→50，解析零失败；网关不支持时回退纯文本
+    try {
+      const res = await provider.chat({
+        model,
+        messages: [
+          { role: 'system', content: '为下面的对话开头生成一个简短标题（≤12 字，中文，不要引号、句号、markdown 符号）。只输出 JSON：{"title":"标题"}。' },
+          user,
+        ],
+        tools: [],
+        temperature: 0.3,
+        maxTokens: 50,
+        responseFormat: { type: 'json_object' },
+        signal: ctrl.signal,
+      });
+      const j = JSON.parse(String(res.text || '').trim());
+      const t = cleanTitle(j?.title);
+      if (t) return t;
+    } catch {}
+    try {
+      const res = await provider.chat({
+        model,
+        messages: [{ role: 'system', content: '为下面的对话开头生成一个简短标题（≤12 字，中文，不要引号、句号、markdown 符号，直接输出标题本身）。' }, user],
+        tools: [],
+        temperature: 0.3,
+        maxTokens: 120,
+        signal: ctrl.signal,
+      });
+      const t = cleanTitle(res.text);
+      return t || null;
+    } catch {
+      return null;
+    }
+  } finally {
+    clearTimeout(timer);
   }
 }
 

package/src/web/index.html

@@ -50,19 +50,26 @@ button.primary{background:var(--accent);color:#06231a;border:none;font-weight:60
 button.danger{background:var(--err);color:#fff;border:none}
 button:disabled{opacity:.45;cursor:not-allowed}
 main{flex:1;overflow-y:auto;padding:18px 0 12px;min-width:0}
-#chat{max-width:860px;margin:0 auto;padding:0 18px;display:flex;flex-direction:column;gap:18px}
+#chat{max-width:860px;margin:0 auto;padding:0 18px;display:flex;flex-direction:column;gap:20px}
 .msg-user{display:flex;justify-content:flex-end}
-.msg-user .bubble{background:var(--user);border:1px solid #2c4a66;border-radius:14px 14px 4px 14px;padding:10px 14px;max-width:78%;white-space:pre-wrap;word-break:break-word}
-.msg-ai{display:flex;flex-direction:column;gap:10px}
-.msg-ai .content{white-space:normal;word-break:break-word}
-.msg-ai .content h1,.msg-ai .content h2,.msg-ai .content h3{font-size:1.05em;margin:.6em 0 .3em;color:var(--accent2)}
-.msg-ai .content h4{font-size:1em;margin:.5em 0 .2em}
-.msg-ai .content p{margin:.35em 0}
-.msg-ai .content ul,.msg-ai .content ol{margin:.3em 0;padding-left:1.4em}
-.msg-ai .content li{margin:.15em 0}
-.msg-ai .content blockquote{margin:.4em 0;padding-left:10px;border-left:3px solid var(--border);color:var(--dim)}
+.msg-user .bubble{background:linear-gradient(135deg,#1f3d57,#173a33);border:1px solid #2c5a4a;border-radius:16px 16px 4px 16px;padding:10px 16px;max-width:78%;white-space:pre-wrap;word-break:break-word;font-size:14.5px;line-height:1.7}
+.msg-ai{display:flex;flex-direction:column;gap:10px;font-size:15px;color:var(--text)}
+.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)}
+.msg-ai .content h2{font-size:18px;margin:16px 0 8px;padding-left:10px;border-left:4px solid var(--accent)}
+.msg-ai .content h3{font-size:16px;margin:13px 0 6px}
+.msg-ai .content h4{font-size:15px;margin:11px 0 5px;color:var(--accent2)}
+.msg-ai .content p{margin:0 0 12px}
+.msg-ai .content p:last-child{margin-bottom:0}
+.msg-ai .content ul,.msg-ai .content ol{margin:0 0 12px;padding-left:24px}
+.msg-ai .content li{margin:4px 0}
+.msg-ai .content li::marker{color:var(--accent2)}
+.msg-ai .content blockquote{margin:0 0 12px;padding:8px 14px;border-left:3px solid var(--accent2);background:var(--bg3);border-radius:0 8px 8px 0;color:var(--dim)}
+.msg-ai .content hr{border:none;border-top:1px solid var(--border);margin:16px 0}
+.msg-ai .content b,.msg-ai .content strong{font-weight:700;color:var(--text)}
 .msg-ai .content code{background:var(--code);border:1px solid var(--border);border-radius:4px;padding:1px 6px;font:12.5px/1.5 ui-monospace,SFMono-Regular,Consolas,monospace;color:#7ee0b8}
-.msg-ai .content pre{background:var(--code);border:1px solid var(--border);border-radius:10px;padding:12px 14px;overflow-x:auto;margin:.5em 0}
+.msg-ai .content pre{background:var(--code);border:1px solid var(--border);border-radius:10px;padding:12px 14px;overflow-x:auto;margin:.5em 0 12px}
 .msg-ai .content pre code{background:none;border:none;padding:0;color:#c8d3e0}
 .msg-ai .content a{color:var(--accent2)}
 .msg-ai .content .hl-kw{color:#7aa2f7;font-weight:600}.hl-s{color:#9ece6a}.hl-n{color:#e0af68}.hl-c{color:#565f6e;font-style:italic}.hl-f{color:#7dcfff}
@@ -306,6 +313,39 @@ if (AUTH_TOKEN) {
   };
 }
 const $ = (s) => document.querySelector(s);
+
+// —— 弹窗三件套（Electron 不实现 window.prompt/confirm/alert：prompt 恒返回 null、confirm 恒 false、
+// alert 静默无反应——桌面版「⚙ 设置里点设Key 没反应」即由此而来）。统一替换为应用内模态框。
+function modalBox(inner){
+  const mask=document.createElement('div'); mask.className='modal-mask';
+  const m=document.createElement('div'); m.className='modal'; m.innerHTML=inner;
+  mask.appendChild(m); document.body.appendChild(mask);
+  return {mask, m};
+}
+function uiPrompt(title, def, opts){
+  opts=opts||{};
+  return new Promise((resolve)=>{
+    const {mask, m}=modalBox('<h3>'+esc(String(title??''))+'</h3><input class="uiPromptInput" '+(opts.hidden?'type="password" ':'')+'style="width:100%;background:var(--bg3);color:var(--text);border:1px solid var(--border);border-radius:8px;padding:8px 10px;font-size:13.5px;margin-top:10px"><div class="row" style="margin-top:12px"><button class="danger" data-a="c">取消</button><button class="primary" data-a="y">确定</button></div>');
+    const inp=m.querySelector('input');
+    if(def!==undefined&&def!==null) inp.value=String(def);
+    const done=(v)=>{ mask.remove(); resolve(v); };
+    m.querySelector('[data-a=y]').onclick=()=>done(inp.value);
+    m.querySelector('[data-a=c]').onclick=()=>done(null);
+    inp.addEventListener('keydown',(e)=>{ if(e.key==='Enter') done(inp.value); if(e.key==='Escape') done(null); });
+    setTimeout(()=>inp.focus(),0);
+  });
+}
+function uiConfirm(title){
+  return new Promise((resolve)=>{
+    const {mask, m}=modalBox('<h3>'+esc(String(title??''))+'</h3><div class="row" style="margin-top:12px"><button class="danger" data-a="c">取消</button><button class="primary" data-a="y">确定</button></div>');
+    m.querySelector('[data-a=y]').onclick=()=>{ mask.remove(); resolve(true); };
+    m.querySelector('[data-a=c]').onclick=()=>{ mask.remove(); resolve(false); };
+  });
+}
+function uiAlert(title){
+  const {mask, m}=modalBox('<h3>'+esc(String(title??''))+'</h3><div class="row" style="margin-top:12px"><button class="primary" data-a="y">确定</button></div>');
+  m.querySelector('[data-a=y]').onclick=()=>mask.remove();
+}
 // —— 目录选择器（新建工作空间 / 改目录）：浏览服务器磁盘目录树 ——
 let pickerCb = null, pickerDir = '/';
 function loadDirList(){
@@ -371,26 +411,44 @@ function highlight(code, lang){
   });
 }
 function renderMarkdown(text){
-  const lines = String(text).split('\n'); let out='', code=null, codeLang='';
-  // 审计 P1-3：codeLang 经 esc() 转义防 XSS（信息串闭合 class 注入）
-  const flush=()=>{ if(code!==null){ out+='<pre><code class="lang-'+esc(codeLang)+'">'+highlight(code.join('\n'),codeLang)+'</code></pre>'; code=null; } };
-  for(const line of lines){
-    if(line.trim().startsWith('```')){
-      if(code===null){ code=[]; codeLang=(line.trim().slice(3).trim().split(/\s+/)[0]||''); }
-      else flush();
+  // 块级解析（美化：加粗标题 / 段落 / 真列表 / 引用 / 分割线，参照 DeepSeek-Harness 会话排版）
+  const lines = String(text).split('\n');
+  let out = '', code = null, codeLang = '';
+  const flushCode = () => { if (code !== null) { out += '<pre><code class="lang-' + esc(codeLang) + '">' + highlight(code.join('\n'), codeLang) + '</code></pre>'; 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; }
-    let l = esc(line);
-    l = l.replace(/`([^`]+)`/g,'<code>$1</code>').replace(/\*\*([^*]+)\*\*/g,'<b>$1</b>').replace(/\*([^*\s][^*]*)\*/g,'<i>$1</i>');
-    l = l.replace(/\[([^\]]+)\]\((https?:\/\/[^\s'"<>)]+)\)/g,'<a href="$2" target="_blank" rel="noopener">$1</a>');
-    if(/^#{1,6}\s/.test(line.trim())){ const m=line.trim().match(/^(#+)\s+(.*)/); const h=Math.min(m[1].length,3); l='<h'+h+'>'+esc(m[2])+'</h'+h+'>'; }
-    else if(/^\s*[-*+]\s/.test(line)) l='• '+l.replace(/^\s*[-*+]\s/,'');
-    else if(/^\s*\d+[.)]\s/.test(line)) l=l.replace(/^\s*(\d+)[.)]\s/,'<b>$1.</b> ');
-    else if(/^>\s?/.test(line)) l='<blockquote>'+l.replace(/^>\s?/,'')+'</blockquote>';
-    out+= l+'<br>';
+    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));
   }
-  flush();
+  flushCode(); flushList(); flushPara();
   return out;
 }
 function scrollBottom(){ chatEl.scrollTop = chatEl.scrollHeight; }
@@ -515,17 +573,17 @@ let attachments=[];
 $('#attachBtn').onclick=()=>{ $('#fileInput').click(); };
 $('#fileInput').addEventListener('change', async e=>{
   for(const f of e.target.files||[]){
-    if(attachments.length>=4){ alert('最多 4 个附件'); break; }
+    if(attachments.length>=4){ uiAlert('最多 4 个附件'); break; }
     if(f.type.startsWith('image/')){
-      if(f.size>5*1024*1024){ alert(f.name+' 超过 5MB'); continue; }
+      if(f.size>5*1024*1024){ 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){ alert(f.name+' 超过 200KB'); continue; }
+      if(f.size>200*1024){ 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{
-      alert(f.name+'：暂只支持图片与文本文件');
+      uiAlert(f.name+'：暂只支持图片与文本文件');
     }
   }
   e.target.value='';
@@ -546,8 +604,17 @@ function renderAttachments(){
 }
 
 async function send(){
-  if(generating){ abort(); return; } // 生成中：同一按钮承担停止职责
-  const text=input.value.trim(); if(!text && !attachments.length) return;
+  const text=input.value.trim();
+  console.log('[MingDao] send 点击：generating=' + generating + ' text=' + text.length + ' attachments=' + attachments.length);
+  if(generating){ console.log('[MingDao] send 被生成态拦截 → 走 abort'); abort(); return; } // 生成中：同一按钮承担停止职责
+  if(!text && !attachments.length) return;
+  generating=true; setBtn(); // 本地在途状态：不再依赖 /api/tasks 轮询
+  const turnCtrl=new AbortController();
+  // 回合看门狗：120 秒无任何响应强制中断——无论服务端处于什么状态，界面都能自动恢复可发送
+  const watchdog=setTimeout(()=>{
+    try{ turnCtrl.abort(); }catch{}
+    fetch('/api/abort',{method:'POST',headers:{'Content-Type':'application/json'},body:'{}'}).catch(()=>{});
+  },120000);
   input.value=''; input.style.height='44px';
   const payload={message:text,file:currentSession};
   // 带上文开关：勾选后系统提示注入最近会话日志（默认不注入——新会话全新开始，避免串到历史会话上下文）
@@ -573,7 +640,7 @@ async function send(){
   const onActivity=()=>{ if(think.parentNode) think.remove(); if(reason&&reason.parentElement){ reason.parentElement.open=false; reason.parentElement.querySelector('summary').classList.remove('live'); } };
   updateTasksPanel();
   try{
-    const resp=await fetch('/api/chat',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify(payload)});
+    const resp=await fetch('/api/chat',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify(payload),signal:turnCtrl.signal});
     if(!resp.ok){ const j=await resp.json().catch(()=>({})); onActivity(); msg.innerHTML='<div class="errline">'+esc(j.error||('HTTP '+resp.status))+'</div>'; updateTasksPanel(); return; }
     await handleEvents(resp.body, ev=>{
       if(ev.taskId) taskId=ev.taskId;
@@ -587,24 +654,27 @@ async function send(){
       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})}).catch(()=>{})); }
       else if(ev.type==='usage'){ onActivity(); const u=document.createElement('div'); u.className='usage'; u.textContent=''+ev.modelName+' · ↑'+ev.usage.prompt_tokens+' ↓'+ev.usage.completion_tokens+' tokens · '+((ev.durationMs||0)/1000).toFixed(1)+'s'+ev.cost; msg.appendChild(u); scroll(); }
-      else if(ev.type==='error'){ onActivity(); const d=document.createElement('div'); d.className='errline'; d.textContent=ev.message; msg.appendChild(d); scroll(); }
-      else if(ev.type==='done'){ onActivity(); if(ev.budget){ const b=ev.budget; hintEl.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(); }
+      else if(ev.type==='error'){ console.log('[MingDao] error 事件：' + ev.message); onActivity(); const d=document.createElement('div'); d.className='errline'; d.textContent=ev.message; msg.appendChild(d); scroll(); }
+      else if(ev.type==='done'){ console.log('[MingDao] done 事件：session=' + ev.session); onActivity(); if(ev.budget){ const b=ev.budget; hintEl.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.message||'网络错误'; msg.appendChild(d); scroll(); }
-  finally{ clearInterval(hintTimer); hintEl.classList.remove('working'); hintEl.textContent=defaultHint; pending=false; content.innerHTML=renderMarkdown(raw); scroll(); updateTasksPanel(); }
+  }catch(e){ onActivity(); const d=document.createElement('div'); d.className='errline'; d.textContent=(e&&e.name==='AbortError')?'响应超时已中断（120 秒无响应），请重试':(e&&e.message)||'网络错误'; msg.appendChild(d); scroll(); }
+  finally{ clearInterval(hintTimer); clearTimeout(watchdog); generating=false; setBtn(); console.log('[MingDao] 回合收尾：generating=false，按钮恢复发送'); hintEl.classList.remove('working'); hintEl.textContent=defaultHint; pending=false; content.innerHTML=renderMarkdown(raw); scroll(); updateTasksPanel(); }
 }
 
 function abort(){ fetch('/api/abort',{method:'POST',headers:{'Content-Type':'application/json'},body:'{}'}).then(()=>updateTasksPanel()).catch(()=>{}); }
 
 // —— 任务面板（多会话并行） ——
+function setBtn(){
+  sendBtn.textContent = generating ? '■ 停止' : '发送';
+  sendBtn.className = generating ? 'danger' : 'primary';
+}
 async function updateTasksPanel(){
   const r=await fetch('/api/tasks').catch(()=>null); if(!r) return;
   const j=await r.json(); const list=$('#tpList'); list.innerHTML='';
   $('#tpCount').textContent='（'+j.running+' 运行中 / 上限 '+j.maxConcurrent+'）';
-  // 发送按钮复用：生成中变「■ 停止」（点击中止全部运行中任务）
-  generating = j.running > 0;
-  sendBtn.textContent = generating ? '■ 停止' : '发送';
-  sendBtn.className = generating ? 'danger' : 'primary';
+  // 审计（第二问无反应修复）：generating 改为「本轮在途」本地状态，由 send/finally 维护，
+  // 不再由 /api/tasks 轮询推导——任务面板瞬时波动或一次轮询失败曾让按钮永久卡在停止态，
+  // 后续发送全部静默。面板仅展示，不参与按钮状态。
   for(const t of j.tasks){
     const div=document.createElement('div'); div.className='tp-item';
     const dot = t.status==='running'?'tp-run':(t.status==='done'?'tp-done':'tp-bad');
@@ -666,6 +736,10 @@ async function init(){
     $('#notifyChk').checked=j.notify!==false;
     const env = ('路由'+(j.routing?'开':'关')+' · 沙箱'+((j.sandbox&&j.sandbox!=='off')?(j.sandboxSupported?j.sandbox:'降级'):'off'));
     $('#envBadge').textContent=env; $('#envBadge').style.display='';
+    // 首次使用引导：无 API Key 时明确提示去设置（桌面版自动初始化后必走这里）
+    if (j.keyReady === false) {
+      renderBanner({ text: '🔑 欢迎使用 MingDao Harness！还没有配置 API Key：请点击右上角 ⚙ 设置 →「模型与 API Key」选择模型并填入密钥（DeepSeek 平台申请）后即可对话。' });
+    }
   }catch(e){
     const ms=$('#modelSel'); if(!ms.options.length){ const o=document.createElement('option'); o.textContent='加载失败，刷新重试'; ms.appendChild(o); }
   }
@@ -698,11 +772,11 @@ async function refreshWsSel(){
 $('#wsSel').addEventListener('change', async e=>{
   const v=e.target.value;
   if(v==='__add__'){
-    const name=prompt('新工作空间名称：'); if(!name){ refreshWsSel(); return; }
+    const name=await uiPrompt('新工作空间名称：'); if(!name){ refreshWsSel(); return; }
     openDirPicker(null, (dir)=>{
       fetch('/api/workspaces',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'add',name,dir:dir||undefined})})
         .then((r)=>r.json()).then((j)=>{
-          if(j.ok) renderBanner({text:'✓ 已登记工作空间 '+j.name+' → '+j.dir+'（目录已自动创建）'}); else alert(j.error||'创建失败');
+          if(j.ok) renderBanner({text:'✓ 已登记工作空间 '+j.name+' → '+j.dir+'（目录已自动创建）'}); else uiAlert(j.error||'创建失败');
           refreshWsSel(); reloadModels();
         });
     });
@@ -719,7 +793,7 @@ $('#wsSel').addEventListener('change', async e=>{
     if(currentSession) payload.file=currentSession;
     const r=await fetch('/api/workspaces',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify(payload)});
     const j=await r.json().catch(()=>({error:'请求失败'}));
-    if(j.ok) renderBanner({text:'✓ 已切换到工作空间 '+j.name+'（'+j.dir+'），后续工具在此目录执行'}); else { alert(j.error||'切换失败'); }
+    if(j.ok) renderBanner({text:'✓ 已切换到工作空间 '+j.name+'（'+j.dir+'），后续工具在此目录执行'}); else { uiAlert(j.error||'切换失败'); }
     refreshWsSel(); reloadModels();
   }
 });
@@ -748,11 +822,11 @@ $('#schAdd').onclick=async ()=>{
   if($('#schOffpeak').checked) payload.offpeak=true;
   if(kind==='at'){ const v=$('#schAt').value; if(!v) return; payload.at=v.replace('T',' '); }
   else if(kind==='every'){ payload.every=$('#schEvery').value; }
-  else if(kind==='chain'){ const v=$('#schChain').value.trim(); if(!v) return; const qs=v.split('\n').map(x=>x.trim()).filter(Boolean); if(qs.length<2){ alert('链式需要至少两行任务'); return; } payload.action='chain'; payload.questions=qs; }
+  else if(kind==='chain'){ const v=$('#schChain').value.trim(); if(!v) return; const qs=v.split('\n').map(x=>x.trim()).filter(Boolean); if(qs.length<2){ uiAlert('链式需要至少两行任务'); return; } payload.action='chain'; payload.questions=qs; }
   else { const v=$('#schAfter').value.trim(); if(!v) return; payload.after=[v]; }
   const r=await fetch('/api/schedule',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify(payload)});
   const j=await r.json().catch(()=>({error:'请求失败'}));
-  if(j.ok){ $('#schQuestion').value=''; refreshSchList(); } else { alert(j.error||'添加失败'); }
+  if(j.ok){ $('#schQuestion').value=''; refreshSchList(); } else { uiAlert(j.error||'添加失败'); }
 };
 // —— 工作空间 ——
 async function refreshWorkspaces(){
@@ -762,9 +836,9 @@ async function refreshWorkspaces(){
   for(const w of j.workspaces){
     const div=document.createElement('div'); div.style.cssText='display:flex;align-items:center;gap:6px;padding:5px 0;border-bottom:1px solid var(--border);font-size:12px';
     div.innerHTML='<span style="flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap">'+esc(w.name)+(w.name===j.current?' <span style="color:var(--accent)">●当前</span>':'')+'</span><span style="flex:1.4;color:var(--faint);overflow:hidden;text-overflow:ellipsis;white-space:nowrap;direction:rtl;text-align:left">'+esc(w.dir||'')+'</span>';
-    const ed=document.createElement('button'); ed.textContent='改目录'; ed.style.cssText='padding:1px 8px;font-size:11px'; ed.onclick=()=>{ openDirPicker(w.dir||null, async (d)=>{ if(d==null) return; const rr=await fetch('/api/workspaces',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'set',name:w.name,dir:d})}); const jj=await rr.json().catch(()=>({error:'失败'})); if(jj.ok){ refreshWorkspaces(); refreshWsSel(); reloadModels(); } else alert(jj.error||'修改失败'); }); };
-    const rn=document.createElement('button'); rn.textContent='重命名'; rn.style.cssText='padding:1px 8px;font-size:11px'; rn.onclick=async()=>{ const t=prompt('新名称：', w.name); if(!t) return; const rr=await fetch('/api/workspaces',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'rename',name:w.name,newName:t})}); const jj=await rr.json().catch(()=>({error:'失败'})); if(jj.ok){ refreshWorkspaces(); refreshWsSel(); } else alert(jj.error||'重命名失败'); };
-    const rm=document.createElement('button'); rm.textContent='删除'; rm.className='danger'; rm.style.cssText='padding:1px 8px;font-size:11px'; rm.onclick=async()=>{ if(!confirm('删除工作空间 '+w.name+'？')) return; await fetch('/api/workspaces',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'remove',name:w.name})}); refreshWorkspaces(); refreshWsSel(); reloadModels(); };
+    const ed=document.createElement('button'); ed.textContent='改目录'; ed.style.cssText='padding:1px 8px;font-size:11px'; ed.onclick=()=>{ openDirPicker(w.dir||null, async (d)=>{ if(d==null) return; const rr=await fetch('/api/workspaces',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'set',name:w.name,dir:d})}); const jj=await rr.json().catch(()=>({error:'失败'})); if(jj.ok){ refreshWorkspaces(); refreshWsSel(); reloadModels(); } else uiAlert(jj.error||'修改失败'); }); };
+    const rn=document.createElement('button'); rn.textContent='重命名'; rn.style.cssText='padding:1px 8px;font-size:11px'; rn.onclick=async()=>{ const t=await uiPrompt('新名称：', w.name); if(!t) return; const rr=await fetch('/api/workspaces',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'rename',name:w.name,newName:t})}); const jj=await rr.json().catch(()=>({error:'失败'})); if(jj.ok){ refreshWorkspaces(); refreshWsSel(); } else uiAlert(jj.error||'重命名失败'); };
+    const rm=document.createElement('button'); rm.textContent='删除'; rm.className='danger'; rm.style.cssText='padding:1px 8px;font-size:11px'; rm.onclick=async()=>{ if(!await uiConfirm('删除工作空间 '+w.name+'？')) return; await fetch('/api/workspaces',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'remove',name:w.name})}); refreshWorkspaces(); refreshWsSel(); reloadModels(); };
     div.appendChild(ed); div.appendChild(rn); div.appendChild(rm); list.appendChild(div);
   }
 }
@@ -773,7 +847,7 @@ $('#wsAdd').onclick=async ()=>{
   const dir=$('#wsDir').value.trim();
   const r=await fetch('/api/workspaces',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'add',name,dir})});
   const j=await r.json().catch(()=>({error:'请求失败'}));
-  if(j.ok){ $('#wsName').value=''; $('#wsDir').value=''; refreshWorkspaces(); refreshWsSel(); reloadModels(); } else alert(j.error||'添加失败');
+  if(j.ok){ $('#wsName').value=''; $('#wsDir').value=''; refreshWorkspaces(); refreshWsSel(); reloadModels(); } else uiAlert(j.error||'添加失败');
 };
 // —— 长期记忆 ——
 function memFlash(msg, good){ const m=$('#memMsg'); m.textContent=msg; m.style.color=good?'var(--accent)':'var(--err)'; setTimeout(()=>{m.textContent='';},4000); }
@@ -829,7 +903,7 @@ $('#mcpAdd').onclick=async ()=>{
   const arg=$('#mcpArg').value.trim();
   const r=await fetch('/api/mcp-presets',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({name,arg})});
   const j=await r.json().catch(()=>({error:'请求失败'}));
-  if(j.ok) alert('✓ 已接入 '+name+'（重启 mingdao web 后生效，/mcp 查看状态）'); else alert(j.error||'接入失败');
+  if(j.ok) uiAlert('✓ 已接入 '+name+'（重启 mingdao web 后生效，/mcp 查看状态）'); else uiAlert(j.error||'接入失败');
 };
 // —— 技能库 ——
 let skillSearchTimer=null;
@@ -859,7 +933,7 @@ async function refreshSkillLib(q, force){
       const body=s.installed?{action:'uninstall',name:s.name}:{action:'install',name:s.name};
       const rr=await fetch('/api/skills',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify(body)});
       const jj=await rr.json().catch(()=>({error:'请求失败'}));
-      if(jj.ok) refreshSkillLib($('#skillSearch').value.trim()); else alert(jj.error||'操作失败');
+      if(jj.ok) refreshSkillLib($('#skillSearch').value.trim()); else uiAlert(jj.error||'操作失败');
     };
     div.appendChild(b); list.appendChild(div);
   }
@@ -891,9 +965,9 @@ async function refreshModelsCfg(){
     const state=p.keyState==='stored'?'<span style="color:var(--accent)">已存 '+esc(p.keyMasked||'')+'</span>':p.keyState==='env'?'<span style="color:var(--dim)">环境变量 '+esc(p.envKey||'')+'</span>':'<span style="color:var(--err)">未设置</span>';
     div.innerHTML='<span style="flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap"><b>'+esc(p.name)+'</b> '+esc(p.label)+'</span><span style="white-space:nowrap">'+state+'</span>';
     const set=document.createElement('button'); set.textContent='设Key'; set.style.cssText='padding:1px 8px;font-size:11px';
-    set.onclick=async()=>{ const k=prompt('API Key（'+p.name+'）：'); if(k===null) return; const rr=await fetch('/api/models-config',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'setProviderKey',provider:p.name,key:k})}); const jj=await rr.json().catch(()=>({error:'请求失败'})); if(jj.ok){ refreshModelsCfg(); reloadModels(); if(jj.modelsNote) alert(jj.modelsNote); } else alert(jj.error||'设置失败'); };
-    if(p.keyState==='stored'&&p.name!=='custom'){ const rf=document.createElement('button'); rf.textContent='刷新模型'; rf.style.cssText='padding:1px 8px;font-size:11px'; rf.onclick=async()=>{ const rr=await fetch('/api/models-config',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'refreshModels',provider:p.name})}); const jj=await rr.json().catch(()=>({error:'请求失败'})); if(jj.ok){ reloadModels(); alert('✓ 已拉取 '+jj.models.length+' 个线上模型'+(jj.fromCache?'（缓存）':'')); } else alert(jj.error||'刷新失败'); }; div.appendChild(rf); }
-    if(p.keyState==='stored'){ const rm=document.createElement('button'); rm.textContent='删除'; rm.className='danger'; rm.style.cssText='padding:1px 8px;font-size:11px'; rm.onclick=async()=>{ if(!confirm('删除 '+p.name+' 的 Key？')) return; await fetch('/api/models-config',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'removeProviderKey',provider:p.name})}); refreshModelsCfg(); reloadModels(); }; div.appendChild(rm); }
+    set.onclick=async()=>{ const k=await uiPrompt('API Key（'+p.name+'）：', null, {hidden:true}); if(k===null) return; const rr=await fetch('/api/models-config',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'setProviderKey',provider:p.name,key:k})}); const jj=await rr.json().catch(()=>({error:'请求失败'})); if(jj.ok){ refreshModelsCfg(); reloadModels(); if(jj.modelsNote) uiAlert(jj.modelsNote); } else uiAlert(jj.error||'设置失败'); };
+    if(p.keyState==='stored'&&p.name!=='custom'){ const rf=document.createElement('button'); rf.textContent='刷新模型'; rf.style.cssText='padding:1px 8px;font-size:11px'; rf.onclick=async()=>{ const rr=await fetch('/api/models-config',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'refreshModels',provider:p.name})}); const jj=await rr.json().catch(()=>({error:'请求失败'})); if(jj.ok){ reloadModels(); uiAlert('✓ 已拉取 '+jj.models.length+' 个线上模型'+(jj.fromCache?'（缓存）':'')); } else uiAlert(jj.error||'刷新失败'); }; div.appendChild(rf); }
+    if(p.keyState==='stored'){ const rm=document.createElement('button'); rm.textContent='删除'; rm.className='danger'; rm.style.cssText='padding:1px 8px;font-size:11px'; rm.onclick=async()=>{ if(!await uiConfirm('删除 '+p.name+' 的 Key？')) return; await fetch('/api/models-config',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'removeProviderKey',provider:p.name})}); refreshModelsCfg(); reloadModels(); }; div.appendChild(rm); }
     div.appendChild(set); pk.appendChild(div);
   }
   const cl=$('#cmList'); cl.innerHTML='';
@@ -902,9 +976,9 @@ async function refreshModelsCfg(){
     const div=document.createElement('div'); div.style.cssText='display:flex;align-items:center;gap:6px;padding:5px 0;border-bottom:1px solid var(--border);font-size:12px';
     const kstate=c.keyState==='stored'?'<span style="color:var(--accent)">'+esc(c.keyMasked||'')+'</span>':'<span style="color:var(--err)">无Key</span>';
     div.innerHTML='<span style="flex:1;min-width:0"><b>'+esc(c.name)+'</b> <span style="color:var(--faint)">'+esc(c.label)+' · '+esc(c.baseUrl)+'</span></span><span style="white-space:nowrap">'+kstate+'</span>';
-    const sk=document.createElement('button'); sk.textContent='设Key'; sk.style.cssText='padding:1px 8px;font-size:11px'; sk.onclick=()=>{ const k=prompt('API Key（'+c.name+'）：'); if(k===null) return; fetch('/api/models-config',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'setCustomKey',name:c.name,key:k})}).then(rr=>rr.json()).then(jj=>{ if(jj.ok) refreshModelsCfg(); else alert(jj.error||'设置失败'); }); };
-    const ed=document.createElement('button'); ed.textContent='修改'; ed.style.cssText='padding:1px 8px;font-size:11px'; ed.onclick=()=>{ const u=prompt('API 地址：', c.baseUrl); if(u===null) return; const l=prompt('标签：', c.label); if(l===null) return; fetch('/api/models-config',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'updateCustom',name:c.name,baseUrl:u,label:l})}).then(rr=>rr.json()).then(jj=>{ if(jj.ok){ refreshModelsCfg(); reloadModels(); } else alert(jj.error||'修改失败'); }); };
-    const rm=document.createElement('button'); rm.textContent='删除'; rm.className='danger'; rm.style.cssText='padding:1px 8px;font-size:11px'; rm.onclick=async()=>{ if(!confirm('删除自定义模型 '+c.name+'？')) return; const rr=await fetch('/api/models-config',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'removeCustom',name:c.name})}); const jj=await rr.json().catch(()=>({error:'失败'})); if(jj.ok){ refreshModelsCfg(); reloadModels(); } else alert(jj.error||'删除失败'); };
+    const sk=document.createElement('button'); sk.textContent='设Key'; sk.style.cssText='padding:1px 8px;font-size:11px'; sk.onclick=async()=>{ const k=await uiPrompt('API Key（'+c.name+'）：', null, {hidden:true}); if(k===null) return; fetch('/api/models-config',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'setCustomKey',name:c.name,key:k})}).then(rr=>rr.json()).then(jj=>{ if(jj.ok) refreshModelsCfg(); else uiAlert(jj.error||'设置失败'); }); };
+    const ed=document.createElement('button'); ed.textContent='修改'; ed.style.cssText='padding:1px 8px;font-size:11px'; ed.onclick=async()=>{ const u=await uiPrompt('API 地址：', c.baseUrl); if(u===null) return; const l=await uiPrompt('标签：', c.label); if(l===null) return; fetch('/api/models-config',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'updateCustom',name:c.name,baseUrl:u,label:l})}).then(rr=>rr.json()).then(jj=>{ if(jj.ok){ refreshModelsCfg(); reloadModels(); } else uiAlert(jj.error||'修改失败'); }); };
+    const rm=document.createElement('button'); rm.textContent='删除'; rm.className='danger'; rm.style.cssText='padding:1px 8px;font-size:11px'; rm.onclick=async()=>{ if(!await uiConfirm('删除自定义模型 '+c.name+'？')) return; const rr=await fetch('/api/models-config',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'removeCustom',name:c.name})}); const jj=await rr.json().catch(()=>({error:'失败'})); if(jj.ok){ refreshModelsCfg(); reloadModels(); } else uiAlert(jj.error||'删除失败'); };
     div.appendChild(sk); div.appendChild(ed); div.appendChild(rm); cl.appendChild(div);
   }
   $('#baseUrlOverride').value=j.baseUrlOverride||'';
@@ -912,15 +986,15 @@ async function refreshModelsCfg(){
 $('#cmAdd').onclick=async ()=>{
   const name=$('#cmName').value.trim();
   const url=$('#cmUrl').value.trim();
-  if(!name||!url){ alert('模型名与 API 地址必填'); return; }
+  if(!name||!url){ uiAlert('模型名与 API 地址必填'); return; }
   const r=await fetch('/api/models-config',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'addCustom',name,label:$('#cmLabel').value.trim(),baseUrl:url,key:$('#cmKey').value})});
   const j=await r.json().catch(()=>({error:'请求失败'}));
-  if(j.ok){ $('#cmName').value=''; $('#cmLabel').value=''; $('#cmUrl').value=''; $('#cmKey').value=''; refreshModelsCfg(); reloadModels(); } else alert(j.error||'添加失败');
+  if(j.ok){ $('#cmName').value=''; $('#cmLabel').value=''; $('#cmUrl').value=''; $('#cmKey').value=''; refreshModelsCfg(); reloadModels(); } else uiAlert(j.error||'添加失败');
 };
 $('#baseUrlSave').onclick=async ()=>{
   const r=await fetch('/api/models-config',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'setBaseUrl',baseUrl:$('#baseUrlOverride').value.trim()})});
   const j=await r.json().catch(()=>({error:'请求失败'}));
-  if(j.ok) alert('✓ API 地址已保存（立即生效）'); else alert(j.error||'保存失败');
+  if(j.ok) uiAlert('✓ API 地址已保存（立即生效）'); else uiAlert(j.error||'保存失败');
 };
 // —— 云同步 ——
 async function refreshSyncUI(){
@@ -939,15 +1013,15 @@ async function refreshSyncUI(){
 }
 $('#syncLogin').onclick=async ()=>{
   const url=$('#syncUrl').value.trim(); const username=$('#syncUser').value.trim(); const password=$('#syncPass').value;
-  if(!url||!username||!password){ alert('服务器地址、用户名、密码均必填'); return; }
+  if(!url||!username||!password){ uiAlert('服务器地址、用户名、密码均必填'); return; }
   const r=await fetch('/api/sync',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'login',url,username,password,deviceName:$('#syncDevice').value.trim()})});
   const j=await r.json().catch(()=>({error:'请求失败'}));
-  if(j.ok){ $('#syncPass').value=''; refreshSyncUI(); } else alert(j.error||'登录失败');
+  if(j.ok){ $('#syncPass').value=''; refreshSyncUI(); } else uiAlert(j.error||'登录失败');
 };
 $('#syncPush').onclick=async ()=>{
   const r=await fetch('/api/sync',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'push'})});
   const j=await r.json().catch(()=>({error:'请求失败'}));
-  alert(j.ok?('✓ 已推送 '+j.pushed+' 个会话'+(j.conflicts?'，'+j.conflicts+' 个远端版本已备份 .server-*':'')):j.error);
+  uiAlert(j.ok?('✓ 已推送 '+j.pushed+' 个会话'+(j.conflicts?'，'+j.conflicts+' 个远端版本已备份 .server-*':'')):j.error);
   refreshSyncUI(); refreshSyncConflicts();
 };
 $('#syncLogout').onclick=async ()=>{ await fetch('/api/sync',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'logout'})}); refreshSyncUI(); };
@@ -962,7 +1036,7 @@ async function refreshSyncShares(){
       const div=document.createElement('div'); div.style.cssText='display:flex;align-items:center;gap:6px;padding:4px 0;border-bottom:1px solid var(--border);font-size:12px';
       div.innerHTML='<span style="flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap"><b>'+esc(s.shareId)+'</b> <span style="color:var(--faint)">'+esc(s.name)+' · 被接受 '+s.pulls+' 次</span></span>';
       const b=document.createElement('button'); b.textContent='撤销'; b.className='danger'; b.style.cssText='padding:1px 8px;font-size:11px';
-      b.onclick=async()=>{ const rr=await fetch('/api/sync',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'unshare',shareId:s.shareId})}); const jj=await rr.json().catch(()=>({error:'失败'})); if(jj.ok) refreshSyncShares(); else alert(jj.error||'撤销失败'); };
+      b.onclick=async()=>{ const rr=await fetch('/api/sync',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'unshare',shareId:s.shareId})}); const jj=await rr.json().catch(()=>({error:'失败'})); if(jj.ok) refreshSyncShares(); else uiAlert(jj.error||'撤销失败'); };
       div.appendChild(b); ml.appendChild(div);
     }
   } else { ml.innerHTML='<div style="color:var(--faint);font-size:12px;padding:4px 2px">暂无分享（分享后此处显示分享码）</div>'; }
@@ -976,23 +1050,23 @@ async function refreshSyncShares(){
   } else { al.innerHTML='<div style="color:var(--faint);font-size:12px;padding:4px 2px">未接受任何分享</div>'; }
 }
 $('#shareCreate').onclick=async ()=>{
-  const name=$('#shareName').value.trim(); if(!name){ alert('输入会话文件名'); return; }
+  const name=$('#shareName').value.trim(); if(!name){ uiAlert('输入会话文件名'); return; }
   const r=await fetch('/api/sync',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'share',name})});
   const j=await r.json().catch(()=>({error:'请求失败'}));
-  if(j.ok){ $('#shareName').value=''; refreshSyncShares(); } else alert(j.error||'创建失败');
+  if(j.ok){ $('#shareName').value=''; refreshSyncShares(); } else uiAlert(j.error||'创建失败');
 };
 $('#shareAccept').onclick=async ()=>{
-  const code=$('#acceptCode').value.trim(); if(!code){ alert('输入分享码'); return; }
+  const code=$('#acceptCode').value.trim(); if(!code){ uiAlert('输入分享码'); return; }
   const r=await fetch('/api/sync',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'accept',shareId:code})});
   const j=await r.json().catch(()=>({error:'请求失败'}));
-  if(j.ok){ $('#acceptCode').value=''; refreshSyncShares(); refreshSessions(); } else alert(j.error||'接受失败');
+  if(j.ok){ $('#acceptCode').value=''; refreshSyncShares(); refreshSessions(); } else uiAlert(j.error||'接受失败');
 };
 $('#passwdBtn').onclick=async ()=>{
   const oldPass=$('#oldPass').value, newPass=$('#newPass').value;
-  if(!oldPass||!newPass){ alert('旧密码与新密码均必填'); return; }
+  if(!oldPass||!newPass){ uiAlert('旧密码与新密码均必填'); return; }
   const r=await fetch('/api/sync',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'passwd',oldPassword:oldPass,newPassword:newPass})});
   const j=await r.json().catch(()=>({error:'请求失败'}));
-  if(j.ok){ $('#oldPass').value=''; $('#newPass').value=''; alert('✓ 密码已修改'); } else alert(j.error||'修改失败');
+  if(j.ok){ $('#oldPass').value=''; $('#newPass').value=''; uiAlert('✓ 密码已修改'); } else uiAlert(j.error||'修改失败');
 };
 async function refreshSyncConflicts(){
   const r=await fetch('/api/sync-conflicts',{cache:'no-store'}).catch(()=>null); if(!r) return;
@@ -1001,7 +1075,7 @@ async function refreshSyncConflicts(){
   for(const c of j.conflicts){
     const div=document.createElement('div'); div.style.cssText='display:flex;align-items:center;gap:6px;padding:5px 0;border-bottom:1px solid var(--border);font-size:12px';
     div.innerHTML='<span style="flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap">'+esc(c.base)+' <span style="color:var(--faint)">'+(c.localExists?'本地有':'本地无')+' · 备份 '+c.entries.length+'</span></span>';
-    const mk=(label,choice,cls)=>{ const b=document.createElement('button'); b.textContent=label; if(cls) b.className=cls; b.style.cssText='padding:1px 8px;font-size:11px'; b.onclick=async()=>{ const rr=await fetch('/api/sync',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'resolveConflict',base:c.base,choice})}); const jj=await rr.json().catch(()=>({error:'失败'})); if(jj.ok) refreshSyncConflicts(); else alert(jj.error||'解决失败'); }; return b; };
+    const mk=(label,choice,cls)=>{ const b=document.createElement('button'); b.textContent=label; if(cls) b.className=cls; b.style.cssText='padding:1px 8px;font-size:11px'; b.onclick=async()=>{ const rr=await fetch('/api/sync',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({action:'resolveConflict',base:c.base,choice})}); const jj=await rr.json().catch(()=>({error:'失败'})); if(jj.ok) refreshSyncConflicts(); else uiAlert(jj.error||'解决失败'); }; return b; };
     div.appendChild(mk('保留本地','local')); div.appendChild(mk('采用远端','remote','danger')); div.appendChild(mk('都保留','both'));
     list.appendChild(div);
   }
@@ -1045,8 +1119,8 @@ async function openSessModal(){
   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=prompt('新标题：', 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 alert(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(!confirm('删除会话 '+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; refreshSessions(); openSessModal(); } else alert(jj.error||'删除失败'); };
+    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; refreshSessions(); openSessModal(); } else uiAlert(jj.error||'删除失败'); };
     div.appendChild(rn); div.appendChild(dl); list.appendChild(div);
   }
 }

package/src/web/server.js

@@ -156,9 +156,9 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
   let modelName = cfg.model || 'deepseek-v4-flash';
   const pc = resolveProviderConfig(cfg, modelName);
   if (!pc.apiKey) {
-    console.error(`[MingDao] 未找到 API Key：请运行 mingdao key set ${pc.name} 或 mingdao init`);
-    process.exitCode = 1;
-    return;
+    // 首次运行/未配置密钥：界面照常启动（黑屏根因修复——此前这里直接 return，桌面版窗口
+    // 加载不到任何服务 → 整窗黑屏且无提示）。⚙ 设置里填入 Key 后即可对话。
+    console.error(`[MingDao] ⚠ 未配置 ${modelName} 的 API Key：界面可正常使用，对话前请在 ⚙ 设置 →「模型与 API Key」填入密钥。`);
   }
 
   let workingDir = process.cwd(); // 工作空间切换时随之更新（后续会话/工具都跟随新目录）
@@ -198,6 +198,22 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
   let taskSeq = 0;
   let draftText = ''; // 外部注入的草稿（VS Code 插件选中代码发送）
 
+  // —— 服务端诊断日志（第二问无反应排查 + 长期运维）：<mingdao-home>/logs/web-server.log ——
+  // 记录每次对话的关键阶段与耗时；2MB 滚动。桌面版与 WebUI 共用同一日志。
+  function srvlog(msg) {
+    try {
+      const dir = path.join(mingdaoHome(), 'logs');
+      fs.mkdirSync(dir, { recursive: true });
+      const f = path.join(dir, 'web-server.log');
+      let prev = '';
+      try {
+        prev = fs.readFileSync(f, 'utf8');
+      } catch {}
+      if (prev.length > 2 * 1024 * 1024) prev = prev.slice(-1024 * 1024);
+      fs.writeFileSync(f, prev + new Date().toISOString() + ' ' + msg + '\n');
+    } catch {}
+  }
+
   function pruneTasks() {
     if (tasks.size <= 100) return;
     for (const [id, t] of tasks) {
@@ -209,6 +225,12 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
   async function handleChat(res, body) {
     const taskId = `t${++taskSeq}`; // 服务端生成：客户端自选 taskId 可能覆盖他人任务
     const entry = { res, send: null, abortHandler: null, pendingAsk: null, session: null, startedAt: Date.now(), status: 'running', message: '', durationMs: 0 };
+    srvlog('chat 开始 ' + taskId + ' session=' + (body.file || '新会话') + ' 消息长度=' + String(body.message || '').length);
+    // 硬截止：任何异常路径 6 分钟内强制结束 SSE 流——前端回合必然收尾，按钮必然恢复
+    const hardDeadline = setTimeout(() => {
+      srvlog('chat 硬截止触发 ' + taskId + '（异常路径强制 res.end）');
+      try { res.end(); } catch {}
+    }, 6 * 60000);
     tasks.set(taskId, entry);
     const send = (obj) => {
       try {
@@ -298,6 +320,10 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
     const permission = createPermission(cfg.permission ?? 'ask', io);
     let providerNow;
     try {
+      // 首次使用引导：未配置密钥时给明确指引，而不是晦涩的 401 原始报错
+      if (!(resolveProviderConfig(cfg, runModel) || {}).apiKey) {
+        throw new Error(`模型 ${runModel} 尚未配置 API Key：请点击右上角 ⚙ 设置 →「模型与 API Key」填入密钥。`);
+      }
       providerNow = await getProviderFor(runModel); // 审计 P1-1：失败时清理任务占位，避免僵尸 running 耗尽并发
     } catch (err) {
       entry.status = 'failed';
@@ -343,15 +369,18 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
 
     try {
       const r = await agent.runTurn(messages);
+      srvlog('chat 回合完成 ' + taskId + ' text=' + String(r.text || '').length + ' ' + (Date.now() - entry.startedAt) + 'ms');
       appendMessages(session.file, messages.slice(persistedBefore));
       io.printUsageLine({ modelName: runModel, usage: r.usage, durationMs: r.durationMs });
       recordUsage(runModel, r.usage, r.perf);
       maybeAutoSync().catch(() => {});
       // 新会话自动标题（可配置关闭）
+      srvlog('chat 标题生成前 ' + taskId);
       if (isNew && cfg.autoTitle !== false && r.text) {
         try {
           const tModel = titleModel(cfg, runModel);
           const title = await generateTitle(await helperProvider(cfg, tModel, providerNow), tModel, built.persistText);
+          srvlog('chat 标题完成 ' + taskId + ' ' + (title || '（无标题）'));
           if (title) {
             const oldName = path.basename(session.file);
             const renamed = renameSessionFile(fs, path, home, session, title);
@@ -361,6 +390,7 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
       }
       entry.status = r.aborted ? 'aborted' : 'done';
       entry.durationMs = Date.now() - entry.startedAt;
+      srvlog('chat 发送 done ' + taskId + ' status=' + entry.status + ' 总耗时=' + entry.durationMs + 'ms');
       // 预算可视化（评估 A5）：会话当前 token 占用 / 预算
       let budgetInfo = null;
       try {
@@ -386,8 +416,11 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
     } catch (err) {
       entry.status = 'failed';
       entry.durationMs = Date.now() - entry.startedAt;
+      srvlog('chat 错误 ' + taskId + ' ' + String(err?.message || err));
       send({ type: 'error', message: String(err?.message || err) });
     } finally {
+      clearTimeout(hardDeadline);
+      srvlog('chat 收尾 ' + taskId + ' res.end 前（客户端将收到流结束）');
       entry.abortHandler = null;
       entry.pendingAsk = null;
       entry.send = null;
@@ -463,6 +496,8 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
         ok: true,
         model: modelName,
         models,
+        // 首次使用引导：当前模型无可用 API Key 时前端显示「去 ⚙ 设置填 Key」横幅
+        keyReady: Boolean((resolveProviderConfig(cfg, modelName) || {}).apiKey),
         permissions: ['ask', 'auto', 'readonly'],
         permission: cfg.permission ?? 'ask',
         sandbox: cfg.sandbox || 'off',
@@ -782,7 +817,19 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
         res.end();
         return;
       }
-      await handleChat(res, body);
+      try {
+        await handleChat(res, body);
+      } catch (err) {
+        // 兜底（审计：「点发送无反应」根因防护）：handleChat 内任意未捕获异常若直接外抛，
+        // SSE 已开流却无事件 → 前端永远停在「正在思考…」。此处统一转为 error 事件回给界面。
+        try {
+          res.write(`data: ${JSON.stringify({ type: 'error', message: '对话失败：' + String(err?.message || err) })}\n\n`);
+        } catch {}
+        try {
+          res.end();
+        } catch {}
+        pruneTasks();
+      }
       return;
     }
     if (req.method === 'POST' && p === '/api/permission') {