deepfish-ai 1.0.24 → 1.0.26

package/README.md

@@ -43,6 +43,7 @@
   - [Initial Setup](#initial-setup)
   - [Configuration Commands](#configuration-commands)
   - [Configuration File Structure](#configuration-file-structure)
+  - [Directory Structure](#directory-structure)
 - [5. Usage](#5-usage)
   - [Interactive Mode](#interactive-mode)
   - [Direct Command Mode](#direct-command-mode)
@@ -125,7 +126,7 @@ ai config add
 
 This will prompt you to configure the following:
 
-- **AI Service Type**: Choose DeepSeek, Ollama, or OpenAI
+- **AI Service Type**: Choose DeepSeek, MiniMax, Qwen, Ollama, or OpenAI
 - **API Base URL**: Default URL provided for each service
 - **Model Name**: Choose the AI model to use
 - **API Key**: Required for DeepSeek and OpenAI
@@ -156,8 +157,8 @@ ai skill disable <name|index> # Disable a skill by name or index, exp: ai skill
 ai skill dir # Open the skill directory
 
 # Memory commands
-ai memery clear # Clear the history messages for the current directory
-ai memery dir # Open the memory directory
+ai memory clear # Clear the history messages for the current directory
+ai memory dir # Open the memory directory
 ```
 
 ### Configuration File Structure
@@ -181,16 +182,54 @@ export default {
   ],
   currentAi: "default", // Name of the currently active AI configuration
   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
   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
-  skills: [], // List of skill configurations
+  isThinkPrint: true, // Whether to print the thinking process
   encoding: "auto", // Command line encoding format, can be set to utf-8, gbk, etc., or auto/empty for auto-detection
+  EMBEDDING_API: "", // Embedding API endpoint URL
+  EMBEDDING_API_KEY: "", // Embedding API key
 };
 ```
 
+### Directory Structure
+
+DeepFish uses `.deepfish-ai` as the default working directory. You can open it directly with:
+
+```bash
+ai config dir
+```
+
+Default paths:
+
+- Windows: `C:/Users/<username>/.deepfish-ai`
+- macOS/Linux: `~/.deepfish-ai`
+
+Based on the structure in DevPlan, the directory layout is:
+
+```text
+.deepfish-ai/
+├─ config.js                           # Global configuration
+├─ user-info/
+│  └─ user.md                          # User profile data
+├─ clawSkills/
+│  ├─ clawSkills.json                  # OpenClaw skill index
+│  └─ <skill>/
+│     └─ SKILL.md                      # Single skill definition
+└─ memery/
+   ├─ agentRecord.json                 # Workspace to main-agent mapping
+   └─ <main-agent-id>/
+      ├─ memery.json                   # Main agent memory
+      ├─ memery-<sub-agent-id>.json    # Sub-agent memory
+      ├─ agentTree.json                # Agent hierarchy
+      ├─ bakup/
+      │  └─ <timestamp>/
+      │     ├─ record.json             # Backup operation record
+      │     └─ <uuid>.*                # Backup files
+      └─ logs/
+         └─ log-{YYYY-MM-DD HH}.txt    # Hourly rolling logs
+```
+
 ## 5. Usage
 
 ### Interactive Mode
@@ -388,8 +427,8 @@ Conversation history is created on a per-directory basis — each execution dire
 
 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 memery dir` — Open the memory directory to view stored conversation contexts
-- `ai memery clear` — Manually clear the conversation history for the current directory
+- `ai memory dir` — Open the memory directory to view stored conversation contexts
+- `ai memory clear` — Manually clear the conversation history for the current directory
 
 ## 9. Troubleshooting
 
@@ -404,7 +443,7 @@ ai config reset
 ### AI Service Connection
 
 - **Ollama**: Ensure Ollama is running locally on port 11434
-- **DeepSeek/OpenAI**: Verify your API key is correct and you have sufficient quota
+- **DeepSeek/MiniMax/Qwen/OpenAI**: Verify your API key is correct and you have sufficient quota
 
 ### Extension Not Loading
 

package/README_CN.md

@@ -44,6 +44,7 @@
   - [初始设置](#初始设置)
   - [配置命令](#配置命令)
   - [配置文件结构](#配置文件结构)
+  - [目录结构说明](#目录结构说明)
 - [5. 使用方法](#5-使用方法)
   - [交互模式](#交互模式)
   - [直接命令模式](#直接命令模式)
@@ -123,7 +124,7 @@ ai config add
 
 这将提示你配置以下内容：
 
-- **AI服务类型**：选择DeepSeek、Ollama或OpenAI
+- **AI服务类型**：选择DeepSeek、MiniMax、Qwen、Ollama或OpenAI
 - **API基础URL**：为每个服务提供默认URL
 - **模型名称**：选择要使用的AI模型
 - **API密钥**：DeepSeek和OpenAI需要
@@ -154,8 +155,8 @@ ai skill disable <name|index> # 通过名称或索引禁用 skill, exp: ai skill
 ai skill dir # 打开 skill 目录
 
 # 记忆命令
-ai memery clear # 清除当前目录的对话历史
-ai memery dir # 打开记忆目录
+ai memory clear # 清除当前目录的对话历史
+ai memory dir # 打开记忆目录
 ```
 
 ### 配置文件结构
@@ -179,16 +180,54 @@ export default {
   ],
   currentAi: "default", // 当前活动的AI配置名称
   maxIterations: -1, // ai完成工作流的最大迭代次数，-1表示无限制
-  maxMessagesLength: 150000, // 最大压缩长度，-1表示无限制
-  maxMessagesCount: 100, // 最大压缩数量，-1表示无限制
   maxMemoryExpireTime: 30, // 整个会话的最大过期时间，单位天，-1表示无限制，0表示不记录
   maxLogExpireTime: 3, // 日志过期时间，单位天，-1表示无限制，0表示不记录
   maxBlockFileSize: 20, // 最大分块文件大小，单位KB；超过该大小的文件需要分块处理
-  skills: [], // 技能配置列表
+  isThinkPrint: true, // 是否打印思考过程
   encoding: "auto", // 命令行编码格式，可设置为utf-8、gbk等，也可以设置成auto或空值自动判断
+  EMBEDDING_API: "", // 向量化接口地址
+  EMBEDDING_API_KEY: "", // 向量化接口密钥
 };
 ```
 
+### 目录结构说明
+
+DeepFish 默认工作目录为 `.deepfish-ai`，可通过以下命令直接打开：
+
+```bash
+ai config dir
+```
+
+默认路径：
+
+- Windows: `C:/Users/<用户名>/.deepfish-ai`
+- macOS/Linux: `~/.deepfish-ai`
+
+参考 DevPlan 的目录结构示例如下：
+
+```text
+.deepfish-ai/
+├─ config.js                           # 全局配置
+├─ user-info/
+│  └─ user.md                          # 用户信息
+├─ clawSkills/
+│  ├─ clawSkills.json                  # OpenClaw 技能索引
+│  └─ <skill>/
+│     └─ SKILL.md                      # 单个技能说明
+└─ memery/
+   ├─ agentRecord.json                 # 工作目录与主 agent 映射
+   └─ <主agent编号>/
+      ├─ memery.json                   # 主 agent 记忆
+      ├─ memery-<子agent编号>.json     # 子 agent 记忆
+      ├─ agentTree.json                # agent 组织结构
+      ├─ bakup/
+      │  └─ <时间戳>/
+      │     ├─ record.json             # 备份记录
+      │     └─ <uuid>.*                # 备份文件
+      └─ logs/
+         └─ log-{YYYY-MM-DD HH}.txt    # 按小时滚动日志
+```
+
 ## 5. 使用方法
 
 ### 交互模式
@@ -384,8 +423,8 @@ AI始终使用相对于当前工作目录的相对路径。
 
 对话历史会在一定时间内自动清除（通过配置文件中的 `maxMemoryExpireTime` 字段控制，默认为 30 天）。您也可以手动管理对话历史：
 
-- `ai memery dir` — 打开记忆目录，查看已存储的对话上下文
-- `ai memery clear` — 清除当前目录的对话历史
+- `ai memory dir` — 打开记忆目录，查看已存储的对话上下文
+- `ai memory clear` — 清除当前目录的对话历史
 
 ## 9. 故障排除
 
@@ -400,7 +439,7 @@ ai config reset
 ### AI服务连接
 
 - **Ollama**：确保Ollama在本地11434端口上运行
-- **DeepSeek/OpenAI**：验证您的API密钥是否正确，并且您有足够的额度
+- **DeepSeek/MiniMax/Qwen/OpenAI**：验证您的API密钥是否正确，并且您有足够的额度
 
 ### 扩展未加载
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepfish-ai",
-  "version": "1.0.24",
+  "version": "1.0.26",
   "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",
@@ -8,7 +8,8 @@
     "ai": "src/cli/index.js"
   },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "package-offline.bat"
   },
   "keywords": [
     "ai",

package/src/AgentRobot/BaseAgentRobot/Brain.js

@@ -76,6 +76,7 @@ class Brain extends EventEmitterSuper {
       try {
         // 更新系统提示词
         if (messages[0].role === 'system') {
+          this.agentRobot.updateSessionTime()
           messages[0] = {
             role: 'system',
             content: this.agentRobot.systemPrompt,

package/src/AgentRobot/BaseAgentRobot/index.js

@@ -5,6 +5,7 @@ const BrainEvent = require('./BrainEvent.js')
 const ScreenPrinter = require('./ScreenPrinter.js')
 const { HandEvent, Hand } = require('./Hand.js')
 const AIToolManager = require('./utils/AIToolManager.js')
+const dayjs = require('dayjs')
 
 class BaseAgentRobot {
   id = '' // Agentid
@@ -187,6 +188,7 @@ class BaseAgentRobot {
 当前工作目录：${workspace}
 操作系统类型：${osType}
 语言类型: 与用户输入语言一致
+会话开始时间: ${dayjs().format('YYYY-MM-DD HH')}
 
 ### 工具使用
 执行任务前，应仔细阅读工具描述以及可以使用的Skills的描述内容，优先使用匹配到的工具或技能，避免自己发挥。
@@ -207,7 +209,7 @@ class BaseAgentRobot {
 
 ### 用户信息
 #### 用户信息记录规则
-当对话中出现用户信息时，如个人基础信息（如姓名、年龄、职业、兴趣、性格特征）、操作习惯、代码习惯、阅读习惯、常用目录、文档收藏夹目录等，必须使用用户信息读写函数进行记录。
+当对话中出现用户信息时，如个人基础信息（如姓名、昵称、年龄、职业、兴趣、性格特征等）、AI的基础信息（如昵称、性格特征等）、操作习惯、代码习惯、阅读习惯、用户常用目录等，必须使用用户信息读写函数进行记录。
 
 #### 当前用户信息
 ----user info start----
@@ -216,6 +218,15 @@ ${this.toolManager.functions.readUserInfo()}
     `
   }
 
+  // 更新系统提示词中的会话开始时间
+  updateSessionTime() {
+    const newTime = dayjs().format('YYYY-MM-DD HH')
+    this.systemPrompt = this.systemPrompt.replace(
+      /会话开始时间: \d{4}-\d{2}-\d{2} \d{2}/,
+      `会话开始时间: ${newTime}`,
+    )
+  }
+
   async executeTask(goal) {
     const taskId = `task-${Date.now()}`
     this.logger.logExecTime(taskId, 'execute task goal')

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

@@ -876,7 +876,33 @@ async function patchDocxText(filePath, replacements) {
 
 // ─── 工具描述 ─────────────────────────────────────────────────────────────────
 
+
+// ─── 使用说明 ─────────────────────────────────────────────────────────────────
+
+function docxReadme() {
+  return `【DOCX 工具使用说明】
+1. 优先使用本工具内置函数完成任务（读取、创建、搜索、替换、模板填充、格式转换、合并等）。
+2. 如果内置函数无法满足需求（如复杂排版保真、特殊宏处理、跨格式高级转换），再尝试使用 LibreOffice 命令行。
+3. 在调用 LibreOffice 前，先检测系统是否已安装 LibreOffice：
+   - 已安装：直接使用 LibreOffice 命令行继续处理。
+   - 未安装：询问用户是否允许安装。
+4. 若用户同意安装：引导完成安装后继续执行原任务。
+5. 若用户拒绝安装：明确告知当前能力限制，并终止该操作。
+
+建议：
+- 常规文档处理优先使用内置函数，速度更快且依赖更少。
+- 仅在确实需要高保真格式转换或复杂排版时才启用 LibreOffice 路径。`
+}
+
 const descriptions = [
+  {
+    type: 'function',
+    function: {
+      name: 'docxReadme',
+      description: '获取 DOCX 工具集的使用说明, 调用函数前必须先查看本说明。',
+      parameters: {},
+    }
+  },
   {
     type: 'function',
     function: {
@@ -1224,6 +1250,7 @@ const descriptions = [
 // ─── 导出 ──────────────────────────────────────────────────────────────────────
 
 const functions = {
+  docxReadme,
   readDocxText,
   readDocxHtml,
   getDocxInfo,