mingdao-harness 0.4.3 → 0.4.4

package/package.json

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

package/presets/local-audit.json

@@ -2,8 +2,8 @@
   "name": "local-audit",
   "label": "本地模型审计",
   "description": "面向本地/资源受限模型（如 131k 窗口 q8 量化）的只读审计预设：只读工具集 + 只读权限 + 保守参数，配合 v0.3.2 本地自适应长任务不中断",
-  "systemPrompt": "你是一名代码审计员。任务是对给定代码库做只读审计：先 ls/glob 摸清结构，再 read/grep 逐文件审查，可用 git 查看历史与 diff、fetch 抓取相关文档。输出审计报告：发现的缺陷按严重度分级，每条给出文件:行号证据；不做任何修改。若上下文紧张，先审查最关键的部分并明示未覆盖区域。",
-  "tools": ["read", "ls", "glob", "grep", "skill", "git", "fetch", "todo"],
+  "systemPrompt": "你是一名代码审计员。任务是对给定代码库做只读审计：先 ls/glob 摸清结构，再 read/grep 逐文件审查，可用 git 查看历史与 diff、fetch 抓取相关文档。对于大仓库可分模块派发只读子代理并行审查（task 工具传 readOnly:true，子代理同样只读：read/ls/glob/grep/skill）。输出审计报告：发现的缺陷按严重度分级，每条给出文件:行号证据；不做任何修改。若上下文紧张，先审查最关键的部分并明示未覆盖区域。",
+  "tools": ["read", "ls", "glob", "grep", "skill", "git", "fetch", "todo", "task"],
   "permission": "readonly",
   "maxRounds": 4,
   "maxOutputTokens": 4096

package/src/agent.js

@@ -26,9 +26,10 @@ const SUBAGENT_MAX_STEPS = 24;
 /**
  * 创建 Agent 循环（调用方只需传 provider/permission/io/modelName/workingDir，其余可选）
  * @param {{ provider: any, permission: any, io: any, modelName: any, workingDir: any,
- *   cfg?: any, undoStore?: any, maxSteps?: number, mcp?: any, onCompact?: any, sessionRef?: any }} params
+ *   cfg?: any, undoStore?: any, maxSteps?: number, mcp?: any, onCompact?: any, sessionRef?: any,
+ *   onUsage?: (usage: any) => void }} params
  */
-export function createAgent({ provider, permission, io, modelName, workingDir, cfg = {}, undoStore, maxSteps, mcp, onCompact, sessionRef }) {
+export function createAgent({ provider, permission, io, modelName, workingDir, cfg = {}, undoStore, maxSteps, mcp, onCompact, sessionRef, onUsage }) {
   const preset = modelPreset(modelName) || {};
   // v0.3.2 模型自适应：预算按模型上下文窗口推导（留输出余量 + 75% 舒适区），
   // 自定义/本地小模型不再套 128000 默认撑爆窗口；prompt 永不逼近窗口边缘（prefill 不爆炸）。
@@ -61,7 +62,9 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
   const usedToolNames = new Set();
   // 省钱 B1（按需挂载）：回合起始为「只读阶段」时只发只读工具（read/ls/glob/grep/skill/todo）
   // + 已用过的工具；检测到写意图（用户消息或模型明说需要写/改/建）后注入全量工具。
-  const READONLY_TIER_SET = new Set(['read', 'ls', 'glob', 'grep', 'skill', 'todo', 'git', 'fetch']);
+  // v0.4.4：加 task——审计/调研等只读长任务此前因 task 不在只读档而看不到「派只读子代理」能力
+  // （readOnly 子代理只读，权限引擎仍门控写操作，无越权）。
+  const READONLY_TIER_SET = new Set(['read', 'ls', 'glob', 'grep', 'skill', 'todo', 'git', 'fetch', 'task']);
   // 中英双语写意图（CodeArts 报告：纯中文正则让英文会话整回合只读死锁）
   const WRITE_INTENT_RE = /写|建|创|改|修|删|装|加|添|增|补|换|移|部署|执行|运行|实现|重构|生成|迁移|安装|更新|升级|发布|调整|优化|修复|提交|推送|打包|编译|测试|implement|fix|create|modify|update|delete|deploy|build|make|generate|install|write|refactor|migrate|test|run|commit|push|remove|add|change|patch/i;
   const hasWriteIntent = (/** @type {any} */ text) => WRITE_INTENT_RE.test(String(text || ''));
@@ -220,6 +223,9 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
     const turnToolCache = new Map();
     for (round = 0; round < maxRounds; round++) {
       steps = 0;
+      // v0.4.4：每轮结束回调本轮增量 usage（长任务费用逐轮入账——此前只在 runTurn 全结束后才
+      // recordUsage，长任务期间「今日费用」恒为 0 被误读为「无统计」；中断时已完成轮次费用也保留）。
+      const roundUsageStart = { prompt_tokens: usage.prompt_tokens, completion_tokens: usage.completion_tokens, prompt_cache_hit_tokens: usage.prompt_cache_hit_tokens || 0, prompt_cache_miss_tokens: usage.prompt_cache_miss_tokens || 0 };
       while (steps < stepLimit) {
       steps += 1;
       // 自动压缩（P3-1）：预算不足、静默裁剪即将丢弃早期段落时，先用 executor 模型
@@ -734,6 +740,15 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
     }
     // v0.3.1 自动续跑（长程执行）：还有剩余轮次且未中断 → 注入进度摘要直接续跑，不落收尾总结
     if (round < maxRounds - 1 && !aborted) {
+      // 每轮结束：回调本轮增量 usage（含缓存命中拆分），供调用方逐轮入账
+      try {
+        onUsage?.({
+          prompt_tokens: usage.prompt_tokens - roundUsageStart.prompt_tokens,
+          completion_tokens: usage.completion_tokens - roundUsageStart.completion_tokens,
+          prompt_cache_hit_tokens: (usage.prompt_cache_hit_tokens || 0) - roundUsageStart.prompt_cache_hit_tokens,
+          prompt_cache_miss_tokens: (usage.prompt_cache_miss_tokens || 0) - roundUsageStart.prompt_cache_miss_tokens,
+        });
+      } catch {}
       const art = deliverables.length ? '已交付文件：' + deliverables.join('、') + '。' : '';
       messages.push({
         role: 'user',

package/src/cli.js

@@ -427,7 +427,7 @@ async function main() {
   if (cfg.mcpServers && Object.keys(cfg.mcpServers).length) {
     // A2：预热——await 连接（6s 超时）；超时本会话冻结工具集（不再中途注入，保护前缀缓存）。
     // 超时后输家 promise 仍在跑：迟到就绪的 manager 立即 stop，防 detached 子进程成孤儿（自查 #2）
-    const mcpStartP = startMcpServers(cfg.mcpServers, workingDir).catch(() => null);
+    const mcpStartP = startMcpServers(cfg.mcpServers, workingDir, cfg).catch(() => null);
     mcpManager = await Promise.race([
       mcpStartP,
       new Promise((/** @type {any} */ r) => setTimeout(() => r(null), 6000)),

package/src/hooks.js

@@ -48,6 +48,7 @@ export function createHooks(hooksCfg = {}, /** @type {any} */ workingDir, /** @t
         cwd: workingDir,
         env: childEnv,
         stdio: ['pipe', 'pipe', 'pipe'],
+        detached: true, // 评估 6.5：自成进程组，超时 process.kill(-pid) 整组清理（否则只杀 shell，孙进程孤儿）
       });
       let out = '';
       let err = '';

package/src/mcp.js

@@ -8,6 +8,17 @@
 
 import fs from 'node:fs';
 import { spawn } from 'node:child_process';
+import { isSensitiveEnv } from './tools/bash.js';
+
+// 评估 6.2（v0.4.3）：MCP 子进程不再继承完整 process.env（含 API Key）——与 bash/hooks 同口径
+// 默认过滤敏感变量；config.mcpEnvKeep 按名放行、config.mcpEnvFilter=false 整体关闭。
+function filteredProcessEnv(/** @type {Set<string>} */ keepSet) {
+  const out = /** @type {any} */ ({});
+  for (const [k, v] of Object.entries(process.env)) {
+    if (!isSensitiveEnv(k) || keepSet.has(k)) out[k] = v;
+  }
+  return out;
+}
 
 // 客户端版本读 package.json（评估 P3-9：此前硬编码 '0.6.0' 与真实版本脱节）
 const CLIENT_VERSION = (() => {
@@ -25,11 +36,12 @@ const HANDSHAKE_TIMEOUT_MS = 20000;
 let nextId = 1;
 
 export class McpClient {
-  constructor(/** @type {any} */ name, /** @type {any} */ { command, args = [], env = {}, trusted = false }, /** @type {any} */ workingDir) {
+  constructor(/** @type {any} */ name, /** @type {any} */ { command, args = [], env = {}, trusted = false }, /** @type {any} */ workingDir, /** @type {any} */ baseEnv = process.env) {
     this.name = name;
     this.command = command;
     this.args = args;
     this.env = env;
+    this.baseEnv = baseEnv; // 过滤敏感变量后的基础环境（startMcpServers 注入）
     this.trusted = trusted === true; // v0.4.1 P0：仅 trusted 服务器的 readOnlyHint 才被信任自动放行
     this.workingDir = workingDir;
     this.tools = /** @type {any[]} */ ([]);
@@ -45,7 +57,7 @@ export class McpClient {
     if (this.child) return this;
     this.child = spawn(this.command, this.args, {
       cwd: this.workingDir,
-      env: { ...process.env, ...this.env },
+      env: { ...this.baseEnv, ...this.env }, // 敏感变量已过滤（this.baseEnv），this.env 为用户显式覆盖
       stdio: ['pipe', 'pipe', 'pipe'],
       detached: true, // 自成进程组：stop 时整组清理（npx 孙进程不成孤儿）
     });
@@ -215,13 +227,16 @@ export class McpClient {
 }
 
 // 多服务器管理器：部分服务器启动失败不影响其余
-export async function startMcpServers(/** @type {any} */ mcpCfg, /** @type {any} */ workingDir) {
+// topCfg 为顶层 config.json（提供 mcpEnvKeep/mcpEnvFilter 环境过滤口径，与 bash/hooks 一致）
+export async function startMcpServers(/** @type {any} */ mcpCfg, /** @type {any} */ workingDir, /** @type {any} */ topCfg = {}) {
+  const keep = new Set((topCfg?.mcpEnvKeep || []).map(String));
+  const baseEnv = topCfg?.mcpEnvFilter === false ? process.env : filteredProcessEnv(keep);
   const clients = new Map();
   const entries = Object.entries(mcpCfg || {});
   await Promise.all(
     entries.map(async ([name, cfg]) => {
       if (!cfg || typeof cfg.command !== 'string' || !cfg.command.trim()) return;
-      const client = new McpClient(name, cfg, workingDir);
+      const client = new McpClient(name, cfg, workingDir, baseEnv);
       clients.set(name, client);
       try {
         await client.start();

package/src/schedule.js

@@ -199,19 +199,22 @@ export function pauseSchedule(/** @type {any} */ home, /** @type {any} */ id) {
 }
 
 export function resumeSchedule(/** @type {any} */ home, /** @type {any} */ id) {
-  const job = readSchedule(home, id);
-  if (!job || job.status !== 'paused') return false;
-  let next = job.nextRunAt;
-  if (job.kind === 'every') {
-    next = job.anchor ? nextAnchorAfter(job.anchor, job.interval) || Date.now() + job.interval : Date.now() + job.interval;
-  } else if (job.kind === 'once') {
-    if (next && next <= Date.now()) next = Date.now() + 30000; // 已过期的一次性任务恢复后 30s 执行
-  } else next = Date.now();
-  const nextJob = { ...job, status: 'pending', nextRunAt: next };
-  writeSchedule(home, nextJob);
-  // 审计修复：守护进程在时只更新状态交给 daemon 接管；否则旧式 sleeper 兜底（避免双跑）
-  if (process.env.MINGDAO_NO_DAEMON === '1' || !daemonAlive(home)) spawnSleeper(home, nextJob);
-  return true;
+  // 评估 6.3（v0.4.3）：读-改-写序列加锁，与 remove/pause 及 sleeper 状态写互斥（防丢更新）
+  return withFileLockSync(path.join(scheduleDir(home), '.lock'), () => {
+    const job = readSchedule(home, id);
+    if (!job || job.status !== 'paused') return false;
+    let next = job.nextRunAt;
+    if (job.kind === 'every') {
+      next = job.anchor ? nextAnchorAfter(job.anchor, job.interval) || Date.now() + job.interval : Date.now() + job.interval;
+    } else if (job.kind === 'once') {
+      if (next && next <= Date.now()) next = Date.now() + 30000; // 已过期的一次性任务恢复后 30s 执行
+    } else next = Date.now();
+    const nextJob = { ...job, status: 'pending', nextRunAt: next };
+    writeSchedule(home, nextJob);
+    // 审计修复：守护进程在时只更新状态交给 daemon 接管；否则旧式 sleeper 兜底（避免双跑）
+    if (process.env.MINGDAO_NO_DAEMON === '1' || !daemonAlive(home)) spawnSleeper(home, nextJob);
+    return true;
+  });
 }
 
 // 每日锚点：锚点时刻（HH:MM）对齐到 now 之后的最近一次
@@ -455,8 +458,11 @@ export async function runSleeper(/** @type {any} */ home, /** @type {any} */ id)
       }
       writeSchedule(home, { ...cur, status: 'running' });
       const result = await runOnce();
-      const cur2 = readSchedule(home, id);
-      if (cur2) writeSchedule(home, { ...cur2, status: result });
+      // 评估 6.4（v0.4.3）：once 最终状态读-改-写加锁（与 pause/remove 互斥，防 pause 被 done 覆盖）
+      withFileLockSync(path.join(scheduleDir(home), '.lock'), () => {
+        const cur2 = readSchedule(home, id);
+        if (cur2) writeSchedule(home, { ...cur2, status: result });
+      });
       return;
     } else {
       // after：轮询依赖，满足即执行一次后结束；任一依赖失败则跳过
@@ -471,8 +477,11 @@ export async function runSleeper(/** @type {any} */ home, /** @type {any} */ id)
       }
       writeSchedule(home, { ...cur, status: 'running' });
       const result = await runOnce();
-      const cur2 = readSchedule(home, id);
-      if (cur2) writeSchedule(home, { ...cur2, status: result });
+      // 评估 6.4（v0.4.3）：after 最终状态读-改-写加锁（同上）
+      withFileLockSync(path.join(scheduleDir(home), '.lock'), () => {
+        const cur2 = readSchedule(home, id);
+        if (cur2) writeSchedule(home, { ...cur2, status: result });
+      });
       return;
     }
   }

package/src/tasks/worker.js

@@ -68,7 +68,7 @@ export async function runWorkerTask(id, question, { permission, model, offpeak }
           if (mcpManager) mcpManager.stop();
         },
       };
-      startMcpServers(cfg.mcpServers, workingDir).then((m) => (mcpManager = m)).catch(() => {});
+      startMcpServers(cfg.mcpServers, workingDir, cfg).then((m) => (mcpManager = m)).catch(() => {});
     }
     const sessionRef = /** @type {{name: any}} */ ({ name: null });
     let persistedCount = 0;

package/src/web/app.js

@@ -399,10 +399,14 @@ async function send(){
       else if(ev.type==='done'){ console.log('[MingDao] done 事件：session=' + ev.session); onActivity(); if(ev.budget){ const b=ev.budget; if(hintTextEl) hintTextEl.textContent='预算 '+Math.round(b.used/1000)+'K/'+Math.round(b.total/1000)+'K（'+Math.round(b.used/b.total*100)+'%）· 本轮完成 · 提示栏右侧为今日费用与命中率'; } refreshStatusBar(); if(ev.stats&&ev.stats.deliverables&&ev.stats.deliverables.length){ const card=document.createElement('div'); card.className='deliver'; card.innerHTML='<div class="t">📦 交付物（'+ev.stats.deliverables.length+' 个文件）</div>'+ev.stats.deliverables.map(f=>'<div class="i">'+esc(f)+(f.toLowerCase().endsWith('.html')?' <span style="color:var(--accent2)">— 浏览器打开即可运行</span>':'')+'</div>').join(''); msg.appendChild(card); } if(ev.note){ const d=document.createElement('div'); d.className='errline'; d.style.color='var(--warn)'; d.textContent=ev.note; msg.appendChild(d); } currentSession=ev.session; update(); refreshSessions(); updateTasksPanel(); }
     });
   }catch(e){ onActivity(); // 诊断（v0.4.2 network error 排查）：静默中断此前无任何日志，无法区分
-    // 「手点停止 / 看门狗 / fetch 流静默断裂」。补记完整错误形态 + 回合状态，下次失败可定位。
-    console.error('[MingDao] chat 流异常', { name: e && e.name, message: e && e.message, err: String(e), taskId, rawLen: raw.length, steps: stepsCount, elapsedS: Math.round((Date.now() - workT0) / 1000) });
+    // 「手点停止 / 看门狗 / fetch 流静默断裂」。v0.4.3 修：第二参改 JSON 字符串——Electron 日志
+    // 对对象只会落 [object Object]，异常细节丢失。
+    const diag = { name: e && e.name, message: e && e.message, err: String(e), taskId, rawLen: raw.length, steps: stepsCount, elapsedS: Math.round((Date.now() - workT0) / 1000) };
+    console.error('[MingDao] chat 流异常 ' + JSON.stringify(diag));
     const d=document.createElement('div'); d.className='errline';
-    d.textContent=(e&&e.name==='AbortError')?(killedByWatchdog?'响应超时已中断（120 秒无任何响应），请重试':'已中断'):((e&&e.message)||('连接中断，本轮未完成。已执行的工作已保存检查点——直接发送「继续」即可从断点续跑（' + Math.round((Date.now() - workT0) / 1000) + 's · ' + stepsCount + ' 步）。'));
+    // 统一 catch 文案（v0.4.3）：非用户中断/看门狗时，无论有无 e.message 都优先给「可续跑」的友好提示，
+    // 具体错误形态已进日志（fetch failed 等不再绕开续跑提示）。
+    d.textContent=(e&&e.name==='AbortError')?(killedByWatchdog?'响应超时已中断（120 秒无任何响应），请重试':'已中断'):('连接中断，本轮未完成。已执行的工作已保存检查点——直接发送「继续」即可从断点续跑（' + Math.round((Date.now() - workT0) / 1000) + 's · ' + stepsCount + ' 步）。');
     msg.appendChild(d); scroll(); }
   finally{ clearInterval(hintTimer); disarm(); generating=false; setBtn(); curTaskId=null; curPhase='模型推理中'; console.log('[MingDao] 回合收尾：generating=false，按钮恢复发送'); hintEl.classList.remove('working'); if(hintTextEl) hintTextEl.textContent=defaultHint; pending=false; content.innerHTML=renderMarkdown(raw); attachTrajMeta(msg); activeAiMsg=null; curWorkT0=0; renderWorkStatus(); scroll(); updateTasksPanel(); }
 }
@@ -583,10 +587,17 @@ setInterval(updateTasksPanel, 2000);
 async function refreshCostBadge(){
   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;
-  const bd=j.breakdown||{}; const gd=j.guard||null;
-  let t='📊 今日 ≈¥'+(bd.today||0).toFixed(4);
-  if(bd.rate!=null) t+=' · 命中 '+(bd.rate*100).toFixed(0)+'%';
-  if(gd&&gd.limit>0&&gd.cost!=null) t+=' · 护栏 '+(gd.cost/gd.limit*100).toFixed(0)+'%';
+  const bd=j.breakdown||{}; const gd=j.guard||null; const sm=j.summary||{};
+  // v0.4.3：本地/自定义模型无定价时费用恒 0——此前显示「¥0.0000」被误读为「无统计」。
+  // 有用量但累计费用为 0 即判定为无计价模型，明确标注而非含糊 ¥0。
+  let t;
+  if ((sm.turns||0) > 0 && (bd.totalCost||0) === 0) {
+    t='📊 本地模型不计费 · 累计 ↑'+(sm.prompt||0)+' ↓'+(sm.completion||0)+' tokens';
+  } else {
+    t='📊 今日 ≈¥'+(bd.today||0).toFixed(4);
+    if(bd.rate!=null) t+=' · 命中 '+(bd.rate*100).toFixed(0)+'%';
+    if(gd&&gd.limit>0&&gd.cost!=null) t+=' · 护栏 '+(gd.cost/gd.limit*100).toFixed(0)+'%';
+  }
   $('#costBadge').textContent=t;
   if($('#dashPanel').style.display==='flex') renderDashboard(j);
 }

package/src/web/attachments.js

@@ -30,7 +30,8 @@ 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_BYTES) {
+      // 评估 6.7（v0.4.3）：上限按字节数而非字符数（中文每字 3 字节，字符数口径会放大到声明值 3 倍）
+      if (Buffer.byteLength(content, 'utf8') > MAX_TEXT_BYTES) {
         return { error: `文本文件过大：${a.name || '未命名'}（≤200KB）` };
       }
       finalText += `${finalText ? '\n\n' : ''}[文件 ${a.name || '未命名'}]\n${content}`;

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

@@ -85,6 +85,9 @@ export async function handle({ req, res, method, p, url }, deps, shared) {
   if (method === 'GET' && p === '/api/fs-browse') {
     let dir = String(url.searchParams.get('dir') || '').trim();
     if (!path.isAbsolute(dir)) return json(res, 400, { error: '需要绝对路径' });
+    // 评估 6.1（v0.4.3）：先 path.resolve 消解 .. 段，再做前缀比较与 stat/readdir——此前字符串
+    // 前缀比较用未规范化的 dir，`/home/u/../../etc` 能通过 startsWith('/home/u/') 但 stat 解析到 /etc。
+    dir = path.resolve(dir);
     // 质检 A3：目录浏览限定基目录，拒绝越界。Windows（CodeArts 报告）：家目录覆盖整个用户配置树
     // （AppData 等）——收紧为 桌面/文档/下载 三常用目录 + 启动目录 + 工作目录 + web.browseRoots 显式授权；
     // 路径比较在 win32 下大小写归一（D:\\ vs d:\\ 不再误拒）。

package/src/web/server.js

@@ -119,8 +119,8 @@ function readBody(req, limit = 40 * 1024 * 1024) {
   });
 }
 
-/** @param {{ host?: string, port?: number, authToken?: string|null, [key: string]: any }} [opts] */
-export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken } = {}) {
+/** @param {{ host?: string, port?: number, authToken?: string|null, onBusy?: (busy: boolean) => void, [key: string]: any }} [opts] */
+export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken, onBusy } = {}) {
   const home = ensureHome();
   const cfg = loadConfig();
   if (!cfg) {
@@ -206,7 +206,7 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
   let mcpManager = null;
   if (cfg.mcpServers && Object.keys(cfg.mcpServers).length) {
     // 超时后输家 promise 仍在跑：迟到就绪的 manager 立即 stop，防 detached 子进程成孤儿（自查 #2）
-    const mcpStartP = startMcpServers(cfg.mcpServers, workingDir).catch(() => null);
+    const mcpStartP = startMcpServers(cfg.mcpServers, workingDir, cfg).catch(() => null);
     mcpManager = await Promise.race([
       mcpStartP,
       new Promise((/** @type {any} */ r) => setTimeout(() => r(null), 6000)),
@@ -230,6 +230,18 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
   let inflight = 0; // 质检 S2：在途聊天请求计数（与请求生命周期绑定，防 readBody 期间并发超限）
   const tasks = new Map(); // taskId -> { res, send, abortHandler, pendingAsk, session, startedAt, status, message, durationMs }
   let taskSeq = 0;
+  // 忙状态通知（v0.4.3 network error 修复）：有 running 任务即「忙」——桌面版据此在生成期
+  // 防睡眠/防熄屏（macOS 熄屏会中断 Chromium 网络栈导致 SSE 断连）。onBusy 由调用方注入。
+  let lastBusy = false;
+  function notifyBusy() {
+    const busy = [...tasks.values()].some((/** @type {any} */ t) => t.status === 'running');
+    if (busy !== lastBusy) {
+      lastBusy = busy;
+      try {
+        onBusy?.(busy);
+      } catch {}
+    }
+  }
   // 会话文件互斥（质检 C1/M3）：同一 session 文件的 append 与 compact 整文件重写必须串行
   const sessionLocks = new Map();
   /** @param {any} file @param {any} fn */
@@ -321,6 +333,7 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
     const entry = /** @type {any} */ ({ 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);
     tasks.set(taskId, entry);
+    notifyBusy(); // 进入 running → 忙
     /** @param {any} obj */
     const send = (obj) => {
       try {
@@ -350,6 +363,7 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
     const built = buildUserContent(userMessage, body.attachments, visionSupported);
     if (built.error) {
       entry.status = 'failed';
+      notifyBusy();
       send({ type: 'error', message: built.error });
       clearInterval(progressTimer);
       res.end();
@@ -490,6 +504,7 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
       providerNow = await getProviderFor(runModel); // 审计 P1-1：失败时清理任务占位，避免僵尸 running 耗尽并发
     } catch (/** @type {any} */ err) {
       entry.status = 'failed';
+      notifyBusy();
       entry.durationMs = Date.now() - entry.startedAt;
       send({ type: 'error', message: `模型 ${runModel} 不可用：${String(err?.message || err)}` });
       clearInterval(progressTimer);
@@ -497,6 +512,17 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
       pruneTasks();
       return;
     }
+    // v0.4.4：长任务费用逐轮入账——记录已按轮入账的累计 usage，最终补记最后一轮 + 兜底总结的剩余。
+    const recorded = { prompt_tokens: 0, completion_tokens: 0, prompt_cache_hit_tokens: 0, prompt_cache_miss_tokens: 0 };
+    const onUsage = (/** @type {any} */ delta) => {
+      recorded.prompt_tokens += delta?.prompt_tokens || 0;
+      recorded.completion_tokens += delta?.completion_tokens || 0;
+      recorded.prompt_cache_hit_tokens += delta?.prompt_cache_hit_tokens || 0;
+      recorded.prompt_cache_miss_tokens += delta?.prompt_cache_miss_tokens || 0;
+      try {
+        recordUsage(runModel, delta, null);
+      } catch {}
+    };
     const agent = createAgent({
       provider: providerNow,
       permission,
@@ -511,6 +537,8 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
         withSessionLock(session.file, () => rewriteSession(session.file, msgs)).catch(() => {}); // onCompact 为同步回调：入队串行即可
         persistedBefore = msgs.length;
       },
+      // 每轮结束回调本轮增量 usage → 逐轮入账（长任务期间「今日费用」实时累计）
+      onUsage,
       // 审计记录归入当前会话（P3-5）
       sessionRef: { name: path.basename(session.file) },
     });
@@ -531,6 +559,7 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
           entry.abortHandler?.();
         } catch {}
         entry.status = 'failed';
+        notifyBusy();
         entry.durationMs = Date.now() - entry.startedAt;
         pruneTasks();
       }
@@ -544,7 +573,14 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
       session.routeStats = { steps: st.steps + (io.stats().toolCount || 0), truncated: st.truncated + (r.truncated ? 1 : 0) };
       await withSessionLock(session.file, () => appendMessages(session.file, messages.slice(persistedBefore)));
       io.printUsageLine({ modelName: runModel, usage: r.usage, durationMs: r.durationMs });
-      recordUsage(r.perf?.usedModel || runModel, r.usage, /** @type {any} */ (r.perf));
+      // v0.4.4：补记最后一轮 + 兜底总结的剩余 usage（自动续跑轮已在 onUsage 逐轮入账，避免重复计）
+      const remaining = {
+        prompt_tokens: Math.max(0, (r.usage?.prompt_tokens || 0) - recorded.prompt_tokens),
+        completion_tokens: Math.max(0, (r.usage?.completion_tokens || 0) - recorded.completion_tokens),
+        prompt_cache_hit_tokens: Math.max(0, (r.usage?.prompt_cache_hit_tokens || 0) - recorded.prompt_cache_hit_tokens),
+        prompt_cache_miss_tokens: Math.max(0, (r.usage?.prompt_cache_miss_tokens || 0) - recorded.prompt_cache_miss_tokens),
+      };
+      recordUsage(r.perf?.usedModel || runModel, remaining, /** @type {any} */ (r.perf));
       // v0.3.0 P0-3：轮末提取项目记忆（有工具工作才提，fire-and-forget）。写文件供「未来会话」用，
       // 当前会话用快照（上文已注入），故不会中途改系统提示、不破坏前缀缓存。
       if (io.stats().toolCount > 0) {
@@ -579,6 +615,7 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
         clearTaskState(finalSessionName);
       }
       entry.status = r.aborted ? 'aborted' : 'done';
+      notifyBusy();
       entry.durationMs = Date.now() - entry.startedAt;
       srvlog('chat 发送 done ' + taskId + ' status=' + entry.status + ' 总耗时=' + entry.durationMs + 'ms');
       // 预算可视化（评估 A5）：会话当前 token 占用 / 预算
@@ -607,6 +644,7 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
       });
     } catch (/** @type {any} */ err) {
       entry.status = 'failed';
+      notifyBusy();
       entry.durationMs = Date.now() - entry.startedAt;
       srvlog('chat 错误 ' + taskId + ' ' + String(err?.message || err));
       send({ type: 'error', message: String(err?.message || err) });

package/src/workspace.js

@@ -6,6 +6,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { mingdaoHome, ensureHome } from './config.js';
+import { atomicWriteFileSync } from './atomic-write.js';
 
 export function workspacesFile() {
   return path.join(mingdaoHome(), 'workspaces.json');
@@ -23,11 +24,8 @@ export function loadWorkspaces() {
 export function saveWorkspaces(/** @type {any} */ ws) {
   try {
     ensureHome();
-    // 原子写：临时文件 + rename，避免崩溃后注册表被冲空
-    const target = workspacesFile();
-    const tmp = target + '.tmp';
-    fs.writeFileSync(tmp, JSON.stringify(ws, null, 2) + '\n');
-    fs.renameSync(tmp, target);
+    // 原子写（评估 6.6）：随机 tmp 名 + rename，避免崩溃冲空与跨进程共名 tmp 串扰
+    atomicWriteFileSync(workspacesFile(), JSON.stringify(ws, null, 2) + '\n');
   } catch {}
 }
 
@@ -121,10 +119,8 @@ export function loadSessionWorkspaces() {
 export function saveSessionWorkspaces(/** @type {any} */ map) {
   try {
     ensureHome();
-    const target = sessionWorkspacesFile();
-    const tmp = target + '.tmp';
-    fs.writeFileSync(tmp, JSON.stringify(map, null, 2) + '\n', { mode: 0o600 });
-    fs.renameSync(tmp, target);
+    // 原子写（评估 6.6）：随机 tmp 名 + rename
+    atomicWriteFileSync(sessionWorkspacesFile(), JSON.stringify(map, null, 2) + '\n', { mode: 0o600 });
   } catch {}
 }