@huicai/cli 2026.710.97950 → 2026.711.0

package/src/transcript.js

@@ -0,0 +1,94 @@
+// 对话转录：导出为 Markdown（/export）与一句话小结（/recap）。
+// recap 直连原始模型（伪模型会触发平台编排+计费，故回退 DEFAULT_MODEL），不写入对话。
+
+import { streamChat } from './api.js';
+import { DEFAULT_MODEL } from './config.js';
+
+const PSEUDO = /^(agent|workflow|datahuman)-/;
+
+/** 提取消息文本（字符串或多模态数组）。 */
+export function textOf(content) {
+  if (typeof content === 'string') return content;
+  if (Array.isArray(content)) {
+    return content.map((p) => (p?.type === 'text' ? p.text : p?.type === 'image_url' ? '［图片］' : '')).join('\n');
+  }
+  return '';
+}
+
+/** 会话 → Markdown 文本（跳过 system；工具调用/结果折叠展示）。 */
+export function toMarkdown(session) {
+  const s = session || {};
+  const lines = [
+    '# HuiCai 对话记录',
+    '',
+    `- 会话：${s.id || ''}`,
+    `- 模型：${s.model || ''}`,
+    `- 导出时间：${new Date().toLocaleString()}`,
+    '',
+    '---',
+    '',
+  ];
+  for (const m of s.messages || []) {
+    if (m.role === 'system') continue;
+    if (m.role === 'user') {
+      lines.push('### 🧑 用户', '', textOf(m.content).trim() || '（空）', '');
+    } else if (m.role === 'assistant') {
+      const text = textOf(m.content).trim();
+      if (text) lines.push('### 🤖 助手', '', text, '');
+      for (const tc of m.tool_calls || []) {
+        const argsStr = String(tc.function?.arguments || '').replace(/\s+/g, ' ').slice(0, 200);
+        lines.push(`> 🔧 \`${tc.function?.name}(${argsStr})\``, '');
+      }
+    } else if (m.role === 'tool') {
+      const out = String(m.content || '').slice(0, 1500);
+      lines.push('> 工具结果：', '', '```', out, '```', '');
+    }
+  }
+  return lines.join('\n');
+}
+
+/** 从对话提炼「值得跨会话长期记住」的项目知识（直连原始模型）。返回事实数组（可能为空）。 */
+export async function distillMemory(messages, config, existingMemory = '') {
+  const model = PSEUDO.test(String(config.model || '')) ? (config.compactModel || DEFAULT_MODEL) : config.model;
+  const transcript = (messages || [])
+    .filter((m) => m.role !== 'system')
+    .map((m) => `[${m.role}] ${textOf(m.content).replace(/\s+/g, ' ').slice(0, 600)}`)
+    .join('\n')
+    .slice(0, 16000);
+  if (!transcript.trim()) return [];
+  const sys = '你是项目知识提炼器。从下面这段对话/执行记录中，提炼出**值得跨会话长期记住**的稳定事实/约定/结论/踩坑'
+    + '（如构建与测试命令、架构决定、代码约定、易错点、外部依赖要点）。要求：每条一行，以「- 」开头，简洁具体；'
+    + '只输出真正长期有用的，不要一次性细节、不要大段代码；若与「已有记忆」重复则跳过；最多 5 条；没有则输出「(无)」。';
+  const user = (existingMemory ? '【已有记忆（勿重复）】\n' + existingMemory + '\n\n' : '') + '【本次记录】\n' + transcript;
+  const r = await streamChat({
+    baseUrl: config.baseUrl, apiKey: config.apiKey, model,
+    messages: [{ role: 'system', content: sys }, { role: 'user', content: user }],
+  });
+  const text = (r.content || '').trim();
+  if (!text || /^[（(]无[)）]$/.test(text)) return [];
+  return text.split('\n')
+    .map((l) => l.replace(/^[-*]\s*/, '').trim())
+    .filter((l) => l && !/^[（(]无[)）]$/.test(l))
+    .slice(0, 5);
+}
+
+/** 一句话小结当前对话（直连原始模型；不落对话）。返回一行文本。 */
+export async function recapConversation(messages, config) {
+  const model = PSEUDO.test(String(config.model || '')) ? (config.compactModel || DEFAULT_MODEL) : config.model;
+  const transcript = (messages || [])
+    .filter((m) => m.role !== 'system')
+    .map((m) => `[${m.role}] ${textOf(m.content).replace(/\s+/g, ' ').slice(0, 500)}`)
+    .join('\n')
+    .slice(0, 12000);
+  if (!transcript.trim()) return '（对话尚无内容）';
+  const r = await streamChat({
+    baseUrl: config.baseUrl,
+    apiKey: config.apiKey,
+    model,
+    messages: [
+      { role: 'system', content: '用一句话（不超过40个汉字）概括这段对话到目前为止在做什么、进展如何。只输出这一句话，不要引号、不要多余说明。' },
+      { role: 'user', content: transcript },
+    ],
+  });
+  return (r.content || '').trim().split('\n')[0] || '（无法生成小结）';
+}

package/src/tui/app.js

@@ -11,6 +11,7 @@
 // 仅在 TTY 且已安装 ink 时启用；未安装时 bin 回退到零依赖 readline REPL。
 
 import React, { useState, useRef, useReducer, useEffect, useMemo } from 'react';
+import { execSync } from 'node:child_process';
 import { render, Box, Text, Static, useInput, useApp } from 'ink';
 import { runTurn } from '../agent.js';
 import { fetchUsage } from '../api.js';
@@ -18,12 +19,15 @@ import { toolLabel } from '../render.js';
 import { renderMarkdown, looksLikeMarkdown } from '../markdown.js';
 import { renderWelcome } from '../banner.js';
 import { createSession, saveSession } from '../session.js';
+import { createCheckpoints } from '../checkpoints.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';
+import { loadAllowRules, loadDenyRules, matchAllowRules, suggestRule, addProjectAllowRule, riskWarning } from '../settings.js';
+import { PLAN_DENY_REASON, SANDBOX_DENY_REASON } from '../permissions.js';
+import { runVerifyLoop } from '../autofix.js';
 
 const h = React.createElement;
 
@@ -55,6 +59,10 @@ export function App({ config, cwd, session: initialSession, extraTools, yolo, in
   const pendingRef = useRef(null); // 授权中：{name,args,resolve}
   const sessionAllow = useRef(new Set());
   const rulesRef = useRef(loadAllowRules(cwd)); // settings.json 允许规则
+  const denyRef = useRef(loadDenyRules(cwd));   // settings.json 拒绝规则
+  const planRef = useRef(false);                // 计划模式（只读门控）
+  const sandboxRef = useRef(false);             // 沙箱模式（禁 shell+联网）
+  const checkpointsRef = useRef(createCheckpoints()); // /rewind 检查点
   const yoloRef = useRef(!!yolo);
   const startedRef = useRef(false);
   const statusRef = useRef('idle');
@@ -76,6 +84,9 @@ export function App({ config, cwd, session: initialSession, extraTools, yolo, in
   const [ctxTok, setCtxTok] = useState(0);
   const [todos, setTodos] = useState([]);
   const [queueLen, setQueueLen] = useState(0);
+  const [planOn, setPlanOn] = useState(false); // 计划模式（底栏指示）
+  const [statusLineOut, setStatusLineOut] = useState(''); // /statusline 自定义底栏输出
+  const loopRef = useRef(null); // /loop 定时器
   const [spin, setSpin] = useState(0);
   const [win, setWin] = useState(null); // Token 用量窗口（5小时/7天）最新快照
   const winRef = useRef(null);           // 同上，供异步路径同步读取（发起回合前的用尽拦截）
@@ -125,6 +136,30 @@ export function App({ config, cwd, session: initialSession, extraTools, yolo, in
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, []);
 
+  // /statusline：定期运行自定义命令，其 stdout 首行显示在底栏
+  useEffect(() => {
+    if (!config.statusLine) {
+      setStatusLineOut('');
+      return undefined;
+    }
+    const run = () => {
+      try {
+        const out = execSync(config.statusLine, { cwd, timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'] })
+          .toString().split('\n')[0].slice(0, 80);
+        setStatusLineOut(out);
+      } catch {
+        setStatusLineOut('');
+      }
+    };
+    run();
+    const t = setInterval(run, 5000);
+    return () => clearInterval(t);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [config.statusLine]);
+
+  // /loop 定时器卸载清理
+  useEffect(() => () => { if (loopRef.current) clearInterval(loopRef.current); }, []);
+
   const thinkRef = useRef(''); // 思考过程（reasoning）流式缓冲，仅动态区展示不入定稿记录
   const events = {
     onDelta: (t) => {
@@ -155,9 +190,18 @@ export function App({ config, cwd, session: initialSession, extraTools, yolo, in
     },
   };
 
-  // ink 版权限：只读/yolo/本会话/settings 规则放行；否则弹提示等待按键（y/a/A/n）
+  // ink 版权限：deny 优先拦截 → 计划模式拦写/执行 → 只读/yolo/本会话/settings 规则放行；否则弹提示等待按键（y/a/A/n）
   const permissions = {
     request: (name, args, _cwd, readOnly) => {
+      if (denyRef.current.length && matchAllowRules(denyRef.current, name, args)) {
+        return Promise.resolve({ allow: false, reason: '该操作被拒绝规则阻止（/permissions 查看或移除）。' });
+      }
+      if (planRef.current && !readOnly) {
+        return Promise.resolve({ allow: false, reason: PLAN_DENY_REASON });
+      }
+      if (sandboxRef.current && (name === 'run_bash' || name === 'fetch_url')) {
+        return Promise.resolve({ allow: false, reason: SANDBOX_DENY_REASON });
+      }
       if (readOnly || yoloRef.current || sessionAllow.current.has(name)
         || matchAllowRules(rulesRef.current, name, args)) {
         return Promise.resolve({ allow: true });
@@ -171,6 +215,19 @@ export function App({ config, cwd, session: initialSession, extraTools, yolo, in
     setYolo: (v) => {
       yoloRef.current = !!v;
     },
+    setPlanMode: (v) => {
+      planRef.current = !!v;
+      setPlanOn(!!v);
+    },
+    isPlanMode: () => planRef.current,
+    setSandbox: (v) => {
+      sandboxRef.current = !!v;
+    },
+    isSandbox: () => sandboxRef.current,
+    reloadRules: () => {
+      rulesRef.current = loadAllowRules(cwd);
+      denyRef.current = loadDenyRules(cwd);
+    },
   };
 
   const pullQueued = () => {
@@ -188,6 +245,8 @@ export function App({ config, cwd, session: initialSession, extraTools, yolo, in
       return;
     }
     const { text: expanded, images } = await expandAtMentions(text, cwd, config);
+    // 回合前记录检查点（供 /rewind），journal 由 runTurn 累积本回合文件原文
+    const journal = checkpointsRef.current.snapshot({ session: sessionRef.current, label: text });
     sessionRef.current.messages.push({ role: 'user', content: buildUserContent(expanded, images) });
     setBusy(true);
     abortRef.current = new AbortController();
@@ -203,6 +262,7 @@ export function App({ config, cwd, session: initialSession, extraTools, yolo, in
       todoState: todoStateRef.current,
       compaction: sessionRef.current.compaction,
       pullQueued,
+      fileJournal: journal,
     });
     abortRef.current = null;
     flushLive();
@@ -219,6 +279,7 @@ export function App({ config, cwd, session: initialSession, extraTools, yolo, in
     }
     setBusy(false);
     void refreshUsage(); // 回合结束刷新用量窗口（含被 429 用尽的情形 → 更新右下角提示 + 拦截下一回合）
+    return r;
   };
 
   const doExit = () => {
@@ -235,6 +296,7 @@ export function App({ config, cwd, session: initialSession, extraTools, yolo, in
       permissions,
       extraTools,
       session: sessionRef.current,
+      checkpoints: checkpointsRef.current,
       print: (t) => addLog('info', String(t)),
     };
     const r = await runSlash(line, ctx);
@@ -242,6 +304,7 @@ export function App({ config, cwd, session: initialSession, extraTools, yolo, in
     if (r.action === 'clear') {
       sessionRef.current = createSession({ cwd, model: config.model, messages: [sessionRef.current.messages[0]] });
       todoStateRef.current.list = [];
+      checkpointsRef.current.list.length = 0;
       setTodos([]);
       setCtxTok(0);
       logRef.current = [];
@@ -249,6 +312,42 @@ export function App({ config, cwd, session: initialSession, extraTools, yolo, in
       setStaticKey((k) => k + 1); // 重挂 Static：复位其内部已渲染索引，新会话记录从头正常渲染
       addLog('info', '已开启新会话（旧会话仍可 --resume 恢复）');
     }
+    if (r.action === 'refresh') {
+      // /rewind 回退对话：会话已被截断，复位派生的动态状态（记录条已由命令打印，保留在滚动区）
+      todoStateRef.current.list = [];
+      setTodos([]);
+      setCtxTok(0);
+    }
+    if (r.action === 'autofix') {
+      await runVerifyLoop({
+        command: r.command,
+        maxIters: r.maxIters,
+        cwd,
+        runTurnOnce: (p) => runUserTurn(p),
+        emit: (t) => addLog('info', t),
+      });
+    }
+    if (r.action === 'cd') {
+      // 富 TUI 内切换目录需重建整套渲染上下文，代价高：引导到普通模式
+      addLog('info', '富 TUI 暂不支持 /cd 切换目录；请用 huicai --plain（普通模式）使用，或退出后到目标目录重开。');
+    }
+    if (r.action === 'loop') {
+      if (loopRef.current) {
+        clearInterval(loopRef.current);
+        loopRef.current = null;
+      }
+      if (r.stop) {
+        addLog('info', '已停止循环。');
+      } else {
+        addLog('info', `已开始循环：每 ${r.seconds}s 运行「${r.prompt}」（/loop off 停止）`);
+        loopRef.current = setInterval(() => {
+          if (statusRef.current !== 'busy') {
+            addLog('user', r.prompt);
+            void runUserTurn(r.prompt);
+          }
+        }, r.seconds * 1000);
+      }
+    }
     if (r.prompt) {
       if (statusRef.current === 'busy') {
         queueRef.current.push(r.prompt);
@@ -519,7 +618,8 @@ export function App({ config, cwd, session: initialSession, extraTools, yolo, in
       Box,
       { justifyContent: 'space-between' },
       h(Text, { color: 'gray' },
-        `${cwdName} · ${config.model}${yoloRef.current ? ' · ⚠ yolo' : ''}`
+        (statusLineOut ? statusLineOut + ' · ' : '')
+          + `${cwdName} · ${config.model}${yoloRef.current ? ' · ⚠ yolo' : ''}${planOn ? ' · 📋 计划' : ''}`
           + (queueLen ? ` · 排队 ${queueLen}` : '')
           + ' · /help'),
       uWarn ? h(Text, { color: uStat.level === 'exhausted' ? 'red' : 'yellow', bold: true }, uWarn) : h(Text, null, ''),

package/src/watch.js

@@ -0,0 +1,74 @@
+// huicai watch：监听工作目录文件变更，防抖后派生一个智能体任务（响应式自动化）。
+// 例：保存代码即自动跑测试/审查。默认任务可自定义（-p），文件名可用 glob 过滤（--glob "*.js"）。
+
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { huicaiBin } from './forks.js';
+
+const IGNORE = new Set([
+  '.git', 'node_modules', 'dist', 'build', 'target', 'out', '.next', '.nuxt',
+  '.venv', 'venv', '__pycache__', '.idea', '.gradle', 'coverage', '.cache',
+]);
+
+function patToRegex(pattern) {
+  return new RegExp('^' + String(pattern).replace(/[.+^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '.*') + '$');
+}
+
+/**
+ * 启动文件监听。
+ * @param {{cwd:string, prompt:string, pattern?:string, debounceMs?:number, log?:(s:string)=>void, spawnImpl?:Function}} p
+ */
+export async function runWatch({ cwd, prompt, pattern = null, debounceMs = 1500, log = (s) => process.stdout.write(s + '\n'), spawnImpl }) {
+  const bin = huicaiBin();
+  if (!bin && !spawnImpl) throw new Error('无法定位 huicai 可执行文件（watch 需在 CLI 环境运行）');
+  const re = pattern ? patToRegex(pattern) : null;
+  let timer = null;
+  let running = false;
+  const changed = new Set();
+
+  const doSpawn = spawnImpl || ((fullPrompt) => {
+    const child = spawn(process.execPath, [bin, '-p', fullPrompt, '--yolo', '--plain'], { cwd, stdio: 'inherit', env: process.env });
+    return child;
+  });
+
+  const trigger = () => {
+    if (running) return;
+    running = true;
+    const files = [...changed];
+    changed.clear();
+    log(`\n▶ 变更 ${files.length} 文件 → 触发智能体：${prompt}`);
+    const fullPrompt = prompt + (files.length ? `\n（刚变更的文件：${files.slice(0, 20).join(', ')}）` : '');
+    const child = doSpawn(fullPrompt);
+    const done = () => {
+      running = false;
+      if (changed.size) schedule();
+    };
+    if (child && child.on) child.on('close', done);
+    else done();
+  };
+  const schedule = () => {
+    if (timer) clearTimeout(timer);
+    timer = setTimeout(trigger, debounceMs);
+  };
+
+  const watcher = fs.watch(cwd, { recursive: true }, (event, filename) => {
+    if (!filename) return;
+    const rel = String(filename);
+    const top = rel.split(path.sep)[0];
+    if (IGNORE.has(top)) return;
+    if (re && !re.test(path.basename(rel))) return;
+    changed.add(rel);
+    schedule();
+  });
+
+  log(`huicai 监听已启动：${cwd}${pattern ? ` (${pattern})` : ''} → 变更即跑「${prompt}」· Ctrl-C 退出`);
+  await new Promise((resolve) => {
+    process.on('SIGINT', () => {
+      watcher.close();
+      if (timer) clearTimeout(timer);
+      log('\n监听已停止。');
+      resolve();
+    });
+  });
+}