@sns-parse/ext-gif 0.1.0-alpha.1

package/lib/gif.d.ts

@@ -0,0 +1,13 @@
+import type { ParserRuntimeLike } from '@sns-parse/core';
+export interface GifOptions {
+    maxWidth: number;
+    fps: number;
+    maxDurationSec: number;
+}
+export declare function resolveFfmpeg(): string;
+/** 生成 ffmpeg 滤镜串（导出供测试） */
+export declare function gifFilter(width: number, fps: number): string;
+/** 裁剪实际转换时长：动图时长与上限取小；未知时长用上限 */
+export declare function gifDuration(durationSec: number, maxDurationSec: number): number;
+/** 下载视频并转 GIF；任何失败返回 null */
+export declare function mp4ToGif(rt: ParserRuntimeLike, url: string, durationSec: number, opts: GifOptions): Promise<Buffer | null>;

package/lib/gif.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveFfmpeg = resolveFfmpeg;
+exports.gifFilter = gifFilter;
+exports.gifDuration = gifDuration;
+exports.mp4ToGif = mp4ToGif;
+/**
+ * 视频转 GIF（推文动图用）。
+ *
+ * ffmpeg 管道两遍法（palettegen + paletteuse），不落盘。
+ * ffmpeg 不可用 / 转换失败 / 下载失败 → 返回 null，调用方回退发送原视频。
+ */
+const child_process_1 = require("child_process");
+const core_1 = require("@sns-parse/core");
+let ffmpegMissingWarned = false;
+/**
+ * ffmpeg 路径解析：内置静态二进制（optionalDependency ffmpeg-static，随插件自动安装）
+ * → 系统 PATH。解析结果记忆化，来源记入 debug 日志。
+ */
+let resolvedFfmpeg = null;
+function resolveFfmpeg() {
+    if (resolvedFfmpeg !== null)
+        return resolvedFfmpeg;
+    try {
+        const p = require('ffmpeg-static');
+        resolvedFfmpeg = typeof p === 'string' && p ? p : 'ffmpeg';
+        (0, core_1.debugLog)(`ffmpeg 解析：内置静态二进制 ${resolvedFfmpeg}`);
+    }
+    catch {
+        resolvedFfmpeg = 'ffmpeg';
+        (0, core_1.debugLog)('ffmpeg 解析：未安装 ffmpeg-static（--no-optional 安装？），回退系统 PATH');
+    }
+    return resolvedFfmpeg;
+}
+/** 生成 ffmpeg 滤镜串（导出供测试） */
+function gifFilter(width, fps) {
+    const w = Math.max(120, Math.min(1080, Math.round(width)));
+    const f = Math.max(5, Math.min(30, Math.round(fps)));
+    return `fps=${f},scale=${w}:-2:flags=lanczos,split[s0][s1];[s0]palettegen=max_colors=128[p];[s1][p]paletteuse=dither=bayer`;
+}
+/** 裁剪实际转换时长：动图时长与上限取小；未知时长用上限 */
+function gifDuration(durationSec, maxDurationSec) {
+    const max = Math.max(1, Math.min(60, maxDurationSec));
+    if (!durationSec || durationSec <= 0)
+        return max;
+    return Math.max(1, Math.min(max, Math.round(durationSec)));
+}
+function runFfmpeg(input, vf, durationSec) {
+    return new Promise((resolve) => {
+        const child = (0, child_process_1.spawn)(resolveFfmpeg(), [
+            '-hide_banner', '-loglevel', 'error',
+            '-i', 'pipe:0',
+            '-t', String(durationSec),
+            '-vf', vf,
+            '-f', 'gif', 'pipe:1',
+        ]);
+        const out = [];
+        let err = '';
+        child.stdout.on('data', (d) => out.push(d));
+        child.stderr.on('data', (d) => { err += d.toString(); });
+        child.on('error', (e) => {
+            if (!ffmpegMissingWarned) {
+                ffmpegMissingWarned = true;
+                core_1.logger.warn(`GIF 转换需要 ffmpeg，但二进制不可用（动图将回退为视频发送）：${e.message}。请安装 optionalDependency ffmpeg-static，或在 PATH 中提供 ffmpeg。`);
+            }
+            resolve(null);
+        });
+        child.on('close', (code) => {
+            if (code === 0 && out.length) {
+                const gif = Buffer.concat(out);
+                core_1.logger.info(`动图已转 GIF 发送：${Math.round(gif.length / 1024)}KB（源视频 ${Math.round(input.length / 1024)}KB）`);
+                resolve(gif);
+            }
+            else {
+                core_1.logger.info(`动图转 GIF 失败，回退发送原视频（ffmpeg 退出码 ${code}${err ? '：' + err.slice(0, 120) : ''}）`);
+                resolve(null);
+            }
+        });
+        child.stdin.on('error', () => { });
+        child.stdin.end(input);
+    });
+}
+/** 下载视频并转 GIF；任何失败返回 null */
+async function mp4ToGif(rt, url, durationSec, opts) {
+    try {
+        // X 媒体 CDN (video.twimg.com) 需要浏览器级 UA + Referer 才不会 403（与 vault 下载一致）
+        const res = await rt.http.get(url, {
+            responseType: 'arraybuffer',
+            timeout: Math.min(rt.config.timeout || 60000, 120000),
+            headers: {
+                'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36',
+                'Referer': 'https://twitter.com/',
+            },
+        });
+        const input = Buffer.from(res.data);
+        if (!input.length)
+            return null;
+        return await runFfmpeg(input, gifFilter(opts.maxWidth, opts.fps), gifDuration(durationSec, opts.maxDurationSec));
+    }
+    catch (e) {
+        core_1.logger.info(`动图 GIF 转换跳过（源视频下载失败，回退发送原视频）：${e?.message || e}`);
+        return null;
+    }
+}

package/lib/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @sns-parse/ext-gif：视频转 GIF（ffmpeg palettegen/paletteuse）。
+ */
+import { mp4ToGif } from './gif';
+export { mp4ToGif, resolveFfmpeg, gifFilter, gifDuration } from './gif';
+export type { GifOptions } from './gif';
+/** 组装为 core 扩展片段 */
+export declare function gifExtension(): {
+    mp4ToGif: typeof mp4ToGif;
+};

package/lib/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gifDuration = exports.gifFilter = exports.resolveFfmpeg = exports.mp4ToGif = void 0;
+exports.gifExtension = gifExtension;
+/**
+ * @sns-parse/ext-gif：视频转 GIF（ffmpeg palettegen/paletteuse）。
+ */
+const gif_1 = require("./gif");
+var gif_2 = require("./gif");
+Object.defineProperty(exports, "mp4ToGif", { enumerable: true, get: function () { return gif_2.mp4ToGif; } });
+Object.defineProperty(exports, "resolveFfmpeg", { enumerable: true, get: function () { return gif_2.resolveFfmpeg; } });
+Object.defineProperty(exports, "gifFilter", { enumerable: true, get: function () { return gif_2.gifFilter; } });
+Object.defineProperty(exports, "gifDuration", { enumerable: true, get: function () { return gif_2.gifDuration; } });
+/** 组装为 core 扩展片段 */
+function gifExtension() {
+    return { mp4ToGif: gif_1.mp4ToGif };
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@sns-parse/ext-gif",
+  "version": "0.1.0-alpha.1+upstream.1.6.7",
+  "description": "sns-parse 扩展：gif",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": [
+    "lib"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rimraf lib",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@sns-parse/core": "^0.1.0"
+  },
+  "optionalDependencies": {
+    "ffmpeg-static": "^5.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "rimraf": "^5.0.5",
+    "typescript": "^5.3.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sns-parse/extensions.git",
+    "directory": "packages/ext-gif"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}