@huicai/cli 2026.711.24617 → 2026.712.80880

package/squads/hc-review.md

@@ -0,0 +1,49 @@
+---
+name: hc-review
+description: 代码评审团——正确性/安全/性能/可维护性四视角并行深评一个 diff，聚合为分级可执行意见
+leader: 明镜
+mode: ensemble
+when: 需要深度评审一段代码/diff/PR（多维度找缺陷并给分级意见）时；纯格式问题用 linter 不开团
+---
+
+不放过一个会上线的缺陷，也不淹没作者：每条意见必须分级（BLOCKER/MAJOR/MINOR）、定位到文件行、给出可执行的修法。四视角并行是本团的 ensemble 用法——同一 diff 多视角竞争性审查，主理人聚合去重仲裁。
+
+## 成员
+- correct  | 辨真 | 正确性：边界/并发/错误处理/逻辑缺陷 |
+- secure   | 御城 | 安全：注入/越权/敏感信息/依赖风险 |
+- perf     | 疾风 | 性能：N+1/热点路径/内存/多余 IO |
+- maintain | 织理 | 可维护性：命名/重复/耦合/与项目 idiom 一致性 |
+
+## 成员人设
+### correct
+角色：正确性审查员（怀疑一切输入）。
+工作方法：对每个改动问三件事——空/极值/非法输入会怎样？并发或重入会怎样？失败路径清理干净了吗？每报一个缺陷必须构造出具体触发场景（输入/状态→错误结果），构造不出就不报。
+交付标准：缺陷列表，每条含 [级别][文件:行] 触发场景 + 修法建议；无缺陷时明确说"未发现"而非空泛肯定。
+
+### secure
+角色：安全审查员（攻击者视角）。
+工作方法：沿数据流追（外部输入→处理→存储/输出），核对注入（SQL/命令/路径/模板）、越权（水平/垂直）、敏感信息（日志/报错/硬编码密钥）、依赖与配置风险；主理人提供的扫描器结果作为线索复核而非结论。
+交付标准：按 OWASP 归类的风险列表，每条含利用路径与修复方式；区分"确认可利用"与"需人工核实"。
+
+### perf
+角色：性能审查员。
+工作方法：找热点路径上的放大项——循环内 IO/查询（N+1）、多余序列化、无界集合、重复计算、错误的缓存粒度；估计数据量级，不在冷路径上吹毛求疵。
+交付标准：问题点 + 量级估算（何时会疼）+ 改法；明确"当前规模可接受"的项不列为问题。
+
+### maintain
+角色：可维护性审查员（下一个读代码的人）。
+工作方法：对照 diff 周边代码的既有风格与模式；找重复逻辑（应抽取）、错误的抽象层级、误导性命名、缺失的关键注释（只在"代码说不清约束"处要求注释）。
+交付标准：改善建议按"值得现在改/可以以后改"分两档；不提口味之争。
+
+## 预检
+- 未提供 diff/代码 → 主理人先用 git 工具取（git diff/show），这是主理人的精确层动作
+- 纯格式/风格 → 不开团，建议 linter/formatter
+- 评审后要求"顺手修掉" → 意见先出，修复动作转 hc-fullstack 或主理人直接落地小修
+
+## 工作流
+### 深度评审（触发：评审 diff/PR/一段代码）
+1. 主理人：取 diff 与必要的周边上下文（被调用方/调用方片段），可先跑本机扫描器作原料
+2. correct、secure、perf、maintain：同一 diff 并行四审（同一轮派发；context=diff 全文+周边片段）
+3. 主理人：聚合——去重、跨视角冲突仲裁、统一分级排序（BLOCKER→MINOR），逐条核对文件行号
+4. 主理人：按交付检查清单自查后输出评审报告；用户要求修复时，BLOCKER/MAJOR 逐条落地并复验
+交付：分级评审报告（每条：级别/位置/场景/修法），附"未发现问题的维度"声明

package/squads/hc-test.md

@@ -0,0 +1,49 @@
+---
+name: hc-test
+description: 测试锻造团——场景矩阵、单测/集成并行锻造、稽核查漏、修到全绿的成套测试
+leader: 锻宇
+mode: dispatch
+when: 需要为模块/功能/改动补齐成套测试（从场景设计到跑绿）时；单个小用例不开团
+---
+
+测试是对行为的契约，不是覆盖率数字。每个用例说得清"守护什么行为、什么输入、什么预期"；矩阵先行，先想清楚要守什么，再动手写。
+
+## 成员
+- designer    | 谋局 | 场景设计：等价类/边界/异常/并发的场景矩阵 |
+- unit        | 铸微 | 单元测试：按矩阵产出单测代码 |
+- integration | 合纵 | 集成测试：按矩阵产出跨组件/接口级测试 |
+- auditor     | 稽核 | 查漏：对照矩阵稽核用例缺口与断言质量 |
+
+## 成员人设
+### designer
+角色：测试用例设计师。
+工作方法：从代码与需求反推行为契约；按维度铺场景——正常路径（等价类代表值）、边界（0/1/满/空/超长）、异常（非法输入/依赖失败/超时）、状态与并发（重入/顺序依赖）；给每个场景标优先级（P0 必须有）。
+交付标准：场景矩阵表（编号/场景描述/输入要点/预期行为/优先级/建议层级[单测|集成]），P0 场景不允许"待定"。
+
+### unit
+角色：单元测试工程师。
+工作方法：沿用项目既有测试框架与断言风格（先读现有测试文件）；一个用例守一个行为；测行为不测实现（不断言内部调用次数除非那就是契约）；外部依赖用项目既有的 mock 模式。
+交付标准：可运行的单测代码，用例名映射矩阵编号；附"如何运行"命令。
+
+### integration
+角色：集成测试工程师。
+工作方法：优先覆盖模块边界与真实装配路径（路由→服务→存储/HTTP 契约）；测试数据自建自清，不依赖外部环境状态；不稳定因素（时间/随机/网络）显式固定。
+交付标准：可运行的集成测试 + 所需前置（如内存库/测试容器/mock server）说明。
+
+### auditor
+角色：覆盖稽核员。
+工作方法：拿矩阵逐行对照已产出用例——漏了哪些场景、哪些断言太弱（只断言不抛错/只断言非空）、哪些用例互相重复；不追求行覆盖率数字，追求 P0 场景全覆盖。
+交付标准：缺口清单（矩阵编号→缺失/断言弱/重复）+ 需要回炉的用例点名。
+
+## 预检
+- 只要跑现有测试/查失败原因 → 不开团（主理人直接跑，失败转 hc-debug）
+- 为"下一步重构"补基线 → 本团正是干这个的，矩阵侧重现状行为快照
+- 补一两个用例的小活 → 主理人直接写
+
+## 工作流
+### 成套铸测（触发：为模块/功能补齐测试）
+1. designer：读代码与需求出场景矩阵
+2. unit 与 integration：按矩阵并行产出各自层级的测试代码（同一轮派发，context 带矩阵）
+3. auditor：对照矩阵稽核缺口（有缺口回 2 定向补齐，≤2 轮）
+4. 主理人：落地测试代码（经用户审批）→ 跑到全绿：失败逐个回灌对应成员修（区分"测试写错"与"发现了真 bug"——真 bug 上报用户，转 hc-debug，不许改测试迁就 bug）
+交付：跑绿的成套测试 + 场景矩阵（沉淀为回归资产）+ 发现的真 bug 清单

package/src/agent.js

@@ -1 +1 @@
-import t from"node:fs";import o from"node:path";import{streamChat as e}from"./api.js";import{MarkupFilter as n,stripMarkup as r}from"./markup-filter.js";import{TOOL_SPECS as s,READONLY_TOOLS as a,runTool as l}from"./tools.js";import{toolLabel as i,indent as c,renderFileDiff as u}from"./render.js";import{compactIfNeeded as m,buildModelMessages as g}from"./compaction.js";import{makeTodoTool as p,formatTodos as f,TODO_TOOL_NAME as d}from"./todo.js";import{makeMemoryTool as h}from"./memory.js";import{loadHooks as y,runHooks as w}from"./hooks.js";import*as S from"./ide.js";import{c as _}from"./colors.js";function T(t){const o=String(t);return o.startsWith("工具执行失败")||o.startsWith("命令启动失败")||o.includes("不是合法 JSON")||o.includes("未找到要替换的内容")||o.includes("路径超出项目目录")||o.includes("是目录而非文件")}function b(t){return"\n\n# 当前目标（用户设定）\n"+String(t).trim()+"\n在本回合结束、停止作答前，检查该目标是否已达成：若未达成，应继续推进（补充调研/改动/验证），不要过早停止；达成后用一句话说明已达成。"}function k(t){return"string"==typeof t?t:Array.isArray(t)?t.filter(t=>"text"===t?.type).map(t=>t.text||"").join("\n"):""}async function x(t,o,e){const n=new Array(t.length);let r=0;return await Promise.all(Array.from({length:Math.max(1,Math.min(o,t.length))},async()=>{for(;r<t.length;){const o=r++;n[o]=await e(t[o],o)}})),n}export function isPlatformModel(t){return/^(agent|workflow|datahuman)-/.test(String(t||""))}function P(t,o=200){const e=String(t).split("\n")[0];return e.length>o?e.slice(0,o)+"…":e}export function capToolResult(t){const o=String(t);if(o.length<=2e4)return o;const e=o.length-16e3-3e3;return o.slice(0,16e3)+`\n…【工具输出过长，中间已省略 ${e} 字符】…\n`+o.slice(-3e3)}export async function runTurn({config:$,messages:j,permissions:M,cwd:I,ask:E,signal:U,extraTools:v=[],depth:A=0,io:O,events:C,todoState:R,compaction:N,pullQueued:D,maxIters:J,fileJournal:q}){const F=O&&O.write||(t=>process.stdout.write(t)),K=C||null,W=t=>{K?K.onInfo?.(t):F(_.gray("  · "+t)+"\n")};let L=0,Q=0,z=0;const B=Number(J||$.maxTurns)||120,G=isPlatformModel($.model);let H=$.model;if(0===A&&$.autoModelStrong&&!G){const t=[...j].reverse().find(t=>"user"===t.role),o=k(t?.content);($.planMode||o.length>400||/重构|架构|设计|复杂|排查|调试|debug|优化|性能|并发|死锁|重写|迁移|安全审查|根因/i.test(o))&&$.autoModelStrong!==$.model&&(H=$.autoModelStrong,$.debug&&W(`[automodel] 复杂回合升配 → ${H}`))}const V=N||{},X=[...v];if(0===A&&!G&&!X.some(t=>t.spec?.function?.name===d)){const t=R||{list:[]};X.push(p({state:t,emit:t=>{K?K.onTodo?K.onTodo(t.map(t=>({...t}))):K.onInfo?.("任务清单：\n"+f(t)):F(_.gray(c(f(t),"  "))+"\n")}}))}0!==A||G||!1===$.memoryEnabled||X.some(t=>"memory_write"===t.spec?.function?.name)||X.push(h({cwd:I,emit:t=>{K?K.onMemory?K.onMemory(t):K.onInfo?.("已记入长期记忆："+P(t,80)):F(_.gray("  ✎ 已记入长期记忆："+P(t,80))+"\n")}}));const Y=new Map;for(const t of X)Y.set(t.spec.function.name,t);const Z=G?void 0:[...s,...X.map(t=>t.spec)];let tt=0,ot=!1,et=0,nt=null;const rt=0!==A||G?null:y(I),st=!(!rt||!rt.all.length);if(st){const t=[];if(j.filter(t=>"user"===t.role).length<=1){const o=w("SessionStart",{cwd:I},rt);o.injectContext&&t.push(o.injectContext);for(const e of o.outputs)t.push(e.stdout)}const o=[...j].reverse().find(t=>"user"===t.role),e=w("UserPromptSubmit",{cwd:I,prompt:k(o?.content)},rt);if(e.block)return W("提交被 UserPromptSubmit 钩子阻断："+e.reason),{error:"提交被钩子阻断："+e.reason,usage:{prompt:L,completion:Q},lastPromptTokens:z};e.injectContext&&t.push(e.injectContext);for(const o of e.outputs)t.push(o.stdout);t.length&&(nt="【钩子提供的附加上下文】\n"+t.join("\n"))}for(let s=0;s<B;s++){const c=s===B-1;!c||G||ot||nt||(nt="已接近本回合的工具调用轮数上限。请不要再调用任何工具，基于目前已获得的信息，直接用中文输出面向用户的完整最终答复。");const p=await m(j,$,{state:V,lastPromptTokens:z});p>0&&W(`已压缩上下文（${p} 条较早消息已摘要，页面与会话记录不受影响）`);let f=!1,d=!1;const h=new n,y=t=>{t&&(f||!d||K||F("\n"),f=!0,K?K.onDelta?.(t):F(t))},k=g(j,V);let E=k;if(!G&&k.length&&"system"===k[0]?.role){let t="";$.planMode&&(t+="\n\n# 计划模式（当前开启）\n你现在处于计划模式：只能用只读工具（read_file/glob/grep/list_files/fetch_url）调研，不得做任何改动——write_file/edit_file/run_bash 等写或执行操作都会被拒绝，不要反复尝试。请先充分理解需求与现状，然后产出一份清晰、分步的实施方案：涉及哪些文件、每步改动要点、如何验证、风险点，用 todo_write 列出步骤，随后停下等待用户确认。用户关闭计划模式后你再执行。"),$.sandbox&&(t+="\n\n# 沙箱模式（当前开启）\n禁止执行 shell 命令（run_bash）与联网（fetch_url），调用会被拒绝，不要反复尝试。只做本地文件读写与分析。"),$.goal&&String($.goal).trim()&&(t+=b($.goal)),t&&(E=[{...k[0],content:String(k[0].content||"")+t},...k.slice(1)])}const v=Date.now();let A;try{A=await e({baseUrl:$.baseUrl,apiKey:$.apiKey,model:H,messages:nt?[...E,{role:"user",content:nt}]:E,tools:ot||c?void 0:Z,reasoningEffort:$.reasoningEffort,client:$.client,sessionId:$.sessionId},{onContent:t=>y(h.feed(t)),onReasoning:t=>{!1!==$.showReasoning&&(K?K.onReasoning?.(t):(d||F(_.gray("\n[思考] ")),F(_.gray(t))),d=!0)},onRetry:(t,o,e)=>W(`模型响应异常，${Math.round(o/1e3)}s 后自动重试（第 ${t} 次）：${e}`)},U)}catch(t){return"AbortError"===t.name?(K?K.onInfo?.("已中断"):F(_.gray("\n[已中断]\n")),{aborted:!0,usage:{prompt:L,completion:Q},lastPromptTokens:z}):(K?K.onInfo?.("✗ 模型调用失败："+t.message):F("\n"+_.red("✗ 模型调用失败：")+t.message+"\n"),{error:t.message,usage:{prompt:L,completion:Q},lastPromptTokens:z})}y(h.flush()),A.usage&&(L+=A.usage.prompt_tokens||0,Q+=A.usage.completion_tokens||0,z=A.usage.prompt_tokens||z),$.debug&&W(`[debug] 轮${s+1} · ${$.model} · in ${A.usage?.prompt_tokens||0} / out ${A.usage?.completion_tokens||0} tok · ${Date.now()-v}ms · ${(A.toolCalls||[]).length} 工具调用`);const{text:O,sawMarkup:C}=r(A.content),R=C||h.sawMarkup;nt=null;const N=G?[]:A.toolCalls;if(!N.length){if(R&&!O.trim()&&!G){if(tt<2){tt++,2===tt&&(ot=!0),nt=1===tt?"你刚才的输出把工具调用写成了文本标记，工具并未被执行，该内容也不会展示给用户。请重新处理：若需调用工具，必须使用规范的函数调用（tool_calls）通道发起，绝不要以任何文本形式书写工具调用标记；若无需工具，请直接用中文输出面向用户的最终答复。":"请停止调用任何工具。基于目前已获得的全部信息，直接用中文输出面向用户的完整最终答复，不要输出任何工具调用或协议标记。",W(`已拦截模型的文本化工具调用标记（工具未被执行），纠正重试中（第 ${tt} 次）`);continue}W("模型持续输出无效的工具调用标记，已全部拦截；本轮无有效答复（可换个说法重试或更换模型）")}f&&!K&&F("\n"),O&&j.push({role:"assistant",content:O}),K&&K.onTurnEnd?.(O);const t=D?.();if(t){j.push({role:"user",content:t});continue}if(st){const t=w("Stop",{cwd:I,result:O},rt);for(const o of t.outputs)W("钩子·Stop："+P(o.stdout,160))}return{usage:{prompt:L,completion:Q},lastPromptTokens:z}}f&&!K&&F("\n"),K&&O&&K.onAssistantText?.(O),j.push({role:"assistant",content:O,tool_calls:N});const J=N.map((t,o)=>{const e=t.function?.name||"";let n={},r=null;const s=t.function?.arguments||"";if(s)try{n=JSON.parse(s)}catch(t){r=`工具参数不是合法 JSON（${t.message}）：${String(s).slice(0,200)}…请修正参数后重新调用。`}const l=Y.get(e),i=S.isActive()&&("write_file"===e||"edit_file"===e);return{tc:t,idx:o,name:e,args:n,argsError:r,extra:l,readOnly:l?!!l.readOnly:a.has(e),deferToIde:i}}),X=t=>{for(let o=t;o<J.length;o++)j.push({role:"tool",tool_call_id:J[o].tc.id||`call_${o}`,content:"（用户中断，该工具未执行）"});return K?K.onInfo?.("已中断"):F(_.gray("\n[已中断]\n")),{aborted:!0,usage:{prompt:L,completion:Q},lastPromptTokens:z}},at=async t=>{if(t.argsError)return t.argsError;let o;try{o=t.extra?await t.extra.run(t.args):await l(t.name,t.args,I,$)}catch(t){o=`工具执行失败：${t.message}`}return capToolResult(String(o))},lt=t=>{K?K.onToolStart?.(t.name,t.args):F(_.cyan("  ⏺ ")+i(t.name,t.args)+"\n")},it=(t,o)=>{T(o)&&et++,K?K.onToolResult?.(t.name,String(o)):F(_.gray("     "+P(o))+"\n"),j.push({role:"tool",tool_call_id:t.tc.id,content:String(o)})},ct=(t,o)=>{K?K.onSkip?.(t.name,t.args):F(_.gray(`  ⊘ ${i(t.name,t.args)} — 已跳过\n`)),j.push({role:"tool",tool_call_id:t.tc.id,content:o||"未授权，未执行。"})},ut=t=>"edit_file"===t||"write_file"===t,mt=o=>{try{return t.readFileSync(o,"utf8")}catch{return""}},gt=(t,e)=>{const n=o.resolve(I,String(t.args.path)),r=u(e,mt(n),{path:String(t.args.path)});r&&(K?K.onFileDiff?.(r):F(r+"\n"))};let pt=0;for(;pt<J.length;){if(U?.aborted)return X(pt);const e=J[pt];if(e.argsError){lt(e),it(e,e.argsError),pt++;continue}if(e.readOnly){let t=pt;for(;t<J.length&&J[t].readOnly&&!J[t].argsError;)t++;const o=J.slice(pt,t),e=await x(o,8,async t=>{const o=await M.request(t.name,t.args,I,!0);return o.allow?(lt(t),{item:t,result:await at(t)}):{item:t,denied:o.reason||"未授权，未执行。"}});for(const t of e)null!=t.denied?ct(t.item,t.denied):it(t.item,t.result);if(pt=t,U?.aborted)return X(pt);continue}const n=await M.request(e.name,e.args,I,e.readOnly||e.deferToIde);if(U?.aborted)return X(pt);if(!n.allow){ct(e,n.reason),pt++;continue}if(st){const t=w("PreToolUse",{cwd:I,toolName:e.name,args:e.args},rt);for(const o of t.outputs)W("钩子·PreToolUse："+P(o.stdout,120));if(t.block){ct(e,"PreToolUse 钩子阻断："+t.reason),pt++;continue}t.modifiedArgs&&(e.args={...e.args,...t.modifiedArgs},W("钩子·PreToolUse 已修改工具参数"))}lt(e);const r=ut(e.name)&&e.args?.path?mt(o.resolve(I,String(e.args.path))):null;if(q&&null!=r&&e.args?.path){const n=t.existsSync(o.resolve(I,String(e.args.path)));q.push(r.length>2097152?{path:String(e.args.path),tooLarge:!0}:{path:String(e.args.path),before:r,existed:n})}let s=await at(e);if(st){const t=w("PostToolUse",{cwd:I,toolName:e.name,args:e.args,result:String(s)},rt);if(t.outputs.length){for(const o of t.outputs)W("钩子·PostToolUse："+P(o.stdout,120));s=String(s)+"\n\n[PostToolUse 钩子输出]\n"+t.outputs.map(t=>t.stdout).join("\n")}}it(e,s),null!=r&&gt(e,r),pt++}et>=3&&!ot&&!nt&&(nt="你刚才连续多次工具调用失败。请停下来重新审视：是不是文件路径/内容/前提假设错了？先用 read_file / grep / list_files 核实现状，再换一种更可靠的方法，绝不要重复同样会失败的调用。",et=0,W("检测到连续工具失败，已提示智能体换一种更可靠的方法"));const ft=D?.();ft&&j.push({role:"user",content:ft})}return K?K.onInfo?.("已达最大工具轮数，停止"):F(_.yellow("\n[已达最大工具轮数，停止]\n")),{usage:{prompt:L,completion:Q},lastPromptTokens:z}}
+import t from"node:fs";import o from"node:path";import{streamChat as e}from"./api.js";import{MarkupFilter as n,stripMarkup as r}from"./markup-filter.js";import{TOOL_SPECS as s,READONLY_TOOLS as a,runTool as l}from"./tools.js";import{toolLabel as i,indent as c,renderFileDiff as u}from"./render.js";import{compactIfNeeded as m,buildModelMessages as g}from"./compaction.js";import{makeTodoTool as p,formatTodos as f,TODO_TOOL_NAME as d}from"./todo.js";import{makeMemoryTool as h}from"./memory.js";import{loadHooks as y,runHooks as w}from"./hooks.js";import*as S from"./ide.js";import{c as _}from"./colors.js";function T(t){const o=String(t);return o.startsWith("工具执行失败")||o.startsWith("命令启动失败")||o.includes("不是合法 JSON")||o.includes("未找到要替换的内容")||o.includes("路径超出项目目录")||o.includes("是目录而非文件")}function b(t){return"\n\n# 当前目标（用户设定）\n"+String(t).trim()+"\n在本回合结束、停止作答前，检查该目标是否已达成：若未达成，应继续推进（补充调研/改动/验证），不要过早停止；达成后用一句话说明已达成。"}function k(t){return"string"==typeof t?t:Array.isArray(t)?t.filter(t=>"text"===t?.type).map(t=>t.text||"").join("\n"):""}async function x(t,o,e){const n=new Array(t.length);let r=0;return await Promise.all(Array.from({length:Math.max(1,Math.min(o,t.length))},async()=>{for(;r<t.length;){const o=r++;n[o]=await e(t[o],o)}})),n}export function isPlatformModel(t){return/^(agent|workflow|datahuman|squad)-/.test(String(t||""))}function P(t,o=200){const e=String(t).split("\n")[0];return e.length>o?e.slice(0,o)+"…":e}export function capToolResult(t){const o=String(t);if(o.length<=2e4)return o;const e=o.length-16e3-3e3;return o.slice(0,16e3)+`\n…【工具输出过长，中间已省略 ${e} 字符】…\n`+o.slice(-3e3)}export async function runTurn({config:$,messages:j,permissions:M,cwd:I,ask:E,signal:U,extraTools:v=[],depth:A=0,io:O,events:C,todoState:R,compaction:N,pullQueued:D,maxIters:J,fileJournal:q}){const F=O&&O.write||(t=>process.stdout.write(t)),K=C||null,W=t=>{K?K.onInfo?.(t):F(_.gray("  · "+t)+"\n")};let L=0,Q=0,z=0;const B=Number(J||$.maxTurns)||120,G=isPlatformModel($.model);let H=$.model;if(0===A&&$.autoModelStrong&&!G){const t=[...j].reverse().find(t=>"user"===t.role),o=k(t?.content);($.planMode||o.length>400||/重构|架构|设计|复杂|排查|调试|debug|优化|性能|并发|死锁|重写|迁移|安全审查|根因/i.test(o))&&$.autoModelStrong!==$.model&&(H=$.autoModelStrong,$.debug&&W(`[automodel] 复杂回合升配 → ${H}`))}const V=N||{},X=[...v];if(0===A&&!G&&!X.some(t=>t.spec?.function?.name===d)){const t=R||{list:[]};X.push(p({state:t,emit:t=>{K?K.onTodo?K.onTodo(t.map(t=>({...t}))):K.onInfo?.("任务清单：\n"+f(t)):F(_.gray(c(f(t),"  "))+"\n")}}))}0!==A||G||!1===$.memoryEnabled||X.some(t=>"memory_write"===t.spec?.function?.name)||X.push(h({cwd:I,emit:t=>{K?K.onMemory?K.onMemory(t):K.onInfo?.("已记入长期记忆："+P(t,80)):F(_.gray("  ✎ 已记入长期记忆："+P(t,80))+"\n")}}));const Y=new Map;for(const t of X)Y.set(t.spec.function.name,t);const Z=G?void 0:[...s,...X.map(t=>t.spec)];let tt=0,ot=!1,et=0,nt=null;const rt=0!==A||G?null:y(I),st=!(!rt||!rt.all.length);if(st){const t=[];if(j.filter(t=>"user"===t.role).length<=1){const o=w("SessionStart",{cwd:I},rt);o.injectContext&&t.push(o.injectContext);for(const e of o.outputs)t.push(e.stdout)}const o=[...j].reverse().find(t=>"user"===t.role),e=w("UserPromptSubmit",{cwd:I,prompt:k(o?.content)},rt);if(e.block)return W("提交被 UserPromptSubmit 钩子阻断："+e.reason),{error:"提交被钩子阻断："+e.reason,usage:{prompt:L,completion:Q},lastPromptTokens:z};e.injectContext&&t.push(e.injectContext);for(const o of e.outputs)t.push(o.stdout);t.length&&(nt="【钩子提供的附加上下文】\n"+t.join("\n"))}for(let s=0;s<B;s++){const c=s===B-1;!c||G||ot||nt||(nt="已接近本回合的工具调用轮数上限。请不要再调用任何工具，基于目前已获得的信息，直接用中文输出面向用户的完整最终答复。");const p=await m(j,$,{state:V,lastPromptTokens:z});p>0&&W(`已压缩上下文（${p} 条较早消息已摘要，页面与会话记录不受影响）`);let f=!1,d=!1;const h=new n,y=t=>{t&&(f||!d||K||F("\n"),f=!0,K?K.onDelta?.(t):F(t))},k=g(j,V);let E=k;if(!G&&k.length&&"system"===k[0]?.role){let t="";$.planMode&&(t+="\n\n# 计划模式（当前开启）\n你现在处于计划模式：只能用只读工具（read_file/glob/grep/list_files/fetch_url）调研，不得做任何改动——write_file/edit_file/run_bash 等写或执行操作都会被拒绝，不要反复尝试。请先充分理解需求与现状，然后产出一份清晰、分步的实施方案：涉及哪些文件、每步改动要点、如何验证、风险点，用 todo_write 列出步骤，随后停下等待用户确认。用户关闭计划模式后你再执行。"),$.sandbox&&(t+="\n\n# 沙箱模式（当前开启）\n禁止执行 shell 命令（run_bash）、联网（fetch_url）与环境/应用自动化工具（install_*/setup_environment/open_*），调用会被拒绝，不要反复尝试。只做本地文件读写与分析。"),$.goal&&String($.goal).trim()&&(t+=b($.goal)),t&&(E=[{...k[0],content:String(k[0].content||"")+t},...k.slice(1)])}const v=Date.now();let A;try{A=await e({baseUrl:$.baseUrl,apiKey:$.apiKey,model:H,messages:nt?[...E,{role:"user",content:nt}]:E,tools:ot||c?void 0:Z,reasoningEffort:$.reasoningEffort,client:$.client,sessionId:$.sessionId},{onContent:t=>y(h.feed(t)),onReasoning:t=>{!1!==$.showReasoning&&(K?K.onReasoning?.(t):(d||F(_.gray("\n[思考] ")),F(_.gray(t))),d=!0)},onRetry:(t,o,e)=>W(`模型响应异常，${Math.round(o/1e3)}s 后自动重试（第 ${t} 次）：${e}`)},U)}catch(t){return"AbortError"===t.name?(K?K.onInfo?.("已中断"):F(_.gray("\n[已中断]\n")),{aborted:!0,usage:{prompt:L,completion:Q},lastPromptTokens:z}):(K?K.onInfo?.("✗ 模型调用失败："+t.message):F("\n"+_.red("✗ 模型调用失败：")+t.message+"\n"),{error:t.message,usage:{prompt:L,completion:Q},lastPromptTokens:z})}y(h.flush()),A.usage&&(L+=A.usage.prompt_tokens||0,Q+=A.usage.completion_tokens||0,z=A.usage.prompt_tokens||z),$.debug&&W(`[debug] 轮${s+1} · ${$.model} · in ${A.usage?.prompt_tokens||0} / out ${A.usage?.completion_tokens||0} tok · ${Date.now()-v}ms · ${(A.toolCalls||[]).length} 工具调用`);const{text:O,sawMarkup:C}=r(A.content),R=C||h.sawMarkup;nt=null;const N=G?[]:A.toolCalls;if(!N.length){if(R&&!O.trim()&&!G){if(tt<2){tt++,2===tt&&(ot=!0),nt=1===tt?"你刚才的输出把工具调用写成了文本标记，工具并未被执行，该内容也不会展示给用户。请重新处理：若需调用工具，必须使用规范的函数调用（tool_calls）通道发起，绝不要以任何文本形式书写工具调用标记；若无需工具，请直接用中文输出面向用户的最终答复。":"请停止调用任何工具。基于目前已获得的全部信息，直接用中文输出面向用户的完整最终答复，不要输出任何工具调用或协议标记。",W(`已拦截模型的文本化工具调用标记（工具未被执行），纠正重试中（第 ${tt} 次）`);continue}W("模型持续输出无效的工具调用标记，已全部拦截；本轮无有效答复（可换个说法重试或更换模型）")}f&&!K&&F("\n"),O&&j.push({role:"assistant",content:O}),K&&K.onTurnEnd?.(O);const t=D?.();if(t){j.push({role:"user",content:t});continue}if(st){const t=w("Stop",{cwd:I,result:O},rt);for(const o of t.outputs)W("钩子·Stop："+P(o.stdout,160))}return{usage:{prompt:L,completion:Q},lastPromptTokens:z}}f&&!K&&F("\n"),K&&O&&K.onAssistantText?.(O),j.push({role:"assistant",content:O,tool_calls:N});const J=N.map((t,o)=>{const e=t.function?.name||"";let n={},r=null;const s=t.function?.arguments||"";if(s)try{n=JSON.parse(s)}catch(t){r=`工具参数不是合法 JSON（${t.message}）：${String(s).slice(0,200)}…请修正参数后重新调用。`}const l=Y.get(e),i=S.isActive()&&("write_file"===e||"edit_file"===e);return{tc:t,idx:o,name:e,args:n,argsError:r,extra:l,readOnly:l?!!l.readOnly:a.has(e),deferToIde:i}}),X=t=>{for(let o=t;o<J.length;o++)j.push({role:"tool",tool_call_id:J[o].tc.id||`call_${o}`,content:"（用户中断，该工具未执行）"});return K?K.onInfo?.("已中断"):F(_.gray("\n[已中断]\n")),{aborted:!0,usage:{prompt:L,completion:Q},lastPromptTokens:z}},at=async t=>{if(t.argsError)return t.argsError;let o;try{o=t.extra?await t.extra.run(t.args):await l(t.name,t.args,I,$)}catch(t){o=`工具执行失败：${t.message}`}return capToolResult(String(o))},lt=t=>{K?K.onToolStart?.(t.name,t.args):F(_.cyan("  ⏺ ")+i(t.name,t.args)+"\n")},it=(t,o)=>{T(o)&&et++,K?K.onToolResult?.(t.name,String(o)):F(_.gray("     "+P(o))+"\n"),j.push({role:"tool",tool_call_id:t.tc.id,content:String(o)})},ct=(t,o)=>{K?K.onSkip?.(t.name,t.args):F(_.gray(`  ⊘ ${i(t.name,t.args)} — 已跳过\n`)),j.push({role:"tool",tool_call_id:t.tc.id,content:o||"未授权，未执行。"})},ut=t=>"edit_file"===t||"write_file"===t,mt=o=>{try{return t.readFileSync(o,"utf8")}catch{return""}},gt=(t,e)=>{const n=o.resolve(I,String(t.args.path)),r=u(e,mt(n),{path:String(t.args.path)});r&&(K?K.onFileDiff?.(r):F(r+"\n"))};let pt=0;for(;pt<J.length;){if(U?.aborted)return X(pt);const e=J[pt];if(e.argsError){lt(e),it(e,e.argsError),pt++;continue}if(e.readOnly){let t=pt;for(;t<J.length&&J[t].readOnly&&!J[t].argsError;)t++;const o=J.slice(pt,t),e=await x(o,8,async t=>{const o=await M.request(t.name,t.args,I,!0);return o.allow?(lt(t),{item:t,result:await at(t)}):{item:t,denied:o.reason||"未授权，未执行。"}});for(const t of e)null!=t.denied?ct(t.item,t.denied):it(t.item,t.result);if(pt=t,U?.aborted)return X(pt);continue}const n=await M.request(e.name,e.args,I,e.readOnly||e.deferToIde);if(U?.aborted)return X(pt);if(!n.allow){ct(e,n.reason),pt++;continue}if(st){const t=w("PreToolUse",{cwd:I,toolName:e.name,args:e.args},rt);for(const o of t.outputs)W("钩子·PreToolUse："+P(o.stdout,120));if(t.block){ct(e,"PreToolUse 钩子阻断："+t.reason),pt++;continue}t.modifiedArgs&&(e.args={...e.args,...t.modifiedArgs},W("钩子·PreToolUse 已修改工具参数"))}lt(e);const r=ut(e.name)&&e.args?.path?mt(o.resolve(I,String(e.args.path))):null;if(q&&null!=r&&e.args?.path){const n=t.existsSync(o.resolve(I,String(e.args.path)));q.push(r.length>2097152?{path:String(e.args.path),tooLarge:!0}:{path:String(e.args.path),before:r,existed:n})}let s=await at(e);if(st){const t=w("PostToolUse",{cwd:I,toolName:e.name,args:e.args,result:String(s)},rt);if(t.outputs.length){for(const o of t.outputs)W("钩子·PostToolUse："+P(o.stdout,120));s=String(s)+"\n\n[PostToolUse 钩子输出]\n"+t.outputs.map(t=>t.stdout).join("\n")}}it(e,s),null!=r&&gt(e,r),pt++}et>=3&&!ot&&!nt&&(nt="你刚才连续多次工具调用失败。请停下来重新审视：是不是文件路径/内容/前提假设错了？先用 read_file / grep / list_files 核实现状，再换一种更可靠的方法，绝不要重复同样会失败的调用。",et=0,W("检测到连续工具失败，已提示智能体换一种更可靠的方法"));const ft=D?.();ft&&j.push({role:"user",content:ft})}return K?K.onInfo?.("已达最大工具轮数，停止"):F(_.yellow("\n[已达最大工具轮数，停止]\n")),{usage:{prompt:L,completion:Q},lastPromptTokens:z}}

package/src/automation.js

@@ -0,0 +1 @@
+import t from"node:fs";import e from"node:path";import{spawn as n}from"node:child_process";import{runBash as o}from"./executors.js";const r=3e4,a=3e5;export const AUTOMATION_TOOLS=new Set(["install_packages","setup_environment","install_plugin","open_browser","open_path","open_app","auto_execute"]);export function automationActionLabel(t,e={}){switch(t){case"install_packages":return`安装 Node.js 包：${Array.isArray(e.packages)&&e.packages.length?e.packages.join(" "):"package.json 全部依赖"}${e.global?"（全局）":""}${e.dev?"（devDependencies）":""}`;case"setup_environment":return Array.isArray(e.commands)&&e.commands.length?`自动配置运行环境：执行 ${e.commands.length} 条配置命令`:"自动配置运行环境：检测项目技术栈并安装依赖";case"install_plugin":return`安装${"jetbrains"===e.target?"JetBrains 插件":"npm"===e.target?"npm 全局工具":"VS Code 扩展"}：${e.id??""}`;case"open_browser":return`打开浏览器访问：${e.url??""}`;case"open_path":return`在文件管理器中打开：${e.path??""}`;case"open_app":return`启动应用：${e.name??""}${e.target?"（"+e.target+"）":""}`;case"auto_execute":{const t=String(e.goal||"").replace(/\s+/g," ");return"自动执行已规划的任务"+(t?"："+(t.length>60?t.slice(0,60)+"…":t):"")}default:return t}}export function automationDetail(t,e={}){return"setup_environment"===t&&Array.isArray(e.commands)&&e.commands.length?e.commands.slice(0,12).map(t=>"$ "+String(t)).join("\n"):"open_browser"===t?String(e.url??""):"open_path"===t?String(e.path??""):"open_app"===t?String(e.target??""):""}export function which(n,{pathStr:o=process.env.PATH||"",platform:r=process.platform}={}){const a="win32"===r?";":":",s="win32"===r?[".cmd",".exe",".bat",""]:[""];for(const r of o.split(a))if(r)for(const o of s){const a=e.join(r,n+o);try{if(t.accessSync(a,t.constants.X_OK),t.statSync(a).isFile())return a}catch{}}return null}export function runArgv(t,e,{cwd:o,timeoutMs:a=3e5,winShell:s=!1}={}){const i="win32"===process.platform;return new Promise(c=>{let l,p="",u=!1;try{l=n(t,e,i?{cwd:o,shell:!!s}:{cwd:o,detached:!0})}catch(t){return void c({code:-1,killed:!1,output:`命令启动失败：${t.message}`})}const d=setTimeout(()=>{u=!0,(()=>{try{!i&&l.pid?process.kill(-l.pid,"SIGKILL"):l.kill("SIGKILL")}catch{try{l.kill("SIGKILL")}catch{}}})()},a),m=t=>{p.length<r&&(p+=t.toString())};l.stdout?.on("data",m),l.stderr?.on("data",m),l.on("error",t=>{clearTimeout(d),c({code:-1,killed:!1,output:`命令启动失败：${t.message}`})}),l.on("close",t=>{clearTimeout(d),c({code:t,killed:u,output:p.length>r?p.slice(0,r)+"\n…（输出已截断）":p})})})}function s(t,e){return new Promise(o=>{let r,a="";try{r=n(t,e,{stdio:["ignore","pipe","pipe"]})}catch(t){return void o({code:-1,output:`命令启动失败：${t.message}`})}const s=setTimeout(()=>{try{r.unref()}catch{}o({code:0,output:a,lingering:!0})},8e3);r.stdout.on("data",t=>a+=t),r.stderr.on("data",t=>a+=t),r.on("error",t=>{clearTimeout(s),o({code:-1,output:`命令启动失败：${t.message}`})}),r.on("close",t=>{clearTimeout(s),o({code:t,output:a})})})}function i(t){if(!t||"string"!=typeof t)throw new Error("工作目录未设置：请在项目目录中运行（VS Code / IDEA 中需先「打开文件夹」）")}function c(t,e=1200){const n=String(t||"").trim();return n.length>e?"…"+n.slice(-e):n}export function detectManager(n){try{if(t.existsSync(e.join(n,"pnpm-lock.yaml")))return"pnpm";if(t.existsSync(e.join(n,"yarn.lock")))return"yarn"}catch{}return"npm"}export function validPackageToken(t){return!("string"!=typeof t||!t.trim()||/\s/.test(t)||t.startsWith("-"))&&/^(@[a-z0-9~][\w.-]*\/)?[a-z0-9~][\w.-]*(@[\w.^~=+*:-]+)?$/i.test(t)}export function buildInstallPlan(t,e={},n=process.platform){const o=["npm","pnpm","yarn"].includes(String(e.manager||"").toLowerCase())?String(e.manager).toLowerCase():detectManager(t),r=(Array.isArray(e.packages)?e.packages:[]).map(t=>String(t).trim()).filter(Boolean);for(const t of r)if(!validPackageToken(t))throw new Error(`包名不合法（仅支持 名字[@版本]，不接受选项/空白/特殊字符）：${t}`);const a=!!e.dev,s=!!e.global;if(s&&!r.length)throw new Error("全局安装（global=true）需要明确的 packages 列表");let i;i=r.length?"yarn"===o?s?["global","add",...r]:["add",...a?["-D"]:[],...r]:"pnpm"===o?["add",...s?["-g"]:[],...a?["-D"]:[],...r]:["install",...s?["-g"]:[],...a?["--save-dev"]:[],...r]:["install"];return{manager:o,bin:o,argv:i,winShell:"win32"===n,display:`${o} ${i.join(" ")}`}}export async function installPackages(t,e){i(t);const n=buildInstallPlan(t,e||{});if(!which(n.bin))return`未找到 ${n.bin}：请先安装 Node.js（https://nodejs.org，macOS 可 brew install node）`+("npm"!==n.manager?'，或改用 manager:"npm"':"");const o=Number.isFinite(e?.timeout)?Math.min(e.timeout,6e5):a,r=await runArgv(n.bin,n.argv,{cwd:t,timeoutMs:o,winShell:n.winShell}),s=r.killed?"【超时被终止】":`退出码 ${r.code}`,l=`$ ${n.display}\n${s}`;return 0===r.code?`${l}\n已安装完成。${c(r.output,800)?"\n"+c(r.output,800):""}`:`${l}\n${c(r.output)||"（无输出）"}`}export function buildSetupSteps(n,o={},r={}){const a=r.platform||process.platform,s=r.pathStr,i=Array.isArray(o.commands)?o.commands.map(t=>String(t).trim()).filter(Boolean).slice(0,12):null;if(i&&i.length)return{mode:"commands",commands:i,detected:[]};const c=o=>{try{return t.existsSync(e.join(n,o))}catch{return!1}},l=[];c("package.json")&&l.push("node"),(c("requirements.txt")||c("pyproject.toml"))&&l.push("python"),c("go.mod")&&l.push("go"),c("Cargo.toml")&&l.push("rust"),c("pom.xml")&&l.push("maven"),(c("build.gradle")||c("build.gradle.kts"))&&l.push("gradle");const p=Array.isArray(o.stacks)&&o.stacks.length?l.filter(t=>o.stacks.includes(t)):l,u=[],d=[],m=(t,e)=>which(t,{pathStr:s,platform:a})?null:e;for(const t of p)if("node"===t){const e=detectManager(n),o=m(e,`未找到 ${e}：请先安装 Node.js（https://nodejs.org，macOS 可 brew install node）`);u.push(o?{stack:t,label:"安装 Node.js 依赖",missing:o}:{stack:t,label:`安装 Node.js 依赖（${e} install）`,bin:e,argv:["install"],winShell:!0})}else if("python"===t){const o="win32"===a?"python":"python3",r=m(o,`未找到 ${o}：macOS 可 brew install python，或从 python.org 安装`);if(r){u.push({stack:t,label:"配置 Python 环境",missing:r});continue}c(".venv")?d.push(".venv 已存在，跳过创建"):u.push({stack:t,label:"创建 Python 虚拟环境 .venv",bin:o,argv:["-m","venv",".venv"]});const s="win32"===a?".venv\\Scripts\\pip.exe":e.join(n,".venv/bin/pip");u.push(c("requirements.txt")?{stack:t,label:"安装 Python 依赖（requirements.txt）",bin:s,argv:["install","-r","requirements.txt"]}:{stack:t,label:"安装 Python 依赖（pyproject.toml）",bin:s,argv:["install","-e","."]})}else if("go"===t){const e=m("go","未找到 go：可从 https://go.dev/dl 安装（macOS 可 brew install go）");u.push(e?{stack:t,label:"下载 Go 依赖",missing:e}:{stack:t,label:"下载 Go 依赖（go mod download）",bin:"go",argv:["mod","download"]})}else if("rust"===t){const e=m("cargo","未找到 cargo：可用 rustup 安装（https://rustup.rs）");u.push(e?{stack:t,label:"拉取 Rust 依赖",missing:e}:{stack:t,label:"拉取 Rust 依赖（cargo fetch）",bin:"cargo",argv:["fetch"]})}else if("maven"===t){const e=m("mvn","未找到 mvn：macOS 可 brew install maven");u.push(e?{stack:t,label:"解析 Maven 依赖",missing:e}:{stack:t,label:"解析 Maven 依赖（mvn dependency:resolve）",bin:"mvn",argv:["-q","-DskipTests","dependency:resolve"],winShell:!0})}else"gradle"===t&&d.push("检测到 Gradle 项目：构建脚本可执行任意代码，出于安全未自动执行；可手动运行 ./gradlew build，或让我用 run_bash 执行");return{mode:"auto",detected:l,want:p,steps:u,notes:d}}export async function setupEnvironment(t,e){i(t);const n=e||{},r=buildSetupSteps(t,n),a=Number.isFinite(n.timeout)?Math.min(n.timeout,6e5):6e5;if("commands"===r.mode){const e=["环境配置（按给定命令逐条执行）："];for(const n of r.commands){const r=await o(t,{command:n,timeout:a});if(e.push(`$ ${n}\n${r}`),!/^退出码 0\b/.test(String(r))){e.push("（上一步未成功，中止后续配置命令）");break}}return e.join("\n\n")}if(!r.detected.length)return"未检测到已知技术栈（package.json / requirements.txt / pyproject.toml / go.mod / Cargo.toml / pom.xml / build.gradle）。可改用 commands 参数显式指定要执行的配置命令。";const s=[`检测到技术栈：${r.detected.join("、")}`+(r.want.length!==r.detected.length?`（本次仅处理：${r.want.join("、")||"无"}）`:"")];for(const e of r.steps){if(e.missing){s.push(`✘ ${e.label}：${e.missing}`);continue}const n=await runArgv(e.bin,e.argv,{cwd:t,timeoutMs:a,winShell:e.winShell});if(0!==n.code){s.push(`✘ ${e.label} → ${n.killed?"超时被终止":"退出码 "+n.code}${c(n.output)?"\n"+c(n.output):""}`),s.push("（该步失败，停止后续步骤；可修正后重试，或用 commands 显式指定命令）");break}s.push(`✔ ${e.label} → 退出码 0`)}for(const t of r.notes||[])s.push("· "+t);return"环境配置报告：\n"+s.join("\n")}const l=["code","code-insiders","cursor","windsurf"],p=["idea","idea64","webstorm","pycharm","goland","rider","clion"];export function buildPluginPlan(t={},e={}){const n=e.platform||process.platform,o=e.pathStr,r=String(t.id||"").trim();if(!r||r.startsWith("-")||!/^[@\w./:-]+$/.test(r))throw new Error(`插件 id 不合法：${r||"（空）"}`);const a=String(t.target||"").trim().toLowerCase();if("vscode"===a){for(const t of l)if(which(t,{pathStr:o,platform:n}))return{kind:"vscode",bin:t,argv:["--install-extension",r],winShell:!0,note:`经 ${t} CLI 安装`};throw new Error("未找到 VS Code 命令行工具（code）。请在 VS Code 命令面板执行「Shell Command: Install 'code' command in PATH」后重试，或到扩展市场手动安装 "+r)}if("jetbrains"===a){for(const t of p)if(which(t,{pathStr:o,platform:n}))return{kind:"jetbrains",bin:t,argv:["installPlugins",r],note:"安装后需重启 IDE 生效"};throw new Error("未找到 JetBrains IDE 命令行启动器（idea 等）。可在 IDE 的 Tools → Create Command-line Launcher 生成，或到 Settings → Plugins 里搜索安装 "+r)}if("npm"===a){if(!which("npm",{pathStr:o,platform:n}))throw new Error("未找到 npm：请先安装 Node.js（https://nodejs.org）");return{kind:"npm",bin:"npm",argv:["install","-g",r],winShell:!0,note:"全局 CLI 工具"}}throw new Error("target 需为 vscode | jetbrains | npm")}export async function installPlugin(t,e){const n=buildPluginPlan(e||{}),o="jetbrains"===n.kind?18e4:a,r=await runArgv(n.bin,n.argv,{cwd:t||void 0,timeoutMs:o,winShell:n.winShell}),s=`${n.bin} ${n.argv.join(" ")}`;return 0===r.code?`$ ${s}\n退出码 0\n已安装 ${e?.id}${n.note?"（"+n.note+"）":""}${c(r.output,600)?"\n"+c(r.output,600):""}`:`$ ${s}\n${r.killed?"【超时被终止】":"退出码 "+r.code}\n${c(r.output)||"（无输出）"}`}export async function openBrowser(t,e){const n=String(e?.url||"").trim();if(!/^https?:\/\/\S+$/i.test(n))throw new Error("仅支持 http/https 网址");const o=process.platform,r="darwin"===o?await s("open",[n]):"win32"===o?await s("rundll32",["url.dll,FileProtocolHandler",n]):await s("xdg-open",[n]);return 0!==r.code?`打开浏览器失败（退出码 ${r.code}）：${c(r.output)||"未知原因"}`:`已在系统默认浏览器打开：${n}`}export async function openPath(n,o){const r=String(o?.path||"").trim();if(!r)throw new Error("缺少路径 path");const a=e.resolve(n||".",r);if(!t.existsSync(a))throw new Error("路径不存在："+a);const i=t.statSync(a).isDirectory(),l=null!=o?.reveal?!!o.reveal:!i,p=process.platform;let u;return"darwin"===p?u=await s("open",l&&!i?["-R",a]:[a]):"win32"===p?(u=await s("explorer.exe",l&&!i?["/select,"+a]:[a]),u={code:0,output:u.output}):u=await s("xdg-open",[l&&!i?e.dirname(a):a]),0!==u.code?`打开文件管理器失败（退出码 ${u.code}）：${c(u.output)||"未知原因"}`:`已在文件管理器中${l&&!i?"定位":"打开"}：${a}`}export async function openApp(t,e){const o=String(e?.name||"").trim(),r=null!=e?.target?String(e.target).trim():"";if(!o)throw new Error("缺少应用名 name");if(o.length>120||/[\0-\x1f"'`$\\;|&<>{}[\]*?%]/.test(o))throw new Error("应用名含不允许的字符："+o);if(r&&/[\0-\x1f"'`$\\;|&<>]/.test(r))throw new Error("target 含不允许的字符："+r);const a=process.platform;if("darwin"===a){const t=await s("open",r?["-a",o,r]:["-a",o]);return 0!==t.code?`启动应用失败（退出码 ${t.code}）：${c(t.output)||"未找到应用 "+o}`:`已启动应用：${o}${r?"（打开 "+r+"）":""}`}if("win32"===a)return await new Promise(t=>{const e=`start "" "${o}"${r?` "${r}"`:""}`,a=n(process.env.COMSPEC||"cmd.exe",["/d","/s","/c",e],{windowsVerbatimArguments:!0});a.on("error",e=>t(`启动应用失败：${e.message}`)),a.on("close",e=>t(0===e?`已启动应用：${o}`:`启动应用失败（退出码 ${e}）`))});if(!/^[\w./+-]+$/.test(o))throw new Error("Linux 下应用名需为可执行文件名（字母数字._/+-）："+o);return await new Promise(t=>{const e=n(o,r?[r]:[],{detached:!0,stdio:"ignore"});e.once("error",e=>t(`启动应用失败：${e.message}`)),e.once("spawn",()=>{e.unref(),t(`已启动应用：${o}${r?"（打开 "+r+"）":""}`)})})}const u=(t,e)=>({type:"object",properties:t,required:e||[]}),d=t=>({type:"string",description:t}),m=t=>({type:"boolean",description:t}),g=t=>({type:"integer",description:t});export const AUTOMATION_TOOL_SPECS=[{type:"function",function:{name:"install_packages",description:"安装 Node.js 依赖包（npm/pnpm/yarn 按锁文件自动识别；执行前会征询用户同意）。省略 packages 时安装 package.json 的全部依赖。仅支持包名[@版本]，不接受额外命令行选项。",parameters:u({packages:{type:"array",items:{type:"string"},description:'要安装的包（如 ["lodash","@types/node@^20"]）；省略=安装全部依赖'},dev:m("可选：装入 devDependencies（默认否）"),global:m("可选：全局安装（需明确 packages；默认否）"),manager:d("可选：npm | pnpm | yarn（默认按锁文件自动识别）"),timeout:g("可选：超时毫秒（默认 300000，上限 600000）")},[])}},{type:"function",function:{name:"setup_environment",description:"自动配置项目运行环境（执行前会征询用户同意）：检测技术栈（Node/Python/Go/Rust/Maven）→ 检查工具链是否安装 → 安装依赖（npm install、创建 .venv 并 pip install、go mod download 等）。也可用 commands 显式指定要执行的配置命令（逐条执行，失败即停）。",parameters:u({stacks:{type:"array",items:{type:"string"},description:"可选：只处理这些技术栈（node|python|go|rust|maven）"},commands:{type:"array",items:{type:"string"},description:"可选：显式配置命令列表（优先于自动检测，最多 12 条）"},timeout:g("可选：单步超时毫秒（默认 600000）")},[])}},{type:"function",function:{name:"install_plugin",description:"安装编辑器/IDE 插件（执行前会征询用户同意）：VS Code 扩展（code --install-extension）、JetBrains 插件（idea installPlugins，装后需重启 IDE）、或 npm 全局 CLI 工具（npm install -g）。",parameters:u({target:d("vscode | jetbrains | npm"),id:d("插件标识：VS Code 扩展 id（如 dbaeumer.vscode-eslint）/ JetBrains 插件 id / npm 包名")},["target","id"])}},{type:"function",function:{name:"open_browser",description:"用系统默认浏览器打开一个 http/https 网址（执行前会征询用户同意）。适合把文档、本地预览页、报告直接呈现给用户。",parameters:u({url:d("完整网址（http/https）")},["url"])}},{type:"function",function:{name:"open_path",description:"在系统文件管理器（访达/资源管理器）中打开目录或定位文件（执行前会征询用户同意）。",parameters:u({path:d("目录或文件路径（相对项目根或绝对路径）"),reveal:m("可选：定位（选中）该文件而非打开；文件默认定位、目录默认打开")},["path"])}},{type:"function",function:{name:"open_app",description:'启动本机任意应用程序（执行前会征询用户同意），可附带要打开的文件或网址。macOS 用应用名（如 "Safari"、"Visual Studio Code"），Windows 用可启动名，Linux 用可执行文件名。',parameters:u({name:d("应用名/可执行名"),target:d("可选：让该应用打开的文件路径或 URL")},["name"])}}];export const AUTOMATION_EXECUTORS={install_packages:installPackages,setup_environment:setupEnvironment,install_plugin:installPlugin,open_browser:openBrowser,open_path:openPath,open_app:openApp};

package/src/autorun.js

@@ -0,0 +1 @@
+export function planPrompt(e){return`目标：${e}\n\n请先自动规划（不要执行任何改动）：\n1) 用只读工具（read_file/glob/grep/search_code/list_files）充分调研现状；\n2) 把达成目标的完整步骤用 todo_write 列成分步计划（涉及哪些文件、每步改动要点、如何验证、风险点）；\n3) 用一段话概述方案要点，然后停下——等待用户确认后才会开始执行。`}export function execPrompt(){return"计划已获用户确认。现在开始自动逐步执行你制定的计划：每完成一步用 todo_write 更新状态并简要自检；遇到与计划不符的情况及时调整并说明；改动后尽量运行测试/构建自检，失败要定位修复。全部完成后总结改了什么、如何验证。"}export async function runAutoFlow({goal:e,config:o,permissions:n,cwd:t,runTurnOnce:a,emit:r=()=>{}}){const l=n.isPlanMode?!!n.isPlanMode():!!o.planMode;r("自动规划中：先只读调研并产出分步计划…"),o.planMode=!0,n.setPlanMode?.(!0);try{await a(planPrompt(e))}finally{o.planMode=l,n.setPlanMode?.(l)}const p=await n.request("auto_execute",{goal:e},t,!1);return p.allow?(o.planMode=!1,n.setPlanMode?.(!1),r("已确认，开始自动执行计划…"),await a(execPrompt()),{approved:!0}):(r("已取消自动执行：计划已生成但未执行"+(p.reason?`（${p.reason}）`:"")+"。可补充要求后重新 /auto，或 /plan approve 按现有计划执行。"),{approved:!1})}

package/src/commands.js

@@ -1 +1 @@
-import n from"node:fs";import e from"node:path";import t from"node:os";import{execSync as o}from"node:child_process";import{saveConfig as i,DEFAULT_MODEL as s,CONFIG_PATH as r}from"./config.js";import{listModels as a,fetchUsage as c,streamChat as m}from"./api.js";import{listSessions as d,relTime as l,turnCount as p,saveSession as f,createSession as g}from"./session.js";import{compactNow as u,buildModelMessages as h}from"./compaction.js";import{computeInsights as w,formatInsights as y}from"./insights.js";import{setColorMode as k,setAccent as v,getAccent as $,ACCENTS as b}from"./colors.js";import{detectVerifyCommand as S}from"./autofix.js";import{loadAllowRules as j,describeRules as _,parseRule as T,addProjectRule as x,removeProjectRule as M,GLOBAL_SETTINGS_PATH as C,projectSettingsPath as I}from"./settings.js";import{contextReport as L}from"./context-report.js";import{renderDiff as N}from"./diffview.js";import{loadHooks as P,formatHooks as A}from"./hooks.js";import{copyToClipboard as D}from"./clipboard.js";import{toMarkdown as E,recapConversation as U}from"./transcript.js";import{runDoctor as R}from"./doctor.js";import{TOOL_SPECS as F}from"./tools.js";import{makeTodoTool as O}from"./todo.js";import{makeMemoryTool as B}from"./memory.js";const K=/^(agent|workflow|datahuman)-/,H="\n\n# 附加可访问目录（可用 read_file/list_files/grep 以绝对路径访问；写入仍限主目录）\n";function J(n){const e=n.messages&&n.messages[0];if(!e||"system"!==e.role||"string"!=typeof e.content)return;const t=e.content.indexOf(H);let o=t>=0?e.content.slice(0,t):e.content;const i=n.extraDirs||[];i.length&&(o+=H+i.map(n=>"- "+n).join("\n")+"\n"),e.content=o}export const INIT_PROMPT="请为当前项目生成或完善 HUICAI.md（给终端智能体看的项目说明）：先用 list_files/glob/read_file 快速调研项目（技术栈、目录结构、构建/测试/运行命令、代码约定），再用 write_file 创建或更新 HUICAI.md（若已存在则保留人工撰写的内容，增量完善）。内容包含：项目简介、关键目录、常用命令（构建/测试/运行）、代码风格与注意事项。控制在 100 行以内，用中文。";const Y=[{name:"help",desc:"显示可用命令（含自定义命令）",run(n){const e=Y.map(n=>[`/${n.name}${n.args?" "+n.args:""}`,n.desc]);for(const t of loadCustomCommands(n.cwd))e.push([`/${t.name}`,`${t.desc}（自定义）`]);e.push(["! <命令>","直接执行 shell 命令并把输出加入上下文"]),e.push(["@<文件路径>","在消息中引用文件内容（自动展开给模型）"]);const t=Math.min(24,Math.max(...e.map(([n])=>n.length))+2);n.print(e.map(([n,e])=>"  "+n.padEnd(t)+e).join("\n"))}},{name:"model",args:"[名称|auto]",desc:"查看或切换模型（auto=按账号自动选可用模型，与 VSCode 一致）",async run(n,e){if(e){if("auto"===e){try{const e=(await a(n.config.baseUrl,n.config.apiKey)).map(n=>n.id).filter(n=>!/^(agent|workflow|datahuman)-/.test(n));n.config.model=(e.includes(s)?s:e[0])||n.config.model}catch{}return i({model:"auto"}),void n.print("Auto 已选："+n.config.model)}n.config.model=e,i({model:e}),n.print("已切换模型："+e)}else n.print("当前模型："+(n.config.model||"(未设置)"))}},{name:"models",desc:"列出平台可用模型",async run(n){try{const e=await a(n.config.baseUrl,n.config.apiKey);n.print(e.map(n=>"  "+n.id).join("\n")||"(无)")}catch(e){n.print("拉取失败："+e.message)}}},{name:"usage",desc:"查看 Token 用量窗口（5小时/7天，按会员等级）",async run(n){const e=n=>"number"==typeof n&&Number.isFinite(n)?n:0,t=(n,t)=>(n=e(n),(t=e(t))<0?`${n.toLocaleString()} / 无限`:0===t?"该档未开放":`${n.toLocaleString()} / ${t.toLocaleString()} (${Math.min(100,Math.round(n/t*100))}%)`);try{const e=await c(n.config.baseUrl,n.config.apiKey);if(!e||"number"!=typeof e.used5h&&"number"!=typeof e.used7d)return void n.print("平台未返回用量数据（请确认平台已支持 /v1/usage）。");n.print(`Token 用量窗口\n  近 5 小时：${t(e.used5h,e.limit5h)}\n  近 7 天　：${t(e.used7d,e.limit7d)}`+(!e.allowed&&e.message?"\n  "+e.message:""))}catch(e){n.print("拉取用量失败："+e.message)}}},{name:"login",desc:"重新登录（浏览器授权；无浏览器请退出后 huicai login --paste）",async run(n){try{const{deviceLogin:e}=await import("./device.js");n.print("正在打开浏览器授权…");const t=await e(n.config.baseUrl);n.config.apiKey=t,i({apiKey:t}),n.print("登录成功。")}catch(e){n.print("登录未完成："+e.message+"（可退出后用 huicai login --paste 粘贴令牌）")}}},{name:"logout",desc:"退出登录（清除本机保存的令牌）",run(n){n.config.apiKey="",i({apiKey:""}),n.print("已退出登录。后续对话需重新 /login 或 huicai login。")}},{name:"clear",desc:"开启新会话（旧会话仍可 --resume 恢复）",run:()=>({action:"clear"})},{name:"compact",desc:"立即压缩上下文（摘要独立存储，不影响页面与会话原文）",async run(n){n.session.compaction||(n.session.compaction={});const e=await u(n.session.messages,n.config,{state:n.session.compaction});n.print(e>0?`已压缩：${e} 条较早消息已摘要（原对话完整保留，仅发给模型的上下文变小）`:"暂无可压缩的中段历史（会话较短或摘要失败）")}},{name:"memory",args:"[clear]",desc:"查看本项目长期记忆（clear 清空）",async run(n,e){const{loadMemory:t,clearMemory:o,memoryPath:i}=await import("./memory.js");if("clear"===e)return void n.print(o(n.cwd)?"已清空本项目长期记忆。":"本项目暂无长期记忆。");const s=t(n.cwd);n.print(s?s+`\n（文件：${i(n.cwd)} · /memory clear 清空）`:"本项目暂无长期记忆（模型会经 memory_write 自动记录值得跨会话记住的信息；配置 memory:false 可关闭）。")}},{name:"cost",desc:"查看本次运行累计 token 用量（及预算进度）",run(n){const e=n.usage.prompt+n.usage.completion,t=Number(n.config.budgetTokens)||0;n.print(`token 用量：输入 ${n.usage.prompt} / 输出 ${n.usage.completion}`+(n.session.lastPromptTokens?` · 当前上下文 ~${n.session.lastPromptTokens} tok`:"")+(t>0?`\n预算：${e.toLocaleString()} / ${t.toLocaleString()} tokens（${Math.round(e/t*100)}%）`+(e>=t?" ⚠ 已超预算":e>=.8*t?" ⚠ 接近预算":""):""))}},{name:"status",desc:"显示运行状态（版本/模型/目录/会话/MCP/权限规则）",run(n){const e=n.session,t=[...new Set((n.extraTools||[]).map(n=>n.spec?.function?.name||"").filter(n=>n.startsWith("mcp__")).map(n=>n.split("__")[1]))];let i="";try{i=o("git rev-parse --abbrev-ref HEAD",{cwd:n.cwd,stdio:["ignore","pipe","ignore"]}).toString().trim()}catch{}const s=j(n.cwd),r=[`版本      huicai ${n.version||""}`,`模型      ${n.config.model}`,`平台      ${n.config.baseUrl}`,`目录      ${n.cwd}${i?`（git:${i}）`:""}`,`会话      ${e.id} · ${p(e.messages)} 轮${e.lastPromptTokens?` · 上下文 ~${e.lastPromptTokens} tok`:""}`,`token     输入 ${n.usage.prompt} / 输出 ${n.usage.completion}`,"审批      "+(n.permissions?.isYolo?.()?"⚠ yolo 自动放行":"写/执行需授权")+` · 允许规则 ${s.length} 条${n.config.planMode?" · 📋 计划模式(只读)":""}`+`${n.config.sandbox?" · 🧪 沙箱":""}${n.config.goal?" · 🎯 目标已设":""}`,`MCP       ${t.length?t.join(", "):"(未配置)"}`];n.print(r.join("\n"))}},{name:"sessions",desc:"列出当前目录的历史会话",run(n){const e=d(n.cwd);if(!e.length)return void n.print("该目录暂无历史会话。");const t=e.slice(0,15).map(e=>{const t=e.id===n.session.id?" ← 当前":"";return`  ${l(e.updatedAt).padStart(8)}  ${e.title}  ${e.turns}轮 · ${e.id}${t}`});t.push("（退出后 huicai --resume 可选择恢复）"),n.print(t.join("\n"))}},{name:"yolo",desc:"切换「自动放行写/执行」模式",run(n){const e=!n.permissions.isYolo();n.permissions.setYolo(e),n.print("自动放行(yolo)："+(e?"开（谨慎）":"关"))}},{name:"cwd",desc:"显示当前工作目录",run(n){n.print(n.cwd)}},{name:"markdown",desc:"切换助手回复的 Markdown 渲染（TUI 富文本；关闭则显示原始文本，便于复制）",run(n){const e=!1===n.config.markdown;n.config.markdown=e,i({markdown:e}),n.print("Markdown 渲染："+(e?"开（下一条回复起生效）":"关（显示原始 Markdown 文本）"))}},{name:"init",desc:"让智能体调研项目并生成/完善 HUICAI.md",run:()=>({prompt:INIT_PROMPT})},{name:"skills",desc:"列出本地技能（Agent Skills；pull/push 用终端命令 huicai skills）",async run(n){const{loadLocalSkills:e}=await import("./skills.js"),t=e(n.cwd);t.length?n.print(t.map(n=>`  ${n.name}${n.version?" v"+n.version:""}（${"project"===n.scope?"项目":"全局"}${n.files.length?` · ${n.files.length} 附件`:""}）${n.description?" "+n.description.slice(0,60):""}`).join("\n")+"\n（模型会按描述经 load_skill 按需载入；本会话启动时已注入目录）"):n.print("暂无本地技能（.huicai/skills 或 ~/.huicai/skills）。可用 huicai skills pull 从平台拉取。")}},{name:"mcp",desc:"列出已连接的 MCP 工具",run(n){const e=(n.extraTools||[]).filter(n=>(n.spec?.function?.name||"").startsWith("mcp__"));e.length?n.print(e.map(n=>`  ${n.spec.function.name}${n.readOnly?"（只读）":""}`).join("\n")):n.print("未连接 MCP 服务。配置 ~/.huicai/mcp.json（通用 mcpServers 格式）后重启生效。")}},{name:"context",desc:"可视化当前上下文占用（各类别 token 估算）",run(n){const e=K.test(String(n.config.model||""));let t=[];if(!e)try{const e=O({state:{list:[]},emit(){}}).spec,o=!1!==n.config.memoryEnabled?B({cwd:n.cwd,emit(){}}).spec:null;t=[...F,e,...o?[o]:[],...(n.extraTools||[]).map(n=>n.spec).filter(Boolean)]}catch{t=F}n.print(L({messages:n.session.messages,compaction:n.session.compaction||{},specs:t,lastPromptTokens:n.session.lastPromptTokens||0,autoCompactTokens:Number(n.config.autoCompactTokens)||0,platform:e}))}},{name:"permissions",args:"[allow|deny <规则> | remove <规则>]",desc:"查看/增删工具权限规则（allow/deny）",run(n,e){const t=String(e||"").trim().split(/\s+/).filter(Boolean),o=(t.shift()||"").toLowerCase(),i=t.join(" ").trim();if(!o){const e=_(n.cwd),t=n=>n.length?n.map(n=>"      "+n).join("\n"):"      （无）";return void n.print("权限规则（deny 优先于 allow/yolo，对只读工具也生效）\n  全局 ~/.huicai/settings.json\n    允许:\n"+t(e.global.allow)+"\n    拒绝:\n"+t(e.global.deny)+"\n  项目 .huicai/settings.json\n    允许:\n"+t(e.project.allow)+"\n    拒绝:\n"+t(e.project.deny)+"\n  用法：/permissions allow <规则> · /permissions deny <规则> · /permissions remove <规则>\n  规则语法：`工具名` 或 `工具名(模式*)`，如 run_bash(git *)、edit_file、read_file(**/.env*)")}if("allow"!==o&&"deny"!==o){if("remove"===o||"rm"===o){if(!i)return void n.print("用法：/permissions remove <规则原文>（仅移除项目设置里的规则）");const e=M(n.cwd,i);return n.permissions?.reloadRules?.(),void n.print(e.removed?`已移除规则：${i}`:`未在项目设置中找到该规则：${i}`)}n.print("未知子命令。用法：/permissions [allow|deny|remove] <规则>")}else{if(!i||!T(i))return void n.print("规则无效。示例：run_bash(git *)、edit_file、fetch_url(https://a.com*)");try{const e=x(n.cwd,o,i);n.permissions?.reloadRules?.(),n.print(`已添加${"deny"===o?"拒绝":"允许"}规则：${i} → ${e}`)}catch(e){n.print("写入失败："+e.message)}}}},{name:"diff",desc:"查看未提交改动（git）与本会话智能体改过的文件",run(n){n.print(N(n.cwd,n.session.messages))}},{name:"pr",args:"[commit|address]",desc:"自动提交并开 PR（生成规范 commit→建分支→push→gh 开 PR）；address=按 review 评论自动改",async run(n,e){const t=String(e||"").trim().toLowerCase();if("address"===t||"comments"===t)return{prompt:"请处理当前分支/PR 的 review 评论：用 `gh pr view --comments`（无 PR 则先 `gh pr status`）读取评论，逐条理解并修改代码解决，然后 git add/commit（规范信息）+ git push；完成后逐条说明如何处理的。若未装 gh 或无 PR，先告知。"};const{runPrFlow:o}=await import("./gitflow.js");try{const e=await o({cwd:n.cwd,config:n.config,emit:e=>n.print(e),push:"commit"!==t,openPr:"commit"!==t});if(!e.ok)return void n.print("✗ "+e.error);n.print(e.pr?"✅ 已开 PR："+e.pr:"✅ 完成（分支 "+e.branch+"）"+(e.note?"："+e.note:""))}catch(e){n.print("PR 流程出错："+e.message)}}},{name:"plan",args:"[on|off|approve]",desc:"计划模式：只读调研出方案→/plan approve 批准并分步执行",run(n,e){const t=String(e||"").trim().toLowerCase();if("approve"===t||"go"===t)return n.config.planMode=!1,n.permissions?.setPlanMode?.(!1),n.print("计划已批准，开始分步执行。"),{prompt:"计划已获批准。现在请按你刚才制定的计划（todo 列表）逐步执行：每完成一步用 todo_write 更新状态并简要自检；遇到与计划不符及时调整并说明；全部完成后总结改了什么、以及如何验证（可用 /verify 让我自动跑验证）。"};const o="on"===t||"off"!==t&&!n.config.planMode;n.config.planMode=o,n.permissions?.setPlanMode?.(o),n.print(o?"计划模式：开。只做只读调研并用 todo_write 产出分步方案；写/执行会被拦截。\n  方案满意后用 /plan approve 批准并自动分步执行；或 /plan off 手动执行。":"计划模式：关。恢复正常执行（写/执行仍按权限审批）。")}},{name:"rewind",args:"[N [chat|code|both]]",desc:"检查点回滚：无参列出；/rewind N 回退对话，加 code/both 一并回滚文件",run(n,e){const t=n.checkpoints;if(!t||!t.list.length)return void n.print("暂无检查点（每个用户回合前自动记录，发生对话后可用）。");const o=String(e||"").trim().split(/\s+/).filter(Boolean);if(!o.length){const e=["检查点（回滚到某个回合之前）"];for(const n of t.list)e.push(`  #${n.id}  ${l(n.time)}  ${n.label}`+(n.journal.length?` · 改动 ${n.journal.length} 处`:""));return e.push("  用法：/rewind N（仅回退对话，安全）· /rewind N code（回滚文件）· /rewind N both"),e.push("  提示：code/both 会覆盖当前文件，建议先 /diff 查看。"),void n.print(e.join("\n"))}const i=Number(o[0]);if(!Number.isFinite(i))return void n.print("用法：/rewind N [chat|code|both]");const s=["chat","code","both"].includes(o[1])?o[1]:"chat",r=t.restore(i,s,{session:n.session,cwd:n.cwd});if(!r.ok)return void n.print(r.error);const a=[];r.conversation&&a.push("对话已回退到该回合之前"),r.filesRestored.length&&a.push(`恢复文件 ${r.filesRestored.length} 个`),r.filesDeleted.length&&a.push(`删除新建文件 ${r.filesDeleted.length} 个`),r.filesSkipped.length&&a.push(`跳过(过大) ${r.filesSkipped.length} 个`),r.filesFailed.length&&a.push(`失败 ${r.filesFailed.length} 个`);try{f(n.session)}catch{}return n.print("已回滚到 #"+i+"："+(a.join("；")||"无变化")+(r.filesFailed.length?"\n  失败："+r.filesFailed.join("；"):"")),r.conversation?{action:"refresh"}:void 0}},{name:"hooks",desc:"查看已配置的工具事件钩子（Pre/PostToolUse/UserPromptSubmit/Stop）",run(n){n.print(A(P(n.cwd)))}},{name:"copy",args:"[N]",desc:"复制助手回复到剪贴板（默认最后一条；N=倒数第 N 条）",async run(n,e){const t=n.session.messages.filter(n=>"assistant"===n.role&&"string"==typeof n.content&&n.content.trim());if(!t.length)return void n.print("还没有可复制的助手回复。");const o=Math.max(1,parseInt(e,10)||1),i=t[t.length-o];if(!i)return void n.print(`只有 ${t.length} 条助手回复。`);const s=await D(i.content);n.print(s.ok?`已复制${o>1?`倒数第 ${o} 条`:"最后一条"}回复到剪贴板（${i.content.length} 字）`:`复制失败（未找到 ${s.tool}）。以下为该回复内容：\n\n${i.content}`)}},{name:"export",args:"[文件路径]",desc:"导出当前对话为 Markdown 文件",run(t,o){const i=E(t.session),s=String(o||"").trim()||`huicai-对话-${(new Date).toISOString().slice(0,19).replace(/[:T]/g,"-")}.md`,r=e.isAbsolute(s)?s:e.join(t.cwd,s);try{n.writeFileSync(r,i,"utf8"),t.print("已导出对话到 "+r)}catch(n){t.print("导出失败："+n.message)}}},{name:"rename",args:"<新标题>",desc:"重命名当前会话",run(n,e){const t=String(e||"").trim();if(t){n.session.title=t.slice(0,80);try{f(n.session)}catch{}n.print("会话已重命名为："+n.session.title)}else n.print("当前标题："+(n.session.title||"(未命名)")+"\n  用法：/rename <新标题>")}},{name:"recap",desc:"用一句话总结当前对话进展（直连原始模型，不写入对话）",async run(n){if(n.session.messages.some(n=>"system"!==n.role))try{n.print("小结："+await U(n.session.messages,n.config))}catch(e){n.print("生成小结失败："+e.message)}else n.print("对话还没有内容。")}},{name:"distill",desc:"从当前对话提炼项目知识，写入长期记忆（供后续会话自动加载）",async run(n){if(!1===n.config.memoryEnabled)return void n.print("长期记忆已关闭（config.memory=false）。");if(!n.session.messages.some(n=>"system"!==n.role))return void n.print("对话还没有内容。");const{distillMemory:e}=await import("./transcript.js"),{loadMemory:t,appendMemory:o}=await import("./memory.js");try{const i=await e(n.session.messages,n.config,t(n.cwd));if(!i.length)return void n.print("未提炼出值得长期记住的新知识。");let s=0;for(const e of i)o(n.cwd,e)&&s++;n.print(`已写入 ${s} 条项目知识到长期记忆：\n`+i.map(n=>"  · "+n).join("\n"))}catch(e){n.print("提炼失败："+e.message)}}},{name:"doctor",desc:"本机环境体检（登录/网络/模型/git/工作目录/钩子）",async run(n){try{n.print(await R(n))}catch(e){n.print("体检失败："+e.message)}}},{name:"config",desc:"查看配置文件路径与当前生效配置（密钥脱敏）",run(n){const e=n.config,t=Number(e.autoCompactTokens);var o;n.print(["配置","  文件      "+r,"  平台      "+e.baseUrl,"  密钥      "+(o=e.apiKey,o?o.slice(0,4)+"…"+o.slice(-4)+`（${o.length}位）`:"(未设置)"),"  模型      "+e.model,"  推理强度  "+(e.reasoningEffort||"off"),"  自动压缩  "+(t<0?"关闭":t>0?t.toLocaleString()+" tokens":"默认(80k)"),"  记忆      "+(!1===e.memoryEnabled?"关":"开"),"  Markdown  "+(!1===e.markdown?"关":"开"),"  全局设置  "+C,"  项目设置  "+I(n.cwd),"  （多数项有对应斜杠命令直接改：/model /effort /autocompact /permissions …）"].join("\n"))}},{name:"effort",args:"[minimal|low|medium|high|off]",desc:"设置推理强度（reasoning_effort 透传；模型不支持则忽略）",run(n,e){const t=String(e||"").trim().toLowerCase();t?["minimal","low","medium","high","off"].includes(t)?(n.config.reasoningEffort="off"===t?"":t,i({reasoningEffort:n.config.reasoningEffort}),n.print("推理强度："+(n.config.reasoningEffort||"off")+"（下一条消息起生效；模型不支持则被忽略）")):n.print("取值：minimal | low | medium | high | off"):n.print("当前推理强度："+(n.config.reasoningEffort||"off")+"\n  用法：/effort minimal|low|medium|high|off")}},{name:"autocompact",args:"[N|off|status]",desc:"自动压缩上下文的触发阈值（token 数；off 关闭）",run(n,e){const t=String(e||"").trim().toLowerCase(),o=Number(n.config.autoCompactTokens)||0;if(!t||"status"===t)return void n.print("自动压缩："+(o<0?"已关闭":o>0?`阈值 ${o.toLocaleString()} tokens`:"默认阈值 80,000 tokens")+"\n  /autocompact <N> 设定 · /autocompact off 关闭 · /autocompact status 查看");if("off"===t)return n.config.autoCompactTokens=-1,i({autoCompactTokens:-1}),void n.print("已关闭自动压缩（仍可 /compact 手动压缩）。");const s=parseInt(t,10);!Number.isFinite(s)||s<1e3?n.print("请给 ≥1000 的 token 阈值，或 off / status。"):(n.config.autoCompactTokens=s,i({autoCompactTokens:s}),n.print("自动压缩阈值设为 "+s.toLocaleString()+" tokens（字符阈值同步联动）。"))}},{name:"review",desc:"审查当前未提交改动（找 bug 与可简化处）",run:()=>({prompt:"请审查当前工作区的未提交改动：先用 run_bash 跑 `git diff`（及 `git status`）查看改了什么，聚焦正确性 bug、边界与错误处理、可复用/可简化处、安全隐患。若本地有 code-review 技能可 load_skill 参照其方法。逐条给出：问题、定位（文件:行）、修改建议，按严重度排序；不确定的地方说明。"})},{name:"security-review",desc:"对当前改动做安全审查",run:()=>({prompt:"请对当前工作区改动做安全审查：注入（SQL/命令/路径穿越）、越权、密钥/凭据泄漏、SSRF、不安全依赖、反序列化、XSS 等。先 run_bash 跑 `git diff` 查看改动。若本地有 security-audit 技能可 load_skill 参照。给出风险点、可利用场景、影响与修复建议，按严重度排序。"})},{name:"scan",args:"[fix]",desc:"安全/质量扫描（自动选可用的 npm audit/semgrep/trivy/gitleaks 等）；fix=让智能体逐条修",async run(n,e){const{detectScanners:t,runScanners:o}=await import("./scan.js"),i=t(n.cwd);if(!i.length)return void n.print("未检测到可用扫描器。可安装 semgrep / trivy / gitleaks，或项目含 package.json（npm audit）等。");if("fix"===String(e||"").trim().toLowerCase())return{prompt:"请对本项目做安全/质量扫描并修复：依次运行并理解这些扫描器的输出——"+i.map(n=>"`"+n.command+"`（"+n.why+"）").join("、")+"；对发现的问题逐个修复（升级/更换依赖、修代码、移除硬编码密钥等），修完重跑对应扫描确认清零；最后汇总修了什么。"};n.print("运行扫描器："+i.map(n=>n.name).join(", ")+"（可能较慢）…");const s=await o(n.cwd,i);for(const e of s)n.print(`\n── ${e.name}（${0===e.code?"✅ 无高危":"⚠ 有发现"}）──`),n.print(e.output.split("\n").slice(0,20).join("\n"));n.print("\n（/scan fix 让智能体逐条修复）")}},{name:"cover",desc:"覆盖率驱动测试生成：跑覆盖率→定位未覆盖的改动→补测试→复测",run:()=>({prompt:"请做覆盖率驱动的测试补全：\n1) 跑测试覆盖率（按项目选：npm test -- --coverage / jest --coverage / pytest --cov / go test -cover / mvn test 等）；\n2) 重点看**最近改动**且覆盖率低或未覆盖的函数与分支；\n3) 为这些薄弱处补写有意义的测试（覆盖正常/边界/错误路径），遵循项目既有测试风格与框架；\n4) 重跑测试与覆盖率，确认通过且覆盖率提升；最后汇报补了哪些测试、覆盖率变化。"})},{name:"verify",args:"[验证命令]",desc:"修到通过：跑测试/构建，失败自动定位修复并重跑，直到通过或达上限",run(n,e){let t=String(e||"").trim();if(!t){if(t=S(n.cwd)||"",!t)return void n.print("未能自动探测验证命令。用法：/verify <命令>（如 /verify npm test）");n.print("自动探测到验证命令："+t)}return{action:"autofix",command:t,maxIters:Math.min(10,Math.max(1,Number(n.config.verifyMaxIters)||5))}}},{name:"simplify",desc:"审查改动的可复用/简化/抽象层级并直接清理（只清理不找 bug）",run:()=>({prompt:"请只做质量清理（不找 bug）：审查最近改动的复用（是否重复造轮子、可否复用现有工具/函数）、简化（是否有更直接的写法）、效率、以及抽象层级是否合适；把确定的改进直接用 edit_file 应用，保持与项目既有风格一致，改后跑测试/构建自检。若本地有 refactor-safely 技能可 load_skill 参照。最后说明改了什么、为什么。"})},{name:"insights",desc:"本机会话使用洞察（数量/轮数/活跃度/按项目·模型分布）",run(n){n.print(y(w(d(null),{cwd:n.cwd})))}},{name:"goal",args:"[目标 | clear]",desc:"设定目标（每轮注入，模型停止前自检是否达成；clear 清除）",run(n,e){const t=String(e||"").trim();if(t){if("clear"===t)return n.config.goal="",void n.print("已清除目标。");n.config.goal=t,n.print("已设定目标："+t+"（每轮注入，模型将在停止前自检是否达成）")}else n.print(n.config.goal?"当前目标："+n.config.goal+"\n  /goal <新目标> 修改 · /goal clear 清除":"未设定目标。用法：/goal <目标>（模型会在停止前自检是否达成）")}},{name:"btw",args:"<问题>",desc:"问一个旁支问题（带当前上下文，但不写入对话、不调用工具）",async run(n,e){const t=String(e||"").trim();if(!t)return void n.print("用法：/btw <问题>（快速旁支问答，不影响主对话）");const o=K.test(String(n.config.model||""))?n.config.compactModel||s:n.config.model;try{const e=h(n.session.messages,n.session.compaction||{}),i=await m({baseUrl:n.config.baseUrl,apiKey:n.config.apiKey,model:o,messages:[...e,{role:"user",content:"（这是一个旁支问题，请结合上文直接简答，不要调用工具、不要展开无关内容）\n"+t}]});n.print("↪ "+(i.content||"(无回复)").trim())}catch(e){n.print("旁支问答失败："+e.message)}}},{name:"ide",desc:"查看 IDE 集成状态（编辑器上下文与内联审阅）",run(n){const e=!!process.env.HUICAI_IDE_PORT,t=process.env.HUICAI_IDE_FILE,o=process.env.HUICAI_IDE_SELECTION,i=process.env.HUICAI_IDE_DIAGNOSTICS,s=["IDE 集成"];s.push("  内联审阅  "+(e?"已连接（write/edit 交编辑器做 diff 审阅）":"未连接（CLI 直接写盘）")),s.push("  客户端    "+(n.config.client||"cli")),s.push("  当前文件  "+(t||"(无)")),s.push("  选区      "+(o?o.length+" 字":"(无)")),s.push("  诊断      "+(i?"有（来自 Problems 面板）":"(无)")),e||s.push("  （在 VS Code/IDEA 的 huicai 面板或其启动的终端里运行可启用内联审阅与编辑器上下文）"),n.print(s.join("\n"))}},{name:"branch",args:"[标题]",desc:"把当前对话另存为一个可 --resume 的分支副本（当前会话继续）",run(n,e){const t=n.session;if(!t.messages.some(n=>"system"!==n.role))return void n.print("当前对话为空，无需分支。");const o=g({cwd:n.cwd,model:t.model,messages:t.messages.map(n=>({...n}))});try{o.compaction=JSON.parse(JSON.stringify(t.compaction||{}))}catch{o.compaction={}}o.title=(String(e||"").trim()||t.title||"对话").slice(0,70)+"（分支）",o.lastPromptTokens=t.lastPromptTokens||0;try{f(o),f(t)}catch{}n.print(`已保存分支副本「${o.title}」（${o.id}）。\n  当前会话继续；分支可用 huicai --resume 恢复到此刻状态。`)}},{name:"theme",args:"[default|mono]",desc:"输出主题：default 彩色 / mono 无色",run(n,e){const t=String(e||"").trim().toLowerCase();t?["default","mono"].includes(t)?(n.config.theme=t,k(t),i({theme:t}),n.print("主题："+t+("mono"===t?"（已关闭颜色）":"（彩色）"))):n.print("取值：default | mono"):n.print("当前主题："+(n.config.theme||"default")+"\n  /theme default | mono（终端配色由终端掌控；mono=关闭颜色，便于复制/管道）")}},{name:"color",args:"["+b.join("|")+"]",desc:"设置强调色（提示符/高亮）",run(n,e){const t=String(e||"").trim().toLowerCase();t?v(t)?(n.config.accentColor=t,i({accentColor:t}),n.print("强调色："+t)):n.print("可选："+b.join(" / ")):n.print("当前强调色："+$()+"\n  可选："+b.join(" / "))}},{name:"tui",args:"[auto|rich|plain]",desc:"交互渲染器偏好（下次启动生效）",run(n,e){const t=String(e||"").trim().toLowerCase();t?["auto","rich","plain"].includes(t)?(n.config.tui=t,i({tui:t}),n.print("渲染器偏好："+t+"（下次启动生效）")):n.print("取值：auto | rich | plain"):n.print("当前渲染器偏好："+(n.config.tui||"auto")+"\n  auto（TTY 下富 TUI）| rich | plain（下次启动生效；本次可加 --tui/--plain 覆盖）")}},{name:"advisor",args:"[模型id|off]",desc:"设置顾问模型（更强模型）：智能体遇难题可 ask_advisor 咨询第二意见",async run(n,e){const t=String(e||"").trim();if(!t)return void n.print(n.config.advisorModel?"当前顾问模型："+n.config.advisorModel+"（智能体可用 ask_advisor 咨询）":"未设置顾问模型。用法：/advisor <模型id>（设一个更强的模型；/models 看可用）· /advisor off 关闭");const o="off"===t?"":t;if(n.config.advisorModel=o,i({advisorModel:o}),Array.isArray(n.extraTools)){const e=n.extraTools.findIndex(n=>"ask_advisor"===n.spec?.function?.name);if(e>=0&&n.extraTools.splice(e,1),o){const{makeAdvisorTool:e}=await import("./advisor.js"),t=e({config:n.config});t&&n.extraTools.push(t)}}n.print(o?"顾问模型已设为 "+o+"（ask_advisor 工具已可用）":"已关闭顾问模型。")}},{name:"automodel",args:"[强模型id|off]",desc:"按任务自动选模型：复杂回合自动升配到该强模型，其余用当前模型",run(n,e){const t=String(e||"").trim();if(!t)return void n.print(n.config.autoModelStrong?"自动升配：开（复杂回合→"+n.config.autoModelStrong+"，其余→"+n.config.model+"）":"未开启。用法：/automodel <强模型id>（复杂回合自动用它；简单回合仍用当前便宜模型）· /models 看可用");const o="off"===t.toLowerCase()?"":t;n.config.autoModelStrong=o,i({autoModelStrong:o}),n.print(o?"按任务自动选模型：开（复杂回合→"+o+"，其余→"+n.config.model+"）":"已关闭自动升配。")}},{name:"embed",args:"[嵌入模型id|off]",desc:"search_code 向量语义重排：设一个嵌入模型走 /v1/embeddings 重排（空/off=纯 BM25）",run(n,e){const t=String(e||"").trim();if(!t)return void n.print(n.config.embeddingModel?"search_code 向量重排：开（嵌入模型 "+n.config.embeddingModel+"）":"未启用向量重排（纯 BM25，离线可用）。用法：/embed <嵌入模型id>（需平台有该嵌入模型）· /embed off");const o="off"===t.toLowerCase()?"":t;n.config.embeddingModel=o,i({embeddingModel:o}),n.print(o?"search_code 向量语义重排：开（嵌入模型 "+o+"；下次检索生效，BM25 召回后按向量相似度重排）":"已关闭向量重排（回到纯 BM25）。")}},{name:"budget",args:"[token数|off|status]",desc:"设置本项目 token 预算（软提醒；/cost 看进度）",run(n,e){const t=String(e||"").trim().toLowerCase(),o=(n.usage?.prompt||0)+(n.usage?.completion||0);if(!t||"status"===t){const e=Number(n.config.budgetTokens)||0;return void n.print(e>0?`token 预算：${o.toLocaleString()} / ${e.toLocaleString()}（${Math.round(o/e*100)}%）`:`未设预算（本次已用 ${o.toLocaleString()} tokens）。/budget <token数> 设定`)}if("off"===t)return n.config.budgetTokens=0,i({budgetTokens:0}),void n.print("已取消预算。");const s=parseInt(t,10);!Number.isFinite(s)||s<1e3?n.print("请给 ≥1000 的 token 数，或 off / status。"):(n.config.budgetTokens=s,i({budgetTokens:s}),n.print("token 预算设为 "+s.toLocaleString()+"（软提醒；/cost 显示进度）。"))}},{name:"debug",args:"[on|off]",desc:"调试输出（每轮打印模型/耗时/token）",run(n,e){const t=String(e||"").trim().toLowerCase(),o="on"===t||"off"!==t&&!n.config.debug;n.config.debug=o,i({debug:o}),n.print("调试输出："+(o?"开（下一条消息起每轮打印 [debug] 行）":"关"))}},{name:"sandbox",args:"[on|off]",desc:"沙箱模式：禁 shell 与联网（仍可读写本地文件）",run(n,e){const t=String(e||"").trim().toLowerCase(),o="on"===t||"off"!==t&&!n.config.sandbox;n.config.sandbox=o,n.permissions?.setSandbox?.(o),n.print(o?"沙箱模式：开。run_bash 与 fetch_url 将被拒绝；本地文件读写照常。":"沙箱模式：关（写/执行仍按权限审批）。")}},{name:"reload-skills",desc:"从磁盘重新加载技能（新增/改名技能生效；改正文已实时生效）",async run(n){const{makeSkillTools:e,loadLocalSkills:t}=await import("./skills.js");if(Array.isArray(n.extraTools)){for(let e=n.extraTools.length-1;e>=0;e--){const t=n.extraTools[e]?.spec?.function?.name;"load_skill"!==t&&"read_skill_file"!==t||n.extraTools.splice(e,1)}n.extraTools.push(...e(n.cwd))}const o=t(n.cwd);n.print(o.length?`已重载 ${o.length} 个技能：${o.map(n=>n.name).join(", ")}\n  （load_skill 现可载入其中任意一个；系统提示词内的技能目录将在下次新会话刷新）`:"未发现本地技能（.huicai/skills 或 ~/.huicai/skills）。")}},{name:"add-dir",args:"[目录 | list | remove <目录>]",desc:"添加可读/搜索的附加目录（写入仍限主目录）",run(t,o){const i=t.session;Array.isArray(i.extraDirs)||(i.extraDirs=[]);const s=String(o||"").trim().split(/\s+/).filter(Boolean),r=(s[0]||"").toLowerCase();if(!o||"list"===r)return void t.print(i.extraDirs.length?"附加目录：\n"+i.extraDirs.map(n=>"  "+n).join("\n")+"\n  /add-dir <目录> 添加 · /add-dir remove <目录> 移除":"暂无附加目录。用法：/add-dir <目录>（可读/搜索，写仍限主目录）");if("remove"===r||"rm"===r){const n=e.resolve(t.cwd,s.slice(1).join(" ")),o=i.extraDirs.length;i.extraDirs=i.extraDirs.filter(e=>e!==n),J(i);try{f(i)}catch{}return void t.print(i.extraDirs.length<o?"已移除："+n:"未找到该附加目录："+n)}const a=e.resolve(t.cwd,String(o).trim());let c=!1;try{c=n.statSync(a).isDirectory()}catch{}if(c)if(a!==t.cwd){i.extraDirs.includes(a)||i.extraDirs.push(a),J(i);try{f(i)}catch{}t.print("已添加可访问目录："+a+"\n  （模型可用 read_file/list_files/grep 以绝对路径访问；写入仍限主目录）")}else t.print("这已是主工作目录。");else t.print("目录不存在："+a)}},{name:"agents",desc:"列出可用子智能体人格（.huicai/agents/*.md；dispatch_agent 可指定）",async run(n){const{loadAgents:e}=await import("./subagent.js"),t=e(n.cwd);n.print(t.length?"子智能体人格（dispatch_agent 的 agent 参数可指定）：\n"+t.map(n=>`  ${n.name}${n.description?" — "+n.description.replace(/\s+/g," ").slice(0,60):""}`).join("\n"):"未定义子智能体人格。\n  在 .huicai/agents/<名字>.md 写 frontmatter(name/description)+正文(人格提示词)即可；\n  dispatch_agent 默认用通用只读子智能体（无需定义也能用）。")}},{name:"orchestrate",args:"<目标>",desc:"把一个目标自动分解为并行子任务、多智能体协作完成",run(n,e){const t=String(e||"").trim();if(t)return{prompt:`目标：${t}\n\n请作为编排者按以下方式完成：\n1) 先把目标分解为若干**独立、可并行**的子任务（研究/检索/分析/定位）；\n2) 用 dispatch_agents 一次性并行委派这些子任务（每个自足，可指定合适的子智能体人格）；\n3) 汇总各子智能体的结论，形成整体方案或结果；\n4) 若需落地改动，再据此逐步执行并自检（可用 /verify 让我自动跑验证）。\n优先用 dispatch_agents 并行，减少串行等待。`};n.print("用法：/orchestrate <较大的目标>（我会分解为并行子任务，用 dispatch_agents 并行推进后综合）")}},{name:"batch",args:"<大改动目标>",desc:"把一个大改动拆成独立子任务，在隔离 git worktree 中并行推进",run(n,e){const t=String(e||"").trim();if(t)return{prompt:`目标（需拆分并行落地）：${t}\n\n请这样做：\n1) 先把目标拆成若干**相互独立、可并行**的改动子任务（尽量互不冲突的文件/模块）；\n2) 对每个子任务，用 \`git worktree add -b huicai-batch/<名> <路径>\` 建隔离工作区，在其中完成该子任务的改动并 commit（不影响主工作区）；\n3) 全部完成后，汇总每个 worktree 的分支与改动；需要时可对每个分支执行 \`huicai pr\` 开 PR。\n（并行调研可用 dispatch_agents；改动务必隔离在各自 worktree，避免互相踩踏。完成后可 \`git worktree remove\` 清理。）`};n.print("用法：/batch <一个可拆分的大改动目标>（拆成互不冲突的子任务，各在隔离 worktree 中落地）")}},{name:"fork",args:"<后台任务提示词>",desc:"派生后台智能体（继承当前对话副本，--yolo 自动放行，输出写日志）",async run(n,e){const t=String(e||"").trim();if(!t)return void n.print("用法：/fork <让后台智能体做什么>（以当前对话副本为上下文，后台运行，--yolo 自动放行）");const o=g({cwd:n.cwd,model:n.session.model,messages:n.session.messages.map(n=>({...n}))});try{o.compaction=JSON.parse(JSON.stringify(n.session.compaction||{}))}catch{o.compaction={}}o.title="(fork) "+(n.session.title||"");try{f(o)}catch{}const{forkAgent:i}=await import("./forks.js");let s;try{s=i({prompt:t,cwd:n.cwd,sessionId:o.id})}catch(e){return void n.print("无法派生后台任务："+e.message)}n.print(`已派生后台智能体 pid ${s.pid}（--yolo 自动放行）\n  上下文：当前对话副本 ${o.id}\n  日志：${s.log}\n  /tasks 查看 · /tasks kill ${s.pid} 终止`)}},{name:"tasks",args:"[kill <pid>]",desc:"查看/终止本会话派生的后台任务（/fork）",async run(n,e){const{listForks:t,killFork:o}=await import("./forks.js"),i=String(e||"").trim().split(/\s+/).filter(Boolean);if("kill"===i[0]){const e=Number(i[1]);if(!Number.isFinite(e))return void n.print("用法：/tasks kill <pid>");const t=o(e);return void n.print(t.ok?"已终止 pid "+e:"终止失败："+(t.reason||""))}const s=t();s.length?n.print("后台任务：\n"+s.map(n=>`  pid ${n.pid} · ${n.alive?"运行中":"已结束"} · ${l(n.started)} · ${n.prompt}\n     日志 ${n.log}`).join("\n")+"\n  /tasks kill <pid> 终止"):n.print("本会话暂无后台任务（/fork <提示词> 派生）。")}},{name:"schedule",args:'[list | add "<cron>" "<提示词>" | remove <id>]',desc:"管理定时任务（生成 crontab 行交系统 cron 运行）",async run(n,e){const t=await import("./schedule.js"),o=String(e||"").trim(),i="huicai";if(!o||"list"===o){const e=t.listTasks();return e.length?void n.print("定时任务：\n"+e.map(n=>`  #${n.id}  ${n.cron}  ${n.prompt.replace(/\s+/g," ").slice(0,40)}\n     crontab: ${t.crontabLine(n,i)}`).join("\n")+"\n  /schedule remove <id> 删除"):void n.print('暂无定时任务。\n  添加：/schedule add "*/30 * * * *" "跑测试并把结果写入 report.md"\n  （随后把打印的 crontab 行加入 crontab -e）')}if(/^add\b/.test(o)){const e=o.match(/"([^"]*)"/g);if(!e||e.length<2)return void n.print('用法：/schedule add "<cron>" "<提示词>"（cron 与提示词都要加引号）');const s=e[0].slice(1,-1).trim(),r=e[1].slice(1,-1).trim();if(5!==s.split(/\s+/).length)return void n.print('cron 需 5 个字段，如 "*/30 * * * *"（分 时 日 月 周）');const{id:a}=t.addTask({cron:s,prompt:r,cwd:n.cwd});return void n.print("已添加定时任务 #"+a+"\n  加入 crontab（crontab -e）：\n  "+t.crontabLine({id:a,cron:s,prompt:r,cwd:n.cwd},i))}if(/^(remove|rm)\b/.test(o)){const e=o.split(/\s+/)[1];return void n.print(t.removeTask(e)?"已删除定时任务 "+e:"未找到定时任务 "+e)}n.print('用法：/schedule list · /schedule add "<cron>" "<提示词>" · /schedule remove <id>')}},{name:"cd",args:"<目录>",desc:"切换工作目录（在新目录开启新会话；IDE 中请用「打开文件夹」）",run(t,o){const i=String(o||"").trim();if(!i)return void t.print("当前工作目录："+t.cwd+"\n  用法：/cd <目录>（将在新目录开启新会话，旧会话已保存）");const s=e.resolve(t.cwd,i);let r=!1;try{r=n.statSync(s).isDirectory()}catch{}if(r){if(s!==t.cwd)return{action:"cd",cwd:s};t.print("已在该目录。")}else t.print("目录不存在："+s)}},{name:"loop",args:"<秒> <提示词> | off",desc:"每隔 N 秒自动重跑一个提示词（off 停止）",run(n,e){const t=String(e||"").trim();if(!t)return void n.print("用法：/loop <秒> <提示词>（如 /loop 300 检查构建是否通过）· /loop off 停止");if("off"===t)return{action:"loop",stop:!0};const o=/^(\d+)\s+([\s\S]+)$/.exec(t);if(o)return{action:"loop",seconds:Math.max(10,parseInt(o[1],10)),prompt:o[2].trim()};n.print("用法：/loop <秒> <提示词> · /loop off")}},{name:"statusline",args:"<shell命令> | off",desc:"自定义 TUI 底栏（运行该命令，展示其 stdout）",run(n,e){const t=String(e||"").trim();if(!t)return void n.print("当前状态栏命令："+(n.config.statusLine||"(默认)")+"\n  /statusline <shell命令>（stdout 显示在 TUI 底栏）· /statusline off 恢复默认");const o="off"===t?"":t;n.config.statusLine=o,i({statusLine:o}),n.print(o?"状态栏命令已设置（TUI 底栏生效）："+o:"已恢复默认状态栏。")}},{name:"background",desc:"保存当前会话并给出在别处继续/后台运行的方式",run(n){try{f(n.session)}catch{}n.print(`会话已保存（${n.session.id}）。\n  · 在别处继续：huicai resume ${n.session.id}\n  · 后台跑一个任务：/fork <提示词>（派生后台智能体，日志可查）\n  · 定时运行：/schedule add "<cron>" "<提示词>"`)}},{name:"exit",desc:"退出",run:()=>({action:"exit"})}];export function listCommands(n){return[...Y.map(n=>({name:n.name,args:n.args||"",desc:n.desc})),...loadCustomCommands(n).map(n=>({name:n.name,args:"",desc:n.desc}))]}export function loadCustomCommands(o){const i=[o?e.join(o,".huicai","commands"):null,e.join(t.homedir(),".huicai","commands")].filter(Boolean),s=new Map;for(const t of i){let o;try{o=n.readdirSync(t).filter(n=>n.endsWith(".md"))}catch{continue}for(const i of o){const o=i.replace(/\.md$/,"").trim();if(o&&!s.has(o)&&!Y.some(n=>n.name===o))try{const r=n.readFileSync(e.join(t,i),"utf8"),{desc:a,body:c}=G(r);s.set(o,{name:o,desc:a||"自定义命令",template:c})}catch{}}}return[...s.values()]}function G(n){const e=/^---\n([\s\S]*?)\n---\n?/.exec(n);if(!e)return{desc:"",body:n.trim()};const t=e[1],o=/^description:\s*(.+)$/m.exec(t);return{desc:o?o[1].trim():"",body:n.slice(e[0].length).trim()}}export async function runSlash(n,e){const t=n.slice(1).split(/\s+/),o=(t[0]||"").trim(),i=t.slice(1).join(" ").trim();if("quit"===o)return{handled:!0,action:"exit"};const s=Y.find(n=>n.name===o);if(s){return{handled:!0,...await s.run(e,i)||{}}}const r=loadCustomCommands(e.cwd).find(n=>n.name===o);if(r){let n=r.template;return n.includes("$ARGUMENTS")?n=n.replaceAll("$ARGUMENTS",i):i&&(n=n+"\n\n"+i),{handled:!0,prompt:n}}return e.print("未知命令。/help 查看可用命令。"),{handled:!0}}
+import n from"node:fs";import e from"node:path";import t from"node:os";import{execSync as o}from"node:child_process";import{saveConfig as i,DEFAULT_MODEL as s,CONFIG_PATH as r}from"./config.js";import{listModels as a,fetchUsage as c,streamChat as d}from"./api.js";import{listSessions as m,relTime as l,turnCount as p,saveSession as f,createSession as u}from"./session.js";import{compactNow as g,buildModelMessages as h}from"./compaction.js";import{computeInsights as w,formatInsights as y}from"./insights.js";import{setColorMode as $,setAccent as k,getAccent as v,ACCENTS as b}from"./colors.js";import{detectVerifyCommand as S}from"./autofix.js";import{loadAllowRules as j,describeRules as x,parseRule as T,addProjectRule as _,removeProjectRule as M,GLOBAL_SETTINGS_PATH as C,projectSettingsPath as I}from"./settings.js";import{contextReport as L}from"./context-report.js";import{renderDiff as N}from"./diffview.js";import{loadHooks as P,formatHooks as A}from"./hooks.js";import{copyToClipboard as E}from"./clipboard.js";import{toMarkdown as D,recapConversation as U}from"./transcript.js";import{runDoctor as q}from"./doctor.js";import{TOOL_SPECS as F}from"./tools.js";import{makeTodoTool as R}from"./todo.js";import{makeMemoryTool as O}from"./memory.js";const K=/^(agent|workflow|datahuman|squad)-/,B="\n\n# 附加可访问目录（可用 read_file/list_files/grep 以绝对路径访问；写入仍限主目录）\n";function H(n){const e=n.messages&&n.messages[0];if(!e||"system"!==e.role||"string"!=typeof e.content)return;const t=e.content.indexOf(B);let o=t>=0?e.content.slice(0,t):e.content;const i=n.extraDirs||[];i.length&&(o+=B+i.map(n=>"- "+n).join("\n")+"\n"),e.content=o}export const INIT_PROMPT="请为当前项目生成或完善 HUICAI.md（给终端智能体看的项目说明）：先用 list_files/glob/read_file 快速调研项目（技术栈、目录结构、构建/测试/运行命令、代码约定），再用 write_file 创建或更新 HUICAI.md（若已存在则保留人工撰写的内容，增量完善）。内容包含：项目简介、关键目录、常用命令（构建/测试/运行）、代码风格与注意事项。控制在 100 行以内，用中文。";const J=[{name:"help",desc:"显示可用命令（含自定义命令）",run(n){const e=J.map(n=>[`/${n.name}${n.args?" "+n.args:""}`,n.desc]);for(const t of loadCustomCommands(n.cwd))e.push([`/${t.name}`,`${t.desc}（自定义）`]);e.push(["! <命令>","直接执行 shell 命令并把输出加入上下文"]),e.push(["@<文件路径>","在消息中引用文件内容（自动展开给模型）"]);const t=Math.min(24,Math.max(...e.map(([n])=>n.length))+2);n.print(e.map(([n,e])=>"  "+n.padEnd(t)+e).join("\n"))}},{name:"model",args:"[名称|auto]",desc:"查看或切换模型（auto=按账号自动选可用模型，与 VSCode 一致）",async run(n,e){if(e){if("auto"===e){try{const e=(await a(n.config.baseUrl,n.config.apiKey)).map(n=>n.id).filter(n=>!/^(agent|workflow|datahuman|squad)-/.test(n));n.config.model=(e.includes(s)?s:e[0])||n.config.model}catch{}return i({model:"auto"}),void n.print("Auto 已选："+n.config.model)}try{const t=(await a(n.config.baseUrl,n.config.apiKey)).map(n=>n.id);if(!t.includes(e))return void n.print(`当前账号无权使用模型「${e}」。\n  可用模型：${t.slice(0,12).join(", ")}`+(t.length>12?` …（共 ${t.length} 个，/models 查看全部）`:"")+"\n  或用 /model auto 自动选择可用模型。")}catch(e){n.print(`（未能校验模型可用性：${e.message}）仍按输入切换；若无权限，平台会在调用时拒绝。`)}n.config.model=e,i({model:e}),n.print("已切换模型："+e)}else n.print("当前模型："+(n.config.model||"(未设置)"))}},{name:"models",desc:"列出平台可用模型",async run(n){try{const e=await a(n.config.baseUrl,n.config.apiKey);n.print(e.map(n=>"  "+n.id).join("\n")||"(无)")}catch(e){n.print("拉取失败："+e.message)}}},{name:"usage",desc:"查看 Token 用量窗口（5小时/7天，按会员等级）",async run(n){const e=n=>"number"==typeof n&&Number.isFinite(n)?n:0,t=(n,t)=>(n=e(n),(t=e(t))<0?`${n.toLocaleString()} / 无限`:0===t?"该档未开放":`${n.toLocaleString()} / ${t.toLocaleString()} (${Math.min(100,Math.round(n/t*100))}%)`);try{const e=await c(n.config.baseUrl,n.config.apiKey);if(!e||"number"!=typeof e.used5h&&"number"!=typeof e.used7d)return void n.print("平台未返回用量数据（请确认平台已支持 /v1/usage）。");n.print(`Token 用量窗口\n  近 5 小时：${t(e.used5h,e.limit5h)}\n  近 7 天　：${t(e.used7d,e.limit7d)}`+(!e.allowed&&e.message?"\n  "+e.message:""))}catch(e){n.print("拉取用量失败："+e.message)}}},{name:"login",desc:"重新登录（浏览器授权；无浏览器请退出后 huicai login --paste）",async run(n){try{const{deviceLogin:e}=await import("./device.js");n.print("正在打开浏览器授权…");const t=await e(n.config.baseUrl);n.config.apiKey=t,i({apiKey:t}),n.print("登录成功。")}catch(e){n.print("登录未完成："+e.message+"（可退出后用 huicai login --paste 粘贴令牌）")}}},{name:"logout",desc:"退出登录（清除本机保存的令牌）",run(n){n.config.apiKey="",i({apiKey:""}),n.print("已退出登录。后续对话需重新 /login 或 huicai login。")}},{name:"clear",desc:"开启新会话（旧会话仍可 --resume 恢复）",run:()=>({action:"clear"})},{name:"compact",desc:"立即压缩上下文（摘要独立存储，不影响页面与会话原文）",async run(n){n.session.compaction||(n.session.compaction={});const e=await g(n.session.messages,n.config,{state:n.session.compaction});n.print(e>0?`已压缩：${e} 条较早消息已摘要（原对话完整保留，仅发给模型的上下文变小）`:"暂无可压缩的中段历史（会话较短或摘要失败）")}},{name:"memory",args:"[clear]",desc:"查看本项目长期记忆（clear 清空）",async run(n,e){const{loadMemory:t,clearMemory:o,memoryPath:i}=await import("./memory.js");if("clear"===e)return void n.print(o(n.cwd)?"已清空本项目长期记忆。":"本项目暂无长期记忆。");const s=t(n.cwd);n.print(s?s+`\n（文件：${i(n.cwd)} · /memory clear 清空）`:"本项目暂无长期记忆（模型会经 memory_write 自动记录值得跨会话记住的信息；配置 memory:false 可关闭）。")}},{name:"cost",desc:"查看本次运行累计 token 用量（及预算进度）",run(n){const e=n.usage.prompt+n.usage.completion,t=Number(n.config.budgetTokens)||0;n.print(`token 用量：输入 ${n.usage.prompt} / 输出 ${n.usage.completion}`+(n.session.lastPromptTokens?` · 当前上下文 ~${n.session.lastPromptTokens} tok`:"")+(t>0?`\n预算：${e.toLocaleString()} / ${t.toLocaleString()} tokens（${Math.round(e/t*100)}%）`+(e>=t?" ⚠ 已超预算":e>=.8*t?" ⚠ 接近预算":""):""))}},{name:"status",desc:"显示运行状态（版本/模型/目录/会话/MCP/权限规则）",run(n){const e=n.session,t=[...new Set((n.extraTools||[]).map(n=>n.spec?.function?.name||"").filter(n=>n.startsWith("mcp__")).map(n=>n.split("__")[1]))];let i="";try{i=o("git rev-parse --abbrev-ref HEAD",{cwd:n.cwd,stdio:["ignore","pipe","ignore"]}).toString().trim()}catch{}const s=j(n.cwd),r=[`版本      huicai ${n.version||""}`,`模型      ${n.config.model}`,`平台      ${n.config.baseUrl}`,`目录      ${n.cwd}${i?`（git:${i}）`:""}`,`会话      ${e.id} · ${p(e.messages)} 轮${e.lastPromptTokens?` · 上下文 ~${e.lastPromptTokens} tok`:""}`,`token     输入 ${n.usage.prompt} / 输出 ${n.usage.completion}`,"审批      "+(n.permissions?.isYolo?.()?"⚠ yolo 自动放行":"写/执行需授权")+` · 允许规则 ${s.length} 条${n.config.planMode?" · 📋 计划模式(只读)":""}`+`${n.config.sandbox?" · 🧪 沙箱":""}${n.config.goal?" · 🎯 目标已设":""}`,`MCP       ${t.length?t.join(", "):"(未配置)"}`];n.print(r.join("\n"))}},{name:"sessions",desc:"列出当前目录的历史会话",run(n){const e=m(n.cwd);if(!e.length)return void n.print("该目录暂无历史会话。");const t=e.slice(0,15).map(e=>{const t=e.id===n.session.id?" ← 当前":"";return`  ${l(e.updatedAt).padStart(8)}  ${e.title}  ${e.turns}轮 · ${e.id}${t}`});t.push("（退出后 huicai --resume 可选择恢复）"),n.print(t.join("\n"))}},{name:"yolo",desc:"切换「自动放行写/执行」模式",run(n){const e=!n.permissions.isYolo();n.permissions.setYolo(e),n.print("自动放行(yolo)："+(e?"开（谨慎）":"关"))}},{name:"cwd",desc:"显示当前工作目录",run(n){n.print(n.cwd)}},{name:"markdown",desc:"切换助手回复的 Markdown 渲染（TUI 富文本；关闭则显示原始文本，便于复制）",run(n){const e=!1===n.config.markdown;n.config.markdown=e,i({markdown:e}),n.print("Markdown 渲染："+(e?"开（下一条回复起生效）":"关（显示原始 Markdown 文本）"))}},{name:"init",desc:"让智能体调研项目并生成/完善 HUICAI.md",run:()=>({prompt:INIT_PROMPT})},{name:"skills",desc:"列出本地技能（Agent Skills；pull/push 用终端命令 huicai skills）",async run(n){const{loadLocalSkills:e}=await import("./skills.js"),t=e(n.cwd);t.length?n.print(t.map(n=>`  ${n.name}${n.version?" v"+n.version:""}（${"project"===n.scope?"项目":"全局"}${n.files.length?` · ${n.files.length} 附件`:""}）${n.description?" "+n.description.slice(0,60):""}`).join("\n")+"\n（模型会按描述经 load_skill 按需载入；本会话启动时已注入目录）"):n.print("暂无本地技能（.huicai/skills 或 ~/.huicai/skills）。可用 huicai skills pull 从平台拉取。")}},{name:"mcp",desc:"列出已连接的 MCP 工具",run(n){const e=(n.extraTools||[]).filter(n=>(n.spec?.function?.name||"").startsWith("mcp__"));e.length?n.print(e.map(n=>`  ${n.spec.function.name}${n.readOnly?"（只读）":""}`).join("\n")):n.print("未连接 MCP 服务。配置 ~/.huicai/mcp.json（通用 mcpServers 格式）后重启生效。")}},{name:"context",desc:"可视化当前上下文占用（各类别 token 估算）",run(n){const e=K.test(String(n.config.model||""));let t=[];if(!e)try{const e=R({state:{list:[]},emit(){}}).spec,o=!1!==n.config.memoryEnabled?O({cwd:n.cwd,emit(){}}).spec:null;t=[...F,e,...o?[o]:[],...(n.extraTools||[]).map(n=>n.spec).filter(Boolean)]}catch{t=F}n.print(L({messages:n.session.messages,compaction:n.session.compaction||{},specs:t,lastPromptTokens:n.session.lastPromptTokens||0,autoCompactTokens:Number(n.config.autoCompactTokens)||0,platform:e}))}},{name:"permissions",args:"[allow|deny <规则> | remove <规则>]",desc:"查看/增删工具权限规则（allow/deny）",run(n,e){const t=String(e||"").trim().split(/\s+/).filter(Boolean),o=(t.shift()||"").toLowerCase(),i=t.join(" ").trim();if(!o){const e=x(n.cwd),t=n=>n.length?n.map(n=>"      "+n).join("\n"):"      （无）";return void n.print("权限规则（deny 优先于 allow/yolo，对只读工具也生效）\n  全局 ~/.huicai/settings.json\n    允许:\n"+t(e.global.allow)+"\n    拒绝:\n"+t(e.global.deny)+"\n  项目 .huicai/settings.json\n    允许:\n"+t(e.project.allow)+"\n    拒绝:\n"+t(e.project.deny)+"\n  用法：/permissions allow <规则> · /permissions deny <规则> · /permissions remove <规则>\n  规则语法：`工具名` 或 `工具名(模式*)`，如 run_bash(git *)、edit_file、read_file(**/.env*)")}if("allow"!==o&&"deny"!==o){if("remove"===o||"rm"===o){if(!i)return void n.print("用法：/permissions remove <规则原文>（仅移除项目设置里的规则）");const e=M(n.cwd,i);return n.permissions?.reloadRules?.(),void n.print(e.removed?`已移除规则：${i}`:`未在项目设置中找到该规则：${i}`)}n.print("未知子命令。用法：/permissions [allow|deny|remove] <规则>")}else{if(!i||!T(i))return void n.print("规则无效。示例：run_bash(git *)、edit_file、fetch_url(https://a.com*)");try{const e=_(n.cwd,o,i);n.permissions?.reloadRules?.(),n.print(`已添加${"deny"===o?"拒绝":"允许"}规则：${i} → ${e}`)}catch(e){n.print("写入失败："+e.message)}}}},{name:"diff",desc:"查看未提交改动（git）与本会话智能体改过的文件",run(n){n.print(N(n.cwd,n.session.messages))}},{name:"pr",args:"[commit|address]",desc:"自动提交并开 PR（生成规范 commit→建分支→push→gh 开 PR）；address=按 review 评论自动改",async run(n,e){const t=String(e||"").trim().toLowerCase();if("address"===t||"comments"===t)return{prompt:"请处理当前分支/PR 的 review 评论：用 `gh pr view --comments`（无 PR 则先 `gh pr status`）读取评论，逐条理解并修改代码解决，然后 git add/commit（规范信息）+ git push；完成后逐条说明如何处理的。若未装 gh 或无 PR，先告知。"};const{runPrFlow:o}=await import("./gitflow.js");try{const e=await o({cwd:n.cwd,config:n.config,emit:e=>n.print(e),push:"commit"!==t,openPr:"commit"!==t});if(!e.ok)return void n.print("✗ "+e.error);n.print(e.pr?"✅ 已开 PR："+e.pr:"✅ 完成（分支 "+e.branch+"）"+(e.note?"："+e.note:""))}catch(e){n.print("PR 流程出错："+e.message)}}},{name:"plan",args:"[on|off|approve]",desc:"计划模式：只读调研出方案→/plan approve 批准并分步执行",run(n,e){const t=String(e||"").trim().toLowerCase();if("approve"===t||"go"===t)return n.config.planMode=!1,n.permissions?.setPlanMode?.(!1),n.print("计划已批准，开始分步执行。"),{prompt:"计划已获批准。现在请按你刚才制定的计划（todo 列表）逐步执行：每完成一步用 todo_write 更新状态并简要自检；遇到与计划不符及时调整并说明；全部完成后总结改了什么、以及如何验证（可用 /verify 让我自动跑验证）。"};const o="on"===t||"off"!==t&&!n.config.planMode;n.config.planMode=o,n.permissions?.setPlanMode?.(o),n.print(o?"计划模式：开。只做只读调研并用 todo_write 产出分步方案；写/执行会被拦截。\n  方案满意后用 /plan approve 批准并自动分步执行；或 /plan off 手动执行。":"计划模式：关。恢复正常执行（写/执行仍按权限审批）。")}},{name:"auto",args:"<目标>",desc:"自动规划并自动执行：只读调研出分步计划，确认「是否继续？」后自动逐步执行",run(n,e){const t=String(e||"").trim();if(t)return{action:"autorun",goal:t};n.print("用法：/auto <目标>\n  先自动规划（只读调研 + todo 分步计划），随后询问「是否继续？1、是 2、是，并允许在当前对话中后续相同操作不再询问 3、否」，确认后自动逐步执行并自检。")}},{name:"rewind",args:"[N [chat|code|both]]",desc:"检查点回滚：无参列出；/rewind N 回退对话，加 code/both 一并回滚文件",run(n,e){const t=n.checkpoints;if(!t||!t.list.length)return void n.print("暂无检查点（每个用户回合前自动记录，发生对话后可用）。");const o=String(e||"").trim().split(/\s+/).filter(Boolean);if(!o.length){const e=["检查点（回滚到某个回合之前）"];for(const n of t.list)e.push(`  #${n.id}  ${l(n.time)}  ${n.label}`+(n.journal.length?` · 改动 ${n.journal.length} 处`:""));return e.push("  用法：/rewind N（仅回退对话，安全）· /rewind N code（回滚文件）· /rewind N both"),e.push("  提示：code/both 会覆盖当前文件，建议先 /diff 查看。"),void n.print(e.join("\n"))}const i=Number(o[0]);if(!Number.isFinite(i))return void n.print("用法：/rewind N [chat|code|both]");const s=["chat","code","both"].includes(o[1])?o[1]:"chat",r=t.restore(i,s,{session:n.session,cwd:n.cwd});if(!r.ok)return void n.print(r.error);const a=[];r.conversation&&a.push("对话已回退到该回合之前"),r.filesRestored.length&&a.push(`恢复文件 ${r.filesRestored.length} 个`),r.filesDeleted.length&&a.push(`删除新建文件 ${r.filesDeleted.length} 个`),r.filesSkipped.length&&a.push(`跳过(过大) ${r.filesSkipped.length} 个`),r.filesFailed.length&&a.push(`失败 ${r.filesFailed.length} 个`);try{f(n.session)}catch{}return n.print("已回滚到 #"+i+"："+(a.join("；")||"无变化")+(r.filesFailed.length?"\n  失败："+r.filesFailed.join("；"):"")),r.conversation?{action:"refresh"}:void 0}},{name:"hooks",desc:"查看已配置的工具事件钩子（Pre/PostToolUse/UserPromptSubmit/Stop）",run(n){n.print(A(P(n.cwd)))}},{name:"copy",args:"[N]",desc:"复制助手回复到剪贴板（默认最后一条；N=倒数第 N 条）",async run(n,e){const t=n.session.messages.filter(n=>"assistant"===n.role&&"string"==typeof n.content&&n.content.trim());if(!t.length)return void n.print("还没有可复制的助手回复。");const o=Math.max(1,parseInt(e,10)||1),i=t[t.length-o];if(!i)return void n.print(`只有 ${t.length} 条助手回复。`);const s=await E(i.content);n.print(s.ok?`已复制${o>1?`倒数第 ${o} 条`:"最后一条"}回复到剪贴板（${i.content.length} 字）`:`复制失败（未找到 ${s.tool}）。以下为该回复内容：\n\n${i.content}`)}},{name:"export",args:"[文件路径]",desc:"导出当前对话为 Markdown 文件",run(t,o){const i=D(t.session),s=String(o||"").trim()||`huicai-对话-${(new Date).toISOString().slice(0,19).replace(/[:T]/g,"-")}.md`,r=e.isAbsolute(s)?s:e.join(t.cwd,s);try{n.writeFileSync(r,i,"utf8"),t.print("已导出对话到 "+r)}catch(n){t.print("导出失败："+n.message)}}},{name:"rename",args:"<新标题>",desc:"重命名当前会话",run(n,e){const t=String(e||"").trim();if(t){n.session.title=t.slice(0,80);try{f(n.session)}catch{}n.print("会话已重命名为："+n.session.title)}else n.print("当前标题："+(n.session.title||"(未命名)")+"\n  用法：/rename <新标题>")}},{name:"recap",desc:"用一句话总结当前对话进展（直连原始模型，不写入对话）",async run(n){if(n.session.messages.some(n=>"system"!==n.role))try{n.print("小结："+await U(n.session.messages,n.config))}catch(e){n.print("生成小结失败："+e.message)}else n.print("对话还没有内容。")}},{name:"distill",desc:"从当前对话提炼项目知识，写入长期记忆（供后续会话自动加载）",async run(n){if(!1===n.config.memoryEnabled)return void n.print("长期记忆已关闭（config.memory=false）。");if(!n.session.messages.some(n=>"system"!==n.role))return void n.print("对话还没有内容。");const{distillMemory:e}=await import("./transcript.js"),{loadMemory:t,appendMemory:o}=await import("./memory.js");try{const i=await e(n.session.messages,n.config,t(n.cwd));if(!i.length)return void n.print("未提炼出值得长期记住的新知识。");let s=0;for(const e of i)o(n.cwd,e)&&s++;n.print(`已写入 ${s} 条项目知识到长期记忆：\n`+i.map(n=>"  · "+n).join("\n"))}catch(e){n.print("提炼失败："+e.message)}}},{name:"doctor",desc:"本机环境体检（登录/网络/模型/git/工作目录/钩子）",async run(n){try{n.print(await q(n))}catch(e){n.print("体检失败："+e.message)}}},{name:"config",desc:"查看配置文件路径与当前生效配置（密钥脱敏）",run(n){const e=n.config,t=Number(e.autoCompactTokens);var o;n.print(["配置","  文件      "+r,"  平台      "+e.baseUrl,"  密钥      "+(o=e.apiKey,o?o.slice(0,4)+"…"+o.slice(-4)+`（${o.length}位）`:"(未设置)"),"  模型      "+e.model,"  推理强度  "+(e.reasoningEffort||"off"),"  自动压缩  "+(t<0?"关闭":t>0?t.toLocaleString()+" tokens":"默认(80k)"),"  记忆      "+(!1===e.memoryEnabled?"关":"开"),"  Markdown  "+(!1===e.markdown?"关":"开"),"  全局设置  "+C,"  项目设置  "+I(n.cwd),"  （多数项有对应斜杠命令直接改：/model /effort /autocompact /permissions …）"].join("\n"))}},{name:"effort",args:"[minimal|low|medium|high|off]",desc:"设置推理强度（reasoning_effort 透传；模型不支持则忽略）",run(n,e){const t=String(e||"").trim().toLowerCase();t?["minimal","low","medium","high","off"].includes(t)?(n.config.reasoningEffort="off"===t?"":t,i({reasoningEffort:n.config.reasoningEffort}),n.print("推理强度："+(n.config.reasoningEffort||"off")+"（下一条消息起生效；模型不支持则被忽略）")):n.print("取值：minimal | low | medium | high | off"):n.print("当前推理强度："+(n.config.reasoningEffort||"off")+"\n  用法：/effort minimal|low|medium|high|off")}},{name:"autocompact",args:"[N|off|status]",desc:"自动压缩上下文的触发阈值（token 数；off 关闭）",run(n,e){const t=String(e||"").trim().toLowerCase(),o=Number(n.config.autoCompactTokens)||0;if(!t||"status"===t)return void n.print("自动压缩："+(o<0?"已关闭":o>0?`阈值 ${o.toLocaleString()} tokens`:"默认阈值 80,000 tokens")+"\n  /autocompact <N> 设定 · /autocompact off 关闭 · /autocompact status 查看");if("off"===t)return n.config.autoCompactTokens=-1,i({autoCompactTokens:-1}),void n.print("已关闭自动压缩（仍可 /compact 手动压缩）。");const s=parseInt(t,10);!Number.isFinite(s)||s<1e3?n.print("请给 ≥1000 的 token 阈值，或 off / status。"):(n.config.autoCompactTokens=s,i({autoCompactTokens:s}),n.print("自动压缩阈值设为 "+s.toLocaleString()+" tokens（字符阈值同步联动）。"))}},{name:"review",desc:"审查当前未提交改动（找 bug 与可简化处）",run:()=>({prompt:"请审查当前工作区的未提交改动：先用 run_bash 跑 `git diff`（及 `git status`）查看改了什么，聚焦正确性 bug、边界与错误处理、可复用/可简化处、安全隐患。若本地有 code-review 技能可 load_skill 参照其方法。逐条给出：问题、定位（文件:行）、修改建议，按严重度排序；不确定的地方说明。"})},{name:"security-review",desc:"对当前改动做安全审查",run:()=>({prompt:"请对当前工作区改动做安全审查：注入（SQL/命令/路径穿越）、越权、密钥/凭据泄漏、SSRF、不安全依赖、反序列化、XSS 等。先 run_bash 跑 `git diff` 查看改动。若本地有 security-audit 技能可 load_skill 参照。给出风险点、可利用场景、影响与修复建议，按严重度排序。"})},{name:"scan",args:"[fix]",desc:"安全/质量扫描（自动选可用的 npm audit/semgrep/trivy/gitleaks 等）；fix=让智能体逐条修",async run(n,e){const{detectScanners:t,runScanners:o}=await import("./scan.js"),i=t(n.cwd);if(!i.length)return void n.print("未检测到可用扫描器。可安装 semgrep / trivy / gitleaks，或项目含 package.json（npm audit）等。");if("fix"===String(e||"").trim().toLowerCase())return{prompt:"请对本项目做安全/质量扫描并修复：依次运行并理解这些扫描器的输出——"+i.map(n=>"`"+n.command+"`（"+n.why+"）").join("、")+"；对发现的问题逐个修复（升级/更换依赖、修代码、移除硬编码密钥等），修完重跑对应扫描确认清零；最后汇总修了什么。"};n.print("运行扫描器："+i.map(n=>n.name).join(", ")+"（可能较慢）…");const s=await o(n.cwd,i);for(const e of s)n.print(`\n── ${e.name}（${0===e.code?"✅ 无高危":"⚠ 有发现"}）──`),n.print(e.output.split("\n").slice(0,20).join("\n"));n.print("\n（/scan fix 让智能体逐条修复）")}},{name:"cover",desc:"覆盖率驱动测试生成：跑覆盖率→定位未覆盖的改动→补测试→复测",run:()=>({prompt:"请做覆盖率驱动的测试补全：\n1) 跑测试覆盖率（按项目选：npm test -- --coverage / jest --coverage / pytest --cov / go test -cover / mvn test 等）；\n2) 重点看**最近改动**且覆盖率低或未覆盖的函数与分支；\n3) 为这些薄弱处补写有意义的测试（覆盖正常/边界/错误路径），遵循项目既有测试风格与框架；\n4) 重跑测试与覆盖率，确认通过且覆盖率提升；最后汇报补了哪些测试、覆盖率变化。"})},{name:"verify",args:"[验证命令]",desc:"修到通过：跑测试/构建，失败自动定位修复并重跑，直到通过或达上限",run(n,e){let t=String(e||"").trim();if(!t){if(t=S(n.cwd)||"",!t)return void n.print("未能自动探测验证命令。用法：/verify <命令>（如 /verify npm test）");n.print("自动探测到验证命令："+t)}return{action:"autofix",command:t,maxIters:Math.min(10,Math.max(1,Number(n.config.verifyMaxIters)||5))}}},{name:"simplify",desc:"审查改动的可复用/简化/抽象层级并直接清理（只清理不找 bug）",run:()=>({prompt:"请只做质量清理（不找 bug）：审查最近改动的复用（是否重复造轮子、可否复用现有工具/函数）、简化（是否有更直接的写法）、效率、以及抽象层级是否合适；把确定的改进直接用 edit_file 应用，保持与项目既有风格一致，改后跑测试/构建自检。若本地有 refactor-safely 技能可 load_skill 参照。最后说明改了什么、为什么。"})},{name:"insights",desc:"本机会话使用洞察（数量/轮数/活跃度/按项目·模型分布）",run(n){n.print(y(w(m(null),{cwd:n.cwd})))}},{name:"goal",args:"[目标 | clear]",desc:"设定目标（每轮注入，模型停止前自检是否达成；clear 清除）",run(n,e){const t=String(e||"").trim();if(t){if("clear"===t)return n.config.goal="",void n.print("已清除目标。");n.config.goal=t,n.print("已设定目标："+t+"（每轮注入，模型将在停止前自检是否达成）")}else n.print(n.config.goal?"当前目标："+n.config.goal+"\n  /goal <新目标> 修改 · /goal clear 清除":"未设定目标。用法：/goal <目标>（模型会在停止前自检是否达成）")}},{name:"btw",args:"<问题>",desc:"问一个旁支问题（带当前上下文，但不写入对话、不调用工具）",async run(n,e){const t=String(e||"").trim();if(!t)return void n.print("用法：/btw <问题>（快速旁支问答，不影响主对话）");const o=K.test(String(n.config.model||""))?n.config.compactModel||s:n.config.model;try{const e=h(n.session.messages,n.session.compaction||{}),i=await d({baseUrl:n.config.baseUrl,apiKey:n.config.apiKey,model:o,messages:[...e,{role:"user",content:"（这是一个旁支问题，请结合上文直接简答，不要调用工具、不要展开无关内容）\n"+t}]});n.print("↪ "+(i.content||"(无回复)").trim())}catch(e){n.print("旁支问答失败："+e.message)}}},{name:"ide",desc:"查看 IDE 集成状态（编辑器上下文与内联审阅）",run(n){const e=!!process.env.HUICAI_IDE_PORT,t=process.env.HUICAI_IDE_FILE,o=process.env.HUICAI_IDE_SELECTION,i=process.env.HUICAI_IDE_DIAGNOSTICS,s=["IDE 集成"];s.push("  内联审阅  "+(e?"已连接（write/edit 交编辑器做 diff 审阅）":"未连接（CLI 直接写盘）")),s.push("  客户端    "+(n.config.client||"cli")),s.push("  当前文件  "+(t||"(无)")),s.push("  选区      "+(o?o.length+" 字":"(无)")),s.push("  诊断      "+(i?"有（来自 Problems 面板）":"(无)")),e||s.push("  （在 VS Code/IDEA 的 huicai 面板或其启动的终端里运行可启用内联审阅与编辑器上下文）"),n.print(s.join("\n"))}},{name:"branch",args:"[标题]",desc:"把当前对话另存为一个可 --resume 的分支副本（当前会话继续）",run(n,e){const t=n.session;if(!t.messages.some(n=>"system"!==n.role))return void n.print("当前对话为空，无需分支。");const o=u({cwd:n.cwd,model:t.model,messages:t.messages.map(n=>({...n}))});try{o.compaction=JSON.parse(JSON.stringify(t.compaction||{}))}catch{o.compaction={}}o.title=(String(e||"").trim()||t.title||"对话").slice(0,70)+"（分支）",o.lastPromptTokens=t.lastPromptTokens||0;try{f(o),f(t)}catch{}n.print(`已保存分支副本「${o.title}」（${o.id}）。\n  当前会话继续；分支可用 huicai --resume 恢复到此刻状态。`)}},{name:"theme",args:"[default|mono]",desc:"输出主题：default 彩色 / mono 无色",run(n,e){const t=String(e||"").trim().toLowerCase();t?["default","mono"].includes(t)?(n.config.theme=t,$(t),i({theme:t}),n.print("主题："+t+("mono"===t?"（已关闭颜色）":"（彩色）"))):n.print("取值：default | mono"):n.print("当前主题："+(n.config.theme||"default")+"\n  /theme default | mono（终端配色由终端掌控；mono=关闭颜色，便于复制/管道）")}},{name:"color",args:"["+b.join("|")+"]",desc:"设置强调色（提示符/高亮）",run(n,e){const t=String(e||"").trim().toLowerCase();t?k(t)?(n.config.accentColor=t,i({accentColor:t}),n.print("强调色："+t)):n.print("可选："+b.join(" / ")):n.print("当前强调色："+v()+"\n  可选："+b.join(" / "))}},{name:"tui",args:"[auto|rich|plain]",desc:"交互渲染器偏好（下次启动生效）",run(n,e){const t=String(e||"").trim().toLowerCase();t?["auto","rich","plain"].includes(t)?(n.config.tui=t,i({tui:t}),n.print("渲染器偏好："+t+"（下次启动生效）")):n.print("取值：auto | rich | plain"):n.print("当前渲染器偏好："+(n.config.tui||"auto")+"\n  auto（TTY 下富 TUI）| rich | plain（下次启动生效；本次可加 --tui/--plain 覆盖）")}},{name:"advisor",args:"[模型id|off]",desc:"设置顾问模型（更强模型）：智能体遇难题可 ask_advisor 咨询第二意见",async run(n,e){const t=String(e||"").trim();if(!t)return void n.print(n.config.advisorModel?"当前顾问模型："+n.config.advisorModel+"（智能体可用 ask_advisor 咨询）":"未设置顾问模型。用法：/advisor <模型id>（设一个更强的模型；/models 看可用）· /advisor off 关闭");const o="off"===t?"":t;if(n.config.advisorModel=o,i({advisorModel:o}),Array.isArray(n.extraTools)){const e=n.extraTools.findIndex(n=>"ask_advisor"===n.spec?.function?.name);if(e>=0&&n.extraTools.splice(e,1),o){const{makeAdvisorTool:e}=await import("./advisor.js"),t=e({config:n.config});t&&n.extraTools.push(t)}}n.print(o?"顾问模型已设为 "+o+"（ask_advisor 工具已可用）":"已关闭顾问模型。")}},{name:"automodel",args:"[强模型id|off]",desc:"按任务自动选模型：复杂回合自动升配到该强模型，其余用当前模型",run(n,e){const t=String(e||"").trim();if(!t)return void n.print(n.config.autoModelStrong?"自动升配：开（复杂回合→"+n.config.autoModelStrong+"，其余→"+n.config.model+"）":"未开启。用法：/automodel <强模型id>（复杂回合自动用它；简单回合仍用当前便宜模型）· /models 看可用");const o="off"===t.toLowerCase()?"":t;n.config.autoModelStrong=o,i({autoModelStrong:o}),n.print(o?"按任务自动选模型：开（复杂回合→"+o+"，其余→"+n.config.model+"）":"已关闭自动升配。")}},{name:"embed",args:"[嵌入模型id|off]",desc:"search_code 向量语义重排：设一个嵌入模型走 /v1/embeddings 重排（空/off=纯 BM25）",run(n,e){const t=String(e||"").trim();if(!t)return void n.print(n.config.embeddingModel?"search_code 向量重排：开（嵌入模型 "+n.config.embeddingModel+"）":"未启用向量重排（纯 BM25，离线可用）。用法：/embed <嵌入模型id>（需平台有该嵌入模型）· /embed off");const o="off"===t.toLowerCase()?"":t;n.config.embeddingModel=o,i({embeddingModel:o}),n.print(o?"search_code 向量语义重排：开（嵌入模型 "+o+"；下次检索生效，BM25 召回后按向量相似度重排）":"已关闭向量重排（回到纯 BM25）。")}},{name:"budget",args:"[token数|off|status]",desc:"设置本项目 token 预算（软提醒；/cost 看进度）",run(n,e){const t=String(e||"").trim().toLowerCase(),o=(n.usage?.prompt||0)+(n.usage?.completion||0);if(!t||"status"===t){const e=Number(n.config.budgetTokens)||0;return void n.print(e>0?`token 预算：${o.toLocaleString()} / ${e.toLocaleString()}（${Math.round(o/e*100)}%）`:`未设预算（本次已用 ${o.toLocaleString()} tokens）。/budget <token数> 设定`)}if("off"===t)return n.config.budgetTokens=0,i({budgetTokens:0}),void n.print("已取消预算。");const s=parseInt(t,10);!Number.isFinite(s)||s<1e3?n.print("请给 ≥1000 的 token 数，或 off / status。"):(n.config.budgetTokens=s,i({budgetTokens:s}),n.print("token 预算设为 "+s.toLocaleString()+"（软提醒；/cost 显示进度）。"))}},{name:"debug",args:"[on|off]",desc:"调试输出（每轮打印模型/耗时/token）",run(n,e){const t=String(e||"").trim().toLowerCase(),o="on"===t||"off"!==t&&!n.config.debug;n.config.debug=o,i({debug:o}),n.print("调试输出："+(o?"开（下一条消息起每轮打印 [debug] 行）":"关"))}},{name:"sandbox",args:"[on|off]",desc:"沙箱模式：禁 shell 与联网（仍可读写本地文件）",run(n,e){const t=String(e||"").trim().toLowerCase(),o="on"===t||"off"!==t&&!n.config.sandbox;n.config.sandbox=o,n.permissions?.setSandbox?.(o),n.print(o?"沙箱模式：开。run_bash 与 fetch_url 将被拒绝；本地文件读写照常。":"沙箱模式：关（写/执行仍按权限审批）。")}},{name:"reload-skills",desc:"从磁盘重新加载技能（新增/改名技能生效；改正文已实时生效）",async run(n){const{makeSkillTools:e,loadLocalSkills:t}=await import("./skills.js");if(Array.isArray(n.extraTools)){for(let e=n.extraTools.length-1;e>=0;e--){const t=n.extraTools[e]?.spec?.function?.name;"load_skill"!==t&&"read_skill_file"!==t||n.extraTools.splice(e,1)}n.extraTools.push(...e(n.cwd))}const o=t(n.cwd);n.print(o.length?`已重载 ${o.length} 个技能：${o.map(n=>n.name).join(", ")}\n  （load_skill 现可载入其中任意一个；系统提示词内的技能目录将在下次新会话刷新）`:"未发现本地技能（.huicai/skills 或 ~/.huicai/skills）。")}},{name:"add-dir",args:"[目录 | list | remove <目录>]",desc:"添加可读/搜索的附加目录（写入仍限主目录）",run(t,o){const i=t.session;Array.isArray(i.extraDirs)||(i.extraDirs=[]);const s=String(o||"").trim().split(/\s+/).filter(Boolean),r=(s[0]||"").toLowerCase();if(!o||"list"===r)return void t.print(i.extraDirs.length?"附加目录：\n"+i.extraDirs.map(n=>"  "+n).join("\n")+"\n  /add-dir <目录> 添加 · /add-dir remove <目录> 移除":"暂无附加目录。用法：/add-dir <目录>（可读/搜索，写仍限主目录）");if("remove"===r||"rm"===r){const n=e.resolve(t.cwd,s.slice(1).join(" ")),o=i.extraDirs.length;i.extraDirs=i.extraDirs.filter(e=>e!==n),H(i);try{f(i)}catch{}return void t.print(i.extraDirs.length<o?"已移除："+n:"未找到该附加目录："+n)}const a=e.resolve(t.cwd,String(o).trim());let c=!1;try{c=n.statSync(a).isDirectory()}catch{}if(c)if(a!==t.cwd){i.extraDirs.includes(a)||i.extraDirs.push(a),H(i);try{f(i)}catch{}t.print("已添加可访问目录："+a+"\n  （模型可用 read_file/list_files/grep 以绝对路径访问；写入仍限主目录）")}else t.print("这已是主工作目录。");else t.print("目录不存在："+a)}},{name:"agents",desc:"列出可用子智能体人格（.huicai/agents/*.md；dispatch_agent 可指定）",async run(n){const{loadAgents:e}=await import("./subagent.js"),t=e(n.cwd);n.print(t.length?"子智能体人格（dispatch_agent 的 agent 参数可指定）：\n"+t.map(n=>`  ${n.name}${n.description?" — "+n.description.replace(/\s+/g," ").slice(0,60):""}`).join("\n"):"未定义子智能体人格。\n  在 .huicai/agents/<名字>.md 写 frontmatter(name/description)+正文(人格提示词)即可；\n  dispatch_agent 默认用通用只读子智能体（无需定义也能用）。")}},{name:"orchestrate",args:"<目标>",desc:"把一个目标自动分解为并行子任务、多智能体协作完成",run(n,e){const t=String(e||"").trim();if(t)return{prompt:`目标：${t}\n\n请作为编排者（只调度不代工）按以下方式完成：\n1) 任务分配预检：先解析目标要什么，把它分解为若干**独立、可并行**的子任务（研究/检索/分析/定位），并确认每个子任务与所派子智能体的能力匹配——超出能力范围的部分如实说明，不硬派；\n2) 用 dispatch_agents 一次性并行委派这些子任务（每个说明必须独立自足——子智能体看不到本对话；可指定合适的子智能体人格）；\n3) 信息流经你中转：需要衔接的结论由你提炼后放进下一批子任务的 context，再行派发；\n4) 汇总各子智能体结论形成整体方案或结果，并自查：每部分都有子任务产出支撑、无遗漏、未完成的如实说明；\n5) 若需落地改动，再据此逐步执行并自检（可用 /verify 让我自动跑验证）。\n优先用 dispatch_agents 并行，减少串行等待。`};n.print("用法：/orchestrate <较大的目标>（我会分解为并行子任务，用 dispatch_agents 并行推进后综合）")}},{name:"squads",desc:"列出可用专家团（内置10个+全局/项目自定义；复杂任务也会被自动选团）",async run(n){const{loadSquads:e}=await import("./squad.js"),t=e(n.cwd),o={project:"项目",global:"全局",builtin:"内置"};n.print(t.length?"专家团（/squad <名称> <任务> 交给团队完成；复杂任务对话中也会按「何时使用」自动选团）：\n"+t.map(n=>`  [${o[n.scope]||"自定义"}] ${n.name} — 主理人${n.leader} · ${n.members.length} 位成员`+(n.when?" · "+n.when.replace(/\s+/g," ").slice(0,46):n.description?" · "+n.description.replace(/\s+/g," ").slice(0,46):"")).join("\n")+"\n（/squad-init <新名> --from <内置团> 以内置团为底稿定制；项目/全局同名可覆盖内置）":"未定义专家团。\n  /squad-init <名称> 生成模板（.huicai/squads/<名称>.md）：成员表+任务预检+预设工作流；\n  平台上的专家团可直接 --model squad-<分享码> 使用（服务端编排）。")}},{name:"squad",args:"<名称> <任务>",desc:"把任务交给专家团：主理人预检派发、成员协作、汇总交付",async run(n,e){const{loadSquads:t,squadCommandPrompt:o,ensureTeamDir:i}=await import("./squad.js"),s=t(n.cwd),r=String(e||"").trim(),a=r.indexOf(" "),c=a<0?r:r.slice(0,a),d=a<0?"":r.slice(a+1).trim(),m=s.find(n=>n.name===c);if(!r||!m||!d)return void n.print("用法：/squad <名称> <任务>"+(s.length?`\n可用专家团：${s.map(n=>n.name).join("、")}`:"\n还没有专家团定义，先 /squad-init <名称> 生成模板。")+(r&&!m&&c?`\n（未找到「${c}」）`:""));if(!m.members.length)return void n.print(`专家团「${c}」还没有成员，请编辑其定义文件补充「## 成员」。`);const l=i(n.cwd,m.name);return n.print(`已召集专家团「${m.name}」（主理人${m.leader}，${m.members.length} 位成员）`+(l?`，团队工作区：${l}`:"")),{prompt:o(m,d,l)}}},{name:"squad-init",args:"[名称] [--from <内置团>]",desc:"生成专家团定义（空白模板，或以内置团为底稿定制）",async run(n,e){const t=await import("node:fs"),o=await import("node:path"),{SQUAD_TEMPLATE:i,loadSquads:s}=await import("./squad.js"),r=String(e||"").trim().split(/\s+/).filter(Boolean),a=r.indexOf("--from"),c=a>=0?r[a+1]:null,d=(a>=0?r.filter((n,e)=>e!==a&&e!==a+1):r)[0];let m,l;if(c){const e=s(n.cwd).find(n=>n.name===c);if(!e||!e.file)return void n.print(`未找到底稿团「${c}」（/squads 查看可用团名）`);l=(d||c).replace(/[^\w.\-一-龥]/g,"-"),m=t.readFileSync(e.file,"utf8").replace(/^(---[\s\S]*?\bname:\s*).*$/m,`$1${l}`)}else l=(d||"my-team").replace(/[^\w.\-一-龥]/g,"-"),m=i.replace("{NAME}",l);const p=o.join(n.cwd,".huicai","squads"),f=o.join(p,`${l}.md`);t.existsSync(f)?n.print(`已存在：${f}（直接编辑即可）`):(t.mkdirSync(p,{recursive:!0}),t.writeFileSync(f,m),n.print(`已生成专家团定义：${f}${c?`（底稿：${c}${l===c?"，项目层将覆盖内置同名团":""}）`:""}\n  编辑成员表（执行者可指 agent:本地人格 / platform:平台伪模型 / platform:auto:类型 自动绑定 / model:模型名）、成员人设、预检速查表与预设工作流后，/squad `+l+" <任务> 即可开工。"))}},{name:"experts",args:"[refresh|on|off]",desc:"平台能力自动编队：查看/刷新可用的专家团·工作流·智能体·数字人",async run(n,e){const{discoverExperts:t,makeExpertTools:o}=await import("./experts.js"),i=String(e||"").trim().toLowerCase(),s=n=>["consult_expert","consult_experts"].includes(n?.spec?.function?.name);if("off"===i){if(n.config.autoExperts=!1,Array.isArray(n.extraTools))for(let e=n.extraTools.length-1;e>=0;e--)s(n.extraTools[e])&&n.extraTools.splice(e,1);return void n.print('已关闭平台能力自动编队（本会话即时生效）。永久关闭：在 ~/.huicai/config.json 中设 "autoExperts": false')}if("on"===i){if(n.config.autoExperts=!0,Array.isArray(n.extraTools)&&!n.extraTools.some(s)){const e=await o({config:n.config});n.extraTools.push(...e),n.print(e.length?"已开启平台能力自动编队（本会话即时生效）。":"已开启，但当前无可编队的平台专家（需登录且账号下有可用资源，或当前驱动模型为伪模型）。")}else n.print("平台能力自动编队已是开启状态。");return}const r=await t(n.config,{force:"refresh"===i});if(!r.length)return void n.print("当前无可编队的平台专家。"+(n.config.apiKey?"（账号下暂无可用的专家团/工作流/智能体/数字人，或平台不可达）":"请先 huicai login 登录平台。"));const a={squad:"专家团",workflow:"工作流",agent:"智能体",datahuman:"数字人"},c=["平台能力编队（原始模型对话时可被自动咨询"+(!1===n.config.autoExperts?"，当前已关闭，/experts on 开启":"")+"）："];for(const n of["squad","workflow","agent","datahuman"]){const e=r.filter(e=>e.type===n);if(e.length){c.push(`  ${a[n]}（${e.length}）`);for(const n of e)c.push(`    ${n.id} — ${n.name}${n.description?"："+n.description.slice(0,50):""}`)}}c.push("refresh"===i?"（已强制刷新）":"（/experts refresh 强制刷新；/experts off 关闭）"),n.print(c.join("\n"))}},{name:"batch",args:"<大改动目标>",desc:"把一个大改动拆成独立子任务，在隔离 git worktree 中并行推进",run(n,e){const t=String(e||"").trim();if(t)return{prompt:`目标（需拆分并行落地）：${t}\n\n请这样做：\n1) 先把目标拆成若干**相互独立、可并行**的改动子任务（尽量互不冲突的文件/模块）；\n2) 对每个子任务，用 \`git worktree add -b huicai-batch/<名> <路径>\` 建隔离工作区，在其中完成该子任务的改动并 commit（不影响主工作区）；\n3) 全部完成后，汇总每个 worktree 的分支与改动；需要时可对每个分支执行 \`huicai pr\` 开 PR。\n（并行调研可用 dispatch_agents；改动务必隔离在各自 worktree，避免互相踩踏。完成后可 \`git worktree remove\` 清理。）`};n.print("用法：/batch <一个可拆分的大改动目标>（拆成互不冲突的子任务，各在隔离 worktree 中落地）")}},{name:"fork",args:"<后台任务提示词>",desc:"派生后台智能体（继承当前对话副本，--yolo 自动放行，输出写日志）",async run(n,e){const t=String(e||"").trim();if(!t)return void n.print("用法：/fork <让后台智能体做什么>（以当前对话副本为上下文，后台运行，--yolo 自动放行）");const o=u({cwd:n.cwd,model:n.session.model,messages:n.session.messages.map(n=>({...n}))});try{o.compaction=JSON.parse(JSON.stringify(n.session.compaction||{}))}catch{o.compaction={}}o.title="(fork) "+(n.session.title||"");try{f(o)}catch{}const{forkAgent:i}=await import("./forks.js");let s;try{s=i({prompt:t,cwd:n.cwd,sessionId:o.id})}catch(e){return void n.print("无法派生后台任务："+e.message)}n.print(`已派生后台智能体 pid ${s.pid}（--yolo 自动放行）\n  上下文：当前对话副本 ${o.id}\n  日志：${s.log}\n  /tasks 查看 · /tasks kill ${s.pid} 终止`)}},{name:"tasks",args:"[kill <pid>]",desc:"查看/终止本会话派生的后台任务（/fork）",async run(n,e){const{listForks:t,killFork:o}=await import("./forks.js"),i=String(e||"").trim().split(/\s+/).filter(Boolean);if("kill"===i[0]){const e=Number(i[1]);if(!Number.isFinite(e))return void n.print("用法：/tasks kill <pid>");const t=o(e);return void n.print(t.ok?"已终止 pid "+e:"终止失败："+(t.reason||""))}const s=t();s.length?n.print("后台任务：\n"+s.map(n=>`  pid ${n.pid} · ${n.alive?"运行中":"已结束"} · ${l(n.started)} · ${n.prompt}\n     日志 ${n.log}`).join("\n")+"\n  /tasks kill <pid> 终止"):n.print("本会话暂无后台任务（/fork <提示词> 派生）。")}},{name:"schedule",args:'[list | add "<cron>" "<提示词>" | remove <id>]',desc:"管理定时任务（生成 crontab 行交系统 cron 运行）",async run(n,e){const t=await import("./schedule.js"),o=String(e||"").trim(),i="huicai";if(!o||"list"===o){const e=t.listTasks();return e.length?void n.print("定时任务：\n"+e.map(n=>`  #${n.id}  ${n.cron}  ${n.prompt.replace(/\s+/g," ").slice(0,40)}\n     crontab: ${t.crontabLine(n,i)}`).join("\n")+"\n  /schedule remove <id> 删除"):void n.print('暂无定时任务。\n  添加：/schedule add "*/30 * * * *" "跑测试并把结果写入 report.md"\n  （随后把打印的 crontab 行加入 crontab -e）')}if(/^add\b/.test(o)){const e=o.match(/"([^"]*)"/g);if(!e||e.length<2)return void n.print('用法：/schedule add "<cron>" "<提示词>"（cron 与提示词都要加引号）');const s=e[0].slice(1,-1).trim(),r=e[1].slice(1,-1).trim();if(5!==s.split(/\s+/).length)return void n.print('cron 需 5 个字段，如 "*/30 * * * *"（分 时 日 月 周）');const{id:a}=t.addTask({cron:s,prompt:r,cwd:n.cwd});return void n.print("已添加定时任务 #"+a+"\n  加入 crontab（crontab -e）：\n  "+t.crontabLine({id:a,cron:s,prompt:r,cwd:n.cwd},i))}if(/^(remove|rm)\b/.test(o)){const e=o.split(/\s+/)[1];return void n.print(t.removeTask(e)?"已删除定时任务 "+e:"未找到定时任务 "+e)}n.print('用法：/schedule list · /schedule add "<cron>" "<提示词>" · /schedule remove <id>')}},{name:"cd",args:"<目录>",desc:"切换工作目录（在新目录开启新会话；IDE 中请用「打开文件夹」）",run(t,o){const i=String(o||"").trim();if(!i)return void t.print("当前工作目录："+t.cwd+"\n  用法：/cd <目录>（将在新目录开启新会话，旧会话已保存）");const s=e.resolve(t.cwd,i);let r=!1;try{r=n.statSync(s).isDirectory()}catch{}if(r){if(s!==t.cwd)return{action:"cd",cwd:s};t.print("已在该目录。")}else t.print("目录不存在："+s)}},{name:"loop",args:"<秒> <提示词> | off",desc:"每隔 N 秒自动重跑一个提示词（off 停止）",run(n,e){const t=String(e||"").trim();if(!t)return void n.print("用法：/loop <秒> <提示词>（如 /loop 300 检查构建是否通过）· /loop off 停止");if("off"===t)return{action:"loop",stop:!0};const o=/^(\d+)\s+([\s\S]+)$/.exec(t);if(o)return{action:"loop",seconds:Math.max(10,parseInt(o[1],10)),prompt:o[2].trim()};n.print("用法：/loop <秒> <提示词> · /loop off")}},{name:"statusline",args:"<shell命令> | off",desc:"自定义 TUI 底栏（运行该命令，展示其 stdout）",run(n,e){const t=String(e||"").trim();if(!t)return void n.print("当前状态栏命令："+(n.config.statusLine||"(默认)")+"\n  /statusline <shell命令>（stdout 显示在 TUI 底栏）· /statusline off 恢复默认");const o="off"===t?"":t;n.config.statusLine=o,i({statusLine:o}),n.print(o?"状态栏命令已设置（TUI 底栏生效）："+o:"已恢复默认状态栏。")}},{name:"background",desc:"保存当前会话并给出在别处继续/后台运行的方式",run(n){try{f(n.session)}catch{}n.print(`会话已保存（${n.session.id}）。\n  · 在别处继续：huicai resume ${n.session.id}\n  · 后台跑一个任务：/fork <提示词>（派生后台智能体，日志可查）\n  · 定时运行：/schedule add "<cron>" "<提示词>"`)}},{name:"exit",desc:"退出",run:()=>({action:"exit"})}];export function listCommands(n){return[...J.map(n=>({name:n.name,args:n.args||"",desc:n.desc})),...loadCustomCommands(n).map(n=>({name:n.name,args:"",desc:n.desc}))]}export function loadCustomCommands(o){const i=[o?e.join(o,".huicai","commands"):null,e.join(t.homedir(),".huicai","commands")].filter(Boolean),s=new Map;for(const t of i){let o;try{o=n.readdirSync(t).filter(n=>n.endsWith(".md"))}catch{continue}for(const i of o){const o=i.replace(/\.md$/,"").trim();if(o&&!s.has(o)&&!J.some(n=>n.name===o))try{const r=n.readFileSync(e.join(t,i),"utf8"),{desc:a,body:c}=Y(r);s.set(o,{name:o,desc:a||"自定义命令",template:c})}catch{}}}return[...s.values()]}function Y(n){const e=/^---\n([\s\S]*?)\n---\n?/.exec(n);if(!e)return{desc:"",body:n.trim()};const t=e[1],o=/^description:\s*(.+)$/m.exec(t);return{desc:o?o[1].trim():"",body:n.slice(e[0].length).trim()}}export async function runSlash(n,e){const t=n.slice(1).split(/\s+/),o=(t[0]||"").trim(),i=t.slice(1).join(" ").trim();if("quit"===o)return{handled:!0,action:"exit"};const s=J.find(n=>n.name===o);if(s){return{handled:!0,...await s.run(e,i)||{}}}const r=loadCustomCommands(e.cwd).find(n=>n.name===o);if(r){let n=r.template;return n.includes("$ARGUMENTS")?n=n.replaceAll("$ARGUMENTS",i):i&&(n=n+"\n\n"+i),{handled:!0,prompt:n}}return e.print("未知命令。/help 查看可用命令。"),{handled:!0}}

package/src/compaction.js

@@ -1 +1 @@
-import{streamChat as t}from"./api.js";import{DEFAULT_MODEL as e}from"./config.js";import{stripMarkup as n}from"./markup-filter.js";export function buildModelMessages(t,e){return e&&e.summary&&e.upTo>1&&!(e.upTo>t.length)?[...t.slice(0,1),{role:"user",content:"【上下文压缩】以下是此前多轮对话与工具执行的摘要（原始对话仍完整保留在会话中，仅为节省上下文而摘要）：\n"+e.summary},...t.slice(e.upTo)]:t}export async function compactIfNeeded(e,o,s={}){const c=s.state||{},l=s.keepRecent||3;if(!e||e.length<6)return 0;const u=Number(o?.autoCompactTokens);if(!s.force&&Number.isFinite(u)&&u<0)return 0;const i=u>0?u:8e4,a=s.thresholdChars||(u>0?3*u:48e3),m=buildModelMessages(e,c);if(!s.force){const t=Number(s.lastPromptTokens)>i,e=function(t){let e=0;for(const n of t)n.content&&(e+=String(n.content).length),n.tool_calls&&(e+=JSON.stringify(n.tool_calls).length);return e}(m)>a;if(!t&&!e)return 0}const f=Math.max(Number(c.upTo)||1,1),p=[];for(let t=f;t<e.length;t++)"user"===e[t].role&&p.push(t);if(p.length<=l)return 0;const h=p[p.length-l];if(h-f<2)return 0;const g=e.slice(f,h);let d;try{d=await async function(e,o,s){const c=[];s&&s.trim()&&c.push("【先前的摘要（需并入新摘要）】\n"+s.trim());c.push(function(t){const e=[];for(const n of t)if("assistant"===n.role&&n.tool_calls?.length){const t=n.tool_calls.map(t=>`${t.function?.name}(${String(t.function?.arguments||"").slice(0,200)})`).join(" ");e.push(`[助手调用工具] ${t}${n.content?" ｜ "+n.content:""}`)}else"tool"===n.role?e.push(`[工具结果] ${String(n.content||"").slice(0,800)}`):n.content&&e.push(`[${n.role}] ${n.content}`);return e.join("\n")}(e));const l=await t({baseUrl:o.baseUrl,apiKey:o.apiKey,model:r(o),messages:[{role:"system",content:"你是对话/执行记录压缩器。把下面的记录（含可能存在的先前摘要）压缩成一份简洁但信息完整的中文摘要：保留已完成的关键步骤、工具得到的重要事实/数据/结论、涉及的文件路径、尚未解决的问题与下一步线索。只依据记录、不要臆造、不要寒暄。"},{role:"user",content:c.join("\n\n")}]});return n(l.content).text}(g,o,c.summary)}catch{return 0}return d&&d.trim()?(c.summary=d.trim(),c.upTo=h,h-f):0}export function compactNow(t,e,n={}){return compactIfNeeded(t,e,{...n,force:!0})}const o=/^(agent|workflow|datahuman)-/;function r(t){if(t?.compactModel)return t.compactModel;const n=t?.model||"";return o.test(n)?e:n}
+import{streamChat as t}from"./api.js";import{DEFAULT_MODEL as e}from"./config.js";import{stripMarkup as n}from"./markup-filter.js";export function buildModelMessages(t,e){return e&&e.summary&&e.upTo>1&&!(e.upTo>t.length)?[...t.slice(0,1),{role:"user",content:"【上下文压缩】以下是此前多轮对话与工具执行的摘要（原始对话仍完整保留在会话中，仅为节省上下文而摘要）：\n"+e.summary},...t.slice(e.upTo)]:t}export async function compactIfNeeded(e,o,s={}){const c=s.state||{},u=s.keepRecent||3;if(!e||e.length<6)return 0;const l=Number(o?.autoCompactTokens);if(!s.force&&Number.isFinite(l)&&l<0)return 0;const i=l>0?l:8e4,a=s.thresholdChars||(l>0?3*l:48e3),m=buildModelMessages(e,c);if(!s.force){const t=Number(s.lastPromptTokens)>i,e=function(t){let e=0;for(const n of t)n.content&&(e+=String(n.content).length),n.tool_calls&&(e+=JSON.stringify(n.tool_calls).length);return e}(m)>a;if(!t&&!e)return 0}const f=Math.max(Number(c.upTo)||1,1),p=[];for(let t=f;t<e.length;t++)"user"===e[t].role&&p.push(t);if(p.length<=u)return 0;const h=p[p.length-u];if(h-f<2)return 0;const g=e.slice(f,h);let d;try{d=await async function(e,o,s){const c=[];s&&s.trim()&&c.push("【先前的摘要（需并入新摘要）】\n"+s.trim());c.push(function(t){const e=[];for(const n of t)if("assistant"===n.role&&n.tool_calls?.length){const t=n.tool_calls.map(t=>`${t.function?.name}(${String(t.function?.arguments||"").slice(0,200)})`).join(" ");e.push(`[助手调用工具] ${t}${n.content?" ｜ "+n.content:""}`)}else"tool"===n.role?e.push(`[工具结果] ${String(n.content||"").slice(0,800)}`):n.content&&e.push(`[${n.role}] ${n.content}`);return e.join("\n")}(e));const u=await t({baseUrl:o.baseUrl,apiKey:o.apiKey,model:r(o),messages:[{role:"system",content:"你是对话/执行记录压缩器。把下面的记录（含可能存在的先前摘要）压缩成一份简洁但信息完整的中文摘要：保留已完成的关键步骤、工具得到的重要事实/数据/结论、涉及的文件路径、尚未解决的问题与下一步线索。只依据记录、不要臆造、不要寒暄。"},{role:"user",content:c.join("\n\n")}]});return n(u.content).text}(g,o,c.summary)}catch{return 0}return d&&d.trim()?(c.summary=d.trim(),c.upTo=h,h-f):0}export function compactNow(t,e,n={}){return compactIfNeeded(t,e,{...n,force:!0})}const o=/^(agent|workflow|datahuman|squad)-/;function r(t){if(t?.compactModel)return t.compactModel;const n=t?.model||"";return o.test(n)?e:n}

package/src/consult.js

@@ -1 +1 @@
-import{streamChat as t}from"./api.js";const r=/^(agent|workflow|datahuman)-/;export function makeConsultTool({config:e}){const n=e&&e.consult;if(!n||!r.test(String(n)))return null;const o=function(t){return t.startsWith("workflow-")?"工作流":t.startsWith("datahuman-")?"业务数字人":"智能体"}(String(n));return{readOnly:!0,spec:{type:"function",function:{name:"consult_platform",description:`咨询平台${o}「${e.consultLabel||n}」：由平台侧编排作答（带其服务端知识库 RAG / 工具 / 联网检索）。遇到它擅长领域的问题优先调用它获取权威答复，再用本机工具把结论落地到项目。可多次调用。`,parameters:{type:"object",properties:{query:{type:"string",description:"自然语言的咨询 / 查询 / 运行输入"}},required:["query"]}}},run:async r=>{const o=String(r&&r.query||"").trim();if(!o)return"需要提供 query（要咨询平台的自然语言问题 / 输入）";try{return(await t({baseUrl:e.baseUrl,apiKey:e.apiKey,model:n,messages:[{role:"user",content:o}],client:e.client,sessionId:e.sessionId},{})).content||"(平台无返回)"}catch(t){if(t&&"AbortError"===t.name)throw t;return`平台调用失败：${t.message}`}}}}
+import{streamChat as t}from"./api.js";const r=/^(agent|workflow|datahuman|squad)-/;export function makeConsultTool({config:e}){const n=e&&e.consult;if(!n||!r.test(String(n)))return null;const s=function(t){return t.startsWith("workflow-")?"工作流":t.startsWith("datahuman-")?"业务数字人":t.startsWith("squad-")?"专家团":"智能体"}(String(n));return{readOnly:!0,spec:{type:"function",function:{name:"consult_platform",description:`咨询平台${s}「${e.consultLabel||n}」：由平台侧编排作答（带其服务端知识库 RAG / 工具 / 联网检索）。遇到它擅长领域的问题优先调用它获取权威答复，再用本机工具把结论落地到项目。可多次调用。`,parameters:{type:"object",properties:{query:{type:"string",description:"自然语言的咨询 / 查询 / 运行输入"}},required:["query"]}}},run:async r=>{const s=String(r&&r.query||"").trim();if(!s)return"需要提供 query（要咨询平台的自然语言问题 / 输入）";try{return(await t({baseUrl:e.baseUrl,apiKey:e.apiKey,model:n,messages:[{role:"user",content:s}],client:e.client,sessionId:e.sessionId},{})).content||"(平台无返回)"}catch(t){if(t&&"AbortError"===t.name)throw t;return`平台调用失败：${t.message}`}}}}

package/src/context.js

@@ -1 +1 @@
-import n from"node:fs";import e from"node:path";import t from"node:os";import{execSync as r}from"node:child_process";import{loadMemory as i}from"./memory.js";import{skillCatalog as o}from"./skills.js";import{buildRepoMap as s}from"./codeindex.js";const c=["- 先了解现状再动手：并行使用 read_file/glob/grep/list_files 收集信息（一轮可同时调多个只读工具），不要臆测文件内容。","- read_file 输出的「行号→」前缀仅供定位，不是文件内容；写 edit_file 的 old_string/new_string 时绝不能包含行号前缀。","- 多步骤任务先用 todo_write 列出计划，并随进度更新状态（同一时刻至多一项 in_progress）；单步小事不必用。","- 改代码优先用 edit_file 做最小精确改动；新建文件才用 write_file。遵循项目既有风格与命名。","- 用 run_bash 执行构建/测试/git 等；改动后尽量运行测试或构建自检，失败要定位修复而不是忽略。","- 需要在线资料（文档/API 说明）可用 fetch_url；带明确目的使用，不要漫游。","- 破坏性或不可逆操作（删除、强推、重置等）前先说明意图；写/执行类工具会请用户授权，被拒绝时据反馈调整方案。","- 不要把密钥、令牌等敏感值回显到输出或写进代码。","- 简洁直接，用中文回答；完成后用一两句话总结改了什么、如何验证的。"];export function buildSystemPrompt(l,m={}){const a=function(n){const e=e=>r(e,{cwd:n,stdio:["ignore","pipe","ignore"]}).toString().trim();try{const n=e("git rev-parse --abbrev-ref HEAD");let t="";try{t=e("git status --short")}catch{}return{branch:n,status:t}}catch{return null}}(l),f=function(t){for(const r of["HUICAI.md","AGENTS.md","CLAUDE.md"])try{const i=n.readFileSync(e.join(t,r),"utf8");if(i.trim())return{name:r,content:i.slice(0,8e3)}}catch{}return null}(l),p=function(){try{const r=n.readFileSync(e.join(t.homedir(),".huicai","HUICAI.md"),"utf8");return r.trim()?r.slice(0,4e3):null}catch{return null}}();let u="";if(m.persona&&m.persona.trim()?(u+="# 你的角色设定\n"+m.persona.trim()+"\n\n",u+="# 运行方式\n",u+="你现在运行在用户终端里，可通过工具在用户本机的项目里读写文件、搜索、执行 shell 命令来真正完成任务。请在保持上述角色设定的前提下遵循以下准则：\n"):(u+="你是 huicai，一个运行在用户终端里的专业自治编码与自动化智能体。\n",u+="你能通过工具在用户本机的项目里读写文件、搜索、执行 shell 命令，从而真正完成任务，而不仅是给建议。\n\n",u+="# 工作准则\n"),u+=c.join("\n")+"\n\n",u+="# 运行环境\n",u+=`- 工作目录: ${l}\n`,u+=`- 操作系统: ${t.platform()} ${t.release()} (${t.arch()})\n`,u+=`- 日期: ${(new Date).toISOString().slice(0,10)}\n`,a&&(u+=`- Git 分支: ${a.branch}\n`,a.status)){u+=`- 未提交改动:\n${a.status.split("\n").slice(0,30).map(n=>"    "+n).join("\n")}\n`}const d=function(e){try{return n.readdirSync(e,{withFileTypes:!0}).filter(n=>".git"!==n.name&&"node_modules"!==n.name).slice(0,60).map(n=>n.isDirectory()?n.name+"/":n.name).join("  ")}catch{return""}}(l);d&&(u+=`- 顶层条目: ${d}\n`);const h=function(){const n=process.env.HUICAI_IDE_FILE,e=process.env.HUICAI_IDE_SELECTION,t=process.env.HUICAI_IDE_DIAGNOSTICS;if(!n&&!e&&!t)return"";let r="";n&&(r+=`- 用户当前正在编辑的文件: ${n}\n`);if(e){r+="- 用户当前选中的代码片段：\n```\n"+(e.length>4e3?e.slice(0,4e3)+"\n…(选区已截断)":e)+"\n```\n"}if(t){r+="- 编辑器诊断（错误/警告，来自 Problems 面板）：\n```\n"+(t.length>4e3?t.slice(0,4e3)+"\n…(诊断已截断)":t)+"\n```\n"}return r}();if(h&&(u+="\n# 编辑器上下文（来自 IDE 集成）\n"+h),p&&(u+=`\n# 全局用户说明（~/.huicai/HUICAI.md）\n${p}\n`),f&&(u+=`\n# 项目说明（${f.name}）\n${f.content}\n`),!1!==m.repoMap)try{const n=s(l);n&&(u+=`\n# 项目地图（关键文件与主要符号；用 search_code 按概念检索相关实现）\n${n}\n`)}catch{}const _=o(l);if(_&&(u+=`\n# 可用技能（本地 Agent Skills）\n${_}\n`),!1!==m.memory){const n=i(l);n&&(u+=`\n# 长期记忆（此前会话经 memory_write 记录，跨会话生效）\n${n}\n`,u+="（发现新的、值得跨会话记住的稳定事实/偏好/结论时，用 memory_write 记录。）\n")}return m.append&&String(m.append).trim()&&(u+="\n# 附加指示\n"+String(m.append).trim()+"\n"),u}
+import n from"node:fs";import e from"node:path";import t from"node:os";import{execSync as r}from"node:child_process";import{loadMemory as i}from"./memory.js";import{skillCatalog as o}from"./skills.js";import{buildRepoMap as s}from"./codeindex.js";const c=["- 先了解现状再动手：并行使用 read_file/glob/grep/list_files 收集信息（一轮可同时调多个只读工具），不要臆测文件内容。","- read_file 输出的「行号→」前缀仅供定位，不是文件内容；写 edit_file 的 old_string/new_string 时绝不能包含行号前缀。","- 多步骤任务先用 todo_write 列出计划，并随进度更新状态（同一时刻至多一项 in_progress）；单步小事不必用。","- 改代码优先用 edit_file 做最小精确改动；新建文件才用 write_file。遵循项目既有风格与命名。","- 用 run_bash 执行构建/测试/git 等；改动后尽量运行测试或构建自检，失败要定位修复而不是忽略。","- 需要在线资料（文档/API 说明）可用 fetch_url；带明确目的使用，不要漫游。","- 环境与应用自动化：install_packages 装 Node.js 包、setup_environment 一键配置运行环境、install_plugin 装 VS Code/JetBrains 插件、open_browser/open_path/open_app 打开浏览器/文件管理器/任意应用。这些操作会先征询用户「是否继续」；被拒绝时不要重试，改为说明手动做法。","- 破坏性或不可逆操作（删除、强推、重置等）前先说明意图；写/执行类工具会请用户授权，被拒绝时据反馈调整方案。","- 不要把密钥、令牌等敏感值回显到输出或写进代码。","- 简洁直接，用中文回答；完成后用一两句话总结改了什么、如何验证的。"];export function buildSystemPrompt(l,a={}){const m=function(n){const e=e=>r(e,{cwd:n,stdio:["ignore","pipe","ignore"]}).toString().trim();try{const n=e("git rev-parse --abbrev-ref HEAD");let t="";try{t=e("git status --short")}catch{}return{branch:n,status:t}}catch{return null}}(l),p=function(t){for(const r of["HUICAI.md","AGENTS.md","CLAUDE.md"])try{const i=n.readFileSync(e.join(t,r),"utf8");if(i.trim())return{name:r,content:i.slice(0,8e3)}}catch{}return null}(l),u=function(){try{const r=n.readFileSync(e.join(t.homedir(),".huicai","HUICAI.md"),"utf8");return r.trim()?r.slice(0,4e3):null}catch{return null}}();let f="";if(a.persona&&a.persona.trim()?(f+="# 你的角色设定\n"+a.persona.trim()+"\n\n",f+="# 运行方式\n",f+="你现在运行在用户终端里，可通过工具在用户本机的项目里读写文件、搜索、执行 shell 命令来真正完成任务。请在保持上述角色设定的前提下遵循以下准则：\n"):(f+="你是 huicai，一个运行在用户终端里的专业自治编码与自动化智能体。\n",f+="你能通过工具在用户本机的项目里读写文件、搜索、执行 shell 命令，从而真正完成任务，而不仅是给建议。\n\n",f+="# 工作准则\n"),f+=c.join("\n")+"\n\n",f+="# 运行环境\n",f+=`- 工作目录: ${l}\n`,f+=`- 操作系统: ${t.platform()} ${t.release()} (${t.arch()})\n`,f+=`- 日期: ${(new Date).toISOString().slice(0,10)}\n`,m&&(f+=`- Git 分支: ${m.branch}\n`,m.status)){f+=`- 未提交改动:\n${m.status.split("\n").slice(0,30).map(n=>"    "+n).join("\n")}\n`}const d=function(e){try{return n.readdirSync(e,{withFileTypes:!0}).filter(n=>".git"!==n.name&&"node_modules"!==n.name).slice(0,60).map(n=>n.isDirectory()?n.name+"/":n.name).join("  ")}catch{return""}}(l);d&&(f+=`- 顶层条目: ${d}\n`);const _=function(){const n=process.env.HUICAI_IDE_FILE,e=process.env.HUICAI_IDE_SELECTION,t=process.env.HUICAI_IDE_DIAGNOSTICS;if(!n&&!e&&!t)return"";let r="";n&&(r+=`- 用户当前正在编辑的文件: ${n}\n`);if(e){r+="- 用户当前选中的代码片段：\n```\n"+(e.length>4e3?e.slice(0,4e3)+"\n…(选区已截断)":e)+"\n```\n"}if(t){r+="- 编辑器诊断（错误/警告，来自 Problems 面板）：\n```\n"+(t.length>4e3?t.slice(0,4e3)+"\n…(诊断已截断)":t)+"\n```\n"}return r}();if(_&&(f+="\n# 编辑器上下文（来自 IDE 集成）\n"+_),u&&(f+=`\n# 全局用户说明（~/.huicai/HUICAI.md）\n${u}\n`),p&&(f+=`\n# 项目说明（${p.name}）\n${p.content}\n`),!1!==a.repoMap)try{const n=s(l);n&&(f+=`\n# 项目地图（关键文件与主要符号；用 search_code 按概念检索相关实现）\n${n}\n`)}catch{}const h=o(l);if(h&&(f+=`\n# 可用技能（本地 Agent Skills）\n${h}\n`),!1!==a.memory){const n=i(l);n&&(f+=`\n# 长期记忆（此前会话经 memory_write 记录，跨会话生效）\n${n}\n`,f+="（发现新的、值得跨会话记住的稳定事实/偏好/结论时，用 memory_write 记录。）\n")}return a.append&&String(a.append).trim()&&(f+="\n# 附加指示\n"+String(a.append).trim()+"\n"),f}

package/src/experts.js

@@ -0,0 +1 @@
+import e from"node:fs";import t from"node:path";import n from"node:os";import r from"node:crypto";import{listModels as i,streamChat as a}from"./api.js";const s=6e5,o=/^(agent|workflow|datahuman|squad)-/,c={squad:0,workflow:1,agent:2,datahuman:3},p={squad:"专家团",workflow:"工作流",agent:"智能体",datahuman:"数字人"};function u(e){if(e.hc_type&&p[e.hc_type])return e.hc_type;const t=/^(agent|workflow|datahuman|squad)-/.exec(String(e.id||""));return t?t[1]:"agent"}export function expertsCachePath(e){const i=r.createHash("sha1").update(String(e.baseUrl||"")+"|"+String(e.apiKey||"").slice(-6)).digest("hex").slice(0,12);return t.join(n.homedir(),".huicai","cache",`experts-${i}.json`)}function l(t){try{const n=JSON.parse(e.readFileSync(t,"utf8"));if(Array.isArray(n?.experts))return{fetchedAt:n.fetchedAt||0,experts:n.experts}}catch{}return null}function y(n,r){try{e.mkdirSync(t.dirname(n),{recursive:!0}),e.writeFileSync(n,JSON.stringify({fetchedAt:Date.now(),experts:r}))}catch{}}async function d(e){return(await i(e.baseUrl,e.apiKey)).filter(e=>o.test(String(e.id||""))).map(e=>({id:e.id,name:e.display_name||e.id,description:String(e.description||"").replace(/\s+/g," ").trim(),type:u(e)})).sort((e,t)=>(c[e.type]??9)-(c[t.type]??9)||String(e.name).localeCompare(t.name,"zh"))}const m=new Set;export async function discoverExperts(e,{force:t=!1}={}){if(!e||!e.baseUrl||!e.apiKey)return[];const n=expertsCachePath(e),r=t?null:l(n);if(r)return Date.now()-r.fetchedAt>6e5&&function(e,t){m.has(t)||(m.add(t),d(e).then(e=>y(t,e)).catch(()=>{}).finally(()=>m.delete(t)))}(e,n),r.experts;try{const r=await(i=d(e),a=t?15e3:3500,new Promise((e,t)=>{const n=setTimeout(()=>t(new Error(`发现超时（${a}ms）`)),a);i.then(t=>{clearTimeout(n),e(t)},e=>{clearTimeout(n),t(e)})}));return y(n,r),r}catch{const e=l(n);return e?e.experts:[]}var i,a}export async function makeExpertTools({config:e}){if(!e||!e.baseUrl||!e.apiKey)return[];if(!1===e.autoExperts)return[];if(o.test(String(e.model||"")))return[];const t=await discoverExperts(e);if(!t.length)return[];const n=new Map(t.map(e=>[e.id,e])),r=function(e){const t=e.slice(0,24),n=t.map(e=>`${e.id} — [${p[e.type]||e.type}]${e.name}${e.description?"："+e.description.slice(0,80):""}`);return e.length>t.length&&n.push(`…另有 ${e.length-t.length} 个（/experts 查看全部）`),n.join("\n")}(t),i={fails:0,openUntil:0},c=()=>Date.now()<i.openUntil?"平台专家暂时不可用（连续失败已熔断，稍后自动恢复）。请先用本地工具与自身知识完成任务，稍后可重试咨询。":null,u=async(r,o,c)=>{const u=String(r||"").trim(),l=n.get(u)||t.find(e=>e.name===u);if(!l)return`未找到平台专家「${u}」，请从目录中选择（/experts 可查看全部）`;if(!String(o||"").trim())return"缺少 query（要咨询/交办的自然语言内容）";try{const t=await async function(e,t,n,r){const i=r&&String(r).trim()?`${n}\n\n【背景/上游材料】\n${r}`:String(n);return(await a({baseUrl:e.baseUrl,apiKey:e.apiKey,model:t,messages:[{role:"user",content:i}],client:e.client,sessionId:e.sessionId},{},AbortSignal.timeout(s))).content||"(平台无返回)"}(e,l.id,o,c);return i.fails=0,`平台${p[l.type]||""}「${l.name}」的答复：\n${t}`}catch(e){const t=e&&"AbortError"===e.name?`超过 ${Math.round(10)} 分钟未完成，已中止`:e.message;return i.fails++,i.fails>=3&&(i.openUntil=Date.now()+3e4),`咨询「${l.name}」失败：${t}${i.openUntil>Date.now()?"（平台已熔断，请先用本地能力完成）":""}`}};return[{readOnly:!0,spec:{type:"function",function:{name:"consult_expert",description:"咨询/交办给一个平台专家（当前账号可用的专家团/工作流/智能体/数字人，服务端编排：知识库RAG/工具/多智能体协作/NL→SQL）。遇到专家擅长领域的问题优先交给它产出权威结论，再用本机工具把结论落地到项目。可多次调用（多个独立咨询会自动并行）。\n可用专家目录：\n"+r,parameters:{type:"object",properties:{expert:{type:"string",description:"专家 id（目录第一列）",...t.length<=24?{enum:t.map(e=>e.id)}:{}},query:{type:"string",description:"自然语言的咨询/任务输入（专家看不到本对话，需自足）"},context:{type:"string",description:"可选：完成该咨询所需的背景/上游材料"}},required:["expert","query"]}}},run:async e=>c()||u(e?.expert,e?.query,e?.context)},{readOnly:!0,spec:{type:"function",function:{name:"consult_experts",description:"一次性把多个**独立**的咨询/子任务并行交给多个平台专家（同一专家也可多份），聚合各自答复。适合跨领域任务：如「专家团出方案 + 数字人查数据 + 智能体审内容」同时推进，显著减少串行等待。",parameters:{type:"object",properties:{tasks:{type:"array",description:"并行咨询数组（建议 2-6 个，上限 8）",items:{type:"object",properties:{expert:{type:"string",description:"专家 id（见 consult_expert 目录）"},query:{type:"string",description:"该专家的自足任务/咨询"},context:{type:"string",description:"可选背景"}},required:["expert","query"]}}},required:["tasks"]}}},run:async e=>{const t=c();if(t)return t;const n=Array.isArray(e?.tasks)?e.tasks.slice(0,8):[];if(!n.length)return"未提供 tasks（需要一个咨询数组）";return(await async function(e,t,n){const r=new Array(e.length);let i=0;return await Promise.all(Array.from({length:Math.max(1,Math.min(t,e.length))},async()=>{for(;i<e.length;){const t=i++;r[t]=await n(e[t],t)}})),r}(n,4,async e=>({expert:e?.expert,out:await u(e?.expert,e?.query,e?.context)}))).map((e,t)=>`【咨询 ${t+1} · ${e.expert}】\n${e.out}`).join("\n\n---\n\n")}}]}

package/src/gitflow.js

@@ -1 +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]}}}
+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|squad)-/,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]}}}