deepfish-ai 1.0.20 → 1.0.22

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

@@ -102,8 +102,9 @@ async function getGenerateSkillRules(goal) {
 2. 命名规范：
    - 函数名称前缀：「领域用途+分隔符」（如systemFileManagement_）
    - 函数描述开头：统一格式「领域用途+分隔符+功能描述」（如系统文件管理:重命名文件）
-3. 内置工具函数调用：函数内可以使用内置工具函数requestAI来获取AI请求结果，在环境中通过this.Tools注入，示例：
+3. 内置工具函数调用：函数内可以使用内置工具函数requestAI来获取AI请求结果，在环境中通过this.Tools注入，必要时也可以使用其他函数，示例：
    - this.Tools.requestAI(systemDescription, prompt, temperature)
+   - this.Tools.executeCommand(command)
 4. 函数数量：至少包含1个可被AI工作流调用的函数
 5. 拆分成多个文件,保持文件结构清晰
 6. 对于大于5个的扩展功能，需要在functions中输出一个说明函数，只需返回一个markdown类型的英文字符串，专门用于解释当前扩展工具的使用方法、参数说明、示例等内容，函数名称为「readme」，如「systemFileManagement_readme」；函数描述需要强调调用该扩展模块前必须先阅读该规则文档。

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

@@ -2,7 +2,7 @@
  * @Author: Roman 306863030@qq.com
  * @Date: 2026-03-17 11:59:19
  * @LastEditors: Roman 306863030@qq.com
- * @LastEditTime: 2026-04-20 17:47:12
+ * @LastEditTime: 2026-04-21 21:08:34
  * @FilePath: \deepfish\src\AgentRobot\BaseAgentRobot\tools\SystemTools.js
  * @Description: 默认扩展函数
  * @
@@ -83,7 +83,13 @@ 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.')
+    throw error
+  }
   try {
     const functions = this.agentRobot.getTools()
     const Func = new Function(
@@ -97,9 +103,12 @@ async function executeJSCode(code) {
             this.logMessages.push(Array.from(arguments).join(' '))
           }
           console.log = newLog.bind(this)
-          ${code}
+          function __main() {
+            ${code}
+          }
+          const result = await __main()
           console.log = originalLog
-          return this.logMessages.join('\\n')
+          return result || this.logMessages.join('\\n')
         })()`,
     )
     const originalRequire = require
@@ -191,7 +200,7 @@ const descriptions = [
     function: {
       name: 'executeJSCode',
       description:
-        '执行JavaScript代码，返回代码执行结果。代码中可通过Tools命名空间直接调用其他工具函数（如await Tools.createFile(),注意：不需要使用require引入）,Tools中引入了一些常用库可直接调用（Tools.fs="fs-extra", Tools.dayjs="dayjs", Tools.axios="axios", Tools.lodash="lodash", Tools.echarts="echarts", Tools.canvas="canvas" Tools.cheerio="cheerio" Tools.puppeteer="puppeteer"），支持引入自定义模块（需使用绝对路径）。注意：1.代码中不要使用__dirname获取当前目录，请使用path.resolve(".")来获取当前目录。2.执行失败时会抛出错误，成功时返回代码执行结果或空字符串。3.使用require(module_path)函数引入自定义模块，module_path为模块路径字符串，支持相对路径（如"./myModule.js"）和绝对路径，返回引入的模块内容。',
+        '执行JavaScript代码，返回代码执行结果。代码中可通过Tools命名空间直接调用其他工具函数（如await Tools.createFile(),注意：不需要使用require引入）,Tools中引入了一些常用库可直接调用（Tools.fs="fs-extra", Tools.dayjs="dayjs", Tools.axios="axios", Tools.lodash="lodash", Tools.echarts="echarts", Tools.canvas="canvas" Tools.cheerio="cheerio" Tools.puppeteer="puppeteer"），支持引入自定义模块（需使用绝对路径）。注意：1.代码中不要使用__dirname获取当前目录，请使用path.resolve(".")来获取当前目录。2.执行失败时会抛出错误，成功时返回代码执行结果或空字符串。3.使用require(module_path)函数引入自定义模块，module_path为模块路径字符串，支持相对路径（如"./myModule.js"）和绝对路径，返回引入的模块内容。4.执行主函数必须使用return返回，如return main()',
       parameters: {
         type: 'object',
         properties: {

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

@@ -0,0 +1,256 @@
+const axios = require('axios')
+const cheerio = require('cheerio')
+const puppeteer = require('puppeteer')
+
+function ok(data = null) {
+  return { success: true, data }
+}
+
+function fail(error, data = null) {
+  return { success: false, error: error?.message || String(error), data }
+}
+
+function normalizeWhitespace(text = '') {
+  return String(text || '').replace(/\s+/g, ' ').trim()
+}
+
+function absoluteUrl(baseUrl, href = '') {
+  try {
+    return new URL(href, baseUrl).toString()
+  } catch {
+    return href
+  }
+}
+
+function extractByCheerio(html = '', url = '') {
+  const $ = cheerio.load(html)
+  $('script, style, noscript').remove()
+
+  const title = normalizeWhitespace($('title').first().text())
+  const bodyText = normalizeWhitespace($('body').text())
+  const metaDescription = normalizeWhitespace(
+    $('meta[name="description"]').attr('content') ||
+      $('meta[property="og:description"]').attr('content') ||
+      '',
+  )
+
+  const links = []
+  $('a[href]').each((_, el) => {
+    const href = $(el).attr('href') || ''
+    const text = normalizeWhitespace($(el).text())
+    if (!href) return
+    links.push({
+      href: absoluteUrl(url, href),
+      text,
+    })
+  })
+
+  return {
+    title,
+    description: metaDescription,
+    content: bodyText,
+    links,
+  }
+}
+
+async function fetchStatic(url, timeout = 15000) {
+  const response = await axios.get(url, {
+    timeout,
+    headers: {
+      'User-Agent':
+        'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130 Safari/537.36 DeepFish-MCP-Web/1.0',
+      Accept: 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
+    },
+  })
+  return response.data
+}
+
+async function fetchDynamic(url, waitUntil = 'networkidle2', timeout = 30000) {
+  const browser = await puppeteer.launch({
+    args: ['--no-sandbox', '--disable-setuid-sandbox'],
+  })
+  try {
+    const page = await browser.newPage()
+    await page.goto(url, { waitUntil, timeout })
+    return await page.content()
+  } finally {
+    await browser.close()
+  }
+}
+
+async function mcpBrowseWebpage(url, mode = 'auto', maxChars = 4000) {
+  try {
+    if (!url) {
+      return fail('url is required')
+    }
+
+    let html = ''
+    let resolvedMode = mode
+
+    if (mode === 'dynamic') {
+      html = await fetchDynamic(url)
+    } else if (mode === 'static') {
+      html = await fetchStatic(url)
+    } else {
+      try {
+        html = await fetchStatic(url)
+        resolvedMode = 'static'
+      } catch {
+        html = await fetchDynamic(url)
+        resolvedMode = 'dynamic'
+      }
+    }
+
+    const parsed = extractByCheerio(html, url)
+    const content = parsed.content.slice(0, Number(maxChars) > 0 ? Number(maxChars) : 4000)
+    const links = parsed.links.slice(0, 50)
+
+    return ok({
+      url,
+      mode: resolvedMode,
+      title: parsed.title,
+      description: parsed.description,
+      content,
+      contentLength: parsed.content.length,
+      links,
+      linkCount: parsed.links.length,
+    })
+  } catch (error) {
+    return fail(error, { url, mode, maxChars })
+  }
+}
+
+async function mcpFetchWebpageByQuery(url, query, mode = 'auto', limit = 20) {
+  try {
+    if (!url) {
+      return fail('url is required')
+    }
+    if (!query) {
+      return fail('query is required')
+    }
+
+    const browseResult = await mcpBrowseWebpage(url, mode, 200000)
+    if (!browseResult.success) {
+      return browseResult
+    }
+
+    const keyword = String(query).toLowerCase().trim()
+    const rawContent = browseResult.data.content || ''
+    const sentences = rawContent
+      .split(/[。！？.!?\n]/)
+      .map((item) => normalizeWhitespace(item))
+      .filter(Boolean)
+
+    const matchedSentences = sentences
+      .map((text) => {
+        const lower = text.toLowerCase()
+        let score = 0
+        let fromIndex = 0
+        while (true) {
+          const idx = lower.indexOf(keyword, fromIndex)
+          if (idx < 0) break
+          score += 1
+          fromIndex = idx + keyword.length
+        }
+        return { text, score }
+      })
+      .filter((item) => item.score > 0)
+      .sort((a, b) => b.score - a.score)
+      .slice(0, Number(limit) > 0 ? Number(limit) : 20)
+
+    const matchedLinks = (browseResult.data.links || [])
+      .filter((item) => {
+        const href = String(item.href || '').toLowerCase()
+        const text = String(item.text || '').toLowerCase()
+        return href.includes(keyword) || text.includes(keyword)
+      })
+      .slice(0, Number(limit) > 0 ? Number(limit) : 20)
+
+    return ok({
+      url,
+      query,
+      mode: browseResult.data.mode,
+      title: browseResult.data.title,
+      matchedSentenceCount: matchedSentences.length,
+      matchedLinkCount: matchedLinks.length,
+      matchedSentences,
+      matchedLinks,
+    })
+  } catch (error) {
+    return fail(error, { url, query, mode, limit })
+  }
+}
+
+const descriptions = [
+  {
+    type: 'function',
+    function: {
+      name: 'mcpBrowseWebpage',
+      description:
+        'MCP网页浏览: 打开并抓取任意网页的标题、摘要正文与链接列表。适合快速浏览网页内容。',
+      parameters: {
+        type: 'object',
+        properties: {
+          url: {
+            type: 'string',
+            description: '要浏览的网页地址（http或https）。',
+          },
+          mode: {
+            type: 'string',
+            description: '抓取模式：auto|static|dynamic。默认auto。',
+          },
+          maxChars: {
+            type: 'number',
+            description: '返回正文最大字符数，默认4000。',
+          },
+        },
+        required: ['url'],
+      },
+    },
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'mcpFetchWebpageByQuery',
+      description:
+        'MCP网页抓取: 按关键词从网页正文和链接中提取匹配内容，返回高相关片段。',
+      parameters: {
+        type: 'object',
+        properties: {
+          url: {
+            type: 'string',
+            description: '目标网页地址（http或https）。',
+          },
+          query: {
+            type: 'string',
+            description: '要匹配的关键词。',
+          },
+          mode: {
+            type: 'string',
+            description: '抓取模式：auto|static|dynamic。默认auto。',
+          },
+          limit: {
+            type: 'number',
+            description: '返回匹配结果上限，默认20。',
+          },
+        },
+        required: ['url', 'query'],
+      },
+    },
+  },
+]
+
+const functions = {
+  mcpBrowseWebpage,
+  mcpFetchWebpageByQuery,
+}
+
+const MCPWebTool = {
+  name: 'MCPWebTool',
+  description: '提供网页浏览与内容抓取能力，支持任意网页的读取与关键词提取。',
+  platform: 'all',
+  descriptions,
+  functions,
+}
+
+module.exports = MCPWebTool

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

@@ -166,7 +166,7 @@ ${table}
           `| ${s.name} | ${s.type} | ${s.description || s.extensionDescription} | ${s.location} | ${s.filePath || s.skillFilePath} |`,
       )
       .join('\n')
-    let skills1 = `
+    let skills1 = clawSkills.length > 0 ? `
     ### 优先使用的Skills
 可以优先调用以下Skill来完成用户的请求，Skill的调用方式：
 - 使用用户请求匹配 skill description，
@@ -179,8 +179,8 @@ ${table}
 |-------|------|-------------|----------|---------------|
 ${table1}
 |-------|------|-------------|----------|---------------|
-`
-  let skills2 = `
+` : '### 无优先使用的Skills'
+  let skills2 = toolCollection.length + clawSkillCollection.length > 0 ?  `
 ### 其他可以使用的Skills
 可以调用以下Skill来完成用户的请求，Skill的调用方式：
 - 使用用户请求匹配 skill description，
@@ -194,9 +194,8 @@ ${table1}
 |-------|------|-------------|----------|----------|
 ${table2}
 |-------|------|-------------|----------|----------|
-`
+`: '### 无其他可用的Skills'
 return skills1 + '\n' + skills2
-
   }
 
   // 扫描包

package/src/cli/DefaultConfig.js

@@ -8,6 +8,8 @@ const defaultConfig = {
   maxLogExpireTime: 3, // 日志过期时间，单位天，-1表示无限制，0表示不记录
   maxBlockFileSize: 20, // 最大分块文件大小，单位KB；超过该大小的文件需要分块处理
   encoding: 'auto', // 命令行编码格式, 可设置为utf-8、gbk等, 也可以设置成auto或空值自动判断
+  EMBEDDING_API: '', // 向量化接口地址
+  EMBEDDING_API_KEY: '' // 向量化接口密钥
 }
 
 const aiCliConfig = {