deepfish-ai 2.0.9 → 2.0.12

package/dist/serve/pm2-server.js

@@ -8403,10 +8403,10 @@ var require_lib = __commonJS({
     exports2.analyse = analyse;
     var detectFile = (filepath, opts = {}) => new Promise((resolve, reject) => {
       let fd;
-      const fs21 = (0, node_1.default)();
+      const fs22 = (0, node_1.default)();
       const handler = (err, buffer) => {
         if (fd) {
-          fs21.closeSync(fd);
+          fs22.closeSync(fd);
         }
         if (err) {
           reject(err);
@@ -8418,9 +8418,9 @@ var require_lib = __commonJS({
       };
       const sampleSize = (opts === null || opts === void 0 ? void 0 : opts.sampleSize) || 0;
       if (sampleSize > 0) {
-        fd = fs21.openSync(filepath, "r");
+        fd = fs22.openSync(filepath, "r");
         let sample = Buffer.allocUnsafe(sampleSize);
-        fs21.read(fd, sample, 0, sampleSize, opts.offset, (err, bytesRead) => {
+        fs22.read(fd, sample, 0, sampleSize, opts.offset, (err, bytesRead) => {
           if (err) {
             handler(err, null);
           } else {
@@ -8432,22 +8432,22 @@ var require_lib = __commonJS({
         });
         return;
       }
-      fs21.readFile(filepath, handler);
+      fs22.readFile(filepath, handler);
     });
     exports2.detectFile = detectFile;
     var detectFileSync = (filepath, opts = {}) => {
-      const fs21 = (0, node_1.default)();
+      const fs22 = (0, node_1.default)();
       if (opts && opts.sampleSize) {
-        const fd = fs21.openSync(filepath, "r");
+        const fd = fs22.openSync(filepath, "r");
         let sample = Buffer.allocUnsafe(opts.sampleSize);
-        const bytesRead = fs21.readSync(fd, sample, 0, opts.sampleSize, opts.offset);
+        const bytesRead = fs22.readSync(fd, sample, 0, opts.sampleSize, opts.offset);
         if (bytesRead < opts.sampleSize) {
           sample = sample.subarray(0, bytesRead);
         }
-        fs21.closeSync(fd);
+        fs22.closeSync(fd);
         return (0, exports2.detect)(sample);
       }
-      return (0, exports2.detect)(fs21.readFileSync(filepath));
+      return (0, exports2.detect)(fs22.readFileSync(filepath));
     };
     exports2.detectFileSync = detectFileSync;
     exports2.default = {
@@ -8542,6 +8542,13 @@ var ADD_MODEL_Config = {
 // src/cli/cli-utils/getGlobalPath.ts
 var import_path2 = __toESM(require("path"));
 var import_fs_extra = __toESM(require("fs-extra"));
+
+// src/cli/cli-utils/node-root.ts
+var { execSync } = require("child_process");
+var path2 = require("path");
+var fs = require("fs");
+
+// src/cli/cli-utils/getGlobalPath.ts
 var getDirname = () => __dirname;
 function getCodePath() {
   let dir = getDirname();
@@ -9516,10 +9523,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path15) {
-  if (!path15)
+function getElementAtPath(obj, path16) {
+  if (!path16)
     return obj;
-  return path15.reduce((acc, key) => acc?.[key], obj);
+  return path16.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -9928,11 +9935,11 @@ function explicitlyAborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path15, issues) {
+function prefixIssues(path16, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path15);
+    iss.path.unshift(path16);
     return iss;
   });
 }
@@ -10079,16 +10086,16 @@ function flattenError(error51, mapper = (issue2) => issue2.message) {
 }
 function formatError(error51, mapper = (issue2) => issue2.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error52, path15 = []) => {
+  const processError = (error52, path16 = []) => {
     for (const issue2 of error52.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path15, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path16, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path15, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path16, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path15, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path16, ...issue2.path]);
       } else {
-        const fullpath = [...path15, ...issue2.path];
+        const fullpath = [...path16, ...issue2.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue2));
         } else {
@@ -10115,17 +10122,17 @@ function formatError(error51, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error51, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error52, path15 = []) => {
+  const processError = (error52, path16 = []) => {
     var _a3, _b;
     for (const issue2 of error52.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path15, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path16, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path15, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path16, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path15, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path16, ...issue2.path]);
       } else {
-        const fullpath = [...path15, ...issue2.path];
+        const fullpath = [...path16, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -10157,8 +10164,8 @@ function treeifyError(error51, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path15 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path15) {
+  const path16 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path16) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -22850,13 +22857,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path15 = ref.slice(1).split("/").filter(Boolean);
-  if (path15.length === 0) {
+  const path16 = ref.slice(1).split("/").filter(Boolean);
+  if (path16.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path15[0] === defsKey) {
-    const key = path15[1];
+  if (path16[0] === defsKey) {
+    const key = path16[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -23272,8 +23279,8 @@ var import_langchain = require("langchain");
 var import_messages = require("@langchain/core/messages");
 
 // src/agent/AIAgent/utils/skill-parser.ts
-var fs5 = require("fs-extra");
-var path5 = require("path");
+var fs6 = require("fs-extra");
+var path6 = require("path");
 var yaml = require_js_yaml();
 
 // src/agent/AIAgent/system-prompt.ts
@@ -23503,20 +23510,17 @@ var import_fs_extra7 = __toESM(require("fs-extra"));
 
 // src/agent/tools/subAgent.ts
 var import_langchain4 = require("langchain");
-async function subAgentExec(prompt, runtime) {
+async function subAgentExec(systemPrompt, prompt, runtime) {
   const curAgent = runtime.context?.curAgent;
-  if (!curAgent || typeof curAgent.createSubAgent !== "function") {
-    throw new Error("\u5F53\u524D\u8FD0\u884C\u4E0A\u4E0B\u6587\u4E0D\u652F\u6301\u521B\u5EFA\u5B50 agent");
-  }
-  const subAgent = await curAgent.createSubAgent();
-  return subAgent.execute(prompt);
+  return curAgent && curAgent.subExecute(systemPrompt, prompt);
 }
 var subAgentTool = (0, import_langchain4.tool)(
-  async ({ prompt }, runtime) => safeTool(() => subAgentExec(prompt, runtime)),
+  async ({ systemPrompt, prompt }, runtime) => safeTool(() => subAgentExec(systemPrompt, prompt, runtime)),
   {
     name: "subAgent_exec",
     description: "\u521B\u5EFA\u4E00\u4E2A\u901A\u7528\u5B50 agent \u6765\u6267\u884C\u72EC\u7ACB\u4EFB\u52A1\uFF0C\u5E76\u8FD4\u56DE\u5B50 agent \u7684\u6267\u884C\u7ED3\u679C\u3002\u9002\u5408\u62C6\u5206\u590D\u6742\u4EFB\u52A1\u3001\u5E76\u884C\u8C03\u7814\u6216\u59D4\u6D3E\u5B50\u4EFB\u52A1\u3002",
     schema: external_exports.object({
+      systemPrompt: external_exports.string().min(1).describe("\u5B50 agent \u7684\u7CFB\u7EDF\u63D0\u793A\u8BCD\uFF0C\u5B9A\u4E49\u5176\u89D2\u8272\u548C\u884C\u4E3A\u89C4\u8303"),
       prompt: external_exports.string().min(1).describe("\u4EA4\u7ED9\u901A\u7528\u5B50 agent \u6267\u884C\u7684\u5B8C\u6574\u4EFB\u52A1\u63CF\u8FF0")
     })
   }
@@ -23597,7 +23601,7 @@ var installPackageTool = (0, import_langchain5.tool)(
 );
 var executeJSCodeTool = (0, import_langchain5.tool)(async ({ code }, runtime) => safeTool(() => executeJSCode(code, runtime)), {
   name: "execute_js_code",
-  description: `\u6267\u884C\u4E00\u6BB5Node.js\u4EE3\u7801\u5E76\u8FD4\u56DE\u6267\u884C\u7ED3\u679C\u3002\u6CE8\u610F\uFF1A\u4EE3\u7801\u5FC5\u987B\u5305\u542B\u4E00\u4E2A__main()\u51FD\u6570\u4F5C\u4E3A\u6267\u884C\u5165\u53E3\uFF0C__main()\u51FD\u6570\u5185\u5FC5\u987B\u662F\u4E00\u4E2A\u4F7F\u7528async\u524D\u7F00\u7684\u51FD\u6570\u3002
+  description: `\u6267\u884C\u4E00\u6BB5Node.js\u4EE3\u7801\u5E76\u8FD4\u56DE\u6267\u884C\u7ED3\u679C\u3002\u6CE8\u610F\uFF1A1.\u5982\u679C\u4EE3\u7801\u4E2D\u4F7F\u7528\u7B2C\u4E09\u65B9\u4F9D\u8D56\u5FC5\u987B\u5148\u4F7F\u7528check_package_installed\u5DE5\u5177\u68C0\u67E5\u5305\u662F\u5426\u5B89\u88C5\uFF0C\u5982\u679C\u672A\u5B89\u88C5\u9700\u8981\u6267\u884Cinstall_package\u5DE5\u5177\u5B89\u88C5\u6307\u5B9A\u7684npm\u5305;2.\u4EE3\u7801\u5FC5\u987B\u5305\u542B\u4E00\u4E2A__main()\u51FD\u6570\u4F5C\u4E3A\u6267\u884C\u5165\u53E3\uFF0C__main()\u51FD\u6570\u5185\u5FC5\u987B\u662F\u4E00\u4E2A\u4F7F\u7528async\u524D\u7F00\u7684\u51FD\u6570\u3002
         \u53EF\u7528\u5185\u7F6E\u51FD\u6570\uFF1A
         - agentExec(prompt: string): Promise<string>\uFF0C\u521B\u5EFA\u4E00\u4E2A\u901A\u7528\u5B50 agent \u6267\u884C\u6307\u5B9A\u4EFB\u52A1\u5E76\u8FD4\u56DE\u7ED3\u679C\uFF0C\u9002\u5408\u5C06\u590D\u6742\u4EFB\u52A1\u62C6\u5206\u7ED9\u5B50 agent \u5B8C\u6210\u3002
         \u793A\u4F8B\u4EE3\u7801\uFF1A
@@ -24211,7 +24215,10 @@ Commands:
   ai skills generate xxx            \u6839\u636E\u63CF\u8FF0\u751F\u6210\u4E00\u4E2A\u65B0\u7684\u6280\u80FD\u6A21\u677F
 
   # Tools commands
+  ai tools ls                       \u67E5\u770B\u5DF2\u5B89\u88C5\u6216\u5DF2\u914D\u7F6E\u7684\u5DE5\u5177\u5217\u8868
   ai tools dir                      \u6253\u5F00\u6216\u8F93\u51FA\u7528\u6237\u81EA\u5B9A\u4E49\u5DE5\u5177\u76EE\u5F55
+  ai tools add <name>               \u6DFB\u52A0\u6307\u5B9A\u540D\u79F0\u7684\u5DE5\u5177
+  ai tools del <index>              \u5220\u9664\u6307\u5B9A\u5E8F\u53F7\u7684\u81EA\u5B9A\u4E49\u5DE5\u5177
   ai tools generate xxx             \u6839\u636E\u63CF\u8FF0\u751F\u6210\u4E00\u4E2A\u65B0\u7684\u5DE5\u5177\u6A21\u677F
 
   # Session commands
@@ -24223,9 +24230,15 @@ Commands:
   ai task add <task>                \u5411\u4EFB\u52A1\u961F\u5217\u6DFB\u52A0\u4E00\u4E2A\u540E\u7EED\u4EFB\u52A1
   ai task del <index>               \u5220\u9664\u6307\u5B9A\u5E8F\u53F7\u7684\u4EFB\u52A1
   ai task clear                     \u6E05\u7A7A\u5F53\u524D\u4EFB\u52A1\u961F\u5217
+
+  # Plan commands
+  ai plan-do <\u4EFB\u52A1\u63CF\u8FF0>              \u5C06\u590D\u6742\u4EFB\u52A1\u62C6\u89E3\u4E3A\u5B50\u4EFB\u52A1\u5E76\u9010\u6B65\u6267\u884C\u5B8C\u6210
   
   # MCP commands
   ai mcp edit                       \u6253\u5F00 MCP \u914D\u7F6E\u6587\u4EF6\u8FDB\u884C\u7F16\u8F91
+  ai mcp ls                         \u67E5\u770B\u5DF2\u914D\u7F6E\u7684 MCP \u670D\u52A1\u5668\u5217\u8868
+  ai mcp enable <name|index>        \u542F\u7528\u6307\u5B9A\u540D\u79F0\u6216\u5E8F\u53F7\u7684 MCP \u670D\u52A1\u5668
+  ai mcp disable <name|index>       \u7981\u7528\u6307\u5B9A\u540D\u79F0\u6216\u5E8F\u53F7\u7684 MCP \u670D\u52A1\u5668
   
   # Serve commands
   ai serve                          \u542F\u52A8\u670D\u52A1\u6216\u8FDB\u5165\u670D\u52A1\u7BA1\u7406\u5165\u53E3
@@ -24538,14 +24551,14 @@ function startAgentRoomServer(opts = {}) {
     logWarning("[agent-room] Service already running");
     return wss;
   }
-  const path15 = opts.path ?? "/agent-room";
+  const path16 = opts.path ?? "/agent-room";
   if (opts.httpServer) {
-    wss = new import_ws2.WebSocketServer({ server: opts.httpServer, path: path15 });
-    logSuccess(`[agent-room] started, path=${path15}`);
+    wss = new import_ws2.WebSocketServer({ server: opts.httpServer, path: path16 });
+    logSuccess(`[agent-room] started, path=${path16}`);
   } else {
     const port = opts.port ?? PORT2;
-    wss = new import_ws2.WebSocketServer({ port, path: path15 });
-    logSuccess(`[agent-room] started: ws://localhost:${port}${path15}`);
+    wss = new import_ws2.WebSocketServer({ port, path: path16 });
+    logSuccess(`[agent-room] started: ws://localhost:${port}${path16}`);
   }
   wss.on("connection", handleConnection);
   return wss;

package/dist/{generate-skill.md → skills/generate-skill.md}

@@ -18,7 +18,7 @@ homepage: ''
 
 1. **目录创建**：在当前工作目录下新建一个子目录，目录名称应简洁明了地反映 Skill 功能（如 `web-scraper`、`code-reviewer`、`image-optimizer` 等）
 2. **核心文件**：目录中必须包含 `SKILL.md` 文件（文件名大小写敏感，必须为 `SKILL.md`）
-3. **辅助文件**：如果 Skill 涉及复杂逻辑，可在目录中创建辅助脚本文件（如 `.js`、`.sh`、`.py` 等），并在 `SKILL.md` 中说明其用途和调用方式；如果是 js 文件，可以在函数中通过 `this.Tools` 调用内置函数，如直接使用 `this.Tools.createSubAgent(workGoal)`
+3. **辅助文件**：如果 Skill 涉及复杂逻辑，可在目录中创建辅助脚本文件（如 `.js`、`.sh`、`.py` 等），并在 `SKILL.md` 中说明其用途和调用方式；如果是 js 文件，可以在函数中通过 `this.Tools` 调用内置函数，如直接使用 `this.Tools.createSubAgent(systemPrompt:string, workGoal:string)`
 
 #### 标准目录结构
 

package/dist/{generate-tool.md → skills/generate-tool.md}

@@ -85,7 +85,7 @@ module.exports = { functions, descriptions };
 1. 理解用户要生成的工具功能
 2. 在当前工作目录下创建 `deepfish-tool-{功能名}/` 目录
 3. 编写 `index.js`，导出 `functions` 和 `descriptions`
-4. 对于需要Agent参与的复杂任务，可以直接使用 `this.createSubAgent(prompt: string)` 创建子 Agent 执行任务，并将任务说明作为 `prompt` 传入
+4. 对于需要Agent参与的复杂任务，可以直接使用 `this.createSubAgent(systemPrompt: string, prompt: string)` 创建子 Agent 执行任务，并将任务说明作为 `prompt` 传入
 5. 需要引入第三方模块时，需要将该tool创建成NodeJs项目，在tool中引入模块
 
 ## 生成说明文档

package/dist/skills/planning-do.md

@@ -0,0 +1,90 @@
+---
+name: 'planning-do'
+description: '将复杂长任务拆分为子任务，通过子 Agent 逐步执行完成'
+homepage: ''
+---
+
+# 长任务规划执行 Skill
+
+当你收到一个复杂的长任务时，使用本 Skill 将其拆分为可执行的子任务，并通过子 Agent 逐步执行完成。
+
+## 工作流程
+
+整个流程分为两个阶段，**必须按顺序执行**：
+
+### 阶段一：创建任务列表
+
+创建一个子 Agent，传入以下系统提示词，让子 Agent 负责将用户目标拆解为子任务：
+
+**子 Agent 系统提示词：**
+
+```
+你是任务分析专家，负责将用户的目标拆解为可执行的子任务。
+
+工作流程：
+1. 分析用户的任务描述，判断是否足够清晰具体；
+2. 如果用户描述模糊、缺少关键信息或存在多种可能性，**必须与用户交互来收敛需求**：
+   - 使用选择题方式让用户选择（如："项目类型是 A. 前端项目 B. 后端项目 C. 全栈项目？"）
+   - 结合输入框让用户补充具体信息（如："请描述项目的核心功能"）
+   - 一次最多问8个问题，避免一次性问太多
+   - 持续交互直到需求足够清晰，能够拆解为具体的子任务
+3. 将收敛后的完整需求作为用户的原始任务描述；
+4. 在当前目录创建 tmp_task_goal.md，记录收敛后的完整需求描述；
+5. 创建 tmp_tasklist.json，包含拆解后的子任务列表。
+
+tmp_tasklist.json 格式要求：
+- 必须是合法的 JSON 数组
+- 每个任务对象包含以下字段：
+  - id: 任务唯一标识（字符串或数字）
+  - name: 任务名称（简洁明了）
+  - description: 任务详细说明
+  - status: 任务状态，初始为 "todo"
+  - createdAt: 创建时间（ISO 字符串）
+  - finishedAt: 完成时间（未完成时为 null）
+  - note: 备注（可为空字符串）
+
+拆分原则：
+- 任务尽量原子化，每个任务只做一件事
+- 任务之间尽量独立，减少依赖
+- 按执行顺序排列
+
+输出要求：仅输出合法 JSON，不要输出解释文字。
+```
+
+**子 Agent 的用户提示词：** 用户的原始任务描述。
+
+### 阶段二：执行任务列表
+
+创建一个子 Agent，传入以下系统提示词，让子 Agent 负责按顺序执行子任务：
+
+**子 Agent 系统提示词：**
+
+```
+你负责按顺序执行 tmp_tasklist.json 中的子任务，完成 tmp_task_goal.md 描述的整体目标。
+
+执行规则：
+1. 先读取 tmp_task_goal.md 了解整体目标；
+2. 读取 tmp_tasklist.json，仅处理 status 为 "todo" 或 "doing" 的任务；
+3. 每次只执行一个子任务，按列表顺序依次执行；
+4. 执行前将当前任务 status 更新为 "doing" 并写回文件；
+5. 执行成功后更新 status 为 "done"，并记录 finishedAt（ISO 时间）；
+6. 执行失败时保留为 "doing" 或回退为 "todo"，在 note 中记录失败原因；
+7. 每完成一个子任务必须立即写回 tmp_tasklist.json；
+8. 尽量将具体执行工作交给子 agent 完成，主流程只负责调度和状态管理；
+9. 告知子 agent 任务列表的文件名为 tmp_tasklist.json；
+10. 全部任务完成后，删除 tmp_tasklist.json 和 tmp_task_goal.md。
+
+输出要求：
+- 输出当前执行的任务 id、名称、结果状态和下一步计划；
+- 不要跳过状态更新和文件写入步骤。
+```
+
+**子 Agent 的用户提示词：** 用户的原始任务描述。
+
+## 注意事项
+
+1. **必须分两个阶段执行**：先创建任务列表，再执行任务列表，不能合并
+2. **子 Agent 只做一件事**：阶段一只负责拆解任务，阶段二只负责按顺序执行
+3. **文件持久化**：任务状态通过 `tmp_tasklist.json` 文件持久化，子 Agent 崩溃后可以重新读取继续执行
+4. **清理临时文件**：全部任务完成后必须删除 `tmp_tasklist.json` 和 `tmp_task_goal.md`
+5. **原子化执行**：每个子任务只做一件事，执行完立即更新状态并写回文件

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepfish-ai",
-  "version": "2.0.9",
+  "version": "2.0.12",
   "private": false,
   "description": "An efficient AI-driven command-line tool designed to bridge the gap between natural language and operating system commands, file operations, and more. It enables non-developers to quickly generate executable instructions through simple natural language descriptions, significantly improving terminal operation efficiency.",
   "repository": {
@@ -27,7 +27,7 @@
     "dist/"
   ],
   "scripts": {
-    "build": "tsup && npm run build:ui",
+    "build": "tsup && node -e \"const fs=require('fs-extra'),p=require('path');const src=p.join(process.cwd(),'src/agent/skills'),dst=p.join(process.cwd(),'dist/skills');fs.ensureDirSync(dst);fs.readdirSync(src).filter(f=>f.endsWith('.md')).forEach(f=>fs.copySync(p.join(src,f),p.join(dst,f)))\" && npm run build:ui",
     "build:ui": "vite build && vite build --config vite.server.config.ts",
     "dev": "tsx src/cli/index.ts",
     "format": "prettier --write \"src/**/*.{ts,js,json,css,md}\"",