@huicai/cli 2026.710.97950 → 2026.711.24616

package/src/executors.js

@@ -1,391 +1 @@
-// 本地工具的执行实现（在用户本机的文件系统 / shell 上运行）。
-// 所有写操作强制限定在当前项目目录内（防误伤系统路径）；读/搜索可跨目录。
-
-import fs from 'node:fs';
-import path from 'node:path';
-import { spawn } from 'node:child_process';
-import * as ide from './ide.js';
-
-const MAX_READ_BYTES = 256 * 1024;
-const MAX_FILE_BYTES = 16 * 1024 * 1024; // 超过则要求用 offset/limit 或 grep
-const DEFAULT_READ_LINES = 2000;
-const MAX_LINE_CHARS = 2000;
-const MAX_GREP_MATCHES = 200;
-const MAX_LIST_ENTRIES = 400;
-const MAX_GLOB_RESULTS = 300;
-const BASH_DEFAULT_TIMEOUT = 120_000;
-const BASH_MAX_OUTPUT = 30_000;
-const FETCH_TIMEOUT = 30_000;
-const FETCH_MAX_BYTES = 2 * 1024 * 1024;
-const FETCH_MAX_CHARS = 80_000;
-
-const DEFAULT_IGNORES = new Set([
-  '.git', 'node_modules', 'dist', 'build', 'target', 'out', '.next', '.nuxt',
-  '.venv', 'venv', '__pycache__', '.idea', '.gradle', '.mvn', 'coverage', '.cache',
-]);
-
-/** 解析路径为绝对路径；mustBeInside 时强制落在项目目录内。 */
-function resolvePath(cwd, p, mustBeInside) {
-  if (!cwd || typeof cwd !== 'string') {
-    throw new Error('工作目录未设置：请在项目目录中运行（VS Code 中需先「打开文件夹」再对话）');
-  }
-  if (!p || typeof p !== 'string') throw new Error('缺少路径 path（工具参数里必须提供 path 字段）');
-  const abs = path.resolve(cwd, p);
-  if (mustBeInside) {
-    const rel = path.relative(cwd, abs);
-    if (rel === '' || rel.startsWith('..') || path.isAbsolute(rel)) {
-      throw new Error(`路径超出项目目录（写操作仅限当前项目内）：${p}`);
-    }
-  }
-  return abs;
-}
-
-function rel(cwd, abs) {
-  const r = path.relative(cwd, abs);
-  return r === '' ? '.' : r;
-}
-
-function isProbablyBinary(buf) {
-  const n = Math.min(buf.length, 4096);
-  for (let i = 0; i < n; i++) if (buf[i] === 0) return true;
-  return false;
-}
-
-/** 深度优先遍历文件（跳过忽略目录），产出绝对文件路径。 */
-function* walkFiles(dir, depth = 0, maxDepth = 14) {
-  let entries;
-  try {
-    entries = fs.readdirSync(dir, { withFileTypes: true });
-  } catch {
-    return;
-  }
-  for (const e of entries) {
-    if (DEFAULT_IGNORES.has(e.name)) continue;
-    const full = path.join(dir, e.name);
-    if (e.isDirectory()) {
-      if (depth < maxDepth) yield* walkFiles(full, depth + 1, maxDepth);
-    } else if (e.isFile()) {
-      yield full;
-    }
-  }
-}
-
-/** 简易 glob → 正则：支持 **（跨目录）、*（同级任意）、?（单字符）。 */
-function globToRegex(glob) {
-  let re = '';
-  for (let i = 0; i < glob.length; i++) {
-    const ch = glob[i];
-    if (ch === '*') {
-      if (glob[i + 1] === '*') {
-        re += '.*';
-        i++;
-        if (glob[i + 1] === '/') i++;
-      } else {
-        re += '[^/]*';
-      }
-    } else if (ch === '?') {
-      re += '[^/]';
-    } else if ('\\^$+.()|{}[]'.includes(ch)) {
-      re += '\\' + ch;
-    } else {
-      re += ch;
-    }
-  }
-  return new RegExp('^' + re + '$');
-}
-
-/**
- * 读取文件：输出「行号→内容」格式（行号仅供定位，不属于文件内容），默认最多 2000 行。
- * 大文件（>16MB）要求用 offset/limit 分段或 grep 检索，避免占满内存与上下文。
- */
-export function readFile(cwd, args) {
-  const abs = resolvePath(cwd, args.path, false);
-  const st = fs.statSync(abs);
-  if (st.isDirectory()) throw new Error(`是目录而非文件：${args.path}`);
-  if (st.size > MAX_FILE_BYTES) {
-    throw new Error(`文件过大（${Math.round(st.size / 1024 / 1024)}MB）：请用 grep 检索，或用 run_bash 的 head/tail/sed 分段查看`);
-  }
-  const buf = fs.readFileSync(abs);
-  if (isProbablyBinary(buf)) return `（二进制文件，${st.size} 字节，未展示内容）`;
-  const text = buf.toString('utf8');
-  if (text === '') return '（空文件）';
-
-  const lines = text.split('\n');
-  // 尾部空行（文件以 \n 结尾产生）不计入展示行数
-  if (lines.length > 1 && lines[lines.length - 1] === '') lines.pop();
-  const total = lines.length;
-  const from = Math.max(0, (Number.isFinite(args.offset) ? args.offset : 1) - 1);
-  const limit = Number.isFinite(args.limit) && args.limit > 0 ? args.limit : DEFAULT_READ_LINES;
-  const to = Math.min(total, from + limit);
-  if (from >= total) return `（起始行 ${from + 1} 超出文件总行数 ${total}）`;
-
-  const width = String(to).length;
-  const outLines = [];
-  for (let i = from; i < to; i++) {
-    let line = lines[i];
-    if (line.length > MAX_LINE_CHARS) line = line.slice(0, MAX_LINE_CHARS) + '…（行过长已截断）';
-    outLines.push(`${String(i + 1).padStart(width)}→${line}`);
-  }
-  let outText = outLines.join('\n');
-  if (from > 0 || to < total) {
-    outText += `\n…（文件共 ${total} 行，本次显示第 ${from + 1}-${to} 行，可用 offset/limit 继续读取）`;
-  }
-  return outText;
-}
-
-export async function writeFile(cwd, args) {
-  const abs = resolvePath(cwd, args.path, true);
-  const content = args.content == null ? '' : String(args.content);
-  // IDE 内联审阅：把拟写内容交扩展做 diff + 应用；仅传输失败时回退直接写
-  if (ide.isActive()) {
-    const d = await ide.proposeWrite(abs, content, cwd);
-    if (d.decided) {
-      return d.applied
-        ? `已写入 ${rel(cwd, abs)}（经 IDE 审阅应用）`
-        : `用户在 IDE 中拒绝了对 ${rel(cwd, abs)} 的修改${d.reason ? '：' + d.reason : ''}`;
-    }
-  }
-  fs.mkdirSync(path.dirname(abs), { recursive: true });
-  fs.writeFileSync(abs, content, 'utf8');
-  return `已写入 ${rel(cwd, abs)}（${Buffer.byteLength(content)} 字节）`
-    + (ide.isActive() ? '（IDE 未响应，已直接写入）' : '');
-}
-
-export async function editFile(cwd, args) {
-  const abs = resolvePath(cwd, args.path, true);
-  const oldStr = args.old_string == null ? '' : String(args.old_string);
-  const newStr = args.new_string == null ? '' : String(args.new_string);
-  if (oldStr === '') throw new Error('edit_file 需要非空 old_string');
-  const content = fs.readFileSync(abs, 'utf8');
-  const count = content.split(oldStr).length - 1;
-  if (count === 0) {
-    throw new Error('未找到要替换的内容（old_string 未出现在文件中）。注意：old_string 必须是文件原文，不能包含 read_file 显示的「行号→」前缀');
-  }
-  if (count > 1 && !args.replace_all) {
-    throw new Error(`old_string 在文件中出现 ${count} 处，不唯一；请补充上下文使其唯一，或设 replace_all=true`);
-  }
-  const updated = args.replace_all ? content.split(oldStr).join(newStr) : content.replace(oldStr, newStr);
-  const times = args.replace_all ? count : 1;
-  if (ide.isActive()) {
-    const d = await ide.proposeWrite(abs, updated, cwd);
-    if (d.decided) {
-      return d.applied
-        ? `已编辑 ${rel(cwd, abs)}（经 IDE 审阅应用，替换 ${times} 处）`
-        : `用户在 IDE 中拒绝了对 ${rel(cwd, abs)} 的修改${d.reason ? '：' + d.reason : ''}`;
-    }
-  }
-  fs.writeFileSync(abs, updated, 'utf8');
-  return `已编辑 ${rel(cwd, abs)}，替换 ${times} 处` + (ide.isActive() ? '（IDE 未响应，已直接写入）' : '');
-}
-
-export function listFiles(cwd, args) {
-  const base = resolvePath(cwd, args.path || '.', false);
-  const out = [];
-  let count = 0;
-  const walk = (dir, depth) => {
-    if (count >= MAX_LIST_ENTRIES) return;
-    let entries;
-    try {
-      entries = fs.readdirSync(dir, { withFileTypes: true });
-    } catch {
-      return;
-    }
-    entries.sort((a, b) => a.name.localeCompare(b.name));
-    for (const e of entries) {
-      if (count >= MAX_LIST_ENTRIES) break;
-      if (DEFAULT_IGNORES.has(e.name)) continue;
-      const full = path.join(dir, e.name);
-      const r = path.relative(base, full);
-      if (e.isDirectory()) {
-        out.push(r + '/');
-        count++;
-        if (depth < 6) walk(full, depth + 1);
-      } else {
-        out.push(r);
-        count++;
-      }
-    }
-  };
-  walk(base, 0);
-  if (out.length === 0) return '（空目录）';
-  return out.join('\n') + (count >= MAX_LIST_ENTRIES ? '\n…（条目已截断）' : '');
-}
-
-export function glob(cwd, args) {
-  if (!args.pattern) throw new Error('缺少 pattern');
-  const re = globToRegex(args.pattern);
-  const results = [];
-  for (const abs of walkFiles(cwd)) {
-    const r = path.relative(cwd, abs).split(path.sep).join('/');
-    if (re.test(r)) {
-      results.push(r);
-      if (results.length >= MAX_GLOB_RESULTS) break;
-    }
-  }
-  if (results.length === 0) return '（无匹配文件）';
-  return results.join('\n');
-}
-
-export function grep(cwd, args) {
-  if (!args.pattern) throw new Error('缺少 pattern');
-  let re;
-  try {
-    re = new RegExp(args.pattern, args.ignore_case ? 'i' : undefined);
-  } catch (e) {
-    throw new Error(`无效的正则：${e.message}`);
-  }
-  const globRe = args.glob ? globToRegex(args.glob) : null;
-  const base = resolvePath(cwd, args.path || '.', false);
-  const maxMatches = Number.isFinite(args.max_results) && args.max_results > 0
-    ? Math.min(args.max_results, 500)
-    : MAX_GREP_MATCHES;
-  const matches = [];
-  const filesHit = [];
-  for (const abs of walkFiles(base)) {
-    if (matches.length >= maxMatches) break;
-    const r = path.relative(cwd, abs).split(path.sep).join('/');
-    if (globRe && !globRe.test(r)) continue;
-    let buf;
-    try {
-      buf = fs.readFileSync(abs);
-    } catch {
-      continue;
-    }
-    if (buf.length > MAX_READ_BYTES || isProbablyBinary(buf)) continue;
-    const lines = buf.toString('utf8').split('\n');
-    let hit = false;
-    for (let i = 0; i < lines.length; i++) {
-      if (re.test(lines[i])) {
-        hit = true;
-        if (args.files_only) break;
-        matches.push(`${r}:${i + 1}: ${lines[i].slice(0, 240)}`);
-        if (matches.length >= maxMatches) break;
-      }
-    }
-    if (hit) {
-      filesHit.push(r);
-      if (args.files_only && filesHit.length >= maxMatches) break;
-    }
-  }
-  if (args.files_only) {
-    return filesHit.length ? filesHit.join('\n') : '（无匹配）';
-  }
-  if (matches.length === 0) return '（无匹配）';
-  return matches.join('\n') + (matches.length >= maxMatches ? '\n…（结果已截断）' : '');
-}
-
-export function runBash(cwd, args) {
-  const command = args.command == null ? '' : String(args.command);
-  if (command.trim() === '') return Promise.resolve('（未提供命令）');
-  const timeout = Number.isFinite(args.timeout) ? Math.min(args.timeout, 600_000) : BASH_DEFAULT_TIMEOUT;
-  const isWin = process.platform === 'win32';
-  return new Promise((resolve) => {
-    let out = '';
-    let killed = false;
-    // POSIX 下 detached 让子命令自成进程组，超时可整组击杀（防止 shell 被杀而孙进程残留）
-    const child = isWin
-      ? spawn(process.env.COMSPEC || 'cmd.exe', ['/d', '/s', '/c', command], { cwd, windowsVerbatimArguments: true })
-      : spawn(process.env.SHELL || '/bin/sh', ['-c', command], { cwd, detached: true });
-    const killTree = () => {
-      try {
-        if (!isWin && child.pid) process.kill(-child.pid, 'SIGKILL');
-        else child.kill('SIGKILL');
-      } catch {
-        try {
-          child.kill('SIGKILL');
-        } catch {
-          /* ignore */
-        }
-      }
-    };
-    const timer = setTimeout(() => {
-      killed = true;
-      killTree();
-    }, timeout);
-    const append = (d) => {
-      if (out.length < BASH_MAX_OUTPUT) out += d.toString();
-    };
-    child.stdout.on('data', append);
-    child.stderr.on('data', append);
-    child.on('error', (e) => {
-      clearTimeout(timer);
-      resolve(`命令启动失败：${e.message}`);
-    });
-    child.on('close', (code) => {
-      clearTimeout(timer);
-      let text = out.length > BASH_MAX_OUTPUT ? out.slice(0, BASH_MAX_OUTPUT) + '\n…（输出已截断）' : out;
-      if (text.trim() === '') text = '（无输出）';
-      const status = killed ? `【超时被终止】` : `退出码 ${code}`;
-      resolve(`${status}\n${text}`);
-    });
-  });
-}
-
-/** 抓取网页/接口并转为可读文本（HTML 去标签；JSON/纯文本原样）。仅 http/https GET。 */
-export async function fetchUrl(cwd, args) {
-  const url = String(args.url || '').trim();
-  if (!/^https?:\/\//i.test(url)) throw new Error('仅支持 http/https URL');
-  let res;
-  try {
-    res = await fetch(url, {
-      redirect: 'follow',
-      signal: AbortSignal.timeout(Number.isFinite(args.timeout) ? Math.min(args.timeout, 120_000) : FETCH_TIMEOUT),
-      headers: {
-        'User-Agent': 'huicai-cli',
-        Accept: 'text/html,application/json;q=0.9,text/plain;q=0.8,*/*;q=0.5',
-      },
-    });
-  } catch (e) {
-    throw new Error(`请求失败：${e?.cause?.message || e.message}`);
-  }
-  const buf = await readBodyCapped(res, FETCH_MAX_BYTES);
-  const ctype = (res.headers.get('content-type') || '').toLowerCase();
-  if (isProbablyBinary(buf) && !/text|json|xml|html/.test(ctype)) {
-    return `HTTP ${res.status} · ${ctype || '未知类型'} · ${buf.length} 字节（二进制内容未展示）`;
-  }
-  let text = buf.toString('utf8');
-  if (ctype.includes('html') || /^\s*<(!doctype|html)/i.test(text)) text = htmlToText(text);
-  text = text.trim();
-  if (text.length > FETCH_MAX_CHARS) text = text.slice(0, FETCH_MAX_CHARS) + '\n…（内容过长已截断）';
-  const head = `HTTP ${res.status}${res.url && res.url !== url ? ` · 重定向至 ${res.url}` : ''}`;
-  if (!res.ok) return `${head}\n${text || '（无内容）'}`;
-  return `${head}\n${text || '（无内容）'}`;
-}
-
-async function readBodyCapped(res, maxBytes) {
-  if (!res.body) return Buffer.alloc(0);
-  const reader = res.body.getReader();
-  const chunks = [];
-  let size = 0;
-  while (true) {
-    const { done, value } = await reader.read();
-    if (done) break;
-    chunks.push(value);
-    size += value.length;
-    if (size >= maxBytes) {
-      reader.cancel().catch(() => {});
-      break;
-    }
-  }
-  return Buffer.concat(chunks.map((u) => Buffer.from(u)), Math.min(size, maxBytes));
-}
-
-/** 极简 HTML→文本：去 script/style，块级标签换行，去其余标签，解码常见实体，压缩空行。 */
-function htmlToText(html) {
-  let s = String(html);
-  s = s.replace(/<(script|style|noscript|svg|head)[\s\S]*?<\/\1>/gi, '');
-  s = s.replace(/<!--[\s\S]*?-->/g, '');
-  s = s.replace(/<br\s*\/?>/gi, '\n');
-  s = s.replace(/<\/(p|div|li|tr|h[1-6]|section|article|blockquote|pre|ul|ol|table)>/gi, '\n');
-  s = s.replace(/<li[^>]*>/gi, '- ');
-  s = s.replace(/<[^>]+>/g, '');
-  s = s
-    .replace(/&nbsp;/g, ' ')
-    .replace(/&lt;/g, '<')
-    .replace(/&gt;/g, '>')
-    .replace(/&quot;/g, '"')
-    .replace(/&#39;|&apos;/g, "'")
-    .replace(/&amp;/g, '&');
-  s = s.replace(/[ \t]+\n/g, '\n').replace(/\n{3,}/g, '\n\n');
-  return s;
-}
+import t from"node:fs";import e from"node:path";import{spawn as n}from"node:child_process";import*as r from"./ide.js";const i=3e4,o=new Set([".git","node_modules","dist","build","target","out",".next",".nuxt",".venv","venv","__pycache__",".idea",".gradle",".mvn","coverage",".cache"]);function s(t,n,r){if(!t||"string"!=typeof t)throw new Error("工作目录未设置：请在项目目录中运行（VS Code 中需先「打开文件夹」再对话）");if(!n||"string"!=typeof n)throw new Error("缺少路径 path（工具参数里必须提供 path 字段）");const i=e.resolve(t,n);if(r){const r=e.relative(t,i);if(""===r||r.startsWith("..")||e.isAbsolute(r))throw new Error(`路径超出项目目录（写操作仅限当前项目内）：${n}`)}return i}function l(t,n){const r=e.relative(t,n);return""===r?".":r}function c(t){const e=Math.min(t.length,4096);for(let n=0;n<e;n++)if(0===t[n])return!0;return!1}function*a(n,r=0,i=14){let s;try{s=t.readdirSync(n,{withFileTypes:!0})}catch{return}for(const t of s){if(o.has(t.name))continue;const s=e.join(n,t.name);t.isDirectory()?r<i&&(yield*a(s,r+1,i)):t.isFile()&&(yield s)}}function u(t){let e="";for(let n=0;n<t.length;n++){const r=t[n];"*"===r?"*"===t[n+1]?(e+=".*",n++,"/"===t[n+1]&&n++):e+="[^/]*":"?"===r?e+="[^/]":"\\^$+.()|{}[]".includes(r)?e+="\\"+r:e+=r}return new RegExp("^"+e+"$")}export function readFile(e,n){const r=s(e,n.path,!1),i=t.statSync(r);if(i.isDirectory())throw new Error(`是目录而非文件：${n.path}`);if(i.size>16777216)throw new Error(`文件过大（${Math.round(i.size/1024/1024)}MB）：请用 grep 检索，或用 run_bash 的 head/tail/sed 分段查看`);const o=t.readFileSync(r);if(c(o))return`（二进制文件，${i.size} 字节，未展示内容）`;const l=o.toString("utf8");if(""===l)return"（空文件）";const a=l.split("\n");a.length>1&&""===a[a.length-1]&&a.pop();const u=a.length,p=Math.max(0,(Number.isFinite(n.offset)?n.offset:1)-1),f=Number.isFinite(n.limit)&&n.limit>0?n.limit:2e3,h=Math.min(u,p+f);if(p>=u)return`（起始行 ${p+1} 超出文件总行数 ${u}）`;const g=String(h).length,d=[];for(let t=p;t<h;t++){let e=a[t];e.length>2e3&&(e=e.slice(0,2e3)+"…（行过长已截断）"),d.push(`${String(t+1).padStart(g)}→${e}`)}let m=d.join("\n");return(p>0||h<u)&&(m+=`\n…（文件共 ${u} 行，本次显示第 ${p+1}-${h} 行，可用 offset/limit 继续读取）`),m}export async function writeFile(n,i){const o=s(n,i.path,!0),c=null==i.content?"":String(i.content);if(r.isActive()){const t=await r.proposeWrite(o,c,n);if(t.decided)return t.applied?`已写入 ${l(n,o)}（经 IDE 审阅应用）`:`用户在 IDE 中拒绝了对 ${l(n,o)} 的修改${t.reason?"："+t.reason:""}`}return t.mkdirSync(e.dirname(o),{recursive:!0}),t.writeFileSync(o,c,"utf8"),`已写入 ${l(n,o)}（${Buffer.byteLength(c)} 字节）`+(r.isActive()?"（IDE 未响应，已直接写入）":"")}export async function editFile(e,n){const i=s(e,n.path,!0),o=null==n.old_string?"":String(n.old_string),c=null==n.new_string?"":String(n.new_string);if(""===o)throw new Error("edit_file 需要非空 old_string");const a=t.readFileSync(i,"utf8"),u=a.split(o).length-1;if(0===u)throw new Error("未找到要替换的内容（old_string 未出现在文件中）。注意：old_string 必须是文件原文，不能包含 read_file 显示的「行号→」前缀");if(u>1&&!n.replace_all)throw new Error(`old_string 在文件中出现 ${u} 处，不唯一；请补充上下文使其唯一，或设 replace_all=true`);const p=n.replace_all?a.split(o).join(c):a.replace(o,c),f=n.replace_all?u:1;if(r.isActive()){const t=await r.proposeWrite(i,p,e);if(t.decided)return t.applied?`已编辑 ${l(e,i)}（经 IDE 审阅应用，替换 ${f} 处）`:`用户在 IDE 中拒绝了对 ${l(e,i)} 的修改${t.reason?"："+t.reason:""}`}return t.writeFileSync(i,p,"utf8"),`已编辑 ${l(e,i)}，替换 ${f} 处`+(r.isActive()?"（IDE 未响应，已直接写入）":"")}export function listFiles(n,r){const i=s(n,r.path||".",!1),l=[];let c=0;const a=(n,r)=>{if(c>=400)return;let s;try{s=t.readdirSync(n,{withFileTypes:!0})}catch{return}s.sort((t,e)=>t.name.localeCompare(e.name));for(const t of s){if(c>=400)break;if(o.has(t.name))continue;const s=e.join(n,t.name),u=e.relative(i,s);t.isDirectory()?(l.push(u+"/"),c++,r<6&&a(s,r+1)):(l.push(u),c++)}};return a(i,0),0===l.length?"（空目录）":l.join("\n")+(c>=400?"\n…（条目已截断）":"")}export function glob(t,n){if(!n.pattern)throw new Error("缺少 pattern");const r=u(n.pattern),i=[];for(const n of a(t)){const o=e.relative(t,n).split(e.sep).join("/");if(r.test(o)&&(i.push(o),i.length>=300))break}return 0===i.length?"（无匹配文件）":i.join("\n")}export function grep(n,r){if(!r.pattern)throw new Error("缺少 pattern");let i;try{i=new RegExp(r.pattern,r.ignore_case?"i":void 0)}catch(t){throw new Error(`无效的正则：${t.message}`)}const o=r.glob?u(r.glob):null,l=s(n,r.path||".",!1),p=Number.isFinite(r.max_results)&&r.max_results>0?Math.min(r.max_results,500):200,f=[],h=[];for(const s of a(l)){if(f.length>=p)break;const l=e.relative(n,s).split(e.sep).join("/");if(o&&!o.test(l))continue;let a;try{a=t.readFileSync(s)}catch{continue}if(a.length>262144||c(a))continue;const u=a.toString("utf8").split("\n");let g=!1;for(let t=0;t<u.length;t++)if(i.test(u[t])){if(g=!0,r.files_only)break;if(f.push(`${l}:${t+1}: ${u[t].slice(0,240)}`),f.length>=p)break}if(g&&(h.push(l),r.files_only&&h.length>=p))break}return r.files_only?h.length?h.join("\n"):"（无匹配）":0===f.length?"（无匹配）":f.join("\n")+(f.length>=p?"\n…（结果已截断）":"")}export function runBash(t,e){const r=null==e.command?"":String(e.command);if(""===r.trim())return Promise.resolve("（未提供命令）");const o=Number.isFinite(e.timeout)?Math.min(e.timeout,6e5):12e4,s="win32"===process.platform;return new Promise(e=>{let l="",c=!1;const a=s?n(process.env.COMSPEC||"cmd.exe",["/d","/s","/c",r],{cwd:t,windowsVerbatimArguments:!0}):n(process.env.SHELL||"/bin/sh",["-c",r],{cwd:t,detached:!0}),u=setTimeout(()=>{c=!0,(()=>{try{!s&&a.pid?process.kill(-a.pid,"SIGKILL"):a.kill("SIGKILL")}catch{try{a.kill("SIGKILL")}catch{}}})()},o),p=t=>{l.length<i&&(l+=t.toString())};a.stdout.on("data",p),a.stderr.on("data",p),a.on("error",t=>{clearTimeout(u),e(`命令启动失败：${t.message}`)}),a.on("close",t=>{clearTimeout(u);let n=l.length>i?l.slice(0,i)+"\n…（输出已截断）":l;""===n.trim()&&(n="（无输出）");e(`${c?"【超时被终止】":`退出码 ${t}`}\n${n}`)})})}export async function fetchUrl(t,e){const n=String(e.url||"").trim();if(!/^https?:\/\//i.test(n))throw new Error("仅支持 http/https URL");let r;try{r=await fetch(n,{redirect:"follow",signal:AbortSignal.timeout(Number.isFinite(e.timeout)?Math.min(e.timeout,12e4):3e4),headers:{"User-Agent":"huicai-cli",Accept:"text/html,application/json;q=0.9,text/plain;q=0.8,*/*;q=0.5"}})}catch(t){throw new Error(`请求失败：${t?.cause?.message||t.message}`)}const i=await async function(t,e){if(!t.body)return Buffer.alloc(0);const n=t.body.getReader(),r=[];let i=0;for(;;){const{done:t,value:o}=await n.read();if(t)break;if(r.push(o),i+=o.length,i>=e){n.cancel().catch(()=>{});break}}return Buffer.concat(r.map(t=>Buffer.from(t)),Math.min(i,e))}(r,2097152),o=(r.headers.get("content-type")||"").toLowerCase();if(c(i)&&!/text|json|xml|html/.test(o))return`HTTP ${r.status} · ${o||"未知类型"} · ${i.length} 字节（二进制内容未展示）`;let s=i.toString("utf8");(o.includes("html")||/^\s*<(!doctype|html)/i.test(s))&&(s=function(t){let e=String(t);return e=e.replace(/<(script|style|noscript|svg|head)[\s\S]*?<\/\1>/gi,""),e=e.replace(/<!--[\s\S]*?-->/g,""),e=e.replace(/<br\s*\/?>/gi,"\n"),e=e.replace(/<\/(p|div|li|tr|h[1-6]|section|article|blockquote|pre|ul|ol|table)>/gi,"\n"),e=e.replace(/<li[^>]*>/gi,"- "),e=e.replace(/<[^>]+>/g,""),e=e.replace(/&nbsp;/g," ").replace(/&lt;/g,"<").replace(/&gt;/g,">").replace(/&quot;/g,'"').replace(/&#39;|&apos;/g,"'").replace(/&amp;/g,"&"),e=e.replace(/[ \t]+\n/g,"\n").replace(/\n{3,}/g,"\n\n"),e}(s)),s=s.trim(),s.length>8e4&&(s=s.slice(0,8e4)+"\n…（内容过长已截断）");const l=`HTTP ${r.status}${r.url&&r.url!==n?` · 重定向至 ${r.url}`:""}`;return r.ok,`${l}\n${s||"（无内容）"}`}

package/src/forks.js

@@ -0,0 +1 @@
+import{spawn as o}from"node:child_process";import r from"node:fs";import e from"node:path";import n from"node:os";const t=[];export function huicaiBin(){const o=process.argv[1]||"";return/huicai/.test(o)?o:null}export function forkAgent({prompt:i,cwd:s,sessionId:c}){const p=huicaiBin();if(!p)throw new Error("无法定位 huicai 可执行文件（请在 CLI 中使用 /fork）");const u=e.join(n.homedir(),".huicai","forks");r.mkdirSync(u,{recursive:!0});const a=e.join(u,Date.now().toString(36)+".log"),d=r.openSync(a,"a"),f=[p];c&&f.push("resume",c),f.push("-p",i,"--yolo","--plain");const l=o(process.execPath,f,{cwd:s,detached:!0,stdio:["ignore",d,d],env:process.env});l.unref();const h={pid:l.pid,prompt:i.replace(/\s+/g," ").slice(0,80),cwd:s,log:a,started:Date.now()};return t.push(h),h}function i(o){try{return process.kill(o,0),!0}catch{return!1}}export function listForks(){return t.map(o=>({...o,alive:i(o.pid)}))}export function killFork(o){if(!t.find(r=>r.pid===o))return{ok:!1,reason:"不是本会话派生的任务"};try{return process.kill(o,"SIGTERM"),{ok:!0}}catch(o){return{ok:!1,reason:o.message}}}

package/src/gitflow.js

@@ -0,0 +1 @@
+import t from"node:fs";import e from"node:os";import r from"node:path";import{execSync as o}from"node:child_process";import{streamChat as n}from"./api.js";import{DEFAULT_MODEL as i}from"./config.js";const c=/^(agent|workflow|datahuman)-/,a=new Set(["main","master","develop","dev"]);function s(t,e){return o("git "+e,{cwd:t,encoding:"utf8",stdio:["ignore","pipe","pipe"]})}function m(t,e){try{return s(t,e)}catch{return""}}export function gitInfo(t){const e={isRepo:!1,branch:"",dirty:!1,hasRemote:!1,hasGh:!1};try{e.isRepo="true"===s(t,"rev-parse --is-inside-work-tree").trim()}catch{return e}e.branch=m(t,"rev-parse --abbrev-ref HEAD").trim(),e.dirty=m(t,"status --porcelain").trim().length>0,e.hasRemote=m(t,"remote").trim().length>0;try{o("gh --version",{stdio:"ignore"}),e.hasGh=!0}catch{}return e}export async function generateCommitMessage(t,e){let r=m(t,"diff --staged");if(r.trim()||(r=m(t,"diff")),r=r.slice(0,12e3),!r.trim())return"chore: update";const o=c.test(String(e.model||""))?e.compactModel||i:e.model;try{const t=await n({baseUrl:e.baseUrl,apiKey:e.apiKey,model:o,messages:[{role:"system",content:"你是提交信息生成器。根据 git diff 生成一条规范的 Conventional Commits 提交信息：第一行 `<type>(<scope>): <简述>`（简述≤50字，type 用 feat/fix/refactor/docs/test/chore/perf/style 之一）；改动较大可空行后加 2-4 条正文要点。只输出提交信息本身，不要解释、不要代码块围栏。"},{role:"user",content:r}]});return(t.content||"").trim().replace(/^```[a-z]*\n?|\n?```$/g,"").trim()||"chore: update"}catch{return"chore: update"}}export async function runPrFlow({cwd:n,config:i,emit:c=()=>{},push:p=!0,openPr:h=!0}){const d=gitInfo(n);if(!d.isRepo)return{ok:!1,error:"当前目录不是 git 仓库"};const u=a.has(d.branch);d.dirty&&(s(n,"add -A"),c("已暂存全部改动"));const f=m(n,"diff --staged --stat").trim();let g="";f&&(c("正在生成提交信息…"),g=await generateCommitMessage(n,i),c("提交信息："+g.split("\n")[0]));let l=d.branch;u&&(l="huicai/"+function(t){return String(t).split("\n")[0].replace(/^[a-z]+(\([^)]*\))?!?:\s*/i,"").replace(/[^a-zA-Z0-9一-鿿]+/g,"-").replace(/^-+|-+$/g,"").toLowerCase().slice(0,32)||"change"}(g||"change")+"-"+Date.now().toString(36).slice(-4),s(n,`checkout -b ${l}`),c("已从 "+d.branch+" 创建分支 "+l));let y=!1;if(f){const o=r.join(e.tmpdir(),"huicai-commit-"+Date.now()+".txt");t.writeFileSync(o,g);try{s(n,`commit -F "${o}"`),y=!0,c("已提交")}finally{try{t.unlinkSync(o)}catch{}}}else c("无新暂存改动，跳过提交");if(!p)return{ok:!0,branch:l,committed:y};if(!d.hasRemote)return{ok:!0,branch:l,committed:y,note:"无 remote，未推送"};try{s(n,`push -u origin ${l}`),c("已推送 origin/"+l)}catch(t){return{ok:!1,error:"push 失败："+String(t.message).split("\n")[0],branch:l}}if(!h)return{ok:!0,branch:l,committed:y,pushed:!0};if(!d.hasGh)return{ok:!0,branch:l,committed:y,pushed:!0,note:"未装 gh CLI，PR 请手动开"};try{const t=o("gh pr create --fill",{cwd:n,encoding:"utf8",stdio:["ignore","pipe","pipe"]}).trim();return c("已开 PR："+t),{ok:!0,branch:l,committed:y,pr:t}}catch(t){return{ok:!0,branch:l,committed:y,pushed:!0,note:"gh pr create 失败（可手动开）："+String(t.message).split("\n")[0]}}}

package/src/hooks.js

@@ -0,0 +1 @@
+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()})}