@deepfish-ai/ffmpeg7-media-tools 1.0.1 → 1.0.3

package/README.md

@@ -1,6 +1,6 @@
 # @deepfish-ai/ffmpeg7-media-tools
 
-English | [中文](./README_CN.md)
+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.
 
@@ -14,22 +14,37 @@ A comprehensive FFmpeg 7 based audio and video processing toolkit with 24 media
 
 ## 🚀 Quick Start
 
-### Prerequisites
+Follow these three steps to install and use this extension:
 
-First, install the global deepfish-ai library:
+### Step 1: Install DeepFish AI
+First, install the global deepfish-ai library (if not already installed):
 
 ```bash
 npm install deepfish-ai -g
 ```
 
-### Installation
-
+### Step 2: Install This Extension
 Install this package globally:
 
 ```bash
 npm install @deepfish-ai/ffmpeg7-media-tools -g
 ```
 
+### 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
+ai convert video.mp4 to avi format
+```
+
+or
+
+```bash
+ai extract audio from video.mp4
+```
+
+The AI will automatically use the appropriate FFmpeg functions from this extension.
+
 ### FFmpeg Installation
 
 This toolkit requires FFmpeg 7 or higher. Please install FFmpeg 7 before using:
@@ -144,6 +159,7 @@ MIT License - See LICENSE file
 ## 📞 Support
 
 For questions or suggestions, please:
+
 1. Check the Troubleshooting section in this documentation
 2. Submit a GitHub Issue
 3. Contact the maintenance team

package/README_CN.md

@@ -1,6 +1,6 @@
 # @deepfish-ai/ffmpeg7-media-tools
 
-[English](./README.md) | 中文
+[English](https://github.com/qq306863030/deepfish-extensions/blob/master/deepfish-ffmpeg7-media-tools/README.md) | 中文
 
 基于FFmpeg 7的音频视频处理工具函数集，包含24个媒体处理函数，支持视频格式转换、音频提取、视频编辑等常见媒体处理任务。
 
@@ -14,22 +14,37 @@
 
 ## 🚀 快速开始
 
-### 前提条件
+按照以下三个步骤安装和使用此扩展：
 
-首先，安装全局deepfish-ai库：
+### 步骤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：
@@ -144,6 +159,7 @@ MIT License - 详见LICENSE文件
 ## 📞 支持
 
 如有问题或建议，请：
+
 1. 查看本文档的故障排除部分
 2. 提交GitHub Issue
 3. 联系维护团队

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,
@@ -980,32 +980,32 @@ functions.ffmpeg_addTextOverlay = async (params) => {
     throw new Error(`${name.replace('ffmpeg_', '')}失败: ${error.message}`);
   }
 };
-
-/**
- * 调整视频音量
- * @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.Tools.executeCommand(command);
-  return {
-    success: true,
-    message: `视频音量调整完成: ${volume}倍`,
-    outputPath: outputPath
-  };
-};
-
+
+/**
+ * 调整视频音量
+ * @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

@@ -6,8 +6,13 @@
 const functions = require('./ffmpeg-functions.js');
 const descriptions = require('./ffmpeg-descriptions.js');
 
+const name = '@deepfish-ai/ffmpeg7-media-tools';
+const description = 'A DeepFish AI extension tool for FFmpeg 7 media processing, including FFmpeg installation/version checks, video/audio format conversion, video trim/merge/concat/crop/rotate/resize, playback speed and bitrate/volume adjustment, video compression, GIF generation, frame and thumbnail extraction, subtitle and watermark/text overlay, audio extraction/mixing, video-audio muxing, and media metadata inspection.';
+
 // 导出
 module.exports = {
+  name,
+  description,
   descriptions,
   functions
 };

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@deepfish-ai/ffmpeg7-media-tools",
-  "version": "1.0.1",
-  "description": "基于FFmpeg 7的音频视频处理工具函数集",
+  "version": "1.0.3",
+  "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"
-}
+}