deepfish-ai 1.0.17 → 1.0.18

package/README.md

@@ -10,13 +10,13 @@
     alt="WeChat"
     src="https://img.shields.io/badge/WeChat-MrRoman_123-green.svg"
   />
-  <a href="https://github.com/qq306863030/deepfish">
+  <a href="https://github.com/qq306863030/deepfish-ai">
     <img
       alt="GitHub"
-      src="https://img.shields.io/badge/GitHub-DeepFish-blue.svg"
+      src="https://img.shields.io/badge/GitHub-DeepFish AI-blue.svg"
   /></a>
-  <a href="https://www.npmjs.com/package/deepfish">
-    <img alt="NPM" src="https://img.shields.io/badge/NPM-DeepFish-blue.svg"
+  <a href="https://www.npmjs.com/package/deepfish-ai">
+    <img alt="NPM" src="https://img.shields.io/badge/NPM-DeepFish AI-blue.svg"
   /></a>
   <img
     alt="Code License"
@@ -289,6 +289,9 @@ ai "Classify all files under the 'model' directory into the 'model2' directory b
 ```bash
 ai "Create a task list: 1.xxxx; 2.xxxx; ..."
 ai "Execute task list" # Start execution
+
+ai "I want to implement an extension tool for long-form novel writing that supports large-scale writing, maintains contextual logic coherence, and avoids AI context explosion issues. This extension tool may be a bit complex to implement. You need to carefully read the extension tool generation rules first, then create a task list"
+ai "Execute task list" # Start execution
 ```
 
 ## 6. Extension Development

package/README_CN.md

@@ -10,13 +10,13 @@
     alt="WeChat"
     src="https://img.shields.io/badge/WeChat-MrRoman_123-green.svg"
   />
-  <a href="https://github.com/qq306863030/deepfish">
+  <a href="https://github.com/qq306863030/deepfish-ai">
     <img
       alt="GitHub"
-      src="https://img.shields.io/badge/GitHub-DeepFish-blue.svg"
+      src="https://img.shields.io/badge/GitHub-DeepFish AI-blue.svg"
   /></a>
-  <a href="https://www.npmjs.com/package/deepfish">
-    <img alt="NPM" src="https://img.shields.io/badge/NPM-DeepFish-blue.svg"
+  <a href="https://www.npmjs.com/package/deepfish-ai">
+    <img alt="NPM" src="https://img.shields.io/badge/NPM-DeepFish AI-blue.svg"
   /></a>
   <img
     alt="Code License"
@@ -287,6 +287,9 @@ ai "将model目录下的所有文件按月份分类到model2目录中，日期
 ```bash
 ai "创建一个任务列表，1.xxxx；2.xxxx；..."
 ai "执行任务列表" # 开始执行
+
+ai "我要实现一个用于长篇小说创作的扩展工具，支持大篇幅写作，保持上下文逻辑连贯，避免AI上下文爆炸问题。这个扩展工具实现起来可能有点复杂，你需要先仔细阅读扩展工具生成规则，然后创建一个任务列表"
+ai "执行任务列表" # 开始执行
 ```
 
 ## 6. 扩展开发

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepfish-ai",
-  "version": "1.0.17",
+  "version": "1.0.18",
   "description": "This is an AI-driven command-line tool built on Node.js, equipped with AI agent and workflow capabilities. It is compatible with a wide range of AI models, can convert natural language into cross-system terminal and file operation commands, and features high extensibility. It supports complex tasks such as translation, content creation, and format conversion, while allowing custom extensions to be automatically generated via AI.",
   "main": "src/index.js",
   "bin": {

package/src/cli/SkillConfigManager.js

@@ -2,7 +2,7 @@
  * @Author: Roman 306863030@qq.com
  * @Date: 2026-03-23 15:23:42
  * @LastEditors: Roman 306863030@qq.com
- * @LastEditTime: 2026-03-26 10:34:01
+ * @LastEditTime: 2026-03-27 10:30:40
  * @FilePath: \deepfish\src\cli\SkillConfigManager.js
  * @Description: Skill configuration manager
  */
@@ -46,7 +46,7 @@ class SkillConfigManager {
   preLoadSkills() {
     const skills = this.configManager.config.skills.filter((skill) => skill.enable)
     if (skills.length === 0) {
-        return ''
+        return '### 暂无可以使用的Skill'
     }
     const table = skills
       .map((s) => `| ${s.name} | ${s.description} | ${s.location} | ${s.skillFilePath} |`)
@@ -268,7 +268,10 @@ ${table}
       return
     }
     const { skill, index } = skillObj
-    const skillPath = skill.location
+    let skillPath = skill.location
+    if (!skillPath) {
+      skillPath = path.join(this.skillDir, skill.skillDirName)
+    }
     userConfig.skills = userConfig.skills.filter((_, i) => i !== index)
     this.configManager.writeConfig(userConfig)
     if (fs.existsSync(skillPath)) {

package/src/core/ai-services/AiWorker/AiPrompt.js

@@ -4,7 +4,7 @@ const { GlobalVariable } = require("../../globalVariable")
  * @Author: Roman 306863030@qq.com
  * @Date: 2026-03-17 09:12:22
  * @LastEditors: Roman 306863030@qq.com
- * @LastEditTime: 2026-03-26 16:56:47
+ * @LastEditTime: 2026-03-27 10:32:06
  * @FilePath: \deepfish\src\core\ai-services\AiWorker\AiPrompt.js
  * @Description: AI请求提示词
  * @
@@ -22,7 +22,10 @@ const AiAgentSystemPrompt = () => {
 语言类型: 与用户输入语言一致
 
 ### 工具使用规则
-系统中内置了一些可以直接调用的工具函数，如可调用 executeJSCode 运行 Node.js 代码处理复杂逻辑；可调用 executeCommand 运行系统命令行工具（如 git、npm 等），工具调用需确保语法/指令符合当前操作系统规范（Windows/macOS/Linux 区分）。
+1.系统中有两种工具可以调用：一种是系统内置的工具函数（扩展工具），另一种是Skill工具包。优先使用系统内置工具函数，只有在系统内置工具函数无法满足需求时才使用Skill工具包。
+2.创建工具函数时，需要先调用generateExtensionRule函数查看生成规则
+3.创建Skill工具包时，需要先调用generateSkillPackageRule函数查看生成规则
+4.工具调用需确保语法/指令符合当前操作系统规范（Windows/macOS/Linux 区分）。
 
 ### 大文本文件处理规则（分步执行）
 处理长文档等大文件（单文件＞${maxBlockFileSize}KB）时，必须按以下步骤分块处理：
@@ -109,7 +112,10 @@ const TaskAiAgentSystemPrompt = () => {
 语言类型: 与用户输入语言一致
 
 ### 工具使用规则
-系统中内置了一些可以直接调用的工具函数，如可调用 executeJSCode 运行 Node.js 代码处理复杂逻辑；可调用 executeCommand 运行系统命令行工具（如 git、npm 等），工具调用需确保语法/指令符合当前操作系统规范（Windows/macOS/Linux 区分）。
+1.系统中有两种工具可以调用：一种是系统内置的工具函数（扩展工具），另一种是Skill工具包。优先使用系统内置工具函数，只有在系统内置工具函数无法满足需求时才使用Skill工具包。
+2.创建工具函数时，需要先调用generateExtensionRule函数查看生成规则
+3.创建Skill工具包时，需要先调用generateSkillPackageRule函数查看生成规则
+4.工具调用需确保语法/指令符合当前操作系统规范（Windows/macOS/Linux 区分）。
 
 ### 大文本文件处理规则（分步执行）
 处理长文档等大文件（单文件＞${maxBlockFileSize}KB）时，必须按以下步骤分块处理：

package/src/core/extension/ExtensionManager.js

@@ -2,7 +2,7 @@
  * @Author: Roman 306863030@qq.com
  * @Date: 2026-03-17 11:59:19
  * @LastEditors: Roman 306863030@qq.com
- * @LastEditTime: 2026-03-26 18:49:38
+ * @LastEditTime: 2026-03-27 10:33:37
  * @FilePath: \deepfish\src\core\extension\ExtensionManager.js
  * @Description: 扩展函数管理
  * @
@@ -12,6 +12,7 @@ const SystemExtension = require('./SystemExtension')
 const FileExtension = require('./FileExtension')
 const InquirerExtension = require('./InquirerExtension')
 const TestExtension = require('./TestExtension')
+const GenerateExtension = require('./GenerateExtension')
 const path = require('path')
 const fs = require('fs-extra')
 const axios = require('axios')
@@ -39,6 +40,7 @@ class ExtensionManager {
       InquirerExtension.descriptions,
       TestExtension.descriptions,
       TaskExtension.descriptions,
+      GenerateExtension.descriptions,
       BaseExtension.descriptions,
     )
     this.extensions.functions = Object.assign(
@@ -48,6 +50,8 @@ class ExtensionManager {
       InquirerExtension.functions,
       TestExtension.functions,
       TaskExtension.functions,
+      GenerateExtension.functions,
+      BaseExtension.functions,
     )
   }
 

package/src/core/extension/FileExtension.js

@@ -2,159 +2,159 @@
  * @Author: Roman 306863030@qq.com
  * @Date: 2026-03-17 11:59:19
  * @LastEditors: Roman 306863030@qq.com
- * @LastEditTime: 2026-03-20 16:52:45
+ * @LastEditTime: 2026-03-27 13:12:59
  * @FilePath: \deepfish\src\core\extension\FileExtension.js
  * @Description: 文件处理扩展函数
  * @
  */
-const path = require("path");
-const fs = require("fs-extra");
+const path = require('path')
+const fs = require('fs-extra')
 
 async function createFile(filePath, content) {
   try {
-    const fullPath = path.resolve(process.cwd(), filePath);
-    const dirPath = path.dirname(fullPath);
+    const fullPath = path.resolve(process.cwd(), filePath)
+    const dirPath = path.dirname(fullPath)
 
     if (!fs.existsSync(dirPath)) {
-      fs.mkdirSync(dirPath, { recursive: true });
+      fs.mkdirSync(dirPath, { recursive: true })
     }
-    fs.writeFileSync(fullPath, content);
-    return true;
+    fs.writeFileSync(fullPath, content)
+    return true
   } catch (error) {
-    return false;
+    return false
   }
 }
 
 async function modifyFile(filePath, content) {
   try {
-    const fullPath = path.resolve(process.cwd(), filePath);
+    const fullPath = path.resolve(process.cwd(), filePath)
 
     if (!fs.existsSync(fullPath)) {
-      return false;
+      return false
     }
 
-    fs.writeFileSync(fullPath, content);
-    return true;
+    fs.writeFileSync(fullPath, content)
+    return true
   } catch (error) {
-    return false;
+    return false
   }
 }
 
 async function readFile(filePath) {
   try {
-    const fullPath = path.resolve(process.cwd(), filePath);
+    const fullPath = path.resolve(process.cwd(), filePath)
 
     if (!fs.existsSync(fullPath)) {
-      return null;
+      return null
     }
 
-    const content = fs.readFileSync(fullPath, "utf8");
-    return content;
+    const content = fs.readFileSync(fullPath, 'utf8')
+    return content
   } catch (error) {
-    return null;
+    return null
   }
 }
 
 async function appendToFile(filePath, content) {
   try {
-    const fullPath = path.resolve(process.cwd(), filePath);
+    const fullPath = path.resolve(process.cwd(), filePath)
 
     if (!fs.existsSync(fullPath)) {
-      return false;
+      return false
     }
 
-    fs.appendFileSync(fullPath, content);
-    return true;
+    fs.appendFileSync(fullPath, content)
+    return true
   } catch (error) {
-    return false;
+    return false
   }
 }
 
 function fileExists(filePath) {
-  const fullPath = path.resolve(process.cwd(), filePath);
-  return fs.existsSync(fullPath);
+  const fullPath = path.resolve(process.cwd(), filePath)
+  return fs.existsSync(fullPath)
 }
 
 async function createDirectory(dirPath) {
   try {
-    const fullPath = path.resolve(process.cwd(), dirPath);
+    const fullPath = path.resolve(process.cwd(), dirPath)
     if (!fs.existsSync(fullPath)) {
-      fs.mkdirSync(fullPath, { recursive: true });
+      fs.mkdirSync(fullPath, { recursive: true })
     }
-    return true;
+    return true
   } catch (error) {
-    return false;
+    return false
   }
 }
 
 async function deleteFile(filePath) {
   try {
-    const fullPath = path.resolve(process.cwd(), filePath);
+    const fullPath = path.resolve(process.cwd(), filePath)
 
     if (fs.existsSync(fullPath)) {
-      fs.unlinkSync(fullPath);
+      fs.unlinkSync(fullPath)
     }
-    return true;
+    return true
   } catch (error) {
-    return false;
+    return false
   }
 }
 
 async function deleteDirectory(dirPath) {
   try {
-    const fullPath = path.resolve(process.cwd(), dirPath);
+    const fullPath = path.resolve(process.cwd(), dirPath)
 
     if (fs.existsSync(fullPath)) {
-      fs.rmSync(fullPath, { recursive: true, force: true });
+      fs.rmSync(fullPath, { recursive: true, force: true })
     }
-    return true;
+    return true
   } catch (error) {
-    return false;
+    return false
   }
 }
 
 async function rename(oldPath, newPath) {
   try {
-    const fullOldPath = path.resolve(process.cwd(), oldPath);
-    const fullNewPath = path.resolve(process.cwd(), newPath);
+    const fullOldPath = path.resolve(process.cwd(), oldPath)
+    const fullNewPath = path.resolve(process.cwd(), newPath)
 
     if (fs.existsSync(fullOldPath)) {
-      fs.renameSync(fullOldPath, fullNewPath);
+      fs.renameSync(fullOldPath, fullNewPath)
     }
-    return true;
+    return true
   } catch (error) {
-    return false;
+    return false
   }
 }
 
 async function moveFile(sourcePath, destinationPath) {
   try {
-    const fullSourcePath = path.resolve(process.cwd(), sourcePath);
-    const fullDestPath = path.resolve(process.cwd(), destinationPath);
-    const destDirPath = path.dirname(fullDestPath);
+    const fullSourcePath = path.resolve(process.cwd(), sourcePath)
+    const fullDestPath = path.resolve(process.cwd(), destinationPath)
+    const destDirPath = path.dirname(fullDestPath)
 
     if (!fs.existsSync(destDirPath)) {
-      fs.mkdirSync(destDirPath, { recursive: true });
+      fs.mkdirSync(destDirPath, { recursive: true })
     }
 
     if (fs.existsSync(fullSourcePath)) {
-      fs.renameSync(fullSourcePath, fullDestPath);
+      fs.renameSync(fullSourcePath, fullDestPath)
     }
-    return true;
+    return true
   } catch (error) {
-    return false;
+    return false
   }
 }
 
 async function getFileInfo(filePath) {
   try {
-    const fullPath = path.resolve(process.cwd(), filePath);
+    const fullPath = path.resolve(process.cwd(), filePath)
 
     if (!fs.existsSync(fullPath)) {
-      return null;
+      return null
     }
 
-    const stats = fs.statSync(fullPath);
+    const stats = fs.statSync(fullPath)
     return {
       path: fullPath,
       size: stats.size,
@@ -163,257 +163,255 @@ async function getFileInfo(filePath) {
       ctime: stats.ctime,
       isFile: stats.isFile(),
       isDirectory: stats.isDirectory(),
-    };
+    }
   } catch (error) {
-    return null;
+    return null
   }
 }
 
 async function getFileNameList(dirPath) {
   try {
-    const fullPath = path.resolve(process.cwd(), dirPath);
+    const fullPath = path.resolve(process.cwd(), dirPath)
     if (!fs.existsSync(fullPath) || !fs.statSync(fullPath).isDirectory()) {
-      return [];
+      return []
     }
-    const files = fs
-      .readdirSync(fullPath)
-      .filter((file) => file !== "ai-history" && file !== "ai-log");
-    return files;
+    const files = fs.readdirSync(fullPath)
+    return files
   } catch (error) {
-    return [];
+    return []
   }
 }
 
 async function clearDirectory(dirPath) {
   try {
-    const fullPath = path.resolve(process.cwd(), dirPath);
+    const fullPath = path.resolve(process.cwd(), dirPath)
 
     if (!fs.existsSync(fullPath)) {
-      return false;
+      return false
     }
 
     if (!fs.statSync(fullPath).isDirectory()) {
-      return false;
+      return false
     }
 
-    const files = fs.readdirSync(fullPath);
+    const files = fs.readdirSync(fullPath)
 
     for (const file of files) {
-      const filePath = path.join(fullPath, file);
+      const filePath = path.join(fullPath, file)
       if (fs.statSync(filePath).isDirectory()) {
-        fs.rmSync(filePath, { recursive: true, force: true });
+        fs.rmSync(filePath, { recursive: true, force: true })
       } else {
-        fs.unlinkSync(filePath);
+        fs.unlinkSync(filePath)
       }
     }
 
-    return true;
+    return true
   } catch (error) {
-    return false;
+    return false
   }
 }
 
 const descriptions = [
   {
-    type: "function",
+    type: 'function',
     function: {
-      name: "createFile",
+      name: 'createFile',
       description:
-        "创建一个包含指定内容的新文件，返回布尔值表示操作是否成功。如果目录不存在会自动创建目录结构。",
+        '创建一个包含指定内容的新文件，返回布尔值表示操作是否成功。如果目录不存在会自动创建目录结构。',
       parameters: {
-        type: "object",
+        type: 'object',
         properties: {
-          filePath: { type: "string" },
-          content: { type: "string" },
+          filePath: { type: 'string' },
+          content: { type: 'string' },
         },
-        required: ["filePath", "content"],
+        required: ['filePath', 'content'],
       },
     },
   },
   {
-    type: "function",
+    type: 'function',
     function: {
-      name: "modifyFile",
+      name: 'modifyFile',
       description:
-        "修改指定文件的内容，返回布尔值表示操作是否成功。如果文件不存在则返回false。",
+        '修改指定文件的内容，返回布尔值表示操作是否成功。如果文件不存在则返回false。',
       parameters: {
-        type: "object",
+        type: 'object',
         properties: {
-          filePath: { type: "string" },
-          content: { type: "string" },
+          filePath: { type: 'string' },
+          content: { type: 'string' },
         },
-        required: ["filePath", "content"],
+        required: ['filePath', 'content'],
       },
     },
   },
   {
-    type: "function",
+    type: 'function',
     function: {
-      name: "readFile",
+      name: 'readFile',
       description:
-        "读取指定文件的内容，返回文件内容字符串。如果文件不存在或读取失败则返回null。",
+        '读取指定文件的内容，返回文件内容字符串。如果文件不存在或读取失败则返回null。',
       parameters: {
-        type: "object",
+        type: 'object',
         properties: {
-          filePath: { type: "string" },
+          filePath: { type: 'string' },
         },
-        required: ["filePath"],
+        required: ['filePath'],
       },
     },
   },
   {
-    type: "function",
+    type: 'function',
     function: {
-      name: "appendToFile",
+      name: 'appendToFile',
       description:
-        "向指定文件追加内容，返回布尔值表示操作是否成功。如果文件不存在则返回false。",
+        '向指定文件追加内容，返回布尔值表示操作是否成功。如果文件不存在则返回false。',
       parameters: {
-        type: "object",
+        type: 'object',
         properties: {
-          filePath: { type: "string" },
-          content: { type: "string" },
+          filePath: { type: 'string' },
+          content: { type: 'string' },
         },
-        required: ["filePath", "content"],
+        required: ['filePath', 'content'],
       },
     },
   },
   {
-    type: "function",
+    type: 'function',
     function: {
-      name: "fileExists",
-      description: "检查指定文件是否存在，返回布尔值。",
+      name: 'fileExists',
+      description: '检查指定文件是否存在，返回布尔值。',
       parameters: {
-        type: "object",
+        type: 'object',
         properties: {
-          filePath: { type: "string" },
+          filePath: { type: 'string' },
         },
-        required: ["filePath"],
+        required: ['filePath'],
       },
     },
   },
   {
-    type: "function",
+    type: 'function',
     function: {
-      name: "createDirectory",
+      name: 'createDirectory',
       description:
-        "创建一个新目录，返回布尔值表示操作是否成功。支持递归创建目录结构。",
+        '创建一个新目录，返回布尔值表示操作是否成功。支持递归创建目录结构。',
       parameters: {
-        type: "object",
+        type: 'object',
         properties: {
-          dirPath: { type: "string" },
+          dirPath: { type: 'string' },
         },
-        required: ["dirPath"],
+        required: ['dirPath'],
       },
     },
   },
   {
-    type: "function",
+    type: 'function',
     function: {
-      name: "deleteFile",
+      name: 'deleteFile',
       description:
-        "删除指定文件，返回布尔值表示操作是否成功。如果文件不存在也会返回true。",
+        '删除指定文件，返回布尔值表示操作是否成功。如果文件不存在也会返回true。',
       parameters: {
-        type: "object",
+        type: 'object',
         properties: {
-          filePath: { type: "string" },
+          filePath: { type: 'string' },
         },
-        required: ["filePath"],
+        required: ['filePath'],
       },
     },
   },
   {
-    type: "function",
+    type: 'function',
     function: {
-      name: "deleteDirectory",
+      name: 'deleteDirectory',
       description:
-        "删除指定目录，返回布尔值表示操作是否成功。支持递归删除目录及其内容。如果目录不存在也会返回true。",
+        '删除指定目录，返回布尔值表示操作是否成功。支持递归删除目录及其内容。如果目录不存在也会返回true。',
       parameters: {
-        type: "object",
+        type: 'object',
         properties: {
-          dirPath: { type: "string" },
+          dirPath: { type: 'string' },
         },
-        required: ["dirPath"],
+        required: ['dirPath'],
       },
     },
   },
   {
-    type: "function",
+    type: 'function',
     function: {
-      name: "rename",
+      name: 'rename',
       description:
-        "重命名文件或目录，返回布尔值表示操作是否成功。如果原文件不存在也会返回true。",
+        '重命名文件或目录，返回布尔值表示操作是否成功。如果原文件不存在也会返回true。',
       parameters: {
-        type: "object",
+        type: 'object',
         properties: {
-          oldPath: { type: "string" },
-          newPath: { type: "string" },
+          oldPath: { type: 'string' },
+          newPath: { type: 'string' },
         },
-        required: ["oldPath", "newPath"],
+        required: ['oldPath', 'newPath'],
       },
     },
   },
   {
-    type: "function",
+    type: 'function',
     function: {
-      name: "moveFile",
+      name: 'moveFile',
       description:
-        "移动文件，返回布尔值表示操作是否成功。如果目标目录不存在会自动创建。如果源文件不存在也会返回true。",
+        '移动文件，返回布尔值表示操作是否成功。如果目标目录不存在会自动创建。如果源文件不存在也会返回true。',
       parameters: {
-        type: "object",
+        type: 'object',
         properties: {
-          sourcePath: { type: "string" },
-          destinationPath: { type: "string" },
+          sourcePath: { type: 'string' },
+          destinationPath: { type: 'string' },
         },
-        required: ["sourcePath", "destinationPath"],
+        required: ['sourcePath', 'destinationPath'],
       },
     },
   },
   {
-    type: "function",
+    type: 'function',
     function: {
-      name: "getFileInfo",
+      name: 'getFileInfo',
       description:
-        "获取指定文件的信息，返回文件信息对象。如果文件不存在或获取失败则返回null。返回对象包含path、size、birthtime、mtime、ctime、isFile、isDirectory等属性。",
+        '获取指定文件的信息，返回文件信息对象。如果文件不存在或获取失败则返回null。返回对象包含path、size、birthtime、mtime、ctime、isFile、isDirectory等属性。',
       parameters: {
-        type: "object",
+        type: 'object',
         properties: {
-          filePath: { type: "string" },
+          filePath: { type: 'string' },
         },
-        required: ["filePath"],
+        required: ['filePath'],
       },
     },
   },
   {
-    type: "function",
+    type: 'function',
     function: {
-      name: "getFileNameList",
+      name: 'getFileNameList',
       description:
-        "获取指定目录下的所有文件名，返回文件名数组。如果目录不存在或不是目录则返回空数组。",
+        '获取指定目录下的所有文件名，返回文件名数组。如果目录不存在或不是目录则返回空数组。',
       parameters: {
-        type: "object",
+        type: 'object',
         properties: {
-          dirPath: { type: "string" },
+          dirPath: { type: 'string' },
         },
-        required: ["dirPath"],
+        required: ['dirPath'],
       },
     },
   },
   {
-    type: "function",
+    type: 'function',
     function: {
-      name: "clearDirectory",
+      name: 'clearDirectory',
       description:
-        "清空指定目录的内容，返回布尔值表示操作是否成功。如果目录不存在或不是目录则返回false。",
+        '清空指定目录的内容，返回布尔值表示操作是否成功。如果目录不存在或不是目录则返回false。',
       parameters: {
-        type: "object",
+        type: 'object',
         properties: {
-          dirPath: { type: "string" },
+          dirPath: { type: 'string' },
         },
-        required: ["dirPath"],
+        required: ['dirPath'],
       },
     },
   },
-];
+]
 
 const functions = {
   createFile,
@@ -429,11 +427,12 @@ const functions = {
   getFileInfo,
   getFileNameList,
   clearDirectory,
-};
+}
 
 module.exports = {
   name: 'FileExtension',
-  extensionDescription: "提供文件和目录的创建、读取、修改、删除、移动、重命名、信息获取等文件系统操作功能",
+  extensionDescription:
+    '提供文件和目录的创建、读取、修改、删除、移动、重命名、信息获取等文件系统操作功能',
   descriptions,
   functions,
-};
+}

package/src/core/extension/GenerateExtension.js

@@ -45,15 +45,17 @@ async function generateExtensionRule(goal) {
 2. package.json配置：
    - name字段值：与项目名称一致，即"deepfish-「项目功能名称」"
    - version字段值：初始版本设置为1.0.0
-   - description字段值：简要描述该项目的核心功能和价值
+   - description字段值：用专业英文简要描述该项目的核心功能和价值, 以"A DeepFish AI extension tool for"开头
    - git仓库地址：固定为 https://github.com/qq306863030/deepfish-extensions.git
    - author设置为"DeepFish AI"
    - type字段设置为"commonjs"，确保模块系统兼容
-3. 主文件：项目入口文件必须命名为index.js
-4. 文档文件：项目根目录需新增2个文档文件：
-   - README_CN.md（中文说明文档）
-   - README.md（英文说明文档）
-5. 主测试文件：test.js
+3. 文件结构
+   - 主文件：项目入口文件必须命名为index.js
+   - 子文件：复杂的逻辑可以拆分到其他.js文件中;将descriptions、functions拆分到子文件;
+   - 文档文件：项目根目录需新增2个文档文件：
+    - README_CN.md（中文说明文档）
+    - README.md（英文说明文档）
+   - 主测试文件：test.js
 
 ### 第二步：index.js 完整开发规范
 #### 2.1 核心输出要求
@@ -76,6 +78,7 @@ async function generateExtensionRule(goal) {
 5. 函数中的this.aiCli在运行时指向DeepFish AI的运行时环境，可以通过this.aiCli访问到AI配置、工具函数等资源
 6. 尽量保持代码思路清晰，避免过度复杂的逻辑嵌套，必要时可以适当拆分函数、添加注释说明或拆分成多个文件
 7. 需要创建的是DeepFish AI的扩展工具，并非创建Skill工具包，因此不需要编写SKILL.md文件
+8. 对于复杂的的扩展功能，需要在functions中输出一个说明函数，只需返回一个markdown类型的字符串，专门用于解释当前扩展工具的使用方法、参数说明、示例等内容，函数名称为「extensionRule」，如「systemFileManagement_extensionRule」；函数描述需要强调调用该扩展模块前必须先阅读该规则文档。
 
 #### 2.3 基础代码模板（必须遵循）
 const descriptions = []
@@ -87,7 +90,19 @@ module.exports = {
   functions,
 }
 
-#### 2.4 参考示例（可参考格式）
+#### 2.4 参考示例（可参考格式，展示多文件拆分结构）
+
+##### index.js（主文件）
+const descriptions = require('./descriptions')
+const functions = require('./functions')
+module.exports = {
+  name: 'systemFileManagement',
+  extensionDescription: '提供文件管理相关功能，包括文件重命名、复制等操作',
+  descriptions,
+  functions,
+}
+
+##### descriptions.js（描述子文件）
 const descriptions = [
   {
     name: 'systemFileManagement_renameFile',
@@ -100,27 +115,38 @@ const descriptions = [
       },
     },
   },
+  {
+    name: 'systemFileManagement_copyFile',
+    description: '系统文件管理:复制文件',
+    parameters: {
+      type: 'object',
+      properties: {
+        srcPath: { type: 'string', description: '源文件路径' },
+        destPath: { type: 'string', description: '目标文件路径' },
+      },
+    },
+  },
 ]
+module.exports = descriptions
+
+##### functions.js（函数子文件）
 const functions = {
-  systemFileManagement_renameFile: (oldPath, newPath) => {
+  systemFileManagement_renameFile: function(oldPath, newPath) {
     return this.aiCli.Tools.rename(oldPath, newPath)
   },
+  systemFileManagement_copyFile: function(srcPath, destPath) {
+    return this.aiCli.Tools.copyFile(srcPath, destPath)
+  },
 }
-module.exports = {
-  name: 'systemFileManagement',
-  extensionDescription: '提供文件管理相关功能，包括文件重命名等操作',
-  descriptions,
-  functions,
-}
+module.exports = functions
 
 ### 第三步：测试规则
 1. 测试目标：至少覆盖扩展中的核心函数（建议覆盖每个对外函数），验证“正常输入可用、关键边界可处理、异常输入有明确反馈”。
 2. 测试文件：统一在 test.js 编写可直接运行的测试脚本，结构清晰，包含“准备数据 → 执行函数 → 断言结果 → 输出结论”。
-3. 运行时注入要求：必须模拟 DeepFish 运行时环境，确保函数可正确使用 this.aiCli 上下文。
+3. 运行时注入要求：必须确保函数可正确使用 this.aiCli 上下文。
    - 环境创建方式：
      "const { AICLI } = require('${packagePath}')\nconst aiCli = new AICLI();"
    - 调用方式：为模块导出的functions绑定aiCli上下文，示例：functions.aiCli = aiCli;
-   - 若函数依赖 this.aiCli.Tools/this.aiCli.aiConfig，需在测试中验证其可被正常访问。
 4. 断言与输出规范：每个用例需打印“用例名称、输入、期望、实际、是否通过（PASS/FAIL）”；全部执行后输出汇总（总数、通过数、失败数）。
 5. 失败处理：出现异常时不得静默吞错，需捕获并输出可定位信息（错误消息、对应用例、关键参数）。
 6. 副作用控制：测试过程中创建的临时文件必须使用 tmp_test_ 前缀，并在测试结束后清理。
@@ -138,9 +164,10 @@ module.exports = {
    - 清晰说明当前NPM包的核心定位、整体功能价值、适用场景
    - 语言简洁易懂，无需技术细节，聚焦「做什么」而非「怎么做」
 2. 快速开始：
-   - 明确说明安装步骤，顺序不可颠倒：
-     ① 先安装deepfish-ai全局库：npm install deepfish-ai -g
-     ② 再安装当前项目库：npm install @deepfish-ai/项目功能名称 -g
+   - 明确说明安装步骤：
+     ① 全局安装deepfish-ai：npm install deepfish-ai -g
+     ② 全局安装当前项目：npm install @deepfish-ai/项目功能名称 -g
+     ③ 在命令行中输入：ai 「扩展的某一个功能」。如：添加了一个查询天气的扩展。则输入：ai 查询一下今天的天气
 3. 函数列表及功能描述：
    - 列出当前项目中所有函数名称
    - 对应说明每个函数的核心功能