@deepfish-ai/ffmpeg7-media-tools 1.0.0 → 1.0.2

package/README.md

@@ -1,299 +1,171 @@
 # @deepfish-ai/ffmpeg7-media-tools
 
-基于FFmpeg 7的音频视频处理工具函数集，包含23个媒体处理函数，支持视频格式转换、音频提取、视频编辑等常见媒体处理任务。
+English | [中文](https://github.com/qq306863030/deepfish-extensions/blob/master/deepfish-ffmpeg7-media-tools/README_CN.md)
 
-## ✨ 特性
+A comprehensive FFmpeg 7 based audio and video processing toolkit with 24 media processing functions, supporting video format conversion, audio extraction, video editing, and other common media processing tasks.
 
-- **全面覆盖**: 23个精心设计的FFmpeg函数，覆盖常见媒体处理需求
-- **易于使用**: 统一的参数格式，清晰的错误处理
-- **AI友好**: 包含完整的AI智能体描述信息
-- **跨平台**: 支持Windows、macOS和Linux系统
-- **TypeScript友好**: 完整的JSDoc注释和类型提示
+## ✨ Features
 
-## 📦 安装
+- **Comprehensive Coverage**: 24 carefully designed FFmpeg functions covering common media processing needs
+- **Easy to Use**: Unified parameter format, clear error handling
+- **AI Friendly**: Complete AI agent description information included
+- **Cross-Platform**: Supports Windows, macOS, and Linux systems
+- **TypeScript Friendly**: Complete JSDoc comments and type hints
 
-### 前提条件
+## 🚀 Quick Start
 
-需要先安装FFmpeg 7或更高版本：
+Follow these three steps to install and use this extension:
 
-#### Windows
-1. 下载FFmpeg 7：https://ffmpeg.org/download.html（选择包含版本7的构建）
-2. 解压并添加到系统PATH环境变量
-3. 验证安装：`ffmpeg -version`
+### Step 1: Install DeepFish AI
+First, install the global deepfish-ai library (if not already installed):
 
-#### macOS
 ```bash
-# 使用Homebrew安装FFmpeg 7
-brew install ffmpeg@7
-
-# 如果找不到ffmpeg@7，可以先更新Homebrew再尝试
-brew update
-brew install ffmpeg@7
+npm install deepfish-ai -g
 ```
 
-或者安装最新版本（可能包含FFmpeg 7）：
-```bash
-brew install ffmpeg
-```
+### Step 2: Install This Extension
+Install this package globally:
 
-#### Linux (Ubuntu/Debian)
-**方法一：使用官方静态构建（推荐）**
 ```bash
-# 下载最新FFmpeg 7静态构建
-wget https://johnvansickle.com/ffmpeg/releases/ffmpeg-release-amd64-static.tar.xz
-# 解压
-tar xf ffmpeg-release-amd64-static.tar.xz
-# 进入解压目录
-cd ffmpeg-*-amd64-static
-# 复制二进制文件到系统路径
-sudo cp ffmpeg ffprobe /usr/local/bin/
+npm install @deepfish-ai/ffmpeg7-media-tools -g
 ```
 
-**方法二：使用PPA安装（适用于Ubuntu 22.04+）**
-```bash
-# 添加PPA
-sudo add-apt-repository ppa:jonathonf/ffmpeg-7
-sudo apt update
-sudo apt install ffmpeg
-```
+### Step 3: Use in DeepFish AI
+Once installed, you can use the extension functions in DeepFish AI by simply asking the AI to perform media processing tasks. For example:
 
-**方法三：使用系统仓库（版本可能较旧）**
 ```bash
-sudo apt update
-sudo apt install ffmpeg
+ai convert video.mp4 to avi format
 ```
 
+or
 
-### 验证安装
-安装完成后，请验证FFmpeg版本是否为7.0或更高：
 ```bash
-ffmpeg -version | head -n 1
+ai extract audio from video.mp4
 ```
-应该输出类似：`ffmpeg version 7.0.1 Copyright (c) 2000-2024...`
 
-如果版本低于7.0，请参考上述安装方法重新安装FFmpeg 7。
+The AI will automatically use the appropriate FFmpeg functions from this extension.
 
-### 安装包
-```bash
-npm install @deepfish-ai/ffmpeg7-media-tools
-```
+### FFmpeg Installation
 
-## 🚀 快速开始
-
-```javascript
-const { functions } = require('@deepfish-ai/ffmpeg7-media-tools');
-
-// 1. 检查FFmpeg安装
-const checkResult = await functions.ffmpeg_checkFfmpegInstallation({
-  minVersion: '7.0.0'
-});
-
-// 2. 转换视频格式
-const convertResult = await functions.ffmpeg_convertVideoFormat({
-  inputPath: '/path/to/input.avi',
-  outputPath: '/path/to/output.mp4',
-  format: 'mp4',
-  quality: '-crf 23'
-});
-
-// 3. 从视频中提取音频
-const audioResult = await functions.ffmpeg_extractAudioFromVideo({
-  videoPath: '/path/to/video.mp4',
-  audioPath: '/path/to/audio.mp3',
-  audioFormat: 'mp3'
-});
-```
+This toolkit requires FFmpeg 7 or higher. Please install FFmpeg 7 before using:
 
-## 📋 API参考
-
-### 安装检测 (1个)
-
-| 函数名 | 描述 | 主要参数 |
-|--------|------|----------|
-| `ffmpeg_checkFfmpegInstallation` | 检测FFmpeg是否安装和版本检测 | `minVersion` |
-
-### 视频处理 (17个)
-
-| 函数名 | 描述 | 主要参数 |
-|--------|------|----------|
-| `ffmpeg_convertVideoFormat` | 转换视频格式 | `inputPath`, `outputPath`, `format`, `quality` |
-| `ffmpeg_resizeVideo` | 调整视频尺寸 | `inputPath`, `outputPath`, `width`, `height`, `keepAspectRatio` |
-| `ffmpeg_trimVideo` | 剪切视频片段 | `inputPath`, `outputPath`, `startTime`, `duration` |
-| `ffmpeg_mergeVideos` | 合并多个视频文件 | `videoPaths`, `outputPath`, `method` |
-| `ffmpeg_adjustBitrate` | 调整视频比特率 | `inputPath`, `outputPath`, `bitrate`, `audioBitrate` |
-| `ffmpeg_addWatermark` | 添加水印 | `inputPath`, `outputPath`, `watermarkPath`, `position`, `opacity` |
-| `ffmpeg_mergeVideoAudio` | 合并视频和音频 | `videoPath`, `audioPath`, `outputPath`, `sync` |
-| `ffmpeg_videoToGif` | 将视频转换为GIF动图 | `videoPath`, `outputPath`, `startTime`, `duration`, `fps`, `width` |
-| `ffmpeg_cropVideo` | 裁剪视频区域 | `videoPath`, `outputPath`, `x`, `y`, `width`, `height` |
-| `ffmpeg_rotateVideo` | 旋转视频 | `videoPath`, `outputPath`, `angle` |
-| `ffmpeg_changeVideoSpeed` | 改变视频播放速度 | `videoPath`, `outputPath`, `speed` |
-| `ffmpeg_addSubtitles` | 添加字幕到视频 | `videoPath`, `subtitlePath`, `outputPath`, `encoding` |
-| `ffmpeg_addTextOverlay` | 添加文本叠加到视频 | `videoPath`, `outputPath`, `text`, `x`, `y`, `fontSize`, `fontColor`, `startTime`, `duration` |
-| `ffmpeg_extractVideoFrames` | 提取视频帧为图片序列 | `videoPath`, `outputDir`, `fps`, `format`, `startTime`, `duration` |
-| `ffmpeg_extractVideoThumbnail` | 提取视频缩略图 | `videoPath`, `outputPath`, `time`, `size` |
-| `ffmpeg_compressVideo` | 压缩视频（调整CRF） | `videoPath`, `outputPath`, `crf`, `preset` |
-| `ffmpeg_concatVideos` | 拼接多个视频文件 | `videoPaths`, `outputPath`, `transition` |
-
-### 音频处理 (5个)
-
-| 函数名 | 描述 | 主要参数 |
-|--------|------|----------|
-| `ffmpeg_extractAudioFromVideo` | 从视频中提取音频 | `videoPath`, `audioPath`, `audioFormat` |
-| `ffmpeg_convertAudioFormat` | 转换音频格式 | `inputPath`, `outputPath`, `format`, `bitrate` |
-| `ffmpeg_adjustAudioVolume` | 调整音频音量 | `inputPath`, `outputPath`, `volume` |
-| `ffmpeg_mixAudios` | 混合多个音频文件 | `audioPaths`, `outputPath`, `volumes` |
-
-### 媒体信息 (1个)
-
-| 函数名 | 描述 | 主要参数 |
-|--------|------|----------|
-| `ffmpeg_getMediaInfo` | 获取媒体文件信息 | `mediaPath` |
-
-## 🔧 详细使用示例
-
-### 视频格式转换
-```javascript
-const result = await functions.ffmpeg_convertVideoFormat({
-  inputPath: 'input.avi',
-  outputPath: 'output.mp4',
-  format: 'mp4',
-  quality: '-crf 23'
-});
-```
+- **Windows**: Download FFmpeg 7 from https://ffmpeg.org/download.html and add to system PATH
+- **macOS**: `brew install ffmpeg@7` or `brew install ffmpeg`
+- **Linux**: Use static builds or distribution packages
 
-### 调整视频尺寸
-```javascript
-const result = await functions.ffmpeg_resizeVideo({
-  inputPath: 'input.mp4',
-  outputPath: 'output_720p.mp4',
-  width: 1280,
-  height: 720,
-  keepAspectRatio: true
-});
-```
+Verify installation: `ffmpeg -version` should show version 7.0 or higher.
 
-### 视频裁剪
-```javascript
-const result = await functions.ffmpeg_cropVideo({
-  videoPath: 'input.mp4',
-  outputPath: 'output_cropped.mp4',
-  x: 100,
-  y: 100,
-  width: 800,
-  height: 600
-});
-```
+## 📋 Function List
 
-### 添加水印
-```javascript
-const result = await functions.ffmpeg_addWatermark({
-  inputPath: 'video.mp4',
-  outputPath: 'video_with_logo.mp4',
-  watermarkPath: 'logo.png',
-  position: 'top-right',
-  opacity: 0.7
-});
-```
+The toolkit provides 24 functions divided into the following categories:
 
-### 从视频中提取音频
-```javascript
-const result = await functions.ffmpeg_extractAudioFromVideo({
-  videoPath: 'video.mp4',
-  audioPath: 'audio.mp3',
-  audioFormat: 'mp3'
-});
-```
+### Installation Detection (1 function)
 
-### 批量处理示例
-```javascript
-// 批量压缩视频
-const videos = ['video1.mp4', 'video2.mp4', 'video3.mp4'];
-
-for (const video of videos) {
-  await functions.ffmpeg_compressVideo({
-    videoPath: video,
-    outputPath: `compressed_${video}`,
-    crf: 28, // 更高的CRF值表示更强的压缩
-    preset: 'slow'
-  });
-}
-```
+| Function Name | Description |
+|---------------|-------------|
+| `ffmpeg_checkFfmpegInstallation` | Check FFmpeg installation and version detection |
+
+### Video Processing (18 functions)
+
+| Function Name | Description |
+|---------------|-------------|
+| `ffmpeg_convertVideoFormat` | Convert video format |
+| `ffmpeg_resizeVideo` | Resize video dimensions |
+| `ffmpeg_trimVideo` | Trim video segment |
+| `ffmpeg_mergeVideos` | Merge multiple video files |
+| `ffmpeg_adjustBitrate` | Adjust video bitrate |
+| `ffmpeg_addWatermark` | Add watermark to video |
+| `ffmpeg_mergeVideoAudio` | Merge video and audio |
+| `ffmpeg_videoToGif` | Convert video to animated GIF |
+| `ffmpeg_cropVideo` | Crop video region |
+| `ffmpeg_rotateVideo` | Rotate video |
+| `ffmpeg_changeVideoSpeed` | Change video playback speed |
+| `ffmpeg_addSubtitles` | Add subtitles to video |
+| `ffmpeg_addTextOverlay` | Add text overlay to video |
+| `ffmpeg_adjustVideoVolume` | Adjust video volume |
+| `ffmpeg_extractVideoFrames` | Extract video frames as image sequence |
+| `ffmpeg_extractVideoThumbnail` | Extract video thumbnail |
+| `ffmpeg_compressVideo` | Compress video (adjust CRF) |
+| `ffmpeg_concatVideos` | Concatenate multiple video files |
+
+### Audio Processing (5 functions)
+
+| Function Name | Description |
+|---------------|-------------|
+| `ffmpeg_extractAudioFromVideo` | Extract audio from video |
+| `ffmpeg_convertAudioFormat` | Convert audio format |
+| `ffmpeg_adjustAudioVolume` | Adjust audio volume |
+| `ffmpeg_mixAudios` | Mix multiple audio files |
 
-## 🏗️ 项目结构
+### Media Information (1 function)
+
+| Function Name | Description |
+|---------------|-------------|
+| `ffmpeg_getMediaInfo` | Get media file information |
+
+## 🏗️ Project Structure
 
 ```
 ffmpeg7-media-tools/
-├── ffmpeg-functions.js     # 23个FFmpeg功能函数实现
-├── ffmpeg-descriptions.js  # AI智能体描述信息
-├── index.js                # 主入口文件，重新导出功能
-├── package.json            # 项目配置
-└── README.md               # 本文档
+├── ffmpeg-functions.js     # 24 FFmpeg function implementations
+├── ffmpeg-descriptions.js  # AI agent description information
+├── index.js                # Main entry file, re-exports functions
+├── package.json            # Project configuration
+├── README.md               # English documentation (this file)
+└── README_CN.md           # Chinese documentation
 ```
 
-### 文件说明
-
-- **ffmpeg-functions.js**: 包含所有23个FFmpeg媒体处理函数的实现，每个函数都有完整的错误处理和参数验证
-- **ffmpeg-descriptions.js**: 为AI智能体提供的函数描述信息，包含详细的参数说明和功能描述
-- **index.js**: 统一导出接口，便于模块化使用
+## ⚠️ Notes
 
-## ⚠️ 注意事项
+1. **FFmpeg Version**: This toolkit is designed for FFmpeg 7, recommended to use FFmpeg 7.0 or higher
+2. **File Paths**: Use absolute paths for all file operations
+3. **Error Handling**: All functions include error handling with detailed error messages
+4. **Resource Consumption**: Video processing is CPU-intensive, monitor system resources when processing large files
+5. **Output Directory**: Ensure output directories exist before processing
 
-1. **FFmpeg版本**: 本工具集基于FFmpeg 7设计，建议使用FFmpeg 7.0或更高版本
-2. **文件路径**: 所有文件路径建议使用绝对路径，相对路径可能因工作目录不同而产生问题
-3. **错误处理**: 所有函数都包含错误处理，执行失败时会抛出详细的错误信息
-4. **资源消耗**: 视频处理是CPU密集型任务，大文件处理时请注意系统资源
-5. **输出目录**: 请确保输出目录存在，否则某些函数可能无法正常创建输出文件
+## 🔍 Troubleshooting
 
-## 🔍 故障排除
-
-### FFmpeg未找到
+### FFmpeg Not Found
 ```
 Error: FFmpeg is not installed or not in system PATH
 ```
-**解决方案**: 
-- 确认FFmpeg已正确安装
-- 将FFmpeg添加到系统PATH环境变量
-- 重启终端或IDE使环境变量生效
+**Solution**: 
+- Confirm FFmpeg is correctly installed
+- Add FFmpeg to system PATH environment variable
+- Restart terminal or IDE for environment variables to take effect
 
-### 文件不存在
+### File Does Not Exist
 ```
 Error: Input file does not exist: /path/to/file.mp4
 ```
-**解决方案**:
-- 确认文件路径正确
-- 使用绝对路径而非相对路径
-- 检查文件权限
+**Solution**:
+- Confirm file path is correct
+- Use absolute paths instead of relative paths
+- Check file permissions
 
-### 格式不支持
-```
-Error: Unsupported video format: .xyz
-```
-**解决方案**:
-- 检查输入文件格式是否被FFmpeg支持
-- 尝试使用`ffmpeg_convertVideoFormat`先转换格式
+## 🤝 Contributing
 
-## 🤝 贡献
+Welcome to submit Issues and Pull Requests to improve this project. Before submitting a PR, please ensure:
 
-欢迎提交Issue和Pull Request来改进这个项目。在提交PR前，请确保：
+1. Code style is consistent
+2. Add appropriate tests
+3. Update documentation (including API docs and examples)
+4. Function parameter formats are unified
 
-1. 代码风格一致
-2. 添加相应的测试
-3. 更新文档（包括API文档和示例）
-4. 函数参数格式统一
+## 📄 License
 
-## 📄 许可证
+MIT License - See LICENSE file
 
-MIT License - 详见LICENSE文件
+## 📞 Support
 
-## 📞 支持
+For questions or suggestions, please:
 
-如有问题或建议，请：
-1. 查看本文档的故障排除部分
-2. 提交GitHub Issue
-3. 联系维护团队
+1. Check the Troubleshooting section in this documentation
+2. Submit a GitHub Issue
+3. Contact the maintenance team
 
 ---
 
-**最后更新**: 2026年  
-**版本**: 1.0.0  
-**FFmpeg版本**: 7.0+
+**Last Updated**: 2026  
+**Version**: 1.0.0  
+**FFmpeg Version**: 7.0+

package/README_CN.md

@@ -0,0 +1,171 @@
+# @deepfish-ai/ffmpeg7-media-tools
+
+[English](https://github.com/qq306863030/deepfish-extensions/blob/master/deepfish-ffmpeg7-media-tools/README.md) | 中文
+
+基于FFmpeg 7的音频视频处理工具函数集，包含24个媒体处理函数，支持视频格式转换、音频提取、视频编辑等常见媒体处理任务。
+
+## ✨ 特性
+
+- **全面覆盖**: 24个精心设计的FFmpeg函数，覆盖常见媒体处理需求
+- **易于使用**: 统一的参数格式，清晰的错误处理
+- **AI友好**: 包含完整的AI智能体描述信息
+- **跨平台**: 支持Windows、macOS和Linux系统
+- **TypeScript友好**: 完整的JSDoc注释和类型提示
+
+## 🚀 快速开始
+
+按照以下三个步骤安装和使用此扩展：
+
+### 步骤1: 安装DeepFish AI
+首先，安装全局deepfish-ai库（如果尚未安装）：
+
+```bash
+npm install deepfish-ai -g
+```
+
+### 步骤2: 安装此扩展
+全局安装本包：
+
+```bash
+npm install @deepfish-ai/ffmpeg7-media-tools -g
+```
+
+### 步骤3: 在DeepFish AI中使用
+安装完成后，您可以在DeepFish AI中通过简单的命令使用扩展功能。例如：
+
+```bash
+ai 将video.mp4转换为avi格式
+```
+
+或
+
+```bash
+ai 从video.mp4中提取音频
+```
+
+AI会自动使用此扩展中的相应FFmpeg函数。
+
+### FFmpeg安装
+
+本工具集需要FFmpeg 7或更高版本。使用前请先安装FFmpeg 7：
+
+- **Windows**: 从 https://ffmpeg.org/download.html 下载FFmpeg 7并添加到系统PATH
+- **macOS**: `brew install ffmpeg@7` 或 `brew install ffmpeg`
+- **Linux**: 使用静态构建或发行版软件包
+
+验证安装：`ffmpeg -version` 应显示版本7.0或更高。
+
+## 📋 函数列表
+
+工具集提供24个函数，分为以下类别：
+
+### 安装检测 (1个函数)
+
+| 函数名 | 描述 |
+|--------|------|
+| `ffmpeg_checkFfmpegInstallation` | 检测FFmpeg是否安装和版本检测 |
+
+### 视频处理 (18个函数)
+
+| 函数名 | 描述 |
+|--------|------|
+| `ffmpeg_convertVideoFormat` | 转换视频格式 |
+| `ffmpeg_resizeVideo` | 调整视频尺寸 |
+| `ffmpeg_trimVideo` | 剪切视频片段 |
+| `ffmpeg_mergeVideos` | 合并多个视频文件 |
+| `ffmpeg_adjustBitrate` | 调整视频比特率 |
+| `ffmpeg_addWatermark` | 添加水印 |
+| `ffmpeg_mergeVideoAudio` | 合并视频和音频 |
+| `ffmpeg_videoToGif` | 将视频转换为GIF动图 |
+| `ffmpeg_cropVideo` | 裁剪视频区域 |
+| `ffmpeg_rotateVideo` | 旋转视频 |
+| `ffmpeg_changeVideoSpeed` | 改变视频播放速度 |
+| `ffmpeg_addSubtitles` | 添加字幕到视频 |
+| `ffmpeg_addTextOverlay` | 添加文本叠加到视频 |
+| `ffmpeg_adjustVideoVolume` | 调整视频音量 |
+| `ffmpeg_extractVideoFrames` | 提取视频帧为图片序列 |
+| `ffmpeg_extractVideoThumbnail` | 提取视频缩略图 |
+| `ffmpeg_compressVideo` | 压缩视频（调整CRF） |
+| `ffmpeg_concatVideos` | 拼接多个视频文件 |
+
+### 音频处理 (5个函数)
+
+| 函数名 | 描述 |
+|--------|------|
+| `ffmpeg_extractAudioFromVideo` | 从视频中提取音频 |
+| `ffmpeg_convertAudioFormat` | 转换音频格式 |
+| `ffmpeg_adjustAudioVolume` | 调整音频音量 |
+| `ffmpeg_mixAudios` | 混合多个音频文件 |
+
+### 媒体信息 (1个函数)
+
+| 函数名 | 描述 |
+|--------|------|
+| `ffmpeg_getMediaInfo` | 获取媒体文件信息 |
+
+## 🏗️ 项目结构
+
+```
+ffmpeg7-media-tools/
+├── ffmpeg-functions.js     # 24个FFmpeg功能函数实现
+├── ffmpeg-descriptions.js  # AI智能体描述信息
+├── index.js                # 主入口文件，重新导出功能
+├── package.json            # 项目配置
+├── README.md               # 英文文档
+└── README_CN.md           # 中文文档（本文档）
+```
+
+## ⚠️ 注意事项
+
+1. **FFmpeg版本**: 本工具集基于FFmpeg 7设计，建议使用FFmpeg 7.0或更高版本
+2. **文件路径**: 所有文件路径建议使用绝对路径，相对路径可能因工作目录不同而产生问题
+3. **错误处理**: 所有函数都包含错误处理，执行失败时会抛出详细的错误信息
+4. **资源消耗**: 视频处理是CPU密集型任务，大文件处理时请注意系统资源
+5. **输出目录**: 请确保输出目录存在，否则某些函数可能无法正常创建输出文件
+
+## 🔍 故障排除
+
+### FFmpeg未找到
+```
+Error: FFmpeg is not installed or not in system PATH
+```
+**解决方案**: 
+- 确认FFmpeg已正确安装
+- 将FFmpeg添加到系统PATH环境变量
+- 重启终端或IDE使环境变量生效
+
+### 文件不存在
+```
+Error: Input file does not exist: /path/to/file.mp4
+```
+**解决方案**:
+- 确认文件路径正确
+- 使用绝对路径而非相对路径
+- 检查文件权限
+
+## 🤝 贡献
+
+欢迎提交Issue和Pull Request来改进这个项目。在提交PR前，请确保：
+
+1. 代码风格一致
+2. 添加相应的测试
+3. 更新文档（包括API文档和示例）
+4. 函数参数格式统一
+
+## 📄 许可证
+
+MIT License - 详见LICENSE文件
+
+## 📞 支持
+
+如有问题或建议，请：
+
+1. 查看本文档的故障排除部分
+2. 提交GitHub Issue
+3. 联系维护团队
+
+---
+
+**最后更新**: 2026  
+**版本**: 1.0.0  
+**FFmpeg版本**: 7.0+

package/ffmpeg-descriptions.js

@@ -672,6 +672,30 @@ descriptions.push({
     ]
   }
 });
+
+descriptions.push({
+  name: 'ffmpeg_adjustVideoVolume',
+  description: 'FFmpeg工具:调整视频音量',
+  parameters: {
+    type: 'object',
+    properties: {
+      videoPath: {
+        type: 'string',
+        description: '输入视频文件路径',
+      },
+      outputPath: {
+        type: 'string',
+        description: '输出视频文件路径',
+      },
+      volume: {
+        type: 'number',
+        description: '音量倍数（如0.5为一半音量，2.0为两倍音量）',
+      },
+    },
+    required: ['videoPath', 'outputPath', 'volume'],
+  },
+});
+
 
 
 

package/ffmpeg-functions.js

@@ -22,7 +22,7 @@ const checkFfmpeg = async () => {
       command = 'which ffmpeg';
     }
     
-    await this.Tools.executeCommand(command);
+    await this.aiCl.Tools.executeCommand(command);
     return { installed: true, error: null };
   } catch (error) {
     return { 
@@ -38,7 +38,7 @@ const checkFfmpeg = async () => {
  */
 const getFfmpegVersion = async () => {
   try {
-    const result = await this.Tools.executeCommand('ffmpeg -version');
+    const result = await this.aiCl.Tools.executeCommand('ffmpeg -version');
     // 从输出中提取版本号
     const versionMatch = result.match(/ffmpeg version (\S+)/);
     const version = versionMatch ? versionMatch[1] : '未知版本';
@@ -132,7 +132,7 @@ functions.ffmpeg_convertVideoFormat = async (params) => {
     finalOutputPath = finalOutputPath.replace(/\.[^/.]+$/, "") + `.${format}`;
   }
   const command = `ffmpeg -i "${inputPath}" ${quality} "${finalOutputPath}"`;
-  await this.Tools.executeCommand(command);
+  await this.aiCl.Tools.executeCommand(command);
   return {
     success: true,
     message: `视频格式转换完成: ${finalOutputPath}`,
@@ -159,7 +159,7 @@ functions.ffmpeg_extractAudioFromVideo = async (params) => {
     finalAudioPath = finalAudioPath.replace(/\.[^/.]+$/, "") + `.${audioFormat}`;
   }
   const command = `ffmpeg -i "${videoPath}" -q:a 0 -map a "${finalAudioPath}"`;
-  await this.Tools.executeCommand(command);
+  await this.aiCl.Tools.executeCommand(command);
   return {
     success: true,
     message: `音频提取完成: ${finalAudioPath}`,
@@ -187,7 +187,7 @@ functions.ffmpeg_resizeVideo = async (params) => {
     scaleFilter = `scale=${width}:${height}`;
   }
   const command = `ffmpeg -i "${inputPath}" -vf "${scaleFilter}" -c:a copy "${outputPath}"`;
-  await this.Tools.executeCommand(command);
+  await this.aiCl.Tools.executeCommand(command);
   return {
     success: true,
     message: `视频尺寸调整完成: ${width}x${height}`,
@@ -209,7 +209,7 @@ functions.ffmpeg_trimVideo = async (params) => {
     throw new Error(`FFmpeg检查失败: ${checkResult.message}`);
   }
   const command = `ffmpeg -i "${inputPath}" -ss ${startTime} -t ${duration} -c copy "${outputPath}"`;
-  await this.Tools.executeCommand(command);
+  await this.aiCl.Tools.executeCommand(command);
   return {
     success: true,
     message: `视频剪切完成: 从 ${startTime} 开始，持续 ${duration}`,
@@ -237,16 +237,16 @@ functions.ffmpeg_mergeVideos = async (params) => {
     videoPaths.forEach(path => {
       listContent += `file '${path}'\n`;
     });
-    await this.Tools.createFile(listFilePath, listContent);
+    await this.aiCl.Tools.createFile(listFilePath, listContent);
     const command = `ffmpeg -f concat -safe 0 -i "${listFilePath}" -c copy "${outputPath}"`;
-    await this.Tools.executeCommand(command);
+    await this.aiCl.Tools.executeCommand(command);
     // 删除临时文件
-    await this.Tools.deleteFile(listFilePath);
+    await this.aiCl.Tools.deleteFile(listFilePath);
   } else if (method === 'overlay') {
     // 简单叠加示例（实际应用中可能需要更复杂的处理）
     if (videoPaths.length === 2) {
       const command = `ffmpeg -i "${videoPaths[0]}" -i "${videoPaths[1]}" -filter_complex "[0:v][1:v]overlay=10:10" "${outputPath}"`;
-      await this.Tools.executeCommand(command);
+      await this.aiCl.Tools.executeCommand(command);
     } else {
       throw new Error('叠加模式目前仅支持两个视频');
     }
@@ -283,7 +283,7 @@ functions.ffmpeg_convertAudioFormat = async (params) => {
     bitrateOption = `-b:a ${bitrate}`;
   }
   const command = `ffmpeg -i "${inputPath}" ${bitrateOption} "${finalOutputPath}"`;
-  await this.Tools.executeCommand(command);
+  await this.aiCl.Tools.executeCommand(command);
   return {
     success: true,
     message: `音频格式转换完成: ${format}`,
@@ -305,7 +305,7 @@ functions.ffmpeg_adjustAudioVolume = async (params) => {
     throw new Error(`FFmpeg检查失败: ${checkResult.message}`);
   }
   const command = `ffmpeg -i "${inputPath}" -filter:a "volume=${volume}" "${outputPath}"`;
-  await this.Tools.executeCommand(command);
+  await this.aiCl.Tools.executeCommand(command);
   return {
     success: true,
     message: `音频音量调整完成: ${volume}倍`,
@@ -336,7 +336,7 @@ functions.ffmpeg_extractVideoThumbnail = async (params) => {
     sizeOption = `-s ${size}`;
   }
   const command = `ffmpeg -i "${videoPath}" -ss ${time} -vframes 1 ${sizeOption} "${finalOutputPath}"`;
-  await this.Tools.executeCommand(command);
+  await this.aiCl.Tools.executeCommand(command);
   return {
     success: true,
     message: `视频缩略图提取完成: ${time}`,
@@ -359,7 +359,7 @@ functions.ffmpeg_getMediaInfo = async (params) => {
   }
   try {
     const command = `ffprobe -v quiet -print_format json -show_format -show_streams "${mediaPath}"`;
-    const result = await this.Tools.executeCommand(command);
+    const result = await this.aiCl.Tools.executeCommand(command);
     // 解析JSON结果
     const info = JSON.parse(result);
     // 提取关键信息
@@ -395,7 +395,7 @@ functions.ffmpeg_getMediaInfo = async (params) => {
     // 如果ffprobe失败，尝试使用ffmpeg获取基本信息
     try {
       const fallbackCommand = `ffmpeg -i "${mediaPath}"`;
-      await this.Tools.executeCommand(fallbackCommand);
+      await this.aiCl.Tools.executeCommand(fallbackCommand);
     } catch (ffmpegError) {
       // 从错误信息中提取信息
       const errorStr = ffmpegError.toString();
@@ -468,7 +468,7 @@ functions.ffmpeg_addWatermark = async (params) => {
   // 添加输出路径
   command += ` "${outputPath}"`;
   try {
-    const result = await this.Tools.executeCommand(command);
+    const result = await this.aiCl.Tools.executeCommand(command);
     return {
       success: true,
       message: `水印添加完成: ${outputPath}`,
@@ -502,7 +502,7 @@ functions.ffmpeg_adjustBitrate = async (params) => {
   // 添加输出路径
   command += ` "${outputPath}"`;
   try {
-    const result = await this.Tools.executeCommand(command);
+    const result = await this.aiCl.Tools.executeCommand(command);
     return {
       success: true,
       message: `视频比特率调整完成: ${outputPath}`,
@@ -535,7 +535,7 @@ functions.ffmpeg_mergeVideoAudio = async (params) => {
     command = `ffmpeg -i "${videoPath}" -i "${audioPath}" -c:v copy -c:a aac -map 0:v:0 -map 1:a:0 "${outputPath}"`;
   }
   try {
-    const result = await this.Tools.executeCommand(command);
+    const result = await this.aiCl.Tools.executeCommand(command);
     return {
       success: true,
       message: `视频音频合并完成: ${outputPath}`,
@@ -582,7 +582,7 @@ functions.ffmpeg_videoToGif = async (params) => {
     command += ` "${outputPath}"`;
 
     // 执行命令
-    await this.Tools.executeCommand(command);
+    await this.aiCl.Tools.executeCommand(command);
 
     return {
       success: true,
@@ -627,7 +627,7 @@ functions.ffmpeg_cropVideo = async (params) => {
     const command = `ffmpeg -i "${videoPath}" -vf "crop=${width}:${height}:${x}:${y}" "${outputPath}"`;
 
     // 执行命令
-    await this.Tools.executeCommand(command);
+    await this.aiCl.Tools.executeCommand(command);
 
     return {
       success: true,
@@ -673,7 +673,7 @@ functions.ffmpeg_rotateVideo = async (params) => {
     const command = `ffmpeg -i "${videoPath}" -vf "${filter}" "${outputPath}"`;
 
     // 执行命令
-    await this.Tools.executeCommand(command);
+    await this.aiCl.Tools.executeCommand(command);
 
     return {
       success: true,
@@ -712,7 +712,7 @@ functions.ffmpeg_changeVideoSpeed = async (params) => {
     const command = `ffmpeg -i "${videoPath}" -filter_complex "[0:v]setpts=${1/speed}*PTS[v];[0:a]atempo=${speed}[a]" -map "[v]" -map "[a]" "${outputPath}"`;
 
     // 执行命令
-    await this.Tools.executeCommand(command);
+    await this.aiCl.Tools.executeCommand(command);
 
     return {
       success: true,
@@ -755,7 +755,7 @@ functions.ffmpeg_addSubtitles = async (params) => {
     command += ` -c:a copy "${outputPath}"`;
 
     // 执行命令
-    await this.Tools.executeCommand(command);
+    await this.aiCl.Tools.executeCommand(command);
 
     return {
       success: true,
@@ -800,7 +800,7 @@ functions.ffmpeg_extractVideoFrames = async (params) => {
     command += ` "${outputDir}/frame_%04d.${format || 'jpg'}"`;
 
     // 执行命令
-    await this.Tools.executeCommand(command);
+    await this.aiCl.Tools.executeCommand(command);
 
     return {
       success: true,
@@ -838,11 +838,11 @@ functions.ffmpeg_concatVideos = async (params) => {
     // 创建临时文件列表
     const listPath = `${outputPath}.txt`;
     const listContent = videoPaths.map(path => `file '${path}'`).join('\n');
-    await this.Tools.fs.writeFile(listPath, listContent);
+    await this.aiCl.Tools.fs.writeFile(listPath, listContent);
     const command = `ffmpeg -f concat -safe 0 -i "${listPath}" -c copy "${outputPath}"`;
 
     // 执行命令
-    await this.Tools.executeCommand(command);
+    await this.aiCl.Tools.executeCommand(command);
 
     return {
       success: true,
@@ -882,7 +882,7 @@ functions.ffmpeg_mixAudios = async (params) => {
     const command = `ffmpeg ${inputs} -filter_complex "${mixFilter}" "${outputPath}"`;
 
     // 执行命令
-    await this.Tools.executeCommand(command);
+    await this.aiCl.Tools.executeCommand(command);
 
     return {
       success: true,
@@ -921,7 +921,7 @@ functions.ffmpeg_compressVideo = async (params) => {
     const command = `ffmpeg -i "${videoPath}" -c:v libx264 -crf ${crf || 23} -preset ${preset || 'medium'} -c:a copy "${outputPath}"`;
 
     // 执行命令
-    await this.Tools.executeCommand(command);
+    await this.aiCl.Tools.executeCommand(command);
 
     return {
       success: true,
@@ -968,7 +968,7 @@ functions.ffmpeg_addTextOverlay = async (params) => {
     const command = `ffmpeg -i "${videoPath}" -vf "${filter}" "${outputPath}"`;
 
     // 执行命令
-    await this.Tools.executeCommand(command);
+    await this.aiCl.Tools.executeCommand(command);
 
     return {
       success: true,
@@ -981,6 +981,32 @@ functions.ffmpeg_addTextOverlay = async (params) => {
   }
 };
 
+/**
+ * 调整视频音量
+ * @param {object} params 参数对象
+ * @param {string} params.videoPath 输入视频文件路径
+ * @param {string} params.outputPath 输出视频文件路径
+ * @param {number} params.volume 音量倍数（如0.5为一半音量，2.0为两倍音量）
+ */
+functions.ffmpeg_adjustVideoVolume = async (params) => {
+  const { videoPath, outputPath, volume } = params;
+  // 检查ffmpeg安装
+  const checkResult = await functions.ffmpeg_checkFfmpegInstallation({ minVersion: '7.0.0' });
+  if (!checkResult.installed || !checkResult.versionOk) {
+    throw new Error(`FFmpeg检查失败: ${checkResult.message}`);
+  }
+  // 构建调整视频音量命令
+  // 使用-filter:a调整音频，-c:v copy保持视频流不重新编码
+  const command = `ffmpeg -i "${videoPath}" -filter:a "volume=${volume}" -c:v copy "${outputPath}"`;
+  await this.aiCl.Tools.executeCommand(command);
+  return {
+    success: true,
+    message: `视频音量调整完成: ${volume}倍`,
+    outputPath: outputPath
+  };
+};
+
+
 
 
 // ============ 模块导出 ============

package/index.js

@@ -3,7 +3,7 @@
  * 重新导出拆分的功能函数和描述文件，提供向后兼容性
  */
 
-const functions = require('./ffmpeg-functions.js').functions;
+const functions = require('./ffmpeg-functions.js');
 const descriptions = require('./ffmpeg-descriptions.js');
 
 // 导出

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@deepfish-ai/ffmpeg7-media-tools",
-  "version": "1.0.0",
-  "description": "基于FFmpeg 7的音频视频处理工具函数集",
+  "version": "1.0.2",
+  "type": "commonjs",
+  "description": "A DeepFish AI extension tool for comprehensive FFmpeg 7 media processing with 24 audio/video manipulation functions",
   "main": "index.js",
   "scripts": {},
   "keywords": [
@@ -23,4 +24,4 @@
     "url": "https://github.com/qq306863030/deepfish-extensions/issues"
   },
   "homepage": "https://github.com/qq306863030/deepfish-extensions#readme"
-}
+}