@xiping/node-utils

Node.js 通用工具库，提供目录树、路径、SRT→VTT 字幕转换、FFmpeg 视频处理、文件信息与图片处理等能力。

npm install @xiping/node-utils

命令行

包内提供可执行命令（需本机已安装 Node；部分命令依赖 FFmpeg，见各模块说明）：

| 命令 | 说明 | |------|------| | video-thumbnail | 为视频生成多帧合成缩略图（见 src/ffmpeg/README.md 中「缩略图生成」与「命令行」） | | translate-srt | 字幕翻译教学相关 CLI（见 src/subtitle-translation-teaching/README.md） |

示例（临时执行、未安装依赖）：

npx -p @xiping/node-utils@latest video-thumbnail --input /path/to/video.mp4

使用案例

import {
  buildDirectoryTree,
  getParentDirectory,
  convertSrtFileToVttFile,
  getVideoInfo,
  getThumbnail,
  getFileConfig,
  convertImage,
  checkFFmpegAvailability,
} from '@xiping/node-utils';

// 目录树
const tree = buildDirectoryTree('/path/to/dir');

// 路径
const parent = getParentDirectory('/Users/documents/folder');

// SRT 转 VTT
convertSrtFileToVttFile('/path/to/subtitle.srt');

// 视频信息与缩略图（需系统安装 ffmpeg）
if (checkFFmpegAvailability()) {
  const info = getVideoInfo('/path/to/video.mp4');
  const thumb = await getThumbnail('/path/to/video.mp4', { frames: 30 });
}

// 文件配置（含视频元数据）
const config = getFileConfig('/path/to/file.mp4');

// 图片格式转换
await convertImage(inputPath, outputPath, 'webp', { quality: 80 });

更多说明见 src/ffmpeg/README.md、src/image/README.md、src/srt-to-vtt/README.md。