dsh-ffmpeg 0.3.0 → 0.4.0

package/README.en.md

@@ -1,5 +1,7 @@
 [中文](README.md)
 
+![npm](https://img.shields.io/npm/v/dsh-ffmpeg) ![downloads](https://img.shields.io/npm/dm/dsh-ffmpeg) ![license](https://img.shields.io/github/license/STARDUSTLC666/dsh-ffmpeg) ![stars](https://img.shields.io/github/stars/STARDUSTLC666/dsh-ffmpeg?style=social)
+
 # dsh-ffmpeg
 
 [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
@@ -8,7 +10,7 @@ DSH (DeepSeek Harness) video-processing plugin: seven tools covering probing, cu
 
 ## Compatibility
 
-Verified against `@deepseek-ai/dsh@0.1.1-rc.2` on 2026-08-26. Built for the cordis patch-bundle plugin model (`cordis.patch.yml` + `dsh.bundle.patch`). No runtime imports of `@deepseek-ai/*` internals.
+Verified against `@deepseek-ai/dsh@0.1.2-alpha.2` on 2026-08-31. Built for the cordis patch-bundle plugin model (`cordis.patch.yml` + `dsh.bundle.patch`). No runtime imports of `@deepseek-ai/*` internals.
 
 ## Installation
 
@@ -80,4 +82,4 @@ pnpm test       # build + 57 tests, including a real-ffmpeg end-to-end suite (au
 
 ## License
 
-MIT
+MIT

package/README.md

@@ -2,18 +2,18 @@
 
 # dsh-ffmpeg
 
-> **你的 agent 会剪视频了**：探测/剪辑/拼接/转码/字幕/抽帧/GIF，七个工具一条命令。
+> **你的 agent 会剪视频了**：探测/剪辑/拼接/转码/字幕/抽帧/GIF/变速旋转调音，十个工具一条命令。
 
 ![npm version](https://img.shields.io/npm/v/dsh-ffmpeg?label=npm&color=blue) ![npm downloads](https://img.shields.io/npm/dm/dsh-ffmpeg) ![license](https://img.shields.io/npm/l/dsh-ffmpeg) ![stars](https://img.shields.io/github/stars/STARDUSTLC666/dsh-ffmpeg?style=social)
 
 [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
 
 
-DSH（DeepSeek Harness）视频处理工具插件：七个工具覆盖探测、剪辑、拼接、转码、字幕、提取与 GIF 制作，全部由 ffmpeg/ffprobe 完成。
+DSH（DeepSeek Harness）视频处理工具插件：十个工具：探测、剪辑、拼接、转码、字幕、提取、GIF、抽帧、调整（变速/音量/静音/旋转）与自检，全部由 ffmpeg/ffprobe 完成。
 
 ## 兼容性
 
-在 `@deepseek-ai/dsh@0.1.1-rc.2` 上验证（2026-08-26）。遵循 cordis 组合包补丁模型（`cordis.patch.yml` + `dsh.bundle.patch`），运行时不 import 任何 `@deepseek-ai/*` 内部模块。
+在 `@deepseek-ai/dsh@0.1.2-alpha.2` 上验证（2026-08-31）。遵循 cordis 组合包补丁模型（`cordis.patch.yml` + `dsh.bundle.patch`），运行时不 import 任何 `@deepseek-ai/*` 内部模块。
 
 ## 安装
 
@@ -57,6 +57,9 @@ dsh plugin --profile web remove dsh-ffmpeg
 | `ffmpeg_subtitle` | 字幕烧录（SRT/ASS 硬字幕） | `input`+`subtitle` 必填 |
 | `ffmpeg_extract` | 提取音轨（m4a）/ 抽帧序列 / 单帧 / 字幕流 | `input`+`what` 必填 |
 | `ffmpeg_gif` | 视频转高质量 GIF（两遍调色板） | `input` 必填；`fps`/`width`/`duration` 可选 |
+| `ffmpeg_frames` | 批量抽帧给视觉模型读图（定间隔或指定时间点，PNG/JPG） | `input` 必填；`every`/`times` 二选一 |
+| `ffmpeg_adjust` | 变速（音视频同步）/ 音量 / 静音 / 旋转（竖横屏互转），可组合 | `input` 必填；`speed`/`volume`/`mute`/`rotate` 至少一个 |
+| `ffmpeg_health` | 自检 ffmpeg / ffprobe 可执行文件 | 无 |
 
 ### 示例
 

package/lib/args.d.ts

@@ -87,3 +87,29 @@ export interface GifSpec {
 export declare function gifPaletteArgs(ffmpeg: string, spec: GifSpec): string[];
 /** GIF 第二遍：paletteuse 合成。 */
 export declare function gifUseArgs(ffmpeg: string, spec: GifSpec): string[];
+export type RotateDeg = 90 | 180 | 270;
+export interface AdjustSpec {
+    input: string;
+    output: string;
+    overwrite: boolean;
+    /** 倍速：>1 加速，<1 减速（0.1-100）。 */
+    speed?: number;
+    /** 音量：倍数（如 1.5 / 0.6）或分贝（如 -3dB）。 */
+    volume?: string;
+    mute?: boolean;
+    rotate?: RotateDeg;
+    /** 输入是否含音频流（probe 结果），决定是否构建音频滤镜。 */
+    hasAudio: boolean;
+}
+/**
+ * atempo 单滤镜只接受约 [0.5, 100]，超出范围用多个 atempo 级联
+ * （0.25 → atempo=0.5,atempo=0.5）。
+ */
+export declare function atempoChain(speed: number): string;
+/** 顺时针旋转滤镜：90/270 用 transpose，180 用双翻转。 */
+export declare function rotateFilter(deg: RotateDeg): string;
+/**
+ * 调整：变速（视频 setpts + 音频 atempo）、音量、静音、旋转。
+ * 只静音/调音量（无变速旋转）时视频走流拷贝；动了画面就重编码。
+ */
+export declare function adjustArgs(ffmpeg: string, spec: AdjustSpec): string[];

package/lib/args.js

@@ -111,3 +111,69 @@ export function gifUseArgs(ffmpeg, spec) {
     const filter = 'fps=' + spec.fps + ',scale=' + spec.width + ':-1:flags=lanczos[x];[x][1:v]paletteuse';
     return [ffmpeg, overwriteFlag(spec.overwrite), '-i', spec.input, '-ss', fmtSeconds(spec.start), '-t', fmtSeconds(spec.duration), '-i', spec.palettePath, '-filter_complex', filter, spec.output];
 }
+/**
+ * atempo 单滤镜只接受约 [0.5, 100]，超出范围用多个 atempo 级联
+ * （0.25 → atempo=0.5,atempo=0.5）。
+ */
+export function atempoChain(speed) {
+    const parts = [];
+    let remaining = speed;
+    while (remaining < 0.5) {
+        parts.push('atempo=0.5');
+        remaining /= 0.5;
+    }
+    while (remaining > 100) {
+        parts.push('atempo=100');
+        remaining /= 100;
+    }
+    parts.push('atempo=' + Number(remaining.toFixed(4)));
+    return parts.join(',');
+}
+/** 顺时针旋转滤镜：90/270 用 transpose，180 用双翻转。 */
+export function rotateFilter(deg) {
+    if (deg === 90)
+        return 'transpose=1';
+    if (deg === 270)
+        return 'transpose=2';
+    return 'hflip,vflip';
+}
+/**
+ * 调整：变速（视频 setpts + 音频 atempo）、音量、静音、旋转。
+ * 只静音/调音量（无变速旋转）时视频走流拷贝；动了画面就重编码。
+ */
+export function adjustArgs(ffmpeg, spec) {
+    const parts = [ffmpeg, overwriteFlag(spec.overwrite), '-i', spec.input];
+    const vf = [];
+    const af = [];
+    const audioUsable = spec.hasAudio && spec.mute !== true;
+    if (spec.speed !== undefined) {
+        vf.push('setpts=PTS/' + spec.speed);
+        if (audioUsable)
+            af.push(atempoChain(spec.speed));
+    }
+    if (spec.volume !== undefined && audioUsable)
+        af.push('volume=' + spec.volume);
+    if (spec.rotate !== undefined)
+        vf.push(rotateFilter(spec.rotate));
+    if (vf.length > 0)
+        parts.push('-vf', vf.join(','));
+    if (af.length > 0)
+        parts.push('-af', af.join(','));
+    if (vf.length > 0) {
+        parts.push('-c:v', 'libx264', '-preset', 'veryfast', '-crf', '18', '-pix_fmt', 'yuv420p');
+    }
+    else {
+        parts.push('-c:v', 'copy');
+    }
+    if (spec.mute === true || !spec.hasAudio) {
+        parts.push('-an');
+    }
+    else if (af.length > 0) {
+        parts.push('-c:a', 'aac', '-b:a', '192k');
+    }
+    else {
+        parts.push('-c:a', 'copy');
+    }
+    parts.push('-movflags', '+faststart', spec.output);
+    return parts;
+}

package/lib/tools.d.ts

@@ -1,5 +1,5 @@
 /**
- * 八个面向模型的视频工具：probe / cut / concat / encode / subtitle / extract / gif / frames。
+ * 九个面向模型的视频工具：probe / cut / concat / encode / subtitle / extract / gif / frames / adjust。
  * 直接调用 ctx.tools.register 注册【编译好的 JSON Schema】参数与 canonical 输出。
  *
  * @module dsh-ffmpeg/tools

package/lib/tools.js

@@ -1,5 +1,5 @@
 /**
- * 八个面向模型的视频工具：probe / cut / concat / encode / subtitle / extract / gif / frames。
+ * 九个面向模型的视频工具：probe / cut / concat / encode / subtitle / extract / gif / frames / adjust。
  * 直接调用 ctx.tools.register 注册【编译好的 JSON Schema】参数与 canonical 输出。
  *
  * @module dsh-ffmpeg/tools
@@ -8,7 +8,7 @@ import { mkdirSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
 import { randomUUID } from 'node:crypto';
 import { tmpdir } from 'node:os';
 import { basename, dirname, extname, join } from 'node:path';
-import { concatArgs, concatListContent, cutArgs, ENCODE_PRESETS, encodeArgs, extractArgs, fmtSeconds, frameAtArgs, gifPaletteArgs, gifUseArgs, probeArgs, subtitleArgs, } from './args.js';
+import { adjustArgs, concatArgs, concatListContent, cutArgs, ENCODE_PRESETS, encodeArgs, extractArgs, fmtSeconds, frameAtArgs, gifPaletteArgs, gifUseArgs, probeArgs, subtitleArgs, } from './args.js';
 import { parseProbeJson } from './ffprobe.js';
 import { assertInputFile, resolveOutputPath, sanitizeName } from './paths.js';
 import { parseTimeArg } from './config.js';
@@ -80,12 +80,12 @@ function buildTextRenderer(lines) {
 const baseSchema = { type: 'object', additionalProperties: true };
 const videoStreamSchema = {
     type: 'object',
-    properties: { width: { type: 'number' }, height: { type: 'number' }, fps: { type: 'number' }, codec: { type: 'string' }, durationSeconds: { type: 'number' }, bitrate: { type: 'number' } },
+    properties: { width: { type: 'number' }, height: { type: 'number' }, fps: { oneOf: [{ type: 'number' }, { type: 'null' }] }, codec: { type: 'string' }, durationSeconds: { oneOf: [{ type: 'number' }, { type: 'null' }] }, bitrate: { oneOf: [{ type: 'number' }, { type: 'null' }] } },
     additionalProperties: true,
 };
 const audioStreamSchema = {
     type: 'object',
-    properties: { codec: { type: 'string' }, sampleRate: { type: 'number' }, channels: { type: 'number' }, durationSeconds: { type: 'number' } },
+    properties: { codec: { type: 'string' }, sampleRate: { oneOf: [{ type: 'number' }, { type: 'null' }] }, channels: { oneOf: [{ type: 'number' }, { type: 'null' }] }, durationSeconds: { oneOf: [{ type: 'number' }, { type: 'null' }] } },
     additionalProperties: true,
 };
 const subtitleStreamSchema = {
@@ -100,9 +100,9 @@ const probeSchema = {
         input: { type: 'string' },
         summary: { type: 'string' },
         formatName: { type: 'string' },
-        durationSeconds: { type: 'number' },
-        sizeBytes: { type: 'number' },
-        bitrate: { type: 'number' },
+        durationSeconds: { oneOf: [{ type: 'number' }, { type: 'null' }] },
+        sizeBytes: { oneOf: [{ type: 'number' }, { type: 'null' }] },
+        bitrate: { oneOf: [{ type: 'number' }, { type: 'null' }] },
         video: videoStreamSchema,
         videos: { type: 'array', items: videoStreamSchema },
         audio: { type: 'array', items: audioStreamSchema },
@@ -507,6 +507,64 @@ export function buildFfmpegTools(config, runner) {
         },
         timeoutMs: timeout,
     };
+    const adjust = {
+        name: 'ffmpeg_adjust',
+        description: '调整媒体：变速（speed 倍率，>1 加速 <1 减速，音视频同步变速）、音量（volume 倍数如 1.5 或分贝如 -3dB）、静音（mute）、顺时针旋转（rotate 90/180/270，竖横屏互转）。可组合使用。只静音/调音量时视频走流拷贝（快）；变速/旋转会重编码。四个操作至少给一个。',
+        parameters: compileParameters({
+            input: { type: 'string', required: true, description: '输入文件（必填）。' },
+            speed: { type: 'number', description: '倍速 0.1-100：2 为两倍速，0.5 为半速（可选）。' },
+            volume: { type: 'string', description: '音量：倍数如 1.5 / 0.6，或分贝如 -3dB / +2dB（可选）。' },
+            mute: { type: 'boolean', description: 'true 时移除音轨（可选）。' },
+            rotate: { type: 'integer', description: '顺时针旋转角度：90 / 180 / 270（可选）。' },
+            output: { type: 'string', description: '输出路径（可选，默认输入同目录加 .adjust 后缀）。' },
+        }),
+        output: {
+            schema: produceSchema,
+            render: buildTextRenderer((_args, value) => {
+                const rec = asRecord(value);
+                const ops = Array.isArray(rec.ops) ? rec.ops.join('，') : '';
+                return ['调整完成：' + rec.output + '（' + ops + '）'];
+            }),
+        },
+        async execute(rawArgs) {
+            const args = asRecord(rawArgs);
+            const input = assertInputFile(requiredString(args, 'input', '输入文件'));
+            const speed = optionalNumber(args, 'speed');
+            if (speed !== undefined && (speed < 0.1 || speed > 100))
+                throw new Error('speed 必须在 0.1-100 之间（当前：' + speed + '）。');
+            const volume = optionalString(args, 'volume');
+            if (volume !== undefined && !/^\d+(\.\d+)?$|^-?\d+(\.\d+)?dB$/.test(volume)) {
+                throw new Error('volume 格式必须是倍数（如 1.5）或分贝（如 -3dB）。');
+            }
+            const mute = args.mute === true;
+            let rotate;
+            const rotateRaw = args.rotate;
+            if (rotateRaw !== undefined) {
+                if (rotateRaw !== 90 && rotateRaw !== 180 && rotateRaw !== 270)
+                    throw new Error('rotate 只支持 90 / 180 / 270。');
+                rotate = rotateRaw;
+            }
+            if (speed === undefined && volume === undefined && !mute && rotate === undefined) {
+                throw new Error('speed / volume / mute / rotate 至少提供一个。');
+            }
+            // 先探测：确认有没有音轨，避免对无声文件构建音频滤镜报错
+            const probeResult = await runChecked(runner, probeArgs(cfg.ffprobePath, input), Math.min(timeout, 60000), 'ffprobe');
+            const hasAudio = parseProbeJson(probeResult.stdout).audio.length > 0;
+            const output = resolveOutputPath(input, optionalString(args, 'output'), '.adjust', extname(input) || '.mp4', cfg.overwrite);
+            await runChecked(runner, adjustArgs(cfg.ffmpegPath, { input, output, overwrite: cfg.overwrite, speed, volume, mute, rotate, hasAudio }), timeout, 'ffmpeg 调整');
+            const ops = [];
+            if (speed !== undefined)
+                ops.push('倍速 x' + speed);
+            if (volume !== undefined)
+                ops.push('音量 ' + volume);
+            if (mute)
+                ops.push('静音');
+            if (rotate !== undefined)
+                ops.push('旋转 ' + rotate + '°');
+            return { output, ops, hasAudio };
+        },
+        timeoutMs: timeout,
+    };
     const health = {
         name: 'ffmpeg_health',
         description: 'dsh-ffmpeg 自检：验证 ffmpeg / ffprobe 可执行文件是否可用（执行 -version）。遇到问题时先运行本工具定位。',
@@ -548,5 +606,5 @@ export function buildFfmpegTools(config, runner) {
         },
         timeoutMs: 30000,
     };
-    return [probe, cut, concat, encode, subtitle, extract, gif, frames, health];
+    return [probe, cut, concat, encode, subtitle, extract, gif, frames, adjust, health];
 }

package/package.json

@@ -1,60 +1,60 @@
-{
-  "name": "dsh-ffmpeg",
-  "version": "0.3.0",
-  "description": "DSH 视频处理工具插件：ffmpeg_probe/cut/concat/encode/subtitle/extract/gif 七工具，进程走官方 subprocess 服务，超时树级终止、环境变量路径回退与多视频流探测，零运行时依赖（ffmpeg 本体除外）。",
-  "type": "module",
-  "main": "lib/index.js",
-  "types": "lib/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./lib/index.d.ts",
-      "default": "./lib/index.js"
-    },
-    "./cordis.patch.yml": "./cordis.patch.yml",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "lib",
-    "cordis.patch.yml",
-    "README.md",
-    "README.en.md"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "pnpm run build && node --test \"test/*.test.mjs\"",
-    "prepublishOnly": "pnpm run build"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    }
-  },
-  "keywords": [
-    "dsh",
-    "deepseek-harness",
-    "plugin",
-    "ffmpeg",
-    "video",
-    "media",
-    "dsh-plugin"
-  ],
-  "license": "MIT",
-  "engines": {
-    "node": ">=22"
-  },
-  "devDependencies": {
-    "@types/node": "^24.0.0",
-    "typescript": "^5.6.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/STARDUSTLC666/dsh-ffmpeg.git"
-  },
-  "bugs": {
-    "url": "https://github.com/STARDUSTLC666/dsh-ffmpeg/issues"
-  },
-  "homepage": "https://github.com/STARDUSTLC666/dsh-ffmpeg#readme",
-  "author": "stardustlc",
-  "packageManager": "pnpm@11.7.0"
-}
+{
+  "name": "dsh-ffmpeg",
+  "version": "0.4.0",
+  "description": "DSH 视频处理工具插件：ffmpeg_probe/cut/concat/encode/subtitle/extract/gif 七工具，进程走官方 subprocess 服务，超时树级终止、环境变量路径回退与多视频流探测，零运行时依赖（ffmpeg 本体除外）。",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "README.en.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "pnpm run build && node --test \"test/*.test.mjs\"",
+    "prepublishOnly": "pnpm run build"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "plugin",
+    "ffmpeg",
+    "video",
+    "media",
+    "dsh-plugin"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.6.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/STARDUSTLC666/dsh-ffmpeg.git"
+  },
+  "bugs": {
+    "url": "https://github.com/STARDUSTLC666/dsh-ffmpeg/issues"
+  },
+  "homepage": "https://github.com/STARDUSTLC666/dsh-ffmpeg#readme",
+  "author": "stardustlc",
+  "packageManager": "pnpm@11.7.0"
+}