koishi-plugin-kkk 3.0.0 → 3.0.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 更新日志
 
+## 3.0.1
+
+### 在线播放：声音不再等服务器
+
+- **默认不在服务器上合视频和声音了**：播放页会同时放画面和声音，由浏览器自己对好（原来要等 ffmpeg 在服务器上合完才能开始放，等得久）。
+- **下载按钮分成了三个**：「下载画面」（只有画面的那份，和以前一样）、「下载声音」（单独把声音存下来）、「合成后下载」（连声音一起下载，点下去服务器才去合并，合好再给你；合过一次会记住，再点马上就好）。
+- 页面上的静音按钮现在同时管画面和声音；拖动进度条时声音也会跟着对齐。
+
 ## 3.0.0
 
 > 这一版主要两件事：**让它快**、**该发出去的东西真的发出去**。

package/lib/karin/platform/bilibili/bilibili.js

@@ -324,7 +324,7 @@ class Bilibili extends utils_1.Base {
                 }
                 else {
                     /**
-                     * 免登录直链分支：体积取自 html5 播放接口的 \`durl[0].size\`。
+                     * 免登录直链分支：体积取自 html5 播放接口的 `durl[0].size`。
                      * 这个接口会偶发拿不到 durl（风控、字段变化、超时），原来这里直接下标取值，
                      * 一旦为空就抛 TypeError，**整条解析直接失败**（用户侧表现就是「提示开始解析，然后没下文」）。
                      * 体积只是展示信息，取不到就按 0 处理，不要拖垮解析。
@@ -1319,6 +1319,12 @@ class Bilibili extends utils_1.Base {
      *   - 本地文件（登录态合成/烧录的产物、免登录时提前下好的直链）；
      *   - 没有下载产物时保持 null（例如体积超限根本没下）。
      */
+    /**
+     * 已经准备好的视频（见 prepareVideo）。
+     *
+     * `audioPath` 只有**在线播放 + 音视频分离（B站）**时才有：表示音轨单独存了一份，
+     * 播放页会同时播这两个文件（默认不合成，用户要求）。
+     */
     preparedVideo = null;
     /**
      * 下载视频（含合成音轨、烧录弹幕），**不发送**。
@@ -1421,23 +1427,52 @@ class Bilibili extends utils_1.Base {
                         }));
                         sourcePath = resultPath;
                     }
+                    else if ((0, player_1.isOnlinePlayerRequest)()) {
+                        /**
+                         * **在线播放：默认不合成**（用户要求）。
+                         *
+                         * B站的音视频是分离的，以前这里必定调一次 ffmpeg 合成（几分钟的视频也要几秒到几十秒，
+                         * 低配机器更久）。改成：画面和声音**各自留一份**，播放页用 `<video muted>` + `<audio>`
+                         * 同时播；只有用户在播放页点「服务器合并后下载」时才按需合成（见 player/server.ts）。
+                         */
+                        success = true;
+                        sourcePath = bmp4.filepath;
+                        node_karin_1.logger.mark('[在线播放] 跳过音视频合成：画面与声音分开存，浏览器端同时播放');
+                    }
                     else {
                         success = await (0, utils_1.mergeVideoAudio)(bmp4.filepath, bmp3.filepath, resultPath);
                         sourcePath = resultPath;
                     }
                     if (success) {
-                        const filePath = utils_1.Common.tempDri.video + `${Config_1.Config.app.removeCache ? 'tmp_' + Date.now() : this.downloadfilename}.mp4`;
-                        node_fs_1.default.renameSync(sourcePath, filePath);
-                        node_karin_1.logger.mark(`视频文件重命名完成: ${sourcePath.split('/').pop()} -> ${filePath.split('/').pop()}`);
-                        node_karin_1.logger.mark('正在尝试删除缓存文件');
-                        if (node_fs_1.default.existsSync(bmp4.filepath))
-                            await utils_1.Common.removeFile(bmp4.filepath, true);
-                        if (bmp3 && node_fs_1.default.existsSync(bmp3.filepath))
-                            await utils_1.Common.removeFile(bmp3.filepath, true);
-                        const stats = node_fs_1.default.statSync(filePath);
-                        const fileSizeInMB = Number((stats.size / (1024 * 1024)).toFixed(2));
-                        // 本地合成的没有视频直链，交给 sendPreparedVideo 上传
-                        this.preparedVideo = { filepath: filePath, totalBytes: fileSizeInMB, originTitle: this.downloadfilename };
+                        /**
+                         * 在线播放（音视频分离）时**不要重命名** —— 画面那个文件原样留着，
+                         * 「audioPath」指向单独的音轨文件，两个都由 publishOnlinePlayer 搬进会话目录。
+                         */
+                        const separateAudio = (0, player_1.isOnlinePlayerRequest)() && !!bmp3 && sourcePath === bmp4.filepath;
+                        if (separateAudio) {
+                            const videoStats = node_fs_1.default.statSync(bmp4.filepath);
+                            this.preparedVideo = {
+                                filepath: bmp4.filepath,
+                                totalBytes: Number((videoStats.size / (1024 * 1024)).toFixed(2)),
+                                originTitle: this.downloadfilename,
+                                audioPath: bmp3.filepath
+                            };
+                            node_karin_1.logger.mark('[在线播放] 已就绪：画面 + 声音分开，交给播放页同时播放');
+                        }
+                        else {
+                            const filePath = utils_1.Common.tempDri.video + `${Config_1.Config.app.removeCache ? 'tmp_' + Date.now() : this.downloadfilename}.mp4`;
+                            node_fs_1.default.renameSync(sourcePath, filePath);
+                            node_karin_1.logger.mark(`视频文件重命名完成: ${sourcePath.split('/').pop()} -> ${filePath.split('/').pop()}`);
+                            node_karin_1.logger.mark('正在尝试删除缓存文件');
+                            if (node_fs_1.default.existsSync(bmp4.filepath))
+                                await utils_1.Common.removeFile(bmp4.filepath, true);
+                            if (bmp3 && node_fs_1.default.existsSync(bmp3.filepath))
+                                await utils_1.Common.removeFile(bmp3.filepath, true);
+                            const stats = node_fs_1.default.statSync(filePath);
+                            const fileSizeInMB = Number((stats.size / (1024 * 1024)).toFixed(2));
+                            // 本地合成的没有视频直链，交给 sendPreparedVideo 上传
+                            this.preparedVideo = { filepath: filePath, totalBytes: fileSizeInMB, originTitle: this.downloadfilename };
+                        }
                     }
                     else {
                         await utils_1.Common.removeFile(bmp4.filepath, true);
@@ -1528,7 +1563,7 @@ class Bilibili extends utils_1.Base {
         this.preparedVideo = null;
         if (!prepared)
             return false;
-        const { filepath, totalBytes, originTitle, videoUrl } = prepared;
+        const { filepath, totalBytes, originTitle, videoUrl, audioPath } = prepared;
         /**
          * 在线播放模式：不烧录、也不上传，直接把下好的视频登记成播放会话，
          * 回一条公网链接（弹幕存下来给播放页用）。
@@ -1538,6 +1573,8 @@ class Bilibili extends utils_1.Base {
         if ((0, player_1.isOnlinePlayerRequest)()) {
             const published = await (0, player_1.publishOnlinePlayer)(this.e, {
                 videoPath: filepath,
+                // 分离音轨：一起交给播放页（默认不合成，浏览器里同时播）
+                audioPath,
                 title: originTitle || this.downloadfilename || this.workInfo?.title,
                 platform: 'bilibili',
                 danmaku: this.danmakuList,

package/lib/player/index.js

@@ -526,7 +526,11 @@ async function publishOnlinePlayer(e, input) {
          * 体积上限：超过就不做在线播放，回一句说明并返回 false ——
          * 调用方拿到 false 会退回「直接发送视频文件」，用户不会什么都没有。
          */
-        const sizeMB = Number(node_fs_1.default.statSync(input.videoPath).size) / 1024 / 1024;
+        /** 有独立音轨时按「画面 + 声音」的总和算，免得两条加起来把磁盘塞爆 */
+        const audioBytes = input.audioPath && node_fs_1.default.existsSync(input.audioPath)
+            ? Number(node_fs_1.default.statSync(input.audioPath).size) || 0
+            : 0;
+        const sizeMB = (Number(node_fs_1.default.statSync(input.videoPath).size) + audioBytes) / 1024 / 1024;
         const limitMB = await resolvePlayerSizeLimitMB();
         if (limitMB > 0 && sizeMB > limitMB) {
             /**
@@ -547,6 +551,7 @@ async function publishOnlinePlayer(e, input) {
         const localOnly = !hasPublicBaseUrl();
         const session = (0, store_1.registerPlayerSession)({
             videoPath: input.videoPath,
+            audioPath: input.audioPath,
             title: input.title,
             platform: input.platform,
             danmaku,

package/lib/player/page.js

@@ -226,6 +226,9 @@ const PLAYER_STYLE = [
     'background:var(--pink);color:#fff;font-size:14px;font-weight:600;cursor:pointer;}',
     '.dlbtn svg{font-size:20px}',
     '.dlbtn:hover{background:#ff8aac}',
+    /** 「合成后下载」是主按钮（另外两个只是分别下载原始流），稍微区分一下 */
+    '.dlbtn.main{background:#fb7299;color:#fff}',
+    '.dlbtn.main:hover{background:#ff8aac}',
     '.dlbtn:focus-visible{outline:2px solid #fff;outline-offset:2px}',
     '.dlhint{color:var(--muted);font-size:12px;}',
     /* 没配公网地址时的提示条：用户打不开得知道是「没配域名」，不是「插件坏了」 */
@@ -287,6 +290,8 @@ function renderPlayerPage(info) {
     const platform = escapeHtml(platformLabel(info.platform));
     const expire = formatExpire(info.expireAt);
     const danmakuCount = Number(info.danmakuCount) || 0;
+    /** 有没有**单独的音轨**（B站这类音视频分离的）：有就 <video muted> + <audio> 同时播 */
+    const hasAudio = typeof info.audioPath === 'string' && info.audioPath.length > 0;
     const duration = formatDuration(info.durationSeconds);
     const script = PLAYER_SCRIPT.split('__KKK_TOKEN__').join(token);
     const stats = [
@@ -338,7 +343,12 @@ function renderPlayerPage(info) {
         + '  </div>\n'
         + '  <div class="player">\n'
         + '    <div class="video-wrap" id="videoWrap">\n'
-        + '      <video id="video" src="/kkk/player/' + token + '/video" preload="metadata" playsinline webkit-playsinline></video>\n'
+        /**
+         * 音视频分离时：视频**静音**播画面，声音交给下面这个 <audio> 一起播
+         * （用户要求：默认不在服务器合成，浏览器端同时播放即可）。
+         */
+        + '      <video id="video" src="/kkk/player/' + token + '/video" preload="metadata" playsinline webkit-playsinline' + (hasAudio ? ' muted' : '') + '></video>\n'
+        + (hasAudio ? '      <audio id="audioTrack" src="/kkk/player/' + token + '/audio" preload="auto"></audio>\n' : '')
         + '      <canvas id="danmaku"></canvas>\n'
         + '      <div id="notice" class="notice" hidden></div>\n'
         + '      <button type="button" class="bigplay" id="bigPlay" aria-label="播放">' + ICON.play + '</button>\n'
@@ -384,9 +394,23 @@ function renderPlayerPage(info) {
          * 放在播放器下面单独一条 —— 作品信息可能缺（那时不会渲染操作按钮排），下载入口不能跟着一起消失。
          */
         + '  <div class="downbar">'
-        + '<a class="dlbtn" id="downloadBtn" href="/kkk/player/' + token + '/video?download=1" download>'
-        + ICON.download + '<span>下载视频</span></a>'
-        + '<span class="dlhint">保存到本机（原画质，不重新编码）</span></div>\n'
+        + (hasAudio
+            /**
+             * 音视频分离：给两个「分别下载」+ 一个「服务器合成后下载」。
+             * 分别是秒下（就是两个原文件），合成那条第一次点要等一两秒（服务器跑一次 ffmpeg -c copy）。
+             */
+            ? '<a class="dlbtn" href="/kkk/player/' + token + '/video?download=1" download>'
+                + ICON.download + '<span>下载画面</span></a>'
+                + '<a class="dlbtn" href="/kkk/player/' + token + '/audio?download=1" download>'
+                + ICON.download + '<span>下载声音</span></a>'
+                + '<a class="dlbtn main" href="/kkk/player/' + token + '/merged?download=1" download>'
+                + ICON.download + '<span>合成后下载</span></a>'
+                + '<span class="dlhint">画面与声音是分开的两条流：前两个直接下载，最后一个由服务器合成成一个视频（第一次要等一两秒）；'
+                + '想在播放器里看就直接播放，声音会自动跟上</span>'
+            : '<a class="dlbtn" id="downloadBtn" href="/kkk/player/' + token + '/video?download=1" download>'
+                + ICON.download + '<span>下载视频</span></a>'
+                + '<span class="dlhint">保存到本机（原画质，不重新编码）</span>')
+        + '</div>\n'
         + linkRow + '\n'
         + (actions ? '  <div class="actions">' + actions + '</div>\n' : '')
         + (info.localOnly
@@ -579,6 +603,14 @@ const PLAYER_SCRIPT = [
     "  var notice = document.getElementById('notice')",
     "  var video = document.getElementById('video')",
     "  var canvas = document.getElementById('danmaku')",
+    "  /**",
+    "   * 单独的音轨（B站这类音视频分离的）。有它的时候：",
+    "   *   - 视频元素是 muted 的（只出画面），声音由这个 <audio> 出；",
+    "   *   - 播放 / 暂停 / 拖动进度都要**带着它一起**，否则声音会跟画面错开。",
+    "   */",
+    "  var audioTrack = document.getElementById('audioTrack')",
+    "  /** 音量控制作用在谁身上：有独立音轨就是音轨，否则是视频自己 */",
+    "  var soundEl = audioTrack || video",
     "  var toggle = document.getElementById('dmOn')",
     "  var countEl = document.getElementById('dmCount')",
     "  var settingsBtn = document.getElementById('dmSettingsBtn')",
@@ -763,6 +795,8 @@ const PLAYER_SCRIPT = [
     "      cursor++",
     "      guard++",
     "    }",
+    "    // 音画同步：偏差超过 0.25 秒就拉回来（长时间播放 / 卡顿后必须对一次）",
+    "    if (audioTrack && !video.paused && !video.ended && !video.seeking) alignAudio()",
     "    draw(dt, now)",
     "  }",
     "",
@@ -967,12 +1001,34 @@ const PLAYER_SCRIPT = [
     "    })",
     "  }",
     "",
+    "  /** 把音轨拉到和画面同一个位置（拖动 / 卡顿时对表） */",
+    "  function alignAudio () {",
+    "    if (!audioTrack) return",
+    "    try {",
+    "      if (Math.abs((audioTrack.currentTime || 0) - video.currentTime) > 0.25) audioTrack.currentTime = video.currentTime",
+    "    } catch (error) { /* 还没加载好就等下一帧 */ }",
+    "  }",
+    "",
+    "  function playAudio () {",
+    "    if (!audioTrack) return",
+    "    alignAudio()",
+    "    var started = audioTrack.play()",
+    "    if (started && started.catch) started.catch(function () { /* 画面已经在放，声音起不来就先算了 */ })",
+    "  }",
+    "",
+    "  function pauseAudio () {",
+    "    if (!audioTrack) return",
+    "    try { audioTrack.pause() } catch (error) { /* 忽略 */ }",
+    "  }",
+    "",
     "  function togglePlay () {",
     "    if (video.paused || video.ended) {",
     "      var started = video.play()",
     "      if (started && started.catch) started.catch(function () { showNotice('浏览器拦住了自动播放，点一下画面中间的播放按钮就行') })",
+    "      playAudio()",
     "    } else {",
     "      video.pause()",
+    "      pauseAudio()",
     "    }",
     "  }",
     "",
@@ -984,22 +1040,34 @@ const PLAYER_SCRIPT = [
     "  }",
     "",
     "  function syncMute () {",
-    "    if (muteBtn) muteBtn.classList.toggle('is-muted', video.muted || video.volume === 0)",
+    "    if (muteBtn) muteBtn.classList.toggle('is-muted', soundEl.muted || soundEl.volume === 0)",
     "  }",
     "",
-    "  video.addEventListener('play', syncPlayState)",
-    "  video.addEventListener('pause', syncPlayState)",
-    "  video.addEventListener('ended', syncPlayState)",
+    "  video.addEventListener('play', function () { syncPlayState(); playAudio() })",
+    "  video.addEventListener('pause', function () { syncPlayState(); pauseAudio() })",
+    "  video.addEventListener('ended', function () { syncPlayState(); pauseAudio() })",
     "  video.addEventListener('timeupdate', drawProgress)",
     "  video.addEventListener('progress', drawProgress)",
     "  video.addEventListener('durationchange', drawProgress)",
     "  video.addEventListener('loadedmetadata', drawProgress)",
     "  video.addEventListener('volumechange', syncMute)",
+    "  // 拖动进度（含键盘 / 快进）：画面跳完马上把音轨对齐，不然会差出好几秒",
+    "  video.addEventListener('seeked', alignAudio)",
+    "  if (audioTrack) {",
+    "    audioTrack.addEventListener('volumechange', syncMute)",
+    "    // 音轨自己卡住 / 被系统暂停时，跟着画面走",
+    "    audioTrack.addEventListener('pause', function () { if (!video.paused && !video.ended) playAudio() })",
+    "    audioTrack.addEventListener('error', function () { showNotice('声音加载失败，画面继续播放（可以在下面单独下载声音）') })",
+    "  }",
     "  if (playBtn) playBtn.addEventListener('click', togglePlay)",
     "  if (bigPlay) bigPlay.addEventListener('click', togglePlay)",
     "  // 点画面中间也能播放 / 暂停（弹幕 canvas 是 pointer-events:none，点它等于点在 video 上）",
     "  video.addEventListener('click', togglePlay)",
-    "  if (muteBtn) muteBtn.addEventListener('click', function () { video.muted = !video.muted; syncMute() })",
+    "  if (muteBtn) {",
+    "    // 有独立音轨时，静音 / 取消静音作用在音轨上（视频一直是 muted 的）",
+    "    if (audioTrack) soundEl.muted = true",
+    "    muteBtn.addEventListener('click', function () { soundEl.muted = !soundEl.muted; syncMute() })",
+    "  }",
     "",
     "  function isFullscreen () { return !!(document.fullscreenElement || document.webkitFullscreenElement) }",
     "",

package/lib/player/server.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -14,7 +47,9 @@ exports.registerPlayerRoutes = registerPlayerRoutes;
  * 三条路由（都挂在自己拼的 `/kkk/player` 前缀下，和配置面板的 /kkk 互不干扰）：
  *   GET /kkk/player/:token           播放页（HTML）
  *   GET /kkk/player/:token/video     视频本体，支持 Range（拖进度条靠它）；`?download=1` = 下载
- *   GET /kkk/player/:token/download  同上，等价于 `/video?download=1`（带 Content-Disposition）
+ *   GET /kkk/player/:token/audio     单独的音轨（B站这种音视频分离的）；`?download=1` = 下载音频
+ *   GET /kkk/player/:token/merged    **按需**用 ffmpeg 合成音视频后下载/播放（第一次会慢一两秒）
+ *   GET /kkk/player/:token/download  等价于 `/video?download=1`（带 Content-Disposition）
  *   GET /kkk/player/:token/danmaku   弹幕 JSON
  *
  * 两种落地方式：
@@ -27,6 +62,7 @@ exports.registerPlayerRoutes = registerPlayerRoutes;
  */
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_http_1 = __importDefault(require("node:http"));
+const node_path_1 = __importDefault(require("node:path"));
 const node_karin_1 = require("../compat/node-karin.js");
 const page_1 = require("./page");
 const store_1 = require("./store");
@@ -101,13 +137,13 @@ function sanitizeDownloadName(title) {
  * 两个文件名都给：`filename=` 用 ASCII 兜底名（老客户端 / 头编码限制），
  * `filename*=` 用 RFC 5987 的 UTF-8 形式放原名（现代浏览器优先用它，中文名不会变成下划线）。
  */
-function downloadDisposition(title) {
-    const full = sanitizeDownloadName(title) + '.mp4';
+function downloadDisposition(title, ext = '.mp4') {
+    const full = sanitizeDownloadName(title) + ext;
     // 纯中文标题会变成一排下划线（对老客户端毫无意义），这种情况直接给个通用名
     const asciiRaw = full.replace(/[^\x20-\x7e]/g, '_').replace(/["\\]/g, '_');
     // 只在**扩展名之前**数有效字符：纯中文标题会变成「_____.mp4」，那 3 个字母来自 .mp4 不能算数
-    const asciiBase = asciiRaw.replace(/\.(mp4|mkv|webm|mov)$/i, '');
-    const ascii = /[A-Za-z0-9]/.test(asciiBase) ? asciiRaw : 'video.mp4';
+    const asciiBase = asciiRaw.replace(/\.(mp4|mkv|webm|mov|m4a|aac|mp3)$/i, '');
+    const ascii = /[A-Za-z0-9]/.test(asciiBase) ? asciiRaw : 'video' + ext;
     const encoded = encodeURIComponent(full).replace(/['()*]/g, (char) => '%' + char.charCodeAt(0).toString(16).toUpperCase());
     return 'attachment; filename="' + ascii + '"; filename*=UTF-8\'\'' + encoded;
 }
@@ -115,29 +151,34 @@ function downloadDisposition(title) {
  * 视频响应：支持 Range，未过期时是 video/mp4。
  * @param download 为 true 时带上 `Content-Disposition: attachment`（浏览器直接下载），Range 照旧支持
  */
-function videoResponse(token, range, head = false, download = false) {
-    const video = (0, store_1.resolvePlayerVideo)(token);
-    if (!video)
-        return notFound(false);
+/**
+ * 通用文件响应：支持 Range。
+ *
+ * @param file 文件路径与大小
+ * @param contentType 响应的 Content-Type（视频 / 音轨 / 合并后的视频各不同）
+ * @param ext 下载时的扩展名（决定 Content-Disposition 里的文件名）
+ * @param download 是否带 \`Content-Disposition: attachment\`
+ */
+function fileResponse(token, file, contentType, range, head = false, download = false, ext = '.mp4') {
     const base = {
-        'Content-Type': 'video/mp4',
+        'Content-Type': contentType,
         'Accept-Ranges': 'bytes',
         'Cache-Control': 'no-store'
     };
     // 下载：文件名取会话标题（清洗过），Range 行为不变（浏览器正常下载时也不会带 Range）
     if (download)
-        base['Content-Disposition'] = downloadDisposition((0, store_1.getPlayerSession)(token)?.title);
-    const parsed = parseRange(range, video.size);
+        base['Content-Disposition'] = downloadDisposition((0, store_1.getPlayerSession)(token)?.title, ext);
+    const parsed = parseRange(range, file.size);
     if (parsed === 'invalid') {
         return {
             status: 416,
-            headers: { ...base, 'Content-Range': 'bytes */' + video.size },
+            headers: { ...base, 'Content-Range': 'bytes */' + file.size },
             body: Buffer.from('请求的范围无效')
         };
     }
     if (!parsed) {
-        base['Content-Length'] = String(video.size);
-        return { status: 200, headers: base, file: head ? undefined : { path: video.path, start: 0, end: video.size - 1 } };
+        base['Content-Length'] = String(file.size);
+        return { status: 200, headers: base, file: head ? undefined : { path: file.path, start: 0, end: file.size - 1 } };
     }
     const length = parsed.end - parsed.start + 1;
     return {
@@ -145,11 +186,78 @@ function videoResponse(token, range, head = false, download = false) {
         headers: {
             ...base,
             'Content-Length': String(length),
-            'Content-Range': 'bytes ' + parsed.start + '-' + parsed.end + '/' + video.size
+            'Content-Range': 'bytes ' + parsed.start + '-' + parsed.end + '/' + file.size
         },
-        file: head ? undefined : { path: video.path, start: parsed.start, end: parsed.end }
+        file: head ? undefined : { path: file.path, start: parsed.start, end: parsed.end }
     };
 }
+/** 视频本体（分离音轨时这里只有画面） */
+function videoResponse(token, range, head = false, download = false) {
+    const video = (0, store_1.resolvePlayerVideo)(token);
+    if (!video)
+        return notFound(false);
+    return fileResponse(token, video, 'video/mp4', range, head, download, '.mp4');
+}
+/** 单独的音轨（B站这类音视频分离的）：\`<audio>\` 直接播它，\`?download=1\` 下载 m4a */
+function audioResponse(token, range, head = false, download = false) {
+    const audio = (0, store_1.resolvePlayerAudio)(token);
+    if (!audio)
+        return notFound(false);
+    return fileResponse(token, audio, 'audio/mp4', range, head, download, '.m4a');
+}
+/**
+ * **按需合成**：把画面和音轨用 ffmpeg 合成一条 mp4（\`-c copy\`，不重新编码，通常一两秒）。
+ *
+ * 为什么要按需：用户要求「默认不合并音频、浏览器里同时播放就行」——
+ * 解析时不再花时间合成，只有点了「服务器合并后下载」才做，而且做完会留在会话目录里，
+ * 同一条链接再点就是秒回（到期随会话一起删）。
+ *
+ * @returns 合成好的文件；没有独立音轨 / ffmpeg 失败时返回 null（路由回 404）
+ */
+async function ensureMerged(token) {
+    const cached = (0, store_1.resolvePlayerMerged)(token);
+    if (cached)
+        return cached;
+    const video = (0, store_1.resolvePlayerVideo)(token);
+    const audio = (0, store_1.resolvePlayerAudio)(token);
+    if (!video || !audio)
+        return null;
+    const session = (0, store_1.getPlayerSession)(token);
+    if (!session)
+        return null;
+    const target = node_path_1.default.join(session.dir, 'merged.mp4');
+    const started = Date.now();
+    try {
+        const { spawn } = await Promise.resolve().then(() => __importStar(require('node:child_process')));
+        const { resolveFfmpegBin } = await Promise.resolve().then(() => __importStar(require('../compat/node-karin.js')));
+        const bin = resolveFfmpegBin();
+        await new Promise((resolve, reject) => {
+            const proc = spawn(bin, [
+                '-y',
+                '-i', video.path,
+                '-i', audio.path,
+                '-c', 'copy',
+                '-movflags', '+faststart',
+                target
+            ], { stdio: 'ignore' });
+            proc.on('error', reject);
+            proc.on('close', (code) => (code === 0 ? resolve() : reject(new Error('ffmpeg exit ' + code))));
+        });
+        const stat = node_fs_1.default.statSync(target);
+        (0, store_1.markPlayerMerged)(token, 'merged.mp4');
+        node_karin_1.logger.mark('[在线播放] 已按需合成音视频（' + (stat.size / 1024 / 1024).toFixed(1) + 'MB，'
+            + (Date.now() - started) + 'ms）：' + token);
+        return { path: target, size: stat.size };
+    }
+    catch (error) {
+        node_karin_1.logger.warn('[在线播放] 合成音视频失败（' + (Date.now() - started) + 'ms）: ' + String(error?.message ?? error));
+        try {
+            node_fs_1.default.rmSync(target, { force: true });
+        }
+        catch { /* 忽略 */ }
+        return null;
+    }
+}
 /**
  * 封面图。
  *
@@ -213,6 +321,19 @@ async function handlePlayerRequest(request) {
     }
     if (action === 'video')
         return videoResponse(token, request.range, method === 'HEAD', wantDownload);
+    // 独立音轨（B站音视频分离时才有）：播放页的 <audio> 播它，?download=1 下载 m4a
+    if (action === 'audio')
+        return audioResponse(token, request.range, method === 'HEAD', wantDownload);
+    /**
+     * 按需合成后下载 / 播放：第一次会跑一次 ffmpeg -c copy（一两秒），之后走缓存。
+     * 合成失败（没有独立音轨 / 没有 ffmpeg）回 404，页面上的按钮也就不该点得动。
+     */
+    if (action === 'merged') {
+        const merged = await ensureMerged(token);
+        if (!merged)
+            return notFound(false);
+        return fileResponse(token, merged, 'video/mp4', request.range, method === 'HEAD', wantDownload, '.mp4');
+    }
     // 独立路由：`/kkk/player/<token>/download` 与 `/video?download=1` 完全等价
     if (action === 'download')
         return videoResponse(token, request.range, method === 'HEAD', true);

package/lib/player/store.js

@@ -46,6 +46,9 @@ exports.getPlayerSession = getPlayerSession;
 exports.readPlayerDanmaku = readPlayerDanmaku;
 exports.resolvePlayerCover = resolvePlayerCover;
 exports.resolvePlayerVideo = resolvePlayerVideo;
+exports.resolvePlayerAudio = resolvePlayerAudio;
+exports.markPlayerMerged = markPlayerMerged;
+exports.resolvePlayerMerged = resolvePlayerMerged;
 exports.deletePlayerSession = deletePlayerSession;
 exports.sweepExpiredPlayers = sweepExpiredPlayers;
 exports.listPlayerSessions = listPlayerSessions;
@@ -138,6 +141,9 @@ function normalizeSession(raw) {
         platform: String(raw.platform ?? ''),
         dir: typeof raw.dir === 'string' && raw.dir ? raw.dir : node_path_1.default.dirname(filePath),
         filePath,
+        audioPath: typeof raw.audioPath === 'string' && raw.audioPath ? raw.audioPath : undefined,
+        audioSizeBytes: Number.isFinite(Number(raw.audioSizeBytes)) ? Number(raw.audioSizeBytes) : undefined,
+        merged: typeof raw.merged === 'string' && raw.merged ? raw.merged : undefined,
         sizeBytes: Number(raw.sizeBytes) || 0,
         danmakuCount: Number(raw.danmakuCount) || 0,
         createdAt: Number(raw.createdAt) || Date.now(),
@@ -244,6 +250,27 @@ function registerPlayerSession(input) {
             node_fs_1.default.copyFileSync(source, target);
             node_fs_1.default.rmSync(source, { force: true });
         }
+        /**
+         * 单独的音轨：也**搬**进会话目录（和视频同一套逻辑：同分区改名、跨分区复制 + 删源）。
+         * 搬不动就当作「没有独立音轨」，不影响视频本身能播。
+         */
+        let audioTarget;
+        if (input.audioPath && node_fs_1.default.existsSync(input.audioPath)) {
+            const candidate = node_path_1.default.join(dir, 'audio.m4a');
+            try {
+                try {
+                    node_fs_1.default.renameSync(input.audioPath, candidate);
+                }
+                catch {
+                    node_fs_1.default.copyFileSync(input.audioPath, candidate);
+                    node_fs_1.default.rmSync(input.audioPath, { force: true });
+                }
+                audioTarget = candidate;
+            }
+            catch (error) {
+                node_karin_1.logger.warn('[在线播放] 音轨文件搬进会话目录失败（将只播视频流）: ' + String(error?.message ?? error));
+            }
+        }
         const danmaku = Array.isArray(input.danmaku) ? input.danmaku : [];
         node_fs_1.default.writeFileSync(node_path_1.default.join(dir, 'danmaku.json'), JSON.stringify({ total: danmaku.length, items: danmaku }));
         // 封面：复制进会话目录，页面用同源地址取（不引外链，断网/内网也能看）
@@ -268,6 +295,8 @@ function registerPlayerSession(input) {
             dir,
             filePath: target,
             sizeBytes: Number(node_fs_1.default.statSync(target).size) || 0,
+            audioPath: audioTarget,
+            audioSizeBytes: audioTarget ? (Number(node_fs_1.default.statSync(audioTarget).size) || 0) : undefined,
             danmakuCount: danmaku.length,
             createdAt: now,
             expireAt: now + normalizeExpireMinutes(input.expireMinutes) * 60 * 1000,
@@ -367,6 +396,50 @@ function resolvePlayerVideo(token) {
         return null;
     }
 }
+/**
+ * 取单独的音轨文件（没有独立音轨就返回 null，路由回 404）。
+ *
+ * 独立音轨 = 解析时没让服务器合成，播放页用 `<audio>` 和视频一起播（见 PlayerSession.audioPath）。
+ */
+function resolvePlayerAudio(token) {
+    const session = getPlayerSession(token);
+    const audioPath = session?.audioPath;
+    if (!audioPath)
+        return null;
+    try {
+        const stat = node_fs_1.default.statSync(audioPath);
+        if (!stat.isFile())
+            return null;
+        return { path: audioPath, size: stat.size };
+    }
+    catch {
+        return null;
+    }
+}
+/** 记住「按需合成的文件」文件名（它会留在会话目录里，到期一起清掉） */
+function markPlayerMerged(token, fileName) {
+    const session = sessions.get(String(token));
+    if (!session)
+        return;
+    session.merged = fileName;
+    persistIndex();
+}
+/** 已经合成好的合并文件路径（没有就 null） */
+function resolvePlayerMerged(token) {
+    const session = getPlayerSession(token);
+    if (!session?.merged)
+        return null;
+    try {
+        const file = node_path_1.default.join(session.dir, session.merged);
+        const stat = node_fs_1.default.statSync(file);
+        if (!stat.isFile())
+            return null;
+        return { path: file, size: stat.size };
+    }
+    catch {
+        return null;
+    }
+}
 /** 删掉一个会话的文件：先按 Common.removeFile 删视频，再把整个会话目录清掉 */
 async function removePlayerFiles(session) {
     await removeFileQuietly(session.filePath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-kkk",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "抖音 / B站 / 快手 / 小红书 视频解析与动态推送，带 QQ 交互面板与弹幕烧录（karin-plugin-kkk 的 Koishi 移植版）",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",

package/scripts/smoke-player.cjs

@@ -397,7 +397,12 @@ setTimeout(async () => {
       if (matched) {
         fs.writeFileSync(scriptFile, matched[1])
         try {
-          require('node:child_process').execFileSync(process.execPath, ['--check', scriptFile], { stdio: 'pipe' })
+          /**
+           * `stdio: 'ignore'` 而不是 'pipe'：受限环境（沙箱）里**管道是禁的**，
+           * `stdio: 'pipe'` 会直接 EPERM，把一条好脚本误判成语法错误；
+           * 这里只需要退出码，不需要子进程输出。
+           */
+          require('node:child_process').execFileSync(process.execPath, ['--check', scriptFile], { stdio: 'ignore' })
           syntaxOk = true
         } catch (error) {
           console.log('     ' + String(error?.stderr ?? error?.message ?? error).slice(0, 200))
@@ -898,11 +903,16 @@ setTimeout(async () => {
      * 门控表达式是 patch-webui 生成到前端包里的，这里直接数产物里的出现次数。
      */
     const playerOffMarker = 'Q(e,[' + BT + 'qq' + BT + ',' + BT + 'playerEnabled' + BT + '],!0)===!1'
-    check('WebUI 里「在线播放器总开关」关掉时组内 6 个字段全部变灰（开关 2 个 + 输入框 4 个）',
-      !!bundleText && bundleText.split(playerOffMarker).length - 1 === 6,
+    /**
+     * 组内字段数：**7 个**（开关 2 个 + 文本框 5 个）。
+     * 2026-09 加了「强制在线播放的适配器」（文本框，也在这一组里）之后，
+     * 这里从 6/4 变成 7/5 —— 断言跟着更新，别把新增的合法字段当成漏门控。
+     */
+    check('WebUI 里「在线播放器总开关」关掉时组内 7 个字段全部变灰（开关 2 个 + 输入框 5 个）',
+      !!bundleText && bundleText.split(playerOffMarker).length - 1 === 7,
       '门控表达式 ' + (bundleText.split(playerOffMarker).length - 1) + ' 处')
-    check('其中文本框/数字框用的是 options.disabled（4 个）',
-      !!bundleText && bundleText.split('disabled:' + playerOffMarker).length - 1 === 4,
+    check('其中文本框/数字框用的是 options.disabled（5 个）',
+      !!bundleText && bundleText.split('disabled:' + playerOffMarker).length - 1 === 5,
       'disabled: 形式 ' + (bundleText.split('disabled:' + playerOffMarker).length - 1) + ' 处')
     check('总开关自己不带这条门控（它只受「强制不烧录弹幕」锁）',
       !!bundleText && bundleText.split(BT + 'playerEnabled' + BT + '],!0)===!1,').length - 1 === 0)

package/src/karin/platform/bilibili/bilibili.ts

@@ -355,7 +355,7 @@ export class Bilibili extends Base {
           videoSize = await getvideosize(correctList.videoList[0].base_url, audioUrl, infoData.data.data.bvid)
         } else {
           /**
-           * 免登录直链分支：体积取自 html5 播放接口的 \`durl[0].size\`。
+           * 免登录直链分支：体积取自 html5 播放接口的 `durl[0].size`。
            * 这个接口会偶发拿不到 durl（风控、字段变化、超时），原来这里直接下标取值，
            * 一旦为空就抛 TypeError，**整条解析直接失败**（用户侧表现就是「提示开始解析，然后没下文」）。
            * 体积只是展示信息，取不到就按 0 处理，不要拖垮解析。
@@ -1470,7 +1470,13 @@ export class Bilibili extends Base {
    *   - 本地文件（登录态合成/烧录的产物、免登录时提前下好的直链）；
    *   - 没有下载产物时保持 null（例如体积超限根本没下）。
    */
-  protected preparedVideo: { filepath: string; totalBytes: number; originTitle: string; videoUrl?: string } | null = null
+  /**
+   * 已经准备好的视频（见 prepareVideo）。
+   *
+   * `audioPath` 只有**在线播放 + 音视频分离（B站）**时才有：表示音轨单独存了一份，
+   * 播放页会同时播这两个文件（默认不合成，用户要求）。
+   */
+  protected preparedVideo: { filepath: string; totalBytes: number; originTitle: string; videoUrl?: string; audioPath?: string } | null = null
 
   /**
    * 下载视频（含合成音轨、烧录弹幕），**不发送**。
@@ -1601,23 +1607,50 @@ export class Bilibili extends Base {
               })
             )
             sourcePath = resultPath
+          } else if (isOnlinePlayerRequest()) {
+            /**
+             * **在线播放：默认不合成**（用户要求）。
+             *
+             * B站的音视频是分离的，以前这里必定调一次 ffmpeg 合成（几分钟的视频也要几秒到几十秒，
+             * 低配机器更久）。改成：画面和声音**各自留一份**，播放页用 `<video muted>` + `<audio>`
+             * 同时播；只有用户在播放页点「服务器合并后下载」时才按需合成（见 player/server.ts）。
+             */
+            success = true
+            sourcePath = bmp4.filepath
+            logger.mark('[在线播放] 跳过音视频合成：画面与声音分开存，浏览器端同时播放')
           } else {
             success = await mergeVideoAudio(bmp4.filepath, bmp3.filepath, resultPath)
             sourcePath = resultPath
           }
 
           if (success) {
-            const filePath = Common.tempDri.video + `${Config.app.removeCache ? 'tmp_' + Date.now() : this.downloadfilename}.mp4`
-            fs.renameSync(sourcePath, filePath)
-            logger.mark(`视频文件重命名完成: ${sourcePath.split('/').pop()} -> ${filePath.split('/').pop()}`)
-            logger.mark('正在尝试删除缓存文件')
-            if (fs.existsSync(bmp4.filepath)) await Common.removeFile(bmp4.filepath, true)
-            if (bmp3 && fs.existsSync(bmp3.filepath)) await Common.removeFile(bmp3.filepath, true)
-
-            const stats = fs.statSync(filePath)
-            const fileSizeInMB = Number((stats.size / (1024 * 1024)).toFixed(2))
-            // 本地合成的没有视频直链，交给 sendPreparedVideo 上传
-            this.preparedVideo = { filepath: filePath, totalBytes: fileSizeInMB, originTitle: this.downloadfilename }
+            /**
+             * 在线播放（音视频分离）时**不要重命名** —— 画面那个文件原样留着，
+             * 「audioPath」指向单独的音轨文件，两个都由 publishOnlinePlayer 搬进会话目录。
+             */
+            const separateAudio = isOnlinePlayerRequest() && !!bmp3 && sourcePath === bmp4.filepath
+            if (separateAudio) {
+              const videoStats = fs.statSync(bmp4.filepath)
+              this.preparedVideo = {
+                filepath: bmp4.filepath,
+                totalBytes: Number((videoStats.size / (1024 * 1024)).toFixed(2)),
+                originTitle: this.downloadfilename,
+                audioPath: bmp3!.filepath
+              }
+              logger.mark('[在线播放] 已就绪：画面 + 声音分开，交给播放页同时播放')
+            } else {
+              const filePath = Common.tempDri.video + `${Config.app.removeCache ? 'tmp_' + Date.now() : this.downloadfilename}.mp4`
+              fs.renameSync(sourcePath, filePath)
+              logger.mark(`视频文件重命名完成: ${sourcePath.split('/').pop()} -> ${filePath.split('/').pop()}`)
+              logger.mark('正在尝试删除缓存文件')
+              if (fs.existsSync(bmp4.filepath)) await Common.removeFile(bmp4.filepath, true)
+              if (bmp3 && fs.existsSync(bmp3.filepath)) await Common.removeFile(bmp3.filepath, true)
+
+              const stats = fs.statSync(filePath)
+              const fileSizeInMB = Number((stats.size / (1024 * 1024)).toFixed(2))
+              // 本地合成的没有视频直链，交给 sendPreparedVideo 上传
+              this.preparedVideo = { filepath: filePath, totalBytes: fileSizeInMB, originTitle: this.downloadfilename }
+            }
           } else {
             await Common.removeFile(bmp4.filepath, true)
             if (bmp3) await Common.removeFile(bmp3.filepath, true)
@@ -1707,7 +1740,7 @@ export class Bilibili extends Base {
     const prepared = this.preparedVideo
     this.preparedVideo = null
     if (!prepared) return false
-    const { filepath, totalBytes, originTitle, videoUrl } = prepared
+    const { filepath, totalBytes, originTitle, videoUrl, audioPath } = prepared
     /**
      * 在线播放模式：不烧录、也不上传，直接把下好的视频登记成播放会话，
      * 回一条公网链接（弹幕存下来给播放页用）。
@@ -1717,6 +1750,8 @@ export class Bilibili extends Base {
     if (isOnlinePlayerRequest()) {
       const published = await publishOnlinePlayer(this.e, {
         videoPath: filepath,
+        // 分离音轨：一起交给播放页（默认不合成，浏览器里同时播）
+        audioPath,
         title: originTitle || this.downloadfilename || this.workInfo?.title,
         platform: 'bilibili',
         danmaku: this.danmakuList,

package/src/player/index.ts

@@ -449,6 +449,11 @@ const TIP_PREPARING = '下载完成，正在准备在线播放…'
  */
 export async function publishOnlinePlayer (e: any, input: {
   videoPath: string
+  /**
+   * 单独的音轨文件（可选）：B站这类音视频分离的流，**默认不再用 ffmpeg 合成**，
+   * 两份一起交给播放页，浏览器里同时播（用户要求）。点「服务器合并后下载」时才按需合成。
+   */
+  audioPath?: string
   title?: string
   platform?: string
   danmaku?: any
@@ -478,7 +483,11 @@ export async function publishOnlinePlayer (e: any, input: {
      * 体积上限：超过就不做在线播放，回一句说明并返回 false ——
      * 调用方拿到 false 会退回「直接发送视频文件」，用户不会什么都没有。
      */
-    const sizeMB = Number(fs.statSync(input.videoPath).size) / 1024 / 1024
+    /** 有独立音轨时按「画面 + 声音」的总和算，免得两条加起来把磁盘塞爆 */
+    const audioBytes = input.audioPath && fs.existsSync(input.audioPath)
+      ? Number(fs.statSync(input.audioPath).size) || 0
+      : 0
+    const sizeMB = (Number(fs.statSync(input.videoPath).size) + audioBytes) / 1024 / 1024
     const limitMB = await resolvePlayerSizeLimitMB()
     if (limitMB > 0 && sizeMB > limitMB) {
       /**
@@ -499,6 +508,7 @@ export async function publishOnlinePlayer (e: any, input: {
     const localOnly = !hasPublicBaseUrl()
     const session = registerPlayerSession({
       videoPath: input.videoPath,
+      audioPath: input.audioPath,
       title: input.title,
       platform: input.platform,
       danmaku,

package/src/player/page.ts

@@ -247,6 +247,9 @@ const PLAYER_STYLE = [
   'background:var(--pink);color:#fff;font-size:14px;font-weight:600;cursor:pointer;}',
   '.dlbtn svg{font-size:20px}',
   '.dlbtn:hover{background:#ff8aac}',
+  /** 「合成后下载」是主按钮（另外两个只是分别下载原始流），稍微区分一下 */
+  '.dlbtn.main{background:#fb7299;color:#fff}',
+  '.dlbtn.main:hover{background:#ff8aac}',
   '.dlbtn:focus-visible{outline:2px solid #fff;outline-offset:2px}',
   '.dlhint{color:var(--muted);font-size:12px;}',
   /* 没配公网地址时的提示条：用户打不开得知道是「没配域名」，不是「插件坏了」 */
@@ -309,6 +312,8 @@ export function renderPlayerPage (info: PlayerPageInfo): string {
   const platform = escapeHtml(platformLabel(info.platform))
   const expire = formatExpire(info.expireAt)
   const danmakuCount = Number(info.danmakuCount) || 0
+  /** 有没有**单独的音轨**（B站这类音视频分离的）：有就 <video muted> + <audio> 同时播 */
+  const hasAudio = typeof info.audioPath === 'string' && info.audioPath.length > 0
   const duration = formatDuration(info.durationSeconds)
   const script = PLAYER_SCRIPT.split('__KKK_TOKEN__').join(token)
 
@@ -365,7 +370,12 @@ export function renderPlayerPage (info: PlayerPageInfo): string {
     + '  </div>\n'
     + '  <div class="player">\n'
     + '    <div class="video-wrap" id="videoWrap">\n'
-    + '      <video id="video" src="/kkk/player/' + token + '/video" preload="metadata" playsinline webkit-playsinline></video>\n'
+    /**
+     * 音视频分离时：视频**静音**播画面，声音交给下面这个 <audio> 一起播
+     * （用户要求：默认不在服务器合成，浏览器端同时播放即可）。
+     */
+    + '      <video id="video" src="/kkk/player/' + token + '/video" preload="metadata" playsinline webkit-playsinline' + (hasAudio ? ' muted' : '') + '></video>\n'
+    + (hasAudio ? '      <audio id="audioTrack" src="/kkk/player/' + token + '/audio" preload="auto"></audio>\n' : '')
     + '      <canvas id="danmaku"></canvas>\n'
     + '      <div id="notice" class="notice" hidden></div>\n'
     + '      <button type="button" class="bigplay" id="bigPlay" aria-label="播放">' + ICON.play + '</button>\n'
@@ -411,9 +421,23 @@ export function renderPlayerPage (info: PlayerPageInfo): string {
      * 放在播放器下面单独一条 —— 作品信息可能缺（那时不会渲染操作按钮排），下载入口不能跟着一起消失。
      */
     + '  <div class="downbar">'
-    + '<a class="dlbtn" id="downloadBtn" href="/kkk/player/' + token + '/video?download=1" download>'
-    + ICON.download + '<span>下载视频</span></a>'
-    + '<span class="dlhint">保存到本机（原画质，不重新编码）</span></div>\n'
+    + (hasAudio
+      /**
+       * 音视频分离：给两个「分别下载」+ 一个「服务器合成后下载」。
+       * 分别是秒下（就是两个原文件），合成那条第一次点要等一两秒（服务器跑一次 ffmpeg -c copy）。
+       */
+      ? '<a class="dlbtn" href="/kkk/player/' + token + '/video?download=1" download>'
+        + ICON.download + '<span>下载画面</span></a>'
+        + '<a class="dlbtn" href="/kkk/player/' + token + '/audio?download=1" download>'
+        + ICON.download + '<span>下载声音</span></a>'
+        + '<a class="dlbtn main" href="/kkk/player/' + token + '/merged?download=1" download>'
+        + ICON.download + '<span>合成后下载</span></a>'
+        + '<span class="dlhint">画面与声音是分开的两条流：前两个直接下载，最后一个由服务器合成成一个视频（第一次要等一两秒）；'
+        + '想在播放器里看就直接播放，声音会自动跟上</span>'
+      : '<a class="dlbtn" id="downloadBtn" href="/kkk/player/' + token + '/video?download=1" download>'
+        + ICON.download + '<span>下载视频</span></a>'
+        + '<span class="dlhint">保存到本机（原画质，不重新编码）</span>')
+    + '</div>\n'
     + linkRow + '\n'
     + (actions ? '  <div class="actions">' + actions + '</div>\n' : '')
     + (info.localOnly
@@ -610,6 +634,14 @@ const PLAYER_SCRIPT = [
   "  var notice = document.getElementById('notice')",
   "  var video = document.getElementById('video')",
   "  var canvas = document.getElementById('danmaku')",
+  "  /**",
+  "   * 单独的音轨（B站这类音视频分离的）。有它的时候：",
+  "   *   - 视频元素是 muted 的（只出画面），声音由这个 <audio> 出；",
+  "   *   - 播放 / 暂停 / 拖动进度都要**带着它一起**，否则声音会跟画面错开。",
+  "   */",
+  "  var audioTrack = document.getElementById('audioTrack')",
+  "  /** 音量控制作用在谁身上：有独立音轨就是音轨，否则是视频自己 */",
+  "  var soundEl = audioTrack || video",
   "  var toggle = document.getElementById('dmOn')",
   "  var countEl = document.getElementById('dmCount')",
   "  var settingsBtn = document.getElementById('dmSettingsBtn')",
@@ -794,6 +826,8 @@ const PLAYER_SCRIPT = [
   "      cursor++",
   "      guard++",
   "    }",
+  "    // 音画同步：偏差超过 0.25 秒就拉回来（长时间播放 / 卡顿后必须对一次）",
+  "    if (audioTrack && !video.paused && !video.ended && !video.seeking) alignAudio()",
   "    draw(dt, now)",
   "  }",
   "",
@@ -998,12 +1032,34 @@ const PLAYER_SCRIPT = [
   "    })",
   "  }",
   "",
+  "  /** 把音轨拉到和画面同一个位置（拖动 / 卡顿时对表） */",
+  "  function alignAudio () {",
+  "    if (!audioTrack) return",
+  "    try {",
+  "      if (Math.abs((audioTrack.currentTime || 0) - video.currentTime) > 0.25) audioTrack.currentTime = video.currentTime",
+  "    } catch (error) { /* 还没加载好就等下一帧 */ }",
+  "  }",
+  "",
+  "  function playAudio () {",
+  "    if (!audioTrack) return",
+  "    alignAudio()",
+  "    var started = audioTrack.play()",
+  "    if (started && started.catch) started.catch(function () { /* 画面已经在放，声音起不来就先算了 */ })",
+  "  }",
+  "",
+  "  function pauseAudio () {",
+  "    if (!audioTrack) return",
+  "    try { audioTrack.pause() } catch (error) { /* 忽略 */ }",
+  "  }",
+  "",
   "  function togglePlay () {",
   "    if (video.paused || video.ended) {",
   "      var started = video.play()",
   "      if (started && started.catch) started.catch(function () { showNotice('浏览器拦住了自动播放，点一下画面中间的播放按钮就行') })",
+  "      playAudio()",
   "    } else {",
   "      video.pause()",
+  "      pauseAudio()",
   "    }",
   "  }",
   "",
@@ -1015,22 +1071,34 @@ const PLAYER_SCRIPT = [
   "  }",
   "",
   "  function syncMute () {",
-  "    if (muteBtn) muteBtn.classList.toggle('is-muted', video.muted || video.volume === 0)",
+  "    if (muteBtn) muteBtn.classList.toggle('is-muted', soundEl.muted || soundEl.volume === 0)",
   "  }",
   "",
-  "  video.addEventListener('play', syncPlayState)",
-  "  video.addEventListener('pause', syncPlayState)",
-  "  video.addEventListener('ended', syncPlayState)",
+  "  video.addEventListener('play', function () { syncPlayState(); playAudio() })",
+  "  video.addEventListener('pause', function () { syncPlayState(); pauseAudio() })",
+  "  video.addEventListener('ended', function () { syncPlayState(); pauseAudio() })",
   "  video.addEventListener('timeupdate', drawProgress)",
   "  video.addEventListener('progress', drawProgress)",
   "  video.addEventListener('durationchange', drawProgress)",
   "  video.addEventListener('loadedmetadata', drawProgress)",
   "  video.addEventListener('volumechange', syncMute)",
+  "  // 拖动进度（含键盘 / 快进）：画面跳完马上把音轨对齐，不然会差出好几秒",
+  "  video.addEventListener('seeked', alignAudio)",
+  "  if (audioTrack) {",
+  "    audioTrack.addEventListener('volumechange', syncMute)",
+  "    // 音轨自己卡住 / 被系统暂停时，跟着画面走",
+  "    audioTrack.addEventListener('pause', function () { if (!video.paused && !video.ended) playAudio() })",
+  "    audioTrack.addEventListener('error', function () { showNotice('声音加载失败，画面继续播放（可以在下面单独下载声音）') })",
+  "  }",
   "  if (playBtn) playBtn.addEventListener('click', togglePlay)",
   "  if (bigPlay) bigPlay.addEventListener('click', togglePlay)",
   "  // 点画面中间也能播放 / 暂停（弹幕 canvas 是 pointer-events:none，点它等于点在 video 上）",
   "  video.addEventListener('click', togglePlay)",
-  "  if (muteBtn) muteBtn.addEventListener('click', function () { video.muted = !video.muted; syncMute() })",
+  "  if (muteBtn) {",
+  "    // 有独立音轨时，静音 / 取消静音作用在音轨上（视频一直是 muted 的）",
+  "    if (audioTrack) soundEl.muted = true",
+  "    muteBtn.addEventListener('click', function () { soundEl.muted = !soundEl.muted; syncMute() })",
+  "  }",
   "",
   "  function isFullscreen () { return !!(document.fullscreenElement || document.webkitFullscreenElement) }",
   "",

package/src/player/server.ts

@@ -4,7 +4,9 @@
  * 三条路由（都挂在自己拼的 `/kkk/player` 前缀下，和配置面板的 /kkk 互不干扰）：
  *   GET /kkk/player/:token           播放页（HTML）
  *   GET /kkk/player/:token/video     视频本体，支持 Range（拖进度条靠它）；`?download=1` = 下载
- *   GET /kkk/player/:token/download  同上，等价于 `/video?download=1`（带 Content-Disposition）
+ *   GET /kkk/player/:token/audio     单独的音轨（B站这种音视频分离的）；`?download=1` = 下载音频
+ *   GET /kkk/player/:token/merged    **按需**用 ffmpeg 合成音视频后下载/播放（第一次会慢一两秒）
+ *   GET /kkk/player/:token/download  等价于 `/video?download=1`（带 Content-Disposition）
  *   GET /kkk/player/:token/danmaku   弹幕 JSON
  *
  * 两种落地方式：
@@ -17,6 +19,7 @@
  */
 import fs from 'node:fs'
 import http from 'node:http'
+import path from 'node:path'
 
 import { logger } from 'node-karin'
 
@@ -24,8 +27,11 @@ import { renderExpiredPage, renderPlayerPage } from './page'
 import {
   getPlayerSession,
   isValidPlayerToken,
+  markPlayerMerged,
   readPlayerDanmaku,
+  resolvePlayerAudio,
   resolvePlayerCover,
+  resolvePlayerMerged,
   resolvePlayerVideo
 } from './store'
 
@@ -118,13 +124,13 @@ export function sanitizeDownloadName (title: unknown): string {
  * 两个文件名都给：`filename=` 用 ASCII 兜底名（老客户端 / 头编码限制），
  * `filename*=` 用 RFC 5987 的 UTF-8 形式放原名（现代浏览器优先用它，中文名不会变成下划线）。
  */
-export function downloadDisposition (title: unknown): string {
-  const full = sanitizeDownloadName(title) + '.mp4'
+export function downloadDisposition (title: unknown, ext = '.mp4'): string {
+  const full = sanitizeDownloadName(title) + ext
   // 纯中文标题会变成一排下划线（对老客户端毫无意义），这种情况直接给个通用名
   const asciiRaw = full.replace(/[^\x20-\x7e]/g, '_').replace(/["\\]/g, '_')
   // 只在**扩展名之前**数有效字符：纯中文标题会变成「_____.mp4」，那 3 个字母来自 .mp4 不能算数
-  const asciiBase = asciiRaw.replace(/\.(mp4|mkv|webm|mov)$/i, '')
-  const ascii = /[A-Za-z0-9]/.test(asciiBase) ? asciiRaw : 'video.mp4'
+  const asciiBase = asciiRaw.replace(/\.(mp4|mkv|webm|mov|m4a|aac|mp3)$/i, '')
+  const ascii = /[A-Za-z0-9]/.test(asciiBase) ? asciiRaw : 'video' + ext
   const encoded = encodeURIComponent(full).replace(/['()*]/g, (char) => '%' + char.charCodeAt(0).toString(16).toUpperCase())
   return 'attachment; filename="' + ascii + '"; filename*=UTF-8\'\'' + encoded
 }
@@ -133,27 +139,41 @@ export function downloadDisposition (title: unknown): string {
  * 视频响应：支持 Range，未过期时是 video/mp4。
  * @param download 为 true 时带上 `Content-Disposition: attachment`（浏览器直接下载），Range 照旧支持
  */
-function videoResponse (token: string, range?: string, head = false, download = false): PlayerHttpResponse {
-  const video = resolvePlayerVideo(token)
-  if (!video) return notFound(false)
+/**
+ * 通用文件响应：支持 Range。
+ *
+ * @param file 文件路径与大小
+ * @param contentType 响应的 Content-Type（视频 / 音轨 / 合并后的视频各不同）
+ * @param ext 下载时的扩展名（决定 Content-Disposition 里的文件名）
+ * @param download 是否带 \`Content-Disposition: attachment\`
+ */
+function fileResponse (
+  token: string,
+  file: { path: string, size: number },
+  contentType: string,
+  range?: string,
+  head = false,
+  download = false,
+  ext = '.mp4'
+): PlayerHttpResponse {
   const base: Record<string, string> = {
-    'Content-Type': 'video/mp4',
+    'Content-Type': contentType,
     'Accept-Ranges': 'bytes',
     'Cache-Control': 'no-store'
   }
   // 下载：文件名取会话标题（清洗过），Range 行为不变（浏览器正常下载时也不会带 Range）
-  if (download) base['Content-Disposition'] = downloadDisposition(getPlayerSession(token)?.title)
-  const parsed = parseRange(range, video.size)
+  if (download) base['Content-Disposition'] = downloadDisposition(getPlayerSession(token)?.title, ext)
+  const parsed = parseRange(range, file.size)
   if (parsed === 'invalid') {
     return {
       status: 416,
-      headers: { ...base, 'Content-Range': 'bytes */' + video.size },
+      headers: { ...base, 'Content-Range': 'bytes */' + file.size },
       body: Buffer.from('请求的范围无效')
     }
   }
   if (!parsed) {
-    base['Content-Length'] = String(video.size)
-    return { status: 200, headers: base, file: head ? undefined : { path: video.path, start: 0, end: video.size - 1 } }
+    base['Content-Length'] = String(file.size)
+    return { status: 200, headers: base, file: head ? undefined : { path: file.path, start: 0, end: file.size - 1 } }
   }
   const length = parsed.end - parsed.start + 1
   return {
@@ -161,9 +181,70 @@ function videoResponse (token: string, range?: string, head = false, download =
     headers: {
       ...base,
       'Content-Length': String(length),
-      'Content-Range': 'bytes ' + parsed.start + '-' + parsed.end + '/' + video.size
+      'Content-Range': 'bytes ' + parsed.start + '-' + parsed.end + '/' + file.size
     },
-    file: head ? undefined : { path: video.path, start: parsed.start, end: parsed.end }
+    file: head ? undefined : { path: file.path, start: parsed.start, end: parsed.end }
+  }
+}
+
+/** 视频本体（分离音轨时这里只有画面） */
+function videoResponse (token: string, range?: string, head = false, download = false): PlayerHttpResponse {
+  const video = resolvePlayerVideo(token)
+  if (!video) return notFound(false)
+  return fileResponse(token, video, 'video/mp4', range, head, download, '.mp4')
+}
+
+/** 单独的音轨（B站这类音视频分离的）：\`<audio>\` 直接播它，\`?download=1\` 下载 m4a */
+function audioResponse (token: string, range?: string, head = false, download = false): PlayerHttpResponse {
+  const audio = resolvePlayerAudio(token)
+  if (!audio) return notFound(false)
+  return fileResponse(token, audio, 'audio/mp4', range, head, download, '.m4a')
+}
+
+/**
+ * **按需合成**：把画面和音轨用 ffmpeg 合成一条 mp4（\`-c copy\`，不重新编码，通常一两秒）。
+ *
+ * 为什么要按需：用户要求「默认不合并音频、浏览器里同时播放就行」——
+ * 解析时不再花时间合成，只有点了「服务器合并后下载」才做，而且做完会留在会话目录里，
+ * 同一条链接再点就是秒回（到期随会话一起删）。
+ *
+ * @returns 合成好的文件；没有独立音轨 / ffmpeg 失败时返回 null（路由回 404）
+ */
+async function ensureMerged (token: string): Promise<{ path: string, size: number } | null> {
+  const cached = resolvePlayerMerged(token)
+  if (cached) return cached
+  const video = resolvePlayerVideo(token)
+  const audio = resolvePlayerAudio(token)
+  if (!video || !audio) return null
+  const session = getPlayerSession(token)
+  if (!session) return null
+  const target = path.join(session.dir, 'merged.mp4')
+  const started = Date.now()
+  try {
+    const { spawn } = await import('node:child_process')
+    const { resolveFfmpegBin } = await import('node-karin')
+    const bin = resolveFfmpegBin()
+    await new Promise<void>((resolve, reject) => {
+      const proc = spawn(bin, [
+        '-y',
+        '-i', video.path,
+        '-i', audio.path,
+        '-c', 'copy',
+        '-movflags', '+faststart',
+        target
+      ], { stdio: 'ignore' })
+      proc.on('error', reject)
+      proc.on('close', (code) => (code === 0 ? resolve() : reject(new Error('ffmpeg exit ' + code))))
+    })
+    const stat = fs.statSync(target)
+    markPlayerMerged(token, 'merged.mp4')
+    logger.mark('[在线播放] 已按需合成音视频（' + (stat.size / 1024 / 1024).toFixed(1) + 'MB，'
+      + (Date.now() - started) + 'ms）：' + token)
+    return { path: target, size: stat.size }
+  } catch (error: any) {
+    logger.warn('[在线播放] 合成音视频失败（' + (Date.now() - started) + 'ms）: ' + String(error?.message ?? error))
+    try { fs.rmSync(target, { force: true }) } catch { /* 忽略 */ }
+    return null
   }
 }
 
@@ -228,6 +309,17 @@ export async function handlePlayerRequest (request: PlayerHttpRequest): Promise<
     }
   }
   if (action === 'video') return videoResponse(token, request.range, method === 'HEAD', wantDownload)
+  // 独立音轨（B站音视频分离时才有）：播放页的 <audio> 播它，?download=1 下载 m4a
+  if (action === 'audio') return audioResponse(token, request.range, method === 'HEAD', wantDownload)
+  /**
+   * 按需合成后下载 / 播放：第一次会跑一次 ffmpeg -c copy（一两秒），之后走缓存。
+   * 合成失败（没有独立音轨 / 没有 ffmpeg）回 404，页面上的按钮也就不该点得动。
+   */
+  if (action === 'merged') {
+    const merged = await ensureMerged(token)
+    if (!merged) return notFound(false)
+    return fileResponse(token, merged, 'video/mp4', request.range, method === 'HEAD', wantDownload, '.mp4')
+  }
   // 独立路由：`/kkk/player/<token>/download` 与 `/video?download=1` 完全等价
   if (action === 'download') return videoResponse(token, request.range, method === 'HEAD', true)
   if (action === 'danmaku') return danmakuResponse(token)

package/src/player/store.ts

@@ -50,6 +50,20 @@ export interface PlayerSession {
   filePath: string
   /** 视频大小（字节） */
   sizeBytes: number
+  /**
+   * **单独的音轨文件**（可选）。
+   *
+   * 用户要求「默认不要服务器合并音频，浏览器里同时播放就行」：B站是分离的音视频流，
+   * 以前要先用 ffmpeg 合成一条 mp4（慢、吃 CPU），现在**默认不合成** ——
+   * 视频流和音频流各存一份，播放页用 `<video muted>` + `<audio>` 同时播放。
+   * 只有用户点「服务器合并后下载」时才按需合成（见 server.ts 的 merged 路由）。
+   * 抖音那种本身就带音轨的视频没有这个字段。
+   */
+  audioPath?: string
+  /** 音轨大小（字节） */
+  audioSizeBytes?: number
+  /** 已经按需合成好的文件（会话目录里的文件名，例如 merged.mp4），第一次合并后记下来 */
+  merged?: string
   /** 弹幕条数 */
   danmakuCount: number
   /** 创建时间 */
@@ -180,6 +194,9 @@ function normalizeSession (raw: any): PlayerSession | null {
     platform: String(raw.platform ?? ''),
     dir: typeof raw.dir === 'string' && raw.dir ? raw.dir : path.dirname(filePath),
     filePath,
+    audioPath: typeof raw.audioPath === 'string' && raw.audioPath ? raw.audioPath : undefined,
+    audioSizeBytes: Number.isFinite(Number(raw.audioSizeBytes)) ? Number(raw.audioSizeBytes) : undefined,
+    merged: typeof raw.merged === 'string' && raw.merged ? raw.merged : undefined,
     sizeBytes: Number(raw.sizeBytes) || 0,
     danmakuCount: Number(raw.danmakuCount) || 0,
     createdAt: Number(raw.createdAt) || Date.now(),
@@ -263,6 +280,11 @@ function createToken (): string {
  */
 export function registerPlayerSession (input: {
   videoPath: string
+  /**
+   * 单独的音轨文件（可选，见 {@link PlayerSession.audioPath}）。
+   * 给了就一起搬进会话目录，播放页同时播放；没给就是「视频自带音轨」。
+   */
+  audioPath?: string
   title?: string
   platform?: string
   danmaku?: PlayerDanmakuItem[]
@@ -297,6 +319,26 @@ export function registerPlayerSession (input: {
       fs.rmSync(source, { force: true })
     }
 
+    /**
+     * 单独的音轨：也**搬**进会话目录（和视频同一套逻辑：同分区改名、跨分区复制 + 删源）。
+     * 搬不动就当作「没有独立音轨」，不影响视频本身能播。
+     */
+    let audioTarget: string | undefined
+    if (input.audioPath && fs.existsSync(input.audioPath)) {
+      const candidate = path.join(dir, 'audio.m4a')
+      try {
+        try {
+          fs.renameSync(input.audioPath, candidate)
+        } catch {
+          fs.copyFileSync(input.audioPath, candidate)
+          fs.rmSync(input.audioPath, { force: true })
+        }
+        audioTarget = candidate
+      } catch (error: any) {
+        logger.warn('[在线播放] 音轨文件搬进会话目录失败（将只播视频流）: ' + String(error?.message ?? error))
+      }
+    }
+
     const danmaku = Array.isArray(input.danmaku) ? input.danmaku : []
     fs.writeFileSync(path.join(dir, 'danmaku.json'), JSON.stringify({ total: danmaku.length, items: danmaku }))
 
@@ -322,6 +364,8 @@ export function registerPlayerSession (input: {
       dir,
       filePath: target,
       sizeBytes: Number(fs.statSync(target).size) || 0,
+      audioPath: audioTarget,
+      audioSizeBytes: audioTarget ? (Number(fs.statSync(audioTarget).size) || 0) : undefined,
       danmakuCount: danmaku.length,
       createdAt: now,
       expireAt: now + normalizeExpireMinutes(input.expireMinutes) * 60 * 1000,
@@ -413,6 +457,46 @@ export function resolvePlayerVideo (token: unknown): { path: string, size: numbe
   }
 }
 
+/**
+ * 取单独的音轨文件（没有独立音轨就返回 null，路由回 404）。
+ *
+ * 独立音轨 = 解析时没让服务器合成，播放页用 `<audio>` 和视频一起播（见 PlayerSession.audioPath）。
+ */
+export function resolvePlayerAudio (token: unknown): { path: string, size: number } | null {
+  const session = getPlayerSession(token)
+  const audioPath = session?.audioPath
+  if (!audioPath) return null
+  try {
+    const stat = fs.statSync(audioPath)
+    if (!stat.isFile()) return null
+    return { path: audioPath, size: stat.size }
+  } catch {
+    return null
+  }
+}
+
+/** 记住「按需合成的文件」文件名（它会留在会话目录里，到期一起清掉） */
+export function markPlayerMerged (token: string, fileName: string): void {
+  const session = sessions.get(String(token))
+  if (!session) return
+  session.merged = fileName
+  persistIndex()
+}
+
+/** 已经合成好的合并文件路径（没有就 null） */
+export function resolvePlayerMerged (token: unknown): { path: string, size: number } | null {
+  const session = getPlayerSession(token)
+  if (!session?.merged) return null
+  try {
+    const file = path.join(session.dir, session.merged)
+    const stat = fs.statSync(file)
+    if (!stat.isFile()) return null
+    return { path: file, size: stat.size }
+  } catch {
+    return null
+  }
+}
+
 /** 删掉一个会话的文件：先按 Common.removeFile 删视频，再把整个会话目录清掉 */
 async function removePlayerFiles (session: PlayerSession): Promise<void> {
   await removeFileQuietly(session.filePath)