mingdao-harness 0.2.2 → 0.2.4

package/docs/ROADMAP-NEXT.md

@@ -26,15 +26,15 @@
 9. cli.js 共享助手抽取（offpeak defer、mcpFacade 构建、run/run-worker 参数解析合一）
 - 验收：全绿 + 新增 fs-browse 越界与限流回归断言。
 
-### Phase B「省钱第二轮」v0.2.3（约 2–3 天）
-1. **工具 Schema 按需挂载**（每请求省 1–2K tokens）：只读阶段只发 read/ls/glob/grep/skill + 本回合已用工具；写类工具首次调用时动态注入
-2. **Batch 输入侧**：文本哈希去重（结果按 custom_id 回填全部位置）、单问超窗口预检报错、`--max-cost` 上限
-3. **费用二级分账 + 看板**：cache-stats 增 reasoning/tool 维度与 byTool 累加；WebUI 仪表盘加模型/工具 Top5 与按天折线（零依赖 SVG）
-4. **护栏 downgrade**：`action:'downgrade'` —— 触顶后自动切 flash + 明确提示（默认仍 warn/block 可选）
-5. **评测基准扩充**：压缩质量集（5 组长会话样本→压缩→关键事实追问断言）、路由 100 条标注集入 bench
-- 验收：bench 断言数 38→60+；覆盖率阈值上调至 60%。
-
-### Phase C「结构渐进」v0.2.4（约 2 天）
+### Phase B「省钱第二轮」v0.2.4（已完成 ✅）
+1. ✅ **工具 Schema 按需挂载**：只读阶段只发 read/ls/glob/grep/skill/todo + 已用工具；模型表达写意图后下一轮注入全量（`cfg.schemaTier=false` 可关）；已用工具深度瘦身（工具级 + 参数级描述清除，全用过降 48%）
+2. ✅ **Batch 输入侧**：文本哈希去重（结果按 custom_id 回填全部位置）、单问超窗口预检报错、`--max-cost` 提交前估算拦截
+3. ✅ **费用二级分账 + 看板**：cache-stats 增 reasoning / byTool 维度；WebUI 仪表盘加模型/工具 Top5 与近 14 天费用折线（零依赖 SVG）；`mingdao cost report` 增按工具分账表
+4. ✅ **护栏 downgrade**：`action:'downgrade'` —— 触顶后自动切 flash 继续执行 + 明确提示（warn/block 仍可选；已是 flash 则按 block 处理）
+5. ✅ **评测基准扩充**：压缩质量集（5 组长会话样本 → 压缩 → 关键事实存活断言 + 尾部字节不变）、路由标注集扩至 100 条；bench 断言数 38 → 150+；覆盖率阈值 55% → 60%
+- 版本说明：v0.2.3 被 0.2.2 桌面启动崩溃的紧急修复占用，Phase B 顺延为 v0.2.4。
+
+### Phase C「结构渐进」v0.2.5（约 2 天）
 1. routes/api.js 按域细分（config/sessions/sync/schedule/skills/workspace/misc 7 模块 + 共享中间件），每域配 API 契约测试
 2. cli.js REPL → commands/repl.js、worker → tasks/worker.js（e2e-local 16 项全绿做护栏）
 3. strict 棘轮削 300 条（先 credentials/permissions/config/sync-server/session 五个安全关键模块全量注解）
@@ -44,10 +44,12 @@
 1. **跨平台沙箱补位**：Windows Job Object + 降权 token（零依赖原生 API）、macOS seatbelt 规则；敏感命令平台无关拦截清单兜底
 2. **记忆语义检索**：零依赖实现（内存向量 + 余弦/哈希相似度；Node 22 可用 node:sqlite 持久化，Node 18 回退 JSONL 索引），记忆注入从「最近 3 条」升级为「相关 3 条」
 3. **WebUI 看板扩展**：预算燃尽预测、费用导出 CSV
-4. GitHub Release 附件自动清理（如你提供 PAT）+ 发布清单文档化
+4. GitHub Release 附件自动清理 + 发布清单文档化
 
-## 需要你拍板的三件事
+## 已落地（本轮 Phase D 部分项提前完成）
+- **GitHub Release 附件自动清理（PAT 已接入）**：新增 `scripts/github-release-cleanup.mjs`——官网同步（收割 + sha512 MATCH 校验）后删除 Release 上的全部构建转运附件，只留指向官网的正文。用法：`MINGDAO_GITHUB_TOKEN=<PAT> node scripts/github-release-cleanup.mjs <版本号> [--dry-run]`。token 存本地 gitignored `.env`（`MINGDAO_GITHUB_TOKEN`，模式 600），不入库。验证：v0.2.2 官网同步后已清理 9 个附件，官网下载不受影响。
 
-1. **Phase 顺序**：A→B→C→D 直接推进，还是把 B（省钱）提前到 A 之前？
-2. **GitHub PAT**：是否提供（用于 Release 附件自动清理与发版自动化）？
-3. **Phase D 裁剪**：跨平台沙箱与语义检索是否都进 0.3.0，还是只做其一？
+## 需要你拍板的事
+
+1. **Phase 顺序**：A→B→C→D 直接推进，还是把 B（省钱）提前到 A 之前？（PAT 已到位，Phase D 附件清理已基本完成）
+2. **Phase D 裁剪**：跨平台沙箱与语义检索是否都进 0.3.0，还是只做其一？

package/package.json

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

package/skills/release-checklist/SKILL.md

@@ -11,9 +11,22 @@ description: 准备发布新版本、打包交付前使用
 2. **版本**：版本号统一（package.json / 配置 / 文档互相一致），遵循语义化版本。
 3. **变更说明**：changelog 用用户语言描述新增/修复/破坏性变更。
 4. **构建验证**：实际构建/打包一次，并在干净环境验证产物可安装可运行。
-5. **敏感信息**：密钥、token、内网地址、个人信息不得进入仓库与产物（`grep -rE 'sk-[A-Za-z0-9]{20,}' .`）。
-6. **回滚方案**：明确如何回退到上一版本（旧包/旧 tag 可恢复）。
-7. **发布后冒烟**：发布完成后立即做一次端到端验证。
+5. **桌面版打包冒烟（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. **发布后冒烟**：发布完成后立即做一次端到端验证。
+
+## 桌面版发布流水线（官网分发 + 镜像 + 转运附件回收）
+
+1. `npm version <v>`（preversion 自动跑 smoke/e2e/bench，version 钩子自动插 changelog，postversion 自动提交）→ 推 3 远端 + tag。
+2. `npm publish` → GitHub desktop.yml CI 全绿（含打包冒烟）。
+3. 服务器收割：`/tmp/harvest-<ver>.sh`（下载 7 安装包 + 2 yml，sha512 交叉校验 MATCH，再生成官网 3 份 feed）。
+4. 官网 site/index.html 刷新版本/大小/sha256 校验行并部署；BBS 随 deploy.sh 重启。
+5. gitee/gitcode 创建 Release（正文指向官网，无附件）。
+6. 官网同步确认后：`MINGDAO_GITHUB_TOKEN=<PAT> node scripts/github-release-cleanup.mjs <版本号>` 删除 GitHub 转运附件（先 --dry-run）。
 
 ## 输出
 

package/src/agent.js

@@ -2,9 +2,9 @@
 // → PostToolUse 钩子 → 结果回填 → 循环，直到模型给出纯文本回复。
 // 附带：子代理（task 工具）、todo 清单状态、undo 备份仓、Ctrl+C 中断。
 
-import { trimMessages, clampText, messageTokens } from './context.js';
+import { trimMessages, clampText, messageTokens, approxTokens } from './context.js';
 import { compactConversation } from './compact.js';
-import { toolSchemas, dispatch } from './tools/index.js';
+import { buildToolSchemas, dispatch } from './tools/index.js';
 import { modelPreset } from './models.js';
 import { makeTokenCounter } from './tokenizer.js';
 import { createHooks } from './hooks.js';
@@ -39,6 +39,25 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
   const count = makeTokenCounter(modelName);
   // MCP 工具集（每次取，服务器晚就绪也能在后续轮次出现）
   const mcpSchemas = () => (mcp ? mcp.toolSchemas() : []);
+  // 省钱 B1：本会话已调用过的工具名（内置名/MCP 前缀名）——其 schema 在后续轮次省略 description，
+  // 模型已在消息历史里见过用途；未用过的保留完整描述。省输入 token（工具 schema 按需瘦身）。
+  const usedToolNames = new Set();
+  // 省钱 B1（按需挂载）：回合起始为「只读阶段」时只发只读工具（read/ls/glob/grep/skill/todo）
+  // + 已用过的工具；检测到写意图（用户消息或模型明说需要写/改/建）后注入全量工具。
+  const READONLY_TIER_SET = new Set(['read', 'ls', 'glob', 'grep', 'skill', 'todo']);
+  const WRITE_INTENT_RE = /写|建|创|改|修|删|装|加|添|增|补|换|移|部署|执行|运行|实现|重构|生成|迁移|安装|更新|升级|发布|调整|优化|修复|提交|推送|打包|编译|测试/;
+  const hasWriteIntent = (/** @type {any} */ text) => WRITE_INTENT_RE.test(String(text || ''));
+  const toolsFor = (/** @type {boolean} */ readOnlyPhase) => {
+    const schemas = buildToolSchemas(usedToolNames, mcpSchemas());
+    if (!readOnlyPhase) return schemas;
+    return schemas.filter((/** @type {any} */ t) => {
+      const n = t?.function?.name;
+      if (!n) return true;
+      if (READONLY_TIER_SET.has(n) || usedToolNames.has(n)) return true;
+      if (n.startsWith('mcp__')) return mcp ? mcp.isReadonly(n) : false;
+      return false;
+    });
+  };
 
   // 子代理：全新上下文 + 同一 Provider/权限（提示带「子任务」标记），独立完成子任务后汇报
   async function spawnTask(prompt, { description = '', readOnly = false } = {}) {
@@ -104,10 +123,34 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
     let llmMsTotal = 0;
     let toolMsTotal = 0;
     let firstTokenAt = null;
-    const perf = () => ({ llmMs: llmMsTotal, toolMs: toolMsTotal, firstTokenMs: firstTokenAt == null ? null : firstTokenAt - startedAt, steps });
+    // 省钱 B3（费用二级分账）：推理 token 估算（按增量累计）与逐工具调用/耗时累加
+    let reasoningTokens = 0;
+    const toolStats = /** @type {Map<string, {calls: number, ms: number}>} */ (new Map());
+    const perf = () => ({
+      llmMs: llmMsTotal,
+      toolMs: toolMsTotal,
+      firstTokenMs: firstTokenAt == null ? null : firstTokenAt - startedAt,
+      steps,
+      reasoningTokens,
+      toolStats: [...toolStats.entries()].map(([tool, s]) => ({ tool, calls: s.calls, ms: s.ms })),
+      usedModel: activeModel, // 省钱 B4：本回合实际使用模型（降级后归属它）
+    });
     let aborted = false;
     let emptyRounds = 0; // 连续空/截断输出计数（防止无限续写）
     let currentAc = null;
+    // 省钱 B4（护栏降级）：action='downgrade' 超限后本回合切换到便宜模型继续执行；
+    // activeModel 是本回合实际使用的模型（分账/记录归属它），downgraded 保证只提示一次。
+    let activeModel = modelName;
+    let downgraded = false;
+    // 省钱 B1：本回合只读阶段判定——最新用户消息无写意图则先只发只读工具，
+    // 模型明确表达写意图后（下一轮）注入全量。cfg.schemaTier=false 可关。
+    let readOnlyPhase = true;
+    if (cfg.schemaTier !== false) {
+      const lastUser = [...messages].reverse().find((m) => m?.role === 'user');
+      readOnlyPhase = !hasWriteIntent(lastUser?.content);
+    } else {
+      readOnlyPhase = false;
+    }
     // 整个回合注册一次 SIGINT：思考、工具执行、权限询问期间都能中断
     const offSigint = io.onSigint ? io.onSigint(() => { aborted = true; currentAc?.abort(); }) : () => {};
     const ctx = makeCtx();
@@ -168,13 +211,14 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
 
       // 护栏前置预估（Kimi P2-E）：发送前按本轮最坏成本估算（trimmed prompt × 未命中输入价
       // + maxOutput × 输出价，峰谷按当前时段）；「今日已用 + 最坏成本」超上限时发送前拦截，
-      // 而不是等 200K 上下文的贵请求发出后才 block。
+      // 而不是等 200K 上下文的贵请求发出后才 block。action='downgrade'（省钱 B4）不在此拦截——
+      // 由降级流程接管：切到便宜模型后按 flash 价格重新估算，通常即可放行。
       if (cfg.costGuard) {
         const g = costGuardConfig();
-        if (g && Number(g.dailyLimitYuan) > 0) {
+        if (g && Number(g.dailyLimitYuan) > 0 && g.action !== 'downgrade') {
           let promptTokens = 0;
           for (const m of sanitized) promptTokens += messageTokens(m, count);
-          const worst = estimateCost(modelName, promptTokens, maxOutput, null, new Date());
+          const worst = estimateCost(activeModel, promptTokens, maxOutput, null, new Date());
           const used = todayCost();
           if (used + worst >= Number(g.dailyLimitYuan)) {
             stripOrphanCalls();
@@ -187,7 +231,8 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
         }
       }
 
-      // 费用护栏（A2）：每轮开始前按今日实际费用检查；block 时暂停本轮并明确告知
+      // 费用护栏（A2/B4）：每轮开始前按今日实际费用检查；block 暂停本轮；
+      // downgrade 自动切换便宜模型继续执行（每回合只切一次，切换即粘滞）
       if (cfg.costGuard) {
         const guard = checkCostGuard();
         if (guard) {
@@ -206,7 +251,23 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
               perf: perf(),
             };
           }
-          io.print(style(guard.message, C.yellow));
+          if (guard.downgrade && !downgraded) {
+            if (guard.downgradeModel !== activeModel) {
+              activeModel = guard.downgradeModel;
+              downgraded = true;
+              io.print(style(guard.message, C.yellow));
+            } else {
+              // 已经是降级目标模型：无法再降，按 block 处理
+              stripOrphanCalls();
+              return {
+                text: null, reasoning: '', usage, steps, finish, truncated: false, aborted: false,
+                note: `今日费用已达上限（实际 ¥${String(todayCost().toFixed(4))}），且已在最便宜模型上执行，已暂停——调整 config.costGuard 或明天自动恢复。`,
+                durationMs: Date.now() - startedAt, perf: perf(),
+              };
+            }
+          } else if (!guard.downgrade) {
+            io.print(style(guard.message, C.yellow));
+          }
         }
       }
 
@@ -221,9 +282,9 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
       const llmT0 = Date.now();
       try {
         res = await provider.chat({
-          model: modelName,
+          model: activeModel,
           messages: sanitized,
-          tools: [...toolSchemas(), ...mcpSchemas()],
+          tools: toolsFor(readOnlyPhase),
           temperature,
           maxTokens: maxOutput,
           reasoningEffort,
@@ -232,7 +293,10 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
             io.stopSpinner();
             if (firstTokenAt == null) firstTokenAt = Date.now(); // 首个增量即首 token
             if (d.text) io.writeText(d.text);
-            if (d.reasoning) io.writeReasoning(d.reasoning);
+            if (d.reasoning) {
+              reasoningTokens += approxTokens(d.reasoning); // 省钱 B3：推理 token 估算（分账维度）
+              io.writeReasoning(d.reasoning);
+            }
           },
         });
         llmMsTotal += Date.now() - llmT0;
@@ -248,6 +312,8 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
       }
 
       finish = res.finish ?? finish;
+      // 省钱 B1：只读阶段中模型文字明确表达写意图 → 下一轮注入全量工具（多一轮，几乎无感）
+      if (readOnlyPhase && hasWriteIntent(res.text)) readOnlyPhase = false;
       if (res.usage) {
         usage.prompt_tokens += res.usage.prompt_tokens || 0;
         usage.completion_tokens += res.usage.completion_tokens || 0;
@@ -339,6 +405,7 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
         // 后续相同调用直接复用结果（仍逐个回填 tool 消息以保持 tool_call_id 配对）
         async function runTool(prep) {
           io.renderToolStart?.(prep.name, prep.args);
+          usedToolNames.add(prep.name); // 省钱 B1：执行过即标记，后续轮次省略其 description
           const dedupKey = !prep.isMcp && READONLY_TOOLS_SET.has(prep.name) ? prep.name + ':' + JSON.stringify(prep.args || {}) : null;
           if (dedupKey && turnToolCache.has(dedupKey)) {
             prep.cached = true;
@@ -363,6 +430,11 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
         function finishTool(prep, result, t0) {
           const ms = Date.now() - t0;
           toolMsTotal += ms;
+          // 省钱 B3：逐工具调用/耗时累加（费用二级分账的 byTool 维度）
+          const ts = toolStats.get(prep.name) || { calls: 0, ms: 0 };
+          ts.calls += 1;
+          ts.ms += ms;
+          toolStats.set(prep.name, ts);
           io.renderTool(prep.name, prep.args, result, ms);
           if (prep.name === 'todo' && result?.todos) io.renderTodo(result.todos);
           hooks.post(prep.name, prep.args, typeof result === 'string' ? { output: result } : result).catch(() => {});

package/src/batch.js

@@ -8,9 +8,12 @@
 
 import fs from 'node:fs';
 import path from 'node:path';
+import crypto from 'node:crypto';
 import { resolveProviderConfig } from './providers/index.js';
 import { estimateBatchCost, BATCH_DISCOUNT } from './pricing.js';
 import { recordCacheStats } from './cachestats.js';
+import { approxTokens } from './context.js';
+import { modelPreset } from './models.js';
 
 const DEFAULT_WINDOW = '24h';
 const DEFAULT_ENDPOINT = '/v1/chat/completions';
@@ -84,9 +87,11 @@ async function downloadResults(base, apiKey, batch) {
   throw new Error('批处理结果文件不可用（端点不支持或文件已过期）');
 }
 
-/** 执行一次批处理。questions: string[]。返回 { ok, outputFile, results, usage, cost, batchId }
- * @param {{ cfg: any, model: any, questions: any, workingDir?: string, maxTokens?: number, temperature?: any, signal?: any, onStatus?: any }} opts */
-export async function runBatch({ cfg, model, questions, workingDir = process.cwd(), maxTokens = 4096, temperature, signal, onStatus }) {
+/** 执行一次批处理。questions: string[]。返回 { ok, outputFile, results, usage, cost, batchId, deduped }
+ * 省钱 B2：①文本哈希去重（重复问题只提交一次，结果回填全部位置）；②单问超窗口预检（提交前报错，不烧钱）；
+ * ③maxCost 预算上限（提交前按估算费用拦截，超出直接中止不提交）。
+ * @param {{ cfg: any, model: any, questions: any, workingDir?: string, maxTokens?: number, temperature?: any, signal?: any, onStatus?: any, maxCost?: number }} opts */
+export async function runBatch({ cfg, model, questions, workingDir = process.cwd(), maxTokens = 4096, temperature, signal, onStatus, maxCost = 0 }) {
   const list = (questions || []).map((q) => String(q).trim()).filter(Boolean);
   if (!list.length) return { error: '没有可批处理的问题（每行一个问题）' };
   const pc = resolveProviderConfig(cfg, model);
@@ -97,6 +102,50 @@ export async function runBatch({ cfg, model, questions, workingDir = process.cwd
   // 不再携带完整系统提示（技能清单/用户记忆/AGENTS.md 对无工具批任务毫无意义，1000 问
   // 可白烧 50-80 万 token）；改用一行精简角色提示，剩余能力损失为零。
   const systemPrompt = '你是 MingDao Harness 编程助手。直接针对每个问题给出准确、完整的答案，不要复述问题、不要解释过程。';
+
+  // —— 省钱 B2：文本哈希去重（trim 后逐字节一致视为重复）——
+  const positions = /** @type {Map<string, number[]>} */ (new Map()); // hash → [输入行下标...]
+  const unique = /** @type {string[]} */ ([]);
+  list.forEach((/** @type {string} */ q, /** @type {number} */ i) => {
+    const h = crypto.createHash('sha256').update(q).digest('hex');
+    if (!positions.has(h)) {
+      positions.set(h, [i]);
+      unique.push(q);
+    } else {
+      positions.get(h)?.push(i);
+    }
+  });
+  const posByUniqueIdx = unique.map((/** @type {string} */ q) => positions.get(crypto.createHash('sha256').update(q).digest('hex')) || []);
+  const deduped = list.length - unique.length;
+  if (deduped > 0) onStatus?.(`去重：${deduped} 条重复问题合并（${list.length} → ${unique.length} 条实际提交）`);
+
+  // —— 省钱 B2：单问超窗口预检（估算输入 + max_tokens 超过模型窗口 95% 即报错，绝不提交烧钱）——
+  const preset = modelPreset(model) || {};
+  const windowTokens = Number(preset.budgetTokens) || 128000;
+  const sysTokens = approxTokens(systemPrompt);
+  for (let i = 0; i < unique.length; i++) {
+    const est = sysTokens + approxTokens(unique[i]);
+    if (est + maxTokens > windowTokens * 0.95) {
+      return {
+        error: `第 ${posByUniqueIdx[i][0] + 1} 个问题超窗口：估算输入 ${est} + max_tokens ${maxTokens} > 模型窗口 ${windowTokens}（可 --max-tokens 调小或拆分问题）`,
+      };
+    }
+  }
+
+  // —— 省钱 B2：--max-cost 预算上限（提交前估算拦截）——
+  let estimatedCost = 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);
+    if (estimatedCost > maxCost) {
+      return {
+        error: `预计费用 ≈¥${estimatedCost.toFixed(4)}（已按半价）超过 --max-cost ¥${maxCost}，已中止提交。可缩小问题集或调高上限。`,
+        estimatedCost,
+      };
+    }
+  }
+
   const bodyTemplate = {
     model,
     messages: null, // 逐行填充
@@ -105,7 +154,7 @@ export async function runBatch({ cfg, model, questions, workingDir = process.cwd
     stream: false,
   };
   const jsonl =
-    list
+    unique
       .map((q, i) =>
         JSON.stringify({
           custom_id: `md-${i}`,
@@ -164,24 +213,33 @@ export async function runBatch({ cfg, model, questions, workingDir = process.cwd
     }
     onStatus?.('下载结果…');
     const results = await downloadResults(base, apiKey, batch);
-    // 汇总 usage 与费用（batch 半价）
+    // 汇总 usage 与费用（batch 半价）；结果按 custom_id 回填到全部重复位置（省钱 B2）
     let prompt = 0;
     let completion = 0;
-    const outputs = [];
+    const outputs = /** @type {Array<{id: string, content: string}>} */ (new Array(list.length));
     for (const r of results) {
       const body = r?.response?.body || {};
       prompt += body.usage?.prompt_tokens || 0;
       completion += body.usage?.completion_tokens || 0;
       const content = body.choices?.[0]?.message?.content ?? body.choices?.[0]?.text ?? (r?.response?.status_code !== 200 ? `（错误 ${r?.response?.status_code}）` : '');
-      outputs.push({ id: r.custom_id, content: String(content || '').trim() });
+      const m = /^md-(\d+)$/.exec(String(r.custom_id || ''));
+      const ui = m ? Number(m[1]) : -1;
+      const idxs = ui >= 0 && ui < posByUniqueIdx.length ? posByUniqueIdx[ui] : [];
+      for (const pos of idxs) {
+        outputs[pos] = { id: String(pos), content: String(content || '').trim() };
+      }
+    }
+    // 防御：服务端漏回的 custom_id 用占位补全，保证输出行数与输入行数一一对应
+    for (let i = 0; i < outputs.length; i++) {
+      if (!outputs[i]) outputs[i] = { id: String(i), content: '' };
     }
     const usage = { prompt_tokens: prompt, completion_tokens: completion };
     const cost = estimateBatchCost(model, prompt, completion);
     const outFile = path.join(workingDir, `mingdao-batch-result-${Date.now()}.jsonl`);
     fs.writeFileSync(outFile, outputs.map((o) => JSON.stringify(o)).join('\n') + '\n');
     recordCacheStats({ model, prompt, completion, hit: null, miss: null, cost, saved: null, batch: true });
-    onStatus?.(`完成：${outputs.length} 条结果`);
-    return { ok: true, batchId: batch.id, outputFile: outFile, results: outputs, usage, cost, discount: BATCH_DISCOUNT };
+    onStatus?.(`完成：${outputs.length} 条结果${deduped ? `（去重合并 ${deduped} 条）` : ''}`);
+    return { ok: true, batchId: batch.id, outputFile: outFile, results: outputs, usage, cost, discount: BATCH_DISCOUNT, deduped, estimatedCost };
   } catch (err) {
     // 批处理端点不支持（404/405 等）→ 明确告知，不静默
     return { error: `批处理不可用：${err?.message || err}（该服务商可能不支持 Batch API，可用 config.batchBaseUrl 指定支持的网关）` };

package/src/cachestats.js

@@ -33,6 +33,8 @@ export function recordCacheStats(entry) {
       llmMs: entry.llmMs ?? undefined, // 模型调用总耗时（状态栏 LLM 时长/tok-s）
       toolMs: entry.toolMs ?? undefined, // 工具执行总耗时（状态栏 工具调用时长）
       firstTokenMs: entry.firstTokenMs ?? undefined, // 首 token 延迟（状态栏平均首 token）
+      reasoning: entry.reasoning ?? undefined, // 省钱 B3：推理 token 估算（费用二级分账维度）
+      byTool: Array.isArray(entry.byTool) ? entry.byTool : undefined, // 省钱 B3：逐工具 {tool,calls,ms}
     });
     fs.appendFileSync(cacheStatsFile(), line + '\n');
     cacheStatsCount += 1;
@@ -125,6 +127,8 @@ export function recordUsage(modelName, usage, perf = null) {
     llmMs: perf?.llmMs ?? undefined,
     toolMs: perf?.toolMs ?? undefined,
     firstTokenMs: perf?.firstTokenMs ?? undefined,
+    reasoning: perf?.reasoningTokens ?? undefined, // 省钱 B3
+    byTool: perf?.toolStats ?? undefined, // 省钱 B3
   });
 }
 
@@ -139,9 +143,12 @@ export function formatCacheSummary(sum) {
 }
 
 // 分账统计（评估 /cost 升级）：按模型分账、今日费用、batch 半价任务、节省归因
+// 省钱 B3：新增 reasoning 维度、byTool 逐工具累加、byDay 近 14 天按日折线数据
 export function costBreakdown() {
   const entries = listCacheStats(100000);
   const byModel = new Map();
+  const byTool = /** @type {Map<string, {calls: number, ms: number}>} */ (new Map());
+  const byDay = /** @type {Map<string, number>} */ (new Map()); // 'MM-DD' → cost（近 14 个北京日，含 0 值日）
   const start = beijingDayStart().getTime();
   let totalCost = 0;
   let totalSaved = 0;
@@ -149,21 +156,45 @@ export function costBreakdown() {
   let batchCost = 0;
   let hit = 0;
   let miss = 0;
+  let reasoning = 0;
   for (const e of entries) {
     totalCost += e.cost || 0;
     totalSaved += e.saved || 0;
     hit += e.hit || 0;
     miss += e.miss || 0;
+    reasoning += e.reasoning || 0;
     if (e.batch) batchCost += e.cost || 0;
     if (e.at >= start) today += e.cost || 0;
-    const m = byModel.get(e.model) || { prompt: 0, completion: 0, cost: 0, saved: 0, turns: 0, batchTurns: 0 };
+    const m = byModel.get(e.model) || { prompt: 0, completion: 0, cost: 0, saved: 0, turns: 0, batchTurns: 0, reasoning: 0 };
     m.prompt += e.prompt || 0;
     m.completion += e.completion || 0;
     m.cost += e.cost || 0;
     m.saved += e.saved || 0;
     m.turns += 1;
+    m.reasoning += e.reasoning || 0;
     if (e.batch) m.batchTurns += 1;
     byModel.set(e.model, m);
+    if (Array.isArray(e.byTool)) {
+      for (const t of e.byTool) {
+        const tt = byTool.get(t.tool) || { calls: 0, ms: 0 };
+        tt.calls += t.calls || 0;
+        tt.ms += t.ms || 0;
+        byTool.set(t.tool, tt);
+      }
+    }
+    if (e.at) {
+      const p = beijingParts(new Date(e.at));
+      const key = `${String(p.month).padStart(2, '0')}-${String(p.day).padStart(2, '0')}`;
+      byDay.set(key, (byDay.get(key) || 0) + (e.cost || 0));
+    }
+  }
+  // 补全近 14 天（含无记录的 0 值日），保证折线 x 轴连续
+  const days = /** @type {Array<{day: string, cost: number}>} */ ([]);
+  for (let i = 13; i >= 0; i--) {
+    const d = new Date(start - i * 86400000);
+    const p = beijingParts(d);
+    const key = `${String(p.month).padStart(2, '0')}-${String(p.day).padStart(2, '0')}`;
+    days.push({ day: key, cost: byDay.get(key) || 0 });
   }
   return {
     totalCost,
@@ -173,11 +204,15 @@ export function costBreakdown() {
     hit,
     miss,
     rate: hit + miss > 0 ? hit / (hit + miss) : null,
+    reasoning,
     byModel: [...byModel.entries()].map(([model, m]) => ({ model, ...m })).sort((a, b) => b.cost - a.cost),
+    byTool: [...byTool.entries()].map(([tool, t]) => ({ tool, ...t })).sort((a, b) => b.ms - a.ms),
+    byDay: days,
   };
 }
 
 // 月度费用报告（/cost 导出）：按北京时间月份聚合，month 形如 'YYYY-MM'，缺省返回全部月份
+// 省钱 B3：月度聚合增加 reasoning 与 byTool 维度
 export function costMonthlyReport(month) {
   const entries = listCacheStats(100000);
   const want = String(month || '').trim();
@@ -188,7 +223,7 @@ export function costMonthlyReport(month) {
     if (want && key !== want) continue;
     let m = months.get(key);
     if (!m) {
-      m = { month: key, cost: 0, saved: 0, prompt: 0, completion: 0, hit: 0, miss: 0, batchCost: 0, days: new Map(), models: new Map() };
+      m = { month: key, cost: 0, saved: 0, prompt: 0, completion: 0, hit: 0, miss: 0, batchCost: 0, reasoning: 0, days: new Map(), models: new Map(), tools: new Map() };
       months.set(key, m);
     }
     m.cost += e.cost || 0;
@@ -197,6 +232,7 @@ export function costMonthlyReport(month) {
     m.completion += e.completion || 0;
     m.hit += e.hit || 0;
     m.miss += e.miss || 0;
+    m.reasoning += e.reasoning || 0;
     if (e.batch) m.batchCost += e.cost || 0;
     const day = String(p.day).padStart(2, '0');
     m.days.set(day, (m.days.get(day) || 0) + (e.cost || 0));
@@ -206,6 +242,14 @@ export function costMonthlyReport(month) {
     mm.cost += e.cost || 0;
     mm.turns += 1;
     m.models.set(e.model, mm);
+    if (Array.isArray(e.byTool)) {
+      for (const t of e.byTool) {
+        const tt = m.tools.get(t.tool) || { calls: 0, ms: 0 };
+        tt.calls += t.calls || 0;
+        tt.ms += t.ms || 0;
+        m.tools.set(t.tool, tt);
+      }
+    }
   }
   return [...months.values()]
     .sort((a, b) => a.month.localeCompare(b.month))
@@ -219,7 +263,9 @@ export function costMonthlyReport(month) {
       miss: m.miss,
       rate: m.hit + m.miss > 0 ? m.hit / (m.hit + m.miss) : null,
       batchCost: m.batchCost,
+      reasoning: m.reasoning,
       days: [...m.days.entries()].sort((a, b) => a[0].localeCompare(b[0])).map(([day, cost]) => ({ day, cost })),
       models: [...m.models.entries()].map(([model, x]) => ({ model, ...x })).sort((a, b) => b.cost - a.cost),
+      tools: [...m.tools.entries()].map(([tool, t]) => ({ tool, ...t })).sort((a, b) => b.ms - a.ms),
     }));
 }

package/src/cli.js

@@ -230,7 +230,7 @@ async function runWorkerTask(id, question, { permission, model, offpeak }) {
       } catch {}
     }
     const finalStatus = res.truncated ? 'failed' : res.aborted ? 'killed' : 'done';
-    recordUsage(modelName, res.usage, res.perf);
+    recordUsage(res.perf?.usedModel || modelName, res.usage, res.perf);
     finish({
       status: finalStatus,
       text: (res.text || '').slice(0, 2000),
@@ -565,12 +565,12 @@ async function main() {
             session: session.name,
           })
         );
-        recordUsage(modelName, res.usage, res.perf);
+        recordUsage(res.perf?.usedModel || modelName, res.usage, res.perf);
         process.exitCode = res.truncated || res.aborted ? 1 : 0;
       } else {
         io.printUsageLine({ modelName, usage: res.usage, durationMs: res.durationMs });
         if (res.aborted) io.print(style('（已中断）', C.dim));
-        recordUsage(modelName, res.usage, res.perf);
+        recordUsage(res.perf?.usedModel || modelName, res.usage, res.perf);
         process.exitCode = res.truncated ? 1 : 0;
       }
     } catch (err) {
@@ -1094,7 +1094,7 @@ async function main() {
       lastUsage = res.usage;
       lastText = res.text || lastText;
       stats.turns += 1;
-      recordUsage(modelName, res.usage, res.perf);
+      recordUsage(res.perf?.usedModel || modelName, res.usage, res.perf);
       stats.promptTokens += res.usage.prompt_tokens || 0;
       stats.completionTokens += res.usage.completion_tokens || 0;
       const fresh = messages.slice(persisted);

package/src/commands/update.js

@@ -33,7 +33,7 @@ export async function handleUpdateFamily(cmd, args) {
     return true;
   }
 
-  // Batch API 半价批处理（A1）：mingdao batch <问题文件|-> [--model 名] [--max-tokens n]
+  // Batch API 半价批处理（A1/B2）：mingdao batch <问题文件|-> [--model 名] [--max-tokens n] [--max-cost 元]
   if (cmd === 'batch') {
     const { runBatch } = await import('../batch.js');
     const cfgB = loadConfig();
@@ -44,16 +44,18 @@ export async function handleUpdateFamily(cmd, args) {
     }
     let model = cfgB.model || 'deepseek-v4-flash';
     let maxTokens = 4096;
+    let maxCost = 0; // 省钱 B2：预算上限（元），提交前按估算拦截
     let srcFile = null;
     for (let i = 0; i < args.length; i++) {
       const a = args[i];
       if (a === '--model') model = args[++i];
       else if (a === '--max-tokens') maxTokens = Number(args[++i]) || 4096;
+      else if (a === '--max-cost') maxCost = Number(args[++i]) || 0;
       else if (a === '--out') { i += 1; /* 输出默认落工作目录 */ }
       else if (!srcFile) srcFile = a;
     }
     if (!srcFile) {
-      console.log('用法：mingdao batch <问题文件|-> 每行一个问题（--model 名 --max-tokens n）');
+      console.log('用法：mingdao batch <问题文件|-> 每行一个问题（--model 名 --max-tokens n --max-cost 元）');
       process.exitCode = 1;
       return true;
     }
@@ -80,6 +82,7 @@ export async function handleUpdateFamily(cmd, args) {
       questions,
       workingDir: process.cwd(),
       maxTokens,
+      maxCost,
       signal: ac.signal,
       onStatus: (st) => console.log('  ' + st),
     });
@@ -90,6 +93,7 @@ export async function handleUpdateFamily(cmd, args) {
       return true;
     }
     console.log(`✓ 完成 ${r.results.length} 条 · ↑${r.usage.prompt_tokens} ↓${r.usage.completion_tokens} tokens · 费用 ≈¥${r.cost.toFixed(5)}（已按半价）`);
+    if (r.deduped) console.log(`  （去重合并 ${r.deduped} 条重复问题，结果已回填全部位置）`);
     console.log(`  结果文件：${r.outputFile}`);
     console.log(`  任务 ID：${r.batchId}（结果已计入 /cost 分账）`);
     return true;
@@ -123,13 +127,21 @@ export async function handleUpdateFamily(cmd, args) {
       md.push('');
       md.push(`- 实际费用 ≈¥${r.cost.toFixed(5)}${r.batchCost > 0 ? `（含 Batch 半价任务 ≈¥${r.batchCost.toFixed(5)}）` : ''}`);
       md.push(`- 相比全未命中已节省 ≈¥${r.saved.toFixed(5)}${r.rate != null ? ` · 缓存命中率 ${(r.rate * 100).toFixed(0)}%` : ''}`);
-      md.push(`- Tokens：↑${r.prompt} / ↓${r.completion}`);
+      md.push(`- Tokens：↑${r.prompt} / ↓${r.completion}${r.reasoning ? ` · 推理 ${r.reasoning}` : ''}`);
       md.push('');
       md.push('## 按模型分账');
       md.push('');
       md.push('| 模型 | 轮次 | ↑prompt | ↓completion | 费用 |');
       md.push('| --- | --- | --- | --- | --- |');
       for (const m of r.models) md.push(`| ${m.model} | ${m.turns} | ${m.prompt} | ${m.completion} | ≈¥${m.cost.toFixed(5)} |`);
+      if (r.tools.length) {
+        md.push('');
+        md.push('## 按工具分账');
+        md.push('');
+        md.push('| 工具 | 调用 | 耗时(ms) |');
+        md.push('| --- | --- | --- |');
+        for (const t of r.tools.slice(0, 10)) md.push(`| ${t.tool} | ${t.calls} | ${t.ms} |`);
+      }
       md.push('');
       md.push('## 每日费用');
       md.push('');

package/src/cost-guard.js

@@ -1,7 +1,8 @@
 // 费用护栏（四报告共识 A2/Kimi P-1：把峰谷定价从「展示」升级为「主动约束」）：
-// config.costGuard = { dailyLimitYuan: 10, warnAtYuan: 8, action: 'warn'|'block' }
+// config.costGuard = { dailyLimitYuan: 10, warnAtYuan: 8, action: 'warn'|'block'|'downgrade', downgradeModel?: 'deepseek-v4-flash' }
 // 按北京时间自然日累计 cache-stats 实际费用（含 batch 半价与缓存折扣后的真实口径）。
-// Agent 每轮开始前检查：超 warn 线提醒、超 limit 且 action=block 时暂停执行。
+// Agent 每轮开始前检查：超 warn 线提醒；超 limit 时按 action 处理——
+//   block：暂停执行；downgrade（省钱 B4）：自动切换便宜模型继续跑（默认 deepseek-v4-flash）。
 
 import fs from 'node:fs';
 import { listCacheStats, cacheStatsFile } from './cachestats.js';
@@ -41,18 +42,19 @@ export function costGuardStatus() {
   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' ? 'block' : 'warn';
+  const action = g.action === 'block' || g.action === 'downgrade' ? g.action : 'warn';
   return {
     cost,
     limit,
     warnAt,
     action,
+    downgradeModel: String(g.downgradeModel || 'deepseek-v4-flash'),
     overWarn: limit > 0 && cost >= warnAt,
     overLimit: limit > 0 && cost >= limit,
   };
 }
 
-// Agent 每轮开始前调用：返回 null 放行；blocked=true 表示应暂停本轮
+// Agent 每轮开始前调用：返回 null 放行；blocked=true 应暂停本轮；downgrade=true 应切换便宜模型
 export function checkCostGuard() {
   const st = costGuardStatus();
   if (!st) return null;
@@ -62,10 +64,18 @@ export function checkCostGuard() {
       message: `今日费用已达上限 ¥${st.limit.toFixed(2)}（实际 ¥${st.cost.toFixed(4)}），已暂停执行——调整 config.costGuard 或明天自动恢复。`,
     };
   }
+  if (st.overLimit && st.action === 'downgrade') {
+    return {
+      blocked: false,
+      downgrade: true,
+      downgradeModel: st.downgradeModel,
+      message: `⚠ 费用护栏：今日已用 ¥${st.cost.toFixed(4)} 超上限 ¥${st.limit.toFixed(2)}——已自动降级到便宜模型 ${st.downgradeModel} 继续执行（config.costGuard.action 可改回 warn/block）。`,
+    };
+  }
   if (st.overWarn) {
     return {
       blocked: false,
-      message: `⚠ 费用护栏：今日已用 ¥${st.cost.toFixed(4)} / 上限 ¥${st.limit.toFixed(2)}${st.action === 'block' ? '（到达即暂停）' : '（仅提醒）'}。`,
+      message: `⚠ 费用护栏：今日已用 ¥${st.cost.toFixed(4)} / 上限 ¥${st.limit.toFixed(2)}${st.action !== 'warn' ? `（${st.action === 'block' ? '到达即暂停' : '到达自动降级 ' + st.downgradeModel}）` : '（仅提醒）'}。`,
     };
   }
   return null;

package/src/tools/index.js

@@ -11,9 +11,9 @@ export const READONLY_TOOLS = new Set(['read', 'glob', 'grep', 'ls', 'skill']);
 const READ_SCHEMA = {
   type: 'object',
   properties: {
-    path: { type: 'string', description: '要读取的文件路径（相对或绝对）。' },
+    path: { type: 'string', description: '文件路径（相对或绝对）。' },
     offset: { type: 'integer', description: '起始行号，默认 1。' },
-    limit: { type: 'integer', description: '最大返回行数，默认 400。' },
+    limit: { type: 'integer', description: '最大行数，默认 400。' },
   },
   required: ['path'],
 };
@@ -21,7 +21,7 @@ const READ_SCHEMA = {
 const WRITE_SCHEMA = {
   type: 'object',
   properties: {
-    path: { type: 'string', description: '要创建或覆盖的文件路径。' },
+    path: { type: 'string', description: '文件路径。' },
     content: { type: 'string', description: '完整文件内容（UTF-8）。' },
   },
   required: ['path', 'content'],
@@ -30,10 +30,10 @@ const WRITE_SCHEMA = {
 const EDIT_SCHEMA = {
   type: 'object',
   properties: {
-    path: { type: 'string', description: '要修改的文件路径。' },
-    old_string: { type: 'string', description: '文件中真实存在的原文片段，必须逐字符完全一致。' },
-    new_string: { type: 'string', description: '替换后的文本。' },
-    replace_all: { type: 'boolean', description: '是否替换所有匹配处，默认 false。' },
+    path: { type: 'string', description: '文件路径。' },
+    old_string: { type: 'string', description: '原文片段，必须逐字一致。' },
+    new_string: { type: 'string', description: '替换后文本。' },
+    replace_all: { type: 'boolean', description: '替换所有匹配，默认 false。' },
   },
   required: ['path', 'old_string', 'new_string'],
 };
@@ -41,15 +41,15 @@ const EDIT_SCHEMA = {
 const LS_SCHEMA = {
   type: 'object',
   properties: {
-    path: { type: 'string', description: '目录路径，默认当前工作目录。' },
+    path: { type: 'string', description: '目录路径，默认当前目录。' },
   },
 };
 
 const GLOB_SCHEMA = {
   type: 'object',
   properties: {
-    pattern: { type: 'string', description: '通配符模式，如 src/**/*.js、*.md。' },
-    path: { type: 'string', description: '搜索根目录，默认当前工作目录。' },
+    pattern: { type: 'string', description: '通配符模式，如 src/**/*.js。' },
+    path: { type: 'string', description: '搜索根目录。' },
   },
   required: ['pattern'],
 };
@@ -58,8 +58,8 @@ const GREP_SCHEMA = {
   type: 'object',
   properties: {
     pattern: { type: 'string', description: '正则表达式。' },
-    path: { type: 'string', description: '搜索根目录，默认当前工作目录。' },
-    include: { type: 'string', description: '文件名通配符过滤，如 *.js。' },
+    path: { type: 'string', description: '搜索根目录。' },
+    include: { type: 'string', description: '文件名过滤，如 *.js。' },
   },
   required: ['pattern'],
 };
@@ -67,7 +67,7 @@ const GREP_SCHEMA = {
 const BASH_SCHEMA = {
   type: 'object',
   properties: {
-    command: { type: 'string', description: '要执行的 shell 命令。执行前会请求用户授权。' },
+    command: { type: 'string', description: 'shell 命令。执行前需用户授权。' },
     timeout: { type: 'integer', description: '超时秒数，默认 120。' },
   },
   required: ['command'],
@@ -76,16 +76,16 @@ const BASH_SCHEMA = {
 const SKILL_SCHEMA = {
   type: 'object',
   properties: {
-    name: { type: 'string', description: '技能名；省略时列出所有可用技能。' },
+    name: { type: 'string', description: '技能名；省略则列出全部。' },
   },
 };
 
 const TASK_SCHEMA = {
   type: 'object',
   properties: {
-    description: { type: 'string', description: '子任务一句话描述（用于进度展示）。' },
-    prompt: { type: 'string', description: '交给子代理的完整任务说明（它没有当前对话上下文）。' },
-    readOnly: { type: 'boolean', description: '只读调研任务（不写文件不执行命令）。多个 readOnly 子任务会并行执行。' },
+    description: { type: 'string', description: '子任务一句话描述。' },
+    prompt: { type: 'string', description: '子代理的完整任务说明。' },
+    readOnly: { type: 'boolean', description: '只读调研任务，可并行。' },
   },
   required: ['prompt'],
 };
@@ -112,7 +112,7 @@ const TODO_SCHEMA = {
 const UNDO_SCHEMA = {
   type: 'object',
   properties: {
-    path: { type: 'string', description: '要撤销的文件；省略时撤销最近一次修改的文件。' },
+    path: { type: 'string', description: '要撤销的文件；省略撤销最近一次。' },
   },
 };
 
@@ -121,7 +121,7 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'read',
-      description: '读取文本文件，返回带行号的内容。修改文件前务必先读取。',
+      description: '读取文件内容（带行号）。修改文件前必须先读。',
       parameters: READ_SCHEMA,
     },
   },
@@ -129,7 +129,7 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'write',
-      description: '创建新文件或完全覆盖已有文件（自动创建父目录）。',
+      description: '创建新文件或整体覆盖（自动建父目录）。',
       parameters: WRITE_SCHEMA,
     },
   },
@@ -137,7 +137,7 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'edit',
-      description: '对文件做精确文本替换。old_string 必须与文件内容完全一致；匹配多处时需 replace_all=true 或提供更精确上下文。',
+      description: '精确文本替换：old_string 必须逐字匹配原文；多处匹配需 replace_all=true。',
       parameters: EDIT_SCHEMA,
     },
   },
@@ -145,7 +145,7 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'ls',
-      description: '列出目录内容，目录以 / 结尾。',
+      description: '列出目录内容（目录以 / 结尾）。',
       parameters: LS_SCHEMA,
     },
   },
@@ -153,7 +153,7 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'glob',
-      description: '按通配符模式查找文件路径（支持 * 与 **）。',
+      description: '按通配符查找文件路径（支持 * 与 **）。',
       parameters: GLOB_SCHEMA,
     },
   },
@@ -161,7 +161,7 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'grep',
-      description: '在文件内容中按正则表达式搜索，返回「文件:行号: 内容」。',
+      description: '正则搜索文件内容，返回「文件:行号: 内容」。',
       parameters: GREP_SCHEMA,
     },
   },
@@ -169,7 +169,7 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'bash',
-      description: '执行 shell 命令并返回输出（stdout/stderr/退出码）。需要用户授权。',
+      description: '执行 shell 命令，返回输出与退出码。需用户授权。',
       parameters: BASH_SCHEMA,
     },
   },
@@ -177,7 +177,7 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'skill',
-      description: '加载指定技能的 SKILL.md 全文；省略 name 时列出可用技能。任务与技能匹配时应先加载。',
+      description: '加载技能 SKILL.md 全文；省略 name 则列出可用技能。',
       parameters: SKILL_SCHEMA,
     },
   },
@@ -185,7 +185,7 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'task',
-      description: '把独立子任务委托给一个全新上下文的子代理，返回其汇报。适合搜索调研、独立实现、复核验证等可并行的工作。',
+      description: '把独立子任务委托给新上下文子代理并返回汇报；readOnly 只读任务可并行。',
       parameters: TASK_SCHEMA,
     },
   },
@@ -193,7 +193,7 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'todo',
-      description: '维护任务清单（全量替换）。多步骤任务开始前建立清单，完成一项更新一项。',
+      description: '维护任务清单（全量替换）。多步任务先建清单再逐项更新。',
       parameters: TODO_SCHEMA,
     },
   },
@@ -201,7 +201,7 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'undo',
-      description: '撤销 write/edit 造成的最近一次文件修改；指定 path 则撤销该文件。',
+      description: '撤销最近一次 write/edit 修改；指定 path 撤销该文件。',
       parameters: UNDO_SCHEMA,
     },
   },
@@ -211,6 +211,47 @@ export function toolSchemas() {
   return TOOLS;
 }
 
+/**
+ * 递归去除对象中的全部 description 键（保留类型/required/enum 等结构性字段）。
+ * @param {any} obj
+ * @returns {any}
+ */
+function stripDescriptions(obj) {
+  if (Array.isArray(obj)) return obj.map(stripDescriptions);
+  if (obj && typeof obj === 'object') {
+    const out = /** @type {Record<string, any>} */ ({});
+    for (const [k, v] of Object.entries(obj)) {
+      if (k === 'description') continue;
+      out[k] = stripDescriptions(v);
+    }
+    return out;
+  }
+  return obj;
+}
+
+/**
+ * 按需构建工具 Schema（省钱 B1）：本会话已调用过的工具省略全部描述（工具级 + 参数级，
+ * 模型已在消息历史里见过其用途，保留 name/parameters 结构与类型即可），未用过的保留完整描述。
+ * 返回浅拷贝新数组，不修改原 TOOLS；extra（如 MCP 工具）按同一规则处理。
+ * @param {Set<string>} usedNames 已调用工具名（内置名或 MCP 前缀名）
+ * @param {Array<object>} [extra] 附加工具 Schema（MCP 等）
+ * @returns {Array<any>}
+ */
+export function buildToolSchemas(usedNames, extra = []) {
+  const strip = (/** @type {any[]} */ arr) =>
+    arr.map((/** @type {any} */ t) => {
+      const name = t?.function?.name;
+      if (name && usedNames.has(name)) {
+        return {
+          ...t,
+          function: { ...t.function, description: '', parameters: stripDescriptions(t.function?.parameters) },
+        };
+      }
+      return t;
+    });
+  return [...strip(TOOLS), ...strip(extra)];
+}
+
 function runSkill(args, ctx) {
   const name = String(args.name ?? '').trim();
   const skills = listSkills(ctx.workingDir);

package/src/web/app.js

@@ -763,12 +763,55 @@ $('#memDedupe').onclick=async ()=>{
 };
 // —— 缓存命中率仪表盘 ——
 function fmtT(n){ n=Number(n||0); return n>=1000?(n/1000).toFixed(1)+'k':String(n); }
+// 省钱 B3：费用二级分账面板（模型/工具 Top5 + 近 14 天折线，零依赖 SVG）
+function renderCostBreakdown(bd){
+  const models=$('#costTopModels'); models.innerHTML='';
+  for(const m of ((bd.byModel||[]).slice(0,5))){
+    const bar=document.createElement('div'); bar.style.cssText='height:3px;border-radius:2px;background:var(--bg3);margin:1px 0;overflow:hidden';
+    const max=bd.byModel&&bd.byModel[0]?bd.byModel[0].cost:1;
+    bar.innerHTML='<div style="height:100%;width:'+Math.max(2,Math.round((m.cost||0)/Math.max(max,1e-9)*100))+'%;background:var(--accent2)"></div>';
+    const row=document.createElement('div'); row.style.cssText='display:flex;justify-content:space-between;font-size:11.5px;padding:1px 0';
+    row.innerHTML='<span>'+esc(m.model||'—')+'</span><span>¥'+(m.cost||0).toFixed(4)+' · '+m.turns+' 轮</span>';
+    const w=document.createElement('div'); w.appendChild(row); w.appendChild(bar); models.appendChild(w);
+  }
+  if(!(bd.byModel||[]).length) models.innerHTML='<div style="color:var(--faint);font-size:11.5px">暂无记录</div>';
+  const tools=$('#costTopTools'); tools.innerHTML='';
+  for(const t of ((bd.byTool||[]).slice(0,5))){
+    const bar=document.createElement('div'); bar.style.cssText='height:3px;border-radius:2px;background:var(--bg3);margin:1px 0;overflow:hidden';
+    const max=bd.byTool&&bd.byTool[0]?bd.byTool[0].ms:1;
+    bar.innerHTML='<div style="height:100%;width:'+Math.max(2,Math.round((t.ms||0)/Math.max(max,1e-9)*100))+'%;background:var(--cyan)"></div>';
+    const row=document.createElement('div'); row.style.cssText='display:flex;justify-content:space-between;font-size:11.5px;padding:1px 0';
+    row.innerHTML='<span>'+esc(t.tool||'—')+'</span><span>'+t.calls+' 次 · '+fmtDur(t.ms)+'</span>';
+    const w=document.createElement('div'); w.appendChild(row); w.appendChild(bar); tools.appendChild(w);
+  }
+  if(!(bd.byTool||[]).length) tools.innerHTML='<div style="color:var(--faint);font-size:11.5px">暂无记录</div>';
+  const line=$('#costLine');
+  const days=(bd.byDay||[]).slice(-14);
+  if(!days.length){ line.innerHTML=''; return; }
+  const W=320, H=56, P=4;
+  const maxC=Math.max(...days.map(d=>d.cost), 1e-9);
+  const pts=days.map((d,i)=>{
+    const x=P+i*(W-2*P)/Math.max(days.length-1,1);
+    const y=H-4-(d.cost/maxC)*(H-10);
+    return [x.toFixed(1), y.toFixed(1)];
+  });
+  const poly=pts.map(p=>p.join(',')).join(' ');
+  const last=pts[pts.length-1];
+  line.innerHTML='<div style="font-size:11.5px;color:var(--faint);margin-bottom:2px">近 14 天费用折线（¥，最高 ¥'+maxC.toFixed(4)+'）</div>'
+    +'<svg viewBox="0 0 '+W+' '+H+'" style="width:100%;height:auto;background:var(--bg3);border-radius:8px">'
+    +'<polyline points="'+poly+'" fill="none" style="stroke:var(--accent2);stroke-width:1.6;stroke-linejoin:round;stroke-linecap:round"/>'
+    +'<circle cx="'+last[0]+'" cy="'+last[1]+'" r="2.6" style="fill:var(--accent)"/>'
+    +'<text x="4" y="10" font-size="8" style="fill:var(--faint)">'+days[0].day+'</text>'
+    +'<text x="'+(W-52)+'" y="10" font-size="8" style="fill:var(--faint)">'+days[days.length-1].day+'</text>'
+    +'</svg>';
+}
 async function refreshCache(){
   const r=await fetch('/api/cache-stats',{cache:'no-store'}).catch(()=>null); if(!r) return;
   const j=await r.json(); if(!j.ok) return;
   const s=j.summary||{};
   const rate=s.rate!=null?(s.rate*100).toFixed(0)+'%':'暂无缓存数据';
   $('#cacheSummary').innerHTML='轮次 '+s.turns+' · ↑'+fmtT(s.prompt)+' ↓'+fmtT(s.completion)+' tokens · 命中率 <b style="color:var(--accent)">'+rate+'</b> · 累计 ≈¥'+Number(s.cost||0).toFixed(5)+'（比全未命中省 ≈¥'+Number(s.saved||0).toFixed(5)+'）';
+  renderCostBreakdown(j.breakdown||{});
   const list=$('#cacheRecent'); list.innerHTML='';
   if(!(j.recent||[]).length){ list.innerHTML='<div style="color:var(--faint);font-size:12px;padding:6px 2px">暂无记录（每次对话后自动统计）</div>'; return; }
   for(const e of j.recent){

package/src/web/index.html

@@ -372,6 +372,18 @@ footer{flex:none;border-top:1px solid var(--border);background:var(--bg2);paddin
     <h4 style="margin:4px 0;color:var(--accent2)">缓存命中率仪表盘（最近 10 次）</h4>
     <div id="cacheSummary" style="font-size:12.5px;color:var(--dim);padding:2px"></div>
     <div id="cacheRecent" style="max-height:130px;overflow-y:auto"></div>
+    <h4 style="margin:10px 0 4px;color:var(--accent2)">费用二级分账（模型 / 工具 Top5 · 近 14 天）</h4>
+    <div style="display:flex;gap:10px;flex-wrap:wrap">
+      <div style="flex:1;min-width:170px">
+        <div style="font-size:11.5px;color:var(--faint)">模型 Top5（费用）</div>
+        <div id="costTopModels" style="font-size:12px;color:var(--dim)"></div>
+      </div>
+      <div style="flex:1;min-width:170px">
+        <div style="font-size:11.5px;color:var(--faint)">工具 Top5（耗时）</div>
+        <div id="costTopTools" style="font-size:12px;color:var(--dim)"></div>
+      </div>
+    </div>
+    <div id="costLine" style="margin-top:8px"></div>
       </section>
     <section class="cfg-panel" data-panel="mcp">
     <hr style="border:none;border-top:1px solid var(--border);margin:14px 0 8px">

package/src/web/server.js

@@ -435,7 +435,7 @@ 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(runModel, r.usage, r.perf);
+      recordUsage(r.perf?.usedModel || runModel, r.usage, r.perf);
       maybeAutoSync().catch(() => {});
       // 新会话自动标题（可配置关闭）
       srvlog('chat 标题生成前 ' + taskId);