deepfish-ai 1.0.26 → 1.0.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepfish-ai",
-  "version": "1.0.26",
+  "version": "1.0.27",
   "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",
   "type": "commonjs",

package/src/AgentRobot/AgentRobotFactory/MainAgentRobot.js

@@ -16,6 +16,7 @@ class MainAgentRobot extends BaseAgentRobot {
 
   // 初始化文件
   _initFiles(opt) {
+    this.logId = Date.now()
     this.workspace = opt.workspace || process.cwd() // 工作空间，目录
     this.basespace = opt.basespace || path.join(os.homedir(), '.deepfish-ai') // 记忆空间，目录
     this.userspace = path.join(this.basespace, 'user-info') // 用户空间，目录

package/src/AgentRobot/BaseAgentRobot/Logger.js

@@ -9,6 +9,7 @@ class Logger {
     this.maxLogExpireTime = agentRobot.config.maxLogExpireTime
     this.memorySpace = agentRobot.memorySpace
     this.logTimeMap = new Map()
+    this.logId = agentRobot.logId || agentRobot.root.logId
   }
   clearAllLogs() {
     const fileNames = fs.readdirSync(this.memorySpace)
@@ -55,11 +56,16 @@ class Logger {
     }
     const logFile = path.join(
       this.logDirPath,
-      `log-${dayjs().format('YYYY-MM-DD HH')}.txt`,
+      `log-${this.logId}-${dayjs().format('YYYY-MM-DD HH')}.txt`,
+    )
+    const logFile2 = path.join(
+      this.logDirPath,
+      `log-messeage-${this.logId}.txt`,
     )
     try {
       let logEntry = `[${new Date().toISOString()}][${message.role}] ${message.content}\n`
       fs.appendFileSync(logFile, logEntry)
+      fs.appendFileSync(logFile2, logEntry)
       return true
     } catch (error) {
       console.error('Failed to log message:', error.message)
@@ -72,7 +78,7 @@ class Logger {
     }
     const logFile = path.join(
       this.logDirPath,
-      `log-${dayjs().format('YYYY-MM-DD HH')}.txt`,
+      `log-${this.logId}-${dayjs().format('YYYY-MM-DD HH')}.txt`,
     )
     try {
       let logEntry = `[${new Date().toISOString()}][***COMPRESS START***] 
@@ -92,7 +98,7 @@ class Logger {
     }
     const logFile = path.join(
       this.logDirPath,
-      `log-${dayjs().format('YYYY-MM-DD HH')}.txt`,
+      `log-${this.logId}-${dayjs().format('YYYY-MM-DD HH')}.txt`,
     )
     try {
       let logEntry = `[${new Date().toISOString()}][###############] ${message}\n`

package/src/AgentRobot/BaseAgentRobot/tools/GenerateTools.js

@@ -1,3 +1,6 @@
+const fs = require('fs-extra')
+const path = require('path')
+
 const descriptions = [
   {
     type: 'function',
@@ -59,6 +62,35 @@ const descriptions = [
       },
     },
   },
+  {
+    type: 'function',
+    function: {
+      name: 'generateClawSkillByHistory',
+      description:
+        '根据用户目标与对话历史日志或指定日志文件自动生成 OpenClaw Skill 工具包。logfile参数为日志文件名称，默认从日志目录中查找，如果不存在则从当前目录查找；若未设置该参数，则使用最新日志文件；该参数也可设置为绝对路径。',
+      parameters: {
+        type: 'object',
+        properties: {
+          goal: { type: 'string' },
+          logfile: { type: 'string' },
+        },
+        required: ['goal'],
+      },
+    },
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'getSessionHistoryFile',
+      description:
+        '获取最后一次会话历史日志文件路径，用于生成Skill时引用会话历史。',
+      parameters: {
+        type: 'object',
+        properties: {},
+        required: [],
+      },
+    },
+  },
 ]
 
 async function getGenerateSkillRules(goal) {
@@ -77,6 +109,7 @@ async function getGenerateSkillRules(goal) {
    - git仓库地址：固定为 https://github.com/qq306863030/deepfish-extensions.git
    - author设置为"DeepFish AI"
    - type字段设置为"commonjs"，确保模块系统兼容
+   - main字段设置为"index.js"，指定入口文件
 3. 文件结构
    - 主文件：项目入口文件必须命名为index.js
    - 子文件：复杂的逻辑可以拆分到其他.js文件中;将descriptions、functions拆分到子文件;
@@ -224,7 +257,7 @@ async function generateSkill(rules) {
 }
 
 async function getGenerateClawSkillRules(goal) {
-   const newGoal = `
+  const newGoal = `
 ## 任务目标
 基于OpenClaw Skill规范创建一个标准化的Skill工具包，实现用户目标：${goal}，最终输出可被你直接加载使用。
 
@@ -328,19 +361,81 @@ async function generateClawSkill(rules) {
   return this.Tools.executeTaskList(rules)
 }
 
+// 根据对话历史生成一个skill工具包
+async function generateClawSkillByHistory(goal, logfile) {
+  const logDirPath = this.agentRobot.logDirPath
+  const workspace = this.agentRobot.workspace
+  let logFilePath
+  if (!logfile) {
+    // 如果没有明确提出对话历史文件，则从最新的对话日志中获取skill生成所需的对话历史内容
+    let logFiles = fs.readdirSync(logDirPath)
+    logFiles = logFiles.filter((file) => file.startsWith(`log-messeage-`))
+    if (logFiles.length === 0) {
+      throw new Error('No log file found for generating skill by history')
+    }
+    // 根据文件名称排序，获取最新的日志文件 log-messeage-{logId}.txt
+    let latestLogFile = logFiles[0]
+    if (logFiles.length > 1) {
+      latestLogFile = logFiles.sort((a, b) => {
+        const aTime = parseInt(a.slice(12, -4))
+        const bTime = parseInt(b.slice(12, -4))
+        return bTime - aTime
+      })[1]
+    }
+    logFilePath = path.join(logDirPath, latestLogFile)
+  } else {
+    logFilePath = path.join(logDirPath, logfile)
+    if (!fs.existsSync(logFilePath)) {
+      // 如果在日志目录中没有找到，则尝试在当前目录中查找
+      logFilePath = path.resolve(workspace, logfile)
+      if (!fs.existsSync(logFilePath)) {
+        throw new Error(`Log file not found: ${logfile}`)
+      }
+    }
+  }
+  const rules = await this.Tools.getGenerateClawSkillRules(
+    `基于用户的任务目标和会话历史日志中的有效信息和，生成一个OpenClaw兼容的Skill工具包。用户目标: ${goal}, 会话历史路径: ${logFilePath}`,
+  )
+  return await this.Tools.generateClawSkill(rules)
+}
+
+// 获取会话历史文件
+function getSessionHistoryFile() {
+  const logDirPath = this.agentRobot.logDirPath
+  let logFiles = fs.readdirSync(logDirPath)
+  logFiles = logFiles.filter((file) => file.startsWith(`log-messeage-`))
+  if (logFiles.length === 0) {
+    throw new Error('No log file found for generating skill by history')
+  }
+  // 根据文件名称排序，获取最新的日志文件 log-messeage-{logId}.txt
+  let latestLogFile = logFiles[0]
+  if (logFiles.length > 1) {
+    latestLogFile = logFiles.sort((a, b) => {
+      const aTime = parseInt(a.slice(12, -4))
+      const bTime = parseInt(b.slice(12, -4))
+      return bTime - aTime
+    })[1]
+  }
+  const logFilePath = path.join(logDirPath, latestLogFile)
+  return logFilePath
+}
+
 const functions = {
   getGenerateClawSkillRules,
   getGenerateSkillRules,
   generateClawSkill,
   generateSkill,
+  generateClawSkillByHistory,
+  getSessionHistoryFile,
 }
 
 const GenerateTools = {
   name: 'GenerateTools',
-  description: '提供扩展工具与Skill工具包生成规则能力，用于辅助AI构建标准化扩展项目模板',
+  description:
+    '提供扩展工具与Skill工具包生成规则能力，用于辅助AI构建标准化扩展项目模板',
   descriptions,
   functions,
-  isSystem: true
+  isSystem: true,
 }
 
-module.exports = GenerateTools
+module.exports = GenerateTools

package/src/AgentRobot/BaseAgentRobot/tools/SystemTools.js

@@ -1,8 +1,8 @@
 /**
  * @Author: Roman 306863030@qq.com
  * @Date: 2026-03-17 11:59:19
- * @LastEditors: roman_123 306863030@qq.com
- * @LastEditTime: 2026-04-24 00:07:22
+ * @LastEditors: Roman 306863030@qq.com
+ * @LastEditTime: 2026-05-07 14:17:50
  * @FilePath: \deepfish\src\AgentRobot\BaseAgentRobot\tools\SystemTools.js
  * @Description: 默认扩展函数
  * @
@@ -12,7 +12,7 @@ const fs = require('fs-extra')
 const dayjs = require('dayjs')
 const iconv = require('iconv-lite')
 const { spawnSync } = require('child_process')
-const { detectEncoding } = require('../utils/normal.js')
+const { detectEncoding, analyzeReturn } = require('../utils/normal.js')
 const aiConsole = require('../utils/aiConsole.js')
 
 // 执行系统命令
@@ -82,11 +82,10 @@ async function requestAI(
 async function executeJSCode(code) {
   aiConsole.logSuccess('Executing JavaScript code: ')
   aiConsole.logSuccess(code)
-  // 检测code最后一行代码包含return，如果不包含，则返回一个错误信息，提示agent需要使用return返回结果
-  const codeLines = code.trim().split('\n')
-  const lastLine = codeLines[codeLines.length - 1].trim()
-  if (!lastLine.startsWith('return')) {
-    const error = new Error('The last line of the code must contain a return statement.')
+  // 校验代码片段中是否存在顶层 return，避免仅按最后一行判断导致误判。
+  const { hasReturnValue } = analyzeReturn(code)
+  if (!hasReturnValue) {
+    const error = new Error('The code must contain a return value.')
     throw error
   }
   try {
@@ -96,6 +95,7 @@ async function executeJSCode(code) {
       'require',
       `return (async () => {
           this.logMessages = []
+          this.Tools = Tools
           const originalLog = console.log
           const newLog = function () {
             originalLog.apply(console, arguments)

package/src/AgentRobot/BaseAgentRobot/utils/AIToolManager.js

@@ -49,6 +49,7 @@ class AIToolManager {
     // 外部工具扫描
     this.toolCollection = AttachmentToolScanner.getToolCollection(
       this.agentRobot.workspace,
+      this.agentRobot.basespace,
     ) // 加载工具集合
     this.clawSkillCollection = AttachmentToolScanner.getClawSkillCollection(
       this.agentRobot.basespace,

package/src/AgentRobot/BaseAgentRobot/utils/AttachmentToolScanner.js

@@ -9,7 +9,7 @@ class AttachmentToolType {
 
 class AttachmentToolScanner {
   // 获取附加工具
-  static getToolCollection(workspace) {
+  static getToolCollection(workspace, basespace) {
     // 从文件中加载附加技能
     // 动态加载这些文件，获取工具对象
     const attachTools = []
@@ -51,12 +51,14 @@ class AttachmentToolScanner {
      */
     // 1. 子agent创建时，不能拥有其他附加能力
     // 2. 使用platform过滤
-    const dir1 = path.resolve(__dirname, '../../../../') // 程序所在目录
+    const dir1 = path.resolve(__dirname, '../../../../../') // 程序所在目录
     const dir2 = path.resolve(workspace, './node_modules') // 工作目录下node_modules目录
     const dir3 = path.resolve(workspace, './') // 工作目录
     const dir4 = getGlobalNodeModulesPath()
+    const dir5 = path.resolve(basespace, 'skills') // 工作目录的父目录
+    const dir6 = path.resolve(basespace, 'clawSkills') // 工作目录的父目录
     const result = []
-    const searchDirs = [...new Set([dir1, dir2, dir3, dir4])]
+    const searchDirs = [...new Set([dir1, dir2, dir3, dir4, dir5, dir6])]
     for (const dirPath of searchDirs) {
       if (!fs.existsSync(dirPath)) {
         continue
@@ -172,7 +174,7 @@ ${table}
 - 使用用户请求匹配 skill description，
 - 一次只加载一个Skill，优先匹配最具体的Skill
 - 当用户请求不匹配任何Skill描述时，不加载任何Skill
-- 使用Skill前先使用readFile函数读取SKILL.md文件获取调用说明，通过仔细阅读说明文件学习Skill的使用方法，来完成任务 
+- 使用Skill前先使用readFile函数读取SKILL.md文件获取调用说明，通过仔细阅读说明文件学习Skill的使用方法，直接完成任务，无需创建子Agent来完成任务
 ## Available Skills
 
 | Skill | Type | Description | Location | SkillFilePath |

package/src/AgentRobot/BaseAgentRobot/utils/analyzeReturn.test.js

@@ -0,0 +1,104 @@
+const assert = require('assert')
+const { analyzeReturn } = require('./normal')
+
+function runCase(name, code, expected) {
+  const actual = analyzeReturn(code)
+  assert.deepStrictEqual(
+    actual,
+    expected,
+    `${name} failed\nexpected: ${JSON.stringify(expected)}\nactual:   ${JSON.stringify(actual)}\ncode:\n${code}`,
+  )
+}
+
+function run() {
+  const cases = [
+    {
+      name: 'empty input',
+      code: '',
+      expected: { hasReturn: false, hasReturnValue: false },
+    },
+    {
+      name: 'non-string input',
+      code: null,
+      expected: { hasReturn: false, hasReturnValue: false },
+    },
+    {
+      name: 'top-level return with number',
+      code: 'const x = 1\nreturn x + 1',
+      expected: { hasReturn: true, hasReturnValue: true },
+    },
+    {
+      name: 'top-level bare return',
+      code: 'if (ok) {\n  return\n}\nreturn;',
+      expected: { hasReturn: true, hasReturnValue: false },
+    },
+    {
+      name: 'ASI after return newline',
+      code: "return\n'hello'",
+      expected: { hasReturn: true, hasReturnValue: false },
+    },
+    {
+      name: 'return with inline comment and value',
+      code: 'return /* explain */ 42',
+      expected: { hasReturn: true, hasReturnValue: true },
+    },
+    {
+      name: 'return with line comment then newline',
+      code: 'return // explain\n42',
+      expected: { hasReturn: true, hasReturnValue: false },
+    },
+    {
+      name: 'return object literal',
+      code: 'return { ok: true }',
+      expected: { hasReturn: true, hasReturnValue: true },
+    },
+    {
+      name: 'return template literal',
+      code: 'return `done:${1}`',
+      expected: { hasReturn: true, hasReturnValue: true },
+    },
+    {
+      name: 'ignore return in string/comment',
+      code: "const s = 'return 1'\n// return 2\n/* return 3 */\nconst n = 4",
+      expected: { hasReturn: false, hasReturnValue: false },
+    },
+    {
+      name: 'ignore return in nested function declaration',
+      code: 'function inner() { return 1 }\nconst n = 1',
+      expected: { hasReturn: false, hasReturnValue: false },
+    },
+    {
+      name: 'ignore return in nested arrow block',
+      code: 'const fn = () => { return 1 }\nconst n = 1',
+      expected: { hasReturn: false, hasReturnValue: false },
+    },
+    {
+      name: 'ignore return in class method',
+      code: 'class A { m() { return 1 } }\nconst n = 1',
+      expected: { hasReturn: false, hasReturnValue: false },
+    },
+    {
+      name: 'ignore return in object method',
+      code: 'const obj = { m() { return 1 } }\nconst n = 1',
+      expected: { hasReturn: false, hasReturnValue: false },
+    },
+    {
+      name: 'top-level return exists even with nested returns',
+      code: 'const fn = () => { return 1 }\nif (ok) { return 2 }',
+      expected: { hasReturn: true, hasReturnValue: true },
+    },
+    {
+      name: 'real-world code snippet from code.txt shape',
+      code: "const fs = require('fs')\nconst content = 'x'\nreturn 'File updated successfully.'",
+      expected: { hasReturn: true, hasReturnValue: true },
+    },
+  ]
+
+  for (const testCase of cases) {
+    runCase(testCase.name, testCase.code, testCase.expected)
+  }
+
+  console.log(`analyzeReturn tests passed: ${cases.length} cases`)
+}
+
+run()

package/src/AgentRobot/BaseAgentRobot/utils/normal.js

@@ -101,6 +101,293 @@ function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms))
 }
 
+// 判断代码是否有返回值
+function analyzeReturn(code) {
+  if (typeof code !== 'string' || !code.trim()) {
+    return {
+      hasReturn: false,
+      hasReturnValue: false,
+    }
+  }
+
+  // 移除字符串和注释，避免把文本中的 return 误判为代码关键字。
+  function stripStringsAndComments(input) {
+    const chars = input.split('')
+    let i = 0
+    let state = 'normal'
+
+    while (i < chars.length) {
+      const ch = chars[i]
+      const next = chars[i + 1]
+
+      if (state === 'normal') {
+        if (ch === '/' && next === '/') {
+          state = 'line-comment'
+          chars[i] = ' '
+          chars[i + 1] = ' '
+          i += 2
+          continue
+        }
+        if (ch === '/' && next === '*') {
+          state = 'block-comment'
+          chars[i] = ' '
+          chars[i + 1] = ' '
+          i += 2
+          continue
+        }
+        if (ch === "'") {
+          state = 'single-quote'
+          chars[i] = ' '
+          i += 1
+          continue
+        }
+        if (ch === '"') {
+          state = 'double-quote'
+          chars[i] = ' '
+          i += 1
+          continue
+        }
+        if (ch === '`') {
+          state = 'template'
+          chars[i] = ' '
+          i += 1
+          continue
+        }
+        i += 1
+        continue
+      }
+
+      if (state === 'line-comment') {
+        if (ch === '\n') {
+          state = 'normal'
+        } else {
+          chars[i] = ' '
+        }
+        i += 1
+        continue
+      }
+
+      if (state === 'block-comment') {
+        if (ch === '*' && next === '/') {
+          chars[i] = ' '
+          chars[i + 1] = ' '
+          state = 'normal'
+          i += 2
+        } else {
+          if (ch !== '\n') {
+            chars[i] = ' '
+          }
+          i += 1
+        }
+        continue
+      }
+
+      if (state === 'single-quote') {
+        if (ch === '\\') {
+          chars[i] = ' '
+          if (i + 1 < chars.length) {
+            chars[i + 1] = ' '
+          }
+          i += 2
+          continue
+        }
+        chars[i] = ch === '\n' ? '\n' : ' '
+        if (ch === "'") {
+          state = 'normal'
+        }
+        i += 1
+        continue
+      }
+
+      if (state === 'double-quote') {
+        if (ch === '\\') {
+          chars[i] = ' '
+          if (i + 1 < chars.length) {
+            chars[i + 1] = ' '
+          }
+          i += 2
+          continue
+        }
+        chars[i] = ch === '\n' ? '\n' : ' '
+        if (ch === '"') {
+          state = 'normal'
+        }
+        i += 1
+        continue
+      }
+
+      if (state === 'template') {
+        if (ch === '\\') {
+          chars[i] = ' '
+          if (i + 1 < chars.length) {
+            chars[i + 1] = ' '
+          }
+          i += 2
+          continue
+        }
+        chars[i] = ch === '\n' ? '\n' : ' '
+        if (ch === '`') {
+          state = 'normal'
+        }
+        i += 1
+      }
+    }
+
+    return chars.join('')
+  }
+
+  function isReturnWithValue(input, startIndex) {
+    let i = startIndex
+    while (i < input.length) {
+      const ch = input[i]
+      const next = input[i + 1]
+      if (ch === ' ' || ch === '\t' || ch === '\r') {
+        i += 1
+        continue
+      }
+
+      if (ch === '/' && next === '/') {
+        i += 2
+        while (i < input.length && input[i] !== '\n') {
+          i += 1
+        }
+        continue
+      }
+
+      if (ch === '/' && next === '*') {
+        i += 2
+        while (i < input.length) {
+          if (input[i] === '*' && input[i + 1] === '/') {
+            i += 2
+            break
+          }
+          i += 1
+        }
+        continue
+      }
+
+      if (ch === '\n' || ch === ';' || ch === '}' || ch === ')') {
+        return false
+      }
+      return true
+    }
+    return false
+  }
+
+  function isControlKeyword(token) {
+    return ['if', 'for', 'while', 'switch', 'catch', 'with'].includes(token)
+  }
+
+  const cleaned = stripStringsAndComments(code)
+  const tokenRegex = /[A-Za-z_$][\w$]*|=>|[{}()\[\]]/g
+  const blockStack = []
+  const parenStack = []
+  let functionDepth = 0
+  let pendingFunctionBlock = 0
+  let pendingArrow = false
+  let hasReturn = false
+  let hasReturnValue = false
+  let lastToken = ''
+  let recentClosedParen = null
+  let match
+
+  while ((match = tokenRegex.exec(cleaned)) !== null) {
+    const token = match[0]
+    const index = match.index
+
+    if (token === '(') {
+      parenStack.push({
+        beforeToken: lastToken,
+      })
+      lastToken = token
+      continue
+    }
+
+    if (token === ')') {
+      recentClosedParen = parenStack.pop() || null
+      lastToken = token
+      continue
+    }
+
+    if (token === 'function') {
+      pendingFunctionBlock += 1
+      pendingArrow = false
+      lastToken = token
+      recentClosedParen = null
+      continue
+    }
+
+    if (token === '=>') {
+      pendingArrow = true
+      lastToken = token
+      recentClosedParen = null
+      continue
+    }
+
+    if (token === '{') {
+      let isFunctionBlock = false
+      if (pendingFunctionBlock > 0 || pendingArrow) {
+        isFunctionBlock = true
+      } else if (lastToken === ')' && recentClosedParen) {
+        const beforeToken = recentClosedParen.beforeToken
+        if (beforeToken && !isControlKeyword(beforeToken)) {
+          // 识别 class/object method 这类无 function 关键字的方法体。
+          isFunctionBlock = true
+        }
+      }
+
+      if (isFunctionBlock) {
+        blockStack.push('function')
+        functionDepth += 1
+        if (pendingFunctionBlock > 0) {
+          pendingFunctionBlock -= 1
+        }
+      } else {
+        blockStack.push('block')
+      }
+
+      pendingArrow = false
+      lastToken = token
+      recentClosedParen = null
+      continue
+    }
+
+    if (token === '}') {
+      const top = blockStack.pop()
+      if (top === 'function' && functionDepth > 0) {
+        functionDepth -= 1
+      }
+      pendingArrow = false
+      lastToken = token
+      recentClosedParen = null
+      continue
+    }
+
+    if (token === 'return' && functionDepth === 0) {
+      hasReturn = true
+      if (isReturnWithValue(code, index + token.length)) {
+        hasReturnValue = true
+      }
+      if (hasReturn && hasReturnValue) {
+        break
+      }
+    }
+
+    if (pendingArrow) {
+      // 箭头函数表达式体不带 {} 时，不会有 return 关键字参与判断。
+      pendingArrow = false
+    }
+
+    lastToken = token
+    recentClosedParen = null
+  }
+
+  return {
+    hasReturn,
+    hasReturnValue,
+  }
+}
+
 module.exports = {
   objStrToObj,
   delay,
@@ -108,4 +395,5 @@ module.exports = {
   openDirectory,
   detectEncoding,
   sleep,
+  analyzeReturn,
 }

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-04-17 09:38:33
+ * @LastEditTime: 2026-05-06 14:53:07
  * @FilePath: \deepfish\src\cli\SkillConfigManager.js
  * @Description: Skill configuration manager
  */
@@ -89,7 +89,8 @@ class SkillConfigManager {
     // 如果数组的数量与目录中的数量不一致，则自动同步
     const skills = this.readSkills()
     const skillDirs = fs.readdirSync(this.skillDir).filter((file) => {
-      return fs.statSync(path.join(this.skillDir, file)).isDirectory()
+      const fullPath = path.join(this.skillDir, file)
+      return fs.statSync(fullPath).isDirectory() && fs.existsSync(path.join(fullPath, 'SKILL.md'))
     })
     if (skills.length === skillDirs.length) {
       return

package/src/AgentRobot/BaseAgentRobot/lazy-tools/embedding.js

@@ -1,459 +0,0 @@
-const path = require('path')
-const fs = require('fs-extra')
-const crypto = require('crypto')
-const mammoth = require('mammoth')
-const pdfParse = require('pdf-parse')
-const XLSX = require('xlsx')
-const aiInquirer = require('../utils/aiInquirer')
-
-function ok(data = null) {
-  return { success: true, data }
-}
-
-function fail(error, data = null) {
-  return { success: false, error: error?.message || String(error), data }
-}
-
-function _getKbRootPath() {
-  return path.resolve(process.cwd(), '.deepfish-rag')
-}
-
-function _getKbIndexPath(kbRootPath) {
-  return path.join(kbRootPath, 'index.json')
-}
-
-function _sha256(content) {
-  return crypto.createHash('sha256').update(content).digest('hex')
-}
-
-function _isSupportedFile(filePath) {
-  const ext = path.extname(filePath).toLowerCase()
-  const supportedExts = new Set([
-    '.md', '.txt', '.json', '.js', '.mjs', '.cjs', '.ts', '.tsx', '.jsx', '.html', '.htm', '.css', '.scss', '.less', '.xml', '.yaml', '.yml', '.csv', '.log', '.sql', '.py', '.java', '.go', '.rs', '.cpp', '.c', '.h', '.docx', '.pdf', '.xlsx', '.xls',
-  ])
-  return supportedExts.has(ext)
-}
-
-function _collectSourceFiles(sourcePath) {
-  const stat = fs.statSync(sourcePath)
-  if (stat.isFile()) {
-    return [sourcePath]
-  }
-  const files = []
-  const walk = (current) => {
-    const children = fs.readdirSync(current)
-    for (const child of children) {
-      const fullPath = path.join(current, child)
-      const childStat = fs.statSync(fullPath)
-      if (childStat.isDirectory()) {
-        walk(fullPath)
-      } else if (childStat.isFile()) {
-        files.push(fullPath)
-      }
-    }
-  }
-  walk(sourcePath)
-  return files
-}
-
-async function _readDocumentContent(filePath) {
-  const ext = path.extname(filePath).toLowerCase()
-  if (ext === '.docx') {
-    const result = await mammoth.extractRawText({ path: filePath })
-    return result.value || ''
-  }
-  if (ext === '.pdf') {
-    const buffer = fs.readFileSync(filePath)
-    const result = await pdfParse(buffer)
-    return result.text || ''
-  }
-  if (ext === '.xlsx' || ext === '.xls') {
-    const workbook = XLSX.readFile(filePath)
-    return workbook.SheetNames.map((sheetName) => {
-      const rows = XLSX.utils.sheet_to_json(workbook.Sheets[sheetName], { header: 1 })
-      return [`# ${sheetName}`, ...rows.map((row) => row.join(' | '))].join('\n')
-    }).join('\n\n')
-  }
-  return fs.readFileSync(filePath, 'utf8')
-}
-
-function _normalizeText(content = '') {
-  return String(content || '').replace(/\s+/g, ' ').trim()
-}
-
-function _buildSummary(content = '', maxLen = 320) {
-  const normalized = _normalizeText(content)
-  if (!normalized) return ''
-  if (normalized.length <= maxLen) return normalized
-  return `${normalized.slice(0, maxLen)}...`
-}
-
-async function _extractSummary(content = '', maxLen = 320, absolutePath = '') {
-  const fallbackSummary = _buildSummary(content, maxLen)
-  if (!fallbackSummary) return ''
-
-  if (!this?.Tools?.requestAI) {
-    return fallbackSummary
-  }
-
-  const systemDescription = '你是文档摘要助手，只输出简洁摘要正文，不要解释。'
-  const prompt = `请为下面文档提取摘要：\n\n文档路径：${absolutePath || '未知'}\n文档内容：\n${content}\n\n要求：\n1. 输出中文摘要，保留关键事实与结论。\n2. 摘要长度不超过${maxLen}个字符。\n3. 不要输出标题、前后缀或解释，只输出摘要正文。`
-
-  try {
-    const aiSummary = await this.Tools.requestAI(systemDescription, prompt, 0.2)
-    if (typeof aiSummary !== 'string') {
-      return fallbackSummary
-    }
-    const normalizedSummary = _normalizeText(aiSummary)
-    if (!normalizedSummary) {
-      return fallbackSummary
-    }
-    return normalizedSummary.length > maxLen
-      ? `${normalizedSummary.slice(0, maxLen)}...`
-      : normalizedSummary
-  } catch {
-    return fallbackSummary
-  }
-}
-
-function _getEmptyKnowledgeBase(kbRootPath) {
-  const now = new Date().toISOString()
-  return {
-    version: 2,
-    name: 'deepfish-rag',
-    kbRootPath,
-    createdAt: now,
-    updatedAt: now,
-    sourceHistory: [],
-    documents: [],
-  }
-}
-
-function _loadKnowledgeBase(kbRootPath) {
-  const indexPath = _getKbIndexPath(kbRootPath)
-  fs.ensureDirSync(kbRootPath)
-  if (!fs.existsSync(indexPath)) {
-    const emptyKb = _getEmptyKnowledgeBase(kbRootPath)
-    fs.writeFileSync(indexPath, JSON.stringify(emptyKb, null, 2), 'utf8')
-    return emptyKb
-  }
-
-  const content = fs.readFileSync(indexPath, 'utf8')
-  const parsed = JSON.parse(content)
-  const base = {
-    ..._getEmptyKnowledgeBase(kbRootPath),
-    ...parsed,
-    kbRootPath,
-  }
-
-  // 向后兼容旧结构：若旧数据里有content，则在加载时迁移为summary。
-  base.documents = (base.documents || []).map((doc) => {
-    const absolutePath = path.resolve(doc.absolutePath || doc.sourcePath || '')
-    return {
-      id: doc.id || _sha256(absolutePath).slice(0, 16),
-      absolutePath,
-      sourceHash: doc.sourceHash || '',
-      size: doc.size || 0,
-      summary: doc.summary || _buildSummary(doc.content || ''),
-      createdAt: doc.createdAt || base.createdAt,
-      updatedAt: doc.updatedAt || base.updatedAt,
-    }
-  })
-
-  return base
-}
-
-function _saveKnowledgeBase(kbRootPath, knowledgeBase) {
-  const indexPath = _getKbIndexPath(kbRootPath)
-  knowledgeBase.updatedAt = new Date().toISOString()
-  fs.writeFileSync(indexPath, JSON.stringify(knowledgeBase, null, 2), 'utf8')
-}
-
-async function _upsertKnowledgeBase(sourcePath = '', knowledgeBasePath = '', reset = false) {
-  const inputSourcePath = sourcePath || (await aiInquirer.askInput('请输入源文件目录或文件路径', '', {}))
-  if (!inputSourcePath) {
-    return fail('未提供源文件目录或文件路径')
-  }
-
-  const resolvedSourcePath = path.resolve(process.cwd(), inputSourcePath)
-  if (!fs.existsSync(resolvedSourcePath)) {
-    return fail(`Source path does not exist: ${resolvedSourcePath}`, {
-      sourcePath: resolvedSourcePath,
-    })
-  }
-
-  const kbRootPath = _getKbRootPath(knowledgeBasePath)
-  if (reset && fs.existsSync(kbRootPath)) {
-    fs.removeSync(kbRootPath)
-  }
-
-  const knowledgeBase = _loadKnowledgeBase(kbRootPath)
-  const sourceFiles = _collectSourceFiles(resolvedSourcePath)
-  const supportedFiles = sourceFiles.filter((filePath) => _isSupportedFile(filePath))
-
-  let addedCount = 0
-  let updatedCount = 0
-  let skippedCount = 0
-
-  for (const filePath of supportedFiles) {
-    try {
-      const absolutePath = path.resolve(filePath)
-      const content = await _readDocumentContent(absolutePath)
-      if (!content || !content.trim()) {
-        skippedCount += 1
-        continue
-      }
-
-      const sourceHash = _sha256(content)
-      const existingIndex = knowledgeBase.documents.findIndex((item) => item.absolutePath === absolutePath)
-
-      if (existingIndex >= 0) {
-        if (knowledgeBase.documents[existingIndex].sourceHash === sourceHash) {
-          skippedCount += 1
-          continue
-        }
-
-        const summary = await _extractSummary.call(this, content, 320, absolutePath)
-
-        knowledgeBase.documents[existingIndex] = {
-          ...knowledgeBase.documents[existingIndex],
-          sourceHash,
-          size: Buffer.byteLength(content, 'utf8'),
-          summary,
-          updatedAt: new Date().toISOString(),
-        }
-        _saveKnowledgeBase(kbRootPath, knowledgeBase)
-        updatedCount += 1
-        continue
-      }
-
-      const summary = await _extractSummary.call(this, content, 320, absolutePath)
-
-      knowledgeBase.documents.push({
-        id: _sha256(absolutePath).slice(0, 16),
-        absolutePath,
-        sourceHash,
-        size: Buffer.byteLength(content, 'utf8'),
-        summary,
-        createdAt: new Date().toISOString(),
-        updatedAt: new Date().toISOString(),
-      })
-      _saveKnowledgeBase(kbRootPath, knowledgeBase)
-      addedCount += 1
-    } catch {
-      skippedCount += 1
-    }
-  }
-
-  knowledgeBase.sourceHistory.push({
-    sourcePath: resolvedSourcePath,
-    loadedAt: new Date().toISOString(),
-    scannedFiles: sourceFiles.length,
-    supportedFiles: supportedFiles.length,
-    addedCount,
-    updatedCount,
-    skippedCount,
-    mode: reset ? 'create' : 'append',
-  })
-
-  _saveKnowledgeBase(kbRootPath, knowledgeBase)
-
-  return ok({
-    knowledgeBasePath: kbRootPath,
-    sourcePath: resolvedSourcePath,
-    scannedFiles: sourceFiles.length,
-    supportedFiles: supportedFiles.length,
-    addedCount,
-    updatedCount,
-    skippedCount,
-    totalDocuments: knowledgeBase.documents.length,
-  })
-}
-
-async function createKnowledgeBase(sourcePath = '', knowledgeBasePath = '') {
-  try {
-    return await _upsertKnowledgeBase.call(this, sourcePath, knowledgeBasePath, true)
-  } catch (error) {
-    return fail(error, { sourcePath, knowledgeBasePath })
-  }
-}
-
-async function appendKnowledgeBase(sourcePath = '', knowledgeBasePath = '') {
-  try {
-    return await _upsertKnowledgeBase.call(this, sourcePath, knowledgeBasePath, false)
-  } catch (error) {
-    return fail(error, { sourcePath, knowledgeBasePath })
-  }
-}
-
-function _matchSummary(knowledgeBase, normalizedKeyword = '', maxResult = 10) {
-  const filtered = knowledgeBase.documents.filter((item) => {
-    if (!normalizedKeyword) return true
-    const haystack = `${item.absolutePath || ''} ${item.summary || ''}`.toLowerCase()
-    return haystack.includes(normalizedKeyword)
-  })
-
-  return filtered.slice(0, maxResult).map((item) => ({
-    id: item.id,
-    absolutePath: item.absolutePath,
-    size: item.size,
-    updatedAt: item.updatedAt,
-    summary: item.summary,
-  }))
-}
-
-async function _queryBySubAgent(keyword, summaryMatches, includeFullDocument = false) {
-  if (!this?.Tools?.createSubAgent) {
-    return {
-      success: false,
-      skipped: true,
-      reason: 'createSubAgent tool is unavailable in current context',
-    }
-  }
-
-  const prompt = `你是知识库检索子agent，请完成文档检索。
-
-用户关键词：${keyword}
-是否允许读取全文：${includeFullDocument ? '是' : '否（仅在必要时）'}
-候选文档（按摘要初筛后）如下：
-${JSON.stringify(summaryMatches, null, 2)}
-
-执行要求：
-1. 先使用候选文档的summary进行关键词匹配和排序。
-2. 当summary不足以回答问题时，再读取对应absolutePath的完整文档内容进行补充。
-3. 输出结构化结果，必须包含：
-   - 命中文档列表（id、absolutePath、匹配原因）
-   - 最终结论
-   - 若读取全文，列出已读取的absolutePath。
-`
-
-  return this.Tools.createSubAgent(prompt)
-}
-
-async function queryKnowledgeBase(keyword = '', knowledgeBasePath = '', limit = 10, includeFullDocument = false) {
-  try {
-    const normalizedKeyword = String(keyword || '').trim().toLowerCase()
-    if (!normalizedKeyword) {
-      return fail('keyword is required')
-    }
-
-    const kbRootPath = _getKbRootPath(knowledgeBasePath)
-    const knowledgeBase = _loadKnowledgeBase(kbRootPath)
-    const maxResult = Number(limit) > 0 ? Number(limit) : 10
-    const summaryMatches = _matchSummary(knowledgeBase, normalizedKeyword, maxResult)
-
-    let subAgentResult = null
-    if (summaryMatches.length > 0) {
-      subAgentResult = await _queryBySubAgent.call(this, keyword, summaryMatches, includeFullDocument)
-    }
-
-    return ok({
-      knowledgeBasePath: kbRootPath,
-      keyword,
-      totalDocuments: knowledgeBase.documents.length,
-      matchedDocuments: summaryMatches.length,
-      items: summaryMatches,
-      subAgentResult,
-    })
-  } catch (error) {
-    return fail(error, { keyword, knowledgeBasePath, limit, includeFullDocument })
-  }
-}
-
-function deleteKnowledgeBase(knowledgeBasePath = '') {
-  try {
-    const kbRootPath = _getKbRootPath(knowledgeBasePath)
-    if (!fs.existsSync(kbRootPath)) {
-      return ok({
-        knowledgeBasePath: kbRootPath,
-        deleted: false,
-        message: 'knowledge base path not found',
-      })
-    }
-
-    fs.removeSync(kbRootPath)
-    return ok({
-      knowledgeBasePath: kbRootPath,
-      deleted: true,
-    })
-  } catch (error) {
-    return fail(error, { knowledgeBasePath })
-  }
-}
-
-const descriptions = [
-  {
-    type: 'function',
-    function: {
-      name: 'createKnowledgeBase',
-      description: '创建知识库（先删除旧库再重建），存储文档绝对路径和约300字摘要。',
-      parameters: {
-        type: 'object',
-        properties: {
-          sourcePath: { type: 'string', description: '源文件目录或文件路径。为空时会交互输入。' },
-        },
-        required: [],
-      },
-    },
-  },
-  {
-    type: 'function',
-    function: {
-      name: 'appendKnowledgeBase',
-      description: '续加知识库（增量导入），存储文档绝对路径和约300字摘要。',
-      parameters: {
-        type: 'object',
-        properties: {
-          sourcePath: { type: 'string', description: '源文件目录或文件路径。为空时会交互输入。' },
-        },
-        required: [],
-      },
-    },
-  },
-  {
-    type: 'function',
-    function: {
-      name: 'queryKnowledgeBase',
-      description: '查询知识库：先按摘要匹配关键词，再由子agent在必要时读取命中文档的完整内容。',
-      parameters: {
-        type: 'object',
-        properties: {
-          keyword: { type: 'string', description: '检索关键词。' },
-          limit: { type: 'number', description: '返回数量上限，默认 10。' },
-          includeFullDocument: { type: 'boolean', description: '是否允许子agent读取全文，默认 false。' },
-        },
-        required: ['keyword'],
-      },
-    },
-  },
-  {
-    type: 'function',
-    function: {
-      name: 'deleteKnowledgeBase',
-      description: '删除知识库目录（默认删除命令执行目录下的 .deepfish-rag）。',
-      parameters: {
-        type: 'object',
-        properties: {},
-        required: [],
-      },
-    },
-  },
-]
-
-const functions = {
-  createKnowledgeBase,
-  appendKnowledgeBase,
-  queryKnowledgeBase,
-  deleteKnowledgeBase,
-}
-
-const EmbeddingTool = {
-  name: 'EmbeddingTool',
-  description: '提供本地知识库创建、续加、查询、删除能力（索引仅存摘要和绝对路径）',
-  platform: 'all',
-  descriptions,
-  functions,
-  isSystem: true
-}
-
-module.exports = EmbeddingTool