@huicai/cli 2026.711.0 → 2026.711.24617

package/src/schedule.js

@@ -1,48 +1 @@
-// /schedule：管理定时任务（持久化到 ~/.huicai/schedule.json），并生成交给系统 cron 运行的 crontab 行。
-// 不自带调度器——把定时职责交给成熟的系统 cron；本模块负责登记 + 生成可粘贴的 crontab 条目。
-
-import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-
-export const SCHEDULE_FILE = path.join(os.homedir(), '.huicai', 'schedule.json');
-
-function read() {
-  try {
-    const j = JSON.parse(fs.readFileSync(SCHEDULE_FILE, 'utf8'));
-    return Array.isArray(j) ? j : [];
-  } catch {
-    return [];
-  }
-}
-
-function write(list) {
-  fs.mkdirSync(path.dirname(SCHEDULE_FILE), { recursive: true });
-  fs.writeFileSync(SCHEDULE_FILE, JSON.stringify(list, null, 2) + '\n', { mode: 0o600 });
-}
-
-export function listTasks() {
-  return read();
-}
-
-/** 添加定时任务。@param {{cron:string, prompt:string, cwd:string}} t */
-export function addTask({ cron, prompt, cwd }) {
-  const list = read();
-  const id = Date.now().toString(36) + Math.random().toString(36).slice(2, 4);
-  list.push({ id, cron, prompt, cwd, created: Date.now() });
-  write(list);
-  return { id };
-}
-
-export function removeTask(id) {
-  const list = read();
-  const next = list.filter((t) => t.id !== id);
-  write(next);
-  return next.length < list.length;
-}
-
-/** 生成一条 crontab 行（供 crontab -e 粘贴）。 */
-export function crontabLine(t, bin = 'huicai') {
-  return `${t.cron} cd ${JSON.stringify(t.cwd)} && ${bin} -p ${JSON.stringify(t.prompt)} --yolo --plain `
-    + `>> ${JSON.stringify(path.join(os.homedir(), '.huicai', 'schedule-' + t.id + '.log'))} 2>&1`;
-}
+import r from"node:fs";import n from"node:path";import t from"node:os";export const SCHEDULE_FILE=n.join(t.homedir(),".huicai","schedule.json");function o(){try{const n=JSON.parse(r.readFileSync(SCHEDULE_FILE,"utf8"));return Array.isArray(n)?n:[]}catch{return[]}}function i(t){r.mkdirSync(n.dirname(SCHEDULE_FILE),{recursive:!0}),r.writeFileSync(SCHEDULE_FILE,JSON.stringify(t,null,2)+"\n",{mode:384})}export function listTasks(){return o()}export function addTask({cron:r,prompt:n,cwd:t}){const e=o(),c=Date.now().toString(36)+Math.random().toString(36).slice(2,4);return e.push({id:c,cron:r,prompt:n,cwd:t,created:Date.now()}),i(e),{id:c}}export function removeTask(r){const n=o(),t=n.filter(n=>n.id!==r);return i(t),t.length<n.length}export function crontabLine(r,o="huicai"){return`${r.cron} cd ${JSON.stringify(r.cwd)} && ${o} -p ${JSON.stringify(r.prompt)} --yolo --plain >> ${JSON.stringify(n.join(t.homedir(),".huicai","schedule-"+r.id+".log"))} 2>&1`}

package/src/session.js

@@ -1,140 +1 @@
-// 会话持久化：把对话（含系统提示词 + 各轮消息）落盘到 ~/.huicai/sessions/<id>.json，
-// 支持列出、恢复、删除。按项目目录(cwd)归属，使 --continue/--resume 只看当前项目的会话。
-// 所有磁盘操作 best-effort：失败仅告警，绝不让保存/读取异常中断对话本身。
-
-import fs from 'node:fs';
-import path from 'node:path';
-import { CONFIG_DIR } from './config.js';
-
-export const SESSIONS_DIR = path.join(CONFIG_DIR, 'sessions');
-
-function ensureDir() {
-  fs.mkdirSync(SESSIONS_DIR, { recursive: true });
-}
-
-function fileOf(id) {
-  return path.join(SESSIONS_DIR, id + '.json');
-}
-
-function genId() {
-  return Date.now().toString(36) + '-' + Math.random().toString(36).slice(2, 6);
-}
-
-/** 由首条用户消息派生标题（截断）。 */
-function deriveTitle(messages) {
-  const firstUser = (messages || []).find((m) => m.role === 'user');
-  if (!firstUser || !firstUser.content) return '(空会话)';
-  return String(firstUser.content).replace(/\s+/g, ' ').trim().slice(0, 60) || '(空会话)';
-}
-
-/** 会话中的用户轮数（对话往返次数的近似）。 */
-export function turnCount(messages) {
-  return (messages || []).filter((m) => m.role === 'user').length;
-}
-
-/**
- * 新建会话对象（内存态）；messages 需已含 system 消息。落盘发生在首次 saveSession。
- */
-export function createSession({ cwd, model, messages }) {
-  const now = Date.now();
-  return {
-    id: genId(),
-    cwd,
-    model,
-    createdAt: now,
-    updatedAt: now,
-    title: '',
-    messages: messages || [],
-    // 非破坏式上下文压缩状态（摘要独立存储，messages 永远保留全量原文）
-    compaction: {},
-  };
-}
-
-/** 保存会话（覆盖写，0600）。best-effort。 */
-export function saveSession(session) {
-  if (!session || !session.id) return;
-  try {
-    ensureDir();
-    session.updatedAt = Date.now();
-    if (!session.title) session.title = deriveTitle(session.messages);
-    fs.writeFileSync(fileOf(session.id), JSON.stringify(session), { mode: 0o600 });
-  } catch (e) {
-    process.stderr.write(`（会话保存失败，不影响对话：${e.message}）\n`);
-  }
-}
-
-/** 读取会话；不存在或损坏返回 null。 */
-export function loadSession(id) {
-  if (!id) return null;
-  try {
-    const j = JSON.parse(fs.readFileSync(fileOf(id), 'utf8'));
-    if (!j || !Array.isArray(j.messages)) return null;
-    if (!j.id) j.id = id;
-    if (!j.compaction || typeof j.compaction !== 'object') j.compaction = {}; // 旧会话兼容
-    return j;
-  } catch {
-    return null;
-  }
-}
-
-/**
- * 列出会话（按更新时间倒序）。cwd 非空时仅列该项目目录的会话。
- * @returns {{id,title,cwd,model,updatedAt,turns}[]}
- */
-export function listSessions(cwd) {
-  let files;
-  try {
-    ensureDir();
-    files = fs.readdirSync(SESSIONS_DIR).filter((f) => f.endsWith('.json'));
-  } catch {
-    return [];
-  }
-  const out = [];
-  for (const f of files) {
-    try {
-      const j = JSON.parse(fs.readFileSync(path.join(SESSIONS_DIR, f), 'utf8'));
-      if (cwd && j.cwd !== cwd) continue;
-      out.push({
-        id: j.id || f.replace(/\.json$/, ''),
-        title: j.title || deriveTitle(j.messages),
-        cwd: j.cwd,
-        model: j.model,
-        updatedAt: j.updatedAt || 0,
-        turns: turnCount(j.messages),
-      });
-    } catch {
-      // 跳过损坏文件
-    }
-  }
-  out.sort((a, b) => b.updatedAt - a.updatedAt);
-  return out;
-}
-
-/** 当前项目最近一次会话的 id；无则 null。 */
-export function mostRecent(cwd) {
-  const list = listSessions(cwd);
-  return list.length ? list[0].id : null;
-}
-
-/** 删除会话文件。 */
-export function deleteSession(id) {
-  try {
-    fs.unlinkSync(fileOf(id));
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/** 相对时间（如「3 分钟前」）。 */
-export function relTime(ts) {
-  if (!ts) return '未知时间';
-  const s = Math.max(0, Math.floor((Date.now() - ts) / 1000));
-  if (s < 60) return s + ' 秒前';
-  const m = Math.floor(s / 60);
-  if (m < 60) return m + ' 分钟前';
-  const h = Math.floor(m / 60);
-  if (h < 24) return h + ' 小时前';
-  const d = Math.floor(h / 24);
-  return d + ' 天前';
-}
+import t from"node:fs";import e from"node:path";import{CONFIG_DIR as n}from"./config.js";export const SESSIONS_DIR=e.join(n,"sessions");function r(){t.mkdirSync(SESSIONS_DIR,{recursive:!0})}function o(t){return e.join(SESSIONS_DIR,t+".json")}function i(t){const e=(t||[]).find(t=>"user"===t.role);return e&&e.content&&String(e.content).replace(/\s+/g," ").trim().slice(0,60)||"(空会话)"}export function turnCount(t){return(t||[]).filter(t=>"user"===t.role).length}export function createSession({cwd:t,model:e,messages:n}){const r=Date.now();return{id:Date.now().toString(36)+"-"+Math.random().toString(36).slice(2,6),cwd:t,model:e,createdAt:r,updatedAt:r,title:"",messages:n||[],compaction:{}}}export function saveSession(e){if(e&&e.id)try{r(),e.updatedAt=Date.now(),e.title||(e.title=i(e.messages)),t.writeFileSync(o(e.id),JSON.stringify(e),{mode:384})}catch(t){process.stderr.write(`（会话保存失败，不影响对话：${t.message}）\n`)}}export function loadSession(e){if(!e)return null;try{const n=JSON.parse(t.readFileSync(o(e),"utf8"));return n&&Array.isArray(n.messages)?(n.id||(n.id=e),n.compaction&&"object"==typeof n.compaction||(n.compaction={}),n):null}catch{return null}}export function listSessions(n){let o;try{r(),o=t.readdirSync(SESSIONS_DIR).filter(t=>t.endsWith(".json"))}catch{return[]}const s=[];for(const r of o)try{const o=JSON.parse(t.readFileSync(e.join(SESSIONS_DIR,r),"utf8"));if(n&&o.cwd!==n)continue;s.push({id:o.id||r.replace(/\.json$/,""),title:o.title||i(o.messages),cwd:o.cwd,model:o.model,updatedAt:o.updatedAt||0,turns:turnCount(o.messages)})}catch{}return s.sort((t,e)=>e.updatedAt-t.updatedAt),s}export function mostRecent(t){const e=listSessions(t);return e.length?e[0].id:null}export function deleteSession(e){try{return t.unlinkSync(o(e)),!0}catch{return!1}}export function relTime(t){if(!t)return"未知时间";const e=Math.max(0,Math.floor((Date.now()-t)/1e3));if(e<60)return e+" 秒前";const n=Math.floor(e/60);if(n<60)return n+" 分钟前";const r=Math.floor(n/60);if(r<24)return r+" 小时前";return Math.floor(r/24)+" 天前"}

package/src/skills.js

@@ -1,248 +1 @@
-// 本地技能（Agent Skills）：发现/读取 <cwd>/.huicai/skills 与 ~/.huicai/skills 下的技能包
-// （<技能名>/SKILL.md + references/scripts 等文本附件），并提供两个动态工具：
-//   load_skill       —— 按需载入技能正文（渐进披露：系统提示词只常驻「名称：描述」目录）
-//   read_skill_file  —— 按需读取技能附件
-// 与平台 skills 表经 /v1/skills 双向同步（huicai skills pull/push），平台即云端技能库。
-
-import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-import { fileURLToPath } from 'node:url';
-
-// 随 CLI 一起分发的内置技能目录（<包根>/skills）。作为「只读、最低优先级」的技能来源：
-// 用户在项目 .huicai/skills 或全局 ~/.huicai/skills 建同名技能即可覆盖。仅进入「发现/载入」读路径，
-// 不进入 skillDirs()（pull 写入目标仍是用户目录，勿写包内）。
-export const BUNDLED_SKILLS_DIR = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'skills');
-
-/** 附件允许的文本扩展名（与平台 SkillFile.TEXT_EXTS 对齐；二进制不收） */
-const TEXT_EXTS = new Set([
-  '.md', '.markdown', '.txt', '.json', '.yaml', '.yml', '.py', '.js', '.mjs', '.cjs', '.ts',
-  '.sh', '.sql', '.csv', '.html', '.css', '.xml', '.toml',
-]);
-const MAX_FILE_BYTES = 256 * 1024;   // 单附件读取上限
-const MAX_FILES = 50;                // 单技能附件数上限
-const MAX_BODY_CHARS = 64 * 1024;    // 载入正文回填上限
-
-/** 解析 SKILL.md 的 YAML frontmatter（零依赖轻量解析：仅顶层 key: value 的 name/description/version）。 */
-export function parseFrontmatter(raw) {
-  const out = { name: '', description: '', version: '', body: (raw || '').trim() };
-  const m = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/.exec(out.body);
-  if (!m) return out;
-  out.body = out.body.slice(m[0].length).trim();
-  for (const line of m[1].split(/\r?\n/)) {
-    const kv = /^(name|description|version)\s*:\s*(.*)$/.exec(line.trim());
-    if (!kv) continue;
-    out[kv[1]] = kv[2].trim().replace(/^["']|["']$/g, '');
-  }
-  return out;
-}
-
-/** 技能根目录（项目级优先于全局；不存在的目录由调用方容错）。 */
-export function skillDirs(cwd) {
-  const dirs = [];
-  if (cwd) dirs.push(path.join(cwd, '.huicai', 'skills'));
-  dirs.push(path.join(os.homedir(), '.huicai', 'skills'));
-  return dirs;
-}
-
-/** 递归收集技能目录下 SKILL.md 之外的文本附件（相对路径，深度≤3，数量受限）。 */
-function collectFiles(dir, base = '', depth = 0, out = []) {
-  if (depth > 3 || out.length >= MAX_FILES) return out;
-  let entries;
-  try {
-    entries = fs.readdirSync(dir, { withFileTypes: true });
-  } catch {
-    return out;
-  }
-  for (const e of entries) {
-    if (out.length >= MAX_FILES) break;
-    if (e.name.startsWith('.')) continue;
-    const rel = base ? `${base}/${e.name}` : e.name;
-    if (e.isDirectory()) {
-      collectFiles(path.join(dir, e.name), rel, depth + 1, out);
-    } else if (e.isFile() && rel !== 'SKILL.md' && TEXT_EXTS.has(path.extname(e.name).toLowerCase())) {
-      out.push(rel);
-    }
-  }
-  return out;
-}
-
-/**
- * 发现本地技能（项目级同名覆盖全局）。
- * @returns {{name:string,description:string,version:string,dir:string,scope:'project'|'global',files:string[]}[]}
- */
-export function loadLocalSkills(cwd) {
-  const byName = new Map();
-  // 优先级：项目 > 全局 > 内置（同名先扫者生效，故用户目录可覆盖内置技能）
-  const dirs = [
-    ...(cwd ? [{ dir: path.join(cwd, '.huicai', 'skills'), scope: 'project' }] : []),
-    { dir: path.join(os.homedir(), '.huicai', 'skills'), scope: 'global' },
-    { dir: BUNDLED_SKILLS_DIR, scope: 'builtin' },
-  ];
-  for (const { dir: base, scope } of dirs) {
-    let entries;
-    try {
-      entries = fs.readdirSync(base, { withFileTypes: true });
-    } catch {
-      continue;
-    }
-    for (const e of entries) {
-      if (!e.isDirectory()) continue;
-      const dir = path.join(base, e.name);
-      let raw;
-      try {
-        raw = fs.readFileSync(path.join(dir, 'SKILL.md'), 'utf8');
-      } catch {
-        continue;
-      }
-      const fm = parseFrontmatter(raw);
-      const name = (fm.name || e.name).trim();
-      if (!name || byName.has(name)) continue;   // 同名：先扫者（更高优先级）生效
-      byName.set(name, {
-        name,
-        description: fm.description || '',
-        version: fm.version || '',
-        dir,
-        scope,
-        files: collectFiles(dir),
-      });
-    }
-  }
-  return [...byName.values()];
-}
-
-/** 读取技能正文（SKILL.md 全文）；找不到返回 null。 */
-export function readSkillBody(cwd, name) {
-  const skill = loadLocalSkills(cwd).find((s) => s.name === name);
-  if (!skill) return null;
-  try {
-    const raw = fs.readFileSync(path.join(skill.dir, 'SKILL.md'), 'utf8');
-    return { skill, raw: raw.length > MAX_BODY_CHARS ? raw.slice(0, MAX_BODY_CHARS) + '\n…(正文已截断)' : raw };
-  } catch {
-    return null;
-  }
-}
-
-/** 读取技能附件（限制在技能目录内，防路径穿越）；返回文本或抛出可读错误。 */
-export function readSkillFileContent(cwd, skillName, relPath) {
-  const skill = loadLocalSkills(cwd).find((s) => s.name === skillName);
-  if (!skill) throw new Error(`本地技能不存在：${skillName}`);
-  const cleaned = String(relPath || '').replace(/\\/g, '/').replace(/^\.\//, '').replace(/^\/+/, '');
-  const abs = path.resolve(skill.dir, cleaned);
-  if (!abs.startsWith(path.resolve(skill.dir) + path.sep)) throw new Error(`路径越界：${relPath}`);
-  const stat = fs.statSync(abs);
-  if (stat.size > MAX_FILE_BYTES) throw new Error(`附件过大（>${MAX_FILE_BYTES / 1024}KB）：${cleaned}`);
-  return fs.readFileSync(abs, 'utf8');
-}
-
-/** 技能目录文本（系统提示词注入）；无技能返回空串。 */
-export function skillCatalog(cwd) {
-  const skills = loadLocalSkills(cwd);
-  if (!skills.length) return '';
-  const lines = skills.map((s) => {
-    const desc = (s.description || '（无描述）').replace(/\s+/g, ' ').slice(0, 300);
-    return `- ${s.name}：${desc}`;
-  });
-  return '以下本地技能可用 load_skill(name) 载入其操作指引后遵循执行（描述含「何时使用」，据此判断是否载入；无关任务不要载入）：\n'
-    + lines.join('\n');
-}
-
-/** 构造 load_skill / read_skill_file 动态工具（extraTools 形态：{spec,run,readOnly}）；无本地技能返回 []。 */
-export function makeSkillTools(cwd) {
-  const skills = loadLocalSkills(cwd);
-  if (!skills.length) return [];
-  const tools = [
-    {
-      readOnly: true,
-      spec: {
-        type: 'function',
-        function: {
-          name: 'load_skill',
-          description: '载入一个本地技能的操作指引（系统提示词「可用技能」目录中的名称）。载入后严格遵循其流程执行。',
-          parameters: {
-            type: 'object',
-            properties: { name: { type: 'string', description: '技能名（见「可用技能」目录）' } },
-            required: ['name'],
-          },
-        },
-      },
-      run: async (args) => {
-        const name = String(args?.name || '').trim();
-        const r = readSkillBody(cwd, name);
-        if (!r) {
-          const names = loadLocalSkills(cwd).map((s) => s.name).join(', ');
-          return `本地技能不存在：${name}（可用：${names || '无'}）`;
-        }
-        let text = r.raw;
-        if (r.skill.files.length) {
-          text += `\n\n---\n本技能附带 ${r.skill.files.length} 个资源文件，需要时用 read_skill_file(skill="${name}", path=...) 读取：\n`
-            + r.skill.files.map((f) => `- ${f}`).join('\n');
-        }
-        return text;
-      },
-    },
-  ];
-  if (skills.some((s) => s.files.length)) {
-    tools.push({
-      readOnly: true,
-      spec: {
-        type: 'function',
-        function: {
-          name: 'read_skill_file',
-          description: '读取本地技能附带的资源文件（先 load_skill 查看其文件清单，再按 path 读取）。',
-          parameters: {
-            type: 'object',
-            properties: {
-              skill: { type: 'string', description: '技能名' },
-              path: { type: 'string', description: '资源文件相对路径（技能载入结果中列出）' },
-            },
-            required: ['skill', 'path'],
-          },
-        },
-      },
-      run: async (args) => {
-        try {
-          const content = readSkillFileContent(cwd, String(args?.skill || '').trim(), args?.path);
-          return `文件 ${args?.path}：\n${content}`;
-        } catch (e) {
-          return `读取失败：${e.message}`;
-        }
-      },
-    });
-  }
-  return tools;
-}
-
-/** 把平台技能详情写入本地目录（pull 落盘）：baseDir/<name>/SKILL.md + 附件。返回技能目录路径。 */
-export function writeSkillToDir(baseDir, item) {
-  const name = String(item?.name || '').trim();
-  if (!name || !item?.content) throw new Error('技能数据不完整（缺 name 或 content）');
-  const dir = path.join(baseDir, name.replace(/[^a-zA-Z0-9_-]/g, '-'));
-  fs.mkdirSync(dir, { recursive: true });
-  fs.writeFileSync(path.join(dir, 'SKILL.md'), item.content, 'utf8');
-  for (const f of item.files || []) {
-    const rel = String(f?.path || '').replace(/\\/g, '/').replace(/^\.\//, '').replace(/^\/+/, '');
-    if (!rel || rel.includes('..')) continue;   // 非法附件路径直接跳过
-    const abs = path.join(dir, rel);
-    fs.mkdirSync(path.dirname(abs), { recursive: true });
-    fs.writeFileSync(abs, f.content ?? '', 'utf8');
-  }
-  return dir;
-}
-
-/** 读取一个本地技能目录为 push 载荷：{content, filename, files:[{path,content}]}。 */
-export function readSkillDirForPush(dir) {
-  const skillMd = path.join(dir, 'SKILL.md');
-  const content = fs.readFileSync(skillMd, 'utf8');
-  const files = [];
-  for (const rel of collectFiles(dir)) {
-    try {
-      const abs = path.join(dir, rel);
-      if (fs.statSync(abs).size > MAX_FILE_BYTES) continue;
-      files.push({ path: rel, content: fs.readFileSync(abs, 'utf8') });
-    } catch {
-      /* 跳过读不了的附件 */
-    }
-  }
-  return { content, filename: path.basename(dir), files };
-}
+import e from"node:fs";import n from"node:path";import t from"node:os";import{fileURLToPath as r}from"node:url";export const BUNDLED_SKILLS_DIR=n.join(n.dirname(r(import.meta.url)),"..","skills");const i=new Set([".md",".markdown",".txt",".json",".yaml",".yml",".py",".js",".mjs",".cjs",".ts",".sh",".sql",".csv",".html",".css",".xml",".toml"]),o=262144;export function parseFrontmatter(e){const n={name:"",description:"",version:"",body:(e||"").trim()},t=/^---\r?\n([\s\S]*?)\r?\n---\r?\n?/.exec(n.body);if(!t)return n;n.body=n.body.slice(t[0].length).trim();for(const e of t[1].split(/\r?\n/)){const t=/^(name|description|version)\s*:\s*(.*)$/.exec(e.trim());t&&(n[t[1]]=t[2].trim().replace(/^["']|["']$/g,""))}return n}export function skillDirs(e){const r=[];return e&&r.push(n.join(e,".huicai","skills")),r.push(n.join(t.homedir(),".huicai","skills")),r}function s(t,r="",o=0,l=[]){if(o>3||l.length>=50)return l;let c;try{c=e.readdirSync(t,{withFileTypes:!0})}catch{return l}for(const e of c){if(l.length>=50)break;if(e.name.startsWith("."))continue;const c=r?`${r}/${e.name}`:e.name;e.isDirectory()?s(n.join(t,e.name),c,o+1,l):e.isFile()&&"SKILL.md"!==c&&i.has(n.extname(e.name).toLowerCase())&&l.push(c)}return l}export function loadLocalSkills(r){const i=new Map,o=[...r?[{dir:n.join(r,".huicai","skills"),scope:"project"}]:[],{dir:n.join(t.homedir(),".huicai","skills"),scope:"global"},{dir:BUNDLED_SKILLS_DIR,scope:"builtin"}];for(const{dir:t,scope:r}of o){let o;try{o=e.readdirSync(t,{withFileTypes:!0})}catch{continue}for(const l of o){if(!l.isDirectory())continue;const o=n.join(t,l.name);let c;try{c=e.readFileSync(n.join(o,"SKILL.md"),"utf8")}catch{continue}const a=parseFrontmatter(c),p=(a.name||l.name).trim();p&&!i.has(p)&&i.set(p,{name:p,description:a.description||"",version:a.version||"",dir:o,scope:r,files:s(o)})}}return[...i.values()]}export function readSkillBody(t,r){const i=loadLocalSkills(t).find(e=>e.name===r);if(!i)return null;try{const t=e.readFileSync(n.join(i.dir,"SKILL.md"),"utf8");return{skill:i,raw:t.length>65536?t.slice(0,65536)+"\n…(正文已截断)":t}}catch{return null}}export function readSkillFileContent(t,r,i){const s=loadLocalSkills(t).find(e=>e.name===r);if(!s)throw new Error(`本地技能不存在：${r}`);const l=String(i||"").replace(/\\/g,"/").replace(/^\.\//,"").replace(/^\/+/,""),c=n.resolve(s.dir,l);if(!c.startsWith(n.resolve(s.dir)+n.sep))throw new Error(`路径越界：${i}`);if(e.statSync(c).size>o)throw new Error(`附件过大（>256KB）：${l}`);return e.readFileSync(c,"utf8")}export function skillCatalog(e){const n=loadLocalSkills(e);if(!n.length)return"";return"以下本地技能可用 load_skill(name) 载入其操作指引后遵循执行（描述含「何时使用」，据此判断是否载入；无关任务不要载入）：\n"+n.map(e=>{const n=(e.description||"（无描述）").replace(/\s+/g," ").slice(0,300);return`- ${e.name}：${n}`}).join("\n")}export function makeSkillTools(e){const n=loadLocalSkills(e);if(!n.length)return[];const t=[{readOnly:!0,spec:{type:"function",function:{name:"load_skill",description:"载入一个本地技能的操作指引（系统提示词「可用技能」目录中的名称）。载入后严格遵循其流程执行。",parameters:{type:"object",properties:{name:{type:"string",description:"技能名（见「可用技能」目录）"}},required:["name"]}}},run:async n=>{const t=String(n?.name||"").trim(),r=readSkillBody(e,t);if(!r){return`本地技能不存在：${t}（可用：${loadLocalSkills(e).map(e=>e.name).join(", ")||"无"}）`}let i=r.raw;return r.skill.files.length&&(i+=`\n\n---\n本技能附带 ${r.skill.files.length} 个资源文件，需要时用 read_skill_file(skill="${t}", path=...) 读取：\n`+r.skill.files.map(e=>`- ${e}`).join("\n")),i}}];return n.some(e=>e.files.length)&&t.push({readOnly:!0,spec:{type:"function",function:{name:"read_skill_file",description:"读取本地技能附带的资源文件（先 load_skill 查看其文件清单，再按 path 读取）。",parameters:{type:"object",properties:{skill:{type:"string",description:"技能名"},path:{type:"string",description:"资源文件相对路径（技能载入结果中列出）"}},required:["skill","path"]}}},run:async n=>{try{const t=readSkillFileContent(e,String(n?.skill||"").trim(),n?.path);return`文件 ${n?.path}：\n${t}`}catch(e){return`读取失败：${e.message}`}}}),t}export function writeSkillToDir(t,r){const i=String(r?.name||"").trim();if(!i||!r?.content)throw new Error("技能数据不完整（缺 name 或 content）");const o=n.join(t,i.replace(/[^a-zA-Z0-9_-]/g,"-"));e.mkdirSync(o,{recursive:!0}),e.writeFileSync(n.join(o,"SKILL.md"),r.content,"utf8");for(const t of r.files||[]){const r=String(t?.path||"").replace(/\\/g,"/").replace(/^\.\//,"").replace(/^\/+/,"");if(!r||r.includes(".."))continue;const i=n.join(o,r);e.mkdirSync(n.dirname(i),{recursive:!0}),e.writeFileSync(i,t.content??"","utf8")}return o}export function readSkillDirForPush(t){const r=n.join(t,"SKILL.md"),i=e.readFileSync(r,"utf8"),l=[];for(const r of s(t))try{const i=n.join(t,r);if(e.statSync(i).size>o)continue;l.push({path:r,content:e.readFileSync(i,"utf8")})}catch{}return{content:i,filename:n.basename(t),files:l}}

package/src/subagent.js

@@ -1,183 +1 @@
-// 客户端子智能体（对应平台 dispatch_agent）：
-// 一个内置工具 dispatch_agent，把明确子任务交给「隔离上下文 + 只读工具」的子智能体自主完成，只回传结论。
-// 让主线程上下文保持精简，适合并行/发散的调研、检索、分析类子任务。
-
-import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-import { runTurn } from './agent.js';
-import { createPermissions } from './permissions.js';
-import { parseFrontmatter } from './skills.js';
-
-const MAX_DEPTH = 2; // 顶层 depth=0；到达上限不再提供 dispatch_agent，防无限递归
-
-/**
- * 加载已定义的子智能体人格：<cwd>/.huicai/agents/*.md 与 ~/.huicai/agents/*.md
- * （frontmatter name/description + 正文=该子智能体的系统提示词）。项目级优先于全局同名。
- * @returns {{name:string, description:string, prompt:string}[]}
- */
-export function loadAgents(cwd) {
-  const dirs = [
-    cwd ? path.join(cwd, '.huicai', 'agents') : null,
-    path.join(os.homedir(), '.huicai', 'agents'),
-  ].filter(Boolean);
-  const byName = new Map();
-  for (const dir of dirs) {
-    let files;
-    try {
-      files = fs.readdirSync(dir).filter((f) => f.endsWith('.md'));
-    } catch {
-      continue;
-    }
-    for (const f of files) {
-      const base = f.replace(/\.md$/, '').trim();
-      if (!base || byName.has(base)) continue;
-      try {
-        const raw = fs.readFileSync(path.join(dir, f), 'utf8');
-        const fm = parseFrontmatter(raw);
-        byName.set(base, { name: (fm.name || base).trim(), description: fm.description || '', prompt: fm.body || raw });
-      } catch {
-        /* 跳过坏文件 */
-      }
-    }
-  }
-  return [...byName.values()];
-}
-
-/** 有序有限并发 map（并发≤limit，结果按输入下标回填）。 */
-async function mapLimit(items, limit, fn) {
-  const results = new Array(items.length);
-  let next = 0;
-  const worker = async () => {
-    while (next < items.length) {
-      const i = next++;
-      results[i] = await fn(items[i], i);
-    }
-  };
-  await Promise.all(Array.from({ length: Math.max(1, Math.min(limit, items.length)) }, worker));
-  return results;
-}
-
-/** 跑一个子智能体子任务（隔离上下文 + 只读工具），返回结论文本。dispatch_agent 与 dispatch_agents 共用。 */
-async function dispatchSubtask({ config, cwd, readOnlyExtras, depth, objective, context, agentDef }) {
-  if (!objective) return '未提供子任务目标 objective';
-  const sys = agentDef
-    ? agentDef.prompt.trim() + '\n\n工作目录：' + cwd + (context && String(context).trim() ? '\n\n## 背景\n' + context : '')
-    : subagentPrompt(cwd, context);
-  const messages = [{ role: 'system', content: sys }, { role: 'user', content: objective }];
-  const permissions = createPermissions({ yolo: false, ask: null });
-  const nested = makeSubagentTool({ config, cwd, extraTools: readOnlyExtras, depth: depth + 1 });
-  const subExtra = nested ? [...readOnlyExtras, nested] : readOnlyExtras;
-  const r = await runTurn({
-    config, messages, permissions, cwd, extraTools: subExtra,
-    depth: depth + 1, maxIters: 50, io: { write: () => {} },
-  });
-  if (r?.error) return `子智能体执行失败：${r.error}`;
-  const last = [...messages].reverse().find((m) => m.role === 'assistant' && m.content);
-  return last ? last.content : '(子智能体未产出结论)';
-}
-
-/**
- * 构造 dispatch_agent 工具。达到深度上限返回 null（不暴露委派）。
- * @param {object} p
- * @param {object} p.config 运行配置（闭包引用，读时取最新 model）
- * @param {string} p.cwd 工作目录
- * @param {{spec:object,run:Function,readOnly:boolean}[]} [p.extraTools] 可传给子智能体的外部工具（仅其只读子集会被采用，通常为 MCP 工具，不含 dispatch 自身）
- * @param {number} p.depth 当前深度
- */
-export function makeSubagentTool({ config, cwd, extraTools = [], depth = 0 }) {
-  if (depth >= MAX_DEPTH) return null;
-
-  const agents = loadAgents(cwd); // 已定义的子智能体人格（可选指定）
-  const spec = {
-    type: 'function',
-    function: {
-      name: 'dispatch_agent',
-      description:
-        '把一个明确、独立、自足的子任务委派给子智能体：它在隔离上下文中自主使用（只读）工具完成后只回传结论。'
-        + '适合可并行的调研/检索/分析类子任务，让主线程上下文保持精简。可多次调用以分解复杂任务。',
-      parameters: {
-        type: 'object',
-        properties: {
-          objective: { type: 'string', description: '要子智能体完成的单一、明确、自足的子任务' },
-          context: { type: 'string', description: '可选：完成该子任务所需的背景信息' },
-          ...(agents.length ? {
-            agent: {
-              type: 'string',
-              enum: agents.map((a) => a.name),
-              description: '可选：使用某个已定义的子智能体人格 — '
-                + agents.map((a) => a.name + (a.description ? `(${a.description.slice(0, 40)})` : '')).join('；'),
-            },
-          } : {}),
-        },
-        required: ['objective'],
-      },
-    },
-  };
-
-  // 子智能体只用只读外部工具（如只读 MCP）；内置读工具由 runTurn 默认提供，写/执行被其非交互权限拒绝
-  const readOnlyExtras = extraTools.filter((t) => t.readOnly);
-
-  const run = async (args) => {
-    const agentDef = args?.agent ? agents.find((a) => a.name === args.agent) : null;
-    return dispatchSubtask({ config, cwd, readOnlyExtras, depth, objective: String(args?.objective || '').trim(), context: args?.context, agentDef });
-  };
-
-  return { readOnly: true, spec, run };
-}
-
-/**
- * 构造 dispatch_agents（并行批量）工具：一次调用把多个独立子任务并行委派给多个子智能体，聚合返回。
- * 是多智能体编排的核心——把一个大目标拆成可并行子任务同时推进，显著提速。达深度上限返回 null。
- */
-export function makeDispatchAgentsTool({ config, cwd, extraTools = [], depth = 0 }) {
-  if (depth >= MAX_DEPTH) return null;
-  const agents = loadAgents(cwd);
-  const readOnlyExtras = extraTools.filter((t) => t.readOnly);
-  const taskProps = {
-    objective: { type: 'string', description: '单一、明确、自足的子任务' },
-    context: { type: 'string', description: '可选：完成该子任务所需背景' },
-    ...(agents.length ? { agent: { type: 'string', enum: agents.map((a) => a.name), description: '可选：指定子智能体人格' } } : {}),
-  };
-  const spec = {
-    type: 'function',
-    function: {
-      name: 'dispatch_agents',
-      description:
-        '一次性把多个**独立、可并行**的子任务同时委派给多个子智能体（隔离上下文、只读工具），并行执行后聚合各自结论。'
-        + '适合把一个较大目标拆成 2-6 个可并行的调研/检索/分析子任务同时推进，显著减少串行等待。每个子任务需自足。',
-      parameters: {
-        type: 'object',
-        properties: {
-          tasks: {
-            type: 'array',
-            description: '并行子任务数组（建议 2-6 个，上限 8）',
-            items: { type: 'object', properties: taskProps, required: ['objective'] },
-          },
-        },
-        required: ['tasks'],
-      },
-    },
-  };
-  const run = async (args) => {
-    const tasks = Array.isArray(args?.tasks) ? args.tasks.slice(0, 8) : [];
-    if (!tasks.length) return '未提供 tasks（需要一个子任务数组）';
-    const results = await mapLimit(tasks, 4, async (t) => {
-      const agentDef = t?.agent ? agents.find((a) => a.name === t.agent) : null;
-      const out = await dispatchSubtask({ config, cwd, readOnlyExtras, depth, objective: String(t?.objective || '').trim(), context: t?.context, agentDef });
-      return { objective: String(t?.objective || '').replace(/\s+/g, ' ').slice(0, 80), agent: t?.agent, out };
-    });
-    return results.map((r, i) =>
-      `【子任务 ${i + 1}${r.agent ? ' · ' + r.agent : ''}】${r.objective}\n${r.out}`).join('\n\n---\n\n');
-  };
-  return { readOnly: true, spec, run };
-}
-
-function subagentPrompt(cwd, context) {
-  let p =
-    '你是一个专注的子智能体，只负责完成主智能体委派的单一子任务。要求：聚焦目标；'
-    + '用可用的只读工具（读文件 / 搜索 / 列目录等）收集信息；直接输出结构清晰、可被主智能体直接复用的最终结论，'
-    + '不要寒暄，也不要复述任务本身。\n工作目录：' + cwd + '\n';
-  if (context && String(context).trim()) p += '\n## 主智能体提供的背景\n' + context + '\n';
-  return p;
-}
+import t from"node:fs";import e from"node:path";import n from"node:os";import{runTurn as r}from"./agent.js";import{createPermissions as o}from"./permissions.js";import{parseFrontmatter as i}from"./skills.js";export function loadAgents(r){const o=[r?e.join(r,".huicai","agents"):null,e.join(n.homedir(),".huicai","agents")].filter(Boolean),a=new Map;for(const n of o){let r;try{r=t.readdirSync(n).filter(t=>t.endsWith(".md"))}catch{continue}for(const o of r){const r=o.replace(/\.md$/,"").trim();if(r&&!a.has(r))try{const s=t.readFileSync(e.join(n,o),"utf8"),c=i(s);a.set(r,{name:(c.name||r).trim(),description:c.description||"",prompt:c.body||s})}catch{}}}return[...a.values()]}async function a({config:t,cwd:e,readOnlyExtras:n,depth:i,objective:a,context:s,agentDef:c}){if(!a)return"未提供子任务目标 objective";const p=c?c.prompt.trim()+"\n\n工作目录："+e+(s&&String(s).trim()?"\n\n## 背景\n"+s:""):function(t,e){let n="你是一个专注的子智能体，只负责完成主智能体委派的单一子任务。要求：聚焦目标；用可用的只读工具（读文件 / 搜索 / 列目录等）收集信息；直接输出结构清晰、可被主智能体直接复用的最终结论，不要寒暄，也不要复述任务本身。\n工作目录："+t+"\n";e&&String(e).trim()&&(n+="\n## 主智能体提供的背景\n"+e+"\n");return n}(e,s),l=[{role:"system",content:p},{role:"user",content:a}],d=o({yolo:!1,ask:null}),m=makeSubagentTool({config:t,cwd:e,extraTools:n,depth:i+1}),g=m?[...n,m]:n,f=await r({config:t,messages:l,permissions:d,cwd:e,extraTools:g,depth:i+1,maxIters:50,io:{write:()=>{}}});if(f?.error)return`子智能体执行失败：${f.error}`;const u=[...l].reverse().find(t=>"assistant"===t.role&&t.content);return u?u.content:"(子智能体未产出结论)"}export function makeSubagentTool({config:t,cwd:e,extraTools:n=[],depth:r=0}){if(r>=2)return null;const o=loadAgents(e),i={type:"function",function:{name:"dispatch_agent",description:"把一个明确、独立、自足的子任务委派给子智能体：它在隔离上下文中自主使用（只读）工具完成后只回传结论。适合可并行的调研/检索/分析类子任务，让主线程上下文保持精简。可多次调用以分解复杂任务。",parameters:{type:"object",properties:{objective:{type:"string",description:"要子智能体完成的单一、明确、自足的子任务"},context:{type:"string",description:"可选：完成该子任务所需的背景信息"},...o.length?{agent:{type:"string",enum:o.map(t=>t.name),description:"可选：使用某个已定义的子智能体人格 — "+o.map(t=>t.name+(t.description?`(${t.description.slice(0,40)})`:"")).join("；")}}:{}},required:["objective"]}}},s=n.filter(t=>t.readOnly);return{readOnly:!0,spec:i,run:async n=>{const i=n?.agent?o.find(t=>t.name===n.agent):null;return a({config:t,cwd:e,readOnlyExtras:s,depth:r,objective:String(n?.objective||"").trim(),context:n?.context,agentDef:i})}}}export function makeDispatchAgentsTool({config:t,cwd:e,extraTools:n=[],depth:r=0}){if(r>=2)return null;const o=loadAgents(e),i=n.filter(t=>t.readOnly);return{readOnly:!0,spec:{type:"function",function:{name:"dispatch_agents",description:"一次性把多个**独立、可并行**的子任务同时委派给多个子智能体（隔离上下文、只读工具），并行执行后聚合各自结论。适合把一个较大目标拆成 2-6 个可并行的调研/检索/分析子任务同时推进，显著减少串行等待。每个子任务需自足。",parameters:{type:"object",properties:{tasks:{type:"array",description:"并行子任务数组（建议 2-6 个，上限 8）",items:{type:"object",properties:{objective:{type:"string",description:"单一、明确、自足的子任务"},context:{type:"string",description:"可选：完成该子任务所需背景"},...o.length?{agent:{type:"string",enum:o.map(t=>t.name),description:"可选：指定子智能体人格"}}:{}},required:["objective"]}}},required:["tasks"]}}},run:async n=>{const s=Array.isArray(n?.tasks)?n.tasks.slice(0,8):[];if(!s.length)return"未提供 tasks（需要一个子任务数组）";return(await async function(t,e,n){const r=new Array(t.length);let o=0;return await Promise.all(Array.from({length:Math.max(1,Math.min(e,t.length))},async()=>{for(;o<t.length;){const e=o++;r[e]=await n(t[e],e)}})),r}(s,4,async n=>{const s=n?.agent?o.find(t=>t.name===n.agent):null,c=await a({config:t,cwd:e,readOnlyExtras:i,depth:r,objective:String(n?.objective||"").trim(),context:n?.context,agentDef:s});return{objective:String(n?.objective||"").replace(/\s+/g," ").slice(0,80),agent:n?.agent,out:c}})).map((t,e)=>`【子任务 ${e+1}${t.agent?" · "+t.agent:""}】${t.objective}\n${t.out}`).join("\n\n---\n\n")}}}