@huicai/cli 2026.710.97950 → 2026.711.24616

package/src/tui/app.js

@@ -1,566 +1 @@
-// ink + React 富终端界面（TUI）。用 React.createElement 编写（无 JSX，故仍无需构建步骤）。
-// 通过 runTurn 的结构化 events（onDelta/onToolStart/onTodo/…）驱动渲染：Static 承载已定稿的对话记录，
-// 下方动态区呈现流式正文、任务清单、思考 spinner、授权提示与可编辑输入行、底部状态栏。
-//
-// 交互细节：
-//  - 输入行支持光标移动/行内编辑（←→、Ctrl+A/E/U/K/W）与上下键历史（按项目目录持久化）；
-//  - 模型工作中可继续输入：回车即排队，工具轮间隙自动注入（「边跑边补充指令」）；Esc 中断当前回合；
-//  - 授权提示含高风险命令警示，[A] 可把允许规则写入项目 .huicai/settings.json；
-//  - 斜杠命令与 REPL 共用 commands.js 注册表；@文件 引用与 !命令 直通同样可用。
-//
-// 仅在 TTY 且已安装 ink 时启用；未安装时 bin 回退到零依赖 readline REPL。
-
-import React, { useState, useRef, useReducer, useEffect, useMemo } from 'react';
-import { render, Box, Text, Static, useInput, useApp } from 'ink';
-import { runTurn } from '../agent.js';
-import { fetchUsage } from '../api.js';
-import { toolLabel } from '../render.js';
-import { renderMarkdown, looksLikeMarkdown } from '../markdown.js';
-import { renderWelcome } from '../banner.js';
-import { createSession, saveSession } from '../session.js';
-import { buildExtraTools } from '../repl.js';
-import { closeMcp } from '../mcp.js';
-import { runSlash, listCommands } from '../commands.js';
-import { usageStatus, fmtReset } from '../usage.js';
-import { expandAtMentions, buildUserContent, runBangCommand, loadHistory, appendHistory } from '../input.js';
-import { loadAllowRules, matchAllowRules, suggestRule, addProjectAllowRule, riskWarning } from '../settings.js';
-
-const h = React.createElement;
-
-function shortLine(s, max = 200) {
-  const first = String(s).split('\n')[0];
-  return first.length > max ? first.slice(0, max) + '…' : first;
-}
-
-function clipLines(s, maxLines = 12) {
-  const lines = String(s).split('\n');
-  if (lines.length <= maxLines) return s;
-  return lines.slice(0, maxLines).join('\n') + `\n…（共 ${lines.length} 行）`;
-}
-
-function fmtTok(n) {
-  n = Number(n) || 0;
-  return n >= 1000 ? (n / 1000).toFixed(1) + 'k' : String(n);
-}
-
-const SPINNER = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
-
-export function App({ config, cwd, session: initialSession, extraTools, yolo, initialPrompt, version, onExit }) {
-  const app = useApp();
-  const logRef = useRef([]); // 已定稿记录：{id,kind,text}
-  const idRef = useRef(0);
-  const liveRef = useRef(''); // 当前流式正文
-  const sessionRef = useRef(initialSession);
-  const abortRef = useRef(null);
-  const pendingRef = useRef(null); // 授权中：{name,args,resolve}
-  const sessionAllow = useRef(new Set());
-  const rulesRef = useRef(loadAllowRules(cwd)); // settings.json 允许规则
-  const yoloRef = useRef(!!yolo);
-  const startedRef = useRef(false);
-  const statusRef = useRef('idle');
-  const queueRef = useRef([]); // 忙时排队的用户消息
-  const todoStateRef = useRef({ list: [] });
-  const historyRef = useRef(loadHistory(cwd));
-  const histIdxRef = useRef(null);
-  const draftRef = useRef('');
-
-  const [, force] = useReducer((x) => x + 1, 0);
-  // 定稿记录（logRef）变更计数：ink <Static> 靠 items「引用变化」识别新项，就地 push 同一数组它不会刷新
-  // （会导致轮末助手回复无后续渲染触发而丢失）。故每次 addLog 自增 logVer，据此派生「全新数组引用」交给 Static。
-  const [logVer, bumpLog] = useReducer((x) => x + 1, 0);
-  const [staticKey, setStaticKey] = useState(0); // /clear 时自增以重挂 Static，复位其内部已渲染索引
-  const [status, setStatus] = useState('idle'); // idle | busy
-  const [inp, setInp] = useState({ text: '', cursor: 0 });
-  const [pending, setPending] = useState(null);
-  const [usage, setUsage] = useState({ prompt: 0, completion: 0 });
-  const [ctxTok, setCtxTok] = useState(0);
-  const [todos, setTodos] = useState([]);
-  const [queueLen, setQueueLen] = useState(0);
-  const [spin, setSpin] = useState(0);
-  const [win, setWin] = useState(null); // Token 用量窗口（5小时/7天）最新快照
-  const winRef = useRef(null);           // 同上，供异步路径同步读取（发起回合前的用尽拦截）
-  const [sugIdx, setSugIdx] = useState(0); // 斜杠命令补全：选中项
-  const [hideSug, setHideSug] = useState(false); // 斜杠命令补全：Esc 临时收起
-  const allCommands = useMemo(() => listCommands(cwd), [cwd]); // 命令清单（含自定义），一次性
-
-  const addLog = (kind, text) => {
-    logRef.current.push({ id: idRef.current++, kind, text });
-    bumpLog(); // 变更定稿记录 → 触发 Static 用新数组引用刷新（见 logVer 说明）
-  };
-  const flushLive = () => {
-    if (liveRef.current) {
-      // 定稿时把助手正文渲染为 Markdown（ink <Text> 原样保留内嵌 ANSI）；流式期间仍显示原文，完成即定稿为富文本。
-      // 纯散文（无 Markdown 结构）直接留原文，避免无谓处理与边角改动。
-      const raw = liveRef.current;
-      const md = config.markdown !== false && looksLikeMarkdown(raw);
-      addLog('assistant', md ? renderMarkdown(raw) : raw);
-      liveRef.current = '';
-    }
-  };
-  const setBusy = (b) => {
-    statusRef.current = b ? 'busy' : 'idle';
-    setStatus(statusRef.current);
-  };
-
-  // 思考中 spinner
-  useEffect(() => {
-    if (status !== 'busy') return;
-    const t = setInterval(() => setSpin((s) => (s + 1) % SPINNER.length), 80);
-    return () => clearInterval(t);
-  }, [status]);
-
-  // Token 用量窗口：进入时拉一次，之后每回合结束 + 定时刷新（best-effort，离线/平台不支持则静默）
-  const refreshUsage = async () => {
-    if (!config.apiKey) return;
-    try {
-      const u = await fetchUsage(config.baseUrl, config.apiKey);
-      winRef.current = u;
-      setWin(u);
-    } catch { /* 忽略 */ }
-  };
-  useEffect(() => {
-    void refreshUsage();
-    const t = setInterval(() => { void refreshUsage(); }, 180000);
-    return () => clearInterval(t);
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, []);
-
-  const thinkRef = useRef(''); // 思考过程（reasoning）流式缓冲，仅动态区展示不入定稿记录
-  const events = {
-    onDelta: (t) => {
-      if (thinkRef.current) thinkRef.current = ''; // 正文开始，思考收起
-      liveRef.current += t;
-      force();
-    },
-    onReasoning: (t) => {
-      thinkRef.current = (thinkRef.current + t).slice(-400);
-      force();
-    },
-    onToolStart: (name, args) => {
-      thinkRef.current = '';
-      flushLive();
-      addLog('tool', toolLabel(name, args));
-    },
-    onToolResult: (name, res) => addLog('toolresult', shortLine(res)),
-    onFileDiff: (diff) => addLog('diff', diff), // 文件更改的行（已带 ANSI，Static 原样呈现）
-    onSkip: (name, args) => addLog('skip', toolLabel(name, args) + ' — 已跳过'),
-    onInfo: (t) => {
-      flushLive();
-      addLog('info', t);
-    },
-    onTodo: (list) => setTodos(list),
-    onTurnEnd: () => {
-      thinkRef.current = '';
-      flushLive();
-    },
-  };
-
-  // ink 版权限：只读/yolo/本会话/settings 规则放行；否则弹提示等待按键（y/a/A/n）
-  const permissions = {
-    request: (name, args, _cwd, readOnly) => {
-      if (readOnly || yoloRef.current || sessionAllow.current.has(name)
-        || matchAllowRules(rulesRef.current, name, args)) {
-        return Promise.resolve({ allow: true });
-      }
-      return new Promise((resolve) => {
-        pendingRef.current = { name, args, resolve };
-        setPending({ label: toolLabel(name, args), name, args, risk: riskWarning(name, args) });
-      });
-    },
-    isYolo: () => yoloRef.current,
-    setYolo: (v) => {
-      yoloRef.current = !!v;
-    },
-  };
-
-  const pullQueued = () => {
-    // runTurn 同步回调：排队消息按原文注入（@ 文档/图片的异步展开只在主输入路径做，队列消息保留 @ 路径原文，模型可再 read_file）
-    const q = queueRef.current.shift();
-    setQueueLen(queueRef.current.length);
-    return q == null ? null : q;
-  };
-
-  const runUserTurn = async (text) => {
-    // 用量窗口已用尽 → 终止：不发起新回合（进行中的回合由平台 429 终态自然结束）
-    const gate = usageStatus(winRef.current);
-    if (gate && gate.level === 'exhausted') {
-      addLog('info', `✗ Token 用量窗口（${gate.label}）已用尽，暂无法继续。${fmtReset(gate.resetAtEpochMs)}`);
-      return;
-    }
-    const { text: expanded, images } = await expandAtMentions(text, cwd, config);
-    sessionRef.current.messages.push({ role: 'user', content: buildUserContent(expanded, images) });
-    setBusy(true);
-    abortRef.current = new AbortController();
-    if (!sessionRef.current.compaction) sessionRef.current.compaction = {};
-    const r = await runTurn({
-      config,
-      messages: sessionRef.current.messages,
-      permissions,
-      cwd,
-      extraTools,
-      events,
-      signal: abortRef.current.signal,
-      todoState: todoStateRef.current,
-      compaction: sessionRef.current.compaction,
-      pullQueued,
-    });
-    abortRef.current = null;
-    flushLive();
-    if (r?.usage) setUsage((u) => ({ prompt: u.prompt + r.usage.prompt, completion: u.completion + r.usage.completion }));
-    if (r?.lastPromptTokens) {
-      setCtxTok(r.lastPromptTokens);
-      sessionRef.current.lastPromptTokens = r.lastPromptTokens;
-    }
-    saveSession(sessionRef.current);
-    if ((r?.aborted || r?.error) && queueRef.current.length) {
-      queueRef.current = [];
-      setQueueLen(0);
-      addLog('info', '已清空排队消息');
-    }
-    setBusy(false);
-    void refreshUsage(); // 回合结束刷新用量窗口（含被 429 用尽的情形 → 更新右下角提示 + 拦截下一回合）
-  };
-
-  const doExit = () => {
-    onExit?.();
-    app.exit();
-  };
-
-  const handleSlash = async (line) => {
-    const ctx = {
-      version,
-      config,
-      cwd,
-      usage,
-      permissions,
-      extraTools,
-      session: sessionRef.current,
-      print: (t) => addLog('info', String(t)),
-    };
-    const r = await runSlash(line, ctx);
-    if (r.action === 'exit') return doExit();
-    if (r.action === 'clear') {
-      sessionRef.current = createSession({ cwd, model: config.model, messages: [sessionRef.current.messages[0]] });
-      todoStateRef.current.list = [];
-      setTodos([]);
-      setCtxTok(0);
-      logRef.current = [];
-      liveRef.current = '';
-      setStaticKey((k) => k + 1); // 重挂 Static：复位其内部已渲染索引，新会话记录从头正常渲染
-      addLog('info', '已开启新会话（旧会话仍可 --resume 恢复）');
-    }
-    if (r.prompt) {
-      if (statusRef.current === 'busy') {
-        queueRef.current.push(r.prompt);
-        setQueueLen(queueRef.current.length);
-      } else {
-        addLog('user', r.prompt);
-        await runUserTurn(r.prompt);
-      }
-    }
-  };
-
-  const handleBang = async (command) => {
-    if (statusRef.current === 'busy') {
-      addLog('info', '正在处理上一条，! 命令请稍候再试');
-      return;
-    }
-    addLog('user', '! ' + command);
-    const { output, record } = await runBangCommand(command, cwd);
-    addLog('toolresult', clipLines(output));
-    sessionRef.current.messages.push({ role: 'user', content: record });
-    saveSession(sessionRef.current);
-  };
-
-  const submit = async (raw) => {
-    const t = raw.trim();
-    setInp({ text: '', cursor: 0 });
-    histIdxRef.current = null;
-    if (!t) return;
-    appendHistory(cwd, t);
-    if (historyRef.current[historyRef.current.length - 1] !== t) historyRef.current.push(t);
-    if (t.startsWith('/')) return handleSlash(t);
-    if (t.startsWith('!') && t.length > 1) return handleBang(t.slice(1).trim());
-    if (statusRef.current === 'busy') {
-      // 边跑边补充：排队，工具轮间隙自动注入本回合
-      addLog('user', t);
-      queueRef.current.push(t);
-      setQueueLen(queueRef.current.length);
-      return;
-    }
-    addLog('user', t);
-    await runUserTurn(t);
-  };
-
-  // 首个自动指令
-  useEffect(() => {
-    if (!startedRef.current && initialPrompt) {
-      startedRef.current = true;
-      void submit(initialPrompt);
-    }
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, []);
-
-  // 历史翻阅
-  const histUp = () => {
-    const hist = historyRef.current;
-    if (!hist.length) return;
-    if (histIdxRef.current == null) {
-      draftRef.current = inp.text;
-      histIdxRef.current = hist.length - 1;
-    } else if (histIdxRef.current > 0) {
-      histIdxRef.current--;
-    }
-    const t = hist[histIdxRef.current] ?? '';
-    setInp({ text: t, cursor: t.length });
-  };
-  const histDown = () => {
-    if (histIdxRef.current == null) return;
-    const hist = historyRef.current;
-    if (histIdxRef.current < hist.length - 1) {
-      histIdxRef.current++;
-      const t = hist[histIdxRef.current];
-      setInp({ text: t, cursor: t.length });
-    } else {
-      histIdxRef.current = null;
-      setInp({ text: draftRef.current, cursor: draftRef.current.length });
-    }
-  };
-
-  // 斜杠命令自动补全：仅在「以 / 开头且尚未输入空格（还在打命令名）」时给候选
-  const slashMatch = /^\/(\S*)$/.exec(inp.text);
-  const slashQuery = slashMatch ? slashMatch[1] : null;
-  const suggestions = slashQuery == null
-    ? []
-    : allCommands.filter((cmd) => cmd.name.toLowerCase().startsWith(slashQuery.toLowerCase())).slice(0, 8);
-  const popupOpen = suggestions.length > 0 && !hideSug;
-  // 候选变化时复位选中项与「Esc 收起」态（继续打字即重新弹出）
-  useEffect(() => { setSugIdx(0); setHideSug(false); }, [slashQuery]);
-
-  useInput((ch, key) => {
-    // 授权提示优先（y 一次 / a 本会话 / A 永久规则 / n·Esc·回车 拒绝）
-    if (pendingRef.current) {
-      const p = pendingRef.current;
-      const done = (res) => {
-        pendingRef.current = null;
-        setPending(null);
-        p.resolve(res);
-      };
-      if (ch === 'y') return done({ allow: true });
-      if (ch === 'a') {
-        sessionAllow.current.add(p.name);
-        return done({ allow: true });
-      }
-      if (ch === 'A') {
-        sessionAllow.current.add(p.name);
-        const rule = suggestRule(p.name, p.args);
-        try {
-          addProjectAllowRule(cwd, rule);
-          rulesRef.current = loadAllowRules(cwd);
-          addLog('info', `已写入允许规则：${rule} → .huicai/settings.json`);
-        } catch (e) {
-          addLog('info', `规则写入失败（本会话仍生效）：${e.message}`);
-        }
-        return done({ allow: true });
-      }
-      if (ch === 'n' || key.escape || key.return) return done({ allow: false, reason: '用户拒绝了该操作。' });
-      return;
-    }
-    // 斜杠命令补全弹层打开时，接管 上下选择 / Tab 补全 / 回车执行 / Esc 收起；其它键落到下方输入以继续过滤
-    if (popupOpen) {
-      const pick = () => suggestions[Math.min(sugIdx, suggestions.length - 1)];
-      if (key.upArrow) return setSugIdx((x) => (x - 1 + suggestions.length) % suggestions.length);
-      if (key.downArrow) return setSugIdx((x) => (x + 1) % suggestions.length);
-      if (key.tab) {
-        const name = pick().name;
-        return setInp({ text: '/' + name + ' ', cursor: name.length + 2 });
-      }
-      if (key.return) return void submit('/' + pick().name);
-      if (key.escape) return setHideSug(true);
-    }
-    if (key.escape) {
-      if (statusRef.current === 'busy' && abortRef.current) {
-        abortRef.current.abort();
-        addLog('info', '已请求中断（Esc）');
-      }
-      return;
-    }
-    if (key.ctrl && ch === 'c') {
-      if (statusRef.current === 'busy' && abortRef.current) {
-        abortRef.current.abort();
-        addLog('info', '已请求中断');
-      } else {
-        doExit();
-      }
-      return;
-    }
-    if (key.return) {
-      void submit(inp.text);
-      return;
-    }
-    if (key.upArrow) return histUp();
-    if (key.downArrow) return histDown();
-    if (key.leftArrow) return setInp((s) => ({ ...s, cursor: Math.max(0, s.cursor - 1) }));
-    if (key.rightArrow) return setInp((s) => ({ ...s, cursor: Math.min(s.text.length, s.cursor + 1) }));
-    if (key.ctrl && ch === 'a') return setInp((s) => ({ ...s, cursor: 0 }));
-    if (key.ctrl && ch === 'e') return setInp((s) => ({ ...s, cursor: s.text.length }));
-    if (key.ctrl && ch === 'u') return setInp((s) => ({ text: s.text.slice(s.cursor), cursor: 0 }));
-    if (key.ctrl && ch === 'k') return setInp((s) => ({ text: s.text.slice(0, s.cursor), cursor: s.cursor }));
-    if (key.ctrl && ch === 'w') {
-      return setInp((s) => {
-        const before = s.text.slice(0, s.cursor).replace(/\S+\s*$/, '');
-        return { text: before + s.text.slice(s.cursor), cursor: before.length };
-      });
-    }
-    if (key.backspace || key.delete) {
-      histIdxRef.current = null;
-      return setInp((s) => (s.cursor > 0
-        ? { text: s.text.slice(0, s.cursor - 1) + s.text.slice(s.cursor), cursor: s.cursor - 1 }
-        : s));
-    }
-    if (ch && !key.ctrl && !key.meta) {
-      histIdxRef.current = null;
-      const str = ch.replace(/\r\n?/g, '\n'); // 粘贴多行归一化
-      setInp((s) => ({ text: s.text.slice(0, s.cursor) + str + s.text.slice(s.cursor), cursor: s.cursor + str.length }));
-    }
-  });
-
-  // ---- 渲染 ----
-  // 每当定稿记录变更（logVer）派生一个全新数组引用，Static 才能识别并渲染新追加项；
-  // 流式增量只调 force()（logVer 不变）→ 此处返回同一引用，Static 不重复刷历史记录。
-  const logItems = useMemo(() => logRef.current.slice(), [logVer]);
-  const cwdName = cwd.split('/').filter(Boolean).pop() || cwd;
-  const before = inp.text.slice(0, inp.cursor);
-  const at = inp.text[inp.cursor] ?? ' ';
-  const after = inp.text.slice(inp.cursor + 1);
-  const termWidth = Math.max(8, process.stdout.columns || 80); // 输入栏上下蓝线宽度（随终端自适应）
-  const uStat = usageStatus(win); // 用量告警（null=正常，不显示）
-  const uWarn = !uStat ? '' : uStat.level === 'exhausted'
-    ? `⛔ ${uStat.label}用量已用尽${fmtReset(uStat.resetAtEpochMs) ? ' · ' + fmtReset(uStat.resetAtEpochMs) : ''}`
-    : `⚠ ${uStat.label}用量 ${Math.round(uStat.pct * 100)}%（${fmtTok(uStat.used)}/${fmtTok(uStat.limit)}）`;
-
-  return h(
-    Box,
-    { flexDirection: 'column' },
-    // 已定稿记录（Static：只渲染一次，天然滚动）
-    h(Static, { key: staticKey, items: logItems }, (item) => h(LogLine, { key: item.id, item })),
-    // 思考过程（reasoning，流式、不入定稿记录）
-    thinkRef.current
-      ? h(Box, null, h(Text, { color: 'gray', italic: true }, '✦ 思考 ' + thinkRef.current.replace(/\n/g, ' ').slice(-160)))
-      : null,
-    // 流式正文
-    liveRef.current ? h(Box, { marginTop: 0 }, h(Text, null, liveRef.current)) : null,
-    // 任务清单（todo_write 实时更新）
-    todos.length
-      ? h(
-          Box,
-          { flexDirection: 'column', paddingLeft: 2, marginTop: 1 },
-          ...todos.map((t, i) =>
-            h(
-              Text,
-              {
-                key: i,
-                color: t.status === 'completed' ? 'green' : t.status === 'in_progress' ? 'cyan' : 'gray',
-                dimColor: t.status === 'completed',
-                bold: t.status === 'in_progress',
-              },
-              (t.status === 'completed' ? '☑ ' : t.status === 'in_progress' ? '◐ ' : '☐ ') + t.content,
-            ),
-          ),
-        )
-      : null,
-    // 思考 spinner
-    status === 'busy' && !liveRef.current
-      ? h(Box, null, h(Text, { color: 'cyan' }, SPINNER[spin] + ' 思考中…'), h(Text, { color: 'gray' }, '（Esc 中断 · 输入回车可排队补充）'))
-      : null,
-    // 授权提示
-    pending
-      ? h(
-          Box,
-          { flexDirection: 'column', borderStyle: 'round', borderColor: 'yellow', paddingX: 1, marginTop: 1 },
-          h(Text, { color: 'yellow', bold: true }, '● 需要授权：' + pending.label),
-          pending.risk ? h(Text, { color: 'red', bold: true }, '⚠ ' + pending.risk) : null,
-          pending.name === 'run_bash' ? h(Text, { color: 'gray' }, '$ ' + (pending.args.command || '')) : null,
-          pending.name === 'fetch_url' ? h(Text, { color: 'gray' }, 'GET ' + (pending.args.url || '')) : null,
-          h(Text, null, '[y] 允许一次 · [a] 本会话 · [A] 永久(写入项目设置) · [n/Esc] 拒绝'),
-        )
-      : null,
-    // 斜杠命令补全弹层（输入 / 即弹；↑↓ 选择 · Tab 补全 · ⏎ 执行 · Esc 关闭）
-    popupOpen
-      ? h(
-          Box,
-          { flexDirection: 'column', marginTop: 1 },
-          h(Text, { color: 'gray' }, '  斜杠命令 · ↑↓ 选择 · Tab 补全 · ⏎ 执行 · Esc 关闭'),
-          ...suggestions.map((s, i) =>
-            h(
-              Box,
-              { key: s.name },
-              h(Text, { color: 'cyan', bold: i === sugIdx },
-                (i === sugIdx ? ' ❯ ' : '   ') + '/' + s.name + (s.args ? ' ' + s.args : '')),
-              h(Text, { color: 'gray' }, '  ' + String(s.desc || '').replace(/\s+/g, ' ').slice(0, 46)),
-            ),
-          ),
-        )
-      : null,
-    // 输入栏：上下各一条蓝色横线包住输入行（弹层打开时其自带间距，蓝线贴紧）
-    h(Box, { marginTop: popupOpen ? 0 : 1 }, h(Text, { color: 'blue' }, '─'.repeat(termWidth))),
-    // 输入行（带光标；忙时输入会排队）
-    h(
-      Box,
-      null,
-      h(Text, { color: status === 'busy' ? 'yellow' : 'cyan' }, status === 'busy' ? '⧗ ' : '› '),
-      h(Text, null, before),
-      h(Text, { inverse: true }, at),
-      h(Text, null, after),
-    ),
-    h(Text, { color: 'blue' }, '─'.repeat(termWidth)),
-    // 底栏：左=目录/模型/队列；右下角=用量告警（仅 ≥80% 或用尽时实时出现）
-    h(
-      Box,
-      { justifyContent: 'space-between' },
-      h(Text, { color: 'gray' },
-        `${cwdName} · ${config.model}${yoloRef.current ? ' · ⚠ yolo' : ''}`
-          + (queueLen ? ` · 排队 ${queueLen}` : '')
-          + ' · /help'),
-      uWarn ? h(Text, { color: uStat.level === 'exhausted' ? 'red' : 'yellow', bold: true }, uWarn) : h(Text, null, ''),
-    ),
-  );
-}
-
-/** 单行记录渲染（按 kind 着色）。 */
-function LogLine({ item }) {
-  const { kind, text } = item;
-  if (kind === 'user') return h(Box, { marginTop: 1 }, h(Text, { color: 'cyan', bold: true }, '› '), h(Text, { bold: true }, text));
-  if (kind === 'assistant') return h(Box, null, h(Text, null, text));
-  if (kind === 'diff') return h(Box, { marginLeft: 2 }, h(Text, null, text)); // 更改的行（已带 ANSI）
-  if (kind === 'tool') return h(Text, { color: 'cyan' }, '  ⏺ ' + text);
-  if (kind === 'toolresult') return h(Text, { color: 'gray' }, '     ' + text);
-  if (kind === 'skip') return h(Text, { color: 'gray' }, '  ⊘ ' + text);
-  if (kind === 'info') {
-    // 失败/错误类信息用红色高亮，避免被淹没（如「模型调用失败：令牌校验失败」）
-    const isErr = /✗|失败|错误|error/i.test(text);
-    return h(Text, { color: isErr ? 'red' : 'yellow' }, (isErr ? '  ✗ ' : '  · ') + text.replace(/^✗\s*/, ''));
-  }
-  return h(Text, null, text);
-}
-
-/**
- * 启动 ink TUI。先（在 ink 接管屏幕前）连接 MCP 并打印连接信息，再进入全屏界面；退出后关闭 MCP。
- */
-export async function runInk({ config, cwd, session, yolo, initialPrompt, version }) {
-  process.stdout.write(renderWelcome({
-    model: config.model,
-    cwd,
-    version,
-    platform: /^(agent|workflow|datahuman)-/.test(String(config.model || '')),
-    yolo,
-    consult: config.consult ? (config.consultLabel || config.consult) : null,
-    ink: true,
-  }) + '\n');
-  const { extraTools, clients } = await buildExtraTools(config, cwd);
-  const { waitUntilExit } = render(
-    h(App, { config, cwd, session, extraTools, yolo, initialPrompt, version, onExit: () => closeMcp(clients) }),
-  );
-  await waitUntilExit();
-  closeMcp(clients);
-}
+import r,{useState as e,useRef as t,useReducer as n,useEffect as o,useMemo as s}from"react";import{execSync as c}from"node:child_process";import{render as l,Box as u,Text as i,Static as a,useInput as m,useApp as p}from"ink";import{runTurn as f}from"../agent.js";import{fetchUsage as g}from"../api.js";import{toolLabel as d}from"../render.js";import{renderMarkdown as h,looksLikeMarkdown as x}from"../markdown.js";import{renderWelcome as y}from"../banner.js";import{createSession as w,saveSession as b}from"../session.js";import{createCheckpoints as v}from"../checkpoints.js";import{buildExtraTools as k}from"../repl.js";import{closeMcp as T}from"../mcp.js";import{runSlash as $,listCommands as j}from"../commands.js";import{usageStatus as S,fmtReset as A}from"../usage.js";import{expandAtMentions as I,buildUserContent as P,runBangCommand as E,loadHistory as M,appendHistory as L}from"../input.js";import{loadAllowRules as _,loadDenyRules as C,matchAllowRules as D,suggestRule as R,addProjectAllowRule as U,riskWarning as W}from"../settings.js";import{PLAN_DENY_REASON as F,SANDBOX_DENY_REASON as K}from"../permissions.js";import{runVerifyLoop as Y}from"../autofix.js";const q=r.createElement;function B(r){return(r=Number(r)||0)>=1e3?(r/1e3).toFixed(1)+"k":String(r)}const G=["⠋","⠙","⠹","⠸","⠼","⠴","⠦","⠧","⠇","⠏"];export function App({config:r,cwd:l,session:y,extraTools:k,yolo:T,initialPrompt:N,version:O,onExit:Q}){const X=p(),z=t([]),H=t(0),V=t(""),Z=t(y),rr=t(null),er=t(null),tr=t(new Set),nr=t(_(l)),or=t(C(l)),sr=t(!1),cr=t(!1),lr=t(v()),ur=t(!!T),ir=t(!1),ar=t("idle"),mr=t([]),pr=t({list:[]}),fr=t(M(l)),gr=t(null),dr=t(""),[,hr]=n(r=>r+1,0),[xr,yr]=n(r=>r+1,0),[wr,br]=e(0),[vr,kr]=e("idle"),[Tr,$r]=e({text:"",cursor:0}),[jr,Sr]=e(null),[Ar,Ir]=e({prompt:0,completion:0}),[Pr,Er]=e(0),[Mr,Lr]=e([]),[_r,Cr]=e(0),[Dr,Rr]=e(!1),[Ur,Wr]=e(""),Fr=t(null),[Kr,Yr]=e(0),[qr,Br]=e(null),Gr=t(null),[Jr,Nr]=e(0),[Or,Qr]=e(!1),Xr=s(()=>j(l),[l]),zr=(r,e)=>{z.current.push({id:H.current++,kind:r,text:e}),yr()},Hr=()=>{if(V.current){const e=V.current,t=!1!==r.markdown&&x(e);zr("assistant",t?h(e):e),V.current=""}},Vr=r=>{ar.current=r?"busy":"idle",kr(ar.current)};o(()=>{if("busy"!==vr)return;const r=setInterval(()=>Yr(r=>(r+1)%G.length),80);return()=>clearInterval(r)},[vr]);const Zr=async()=>{if(r.apiKey)try{const e=await g(r.baseUrl,r.apiKey);Gr.current=e,Br(e)}catch{}};o(()=>{Zr();const r=setInterval(()=>{Zr()},18e4);return()=>clearInterval(r)},[]),o(()=>{if(!r.statusLine)return void Wr("");const e=()=>{try{const e=c(r.statusLine,{cwd:l,timeout:3e3,stdio:["ignore","pipe","ignore"]}).toString().split("\n")[0].slice(0,80);Wr(e)}catch{Wr("")}};e();const t=setInterval(e,5e3);return()=>clearInterval(t)},[r.statusLine]),o(()=>()=>{Fr.current&&clearInterval(Fr.current)},[]);const re=t(""),ee={onDelta:r=>{re.current&&(re.current=""),V.current+=r,hr()},onReasoning:r=>{re.current=(re.current+r).slice(-400),hr()},onToolStart:(r,e)=>{re.current="",Hr(),zr("tool",d(r,e))},onToolResult:(r,e)=>zr("toolresult",function(r,e=200){const t=String(r).split("\n")[0];return t.length>e?t.slice(0,e)+"…":t}(e)),onFileDiff:r=>zr("diff",r),onSkip:(r,e)=>zr("skip",d(r,e)+" — 已跳过"),onInfo:r=>{Hr(),zr("info",r)},onTodo:r=>Lr(r),onTurnEnd:()=>{re.current="",Hr()}},te={request:(r,e,t,n)=>or.current.length&&D(or.current,r,e)?Promise.resolve({allow:!1,reason:"该操作被拒绝规则阻止（/permissions 查看或移除）。"}):sr.current&&!n?Promise.resolve({allow:!1,reason:F}):!cr.current||"run_bash"!==r&&"fetch_url"!==r?n||ur.current||tr.current.has(r)||D(nr.current,r,e)?Promise.resolve({allow:!0}):new Promise(t=>{er.current={name:r,args:e,resolve:t},Sr({label:d(r,e),name:r,args:e,risk:W(r,e)})}):Promise.resolve({allow:!1,reason:K}),isYolo:()=>ur.current,setYolo:r=>{ur.current=!!r},setPlanMode:r=>{sr.current=!!r,Rr(!!r)},isPlanMode:()=>sr.current,setSandbox:r=>{cr.current=!!r},isSandbox:()=>cr.current,reloadRules:()=>{nr.current=_(l),or.current=C(l)}},ne=()=>{const r=mr.current.shift();return Cr(mr.current.length),null==r?null:r},oe=async e=>{const t=S(Gr.current);if(t&&"exhausted"===t.level)return void zr("info",`✗ Token 用量窗口（${t.label}）已用尽，暂无法继续。${A(t.resetAtEpochMs)}`);const{text:n,images:o}=await I(e,l,r),s=lr.current.snapshot({session:Z.current,label:e});Z.current.messages.push({role:"user",content:P(n,o)}),Vr(!0),rr.current=new AbortController,Z.current.compaction||(Z.current.compaction={});const c=await f({config:r,messages:Z.current.messages,permissions:te,cwd:l,extraTools:k,events:ee,signal:rr.current.signal,todoState:pr.current,compaction:Z.current.compaction,pullQueued:ne,fileJournal:s});return rr.current=null,Hr(),c?.usage&&Ir(r=>({prompt:r.prompt+c.usage.prompt,completion:r.completion+c.usage.completion})),c?.lastPromptTokens&&(Er(c.lastPromptTokens),Z.current.lastPromptTokens=c.lastPromptTokens),b(Z.current),(c?.aborted||c?.error)&&mr.current.length&&(mr.current=[],Cr(0),zr("info","已清空排队消息")),Vr(!1),Zr(),c},se=()=>{Q?.(),X.exit()},ce=async r=>{if("busy"===ar.current)return void zr("info","正在处理上一条，! 命令请稍候再试");zr("user","! "+r);const{output:e,record:t}=await E(r,l);zr("toolresult",function(r,e=12){const t=String(r).split("\n");return t.length<=e?r:t.slice(0,e).join("\n")+`\n…（共 ${t.length} 行）`}(e)),Z.current.messages.push({role:"user",content:t}),b(Z.current)},le=async e=>{const t=e.trim();if($r({text:"",cursor:0}),gr.current=null,t){if(L(l,t),fr.current[fr.current.length-1]!==t&&fr.current.push(t),t.startsWith("/"))return(async e=>{const t={version:O,config:r,cwd:l,usage:Ar,permissions:te,extraTools:k,session:Z.current,checkpoints:lr.current,print:r=>zr("info",String(r))},n=await $(e,t);if("exit"===n.action)return se();"clear"===n.action&&(Z.current=w({cwd:l,model:r.model,messages:[Z.current.messages[0]]}),pr.current.list=[],lr.current.list.length=0,Lr([]),Er(0),z.current=[],V.current="",br(r=>r+1),zr("info","已开启新会话（旧会话仍可 --resume 恢复）")),"refresh"===n.action&&(pr.current.list=[],Lr([]),Er(0)),"autofix"===n.action&&await Y({command:n.command,maxIters:n.maxIters,cwd:l,runTurnOnce:r=>oe(r),emit:r=>zr("info",r)}),"cd"===n.action&&zr("info","富 TUI 暂不支持 /cd 切换目录；请用 huicai --plain（普通模式）使用，或退出后到目标目录重开。"),"loop"===n.action&&(Fr.current&&(clearInterval(Fr.current),Fr.current=null),n.stop?zr("info","已停止循环。"):(zr("info",`已开始循环：每 ${n.seconds}s 运行「${n.prompt}」（/loop off 停止）`),Fr.current=setInterval(()=>{"busy"!==ar.current&&(zr("user",n.prompt),oe(n.prompt))},1e3*n.seconds))),n.prompt&&("busy"===ar.current?(mr.current.push(n.prompt),Cr(mr.current.length)):(zr("user",n.prompt),await oe(n.prompt)))})(t);if(t.startsWith("!")&&t.length>1)return ce(t.slice(1).trim());if("busy"===ar.current)return zr("user",t),mr.current.push(t),void Cr(mr.current.length);zr("user",t),await oe(t)}};o(()=>{!ir.current&&N&&(ir.current=!0,le(N))},[]);const ue=/^\/(\S*)$/.exec(Tr.text),ie=ue?ue[1]:null,ae=null==ie?[]:Xr.filter(r=>r.name.toLowerCase().startsWith(ie.toLowerCase())).slice(0,8),me=ae.length>0&&!Or;o(()=>{Nr(0),Qr(!1)},[ie]),m((r,e)=>{if(er.current){const t=er.current,n=r=>{er.current=null,Sr(null),t.resolve(r)};if("y"===r)return n({allow:!0});if("a"===r)return tr.current.add(t.name),n({allow:!0});if("A"===r){tr.current.add(t.name);const r=R(t.name,t.args);try{U(l,r),nr.current=_(l),zr("info",`已写入允许规则：${r} → .huicai/settings.json`)}catch(r){zr("info",`规则写入失败（本会话仍生效）：${r.message}`)}return n({allow:!0})}return"n"===r||e.escape||e.return?n({allow:!1,reason:"用户拒绝了该操作。"}):void 0}if(me){const r=()=>ae[Math.min(Jr,ae.length-1)];if(e.upArrow)return Nr(r=>(r-1+ae.length)%ae.length);if(e.downArrow)return Nr(r=>(r+1)%ae.length);if(e.tab){const e=r().name;return $r({text:"/"+e+" ",cursor:e.length+2})}if(e.return)return void le("/"+r().name);if(e.escape)return Qr(!0)}if(e.escape)"busy"===ar.current&&rr.current&&(rr.current.abort(),zr("info","已请求中断（Esc）"));else if(e.ctrl&&"c"===r)"busy"===ar.current&&rr.current?(rr.current.abort(),zr("info","已请求中断")):se();else if(e.return)le(Tr.text);else{if(e.upArrow)return(()=>{const r=fr.current;if(!r.length)return;null==gr.current?(dr.current=Tr.text,gr.current=r.length-1):gr.current>0&&gr.current--;const e=r[gr.current]??"";$r({text:e,cursor:e.length})})();if(e.downArrow)return(()=>{if(null==gr.current)return;const r=fr.current;if(gr.current<r.length-1){gr.current++;const e=r[gr.current];$r({text:e,cursor:e.length})}else gr.current=null,$r({text:dr.current,cursor:dr.current.length})})();if(e.leftArrow)return $r(r=>({...r,cursor:Math.max(0,r.cursor-1)}));if(e.rightArrow)return $r(r=>({...r,cursor:Math.min(r.text.length,r.cursor+1)}));if(e.ctrl&&"a"===r)return $r(r=>({...r,cursor:0}));if(e.ctrl&&"e"===r)return $r(r=>({...r,cursor:r.text.length}));if(e.ctrl&&"u"===r)return $r(r=>({text:r.text.slice(r.cursor),cursor:0}));if(e.ctrl&&"k"===r)return $r(r=>({text:r.text.slice(0,r.cursor),cursor:r.cursor}));if(e.ctrl&&"w"===r)return $r(r=>{const e=r.text.slice(0,r.cursor).replace(/\S+\s*$/,"");return{text:e+r.text.slice(r.cursor),cursor:e.length}});if(e.backspace||e.delete)return gr.current=null,$r(r=>r.cursor>0?{text:r.text.slice(0,r.cursor-1)+r.text.slice(r.cursor),cursor:r.cursor-1}:r);if(r&&!e.ctrl&&!e.meta){gr.current=null;const e=r.replace(/\r\n?/g,"\n");$r(r=>({text:r.text.slice(0,r.cursor)+e+r.text.slice(r.cursor),cursor:r.cursor+e.length}))}}});const pe=s(()=>z.current.slice(),[xr]),fe=l.split("/").filter(Boolean).pop()||l,ge=Tr.text.slice(0,Tr.cursor),de=Tr.text[Tr.cursor]??" ",he=Tr.text.slice(Tr.cursor+1),xe=Math.max(8,process.stdout.columns||80),ye=S(qr),we=ye?"exhausted"===ye.level?`⛔ ${ye.label}用量已用尽${A(ye.resetAtEpochMs)?" · "+A(ye.resetAtEpochMs):""}`:`⚠ ${ye.label}用量 ${Math.round(100*ye.pct)}%（${B(ye.used)}/${B(ye.limit)}）`:"";return q(u,{flexDirection:"column"},q(a,{key:wr,items:pe},r=>q(J,{key:r.id,item:r})),re.current?q(u,null,q(i,{color:"gray",italic:!0},"✦ 思考 "+re.current.replace(/\n/g," ").slice(-160))):null,V.current?q(u,{marginTop:0},q(i,null,V.current)):null,Mr.length?q(u,{flexDirection:"column",paddingLeft:2,marginTop:1},...Mr.map((r,e)=>q(i,{key:e,color:"completed"===r.status?"green":"in_progress"===r.status?"cyan":"gray",dimColor:"completed"===r.status,bold:"in_progress"===r.status},("completed"===r.status?"☑ ":"in_progress"===r.status?"◐ ":"☐ ")+r.content))):null,"busy"!==vr||V.current?null:q(u,null,q(i,{color:"cyan"},G[Kr]+" 思考中…"),q(i,{color:"gray"},"（Esc 中断 · 输入回车可排队补充）")),jr?q(u,{flexDirection:"column",borderStyle:"round",borderColor:"yellow",paddingX:1,marginTop:1},q(i,{color:"yellow",bold:!0},"● 需要授权："+jr.label),jr.risk?q(i,{color:"red",bold:!0},"⚠ "+jr.risk):null,"run_bash"===jr.name?q(i,{color:"gray"},"$ "+(jr.args.command||"")):null,"fetch_url"===jr.name?q(i,{color:"gray"},"GET "+(jr.args.url||"")):null,q(i,null,"[y] 允许一次 · [a] 本会话 · [A] 永久(写入项目设置) · [n/Esc] 拒绝")):null,me?q(u,{flexDirection:"column",marginTop:1},q(i,{color:"gray"},"  斜杠命令 · ↑↓ 选择 · Tab 补全 · ⏎ 执行 · Esc 关闭"),...ae.map((r,e)=>q(u,{key:r.name},q(i,{color:"cyan",bold:e===Jr},(e===Jr?" ❯ ":"   ")+"/"+r.name+(r.args?" "+r.args:"")),q(i,{color:"gray"},"  "+String(r.desc||"").replace(/\s+/g," ").slice(0,46))))):null,q(u,{marginTop:me?0:1},q(i,{color:"blue"},"─".repeat(xe))),q(u,null,q(i,{color:"busy"===vr?"yellow":"cyan"},"busy"===vr?"⧗ ":"› "),q(i,null,ge),q(i,{inverse:!0},de),q(i,null,he)),q(i,{color:"blue"},"─".repeat(xe)),q(u,{justifyContent:"space-between"},q(i,{color:"gray"},(Ur?Ur+" · ":"")+`${fe} · ${r.model}${ur.current?" · ⚠ yolo":""}${Dr?" · 📋 计划":""}`+(_r?` · 排队 ${_r}`:"")+" · /help"),we?q(i,{color:"exhausted"===ye.level?"red":"yellow",bold:!0},we):q(i,null,"")))}function J({item:r}){const{kind:e,text:t}=r;if("user"===e)return q(u,{marginTop:1},q(i,{color:"cyan",bold:!0},"› "),q(i,{bold:!0},t));if("assistant"===e)return q(u,null,q(i,null,t));if("diff"===e)return q(u,{marginLeft:2},q(i,null,t));if("tool"===e)return q(i,{color:"cyan"},"  ⏺ "+t);if("toolresult"===e)return q(i,{color:"gray"},"     "+t);if("skip"===e)return q(i,{color:"gray"},"  ⊘ "+t);if("info"===e){const r=/✗|失败|错误|error/i.test(t);return q(i,{color:r?"red":"yellow"},(r?"  ✗ ":"  · ")+t.replace(/^✗\s*/,""))}return q(i,null,t)}export async function runInk({config:r,cwd:e,session:t,yolo:n,initialPrompt:o,version:s}){process.stdout.write(y({model:r.model,cwd:e,version:s,platform:/^(agent|workflow|datahuman)-/.test(String(r.model||"")),yolo:n,consult:r.consult?r.consultLabel||r.consult:null,ink:!0})+"\n");const{extraTools:c,clients:u}=await k(r,e),{waitUntilExit:i}=l(q(App,{config:r,cwd:e,session:t,extraTools:c,yolo:n,initialPrompt:o,version:s,onExit:()=>T(u)}));await i(),T(u)}

package/src/usage.js

@@ -1,43 +1 @@
-// Token 用量窗口告警判定（纯函数，零依赖）。从 /v1/usage 的快照推导「是否该提示 / 是否用尽」。
-// limit 约定：>0 上限；-1 无限；0 该档未开放。两窗（5小时/7天）取占比最高者。
-
-/**
- * @param {{allowed?:boolean, used5h?:number, limit5h?:number, used7d?:number, limit7d?:number, resetAtEpochMs?:number|null}|null} win
- * @returns {{level:'warn'|'exhausted', label:string, used:number, limit:number, pct:number, resetAtEpochMs?:number|null}|null}
- *   null = 正常（<80% 或无可判定窗口）。warn ≥80%；exhausted ≥100% 或平台判定 allowed=false。
- */
-export function usageStatus(win) {
-  if (!win) return null;
-  let worst = null;
-  for (const w of [
-    { label: '5小时', used: win.used5h, limit: win.limit5h },
-    { label: '7天', used: win.used7d, limit: win.limit7d },
-  ]) {
-    if (typeof w.limit !== 'number' || w.limit <= 0 || typeof w.used !== 'number') continue; // -1 无限 / 0 未开放
-    const pct = w.used / w.limit;
-    if (!worst || pct > worst.pct) worst = { ...w, pct };
-  }
-  if (win.allowed === false) {
-    return {
-      level: 'exhausted',
-      label: worst?.label || '窗口',
-      used: worst?.used,
-      limit: worst?.limit,
-      pct: worst ? worst.pct : 1,
-      resetAtEpochMs: win.resetAtEpochMs,
-    };
-  }
-  if (!worst) return null;
-  if (worst.pct >= 1) return { level: 'exhausted', ...worst, resetAtEpochMs: win.resetAtEpochMs };
-  if (worst.pct >= 0.8) return { level: 'warn', ...worst, resetAtEpochMs: win.resetAtEpochMs };
-  return null;
-}
-
-/** 剩余时长（到 resetAtEpochMs）转「N小时M分后重置」；已过或缺省返回空串。 */
-export function fmtReset(ms) {
-  const d = (ms || 0) - Date.now();
-  if (d <= 0) return '';
-  const h = Math.floor(d / 3600000);
-  const m = Math.round((d % 3600000) / 60000);
-  return h > 0 ? `${h}小时${m}分后重置` : `${m}分后重置`;
-}
+export function usageStatus(e){if(!e)return null;let t=null;for(const l of[{label:"5小时",used:e.used5h,limit:e.limit5h},{label:"7天",used:e.used7d,limit:e.limit7d}]){if("number"!=typeof l.limit||l.limit<=0||"number"!=typeof l.used)continue;const e=l.used/l.limit;(!t||e>t.pct)&&(t={...l,pct:e})}return!1===e.allowed?{level:"exhausted",label:t?.label||"窗口",used:t?.used,limit:t?.limit,pct:t?t.pct:1,resetAtEpochMs:e.resetAtEpochMs}:t?t.pct>=1?{level:"exhausted",...t,resetAtEpochMs:e.resetAtEpochMs}:t.pct>=.8?{level:"warn",...t,resetAtEpochMs:e.resetAtEpochMs}:null:null}export function fmtReset(e){const t=(e||0)-Date.now();if(t<=0)return"";const l=Math.floor(t/36e5),s=Math.round(t%36e5/6e4);return l>0?`${l}小时${s}分后重置`:`${s}分后重置`}

package/src/watch.js

@@ -0,0 +1 @@
+import{spawn as e}from"node:child_process";import t from"node:fs";import n from"node:path";import{huicaiBin as o}from"./forks.js";const r=new Set([".git","node_modules","dist","build","target","out",".next",".nuxt",".venv","venv","__pycache__",".idea",".gradle","coverage",".cache"]);export async function runWatch({cwd:c,prompt:s,pattern:i=null,debounceMs:a=1500,log:l=e=>process.stdout.write(e+"\n"),spawnImpl:p}){const u=o();if(!u&&!p)throw new Error("无法定位 huicai 可执行文件（watch 需在 CLI 环境运行）");const d=i?function(e){return new RegExp("^"+String(e).replace(/[.+^${}()|[\]\\]/g,"\\$&").replace(/\*/g,".*")+"$")}(i):null;let m=null,h=!1;const w=new Set,g=p||(t=>e(process.execPath,[u,"-p",t,"--yolo","--plain"],{cwd:c,stdio:"inherit",env:process.env})),f=()=>{if(h)return;h=!0;const e=[...w];w.clear(),l(`\n▶ 变更 ${e.length} 文件 → 触发智能体：${s}`);const t=s+(e.length?`\n（刚变更的文件：${e.slice(0,20).join(", ")}）`:""),n=g(t),o=()=>{h=!1,w.size&&$()};n&&n.on?n.on("close",o):o()},$=()=>{m&&clearTimeout(m),m=setTimeout(f,a)},v=t.watch(c,{recursive:!0},(e,t)=>{if(!t)return;const o=String(t),c=o.split(n.sep)[0];r.has(c)||d&&!d.test(n.basename(o))||(w.add(o),$())});l(`huicai 监听已启动：${c}${i?` (${i})`:""} → 变更即跑「${s}」· Ctrl-C 退出`),await new Promise(e=>{process.on("SIGINT",()=>{v.close(),m&&clearTimeout(m),l("\n监听已停止。"),e()})})}