mingdao-harness 0.2.7 → 0.2.8

package/docs/CONFIG.md

@@ -57,9 +57,9 @@ MingDao 先用 executor 模型（路由关闭时为当前模型）把被裁段
 ## 会话检索索引（P3-2）
 
 `mingdao sessions search <关键词>` 与 WebUI 历史会话搜索走增量词表索引
-（`~/.mingdao/sessions-index.json`）：中文按 bigram+单字、英文按词，多词 AND 匹配；
-只有内容变化（mtime/size）的会话才重新分词，删除的会话自动清出索引。索引文件可随时
-删除（下次搜索自动重建）。
+（`~/.mingdao/sessions-index/` 分片目录，v0.2.8 起按会话名 sha1 前 2 位分 256 片）：
+中文按 bigram+单字、英文按词，多词 AND 匹配；只有内容变化（mtime/size）的会话才重新
+分词，删除的会话自动清出索引。索引目录可随时删除（下次搜索自动重建）。
 
 ## 会话级工作空间（P3-4）
 
@@ -169,7 +169,7 @@ completion 计费，防止推理吃满上限时空轮白烧）、`compactTrigger
 { "costGuard": { "dailyLimitYuan": 10, "warnAtYuan": 8, "action": "block" } }
 ```
 
-- `action: "warn"`（默认）超限仅提醒；`"block"` 到达上限暂停执行（明天自动恢复）；
+- `action: "warn"`（默认）超限仅提醒；`"block"` 到达上限暂停执行（明天自动恢复）；`"downgrade"` 触顶后自动切换到同服务商更便宜模型（如 flash）继续执行并提示（已是 flash 则按 block 处理）；
 - `/cost` 与 WebUI 头部费用徽标实时显示「今日费用 / 上限百分比」。
 
 ## 战略省钱：Batch 半价 + 避峰调度
@@ -182,7 +182,7 @@ completion 计费，防止推理吃满上限时空轮白烧）、`compactTrigger
   ——高峰时段（北京时间工作日 9:00–12:00、14:00–18:00 两段）自动顺延到最近闲时（12:00 / 18:00）执行；**周末与午间 12:00–14:00 按闲时计价**
   · `pricing.peakWindows`：高峰窗口覆盖（[[起,止],...] 北京时间整点）；`pricing.timezone`：计价时区
   · `pricing.source`：官方价格 JSON 地址（`mingdao update --pricing` 拉取，TTL 默认 7 天，`pricing.ttlDays` 可调）；`pricing.overrides`：按模型覆盖价格
-  · `reasoningEffort`：思考强度 low/high/max（默认模型内置 high；REPL `/think` 切换）
+  · `reasoningByModel`：思考强度按模型独立覆盖，`{ "deepseek-v4-pro": "low" }`（`off`/`low`/`high`/`max`，默认模型内置 high；`off` 显式关闭思考省推理 token；REPL `/think` 或 WebUI 设置「模型与密钥」→ 思考模式开关 + 推理等级）；旧版全局 `reasoningEffort` 仍兼容，优先级低于 `reasoningByModel`
   · `routing.upgradeSteps` / `routing.upgradeTruncated`：粘滞 flash 会话累计步数/截断超过阈值自动升 planner（默认 10 / 2）
   （DeepSeek 官方邮件确认），不触发避峰等待。WebUI 调度面板勾选「🌙 避峰执行」。
 

package/docs/QA-REPORT.md

@@ -5,6 +5,8 @@
 > 版本：0.1.54（历史归档；现行 0.1.x 口径见根 README 与各版本 tag。纯 ESM，零 npm 依赖，Node.js ≥ 18.17）
 > 质检方式：全量源码走读 + 冒烟/端到端测试 + 针对性缺陷验证脚本
 
+> **当前测试规模快照（v0.2.8，随版本持续增长）**：smoke **61 组** · e2e-local **16 项** · e2e-web **21 项** · e2e-schedule **8 项** · api-contracts **8 项** · bench **194 条断言**（tokenizer 16 + routing 118 + compaction 46 + cost 14）。下文 2026-08-18 的「14 组断言」为当时历史口径，已过时——以本快照为准。
+
 ---
 
 ## 一、总体评价

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mingdao-harness",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "description": "MingDao Harness —— 开源智能体框架（Agent Harness）。零依赖、开箱即用，针对 DeepSeek-V4 系列优化，开放主流模型接入。",
   "type": "module",
   "bin": {
@@ -49,7 +49,7 @@
   "scripts": {
     "start": "node src/cli.js",
     "test": "node test/run-all.mjs",
-    "typecheck": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.full.json",
     "prepublishOnly": "node test/smoke.js && node test/e2e-local.js && node test/e2e-schedule.js",
     "desktop": "npm --prefix desktop start",
     "desktop:dist": "node scripts/sync-versions.mjs && npm --prefix desktop run dist:dir",

package/src/agent.js

@@ -28,7 +28,7 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
   const budget = cfg.contextBudget || preset.budgetTokens || 128000;
   const maxOutput = cfg.maxOutputTokens || preset.maxOutputTokens || 8192;
   const temperature = cfg.temperature ?? preset.temperature ?? 0.6;
-  const reasoningEffort = cfg.reasoningEffort ?? preset.reasoningEffort?.default ?? undefined;
+  const reasoningEffort = cfg.reasoningByModel?.[modelName] ?? cfg.reasoningEffort ?? preset.reasoningEffort?.default ?? undefined;
   const hooks = createHooks(cfg.hooks, workingDir);
   const todos = /** @type {any[]} */ ([]);
   // 会话级共享：调用方传入则复用（/model 切换、子代理均共享，undo 不丢失）
@@ -359,6 +359,16 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
       }
 
       if (res.toolCalls?.length) {
+        // v0.2.8 步数上限收尾（对齐 DSH）：末轮仍返回工具调用（无视收尾指令）时不再执行工具——
+        // 有正文直接收尾，无正文跳出循环进入兜底总结，避免再次跑满步数后静默结束。
+        if (steps === stepLimit) {
+          io.endTurn();
+          if (res.text) {
+            messages.push({ role: 'assistant', content: res.text });
+            return { text: res.text, reasoning: res.reasoning || '', usage, steps, finish, truncated: false, aborted: false, durationMs: Date.now() - startedAt, perf: perf() };
+          }
+          break;
+        }
         io.endTurn();
         const assistantMsg = {
           role: 'assistant',
@@ -553,6 +563,15 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
             }
           }
         }
+        // v0.2.8 步数预留收尾（对齐 DSH）：仅剩最后一轮时，工具结果回填后追加收尾指令，
+        // 让模型在末轮输出「总结文字 + 交付物清单」，而非跑满步数后静默结束。
+        if (steps === stepLimit - 1) {
+          messages.push({
+            role: 'user',
+            content:
+              '（系统提示）已达到工具调用步数上限，请停止调用工具，直接输出最终总结：① 已完成的工作；② 交付物清单（文件路径）；③ 遗留问题与后续建议。',
+          });
+        }
       } else {
         io.endTurn();
         // 最终纯文本回复回填消息历史（会话持久化与多轮上下文依赖它）；
@@ -626,6 +645,38 @@ export function createAgent({ provider, permission, io, modelName, workingDir, c
     io.endTurn();
     // 步数上限：清掉未执行的 tool_calls，避免下一轮/恢复后 API 400
     stripOrphanCalls();
+    // v0.2.8 兜底总结（对齐 DSH）：跑满步数/末轮无正文且未中断时，补一次 no-tool 小输出请求，
+    // 让任务以「总结文字 + 交付物清单」收尾，而非静默结束；失败则回退旧行为（text:null）。
+    if (!aborted && messages.length) {
+      try {
+        // stripOrphanCalls 残留的空 assistant（无 tool_calls 且 content 为空）回传会触发 API 400，先清掉
+        const lastMsg = messages[messages.length - 1];
+        if (lastMsg.role === 'assistant' && !lastMsg.content && !Array.isArray(lastMsg.tool_calls)) messages.pop();
+        const wrapReq = [
+          ...trimMessages(messages, budget, count),
+          { role: 'user', content: '（系统提示）任务已执行完毕。请用一段话总结刚才完成的工作，列出交付物（文件路径），并说明遗留问题与后续建议。' },
+        ];
+        currentAc = new AbortController();
+        const wrapRes = await provider.chat({
+          model: activeModel,
+          messages: wrapReq,
+          tools: [],
+          temperature,
+          maxTokens: Math.min(maxOutput, 2048),
+          reasoningEffort: modelPreset(activeModel)?.supportsReasoning ? 'low' : undefined,
+          signal: currentAc.signal,
+          onDelta(/** @type {any} */ d) {
+            if (d.text) io.writeText(d.text);
+          },
+        });
+        if (wrapRes.usage) {
+          usage.prompt_tokens += wrapRes.usage.prompt_tokens || 0;
+          usage.completion_tokens += wrapRes.usage.completion_tokens || 0;
+        }
+        if (wrapRes.text) messages.push({ role: 'assistant', content: wrapRes.text });
+        return { text: wrapRes.text || null, reasoning: wrapRes.reasoning || '', usage, steps, finish, truncated: false, aborted: false, durationMs: Date.now() - startedAt, perf: perf() };
+      } catch {}
+    }
     return { text: null, reasoning: '', usage, steps, finish, truncated: true, aborted: false, durationMs: Date.now() - startedAt, perf: perf() };
     } finally {
       currentAc = null;

package/src/commands/repl.js

@@ -318,13 +318,16 @@ export async function runRepl(ctx) {
         await switchToModel(target);
       } else if (cmd === '/think') {
         const vals = ['low', 'high', 'max'];
+        const cur = cfg.reasoningByModel?.[modelName] ?? cfg.reasoningEffort ?? '跟随模型默认';
         if (!arg) {
-          io.print(`用法：/think low|high|max|off（当前：${cfg.reasoningEffort || '跟随模型默认 high'}）`);
+          io.print(`用法：/think low|high|max|off（当前：${cur}）`);
           continue;
         }
-        if (arg === 'off') cfg.reasoningEffort = 'off'; // 显式禁用（provider 转 thinking:{type:'disabled'}）
-        else if (vals.includes(arg)) cfg.reasoningEffort = arg;
-        else { io.print(style('无效取值：low|high|max|off', C.red)); continue; }
+        if (arg === 'off' || vals.includes(arg)) {
+          cfg.reasoningByModel = cfg.reasoningByModel || {};
+          cfg.reasoningByModel[modelName] = arg; // 按模型独立：只改当前模型（off 转 thinking:{type:'disabled'}）
+          saveConfig(cfg);
+        } else { io.print(style('无效取值：low|high|max|off', C.red)); continue; }
         agent = createAgent({
           provider, permission, io, modelName, workingDir, cfg,
           undoStore: sessionUndoStore, mcp: mcpFacade, sessionRef,
@@ -333,7 +336,7 @@ export async function runRepl(ctx) {
             tuiState.persisted = msgs.length;
           },
         });
-        io.print(style(`✓ 思考强度：${cfg.reasoningEffort || 'off（模型默认）'}`, C.green));
+        io.print(style(`✓ 思考强度（${modelName}）：${cfg.reasoningByModel[modelName]}`, C.green));
       } else if (cmd === '/plan') {
         planMode = !planMode;
         io.print(style(`✓ 计划模式：${planMode ? '开' : '关'}${planMode ? '（先出计划，确认后执行）' : ''}`, C.green));

package/src/session-index.js

@@ -1,36 +1,71 @@
 // 会话检索索引（P3-2）：词表倒排 + 增量同步，替代每次全量扫描全部会话文件。
-// 索引文件 <mingdao-home>/sessions-index.json：
-//   { files: { "<会话名>": { mtime, size, terms: {词: 次数} } } }
+// 索引分片存储（v0.2.8 B1）：<mingdao-home>/sessions-index/<2位sha1前缀>.json ——
+//   每片 { files: { "<会话名>": { mtime, size, terms: {词: 次数} } } }
+// 分片收益：>1000 会话时不再单次 JSON.parse/stringify 一个巨型索引文件；
+//   同步只重写「变脏」的分片，读/写放大与内存峰值都大幅下降（256 片，每片 ~4 个会话）。
 // 同步策略：查询前对每个会话文件做 mtime/size 对比——未变化直接用缓存词表（O(词表)），
 // 变化/新增才重新分词（增量）；已删除文件自动清理；>8MB 超大文件跳过并移除条目。
 // 分词：英文/数字/路径按词（小写），中文按 bigram + 单字，查询串同口径分词后按 AND 匹配。
 
 import fs from 'node:fs';
 import path from 'node:path';
+import crypto from 'node:crypto';
 import { mingdaoHome, ensureHome } from './config.js';
 import { atomicWriteFileSync } from './atomic-write.js';
 
 const INDEX_MAX_FILE = 8 * 1024 * 1024;
+const SHARD_HEX = 2; // sha1 前 2 个十六进制位 → 256 片
 
-export function sessionIndexFile() {
-  return path.join(mingdaoHome(), 'sessions-index.json');
+/** 分片目录（索引分片统一存放于此） */
+export function shardDir() {
+  return path.join(mingdaoHome(), 'sessions-index');
 }
 
-export function loadSessionIndex() {
+/** 会话名 → 分片名（sha1 前 2 位，稳定且均匀） */
+/** @param {any} name */
+export function shardOf(name) {
+  return crypto.createHash('sha1').update(String(name)).digest('hex').slice(0, SHARD_HEX);
+}
+
+/** @param {any} shard */
+function shardFile(shard) {
+  return path.join(shardDir(), `${shard}.json`);
+}
+
+/** @param {any} shard */
+function loadShard(shard) {
   try {
-    const j = JSON.parse(fs.readFileSync(sessionIndexFile(), 'utf8'));
+    const j = JSON.parse(fs.readFileSync(shardFile(shard), 'utf8'));
     return j && typeof j === 'object' && j.files && typeof j.files === 'object' ? j : { files: {} };
   } catch {
     return { files: {} };
   }
 }
 
-/** @param {any} idx */
-export function saveSessionIndex(idx) {
+/** @param {any} shard @param {any} idx */
+function saveShard(shard, idx) {
   try {
     ensureHome();
-    const target = sessionIndexFile();
-    atomicWriteFileSync(target, JSON.stringify(idx) + '\n'); // 质检 H4：索引原子写
+    const dir = shardDir();
+    fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    atomicWriteFileSync(shardFile(shard), JSON.stringify(idx) + '\n'); // 质检 H4：索引原子写
+  } catch {}
+}
+
+// 一次性迁移：旧版单文件 sessions-index.json → 分片目录（迁移后删除旧文件）
+function migrateLegacyIndex() {
+  const legacy = path.join(mingdaoHome(), 'sessions-index.json');
+  if (!fs.existsSync(legacy)) return;
+  try {
+    const j = JSON.parse(fs.readFileSync(legacy, 'utf8'));
+    const files = j && typeof j === 'object' && j.files && typeof j.files === 'object' ? j.files : {};
+    for (const [name, entry] of Object.entries(files)) {
+      const shard = shardOf(name);
+      const idx = loadShard(shard);
+      idx.files[name] = entry;
+      saveShard(shard, idx);
+    }
+    fs.unlinkSync(legacy);
   } catch {}
 }
 
@@ -81,45 +116,99 @@ export function extractSessionText(file) {
   return parts.join('\n');
 }
 
-// 增量同步索引（对比 mtime/size，只重算变化的文件；清理已删除条目）
-/** @param {any} home @param {any} sessions */
+// 增量同步索引（对比 mtime/size，只重算变化的文件；清理已删除条目）。
+// 返回合并后的 { files: {名称: 词表条目} } 供检索匹配（仍只持有所需词表，不再单次解析巨型文件）。
+/** @param {any} home @param {any} sessions
+ * @returns {{ files: Record<string, any> }} */
 export function syncSessionIndex(home, sessions) {
-  const idx = loadSessionIndex();
+  migrateLegacyIndex();
   const dir = path.join(home, 'sessions');
-  let changed = false;
+  /** @type {{ files: Record<string, any> }} */
+  const combined = { files: {} };
+  const liveShards = new Set();
+
+  // 按分片聚合存活会话：每片只 load 一次，命中/变化只写回该片
+  const byShard = new Map();
   for (const s of sessions) {
-    let st;
-    try {
-      st = fs.statSync(s.file);
-    } catch {
-      delete idx.files[s.name];
+    const k = shardOf(s.name);
+    if (!byShard.has(k)) byShard.set(k, []);
+    byShard.get(k).push(s);
+  }
+
+  for (const [k, group] of byShard) {
+    liveShards.add(k);
+    const idx = loadShard(k);
+    let changed = false;
+    for (const s of group) {
+      let st;
+      try {
+        st = fs.statSync(s.file);
+      } catch {
+        delete idx.files[s.name];
+        changed = true;
+        continue;
+      }
+      const cached = idx.files[s.name];
+      if (cached && cached.mtime === st.mtimeMs && cached.size === st.size) continue; // 未变化：直接用缓存
       changed = true;
-      continue;
+      if (st.size > INDEX_MAX_FILE) {
+        delete idx.files[s.name]; // 超大文件不索引
+        continue;
+      }
+      try {
+        idx.files[s.name] = {
+          mtime: st.mtimeMs,
+          size: st.size,
+          terms: Object.fromEntries(tokenize(extractSessionText(s.file))),
+        };
+      } catch {
+        delete idx.files[s.name];
+      }
     }
-    const cached = idx.files[s.name];
-    if (cached && cached.mtime === st.mtimeMs && cached.size === st.size) continue; // 未变化：直接用缓存
-    changed = true;
-    if (st.size > INDEX_MAX_FILE) {
-      delete idx.files[s.name]; // 超大文件不索引
-      continue;
+    // 清理本片内已删除的会话条目（防索引膨胀）
+    for (const name of Object.keys(idx.files)) {
+      if (!fs.existsSync(path.join(dir, name))) {
+        delete idx.files[name];
+        changed = true;
+      }
     }
-    try {
-      idx.files[s.name] = {
-        mtime: st.mtimeMs,
-        size: st.size,
-        terms: Object.fromEntries(tokenize(extractSessionText(s.file))),
-      };
-    } catch {
-      delete idx.files[s.name];
+    if (changed) saveShard(k, idx);
+    // 合并本片存活条目供检索
+    for (const s of group) {
+      const e = idx.files[s.name];
+      if (e) combined.files[s.name] = e;
     }
   }
-  // 清理已删除的会话条目（防索引无限膨胀）
-  for (const name of Object.keys(idx.files)) {
-    if (!fs.existsSync(path.join(dir, name))) {
-      delete idx.files[name];
-      changed = true;
+
+  // 清理「无存活会话」分片里的陈旧条目（这些片的会话全被删了）：目录扫描逐片检查，
+  // 每片都很小；空片直接删除文件，避免残留索引膨胀
+  let entries = [];
+  try {
+    entries = fs.readdirSync(shardDir());
+  } catch {
+    return combined;
+  }
+  for (const f of entries) {
+    if (!f.endsWith('.json')) continue;
+    const k = f.slice(0, -5);
+    if (liveShards.has(k)) continue;
+    const idx = loadShard(k);
+    let changed = false;
+    for (const name of Object.keys(idx.files)) {
+      if (!fs.existsSync(path.join(dir, name))) {
+        delete idx.files[name];
+        changed = true;
+      }
+    }
+    if (changed) {
+      if (Object.keys(idx.files).length) saveShard(k, idx);
+      else {
+        try {
+          fs.unlinkSync(path.join(shardDir(), f));
+        } catch {}
+      }
     }
   }
-  if (changed) saveSessionIndex(idx);
-  return idx;
+
+  return combined;
 }

package/src/tools/fs-tools.js

@@ -3,11 +3,12 @@
 
 import fs from 'node:fs';
 import path from 'node:path';
+import { MAX_FILE_READ_BYTES } from '../web/constants.js';
 
 const MAX_SCAN_FILES = 20000;
 const MAX_GLOB_RESULTS = 1000;
 const MAX_GREP_MATCHES = 250;
-const MAX_FILE_BYTES = 5 * 1024 * 1024;
+const MAX_FILE_BYTES = MAX_FILE_READ_BYTES; // 单源化（v0.2.8 B2）：read/edit 单文件读取上限
 
 /**
  * @param {any} cwd

package/src/web/app.js

@@ -1,3 +1,6 @@
+import { $, esc, highlight, renderMarkdown, scrollBottom, expandableBody, resultText, truncText, fmtDur, fmtTok, fmtT } from './util.js';
+import { MAX_ATTACHMENTS, MAX_IMAGE_BYTES, MAX_TEXT_BYTES } from './constants.js';
+
 // 访问令牌（P1-3）：地址带 ?token= 时记入 sessionStorage 并从地址栏移除（防截图/历史外泄），
 // 之后所有同源请求统一附加 X-MingDao-Token 头；无令牌时行为与旧版一致。
 const AUTH_TOKEN = (() => {
@@ -18,7 +21,52 @@ if (AUTH_TOKEN) {
     return rawFetch(input, init);
   };
 }
-const $ = (s) => document.querySelector(s);
+
+// —— 自绘悬浮气泡 tooltip（替换原生 title：出现快、样式与暗色主题一致） ——
+let tipEl = null;
+function ensureTip() {
+  if (!tipEl) {
+    tipEl = document.createElement('div');
+    tipEl.className = 'mdtip';
+    document.body.appendChild(tipEl);
+  }
+  return tipEl;
+}
+function showTip(text, anchor) {
+  if (!text || !anchor) return;
+  const t = ensureTip();
+  t.textContent = text;
+  t.style.display = 'block';
+  const r = anchor.getBoundingClientRect();
+  const w = t.offsetWidth, h = t.offsetHeight;
+  let left = r.left + r.width / 2 - w / 2;
+  left = Math.max(8, Math.min(left, window.innerWidth - w - 8));
+  let top = r.top - h - 8;
+  if (top < 8) top = r.bottom + 8;
+  t.style.left = left + 'px';
+  t.style.top = top + 'px';
+}
+function hideTip() { if (tipEl) tipEl.style.display = 'none'; }
+function attachTip(el, text) {
+  if (!el || !text) return;
+  el.removeAttribute('title'); // 去掉原生 title，避免双提示
+  const get = typeof text === 'function' ? text : () => text;
+  el.addEventListener('mouseenter', () => showTip(get(), el));
+  el.addEventListener('mouseleave', hideTip);
+  el.addEventListener('focus', () => showTip(get(), el));
+  el.addEventListener('blur', hideTip);
+  el.addEventListener('mousedown', hideTip); // 打开下拉/点击时隐藏，避免遮挡
+}
+window.addEventListener('scroll', hideTip, true);
+
+// 输入区下拉 / 附件按钮：把原生 title 换成自绘气泡（文本取自原 title，一次性读取后移除）
+function initTips() {
+  const perm = $('#permSel'); if (perm) attachTip(perm, perm.getAttribute('title'));
+  const reas = $('#reasoningSel'); if (reas) attachTip(reas, reas.getAttribute('title'));
+  const model = $('#modelSel'); if (model) attachTip(model, () => { const o = model.options[model.selectedIndex]; return (o && o.title) ? o.title : '切换模型'; });
+  const at = $('#attachBtn'); if (at) attachTip(at, at.getAttribute('title'));
+}
+initTips();
 
 // —— 弹窗三件套（Electron 不实现 window.prompt/confirm/alert：prompt 恒返回 null、confirm 恒 false、
 // alert 静默无反应——桌面版「⚙ 设置里点设Key 没反应」即由此而来）。统一替换为应用内模态框。
@@ -125,61 +173,7 @@ chatEl.addEventListener('click', (e) => {
 let generating = false; // 生成中：发送按钮复用为停止按钮
 let currentSession = null, thinking = null;
 
-function esc(s){return String(s??'').replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;').replace(/'/g,'&#39;')}
 
-function highlight(code, lang){
-  const kws = new Set('const let var function return if else for while import from export class new await async try catch throw null undefined true false def elif raise with as lambda None True False self echo exit if then else fi done local function'.split(' '));
-  const re = /(\/\/[^\n]*|#[^\n]*|"(?:\\.|[^"\\])*"|'[^']*'|`[^`]*`|\b\d[\d._]*\b|[A-Za-z_$][\w$]*)/g;
-  return esc(code).replace(re, (tok)=>{
-    if(tok.startsWith('//')||tok.startsWith('#')) return '<span class="hl-c">'+tok+'</span>';
-    if(/^["'`]/.test(tok)) return '<span class="hl-s">'+tok+'</span>';
-    if(/^\d/.test(tok)) return '<span class="hl-n">'+tok+'</span>';
-    if(kws.has(tok)) return '<span class="hl-kw">'+tok+'</span>';
-    return tok;
-  });
-}
-function renderMarkdown(text){
-  // 块级解析（美化：加粗标题 / 段落 / 真列表 / 引用 / 分割线，参照 DeepSeek-Harness 会话排版）
-  const lines = String(text).split('\n');
-  let out = '', code = null, codeLang = '';
-  const flushCode = () => { if (code !== null) { out += '<div class="codeblock"><div class="cb-banner"><span class="cb-lang"><span class="cb-dot"></span>' + (esc(codeLang) || 'code') + '</span><span class="cb-copy" style="cursor:pointer">复制</span></div><pre><code class="lang-' + esc(codeLang) + '">' + highlight(code.join('\n'), codeLang) + '</code></pre></div>'; code = null; } };
-  let para = [];
-  let list = null; // {type:'ul'|'ol', items:[]}
-  const flushPara = () => { if (para.length) { out += '<p>' + para.join('<br>') + '</p>'; para = []; } };
-  const flushList = () => { if (list) { out += '<' + list.type + '>' + list.items.map((i) => '<li>' + i + '</li>').join('') + '</' + list.type + '>'; list = null; } };
-  // 行内元素（审计 P1-3：内容与 codeLang 均经 esc 转义防 XSS）
-  const inline = (l) => {
-    let s = esc(l);
-    s = s.replace(/`([^`]+)`/g, '<code>$1</code>')
-      .replace(/\*\*([^*]+)\*\*/g, '<b>$1</b>')
-      .replace(/\*([^*\s][^*]*)\*/g, '<i>$1</i>')
-      .replace(/\[([^\]]+)\]\((https?:\/\/[^\s'"<>)]+)\)/g, '<a href="$2" target="_blank" rel="noopener">$1</a>');
-    return s;
-  };
-  for (const line of lines) {
-    const t = line.trim();
-    if (t.startsWith('```')) {
-      if (code === null) { flushList(); flushPara(); code = []; codeLang = (t.slice(3).trim().split(/\s+/)[0] || ''); }
-      else flushCode();
-      continue;
-    }
-    if (code !== null) { code.push(line); continue; }
-    if (t === '') { flushList(); flushPara(); continue; }
-    const h = t.match(/^(#{1,6})\s+(.*)$/);
-    if (h) { flushList(); flushPara(); const level = Math.min(h[1].length, 4); out += '<h' + level + '>' + inline(h[2]) + '</h' + level + '>'; continue; }
-    const ul = t.match(/^([-*+])\s+(.*)$/);
-    if (ul) { flushPara(); if (!list || list.type !== 'ul') { flushList(); list = { type: 'ul', items: [] }; } list.items.push(inline(ul[2])); continue; }
-    const ol = t.match(/^(\d+)[.)]\s+(.*)$/);
-    if (ol) { flushPara(); if (!list || list.type !== 'ol') { flushList(); list = { type: 'ol', items: [] }; } list.items.push(inline(ol[2])); continue; }
-    if (/^>\s?/.test(t)) { flushList(); flushPara(); out += '<blockquote>' + inline(t.replace(/^>\s?/, '')) + '</blockquote>'; continue; }
-    if (/^(-{3,}|\*{3,})$/.test(t)) { flushList(); flushPara(); out += '<hr>'; continue; }
-    flushList();
-    para.push(inline(t));
-  }
-  flushCode(); flushList(); flushPara();
-  return out;
-}
-function scrollBottom(){ const sc=document.querySelector('main'); if(sc) sc.scrollTop = sc.scrollHeight; }
 
 function newAiMsg(){ const el=document.createElement('div'); el.className='msg-ai'; chatEl.appendChild(el); scrollBottom(); return el; }
 function aiContent(msg){ const c=msg.querySelector('.content'); return c || (()=>{const d=document.createElement('div');d.className='content';msg.appendChild(d);return d;})(); }
@@ -187,15 +181,6 @@ function addReasoning(msg){ const d=document.createElement('details'); d.classNa
 
 function addUser(text){ const el=document.createElement('div'); el.className='msg-user'; el.innerHTML='<div class="bubble">'+esc(text)+'</div>'; chatEl.appendChild(el); scrollBottom(); }
 
-function expandableBody(previewHtml, fullHtml){
-  const b=document.createElement('div'); b.className='body';
-  const prev=document.createElement('div'); const full=document.createElement('div');
-  prev.innerHTML=previewHtml; full.innerHTML=fullHtml; full.style.display='none';
-  const btn=document.createElement('button'); btn.textContent='展开全文'; btn.style.cssText='padding:1px 8px;font-size:11px;margin-top:4px';
-  btn.onclick=()=>{ const open=full.style.display!=='none'; full.style.display=open?'none':'block'; btn.textContent=open?'展开全文':'收起'; scrollBottom(); };
-  b.appendChild(prev); b.appendChild(full); b.appendChild(btn);
-  return b;
-}
 const runningTools = new Map();
 function renderToolStartEvent(ev){
   const card=document.createElement('div'); card.className='tool';
@@ -302,13 +287,13 @@ let attachments=[];
 $('#attachBtn').onclick=()=>{ $('#fileInput').click(); };
 $('#fileInput').addEventListener('change', async e=>{
   for(const f of e.target.files||[]){
-    if(attachments.length>=4){ uiAlert('最多 4 个附件'); break; }
+    if(attachments.length>=MAX_ATTACHMENTS){ uiAlert('最多 '+MAX_ATTACHMENTS+' 个附件'); break; }
     if(f.type.startsWith('image/')){
-      if(f.size>5*1024*1024){ uiAlert(f.name+' 超过 5MB'); continue; }
+      if(f.size>MAX_IMAGE_BYTES){ uiAlert(f.name+' 超过 5MB'); continue; }
       const dataUrl=await new Promise(r=>{ const fr=new FileReader(); fr.onload=()=>r(fr.result); fr.readAsDataURL(f); });
       attachments.push({type:'image',name:f.name,dataUrl});
     }else if(f.type.startsWith('text/')||/\.(txt|md|json|js|py|log|csv|html|css)$/i.test(f.name)){
-      if(f.size>200*1024){ uiAlert(f.name+' 超过 200KB'); continue; }
+      if(f.size>MAX_TEXT_BYTES){ uiAlert(f.name+' 超过 200KB'); continue; }
       const content=await new Promise(r=>{ const fr=new FileReader(); fr.onload=()=>r(fr.result); fr.readAsText(f); });
       attachments.push({type:'text',name:f.name,content});
     }else{
@@ -420,6 +405,7 @@ function renderWorkStatus(){
   renderLiveBar();
   const el=$('#workStatus'); if(!el) return;
   let html='';
+  let tip='';
   if(generating){
     const secs=curWorkT0?Math.round((Date.now()-curWorkT0)/1000):0;
     html='<span class="ws-busy"><span class="spinner"></span><span class="ws-phase">'+esc(curPhase)+'</span><span>⏳ 第 '+curSteps+' 步 · '+Math.floor(secs/60)+' 分 '+Math.round(secs%60)+' 秒 · '+curTools+' 工具步'+(curTasks>0?' · '+curTasks+' 个子代理':'')+'</span></span>';
@@ -427,12 +413,12 @@ function renderWorkStatus(){
     // 后台任务 chip（非顶部，位于输入框上方）：计数 + 最新任务 + 悬浮详情 tooltip，点击打开详情面板
     const running=bgTasks.filter((/** @type {any} */ t)=>t.status==='running');
     const latest=running.length?running[running.length-1]:null;
-    const tip=bgTasks.map((/** @type {any} */ t)=>(t.kind==='schedule'?'⏰':'🛠')+' '+String(t.message||t.id||'').slice(0,40)+' · '+t.status).join('\n');
-    html='<span class="ws-bg" title="'+esc(String(tip)).replace(/"/g,'&quot;')+'">🛠 '+bgRunning+' 个后台任务运行中'+(latest?' · '+esc(String(latest.message||'').slice(0,22)):'')+' — 点击查看详情</span>';
+    tip=bgTasks.map((/** @type {any} */ t)=>(t.kind==='schedule'?'⏰':'🛠')+' '+String(t.message||t.id||'').slice(0,40)+' · '+t.status).join('\n');
+    html='<span class="ws-bg">🛠 '+bgRunning+' 个后台任务运行中'+(latest?' · '+esc(String(latest.message||'').slice(0,22)):'')+' — 点击查看详情</span>';
   }
   el.style.display=html?'flex':'none';
   el.innerHTML=html;
-  const bg=el.querySelector('.ws-bg'); if(bg) bg.onclick=()=>{ const tp=$('#tasksPanel'); tp.style.display = tp.style.display==='none'?'flex':'none'; if(tp.style.display==='flex'){ $('#trajPanel').style.display='none'; $('#subPanel').style.display='none'; updateTasksPanel(); } syncPanelLayout(); };
+  const bg=el.querySelector('.ws-bg'); if(bg){ bg.onclick=()=>{ const tp=$('#tasksPanel'); tp.style.display = tp.style.display==='none'?'flex':'none'; if(tp.style.display==='flex'){ $('#trajPanel').style.display='none'; $('#subPanel').style.display='none'; updateTasksPanel(); } syncPanelLayout(); }; attachTip(bg, tip); }
 }
 // 顶部常驻活动条（静默完美解决层）：生成期间始终可见，滚动不影响
 function renderLiveBar(){
@@ -498,14 +484,6 @@ function syncPanelLayout(){
   document.body.classList.toggle('sub-open', open('subPanel'));
   document.body.classList.toggle('tasks-open', open('tasksPanel'));
 }
-function resultText(r){
-  if(r==null||r===undefined) return '';
-  if(typeof r==='string') return r;
-  if(r.output) return String(r.output);
-  if(r.stdout||r.stderr) return String(r.stdout||'')+String(r.stderr||'');
-  return JSON.stringify(r);
-}
-function truncText(t,n){ t=String(t||''); return t.length>n?t.slice(0,n)+'\n…（截断，共 '+t.length+' 字）':t; }
 $('#tjClose').onclick=()=>{ $('#trajPanel').style.display='none'; $('#trajRailBtn').classList.remove('on'); syncPanelLayout(); };
 $('#trajRailBtn').onclick=()=>{
   const p=$('#trajPanel');
@@ -602,8 +580,6 @@ async function refreshCostBadge(){
 }
 refreshCostBadge(); setInterval(refreshCostBadge, 15000);
 // 底部状态栏：轮次/步数/LLM 与工具时长/首 token 平均/吞吐/缓存命中/输入输出 tokens
-function fmtDur(ms){ if(!ms) return '0s'; const sec=Math.round(ms/1000); const m=Math.floor(sec/60); return m>0 ? m+'m'+String(sec%60).padStart(2,'0')+'s' : sec+'s'; }
-function fmtTok(n){ if(n>=1e9) return (n/1e9).toFixed(1)+'B'; if(n>=1e6) return (n/1e6).toFixed(0)+'M'; if(n>=1e3) return (n/1e3).toFixed(1)+'K'; return String(n); }
 async function refreshStatusBar(){
   const r=await fetch('/api/cache-stats',{cache:'no-store'}).catch(()=>null); if(!r) return;
   const j=await r.json().catch(()=>null); if(!j) return;
@@ -620,6 +596,18 @@ $('#tpClose').onclick=()=>{ $('#tasksPanel').style.display='none'; syncPanelLayo
 async function refreshSessions(q){ const u=q?'/api/sessions?q='+encodeURIComponent(q):'/api/sessions'; const r=await fetch(u).catch(()=>null); if(!r)return; const j=await r.json(); const sel=$('#sessions'); sel.innerHTML='<option value="">历史会话</option>'; for(const s of j.sessions){ const o=document.createElement('option'); o.value=s.file; o.textContent=s.label; sel.appendChild(o); } if(currentSession&&!q) sel.value=currentSession; }
 let searchTimer=null;
 $('#sessionSearch').addEventListener('input',e=>{ clearTimeout(searchTimer); searchTimer=setTimeout(()=>refreshSessions(e.target.value.trim()),300); });
+// 思考模式 / 推理等级（v0.2.8）：与模型选择并列在输入区，按当前模型独立。
+// 仅 reasoning 模型显示该下拉（关/低/高/最高）；切换模型时随 /api/state 的 reasoning 字段刷新。
+function applyReasoningUI(reasoning){
+  const sel=$('#reasoningSel');
+  if(!sel) return;
+  const supported = Boolean(reasoning && reasoning.supported);
+  sel.style.display = supported ? '' : 'none';
+  if(!supported) return;
+  const effort = reasoning && reasoning.effort ? reasoning.effort : 'high';
+  sel.value = ['off','low','high','max'].includes(effort) ? effort : 'high';
+}
+$('#reasoningSel').onchange=()=>{ applyConfig({reasoningEffort:$('#reasoningSel').value}); };
 async function init(){
   try{
     const r=await fetch('/api/state',{cache:'no-store'}); const j=await r.json();
@@ -628,7 +616,7 @@ async function init(){
     for(const m of (j.models||[])){ const g=m.providerLabel||'其他'; if(!groups[g]){groups[g]=[];order.push(g);} groups[g].push(m); }
     for(const g of order){
       const og=document.createElement('optgroup'); og.label=g;
-      for(const m of groups[g]){ const o=document.createElement('option'); o.value=m.name; o.textContent=m.label; if(m.name===j.model) o.selected=true; og.appendChild(o); }
+      for(const m of groups[g]){ const o=document.createElement('option'); o.value=m.name; o.textContent=m.name; o.title=m.label; if(m.name===j.model) o.selected=true; og.appendChild(o); }
       ms.appendChild(og);
     }
     if(!(j.models||[]).length){ const o=document.createElement('option'); o.value=j.model; o.textContent=j.model; ms.appendChild(o); }
@@ -639,6 +627,7 @@ async function init(){
     $('#budgetInput').value=j.contextBudget||128000;
     $('#autoStartChk').checked=Boolean(j.autostart);
     $('#notifyChk').checked=j.notify!==false;
+    applyReasoningUI(j.reasoning);
     const env = ('路由'+(j.routing?'开':'关')+' · 沙箱'+((j.sandbox&&j.sandbox!=='off')?(j.sandboxSupported?j.sandbox:'降级'):'off'));
     $('#envBadge').textContent=env; $('#envBadge').style.display='';
     // 首次使用引导：无 API Key 时明确提示去设置（桌面版自动初始化后必走这里）
@@ -779,7 +768,6 @@ $('#memDedupe').onclick=async ()=>{
   if(j.ok){ memFlash('✓ 去重完成，移除 '+j.removed+' 行', true); loadMemoryUI(); } else memFlash('✖ '+(j.error||'去重失败'), false);
 };
 // —— 缓存命中率仪表盘 ——
-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='';
@@ -904,12 +892,13 @@ async function reloadModels(){
     for(const m of (j.models||[])){ const g=m.providerLabel||'其他'; if(!groups[g]){groups[g]=[];order.push(g);} groups[g].push(m); }
     for(const g of order){
       const og=document.createElement('optgroup'); og.label=g;
-      for(const m of groups[g]){ const o=document.createElement('option'); o.value=m.name; o.textContent=m.label; if(m.name===j.model) o.selected=true; og.appendChild(o); }
+      for(const m of groups[g]){ const o=document.createElement('option'); o.value=m.name; o.textContent=m.name; o.title=m.label; if(m.name===j.model) o.selected=true; og.appendChild(o); }
       ms.appendChild(og);
     }
     if(!(j.models||[]).length){ const o=document.createElement('option'); o.value=j.model; o.textContent=j.model; ms.appendChild(o); }
     const env=('路由'+(j.routing?'开':'关')+' · 沙箱'+((j.sandbox&&j.sandbox!=='off')?(j.sandboxSupported?j.sandbox:'降级'):'off'));
     $('#envBadge').textContent=env; $('#envBadge').style.display='';
+    applyReasoningUI(j.reasoning);
   }catch(e){}
 }
 async function refreshModelsCfg(){

package/src/web/attachments.js

@@ -4,12 +4,11 @@
 //  - 文本文件：直接拼接进消息文本（≤200KB），并留文件名标注
 //  - 返回 { content（模型消息内容：字符串或图文数组）, persistText（落盘文本）, error }
 
-const MAX_IMAGE_DATAURL = 7 * 1024 * 1024; // base64 膨胀 1.33 倍，对应约 5MB 原图
-const MAX_TEXT = 200 * 1024;
+import { MAX_ATTACHMENTS, MAX_IMAGE_DATAURL, MAX_TEXT_BYTES } from './constants.js';
 
 export function buildUserContent(/** @type {any} */ message, /** @type {any} */ attachments, /** @type {any} */ visionSupported) {
   const text = String(message ?? '').trim();
-  const list = Array.isArray(attachments) ? attachments.slice(0, 4) : [];
+  const list = Array.isArray(attachments) ? attachments.slice(0, MAX_ATTACHMENTS) : [];
   const imageParts = [];
   const persistParts = [];
   let finalText = text;
@@ -31,7 +30,7 @@ export function buildUserContent(/** @type {any} */ message, /** @type {any} */
     } else if (a.type === 'text') {
       const content = String(a.content ?? '');
       if (!content.trim()) continue;
-      if (content.length > MAX_TEXT) {
+      if (content.length > MAX_TEXT_BYTES) {
         return { error: `文本文件过大：${a.name || '未命名'}（≤200KB）` };
       }
       finalText += `${finalText ? '\n\n' : ''}[文件 ${a.name || '未命名'}]\n${content}`;

package/src/web/constants.js

@@ -0,0 +1,9 @@
+// 前端 + 服务端共享常量（零依赖纯 ESM，浏览器与 Node 均可 import）。
+// 单源化（v0.2.8 B2）：附件上限 / 并发上限等数值只在此定义，
+// 防 app.js（客户端预检）/ attachments.js（服务端校验）/ fs-tools.js（读取上限）漂移。
+export const MAX_CONCURRENT = 8; // 并发任务上限（server 与任务面板共用）
+export const MAX_ATTACHMENTS = 4; // 单次最多附件数
+export const MAX_IMAGE_BYTES = 5 * 1024 * 1024; // 单张图片原图上限（5MB）
+export const MAX_IMAGE_DATAURL = 7 * 1024 * 1024; // base64 膨胀 1.33 倍后的 dataURL 上限（≈5MB 原图）
+export const MAX_TEXT_BYTES = 200 * 1024; // 文本附件上限（200KB）
+export const MAX_FILE_READ_BYTES = 5 * 1024 * 1024; // read/edit 工具单文件读取上限（独立语义，非附件上限）

package/src/web/index.html

@@ -94,6 +94,7 @@ header select{flex:none}
 #trajPanel{position:fixed;left:42px;top:52px;bottom:0;width:252px;background:var(--bg2);border-right:1px solid var(--border);z-index:40;display:flex;flex-direction:column;box-shadow:4px 0 24px rgba(0,0,0,.35)}
 .tj-head{padding:12px 14px;font-size:14px;font-weight:600;border-bottom:1px solid var(--border);color:var(--accent2);display:flex;align-items:center;gap:8px}
 .tj-head button{margin-left:auto}
+#tjClose,#sbClose{font-size:12px;white-space:nowrap;padding:3px 10px}
 #tjList{flex:1;overflow-y:auto;padding:8px}
 .tj-turn{color:var(--accent2);font-size:12px;font-weight:600;margin:8px 2px 4px}
 .tj-item{padding:6px 10px;border:1px solid var(--border);border-radius:8px;margin-bottom:6px;font-size:12.5px;background:var(--bg3);cursor:pointer}
@@ -189,10 +190,14 @@ main{flex:1;overflow-y:auto;padding:18px 0 12px;min-width:0}
 .errline{color:var(--err);background:rgba(229,83,75,.08);border:1px solid rgba(229,83,75,.3);border-radius:10px;padding:10px 14px;font-size:13.5px}
 footer{flex:none;border-top:1px solid var(--border);background:var(--bg2);padding:12px 18px}
 #composer{max-width:860px;margin:0 auto;display:flex;gap:10px;align-items:flex-end}
-#input{flex:1;background:var(--bg3);border:1px solid var(--border);border-radius:12px;color:var(--text);padding:10px 14px;font:14px/1.6 inherit;resize:none;min-height:44px;max-height:200px}
+#composer #permSel{max-width:96px;min-width:64px;flex:none;padding:8px 8px}
+#composer #reasoningSel{max-width:64px;min-width:48px;flex:none;padding:8px 6px;font-size:12px}
+#composer #modelSel{max-width:150px;min-width:88px;flex:none;padding:8px 8px;font-size:12px}
+#input{flex:1;background:var(--bg3);border:1px solid var(--border);border-radius:12px;color:var(--text);padding:10px 14px;font:14px/1.6 inherit;resize:none;min-height:44px;max-height:200px;min-width:0}
 #input:focus{outline:none;border-color:var(--accent2)}
 #hint{font-size:11.5px;color:var(--faint);margin-top:6px;max-width:860px;margin-left:auto;margin-right:auto}
 #statusBar{font-size:11.5px;color:var(--faint);margin-top:2px;max-width:860px;margin-left:auto;margin-right:auto;font-variant-numeric:tabular-nums;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+@media (max-width:560px){footer{padding:10px 8px}#composer{gap:6px}#composer #permSel{min-width:52px;padding:8px 4px}#composer #reasoningSel{min-width:44px;padding:8px 4px}#composer #modelSel{min-width:72px;padding:8px 4px}#attachBtn{padding:10px 9px}}
 .modal-mask{position:fixed;inset:0;background:rgba(0,0,0,.55);display:flex;align-items:center;justify-content:center;z-index:50}
 .modal{background:var(--panel);border:1px solid var(--border);border-radius:14px;width:min(520px,92vw);padding:18px;max-height:88vh;overflow-y:auto}
 /* 设置多级菜单（审计：一拉到底改为左侧分组导航 + 右侧面板） */
@@ -221,17 +226,13 @@ footer{flex:none;border-top:1px solid var(--border);background:var(--bg2);paddin
 .spinner{display:inline-block;width:14px;height:14px;border:2px solid var(--accent);border-top-color:transparent;border-radius:50%;animation:spin .8s linear infinite;vertical-align:-2px}
   #scrollBottomBtn{position:fixed;right:26px;bottom:118px;width:40px;height:40px;border-radius:50%;background:linear-gradient(135deg,var(--accent),var(--accent2));color:#06121a;font-size:20px;font-weight:800;border:none;cursor:pointer;box-shadow:0 4px 16px rgba(0,0,0,.45);z-index:30;display:none;align-items:center;justify-content:center}
 @keyframes spin{to{transform:rotate(360deg)}}
+/* 自绘悬浮气泡 tooltip（替换原生 title）：暗色悬浮层 + 阴影，跟随锚点居中，越界自动回弹 */
+.mdtip{position:fixed;z-index:1000;max-width:320px;background:var(--bg3);color:var(--text);border:1px solid var(--border);border-radius:8px;padding:7px 11px;font-size:12px;line-height:1.6;box-shadow:0 8px 24px rgba(0,0,0,.55);pointer-events:none;white-space:pre-line;word-break:break-word;display:none}
 </style>
 </head>
 <body>
 <header>
   <div class="logo">MingDao <span>Harness</span></div>
-  <select id="modelSel" title="切换模型"></select>
-  <select id="permSel" title="权限模式">
-    <option value="ask">权限 ask</option>
-    <option value="auto">权限 auto</option>
-    <option value="readonly">权限 readonly</option>
-  </select>
   <span id="cfgMsg" class="badge" style="display:none"></span>
   <button id="cfgBtn" title="设置">⚙</button>
   <select id="wsSel" title="工作空间（切换 / 新建，目录自动创建）"></select>
@@ -266,6 +267,18 @@ footer{flex:none;border-top:1px solid var(--border);background:var(--bg2);paddin
   <div id="composer">
     <button id="attachBtn" title="上传图片或文本文件（图片需视觉模型，如 deepseek-v4-flash-vision-exp）">📎</button>
     <textarea id="input" rows="1" placeholder="输入任务…（Enter 发送，Shift+Enter 换行）"></textarea>
+    <select id="permSel" title="权限模式：询问＝写文件/执行命令前先确认（推荐） · 自动＝全部直接放行 · 只读＝禁止修改与执行">
+      <option value="ask">询问</option>
+      <option value="auto">自动</option>
+      <option value="readonly">只读</option>
+    </select>
+    <select id="modelSel" title="切换模型"></select>
+    <select id="reasoningSel" title="思考模式（推理等级）：关＝不推理省 token · 低 · 高（默认）· 最高＝最强推理" style="display:none">
+      <option value="off">关</option>
+      <option value="low">低</option>
+      <option value="high">高</option>
+      <option value="max">最高</option>
+    </select>
     <button id="sendBtn" class="primary">发送</button>
   </div>
   <div id="hint"><span id="hintText">工具执行与权限确认会实时展示；生成中可点「中断」停止。</span><label style="margin-left:12px;cursor:pointer;user-select:none"><input type="checkbox" id="journalChk" style="vertical-align:-2px;margin:0 4px 0 0">📌 带上文（最近会话日志，默认关＝新会话全新开始）</label></div>
@@ -442,6 +455,6 @@ footer{flex:none;border-top:1px solid var(--border);background:var(--bg2);paddin
     </div>
   </div>
 </div>
-<script src="/app.js"></script>
+<script type="module" src="/app.js"></script>
 </body>
 </html>

package/src/web/routes/api.js

@@ -31,7 +31,7 @@ export function createApiDispatch(deps) {
     // 访问控制（P1-3/P1-4）：token 校验覆盖数据与操作接口；壳页面与 PWA 静态资源公开
     // （壳不含任何数据，SPA 需要先加载才能读取 ?token=）；Host 白名单覆盖一切请求
     const isStaticAsset =
-      p === '/' || p === '/index.html' || p === '/app.js' || p === '/favicon.ico' || p === '/icon.svg' || p === '/icon-192.png' || p === '/icon-512.png' || p === '/manifest.webmanifest' || p === '/sw.js';
+      p === '/' || p === '/index.html' || p === '/app.js' || p === '/util.js' || p === '/constants.js' || p === '/favicon.ico' || p === '/icon.svg' || p === '/icon-192.png' || p === '/icon-512.png' || p === '/manifest.webmanifest' || p === '/sw.js';
     if (authEnabled && !isStaticAsset && !tokenMatches(requestToken(req, url))) {
       return json(res, 401, { error: '未授权：缺少或无效的访问令牌（地址需带 ?token=…，或请求头携带 X-MingDao-Token）' });
     }
@@ -60,15 +60,17 @@ export function createApiDispatch(deps) {
     }
 
     // —— 静态壳资源（公开；不经过域分发） ——
-    if (method === 'GET' && p === '/app.js') {
-      // 质检 Q2/S5：SPA 外部 JS——从磁盘读取（与 index.html 同目录）
+    // 质检 Q2/S5：SPA 外部 JS——从磁盘读取（与 index.html 同目录）。
+    // v0.2.8 C2：app.js 拆分为 ES Modules（app.js / util.js / constants.js），统一从此处伺服。
+    const WEB_JS_FILES = new Set(['app.js', 'util.js', 'constants.js']);
+    if (method === 'GET' && WEB_JS_FILES.has(p.slice(1))) {
       try {
-        const js = fs.readFileSync(path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'app.js'), 'utf8');
+        const js = fs.readFileSync(path.join(path.dirname(fileURLToPath(import.meta.url)), '..', p.slice(1)), 'utf8');
         res.writeHead(200, { 'Content-Type': 'text/javascript; charset=utf-8', 'Cache-Control': 'no-cache' });
         res.end(js);
       } catch {
         res.writeHead(500, { 'Content-Type': 'text/plain; charset=utf-8' });
-        res.end('app.js 加载失败');
+        res.end(p.slice(1) + ' 加载失败');
       }
       return;
     }
@@ -124,8 +126,8 @@ export function createApiDispatch(deps) {
     }
     if (method === 'GET' && p === '/sw.js') {
       res.writeHead(200, { 'Content-Type': 'application/javascript; charset=utf-8' });
-      // 缓存键去掉 query（?token= 不落缓存）；mingdao-v4：随 token 认证版本升版本号，强制替换旧 SW 缓存
-      res.end(`self.addEventListener('install',()=>self.skipWaiting());self.addEventListener('activate',e=>e.waitUntil(caches.keys().then(ks=>Promise.all(ks.filter(k=>k!=='mingdao-v4').map(k=>caches.delete(k)))).then(()=>clients.claim())));self.addEventListener('fetch',e=>{if(e.request.method==='GET'&&new URL(e.request.url).origin===location.origin&&!e.request.url.includes('/api/')){const u=new URL(e.request.url);u.search='';e.respondWith(fetch(e.request).then(r=>{const c=r.clone();caches.open('mingdao-v4').then(cache=>cache.put(u.toString(),c));return r;}).catch(()=>caches.match(u.toString()).then(m=>m||caches.match('/'))));}});`);
+      // 缓存键去掉 query（?token= 不落缓存）；mingdao-v5：随 token 认证版本升版本号，强制替换旧 SW 缓存
+      res.end(`self.addEventListener('install',()=>self.skipWaiting());self.addEventListener('activate',e=>e.waitUntil(caches.keys().then(ks=>Promise.all(ks.filter(k=>k!=='mingdao-v5').map(k=>caches.delete(k)))).then(()=>clients.claim())));self.addEventListener('fetch',e=>{if(e.request.method==='GET'&&new URL(e.request.url).origin===location.origin&&!e.request.url.includes('/api/')){const u=new URL(e.request.url);u.search='';e.respondWith(fetch(e.request).then(r=>{const c=r.clone();caches.open('mingdao-v5').then(cache=>cache.put(u.toString(),c));return r;}).catch(()=>caches.match(u.toString()).then(m=>m||caches.match('/'))));}});`);
       return;
     }
 

package/src/web/routes/domains/config.js

@@ -6,7 +6,7 @@ import { loadConfig, saveConfig } from '../../../config.js';
 import { setStoredKey, removeStoredKey, getStoredKey, maskKey } from '../../../credentials.js';
 import { availableModels, fetchProviderModels, providerHasKey } from '../../../model-discovery.js';
 import { createProvider, resolveProviderConfig } from '../../../providers/index.js';
-import { MODELS, PROVIDERS } from '../../../models.js';
+import { MODELS, PROVIDERS, modelPreset } from '../../../models.js';
 import { detectSandbox } from '../../../tools/bash.js';
 import { enableAutostart, disableAutostart, autostartStatus } from '../../../autostart.js';
 import { PRICE_DATA_AS_OF } from '../../../pricing.js';
@@ -29,6 +29,14 @@ export async function handle({ req, res, method, p, url }, deps, shared) {
       .map((s) => ({ file: s.name, mtime: s.mtime, label: `${relativeTime(s.mtime)} · ${sessionPreview(s.file)}` }));
     // 模型列表：只列已设置 Key 的服务商，名称以 /models 接口线上名单为准（预设仅回退与补价）
     const models = await availableModels(cfg, state.modelName);
+    // 思考模式 / 推理等级（v0.2.8）：当前模型是否支持 reasoning、当前档位与可选档位。
+    // 按模型独立：reasoningByModel[当前模型] 覆盖 > 全局 reasoningEffort（旧配置兼容）> 模型预设默认。
+    const rp = modelPreset(state.modelName);
+    const reasoning = {
+      supported: Boolean(rp?.supportsReasoning),
+      effort: cfg.reasoningByModel?.[state.modelName] ?? cfg.reasoningEffort ?? rp?.reasoningEffort?.default ?? (rp?.supportsReasoning ? 'high' : 'off'),
+      options: rp?.reasoningEffort?.options ?? ['low', 'high', 'max'],
+    };
     json(res, 200, {
       ok: true,
       model: state.modelName,
@@ -40,6 +48,7 @@ export async function handle({ req, res, method, p, url }, deps, shared) {
       sandbox: cfg.sandbox || 'off',
       sandboxSupported: detectSandbox() !== 'none',
       routing: cfg.routing?.enabled ? cfg.routing : null,
+      reasoning,
       contextBudget: cfg.contextBudget || 128000,
       pricingAsOf: PRICE_DATA_AS_OF,
       autostart: autostartStatus(),
@@ -103,6 +112,15 @@ export async function handle({ req, res, method, p, url }, deps, shared) {
       next.contextBudget = n;
       cfg.contextBudget = n;
     }
+    if (body.reasoningEffort !== undefined) {
+      const re = String(body.reasoningEffort);
+      if (!['off', 'low', 'high', 'max'].includes(re)) {
+        return json(res, 400, { error: '思考强度必须是 off / low / high / max' });
+      }
+      // 按模型独立：写入当前模型的覆盖档位（不污染其他模型）
+      cfg.reasoningByModel = cfg.reasoningByModel || {};
+      cfg.reasoningByModel[state.modelName] = re;
+    }
     let autostartChanged = false;
     if (body.autostart !== undefined) {
       autostartChanged = true;
@@ -121,7 +139,7 @@ export async function handle({ req, res, method, p, url }, deps, shared) {
     cfg.model = next.model;
     cfg.permission = next.permission;
     saveConfig(cfg);
-    json(res, 200, { ok: true, model: state.modelName, permission: cfg.permission, sandbox: cfg.sandbox, routing: cfg.routing?.enabled, contextBudget: cfg.contextBudget, autostart: autostartChanged ? autostartStatus() : undefined, notify: cfg.notify !== false });
+    json(res, 200, { ok: true, model: state.modelName, permission: cfg.permission, sandbox: cfg.sandbox, routing: cfg.routing?.enabled, contextBudget: cfg.contextBudget, reasoningEffort: cfg.reasoningByModel?.[state.modelName] ?? cfg.reasoningEffort, autostart: autostartChanged ? autostartStatus() : undefined, notify: cfg.notify !== false });
     return true;
   }
 

package/src/web/server.js

@@ -25,6 +25,7 @@ import { createProvider, resolveProviderConfig, helperProvider } from '../provid
 import { MODELS, modelPreset, PROVIDERS } from '../models.js';
 import { routeTask, routingConfig } from '../routing.js';
 import { buildUserContent } from './attachments.js';
+import { MAX_CONCURRENT } from './constants.js';
 import { createAgent } from '../agent.js';
 import { createPermission } from '../permissions.js';
 import { buildSystemPrompt } from '../prompts.js';
@@ -217,7 +218,6 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
   };
 
   // 任务注册表：支持多会话并行——每个任务独立的 SSE 流、权限确认、中断控制
-  const MAX_CONCURRENT = 8;
   let inflight = 0; // 质检 S2：在途聊天请求计数（与请求生命周期绑定，防 readBody 期间并发超限）
   const tasks = new Map(); // taskId -> { res, send, abortHandler, pendingAsk, session, startedAt, status, message, durationMs }
   let taskSeq = 0;
@@ -519,7 +519,7 @@ export async function runWebServer({ host = '127.0.0.1', port = 3820, authToken
         durationMs: r.durationMs,
         truncated: r.truncated,
         aborted: r.aborted,
-        note: r.note || (r.text ? '' : `（本轮共执行 ${io.stats().toolCount} 步工具操作${io.stats().deliverables.length ? `、交付 ${io.stats().deliverables.length} 个文件` : ''}，但模型没有输出总结文字——可追问「总结一下刚才的工作」）`),
+        note: r.note || (r.text ? '' : `（任务已执行 ${io.stats().toolCount} 步工具操作${io.stats().deliverables.length ? `、交付 ${io.stats().deliverables.length} 个文件` : ''}，自动收尾总结未能生成——可追问「总结一下刚才的工作」）`),
         stats: io.stats(),
         session: path.basename(session.file),
       });

package/src/web/util.js

@@ -0,0 +1,201 @@
+// 纯前端工具（零状态，仅依赖 DOM/标准 API）：选择器、转义、Markdown 渲染、格式化。
+// 从 app.js 拆分（v0.2.8 C2）：这些函数被消息渲染/轨迹/设置等多处复用，独立成模块便于维护与测试。
+
+export const $ = (s) => document.querySelector(s);
+
+export function esc(s) {
+  return String(s ?? '')
+    .replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#39;');
+}
+
+export function highlight(code, lang) {
+  const kws = new Set(
+    'const let var function return if else for while import from export class new await async try catch throw null undefined true false def elif raise with as lambda None True False self echo exit if then else fi done local function'.split(
+      ' '
+    )
+  );
+  const re = /(\/\/[^\n]*|#[^\n]*|"(?:\\.|[^"\\])*"|'[^']*'|`[^`]*`|\b\d[\d._]*\b|[A-Za-z_$][\w$]*)/g;
+  return esc(code).replace(re, (tok) => {
+    if (tok.startsWith('//') || tok.startsWith('#')) return '<span class="hl-c">' + tok + '</span>';
+    if (/^["'`]/.test(tok)) return '<span class="hl-s">' + tok + '</span>';
+    if (/^\d/.test(tok)) return '<span class="hl-n">' + tok + '</span>';
+    if (kws.has(tok)) return '<span class="hl-kw">' + tok + '</span>';
+    return tok;
+  });
+}
+
+export function renderMarkdown(text) {
+  // 块级解析（美化：加粗标题 / 段落 / 真列表 / 引用 / 分割线，参照 DeepSeek-Harness 会话排版）
+  const lines = String(text).split('\n');
+  let out = '';
+  let code = null;
+  let codeLang = '';
+  const flushCode = () => {
+    if (code !== null) {
+      out +=
+        '<div class="codeblock"><div class="cb-banner"><span class="cb-lang"><span class="cb-dot"></span>' +
+        (esc(codeLang) || 'code') +
+        '</span><span class="cb-copy" style="cursor:pointer">复制</span></div><pre><code class="lang-' +
+        esc(codeLang) +
+        '">' +
+        highlight(code.join('\n'), codeLang) +
+        '</code></pre></div>';
+      code = null;
+    }
+  };
+  let para = [];
+  let list = null; // {type:'ul'|'ol', items:[]}
+  const flushPara = () => {
+    if (para.length) {
+      out += '<p>' + para.join('<br>') + '</p>';
+      para = [];
+    }
+  };
+  const flushList = () => {
+    if (list) {
+      out += '<' + list.type + '>' + list.items.map((i) => '<li>' + i + '</li>').join('') + '</' + list.type + '>';
+      list = null;
+    }
+  };
+  // 行内元素（审计 P1-3：内容与 codeLang 均经 esc 转义防 XSS）
+  const inline = (l) => {
+    let s = esc(l);
+    s = s
+      .replace(/`([^`]+)`/g, '<code>$1</code>')
+      .replace(/\*\*([^*]+)\*\*/g, '<b>$1</b>')
+      .replace(/\*([^*\s][^*]*)\*/g, '<i>$1</i>')
+      .replace(/\[([^\]]+)\]\((https?:\/\/[^\s'"<>)]+)\)/g, '<a href="$2" target="_blank" rel="noopener">$1</a>');
+    return s;
+  };
+  for (const line of lines) {
+    const t = line.trim();
+    if (t.startsWith('```')) {
+      if (code === null) {
+        flushList();
+        flushPara();
+        code = [];
+        codeLang = t.slice(3).trim().split(/\s+/)[0] || '';
+      } else flushCode();
+      continue;
+    }
+    if (code !== null) {
+      code.push(line);
+      continue;
+    }
+    if (t === '') {
+      flushList();
+      flushPara();
+      continue;
+    }
+    const h = t.match(/^(#{1,6})\s+(.*)$/);
+    if (h) {
+      flushList();
+      flushPara();
+      const level = Math.min(h[1].length, 4);
+      out += '<h' + level + '>' + inline(h[2]) + '</h' + level + '>';
+      continue;
+    }
+    const ul = t.match(/^([-*+])\s+(.*)$/);
+    if (ul) {
+      flushPara();
+      if (!list || list.type !== 'ul') {
+        flushList();
+        list = { type: 'ul', items: [] };
+      }
+      list.items.push(inline(ul[2]));
+      continue;
+    }
+    const ol = t.match(/^(\d+)[.)]\s+(.*)$/);
+    if (ol) {
+      flushPara();
+      if (!list || list.type !== 'ol') {
+        flushList();
+        list = { type: 'ol', items: [] };
+      }
+      list.items.push(inline(ol[2]));
+      continue;
+    }
+    if (/^>\s?/.test(t)) {
+      flushList();
+      flushPara();
+      out += '<blockquote>' + inline(t.replace(/^>\s?/, '')) + '</blockquote>';
+      continue;
+    }
+    if (/^(-{3,}|\*{3,})$/.test(t)) {
+      flushList();
+      flushPara();
+      out += '<hr>';
+      continue;
+    }
+    flushList();
+    para.push(inline(t));
+  }
+  flushCode();
+  flushList();
+  flushPara();
+  return out;
+}
+
+export function scrollBottom() {
+  const sc = document.querySelector('main');
+  if (sc) sc.scrollTop = sc.scrollHeight;
+}
+
+export function expandableBody(previewHtml, fullHtml) {
+  const b = document.createElement('div');
+  b.className = 'body';
+  const prev = document.createElement('div');
+  const full = document.createElement('div');
+  prev.innerHTML = previewHtml;
+  full.innerHTML = fullHtml;
+  full.style.display = 'none';
+  const btn = document.createElement('button');
+  btn.textContent = '展开全文';
+  btn.style.cssText = 'padding:1px 8px;font-size:11px;margin-top:4px';
+  btn.onclick = () => {
+    const open = full.style.display !== 'none';
+    full.style.display = open ? 'none' : 'block';
+    btn.textContent = open ? '展开全文' : '收起';
+    scrollBottom();
+  };
+  b.appendChild(prev);
+  b.appendChild(full);
+  b.appendChild(btn);
+  return b;
+}
+
+export function resultText(r) {
+  if (r == null || r === undefined) return '';
+  if (typeof r === 'string') return r;
+  if (r.output) return String(r.output);
+  if (r.stdout || r.stderr) return String(r.stdout || '') + String(r.stderr || '');
+  return JSON.stringify(r);
+}
+
+export function truncText(t, n) {
+  t = String(t || '');
+  return t.length > n ? t.slice(0, n) + '\n…（截断，共 ' + t.length + ' 字）' : t;
+}
+
+export function fmtDur(ms) {
+  if (!ms) return '0s';
+  const sec = Math.round(ms / 1000);
+  const m = Math.floor(sec / 60);
+  return m > 0 ? m + 'm' + String(sec % 60).padStart(2, '0') + 's' : sec + 's';
+}
+
+export function fmtTok(n) {
+  if (n >= 1e9) return (n / 1e9).toFixed(1) + 'B';
+  if (n >= 1e6) return (n / 1e6).toFixed(0) + 'M';
+  if (n >= 1e3) return (n / 1e3).toFixed(1) + 'K';
+  return String(n);
+}
+
+export function fmtT(n) {
+  n = Number(n || 0);
+  return n >= 1000 ? (n / 1000).toFixed(1) + 'k' : String(n);
+}