mingdao-harness 0.2.4 → 0.2.6

package/src/commands/repl.js

@@ -0,0 +1,711 @@
+// 交互式 TUI REPL（Phase C C2：自 cli.js 抽取）。
+// 会话主循环：斜杠命令 + 多行输入 + 回合执行 + 自动压缩/标题/记忆/同步。
+import fs from 'node:fs';
+import path from 'node:path';
+import readline from 'node:readline';
+import { loadConfig, saveConfig, runWizard, ensureHome, mingdaoHome } from '../config.js';
+import { modelPreset, PROVIDERS } from '../models.js';
+import { maskKey, getStoredKey } from '../credentials.js';
+import { createProvider, resolveProviderConfig, helperProvider } from '../providers/index.js';
+import { compactConversation } from '../compact.js';
+import { makeTokenCounter } from '../tokenizer.js';
+import { messageTokens } from '../context.js';
+import { startMcpServers } from '../mcp.js';
+import { startTask, listTasks, patchTask, killTask, formatTaskRow } from '../tasks.js';
+import { enableAutostart, disableAutostart, autostartStatus, autostartPath } from '../autostart.js';
+import { notifyTaskDone } from '../notify.js';
+import { addWorkspace, removeWorkspace, workspacePath, touchWorkspace, listWorkspaces, currentWorkspace } from '../workspace.js';
+import { finalizeSession, extractMemory, loadMemory, appendMemory, recentJournal, dedupeMemory, removeMemoryLines } from '../memory.js';
+import { recordUsage, listCacheStats, summarizeCacheStats, formatCacheSummary, costBreakdown } from '../cachestats.js';
+import { presetList, buildPreset } from '../mcp-presets.js';
+import {
+  addSchedule,
+  listSchedules,
+  readSchedule,
+  removeSchedule,
+  pauseSchedule,
+  resumeSchedule,
+  chainSchedules,
+  reconcileSchedules,
+  runSleeper,
+  formatScheduleRow,
+} from '../schedule.js';
+import { createAgent } from '../agent.js';
+import { createPermission } from '../permissions.js';
+import { buildSystemPrompt } from '../prompts.js';
+import { listSkills, tamperedSkillNames } from '../skills.js';
+import { costGuardStatus } from '../cost-guard.js';
+import { libraryList, searchLibrary, installSkill, uninstallSkill, reinstallSkill, trustSkill } from '../skill-lib.js';
+import { syncLogin, syncLogout, syncPush, syncPull, syncStatus, syncRemoteList, maybeAutoSync, syncChangePassword, syncShareCreate, syncShareList, syncShareAccept, syncShareRevoke, listSyncConflicts, resolveSyncConflict } from '../sync.js';
+import { runWebServer } from '../web/server.js';
+import { routeTask, routingConfig } from '../routing.js';
+import { detectSandbox } from '../tools/bash.js';
+import { generateTitle, renameSessionFile, titleModel } from '../titles.js';
+import { estimateCost, isPeakHour, deferToOffpeak } from '../pricing.js';
+import { createIO, style, C } from '../ui.js';
+import {
+  createSession,
+  latestSession,
+  appendMessages,
+  rewriteSession,
+  loadSession,
+  listSessions,
+  sessionPreview,
+  relativeTime,
+  searchSessions,
+} from '../session.js';
+
+const pkg = JSON.parse(fs.readFileSync(new URL('../../package.json', import.meta.url), 'utf8'));
+
+const HELP_LINES = [
+  [`MingDao Harness · AI 智能体框架 v${pkg.version}（命令：mingdao，简写 mdh）`, C.bold + C.cyan],
+  ['', null],
+  ['用法', C.bold + C.yellow],
+  ['  mingdao                    交互式对话（TUI）', null],
+  ['  mingdao "你的问题"         单次提问（适合脚本与管道）', null],
+  ['  mingdao --format json "…"  单次提问，输出结构化 JSON', null],
+  ['  mingdao web [端口]        启动 WebUI（默认 http://127.0.0.1:3820）', null],
+  ['  mingdao sessions search <词> 全文检索历史会话', null],
+  ['  mingdao run "<任务>"     后台启动任务（tasks 面板管理）', null],
+  ['  mingdao tasks [watch|kill <id>] 查看/实时刷新/停止后台任务', null],
+  ['  mingdao schedule add/list/remove/pause/resume/chain 定时任务与依赖编排', null],
+  ['  mingdao autostart on|off    开机自启（登录后自动启动服务器）', null],
+  ['  mingdao workspace add/list/use/path/remove 工作空间（项目目录登记与快速切换）', null],
+  ['  mingdao --continue         继续最近一次会话', null],
+  ['  mingdao --journal          新会话带上最近会话日志（默认不注入，新会话全新开始）', null],
+  ['  mingdao --resume           从会话列表选择恢复', null],
+  ['  mingdao --model <模型名>   指定模型，例如 deepseek-v4-pro', null],
+  ['  mingdao init               初始化配置向导', null],
+  ['  mingdao update [--check]   一键自更新（git 安装形态；--check 只对比版本）', null],
+  ['  mingdao rollback           回滚到上次 update 之前的提交', null],
+  ['  mingdao audit [数量]       查看工具调用审计日志（默认最近 20 条）', null],
+  ['  mingdao desktop            启动桌面版（Electron，任意目录可用，托盘常驻）', null],
+  ['  mingdao --help / --version 帮助 / 版本', null],
+  ['', null],
+  ['凭证管理（API Key 独立存储，绝不写入 config.json / 仓库）', C.bold + C.yellow],
+  ['  mingdao key                查看凭证状态（脱敏显示）', null],
+  ['  mingdao key set <服务商>   交互式保存 API Key（隐藏输入）', null],
+  ['  mingdao key remove <服务商> 删除凭证', null],
+  ['  mingdao key import         从环境变量导入所有可用 Key', null],
+  ['', null],
+  ['云同步与技能库（跨设备会话同步 / 技能安装）', C.bold + C.yellow],
+  ['  mingdao sync login <用户名> [密码] <服务器地址> 登录云同步（自动注册）', null],
+  ['  mingdao sync push|pull|status|logout  推送 / 拉取 / 状态 / 退出', null],
+  ['  mingdao sync-server [端口] 自建云同步服务器（数据目录 /var/lib/mingdao-sync）', null],
+  ['  mingdao skill search|install|uninstall|update <名称> 技能库（内置 + 线上 registry）', null],
+  ['', null],
+  ['会话内命令', C.bold + C.yellow],
+  ['  /help        显示帮助          /clear   清空上下文', null],
+  ['  /model <名>  切换模型          /mode    pro/flash 快捷切换', null],
+  ['  /compact     压缩上下文        /plan    计划模式（先计划后执行）', null],
+  ['  /init        生成 AGENTS.md    /memory add <内容> 追加用户记忆', null],
+  ['  /skills      列出技能          /status  会话状态 · /cost 累计费用', null],
+  ['  /sessions    历史会话/检索    /route on|off 自动路由开关', null],
+  ['  /mcp         MCP 服务器状态  /verbose 思考开关 · /title <别名> 会话命名', null],
+  ['  /usage       上轮用量          /exit    退出 · /save 会话文件', null],
+  ['  /exit        退出              Tab 补全命令 · Ctrl+C 中断生成', null],
+  ['', null],
+  [`配置目录: ${mingdaoHome()}`, C.dim],
+];
+
+/** @param {any} out */
+function printHelpLines(out) {
+  for (const [text, code] of HELP_LINES) out(code ? style(text, code) : text);
+}
+
+/** @param {any} provider @param {any} modelName @param {any} task */
+async function generatePlan(provider, modelName, task) {
+  const res = await provider.chat({
+    model: modelName,
+    messages: [
+      {
+        role: 'system',
+        content:
+          '你是规划专家。为任务输出可执行计划：步骤列表（注明每步将使用的工具）、涉及的文件、风险点。不要执行任何工具、不要写代码。≤400 字，中文。',
+      },
+      { role: 'user', content: task },
+    ],
+    tools: [],
+    temperature: 0.3,
+    maxTokens: 2048,
+  });
+  return res.text || null;
+}
+
+/**
+ * 交互式 TUI 主循环（cli.js 装配好 provider/permission/agent 后调用）。
+ * 可变状态（modelName/provider/agent）在 ctx 上传递：切换模型时重建。
+ * @param {any} ctx
+ */
+export async function runRepl(ctx) {
+  const { io, cfg, home, pc0, opts, permission, workingDir, sessionUndoStore, mcpFacade, sessionRef, preset, withJournal, tuiState } = ctx;
+  let mcpManager = ctx.mcpManager;
+  let modelName = ctx.modelName;
+  let provider = ctx.provider;
+  let agent = ctx.agent;
+
+  // —— 交互式 TUI ——
+  const storedKey = getStoredKey(pc0.name);
+  const envKeyDetected = (pc0.envHint && process.env[pc0.envHint]) || process.env.MINGDAO_API_KEY;
+  const keySource = envKeyDetected ? '环境变量' : storedKey ? `凭证库 ${maskKey(storedKey)}` : 'config 字段';
+  const sandboxMode = cfg.sandbox || 'off';
+  const sandboxLabel =
+    sandboxMode === 'off' ? 'off' : detectSandbox() === 'bwrap' ? sandboxMode : `${sandboxMode}（bwrap 缺失，已降级）`;
+  const routing = routingConfig(cfg);
+  const wsNow = currentWorkspace(workingDir);
+  io.print('');
+  io.box(`MingDao Harness v${pkg.version}`, [
+    `模型  ${modelName}${preset?.label ? '（' + preset.label + '）' : ''}`,
+    `权限  ${permission.mode} · 密钥  ${keySource}`,
+    `沙箱  ${sandboxLabel}${routing ? ` · 路由  ${routing.planner}⇄${routing.executor}` : ''}`,
+    wsNow ? `工作空间  ${wsNow.name}（${wsNow.dir}）` : '',
+  ].filter(Boolean));
+  io.print(style('输入问题开始对话 · /help 查看命令 · Tab 补全 · Ctrl+C 中断生成\n', C.dim));
+
+  // WebUI 自动启动（首次运行 mingdao web 时可选开启，存 config.web.autoStart）：
+  // 独立后台进程拉起，退出 TUI 后 WebUI 继续可用；关闭：mingdao web --no-autostart
+  if (cfg.web?.autoStart && !process.env.MINGDAO_NO_WEB_AUTOSTART) {
+    try {
+      const { spawn } = await import('node:child_process');
+      const { fileURLToPath } = await import('node:url');
+      const child = spawn(process.execPath, [fileURLToPath(import.meta.url), 'web'], {
+        detached: true,
+        stdio: 'ignore',
+        env: process.env,
+      });
+      child.on('error', (err) => io.print(style(`[WebUI 自启失败] ${err?.message || err}（可手动运行 mingdao web ${cfg.web?.port || 3820}）`, C.red)));
+      child.unref();
+      io.print(style(`🌐 WebUI 后台启动中：http://127.0.0.1:${cfg.web?.port || 3820}（关闭自动启动：mingdao web --no-autostart）`, C.dim));
+    } catch (/** @type {any} */ err) {
+      io.print(style(`[WebUI 自启失败] ${err?.message || err}`, C.red)); // 质检 L6：不再静默吞掉
+    }
+  }
+
+  /** @type {any} */
+  let session = null;
+  if (opts.resume) {
+    const list = listSessions(home).slice(0, 10);
+    if (!list.length) {
+      io.print(style('没有可恢复的历史会话，已新建。', C.dim));
+    } else {
+      const choice = await io.choose(
+        '选择要恢复的会话：',
+        list.map((s) => ({ value: s.file, label: `${relativeTime(s.mtime)} · ${sessionPreview(s.file)}` }))
+      );
+      const loaded = loadSession(choice);
+      if (loaded.messages.length) {
+        session = loaded;
+        io.print(style(`✓ 已载入会话 ${path.basename(choice)}（${loaded.messages.length} 条消息）`, C.green));
+      }
+    }
+  }
+  if (!session && opts.continueSession) {
+    const latest = latestSession(home);
+    if (latest) {
+      const loaded = loadSession(latest.file);
+      if (loaded.messages.length) {
+        session = loaded;
+        io.print(style(`已载入会话 ${latest.name}（${loaded.messages.length} 条消息）`, C.dim));
+      }
+    }
+    if (!session) io.print('没有可继续的历史会话，已新建。');
+  }
+  if (!session) session = createSession(home);
+  tuiState.session = session;
+  sessionRef.name = path.basename(session.file);
+  io.print(style(`会话  ${path.basename(session.file)}`, C.dim));
+
+  const systemPrompt = buildSystemPrompt({ modelName, workingDir, withJournal });
+  // 恢复会话时刷新 system prompt（用户记忆 / AGENTS.md / 技能清单 / 时间戳以当前为准），
+  // 旧 system 消息保留在会话文件中，不影响追加历史。
+  const loadedMsgs = session.messages || [];
+  const hasOldSystem = loadedMsgs[0]?.role === 'system';
+  let messages = hasOldSystem
+    ? [{ role: 'system', content: systemPrompt }, ...loadedMsgs.slice(1)]
+    : [{ role: 'system', content: systemPrompt }, ...loadedMsgs];
+  tuiState.persisted = messages.length;
+  let lastUsage = null;
+  let lastText = '';
+  let planMode = false;
+  let routingEnabled = Boolean(routing);
+  let lastRouteModel = null; // 会话级路由粘滞（评估 P2-1：执行类会话不再逐轮分类）
+  let autoTitled = Boolean(session.messages?.length);
+  const stats = { turns: 0, promptTokens: 0, completionTokens: 0 };
+  io.setHistory(messages.filter((m) => m.role === 'user').map((m) => m.content));
+
+  /** @param {any} target */
+  async function switchToModel(target, { silent = false, persist = true } = {}) {
+    try {
+      const npc = resolveProviderConfig(cfg, target);
+      if (!npc.apiKey) {
+        io.print(style('该模型没有可用的 API Key，请先运行 mingdao init 配置。', C.red));
+        return false;
+      }
+      const newProvider = await createProvider(cfg, target);
+      provider = newProvider;
+      modelName = target;
+      // 自动路由的切换只改会话内存态（评估 P3-6：不悄悄改写用户持久默认模型）；/model 显式切换才落盘
+      if (persist) {
+        cfg.model = target;
+        saveConfig(cfg);
+      }
+      agent = createAgent({
+        provider,
+        permission,
+        io,
+        modelName,
+        workingDir,
+        cfg,
+        undoStore: sessionUndoStore,
+        mcp: mcpFacade,
+        sessionRef,
+        onCompact: (/** @type {any} */ msgs) => {
+          rewriteSession(session.file, msgs);
+          tuiState.persisted = msgs.length;
+        },
+      });
+      messages[0] = { role: 'system', content: buildSystemPrompt({ workingDir, withJournal }) };
+      if (!silent) {
+        const p2 = modelPreset(modelName);
+        io.print(style(`✓ 已切换到 ${C.bold}${modelName}${C.reset}${p2 ? `（${p2.label}）` : ''}`, C.green));
+      }
+      return true;
+    } catch (/** @type {any} */ err) {
+      io.print(style('[错误] ' + (err?.message || err), C.red));
+      return false;
+    }
+  }
+
+  for (;;) {
+    let input;
+    try {
+      input = await io.askMultiline(style('你> ', C.green));
+    } catch {
+      break;
+    }
+    if (input === '') continue;
+
+    if (input.startsWith('/')) {
+      const [cmd, ...rest] = input.split(/\s+/);
+      const arg = rest.join(' ');
+      // 审计（第五轮 P1-1 教训）：斜杠命令统一 try/catch——单条命令异常只提示不退出，
+      // 绝不再因一条命令的错误杀死整个 REPL 会话（历史 P1-1 曾导致会话上下文全丢）
+      try {
+      if (cmd === '/exit' || cmd === '/quit') break;
+      else if (cmd === '/help') printHelpLines(io.print);
+      else if (cmd === '/clear') {
+        messages = [{ role: 'system', content: systemPrompt }];
+        // 评估 P2-1：会话文件同步原子重写为仅新 system——否则旧上下文残留会被 --continue 读回，
+        // 且后续 appendMessages 会把 system+新消息重复追加到旧历史之后。
+        try {
+          rewriteSession(session.file, messages);
+        } catch {}
+        tuiState.persisted = messages.length;
+        io.print('已清空上下文（会话文件已同步重置）。');
+      } else if (cmd === '/model') {
+        if (!arg) {
+          io.print(`当前模型：${modelName}`);
+          continue;
+        }
+        await switchToModel(arg);
+      } else if (cmd === '/mode') {
+        const map = { pro: 'deepseek-v4-pro', flash: 'deepseek-v4-flash' };
+        const target = /** @type {Record<string, any>} */ (map)[arg] || arg;
+        if (!target) {
+          io.print('用法：/mode pro|flash|<模型名>（pro=deepseek-v4-pro，flash=deepseek-v4-flash）');
+          continue;
+        }
+        await switchToModel(target);
+      } else if (cmd === '/think') {
+        const vals = ['low', 'high', 'max'];
+        if (!arg) {
+          io.print(`用法：/think low|high|max|off（当前：${cfg.reasoningEffort || '跟随模型默认 high'}）`);
+          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; }
+        agent = createAgent({
+          provider, permission, io, modelName, workingDir, cfg,
+          undoStore: sessionUndoStore, mcp: mcpFacade, sessionRef,
+          onCompact: (/** @type {any} */ msgs) => {
+            rewriteSession(session.file, msgs);
+            tuiState.persisted = msgs.length;
+          },
+        });
+        io.print(style(`✓ 思考强度：${cfg.reasoningEffort || 'off（模型默认）'}`, C.green));
+      } else if (cmd === '/plan') {
+        planMode = !planMode;
+        io.print(style(`✓ 计划模式：${planMode ? '开' : '关'}${planMode ? '（先出计划，确认后执行）' : ''}`, C.green));
+      } else if (cmd === '/route') {
+        if (!routing) {
+          io.print(style('未配置自动路由（config.json 的 routing 字段，如 {"enabled":true,"planner":"deepseek-v4-pro","executor":"deepseek-v4-flash"}）', C.dim));
+          continue;
+        }
+        if (arg === 'on' || arg === 'off') routingEnabled = arg === 'on';
+        else routingEnabled = !routingEnabled;
+        io.print(style(`✓ 自动路由：${routingEnabled ? '开' : '关'}（规划类→${routing.planner}，执行类→${routing.executor}）`, C.green));
+      } else if (cmd === '/verbose') {
+        io.setShowReasoning(!io.showReasoning);
+        io.print(style(`✓ 思考过程显示：${io.showReasoning ? '开' : '关'}`, C.green));
+      } else if (cmd === '/compact') {
+        if (messages.length <= 6) {
+          io.print(style('消息较少（≤6 条），无需压缩。', C.dim));
+          continue;
+        }
+        io.startSpinner('正在压缩上下文…');
+        let compacted = null;
+        try {
+          const count = makeTokenCounter(modelName);
+          let total = 0;
+          for (const m of messages) total += messageTokens(m, count);
+          const budget = Math.max(1000, Math.round(total * 0.5)); // 手动触发：保留约 30% 尾部
+          compacted = await compactConversation({
+            messages,
+            budget,
+            count,
+            provider,
+            executorModel: modelName,
+            triggerRatio: 0,
+            force: true, // 手动意图明确：跳过最小裁剪门槛
+          });
+        } catch (/** @type {any} */ err) {
+          io.print(style('[压缩失败] ' + (err?.message || err), C.red));
+        }
+        io.stopSpinner();
+        if (!compacted?.messages) {
+          io.print(style('未能压缩（被裁段落不足或摘要失败）。', C.dim));
+          continue;
+        }
+        messages = compacted.messages;
+        appendMessages(session.file, [{ role: 'system', content: '── /compact 压缩点 ──' }, ...messages.slice(1)]);
+        tuiState.persisted = messages.length;
+        io.print(style(`✓ 已压缩上下文：${compacted.droppedCount} 条早期消息 → 摘要（回收约 ${compacted.droppedTokens} tokens）`, C.green));
+      } else if (cmd === '/init') {
+        const target = path.join(workingDir, 'AGENTS.md');
+        if (fs.existsSync(target) && arg !== 'force') {
+          io.print(style(`已存在 ${target}，如需覆盖：/init force`, C.yellow));
+          continue;
+        }
+        const entries = fs.readdirSync(workingDir).slice(0, 20).join('、') || '（空目录）';
+        const template =
+          `# ${path.basename(workingDir)} 项目约定\n\n` +
+          `## 项目概述\n\n（一句话说明项目用途）\n\n` +
+          `## 常用命令\n\n（构建、测试、运行命令）\n\n` +
+          `## 代码结构\n\n顶层内容：${entries}\n\n` +
+          `## 约定与规范\n\n（团队约定、注意事项；MingDao 每次会话会自动读取本文件）\n`;
+        fs.writeFileSync(target, template);
+        io.print(style(`✓ 已生成 ${target}，将在后续会话自动注入。`, C.green));
+      } else if (cmd === '/memory') {
+        const memPath = path.join(mingdaoHome(), 'AGENTS.md');
+        if (arg.startsWith('add ')) {
+          const text = arg.slice(4).trim();
+          if (!text) {
+            io.print('用法：/memory add <内容>');
+            continue;
+          }
+          fs.appendFileSync(memPath, `- ${text}\n`);
+          io.print(style(`✓ 已追加到用户记忆 ${memPath}（后续会话自动生效）`, C.green));
+        } else if (arg === 'extract') {
+          io.startSpinner('正在从当前对话提炼记忆…');
+          try {
+            const existing = loadMemory();
+            const lines = await extractMemory(provider, titleModel(cfg, modelName), messages, existing);
+            io.stopSpinner();
+            if (lines.length) {
+              appendMemory(lines);
+              io.print(style(`✓ 新增 ${lines.length} 条记忆：`, C.green));
+              for (const l of lines) io.print(style('  ' + l, C.dim));
+            } else {
+              io.print(style('没有发现新的值得记住的内容。', C.dim));
+            }
+          } catch (/** @type {any} */ err) {
+            io.stopSpinner();
+            io.print(style('[错误] ' + (err?.message || err), C.red));
+          }
+        } else if (arg === 'show') {
+          const raw = loadMemory();
+          if (!raw.trim()) {
+            io.print('记忆库为空。');
+          } else {
+            io.print(style('记忆库（' + memPath + '）：', C.bold));
+            raw.split('\n').forEach((l, i) => {
+              if (l.trim()) io.print(style(`  ${String(i + 1).padStart(3)}  ${l}`, C.dim));
+            });
+          }
+        } else if (arg.startsWith('remove ')) {
+          const kw = arg.slice(7).trim();
+          if (!kw) {
+            io.print('用法：/memory remove <关键词>（删除包含该词的条目）');
+            continue;
+          }
+          const removed = removeMemoryLines(kw);
+          io.print(removed > 0 ? style(`✓ 已删除 ${removed} 条（原文件备份于 ${memPath}.bak）`, C.green) : style('没有匹配的条目。', C.dim));
+        } else if (arg === 'dedupe') {
+          const removed = dedupeMemory();
+          io.print(removed > 0 ? style(`✓ 去重完成：合并 ${removed} 条重复记忆`, C.green) : style('没有重复条目。', C.dim));
+        } else if (arg === 'edit') {
+          const editor = process.env.EDITOR || process.env.VISUAL;
+          if (!editor) {
+            io.print(style('未设置 EDITOR 环境变量。可 export EDITOR=nano（或 vim/code）后用 /memory edit 打开记忆文件。', C.yellow));
+            continue;
+          }
+          const { spawnSync } = await import('node:child_process');
+          spawnSync(editor, [memPath], { stdio: 'inherit' });
+          io.print(style('✓ 记忆文件已编辑（后续会话自动生效）。', C.green));
+        } else {
+          io.print(style(`用户记忆文件：${memPath}${fs.existsSync(memPath) ? '' : '（尚不存在）'}`, C.dim));
+          if (fs.existsSync(memPath)) io.print(style(fs.readFileSync(memPath, 'utf8').slice(0, 2000), C.dim));
+          const journal = recentJournal(home, 5);
+          if (journal.length) {
+            io.print(style('最近会话：', C.bold));
+            for (const e of journal.reverse()) io.print(style(`  ${new Date(e.at).toISOString().slice(0, 10)} ${e.firstUser?.slice(0, 40)}`, C.dim));
+          }
+          io.print('用法：/memory add <内容> 追加 · extract 自动提炼 · show 查看 · remove <词> 删除 · dedupe 去重 · edit 编辑器修改');
+        }
+      } else if (cmd === '/skills') {
+        const skills = listSkills(workingDir);
+        if (!skills.length) {
+          io.print(
+            style(
+              '未安装技能。目录：~/.mingdao/skills/（用户级）、<项目>/.mingdao/skills/（项目级）与内置技能库',
+              C.dim
+            )
+          );
+          continue;
+        }
+        const label = (/** @type {any} */ s) => `${s.name}${s.source === 'user' ? '（用户级）' : s.source === 'builtin' ? '（内置）' : ''}`;
+        io.box(
+          `已安装技能（${skills.length}）`,
+          skills.map((s) => `${label(s)}：${s.description || '（无描述）'}`)
+        );
+        io.print(style(`技能库安装：退出会话后运行 mingdao skill search [关键词] → mingdao skill install <名称>`, C.dim));
+      } else if (cmd === '/title') {
+        if (!arg) {
+          io.print('用法：/title <别名>（给当前会话命名，便于 --resume 识别）');
+          continue;
+        }
+        const safe = arg.replace(/[^\w\u4e00-\u9fa5.-]/g, '_').slice(0, 40);
+        let newFile = path.join(home, 'sessions', safe + '.jsonl');
+        try {
+          fs.appendFileSync(session.file, ''); // 确保文件已创建（尚未写消息时也可能重命名）
+          // 同名会话已存在时附加随机后缀，绝不静默覆盖
+          if (fs.existsSync(newFile)) {
+            newFile = path.join(home, 'sessions', safe + '-' + Math.random().toString(36).slice(2, 6) + '.jsonl');
+          }
+          fs.renameSync(session.file, newFile);
+          session.file = newFile;
+          io.print(style(`✓ 会话已命名为 ${path.basename(newFile)}`, C.green));
+        } catch (/** @type {any} */ err) {
+          io.print(style('[错误] ' + (err?.message || err), C.red));
+        }
+      } else if (cmd === '/audit') {
+        const n = Number(arg) || 10;
+        const { listAudit } = await import('../audit.js');
+        const rows = listAudit(n);
+        if (!rows.length) {
+          io.print(style('暂无审计记录（工具调用会自动记录）。', C.dim));
+          continue;
+        }
+        io.print(style(`最近 ${rows.length} 条工具调用审计：`, C.bold));
+        for (const r of rows) {
+          const when = new Date(r.at).toISOString().slice(0, 19).replace('T', ' ');
+          const status = r.denied ? `✖拒绝(${r.reason || ''})` : r.ok ? '✓' : '✖错误';
+          io.print(`  ${when}  ${status}  ${r.tool}  ${String(r.args || '').slice(0, 60)}`);
+        }
+      } else if (cmd === '/mcp') {
+        const status = mcpFacade.status();
+        if (status.length === 1 && status[0].name === '（连接中…）' && !status[0].ok && !mcpManager) {
+          if (!cfg.mcpServers || !Object.keys(cfg.mcpServers).length) {
+            io.print(style('未配置 MCP 服务器（config.json 的 mcpServers 字段）。', C.dim));
+          } else {
+            io.print(style('MCP 服务器连接中…（npx 首次下载依赖可能较慢）', C.dim));
+          }
+          continue;
+        }
+        io.box(
+          `MCP 服务器（${status.length}）`,
+          status.map((/** @type {any} */ s) => `${s.ok ? '✓' : '✖'} ${s.name}${s.ok ? ` · ${s.tools} 个工具` : `：${s.error}`}`)
+        );
+      } else if (cmd === '/sessions') {
+        if (arg) {
+          // 关键词全文检索历史会话
+          const hits = /** @type {any[]} */ (searchSessions(home, arg));
+          if (!hits.length) {
+            io.print(style(`未找到包含「${arg}」的会话。`, C.dim));
+          } else {
+            io.box(`会话检索：${arg}（${hits.length} 个命中）`, hits.map((h) => `${h.name}（${relativeTime(h.mtime)}）`));
+            for (const h of hits.slice(0, 5)) io.print(style(`  ${h.snippet}`, C.dim));
+            io.print(style('恢复：mingdao --resume（或 mingdao sessions search 命令）', C.dim));
+          }
+        } else {
+          const list = listSessions(home).slice(0, 10);
+          if (!list.length) io.print('暂无历史会话。');
+          else {
+            io.box('历史会话（最近 10 个）', list.map((s) => `${relativeTime(s.mtime)} · ${sessionPreview(s.file)}`));
+            io.print(style('检索：/sessions <关键词> · 恢复：mingdao --resume（文件：' + path.join(home, 'sessions') + '）', C.dim));
+          }
+        }
+      } else if (cmd === '/save') {
+        io.print(`当前会话自动保存于：${session.file}`);
+      } else if (cmd === '/usage') {
+        if (lastUsage) {
+          io.print(
+            style(
+              `上轮用量：${lastUsage.prompt_tokens} prompt + ${lastUsage.completion_tokens} completion tokens`,
+              C.dim
+            )
+          );
+        } else io.print('尚无用量记录。');
+      } else if (cmd === '/status') {
+        io.box('会话状态', [
+          `模型  ${modelName} · 权限 ${permission.mode}`,
+          `沙箱  ${cfg.sandbox || 'off'}${routing ? ` · 自动路由  ${routingEnabled ? '开' : '关'}（${routing.planner}⇄${routing.executor}）` : ''}`,
+          `会话  ${path.basename(session.file)}`,
+          `轮次  ${stats.turns} · 消息 ${messages.length} 条`,
+          `Tokens  ↑${stats.promptTokens} ↓${stats.completionTokens}`,
+          `费用  ≈¥${estimateCost(modelName, stats.promptTokens, stats.completionTokens).toFixed(5)}（累计·按当前模型计价）`,
+          `计划模式  ${planMode ? '开' : '关'} · 思考显示  ${io.showReasoning ? '开' : '关'} · 任务 ${agent.getTodos().length} 项`,
+        ]);
+      } else if (cmd === '/cost') {
+        const bd = costBreakdown();
+        io.box('费用分账（含缓存折扣与 Batch 半价的真实口径）', [
+          `累计  ≈¥${bd.totalCost.toFixed(5)} · 今日 ≈¥${bd.today.toFixed(5)}` +
+            `${bd.totalSaved > 0 ? ` · 相比全未命中已省 ≈¥${bd.totalSaved.toFixed(5)}` : ''}`,
+          `缓存命中率  ${bd.rate != null ? (bd.rate * 100).toFixed(0) + '%' : '暂无缓存数据'}${bd.batchCost > 0 ? ` · Batch 半价任务 ≈¥${bd.batchCost.toFixed(5)}` : ''}`,
+          ...bd.byModel.slice(0, 8).map((m) => `  ${m.model}：${m.turns} 轮（${m.batchTurns ? m.batchTurns + ' 批' : ''}）· ↑${m.prompt} ↓${m.completion} · ≈¥${m.cost.toFixed(5)}${m.saved > 0 ? ` · 省 ¥${m.saved.toFixed(5)}` : ''}`),
+        ]);
+        const guard = costGuardStatus();
+        if (guard) {
+          io.print(
+            style(
+              `费用护栏：今日 ¥${(guard.cost ?? 0).toFixed(4)} / 上限 ¥${guard.limit.toFixed(2)}${guard.overLimit ? '（已达上限' + (guard.action === 'block' ? '，执行已暂停' : '，仅提醒') + '）' : ''}`,
+              guard.overLimit ? C.yellow : C.dim
+            )
+          );
+        }
+        io.print(style('会话内累计（本次）≈¥' + estimateCost(modelName, stats.promptTokens, stats.completionTokens).toFixed(5), C.dim));
+      } else if (cmd === '/cache') {
+        const entries = listCacheStats();
+        if (!entries.length) {
+          io.print(style('暂无缓存统计（对话若干轮后自动累积）。', C.dim));
+          continue;
+        }
+        const sum = summarizeCacheStats(entries);
+        io.box('缓存命中率仪表盘', formatCacheSummary(sum));
+        io.print(style('近 10 次命中率趋势：', C.dim));
+        const recent = entries.slice(-10);
+        const maxBar = 24;
+        for (const e of recent) {
+          const rate = e.hit != null && e.hit + e.miss > 0 ? e.hit / (e.hit + e.miss) : null;
+          const bar = rate == null ? '—'.repeat(maxBar) : '█'.repeat(Math.round(rate * maxBar));
+          io.print(style(`  ${bar.padEnd(maxBar)} ${rate == null ? 'n/a' : (rate * 100).toFixed(0) + '%'}  ${e.model}`, C.dim));
+        }
+      } else {
+        io.print(style('未知命令，输入 /help 查看可用命令。', C.yellow));
+      }
+      continue;
+      } catch (/** @type {any} */ err) {
+        io.print(style('[错误] 命令执行失败：' + (err?.message || err), C.red));
+        continue;
+      }
+    }
+
+    // 自动路由：规划类任务切 planner，执行类走 executor（会话粘滞 + 分类缓存见 routing.js）
+    if (routingEnabled) {
+      const route = await routeTask({ cfg, provider, currentModel: modelName, text: input, sticky: lastRouteModel });
+      lastRouteModel = route.model;
+      if (route.model !== modelName) {
+        const okSwitch = await switchToModel(route.model, { silent: true, persist: false });
+        if (okSwitch) io.print(style(`⤷ 自动路由 → ${route.model}（${route.reason}）`, C.dim));
+      }
+    }
+
+    // 计划模式：先出计划，确认后执行
+    if (planMode) {
+      io.startSpinner('正在生成计划…');
+      let plan = null;
+      try {
+        plan = await generatePlan(provider, modelName, input);
+      } catch (/** @type {any} */ err) {
+        io.print(style('[计划生成失败] ' + (err?.message || err), C.red));
+      }
+      io.stopSpinner();
+      if (plan == null) continue;
+      io.print(style('── 执行计划 ──', C.bold + C.cyan));
+      io.print(plan);
+      const okGo = await io.confirm(style('是否按此计划执行？[y/N]', C.yellow));
+      if (!okGo) {
+        io.print(style('已取消执行，可修改要求后重试。', C.dim));
+        continue;
+      }
+      const planMsg = { role: 'assistant', content: '[执行计划]\n' + plan };
+      messages.push(planMsg);
+      appendMessages(session.file, [planMsg]);
+      tuiState.persisted += 1;
+    }
+
+    const userMsg = { role: 'user', content: input };
+    messages.push(userMsg);
+    appendMessages(session.file, [userMsg]);
+    tuiState.persisted += 1;
+
+    try {
+      const res = await agent.runTurn(messages);
+      lastUsage = res.usage;
+      lastText = res.text || lastText;
+      stats.turns += 1;
+      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(tuiState.persisted);
+      appendMessages(session.file, fresh);
+      tuiState.persisted = messages.length;
+      if (!autoTitled && cfg.autoTitle !== false && res.text) {
+        autoTitled = true;
+        const tModel = titleModel(cfg, modelName);
+        const title = await generateTitle(await helperProvider(cfg, tModel, provider), tModel, input);
+        if (title) {
+          const renamed = renameSessionFile(fs, path, home, session, title);
+          if (renamed) io.print(style(`✓ 会话标题：${path.basename(renamed)}`, C.dim));
+        }
+      }
+      if (res.aborted) {
+        io.print(style('（已中断）', C.dim));
+      }
+      if (res.truncated) {
+        io.print(style('[警告] 达到最大工具调用步数，任务可能未完成。', C.yellow));
+      }
+      if (res.finish === 'length') {
+        io.print(style('[提示] 模型输出达到长度上限被截断。', C.yellow));
+      }
+      io.printUsageLine({ modelName, usage: res.usage, durationMs: res.durationMs });
+    } catch (/** @type {any} */ err) {
+      io.print(style('[错误] ' + (err?.message || err), C.red));
+      io.print(style('提示：可直接继续对话，或 /exit 退出。', C.dim));
+    }
+  }
+
+  mcpFacade.stop();
+  if (stats.turns > 0) {
+    io.startSpinner('正在沉淀会话记忆…');
+    try {
+      await finalizeSession({
+        cfg,
+        provider,
+        model: titleModel(cfg, modelName),
+        home,
+        workingDir,
+        messages,
+        turns: stats.turns,
+        lastText,
+      });
+    } catch {}
+    io.stopSpinner();
+  }
+  try {
+    await maybeAutoSync();
+  } catch {}
+  io.print('再见，MingDao Harness 与你同行。');
+  io.close();
+}