@xiping/node-utils 1.0.76 → 1.0.77

package/README.md

@@ -6,6 +6,21 @@ Node.js 通用工具库，提供目录树、路径、SRT→VTT 字幕转换、FF
 npm install @xiping/node-utils
 ```
 
+## 命令行
+
+包内提供可执行命令（需本机已安装 Node；部分命令依赖 FFmpeg，见各模块说明）：
+
+| 命令 | 说明 |
+|------|------|
+| `video-thumbnail` | 为视频生成多帧合成缩略图（见 [src/ffmpeg/README.md](./src/ffmpeg/README.md) 中「缩略图生成」与「命令行」） |
+| `translate-srt` | 字幕翻译教学相关 CLI（见 [src/subtitle-translation-teaching/README.md](./src/subtitle-translation-teaching/README.md)） |
+
+**示例（临时执行、未安装依赖）：**
+
+```bash
+npx -p @xiping/node-utils@latest video-thumbnail --input /path/to/video.mp4
+```
+
 ## 使用案例
 
 ```typescript

package/bin/video-thumbnail

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../lib/src/ffmpeg/cli-thumbnail.js";

package/lib/src/ffmpeg/README.md

@@ -140,6 +140,27 @@ console.log(result.outputPath);
 console.log(result.metadata);
 ```
 
+### 命令行（`video-thumbnail`）
+
+安装 `@xiping/node-utils` 后可用 `video-thumbnail`，与上方 API 选项对应（见 `--help`）。
+
+**未在项目中安装依赖、临时在一台机器上执行：**
+
+```bash
+npx -p @xiping/node-utils@latest video-thumbnail --input /path/to/video.mp4
+```
+
+（包名是 `@xiping/node-utils`，命令名是 `video-thumbnail`，临时拉包时需用 `-p` 指定包名。）
+
+**已全局安装**（之后可省略 `npx` 与 `-p`）：
+
+```bash
+npm i -g @xiping/node-utils
+video-thumbnail --input /path/to/video.mp4
+```
+
+**当前项目已依赖本包** 时，可直接 `npx video-thumbnail --input ...`，无需 `-p`。
+
 ### 进度回调
 
 ```typescript

package/lib/src/ffmpeg/cli-thumbnail.d.ts

@@ -0,0 +1 @@
+export declare function runCli(args: string[]): Promise<void>;

package/lib/src/ffmpeg/cli-thumbnail.js

@@ -0,0 +1,130 @@
+import path from "node:path";
+import { getThumbnail } from "./getThumbnail.js";
+function printHelp() {
+    console.log(`Usage: video-thumbnail --input <video> [options]
+
+Options:
+  -i, --input <path>       Video file path (required)
+  --frames <n>             Frame count for composition (default: 60)
+  --output-width <n>       Output width in pixels (default: 3840)
+  --columns <n>            Grid columns (default: 4)
+  --output-name <name>     Output filename, e.g. thumbnail.avif (default: thumbnail.avif)
+  --quality <1-100>        Output quality (default: 80)
+  --format <fmt>           avif | webp | jpeg | png (default: avif)
+  --batch-size <n>         Batch size (default: 10)
+  --max-concurrency <n>    Max concurrency (default: 4)
+  --temp-dir <path>        Custom temp directory
+  -h, --help               Show this help
+`);
+}
+function parseArgs(args) {
+    const options = { input: "" };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--input" || arg === "-i") {
+            options.input = args[++i] ?? "";
+        }
+        else if (arg === "--frames") {
+            options.frames = parseInt(args[++i] ?? "", 10);
+        }
+        else if (arg === "--output-width") {
+            options.outputWidth = parseInt(args[++i] ?? "", 10);
+        }
+        else if (arg === "--columns") {
+            options.columns = parseInt(args[++i] ?? "", 10);
+        }
+        else if (arg === "--output-name") {
+            options.outputFileName = args[++i] ?? "";
+        }
+        else if (arg === "--quality") {
+            options.quality = parseInt(args[++i] ?? "", 10);
+        }
+        else if (arg === "--format") {
+            const f = args[++i] ?? "";
+            if (f === "avif" || f === "webp" || f === "jpeg" || f === "png") {
+                options.format = f;
+            }
+            else {
+                console.error(`Error: --format must be avif, webp, jpeg, or png, got: ${f}`);
+                process.exit(1);
+            }
+        }
+        else if (arg === "--batch-size") {
+            options.batchSize = parseInt(args[++i] ?? "", 10);
+        }
+        else if (arg === "--max-concurrency") {
+            options.maxConcurrency = parseInt(args[++i] ?? "", 10);
+        }
+        else if (arg === "--temp-dir") {
+            options.tempDir = args[++i] ?? "";
+        }
+        else if (arg === "--help" || arg === "-h") {
+            options.help = true;
+        }
+    }
+    return options;
+}
+function buildThumbnailOptions(opts) {
+    const out = {
+        onProgress: (p) => {
+            const line = `[${p.phase}] ${p.percent}%${p.message ? ` ${p.message}` : ""}`;
+            console.error(line);
+        },
+    };
+    if (opts.frames !== undefined && !Number.isNaN(opts.frames)) {
+        out.frames = opts.frames;
+    }
+    if (opts.outputWidth !== undefined && !Number.isNaN(opts.outputWidth)) {
+        out.outputWidth = opts.outputWidth;
+    }
+    if (opts.columns !== undefined && !Number.isNaN(opts.columns)) {
+        out.columns = opts.columns;
+    }
+    if (opts.outputFileName) {
+        out.outputFileName = opts.outputFileName;
+    }
+    if (opts.quality !== undefined && !Number.isNaN(opts.quality)) {
+        out.quality = opts.quality;
+    }
+    if (opts.format) {
+        out.format = opts.format;
+    }
+    if (opts.batchSize !== undefined && !Number.isNaN(opts.batchSize)) {
+        out.batchSize = opts.batchSize;
+    }
+    if (opts.maxConcurrency !== undefined && !Number.isNaN(opts.maxConcurrency)) {
+        out.maxConcurrency = opts.maxConcurrency;
+    }
+    if (opts.tempDir) {
+        out.tempDir = path.resolve(opts.tempDir);
+    }
+    return out;
+}
+export async function runCli(args) {
+    const opts = parseArgs(args);
+    if (opts.help) {
+        printHelp();
+        return;
+    }
+    if (!opts.input) {
+        console.error("Error: --input is required");
+        printHelp();
+        process.exit(1);
+    }
+    const videoPath = path.resolve(process.cwd(), opts.input);
+    const thumbnailOpts = buildThumbnailOptions(opts);
+    try {
+        const result = await getThumbnail(videoPath, thumbnailOpts);
+        console.log(result.outputPath);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        console.error(`Error: ${msg}`);
+        process.exit(1);
+    }
+}
+const argv = process.argv.slice(2);
+runCli(argv).catch((e) => {
+    console.error(e instanceof Error ? e.message : String(e));
+    process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiping/node-utils",
-  "version": "1.0.76",
+  "version": "1.0.77",
   "description": "node-utils",
   "type": "module",
   "author": "The-End-Hero <527409987@qq.com>",
@@ -8,14 +8,16 @@
   "license": "MIT",
   "main": "lib/index.js",
   "bin": {
-    "translate-srt": "./bin/translate-srt"
+    "translate-srt": "./bin/translate-srt",
+    "video-thumbnail": "./bin/video-thumbnail"
   },
   "directories": {
     "lib": "lib",
     "test": "__tests__"
   },
   "files": [
-    "lib"
+    "lib",
+    "bin"
   ],
   "repository": {
     "type": "git",
@@ -28,7 +30,7 @@
   "bugs": {
     "url": "https://github.com/The-End-Hero/xiping/issues"
   },
-  "gitHead": "24c2d65c542f30ed4b09d7c9473a004f5e08dd3c",
+  "gitHead": "53cce3c7a028d237fa19f768d9a392bea054d49a",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"