mingdao-harness 0.2.6 → 0.2.7

package/package.json

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

package/skills/release-checklist/SKILL.md

@@ -11,13 +11,14 @@ description: 准备发布新版本、打包交付前使用
 2. **版本**：版本号统一（package.json / 配置 / 文档互相一致），遵循语义化版本。
 3. **变更说明**：changelog 用用户语言描述新增/修复/破坏性变更。
 4. **构建验证**：实际构建/打包一次，并在干净环境验证产物可安装可运行。
-5. **桌面版打包冒烟（0.2.2 事故护栏，发版必经）**：主进程模块求值必须真实跑通打包产物——
+5. **发布前自检（常设步骤，2026-09-02 起）**：不依赖外部评估报告，纯代码审查主动找 bug——重点覆盖本次改动的调用链、锁/并发、权限/安全、跨平台与「打包期无声、运行期爆炸」类边界；每一条发现必须给出**文件+行号证据并按严重度排序**（高危优先修，不可带着已知高危发布）。历史战例：v0.2.6 自检一次捞出 6 条（含外部六份评估全漏的 `schedule stop` 双守护进程 bug）与 2 条自改回归。
+6. **桌面版打包冒烟（0.2.2 事故护栏，发版必经）**：主进程模块求值必须真实跑通打包产物——
    - CI 已内置：desktop.yml 在 Linux 腿用 xvfb 运行 `dist/linux-unpacked/mingdao --no-sandbox`（`MINGDAO_DESKTOP_SMOKE=1`），模块求值通过输出 `MINGDAO_DESKTOP_SMOKE_OK` 并退出 0，否则 workflow 失败；
    - 本地有显示器时可加验：`cd desktop && MINGDAO_DESKTOP_SMOKE=1 dist/linux-unpacked/mingdao --no-sandbox`（AppImage 加 `--appimage-extract-and-run`）；
    - 教训：0.2.2 三平台启动即崩（main.js 顶层调用 createLogWriter 漏导入），打包期不报错、运行期才炸——静态护栏（test/smoke.js「桌面主进程静态护栏」组）与打包冒烟双保险。
-6. **敏感信息**：密钥、token、内网地址、个人信息不得进入仓库与产物（`grep -rE 'sk-[A-Za-z0-9]{20,}' .`）。
-7. **回滚方案**：明确如何回退到上一版本（旧包/旧 tag 可恢复）。
-8. **发布后冒烟**：发布完成后立即做一次端到端验证。
+7. **敏感信息**：密钥、token、内网地址、个人信息不得进入仓库与产物（`grep -rE 'sk-[A-Za-z0-9]{20,}' .`）。
+8. **回滚方案**：明确如何回退到上一版本（旧包/旧 tag 可恢复）。
+9. **发布后冒烟**：发布完成后立即做一次端到端验证。
 
 ## 桌面版发布流水线（官网分发 + 镜像 + 转运附件回收）
 

package/src/cli.js

@@ -257,8 +257,16 @@ async function main() {
     const { readTask } = await import('./tasks.js');
     const handled = new Set();
     const supervising = new Set(); // 本 daemon 正在监督的任务（防崩溃恢复误判正在执行的任务）
+    const nonce = String(opts.prompt[1] || '');
     try {
       for (;;) {
+        // 守护进程租约自检（2026-09-03，防双 daemon）：pidfile 不再等于「我的 pid nonce」
+        // 即视为已被 stop 或已被新 daemon 取代——立即退出，绝不与新 daemon 并跑重复执行任务
+        try {
+          if (fs.readFileSync(daemonPidFile(home0), 'utf8').trim() !== `${process.pid} ${nonce}`) break;
+        } catch {
+          break; // pidfile 被删 = 已被 stop
+        }
         const jobs = listSchedules(home0);
         if (!jobs.some((j) => j.status === 'pending' || j.status === 'running')) break;
         for (const j of jobs) {
@@ -295,8 +303,12 @@ async function main() {
         await new Promise((r) => setTimeout(r, 2000));
       }
     } finally {
+      // 只删除「仍指向自己」的 pidfile：租约被改写/被新 daemon 取代而退出时，
+      // 绝不误删新 daemon 的 pidfile（否则新 daemon 下一次租约检查会连锁退出，双守护全灭）
       try {
-        fs.rmSync(daemonPidFile(home0), { force: true });
+        if (fs.readFileSync(daemonPidFile(home0), 'utf8').trim() === `${process.pid} ${nonce}`) {
+          fs.rmSync(daemonPidFile(home0), { force: true });
+        }
       } catch {}
     }
     return;
@@ -368,11 +380,14 @@ async function main() {
     },
   };
   if (cfg.mcpServers && Object.keys(cfg.mcpServers).length) {
-    // A2：预热——await 连接（6s 超时）；超时本会话冻结工具集（不再中途注入，保护前缀缓存）
+    // A2：预热——await 连接（6s 超时）；超时本会话冻结工具集（不再中途注入，保护前缀缓存）。
+    // 超时后输家 promise 仍在跑：迟到就绪的 manager 立即 stop，防 detached 子进程成孤儿（自查 #2）
+    const mcpStartP = startMcpServers(cfg.mcpServers, workingDir).catch(() => null);
     mcpManager = await Promise.race([
-      startMcpServers(cfg.mcpServers, workingDir).catch(() => null),
+      mcpStartP,
       new Promise((/** @type {any} */ r) => setTimeout(() => r(null), 6000)),
     ]);
+    if (!mcpManager) mcpStartP.then((/** @type {any} */ m) => { if (m) m.stop(); });
     if (mcpManager) {
       const ready = mcpManager.status().filter((/** @type {any} */ s) => s.ok).length;
       if (io && !opts.prompt.length) {

package/src/log-writer.js

@@ -9,7 +9,9 @@ export function createLogWriter(/** @type {string} */ file, { maxBytes = 512 * 1
     try {
       fs.mkdirSync(path.dirname(file), { recursive: true });
       const line = new Date().toISOString() + ' ' + String(msg) + '\n';
-      fs.appendFileSync(file, line);
+      // 自查 #5：日志可能含工具参数等敏感信息——创建与轮转一律 600（多用户机器防同机读取）
+      if (!fs.existsSync(file)) fs.appendFileSync(file, line, { mode: 0o600 });
+      else fs.appendFileSync(file, line);
       const st = fs.statSync(file);
       if (st.size > maxBytes) {
         const raw = fs.readFileSync(file, 'utf8');
@@ -17,8 +19,9 @@ export function createLogWriter(/** @type {string} */ file, { maxBytes = 512 * 1
         const nl = raw.indexOf('\n', cut);
         const keep = nl === -1 ? raw.slice(cut) : raw.slice(nl + 1); // 行对齐保留尾部
         const tmp = file + '.' + process.pid + '.' + crypto.randomBytes(3).toString('hex') + '.tmp';
-        fs.writeFileSync(tmp, keep);
+        fs.writeFileSync(tmp, keep, { mode: 0o600 }); // 轮转重建保持 600
         fs.renameSync(tmp, file);
+        try { fs.chmodSync(file, 0o600); } catch {} // rename 后兜底收权（历史 644 日志迁移）
       }
     } catch {
       // 日志失败绝不抛错（best-effort）

package/src/pricing.js

@@ -42,9 +42,18 @@ export function pricingDataStale() { return externalPricing().stale; }
 export async function refreshPricingFromSource(cfg) {
   const src = String(cfg?.pricing?.source || '').trim();
   if (!src) return { ok: false, lines: ['未配置 pricing.source（config.json 的 pricing.source 填官方价格 JSON 地址后重试）'] };
+  // 自查 #4：与 sync/自定义模型同类的第三外联入口——协议白名单 + 响应大小上限（防误配/恶意源灌内存）
+  try {
+    const u = new URL(src);
+    if (u.protocol !== 'http:' && u.protocol !== 'https:') return { ok: false, lines: ['价格源仅支持 http/https 地址'] };
+  } catch {
+    return { ok: false, lines: ['价格源必须是合法的 http(s) URL'] };
+  }
   const res = await fetch(src, { signal: AbortSignal.timeout(15000) });
   if (!res.ok) return { ok: false, lines: ['价格源请求失败：HTTP ' + res.status] };
-  const d = await res.json();
+  const buf = await res.arrayBuffer();
+  if (buf.byteLength > 512 * 1024) return { ok: false, lines: ['价格源响应超过 512KB 上限，已拒绝'] };
+  const d = JSON.parse(Buffer.from(buf).toString('utf8'));
   const models = d && typeof d === 'object' && !Array.isArray(d) ? /** @type {any} */ (d).models : null;
   if (!models || typeof models !== 'object' || Array.isArray(models)) {
     return { ok: false, lines: ['价格源格式不符：应为 {"models": {"模型名": {"input":…,"output":…,"cacheHit":…,"peak":{…}}}}'] };

package/src/prompts.js

@@ -14,7 +14,7 @@ const BASE = `你是 MingDao Harness，一个由 MingDao Harness 驱动的 AI
 2. 精准修改：优先用 edit 做小步精确替换；新建文件用 write；保持改动最小化；改错可用 undo 撤销。
 3. 大内容分批写：单个 write 的参数总长控制在 6000 字符以内；大文件先写核心骨架，再分多次 write/edit 逐步补充——单次输出超限会被截断并导致参数解析失败。
 4. 任务管理：多步骤任务先建 todo 清单并逐项更新；与技能（skill）相关的任务先加载对应 SKILL.md。
-5. 委托与专注：独立、可并行的子问题（调研、复核、独立实现）用 task 委托子代理，把结果拿回来继续主线。
+5. 委托与专注：把「互不依赖、可并行」的子问题（同时调研多个方向、复核多份文件、独立实现多模块）用 task 委托子代理；多个只读调研子代理应在同一轮一起派发（readOnly=true，自动并行，效率最高）；依赖当前对话细节的小改动自己做，不要委托。子代理返回后拿结果继续主线。
 6. 命令谨慎：执行 bash 前想清楚影响；命令失败时阅读错误输出并修复，同一问题最多重试 3 次。
 7. 回答风格：使用用户的语言（默认中文），简洁直接，先结论后说明。
 8. 诚实可靠：不编造不存在的文件、行号、API 或执行结果。

package/src/schedule.js

@@ -293,7 +293,9 @@ export function daemonAlive(/** @type {any} */ home) {
 }
 export function stopDaemon(/** @type {any} */ home) {
   try {
-    const pid = Number(fs.readFileSync(daemonPidFile(home), 'utf8'));
+    // pidfile 格式 "<pid> <nonce>"——必须取首段（此前整串 Number()=NaN，SIGTERM 永远不发，
+    // 只删 pidfile → 孤儿 daemon 继续跑，新 daemon 再被拉起 → 双守护重复执行任务）
+    const pid = Number(String(fs.readFileSync(daemonPidFile(home), 'utf8')).trim().split(/\s+/)[0]);
     if (pid) {
       try {
         process.kill(pid, 'SIGTERM');

package/src/tools/index.js

@@ -83,9 +83,9 @@ const SKILL_SCHEMA = {
 const TASK_SCHEMA = {
   type: 'object',
   properties: {
-    description: { type: 'string', description: '子任务一句话描述。' },
-    prompt: { type: 'string', description: '子代理的完整任务说明。' },
-    readOnly: { type: 'boolean', description: '只读调研任务，可并行。' },
+    description: { type: 'string', description: '子任务一句话描述（用于进度展示）。' },
+    prompt: { type: 'string', description: '子代理的完整任务说明（全新上下文，需自带全部必要背景）。' },
+    readOnly: { type: 'boolean', description: '只读调研任务（不写文件不执行命令）。多个 readOnly 子任务同一轮派发会并行执行，效率最高。' },
   },
   required: ['prompt'],
 };
@@ -185,7 +185,7 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'task',
-      description: '把独立子任务委托给新上下文子代理并返回汇报；readOnly 只读任务可并行。',
+      description: '把独立、可并行的子任务委托给全新上下文子代理并返回汇报。适合：多方向调研/复核/独立实现等互不依赖的任务（多个只读调研子任务应同一轮一起派发，自动并行，效率最高）；不适合：依赖当前对话细节的小改动。',
       parameters: TASK_SCHEMA,
     },
   },

package/src/web/app.js

@@ -101,6 +101,7 @@ $('#dirPickNone').onclick = () => { const cb = pickerCb; pickerCb = null; $('#di
 $('#dirPickCancel').onclick = () => { pickerCb = null; $('#dirModal').style.display = 'none'; };
 const chatEl = $('#chat'), input = $('#input'), sendBtn = $('#sendBtn');
 let activeAiMsg=null, bgRunning=0, curSteps=0, curWorkT0=0, curTools=0, curTasks=0; // 本轮进度（活动条/状态条/轨迹共用）
+let bgTasks=[]; // 后台任务列表快照（chip tooltip 详情用，updateTasksPanel 每 2s 刷新）
 let curPhase='模型推理中'; // 阶段语义（服务端 progress 事件下发）
 const sessionSubs=[]; // 本会话全部子代理（task 工具）条目：{seq, question, result, msg}
 // 回到底部悬浮按钮：滚动容器为 main；上滚超过 300px 时出现，点击平滑回底
@@ -421,9 +422,13 @@ function renderWorkStatus(){
   let html='';
   if(generating){
     const secs=curWorkT0?Math.round((Date.now()-curWorkT0)/1000):0;
-    html='<span class="ws-busy"><span class="spinner"></span>⏳ '+curSteps+' 步 · '+Math.floor(secs/60)+' 分 '+Math.round(secs%60)+' 秒 · '+curTools+' 工具步</span>';
+    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>';
   } else if(bgRunning>0){
-    html='<span class="ws-bg">🛠 '+bgRunning+' 个后台任务运行中（下载/定时任务等）— 点击查看，完成后会自动提示</span>';
+    // 后台任务 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>';
   }
   el.style.display=html?'flex':'none';
   el.innerHTML=html;
@@ -553,6 +558,7 @@ async function updateTasksPanel(){
   const j=await r.json(); const list=$('#tpList'); list.innerHTML='';
   // 质检（等待状态静默）：后台任务（worker/调度）并入计数与面板；状态转换时在聊天区弹可见横幅
   bgRunning=(Number(j.running)||0)+(Number(j.bgRunning)||0);
+  bgTasks=j.background||[];
   for(const t of (j.background||[])){
     const prev=lastBgStatus.get(t.id);
     if(prev && prev.status==='running' && t.status!=='running'){
@@ -591,7 +597,7 @@ async function refreshCostBadge(){
   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) t+=' · 护栏 '+(gd.cost/gd.limit*100).toFixed(0)+'%';
+  if(gd&&gd.limit>0&&gd.cost!=null) t+=' · 护栏 '+(gd.cost/gd.limit*100).toFixed(0)+'%';
   $('#costBadge').textContent=t;
 }
 refreshCostBadge(); setInterval(refreshCostBadge, 15000);

package/src/web/index.html

@@ -62,7 +62,8 @@ header select{flex:none}
 #tasksPanel{position:fixed;right:0;top:52px;bottom:0;width:280px;background:var(--bg2);border-left:1px solid var(--border);z-index:40;display:flex;flex-direction:column}
 /* 输入框上方工作状态条（审计：长任务静默硬伤——实时显示执行步数/耗时与后台任务数）。
    与输入框同宽对齐（复用 #composer 的居中容器），不再横贯整个聊天窗口 */
-#workStatus{max-width:860px;margin:0 auto 4px;display:flex;align-items:center;gap:10px;padding:6px 14px;background:var(--panel);border:1px solid var(--border);border-radius:12px;font-size:12.5px;color:var(--dim);flex:none}
+#workStatus{width:fit-content;max-width:100%;margin:0 auto 4px;display:flex;align-items:center;gap:10px;padding:6px 14px;background:var(--panel);border:1px solid var(--border);border-radius:12px;font-size:12.5px;color:var(--dim);flex:none;overflow:hidden}
+#workStatus .ws-busy{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 /* 状态条 busy 行：承载完整阶段信息（合并原顶部活动条），与输入框同列不遮挡聊天区 */
 #workStatus .ws-phase{color:var(--accent2);font-weight:600;white-space:nowrap}
 /* 左侧轨迹固定栏 + 右侧子代理面板（布局重构：轨迹在左、子代理在右） */

package/src/web/server.js

@@ -195,11 +195,16 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
   /** @type {any} */
   let mcpManager = null;
   if (cfg.mcpServers && Object.keys(cfg.mcpServers).length) {
+    // 超时后输家 promise 仍在跑：迟到就绪的 manager 立即 stop，防 detached 子进程成孤儿（自查 #2）
+    const mcpStartP = startMcpServers(cfg.mcpServers, workingDir).catch(() => null);
     mcpManager = await Promise.race([
-      startMcpServers(cfg.mcpServers, workingDir).catch(() => null),
+      mcpStartP,
       new Promise((/** @type {any} */ r) => setTimeout(() => r(null), 6000)),
     ]);
-    if (!mcpManager) console.error('[MingDao] ⚠ MCP 连接超时（6s）：本会话不注入 MCP 工具（重启 mingdao web 可重试）');
+    if (!mcpManager) {
+      console.error('[MingDao] ⚠ MCP 连接超时（6s）：本会话不注入 MCP 工具（重启 mingdao web 可重试）');
+      mcpStartP.then((/** @type {any} */ m) => { if (m) m.stop(); });
+    }
   }
   const mcpFacade = {
     toolSchemas: () => (mcpManager ? mcpManager.toolSchemas() : []),