dsh-ffmpeg 0.4.0 → 0.4.1

package/README.en.md

@@ -10,7 +10,7 @@ DSH (DeepSeek Harness) video-processing plugin: seven tools covering probing, cu
 
 ## Compatibility
 
-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.
+Verified against the official `@deepseek-ai/dsh@0.1.3-alpha.2` on 2026-09-08, including an 18-component co-load and the full tool registration/invocation contract. Built for the cordis patch-bundle plugin model (`cordis.patch.yml` + `dsh.bundle.patch`). No runtime imports of `@deepseek-ai/*` internals.
 
 ## Installation
 
@@ -77,7 +77,7 @@ ffmpeg_gif { input: E:\videos\raw.mp4, duration: 3, width: 480 }
 
 ```bash
 pnpm install
-pnpm test       # build + 57 tests, including a real-ffmpeg end-to-end suite (auto-skipped without ffmpeg)
+pnpm test       # build + 83 tests, including a real-ffmpeg end-to-end suite (auto-skipped without ffmpeg)
 ```
 
 ## License

package/README.md

@@ -13,7 +13,7 @@ DSH（DeepSeek Harness）视频处理工具插件：十个工具：探测、剪
 
 ## 兼容性
 
-在 `@deepseek-ai/dsh@0.1.2-alpha.2` 上验证（2026-08-31）。遵循 cordis 组合包补丁模型（`cordis.patch.yml` + `dsh.bundle.patch`），运行时不 import 任何 `@deepseek-ai/*` 内部模块。
+已在官方 `@deepseek-ai/dsh@0.1.3-alpha.2` 下验证（2026-09-08）：18 个组件同载，工具注册与调用契约全部通过。遵循 cordis 组合包补丁模型（`cordis.patch.yml` + `dsh.bundle.patch`），运行时不 import 任何 `@deepseek-ai/*` 内部模块。
 
 ## 安装
 
@@ -83,9 +83,9 @@ ffmpeg_gif { input: E:\videos\raw.mp4, duration: 3, width: 480 }
 
 ```bash
 pnpm install
-pnpm test       # 构建 + 57 个测试（含真实 ffmpeg 端到端集成，缺 ffmpeg 自动跳过）
+pnpm test       # 构建 + 83 个测试（含真实 ffmpeg 端到端集成，缺 ffmpeg 自动跳过）
 ```
 
 ## License
 
-MIT
+MIT

package/lib/args.js

@@ -48,7 +48,12 @@ export const ENCODE_PRESETS = ['bilibili-1080p', 'bilibili-4k', 'vertical-1080p'
 const PRESET_TABLE = {
     'bilibili-1080p': { crf: 20, maxrate: '6000k', bufsize: '12000k' },
     'bilibili-4k': { crf: 18, maxrate: '20000k', bufsize: '40000k' },
-    'vertical-1080p': { crf: 20, maxrate: '6000k', bufsize: '12000k', vf: 'scale=-2:1920' },
+    'vertical-1080p': {
+        crf: 20,
+        maxrate: '6000k',
+        bufsize: '12000k',
+        vf: 'scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2,setsar=1',
+    },
     'web-720p': { crf: 23, maxrate: '2800k', bufsize: '5600k', vf: 'scale=-2:720' },
 };
 /** 转码：预设 + 可选的 crf/fps/scale 覆盖。 */

package/lib/config.js

@@ -12,22 +12,34 @@ const DEFAULT_GRACE_MS = 15000;
  * @throws 配置值非法时抛出中文错误。
  */
 export function resolveConfig(config, env = process.env) {
+    if (config !== undefined && config !== null && (typeof config !== 'object' || Array.isArray(config))) {
+        throw new Error('dsh-ffmpeg 配置必须是对象。');
+    }
     const cfg = config ?? {};
-    const ffmpegPath = typeof cfg.ffmpegPath === 'string' && cfg.ffmpegPath.trim() !== '' ? cfg.ffmpegPath.trim() : (env.DSH_FFMPEG_PATH?.trim() || 'ffmpeg');
-    const ffprobePath = typeof cfg.ffprobePath === 'string' && cfg.ffprobePath.trim() !== '' ? cfg.ffprobePath.trim() : (env.DSH_FFPROBE_PATH?.trim() || 'ffprobe');
+    if (cfg.ffmpegPath !== undefined && (typeof cfg.ffmpegPath !== 'string' || cfg.ffmpegPath.trim() === '')) {
+        throw new Error('ffmpegPath 必须是非空字符串。');
+    }
+    if (cfg.ffprobePath !== undefined && (typeof cfg.ffprobePath !== 'string' || cfg.ffprobePath.trim() === '')) {
+        throw new Error('ffprobePath 必须是非空字符串。');
+    }
+    if (cfg.overwrite !== undefined && typeof cfg.overwrite !== 'boolean') {
+        throw new Error('overwrite 必须是布尔值。');
+    }
+    const ffmpegPath = cfg.ffmpegPath?.trim() || env.DSH_FFMPEG_PATH?.trim() || 'ffmpeg';
+    const ffprobePath = cfg.ffprobePath?.trim() || env.DSH_FFPROBE_PATH?.trim() || 'ffprobe';
     let timeoutMs = DEFAULT_TIMEOUT_MS;
     if (cfg.timeoutMs !== undefined) {
-        if (typeof cfg.timeoutMs !== 'number' || !Number.isFinite(cfg.timeoutMs) || cfg.timeoutMs <= 0) {
-            throw new Error('timeoutMs 必须是大于 0 的数字（毫秒），例如 300000。');
+        if (typeof cfg.timeoutMs !== 'number' || !Number.isInteger(cfg.timeoutMs) || cfg.timeoutMs < 10000 || cfg.timeoutMs > 2 * 60 * 60 * 1000) {
+            throw new Error('timeoutMs 必须是 10000–7200000 的整数（毫秒）。');
         }
-        timeoutMs = Math.min(2 * 60 * 60 * 1000, Math.max(10000, Math.round(cfg.timeoutMs)));
+        timeoutMs = cfg.timeoutMs;
     }
     let graceMs = DEFAULT_GRACE_MS;
     if (cfg.graceMs !== undefined) {
-        if (typeof cfg.graceMs !== 'number' || !Number.isFinite(cfg.graceMs) || cfg.graceMs <= 0) {
-            throw new Error('graceMs 必须是大于 0 的数字（毫秒），例如 15000。');
+        if (typeof cfg.graceMs !== 'number' || !Number.isInteger(cfg.graceMs) || cfg.graceMs < 1000 || cfg.graceMs > 120000) {
+            throw new Error('graceMs 必须是 1000–120000 的整数（毫秒）。');
         }
-        graceMs = Math.min(120000, Math.max(1000, Math.round(cfg.graceMs)));
+        graceMs = cfg.graceMs;
     }
     const overwrite = cfg.overwrite === true;
     return { ffmpegPath, ffprobePath, timeoutMs, graceMs, overwrite };

package/lib/exec.d.ts

@@ -15,6 +15,7 @@ export interface RunResult {
 export interface ProcessRunner {
     run(argv: readonly string[], options?: {
         timeoutMs?: number;
+        signal?: AbortSignal;
     }): Promise<RunResult>;
 }
 /** 工具所需的 ctx.subprocess 最小面。 */

package/lib/exec.js

@@ -15,6 +15,9 @@ export function createSubprocessRunner(spawn, graceMs, defaultTimeoutMs) {
             const timeoutMs = options?.timeoutMs ?? defaultTimeoutMs;
             const controller = new AbortController();
             const timer = setTimeout(() => controller.abort(new Error('ffmpeg operation timed out')), timeoutMs);
+            const signal = options?.signal === undefined
+                ? controller.signal
+                : AbortSignal.any([options.signal, controller.signal]);
             let handle;
             try {
                 handle = spawn({
@@ -26,7 +29,7 @@ export function createSubprocessRunner(spawn, graceMs, defaultTimeoutMs) {
                         stderr: { maxBytes: COLLECT_BYTES },
                     },
                     graceMs,
-                    signal: controller.signal,
+                    signal,
                 });
                 const outcome = await handle.done;
                 const stdout = handle.collected.stdout?.readFrom(0).text ?? '';

package/lib/index.js

@@ -20,14 +20,7 @@ export const inject = ['subprocess', 'tools'];
  * @param config - 插件配置（可缺省）。
  */
 export function apply(ctx, config) {
-    let cfg;
-    try {
-        cfg = resolveConfig(config);
-    }
-    catch (error) {
-        console.warn('[dsh-ffmpeg] ' + (error instanceof Error ? error.message : String(error)));
-        cfg = resolveConfig(null);
-    }
+    const cfg = resolveConfig(config);
     const runner = createSubprocessRunner(ctx.subprocess.spawn, cfg.graceMs, cfg.timeoutMs);
     const disposers = [];
     for (const definition of buildFfmpegTools(cfg, runner)) {

package/lib/tools.d.ts

@@ -12,6 +12,10 @@ export interface ContentBlock {
     type: 'text';
     text: string;
 }
+/** v0.1.2-rc.1 工具执行上下文中本插件需要的公共最小面。 */
+export interface FfmpegToolRunContext {
+    readonly signal: AbortSignal;
+}
 /** 注册给 ctx.tools.register 的原始工具定义。 */
 export interface FfmpegToolDefinition {
     name: string;
@@ -25,7 +29,7 @@ export interface FfmpegToolDefinition {
         schema: Record<string, unknown>;
         render(args: unknown, value: unknown): ContentBlock[];
     };
-    execute(args: unknown, exec: unknown): Promise<unknown>;
+    execute(args: unknown, exec: FfmpegToolRunContext): Promise<unknown>;
     timeoutMs?: number;
 }
 /** 生成一行人类可读的媒体摘要：容器、时长、主视频、帧率、码率、体积。 */

package/lib/tools.js

@@ -4,7 +4,7 @@
  *
  * @module dsh-ffmpeg/tools
  */
-import { mkdirSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
+import { mkdirSync, mkdtempSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
 import { randomUUID } from 'node:crypto';
 import { tmpdir } from 'node:os';
 import { basename, dirname, extname, join } from 'node:path';
@@ -65,8 +65,8 @@ function stringArray(args, key) {
     return value.filter((item) => typeof item === 'string' && item.trim() !== '').map((item) => item.trim());
 }
 /** 执行并检查退出码；非零抛中文错误（附 stderr 尾部）。 */
-async function runChecked(runner, argv, timeoutMs, label) {
-    const result = await runner.run(argv, { timeoutMs });
+async function runChecked(runner, argv, timeoutMs, label, signal) {
+    const result = await runner.run(argv, { timeoutMs, ...(signal === undefined ? {} : { signal }) });
     if (result.exitCode !== 0) {
         const tail = result.stderr.trim().split(/\r?\n/).slice(-6).join(' | ');
         throw new Error(label + '失败（退出码 ' + String(result.exitCode ?? 'null') + (result.signal ? '，信号 ' + result.signal : '') + '）：' + (tail || '无错误输出'));
@@ -90,7 +90,7 @@ const audioStreamSchema = {
 };
 const subtitleStreamSchema = {
     type: 'object',
-    properties: { codec: { type: 'string' }, language: { type: 'string' } },
+    properties: { codec: { type: 'string' }, language: { oneOf: [{ type: 'string' }, { type: 'null' }] } },
     additionalProperties: true,
 };
 const probeSchema = {
@@ -103,7 +103,7 @@ const probeSchema = {
         durationSeconds: { oneOf: [{ type: 'number' }, { type: 'null' }] },
         sizeBytes: { oneOf: [{ type: 'number' }, { type: 'null' }] },
         bitrate: { oneOf: [{ type: 'number' }, { type: 'null' }] },
-        video: videoStreamSchema,
+        video: { oneOf: [videoStreamSchema, { type: 'null' }] },
         videos: { type: 'array', items: videoStreamSchema },
         audio: { type: 'array', items: audioStreamSchema },
         subtitles: { type: 'array', items: subtitleStreamSchema },
@@ -177,10 +177,10 @@ export function buildFfmpegTools(config, runner) {
                 return lines;
             }),
         },
-        async execute(rawArgs) {
+        async execute(rawArgs, exec) {
             const args = asRecord(rawArgs);
             const input = assertInputFile(requiredString(args, 'input', '输入文件'));
-            const result = await runChecked(runner, probeArgs(cfg.ffprobePath, input), Math.min(timeout, 60000), 'ffprobe');
+            const result = await runChecked(runner, probeArgs(cfg.ffprobePath, input), Math.min(timeout, 60000), 'ffprobe', exec?.signal);
             const media = parseProbeJson(result.stdout);
             return { ok: true, input, summary: buildProbeSummary(media), ...media };
         },
@@ -204,7 +204,7 @@ export function buildFfmpegTools(config, runner) {
                 return ['剪辑完成：' + rec.output + '（' + fmtSeconds(Number(rec.duration ?? 0)) + ' 秒' + (rec.reencode === true ? '，已重编码' : '，流拷贝') + '）'];
             }),
         },
-        async execute(rawArgs) {
+        async execute(rawArgs, exec) {
             const args = asRecord(rawArgs);
             const input = assertInputFile(requiredString(args, 'input', '输入文件'));
             const start = optionalTime(args, 'start') ?? 0;
@@ -222,7 +222,7 @@ export function buildFfmpegTools(config, runner) {
             }
             const reencode = args.reencode === true;
             const output = resolveOutputPath(input, optionalString(args, 'output'), '.cut', extname(input) || '.mp4', cfg.overwrite);
-            await runChecked(runner, cutArgs(cfg.ffmpegPath, { input, start, duration, output, overwrite: cfg.overwrite, reencode }), timeout, 'ffmpeg 剪辑');
+            await runChecked(runner, cutArgs(cfg.ffmpegPath, { input, start, duration, output, overwrite: cfg.overwrite, reencode }), timeout, 'ffmpeg 剪辑', exec?.signal);
             return { output, start, duration, reencode };
         },
         timeoutMs: timeout,
@@ -242,7 +242,7 @@ export function buildFfmpegTools(config, runner) {
                 return ['拼接完成：' + rec.output + '（' + rec.count + ' 个片段' + (rec.reencode === true ? '，已重编码' : '，流拷贝') + '）'];
             }),
         },
-        async execute(rawArgs) {
+        async execute(rawArgs, exec) {
             const args = asRecord(rawArgs);
             const inputs = stringArray(args, 'inputs');
             if (inputs.length < 2)
@@ -257,14 +257,14 @@ export function buildFfmpegTools(config, runner) {
                 const listPath = join(tmpdir(), 'dsh-ffmpeg-concat-' + Date.now() + '-' + randomUUID().slice(0, 8) + '.txt');
                 writeFileSync(listPath, concatListContent(absolute), 'utf8');
                 try {
-                    await runChecked(runner, concatArgs(cfg.ffmpegPath, { inputs: absolute, listFilePath: listPath, output, overwrite: cfg.overwrite, reencode: false }), timeout, 'ffmpeg 拼接');
+                    await runChecked(runner, concatArgs(cfg.ffmpegPath, { inputs: absolute, listFilePath: listPath, output, overwrite: cfg.overwrite, reencode: false }), timeout, 'ffmpeg 拼接', exec?.signal);
                 }
                 finally {
                     rmSync(listPath, { force: true });
                 }
             }
             else {
-                await runChecked(runner, concatArgs(cfg.ffmpegPath, { inputs: absolute, output, overwrite: cfg.overwrite, reencode: true }), timeout, 'ffmpeg 拼接');
+                await runChecked(runner, concatArgs(cfg.ffmpegPath, { inputs: absolute, output, overwrite: cfg.overwrite, reencode: true }), timeout, 'ffmpeg 拼接', exec?.signal);
             }
             return { output, count: absolute.length, reencode };
         },
@@ -288,7 +288,7 @@ export function buildFfmpegTools(config, runner) {
                 return ['转码完成：' + rec.output + '（预设 ' + rec.preset + '，crf=' + rec.crf + '）'];
             }),
         },
-        async execute(rawArgs) {
+        async execute(rawArgs, exec) {
             const args = asRecord(rawArgs);
             const input = assertInputFile(requiredString(args, 'input', '输入文件'));
             const presetRaw = optionalString(args, 'preset') ?? 'bilibili-1080p';
@@ -318,7 +318,7 @@ export function buildFfmpegTools(config, runner) {
                 scale = scaleRaw;
             }
             const output = resolveOutputPath(input, optionalString(args, 'output'), '.encoded', extname(input) || '.mp4', cfg.overwrite);
-            await runChecked(runner, encodeArgs(cfg.ffmpegPath, { input, output, preset, crf, fps, scale, overwrite: cfg.overwrite }), timeout, 'ffmpeg 转码');
+            await runChecked(runner, encodeArgs(cfg.ffmpegPath, { input, output, preset, crf, fps, scale, overwrite: cfg.overwrite }), timeout, 'ffmpeg 转码', exec?.signal);
             return { output, preset, crf: crf ?? 'preset', fps: fps ?? null, scale: scale ?? null };
         },
         timeoutMs: timeout,
@@ -338,12 +338,12 @@ export function buildFfmpegTools(config, runner) {
                 return ['字幕烧录完成：' + rec.output + '（硬字幕）'];
             }),
         },
-        async execute(rawArgs) {
+        async execute(rawArgs, exec) {
             const args = asRecord(rawArgs);
             const input = assertInputFile(requiredString(args, 'input', '输入视频'));
             const subtitlePath = assertInputFile(requiredString(args, 'subtitle', '字幕文件'));
             const output = resolveOutputPath(input, optionalString(args, 'output'), '.sub', extname(input) || '.mp4', cfg.overwrite);
-            await runChecked(runner, subtitleArgs(cfg.ffmpegPath, { input, subtitle: subtitlePath, output, overwrite: cfg.overwrite }), timeout, 'ffmpeg 字幕');
+            await runChecked(runner, subtitleArgs(cfg.ffmpegPath, { input, subtitle: subtitlePath, output, overwrite: cfg.overwrite }), timeout, 'ffmpeg 字幕', exec?.signal);
             return { output, mode: 'burn' };
         },
         timeoutMs: timeout,
@@ -367,7 +367,7 @@ export function buildFfmpegTools(config, runner) {
                 return ['提取完成（' + rec.what + '）：' + rec.output];
             }),
         },
-        async execute(rawArgs) {
+        async execute(rawArgs, exec) {
             const args = asRecord(rawArgs);
             const input = assertInputFile(requiredString(args, 'input', '输入文件'));
             const what = requiredString(args, 'what', '提取内容');
@@ -403,7 +403,7 @@ export function buildFfmpegTools(config, runner) {
                     output = join(dirname(input), sanitizeName(basename(input, extname(input))) + '-%03d.png');
                 }
             }
-            await runChecked(runner, extractArgs(cfg.ffmpegPath, { input, what: what, output, overwrite: cfg.overwrite, start, duration, fps, streamIndex }), timeout, 'ffmpeg 提取');
+            await runChecked(runner, extractArgs(cfg.ffmpegPath, { input, what: what, output, overwrite: cfg.overwrite, start, duration, fps, streamIndex }), timeout, 'ffmpeg 提取', exec?.signal);
             return { output, what, start: start ?? null, duration: duration ?? null, fps: fps ?? null, streamIndex };
         },
         timeoutMs: timeout,
@@ -426,7 +426,7 @@ export function buildFfmpegTools(config, runner) {
                 return ['GIF 生成完成：' + rec.output + '（' + rec.width + 'px，' + rec.fps + 'fps，' + fmtSeconds(Number(rec.duration ?? 0)) + ' 秒）'];
             }),
         },
-        async execute(rawArgs) {
+        async execute(rawArgs, exec) {
             const args = asRecord(rawArgs);
             const input = assertInputFile(requiredString(args, 'input', '输入视频'));
             const start = optionalTime(args, 'start') ?? 0;
@@ -438,14 +438,17 @@ export function buildFfmpegTools(config, runner) {
             const widthRaw = args.width;
             const width = typeof widthRaw === 'number' && Number.isInteger(widthRaw) ? Math.min(1280, Math.max(64, widthRaw)) : 480;
             const output = resolveOutputPath(input, optionalString(args, 'output'), '.gif', '.gif', cfg.overwrite);
-            const palettePath = output + '.palette.png';
+            // 调色板属于内部临时产物，不能借用用户输出旁的可预测路径；否则 -y 与
+            // finally 清理都可能覆盖/删除用户原有的 <output>.palette.png。
+            const paletteDir = mkdtempSync(join(tmpdir(), 'dsh-ffmpeg-gif-'));
+            const palettePath = join(paletteDir, 'palette.png');
             const spec = { input, output, palettePath, overwrite: cfg.overwrite, start, duration, fps, width };
             try {
-                await runChecked(runner, gifPaletteArgs(cfg.ffmpegPath, spec), timeout, 'ffmpeg GIF 调色板');
-                await runChecked(runner, gifUseArgs(cfg.ffmpegPath, spec), timeout, 'ffmpeg GIF 合成');
+                await runChecked(runner, gifPaletteArgs(cfg.ffmpegPath, spec), timeout, 'ffmpeg GIF 调色板', exec?.signal);
+                await runChecked(runner, gifUseArgs(cfg.ffmpegPath, spec), timeout, 'ffmpeg GIF 合成', exec?.signal);
             }
             finally {
-                rmSync(palettePath, { force: true });
+                rmSync(paletteDir, { recursive: true, force: true });
             }
             return { output, start, duration, fps, width };
         },
@@ -469,7 +472,7 @@ export function buildFfmpegTools(config, runner) {
                 return ['抽帧完成：共 ' + rec.count + ' 张，输出目录 ' + rec.outputDir + (rec.mode === 'times' ? '（指定时间点）' : '（每 ' + rec.every + ' 秒一帧）')];
             }),
         },
-        async execute(rawArgs) {
+        async execute(rawArgs, exec) {
             const args = asRecord(rawArgs);
             const input = assertInputFile(requiredString(args, 'input', '输入文件'));
             const formatRaw = optionalString(args, 'format')?.toLowerCase() ?? 'png';
@@ -488,7 +491,7 @@ export function buildFfmpegTools(config, runner) {
                     if (at === null)
                         throw new Error('times 里第 ' + (i + 1) + ' 个时间点非法：' + raw + '（请用秒数或 HH:MM:SS.mmm）。');
                     const target = join(outDir, 'frame-' + String(i + 1).padStart(3, '0') + ext);
-                    await runChecked(runner, frameAtArgs(cfg.ffmpegPath, { input, time: at, output: target, overwrite: cfg.overwrite }), timeout, 'ffmpeg 定点抽帧');
+                    await runChecked(runner, frameAtArgs(cfg.ffmpegPath, { input, time: at, output: target, overwrite: cfg.overwrite }), timeout, 'ffmpeg 定点抽帧', exec?.signal);
                     i++;
                 }
             }
@@ -499,7 +502,7 @@ export function buildFfmpegTools(config, runner) {
                 const maxFramesRaw = args.maxFrames;
                 const maxFrames = typeof maxFramesRaw === 'number' && Number.isInteger(maxFramesRaw) ? Math.min(500, Math.max(1, maxFramesRaw)) : 100;
                 const pattern = join(outDir, 'frame-%03d' + ext);
-                await runChecked(runner, extractArgs(cfg.ffmpegPath, { input, what: 'frames', output: pattern, overwrite: cfg.overwrite, fps: 1 / every, streamIndex: 0, maxFrames }), timeout, 'ffmpeg 抽帧');
+                await runChecked(runner, extractArgs(cfg.ffmpegPath, { input, what: 'frames', output: pattern, overwrite: cfg.overwrite, fps: 1 / every, streamIndex: 0, maxFrames }), timeout, 'ffmpeg 抽帧', exec?.signal);
             }
             const files = readdirSync(outDir).filter((f) => f.startsWith('frame-') && f.endsWith(ext)).sort();
             const every = optionalNumber(args, 'every') ?? 1;
@@ -526,7 +529,7 @@ export function buildFfmpegTools(config, runner) {
                 return ['调整完成：' + rec.output + '（' + ops + '）'];
             }),
         },
-        async execute(rawArgs) {
+        async execute(rawArgs, exec) {
             const args = asRecord(rawArgs);
             const input = assertInputFile(requiredString(args, 'input', '输入文件'));
             const speed = optionalNumber(args, 'speed');
@@ -548,10 +551,10 @@ export function buildFfmpegTools(config, runner) {
                 throw new Error('speed / volume / mute / rotate 至少提供一个。');
             }
             // 先探测：确认有没有音轨，避免对无声文件构建音频滤镜报错
-            const probeResult = await runChecked(runner, probeArgs(cfg.ffprobePath, input), Math.min(timeout, 60000), 'ffprobe');
+            const probeResult = await runChecked(runner, probeArgs(cfg.ffprobePath, input), Math.min(timeout, 60000), 'ffprobe', exec?.signal);
             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 调整');
+            await runChecked(runner, adjustArgs(cfg.ffmpegPath, { input, output, overwrite: cfg.overwrite, speed, volume, mute, rotate, hasAudio }), timeout, 'ffmpeg 调整', exec?.signal);
             const ops = [];
             if (speed !== undefined)
                 ops.push('倍速 x' + speed);
@@ -582,12 +585,12 @@ export function buildFfmpegTools(config, runner) {
                 return lines;
             }),
         },
-        async execute() {
+        async execute(_rawArgs, exec) {
             const checks = [];
             let ok = true;
             for (const [label, bin] of [['ffmpeg', cfg.ffmpegPath], ['ffprobe', cfg.ffprobePath]]) {
                 try {
-                    const result = await runner.run([bin, '-version'], { timeoutMs: 15000 });
+                    const result = await runner.run([bin, '-version'], { timeoutMs: 15000, ...(exec?.signal === undefined ? {} : { signal: exec.signal }) });
                     const firstLine = result.stdout.split(/\r?\n/)[0]?.trim() ?? '';
                     if (result.exitCode === 0) {
                         checks.push({ name: label, ok: true, path: bin, version: firstLine });
@@ -598,6 +601,8 @@ export function buildFfmpegTools(config, runner) {
                     }
                 }
                 catch (error) {
+                    if (exec?.signal.aborted === true)
+                        throw error;
                     ok = false;
                     checks.push({ name: label, ok: false, path: bin, detail: error instanceof Error ? error.message : String(error) });
                 }

package/package.json

@@ -1,60 +1,60 @@
-{
-  "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"
-}
+{
+  "name": "dsh-ffmpeg",
+  "version": "0.4.1",
+  "description": "DSH 视频处理工具插件：ffmpeg_probe/cut/concat/encode/subtitle/extract/gif/frames/adjust/health 十工具（探测摘要、批量抽帧、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"
+}