@huicai/cli 2026.711.0 → 2026.711.24616

package/src/api.js

@@ -1,359 +1 @@
-// HuiCai_AI 平台 OpenAI 兼容 /v1 客户端（零依赖，用 Node 内置 fetch + Web Streams）。
-//
-// 对「原始模型 id」，平台 /v1/chat/completions 为透明代理：透传 tools、原样回传 tool_calls 与流式增量。
-// 因此本客户端把平台当作「会做函数调用决策」的模型后端，工具在本机执行的智能体模式。
-//
-// 可靠性：首字节前的 429/5xx/网络错自动指数退避重试（尊重 Retry-After）；流中途长时间无数据由
-// 停滞看门狗中止，避免挂死。一旦开始收到增量则不再重试（防止重复输出/重复计费）。
-
-const RETRYABLE_STATUS = new Set([429, 500, 502, 503, 504]);
-const MAX_RETRIES = 2; // 共尝试 1+2 次
-const STALL_TIMEOUT_MS = 90_000; // 流中无任何字节超过该时长视为停滞
-const REQUEST_TIMEOUT_MS = 15_000; // 非流式小请求超时
-
-/** 从 Authorization 组装请求头。 */
-function authHeaders(apiKey) {
-  return {
-    'Content-Type': 'application/json',
-    Authorization: `Bearer ${apiKey}`,
-  };
-}
-
-/** 读取错误响应体并抽出可读信息与 OpenAI error.type（供识别用量窗口超限等终态）。 */
-async function readError(res) {
-  let text = '';
-  try {
-    text = await res.text();
-  } catch {
-    /* ignore */
-  }
-  try {
-    const j = JSON.parse(text);
-    const type = j?.error?.type || j?.type || '';
-    if (j?.error?.message) return { message: j.error.message, type };
-    if (j?.message) return { message: j.message, type };
-    if (j?.msg) return { message: j.msg, type };
-  } catch {
-    /* not json */
-  }
-  return { message: text || `HTTP ${res.status}`, type: '' };
-}
-
-/** 把一批 tool_calls 增量按 index 累加到 acc。 */
-function mergeToolCalls(acc, deltas) {
-  for (const tc of deltas) {
-    const i = typeof tc.index === 'number' ? tc.index : acc.length;
-    if (!acc[i]) acc[i] = { id: '', type: 'function', function: { name: '', arguments: '' } };
-    if (tc.id) acc[i].id = tc.id;
-    if (tc.type) acc[i].type = tc.type;
-    if (tc.function?.name) acc[i].function.name += tc.function.name;
-    if (tc.function?.arguments) acc[i].function.arguments += tc.function.arguments;
-  }
-}
-
-function sleep(ms, signal) {
-  return new Promise((resolve, reject) => {
-    if (signal?.aborted) return reject(abortError());
-    const t = setTimeout(() => {
-      signal?.removeEventListener?.('abort', onAbort);
-      resolve();
-    }, ms);
-    const onAbort = () => {
-      clearTimeout(t);
-      reject(abortError());
-    };
-    signal?.addEventListener?.('abort', onAbort, { once: true });
-  });
-}
-
-function abortError() {
-  const e = new Error('已中断');
-  e.name = 'AbortError';
-  return e;
-}
-
-/** 由重试次数与 Retry-After 头计算退避时长（毫秒）。 */
-function backoffMs(attempt, res) {
-  const ra = res?.headers?.get?.('retry-after');
-  const raSec = ra != null ? Number(ra) : NaN;
-  if (Number.isFinite(raSec) && raSec >= 0) return Math.min(raSec * 1000, 30_000);
-  return Math.min(500 * 2 ** attempt + Math.floor(Math.random() * 250), 8_000);
-}
-
-/**
- * 流式对话补全。逐块解析 SSE：content/reasoning 经 handlers 实时下发，tool_calls 累积后返回。
- *
- * @param {{baseUrl:string, apiKey:string, model:string, messages:any[], tools?:any[], temperature?:number, stallTimeoutMs?:number}} opts
- * @param {{onContent?:(t:string)=>void, onReasoning?:(t:string)=>void, onRetry?:(attempt:number, waitMs:number, reason:string)=>void}} [handlers]
- * @param {AbortSignal} [signal]
- * @returns {Promise<{content:string, toolCalls:any[], finishReason:string|null, usage:any}>}
- */
-export async function streamChat(opts, handlers = {}, signal) {
-  const url = `${opts.baseUrl}/v1/chat/completions`;
-  const payload = {
-    model: opts.model,
-    messages: opts.messages,
-    stream: true,
-    stream_options: { include_usage: true },
-  };
-  if (opts.tools && opts.tools.length) {
-    payload.tools = opts.tools;
-    payload.tool_choice = 'auto';
-  }
-  if (typeof opts.temperature === 'number') payload.temperature = opts.temperature;
-  // 推理强度：OpenAI 兼容字段 reasoning_effort（透传；模型不支持则平台/模型侧忽略）
-  if (opts.reasoningEffort && opts.reasoningEffort !== 'off') payload.reasoning_effort = opts.reasoningEffort;
-  // 对话落库审计标识：来源(cli/vscode) + 会话号（平台按此归并同会话多轮，供后台审计）
-  const chatHeaders = authHeaders(opts.apiKey);
-  if (opts.client) chatHeaders['X-Huicai-Client'] = opts.client;
-  if (opts.sessionId) chatHeaders['X-Huicai-Session'] = opts.sessionId;
-  const body = JSON.stringify(payload);
-
-  // 重试仅发生在「拿到可读响应体之前」：状态可重试或网络错。开始读流后不再重试。
-  for (let attempt = 0; ; attempt++) {
-    let res;
-    try {
-      res = await fetch(url, { method: 'POST', headers: chatHeaders, body, signal });
-    } catch (e) {
-      if (e?.name === 'AbortError' || signal?.aborted) throw abortError();
-      if (attempt < MAX_RETRIES) {
-        const wait = backoffMs(attempt, null);
-        handlers.onRetry?.(attempt + 1, wait, '网络错误：' + (e?.message || e));
-        await sleep(wait, signal);
-        continue;
-      }
-      throw new Error('网络错误：' + (e?.message || e));
-    }
-    if (!res.ok || !res.body) {
-      const err = await readError(res);
-      // 用量窗口超限（5小时/7天滚动窗）为终态：不重试，直接抛出清晰提示（含重置时间），避免无谓退避重试
-      const usageLimited = err.type === 'usage_limit_exceeded';
-      if (!usageLimited && RETRYABLE_STATUS.has(res.status) && attempt < MAX_RETRIES) {
-        const wait = backoffMs(attempt, res);
-        handlers.onRetry?.(attempt + 1, wait, `HTTP ${res.status}：${err.message}`);
-        await sleep(wait, signal);
-        continue;
-      }
-      throw new Error(err.message);
-    }
-    return readStream(res, handlers, signal, opts.stallTimeoutMs ?? STALL_TIMEOUT_MS);
-  }
-}
-
-/** 读取 SSE 响应体：外部 signal 可中断；停滞看门狗防挂死。 */
-async function readStream(res, handlers, signal, stallMs) {
-  const reader = res.body.getReader();
-  const decoder = new TextDecoder();
-  let buffer = '';
-  let content = '';
-  const toolCalls = [];
-  let finishReason = null;
-  let usage = null;
-
-  let stalled = false;
-  let stallTimer = null;
-  const armStall = () => {
-    if (stallTimer) clearTimeout(stallTimer);
-    stallTimer = setTimeout(() => {
-      stalled = true;
-      reader.cancel().catch(() => {});
-    }, stallMs);
-  };
-  const onAbort = () => reader.cancel().catch(() => {});
-  signal?.addEventListener?.('abort', onAbort, { once: true });
-
-  try {
-    armStall();
-    while (true) {
-      let chunk;
-      try {
-        chunk = await reader.read();
-      } catch (e) {
-        if (signal?.aborted) throw abortError();
-        if (stalled) throw new Error(`响应停滞超过 ${Math.round(stallMs / 1000)}s，已中止（可重试）`);
-        throw e;
-      }
-      if (signal?.aborted) throw abortError();
-      if (stalled) throw new Error(`响应停滞超过 ${Math.round(stallMs / 1000)}s，已中止（可重试）`);
-      const { done, value } = chunk;
-      if (done) break;
-      armStall();
-      buffer += decoder.decode(value, { stream: true });
-      const lines = buffer.split('\n');
-      buffer = lines.pop() ?? '';
-      for (const raw of lines) {
-        const line = raw.trim();
-        if (!line.startsWith('data:')) continue;
-        const data = line.slice(5).trim();
-        if (data === '[DONE]' || data === '') continue;
-        let json;
-        try {
-          json = JSON.parse(data);
-        } catch {
-          continue; // 半个 JSON（跨块），忽略；完整帧下轮再来
-        }
-        if (json.usage) usage = json.usage;
-        const choice = json.choices?.[0];
-        if (!choice) continue;
-        const delta = choice.delta || {};
-        const rc = delta.reasoning_content ?? delta.reasoning;
-        if (rc) handlers.onReasoning?.(rc);
-        if (delta.content) {
-          content += delta.content;
-          handlers.onContent?.(delta.content);
-        }
-        if (Array.isArray(delta.tool_calls)) mergeToolCalls(toolCalls, delta.tool_calls);
-        if (choice.finish_reason) finishReason = choice.finish_reason;
-      }
-    }
-  } finally {
-    if (stallTimer) clearTimeout(stallTimer);
-    signal?.removeEventListener?.('abort', onAbort);
-  }
-  return { content, toolCalls: toolCalls.filter(Boolean), finishReason, usage };
-}
-
-/** 文本向量化（POST /v1/embeddings，OpenAI 兼容）。返回向量数组（与 input 一一对应）；失败抛出。 */
-export async function embed(baseUrl, apiKey, model, input) {
-  const res = await fetch(`${baseUrl}/v1/embeddings`, {
-    method: 'POST',
-    headers: authHeaders(apiKey),
-    body: JSON.stringify({ model, input: Array.isArray(input) ? input : [input] }),
-    signal: AbortSignal.timeout(30_000),
-  });
-  if (!res.ok) throw new Error((await readError(res)).message);
-  const j = await res.json();
-  return Array.isArray(j?.data) ? j.data.map((d) => d.embedding) : null;
-}
-
-/**
- * 知识库代码增量同步（POST /v1/knowledge/{kbId}/sync）。
- * 把一批变更文件（新增/修改/删除）提交给平台按路径 upsert，保鲜 RAG。
- * @param {string|number} kbId 知识库ID
- * @param {Array<{path:string, content?:string, deleted?:boolean}>} files 变更文件
- * @returns {Promise<{accepted:number, skipped:number, truncated:boolean, message:string}>}
- */
-export async function syncKnowledge(baseUrl, apiKey, kbId, files) {
-  const res = await fetch(`${baseUrl}/v1/knowledge/${encodeURIComponent(kbId)}/sync`, {
-    method: 'POST',
-    headers: authHeaders(apiKey),
-    body: JSON.stringify({ files }),
-    signal: AbortSignal.timeout(120_000),
-  });
-  if (!res.ok) throw new Error((await readError(res)).message);
-  return res.json();
-}
-
-/** 列出可用模型（含平台已发布智能体伪模型 agent-/workflow-/datahuman-）。 */
-export async function listModels(baseUrl, apiKey) {
-  const res = await fetch(`${baseUrl}/v1/models`, {
-    headers: authHeaders(apiKey),
-    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
-  });
-  if (!res.ok) throw new Error((await readError(res)).message);
-  const j = await res.json();
-  return Array.isArray(j?.data) ? j.data : [];
-}
-
-/**
- * 读取客户端相关的平台默认配置（GET /v1/config）。
- * @returns {Promise<{vision_bridge_model?:string}>} 失败时返回 {}（客户端自行回退）
- */
-export async function getPlatformConfig(baseUrl, apiKey) {
-  try {
-    const res = await fetch(`${baseUrl}/v1/config`, {
-      headers: authHeaders(apiKey),
-      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
-    });
-    if (!res.ok) return {};
-    const j = await res.json();
-    return j && typeof j === 'object' ? j : {};
-  } catch {
-    return {};
-  }
-}
-
-/**
- * 拉取某已发布智能体的人格（供 --agent 本机执行模式采用）。
- * @param {string} ref 分享令牌，或伪模型ID agent-{token}
- * @returns {Promise<{name:string,description:string,systemPrompt:string,model:string,temperature:number,maxTokens:number}>}
- */
-export async function getAgentPersona(baseUrl, apiKey, ref) {
-  const res = await fetch(`${baseUrl}/v1/agents/${encodeURIComponent(ref)}/persona`, {
-    headers: authHeaders(apiKey),
-    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
-  });
-  if (!res.ok) throw new Error((await readError(res)).message);
-  return res.json();
-}
-
-/**
- * 查询当前令牌用户的 Token 用量窗口（5小时/7天滚动窗，GET /v1/usage）。
- * @returns {Promise<{allowed:boolean,used5h:number,limit5h:number,used7d:number,limit7d:number,resetAtEpochMs?:number|null,message?:string}>}
- */
-export async function fetchUsage(baseUrl, apiKey) {
-  const res = await fetch(`${baseUrl}/v1/usage`, {
-    headers: authHeaders(apiKey),
-    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
-  });
-  if (!res.ok) throw new Error((await readError(res)).message);
-  return res.json();
-}
-
-/**
- * 解析文档附件为纯文本（POST /v1/files/extract：PDF/Word/Excel/PPT/RTF 及各类文本，Base64 传输）。
- * 服务端与 Web 分享页同源解析（knowledge DocumentParser），扫描件/二进制会得到明确报错。
- * 大文件解析较慢，超时放宽到 2 分钟。
- * @param {{filename:string, data:string, maxChars?:number}} payload data=文件内容 Base64
- * @returns {Promise<{name:string,ext:string,category:string,chars:number,truncated:boolean,pages?:number|null,text:string}>}
- */
-export async function extractDocument(baseUrl, apiKey, payload) {
-  const res = await fetch(`${baseUrl}/v1/files/extract`, {
-    method: 'POST',
-    headers: authHeaders(apiKey),
-    body: JSON.stringify(payload),
-    signal: AbortSignal.timeout(120_000),
-  });
-  if (!res.ok) throw new Error((await readError(res)).message);
-  return res.json();
-}
-
-/**
- * 列出平台上我的文档技能（GET /v1/skills，云端技能库；供 huicai skills pull）。
- * @returns {Promise<{id:number,name:string,description:string,version:string,updateTime:string}[]>}
- */
-export async function listPlatformSkills(baseUrl, apiKey) {
-  const res = await fetch(`${baseUrl}/v1/skills`, {
-    headers: authHeaders(apiKey),
-    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
-  });
-  if (!res.ok) throw new Error((await readError(res)).message);
-  const j = await res.json();
-  return Array.isArray(j?.data) ? j.data : [];
-}
-
-/** 平台技能详情（含 SKILL.md 全文与附件，GET /v1/skills/{id}）。 */
-export async function getPlatformSkill(baseUrl, apiKey, id) {
-  const res = await fetch(`${baseUrl}/v1/skills/${encodeURIComponent(id)}`, {
-    headers: authHeaders(apiKey),
-    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
-  });
-  if (!res.ok) throw new Error((await readError(res)).message);
-  return res.json();
-}
-
-/**
- * 推送本地技能到平台（POST /v1/skills/import；同名冲突 skip/overwrite）。
- * @param {{content:string,filename?:string,conflict?:string,files?:{path:string,content:string}[]}} payload
- * @returns {Promise<{id:number,status:'imported'|'overwritten'|'skipped',warnings?:string[]}>}
- */
-export async function pushPlatformSkill(baseUrl, apiKey, payload) {
-  const res = await fetch(`${baseUrl}/v1/skills/import`, {
-    method: 'POST',
-    headers: { ...authHeaders(apiKey), 'Content-Type': 'application/json' },
-    body: JSON.stringify(payload),
-    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
-  });
-  if (!res.ok) throw new Error((await readError(res)).message);
-  return res.json();
-}
+const t=new Set([429,500,502,503,504]),e=15e3;function n(t){return{"Content-Type":"application/json",Authorization:`Bearer ${t}`}}async function o(t){let e="";try{e=await t.text()}catch{}try{const t=JSON.parse(e),n=t?.error?.type||t?.type||"";if(t?.error?.message)return{message:t.error.message,type:n};if(t?.message)return{message:t.message,type:n};if(t?.msg)return{message:t.msg,type:n}}catch{}return{message:e||`HTTP ${t.status}`,type:""}}function r(t,e){for(const n of e){const e="number"==typeof n.index?n.index:t.length;t[e]||(t[e]={id:"",type:"function",function:{name:"",arguments:""}}),n.id&&(t[e].id=n.id),n.type&&(t[e].type=n.type),n.function?.name&&(t[e].function.name+=n.function.name),n.function?.arguments&&(t[e].function.arguments+=n.function.arguments)}}function a(t,e){return new Promise((n,o)=>{if(e?.aborted)return o(s());const r=setTimeout(()=>{e?.removeEventListener?.("abort",a),n()},t),a=()=>{clearTimeout(r),o(s())};e?.addEventListener?.("abort",a,{once:!0})})}function s(){const t=new Error("已中断");return t.name="AbortError",t}function i(t,e){const n=e?.headers?.get?.("retry-after"),o=null!=n?Number(n):NaN;return Number.isFinite(o)&&o>=0?Math.min(1e3*o,3e4):Math.min(500*2**t+Math.floor(250*Math.random()),8e3)}export async function streamChat(e,r={},l){const u=`${e.baseUrl}/v1/chat/completions`,f={model:e.model,messages:e.messages,stream:!0,stream_options:{include_usage:!0}};e.tools&&e.tools.length&&(f.tools=e.tools,f.tool_choice="auto"),"number"==typeof e.temperature&&(f.temperature=e.temperature),e.reasoningEffort&&"off"!==e.reasoningEffort&&(f.reasoning_effort=e.reasoningEffort);const m=n(e.apiKey);e.client&&(m["X-Huicai-Client"]=e.client),e.sessionId&&(m["X-Huicai-Session"]=e.sessionId);const g=JSON.stringify(f);for(let n=0;;n++){let f;try{f=await fetch(u,{method:"POST",headers:m,body:g,signal:l})}catch(t){if("AbortError"===t?.name||l?.aborted)throw s();if(n<2){const e=i(n,null);r.onRetry?.(n+1,e,"网络错误："+(t?.message||t)),await a(e,l);continue}throw new Error("网络错误："+(t?.message||t))}if(!f.ok||!f.body){const e=await o(f);if(!("usage_limit_exceeded"===e.type)&&t.has(f.status)&&n<2){const t=i(n,f);r.onRetry?.(n+1,t,`HTTP ${f.status}：${e.message}`),await a(t,l);continue}throw new Error(e.message)}return c(f,r,l,e.stallTimeoutMs??9e4)}}async function c(t,e,n,o){const a=t.body.getReader(),i=new TextDecoder;let c="",l="";const u=[];let f=null,m=null,g=!1,d=null;const h=()=>{d&&clearTimeout(d),d=setTimeout(()=>{g=!0,a.cancel().catch(()=>{})},o)},w=()=>a.cancel().catch(()=>{});n?.addEventListener?.("abort",w,{once:!0});try{for(h();;){let t;try{t=await a.read()}catch(t){if(n?.aborted)throw s();if(g)throw new Error(`响应停滞超过 ${Math.round(o/1e3)}s，已中止（可重试）`);throw t}if(n?.aborted)throw s();if(g)throw new Error(`响应停滞超过 ${Math.round(o/1e3)}s，已中止（可重试）`);const{done:d,value:w}=t;if(d)break;h(),c+=i.decode(w,{stream:!0});const y=c.split("\n");c=y.pop()??"";for(const t of y){const n=t.trim();if(!n.startsWith("data:"))continue;const o=n.slice(5).trim();if("[DONE]"===o||""===o)continue;let a;try{a=JSON.parse(o)}catch{continue}a.usage&&(m=a.usage);const s=a.choices?.[0];if(!s)continue;const i=s.delta||{},c=i.reasoning_content??i.reasoning;c&&e.onReasoning?.(c),i.content&&(l+=i.content,e.onContent?.(i.content)),Array.isArray(i.tool_calls)&&r(u,i.tool_calls),s.finish_reason&&(f=s.finish_reason)}}}finally{d&&clearTimeout(d),n?.removeEventListener?.("abort",w)}return{content:l,toolCalls:u.filter(Boolean),finishReason:f,usage:m}}export async function embed(t,e,r,a){const s=await fetch(`${t}/v1/embeddings`,{method:"POST",headers:n(e),body:JSON.stringify({model:r,input:Array.isArray(a)?a:[a]}),signal:AbortSignal.timeout(3e4)});if(!s.ok)throw new Error((await o(s)).message);const i=await s.json();return Array.isArray(i?.data)?i.data.map(t=>t.embedding):null}export async function syncKnowledge(t,e,r,a){const s=await fetch(`${t}/v1/knowledge/${encodeURIComponent(r)}/sync`,{method:"POST",headers:n(e),body:JSON.stringify({files:a}),signal:AbortSignal.timeout(12e4)});if(!s.ok)throw new Error((await o(s)).message);return s.json()}export async function listModels(t,r){const a=await fetch(`${t}/v1/models`,{headers:n(r),signal:AbortSignal.timeout(e)});if(!a.ok)throw new Error((await o(a)).message);const s=await a.json();return Array.isArray(s?.data)?s.data:[]}export async function getPlatformConfig(t,o){try{const r=await fetch(`${t}/v1/config`,{headers:n(o),signal:AbortSignal.timeout(e)});if(!r.ok)return{};const a=await r.json();return a&&"object"==typeof a?a:{}}catch{return{}}}export async function getAgentPersona(t,r,a){const s=await fetch(`${t}/v1/agents/${encodeURIComponent(a)}/persona`,{headers:n(r),signal:AbortSignal.timeout(e)});if(!s.ok)throw new Error((await o(s)).message);return s.json()}export async function fetchUsage(t,r){const a=await fetch(`${t}/v1/usage`,{headers:n(r),signal:AbortSignal.timeout(e)});if(!a.ok)throw new Error((await o(a)).message);return a.json()}export async function extractDocument(t,e,r){const a=await fetch(`${t}/v1/files/extract`,{method:"POST",headers:n(e),body:JSON.stringify(r),signal:AbortSignal.timeout(12e4)});if(!a.ok)throw new Error((await o(a)).message);return a.json()}export async function listPlatformSkills(t,r){const a=await fetch(`${t}/v1/skills`,{headers:n(r),signal:AbortSignal.timeout(e)});if(!a.ok)throw new Error((await o(a)).message);const s=await a.json();return Array.isArray(s?.data)?s.data:[]}export async function getPlatformSkill(t,r,a){const s=await fetch(`${t}/v1/skills/${encodeURIComponent(a)}`,{headers:n(r),signal:AbortSignal.timeout(e)});if(!s.ok)throw new Error((await o(s)).message);return s.json()}export async function pushPlatformSkill(t,r,a){const s=await fetch(`${t}/v1/skills/import`,{method:"POST",headers:{...n(r),"Content-Type":"application/json"},body:JSON.stringify(a),signal:AbortSignal.timeout(e)});if(!s.ok)throw new Error((await o(s)).message);return s.json()}

package/src/autofix.js

@@ -1,90 +1 @@
-// 自主「修到通过」闭环（/verify 深化）：跑验证命令 → 失败则让智能体定位修复 → 自动重跑，直到通过或达上限。
-// 这是自动化+智能化的核心：把「跑测试、看报错、改代码、再跑」这个人类循环交给智能体自主完成。
-
-import { spawn } from 'node:child_process';
-import fs from 'node:fs';
-import path from 'node:path';
-
-const CAP = 16000;
-
-function clip(s) {
-  s = String(s);
-  return s.length > CAP ? s.slice(0, CAP) + '\n…（输出过长已截断）' : s;
-}
-
-/** 跑一条命令，返回 {code, output}（合并 stdout/stderr，截断）。超时整组击杀。 */
-export function captureCommand(cwd, command, timeout = 180000) {
-  const isWin = process.platform === 'win32';
-  return new Promise((resolve) => {
-    let out = '';
-    let killed = false;
-    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 timer = setTimeout(() => {
-      killed = true;
-      try {
-        if (!isWin && child.pid) process.kill(-child.pid, 'SIGKILL');
-        else child.kill('SIGKILL');
-      } catch { /* ignore */ }
-    }, timeout);
-    const append = (d) => { if (out.length < CAP * 2) out += d.toString(); };
-    child.stdout.on('data', append);
-    child.stderr.on('data', append);
-    child.on('error', (e) => { clearTimeout(timer); resolve({ code: -1, output: '命令启动失败：' + e.message }); });
-    child.on('close', (code) => { clearTimeout(timer); resolve({ code: killed ? 124 : (code == null ? 1 : code), output: clip(out) || '（无输出）' }); });
-  });
-}
-
-/** 自动探测验证命令（测试/构建）。返回命令字符串或 null。 */
-export function detectVerifyCommand(cwd) {
-  const has = (f) => { try { return fs.existsSync(path.join(cwd, f)); } catch { return false; } };
-  try {
-    if (has('package.json')) {
-      const pkg = JSON.parse(fs.readFileSync(path.join(cwd, 'package.json'), 'utf8'));
-      if (pkg.scripts?.test && !/no test specified/i.test(pkg.scripts.test)) return 'npm test';
-      if (pkg.scripts?.build) return 'npm run build';
-    }
-  } catch { /* 坏 package.json 忽略 */ }
-  if (has('pyproject.toml') || has('pytest.ini') || has('tox.ini')) return 'pytest -q';
-  if (has('pom.xml')) return 'mvn -q test';
-  if (has('build.gradle') || has('build.gradle.kts')) return './gradlew test';
-  if (has('Cargo.toml')) return 'cargo test';
-  if (has('go.mod')) return 'go test ./...';
-  if (has('Makefile')) return 'make test';
-  return null;
-}
-
-/**
- * 修到通过循环。
- * @param {object} p
- * @param {string} p.command 验证命令
- * @param {number} [p.maxIters] 最多修复轮数（默认 5）
- * @param {string} p.cwd
- * @param {(prompt:string)=>Promise<{aborted?:boolean}|void>} p.runTurnOnce 跑一个智能体回合（前端提供）
- * @param {(text:string)=>void} p.emit 进度输出
- * @returns {Promise<{passed:boolean, iters?:number, output?:string, aborted?:boolean}>}
- */
-export async function runVerifyLoop({ command, maxIters = 5, cwd, runTurnOnce, emit }) {
-  for (let i = 0; i < maxIters; i++) {
-    emit(`▶ 验证 ${i + 1}/${maxIters}：${command}`);
-    const { code, output } = await captureCommand(cwd, command);
-    if (code === 0) {
-      emit(`✅ 验证通过（第 ${i + 1} 轮）。`);
-      return { passed: true, iters: i + 1 };
-    }
-    emit(`✗ 未通过（退出码 ${code}）` + (i < maxIters - 1 ? '，让智能体定位修复后自动重跑…' : ''));
-    if (i === maxIters - 1) {
-      emit(`⚠ 已达上限 ${maxIters} 轮仍未通过。`);
-      return { passed: false, iters: i + 1, output };
-    }
-    const r = await runTurnOnce(
-      `自动验证：运行 \`${command}\` 失败（退出码 ${code}）。输出如下：\n\n${output}\n\n`
-      + '请定位根因并**修复代码/配置**。不要自己重跑该命令——我会自动重跑验证。本轮只做必要的修复。');
-    if (r && r.aborted) {
-      emit('已中断修复循环。');
-      return { passed: false, aborted: true, iters: i + 1 };
-    }
-  }
-  return { passed: false };
-}
+import{spawn as t}from"node:child_process";import e from"node:fs";import r from"node:path";const o=16e3;export function captureCommand(e,r,n=18e4){const s="win32"===process.platform;return new Promise(i=>{let c="",a=!1;const d=s?t(process.env.COMSPEC||"cmd.exe",["/d","/s","/c",r],{cwd:e,windowsVerbatimArguments:!0}):t(process.env.SHELL||"/bin/sh",["-c",r],{cwd:e,detached:!0}),p=setTimeout(()=>{a=!0;try{!s&&d.pid?process.kill(-d.pid,"SIGKILL"):d.kill("SIGKILL")}catch{}},n),u=t=>{c.length<32e3&&(c+=t.toString())};d.stdout.on("data",u),d.stderr.on("data",u),d.on("error",t=>{clearTimeout(p),i({code:-1,output:"命令启动失败："+t.message})}),d.on("close",t=>{var e;clearTimeout(p),i({code:a?124:null==t?1:t,output:(e=c,((e=String(e)).length>o?e.slice(0,o)+"\n…（输出过长已截断）":e)||"（无输出）")})})})}export function detectVerifyCommand(t){const o=o=>{try{return e.existsSync(r.join(t,o))}catch{return!1}};try{if(o("package.json")){const o=JSON.parse(e.readFileSync(r.join(t,"package.json"),"utf8"));if(o.scripts?.test&&!/no test specified/i.test(o.scripts.test))return"npm test";if(o.scripts?.build)return"npm run build"}}catch{}return o("pyproject.toml")||o("pytest.ini")||o("tox.ini")?"pytest -q":o("pom.xml")?"mvn -q test":o("build.gradle")||o("build.gradle.kts")?"./gradlew test":o("Cargo.toml")?"cargo test":o("go.mod")?"go test ./...":o("Makefile")?"make test":null}export async function runVerifyLoop({command:t,maxIters:e=5,cwd:r,runTurnOnce:o,emit:n}){for(let s=0;s<e;s++){n(`▶ 验证 ${s+1}/${e}：${t}`);const{code:i,output:c}=await captureCommand(r,t);if(0===i)return n(`✅ 验证通过（第 ${s+1} 轮）。`),{passed:!0,iters:s+1};if(n(`✗ 未通过（退出码 ${i}）`+(s<e-1?"，让智能体定位修复后自动重跑…":"")),s===e-1)return n(`⚠ 已达上限 ${e} 轮仍未通过。`),{passed:!1,iters:s+1,output:c};const a=await o(`自动验证：运行 \`${t}\` 失败（退出码 ${i}）。输出如下：\n\n${c}\n\n请定位根因并**修复代码/配置**。不要自己重跑该命令——我会自动重跑验证。本轮只做必要的修复。`);if(a&&a.aborted)return n("已中断修复循环。"),{passed:!1,aborted:!0,iters:s+1}}return{passed:!1}}

package/src/banner.js

@@ -1,83 +1 @@
-// 启动欢迎横幅：渐变 ASCII 字标 + 上下文信息 + 快捷提示（对标 Claude CLI 进入时的欢迎屏）。
-// 零依赖；真彩(COLORTERM=truecolor)时走 24-bit 青→紫渐变，仅 16 色时退化为青色，NO_COLOR/非 TTY 输出朴素字标。
-
-import { c, colorEnabled } from './colors.js';
-
-// 5 行块字（每字形 5 列宽，字间 1 空格）。
-const FONT = {
-  H: ['█   █', '█   █', '█████', '█   █', '█   █'],
-  U: ['█   █', '█   █', '█   █', '█   █', '█████'],
-  I: ['█████', '  █  ', '  █  ', '  █  ', '█████'],
-  C: ['█████', '█    ', '█    ', '█    ', '█████'],
-  A: ['█████', '█   █', '█████', '█   █', '█   █'],
-  ' ': ['     ', '     ', '     ', '     ', '     '],
-};
-
-function wordmark(word) {
-  const rows = ['', '', '', '', ''];
-  [...word].forEach((ch, idx) => {
-    const g = FONT[ch] || FONT[' '];
-    for (let r = 0; r < 5; r++) rows[r] += (idx ? ' ' : '') + g[r];
-  });
-  return rows;
-}
-
-const truecolor = colorEnabled && /truecolor|24bit/i.test(process.env.COLORTERM || '');
-const lerp = (a, b, t) => Math.round(a + (b - a) * t);
-
-// 按列做水平渐变；无真彩退化为青色；无色原样返回。
-function gradientRow(row, from, to) {
-  if (!colorEnabled) return row;
-  const chars = [...row];
-  const n = chars.length;
-  let out = '';
-  for (let i = 0; i < n; i++) {
-    const ch = chars[i];
-    if (ch === ' ') { out += ' '; continue; }
-    if (!truecolor) { out += `\x1b[36m${ch}`; continue; }
-    const t = n <= 1 ? 0 : i / (n - 1);
-    out += `\x1b[38;2;${lerp(from[0], to[0], t)};${lerp(from[1], to[1], t)};${lerp(from[2], to[2], t)}m${ch}`;
-  }
-  return out + '\x1b[0m';
-}
-
-const PAD = '  ';
-const FROM = [0, 229, 255];  // 青
-const TO = [168, 85, 247];   // 紫
-
-/**
- * 生成欢迎横幅字符串（不含结尾换行）。
- * @param {object} p
- * @param {string} p.model 当前模型 / 平台目标
- * @param {string} p.cwd 工作目录
- * @param {string} [p.version] 版本展示串
- * @param {boolean} [p.platform] 是否平台伪模型（agent-/workflow-/datahuman-）
- * @param {boolean} [p.yolo] 是否已开自动放行
- * @param {string} [p.consult] 混合模式咨询目标展示名
- * @param {boolean} [p.ink] 是否 ink 富终端（附注一行）
- */
-export function renderWelcome({ model, cwd, version, platform, yolo, consult, ink } = {}) {
-  const cols = process.stdout.columns || 60;
-  const sep = c.gray('─'.repeat(Math.min(Math.max(cols - 2, 24), 50)));
-  const L = [''];
-
-  if (colorEnabled) {
-    for (const row of wordmark('HUICAI')) L.push(PAD + gradientRow(row, FROM, TO));
-  } else {
-    L.push(PAD + 'H U I C A I');
-  }
-
-  L.push('');
-  L.push(PAD + c.bold('HuiCai AI') + c.gray(' · 终端智能体') + (version ? c.gray('  v' + version) : '')
-    + (ink ? c.gray('  · ink') : ''));
-  L.push(PAD + sep);
-  L.push(PAD + c.gray(platform ? '目标  ' : '模型  ') + c.cyan(model || c.gray('(未设置，/model 设置)'))
-    + (platform ? c.gray('  · 平台编排（无本机工具）') : ''));
-  L.push(PAD + c.gray('目录  ') + cwd);
-  if (consult) L.push(PAD + c.gray('咨询  ') + c.magenta(consult) + c.gray('  · 混合模式（本机工具 + 平台咨询）'));
-  if (yolo) L.push(PAD + c.yellow('⚠ 自动放行(yolo) 已开：写文件/执行命令不再逐次确认'));
-  L.push('');
-  L.push(PAD + c.magenta('✦ ') + c.gray('/help 命令 · @文件 引用 · !命令 直通 shell · Ctrl+C 中断'));
-
-  return L.join('\n');
-}
+import{c as o,colorEnabled as t}from"./colors.js";const n={H:["█   █","█   █","█████","█   █","█   █"],U:["█   █","█   █","█   █","█   █","█████"],I:["█████","  █  ","  █  ","  █  ","█████"],C:["█████","█    ","█    ","█    ","█████"],A:["█████","█   █","█████","█   █","█   █"]," ":["     ","     ","     ","     ","     "]};const r=t&&/truecolor|24bit/i.test(process.env.COLORTERM||""),s=(o,t,n)=>Math.round(o+(t-o)*n);function e(o,n,e){if(!t)return o;const u=[...o],c=u.length;let a="";for(let o=0;o<c;o++){const t=u[o];if(" "===t){a+=" ";continue}if(!r){a+=`${t}`;continue}const l=c<=1?0:o/(c-1);a+=`[38;2;${s(n[0],e[0],l)};${s(n[1],e[1],l)};${s(n[2],e[2],l)}m${t}`}return a+""}const u="  ",c=[0,229,255],a=[168,85,247];export function renderWelcome({model:r,cwd:s,version:l,platform:i,yolo:h,consult:p,ink:y}={}){const f=process.stdout.columns||60,g=o.gray("─".repeat(Math.min(Math.max(f-2,24),50))),m=[""];if(t)for(const o of function(o){const t=["","","","",""];return[...o].forEach((o,r)=>{const s=n[o]||n[" "];for(let o=0;o<5;o++)t[o]+=(r?" ":"")+s[o]}),t}("HUICAI"))m.push(u+e(o,c,a));else m.push("  H U I C A I");return m.push(""),m.push(u+o.bold("HuiCai AI")+o.gray(" · 终端智能体")+(l?o.gray("  v"+l):"")+(y?o.gray("  · ink"):"")),m.push(u+g),m.push(u+o.gray(i?"目标  ":"模型  ")+o.cyan(r||o.gray("(未设置，/model 设置)"))+(i?o.gray("  · 平台编排（无本机工具）"):"")),m.push(u+o.gray("目录  ")+s),p&&m.push(u+o.gray("咨询  ")+o.magenta(p)+o.gray("  · 混合模式（本机工具 + 平台咨询）")),h&&m.push(u+o.yellow("⚠ 自动放行(yolo) 已开：写文件/执行命令不再逐次确认")),m.push(""),m.push(u+o.magenta("✦ ")+o.gray("/help 命令 · @文件 引用 · !命令 直通 shell · Ctrl+C 中断")),m.join("\n")}

package/src/checkpoints.js

@@ -1,99 +1 @@
-// 会话检查点（对标 Claude Code /rewind）：每个用户回合前快照「对话位置 + 该回合将改动文件的原始内容」，
-// 可把对话/文件/两者回滚到某个检查点之前。文件原文由 runTurn 经 fileJournal 在写入前记录（见 agent.js）。
-//
-// 检查点存活于当前运行的会话（内存），不落盘（避免把大段文件内容写进会话 JSON）。
-// 语义：检查点 N 记录「第 N 个用户回合开始前」的状态；回滚到 N 即回到该回合之前。
-
-import fs from 'node:fs';
-import path from 'node:path';
-
-const MAX_CHECKPOINTS = 100;
-
-function safeClone(o) {
-  try {
-    return o ? JSON.parse(JSON.stringify(o)) : {};
-  } catch {
-    return {};
-  }
-}
-
-function deriveLabel(text) {
-  const first = String(text || '').replace(/\s+/g, ' ').trim();
-  return first ? (first.length > 60 ? first.slice(0, 60) + '…' : first) : '(空)';
-}
-
-export function createCheckpoints() {
-  const list = []; // {id, time, label, messagesLen, compaction, journal:[{path,before,existed,tooLarge?}]}
-  let seq = 0;
-
-  /** 回合开始前调用：记录对话位置，返回一个 journal 数组交给 runTurn 累积本回合的文件原文。 */
-  function snapshot({ session, label }) {
-    const cp = {
-      id: ++seq,
-      time: Date.now(),
-      label: deriveLabel(label),
-      messagesLen: session.messages.length,
-      compaction: safeClone(session.compaction),
-      journal: [],
-    };
-    list.push(cp);
-    // 上限保护：超出则丢弃最早的（其对应文件原文一并释放）
-    if (list.length > MAX_CHECKPOINTS) list.splice(0, list.length - MAX_CHECKPOINTS);
-    return cp.journal;
-  }
-
-  /** 从某检查点（含）起、各文件最早一次记录的原始内容（用于回滚到该点之前的文件状态）。 */
-  function changedFilesSince(pos) {
-    const map = new Map(); // relPath -> journal entry（最早）
-    for (let i = pos; i < list.length; i++) {
-      for (const e of list[i].journal) {
-        if (e && e.path && !map.has(e.path)) map.set(e.path, e);
-      }
-    }
-    return map;
-  }
-
-  /**
-   * 回滚到检查点 id。
-   * @param {number} id 检查点编号
-   * @param {'chat'|'code'|'both'} mode
-   * @param {{session:object, cwd:string}} p
-   */
-  function restore(id, mode, { session, cwd }) {
-    const pos = list.findIndex((c) => c.id === id);
-    if (pos < 0) return { ok: false, error: `检查点 ${id} 不存在（/rewind 查看可用检查点）` };
-    const cp = list[pos];
-    const summary = { ok: true, id, mode, conversation: false, filesRestored: [], filesDeleted: [], filesFailed: [], filesSkipped: [] };
-
-    if (mode === 'code' || mode === 'both') {
-      for (const [relPath, e] of changedFilesSince(pos)) {
-        if (e.tooLarge) { summary.filesSkipped.push(relPath); continue; }
-        const abs = path.resolve(cwd, relPath);
-        try {
-          if (!e.existed) {
-            fs.rmSync(abs, { force: true });
-            summary.filesDeleted.push(relPath);
-          } else {
-            fs.mkdirSync(path.dirname(abs), { recursive: true });
-            fs.writeFileSync(abs, e.before, 'utf8');
-            summary.filesRestored.push(relPath);
-          }
-        } catch (err) {
-          summary.filesFailed.push(`${relPath}：${err.message}`);
-        }
-      }
-    }
-
-    if (mode === 'chat' || mode === 'both') {
-      if (cp.messagesLen <= session.messages.length) session.messages.length = cp.messagesLen;
-      session.compaction = safeClone(cp.compaction);
-      session.lastPromptTokens = 0;
-      summary.conversation = true;
-      // 对话被截断 → 该点及之后的检查点失效
-      list.length = pos;
-    }
-    return summary;
-  }
-
-  return { list, snapshot, restore, changedFilesSince };
-}
+import e from"node:fs";import t from"node:path";function n(e){try{return e?JSON.parse(JSON.stringify(e)):{}}catch{return{}}}function s(e){const t=String(e||"").replace(/\s+/g," ").trim();return t?t.length>60?t.slice(0,60)+"…":t:"(空)"}export function createCheckpoints(){const o=[];let r=0;function i(e){const t=new Map;for(let n=e;n<o.length;n++)for(const e of o[n].journal)e&&e.path&&!t.has(e.path)&&t.set(e.path,e);return t}return{list:o,snapshot:function({session:e,label:t}){const i={id:++r,time:Date.now(),label:s(t),messagesLen:e.messages.length,compaction:n(e.compaction),journal:[]};return o.push(i),o.length>100&&o.splice(0,o.length-100),i.journal},restore:function(s,r,{session:c,cwd:a}){const l=o.findIndex(e=>e.id===s);if(l<0)return{ok:!1,error:`检查点 ${s} 不存在（/rewind 查看可用检查点）`};const f=o[l],p={ok:!0,id:s,mode:r,conversation:!1,filesRestored:[],filesDeleted:[],filesFailed:[],filesSkipped:[]};if("code"===r||"both"===r)for(const[n,s]of i(l)){if(s.tooLarge){p.filesSkipped.push(n);continue}const o=t.resolve(a,n);try{s.existed?(e.mkdirSync(t.dirname(o),{recursive:!0}),e.writeFileSync(o,s.before,"utf8"),p.filesRestored.push(n)):(e.rmSync(o,{force:!0}),p.filesDeleted.push(n))}catch(e){p.filesFailed.push(`${n}：${e.message}`)}}return"chat"!==r&&"both"!==r||(f.messagesLen<=c.messages.length&&(c.messages.length=f.messagesLen),c.compaction=n(f.compaction),c.lastPromptTokens=0,p.conversation=!0,o.length=l),p},changedFilesSince:i}}