@huicai/cli 2026.711.0 → 2026.711.24617

package/src/todo.js

@@ -1,75 +1 @@
-// 任务清单工具：
-// 模型用 todo_write 维护当前任务的步骤清单（每次提交完整列表），CLI 实时渲染进度。
-// 纯客户端状态（不落盘、不进模型上下文之外的系统），状态由调用方（会话）持有以跨轮保留。
-
-const STATUSES = new Set(['pending', 'in_progress', 'completed']);
-
-export const TODO_TOOL_NAME = 'todo_write';
-
-/**
- * 构造 todo_write 工具。
- * @param {{state:{list:any[]}, emit:(list:any[])=>void}} p state 由调用方持有（跨轮保留）；emit 用于 UI 渲染
- * @returns {{spec:object, run:Function, readOnly:boolean}}
- */
-export function makeTodoTool({ state, emit }) {
-  const spec = {
-    type: 'function',
-    function: {
-      name: TODO_TOOL_NAME,
-      description:
-        '维护当前任务的步骤清单，帮助用户看到进度。多步骤/非琐碎任务开始前先列出计划，'
-        + '每完成一步就更新状态（同一时刻至多一项 in_progress）。每次调用需提交完整清单（全量覆盖）。'
-        + '单步小事无需使用。',
-      parameters: {
-        type: 'object',
-        properties: {
-          todos: {
-            type: 'array',
-            description: '完整的任务清单（全量覆盖旧清单）',
-            items: {
-              type: 'object',
-              properties: {
-                content: { type: 'string', description: '任务内容（简短祈使句）' },
-                status: { type: 'string', enum: ['pending', 'in_progress', 'completed'], description: '任务状态' },
-              },
-              required: ['content', 'status'],
-            },
-          },
-        },
-        required: ['todos'],
-      },
-    },
-  };
-
-  const run = async (args) => {
-    const raw = Array.isArray(args?.todos) ? args.todos : null;
-    if (!raw) return 'todo_write 需要 todos 数组';
-    const list = raw
-      .map((t) => ({
-        content: String(t?.content ?? '').trim(),
-        status: STATUSES.has(t?.status) ? t.status : 'pending',
-      }))
-      .filter((t) => t.content)
-      .slice(0, 50);
-    state.list = list;
-    try {
-      emit?.(list);
-    } catch {
-      /* 渲染失败不影响流程 */
-    }
-    const done = list.filter((t) => t.status === 'completed').length;
-    return `已更新任务清单：共 ${list.length} 项，完成 ${done} 项。`;
-  };
-
-  return { readOnly: true, spec, run };
-}
-
-/** 把清单渲染为多行文本（REPL/降级输出用）。 */
-export function formatTodos(list) {
-  return (list || [])
-    .map((t) => {
-      const mark = t.status === 'completed' ? '☑' : t.status === 'in_progress' ? '◐' : '☐';
-      return `${mark} ${t.content}`;
-    })
-    .join('\n');
-}
+const t=new Set(["pending","in_progress","completed"]);export const TODO_TOOL_NAME="todo_write";export function makeTodoTool({state:e,emit:o}){return{readOnly:!0,spec:{type:"function",function:{name:"todo_write",description:"维护当前任务的步骤清单，帮助用户看到进度。多步骤/非琐碎任务开始前先列出计划，每完成一步就更新状态（同一时刻至多一项 in_progress）。每次调用需提交完整清单（全量覆盖）。单步小事无需使用。",parameters:{type:"object",properties:{todos:{type:"array",description:"完整的任务清单（全量覆盖旧清单）",items:{type:"object",properties:{content:{type:"string",description:"任务内容（简短祈使句）"},status:{type:"string",enum:["pending","in_progress","completed"],description:"任务状态"}},required:["content","status"]}}},required:["todos"]}}},run:async n=>{const r=Array.isArray(n?.todos)?n.todos:null;if(!r)return"todo_write 需要 todos 数组";const s=r.map(e=>({content:String(e?.content??"").trim(),status:t.has(e?.status)?e.status:"pending"})).filter(t=>t.content).slice(0,50);e.list=s;try{o?.(s)}catch{}const i=s.filter(t=>"completed"===t.status).length;return`已更新任务清单：共 ${s.length} 项，完成 ${i} 项。`}}}export function formatTodos(t){return(t||[]).map(t=>`${"completed"===t.status?"☑":"in_progress"===t.status?"◐":"☐"} ${t.content}`).join("\n")}

package/src/tools.js

@@ -1,147 +1 @@
-// 本机工具的 OpenAI 函数规格（随请求透传给平台模型）+ 名称→执行器分发。
-
-import * as ex from './executors.js';
-import { searchCode } from './codeindex.js';
-
-const obj = (properties, required) => ({ type: 'object', properties, required: required || [] });
-const str = (description) => ({ type: 'string', description });
-const int = (description) => ({ type: 'integer', description });
-const bool = (description) => ({ type: 'boolean', description });
-
-/** @type {any[]} 暴露给模型的工具（函数调用规格）。 */
-export const TOOL_SPECS = [
-  {
-    type: 'function',
-    function: {
-      name: 'read_file',
-      description:
-        '读取文本文件内容，每行带「行号→」前缀（行号仅供定位，不属于文件内容，编辑时不要包含它）。'
-        + '默认最多 2000 行，可用 offset(起始行,1基)/limit(行数) 分段读取大文件。',
-      parameters: obj(
-        { path: str('相对项目根的文件路径'), offset: int('可选：起始行(1基)'), limit: int('可选：读取行数') },
-        ['path'],
-      ),
-    },
-  },
-  {
-    type: 'function',
-    function: {
-      name: 'list_files',
-      description: '列出目录下的文件树（跳过 .git/node_modules 等）。可选 path 指定子目录（默认项目根）。',
-      parameters: obj({ path: str('可选：子目录路径，默认当前项目根') }, []),
-    },
-  },
-  {
-    type: 'function',
-    function: {
-      name: 'glob',
-      description: '按 glob 模式查找文件（支持 ** 与 *），如 "**/*.ts"、"src/**/*.java"。',
-      parameters: obj({ pattern: str('glob 模式') }, ['pattern']),
-    },
-  },
-  {
-    type: 'function',
-    function: {
-      name: 'search_code',
-      description:
-        '按「概念/功能」检索最相关的代码块（BM25 相关性排序，比 grep 更懂「哪段代码在做这件事」）。'
-        + '适合「登录逻辑在哪」「哪里处理支付回调」这类找相关实现；要找精确字符串仍用 grep。返回 文件:行范围 + 代码块。',
-      parameters: obj(
-        { query: str('要找的功能/概念（自然语言或关键词组合，多写几个相关词更准）'), k: int('可选：返回块数，默认 8，上限 20') },
-        ['query'],
-      ),
-    },
-  },
-  {
-    type: 'function',
-    function: {
-      name: 'grep',
-      description:
-        '在文件内容中按正则搜索，返回 匹配文件:行号: 该行。可选 path 限定目录、glob 限定文件名模式、'
-        + 'ignore_case 忽略大小写、files_only 只列出命中文件。',
-      parameters: obj(
-        {
-          pattern: str('正则表达式'),
-          path: str('可选：搜索目录，默认项目根'),
-          glob: str('可选：文件名 glob 过滤'),
-          ignore_case: bool('可选：忽略大小写（默认否）'),
-          files_only: bool('可选：只返回命中文件列表，不含匹配行（默认否）'),
-          max_results: int('可选：最多返回条数（默认 200，上限 500）'),
-        },
-        ['pattern'],
-      ),
-    },
-  },
-  {
-    type: 'function',
-    function: {
-      name: 'write_file',
-      description: '把文本写入文件（覆盖式，自动建父目录）。仅限当前项目目录内。仅用于新建文件或全量重写；小改动优先 edit_file。',
-      parameters: obj({ path: str('相对项目根的文件路径'), content: str('完整文件内容') }, ['path', 'content']),
-    },
-  },
-  {
-    type: 'function',
-    function: {
-      name: 'edit_file',
-      description:
-        '精确替换文件中的片段：old_string 必须是文件原文（不含 read_file 的行号前缀）且在文件中唯一'
-        + '（除非 replace_all=true）。仅限项目目录内。',
-      parameters: obj(
-        {
-          path: str('相对项目根的文件路径'),
-          old_string: str('被替换的原文（需在文件中唯一，除非 replace_all；不要包含行号前缀）'),
-          new_string: str('替换为的新内容'),
-          replace_all: bool('是否替换全部匹配（默认否）'),
-        },
-        ['path', 'old_string', 'new_string'],
-      ),
-    },
-  },
-  {
-    type: 'function',
-    function: {
-      name: 'run_bash',
-      description:
-        '在项目目录下执行一条 shell 命令并返回输出（stdout+stderr+退出码）。用于构建、测试、git、脚手架等。'
-        + '默认超时 120s（可用 timeout 调整）。避免用它读文件/搜索（用 read_file/grep 更高效）。',
-      parameters: obj({ command: str('要执行的 shell 命令'), timeout: int('可选：超时毫秒') }, ['command']),
-    },
-  },
-  {
-    type: 'function',
-    function: {
-      name: 'fetch_url',
-      description:
-        '抓取一个 http/https 网页或接口（GET），HTML 自动转为纯文本。用于查在线文档、API 说明、Issue 等。'
-        + '结果可能很长，尽量带着明确目的使用。',
-      parameters: obj({ url: str('完整 URL（http/https）'), timeout: int('可选：超时毫秒，默认 30000') }, ['url']),
-    },
-  },
-];
-
-/** 只读工具（默认自动放行，无需审批）。fetch_url 涉及外发请求，需用户授权。 */
-export const READONLY_TOOLS = new Set(['read_file', 'list_files', 'glob', 'grep', 'search_code']);
-
-const EXECUTORS = {
-  read_file: ex.readFile,
-  list_files: ex.listFiles,
-  glob: ex.glob,
-  grep: ex.grep,
-  search_code: searchCode,
-  write_file: ex.writeFile,
-  edit_file: ex.editFile,
-  run_bash: ex.runBash,
-  fetch_url: ex.fetchUrl,
-};
-
-/** 执行一个本机工具，返回文本结果（回填给模型）。config 传入供个别工具用（如 search_code 的向量重排）。抛错转为可读文本，保证循环不中断。 */
-export async function runTool(name, args, cwd, config) {
-  const fn = EXECUTORS[name];
-  if (!fn) return `未知工具：${name}`;
-  try {
-    return await fn(cwd, args || {}, config);
-  } catch (e) {
-    return `工具执行失败：${e.message}`;
-  }
-}
+import*as e from"./executors.js";import{searchCode as t}from"./codeindex.js";const r=(e,t)=>({type:"object",properties:e,required:t||[]}),n=e=>({type:"string",description:e}),i=e=>({type:"integer",description:e}),o=e=>({type:"boolean",description:e});export const TOOL_SPECS=[{type:"function",function:{name:"read_file",description:"读取文本文件内容，每行带「行号→」前缀（行号仅供定位，不属于文件内容，编辑时不要包含它）。默认最多 2000 行，可用 offset(起始行,1基)/limit(行数) 分段读取大文件。",parameters:r({path:n("相对项目根的文件路径"),offset:i("可选：起始行(1基)"),limit:i("可选：读取行数")},["path"])}},{type:"function",function:{name:"list_files",description:"列出目录下的文件树（跳过 .git/node_modules 等）。可选 path 指定子目录（默认项目根）。",parameters:r({path:n("可选：子目录路径，默认当前项目根")},[])}},{type:"function",function:{name:"glob",description:'按 glob 模式查找文件（支持 ** 与 *），如 "**/*.ts"、"src/**/*.java"。',parameters:r({pattern:n("glob 模式")},["pattern"])}},{type:"function",function:{name:"search_code",description:"按「概念/功能」检索最相关的代码块（BM25 相关性排序，比 grep 更懂「哪段代码在做这件事」）。适合「登录逻辑在哪」「哪里处理支付回调」这类找相关实现；要找精确字符串仍用 grep。返回 文件:行范围 + 代码块。",parameters:r({query:n("要找的功能/概念（自然语言或关键词组合，多写几个相关词更准）"),k:i("可选：返回块数，默认 8，上限 20")},["query"])}},{type:"function",function:{name:"grep",description:"在文件内容中按正则搜索，返回 匹配文件:行号: 该行。可选 path 限定目录、glob 限定文件名模式、ignore_case 忽略大小写、files_only 只列出命中文件。",parameters:r({pattern:n("正则表达式"),path:n("可选：搜索目录，默认项目根"),glob:n("可选：文件名 glob 过滤"),ignore_case:o("可选：忽略大小写（默认否）"),files_only:o("可选：只返回命中文件列表，不含匹配行（默认否）"),max_results:i("可选：最多返回条数（默认 200，上限 500）")},["pattern"])}},{type:"function",function:{name:"write_file",description:"把文本写入文件（覆盖式，自动建父目录）。仅限当前项目目录内。仅用于新建文件或全量重写；小改动优先 edit_file。",parameters:r({path:n("相对项目根的文件路径"),content:n("完整文件内容")},["path","content"])}},{type:"function",function:{name:"edit_file",description:"精确替换文件中的片段：old_string 必须是文件原文（不含 read_file 的行号前缀）且在文件中唯一（除非 replace_all=true）。仅限项目目录内。",parameters:r({path:n("相对项目根的文件路径"),old_string:n("被替换的原文（需在文件中唯一，除非 replace_all；不要包含行号前缀）"),new_string:n("替换为的新内容"),replace_all:o("是否替换全部匹配（默认否）")},["path","old_string","new_string"])}},{type:"function",function:{name:"run_bash",description:"在项目目录下执行一条 shell 命令并返回输出（stdout+stderr+退出码）。用于构建、测试、git、脚手架等。默认超时 120s（可用 timeout 调整）。避免用它读文件/搜索（用 read_file/grep 更高效）。",parameters:r({command:n("要执行的 shell 命令"),timeout:i("可选：超时毫秒")},["command"])}},{type:"function",function:{name:"fetch_url",description:"抓取一个 http/https 网页或接口（GET），HTML 自动转为纯文本。用于查在线文档、API 说明、Issue 等。结果可能很长，尽量带着明确目的使用。",parameters:r({url:n("完整 URL（http/https）"),timeout:i("可选：超时毫秒，默认 30000")},["url"])}}];export const READONLY_TOOLS=new Set(["read_file","list_files","glob","grep","search_code"]);const s={read_file:e.readFile,list_files:e.listFiles,glob:e.glob,grep:e.grep,search_code:t,write_file:e.writeFile,edit_file:e.editFile,run_bash:e.runBash,fetch_url:e.fetchUrl};export async function runTool(e,t,r,n){const i=s[e];if(!i)return`未知工具：${e}`;try{return await i(r,t||{},n)}catch(e){return`工具执行失败：${e.message}`}}

package/src/transcript.js

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