mingdao-harness 0.4.3 → 0.4.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mingdao-harness",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "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?: (modelName: string, 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 || ''));
@@ -109,6 +112,7 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
       maxSteps: SUBAGENT_MAX_STEPS,
       mcp,
       sessionRef, // 子代理的审计记录归入主会话
+      onUsage, // P1-5（v0.4.5）：透传逐轮入账回调——子代理消耗计入今日费用（子代理内部 activeModel=subModel 正确归属）
     });
     const sys =
       `你是主智能体 MingDao 派出的子代理，独立完成一项子任务。` +
@@ -191,7 +195,10 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
     const inFlightCost = () => estimateCost(activeModel, usage.prompt_tokens, usage.completion_tokens, null, new Date());
     const usedTodayWithInflight = () => {
       const today = todayCost();
-      return today == null ? null : today + inFlightCost();
+      if (today == null) return null;
+      const inflight = inFlightCost();
+      // P0-4（v0.4.5）：无价模型在途费用为 null（未知）——整体视为「无法判断」而非 +null→today 的静默忽略
+      return inflight == null ? null : today + inflight;
     };
     // 省钱 B1：本回合只读阶段判定——最新用户消息无写意图则先只发只读工具，
     // 模型明确表达写意图后（下一轮）注入全量。cfg.schemaTier=false 可关。
@@ -220,6 +227,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 模型
@@ -299,8 +309,9 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
           for (const m of sanitized) promptTokens += messageTokens(m, count);
           const worst = estimateCost(activeModel, promptTokens, maxOutput, null, new Date());
           const used = usedTodayWithInflight(); // 含本回合在途费用（防长回合烧穿）
-          if (used == null) {
-            // todayCost 读取失败：无法判断，跳过前置拦截（护栏主检查同样跳过并告警）
+          if (used == null || worst == null) {
+            // P0-4（v0.4.5）：统计不可读 或 无价格数据（最坏成本未知）→ 无法判断，跳过前置拦截
+            // （护栏主检查 checkCostGuard 会显式告警「无价格数据」，此处不重复误拦也不静默放行）
           } else if (used + worst >= Number(g.dailyLimitYuan)) {
             stripOrphanCalls();
             return {
@@ -315,7 +326,7 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
       // 费用护栏（A2/B4）：每轮开始前按今日实际费用检查；block 暂停本轮；
       // downgrade 自动切换便宜模型继续执行（每回合只切一次，切换即粘滞）
       if (cfg.costGuard) {
-        const guard = checkCostGuard();
+        const guard = checkCostGuard(activeModel);
         if (guard) {
           if (guard.blocked) {
             stripOrphanCalls();
@@ -404,6 +415,24 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
           stripOrphanCalls();
           return { text: null, reasoning: '', usage, steps, finish, truncated: false, aborted: true, durationMs: Date.now() - startedAt, perf: perf() };
         }
+        // MacBook 本地 507 memory_refusal 根因（v0.4.5）：服务端内存拒绝不是「空输出」——
+        // 直接终结合合并透出降级提示，不计入空轮、不注入续写重试（内存未释放必再 507，空烧请求）。
+        const e = /** @type {any} */ (err);
+        if (e?.status === 507 || /memory_refusal|内存不足|内存拒绝/i.test(String(e?.message || ''))) {
+          stripOrphanCalls();
+          return {
+            text: null,
+            reasoning: '',
+            usage,
+            steps,
+            finish,
+            truncated: false,
+            aborted: false,
+            note: '本地模型内存不足（507 memory_refusal）——请压缩上下文（减小 config.contextBudget 或 /compact）、减少并发子任务，或重启模型服务释放内存后再继续。',
+            durationMs: Date.now() - startedAt,
+            perf: perf(),
+          };
+        }
         throw err;
       }
 
@@ -517,6 +546,9 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
           let allowed = false;
           if (isMcp && mcp?.isReadonly(name)) {
             allowed = true; // MCP 工具的只读标注自动放行
+          } else if (name === 'task' && args.readOnly === true) {
+            allowed = true; // P2-2（v0.4.5）：只读子代理自动放行——它本身只读（readOnly 子代理只能读），
+            // 与 release note「可派 readOnly 子代理」意图一致；非 readOnly 的 task 仍走权限询问
           } else {
             try {
               allowed = await permission.check(name, args);
@@ -734,6 +766,16 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
     }
     // v0.3.1 自动续跑（长程执行）：还有剩余轮次且未中断 → 注入进度摘要直接续跑，不落收尾总结
     if (round < maxRounds - 1 && !aborted) {
+      // 每轮结束：回调本轮增量 usage（含缓存命中拆分），供调用方逐轮入账。activeModel 为本轮实际模型
+      // （护栏降级/子代理都据此正确归属——P2-5 模型名一致性 + P1-5 子代理费用入账）。
+      try {
+        onUsage?.(activeModel, {
+          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/atomic-write.js

@@ -31,10 +31,17 @@ export function atomicWriteJsonSync(/** @type {string} */ target, /** @type {any
 
 // 极简互斥锁：O_EXCL 创建 lockfile；持锁期间执行 fn（同步）；异常/完成释放。
 // 进程崩溃遗留的陈旧锁（> staleMs 未更新）自动回收，避免永久卡死。
+// 可重入（P0-1 修复，v0.4.5）：本进程已持该锁时直接执行 fn——O_EXCL 锁不可重入，此前
+// killTask 持锁内调 patchTask 二次抢同一把锁自死锁 5s（tasks kill/pause/remove 全失效）。
 const sleepBuf = new Int32Array(new SharedArrayBuffer(4));
 const sleepMs = (/** @type {number} */ ms) => Atomics.wait(sleepBuf, 0, 0, ms);
+const heldLocks = new Set(); // 本进程当前持有的锁路径（可重入判定）
 
 export function withFileLockSync(/** @type {string} */ lockPath, /** @type {() => any} */ fn, { timeoutMs = 5000, staleMs = 15000 } = {}) {
+  // 可重入：同一调用栈内已持该锁 → 直接执行，不再二次抢锁
+  if (heldLocks.has(lockPath)) {
+    return fn();
+  }
   fs.mkdirSync(path.dirname(lockPath), { recursive: true });
   const t0 = Date.now();
   for (;;) {
@@ -45,9 +52,11 @@ export function withFileLockSync(/** @type {string} */ lockPath, /** @type {() =
       } finally {
         fs.closeSync(fd);
       }
+      heldLocks.add(lockPath);
       try {
         return fn();
       } finally {
+        heldLocks.delete(lockPath);
         try {
           fs.unlinkSync(lockPath);
         } catch {}

package/src/cachestats.js

@@ -5,7 +5,6 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { mingdaoHome, ensureHome } from './config.js';
 import { estimateCost, cacheSplit, beijingDayStart, beijingParts } from './pricing.js';
-import { modelPreset } from './models.js';
 import { withFileLockSync, atomicWriteFileSync } from './atomic-write.js';
 
 export function cacheStatsFile() {
@@ -114,10 +113,12 @@ export function recordUsage(/** @type {any} */ modelName, /** @type {any} */ usa
   let cost = null;
   let saved = null;
   if (split) {
+    const base = estimateCost(modelName, prompt, completion, null);
     cost = estimateCost(modelName, prompt, completion, split);
-    saved = estimateCost(modelName, prompt, completion, null) - cost;
-  } else if (modelPreset(modelName)?.pricing) {
-    // 审计 B10：无缓存字段时按全未命中估算（不再计 0 元，费用护栏口径更真实）
+    if (base != null && cost != null) saved = base - cost;
+  } else {
+    // P0-4（v0.4.5）：estimateCost 无价返 null，直接记录 null（未知）而非 0（免费）——
+    // 覆盖内置定价 + 外部定价 + config.pricing.overrides 三条来源，不再依赖 modelPreset 单一判断。
     cost = estimateCost(modelName, prompt, completion, null);
   }
   recordCacheStats({

package/src/cli.js

@@ -32,6 +32,7 @@ import {
   reconcileSchedules,
   runSleeper,
   formatScheduleRow,
+  postRunStatus,
 } from './schedule.js';
 import { createAgent } from './agent.js';
 import { saveTaskStateMerge, clearTaskState } from './task-state.js';
@@ -120,21 +121,28 @@ function printHelpLines(/** @type {any} */ out) {
 
 function parseArgs(/** @type {any} */ argv) {
   const opts = /** @type {Record<string, any>} */ ({ prompt: [], model: null, continueSession: false, resume: false, format: 'text' });
+  // P1-2 / P2-24（v0.4.5）：遇第一个位置参数后停止解析全局 flag——此前贪婪匹配任意位置的 --model/init，
+  // 导致 `mingdao run "任务" --model X` 的 --model 被顶层剥除（后台/定时指定模型静默失效），
+  // 且提问文本含「init」即误触发初始化向导。此后子命令 flag 原样收入 prompt 交子命令解析。
+  let seenArg = false;
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
-    if (a === '-h' || a === '--help') opts.help = true;
-    else if (a === '-v' || a === '--version') opts.version = true;
-    else if (a === '-c' || a === '--continue') opts.continueSession = true;
-    else if (a === '--journal') opts.journal = true;
-    else if (a === '-p' || a === '--preset') opts.preset = argv[++i];
-    else if (a.startsWith('--preset=')) opts.preset = a.slice(9);
-    else if (a === '-r' || a === '--resume') opts.resume = true;
-    else if (a === '--init' || a === 'init') opts.init = true;
-    else if (a === '-m' || a === '--model') opts.model = argv[++i];
-    else if (a.startsWith('--model=')) opts.model = a.slice(8);
-    else if (a === '-f' || a === '--format') opts.format = argv[++i] || 'text';
-    else if (a.startsWith('--format=')) opts.format = a.slice(9);
-    else opts.prompt.push(a);
+    if (!seenArg) {
+      if (a === '-h' || a === '--help') { opts.help = true; continue; }
+      else if (a === '-v' || a === '--version') { opts.version = true; continue; }
+      else if (a === '-c' || a === '--continue') { opts.continueSession = true; continue; }
+      else if (a === '--journal') { opts.journal = true; continue; }
+      else if (a === '-p' || a === '--preset') { opts.preset = argv[++i]; continue; }
+      else if (a.startsWith('--preset=')) { opts.preset = a.slice(9); continue; }
+      else if (a === '-r' || a === '--resume') { opts.resume = true; continue; }
+      else if (a === '--init' || a === 'init') { opts.init = true; continue; }
+      else if (a === '-m' || a === '--model') { opts.model = argv[++i]; continue; }
+      else if (a.startsWith('--model=')) { opts.model = a.slice(8); continue; }
+      else if (a === '-f' || a === '--format') { opts.format = argv[++i] || 'text'; continue; }
+      else if (a.startsWith('--format=')) { opts.format = a.slice(9); continue; }
+    }
+    seenArg = true;
+    opts.prompt.push(a);
   }
   if (!['text', 'json'].includes(opts.format)) opts.format = 'text';
   return opts;
@@ -289,7 +297,14 @@ async function main() {
             }
             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 });
+              // P1-4（v0.4.5）：every 周期任务崩溃恢复不能终态化——复用 postRunStatus 重排下一期回 pending，
+              // 否则周期任务静默永停（此前与 once/after 一视同仁写成 done/failed，reconcile 永远跳过）。
+              if (j.kind === 'every') {
+                const ns = postRunStatus(j, result);
+                await writeSchedule(home0, { ...j, ...(ns || { status: result }), lastRunAt: t.startedAt || j.lastRunAt, runs: (j.runs || 0) + 1 });
+              } else {
+                await writeSchedule(home0, { ...j, status: result, lastRunAt: t.startedAt || j.lastRunAt, runs: (j.runs || 0) + 1 });
+              }
               continue;
             }
             continue; // worker 仍在跑：等它（外层 2s 轮询）
@@ -427,7 +442,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/commands/repl.js

@@ -617,13 +617,14 @@ export async function runRepl(ctx) {
           );
         } else io.print('尚无用量记录。');
       } else if (cmd === '/status') {
+        const sc = estimateCost(modelName, stats.promptTokens, stats.completionTokens);
         io.box('会话状态', [
           `模型  ${modelName} · 权限 ${permission.mode}`,
           `沙箱  ${cfg.sandbox || 'off'}${routing ? ` · 自动路由  ${routingEnabled ? '开' : '关'}（${routing.planner}⇄${routing.executor}）` : ''}`,
           `会话  ${path.basename(session.file)}`,
           `轮次  ${stats.turns} · 消息 ${messages.length} 条`,
           `Tokens  ↑${stats.promptTokens} ↓${stats.completionTokens}`,
-          `费用  ≈¥${estimateCost(modelName, stats.promptTokens, stats.completionTokens).toFixed(5)}（累计·按当前模型计价）`,
+          `费用  ${sc == null ? '≈¥—（无价格数据）' : '≈¥' + sc.toFixed(5)}（累计·按当前模型计价）`,
           `计划模式  ${planMode ? '开' : '关'} · 思考显示  ${io.showReasoning ? '开' : '关'} · 任务 ${agent.getTodos().length} 项`,
         ]);
       } else if (cmd === '/cost') {
@@ -634,7 +635,7 @@ export async function runRepl(ctx) {
           `缓存命中率  ${bd.rate != null ? (bd.rate * 100).toFixed(0) + '%' : '暂无缓存数据'}${bd.batchCost > 0 ? ` · Batch 半价任务 ≈¥${bd.batchCost.toFixed(5)}` : ''}`,
           ...bd.byModel.slice(0, 8).map((m) => `  ${m.model}：${m.turns} 轮（${m.batchTurns ? m.batchTurns + ' 批' : ''}）· ↑${m.prompt} ↓${m.completion} · ≈¥${m.cost.toFixed(5)}${m.saved > 0 ? ` · 省 ¥${m.saved.toFixed(5)}` : ''}`),
         ]);
-        const guard = costGuardStatus();
+        const guard = costGuardStatus(modelName);
         if (guard) {
           io.print(
             style(
@@ -643,7 +644,8 @@ export async function runRepl(ctx) {
             )
           );
         }
-        io.print(style('会话内累计（本次）≈¥' + estimateCost(modelName, stats.promptTokens, stats.completionTokens).toFixed(5), C.dim));
+        const sc2 = estimateCost(modelName, stats.promptTokens, stats.completionTokens);
+        io.print(style('会话内累计（本次）' + (sc2 == null ? '≈¥—（无价格数据）' : '≈¥' + sc2.toFixed(5)), C.dim));
       } else if (cmd === '/cache') {
         const entries = listCacheStats();
         if (!entries.length) {

package/src/cost-guard.js

@@ -6,7 +6,7 @@
 
 import fs from 'node:fs';
 import { listCacheStats, cacheStatsFile } from './cachestats.js';
-import { beijingDayStart } from './pricing.js';
+import { beijingDayStart, hasPricing } from './pricing.js';
 import { loadConfig } from './config.js';
 
 export function costGuardConfig() {
@@ -44,13 +44,22 @@ export function todayCost() {
   }
 }
 
-export function costGuardStatus() {
+/**
+ * @param {any} [modelName] 实际使用模型；缺省回退 config.model（仪表盘/无会话上下文）
+ */
+export function costGuardStatus(modelName) {
   const g = costGuardConfig();
   if (!g) return null;
   const cost = todayCost();
   const limit = Number(g.dailyLimitYuan) || 0;
   const warnAt = Number(g.warnAtYuan) || (limit > 0 ? limit * 0.8 : 0);
   const action = g.action === 'block' || g.action === 'downgrade' ? g.action : 'warn';
+  // P0-4（v0.4.5）：当前模型无价格数据时费用护栏静默失效（estimateCost 恒 0、overLimit 恒 false）。
+  // 显式标记 noPricing，调用方据此告警而非静默放行。modelName 优先取「实际使用模型」（agent 传 activeModel），
+  // 缺省回退 config.model（仪表盘/无会话上下文）；两者都无则无法判断，不误标 noPricing。
+  const cfg = loadConfig();
+  const model = modelName ?? cfg?.model ?? null;
+  const noPricing = limit > 0 && model != null && !hasPricing(model);
   return {
     cost,
     limit,
@@ -58,16 +67,27 @@ export function costGuardStatus() {
     action,
     downgradeModel: String(g.downgradeModel || 'deepseek-v4-flash'),
     degraded: cost === null, // 统计不可读：护栏降级为「无法判断」
-    overWarn: cost !== null && limit > 0 && cost >= warnAt,
-    overLimit: cost !== null && limit > 0 && cost >= limit,
+    noPricing, // 无价格数据：费用护栏无法累计，需显式告警
+    overWarn: cost !== null && !noPricing && limit > 0 && cost >= warnAt,
+    overLimit: cost !== null && !noPricing && limit > 0 && cost >= limit,
   };
 }
 
 // Agent 每轮开始前调用：返回 null 放行；blocked=true 应暂停本轮；downgrade=true 应切换便宜模型
-export function checkCostGuard() {
-  const st = costGuardStatus();
+/**
+ * @param {any} [modelName] 实际使用模型；缺省回退 config.model
+ */
+export function checkCostGuard(modelName) {
+  const st = costGuardStatus(modelName);
   if (!st) return null;
   if (st.degraded) return null; // 统计不可读：不误拦也不放水（已告警），按无法判断处理
+  if (st.noPricing) {
+    // P0-4（v0.4.5）：无价格数据时护栏无法累计——显式告警而非静默放行（绝不当「没花钱」）
+    return {
+      blocked: false,
+      message: '⚠ 费用护栏：当前模型无价格数据，今日费用无法累计、dailyLimitYuan 不生效——请在 config.pricing.overrides 为模型补充定价，或改用有价的 DeepSeek 模型（deepseek-v4-pro/flash）。',
+    };
+  }
   if (st.overLimit && st.action === 'block') {
     return {
       blocked: true,

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/memory.js

@@ -9,6 +9,7 @@ import path from 'node:path';
 import { mingdaoHome, ensureHome } from './config.js';
 import { beijingParts } from './pricing.js';
 import { tokenize } from './session-index.js';
+import { atomicWriteFileSync } from './atomic-write.js';
 
 export function memoryFile() {
   return path.join(mingdaoHome(), 'AGENTS.md');
@@ -47,7 +48,7 @@ function backupMemory() {
 export function writeMemory(/** @type {any} */ content) {
   backupMemory();
   ensureHome();
-  fs.writeFileSync(memoryFile(), String(content ?? ''));
+  atomicWriteFileSync(memoryFile(), String(content ?? ''));
 }
 
 // 去重：忽略日期前缀后内容相同的条目只保留第一条
@@ -70,7 +71,7 @@ export function dedupeMemory() {
   }
   if (removed > 0) {
     backupMemory();
-    fs.writeFileSync(memoryFile(), kept.join('\n') + '\n');
+    atomicWriteFileSync(memoryFile(), kept.join('\n') + '\n');
   }
   return removed;
 }
@@ -91,7 +92,7 @@ export function removeMemoryLines(/** @type {any} */ keyword) {
   }
   if (removed > 0) {
     backupMemory();
-    fs.writeFileSync(memoryFile(), kept.join('\n'));
+    atomicWriteFileSync(memoryFile(), kept.join('\n'));
   }
   return removed;
 }
@@ -117,7 +118,7 @@ export function appendJournal(/** @type {any} */ home, /** @type {any} */ entry)
       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');
+        atomicWriteFileSync(journalFile(), lines.slice(-500).join('\n') + '\n');
         journalCount = 500;
       }
     } catch {}
@@ -294,7 +295,7 @@ export function dedupeProjectMemory(/** @type {any} */ workingDir) {
     kept.push(t);
   }
   if (removed > 0) {
-    try { fs.writeFileSync(projectMemoryFile(workingDir), kept.join('\n') + '\n'); } catch {}
+    try { atomicWriteFileSync(projectMemoryFile(workingDir), kept.join('\n') + '\n'); } catch {}
   }
   return removed;
 }

package/src/model-caps.js

@@ -7,6 +7,8 @@ import { modelPreset } from './models.js';
 // fc00::/7、fe80::/10、::、::1、IPv4-mapped）——此前只查 IPv4 与 ::1，IPv6 本地模型被误判远程
 // （超时档位错），且与 fetch 工具/SSRF 判定各维护一份、口径漂移。
 import { isPrivateHost } from './tools/fetch.js';
+import fs from 'node:fs';
+import path from 'node:path';
 
 // 兜底：未知模型默认上下文窗口。本地小模型宁可保守（不撑爆）也不乐观。
 export const UNKNOWN_LOCAL_WINDOW = 32768;
@@ -21,11 +23,45 @@ export const COMFORT_RATIO = 0.75;
 export const EDGE_RATIO = 0.85;
 
 /** 判断 baseUrl 是否指向本机/内网（本地推理框架部署）。 */
+// MacBook 本地 507 根因（v0.4.5）：自定义主机名（如 mtplx.server.openai 经 /etc/hosts 指向 127.0.0.1）
+// 的字面量判定抓不到——isPrivateHost(hostname) 对非 IP/非 localhost 恒 false，导致本地模型被误判远程：
+// 只读子代理不串行（9 路大 prefill 并发击穿内存）、压缩触发线用远程档（0.8 而非 0.6）、超时档位错。
+// 同步查 /etc/hosts（含 Windows）复检「主机名 → 私网/回环 IP」的映射，命中即视为本地。
+const hostsCache = /** @type {Map<string, boolean>} */ (new Map()); // hostname → 是否 /etc/hosts 映射私网
+function hostsMapsToPrivate(/** @type {string} */ hostname) {
+  if (hostsCache.has(hostname)) return Boolean(hostsCache.get(hostname));
+  let mapped = false;
+  try {
+    const file = process.platform === 'win32'
+      ? path.join(process.env.SystemRoot || 'C:\\Windows', 'System32', 'drivers', 'etc', 'hosts')
+      : '/etc/hosts';
+    const text = fs.readFileSync(file, 'utf8');
+    for (const line of text.split(/\r?\n/)) {
+      const clean = line.replace(/#.*/, '').trim();
+      if (!clean) continue;
+      const parts = clean.split(/\s+/);
+      const ip = parts[0];
+      if (!ip || !isPrivateHost(ip)) continue;
+      if (parts.slice(1).some((h) => h.toLowerCase() === hostname)) {
+        mapped = true;
+        break;
+      }
+    }
+  } catch {
+    mapped = false; // 无 /etc/hosts 或不可读：维持字面量判定
+  }
+  hostsCache.set(hostname, mapped);
+  return mapped;
+}
+
 export function isLocalBaseUrl(/** @type {any} */ baseUrl) {
   try {
     const u = new URL(String(baseUrl || ''));
     if (!u.hostname) return false;
-    return isPrivateHost(u.hostname);
+    const host = u.hostname.toLowerCase();
+    if (isPrivateHost(host)) return true;
+    // 自定义主机名（经 /etc/hosts 指向 127.0.0.1 等私网地址）复检；否则维持「远程」
+    return hostsMapsToPrivate(host);
   } catch {
     return false;
   }
@@ -41,7 +77,10 @@ export function resolveModelCaps(/** @type {any} */ cfg, /** @type {any} */ mode
   const preset = modelPreset(modelName);
   const cm = (cfg?.customModels || {})[modelName] || {};
   const baseUrl = cm.baseUrl || cfg?.baseUrl || '';
-  const isLocal = isLocalBaseUrl(baseUrl);
+  // 显式声明优先：customModels.<name>.local=true/isLocal=true 强制按本地模型处理（压缩/串行/超时走本地档），
+  // 覆盖 baseUrl 字面量/hosts 判定不到的场景（如经公网反代回本机、特殊主机名）。
+  const explicitLocal = cm.local === true || cm.isLocal === true;
+  const isLocal = explicitLocal || isLocalBaseUrl(baseUrl);
   const contextWindow =
     Number(cm.contextWindow) > 0
       ? Number(cm.contextWindow)

package/src/pricing.js

@@ -7,6 +7,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { modelPreset } from './models.js';
+import { atomicWriteFileSync } from './atomic-write.js';
 import { mingdaoHome } from './config.js';
 
 // 内置价格表的数据时点（定价可能调整，配置覆盖可随时更新）
@@ -63,7 +64,7 @@ export async function refreshPricingFromSource(cfg) {
   }
   const file = pricingFilePath();
   fs.mkdirSync(path.dirname(file), { recursive: true });
-  fs.writeFileSync(file, JSON.stringify({ fetchedAt: Date.now(), source: src, models }, null, 2));
+  atomicWriteFileSync(file, JSON.stringify({ fetchedAt: Date.now(), source: src, models }, null, 2));
   extCache = { mtime: -1, ttlDays: 7, data: null, stale: false };
   const names = Object.keys(models).join('、');
   return { ok: true, lines: ['✓ 价格表已刷新（' + names + '），TTL 内费用估算/护栏/避峰自动跟随'] };
@@ -214,6 +215,13 @@ function pricingOverrides() {
 /**
  * @param {any} modelName
  */
+// P0-4（v0.4.5）：判断模型是否有价格数据（内置定价或外部定价或 overrides）——
+// 无价模型 estimateCost 恒 0，费用护栏/仪表盘/分账静默失真，必须显式暴露给调用方告警。
+export function hasPricing(/** @type {any} */ modelName) {
+  return Boolean(modelName && effectivePricing(modelName));
+}
+
+/** @param {any} modelName */
 function effectivePricing(modelName) {
   const preset = modelPreset(modelName);
   const ext = externalPricing().data?.models?.[modelName] || null;
@@ -250,7 +258,9 @@ function effectivePricing(modelName) {
  */
 export function estimateCost(modelName, promptTokens, completionTokens, cache = null, date = new Date()) {
   const pricing = effectivePricing(modelName);
-  if (!pricing) return 0;
+  // P0-4（v0.4.5）：无价返 null 而非 0——0 与「未知」语义完全混淆（0 被当作「免费/没花钱」），
+  // 下游护栏/分账/仪表盘据此静默失真。返回 null 强制调用方显式区分「未知」与「免费（0）」（技术评估 P0-4）。
+  if (!pricing) return null;
   const price = isPeakHour(date) ? pricing.peak : pricing.offpeak;
   if (cache && Number.isFinite(cache.hit) && Number.isFinite(cache.miss)) {
     const hitPrice = price.cacheHit ?? 0;
@@ -268,10 +278,11 @@ export function estimateCost(modelName, promptTokens, completionTokens, cache =
  * @param {any} [usage]
  */
 export function estimateCostLabel(modelName, promptTokens, completionTokens, usage = null) {
-  const pricing = effectivePricing(modelName);
-  if (!pricing) return '';
   const cache = cacheSplit(usage);
-  const yuan = estimateCost(modelName, promptTokens, completionTokens, cache).toFixed(5);
+  const c = estimateCost(modelName, promptTokens, completionTokens, cache);
+  // P0-4（v0.4.5）：无价返 null → 标签置空（不显示「≈¥0.0000」冒充免费）
+  if (c == null) return '';
+  const yuan = c.toFixed(5);
   const hitPart =
     cache && cache.hit + cache.miss > 0 ? ` · 缓存命中 ${(cache.rate * 100).toFixed(0)}%` : ' · 未计缓存折扣';
   return ` ≈¥${yuan}（${isPeakHour() ? '高峰' : '闲时'}${hitPart}）${pricingDataStale() ? ' · ⚠ 价格表过期，运行 mingdao update --pricing 刷新' : ''}`;