@evio/ffai 1.0.4 → 1.0.5

package/README.md

@@ -101,26 +101,46 @@ ffai build task.json
 00:05-00:10 这是第一条字幕
 00:12-00:18 这是第二条字幕
 00:20-00:25 支持中文和英文
+01:30-01:45 时间可以跨分钟
 ```
 
-格式说明：
+**格式说明：**
 - 时间格式：`MM:SS-MM:SS 字幕内容`
 - 开始时间和结束时间用 `-` 分隔
 - 时间和文本之间用空格分隔
+- 支持跨分钟的时间范围
+
+**字幕样式：**
+- 字体大小：36px
+- 字体颜色：白色
+- 文字效果：黑色描边 + 阴影，确保在任何背景下清晰可见
+- 位置：视频底部居中（距底部 300px）
+- 字体：macOS 使用宋体，其他系统需在 `src/task.ts` 中修改 `fontfile` 变量
 
 ## 🔄 工作流程
 
 工具会按以下步骤自动处理每个任务：
 
 1. **检查 FFmpeg** - 验证 FFmpeg 是否可用
-2. **解析配置** - 读取任务配置文件
-3. **视频转码**（可选）- 将视频统一转码为 MP4 格式（H.264 + AAC）
-4. **音频混音** - 将多个音频文件混合为一个音轨
-5. **视频选择** - 根据模式选择视频片段
-6. **视频拼接** - 将选中的视频片段拼接成完整视频
-7. **添加音频** - 为视频添加混音后的背景音频
-8. **渲染字幕** - 将字幕渲染到视频上
-9. **输出成品** - 生成最终视频文件
+2. **解析配置** - 读取任务配置文件，支持数组形式的多任务
+3. **解析素材文件** - 根据 glob 模式或数组匹配音频和视频文件
+4. **视频转码**（可选）- 将视频统一转码为 MP4 格式（H.264 + AAC，44.1kHz，立体声）
+5. **获取时长信息** - 分析所有音频和视频的播放时长
+6. **音频混音** - 将多个音频文件混合为一个音轨（以第一个音频时长为准）
+7. **视频选择** - 根据 `videoPackMode` 选择视频片段：
+   - `random` 模式：随机选择视频直到总时长 ≥ 音频时长
+   - `all` 模式：使用所有视频文件
+8. **视频拼接** - 将选中的视频片段拼接成完整视频
+9. **添加音频** - 为视频添加混音后的背景音频（使用 `-shortest` 参数自动对齐）
+10. **渲染字幕** - 将字幕渲染到视频上（白色文字 + 黑色描边阴影）
+11. **清理临时文件** - 删除中间过程文件，保留最终成品
+12. **输出成品** - 生成最终视频文件到 `task-{index}/video.mp4`
+
+**处理时间估算：**
+- 视频转码：取决于视频数量和时长，通常为实际播放时长的 0.5-2 倍
+- 音频混音：通常在几秒内完成
+- 视频拼接：较快，通常在 10 秒内
+- 字幕渲染：取决于视频时长，通常为实际播放时长的 1-3 倍
 
 ## 📂 输出结构
 
@@ -153,11 +173,15 @@ task-0/
 ]
 ```
 
-这个配置会：
-- 混合两个背景音乐
+**这个配置会：**
+- 混合两个背景音乐（以 `music1.mp3` 的时长为准）
 - 从 `clips/` 目录随机选择视频片段，直到总时长匹配音频
-- 转码所有视频为统一格式
-- 添加字幕
+- 转码所有视频为统一格式（H.264/AAC）
+- 添加字幕并输出到 `task-0/video.mp4`
+
+**适用场景：** 制作短视频、Vlog、产品宣传片等需要随机素材组合的场景
+
+---
 
 ### 示例 2：使用所有视频 + Glob 模式
 
@@ -172,10 +196,15 @@ task-0/
 ]
 ```
 
-这个配置会：
+**这个配置会：**
 - 混合 `audio/` 目录下的所有 MP3 文件
-- 按顺序拼接三个视频文件
-- 不进行视频转码（使用原始格式）
+- 按顺序拼接三个视频文件（片头 + 内容 + 片尾）
+- 不进行视频转码（使用原始格式，需确保格式一致）
+- 添加字幕并输出到 `task-0/video.mp4`
+
+**适用场景：** 固定结构的视频制作，如教程视频、演讲录制等
+
+---
 
 ### 示例 3：批量处理多个任务
 
@@ -192,10 +221,49 @@ task-0/
     "videos": "task2/videos/*.mp4",
     "narration": "task2/subtitle.txt",
     "videoPackMode": "all"
+  },
+  {
+    "audios": ["task3/bgm1.mp3", "task3/bgm2.mp3"],
+    "videos": "task3/clips/*.mp4",
+    "narration": "task3/subtitle.txt",
+    "videoTranscodeable": true,
+    "videoPackMode": "random"
+  }
+]
+```
+
+**这个配置会：**
+- 依次处理三个独立任务
+- 每个任务输出到对应的 `task-0/`、`task-1/`、`task-2/` 目录
+- 支持不同的配置组合
+
+**适用场景：** 批量生产系列视频、多语言版本视频等
+
+---
+
+### 示例 4：实际项目配置（参考 workspace/task.json）
+
+```json
+[
+  {
+    "audios": ["workspace/007/007阿勒泰.mp3", "workspace/新疆背景音乐-已编辑.MP3"],
+    "videos": "workspace/007/*.mp4",
+    "narration": "workspace/007/007.txt",
+    "videoTranscodeable": true,
+    "videoPackMode": "random"
   }
 ]
 ```
 
+**这个配置会：**
+- 混合旁白音频和背景音乐（以旁白时长为准）
+- 从 `workspace/007/` 目录随机选择视频素材
+- 转码所有视频确保格式统一
+- 添加字幕文件 `007.txt` 中的内容
+- 输出到 `task-0/video.mp4`
+
+**适用场景：** 旅游 Vlog、纪录片、风景视频等需要旁白 + 背景音乐的场景
+
 ## 🛠️ 开发
 
 ```bash
@@ -226,27 +294,261 @@ import {
 } from '@evio/ffai';
 ```
 
+### 函数详细说明
+
+#### `getMediaDuration(filePath: string): Promise<number>`
+获取媒体文件（音频或视频）的播放时长。
+
+**参数：**
+- `filePath`: 媒体文件的完整路径
+
+**返回：** Promise，resolve 时返回时长（秒）
+
+**示例：**
+```typescript
+const duration = await getMediaDuration('video.mp4');
+console.log(`视频时长: ${duration} 秒`);
+```
+
+---
+
+#### `transcodeVideo(input: string, output: string): Promise<void>`
+将单个视频转码为 MP4 格式（H.264 + AAC）。
+
+**参数：**
+- `input`: 输入视频文件路径
+- `output`: 输出视频文件路径
+
+**编码参数：**
+- 视频编码：H.264 (libx264)
+- 音频编码：AAC
+- 音频采样率：44.1kHz
+- 音频声道：立体声
+
+**示例：**
+```typescript
+await transcodeVideo('input.avi', 'output.mp4');
+```
+
+---
+
+#### `concatVideos(files: string[], outputFilePath: string, tmp?: string): Promise<void>`
+拼接多个视频文件为一个完整视频。
+
+**参数：**
+- `files`: 视频文件路径数组
+- `outputFilePath`: 输出文件路径
+- `tmp`: 可选，临时文件目录（用于存放 videofiles.txt）
+
+**注意：** 建议所有视频使用相同的编码格式、分辨率和帧率
+
+**示例：**
+```typescript
+await concatVideos(
+  ['clip1.mp4', 'clip2.mp4', 'clip3.mp4'],
+  'final.mp4',
+  './tmp'
+);
+```
+
+---
+
+#### `mergeAudioFiles(audioFiles: string[], outputFilePath: string): Promise<void>`
+混音多个音频文件，以第一个音频的时长为准。
+
+**参数：**
+- `audioFiles`: 音频文件路径数组
+- `outputFilePath`: 输出文件路径
+
+**混音规则：**
+- 使用 FFmpeg 的 `amix` 滤镜
+- 自动调整音量避免爆音
+- 输出时长由第一个音频决定
+
+**示例：**
+```typescript
+await mergeAudioFiles(
+  ['narration.mp3', 'bgm.mp3'],
+  'mixed.mp3'
+);
+```
+
+---
+
+#### `addBackgroundAudio(inputVideoPath: string, outputVideoPath: string, audioPath: string): Promise<void>`
+为视频添加背景音频。
+
+**参数：**
+- `inputVideoPath`: 输入视频路径
+- `outputVideoPath`: 输出视频路径
+- `audioPath`: 音频文件路径
+
+**处理规则：**
+- 视频流直接复制，不重新编码
+- 音频使用 AAC 编码
+- 使用 `-shortest` 参数，输出长度取视频和音频中较短的一个
+
+**示例：**
+```typescript
+await addBackgroundAudio(
+  'video.mp4',
+  'video_with_audio.mp4',
+  'bgm.mp3'
+);
+```
+
+---
+
+#### `addSubTitles(inputfile: string, outputfile: string, texts: string, fontfile?: string): Promise<void>`
+为视频添加字幕。
+
+**参数：**
+- `inputfile`: 输入视频路径
+- `outputfile`: 输出视频路径
+- `texts`: 字幕文件路径（格式：`MM:SS-MM:SS 文本内容`）
+- `fontfile`: 可选，字体文件路径
+
+**字幕样式：**
+- 字体大小：36px
+- 颜色：白色
+- 效果：黑色描边 + 阴影
+- 位置：底部居中（距底部 300px）
+
+**示例：**
+```typescript
+await addSubTitles(
+  'video.mp4',
+  'video_with_subtitles.mp4',
+  'subtitle.txt',
+  '/path/to/font.ttf'
+);
+```
+
+---
+
+#### `checkFfmpegAvailable(): Promise<boolean>`
+检查系统中 FFmpeg 是否可用。
+
+**返回：** Promise，resolve 时返回 `true`（可用）或 `false`（不可用）
+
+**示例：**
+```typescript
+const available = await checkFfmpegAvailable();
+if (!available) {
+  console.error('FFmpeg 未安装或不可用');
+}
+```
+
 ## ⚠️ 注意事项
 
-1. **FFmpeg 必须安装** - 工具依赖 FFmpeg，请确保已正确安装
-2. **字幕字体** - macOS 默认使用宋体（`/System/Library/Fonts/Supplemental/Songti.ttc`），其他系统可能需要修改字体路径
-3. **视频格式** - 建议启用 `videoTranscodeable` 以确保所有视频格式统一，避免拼接问题
-4. **文件路径** - 所有路径都相对于执行命令的当前目录
-5. **临时文件** - 处理完成后会自动清理临时文件，保留最终成品
+1. **FFmpeg 必须安装** - 工具依赖 FFmpeg，请确保已正确安装并配置到环境变量
+2. **字幕字体路径** - macOS 默认使用宋体（`/System/Library/Fonts/Supplemental/Songti.ttc`），其他系统需要在 `src/task.ts` 中修改 `fontfile` 变量
+3. **视频格式统一** - 强烈建议启用 `videoTranscodeable` 以确保所有视频格式统一，避免拼接时出现黑屏、卡顿或音画不同步
+4. **文件路径规则** - 所有路径都相对于执行命令的当前目录（`process.cwd()`）
+5. **临时文件清理** - 处理完成后会自动清理中间过程文件（`video_concat.mp4`、`video_concat_audio.mp4`、`videofiles.txt`），仅保留最终成品
+6. **音频时长规则** - 当 `audios` 为数组时，最终音频时长由第一个音频文件决定，其他音频会被混音叠加
+7. **视频时长匹配** - 添加背景音频时使用 `-shortest` 参数，输出视频长度会与音频或视频中较短的一个对齐
+8. **字幕文件编码** - 字幕文件必须使用 UTF-8 编码，避免中文乱码
+9. **Glob 模式注意** - 使用 glob 模式时，文件匹配顺序可能不是字母顺序，建议使用数组明确指定顺序
+10. **磁盘空间** - 视频处理需要较大的临时存储空间，确保磁盘有足够空间（建议至少为源文件总大小的 2-3 倍）
+
+## 🎯 最佳实践
+
+1. **项目结构建议**
+   ```
+   project/
+   ├── task.json          # 任务配置文件
+   ├── audios/            # 音频素材目录
+   │   ├── narration.mp3
+   │   └── bgm.mp3
+   ├── videos/            # 视频素材目录
+   │   ├── clip1.mp4
+   │   └── clip2.mp4
+   ├── subtitles/         # 字幕文件目录
+   │   └── subtitle.txt
+   └── task-0/            # 输出目录（自动生成）
+       └── video.mp4
+   ```
+
+2. **视频素材准备**
+   - 尽量使用相同分辨率和帧率的视频素材
+   - 如果素材格式不统一，务必启用 `videoTranscodeable: true`
+   - 建议使用 1920x1080 (1080p) 或 1280x720 (720p) 分辨率
+
+3. **音频素材准备**
+   - 旁白音频放在数组第一位，背景音乐放在后面
+   - 确保音频采样率一致（建议 44.1kHz）
+   - 背景音乐音量建议比旁白低 20-30%（可以预先处理）
+
+4. **字幕文件编写**
+   - 使用文本编辑器保存为 UTF-8 编码
+   - 每条字幕时长建议 3-8 秒，便于阅读
+   - 字幕文本不要过长，建议每行不超过 20 个汉字
+   - 预留字幕间隔时间，避免连续出现
+
+5. **性能优化**
+   - 如果不需要转码，关闭 `videoTranscodeable` 可以大幅提升速度
+   - 批量任务建议分批处理，避免一次处理过多任务
+   - 使用 SSD 硬盘可以显著提升处理速度
+
+6. **质量控制**
+   - 处理完成后检查输出视频的音画同步
+   - 验证字幕显示时间和内容是否正确
+   - 检查音频混音效果，确保旁白清晰可听
 
 ## 🐛 常见问题
 
 **Q: 提示 "FFmpeg is not available"**  
-A: 请确保已安装 FFmpeg 并配置到系统环境变量中
+A: 请确保已安装 FFmpeg 并配置到系统环境变量中。可以运行 `ffmpeg -version` 验证安装。
 
 **Q: 视频拼接后出现黑屏或卡顿**  
-A: 建议启用 `videoTranscodeable: true` 将所有视频转码为统一格式
+A: 建议启用 `videoTranscodeable: true` 将所有视频转码为统一格式。不同编码格式的视频直接拼接可能导致兼容性问题。
 
-**Q: 字幕显示不正常**  
-A: 检查字幕文件格式是否正确，时间格式必须为 `MM:SS-MM:SS`
+**Q: 字幕显示不正常或不显示**  
+A: 
+- 检查字幕文件格式是否正确，时间格式必须为 `MM:SS-MM:SS 文本内容`
+- 确保字幕文件使用 UTF-8 编码
+- 检查时间范围是否在视频时长内
+- 确保每行格式正确，时间和文本之间有空格
 
 **Q: 音频混音后声音太小或太大**  
-A: FFmpeg 的 `amix` 滤镜会自动调整音量，如需手动控制可修改 `lib.ts` 中的混音参数
+A: FFmpeg 的 `amix` 滤镜会自动调整音量。如需手动控制，可以在 `src/lib.ts` 的 `mergeAudioFiles` 函数中修改 `amix` 参数，例如添加 `weights` 选项来调整各音频的权重。
+
+**Q: 字幕字体显示异常或乱码**  
+A: 
+- macOS 默认使用宋体，路径为 `/System/Library/Fonts/Supplemental/Songti.ttc`
+- Windows 可以使用 `C:/Windows/Fonts/simhei.ttf`（黑体）
+- Linux 需要安装中文字体，如 `sudo apt install fonts-wqy-zenhei`
+- 修改 `src/task.ts` 中的 `fontfile` 变量指向正确的字体文件
+
+**Q: 任务配置文件必须是 .json 后缀吗？**  
+A: 是的，工具会检查文件扩展名，必须使用 `.json` 后缀。
+
+**Q: 可以处理哪些视频格式？**  
+A: FFmpeg 支持几乎所有常见视频格式（MP4、AVI、MOV、MKV、FLV 等）。建议启用 `videoTranscodeable` 转码为统一的 MP4 格式以确保兼容性。
+
+**Q: random 模式如何选择视频？**  
+A: 工具会随机选择视频片段，累加时长直到 ≥ 音频时长。每个视频片段只会被选择一次，避免重复。如果所有视频总时长仍小于音频时长，则使用所有视频。
+
+**Q: 处理大文件时速度很慢怎么办？**  
+A: 
+- 视频转码是最耗时的步骤，如果源视频已经是 MP4 格式，可以关闭 `videoTranscodeable`
+- 字幕渲染需要重新编码视频，可以在 `src/lib.ts` 中调整 `-preset` 参数（如改为 `ultrafast`）来加快速度，但会增大文件体积
+- 考虑使用更强大的硬件或启用硬件加速
+
+**Q: 如何自定义字幕样式？**  
+A: 在 `src/lib.ts` 的 `addSubTitles` 函数中修改 `videoFilters` 的 `options`，可以调整：
+- `fontsize`: 字体大小
+- `fontcolor`: 文字颜色
+- `shadowcolor`/`shadowx`/`shadowy`: 阴影效果
+- `borderw`/`bordercolor`: 边框效果
+- `x`/`y`: 字幕位置
+
+**Q: 输出视频的质量如何控制？**  
+A: 在 `src/lib.ts` 中可以调整编码参数：
+- 转码时的 `-c:v libx264` 可以改为 `-c:v libx265`（更高压缩率）
+- 字幕渲染时的 `-crf 18` 控制质量（0-51，数值越小质量越高，18 为高质量）
+- 音频比特率 `-b:a 192k` 可以调整为更高或更低的值
 
 ## 📄 License
 
@@ -256,7 +558,53 @@ ISC
 
 欢迎提交 Issue 和 Pull Request！
 
+### 贡献指南
+
+1. Fork 本项目
+2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
+3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
+4. 推送到分支 (`git push origin feature/AmazingFeature`)
+5. 开启 Pull Request
+
+### 开发建议
+
+- 遵循现有代码风格
+- 添加适当的注释和文档
+- 测试新功能确保不影响现有功能
+- 更新 README 文档（如有必要）
+
+## 📚 相关资源
+
+- [FFmpeg 官方文档](https://ffmpeg.org/documentation.html)
+- [fluent-ffmpeg 文档](https://github.com/fluent-ffmpeg/node-fluent-ffmpeg)
+- [FFmpeg 滤镜文档](https://ffmpeg.org/ffmpeg-filters.html)
+- [视频编码指南](https://trac.ffmpeg.org/wiki/Encode/H.264)
+
+## 🔮 未来计划
+
+- [ ] 支持更多字幕格式（SRT、ASS 等）
+- [ ] 添加视频特效和转场效果
+- [ ] 支持硬件加速编码（NVENC、QSV 等）
+- [ ] 提供 GUI 界面
+- [ ] 支持实时预览
+- [ ] 添加进度条显示
+- [ ] 支持视频裁剪和缩放
+- [ ] 添加水印功能
+- [ ] 支持多语言字幕
+
+## 📞 联系方式
+
+如有问题或建议，欢迎通过以下方式联系：
+
+- 提交 [Issue](https://github.com/your-repo/issues)
+- 发送邮件至：[your-email@example.com]
+
 ---
 
 **版本**: 1.0.2  
-**作者**: @evio/ffai
+**作者**: @evio/ffai  
+**最后更新**: 2024
+
+---
+
+⭐ 如果这个项目对你有帮助，欢迎给个 Star！

package/dist/task.js

@@ -4,10 +4,15 @@ exports.RunTask = RunTask;
 const node_path_1 = require("node:path");
 const glob_1 = require("glob");
 const node_fs_1 = require("node:fs");
+const signale_1 = require("signale");
 const lib_1 = require("./lib");
 const fontfile = '/System/Library/Fonts/Supplemental/Songti.ttc';
 async function RunTask(props, index) {
-    console.log(`开始第${index + 1}个任务：`);
+    const cmd = new signale_1.Signale({
+        interactive: true,
+        scope: 'task-' + (index + 1),
+    });
+    cmd.await(`[%d/7] - 正在进行第${index + 1}个任务...`, 1);
     const cwd = process.cwd();
     const directory = (0, node_path_1.resolve)(cwd, 'task-' + index);
     const narrationFile = (0, node_path_1.resolve)(cwd, props.narration);
@@ -15,8 +20,8 @@ async function RunTask(props, index) {
         throw new Error('缺少旁白文件');
     if (!(0, node_fs_1.existsSync)(directory))
         (0, node_fs_1.mkdirSync)(directory);
-    const videosData = await parseVideos(props.videoTranscodeable, props.videos, directory);
-    const audioData = await parseAudios(props.audios, directory);
+    const videosData = await parseVideos(props.videoTranscodeable, props.videos, directory, cmd);
+    const audioData = await parseAudios(props.audios, directory, cmd);
     const output_concat = (0, node_path_1.resolve)(directory, 'video_concat.mp4');
     const output_concat_audio = (0, node_path_1.resolve)(directory, 'video_concat_audio.mp4');
     const output_concat_audio_subtitle = (0, node_path_1.resolve)(directory, 'video.mp4');
@@ -36,14 +41,26 @@ async function RunTask(props, index) {
     const videoTmpDir = (0, node_path_1.resolve)(directory, 'tmp');
     if (!(0, node_fs_1.existsSync)(videoTmpDir))
         (0, node_fs_1.mkdirSync)(videoTmpDir);
+    cmd.await(`[%d/7] - 正在合并视频...`, 4);
     await (0, lib_1.concatVideos)(packVideos, output_concat, videoTmpDir);
+    cmd.await(`[%d/7] - 正在添加背景音频...`, 5);
     await (0, lib_1.addBackgroundAudio)(output_concat, output_concat_audio, audioData.file);
+    cmd.await(`[%d/7] - 正在添加旁白...`, 6);
     await (0, lib_1.addSubTitles)(output_concat_audio, output_concat_audio_subtitle, narrationFile, fontfile);
     // 清理
     (0, node_fs_1.unlinkSync)((0, node_path_1.resolve)(videoTmpDir, 'videofiles.txt'));
+    (0, node_fs_1.rmdirSync)(videoTmpDir);
+    (0, node_fs_1.unlinkSync)(audioData.file);
     (0, node_fs_1.unlinkSync)(output_concat);
     (0, node_fs_1.unlinkSync)(output_concat_audio);
-    console.log('+', output_concat_audio_subtitle);
+    const videoDirectory = (0, node_path_1.resolve)(directory, 'videos');
+    if (props.videoTranscodeable && (0, node_fs_1.existsSync)(videoDirectory)) {
+        for (let i = 0; i < videosData.length; i++) {
+            (0, node_fs_1.unlinkSync)(videosData[i].file);
+        }
+        (0, node_fs_1.rmdirSync)(videoDirectory);
+    }
+    cmd.success(`[%d/7] - ${output_concat_audio_subtitle}`, 7);
 }
 async function getVideoFiles(videos) {
     const cwd = process.cwd();
@@ -65,7 +82,7 @@ async function getAudioFiles(audios) {
         return files.map(file => (0, node_path_1.resolve)(cwd, file));
     }
 }
-async function parseVideos(transcodeable, videos, directory) {
+async function parseVideos(transcodeable, videos, directory, cmd) {
     let files = await getVideoFiles(videos);
     if (transcodeable) {
         const to = (0, node_path_1.resolve)(directory, 'videos');
@@ -73,6 +90,7 @@ async function parseVideos(transcodeable, videos, directory) {
             (0, node_fs_1.mkdirSync)(to);
         let newFiles = [];
         for (let i = 0; i < files.length; i++) {
+            cmd.await(`[%d/7] - 正在转换视频格式: %d/%d`, 2, i + 1, files.length);
             const outfile = (0, node_path_1.resolve)(to, `${i + 1}.mp4`);
             await (0, lib_1.transcodeVideo)(files[i], outfile);
             newFiles.push(outfile);
@@ -81,6 +99,7 @@ async function parseVideos(transcodeable, videos, directory) {
     }
     const result = [];
     for (let i = 0; i < files.length; i++) {
+        cmd.await(`[%d/7] - 正在转换视频格式: %d/%d`, 2, i + 1, files.length);
         const sec = Math.ceil(await (0, lib_1.getMediaDuration)(files[i]));
         result.push({
             file: files[i],
@@ -89,9 +108,10 @@ async function parseVideos(transcodeable, videos, directory) {
     }
     return result;
 }
-async function parseAudios(audios, directory) {
+async function parseAudios(audios, directory, cmd) {
     const files = await getAudioFiles(audios);
     const file = (0, node_path_1.resolve)(directory, 'audio.mp3');
+    cmd.await(`[%d/7] - 正在合并音频`, 3);
     await (0, lib_1.mergeAudioFiles)(files, file);
     const sec = Math.ceil(await (0, lib_1.getMediaDuration)(file));
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evio/ffai",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "一个基于 FFmpeg 的命令行工具，用于批量处理视频和音频文件，支持视频转码、音频合并、字幕添加等功能。",
   "main": "dist/lib.js",
   "scripts": {
@@ -22,15 +22,18 @@
     "commander": "^14.0.2",
     "dayjs": "1.11.19",
     "fluent-ffmpeg": "^2.1.3",
-    "glob": "^13.0.0"
+    "glob": "^13.0.0",
+    "signale": "^1.4.0"
   },
   "devDependencies": {
     "@types/fluent-ffmpeg": "^2.1.27",
+    "@types/fs-extra": "^11.0.4",
     "@types/node": "^22.0.0",
+    "@types/signale": "^1.4.7",
     "dayjs": "1.11.19",
+    "fix-esm-import-path": "^1.10.1",
     "glob": "^13.0.0",
     "ts-node": "^10.9.2",
-    "typescript": "^5.4.0",
-    "fix-esm-import-path": "^1.10.1"
+    "typescript": "^5.4.0"
   }
 }