ai-helper-agent 1.12.1 → 1.12.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-helper-agent",
-  "version": "1.12.1",
+  "version": "1.12.3",
   "description": "AI Helper 代理服务 - 为 Chrome 扩展提供本地文件读写和系统命令执行能力",
   "type": "module",
   "main": "./src/server.js",

package/src/executor.js

@@ -370,10 +370,8 @@ function killProcess(execId) {
 
   if (isWin) {
     // Windows: /T 递归终止整个进程树
-    exec(`taskkill /T /PID ${pid}`, (err) => {
-      if (err) {
-        exec(`taskkill /F /T /PID ${pid}`, () => {});
-      }
+    spawn('taskkill', ['/T', '/PID', String(pid)], { windowsHide: true }).on('error', () => {
+      spawn('taskkill', ['/F', '/T', '/PID', String(pid)], { windowsHide: true });
     });
   } else {
     // Unix: 负 PID 表示杀整个进程组（detached + 未调用 setsid 时有效）
@@ -399,7 +397,7 @@ function killProcess(execId) {
     try {
       if (entry.process.exitCode === null) {
         if (isWin) {
-          exec(`taskkill /F /T /PID ${pid}`, () => {});
+          spawn('taskkill', ['/F', '/T', '/PID', String(pid)], { windowsHide: true });
         } else {
           try { process.kill(-pid, 'SIGKILL'); }
           catch { try { entry.process.kill('SIGKILL'); } catch {} }

package/src/search.js

@@ -2,7 +2,7 @@
 import { spawn } from 'child_process';
 import { readdir, stat, readFile } from 'fs/promises';
 import { statSync } from 'fs';
-import { join, basename, extname, resolve } from 'path';
+import { join, basename, extname, resolve, isAbsolute } from 'path';
 import { checkPath } from './security.js';
 
 // 缓存检测结果，避免每次启动重复检测
@@ -112,7 +112,7 @@ function searchWithFd(rootPath, filePattern, recursive, maxResults) {
       const output = Buffer.concat(stdout).toString('utf-8').trim();
       const lines = output ? output.split('\n').filter(Boolean) : [];
       const results = lines.map(p => {
-        const absPath = join(rootPath, p);
+        const absPath = isAbsolute(p) ? p : join(rootPath, p);
         try {
           const s = statSync(absPath);
           return { path: absPath, name: basename(p), type: s.isDirectory() ? 'directory' : 'file', size: s.size, mtime: s.mtimeMs };

package/src/server.js

@@ -420,6 +420,7 @@ export function startServer() {
         version: AGENT_VERSION,
         running: true,
         platform: PLATFORM_INFO.platform,
+        platformName: PLATFORM_INFO.platformName,
         arch: PLATFORM_INFO.arch,
         nodeVersion: PLATFORM_INFO.nodeVersion,
         searchTools: getSearchToolsAvailable()
@@ -537,7 +538,8 @@ export function startServer() {
           const result = await new Promise((resolvePromise) => {
             const npm = spawn('npm', ['install', '-g', 'ai-helper-agent@latest', '--no-audit', '--no-fund'], {
               shell: true,
-              env: { ...process.env }
+              env: { ...process.env },
+              windowsHide: true
             });
             npm.stdout.on('data', d => npmOutput.push(d.toString().trim()));
             npm.stderr.on('data', d => npmOutput.push(d.toString().trim()));

package/src/skill/executor.js

@@ -1,9 +1,9 @@
 // skill/executor.js - Skill 执行引擎
 // 解析 Skill 定义的步骤 DAG，按拓扑排序执行，支持并行
 import { render } from './template.js';
-import { readFile, writeFile, readdir, stat } from 'fs/promises';
+import { readFile, writeFile, readdir, stat, unlink } from 'fs/promises';
 import { checkPath, checkCommand } from '../security.js';
-import { join } from 'path';
+import { join, basename } from 'path';
 
 // 执行上下文（当前活跃的执行任务）
 const activeExecutions = new Map(); // execId → { skill, status, steps, results }
@@ -47,32 +47,53 @@ async function executeToolCall(toolName, args) {
   // 映射 Skill 步骤中的 tool 到实际 Agent API
   try {
     switch (toolName) {
-      case 'agent_read_file': {
-        const check = await checkPath(args.path);
-        if (!check.allowed) return { success: false, error: check.reason };
-        const content = await readFile(check.resolved, 'utf-8');
-        return { success: true, content, size: content.length, path: check.resolved };
-      }
-
-      case 'agent_write_file': {
+      case 'agent_file':
+      case 'agent_read_file':
+      case 'agent_write_file':
+      case 'agent_list_dir':
+      case 'agent_delete_file':
+      case 'agent_download_file': {
+        const action = args.action || (
+          toolName === 'agent_read_file' ? 'read' :
+          toolName === 'agent_write_file' ? 'write' :
+          toolName === 'agent_list_dir' ? 'list' :
+          toolName === 'agent_delete_file' ? 'delete' :
+          toolName === 'agent_download_file' ? 'download' :
+          (args.content ? 'write' : 'read')
+        );
         const check = await checkPath(args.path);
         if (!check.allowed) return { success: false, error: check.reason };
-        await writeFile(check.resolved, String(args.content || ''), 'utf-8');
-        return { success: true, message: `文件已写入: ${check.resolved}` };
-      }
-
-      case 'agent_list_dir': {
-        const check = await checkPath(args.path || '.');
-        if (!check.allowed) return { success: false, error: check.reason };
-        const names = await readdir(check.resolved);
-        const entries = await Promise.all(names.map(async (name) => {
-          const s = await stat(join(check.resolved, name));
-          return { name, type: s.isDirectory() ? 'directory' : 'file', size: s.size };
-        }));
-        return { success: true, entries, path: check.resolved };
+        switch (action) {
+          case 'read': {
+            const content = await readFile(check.resolved, 'utf-8');
+            return { success: true, content, size: content.length, path: check.resolved };
+          }
+          case 'write': {
+            await writeFile(check.resolved, String(args.content || ''), 'utf-8');
+            return { success: true, message: `文件已写入: ${check.resolved}` };
+          }
+          case 'list': {
+            const names = await readdir(check.resolved);
+            const entries = await Promise.all(names.map(async (name) => {
+              const s = await stat(join(check.resolved, name));
+              return { name, type: s.isDirectory() ? 'directory' : 'file', size: s.size };
+            }));
+            return { success: true, entries, path: check.resolved };
+          }
+          case 'delete': {
+            await unlink(check.resolved);
+            return { success: true, message: `已删除: ${check.resolved}` };
+          }
+          case 'download': {
+            const content = await readFile(check.resolved);
+            return { success: true, content, path: check.resolved, filename: basename(check.resolved) };
+          }
+          default:
+            return { success: false, error: `未知 action: ${action}` };
+        }
       }
 
-      case 'agent_exec_command': {
+      case 'agent_exec': {
         const cmdCheck = checkCommand(args.command, false);
         if (cmdCheck.level === 'deny') {
           return { success: false, error: cmdCheck.reason };
@@ -87,7 +108,8 @@ async function executeToolCall(toolName, args) {
             cwd: args.cwd || process.cwd(),
             encoding: 'utf-8',
             timeout: 30000,
-            maxBuffer: 10 * 1024 * 1024
+            maxBuffer: 10 * 1024 * 1024,
+            windowsHide: true
           }, (error, stdout, stderr) => {
             if (error) {
               resolve({ success: false, error: error.message, stdout, stderr });
@@ -98,8 +120,23 @@ async function executeToolCall(toolName, args) {
         });
       }
 
-      case 'agent_search_files': {
-        const { searchFiles } = await import('../search.js');
+      case 'agent_search':
+      case 'agent_search_files':
+      case 'agent_search_content': {
+        const searchType = args.searchType || (
+          toolName === 'agent_search_content' ? 'content' : 'file'
+        );
+        const { searchFiles, searchContent } = await import('../search.js');
+        if (searchType === 'content') {
+          return await searchContent(
+            args.path || '.',
+            args.pattern,
+            args.filePattern || null,
+            args.caseSensitive || false,
+            Math.min(args.maxResults || 100, 5000),
+            args.contextLines || 2
+          );
+        }
         return await searchFiles(
           args.path || '.',
           args.pattern || '*',
@@ -108,18 +145,6 @@ async function executeToolCall(toolName, args) {
         );
       }
 
-      case 'agent_search_content': {
-        const { searchContent } = await import('../search.js');
-        return await searchContent(
-          args.path || '.',
-          args.pattern,
-          args.filePattern || null,
-          args.caseSensitive || false,
-          Math.min(args.maxResults || 100, 5000),
-          args.contextLines || 2
-        );
-      }
-
       default:
         return { success: false, error: `未知工具: ${toolName}` };
     }

package/src/skill/loader.js

@@ -256,19 +256,23 @@ export function deleteSkillFile(name, type) {
 /**
  * 种子 skill-creator 内置技能到文件系统
  * 首次运行时将 skill-creator 的 SKILL.md 写入 ~/.ai-helper-agent/skills/skill-creator/
- * 之后用户可在工具箱中编辑、优化此技能（如调整为 Windows cmd 兼容）
+ * 当种子版本号高于已安装版本时自动更新
  * @returns {boolean} 是否执行了种子写入
  */
 export function seedSkillCreator() {
   const skillDir = join(SKILLS_DIR, SKILL_CREATOR_DIR);
   const skillMdPath = join(skillDir, 'SKILL.md');
 
+  // 从种子内容中提取目标版本号
+  const seedVersionMatch = SKILL_CREATOR_SEED_MD.match(/^version:\s*([\d.]+)/m);
+  const seedVersion = seedVersionMatch ? seedVersionMatch[1] : '0.0.0';
+
   if (existsSync(skillMdPath)) {
     try {
       const content = readFileSync(skillMdPath, 'utf-8');
       const versionMatch = content.match(/^version:\s*([\d.]+)/m);
-      const currentVersion = versionMatch ? versionMatch[1] : '0.0.0';
-      if (currentVersion === '1.1.0') {
+      const installedVersion = versionMatch ? versionMatch[1] : '0.0.0';
+      if (installedVersion === seedVersion) {
         return false;
       }
     } catch { /* 读取失败则覆盖 */ }

package/src/skill/markdown-loader.js

@@ -360,7 +360,7 @@ export async function importMarkdownSkillFromZip(skillsDir, zipBuffer, skillName
     writeFileSync(tmpZip, zipBuffer);
 
     // 解压到临时目录（execFile 数组参数，不经 shell，杜绝命令注入）
-    await execFileAsync('unzip', ['-o', tmpZip, '-d', tmpDir], { timeout: 30000 });
+    await execFileAsync('unzip', ['-o', tmpZip, '-d', tmpDir], { timeout: 30000, windowsHide: true });
 
     // 查找 SKILL.md
     const entries = readdirSync(tmpDir);
@@ -414,7 +414,7 @@ export async function importMarkdownSkillFromZip(skillsDir, zipBuffer, skillName
     }
 
     // 复制（execFile 数组参数，不经 shell）
-    await execFileAsync('cp', ['-r', skillDir + '/.', destDir], { timeout: 30000 });
+    await execFileAsync('cp', ['-r', skillDir + '/.', destDir], { timeout: 30000, windowsHide: true });
 
     // 重新加载
     const skill = loadMarkdownSkill(destDir);

package/src/skill/registry.js

@@ -194,7 +194,7 @@ export async function runSkill(name, params = {}, onStepUpdate) {
 /**
  * 获取所有启用的 Agent Skill 的轻量列表
  * 仅包含名称和描述，用于注入到 AI System Prompt 中。
- * AI 需要使用 agent_skill_load 工具按需加载完整内容。
+ * AI 需要使用 agent_skill 工具按需加载完整内容。
  * @returns {string} - 格式化的技能列表文本
  */
 export function getAgentSkillPrompts() {
@@ -210,7 +210,7 @@ export function getAgentSkillPrompts() {
   const parts = [];
   parts.push('## 可用技能 (Skills)');
   parts.push('');
-  parts.push('以下是可用的 Agent Skill（AI 能力扩展）列表。当用户需求与某个技能高度匹配时，使用 `agent_skill_load` 工具加载该技能的完整说明，然后根据说明自主完成任务。');
+  parts.push('以下是可用的 Agent Skill（AI 能力扩展）列表。当用户需求与某个技能高度匹配时，使用 `agent_skill` 工具（action: load）加载该技能的完整说明，然后根据说明自主完成任务。');
   parts.push('');
   parts.push('**使用策略**：');
   parts.push('- 仅在用户需求明确匹配技能描述时才加载，不要为一般性的编程/技术问题加载技能');

package/src/skill/skill-creator-seed.js

@@ -8,7 +8,7 @@ export const SKILL_CREATOR_SEED_MD = `---
 name: skill-creator
 description: "创建新技能的元技能。当用户要求创建技能、沉淀技能、新增技能、或任何创建/添加技能的意图时，必须立即调用此技能。"
 enabled: true
-version: 1.1.0
+version: 1.2.1
 ---
 
 # Skill Creator
@@ -99,18 +99,20 @@ enabled: true
    - 示例（正例和反例）
    - 注意事项（容易踩的坑）
 
+   > 💡 **多轮对话沉淀技巧**：当对话涉及多轮工具调用（ReAct 循环）时，先调用 \`exec_log\` 工具（scope: full_session）提取完整的执行日志。从**成功路径**中提炼经过验证的有效操作步骤，从**失败教训**中提炼注意事项和避坑指南，从**反思建议**中提炼优化方案。这能确保沉淀的技能内容覆盖完整的操作过程，而不仅仅是最终结果。
+
 4. **创建技能目录**：
-   - 使用 \`agent_exec_command\` 创建技能子目录。
+   - 使用 \`agent_exec\` 创建技能子目录。
    - **macOS/Linux**：\`mkdir -p ~/.ai-helper-agent/skills/<skill-name>\`
    - **Windows (cmd)**：\`mkdir %USERPROFILE%\\.ai-helper-agent\\skills\\<skill-name>\`
    - **Windows (PowerShell)**：\`New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\\.ai-helper-agent\\skills\\<skill-name>"\`
-   - 如果 \`mkdir\` 报错，尝试不带参数或使用 \`agent_write_file\` 工具在目标路径写入一个临时文件，让系统自动创建父目录。
+   - 如果 \`mkdir\` 报错，尝试不带参数或使用 \`agent_file\`（action: write）在目标路径写入一个临时文件，让系统自动创建父目录。
 
-5. **写入 SKILL.md**：使用 \`agent_write_file\` 工具将内容写入目标文件。
+5. **写入 SKILL.md**：使用 \`agent_file\`（action: write）工具将内容写入目标文件。
 
-   > ⚠️ **关键限制**：\`agent_write_file\` 不接受 \`~\` 或相对路径，**必须传入绝对路径**。
+   > ⚠️ **关键限制**：\`agent_file\` 不接受 \`~\` 或相对路径，**必须传入绝对路径**。
 
-   **推荐做法**：先用 \`agent_exec_command\` 获取用户主目录的绝对路径，再拼接完整路径。
+   **推荐做法**：先用 \`agent_exec\` 获取用户主目录的绝对路径，再拼接完整路径。
 
 6. **告知用户**：创建完成后，告知用户技能已就绪，说明触发关键词。建议用户在工具箱页面点击「重新加载」使技能生效。
 
@@ -119,10 +121,10 @@ enabled: true
 当用户要求更新/完善已有技能时：
 
 1. **确认技能名称**：与用户确认要更新的技能名称
-2. **读取现有内容**：使用 \`agent_read_file\` 读取目标 SKILL.md（路径规则同创建流程，需使用绝对路径，如 \`/Users/<你的用户名>/.ai-helper-agent/skills/<skill-name>/SKILL.md\`）
+2. **读取现有内容**：使用 \`agent_file\`（action: read）读取目标 SKILL.md（路径规则同创建流程，需使用绝对路径，如 \`/Users/<你的用户名>/.ai-helper-agent/skills/<skill-name>/SKILL.md\`）
 3. **分析更新需求**：结合当前对话上下文，识别需要更新的部分
 4. **合并内容**：保留原技能的核心结构，将新内容融入适当位置
-5. **覆盖写入**：使用 \`agent_write_file\` 覆盖写入 SKILL.md（路径规则同上，必须使用绝对路径）
+5. **覆盖写入**：使用 \`agent_file\`（action: write）覆盖写入 SKILL.md（路径规则同上，必须使用绝对路径）
 6. **告知用户**：告知更新内容，建议重新加载
 
 ## 更新注意事项