mingdao-harness 0.1.54

package/src/memory.js

@@ -0,0 +1,242 @@
+// 长记忆与自主进化（借鉴 Hermes Agent）：
+//  - 用户记忆：~/.mingdao/AGENTS.md（/memory add 手动 + 会话结束自动提取用户偏好，去重追加）
+//  - 会话日志：~/.mingdao/journal.jsonl（跨会话连续性；默认不注入系统提示——新会话全新开始，
+//    避免串到历史会话上下文；WebUI「带上文」勾选 / CLI --journal 时注入最近 3 条）
+//  - 自动记忆提取用 executor 模型（约几十 token/会话），config.autoMemory 可关（默认开）
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { mingdaoHome, ensureHome } from './config.js';
+
+export function memoryFile() {
+  return path.join(mingdaoHome(), 'AGENTS.md');
+}
+
+export function journalFile() {
+  return path.join(mingdaoHome(), 'journal.jsonl');
+}
+
+export function loadMemory() {
+  try {
+    return fs.readFileSync(memoryFile(), 'utf8');
+  } catch {
+    return '';
+  }
+}
+
+export function appendMemory(lines) {
+  const add = lines.map((l) => l.trim()).filter(Boolean);
+  if (!add.length) return 0;
+  ensureHome();
+  // 审计 B9：与费用统计同口径，用北京时间自然日做记忆日期戳
+  let date = new Date().toISOString().slice(0, 10);
+  try {
+    const p = new Intl.DateTimeFormat('en-CA', { timeZone: 'Asia/Shanghai', year: 'numeric', month: '2-digit', day: '2-digit' })
+      .formatToParts(new Date());
+    const g = (t) => p.find((x) => x.type === t)?.value;
+    date = `${g('year')}-${g('month')}-${g('day')}`;
+  } catch {}
+  fs.appendFileSync(memoryFile(), add.map((l) => (l.startsWith('-') ? `- [${date}] ${l.slice(1).trim()}` : `- [${date}] ${l}`)).join('\n') + '\n');
+  return add.length;
+}
+
+function backupMemory() {
+  try {
+    if (fs.existsSync(memoryFile())) fs.copyFileSync(memoryFile(), memoryFile() + '.bak');
+  } catch {}
+}
+
+// 整体覆写（编辑面板保存用，自动备份）
+export function writeMemory(content) {
+  backupMemory();
+  ensureHome();
+  fs.writeFileSync(memoryFile(), String(content ?? ''));
+}
+
+// 去重：忽略日期前缀后内容相同的条目只保留第一条
+export function dedupeMemory() {
+  const raw = loadMemory();
+  if (!raw.trim()) return 0;
+  const seen = new Set();
+  const kept = [];
+  let removed = 0;
+  for (const line of raw.split('\n')) {
+    const t = line.trim();
+    if (!t) continue;
+    const norm = t.replace(/^-\s*\[\d{4}-\d{2}-\d{2}\]\s*/, '').trim().toLowerCase();
+    if (seen.has(norm)) {
+      removed += 1;
+      continue;
+    }
+    seen.add(norm);
+    kept.push(t);
+  }
+  if (removed > 0) {
+    backupMemory();
+    fs.writeFileSync(memoryFile(), kept.join('\n') + '\n');
+  }
+  return removed;
+}
+
+// 删除包含关键词的条目
+export function removeMemoryLines(keyword) {
+  const raw = loadMemory();
+  const kw = String(keyword).trim().toLowerCase();
+  if (!raw.trim() || !kw) return 0;
+  const kept = [];
+  let removed = 0;
+  for (const line of raw.split('\n')) {
+    if (line.trim() && line.toLowerCase().includes(kw)) {
+      removed += 1;
+      continue;
+    }
+    kept.push(line);
+  }
+  if (removed > 0) {
+    backupMemory();
+    fs.writeFileSync(memoryFile(), kept.join('\n'));
+  }
+  return removed;
+}
+
+let journalCount = 0; // 内存计数（评估 P3-2）：避免每次写入都整文件读一遍只为查行数
+
+export function appendJournal(home, entry) {
+  try {
+    // journalFile() 已含 mingdaoHome()（home 参数仅为兼容旧签名保留）。
+    // 不能 path.join(home, dirname(journalFile()))：journalFile() 是绝对路径，join 会拼出
+    // 「D:\a\D:\b」式非法路径——Windows 上 mkdir 抛错被静默吞掉，journal 整体失效（评估 D1）。
+    fs.mkdirSync(path.dirname(journalFile()), { recursive: true });
+    // 纯追加：并发会话收尾互不覆盖；崩溃最多丢最后一行
+    fs.appendFileSync(journalFile(), JSON.stringify(entry) + '\n');
+    journalCount += 1;
+  } catch (err) {
+    // 静默吞错面收窄（评估建议 3）：调试开关可见原因，正常使用仍零打扰
+    if (process.env.MINGDAO_DEBUG) console.warn('[MingDao] journal 写入失败：' + (err?.message || err));
+  }
+  // 低频截断：超过 600 行时重写保留最近 500 行（跨过上限后每 200 条检查一次）
+  if (journalCount > 600 && journalCount % 200 === 0) {
+    try {
+      const raw = fs.readFileSync(journalFile(), 'utf8');
+      const lines = raw.split('\n').filter(Boolean);
+      if (lines.length > 600) {
+        fs.writeFileSync(journalFile(), lines.slice(-500).join('\n') + '\n');
+        journalCount = 500;
+      }
+    } catch {}
+  }
+}
+
+export function recentJournal(home, n = 3) {
+  try {
+    const raw = fs.readFileSync(journalFile(), 'utf8');
+    return raw
+      .split('\n')
+      .filter(Boolean)
+      .map((l) => {
+        try {
+          return JSON.parse(l);
+        } catch {
+          return null;
+        }
+      })
+      .filter(Boolean)
+      .slice(-n);
+  } catch {
+    return [];
+  }
+}
+
+export function recentJournalBlock(home) {
+  const entries = recentJournal(home, 3);
+  if (!entries.length) return '';
+  return (
+    '\n\n<recent_sessions>\n' +
+    entries
+      .map((e) => `- ${new Date(e.at).toISOString().slice(0, 10)} ${(e.workspace || '').replace(/[<>]/g, '')}：${(e.firstUser?.slice(0, 40) ?? '').replace(/[<>]/g, '')} → ${(e.outcome?.slice(0, 40) ?? '').replace(/[<>]/g, '')}`)
+      .join('\n') +
+    '\n</recent_sessions>'
+  );
+}
+
+// 自动记忆提取：从对话提炼值得长期记住的用户偏好/事实（去重：已有记忆会先提供给模型）
+export async function extractMemory(provider, model, messages, existingMemory) {
+  try {
+    const convo = messages
+      .filter((m) => m.role === 'user' || m.role === 'assistant')
+      .slice(-20)
+      .map((m) => `${m.role === 'user' ? '用户' : 'MingDao'}：${String(m.content || '').slice(0, 500)}`)
+      .join('\n');
+    const msgs = [
+      {
+        role: 'system',
+        content:
+          '你是 MingDao 的记忆提取器。从对话中提取值得长期记住的用户偏好与事实（工具链、代码风格、项目背景、个人约定、常用指令等）。每条一行，以 - 开头，≤30 字，只输出新条目（与「已有记忆」重复或对话中未提及的不要输出）；没有新增时 items 为空数组。\n已有记忆：\n' +
+          (existingMemory || '（空）'),
+      },
+      { role: 'user', content: convo.slice(0, 8000) },
+    ];
+    // 结构化输出（评估 4.2-4）：json_object，maxTokens 300→200，解析零失败；网关不支持时回退纯文本
+    try {
+      const res = await provider.chat({ model, messages: msgs, tools: [], temperature: 0.2, maxTokens: 200, responseFormat: { type: 'json_object' } });
+      const j = JSON.parse(String(res.text || '').trim());
+      const items = Array.isArray(j?.items) ? j.items : [];
+      const clean = items
+        .map((l) => String(l).trim())
+        .filter(Boolean)
+        .map((l) => (/^[·•]/.test(l) ? '- ' + l.replace(/^[·•]\s*/, '') : l.startsWith('-') ? l : '- ' + l)) // 审计 Q4：非前缀条目规整为 "- "，不再二次回退调用
+        .slice(0, 10);
+      if (clean.length || items.length === 0) return clean; // 空数组 = 无新增；有内容即返回
+    } catch {}
+    const res = await provider.chat({
+      model,
+      messages: [
+        {
+          role: 'system',
+          content:
+            '你是 MingDao 的记忆提取器。从对话中提取值得长期记住的用户偏好与事实（工具链、代码风格、项目背景、个人约定、常用指令等）。每条一行，以 - 开头，≤30 字，只输出新条目（与「已有记忆」重复或对话中未提及的不要输出）；没有新增就只输出「无新增」。\n已有记忆：\n' +
+            (existingMemory || '（空）'),
+        },
+        { role: 'user', content: convo.slice(0, 8000) },
+      ],
+      tools: [],
+      temperature: 0.2,
+      maxTokens: 300,
+    });
+    const text = String(res.text || '').trim();
+    if (!text || text.includes('无新增')) return [];
+    return text
+      .split('\n')
+      .map((l) => l.trim())
+      .filter((l) => l.startsWith('-') || /^[·•]/.test(l))
+      .map((l) => l.replace(/^[·•]\s*/, '- '))
+      .slice(0, 10);
+  } catch {
+    return [];
+  }
+}
+
+// 会话收尾：写日志 + 自动记忆（turns 太少的一次性会话只记日志不提取）
+export async function finalizeSession({ cfg, provider, model, home, workingDir, messages, turns, lastText }) {
+  const firstUser = messages.find((m) => m.role === 'user')?.content || '';
+  try {
+    const wsName = null; // 由调用方通过 currentWorkspace 提供会更好，这里保持轻量
+    appendJournal(home, {
+      at: Date.now(),
+      workspace: wsName,
+      firstUser: firstUser.slice(0, 80),
+      outcome: lastText?.slice(0, 80) || '',
+      turns,
+    });
+  } catch {}
+  if (cfg?.autoMemory !== false && turns >= 3) {
+    try {
+      const existing = loadMemory();
+      // 辅助模型与当前模型分属不同服务商时按模型解析 provider（评估 P2-2）
+      const { helperProvider } = await import('./providers/index.js');
+      const memProvider = await helperProvider(cfg, model, provider);
+      const lines = await extractMemory(memProvider, model, messages, existing);
+      if (lines.length) appendMemory(lines);
+    } catch {}
+  }
+}

package/src/model-discovery.js

@@ -0,0 +1,153 @@
+// 模型动态发现：设置 API Key 后从服务商 /models 接口拉取真实可用模型，
+// 模型名称以线上为准（不硬编码），预设仅作为无网络时的回退与价格/参数的补充。
+//  - 缓存 <home>/model-cache.json，TTL 1 小时，避免每次打开都请求
+//  - availableModels：只列出已设置 Key 的服务商（凭证库或环境变量），
+//    动态名单优先，预设名单回退；自定义模型（config.customModels）恒列出
+//  - 未收录预设的线上模型走通用默认（Agent 有兜底参数），计价显示 n/a
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { mingdaoHome, ensureHome } from './config.js';
+import { PROVIDERS, MODELS } from './models.js';
+import { getStoredKey } from './credentials.js';
+
+const TTL_MS = 60 * 60 * 1000;
+
+export function modelCacheFile() {
+  return path.join(mingdaoHome(), 'model-cache.json');
+}
+
+function loadCache() {
+  try {
+    return JSON.parse(fs.readFileSync(modelCacheFile(), 'utf8'));
+  } catch {
+    return {};
+  }
+}
+
+function saveCache(data) {
+  try {
+    ensureHome();
+    fs.writeFileSync(modelCacheFile(), JSON.stringify(data, null, 2) + '\n', { mode: 0o600 });
+  } catch {}
+}
+
+export function providerHasKey(providerName) {
+  const pp = PROVIDERS[providerName];
+  if (!pp) return false;
+  if (getStoredKey(providerName)) return true;
+  if (pp.envKey && process.env[pp.envKey]) return true;
+  return false;
+}
+
+export function providerBaseUrl(cfg, providerName) {
+  const pp = PROVIDERS[providerName];
+  if (!pp) return '';
+  // 当前服务商的 baseUrl 覆盖优先
+  if (providerName === cfg?.provider && cfg?.baseUrl) return cfg.baseUrl;
+  return pp.baseUrl || '';
+}
+
+export function providerApiKey(providerName) {
+  const pp = PROVIDERS[providerName];
+  const stored = getStoredKey(providerName);
+  if (stored) return stored;
+  if (pp?.envKey && process.env[pp.envKey]) return process.env[pp.envKey];
+  return '';
+}
+
+function isChatModel(id) {
+  return !/embedding|rerank|moderation/i.test(id);
+}
+
+// 拉取某服务商的真实模型名单（缓存优先；force 强制刷新）
+// 返回 { models: [名称], fromCache, fetchedAt }；失败返回 { error }
+const inflight = new Map(); // 同服务商并发去重：合并为同一请求
+
+export async function fetchProviderModels(cfg, providerName, { force = false } = {}) {
+  const base = providerBaseUrl(cfg, providerName).replace(/\/+$/, '');
+  const key = providerApiKey(providerName);
+  if (!base || !key) return { error: '该服务商未设置 API Key' };
+  const cache = loadCache();
+  const entry = cache[providerName];
+  if (!force && entry && Date.now() - entry.fetchedAt < TTL_MS && Array.isArray(entry.models)) {
+    return { models: entry.models, fromCache: true, fetchedAt: entry.fetchedAt };
+  }
+  if (!force && inflight.has(providerName)) return inflight.get(providerName);
+  const p = (async () => {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), 8000);
+    try {
+      const res = await fetch(`${base}/models`, {
+        headers: { Authorization: `Bearer ${key}` },
+        signal: ctrl.signal,
+        redirect: 'follow',
+      });
+      if (!res.ok) return { error: `HTTP ${res.status}` };
+      const j = await res.json().catch(() => null);
+      const list = (j?.data || [])
+        .map((m) => String(m?.id || '').trim())
+        .filter((id) => id && isChatModel(id))
+        .slice(0, 200);
+      if (!list.length) return { error: '接口未返回可用模型' };
+      const cache2 = loadCache(); // 重新读取：避免与并发写入互相覆盖
+      cache2[providerName] = { models: list, fetchedAt: Date.now() };
+      saveCache(cache2);
+      return { models: list, fromCache: false, fetchedAt: Date.now() };
+    } catch (e) {
+      return { error: e.name === 'AbortError' ? '请求超时（8s）' : e.message };
+    } finally {
+      clearTimeout(timer);
+    }
+  })();
+  inflight.set(providerName, p);
+  try {
+    return await p;
+  } finally {
+    if (inflight.get(providerName) === p) inflight.delete(providerName);
+  }
+}
+
+// 合并可用模型列表：只含已设置 Key 的服务商；动态名单优先、预设回退；自定义模型恒在。
+export async function availableModels(cfg, currentModel) {
+  const out = [];
+  const seen = new Set();
+  for (const [pname, pp] of Object.entries(PROVIDERS)) {
+    if (pname === 'custom') continue;
+    if (!providerHasKey(pname)) continue;
+    const dynamic = await fetchProviderModels(cfg, pname);
+    const names = dynamic.models?.length ? dynamic.models : pp.models || [];
+    for (const n of names) {
+      if (seen.has(n)) continue;
+      seen.add(n);
+      const preset = MODELS[n];
+      out.push({
+        name: n,
+        label: preset ? `${n} — ${preset.label}` : `${n}（线上最新）`,
+        provider: pname,
+        providerLabel: pp.label,
+        dynamic: !MODELS[n],
+      });
+    }
+  }
+  for (const [cmName, cm] of Object.entries(cfg?.customModels || {})) {
+    if (seen.has(cmName)) continue;
+    seen.add(cmName);
+    out.push({
+      name: cmName,
+      label: `${cmName} — ${cm.label || '自定义模型'}`,
+      provider: 'custom',
+      providerLabel: '自定义',
+      custom: true,
+    });
+  }
+  if (currentModel && !out.some((m) => m.name === currentModel)) {
+    out.unshift({
+      name: currentModel,
+      label: `${currentModel}（当前配置）`,
+      provider: 'current',
+      providerLabel: '当前',
+    });
+  }
+  return out;
+}

package/src/models.js

@@ -0,0 +1,186 @@
+// 模型与服务商预设目录（MingDao 内置）。
+// 所有字段都可以通过 ~/.mingdao/config.json 或环境变量覆盖，
+// 也可以在 <mingdao-home>/providers/<name>.mjs 中注册完全自定义的 Provider 模块。
+
+export const PROVIDERS = {
+  deepseek: {
+    label: 'DeepSeek 官方 API',
+    kind: 'openai-compatible',
+    baseUrl: 'https://api.deepseek.com/v1',
+    envKey: 'DEEPSEEK_API_KEY',
+    models: ['deepseek-v4-flash', 'deepseek-v4-pro', 'deepseek-v4-flash-vision-exp'],
+    note: 'DeepSeek-V4 正式版（2026-08-17 起商用）：384K 上下文，峰谷定价（高峰 9:00–14:00 为闲时 2 倍），支持工具调用 / Responses API / Anthropic 兼容接口。',
+  },
+  openai: {
+    label: 'OpenAI',
+    kind: 'openai-compatible',
+    baseUrl: 'https://api.openai.com/v1',
+    envKey: 'OPENAI_API_KEY',
+    models: ['gpt-5', 'gpt-5-mini', 'gpt-5-nano'],
+  },
+  qwen: {
+    label: '阿里云百炼（通义千问）',
+    kind: 'openai-compatible',
+    baseUrl: 'https://dashscope.aliyuncs.com/compatible-mode/v1',
+    envKey: 'DASHSCOPE_API_KEY',
+    models: ['qwen3.7-max', 'qwen-plus'],
+  },
+  glm: {
+    label: '智谱 GLM',
+    kind: 'openai-compatible',
+    baseUrl: 'https://open.bigmodel.cn/api/paas/v4',
+    envKey: 'ZHIPUAI_API_KEY',
+    models: ['glm-5', 'glm-4.5-air'],
+  },
+  moonshot: {
+    label: '月之暗面 Kimi',
+    kind: 'openai-compatible',
+    baseUrl: 'https://api.moonshot.cn/v1',
+    envKey: 'MOONSHOT_API_KEY',
+    models: ['kimi-latest', 'kimi-k2'],
+  },
+  custom: {
+    label: '自定义 OpenAI 兼容端点（任意模型网关/本地部署）',
+    kind: 'openai-compatible',
+    baseUrl: 'https://your-gateway.example.com/v1',
+    envKey: 'MINGDAO_API_KEY',
+    models: [],
+  },
+};
+
+export const MODELS = {
+  // —— DeepSeek-V4 系列（MingDao 首发优化目标）——
+  'deepseek-v4-pro': {
+    label: '旗舰推理 · 复杂架构、排障、规划',
+    provider: 'deepseek',
+    contextWindow: 384000, // 正式版规格：384K 上下文（2026-08-17 起商用）
+    budgetTokens: 200000, // 默认注入预算（省钱省时，可调高）
+    maxOutputTokens: 32768,
+    temperature: 0.4,
+    supportsReasoning: true,
+    // 峰谷定价（元/百万 tokens；input=缓存未命中，cacheHit=缓存命中约为未命中的 1/30）
+    pricing: {
+      offpeak: { input: 4.5, output: 13.5, cacheHit: 0.15 },
+      peak: { input: 9, output: 27, cacheHit: 0.3 },
+    },
+  },
+  'deepseek-v4-flash': {
+    label: '极速响应 · 日常问答与轻量任务',
+    provider: 'deepseek',
+    contextWindow: 384000, // 正式版规格：384K 上下文
+    budgetTokens: 128000,
+    maxOutputTokens: 8192,
+    temperature: 0.6,
+    supportsReasoning: false,
+    pricing: {
+      offpeak: { input: 1.5, output: 4.5, cacheHit: 0.05 },
+      peak: { input: 3, output: 9, cacheHit: 0.1 },
+    },
+  },
+  // 多模态视觉模型（2026-08-21 上线，实验版）：文本 + 图片输入（JPEG/PNG/GIF/WebP），
+  // 图片转 token 计费（≤384 tokens/张），价格与 V4-Flash 完全一致。
+  'deepseek-v4-flash-vision-exp': {
+    label: '多模态视觉 · 图片描述/截图识别/图表分析（实验版）',
+    provider: 'deepseek',
+    contextWindow: 384000,
+    budgetTokens: 128000,
+    maxOutputTokens: 8192,
+    temperature: 0.6,
+    supportsReasoning: false,
+    supportsVision: true,
+    pricing: {
+      offpeak: { input: 1.5, output: 4.5, cacheHit: 0.05 },
+      peak: { input: 3, output: 9, cacheHit: 0.1 },
+    },
+  },
+  // —— 其他主流模型（OpenAI 兼容接入，按 2026-08 官方当前型号）——
+  'gpt-5': {
+    label: 'OpenAI 旗舰（官方别名，随最新版本）',
+    provider: 'openai',
+    contextWindow: 400000,
+    budgetTokens: 128000,
+    maxOutputTokens: 16384,
+    temperature: 0.6,
+    supportsReasoning: false,
+  },
+  'gpt-5-mini': {
+    label: 'OpenAI 性价比',
+    provider: 'openai',
+    contextWindow: 272000,
+    budgetTokens: 128000,
+    maxOutputTokens: 16384,
+    temperature: 0.7,
+    supportsReasoning: false,
+  },
+  'gpt-5-nano': {
+    label: 'OpenAI 最便宜',
+    provider: 'openai',
+    contextWindow: 272000,
+    budgetTokens: 96000,
+    maxOutputTokens: 16384,
+    temperature: 0.7,
+    supportsReasoning: false,
+  },
+  'qwen3.7-max': {
+    label: '通义千问旗舰',
+    provider: 'qwen',
+    contextWindow: 262144,
+    budgetTokens: 128000,
+    maxOutputTokens: 8192,
+    temperature: 0.6,
+    supportsReasoning: false,
+  },
+  'qwen-plus': {
+    label: '通义千问通用（官方别名，随最新版本）',
+    provider: 'qwen',
+    contextWindow: 131072,
+    budgetTokens: 96000,
+    maxOutputTokens: 8192,
+    temperature: 0.6,
+    supportsReasoning: false,
+  },
+  'glm-5': {
+    label: '智谱旗舰',
+    provider: 'glm',
+    contextWindow: 200000,
+    budgetTokens: 128000,
+    maxOutputTokens: 8192,
+    temperature: 0.6,
+    supportsReasoning: false,
+  },
+  'glm-4.5-air': {
+    label: '智谱免费轻量',
+    provider: 'glm',
+    contextWindow: 131072,
+    budgetTokens: 96000,
+    maxOutputTokens: 4096,
+    temperature: 0.7,
+    supportsReasoning: false,
+  },
+  'kimi-latest': {
+    label: 'Kimi 最新（官方别名，随最新版本）',
+    provider: 'moonshot',
+    contextWindow: 262144,
+    budgetTokens: 128000,
+    maxOutputTokens: 8192,
+    temperature: 0.7,
+    supportsReasoning: false,
+  },
+  'kimi-k2': {
+    label: 'Kimi K2 长文本',
+    provider: 'moonshot',
+    contextWindow: 262144,
+    budgetTokens: 128000,
+    maxOutputTokens: 8192,
+    temperature: 0.7,
+    supportsReasoning: false,
+  },
+};
+
+export function modelPreset(name) {
+  return MODELS[name] || null;
+}
+
+export function providerPreset(name) {
+  return PROVIDERS[name] || null;
+}

package/src/notify.js

@@ -0,0 +1,38 @@
+// 桌面通知（零依赖）：后台任务完成/失败时弹出系统通知。
+//  - Linux：notify-send（GNOME/KDE 等桌面环境自带）
+//  - macOS：osascript display notification
+//  - Windows：PowerShell WScript.Shell Popup（10 秒自动消失）
+//  config.notify 可关闭（默认开启）；通知失败静默忽略，绝不影响任务流程。
+
+import { spawn } from 'node:child_process';
+
+export function notify(title, message) {
+  try {
+    const text = String(message).replace(/\s+/g, ' ').slice(0, 120);
+    // 审计 P2-12：title 同样转义（mac 反斜杠/引号、win 单引号），防注入破坏命令
+    const t = String(title).replace(/\s+/g, ' ').slice(0, 40);
+    if (process.platform === 'linux') {
+      const child = spawn('notify-send', [t, text], { detached: true, stdio: 'ignore' });
+      child.on('error', () => {});
+      child.unref();
+    } else if (process.platform === 'darwin') {
+      const safe = text.replace(/[\\"]/g, '\\$&');
+      const safeT = t.replace(/[\\"]/g, '\\$&');
+      const child = spawn('osascript', ['-e', `display notification "${safe}" with title "${safeT}"`], { detached: true, stdio: 'ignore' });
+      child.on('error', () => {});
+      child.unref();
+    } else if (process.platform === 'win32') {
+      const safe = text.replace(/'/g, "''");
+      const safeT = t.replace(/'/g, "''");
+      const child = spawn('powershell', ['-NoProfile', '-Command', `(New-Object -ComObject Wscript.Shell).Popup('${safe}', 10, '${safeT}', 64)`], { detached: true, stdio: 'ignore' });
+      child.on('error', () => {});
+      child.unref();
+    }
+  } catch {
+    // 通知失败静默忽略
+  }
+}
+
+export function notifyTaskDone(question, status) {
+  notify('MingDao', `${status === 'done' ? '✓ 完成' : '✖ 失败'}：${String(question).slice(0, 60)}`);
+}