deepfish-ai 1.0.17 → 1.0.19

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"
@@ -109,7 +109,7 @@ npm link
 
 ```bash
 ai config add # Enter a name, then select deepseek, and enter your DeepSeek API key
-ai use [the_name_you_entered]
+ai config use [the_name_you_entered]
 ai "Help me write an article about future technology in the current directory, output in markdown format"
 ```
 
@@ -145,13 +145,6 @@ ai config view [name] # View details of the specified AI configuration
 ai config edit # Edit the configuration file manually
 ai config dir # Open the configuration file directory
 ai config reset # Reset configuration
-ai config clear # Delete the configuration file
-
-# Extension commands
-ai ext add <filename> # Add an extension tool
-ai ext del <filepath> # Remove an extension tool by file path
-ai ext del <index> # Remove an extension tool by index
-ai ext ls # List all extension tools
 
 # Skill commands
 ai skill ls # List all registered skills
@@ -162,11 +155,9 @@ ai skill enable <name|index> # Enable a skill by name or index, exp: ai skill en
 ai skill disable <name|index> # Disable a skill by name or index, exp: ai skill disable 1
 ai skill dir # Open the skill directory
 
-# History commands
-ai history clear # Clear the history messages for the current directory
-ai history output # Output the history messages to current directory
-ai history dir # Open the history directory
-ai history reset # Reset all history for all directories
+# Memory commands
+ai memery clear # Clear the history messages for the current directory
+ai memery dir # Open the memory directory
 ```
 
 ### Configuration File Structure
@@ -174,7 +165,7 @@ ai history reset # Reset all history for all directories
 The configuration file (`~/.deepfish-ai/config.js`) has the following structure:
 
 ```javascript
-module.exports = {
+export default {
   ai: [
     {
       name: "default", // AI configuration name
@@ -182,8 +173,9 @@ module.exports = {
       baseUrl: "https://api.deepseek.com", // API base URL
       model: "deepseek-reasoner", // AI model name
       apiKey: "", // API key (required for DeepSeek and OpenAI)
-      temperature: 1, // Response randomness (0-2)
-      maxTokens: 8192, // Maximum response length
+      temperature: 0.7, // Response randomness (0-2)
+      maxTokens: 8, // Maximum response length (KB)
+      maxContextLength: 64, // Maximum context length (KB)
       stream: true, // Enable/disable streaming output
     }
   ],
@@ -191,12 +183,11 @@ module.exports = {
   maxIterations: -1, // Maximum iterations for AI to complete the workflow, -1 for unlimited
   maxMessagesLength: 150000, // Maximum compression length, -1 for unlimited
   maxMessagesCount: 100, // Maximum compression count, -1 for unlimited
-  maxHistoryExpireTime: 30, // Maximum session expiration time in days, -1 for unlimited, 0 to disable recording
+  maxMemoryExpireTime: 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
+  encoding: "auto", // Command line encoding format, can be set to utf-8, gbk, etc., or auto/empty for auto-detection
 };
 ```
 
@@ -251,7 +242,6 @@ ai "Check disk usage for the current directory"
 
 ```bash
 ai "Create a weather.js extension tool for querying weather"
-ai ext add weather.js
 ```
 
 **Skill Management:**
@@ -289,6 +279,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
@@ -338,20 +331,13 @@ module.exports = {
 
 ### Registering Extensions
 
-**Method 1: Using Command Line**
-
-```bash
-ai ext add <filename> # ai ext add weather.js
-ai ext add . # Traverse the current directory, automatically scan and add extensions
-```
-
-**Method 2: Manual Configuration**
+**Method 1: Manual Configuration**
 
 1. ai config edit
 2. Add it to your configuration:
 
 ```javascript
-module.exports = {
+export default {
   // ... other configurations
   extensions: [
     '/path/to/weather-extension.js'
@@ -359,19 +345,19 @@ module.exports = {
 };
 ```
 
-**Method 3: Automatic Scanning**
+**Method 2: Automatic Scanning**
 
 Rules for automatic scanning of extension modules upon program startup:
 
 1. Scanning locations:
-   - node_modules in the npm root directory
-   - node_modules in the command execution directory
-   - the command execution directory itself
+  - the DeepFish installation directory (where `deepfish-ai` is located)
+  - `node_modules` under the current working directory
+  - the current working directory itself
 
 2. Scanned files:
-   - Extension packages under the @deepfish-ai directory
-   - Extension packages starting with "deepfish-"
-   - JavaScript extension files in the command execution directory, which are automatically loaded if they contain the strings 'module.exports', 'descriptions', and 'functions'
+  - scoped packages under `@deepfish-ai/*` in the locations above
+  - packages starting with `deepfish-` in the locations above (excluding `deepfish-ai` itself)
+  - top-level `.js` / `.mjs` files in the current working directory are scanned additionally; files containing `module.exports`, `descriptions`, and `functions` are treated as auto-loadable extensions
   
 ## 7. Recommendations
 
@@ -398,12 +384,12 @@ AI always uses paths relative to the current working directory.
 
 Conversation history is created on a per-directory basis — each execution directory corresponds to its own Agent context. This means that conversations started in different directories are independent of each other.
 
-Conversation history will be automatically cleared after a configurable period (controlled by the `maxHistoryExpireTime` field in the configuration file, default is 30 days). You can also manage it manually:
+> **⚠️ Important Note:** AI context is directory-based — each directory corresponds to one context. **Please do not open two command-line dialogs in the same directory**, as this may cause context conflicts and unexpected behavior.
+
+Conversation history will be automatically cleared after a configurable period (controlled by the `maxMemoryExpireTime` field in the configuration file, default is 30 days). You can also manage it manually:
 
-- `ai history dir` — Open the history directory to view stored conversation contexts
-- `ai history clear` — Manually clear the conversation history for the current directory
-- `ai history output` — Export the conversation history to the current directory
-- `ai history reset` — Reset all conversation history for all directories
+- `ai memery dir` — Open the memory directory to view stored conversation contexts
+- `ai memery clear` — Manually clear the conversation history for the current directory
 
 ## 9. Troubleshooting
 

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"
@@ -107,7 +107,7 @@ npm link
 
 ```bash
 ai config add # 输入名称, 然后选择deepseek，并输入你的deepseek api key
-ai use 你输入的名称
+ai config use 你输入的名称
 ai ”帮我在当前目录写一篇关于未来科技的文章，用markdown格式输出“
 ```
 
@@ -143,13 +143,6 @@ ai config view [name] # 查看指定AI配置的详细信息
 ai config edit # 编辑配置文件手动编辑配置文件
 ai config dir # 打开配置文件所在目录
 ai config reset # 重置配置
-ai config clear # 删除配置文件
-
-# 扩展命令
-ai ext add <filename> # 添加扩展工具
-ai ext del <filepath> # 通过文件路径移除扩展工具
-ai ext del <index> # 通过索引移除扩展工具
-ai ext ls # 列出所有扩展工具
 
 # Skill 命令
 ai skill ls # 列出所有已注册的 skill
@@ -160,11 +153,9 @@ ai skill enable <name|index> # 通过名称或索引启用 skill, exp: ai skill
 ai skill disable <name|index> # 通过名称或索引禁用 skill, exp: ai skill disable 1
 ai skill dir # 打开 skill 目录
 
-# 历史记录命令
-ai history clear # 清除当前目录的对话历史
-ai history output # 将历史消息输出到当前目录
-ai history dir # 打开历史记录目录
-ai history reset # 清除所有目录的对话历史
+# 记忆命令
+ai memery clear # 清除当前目录的对话历史
+ai memery dir # 打开记忆目录
 ```
 
 ### 配置文件结构
@@ -172,7 +163,7 @@ ai history reset # 清除所有目录的对话历史
 配置文件 (`~/.deepfish-ai/config.js`) 具有以下结构：
 
 ```javascript
-module.exports = {
+export default {
   ai: [
     {
       name: "default", // AI配置名称
@@ -180,8 +171,9 @@ module.exports = {
       baseUrl: "https://api.deepseek.com", // API基础URL
       model: "deepseek-reasoner", // AI模型名称
       apiKey: "", // API密钥（DeepSeek和OpenAI需要）
-      temperature: 1, // 响应随机性（0-2）
-      maxTokens: 8192, // 最大响应长度
+      temperature: 0.7, // 响应随机性（0-2）
+      maxTokens: 8, // 最大响应长度（KB）
+      maxContextLength: 64, // 最大上下文长度（KB）
       stream: true, // 启用/禁用流式输出
     }
   ],
@@ -189,12 +181,11 @@ module.exports = {
   maxIterations: -1, // ai完成工作流的最大迭代次数，-1表示无限制
   maxMessagesLength: 150000, // 最大压缩长度，-1表示无限制
   maxMessagesCount: 100, // 最大压缩数量，-1表示无限制
-  maxHistoryExpireTime: 30, // 整个会话的最大过期时间，单位天，-1表示无限制，0表示不记录
+  maxMemoryExpireTime: 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或空值自动判断
 };
 ```
 
@@ -249,7 +240,6 @@ ai "检查当前目录的磁盘使用情况"
 
 ```bash
 ai "创建一个用于查询天气的扩展工具weather.js"
-ai ext add weather.js
 ```
 
 **Skill 管理：**
@@ -287,6 +277,9 @@ ai "将model目录下的所有文件按月份分类到model2目录中，日期
 ```bash
 ai "创建一个任务列表，1.xxxx；2.xxxx；..."
 ai "执行任务列表" # 开始执行
+
+ai "我要实现一个用于长篇小说创作的扩展工具，支持大篇幅写作，保持上下文逻辑连贯，避免AI上下文爆炸问题。这个扩展工具实现起来可能有点复杂，你需要先仔细阅读扩展工具生成规则，然后创建一个任务列表"
+ai "执行任务列表" # 开始执行
 ```
 
 ## 6. 扩展开发
@@ -336,20 +329,13 @@ module.exports = {
 
 ### 注册扩展
 
-**方法1：使用命令行**
-
-```bash
-ai ext add <filename> # ai ext add weather.js
-ai ext add . # 遍历当前目录，自动扫描并添加扩展
-```
-
-**方法2：手动配置**
+**方法1：手动配置**
 
 1. ai config edit
 2. 将其添加到您的配置中：
 
 ```javascript
-module.exports = {
+export default {
   // ... 其他配置
   extensions: [
     '/path/to/weather-extension.js'
@@ -357,17 +343,17 @@ module.exports = {
 };
 ```
 
-**方法3：自动扫描**
+**方法2：自动扫描**
 
 程序启动时自动扫描扩展模块的规则:
 1. 扫描位置:
-    - npm根目录的node_modules
-    - 命令执行目录的node_modules
-    - 命令执行目录
+  - 程序安装目录（deepfish-ai 程序所在目录）
+  - 当前工作目录的 node_modules 目录
+  - 当前工作目录
 2. 扫描文件:
-    - @deepfish-ai目录下的扩展包
-    - deepfish-开头的扩展包
-    - 命令执行目录的js扩展文件，js文件内包含'module.exports'、'descriptions'和'functions'字符串则视为扩展文件自动加载
+  - 在以上目录中扫描 `@deepfish-ai/*` 作用域包
+  - 在以上目录中扫描 `deepfish-` 开头的包（排除 `deepfish-ai` 本体）
+  - 在当前工作目录额外扫描顶层 `.js` / `.mjs` 文件, 文件内容包含 `module.exports`、`descriptions`、`functions` 字符串时视为可自动加载扩展
 
 ## 7. 建议
 
@@ -392,14 +378,14 @@ AI始终使用相对于当前工作目录的相对路径。
 
 ### 对话历史
 
-对话历史是以程序执行目录为单位创建的，每个程序的执行目录会对应一个独立的 Agent 上下文。这意味着在不同目录下启动的对话是相互独立的。
+对话历史是以程序执行目录为单位创建的，每个程序的执行目录会对应一个独立的 Agent 上下文。这意味着在不同目录下启动的对话是相互独立的。
+
+> **⚠️ 重要提示：** AI上下文是以目录为单位的，一个目录对应一个上下文。**请不要在同一个目录下开启两个命令行对话框**，以免造成上下文冲突和意外行为。
 
-对话历史会在一定时间内自动清除（通过配置文件中的 `maxHistoryExpireTime` 字段控制，默认为 30 天）。您也可以手动管理对话历史：
+对话历史会在一定时间内自动清除（通过配置文件中的 `maxMemoryExpireTime` 字段控制，默认为 30 天）。您也可以手动管理对话历史：
 
-- `ai history dir` — 打开历史记录目录，查看已存储的对话上下文
-- `ai history clear` — 清除当前目录的对话历史
-- `ai history output` — 将对话历史导出到当前目录
-- `ai history reset` — 清除所有目录的对话历史
+- `ai memery dir` — 打开记忆目录，查看已存储的对话上下文
+- `ai memery clear` — 清除当前目录的对话历史
 
 ## 9. 故障排除
 

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "deepfish-ai",
-  "version": "1.0.17",
+  "version": "1.0.19",
   "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",
   "bin": {
     "ai": "src/cli/index.js"
   },
@@ -33,20 +34,35 @@
   },
   "homepage": "https://github.com/qq306863030/deepfish-ai#readme",
   "dependencies": {
+    "adm-zip": "^0.5.16",
     "axios": "^1.13.5",
+    "canvas": "^3.2.3",
     "chalk": "^4.1.0",
     "chardet": "^2.1.1",
     "cheerio": "^1.2.0",
     "commander": "^11.0.0",
     "dayjs": "^1.11.19",
+    "docx": "^9.6.1",
+    "docxtemplater": "^3.68.4",
+    "echarts": "^6.0.0",
+    "eventemitter-super": "^1.0.8",
     "extract-zip": "^2.0.1",
     "fs-extra": "^11.3.3",
     "iconv-lite": "^0.7.2",
     "inquirer": "^9.0.0",
     "js-yaml": "^4.1.1",
     "lodash": "^4.17.23",
+    "mammoth": "^1.12.0",
     "openai": "^6.18.0",
-    "uuid": "^13.0.0"
+    "pdf-lib": "^1.17.1",
+    "pdf-parse": "^2.4.5",
+    "pdf-to-img": "^6.0.0",
+    "pdfkit": "^0.18.0",
+    "pizzip": "^3.2.0",
+    "pptxgenjs": "^4.0.1",
+    "sharp": "^0.34.5",
+    "uuid": "^13.0.0",
+    "xlsx": "^0.18.5"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",

package/src/AgentRobot/AgentRobotFactory/MainAgentRobot.js

@@ -0,0 +1,105 @@
+const path = require('path')
+const os = require('os')
+const fs = require('fs-extra')
+const dayjs = require('dayjs')
+const Logger = require('../BaseAgentRobot/Logger.js')
+const BaseAgentRobot = require('../BaseAgentRobot/index.js')
+const AttachmentToolScanner = require('../BaseAgentRobot/utils/AttachmentToolScanner.js')
+
+class MainAgentRobot extends BaseAgentRobot {
+  // toolCollection = null // 工具集合，包含所有工具函数
+  constructor(opt) {
+    super(opt)
+    this.type = 'main'
+  }
+
+  // 初始化文件
+  _initFiles(opt) {
+    this.workspace = opt.workspace || process.cwd() // 工作空间，目录
+    this.basespace = opt.basespace || path.join(os.homedir(), '.deepfish-ai') // 记忆空间，目录
+    this.memorySpace = path.join(this.basespace, 'memory') // 记忆空间，目录
+    this.agentRecordFilePath = path.join(this.memorySpace, 'agentRecord.json')
+    fs.ensureDirSync(this.memorySpace)
+    // 查看agentRecord.json文件是否存在，不存在则创建
+    if (!fs.pathExistsSync(this.agentRecordFilePath)) {
+      fs.writeJsonSync(this.agentRecordFilePath, [], { spaces: 2 })
+    }
+    // 判断是否已经存在workspace
+    let agentRecord = fs.readJsonSync(this.agentRecordFilePath)
+    const record = agentRecord.find(
+      (record) => record.workspace === this.workspace,
+    )
+    if (record) {
+      this.id = record.agentId
+      this.name = record.name
+      this.updateTime = dayjs().format('YYYY-MM-DD HH:mm:ss')
+    } else {
+      agentRecord.push({
+        agentId: this.id,
+        name: this.name,
+        workspace: this.workspace,
+        createTime: dayjs().format('YYYY-MM-DD HH:mm:ss'),
+        updateTime: dayjs().format('YYYY-MM-DD HH:mm:ss'),
+      })
+    }
+    fs.writeJsonSync(this.agentRecordFilePath, agentRecord, { spaces: 2 })
+    this.agentSpace = path.join(this.memorySpace, this.id) // 机器人空间，目录
+    fs.ensureDirSync(this.agentSpace)
+    this.agentTreeFilePath = path.join(this.agentSpace, 'agentTree.json')
+    if (!fs.pathExistsSync(this.agentTreeFilePath)) {
+      fs.writeJsonSync(
+        this.agentTreeFilePath,
+        { agentId: this.id, children: [] },
+        { spaces: 2 },
+      )
+    } else {
+      const agentTree = fs.readJsonSync(this.agentTreeFilePath)
+      if (agentTree && agentTree.agentId === this.id) {
+        // 恢复子机器人
+        // this._parseAgentTree(this, agentTree)
+      } else {
+        agentTree.push({ agentId: this.id, children: [] })
+        fs.writeJsonSync(this.agentTreeFilePath, agentTree, { spaces: 2 })
+      }
+    }
+    this.agentTree = fs.readJsonSync(this.agentTreeFilePath)
+    this.memoryFilePath = path.join(this.agentSpace, 'memory.json')
+    this.logDirPath = path.join(this.agentSpace, 'logs')
+    fs.ensureDirSync(this.logDirPath)
+
+    // 自动清除过期的记忆和日志
+    const currentDate = dayjs()
+    agentRecord = agentRecord.filter((record) => {
+      if (
+        currentDate.diff(dayjs(record.updateTime), 'day') >
+        opt.maxMemoryExpireTime
+      ) {
+        // 删除机器人空间
+        fs.removeSync(path.join(this.memorySpace, record.agentId))
+        return false
+      }
+      return true
+    })
+    fs.writeJsonSync(this.agentRecordFilePath, agentRecord, { spaces: 2 })
+    this.logger = new Logger(this) // 初始化日志系统
+    this.logger.clearAllLogs()
+    this.toolCollection = AttachmentToolScanner.getToolCollection(
+      this.workspace,
+    ) // 加载工具集合
+    this.clawSkillCollection = AttachmentToolScanner.getClawSkillCollection(
+      this.basespace,
+    ) // 加载Claw技能集合
+  }
+
+  _getDefaultSystemPrompt(opt) {
+    const systemPrompt = super._getDefaultSystemPrompt(opt)
+    return `
+${systemPrompt}
+### 工具调用
+对于复杂的任务，先从可以使用的Skills中查找并使用合适的Skill，如果没有合适的Skill，再使用内置工具函数，使用时请严格按照工具函数的调用方式进行调用。
+${AttachmentToolScanner.getAttachToolPrompt(this.toolCollection, this.clawSkillCollection)}
+    `
+  }
+}
+
+module.exports = MainAgentRobot

package/src/AgentRobot/AgentRobotFactory/SubAgentRobot.js

@@ -0,0 +1,57 @@
+const path = require('path')
+const os = require('os')
+const fs = require('fs-extra')
+const BaseAgentRobot = require('../BaseAgentRobot/index.js')
+const Logger = require('../BaseAgentRobot/Logger.js')
+const AttachmentToolScanner = require('../BaseAgentRobot/utils/AttachmentToolScanner.js')
+
+class SubAgentRobot extends BaseAgentRobot {
+  // opt: { root, parent, ...MainAgentOpt }
+  constructor(opt) {
+    super(opt)
+    this.type = 'sub'
+    this.parent = opt.parent
+  }
+
+  _initFiles(opt) {
+    this.root = opt.root
+    this.parent = opt.parent
+    this.attachTools = opt.attachTools || []
+    this.workspace = opt.workspace || process.cwd() // 工作空间，目录
+    this.basespace = opt.basespace || path.join(os.homedir(), '.deepfish-ai') // 记忆空间，目录
+    this.memorySpace = path.join(this.basespace, 'memory') // 记忆空间，目录
+    this.agentRecordFilePath = path.join(this.memorySpace, 'agentRecord.json')
+    this.agentSpace = path.join(this.memorySpace, this.root.id) // 机器人空间，目录
+    this.agentTreeFilePath = path.join(this.agentSpace, 'agentTree.json')
+    this.memoryFilePath = path.join(this.agentSpace, `memory-${this.id}.json`)
+    this.logDirPath = path.join(this.agentSpace, 'logs')
+    this.logger = new Logger(this) // 初始化日志系统
+    const parentAgentTree = this.parent.agentTree
+    const rootAgentTree = this.root.agentTree
+    if (parentAgentTree && parentAgentTree.children) {
+      const currentNode = parentAgentTree.children.find((child) => child.agentId === this.id)
+      if (!currentNode) {
+        parentAgentTree.children.push({ agentId: this.id, children: [], type: 'sub' })
+        fs.writeJsonSync(this.agentTreeFilePath, rootAgentTree, { spaces: 2 })
+      }
+    }
+    this.toolCollection = AttachmentToolScanner.getToolCollection(
+      this.workspace,
+    ) // 加载工具集合
+    this.clawSkillCollection = AttachmentToolScanner.getClawSkillCollection(
+      this.basespace,
+    ) // 加载Claw技能集合
+  }
+
+  _getDefaultSystemPrompt(opt) {
+    const systemPrompt = super._getDefaultSystemPrompt(opt)
+    return `
+  ${systemPrompt}
+  ### 工具调用
+  对于复杂的任务，先从可以使用的Skills中查找并使用合适的Skill，如果没有合适的Skill，再使用内置工具函数，使用时请严格按照工具函数的调用方式进行调用。
+  ${AttachmentToolScanner.getAttachToolPrompt(this.toolCollection, this.clawSkillCollection)}
+      `
+  }
+}
+
+module.exports = SubAgentRobot

package/src/AgentRobot/AgentRobotFactory/SubSkillAgentRobot.js

@@ -0,0 +1,45 @@
+const path = require('path')
+const os = require('os')
+const fs = require('fs-extra')
+const BaseAgentRobot = require('../BaseAgentRobot/index.js')
+const Logger = require('../BaseAgentRobot/Logger.js')
+
+class SubSkillAgentRobot extends BaseAgentRobot {
+  // opt: { root, parent, ...MainAgentOpt }
+  constructor(opt) {
+    super(opt)
+    this.type = 'sub-skill'
+  }
+
+  _initFiles(opt) {
+    this.root = opt.root
+    this.parent = opt.parent
+    this.attachTools = opt.attachTools || []
+    this.workspace = opt.workspace || process.cwd() // 工作空间，目录
+    this.basespace = opt.basespace || path.join(os.homedir(), '.deepfish-ai') // 记忆空间，目录
+    this.memorySpace = path.join(this.basespace, 'memory') // 记忆空间，目录
+    this.agentRecordFilePath = path.join(this.memorySpace, 'agentRecord.json')
+    this.agentSpace = path.join(this.memorySpace, this.root.id) // 机器人空间，目录
+    this.agentTreeFilePath = path.join(this.agentSpace, 'agentTree.json')
+    this.memoryFilePath = path.join(this.agentSpace, `memory-${this.id}.json`)
+    this.logDirPath = path.join(this.agentSpace, 'logs')
+    this.logger = new Logger(this) // 初始化日志系统
+    const parentAgentTree = this.parent.agentTree
+    const rootAgentTree = this.root.agentTree
+    if (parentAgentTree && parentAgentTree.children) {
+      const currentNode = parentAgentTree.children.find(
+        (child) => child.agentId === this.id,
+      )
+      if (!currentNode) {
+        parentAgentTree.children.push({
+          agentId: this.id,
+          children: [],
+          type: 'sub-skill',
+        })
+        fs.writeJsonSync(this.agentTreeFilePath, rootAgentTree, { spaces: 2 })
+      }
+    }
+  }
+}
+
+module.exports = SubSkillAgentRobot

package/src/AgentRobot/AgentRobotFactory/index.js

@@ -0,0 +1,53 @@
+const { AttachmentToolScanner, AttachmentToolType } = require('../BaseAgentRobot/utils/AttachmentToolScanner.js')
+const MainAgentRobot = require('./MainAgentRobot.js')
+const SubAgentRobot = require('./SubAgentRobot.js')
+const SubSkillAgentRobot = require('./SubSkillAgentRobot.js')
+
+class AgentRobotFactory {
+  createMainAgent(opt) {
+    return new MainAgentRobot(opt)
+  }
+  // 创建子技能机器人
+  createSubSkillAgent(parent, id, attachTools = []) {
+    const baseSkill = []
+    const clawSkill = []
+    for (const tool of attachTools) {
+      if (tool.type === AttachmentToolType.BASE_SKILL) {
+        baseSkill.push(tool)
+      } else if (tool.type === AttachmentToolType.CLAW_SKILL) {
+        clawSkill.push(tool)
+      }
+    }
+    const subAgent = new SubSkillAgentRobot({
+      ...parent.opt,
+      id,
+      name: `SubSkillAgent-${attachTools[0].name}`,
+      parent: parent,
+      root: parent.root || parent,
+      attachTools: baseSkill,
+    })
+    if (clawSkill.length > 0) {
+      parent.systemPrompt =
+        parent.systemPrompt +
+        '\n' +
+        AttachmentToolScanner.getClawSkillPrompt(clawSkill)
+    }
+    parent.children.push(subAgent)
+    return subAgent
+  }
+
+  // 创建子机器人
+  createSubAgent(parent, id) {
+    const subAgent = new SubAgentRobot({
+      ...parent.opt,
+      id,
+      name: `SubAgent-${id}`,
+      parent: parent,
+      root: parent.root || parent,
+    })
+    parent.children.push(subAgent)
+    return subAgent
+  }
+}
+
+module.exports = AgentRobotFactory