@lzwme/m3u8-dl 1.5.0 → 1.6.0-0

package/cjs/lib/i18n.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * Shared i18n utility for backend (CLI, SDK, Server)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LANG_CODES = void 0;
+exports.detectLanguage = detectLanguage;
+exports.setLanguage = setLanguage;
+exports.getLanguage = getLanguage;
+exports.getLang = getLang;
+exports.t = t;
+exports.LANG_CODES = new Set(['zh', 'en']);
+let globalLang = null;
+/**
+ * Detect language from OS or environment
+ */
+function detectLanguage() {
+    // Check environment variable first
+    const envLang = process.env.M3U8DL_LANG || process.env.LANG;
+    if (envLang) {
+        const langCode = envLang.toLowerCase().split('-')[0].split('_')[0];
+        if (exports.LANG_CODES.has(langCode)) {
+            return langCode;
+        }
+    }
+    // Try to detect from OS locale
+    try {
+        const osLocale = Intl.DateTimeFormat().resolvedOptions().locale;
+        const langCode = osLocale.toLowerCase().split('-')[0];
+        if (exports.LANG_CODES.has(langCode)) {
+            return langCode;
+        }
+    }
+    catch {
+        // Ignore errors
+    }
+    // Fallback to English
+    return 'en';
+}
+/**
+ * Set global language context
+ */
+function setLanguage(lang) {
+    globalLang = lang;
+}
+/**
+ * Get global language context
+ */
+function getLanguage() {
+    return globalLang;
+}
+/**
+ * Get language from various sources
+ */
+function getLang(lang) {
+    if (lang && exports.LANG_CODES.has(lang)) {
+        return lang;
+    }
+    if (globalLang) {
+        return globalLang;
+    }
+    return detectLanguage();
+}
+/**
+ * Translation function
+ */
+function t(key, lang, params) {
+    const targetLang = getLang(lang);
+    const translations = require(`../i18n/locales/${targetLang}.js`);
+    // Navigate through nested keys (e.g., 'cli.command.download.description')
+    const keys = key.split('.');
+    let value = translations.default || translations;
+    for (const k of keys) {
+        if (value && typeof value === 'object' && k in value) {
+            value = value[k];
+        }
+        else {
+            // Key not found, return the key itself
+            return key;
+        }
+    }
+    // If value is a string, replace params if provided
+    if (typeof value === 'string' && params) {
+        return value.replace(/\{(\w+)\}/g, (match, paramKey) => {
+            return params[paramKey] !== undefined ? String(params[paramKey]) : match;
+        });
+    }
+    return typeof value === 'string' ? value : key;
+}

package/cjs/lib/m3u8-convert.js

@@ -1,18 +1,13 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.m3u8Convert = m3u8Convert;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const fe_utils_1 = require("@lzwme/fe-utils");
 const console_log_colors_1 = require("console-log-colors");
-const ffmpeg_static_1 = __importDefault(require("ffmpeg-static"));
 const utils_1 = require("./utils");
 async function m3u8Convert(options, data) {
-    const useGlobal = options.useGlobalFfmpeg || false;
-    const ffmpegBin = useGlobal ? 'ffmpeg' : ffmpeg_static_1.default;
+    const ffmpegBin = options.ffmpegPath || 'ffmpeg';
     let ffmpegSupport = (0, utils_1.isSupportFfmpeg)(ffmpegBin);
     let filepath = (0, node_path_1.resolve)(options.saveDir, options.filename);
     if (!ffmpegSupport)
@@ -40,7 +35,7 @@ async function m3u8Convert(options, data) {
         const r = (0, fe_utils_1.execSync)(cmd);
         ffmpegSupport = !r.error;
         if (r.error)
-            utils_1.logger.error(`Conversion to mp4 failed. Please confirm that \`${useGlobal ? 'ffmpeg' : 'ffmpeg-static'}\` is ${useGlobal ? 'installed' : 'available'}!`, r.stderr);
+            utils_1.logger.error(`Conversion to mp4 failed. Please confirm that \`${ffmpegBin}\` is installed and available!`, r.stderr);
         else
             (0, node_fs_1.unlinkSync)(ffconcatFile);
     }

package/cjs/lib/m3u8-download.js

@@ -1,7 +1,4 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.workPollPublic = exports.downloadQueue = exports.DownloadQueue = void 0;
 exports.preDownLoad = preDownLoad;
@@ -12,7 +9,7 @@ const node_path_1 = require("node:path");
 const fe_utils_1 = require("@lzwme/fe-utils");
 const helper_1 = require("@lzwme/fe-utils/cjs/common/helper");
 const console_log_colors_1 = require("console-log-colors");
-const ffmpeg_static_1 = __importDefault(require("ffmpeg-static"));
+const i18n_js_1 = require("./i18n.js");
 const format_options_js_1 = require("./format-options.js");
 const local_play_js_1 = require("./local-play.js");
 const m3u8_convert_js_1 = require("./m3u8-convert.js");
@@ -91,7 +88,7 @@ const cache = {
 const tsDlFile = (0, node_path_1.resolve)(__dirname, './ts-download.js');
 exports.workPollPublic = new worker_pool_js_1.WorkerPool(tsDlFile);
 async function m3u8InfoParse(u, o = {}) {
-    const ffmpegBin = o.useGlobalFfmpeg ? 'ffmpeg' : ffmpeg_static_1.default;
+    const ffmpegBin = o.ffmpegPath || 'ffmpeg';
     const ext = (0, utils_js_1.isSupportFfmpeg)(ffmpegBin) ? '.mp4' : '.ts';
     const { url, options, urlMd5 } = (0, format_options_js_1.formatOptions)(u, o);
     /** 最终合并转换后的文件路径 */
@@ -105,17 +102,32 @@ async function m3u8InfoParse(u, o = {}) {
     }
     if (!options.force && (0, node_fs_1.existsSync)(filepath))
         return result;
+    const lang = (0, i18n_js_1.getLang)(o.lang);
     const m3u8Info = await (0, parseM3u8_js_1.parseM3U8)(url, (0, node_path_1.resolve)(options.cacheDir, urlMd5), options.headers).catch(e => {
-        utils_js_1.logger.error('[parseM3U8][failed]', e.message);
+        utils_js_1.logger.error((0, i18n_js_1.t)('download.status.parseFailed', lang), e.message);
         console.log(e);
     });
     if (m3u8Info && m3u8Info?.tsCount > 0) {
         result.m3u8Info = m3u8Info;
         if (options.ignoreSegments) {
+            const totalDuration = m3u8Info.duration;
             const timeSegments = options.ignoreSegments
                 .split(',')
-                .map(d => d.split(/[- ]+/).map(d => +d.trim()))
-                .filter(d => d[0] && d[1] && d[0] !== d[1]);
+                .map(d => {
+                const trimmed = d.trim();
+                // 支持 END-60 格式，表示末尾N秒
+                const parts = trimmed.split(/[- ]+/).map(d => d.trim());
+                if (parts.length === 2 && parts[0].toUpperCase() === 'END') {
+                    const seconds = +parts[1];
+                    if (!Number.isNaN(seconds) && seconds > 0) {
+                        const start = Math.max(0, totalDuration - seconds);
+                        return [start, totalDuration];
+                    }
+                }
+                // 原有的 start-end 格式
+                return parts.map(d => +d);
+            })
+                .filter(d => d[0] !== undefined && d[1] !== undefined && !Number.isNaN(d[0]) && !Number.isNaN(d[1]) && d[0] !== d[1]);
             if (timeSegments.length) {
                 const total = m3u8Info.data.length;
                 m3u8Info.data = m3u8Info.data.filter(item => {
@@ -132,7 +144,7 @@ async function m3u8InfoParse(u, o = {}) {
                 const ignoredCount = total - m3u8Info.data.length;
                 if (ignoredCount) {
                     m3u8Info.tsCount = m3u8Info.data.length;
-                    utils_js_1.logger.info(`[parseM3U8][ignoreSegments] ignored ${(0, console_log_colors_1.cyanBright)(ignoredCount)} segments`);
+                    utils_js_1.logger.info((0, i18n_js_1.t)('download.status.segmentsIgnored', lang, { count: (0, console_log_colors_1.cyanBright)(ignoredCount) }));
                     m3u8Info.duration = +Number(m3u8Info.duration).toFixed(2);
                 }
             }
@@ -189,11 +201,12 @@ async function m3u8Download(url, options = {}) {
         });
     }
     // 原有的下载逻辑
-    utils_js_1.logger.info('Starting download for', (0, console_log_colors_1.cyanBright)(url));
+    const lang = (0, i18n_js_1.getLang)(options.lang);
+    utils_js_1.logger.info((0, i18n_js_1.t)('download.status.starting', lang), (0, console_log_colors_1.cyanBright)(url));
     const result = await m3u8InfoParse(url, options);
     options = result.options;
     if (!options.force && (0, node_fs_1.existsSync)(result.filepath) && !result.m3u8Info) {
-        utils_js_1.logger.info('file already exist:', result.filepath);
+        utils_js_1.logger.info((0, i18n_js_1.t)('download.status.fileExists', lang), result.filepath);
         result.isExist = true;
         return result;
     }
@@ -231,14 +244,14 @@ async function m3u8Download(url, options = {}) {
                     if (!res || err) {
                         if (err) {
                             console.log('\n');
-                            utils_js_1.logger.error('[TS-DL][error]', info.index, err, res || '');
+                            utils_js_1.logger.error((0, i18n_js_1.t)('download.status.tsDownloadError', lang), info.index, err, res || '');
                         }
                         if (typeof info.success !== 'number')
                             info.success = 0;
                         else
                             info.success--;
                         if (info.success >= -3) {
-                            utils_js_1.logger.warn(`[retry][times: ${info.success}]`, info.index, info.uri);
+                            utils_js_1.logger.warn((0, i18n_js_1.t)('download.status.retryTimes', lang, { times: info.success }), info.index, info.uri);
                             setTimeout(() => runTask([info]), 1000);
                             return;
                         }
@@ -293,7 +306,7 @@ async function m3u8Download(url, options = {}) {
             }
         };
         if (options.showProgress) {
-            console.info(`\nTotal segments: ${(0, console_log_colors_1.cyan)(m3u8Info.tsCount)}, duration: ${(0, console_log_colors_1.green)(`${m3u8Info.duration}sec`)}.`, `Parallel jobs: ${(0, console_log_colors_1.magenta)(options.threadNum)}`);
+            console.info(`\n${(0, i18n_js_1.t)('download.status.totalSegments', lang, { count: (0, console_log_colors_1.cyan)(m3u8Info.tsCount), duration: (0, console_log_colors_1.green)(`${m3u8Info.duration}sec`) })}.`, (0, i18n_js_1.t)('download.status.parallelJobs', lang, { count: (0, console_log_colors_1.magenta)(options.threadNum) }));
         }
         result.stats = stats;
         (0, local_play_js_1.toLocalM3u8)(m3u8Info.data);
@@ -303,16 +316,24 @@ async function m3u8Download(url, options = {}) {
         await barrier.wait();
         workPoll.close();
         if (stats.tsFailed > 0) {
-            utils_js_1.logger.warn('Download Failed! Please retry!', stats.tsFailed);
+            stats.errmsg = (0, i18n_js_1.t)('download.status.segmentsFailed', lang, { count: stats.tsFailed });
+            result.errmsg = stats.errmsg;
+            utils_js_1.logger.warn((0, i18n_js_1.t)('download.status.downloadFailedRetry', lang), stats.tsFailed);
         }
         else if (options.convert !== false) {
+            stats.errmsg = (0, i18n_js_1.t)('download.status.mergingVideo', lang);
+            if (options.onProgress)
+                options.onProgress(stats.tsCount, m3u8Info.tsCount, null, stats);
             result.filepath = await (0, m3u8_convert_js_1.m3u8Convert)(options, m3u8Info.data);
+            stats.errmsg = result.filepath ? '' : (0, i18n_js_1.t)('download.status.mergeFailed', lang);
             if (result.filepath && (0, node_fs_1.existsSync)(result.filepath)) {
                 stats.size = (0, node_fs_1.statSync)(result.filepath).size;
                 if (options.delCache)
                     (0, fe_utils_1.rmrfAsync)((0, node_path_1.dirname)(m3u8Info.data[0].tsOut));
             }
         }
+        if (options.onProgress)
+            options.onProgress(stats.tsCount, m3u8Info.tsCount, null, stats);
     }
     utils_js_1.logger.debug('Done!', url, result.m3u8Info);
     return result;

package/cjs/lib/utils.js

@@ -23,11 +23,11 @@ const getRetry = (url, headers, retries = 3) => (0, fe_utils_1.retry)(() => expo
 });
 exports.getRetry = getRetry;
 exports.logger = fe_utils_1.NLogger.getLogger('[M3U8-DL]', { color: fe_utils_1.color });
-let _isSupportFfmpeg = null;
+const ffmpegTestCache = {};
 function isSupportFfmpeg(ffmpegBin) {
-    if (null == _isSupportFfmpeg)
-        _isSupportFfmpeg = (0, fe_utils_1.execSync)(`${ffmpegBin} -version`).stderr === '';
-    return _isSupportFfmpeg;
+    if (!(ffmpegBin in ffmpegTestCache))
+        ffmpegTestCache[ffmpegBin] = (0, fe_utils_1.execSync)(`${ffmpegBin} -version`).stderr === '';
+    return ffmpegTestCache[ffmpegBin];
 }
 function findFiles(apidir, validate) {
     const files = [];

package/cjs/server/download-server.d.ts

@@ -46,6 +46,7 @@ export declare class DLServer {
     private createApp;
     private startDownload;
     startNextPending(): void;
+    private getLangFromRequest;
     private wsSend;
     private initRouters;
 }

package/cjs/server/download-server.js

@@ -35,14 +35,15 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DLServer = void 0;
 const node_fs_1 = require("node:fs");
-const node_path_1 = require("node:path");
 const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
 const fe_utils_1 = require("@lzwme/fe-utils");
 const console_log_colors_1 = require("console-log-colors");
 const file_download_js_1 = require("../lib/file-download.js");
 const format_options_js_1 = require("../lib/format-options.js");
-const m3u8_download_js_1 = require("../lib/m3u8-download.js");
 const getM3u8Urls_js_1 = require("../lib/getM3u8Urls.js");
+const i18n_js_1 = require("../lib/i18n.js");
+const m3u8_download_js_1 = require("../lib/m3u8-download.js");
 const utils_js_1 = require("../lib/utils.js");
 const index_js_1 = require("../video-parser/index.js");
 const rootDir = (0, node_path_1.resolve)(__dirname, '../..');
@@ -76,6 +77,7 @@ class DLServer {
             debug: process.env.DS_DEBUG === '1',
             saveDir: process.env.DS_SAVE_DIR || './downloads',
             threadNum: 4,
+            ffmpegPath: process.env.DS_FFMPEG_PATH || undefined,
         },
     };
     /** 下载任务缓存 */
@@ -172,6 +174,18 @@ class DLServer {
     saveConfig(config, configPath) {
         if (!configPath)
             configPath = this.options.configPath;
+        // 验证 ffmpegPath 是否存在
+        if (config.ffmpegPath?.trim()) {
+            const ffmpegPath = config.ffmpegPath.trim();
+            if (!(0, node_fs_1.existsSync)(ffmpegPath)) {
+                throw new Error(`ffmpeg 路径不存在: ${ffmpegPath}`);
+            }
+            // 检查是否为文件（不是目录）
+            const stats = (0, node_fs_1.statSync)(ffmpegPath);
+            if (!stats.isFile()) {
+                throw new Error(`ffmpeg 路径不是文件: ${ffmpegPath}`);
+            }
+        }
         for (const [key, value] of Object.entries(config)) {
             // @ts-expect-error 忽略类型错误
             if (key in this.cfg.webOptions)
@@ -192,16 +206,28 @@ class DLServer {
         this.app = app;
         this.wss = wss;
         app.use((req, res, next) => {
-            if (['/', '/index.html'].includes(req.path)) {
+            // 处理 SPA 路由：根路径和 /page/* 路径都返回 index.html
+            const isIndexPage = ['/', '/index.html'].includes(req.path) || req.path.startsWith('/page/');
+            const isPlayPage = req.path.startsWith('/play.html');
+            if (isIndexPage || isPlayPage) {
                 const version = this.serverInfo.version;
-                let indexHtml = (0, node_fs_1.readFileSync)((0, node_path_1.resolve)(rootDir, 'client/index.html'), 'utf-8').replaceAll('{{version}}', version);
+                let htmlContent = (0, node_fs_1.readFileSync)((0, node_path_1.resolve)(rootDir, `client/${isPlayPage ? 'play' : 'index'}.html`), 'utf-8').replaceAll('{{version}}', version);
                 if ((0, node_fs_1.existsSync)((0, node_path_1.resolve)(rootDir, 'client/local/cdn'))) {
-                    indexHtml = indexHtml
-                        .replaceAll('https://s4.zstatic.net/ajax/libs', 'local/cdn')
-                        .replaceAll(/integrity="[^"]+"\n?/g, '')
-                        .replace('https://cdn.tailwindcss.com/3.4.16', 'local/cdn/tailwindcss/3.4.16/tailwindcss.min.js');
+                    // 提取所有 zstatic.net 的 js 和 css 资源地址，若子路径存在于 local/cdn 目录下则替换为本地路径
+                    const zstaticRegex = /https:\/\/s4\.zstatic\.net\/ajax\/libs\/[^\s"'`<>]+\.(js|css)/g;
+                    const zstaticMatches = htmlContent.match(zstaticRegex);
+                    if (zstaticMatches) {
+                        for (const match of zstaticMatches) {
+                            const relativePath = match.split('libs/')[1];
+                            const localPath = (0, node_path_1.resolve)(rootDir, `client/local/cdn/${relativePath}`);
+                            if ((0, node_fs_1.existsSync)(localPath)) {
+                                htmlContent = htmlContent.replaceAll(match, `local/cdn/${relativePath}`);
+                            }
+                        }
+                        htmlContent = htmlContent.replaceAll(/integrity="[^"]+"\n?/g, '');
+                    }
                 }
-                res.setHeader('content-type', 'text/html').send(indexHtml);
+                res.setHeader('content-type', 'text/html').send(htmlContent);
             }
             else {
                 next();
@@ -221,9 +247,10 @@ class DLServer {
             if (this.options.token && req.headers.authorization !== this.options.token) {
                 const ignorePaths = ['/healthcheck', '/localplay'];
                 if (!ignorePaths.some(d => req.url.includes(d))) {
+                    const lang = this.getLangFromRequest(req);
                     const clientIp = req.headers['x-forwarded-for'] || req.socket.remoteAddress;
                     utils_js_1.logger.warn('Unauthorized access:', clientIp, req.url, req.headers.authorization);
-                    res.status(401).json({ message: '未授权，禁止访问', code: 401 });
+                    res.status(401).json({ message: (0, i18n_js_1.t)('api.error.unauthorized', lang), code: 1008 });
                     return;
                 }
             }
@@ -338,6 +365,28 @@ class DLServer {
             this.wsSend('progress', nextItem[0]);
         }
     }
+    getLangFromRequest(req) {
+        // Try to get lang from query parameter
+        const queryLang = req.query?.lang;
+        if (queryLang && i18n_js_1.LANG_CODES.has(queryLang)) {
+            return queryLang;
+        }
+        // Try to get lang from Accept-Language header
+        const acceptLanguage = req.headers['accept-language'];
+        if (acceptLanguage) {
+            const langCode = acceptLanguage.toLowerCase().split(',')[0].split('-')[0].trim();
+            if (i18n_js_1.LANG_CODES.has(langCode)) {
+                return langCode;
+            }
+        }
+        // Try to get lang from body
+        const bodyLang = req.body?.lang;
+        if (bodyLang && i18n_js_1.LANG_CODES.has(bodyLang)) {
+            return bodyLang;
+        }
+        // Fallback to default
+        return (0, i18n_js_1.getLang)();
+    }
     wsSend(type = 'progress', data) {
         if (type === 'tasks' && !data) {
             data = Object.fromEntries(this.dlCacheClone());
@@ -361,29 +410,40 @@ class DLServer {
             res.json({ message: 'ok', code: 0 });
         });
         app.post('/api/config', (req, res) => {
-            const config = req.body;
-            this.saveConfig(config);
-            res.json({ message: 'Config updated successfully', code: 0 });
+            const lang = this.getLangFromRequest(req);
+            try {
+                const config = req.body;
+                this.saveConfig(config);
+                res.json({ message: (0, i18n_js_1.t)('api.success.configUpdated', lang), code: 0 });
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : (0, i18n_js_1.t)('api.error.configSaveFailed', lang);
+                utils_js_1.logger.error('[saveConfig]', errorMessage);
+                res.status(400).json({ message: errorMessage, code: 1 });
+            }
         });
         app.get('/api/config', (_req, res) => {
-            res.json({ ...this.cfg.dlOptions, ...this.cfg.webOptions });
+            res.json({ code: 0, data: { ...this.cfg.dlOptions, ...this.cfg.webOptions } });
         });
         // API to get all download progress
         app.get('/api/tasks', (_req, res) => {
-            res.json(Object.fromEntries(this.dlCacheClone()));
+            res.json({ code: 0, data: Object.fromEntries(this.dlCacheClone()) });
         });
         // API to get queue status
         app.get('/api/queue/status', (_req, res) => {
             const pendingTasks = Array.from(this.dlCache.entries()).filter(([_, item]) => item.status === 'pending');
             const activeTasks = Array.from(this.dlCache.entries()).filter(([_, item]) => item.status === 'resume');
             res.json({
-                queueLength: pendingTasks.length,
-                activeDownloads: activeTasks.map(([url]) => url),
-                maxConcurrent: this.cfg.webOptions.maxDownloads,
+                code: 0,
+                data: {
+                    queueLength: pendingTasks.length,
+                    activeDownloads: activeTasks.map(([url]) => url),
+                    maxConcurrent: this.cfg.webOptions.maxDownloads,
+                },
             });
         });
         // API to clear queue
-        app.post('/api/queue/clear', (_req, res) => {
+        app.post('/api/queue/clear', (req, res) => {
             let count = 0;
             for (const [url, item] of this.dlCache.entries()) {
                 if (item.status === 'pending') {
@@ -393,23 +453,25 @@ class DLServer {
             }
             if (count)
                 this.wsSend('tasks');
-            res.json({ message: `已清空 ${count} 个等待中的下载任务`, code: 0 });
+            const lang = this.getLangFromRequest(req);
+            res.json({ message: (0, i18n_js_1.t)('api.success.queueCleared', lang, { count }), code: 0 });
         });
         // API to update task priority
-        app.post('/api/priority', (req, res) => {
-            const { url, priority } = req.body;
-            const item = this.dlCache.get(url);
-            if (!item) {
-                res.json({ message: '任务不存在', code: 1 });
-                return;
-            }
-            item.options.priority = priority;
-            this.saveCache();
-            res.json({ message: '已更新任务优先级', code: 0 });
-        });
+        // app.post('/api/priority', (req, res) => {
+        //   const { url, priority } = req.body;
+        //   const item = this.dlCache.get(url);
+        //   if (!item) {
+        //     res.json({ message: '任务不存在', code: 1 });
+        //     return;
+        //   }
+        //   item.options.priority = priority;
+        //   this.saveCache();
+        //   res.json({ message: '已更新任务优先级', code: 0 });
+        // });
         // API to start m3u8 download
         app.post('/api/download', (req, res) => {
             const { url, options = {}, list = [] } = req.body;
+            const lang = this.getLangFromRequest(req);
             try {
                 if (list.length) {
                     for (const item of list) {
@@ -420,11 +482,11 @@ class DLServer {
                 }
                 else if (url)
                     this.startDownload(url, options);
-                res.json({ message: `Download started: ${list.length || 1}`, code: 0 });
+                res.json({ message: (0, i18n_js_1.t)('api.success.downloadStarted', lang, { count: list.length || 1 }), code: 0 });
                 this.wsSend('tasks');
             }
             catch (error) {
-                res.status(500).json({ error: `Download failed: ${error.message}` });
+                res.status(500).json({ error: `${(0, i18n_js_1.t)('api.error.downloadFailed', lang)}: ${error.message || ''}` });
             }
         });
         // API to pause download
@@ -445,7 +507,8 @@ class DLServer {
                 this.wsSend('progress', list);
                 this.startNextPending();
             }
-            res.json({ message: `已暂停 ${list.length} 个下载任务`, code: 0, count: list.length });
+            const lang = this.getLangFromRequest(req);
+            res.json({ message: (0, i18n_js_1.t)('api.success.paused', lang, { count: list.length }), code: 0, count: list.length });
         });
         // API to resume download
         app.post('/api/resume', (req, res) => {
@@ -464,7 +527,12 @@ class DLServer {
             }
             if (list.length)
                 this.wsSend('progress', list);
-            res.json({ message: list.length ? `已恢复 ${list.length} 个下载任务` : '没有找到可恢复的下载任务', code: 0, count: list.length });
+            const lang = this.getLangFromRequest(req);
+            res.json({
+                message: list.length ? (0, i18n_js_1.t)('api.success.resumed', lang, { count: list.length }) : (0, i18n_js_1.t)('api.success.noResumableTasks', lang),
+                code: 0,
+                count: list.length,
+            });
         });
         // API to delete download
         app.post('/api/delete', (req, res) => {
@@ -500,7 +568,8 @@ class DLServer {
                 this.saveCache();
                 this.startNextPending();
             }
-            res.json({ message: `已删除 ${list.length} 个下载任务`, code: 0, count: list.length });
+            const lang = this.getLangFromRequest(req);
+            res.json({ message: (0, i18n_js_1.t)('api.success.deleted', lang, { count: list.length }), code: 0, count: list.length });
         });
         app.get(/^\/localplay\/(.*)$/, (req, res) => {
             let filepath = decodeURIComponent(req.params[0]);
@@ -526,7 +595,8 @@ class DLServer {
                     const isAllow = !this.options.limitFileAccess || allowedDirs.some(d => filepath.startsWith((0, node_path_1.resolve)(d)));
                     if (!isAllow) {
                         utils_js_1.logger.error('[Localplay] Access denied:', filepath);
-                        res.send({ message: 'Access denied', code: 403 });
+                        const lang = this.getLangFromRequest(req);
+                        res.send({ message: (0, i18n_js_1.t)('api.error.accessDenied', lang), code: 403 });
                         return;
                     }
                 }
@@ -553,12 +623,14 @@ class DLServer {
                 }
             }
             utils_js_1.logger.error('[Localplay]file not found:', (0, console_log_colors_1.red)(filepath));
-            res.status(404).send({ message: 'Not Found', code: 404 });
+            const lang = this.getLangFromRequest(req);
+            res.status(404).send({ message: (0, i18n_js_1.t)('api.error.notFound', lang), code: 404 });
         });
         app.post('/api/getM3u8Urls', (req, res) => {
             const { url, headers, subUrlRegex } = req.body;
+            const lang = this.getLangFromRequest(req);
             if (!url) {
-                res.json({ code: 1001, message: '无效的 url 参数' });
+                res.json({ code: 1001, message: (0, i18n_js_1.t)('api.error.invalidUrl', lang) });
             }
             else {
                 (0, getM3u8Urls_js_1.getM3u8Urls)({ url, headers, subUrlRegex })

package/cjs/types/index.d.ts

@@ -1,4 +1,4 @@
 export * from './common';
 export * from './m3u8';
-export * from './video-search';
 export * from './video-parser';
+export * from './video-search';

package/cjs/types/index.js

@@ -16,5 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./common"), exports);
 __exportStar(require("./m3u8"), exports);
-__exportStar(require("./video-search"), exports);
 __exportStar(require("./video-parser"), exports);
+__exportStar(require("./video-search"), exports);

package/cjs/types/m3u8.d.ts

@@ -140,8 +140,10 @@ export interface M3u8DLOptions {
      * - 'parser'：下载 VideoParser 支持解析的平台视频文件
      */
     type?: 'm3u8' | 'file' | 'parser';
-    /** 是否使用系统安装的 ffmpeg 而不是内置的 ffmpeg-static。默认为 false */
-    useGlobalFfmpeg?: boolean;
+    /** ffmpeg 可执行文件路径。如果未指定，则尝试使用系统 PATH 中的 'ffmpeg' */
+    ffmpegPath?: string;
+    /** 语言。可选值：zh, en */
+    lang?: 'zh' | 'en';
 }
 export interface M3u8DLResult extends Partial<DownloadResult> {
     /** 下载进度统计 */