deepfish-ai 1.0.15 → 1.0.16

package/README.md

@@ -193,6 +193,7 @@ module.exports = {
   maxMessagesCount: 100, // Maximum compression count, -1 for unlimited
   maxHistoryExpireTime: 30, // Maximum session expiration time in days, -1 for unlimited, 0 to disable recording
   maxLogExpireTime: 3, // Log expiration time in days, -1 for unlimited, 0 to disable recording
+  maxBlockFileSize: 20, // Maximum block file size in KB; files exceeding this size need to be processed in blocks
   extensions: [], // List of extension file paths
   skills: [], // List of skill configurations
   encoding: "utf-8", // Command line encoding format, can be set to utf-8, gbk, etc., or auto/empty for auto-detection

package/README_CN.md

@@ -190,6 +190,7 @@ module.exports = {
   maxMessagesCount: 100, // 最大压缩数量，-1表示无限制
   maxHistoryExpireTime: 30, // 整个会话的最大过期时间，单位天，-1表示无限制，0表示不记录
   maxLogExpireTime: 3, // 日志过期时间，单位天，-1表示无限制，0表示不记录
+  maxBlockFileSize: 20, // 最大分块文件大小，单位KB；超过该大小的文件需要分块处理
   extensions: [], // 扩展文件路径列表
   skills: [], // 技能配置列表
   encoding: "utf-8", // 命令行编码格式，可设置为utf-8、gbk等，也可以设置成auto或空值自动判断

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepfish-ai",
-  "version": "1.0.15",
+  "version": "1.0.16",
   "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/DefaultConfig.js

@@ -6,9 +6,10 @@ const defaultConfig = {
   maxMessagesCount: 100, // 最大压缩数量，-1表示无限制
   maxHistoryExpireTime: 30, // 整个会话的最大过期时间，单位天，-1表示无限制, 0表示不记录
   maxLogExpireTime: 3, // 日志过期时间，单位天，-1表示无限制，0表示不记录
+  maxBlockFileSize: 20, // 最大分块文件大小，单位KB；超过该大小的文件需要分块处理
   extensions: [],
   skills:[],
-  encoding: "utf-8", // 命令行编码格式, 可设置为utf-8、gbk等, 也可以设置成auto或空值自动判断
+  encoding: "auto", // 命令行编码格式, 可设置为utf-8、gbk等, 也可以设置成auto或空值自动判断
 };
 
 const aiCliConfig = {

package/src/cli/index.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 const { program } = require("commander");
 const AICLI = require("../core/AICLI");
 const { logError } = require("../core/utils/log");

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

@@ -1,9 +1,9 @@
 /**
  * @Author: Roman 306863030@qq.com
  * @Date: 2026-03-16 09:18:05
- * @LastEditors: Roman 306863030@qq.com
- * @LastEditTime: 2026-03-17 10:00:20
- * @FilePath: \src\core\ai-services\AiWorker\AiAgent.js
+ * @LastEditors: roman_123 306863030@qq.com
+ * @LastEditTime: 2026-03-26 01:04:45
+ * @FilePath: \deepfish\src\core\ai-services\AiWorker\AiAgent.js
  * @Description: 工作流循环
  * @
  */
@@ -28,6 +28,7 @@ class AiAgent {
     this.aiConfig = aiConfig
     this.maxIterations =
       config.maxIterations === -1 ? Infinity : config.maxIterations
+    this.maxBlockFileSize = this.config.maxBlockFileSize || 20 // 默认20KB
     this.aiMessageManager = new AIMessageManager(aiClient, config, aiConfig, [])
     this.extensionTools = extensionTools
     this.name = config.name
@@ -97,7 +98,7 @@ class AiAgent {
             const fileInfo = await this.extensionTools.functions['getFileInfo'](
               parsedArgs.filePath,
             )
-            if (fileInfo && fileInfo.isFile && fileInfo.size > 10 * 1024) {
+            if (fileInfo && fileInfo.isFile && fileInfo.size > this.maxBlockFileSize * 1024) {
               this.aiMessageManager.addTool(id, {
                 error:
                   '文件过大，请使用executeJSCode工具编写脚本分块读取和处理文件，避免一次性读取整个文件内容到对话中。建议使用fs.createReadStream逐行或分块读取，仅返回必要的结果或总结。',
@@ -110,7 +111,7 @@ class AiAgent {
           let result = await toolFunction(...Object.values(parsedArgs))
           let toolContent = JSON.stringify(result)
           if (name !== 'requestAI') {
-            const MAX_CONTENT_SIZE = 100000
+            const MAX_CONTENT_SIZE = this.maxBlockFileSize * 1024
             if (toolContent.length > MAX_CONTENT_SIZE) {
               if (
                 typeof result === 'string' &&

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

@@ -1,8 +1,8 @@
 /**
  * @Author: Roman 306863030@qq.com
  * @Date: 2026-03-17 09:12:22
- * @LastEditors: Roman 306863030@qq.com
- * @LastEditTime: 2026-03-25 18:25:15
+ * @LastEditors: roman_123 306863030@qq.com
+ * @LastEditTime: 2026-03-26 02:12:44
  * @FilePath: \deepfish\src\core\ai-services\AiWorker\AiPrompt.js
  * @Description: AI请求提示词
  * @
@@ -23,7 +23,7 @@ const AiAgentSystemPrompt = `
 ### 大文本文件处理规则（分步执行）
 处理长文档等大文件（单文件＞20KB）时，必须按以下步骤分块处理：
 1. 预处理：先执行文件大小/结构检查（如通过命令行/JS 代码获取文件大小、判断文件格式），输出检查结果；
-2. 分块规则：按5KB-10KB/块拆分文件，拆分后每个块生成独立临时文件（命名格式：{原文件名}_chunk{序号}.tmp）；
+2. 分块规则：按5KB-10KB/块拆分文件，拆分后每个块生成独立临时文件（命名格式：tmp_{原文件名}_chunk{序号}.tmp）；
 3. 处理逻辑：翻译/总结/分析类任务逐块处理，每块处理完成后记录结果，最后合并所有块的结果生成最终文件；
 4. 合并校验：合并后需校验结果完整性（如总字符数匹配、无内容缺失），确保分块处理无遗漏。
 
@@ -31,7 +31,8 @@ const AiAgentSystemPrompt = `
 1. 最优路径优先：执行前必须先规划最少步骤的操作路径，明确「先做什么、再做什么、哪些可省略」，避免重复操作和无效步骤；
 2. 异常反馈：操作失败（如命令执行报错、文件不存在）时，需明确说明「失败原因+可尝试的解决方案」，而非仅提示“操作失败”；
 3. 结果校验：任务完成后，需简单校验结果是否符合用户目标（如文件是否生成、内容是否完整），并向用户反馈校验结果。
-4. 如果需要安装软件或工具来完成任务，必须通过调用用户交互函数与用户交互，等待用户确认后再执行安装。
+4. 如果执行任务过程中需要安装软件、工具或执行"npm install"命令，必须通过调用用户交互函数与用户交互，等待用户确认后再执行安装。
+5. 任务执行过程中，产生的所有临时文件（如分块文件、测试文件等）必须以"tmp_"为前缀命名，并在任务完成后删除这些临时文件，确保工作目录整洁。
   `
 
 const SkillAiAgentSystemPrompt = `
@@ -47,7 +48,7 @@ const SkillAiAgentSystemPrompt = `
 ### 大文本文件处理规则（分步执行）
 处理长文档等大文件（单文件＞20KB）时，必须按以下步骤分块处理：
 1. 预处理：先执行文件大小/结构检查（如通过命令行/JS 代码获取文件大小、判断文件格式），输出检查结果；
-2. 分块规则：按5KB-10KB/块拆分文件，拆分后每个块生成独立临时文件（命名格式：{原文件名}_chunk{序号}.tmp）；
+2. 分块规则：按5KB-10KB/块拆分文件，拆分后每个块生成独立临时文件（命名格式：tmp_{原文件名}_chunk{序号}.tmp）；
 3. 处理逻辑：翻译/总结/分析类任务逐块处理，每块处理完成后记录结果，最后合并所有块的结果生成最终文件；
 4. 合并校验：合并后需校验结果完整性（如总字符数匹配、无内容缺失），确保分块处理无遗漏。
 
@@ -58,6 +59,7 @@ const SkillAiAgentSystemPrompt = `
 4. 如果发现不能使用Skill完成任务，则直接说明原因，不要尝试使用其他工具或技能来完成任务；
 5. 如果需要安装软件或工具来完成任务，必须通过调用用户交互函数与用户交互，等待用户确认后再执行安装。
 6. 任务完成后，反馈任务执行结果。
+7. 任务执行过程中，产生的所有临时文件（如分块文件、测试文件等）必须以"tmp_"为前缀命名，并在任务完成后删除这些临时文件，确保工作目录整洁。
   `
 
 const TestAiAgentSystemPrompt = `
@@ -74,8 +76,9 @@ const TestAiAgentSystemPrompt = `
 1. 仔细分析测试目标，确保完全理解测试需求和预期结果；
 2. 在测试过程中可以通过创建前缀为"test_"的临时文件辅助测试，完成后需删除这些临时文件；
 3. 在测试过程中随意不能修改原有的文件内容；
-3. 如果发现不能使用工具函数完成测试任务，则直接说明原因，不要做过多尝试；
-4. 任务完成后，反馈测试执行结果。
+4. 如果发现不能使用工具函数完成测试任务，则直接说明原因，不要做过多尝试；
+5. 任务完成后，反馈测试执行结果。
+6. 任务执行过程中，产生的所有临时文件（如分块文件、测试文件等）必须以"tmp_"为前缀命名，并在任务完成后删除这些临时文件，确保工作目录整洁。
   `
 
 module.exports = {

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

@@ -1,8 +1,8 @@
 /**
  * @Author: Roman 306863030@qq.com
  * @Date: 2026-03-17 09:12:22
- * @LastEditors: Roman 306863030@qq.com
- * @LastEditTime: 2026-03-25 19:56:42
+ * @LastEditors: roman_123 306863030@qq.com
+ * @LastEditTime: 2026-03-26 01:08:48
  * @FilePath: \deepfish\src\core\ai-services\AiWorker\AiTools.js
  * @Description: 对话初始化、对话请求
  * @
@@ -36,15 +36,17 @@ function getInitialMessages(goal) {
 }
 
 function getSystemPrompt() {
+  const config = GlobalVariable.aiCli.config
   const skillPrompt = GlobalVariable.skillConfigManager.preLoadSkills()
-  const systemDescription = `${AiAgentSystemPrompt}\n\n${skillPrompt}`
+  const systemDescription = `${AiAgentSystemPrompt.replace('20KB', `${config.maxBlockFileSize}KB`)}\n\n${skillPrompt}`
   return systemDescription
 }
 
 // 获取调用skill的初始message
 function getInitialMessagesForSkill(skillContent, goal) {
+  const config = GlobalVariable.aiCli.config
   const systemDescription = `
-${SkillAiAgentSystemPrompt}
+${SkillAiAgentSystemPrompt.replace('20KB', `${config.maxBlockFileSize}KB`)}
 ### 以下是加载完成的Skill.md文件的内容：
 ${skillContent}`
   return [
@@ -63,7 +65,7 @@ function getInitialMessagesForTest(goal) {
   return [
     {
       role: 'system',
-      content: TestAiAgentSystemPrompt,
+      content: TestAiAgentSystemPrompt.replace('20KB', `${GlobalVariable.aiCli.config.maxBlockFileSize}KB`),
     },
     {
       role: 'user',

package/src/core/extension/InquirerExtension.js

@@ -8,8 +8,8 @@ async function askConfirm(name, message, defaultVal = true, opt = {}) {
       name,
       message,
       default: defaultVal,
-      ...opt
-    }
+      ...opt,
+    },
   ]
   const answers = await inquirer.prompt(questions)
   return answers[name]
@@ -24,8 +24,8 @@ function askList(name, message, choices, defaultVal = 0, opt = {}) {
       message,
       choices,
       default: defaultVal,
-      ...opt
-    }
+      ...opt,
+    },
   ]
   return inquirer.prompt(questions)
 }
@@ -38,7 +38,7 @@ async function askInput(name, message, defaultVal = '', opt = {}) {
       name,
       message,
       default: defaultVal,
-      ...opt
+      ...opt,
     },
   ]
   const answers = await inquirer.prompt(questions)
@@ -53,7 +53,7 @@ async function askNumber(name, message, defaultVal = 0, opt = {}) {
       name,
       message,
       default: defaultVal,
-      ...opt
+      ...opt,
     },
   ]
   const answers = await inquirer.prompt(questions)
@@ -67,85 +67,210 @@ function askAny(questions) {
 
 const descriptions = [
   {
-    type: "function",
+    type: 'function',
     function: {
-      name: "askConfirm",
-      description: "用户交互：提示用户确认问题，返回布尔值。通过message参数显示问题文本，defaultVal参数设置默认值（默认为true），opt参数可传递inquirer的其他选项。",
+      name: 'askConfirm',
+      description:
+        '用户交互：基于inquirer的confirm类型封装，提示用户确认问题，用户输入Y/N后返回布尔值（true/false）。参数说明(不是对象参数)：name-问题标识名称；message-显示给用户的问题文本；defaultVal-默认布尔值（默认true）；opt-inquirer额外配置选项对象。',
       parameters: {
-        type: "object",
+        type: 'object',
         properties: {
-          name: { type: "string", description: "问题的标识名称" },
-          message: { type: "string", description: "显示给用户的问题文本" },
-          defaultVal: { type: "boolean", description: "默认值，默认为true" },
-          opt: { type: "object", description: "inquirer的其他选项对象，可选" },
+          name: {
+            type: 'string',
+            description:
+              "问题的唯一标识名称，用于从返回结果中提取该问题的答案，例如 'confirmDelete'、'agreeLicense'",
+          },
+          message: {
+            type: 'string',
+            description:
+              "显示给用户的确认问题文本，例如 '是否确认删除？'、'你同意继续吗？'",
+          },
+          defaultVal: {
+            type: 'boolean',
+            description:
+              '用户直接按回车时的默认值，true表示默认确认，false表示默认拒绝，默认为true',
+          },
+          opt: {
+            type: 'object',
+            description:
+              'inquirer额外配置选项对象，可选。支持的字段包括：when（条件函数，控制是否显示此问题）、prefix（问题前缀符号）、suffix（问题后缀符号）、transformer（显示值转换函数）等',
+          },
         },
-        required: ["name", "message"],
+        required: ['name', 'message'],
       },
     },
   },
   {
-    type: "function",
+    type: 'function',
     function: {
-      name: "askList",
-      description: "用户交互：提示用户从列表中选择一项，返回选择项对象。通过choices参数传递选项数组，defaultVal参数设置默认选择的索引（默认为0），opt参数可传递inquirer的其他选项。",
+      name: 'askList',
+      description:
+        '用户交互：基于inquirer的list类型封装，提示用户从列表中选择一项，返回包含用户选择结果的对象（{choices => items => name: 选中值}）。参数说明(不是对象参数)：name-问题标识名称；message-显示给用户的提示文本；choices-选项数组（字符串或{name,value,short}对象）；defaultVal-默认选中索引（默认0）；opt-inquirer额外配置选项对象。',
       parameters: {
-        type: "object",
+        type: 'object',
         properties: {
-          name: { type: "string", description: "问题的标识名称" },
-          message: { type: "string", description: "显示给用户的问题文本" },
-          choices: { type: "array", description: "选项数组" },
-          defaultVal: { type: "number", description: "默认选择索引，默认为0" },
-          opt: { type: "object", description: "inquirer的其他选项对象，可选" },
+          name: {
+            type: 'string',
+            description:
+              "问题的唯一标识名称，用于从返回对象中提取选择结果，例如 'language'、'theme'。返回值格式为 {[name]: 选中项的value}",
+          },
+          message: {
+            type: 'string',
+            description:
+              "显示给用户的选择提示文本，例如 '请选择编程语言：'、'请选择主题风格：'",
+          },
+          choices: {
+            type: 'array',
+            description:
+              "选项数组，每项可以是字符串（同时作为显示文本和值），也可以是对象 {name: '显示文本', value: '实际值', short: '选中后的简短显示'}。还支持 new inquirer.Separator() 作为分隔线",
+            items: {
+              type: 'object',
+              properties: {
+                name: { type: 'string', description: '选项的显示文本' },
+                value: {
+                  type: 'string',
+                  description: '选项被选中后的实际返回值',
+                },
+                short: {
+                  type: 'string',
+                  description: '选中后在提示行中显示的简短文本，可选',
+                },
+              },
+            },
+          },
+          defaultVal: {
+            type: 'number',
+            description:
+              '默认选中项的索引（从0开始），默认为0即选中第一项。例如传入2表示默认高亮第三个选项',
+          },
+          opt: {
+            type: 'object',
+            description:
+              'inquirer额外配置选项对象，可选。支持的字段包括：loop（布尔值，是否循环滚动列表，默认true）、pageSize（数字，一次显示的选项数量，超出则滚动）、when（条件函数）、filter（结果过滤函数）等',
+          },
         },
-        required: ["name", "message", "choices"],
+        required: ['name', 'message', 'choices'],
       },
     },
   },
   {
-    type: "function",
+    type: 'function',
     function: {
-      name: "askInput",
-      description: "用户交互：提示用户输入文本，返回输入的字符串。通过message参数显示问题文本，defaultVal参数设置默认值（默认为空字符串），opt参数可传递inquirer的其他选项。",
+      name: 'askInput',
+      description:
+        '用户交互：基于inquirer的input类型封装，提示用户输入一段文本，返回用户输入的字符串。参数说明(不是对象参数)：name-问题标识名称；message-显示给用户的提示文本；defaultVal-默认输入值（默认空字符串）；opt-inquirer额外配置选项对象（支持validate、filter等）。',
       parameters: {
-        type: "object",
+        type: 'object',
         properties: {
-          name: { type: "string", description: "问题的标识名称" },
-          message: { type: "string", description: "显示给用户的问题文本" },
-          defaultVal: { type: "string", description: "默认值，默认为空字符串" },
-          opt: { type: "object", description: "inquirer的其他选项对象，可选" },
+          name: {
+            type: 'string',
+            description:
+              "问题的唯一标识名称，用于从返回结果中提取输入内容，例如 'username'、'filePath'",
+          },
+          message: {
+            type: 'string',
+            description:
+              "显示给用户的输入提示文本，例如 '请输入用户名：'、'请输入文件路径：'",
+          },
+          defaultVal: {
+            type: 'string',
+            description:
+              "用户直接按回车时的默认输入值，默认为空字符串。例如传入 './output' 表示默认路径",
+          },
+          opt: {
+            type: 'object',
+            description:
+              'inquirer额外配置选项对象，可选。支持的字段包括：validate（校验函数，接收输入值返回true或错误提示字符串）、filter（过滤函数，对用户输入进行转换处理）、transformer（显示转换函数，不影响实际值）、when（条件函数）等',
+          },
         },
-        required: ["name", "message"],
+        required: ['name', 'message'],
       },
     },
   },
   {
-    type: "function",
+    type: 'function',
     function: {
-      name: "askNumber",
-      description: "用户交互：提示用户输入数字，返回输入的数字。通过message参数显示问题文本，defaultVal参数设置默认值（默认为0），opt参数可传递inquirer的其他选项。",
+      name: 'askNumber',
+      description:
+        '用户交互：基于inquirer的number类型封装，提示用户输入一个数字，返回Number类型值（非数字输入返回NaN）。参数说明(不是对象参数)：name-问题标识名称；message-显示给用户的提示文本；defaultVal-默认数字值（默认0）；opt-inquirer额外配置选项对象（支持validate、filter等）。',
       parameters: {
-        type: "object",
+        type: 'object',
         properties: {
-          name: { type: "string", description: "问题的标识名称" },
-          message: { type: "string", description: "显示给用户的问题文本" },
-          defaultVal: { type: "number", description: "默认值，默认为0" },
-          opt: { type: "object", description: "inquirer的其他选项对象，可选" },
+          name: {
+            type: 'string',
+            description:
+              "问题的唯一标识名称，用于从返回结果中提取输入的数字，例如 'port'、'retryCount'",
+          },
+          message: {
+            type: 'string',
+            description:
+              "显示给用户的数字输入提示文本，例如 '请输入端口号：'、'请输入重试次数：'",
+          },
+          defaultVal: {
+            type: 'number',
+            description:
+              '用户直接按回车时的默认数字值，默认为0。例如传入8080表示默认端口号',
+          },
+          opt: {
+            type: 'object',
+            description:
+              'inquirer额外配置选项对象，可选。支持的字段包括：validate（校验函数，接收输入值返回true或错误提示字符串，可用于限制数值范围）、filter（过滤函数，对输入数字进行转换）、when（条件函数）等',
+          },
         },
-        required: ["name", "message"],
+        required: ['name', 'message'],
       },
     },
   },
   {
-    type: "function",
+    type: 'function',
     function: {
-      name: "askAny",
-      description: "用户交互：提示用户根据自定义问题对象数组进行交互，返回答案对象。通过questions参数传递inquirer格式的问题数组，支持多种问题类型和复杂配置。",
+      name: 'askAny',
+      description:
+        '用户交互：直接调用inquirer.prompt()的通用封装，接受自定义问题对象数组，支持一次提出多个问题进行连续交互，返回包含所有答案的对象（{问题name: 对应答案}）。参数说明(不是对象参数)：questions-inquirer问题对象数组，每个对象包含type（问题类型：input/confirm/list/checkbox/password/editor/rawlist/expand）、name（标识名称）、message（提示文本）及可选的default、choices、validate、filter、when等字段。',
       parameters: {
-        type: "object",
+        type: 'object',
         properties: {
-          questions: { type: "array", description: "inquirer的问题对象数组" },
+          questions: {
+            type: 'array',
+            description:
+              "inquirer问题对象数组，每个问题对象包含以下字段：type（问题类型，如'input'/'confirm'/'list'/'checkbox'/'password'/'editor'/'rawlist'/'expand'）、name（问题标识名称）、message（提示文本）、default（默认值）、choices（选项数组，适用于list/checkbox/rawlist/expand类型）、validate（校验函数）、filter（过滤函数）、when（条件函数，控制是否显示该问题，接收前面的回答作为参数）、transformer（显示转换函数）等。多个问题会按数组顺序依次向用户提问",
+            items: {
+              type: 'object',
+              properties: {
+                type: {
+                  type: 'string',
+                  description:
+                    "问题类型：'input'（文本输入）、'confirm'（是否确认）、'list'（单选列表）、'checkbox'（多选列表）、'password'（密码输入，输入内容隐藏）、'editor'（打开编辑器输入大段文本）、'rawlist'（带编号的列表选择）、'expand'（按键选择展开列表）",
+                },
+                name: {
+                  type: 'string',
+                  description:
+                    '问题的唯一标识名称，用于在返回的答案对象中作为key提取对应答案',
+                },
+                message: {
+                  type: 'string',
+                  description: '显示给用户的问题提示文本',
+                },
+                default: {
+                  type: 'string',
+                  description: '默认值，类型根据问题类型而定',
+                },
+                choices: {
+                  type: 'array',
+                  description:
+                    '选项数组，适用于list/checkbox/rawlist/expand类型',
+                },
+                validate: {
+                  type: 'string',
+                  description:
+                    '校验函数，接收用户输入返回true表示通过或返回错误字符串',
+                },
+              },
+              required: ['type', 'name', 'message'],
+            },
+          },
         },
-        required: ["questions"],
+        required: ['questions'],
       },
     },
   },
@@ -161,7 +286,8 @@ const functions = {
 
 module.exports = {
   name: 'InquirerExtension',
-  extensionDescription: "提供用户交互功能，支持确认、列表选择、文本输入、数字输入等多种交互方式",
+  extensionDescription:
+    '提供用户交互功能，支持确认、列表选择、文本输入、数字输入等多种交互方式',
   descriptions,
   functions,
-}
+}

package/src/core/extension/SystemExtension.js

@@ -1,8 +1,8 @@
 /**
  * @Author: Roman 306863030@qq.com
  * @Date: 2026-03-17 11:59:19
- * @LastEditors: Roman 306863030@qq.com
- * @LastEditTime: 2026-03-25 20:05:23
+ * @LastEditors: roman_123 306863030@qq.com
+ * @LastEditTime: 2026-03-26 00:54:25
  * @FilePath: \deepfish\src\core\extension\SystemExtension.js
  * @Description: 默认扩展函数
  * @
@@ -132,7 +132,7 @@ async function getExtensionFileRule(goal) {
 基于指定规则创建一个标准化的Node.js NPM项目，实现用户目标：${goal}，最终输出符合AI工作流调用规范的函数模块，并配套中英文说明文档。
 
 ### 第一步：项目初始化
-1. 目录创建：新建目录，目录名称为「项目功能名称」，作为NPM项目根目录
+1. 目录创建：新建目录，目录名称以"deepfish-"开头,如"deepfish-「项目功能名称」"，作为NPM项目根目录
 2. package.json配置：
    - name字段值：@deepfish-ai/项目功能名称（替换「项目功能名称」为实际功能名）
    - git仓库地址：固定为 https://github.com/qq306863030/deepfish-extensions.git
@@ -155,11 +155,14 @@ async function getExtensionFileRule(goal) {
 2. 命名规范：
    - 函数名称前缀：「领域用途+分隔符」（如systemFileManagement_）
    - 函数描述开头：统一格式「领域用途+分隔符+功能描述」（如系统文件管理:重命名文件）
-3. 内置工具调用：函数内部可直接使用this.Tools下的内置方法，示例：
+3. 内置工具函数调用：函数内部会自动注入所有内置工具函数，可以通过this.Tools获取，示例：
    - this.Tools.requestAI(systemDescription, prompt, temperature)
    - this.Tools.readFile(filePath)
    - 其他文件处理类内置函数（运行时自动注入）
 4. 函数数量：至少包含1个可被AI工作流调用的函数
+5. 函数中的this在运行时指向DeepFish AI的运行时环境，可以通过this访问到AI配置、工具函数等资源，因此在创建扩展时需要注意this的指向
+6. 尽量保持代码思路清晰，避免过度复杂的逻辑嵌套，必要时可以适当拆分函数、添加注释说明或拆分成多个文件
+7. 需要创建的是DeepFish AI的扩展工具，并非创建Skill工具包，因此不需要编写SKILL.md文件
 
 #### 2.3 基础代码模板（必须遵循）
 const descriptions = []
@@ -240,6 +243,34 @@ function executeSkill(skillFilePath, subGoalPrompt = '') {
   return this.aiService.subSkillWorkflow(skillContent, subGoalPrompt)
 }
 
+// 了解自己
+function getSelfInfo() {
+  // 返回自己的代码路径、package.json路径、readme路径等基本信息，供AI有选择的了解自己，回答用户的问题
+  const homeDir = path.resolve(__dirname, '../../../')
+  return {
+    codePath: {
+      description: 'DeepFish AI程序代码路径',
+      value: homeDir,
+    },
+    packageJsonPath: {
+      description: 'DeepFish AI程序package.json文件路径',
+      value: path.resolve(homeDir, 'package.json'),
+    },
+    readmeCNPath: {
+      description: 'DeepFish AI程序中文文档路径',
+      value: path.resolve(homeDir, 'README_CN.md'),
+    },
+    readmeENPath: {
+      description: 'DeepFish AI程序英文文档路径',
+      value: path.resolve(homeDir, 'README.md'),
+    },
+    version: {
+      description: 'DeepFish AI程序版本',
+      value: "v" + require(path.resolve(homeDir, 'package.json')).version,
+    }
+  }
+}
+
 const descriptions = [
   {
     type: 'function',
@@ -351,6 +382,19 @@ const descriptions = [
       },
     },
   },
+  {
+    type: 'function',
+    function: {
+      name: 'getSelfInfo',
+      description:
+        '获取DeepFish AI程序的基本信息、命令行等，供AI有选择的了解自己，回答用户的问题。',
+      parameters: {
+        type: 'object',
+        properties: {},
+        required: [],
+      },
+    }
+  }
 ]
 const functions = {
   executeCommand,
@@ -360,6 +404,7 @@ const functions = {
   getAiConfig,
   getAiConfigPath,
   executeSkill,
+  getSelfInfo,
 }
 
 module.exports = {