mingdao-harness 0.4.4 → 0.4.6

package/skills-lib/performance/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: performance
+description: 性能分析与调优（定位瓶颈/基准/优化验证）
+---
+
+# 性能分析与调优
+
+程序慢、内存高、接口延迟大时使用。
+
+## 步骤
+
+1. 先测量再优化：明确指标（延迟/吞吐/内存）与基线数据。
+2. 定位瓶颈：按「CPU / IO / 网络 / 锁 / 内存」分类，用工具确认（top、profiler、日志耗时打点）。
+3. 按 80/20 原则只优化热点；每次只改一处，改后立即对比基线。
+4. 常见手段：缓存、批处理、索引、连接复用、异步化、减少序列化。
+
+## 检查点
+
+- 禁止无测量的「感觉优化」；优化前给出当前基线数字；
+- 优化可能引入正确性风险（缓存一致性等），注明并验证；
+- 环境因素（冷启动/网络抖动）要排除后再下结论。
+
+## 输出
+
+「基线 → 瓶颈定位（证据）→ 优化项（按收益排序）→ 优化后对比」。

package/skills-lib/python/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: python
+description: Python 编码规范与最佳实践
+---
+
+# Python 编码规范
+
+写/改/审查 Python 代码时使用。
+
+## 规则
+
+1. 风格遵循 PEP 8：4 空格缩进、行宽 ≤ 100、snake_case 命名。
+2. 类型注解：函数签名写参数与返回类型；用 `pathlib` 处理路径、`dataclasses` 代替裸字典。
+3. 现代语法：f-string 格式化、`with` 管理资源、异常只捕获具体类型（不裸 `except:`）。
+4. 结构：纯函数优先、依赖注入便于测试；副作用集中在入口处。
+5. 依赖：优先标准库；第三方包注明版本（pyproject.toml）。
+6. 环境：虚拟环境 + `pyproject.toml`，兼容性注明 Python 最低版本。
+
+## 检查点
+
+- 不混用制表符；字符串编码显式 UTF-8；
+- 可运行性优先：改动后给出运行/测试命令。
+
+## 输出
+
+代码 + 关键设计说明（为什么这样写）。

package/skills-lib/readme/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: readme
+description: README 写作（项目门面：安装/用法/特色）
+---
+
+# README 写作
+
+新建 README 或重写项目首页文档时使用。
+
+## 结构
+
+1. 项目名 + 一句话定位（解决什么问题、给谁用）。
+2. 特色列表：3–6 条最打动人心的亮点，不堆功能。
+3. 快速开始：安装 → 最小示例，5 分钟内跑通，命令真实可执行。
+4. 配置与常见用法、文档链接、贡献方式、许可证。
+5. 徽章与截图酌情添加；中文项目注意中英文间距与排版。
+
+## 检查点
+
+- 每个命令都实际验证过；版本号/链接与仓库一致；
+- 避免大段空话（「强大、易用」要有具体支撑）；长度以「读完能上手」为准。
+
+## 输出
+
+Markdown 全文 + 一句修改说明。

package/skills-lib/regex/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: regex
+description: 正则表达式编写、验证与性能注意
+---
+
+# 正则表达式
+
+编写、调试或优化正则时使用。
+
+## 步骤
+
+1. 明确目标字符串样例（含边界与反例），先列 3–5 个正例和反例。
+2. 选择风格：grep/awk 用 POSIX ERE，Python/JS 用 PCRE 风格，注明方言差异。
+3. 逐步构造：锚点（^ $ \b）→ 字符类 → 量词 → 分组/捕获，能不用回溯就不用。
+4. 用测试样例逐条验证；拿不准的边界（空串、换行、Unicode）单独测。
+
+## 检查点
+
+- 警惕灾难性回溯（嵌套量词如 `(a+)+`），给出安全替代写法；
+- 明确是否区分大小写、是否跨行匹配（m/s 标志）；
+- 替换场景注意捕获组顺序与 `$1` 含义。
+
+## 输出
+
+「正则 + 逐段解释 + 正反例测试结果 + 方言/标志说明」。

package/skills-lib/report/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: report
+description: 周报/月报/汇报总结写作（结构/亮点/数据）
+---
+
+# 周报与汇报写作
+
+写周报、月报、阶段总结或向上汇报材料时使用。
+
+## 规则
+
+1. 结构：本周成果（先说结论）→ 数据支撑 → 问题与风险 → 下周计划，篇幅按场合控制。
+2. 成果写法：动词 + 事项 + 进展/结果（完成/进行中 注明百分比），重点不超过 3 条。
+3. 数据优先：有数字用数字（「处理 32 个工单，平均 4 小时关闭」优于「高效处理工单」）。
+4. 问题透明：说风险必带「影响 + 建议方案 + 需要的支持」，不只有抱怨。
+5. 计划可验证：下周条目写成可检查的交付物，避免「继续推进」。
+
+## 检查点
+
+- 时间与事实核对无误；语气客观，不夸大不贬低；
+- 提供「详细版（给直属上级）+ 精简版（给大群/上级的上级）」。
+
+## 输出
+
+两版周报 + 一句核心亮点摘要。

package/skills-lib/resume/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: resume
+description: 简历优化（结构/量化/岗位匹配）
+---
+
+# 简历优化
+
+修改简历或针对岗位定制简历时使用。
+
+## 规则
+
+1. 结构：基本信息 → 个人优势（3 行）→ 工作/项目经历（倒序）→ 技能 → 教育，总量 1–2 页。
+2. 经历写法：动词开头 + 动作 + 方法 + 可量化结果（如「将接口耗时从 800ms 降到 120ms，支撑日活 10 万」），避免职责罗列。
+3. 岗位匹配：读 JD 提取关键词，经历按相关度重排，删除无关内容；一岗一版。
+4. 排版：统一字体/日期格式，无错别字（逐字检查），导出 PDF 前预览。
+
+## 检查点
+
+- 所有数字与事实真实，不确定的向用户确认，不编造；
+- 敏感信息（身份证/薪资/联系方式）按用户要求保留或脱敏。
+
+## 输出
+
+「修改后简历全文 + 修改点清单 + 针对该岗位的一句话匹配度分析」。

package/skills-lib/security-audit/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: security-audit
+description: 代码与配置安全审计
+---
+
+# 安全审计
+
+审查代码/依赖/配置的安全风险时使用。
+
+## 步骤
+
+1. 列出攻击面：外部输入入口、网络请求、文件读写、命令执行、认证与密钥。
+2. 逐类检查：
+   - 注入：SQL/命令/路径注入，用户输入是否拼接进查询或 shell；
+   - 密钥：硬编码 key/token/password（`grep -rE 'sk-[A-Za-z0-9]{20,}|password\s*=' .`）；
+   - 依赖：已知漏洞版本、不必要的运行时依赖；
+   - 文件与权限：路径穿越、敏感文件权限（600）、上传校验；
+   - 传输与加密：明文 HTTP 传敏感数据、弱哈希（MD5/SHA1 用于口令）。
+3. 按「严重/高/中/低」分级，每项给出复现路径与修复方案。
+
+## 检查点
+
+- 只审计不直接修改，修复等用户确认（紧急项明确标出）；
+- 不把密钥内容写进输出，发现时用脱敏形式提示。
+
+## 输出
+
+「风险清单表格（级别/位置/问题/修复）+ 总体结论」。

package/skills-lib/sql/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: sql
+description: SQL 编写、审查与性能优化
+---
+
+# SQL 编写与优化
+
+写查询、审查现有 SQL、排查慢查询时使用。
+
+## 步骤
+
+1. 确认数据库方言（MySQL 8 / PostgreSQL / SQLite 等），先看表结构（`DESCRIBE` / `\d` 或读 schema 文件）。
+2. 写查询：显式列名（避免 `SELECT *`）、JOIN 条件明确、NULL 语义想清楚。
+3. 优化：先看 `EXPLAIN`，检查全表扫描、缺失索引、隐式类型转换；大分页用游标/键集分页替代深 `OFFSET`。
+4. 防注入：拼接参数一律用绑定变量/参数化查询。
+
+## 检查点
+
+- 预估数据量级，注明是否适用；无法确认表结构时先询问用户；
+- 写操作（UPDATE/DELETE）先给出 WHERE 影响范围，默认建议先 SELECT 验证；
+- 迁移类语句给出回滚语句。
+
+## 输出
+
+「SQL 语句（带注释）+ 为什么这样写 + 性能注意点」。

package/skills-lib/translation/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: translation
+description: 中英互译（术语一致/语气适配/本地化质量）
+---
+
+# 中英互译
+
+翻译技术文档、产品文案或校对译文时使用。
+
+## 规则
+
+1. 先通读全文定基调：技术文档准确优先、营销文案感染力优先、界面文案简洁优先。
+2. 术语统一：同一概念全文同一译法；专有名词（产品名/协议名）保留原文；首次出现可加注。
+3. 避免直译：拆长句、调整语序，中文忌欧化句式（过多「的/被/进行」），英文忌中式堆砌。
+4. 格式保留：Markdown 标记、代码块、链接、占位符 `{var}` 原样保留不翻译。
+5. 校对：译文独立通读一遍（不看原文），检查数字/单位/日期格式本地化。
+
+## 检查点
+
+- 代码、命令、API 名称不翻译；歧义处标注并给出备选译法；
+- 输出「译文 + 关键术语对照表 + 处理说明」。
+
+## 输出
+
+译文 + 术语表 + 一句校对说明。

package/src/agent.js

@@ -23,11 +23,16 @@ const MAX_STEPS = 24;
 // 提到与主循环一致（24），只读子任务每步是 read/grep（输入便宜、无输出 token），成本增量可忽略。
 const SUBAGENT_MAX_STEPS = 24;
 
+// 只读档工具集（省钱 B1 的「只读阶段」）——模块级单一来源。
+// v0.4.6：此前 test/bench 各自维护一份副本，已经漂移（漏了 v0.4.4 加入的 task），
+// 导致基准测的不是真实只读档。导出后基准与实现共用同一集合。
+export const READONLY_TIER_SET = new Set(['read', 'ls', 'glob', 'grep', 'skill', 'todo', 'git', 'fetch', 'task']);
+
 /**
  * 创建 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,
- *   onUsage?: (usage: any) => void }} params
+ *   onUsage?: (modelName: string, usage: any) => void }} params
  */
 export function createAgent({ provider, permission, io, modelName, workingDir, cfg = {}, undoStore, maxSteps, mcp, onCompact, sessionRef, onUsage }) {
   const preset = modelPreset(modelName) || {};
@@ -39,7 +44,13 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
   const budget = safeBudget(cfg, caps);
   // maxOutput 也按窗口封顶：显式配超大 maxOutputTokens 时，prompt(预算)+output 仍不得越过窗口
   // （预算已按 caps.maxOutputTokens 留余量，但显式值可能更大——此处兜底，防服务端截断/拒绝）
-  const maxOutput = Math.min(cfg.maxOutputTokens || caps.maxOutputTokens, Math.max(1024, caps.contextWindow - budget));
+  const maxOutput = Math.min(
+    cfg.maxOutputTokens || caps.maxOutputTokens,
+    // v0.4.6：显式 maxOutputTokens 也要受官方单次输出规格（maxOutputCeiling，DeepSeek 384K）约束——
+    // 该字段此前只定义不生效，README 的「单次输出上限 384K」实际拿不到。
+    caps.maxOutputCeiling || Number.MAX_SAFE_INTEGER,
+    Math.max(1024, caps.contextWindow - budget)
+  );
   // v0.3.2 工具输出截断自适应：窗口越小截得越狠（单条工具结果按窗口 1/16 封顶，最少 2000 字），
   // 但绝不超过旧默认 20000（大窗口模型如 1M 不因公式放大回灌、不推高成本）。
   // 本地小模型（32k 窗口 → 2k 字）不再把大段代码/日志整条回灌，省 prompt 且不撑爆窗口。
@@ -48,6 +59,11 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
   const reasoningEffort = cfg.reasoningByModel?.[modelName] ?? cfg.reasoningEffort ?? preset.reasoningEffort?.default ?? undefined;
   const hooks = createHooks(cfg.hooks, workingDir, cfg);
   const todos = /** @type {any[]} */ ([]);
+  // v0.4.6 修复：当前 runTurn 的 usage 累加器引用——spawnTask 定义在 runTurn 之外，
+  // 此前子代理的 token 消耗只用于生成汇报文本、从不并入父回合 usage，导致「今日费用」系统性少计
+  // （CLI/REPL 每次派子代理都漏计；README 主推的「多方向并行调研」场景漏计最重）。
+  // runTurn 开始时指向本轮 usage，finally 清空；runTurn 之外调用 spawnTask 时为 null（安全跳过）。
+  let currentUsage = /** @type {any} */ (null);
   // 会话级共享：调用方传入则复用（/model 切换、子代理均共享，undo 不丢失）
   const undo = undoStore || { backups: new Map() };
   const stepLimit = maxSteps || MAX_STEPS;
@@ -64,7 +80,7 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
   // + 已用过的工具；检测到写意图（用户消息或模型明说需要写/改/建）后注入全量工具。
   // v0.4.4：加 task——审计/调研等只读长任务此前因 task 不在只读档而看不到「派只读子代理」能力
   // （readOnly 子代理只读，权限引擎仍门控写操作，无越权）。
-  const READONLY_TIER_SET = new Set(['read', 'ls', 'glob', 'grep', 'skill', 'todo', 'git', 'fetch', 'task']);
+  // 只读档工具集：单一来源见模块顶部导出的 READONLY_TIER_SET
   // 中英双语写意图（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 || ''));
@@ -112,6 +128,8 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
       maxSteps: SUBAGENT_MAX_STEPS,
       mcp,
       sessionRef, // 子代理的审计记录归入主会话
+      // 注意：这里**不**透传 onUsage。子代理的消耗改为在下方 runTurn 返回后一次性并入父回合 usage
+      // （v0.4.6）。若同时透传 onUsage 又并入总量，WebUI 会对子代理已逐轮入账的部分重复计费。
     });
     const sys =
       `你是主智能体 MingDao 派出的子代理，独立完成一项子任务。` +
@@ -126,6 +144,20 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
     const t0 = Date.now();
     const res = await subAgent.runTurn(messages);
     const ms = Date.now() - t0;
+    // v0.4.6 P1 修复：子代理 token 消耗并入父回合 usage（缓存命中/未命中字段一并累加）——
+    // 否则子代理完全不计费：CLI/REPL（无 onUsage）恒漏计；WebUI 仅在子代理跨轮时偶发计入。
+    // 并入后父回合 res.usage 即「真总量」，护栏在途估算、分账、今日费用同时变准。
+    if (currentUsage && res?.usage) {
+      const u = res.usage;
+      currentUsage.prompt_tokens += u.prompt_tokens || 0;
+      currentUsage.completion_tokens += u.completion_tokens || 0;
+      if (Number.isFinite(u.prompt_cache_hit_tokens)) {
+        currentUsage.prompt_cache_hit_tokens = (currentUsage.prompt_cache_hit_tokens || 0) + u.prompt_cache_hit_tokens;
+      }
+      if (Number.isFinite(u.prompt_cache_miss_tokens)) {
+        currentUsage.prompt_cache_miss_tokens = (currentUsage.prompt_cache_miss_tokens || 0) + u.prompt_cache_miss_tokens;
+      }
+    }
     // v0.4.1：子代理空输出给主线程可用的失败信号（含 note 原因），而非笼统「无输出」——
     // 主智能体据此决定是否重试/换法，而非把子代理静默当作「已完成但没说话」。
     const text =
@@ -160,11 +192,16 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
     const maxRounds = Math.max(1, Number(cfg.maxRounds) || 3);
     let round = 0;
     const usage = /** @type {{ prompt_tokens: number, completion_tokens: number, prompt_cache_hit_tokens?: number, prompt_cache_miss_tokens?: number }} */ ({ prompt_tokens: 0, completion_tokens: 0 });
+    currentUsage = usage; // 子代理消耗并入本回合总量（见 spawnTask）
     const startedAt = Date.now();
     // 回合性能指标（状态栏：LLM 时长 / 工具时长 / 首 token 延迟 / 步数）
     let llmMsTotal = 0;
     let toolMsTotal = 0;
     let firstTokenAt = /** @type {any} */ (null);
+    // v0.4.6：记录最近一次模型请求的**发起**时刻——峰谷单价必须按发起时刻判定。
+    // 此前 recordUsage 在响应落地后用 new Date() 计价，跨 12:00/18:00 边界的请求会错记一档
+    // （1M prompt 的 pro 调用是 ¥9 vs ¥4.5 的差别）。
+    let lastRequestStartAt = /** @type {any} */ (null);
     // 省钱 B3（费用二级分账）：推理 token 估算（按增量累计）与逐工具调用/耗时累加
     let reasoningTokens = 0;
     const toolStats = /** @type {Map<string, {calls: number, ms: number}>} */ (new Map());
@@ -177,6 +214,7 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
       reasoningTokens,
       toolStats: [...toolStats.entries()].map(([tool, s]) => ({ tool, calls: s.calls, ms: s.ms })),
       usedModel: activeModel, // 省钱 B4：本回合实际使用模型（降级后归属它）
+      requestStartAt: lastRequestStartAt, // v0.4.6：峰谷计价锚点（请求发起时刻，非落账时刻）
       deliverables: [...deliverables], // v0.3.1：CLI/REPL 续跑检查点复用（此前 artifacts 恒空）
     });
     let aborted = false;
@@ -194,7 +232,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 可关。
@@ -221,6 +262,16 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
     // v0.4.1 P1 修复：turnToolCache 必须声明在 while 之外、for 轮内——此前在 while 体内每步重建，
     // 去重只在本步的多个工具调用间生效，跨步（如先 grep 定位再 read 确认同一文件）完全失效。
     const turnToolCache = new Map();
+    // v0.4.6 P1 修复：有副作用的工具一旦执行，本回合的只读去重缓存必须整片作废。
+    // v0.4.1 把 turnToolCache 提到 for 轮内，让去重跨步生效（评估 A4），却没有失效点——
+    // 同回合「read a → write a → read a」的第 3 步会命中第 1 步缓存，模型拿到写入前的内容、
+    // 误判写入未生效，进而重复写入或得出错误结论（已实测复现）。只读工具与 task(readOnly)
+    // 不改变文件状态，缓存保留（去重收益不受影响）。
+    const invalidateReadCache = (/** @type {any} */ prep) => {
+      if (!prep.isMcp && READONLY_TOOLS_SET.has(prep.name)) return;
+      if (prep.name === 'task' && prep.args?.readOnly === true) return;
+      turnToolCache.clear();
+    };
     for (round = 0; round < maxRounds; round++) {
       steps = 0;
       // v0.4.4：每轮结束回调本轮增量 usage（长任务费用逐轮入账——此前只在 runTurn 全结束后才
@@ -305,8 +356,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 {
@@ -321,7 +373,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();
@@ -381,6 +433,7 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
       // 审计（tsc 扩面发现）：llmT0 此前在 try 内声明、catch 内引用——chat 抛错时
       // catch 自身 ReferenceError，掩盖原始错误且计时丢失；提到 try 外声明。
       const llmT0 = Date.now();
+      lastRequestStartAt = llmT0;
       try {
         res = await provider.chat({
           model: activeModel,
@@ -410,6 +463,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;
       }
 
@@ -523,6 +594,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);
@@ -558,9 +632,12 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
             } else {
               result = await dispatch(prep.name, prep.args, ctx);
             }
+            invalidateReadCache(prep); // 有副作用 → 作废本回合只读缓存（写后再读必须看到新内容）
             if (dedupKey) turnToolCache.set(dedupKey, result);
             return result;
           } catch (/** @type {any} */ err) {
+            // 失败也可能已产生副作用（半写入/部分执行）→ 同样作废缓存
+            invalidateReadCache(prep);
             return JSON.stringify({ ok: false, error: String(err?.message || err) });
           }
         }
@@ -740,9 +817,10 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
     }
     // v0.3.1 自动续跑（长程执行）：还有剩余轮次且未中断 → 注入进度摘要直接续跑，不落收尾总结
     if (round < maxRounds - 1 && !aborted) {
-      // 每轮结束：回调本轮增量 usage（含缓存命中拆分），供调用方逐轮入账
+      // 每轮结束：回调本轮增量 usage（含缓存命中拆分），供调用方逐轮入账。activeModel 为本轮实际模型
+      // （护栏降级/子代理都据此正确归属——P2-5 模型名一致性 + P1-5 子代理费用入账）。
       try {
-        onUsage?.({
+        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,
@@ -776,6 +854,12 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
           { role: 'user', content: '（系统提示）任务已执行完毕。请用一段话总结刚才完成的工作，列出交付物（文件路径），并说明遗留问题与后续建议。' },
         ];
         currentAc = new AbortController();
+        lastRequestStartAt = Date.now();
+        // v0.4.6 P1 修复：进入兜底总结前本回合已多次 io.endTurn()（步数上限分支），TUI 的 renderer
+        // 已被置空，而 onDelta → io.writeText 只做 `renderer?.push(...)`——总结文本被静默丢弃，
+        // 跑满 24 步的长任务（审计/重构/调研）在终端里只看到一屏工具调用、没有最终答复。
+        // 重新 beginTurn() 开一个渲染段（web-io 的 beginTurn 是空实现，不受影响）。
+        io.beginTurn();
         const wrapRes = await provider.chat({
           model: activeModel,
           messages: wrapReq,
@@ -788,6 +872,7 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
             if (d.text) io.writeText(d.text);
           },
         });
+        io.endTurn(); // 收尾：flush 流式渲染段（与正常 turn 一致）
         if (wrapRes.usage) {
           usage.prompt_tokens += wrapRes.usage.prompt_tokens || 0;
           usage.completion_tokens += wrapRes.usage.completion_tokens || 0;
@@ -812,6 +897,7 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
       throw err;
     } finally {
       currentAc = null;
+      currentUsage = null; // 回合结束：避免 runTurn 之外调用的 spawnTask 写入陈旧累加器
       offSigint();
     }
   }

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

@@ -7,8 +7,26 @@
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
+import { spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 
+// v0.4.6 P2 修复：自启命令必须用**绝对路径**。
+// 三个平台原先都只写命令名（`mingdao web 3820`）。在 macOS 上这是必然失败：launchd 给 agent 的
+// 是一个极简环境（PATH=/usr/bin:/bin:/usr/sbin:/sbin，不读登录 shell 配置），而 mingdao 常装在
+// /usr/local/bin、~/.local/bin 或 nvm 目录 —— 实测 `env -i PATH=… command -v mingdao` 找不到，
+// 登录后只会把 "command not found" 写进 StandardErrorPath，WebUI 静默不自启。
+// 现用 process.execPath（node 绝对路径）+ src/cli.js 绝对路径，彻底不依赖 PATH。
+function cliEntry() {
+  try {
+    return fileURLToPath(new URL('./cli.js', import.meta.url));
+  } catch {
+    return path.join(process.cwd(), 'src', 'cli.js');
+  }
+}
+function nodeBin() {
+  return process.execPath || 'node';
+}
+
 function linuxFile() {
   return path.join(os.homedir(), '.config', 'autostart', 'mingdao-web.desktop');
 }
@@ -36,26 +54,36 @@ export function enableAutostart() {
   const target = autostartPath();
   try {
     fs.mkdirSync(path.dirname(target), { recursive: true });
+    const node = nodeBin();
+    const cli = cliEntry();
     if (process.platform === 'win32') {
-      fs.writeFileSync(target, '@echo off\r\nstart "" cmd /c "mingdao web 3820"\r\n');
+      fs.writeFileSync(target, `@echo off\r\nstart "" "${node}" "${cli}" web 3820\r\n`);
     } else if (process.platform === 'darwin') {
       const plist = `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0"><dict>
   <key>Label</key><string>org.mingdao.web</string>
   <key>ProgramArguments</key><array>
-    <string>/bin/sh</string><string>-c</string><string>mingdao web 3820</string>
+    <string>${node}</string><string>${cli}</string><string>web</string><string>3820</string>
   </array>
   <key>RunAtLoad</key><true/>
+  <key>EnvironmentVariables</key><dict>
+    <key>PATH</key><string>${path.dirname(node)}:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin</string>
+  </dict>
   <key>StandardOutPath</key><string>/tmp/mingdao-web.log</string>
   <key>StandardErrorPath</key><string>/tmp/mingdao-web.err</string>
 </dict></plist>
 `;
       fs.writeFileSync(target, plist);
+      // 立即注册（否则要等下次登录才生效，用户以为开关没起作用）。失败不致命：
+      // 文件已落盘，下次登录仍会由 RunAtLoad 拉起。
+      try {
+        spawnSync('launchctl', ['bootstrap', `gui/${process.getuid?.() ?? 0}`, target], { stdio: 'ignore' });
+      } catch {}
     } else {
       fs.writeFileSync(
         target,
-        '[Desktop Entry]\nType=Application\nName=MingDao 自动启动\nComment=MingDao-Harness WebUI 服务器（登录时启动）\nExec=sh -c \'mingdao web 3820 >/dev/null 2>&1\'\nX-GNOME-Autostart-enabled=true\nHidden=false\n'
+        `[Desktop Entry]\nType=Application\nName=MingDao 自动启动\nComment=MingDao-Harness WebUI 服务器（登录时启动）\nExec="${node}" "${cli}" web 3820\nX-GNOME-Autostart-enabled=true\nHidden=false\n`
       );
     }
     return true;
@@ -66,6 +94,12 @@ export function enableAutostart() {
 
 export function disableAutostart() {
   try {
+    if (process.platform === 'darwin') {
+      // 已 bootstrap 的 agent 必须 bootout 才真正停用（仅删 plist 不影响本次会话）
+      try {
+        spawnSync('launchctl', ['bootout', `gui/${process.getuid?.() ?? 0}/org.mingdao.web`], { stdio: 'ignore' });
+      } catch {}
+    }
     if (fs.existsSync(autostartPath())) fs.unlinkSync(autostartPath());
     return true;
   } catch {

package/src/batch.js

@@ -134,11 +134,19 @@ export async function runBatch({ cfg, model, questions, workingDir = process.cwd
   }
 
   // —— 省钱 B2：--max-cost 预算上限（提交前估算拦截）——
-  let estimatedCost = 0;
+  let estimatedCost = /** @type {number|null} */ (0);
   if (maxCost > 0) {
     const estPrompt = unique.reduce((s, q) => s + sysTokens + approxTokens(q), 0);
     const estCompletion = unique.length * Math.min(maxTokens, 2048); // 保守按平均 2K 输出估算
     estimatedCost = estimateBatchCost(model, estPrompt, estCompletion);
+    // v0.4.6：无价模型估算为 null（未知）——--max-cost 是「预算保障」，未知即无法保障，
+    // 必须 fail-closed 中止提交；此前 null 被当 0、拦截恒不触发（与 P0-4 同类静默失效）。
+    if (estimatedCost == null) {
+      return {
+        error: `模型 ${model} 没有价格数据，无法估算 Batch 费用，--max-cost 预算保障失效，已中止提交。请先在 config.pricing.overrides 配置该模型价格，或去掉 --max-cost（自行承担预算风险）后重试。`,
+        estimatedCost: null,
+      };
+    }
     if (estimatedCost > maxCost) {
       return {
         error: `预计费用 ≈¥${estimatedCost.toFixed(4)}（已按半价）超过 --max-cost ¥${maxCost}，已中止提交。可缩小问题集或调高上限。`,