deepfish-ai 1.0.29 → 2.0.3

package/README.md

@@ -1,5 +1,5 @@
 <div align="center" style="display:flex;align-items: center;justify-content: center;">
-  <img src="./images/title-img.png" alt="DeepFish" width="300" />
+  <img src="https://github.com/qq306863030/deepfish-ai/blob/master/images/title-img.png" alt="DeepFish" width="300" />
 </div>
 
 ---
@@ -24,80 +24,73 @@
   />
 </div>
 
-<img src="./images/banner.png" alt="banner" style="width:100%;text-align:center;" />
+<img src="https://github.com/qq306863030/deepfish-ai/blob/master/images/banner.png" alt="banner" style="width:100%;text-align:center;" />
 
+- [English](README_EN.md) | [中文](README.md)
 
+## 目录
 
-- [English](README.md) | [中文](README_CN.md)
+- [目录](#目录)
+- [1. 介绍](#1-介绍)
+- [2. 安装](#2-安装)
+  - [前置要求](#前置要求)
+  - [通过npm安装](#通过npm安装)
+  - [从源码安装](#从源码安装)
+- [3. 快速使用](#3-快速使用)
+- [4. 命令说明](#4-命令说明)
+  - [基础对话](#基础对话)
+  - [配置管理](#配置管理)
+  - [模型管理](#模型管理)
+  - [Skill 管理](#skill-管理)
+  - [工具管理](#工具管理)
+  - [会话管理](#会话管理)
+  - [任务管理](#任务管理)
+  - [MCP 管理](#mcp-管理)
+  - [服务管理](#服务管理)
+  - [缓存管理（AI自我学习的缓存）](#缓存管理ai自我学习的缓存)
+- [5. MCP 扩展配置](#5-mcp-扩展配置)
+  - [配置示例](#配置示例)
+- [6. Tool 与 Skill 扩展说明](#6-tool-与-skill-扩展说明)
+  - [当前目录扩展](#当前目录扩展)
+  - [全局扩展](#全局扩展)
+- [7. 系统配置文件说明](#7-系统配置文件说明)
+  - [配置文件字段](#配置文件字段)
+  - [AI 模型配置字段](#ai-模型配置字段)
+- [8. 贡献](#8-贡献)
+- [9. 许可证](#9-许可证)
+- [10. 支持](#10-支持)
 
-## Table of Contents
+## 1. 介绍
 
-- [Table of Contents](#table-of-contents)
-- [1. Introduction](#1-introduction)
-- [2. Installation](#2-installation)
-  - [Prerequisites](#prerequisites)
-  - [Installation via npm](#installation-via-npm)
-  - [Installation from Source](#installation-from-source)
-- [3. Quick Start](#3-quick-start)
-- [4. Configuration](#4-configuration)
-  - [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)
-  - [Usage Examples](#usage-examples)
-- [6. Extension Development](#6-extension-development)
-  - [Creating an Extension](#creating-an-extension)
-  - [Registering Extensions](#registering-extensions)
-- [7. Recommendations](#7-recommendations)
-  - [AI Service Selection](#ai-service-selection)
-- [8. Usage Notes](#8-usage-notes)
-  - [Using Relative Paths](#using-relative-paths)
-  - [Conversation History](#conversation-history)
-- [9. Troubleshooting](#9-troubleshooting)
-  - [Configuration Issues](#configuration-issues)
-  - [AI Service Connection](#ai-service-connection)
-  - [Extension Not Loading](#extension-not-loading)
-- [10. Contributing](#10-contributing)
-- [11. License](#11-license)
-- [12. Support](#12-support)
+一款高效便捷的AI驱动命令行工具，致力于打破自然语言与操作系统指令、文件操作指令之间的壁垒，让非专业开发者也能通过简单的自然语言描述，快速生成可直接执行的操作指令，大幅提升终端操作效率。
+核心特性：
 
+- 多模型兼容：无缝支持DeepSeek、Ollama，以及所有遵循OpenAI API规范的AI模型，可根据需求灵活切换，适配不同场景下的指令生成需求。
 
+- 自然语言转指令：精准解析自然语言需求，自动转换为对应的操作系统命令（如Linux、Windows、macOS终端指令）和文件操作指令（如创建、删除、修改文件/目录），无需手动编写复杂命令。
 
-## 1. Introduction
+- **Skill 扩展**：Skill 是 AI 的工作流知识包，通过 Markdown 文件定义特定领域的操作流程和最佳实践。安装 Skill 后，AI 能自动遵循其中的规范来执行任务，例如代码审查流程、文档生成模板等。支持兼容 OpenClaw 的 Skill 生态，可通过 `ai skills` 命令进行安装、启用与管理。
 
-An efficient and convenient AI-driven command-line tool designed to break down the barrier between natural language and operating system commands or file operation instructions. It enables non-professional developers to quickly generate directly executable operation instructions through simple natural language descriptions, significantly improving terminal operation efficiency.
-Core Features:
+- **Tool 扩展**：Tool 是 AI 可调用的自定义函数工具，通过 TypeScript 文件定义。你可以编写 Tool 来扩展 AI 的能力边界，例如调用第三方 API、操作数据库、处理特定文件格式等。支持通过 `ai tools generate` 命令让 AI 自动生成 Tool，降低开发门槛。
 
-- Multi-model Compatibility: Seamlessly supports DeepSeek, Ollama, and all AI models that comply with the OpenAI API specification. It can be flexibly switched according to needs to adapt to instruction generation requirements in different scenarios.
+- **MCP 扩展**：MCP（Model Context Protocol）是一种标准化的模型上下文协议，允许 AI 连接外部工具和数据源。通过配置 MCP Server，AI 可以获得浏览器自动化、数据库查询、文件系统访问等能力。DeepFish 内置 MCP 支持，只需简单配置即可接入各类 MCP 服务。
 
-- OpenClaw Skill Compatibility: Supports the OpenClaw Skill ecosystem. Skills can be installed, enabled, and managed through the existing Skill commands to quickly expand workflow capabilities.
+- 高度可扩展：支持通过扩展机制拓展功能边界，除基础的终端、文件操作外，可轻松实现翻译、小说创作、文件格式转换、数据处理等复杂任务，满足多样化使用需求。
 
-- Natural Language to Instructions: Precisely parses natural language requirements and automatically converts them into corresponding operating system commands (such as Linux, Windows, and macOS terminal commands) and file operation instructions (such as creating, deleting, and modifying files/directories), eliminating the need to manually write complex commands.
+## 2. 安装
 
-- Highly Extensible: Supports expanding functional boundaries through an extension mechanism. In addition to basic terminal and file operations, it can easily implement complex tasks such as translation, novel writing, file format conversion, and data processing to meet diverse usage needs.
+### 前置要求
 
-- AI Automatic Extension Generation: There is no need to manually develop complex extension tools. Custom extensions can be directly generated through AI, reducing the threshold for extension development and making function expansion more efficient and flexible.[Extensions-Example](https://github.com/qq306863030/deepfish-extensions)
+- Node.js（v22.14.0或更高版本）
+- npm或yarn
 
-Suitable for various groups such as developers, operation and maintenance personnel, and daily terminal users. Whether it is quickly executing terminal operations, batch processing files, or realizing personalized needs through extensions, this tool can simplify the operation process, improve work efficiency, and empower every terminal operation with AI.
-
-
-## 2. Installation
-
-### Prerequisites
-
-- Node.js (v22.14.0 or higher)
-- npm or yarn
-
-### Installation via npm
+### 通过npm安装
 
 ```bash
 npm install -g deepfish-ai
 ```
 
-### Installation from Source
+### 从源码安装
 
 ```bash
 git clone https://github.com/qq306863030/deepfish-ai.git
@@ -106,359 +99,217 @@ npm install
 npm link
 ```
 
-## 3. Quick Start
+## 3. 快速使用
 
 ```bash
-ai config add # Enter a name, then select deepseek, and enter your DeepSeek API key
-ai config use [the_name_you_entered]
-ai "Help me write an article about future technology in the current directory, output in markdown format"
+ai models add # 输入名称, 输入你的模型配置
+ai config use 你输入的名称
+ai ”帮我在当前目录写一篇关于未来科技的文章，用markdown格式输出“
 ```
 
-## 4. Configuration
+## 4. 命令说明
 
-### Initial Setup
-
-Run the configuration wizard to set up your AI service:
+### 基础对话
 
 ```bash
-ai config add
+ai "你的问题或指令"
 ```
 
-This will prompt you to configure the following:
-
-- **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
-- **Temperature**: Controls response randomness (0-2)
-- **Max Tokens**: Maximum response length
-- **Streaming Output**: Enable/disable streaming response
+直接输入自然语言，AI 将自动解析并执行对应操作。
 
-### Configuration Commands
-
-```bash
-# Configuration commands
-ai config add # Add a new AI configuration
-ai config ls # List all AI configurations
-ai config use <name> # Set the specified AI configuration as the current one
-ai config del <name> # Delete the specified AI configuration
-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
-
-# Skill commands
-ai skill ls # List all registered skills
-ai skill add <name> # Add a local skill directory or zip file from the current directory
-ai skill del <name|index> # Remove a skill by name or index, exp: ai skill del 1
-ai skill install <url> # Install a skill from ClawHub，exp: ai skill install https://clawhub.ai/TheSethRose/agent-browser
-ai skill enable <name|index> # Enable a skill by name or index, exp: ai skill enable 1
-ai skill disable <name|index> # Disable a skill by name or index, exp: ai skill disable 1
-ai skill dir # Open the skill directory
-
-# Memory commands
-ai memory clear # Clear the history messages for the current directory
-ai memory dir # Open the memory directory
-```
+### 配置管理
 
-### Configuration File Structure
-
-The configuration file (`~/.deepfish-ai/config.js`) has the following structure:
-
-```javascript
-export default {
-  ai: [
-    {
-      name: "default", // AI configuration name
-      type: "deepseek", // AI service type: "ollama", "deepseek", or "openai"
-      baseUrl: "https://api.deepseek.com", // API base URL
-      model: "deepseek-reasoner", // AI model name
-      apiKey: "", // API key (required for DeepSeek and OpenAI)
-      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
-    }
-  ],
-  currentAi: "default", // Name of the currently active AI configuration
-  maxIterations: -1, // Maximum iterations for AI to complete the workflow, -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
-  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
-};
-```
+| 命令              | 说明         |
+| ----------------- | ------------ |
+| `ai config edit`  | 编辑配置文件 |
+| `ai config view`  | 查看当前配置 |
+| `ai config reset` | 重置配置     |
+| `ai config dir`   | 查看配置目录 |
 
-### Directory Structure
+### 模型管理
 
-DeepFish uses `.deepfish-ai` as the default working directory. You can open it directly with:
+| 命令                   | 说明           |
+| ---------------------- | -------------- |
+| `ai models add`        | 添加新模型     |
+| `ai models ls`         | 列出所有模型   |
+| `ai models use <name>` | 切换使用的模型 |
+| `ai models del <name>` | 删除指定模型   |
 
-```bash
-ai config dir
-```
+### Skill 管理
 
-Default paths:
+| 命令                              | 说明               |
+| --------------------------------- | ------------------ |
+| `ai skills ls`                    | 列出所有 Skill     |
+| `ai skills add <name>`            | 添加 Skill         |
+| `ai skills del <index>`           | 删除指定 Skill     |
+| `ai skills enable <name\|index>`  | 启用 Skill         |
+| `ai skills disable <name\|index>` | 禁用 Skill         |
+| `ai skills dir`                   | 查看 Skill 目录    |
+| `ai skills generate xxx`          | 通过 AI 生成 Skill |
 
-- Windows: `C:/Users/<username>/.deepfish-ai`
-- macOS/Linux: `~/.deepfish-ai`
+### 工具管理
 
-Based on the structure in DevPlan, the directory layout is:
+| 命令                    | 说明                                               |
+| ----------------------- | -------------------------------------------------- |
+| `ai tools dir`          | 查看全局工具目录                                   |
+| `ai tools add <name>`   | 添加当前目录下的本地工具目录，可选择本地或全局生效 |
+| `ai tools generate xxx` | 通过 AI 生成工具                                   |
 
-```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
+| 命令               | 说明         |
+| ------------------ | ------------ |
+| `ai session clear` | 清除会话历史 |
+| `ai session dir`   | 查看会话目录 |
 
-### Interactive Mode
+### 任务管理
 
-Start an interactive session (multi-turn dialogue):
+| 命令                  | 说明         |
+| --------------------- | ------------ |
+| `ai task ls`          | 列出所有任务 |
+| `ai task add <task>`  | 添加任务     |
+| `ai task del <index>` | 删除指定任务 |
+| `ai task clear`       | 清除所有任务 |
 
-```bash
-ai
-```
+### MCP 管理
 
-Or explicitly specify:
+| 命令          | 说明          |
+| ------------- | ------------- |
+| `ai mcp edit` | 编辑 MCP 配置 |
 
-```bash
-ai -i or ai -interactive
-```
+### 服务管理
 
-### Direct Command Mode
+| 命令               | 说明     |
+| ------------------ | -------- |
+| `ai serve`         | 启动服务 |
+| `ai serve start`   | 启动服务 |
+| `ai serve stop`    | 停止服务 |
+| `ai serve restart` | 重启服务 |
 
-Execute a single command:
+### 缓存管理（AI自我学习的缓存）
 
-```bash
-ai "Create a file named hello.txt with the content 'Hello World'"
-```
+| 命令                        | 说明       |
+| --------------------------- | ---------- |
+| `ai cache ls`               | 列出缓存   |
+| `ai cache edit <index\|id>` | 编辑缓存项 |
+| `ai cache del <index\|id>`  | 删除缓存项 |
 
-### Usage Examples
+## 5. MCP 扩展配置
 
-**File Operations:**
+MCP（Model Context Protocol）允许 AI 连接外部工具和服务。通过 `ai mcp edit` 命令编辑 MCP 配置文件，添加你需要的 MCP Server。
 
-```bash
-ai "Create 10 text documents, each with 100 random characters"
-ai "Clear the current directory"
-```
+### 配置示例
 
-**Code Generation:**
+以下示例配置了 Chrome DevTools MCP Server，使 AI 能够操控浏览器进行自动化操作：
 
-```bash
-ai "Create a simple Express server with a /hello endpoint"
-ai "Create a browser-based airplane shooting game"
+```json
+{
+  "mcpServers": {
+    "chrome-devtools": {
+      "command": "npx",
+      "args": ["-y", "chrome-devtools-mcp@latest"]
+    }
+  }
+}
 ```
 
-**System Commands:**
+配置完成后，AI 将自动加载 MCP Server 提供的工具，你可以在对话中直接让 AI 使用这些能力。
 
-```bash
-ai "List all files in the current directory with their sizes"
-ai "Check disk usage for the current directory"
-```
+## 6. Tool 与 Skill 扩展说明
 
-**Extension Tool Generation:**
+DeepFish 支持通过 Tool 和 Skill 扩展 AI 的能力。扩展文件可以放在当前工作目录的 `.deepfish-ai` 目录中，也可以放在全局配置目录中。
 
-```bash
-ai "Create a weather.js extension tool for querying weather"
-```
+- **Tool 扩展**：用于定义 AI 可直接调用的自定义函数工具，适合封装 API 调用、数据库操作、文件处理等能力。
+- **Skill 扩展**：用于定义 AI 的工作流知识包，适合沉淀某类任务的执行步骤、规范和最佳实践。
 
-**Skill Management:**
+### 当前目录扩展
 
-```bash
-ai skill install https://clawhub.ai/TheSethRose/agent-browser
-ai skill install https://clawhub.ai/steipete/weather
-ai skill ls
-ai skill enable 1
-ai skill disable 0
-```
+如果扩展只希望在当前目录下生效，请将扩展拷贝到当前目录的 `.deepfish-ai` 目录中：
 
-**OpenClaw Skill Generation:**
-
-```bash
-ai "Create a weather query skill"
-ai skill add weather-query
-ai skill enable weather-query
+```text
+当前目录/
+└── .deepfish-ai/
+    ├── tools/
+    │   └── your-tool/
+    └── skills/
+        └── your-skill/
 ```
 
-**Media Processing:**
+- Tool 扩展放入 `当前目录/.deepfish-ai/tools/`。
+- Skill 扩展放入 `当前目录/.deepfish-ai/skills/`。
+- 这种方式只对当前目录有效，适合项目级扩展或仅在某个项目中使用的能力。
 
-```bash
-ai "I have ffmpeg5 installed on my system, help me convert all MP4 files in the directory to AVI format"
-```
+### 全局扩展
 
-**File Organization:**
+如果扩展希望在所有目录下生效，请将扩展拷贝到全局配置目录中的 `tools` 或 `skills` 目录。
 
-```bash
-ai "Classify all files under the 'model' directory into the 'model2' directory by month, date format YYYY-MM"
-```
-
-**Task List Execution:**
+可以通过以下命令打开全局配置目录：
 
 ```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
-
-Extensions allow you to add custom functions that AI can use in its workflows. For complex processes, you can develop them yourself or try generating extensions using this program, then register the extension with the program and use the command line to complete tasks.
-
-### Creating an Extension
-
-1. Extensions should export an object containing `descriptions` (an array of tool descriptions) and `functions` (an object of functions).
-2. Tip: You can generate extensions via AI, e.g., `ai "Create a weather.js extension tool for querying weather"`
-3. View [example extensions](https://github.com/qq306863030/deepfish-extensions).
-
-```javascript
-// Example extension: Weather Extension
-const axios = require('axios');
-
-const descriptions = [
-  {
-    type: 'function',
-    function: {
-      name: 'getWeather',
-      description: 'Get current weather information for a city',
-      parameters: {
-        type: 'object',
-        properties: {
-          city: { type: 'string' }
-        },
-        required: ['city']
-      }
-    }
-  }
-];
-
-const functions = {
-  async getWeather(city) {
-    // Implement weather API call
-    const response = await axios.get(`https://api.weatherapi.com/v1/current.json?key=YOUR_KEY&q=${city}`);
-    return `${city} weather: ${response.data.current.temp_c}°C, ${response.data.current.condition.text}`;
-  }
-};
-
-module.exports = {
-  descriptions,
-  functions
-};
+ai config dir
 ```
 
-### Registering Extensions
-
-**Method 1: Manual Configuration**
+目录结构示例：
 
-1. ai config edit
-2. Add it to your configuration:
-
-```javascript
-export default {
-  // ... other configurations
-  extensions: [
-    '/path/to/weather-extension.js'
-  ],
-};
+```text
+全局配置目录/
+└── .deepfish-ai/
+    ├── tools/
+    │   └── your-tool/
+    └── skills/
+        └── your-skill/
 ```
 
-**Method 2: Automatic Scanning**
+- Tool 扩展放入 `全局配置目录/.deepfish-ai/tools/`。
+- Skill 扩展放入 `全局配置目录/.deepfish-ai/skills/`。
+- 这种方式对全局有效，适合通用工具或长期复用的工作流能力。
 
-Rules for automatic scanning of extension modules upon program startup:
+## 7. 系统配置文件说明
 
-1. Scanning locations:
-  - the DeepFish installation directory (where `deepfish-ai` is located)
-  - `node_modules` under the current working directory
-  - the current working directory itself
-
-2. Scanned files:
-  - 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
-
-### AI Service Selection
-
-**Recommendation: Use online AI services (DeepSeek/OpenAI) for best results**
-
-While local AI services (like Ollama) offer privacy and offline capabilities, they may have the following limitations:
-
-- **Response Accuracy**: Local models may not be as rigorous and precise as online models
-- **Code Quality**: Generated code may require more manual review and correction
-- **Complex Task Handling**: May encounter difficulties with multi-step or complex operations
-- **Language Understanding**: Online services provide better language models
-
-For production environments or complex tasks, we recommend using DeepSeek, OpenAI services, or cloud services within Ollama for more reliable and accurate results.
-
-## 8. Usage Notes
-
-### Using Relative Paths
-
-AI always uses paths relative to the current working directory.
-
-### Conversation History
-
-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.
-
-> **⚠️ 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 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
-
-### Configuration Issues
-
-If you encounter configuration errors, try resetting:
+DeepFish 的系统配置文件位于用户目录下的 `.deepfish-ai/config.json5`，可通过以下命令打开或查看：
 
 ```bash
-ai config reset
+ai config edit
+ai config view
 ```
 
-### AI Service Connection
+### 配置文件字段
+
+| 字段                  | 类型      | 默认值   | 说明                                                                    |
+| --------------------- | --------- | -------- | ----------------------------------------------------------------------- |
+| `aiList`              | `array`   | `[]`     | AI 模型配置列表，可添加多个模型配置。                                   |
+| `currentModel`        | `string`  | `''`     | 当前正在使用的 AI 配置名称，对应 `aiList` 中某一项的 `name`。           |
+| `maxIterations`       | `number`  | `-1`     | AI 完成工作流的最大迭代次数，`-1` 表示不限制。                          |
+| `maxMemoryExpireTime` | `number`  | `30`     | 会话记忆最大保留时间，单位为天；`-1` 表示永久保留，`0` 表示不记录。     |
+| `maxLogExpireTime`    | `number`  | `3`      | 日志最大保留时间，单位为天；`-1` 表示永久保留，`0` 表示不记录。         |
+| `maxBlockFileSize`    | `number`  | `50`     | 最大分块文件大小，单位为 KB；超过该大小的文件会按块处理。               |
+| `encoding`            | `string`  | `'auto'` | 命令行输出编码，可设置为 `utf-8`、`gbk` 等；`auto` 或空值表示自动判断。 |
+| `maxSubAgentCount`    | `number`  | `2`      | 最大并行子 Agent 数量，`-1` 表示不限制。                                |
+| `isPrintThinking`     | `boolean` | `true`   | 是否打印 AI 思考过程中的中间信息。                                      |
+| `serve.port`          | `number`  | `8866`   | DeepFish 本地服务端口。                                                 |
 
-- **Ollama**: Ensure Ollama is running locally on port 11434
-- **DeepSeek/MiniMax/Qwen/OpenAI**: Verify your API key is correct and you have sufficient quota
+### AI 模型配置字段
 
-### Extension Not Loading
+`aiList` 中的每一项表示一个 AI 模型配置，常见字段如下：
 
-- Check the file path in the configuration
-- Ensure the file exports the correct object
-- Verify the file has no syntax errors
+| 字段               | 类型     | 说明                                                            |
+| ------------------ | -------- | --------------------------------------------------------------- |
+| `name`             | `string` | 模型配置名称，用于 `ai models use <name>` 切换模型。            |
+| `type`             | `string` | 模型供应商类型，例如 `DeepSeek`、`Ollama`、`OpenAICompatible`。 |
+| `baseUrl`          | `string` | 模型 API 地址。                                                 |
+| `model`            | `string` | 实际调用的模型名称。                                            |
+| `apiKey`           | `string` | 模型 API Key。                                                  |
+| `temperature`      | `number` | 生成随机性参数，数值越高输出越发散，数值越低输出越稳定。        |
+| `maxContextLength` | `number` | 模型最大上下文长度，单位为 tokens。                             |
 
-## 10. Contributing
+## 8. 贡献
 
-Contributions are welcome! Please feel free to submit a Pull Request.
+欢迎贡献！请随时提交Pull Request。
 
-## 11. License
+## 9. 许可证
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+本项目采用MIT许可证 - 详见[LICENSE](LICENSE)文件。
 
-## 12. Support
+## 10. 支持
 
-For issues and questions, please submit an issue on the GitHub repository.
+如有问题和疑问，请在GitHub仓库上提交issue。