@huicai/cli 2026.711.0 → 2026.711.24617

package/src/hooks.js

@@ -1,207 +1 @@
-// 工具事件钩子（对标 Claude Code hooks）：在关键节点跑用户自定义 shell 命令。
-// 配置在 settings.json（全局 ~/.huicai + 项目 .huicai）：
-//   { "hooks": {
-//       "UserPromptSubmit": [{ "command": "..." }],
-//       "PreToolUse":  [{ "matcher": "write_file|edit_file", "command": "..." }],
-//       "PostToolUse": [{ "matcher": "run_bash", "command": "npm test" }],
-//       "Stop":        [{ "command": "..." }]
-//   } }
-// matcher 为工具名正则（仅 Pre/PostToolUse 有意义；缺省匹配全部工具）。
-// 命令通过环境变量 + stdin(JSON) 拿到上下文：
-//   HUICAI_EVENT / HUICAI_CWD / HUICAI_TOOL_NAME / HUICAI_TOOL_PATH / HUICAI_TOOL_ARGS(JSON)。
-// 阻断语义：PreToolUse / UserPromptSubmit 的钩子以「非零退出码」表示阻断（stderr/stdout 作为原因回灌）；
-//   PostToolUse / Stop / SessionStart 不阻断，仅采集输出（stdout 会附加到工具结果/提示，供模型看到）。
-// 结构化控制（进阶）：钩子若把 JSON 打到 stdout，则按结构化决策处理（优先于退出码）：
-//   {"decision":"block","reason":"..."}      阻断该操作（仅阻断类事件）
-//   {"context":"..."}                          把文本作为附加上下文注入模型
-//   {"modifiedArgs":{...}}                     (PreToolUse) 覆盖该工具的调用参数
-//   多个字段可同时出现。非 JSON 输出仍按「纯文本 + 退出码」旧语义处理（向后兼容）。
-// SessionStart 事件：本会话首个用户回合前触发一次，常用于注入项目上下文（context 字段）。
-//
-// 安全：全局设置里的钩子始终生效（用户本机配置，可信）；项目 .huicai/settings.json 里的钩子默认**不执行**
-//   （克隆来的仓库可能植入恶意命令），需显式信任：环境变量 HUICAI_PROJECT_HOOKS=1，
-//   或全局设置 { "hooks": { "trustProject": true } }。/hooks 会提示被忽略的项目钩子数量。
-
-import { spawnSync } from 'node:child_process';
-import { loadRawSettings } from './settings.js';
-
-export const HOOK_EVENTS = ['SessionStart', 'UserPromptSubmit', 'PreToolUse', 'PostToolUse', 'Stop'];
-const BLOCKING_EVENTS = new Set(['UserPromptSubmit', 'PreToolUse']);
-
-/** 解析钩子 stdout 为结构化控制 JSON（非 JSON 返回 null）。 */
-function parseHookJson(stdout) {
-  const t = String(stdout || '').trim();
-  if (!t.startsWith('{')) return null;
-  try {
-    return JSON.parse(t);
-  } catch {
-    return null;
-  }
-}
-const DEFAULT_TIMEOUT = 30_000;
-const MAX_HOOK_OUTPUT = 8_000;
-
-/** 项目级钩子是否被信任执行。 */
-function projectHooksTrusted(globalSettings) {
-  if (process.env.HUICAI_PROJECT_HOOKS === '1') return true;
-  return globalSettings?.hooks?.trustProject === true;
-}
-
-function normalizeHooks(rawHooks, source) {
-  const out = [];
-  if (!rawHooks || typeof rawHooks !== 'object') return out;
-  for (const event of HOOK_EVENTS) {
-    const arr = rawHooks[event];
-    if (!Array.isArray(arr)) continue;
-    for (const h of arr) {
-      const command = typeof h === 'string' ? h : h?.command;
-      if (typeof command !== 'string' || !command.trim()) continue;
-      out.push({
-        event,
-        matcher: h && typeof h.matcher === 'string' && h.matcher.trim() ? h.matcher.trim() : null,
-        command: command.trim(),
-        timeout: Number(h?.timeout) > 0 ? Number(h.timeout) : DEFAULT_TIMEOUT,
-        source,
-      });
-    }
-  }
-  return out;
-}
-
-/**
- * 加载生效钩子。
- * @returns {{ byEvent: Record<string, object[]>, all: object[], projectIgnored: number, projectTrusted: boolean }}
- */
-export function loadHooks(cwd) {
-  const { global, project } = loadRawSettings(cwd);
-  const trusted = projectHooksTrusted(global);
-  const all = [...normalizeHooks(global.hooks, 'global')];
-  const projectHooks = normalizeHooks(project.hooks, 'project');
-  let projectIgnored = 0;
-  if (trusted) all.push(...projectHooks);
-  else projectIgnored = projectHooks.length;
-
-  const byEvent = Object.fromEntries(HOOK_EVENTS.map((e) => [e, []]));
-  for (const h of all) byEvent[h.event].push(h);
-  return { byEvent, all, projectIgnored, projectTrusted: trusted };
-}
-
-/** 该钩子是否匹配此工具名（无 matcher 或非工具事件恒真）。 */
-export function hookMatches(hook, toolName) {
-  if (!hook.matcher) return true;
-  if (!toolName) return true;
-  try {
-    return new RegExp(hook.matcher).test(toolName);
-  } catch {
-    return false; // 非法正则：视为不匹配，避免误伤全部
-  }
-}
-
-function clip(s) {
-  s = String(s || '');
-  return s.length > MAX_HOOK_OUTPUT ? s.slice(0, MAX_HOOK_OUTPUT) + '\n…（钩子输出已截断）' : s;
-}
-
-function runOne(hook, env, input) {
-  const isWin = process.platform === 'win32';
-  const r = isWin
-    ? spawnSync(process.env.COMSPEC || 'cmd.exe', ['/d', '/s', '/c', hook.command],
-      { cwd: env.HUICAI_CWD, env, input, encoding: 'utf8', timeout: hook.timeout, maxBuffer: 4 * 1024 * 1024, windowsVerbatimArguments: true })
-    : spawnSync(process.env.SHELL || '/bin/sh', ['-c', hook.command],
-      { cwd: env.HUICAI_CWD, env, input, encoding: 'utf8', timeout: hook.timeout, maxBuffer: 4 * 1024 * 1024 });
-  const stdout = clip(r.stdout);
-  const stderr = clip(r.stderr);
-  const timedOut = r.error && r.error.code === 'ETIMEDOUT';
-  const status = timedOut ? 124 : (r.status == null ? 1 : r.status);
-  return { stdout, stderr, status, timedOut };
-}
-
-/**
- * 触发某事件的全部匹配钩子（同步、有序）。
- * @param {string} event
- * @param {{cwd:string, toolName?:string, args?:object, prompt?:string, result?:string}} payload
- * @param {{byEvent?:object}} [loaded] 预加载的钩子（省略则按 cwd 现读）
- * @returns {{ block:boolean, reason:string, outputs:{command:string,stdout:string}[] }}
- */
-export function runHooks(event, payload, loaded) {
-  const cwd = payload.cwd;
-  const hooks = (loaded?.byEvent?.[event]) || loadHooks(cwd).byEvent[event] || [];
-  const matching = hooks.filter((h) => hookMatches(h, payload.toolName));
-  const result = { block: false, reason: '', outputs: [], injectContext: '', modifiedArgs: null };
-  if (!matching.length) return result;
-
-  const env = {
-    ...process.env,
-    HUICAI_EVENT: event,
-    HUICAI_CWD: cwd || process.cwd(),
-    HUICAI_TOOL_NAME: payload.toolName || '',
-    HUICAI_TOOL_PATH: payload.args && payload.args.path != null ? String(payload.args.path) : '',
-    HUICAI_TOOL_ARGS: (() => { try { return JSON.stringify(payload.args || {}); } catch { return '{}'; } })(),
-  };
-  const input = (() => { try { return JSON.stringify(payload); } catch { return '{}'; } })();
-
-  for (const hook of matching) {
-    let r;
-    try {
-      r = runOne(hook, env, input);
-    } catch (e) {
-      r = { stdout: '', stderr: String(e.message || e), status: 1, timedOut: false };
-    }
-    const json = parseHookJson(r.stdout);
-    if (json) {
-      // 结构化控制（JSON 输出优先于退出码）
-      if (typeof json.context === 'string' && json.context.trim()) {
-        result.injectContext += (result.injectContext ? '\n' : '') + json.context.trim();
-      }
-      if (json.modifiedArgs && typeof json.modifiedArgs === 'object') {
-        result.modifiedArgs = { ...(result.modifiedArgs || {}), ...json.modifiedArgs };
-      }
-      if (json.decision === 'block' && BLOCKING_EVENTS.has(event)) {
-        result.block = true;
-        result.reason = String(json.reason || '钩子决定阻断该操作');
-        break;
-      }
-      continue; // JSON 钩子不把原文当普通输出
-    }
-    // 纯文本钩子（向后兼容）：输出采集 + 非零退出码阻断
-    const text = (r.stdout || r.stderr || '').trim();
-    if (text) result.outputs.push({ command: hook.command, stdout: r.stdout.trim() || r.stderr.trim() });
-    if (r.status !== 0 && BLOCKING_EVENTS.has(event)) {
-      result.block = true;
-      result.reason = (r.timedOut ? `钩子超时（${hook.command}）` : (r.stderr.trim() || r.stdout.trim()
-        || `钩子以退出码 ${r.status} 阻断（${hook.command}）`));
-      break; // 一旦阻断即停止后续钩子
-    }
-  }
-  return result;
-}
-
-/** /hooks 列表展示：把已加载钩子渲染为可读文本。 */
-export function formatHooks(loaded) {
-  const lines = [];
-  const total = loaded.all.length;
-  if (!total) {
-    lines.push('未配置钩子。可在 ~/.huicai/settings.json 或 项目 .huicai/settings.json 的 "hooks" 中添加。');
-  } else {
-    for (const event of HOOK_EVENTS) {
-      const arr = loaded.byEvent[event];
-      if (!arr.length) continue;
-      lines.push(`${event}`);
-      for (const h of arr) {
-        const m = h.matcher ? `[${h.matcher}] ` : '';
-        lines.push(`  · ${m}${h.command}${h.source === 'global' ? '' : '（项目）'}`);
-      }
-    }
-  }
-  if (loaded.projectIgnored > 0) {
-    lines.push('');
-    lines.push(`⚠ 已忽略 ${loaded.projectIgnored} 条项目级钩子（未信任本项目）。`);
-    lines.push('  如信任本项目，设 HUICAI_PROJECT_HOOKS=1，或全局设置 hooks.trustProject=true。');
-  }
-  lines.push('');
-  lines.push('事件：SessionStart（会话开始，注入上下文）· UserPromptSubmit（提交前，注入/阻断）'
-    + '· PreToolUse（工具前，阻断/改参数）· PostToolUse（工具后，采输出）· Stop（回合结束）。');
-  lines.push('结构化控制：钩子可把 JSON 打到 stdout —— {"decision":"block","reason":..} 阻断 / '
-    + '{"context":".."} 注入上下文 / {"modifiedArgs":{..}} 改工具参数。');
-  return lines.join('\n');
-}
+import{spawnSync as t}from"node:child_process";import{loadRawSettings as o}from"./settings.js";export const HOOK_EVENTS=["SessionStart","UserPromptSubmit","PreToolUse","PostToolUse","Stop"];const r=new Set(["UserPromptSubmit","PreToolUse"]);function e(t){const o=String(t||"").trim();if(!o.startsWith("{"))return null;try{return JSON.parse(o)}catch{return null}}function s(t,o){const r=[];if(!t||"object"!=typeof t)return r;for(const e of HOOK_EVENTS){const s=t[e];if(Array.isArray(s))for(const t of s){const s="string"==typeof t?t:t?.command;"string"==typeof s&&s.trim()&&r.push({event:e,matcher:t&&"string"==typeof t.matcher&&t.matcher.trim()?t.matcher.trim():null,command:s.trim(),timeout:Number(t?.timeout)>0?Number(t.timeout):3e4,source:o})}}return r}export function loadHooks(t){const{global:r,project:e}=o(t),n=(c=r,"1"===process.env.HUICAI_PROJECT_HOOKS||!0===c?.hooks?.trustProject);var c;const i=[...s(r.hooks,"global")],u=s(e.hooks,"project");let m=0;n?i.push(...u):m=u.length;const a=Object.fromEntries(HOOK_EVENTS.map(t=>[t,[]]));for(const t of i)a[t.event].push(t);return{byEvent:a,all:i,projectIgnored:m,projectTrusted:n}}export function hookMatches(t,o){if(!t.matcher)return!0;if(!o)return!0;try{return new RegExp(t.matcher).test(o)}catch{return!1}}function n(t){return(t=String(t||"")).length>8e3?t.slice(0,8e3)+"\n…（钩子输出已截断）":t}function c(o,r,e){const s="win32"===process.platform?t(process.env.COMSPEC||"cmd.exe",["/d","/s","/c",o.command],{cwd:r.HUICAI_CWD,env:r,input:e,encoding:"utf8",timeout:o.timeout,maxBuffer:4194304,windowsVerbatimArguments:!0}):t(process.env.SHELL||"/bin/sh",["-c",o.command],{cwd:r.HUICAI_CWD,env:r,input:e,encoding:"utf8",timeout:o.timeout,maxBuffer:4194304}),c=n(s.stdout),i=n(s.stderr),u=s.error&&"ETIMEDOUT"===s.error.code;return{stdout:c,stderr:i,status:u?124:null==s.status?1:s.status,timedOut:u}}export function runHooks(t,o,s){const n=o.cwd,i=(s?.byEvent?.[t]||loadHooks(n).byEvent[t]||[]).filter(t=>hookMatches(t,o.toolName)),u={block:!1,reason:"",outputs:[],injectContext:"",modifiedArgs:null};if(!i.length)return u;const m={...process.env,HUICAI_EVENT:t,HUICAI_CWD:n||process.cwd(),HUICAI_TOOL_NAME:o.toolName||"",HUICAI_TOOL_PATH:o.args&&null!=o.args.path?String(o.args.path):"",HUICAI_TOOL_ARGS:(()=>{try{return JSON.stringify(o.args||{})}catch{return"{}"}})()},a=(()=>{try{return JSON.stringify(o)}catch{return"{}"}})();for(const o of i){let s;try{s=c(o,m,a)}catch(t){s={stdout:"",stderr:String(t.message||t),status:1,timedOut:!1}}const n=e(s.stdout);if(n){if("string"==typeof n.context&&n.context.trim()&&(u.injectContext+=(u.injectContext?"\n":"")+n.context.trim()),n.modifiedArgs&&"object"==typeof n.modifiedArgs&&(u.modifiedArgs={...u.modifiedArgs||{},...n.modifiedArgs}),"block"===n.decision&&r.has(t)){u.block=!0,u.reason=String(n.reason||"钩子决定阻断该操作");break}continue}if((s.stdout||s.stderr||"").trim()&&u.outputs.push({command:o.command,stdout:s.stdout.trim()||s.stderr.trim()}),0!==s.status&&r.has(t)){u.block=!0,u.reason=s.timedOut?`钩子超时（${o.command}）`:s.stderr.trim()||s.stdout.trim()||`钩子以退出码 ${s.status} 阻断（${o.command}）`;break}}return u}export function formatHooks(t){const o=[];if(t.all.length)for(const r of HOOK_EVENTS){const e=t.byEvent[r];if(e.length){o.push(`${r}`);for(const t of e){const r=t.matcher?`[${t.matcher}] `:"";o.push(`  · ${r}${t.command}${"global"===t.source?"":"（项目）"}`)}}}else o.push('未配置钩子。可在 ~/.huicai/settings.json 或 项目 .huicai/settings.json 的 "hooks" 中添加。');return t.projectIgnored>0&&(o.push(""),o.push(`⚠ 已忽略 ${t.projectIgnored} 条项目级钩子（未信任本项目）。`),o.push("  如信任本项目，设 HUICAI_PROJECT_HOOKS=1，或全局设置 hooks.trustProject=true。")),o.push(""),o.push("事件：SessionStart（会话开始，注入上下文）· UserPromptSubmit（提交前，注入/阻断）· PreToolUse（工具前，阻断/改参数）· PostToolUse（工具后，采输出）· Stop（回合结束）。"),o.push('结构化控制：钩子可把 JSON 打到 stdout —— {"decision":"block","reason":..} 阻断 / {"context":".."} 注入上下文 / {"modifiedArgs":{..}} 改工具参数。'),o.join("\n")}

package/src/ide.js

@@ -1,53 +1 @@
-// IDE 桥接客户端：当运行在 huicai VS Code 扩展启动的终端里（扩展经环境变量注入本地服务端口+令牌）时，
-// 把 write_file/edit_file 的「拟写入内容」发给扩展做「内联 diff 审阅 + 应用」，而非 CLI 直接落盘。
-// 未在 IDE 环境（无 HUICAI_IDE_PORT）则本模块不介入，CLI 照常直接写文件。
-
-import http from 'node:http';
-
-const APPLY_TIMEOUT = 120_000; // 用户审阅可能较久
-
-/** 是否处于 IDE 集成环境（由扩展注入端口）。 */
-export function isActive() {
-  return !!process.env.HUICAI_IDE_PORT;
-}
-
-/**
- * 把拟写入内容提交给 IDE 扩展做内联 diff 审阅。
- * @returns {Promise<{decided:boolean, applied?:boolean, reason?:string}>}
- *   decided=false 表示传输失败（扩展未响应）——调用方应回退为直接写盘。
- */
-export function proposeWrite(absPath, content, cwd) {
-  return new Promise((resolve) => {
-    const port = process.env.HUICAI_IDE_PORT;
-    const token = process.env.HUICAI_IDE_TOKEN || '';
-    const body = JSON.stringify({ path: absPath, content, cwd, token });
-    const req = http.request(
-      {
-        host: '127.0.0.1',
-        port,
-        path: '/apply',
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json', 'Content-Length': Buffer.byteLength(body) },
-      },
-      (res) => {
-        let d = '';
-        res.on('data', (c) => (d += c));
-        res.on('end', () => {
-          try {
-            const j = JSON.parse(d);
-            resolve({ decided: true, applied: !!j.applied, reason: j.reason });
-          } catch {
-            resolve({ decided: false });
-          }
-        });
-      },
-    );
-    req.on('error', () => resolve({ decided: false }));
-    req.setTimeout(APPLY_TIMEOUT, () => {
-      req.destroy();
-      resolve({ decided: false });
-    });
-    req.write(body);
-    req.end();
-  });
-}
+import e from"node:http";export function isActive(){return!!process.env.HUICAI_IDE_PORT}export function proposeWrite(t,n,o){return new Promise(r=>{const d=process.env.HUICAI_IDE_PORT,p=process.env.HUICAI_IDE_TOKEN||"",s=JSON.stringify({path:t,content:n,cwd:o,token:p}),i=e.request({host:"127.0.0.1",port:d,path:"/apply",method:"POST",headers:{"Content-Type":"application/json","Content-Length":Buffer.byteLength(s)}},e=>{let t="";e.on("data",e=>t+=e),e.on("end",()=>{try{const e=JSON.parse(t);r({decided:!0,applied:!!e.applied,reason:e.reason})}catch{r({decided:!1})}})});i.on("error",()=>r({decided:!1})),i.setTimeout(12e4,()=>{i.destroy(),r({decided:!1})}),i.write(s),i.end()})}

package/src/input.js

@@ -1,182 +1 @@
-// 输入预处理与历史：
-//  - @文件 引用：消息中的 @路径 自动展开为文件内容（附在消息末尾），目录则展开为清单；
-//  - !命令 直通：以 ! 开头的输入直接在本机执行 shell 命令，输出加入对话上下文（不消耗模型调用）；
-//  - 输入历史：按项目目录持久化到 ~/.huicai/history.json，供 REPL/TUI 上下键翻阅。
-
-import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-import { CONFIG_DIR } from './config.js';
-import { runBash } from './executors.js';
-import { extractDocument } from './api.js';
-
-const MAX_MENTIONS = 5;
-const MENTION_FILE_CHARS = 12_000;
-const HISTORY_PATH = path.join(CONFIG_DIR, 'history.json');
-const HISTORY_CAP = 1000;
-
-/** 图片扩展名 → 作为多模态 image_url 附加。 */
-const IMAGE_MIME = {
-  png: 'image/png', jpg: 'image/jpeg', jpeg: 'image/jpeg', gif: 'image/gif',
-  webp: 'image/webp', bmp: 'image/bmp', svg: 'image/svg+xml',
-};
-/** 文档扩展名 → 经平台 /v1/files/extract 解析为纯文本（与 VSCode 扩展附件同源）。 */
-const DOC_EXT = new Set(['pdf', 'doc', 'docx', 'xls', 'xlsx', 'ppt', 'pptx', 'rtf', 'odt', 'ods', 'odp', 'csv']);
-const MAX_IMAGE_BYTES = 8 * 1024 * 1024;
-const MAX_DOC_BYTES = 20 * 1024 * 1024;
-
-/**
- * 展开消息中的 @文件/@目录 引用：原文保留，内容以引用块追加在末尾（模型可见全文）。
- * @returns {{text:string, mentions:string[]}}
- */
-export async function expandAtMentions(text, cwd, config = null) {
-  const re = /(^|[\s("'`（【,，:：])@([~A-Za-z0-9_./\\-]+)/g;
-  const seen = new Set();
-  const candidates = [];
-  let m;
-  while ((m = re.exec(text)) && candidates.length < MAX_MENTIONS) {
-    const raw = m[2].replace(/[.,;:。，；]+$/, ''); // 去句尾标点
-    if (raw && !seen.has(raw)) {
-      seen.add(raw);
-      candidates.push(raw);
-    }
-  }
-  const blocks = [];
-  const images = []; // 多模态图片附件 {label, dataUri}
-  const mentions = [];
-  for (const raw of candidates) {
-    const abs = raw.startsWith('~') ? path.join(os.homedir(), raw.slice(1)) : path.resolve(cwd, raw);
-    let st;
-    try {
-      st = fs.statSync(abs);
-    } catch {
-      continue; // 不存在的路径按普通文本处理
-    }
-    mentions.push(raw);
-    if (st.isDirectory()) {
-      try {
-        const entries = fs.readdirSync(abs).slice(0, 100).join('\n');
-        blocks.push(`【引用目录 @${raw}】\n${entries || '（空目录）'}`);
-      } catch {
-        /* ignore */
-      }
-      continue;
-    }
-    const ext = path.extname(abs).slice(1).toLowerCase();
-    // 图片：作为多模态 image_url 附加（需当前模型支持视觉，或走平台伪模型的服务端识图）
-    if (IMAGE_MIME[ext]) {
-      if (st.size > MAX_IMAGE_BYTES) {
-        blocks.push(`【图片 @${raw}】（超过 ${Math.round(MAX_IMAGE_BYTES / 1048576)}MB，未附加）`);
-      } else {
-        try {
-          const b64 = fs.readFileSync(abs).toString('base64');
-          images.push({ label: raw, dataUri: `data:${IMAGE_MIME[ext]};base64,${b64}` });
-          blocks.push(`【已附加图片 @${raw}】`);
-        } catch {
-          /* ignore */
-        }
-      }
-      continue;
-    }
-    // 文档（PDF/Word/Excel/PPT/RTF…）：经平台 /v1/files/extract 解析为纯文本
-    if (DOC_EXT.has(ext)) {
-      if (!config || !config.baseUrl || !config.apiKey) {
-        blocks.push(`【文档 @${raw}】（需登录后才能解析为文本）`);
-      } else if (st.size > MAX_DOC_BYTES) {
-        blocks.push(`【文档 @${raw}】（超过 ${Math.round(MAX_DOC_BYTES / 1048576)}MB，未解析）`);
-      } else {
-        try {
-          const b64 = fs.readFileSync(abs).toString('base64');
-          const r = await extractDocument(config.baseUrl, config.apiKey,
-            { filename: path.basename(abs), data: b64, maxChars: 60_000 });
-          const meta = `${r.pages ? r.pages + '页·' : ''}${r.chars ?? 0}字${r.truncated ? '·已截断' : ''}`;
-          blocks.push(`【引用文档 @${raw}（${meta}）】\n${r.text || '（空）'}`);
-        } catch (e) {
-          blocks.push(`【文档 @${raw}】（解析失败：${e.message}）`);
-        }
-      }
-      continue;
-    }
-    // 其余：文本文件展开，二进制跳过
-    if (st.size > 512 * 1024) {
-      blocks.push(`【引用文件 @${raw}】\n（文件过大：${Math.round(st.size / 1024)}KB，未展开；可让我用 read_file 分段读取）`);
-      continue;
-    }
-    try {
-      const buf = fs.readFileSync(abs);
-      if (isBinary(buf)) {
-        blocks.push(`【引用文件 @${raw}】\n（二进制文件，未展开）`);
-        continue;
-      }
-      let content = buf.toString('utf8');
-      if (content.length > MENTION_FILE_CHARS) content = content.slice(0, MENTION_FILE_CHARS) + '\n…（已截断）';
-      blocks.push(`【引用文件 @${raw}】\n\`\`\`\n${content}\n\`\`\``);
-    } catch {
-      /* ignore */
-    }
-  }
-  const outText = blocks.length ? text + '\n\n' + blocks.join('\n\n') : text;
-  return { text: outText, mentions, images };
-}
-
-function isBinary(buf) {
-  const n = Math.min(buf.length, 4096);
-  for (let i = 0; i < n; i++) if (buf[i] === 0) return true;
-  return false;
-}
-
-/** 组装用户消息 content：有图片附件则用 OpenAI 多模态数组，否则纯文本字符串。 */
-export function buildUserContent(text, images) {
-  if (!images || !images.length) return text;
-  return [
-    { type: 'text', text },
-    ...images.map((i) => ({ type: 'image_url', image_url: { url: i.dataUri } })),
-  ];
-}
-
-/**
- * 执行 !命令 直通：在 cwd 下跑 shell 命令，返回展示文本与写入对话的记录文本。
- * @returns {Promise<{output:string, record:string}>}
- */
-export async function runBangCommand(command, cwd) {
-  const output = await runBash(cwd, { command });
-  const capped = output.length > 8000 ? output.slice(0, 8000) + '\n…（已截断）' : output;
-  return {
-    output,
-    record: `我在终端直接执行了命令：$ ${command}\n${capped}`,
-  };
-}
-
-function readHistoryFile() {
-  try {
-    const j = JSON.parse(fs.readFileSync(HISTORY_PATH, 'utf8'));
-    return Array.isArray(j?.entries) ? j.entries : [];
-  } catch {
-    return [];
-  }
-}
-
-/** 读取某目录的输入历史（旧→新）。 */
-export function loadHistory(cwd, limit = 200) {
-  return readHistoryFile()
-    .filter((e) => e && e.cwd === cwd && typeof e.line === 'string')
-    .slice(-limit)
-    .map((e) => e.line);
-}
-
-/** 追加一条输入历史（连续重复不记）。best-effort，失败静默。 */
-export function appendHistory(cwd, line) {
-  const t = String(line || '').trim();
-  if (!t) return;
-  try {
-    let entries = readHistoryFile();
-    const last = [...entries].reverse().find((e) => e.cwd === cwd);
-    if (last && last.line === t) return;
-    entries.push({ cwd, line: t, ts: Date.now() });
-    if (entries.length > HISTORY_CAP) entries = entries.slice(-HISTORY_CAP);
-    fs.mkdirSync(CONFIG_DIR, { recursive: true });
-    fs.writeFileSync(HISTORY_PATH, JSON.stringify({ entries }), { mode: 0o600 });
-  } catch {
-    /* ignore */
-  }
-}
+import e from"node:fs";import t from"node:path";import n from"node:os";import{CONFIG_DIR as r}from"./config.js";import{runBash as i}from"./executors.js";import{extractDocument as s}from"./api.js";const o=t.join(r,"history.json"),a={png:"image/png",jpg:"image/jpeg",jpeg:"image/jpeg",gif:"image/gif",webp:"image/webp",bmp:"image/bmp",svg:"image/svg+xml"},c=new Set(["pdf","doc","docx","xls","xlsx","ppt","pptx","rtf","odt","ods","odp","csv"]),p=8388608,l=20971520;export async function expandAtMentions(r,i,o=null){const f=/(^|[\s("'`（【,，:：])@([~A-Za-z0-9_./\\-]+)/g,m=new Set,d=[];let h;for(;(h=f.exec(r))&&d.length<5;){const e=h[2].replace(/[.,;:。，；]+$/,"");e&&!m.has(e)&&(m.add(e),d.push(e))}const g=[],y=[],$=[];for(const r of d){const f=r.startsWith("~")?t.join(n.homedir(),r.slice(1)):t.resolve(i,r);let m;try{m=e.statSync(f)}catch{continue}if($.push(r),m.isDirectory()){try{const t=e.readdirSync(f).slice(0,100).join("\n");g.push(`【引用目录 @${r}】\n${t||"（空目录）"}`)}catch{}continue}const d=t.extname(f).slice(1).toLowerCase();if(a[d])if(m.size>p)g.push(`【图片 @${r}】（超过 ${Math.round(8)}MB，未附加）`);else try{const t=e.readFileSync(f).toString("base64");y.push({label:r,dataUri:`data:${a[d]};base64,${t}`}),g.push(`【已附加图片 @${r}】`)}catch{}else if(c.has(d))if(o&&o.baseUrl&&o.apiKey)if(m.size>l)g.push(`【文档 @${r}】（超过 ${Math.round(20)}MB，未解析）`);else try{const n=e.readFileSync(f).toString("base64"),i=await s(o.baseUrl,o.apiKey,{filename:t.basename(f),data:n,maxChars:6e4}),a=`${i.pages?i.pages+"页·":""}${i.chars??0}字${i.truncated?"·已截断":""}`;g.push(`【引用文档 @${r}（${a}）】\n${i.text||"（空）"}`)}catch(e){g.push(`【文档 @${r}】（解析失败：${e.message}）`)}else g.push(`【文档 @${r}】（需登录后才能解析为文本）`);else if(m.size>524288)g.push(`【引用文件 @${r}】\n（文件过大：${Math.round(m.size/1024)}KB，未展开；可让我用 read_file 分段读取）`);else try{const t=e.readFileSync(f);if(u(t)){g.push(`【引用文件 @${r}】\n（二进制文件，未展开）`);continue}let n=t.toString("utf8");n.length>12e3&&(n=n.slice(0,12e3)+"\n…（已截断）"),g.push(`【引用文件 @${r}】\n\`\`\`\n${n}\n\`\`\``)}catch{}}return{text:g.length?r+"\n\n"+g.join("\n\n"):r,mentions:$,images:y}}function u(e){const t=Math.min(e.length,4096);for(let n=0;n<t;n++)if(0===e[n])return!0;return!1}export function buildUserContent(e,t){return t&&t.length?[{type:"text",text:e},...t.map(e=>({type:"image_url",image_url:{url:e.dataUri}}))]:e}export async function runBangCommand(e,t){const n=await i(t,{command:e}),r=n.length>8e3?n.slice(0,8e3)+"\n…（已截断）":n;return{output:n,record:`我在终端直接执行了命令：$ ${e}\n${r}`}}function f(){try{const t=JSON.parse(e.readFileSync(o,"utf8"));return Array.isArray(t?.entries)?t.entries:[]}catch{return[]}}export function loadHistory(e,t=200){return f().filter(t=>t&&t.cwd===e&&"string"==typeof t.line).slice(-t).map(e=>e.line)}export function appendHistory(t,n){const i=String(n||"").trim();if(i)try{let n=f();const s=[...n].reverse().find(e=>e.cwd===t);if(s&&s.line===i)return;n.push({cwd:t,line:i,ts:Date.now()}),n.length>1e3&&(n=n.slice(-1e3)),e.mkdirSync(r,{recursive:!0}),e.writeFileSync(o,JSON.stringify({entries:n}),{mode:384})}catch{}}

package/src/insights.js

@@ -1,102 +1 @@
-// /insights：从本机会话（~/.huicai/sessions）聚合使用洞察——数量/轮数/活跃度/按项目·模型分布。
-// 纯元数据统计（listSessions 已给出 turns/model/cwd/updatedAt），不再逐个读全文。
-
-import path from 'node:path';
-import { c } from './colors.js';
-import { relTime } from './session.js';
-
-const DAY = 24 * 60 * 60 * 1000;
-
-function topN(counts, n) {
-  return [...counts.entries()].sort((a, b) => b[1] - a[1]).slice(0, n);
-}
-
-/** 由会话列表计算洞察数据。@param {{cwd?:string, now?:number}} [opts] */
-export function computeInsights(sessions, opts = {}) {
-  const now = opts.now || Date.now();
-  const list = Array.isArray(sessions) ? sessions : [];
-  const byProject = new Map();
-  const byModel = new Map();
-  let totalTurns = 0;
-  let last24 = 0;
-  let last7 = 0;
-  let last30 = 0;
-  let longest = null;
-  let mostRecent = 0;
-
-  for (const s of list) {
-    const turns = Number(s.turns) || 0;
-    totalTurns += turns;
-    const proj = s.cwd ? (path.basename(s.cwd) || s.cwd) : '(未知)';
-    byProject.set(proj, (byProject.get(proj) || 0) + 1);
-    const model = s.model || '(未知)';
-    byModel.set(model, (byModel.get(model) || 0) + 1);
-    const age = now - (s.updatedAt || 0);
-    if (age <= DAY) last24++;
-    if (age <= 7 * DAY) last7++;
-    if (age <= 30 * DAY) last30++;
-    if (!longest || turns > longest.turns) longest = { turns, title: s.title || '' };
-    if ((s.updatedAt || 0) > mostRecent) mostRecent = s.updatedAt || 0;
-  }
-
-  // 近 14 天每日活跃（会话更新计数）
-  const DAYS = 14;
-  const daily = new Array(DAYS).fill(0);
-  const startToday = new Date(now);
-  startToday.setHours(0, 0, 0, 0);
-  for (const s of list) {
-    const su = new Date(s.updatedAt || 0);
-    su.setHours(0, 0, 0, 0);
-    const ago = Math.floor((startToday.getTime() - su.getTime()) / DAY);
-    if (ago >= 0 && ago < DAYS) daily[DAYS - 1 - ago]++;
-  }
-
-  const cwdProj = opts.cwd ? (path.basename(opts.cwd) || opts.cwd) : null;
-  const currentProject = cwdProj
-    ? { name: cwdProj, sessions: list.filter((s) => s.cwd === opts.cwd).length,
-      turns: list.filter((s) => s.cwd === opts.cwd).reduce((n, s) => n + (Number(s.turns) || 0), 0) }
-    : null;
-
-  return {
-    total: list.length,
-    totalTurns,
-    avgTurns: list.length ? totalTurns / list.length : 0,
-    last24, last7, last30,
-    mostRecent,
-    longest,
-    byProject: topN(byProject, 5),
-    byModel: topN(byModel, 5),
-    currentProject,
-    daily,
-  };
-}
-
-const SPARK = '▁▂▃▄▅▆▇█';
-function sparkline(arr) {
-  const max = Math.max(1, ...arr);
-  return arr.map((v) => (v === 0 ? '·' : SPARK[Math.min(7, Math.floor((v / max) * 7))])).join('');
-}
-
-/** 渲染洞察报告文本。 */
-export function formatInsights(d) {
-  if (!d.total) return '本机还没有历史会话（对话发生后即可 /insights 查看统计）。';
-  const lines = [c.bold('会话洞察') + c.gray('（本机 ~/.huicai/sessions）')];
-  lines.push(`  总计      ${d.total} 个会话 · ${d.totalTurns} 轮对话`
-    + (d.mostRecent ? ` · 最近活跃 ${relTime(d.mostRecent)}` : ''));
-  lines.push(`  近况      24h ${d.last24} 个 · 7天 ${d.last7} 个 · 30天 ${d.last30} 个`);
-  if (d.daily && d.daily.some((x) => x > 0)) {
-    lines.push(`  近14天    ${sparkline(d.daily)}  ${c.gray('(峰值 ' + Math.max(...d.daily) + '/天)')}`);
-  }
-  lines.push(`  平均      ${d.avgTurns.toFixed(1)} 轮/会话`
-    + (d.longest ? ` · 最长 ${d.longest.turns} 轮${d.longest.title ? '（' + d.longest.title.slice(0, 24) + '）' : ''}` : ''));
-  if (d.byProject.length) {
-    lines.push('  按项目    ' + d.byProject.map(([k, v]) => `${k} ${v}`).join(' · '));
-  }
-  if (d.byModel.length) {
-    lines.push('  按模型    ' + d.byModel.map(([k, v]) => `${k.length > 20 ? k.slice(0, 20) + '…' : k} ${v}`).join(' · '));
-  }
-  if (d.currentProject) {
-    lines.push(c.gray(`  当前项目  ${d.currentProject.name}：${d.currentProject.sessions} 个会话 · ${d.currentProject.turns} 轮`));
-  }
-  return lines.join('\n');
-}
+import t from"node:path";import{c as e}from"./colors.js";import{relTime as n}from"./session.js";const s=864e5;function o(t,e){return[...t.entries()].sort((t,e)=>e[1]-t[1]).slice(0,e)}export function computeInsights(e,n={}){const r=n.now||Date.now(),l=Array.isArray(e)?e:[],a=new Map,c=new Map;let u=0,i=0,d=0,m=0,h=null,g=0;for(const e of l){const n=Number(e.turns)||0;u+=n;const o=e.cwd?t.basename(e.cwd)||e.cwd:"(未知)";a.set(o,(a.get(o)||0)+1);const l=e.model||"(未知)";c.set(l,(c.get(l)||0)+1);const p=r-(e.updatedAt||0);p<=s&&i++,p<=7*s&&d++,p<=30*s&&m++,(!h||n>h.turns)&&(h={turns:n,title:e.title||""}),(e.updatedAt||0)>g&&(g=e.updatedAt||0)}const p=new Array(14).fill(0),f=new Date(r);f.setHours(0,0,0,0);for(const t of l){const e=new Date(t.updatedAt||0);e.setHours(0,0,0,0);const n=Math.floor((f.getTime()-e.getTime())/s);n>=0&&n<14&&p[13-n]++}const $=n.cwd?t.basename(n.cwd)||n.cwd:null,w=$?{name:$,sessions:l.filter(t=>t.cwd===n.cwd).length,turns:l.filter(t=>t.cwd===n.cwd).reduce((t,e)=>t+(Number(e.turns)||0),0)}:null;return{total:l.length,totalTurns:u,avgTurns:l.length?u/l.length:0,last24:i,last7:d,last30:m,mostRecent:g,longest:h,byProject:o(a,5),byModel:o(c,5),currentProject:w,daily:p}}export function formatInsights(t){if(!t.total)return"本机还没有历史会话（对话发生后即可 /insights 查看统计）。";const s=[e.bold("会话洞察")+e.gray("（本机 ~/.huicai/sessions）")];return s.push(`  总计      ${t.total} 个会话 · ${t.totalTurns} 轮对话`+(t.mostRecent?` · 最近活跃 ${n(t.mostRecent)}`:"")),s.push(`  近况      24h ${t.last24} 个 · 7天 ${t.last7} 个 · 30天 ${t.last30} 个`),t.daily&&t.daily.some(t=>t>0)&&s.push(`  近14天    ${function(t){const e=Math.max(1,...t);return t.map(t=>0===t?"·":"▁▂▃▄▅▆▇█"[Math.min(7,Math.floor(t/e*7))]).join("")}(t.daily)}  ${e.gray("(峰值 "+Math.max(...t.daily)+"/天)")}`),s.push(`  平均      ${t.avgTurns.toFixed(1)} 轮/会话`+(t.longest?` · 最长 ${t.longest.turns} 轮${t.longest.title?"（"+t.longest.title.slice(0,24)+"）":""}`:"")),t.byProject.length&&s.push("  按项目    "+t.byProject.map(([t,e])=>`${t} ${e}`).join(" · ")),t.byModel.length&&s.push("  按模型    "+t.byModel.map(([t,e])=>`${t.length>20?t.slice(0,20)+"…":t} ${e}`).join(" · ")),t.currentProject&&s.push(e.gray(`  当前项目  ${t.currentProject.name}：${t.currentProject.sessions} 个会话 · ${t.currentProject.turns} 轮`)),s.join("\n")}