koishi-plugin-kkk 3.7.0 → 3.7.1

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # 更新日志
 
+## 3.7.1
+
+> 修一个 3.7.0 改过头的地方：**视频直接发到群里的那种互动视频，照旧要在群里发带按钮的选择面板**；
+> 而且点完选项之后，**上一段视频会撤回**，群里只留当前这一段。
+
+### 互动视频：两种玩法各归各位
+
+- **选了在线播放**（或者视频太大、自动转成在线播放）：选项在网页播放器里贴出来，群里不再问一遍。
+- **视频直接发到群里**（没有播放页）：照旧在群里发**带按钮的选择面板** ——
+  QQ 官方机器人是按钮，其它平台是一行一个选项的文字，点一下接着播下一段。
+- **点完选项会撤回上一段视频**：不然玩几段之后，群里会躺着一串视频。
+  顺序是先发新的、再撤旧的，中间不会出现「一段视频都没有」的空档；
+  选择面板照旧是发新的时候撤掉旧的。
+- 剧情图（勾了「流程图」时）照常：第一段出一张，走到结局再出一张。
+
 ## 3.7.0
 
 > 互动视频这一版基本重做了：**选剧情搬到了网页播放器里**（选项就贴在画面上、点完能看到下载进度），

package/lib/build-metadata.json

@@ -1,7 +1,7 @@
 {
-  "version": "3.7.0",
-  "buildTime": "2026-09-25T18:12:21.026Z",
-  "buildTimestamp": 1790359941027,
+  "version": "3.7.1",
+  "buildTime": "2026-09-25T18:27:55.201Z",
+  "buildTimestamp": 1790360875202,
   "name": "koishi-plugin-kkk",
   "description": "抖音 / B站 / 快手 / 小红书 视频解析与动态推送，带 QQ 交互面板与弹幕烧录（karin-plugin-kkk 的 Koishi 移植版）",
   "homepage": "https://github.com/maimai993/koishi-plugin-kkk#readme",

package/lib/karin/module/utils/Base.js

@@ -51,6 +51,19 @@ const runtime_1 = require("../../../compat/runtime");
 const player_1 = require("../../../player");
 // 解析阶段（「下载进度」指令读的就是这里登记的状态）
 const Downloader_1 = require("./Network/Downloader");
+/** 发送结果里把消息 ID 抠出来（不同适配器返回的形状不一样：对象带 messageId、或者就是字符串数组） */
+const reportSent = (options, sent) => {
+    if (!options?.onSent)
+        return;
+    try {
+        const id = typeof sent === 'string'
+            ? sent
+            : (sent?.messageId ?? (Array.isArray(sent) ? sent[0] : ''));
+        if (id)
+            options.onSent(String(id));
+    }
+    catch { /* 拿不到 ID 不影响发送本身 */ }
+};
 /**
  * 基础基类
  * @remarks 提供事件上下文与通用请求头，继承自 `AmagiBase` 以复用 Amagi 客户端。
@@ -259,13 +272,15 @@ const uploadFile = async (event, file, videoUrl, options) => {
                 // 是群文件
                 const bot = node_karin_1.default.getBot(String(options.activeOption?.uin));
                 node_karin_1.logger.mark(`${node_karin_1.logger.blue('主动消息:')} 视频大小: ${newFileSize.toFixed(1)}MB 正在通过${node_karin_1.logger.yellow('bot.uploadFile')}回复...`);
-                await bot.uploadFile(contact, File, file.originTitle ? `${file.originTitle}.mp4` : `${File.split('/').pop()}`);
+                const sent = await bot.uploadFile(contact, File, file.originTitle ? `${file.originTitle}.mp4` : `${File.split('/').pop()}`);
+                reportSent(options, sent);
             }
             else {
                 // 不是群文件
                 node_karin_1.logger.mark(`${node_karin_1.logger.blue('主动消息:')} 视频大小: ${newFileSize.toFixed(1)}MB 正在通过${node_karin_1.logger.yellow('karin.sendMsg')}回复...`);
                 // 兼容层已经把「没拿到消息 ID」当成失败抛出（见 compat/sendError），所以这里没有异常就是发出去了
-                await node_karin_1.default.sendMsg(selfId, contact, [node_karin_1.segment.video(File)], { retryCount: 0 });
+                const sent = await node_karin_1.default.sendMsg(selfId, contact, [node_karin_1.segment.video(File)], { retryCount: 0 });
+                reportSent(options, sent);
                 sendStatus = true;
             }
         }
@@ -274,13 +289,15 @@ const uploadFile = async (event, file, videoUrl, options) => {
             if (useGroupFile) {
                 // 是文件
                 node_karin_1.logger.mark(`${node_karin_1.logger.blue('被动消息:')} 视频大小: ${newFileSize.toFixed(1)}MB 正在通过${node_karin_1.logger.yellow('e.bot.uploadFile')}回复...`);
-                await event.bot.uploadFile(event.contact, File, file.originTitle ? `${file.originTitle}.mp4` : `${File.split('/').pop()}`);
+                const sent = await event.bot.uploadFile(event.contact, File, file.originTitle ? `${file.originTitle}.mp4` : `${File.split('/').pop()}`);
+                reportSent(options, sent);
             }
             else {
                 // 不是文件
                 node_karin_1.logger.mark(`${node_karin_1.logger.blue('被动消息:')} 视频大小: ${newFileSize.toFixed(1)}MB 正在通过${node_karin_1.logger.yellow('e.reply')}回复...`);
                 // 同上：异常才是失败（没拿到消息 ID 已经由兼容层抛出来了）
-                await event.reply(node_karin_1.segment.video(File) || videoUrl);
+                const sent = await event.reply(node_karin_1.segment.video(File) || videoUrl);
+                reportSent(options, sent);
                 sendStatus = true;
             }
         }

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

@@ -588,15 +588,14 @@ class Bilibili extends utils_1.Base {
                             await downloadTask;
                             await this.sendPreparedVideo();
                             /**
-                             * 互动视频：**群里不再发「选择按钮」了**（用户要求）。
-                             *
-                             * 剧情选择整个搬到播放页上（选项贴在视频上、点完显示加载进度）；
-                             * 群里如果还同步问一遍，用户会被两处剧情各问一次。
-                             * 只有「视频直接发到群里、没走播放页」时，顺手补一张**剧情图**（图片，不是按钮）——
-                             * 用户至少能看到这张图里有几条分支。
+                             * 互动视频的剧情怎么走，看这次的视频发到哪儿：
+                             *   · **走在线播放**（视频没发进群里，用户在看播放页）→ 选项在播放页上贴出来，
+                             *     群里不再问一遍，免得两处各问一次（见 sendPreparedVideo 里的 story）；
+                             *   · **直接发到群里**（没有播放页）→ 照旧在群里发**带按钮的选择面板**，
+                             *     用户点一下播下一段，并撤回上一段视频（用户要求）。
                              */
                             if (this.interactive && !this.publishedStory)
-                                void this.sendInteractiveChartOnly();
+                                void this.startInteractiveStory();
                         });
                     }
                 }
@@ -1720,38 +1719,6 @@ class Bilibili extends utils_1.Base {
         }
         return this.preparedVideo !== null;
     }
-    /**
-     * 互动视频发到群里时：只补一张**剧情图**，不问选项（用户要求：群里不要选择按钮）。
-     *
-     * 选项流程在播放页里（见 sendPreparedVideo 的 story）；这里只把「有几条分支」画出来。
-     * 失败只记日志 —— 出不了图不影响视频已经发出去这件事。
-     */
-    async sendInteractiveChartOnly() {
-        const interactive = this.interactive;
-        if (!interactive)
-            return;
-        /** 没勾「流程图」就什么都不做（配置说了算） */
-        if (!Config_1.Config.bilibili.sendContent.some((item) => item === 'chart'))
-            return;
-        try {
-            const info = await (0, InteractiveVideo_1.fetchInteractiveInfo)({ bvid: interactive.bvid, cid: interactive.cid, headers: this.headers });
-            if (!info)
-                return;
-            await (0, interactive_story_1.renderInteractiveChart)({
-                e: this.e,
-                bvid: interactive.bvid,
-                graphVersion: info.graphVersion,
-                cid: interactive.cid,
-                title: this.workInfo?.title ?? '互动视频',
-                notice: info.notice,
-                headers: this.headers,
-                full: true
-            });
-        }
-        catch (error) {
-            node_karin_1.logger.debug('[互动视频] 群里补剧情图失败（不影响视频）: ' + String(error?.message ?? error));
-        }
-    }
     /**
      * 起一次互动剧情（后台长跑，不阻塞解析主流程）。
      *
@@ -1923,11 +1890,18 @@ class Bilibili extends utils_1.Base {
             }
             node_karin_1.logger.warn('[在线播放] 播放会话登记失败，退回直接发送视频文件');
         }
+        /**
+         * 互动视频（发到群里的那种）：把这条视频的消息 ID 记下来 ——
+         * 用户点了下一个选项之后，这条要撤回，群里只留当前这一段。
+         */
+        const sentOptions = this.interactive
+            ? { onSent: (messageId) => (0, interactive_story_1.rememberStoryVideo)(this.e, messageId) }
+            : undefined;
         if (totalBytes > Config_1.Config.app.groupfilevalue) {
-            await (0, utils_1.uploadFile)(this.e, { filepath, totalBytes, originTitle }, videoUrl ?? '', { useGroupFile: true });
+            await (0, utils_1.uploadFile)(this.e, { filepath, totalBytes, originTitle }, videoUrl ?? '', { useGroupFile: true, ...sentOptions });
         }
         else {
-            await (0, utils_1.uploadFile)(this.e, { filepath, totalBytes, originTitle }, videoUrl ?? '');
+            await (0, utils_1.uploadFile)(this.e, { filepath, totalBytes, originTitle }, videoUrl ?? '', sentOptions);
         }
         return true;
     }

package/lib/karin/platform/bilibili/interactive-story.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.interactiveChart = exports.renderInteractiveChart = exports.forgetChoiceMessage = exports.toCardGraph = exports.findNode = exports.runInteractiveStory = exports.sendStoryTip = exports.sendInteractiveChoices = exports.buildChoiceMessage = exports.RENDER_CHART_COMMAND = exports.CHOICE_WAIT_SECONDS = void 0;
+exports.interactiveChart = exports.renderInteractiveChart = exports.forgetChoiceMessage = exports.toCardGraph = exports.findNode = exports.runInteractiveStory = exports.sendStoryTip = exports.sendInteractiveChoices = exports.buildChoiceMessage = exports.rememberStoryVideo = exports.RENDER_CHART_COMMAND = exports.CHOICE_WAIT_SECONDS = void 0;
 /**
  * 互动视频的「发选项 → 等选择 → 播下一段」这一段流程。
  *
@@ -60,6 +60,43 @@ exports.CHOICE_WAIT_SECONDS = 180;
 exports.RENDER_CHART_COMMAND = '渲染流程图';
 /** 每个频道最近一条「选项消息」，用于发下一条之前撤回 */
 const lastChoiceMessages = new Map();
+/**
+ * 每个频道最近一条「剧情视频」的消息 ID。
+ *
+ * 用户要求：点一下选项，**上一段视频也要撤回** —— 不然玩几段之后群里躺着一串视频。
+ * 视频是解析链路发的（不是这里发的），所以由那边把它发出去的消息 ID 记进来。
+ */
+const lastStoryVideos = new Map();
+/** 记下刚发出去的剧情视频（由解析链路在上传成功时调用） */
+const rememberStoryVideo = (e, messageId) => {
+    if (!messageId)
+        return;
+    lastStoryVideos.set(sessionKeyOf(e), String(messageId));
+};
+exports.rememberStoryVideo = rememberStoryVideo;
+/**
+ * 取出并清掉「上一条剧情视频」的消息 ID。
+ *
+ * 取出来就删：这条只该被撤回一次，撤回失败也不能反复去点。
+ */
+const takeStoryVideo = (e) => {
+    const key = sessionKeyOf(e);
+    const messageId = lastStoryVideos.get(key);
+    if (messageId)
+        lastStoryVideos.delete(key);
+    return messageId;
+};
+/** 撤回某条消息（失败只记日志，绝不影响剧情） */
+const recallMessage = async (e, messageId) => {
+    if (!messageId)
+        return;
+    try {
+        await e.bot?.recallMsg?.(messageId, channelOf(e));
+    }
+    catch (error) {
+        node_karin_1.logger.debug('[互动视频] 撤回消息失败: ' + String(error?.message ?? error));
+    }
+};
 const platformOf = (e) => String(e?.bot?.bot?.platform ?? e?.bot?.platform ?? e?.platform ?? '');
 const channelOf = (e) => String(e?.contact?.peer ?? e?.guildId ?? '');
 /** 剧情会话 key（和 InteractiveVideo 里的口径一致） */
@@ -315,12 +352,20 @@ const runInteractiveStory = async (options) => {
         entry = { fromCid: currentCid, edgeId: choice.edgeId };
         currentCid = choice.cid;
         if (play) {
+            /**
+             * 用户要求：点一下选项，**上一段视频也要撤回**（群里只留当前这一段）。
+             *
+             * 顺序是「发新的 → 撤旧的」：先取走旧 ID（新的那条发出去时会被重新记上），
+             * 新的发完再撤旧的 —— 中间不会出现「一段视频都没有」的空档。
+             */
+            const previousVideo = takeStoryVideo(target);
             try {
                 await play(currentCid, target);
             }
             catch (error) {
                 node_karin_1.logger.warn('[互动视频] 播放下一段失败（cid=' + currentCid + '）: ' + String(error?.message ?? error));
             }
+            await recallMessage(target, previousVideo);
         }
         node = { ...next, cid: currentCid };
     }

package/package.json

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

package/scripts/smoke-interactive-story.cjs

@@ -145,6 +145,33 @@ const main = async () => {
   check('结局时撤回了上一条选项消息', state.recalled.length >= 1, JSON.stringify(state.recalled))
   check('结局有提示', state.replies.some((item) => String(item).includes('结局')), JSON.stringify(state.replies).slice(0, 200))
 
+  console.log('== 点一下选项：上一段视频也要撤回（用户要求）==')
+  {
+    const { e, state } = makeEvent('qqguild')
+    /** 解析链路发第一段视频时记下的消息 ID */
+    story.rememberStoryVideo(e, 'vid-root')
+    const playedVideo = []
+    const r = await runInteractiveStory({
+      e,
+      bvid: 'BV1xDgL6SEzk',
+      graphVersion: 1722536,
+      rootCid: 41156151510,
+      title: '史蒂夫的选择',
+      request: requestFor({ root: rootPayload, 11: leafPayload, 12: middlePayload }),
+      wait: async () => 'A',
+      play: async (cid) => {
+        playedVideo.push(cid)
+        /** 模拟解析链路：新一段视频发出去后把它的消息 ID 记进来 */
+        story.rememberStoryVideo(e, 'vid-' + cid)
+      }
+    })
+    check('选完播了下一段', playedVideo.join(',') === '101', playedVideo.join(','))
+    check('上一段视频被撤回了（群里只留当前这一段）', state.recalled.includes('vid-root'), JSON.stringify(state.recalled))
+    check('刚发出去的那一段没有被误撤', !state.recalled.includes('vid-101'), JSON.stringify(state.recalled))
+    check('同一条只撤一次（取走即清）', state.recalled.filter((id) => id === 'vid-root').length === 1, JSON.stringify(state.recalled))
+    check('剧情照常走完', r.ended === 'leaf', r.ended)
+  }
+
   console.log('== 结局那一段也要给上层画图的机会 ==')
   const endingHook = makeEvent('qqguild')
   const hookCalls = []

package/src/karin/module/utils/Base.ts

@@ -24,11 +24,29 @@ import {
 // 解析阶段（「下载进度」指令读的就是这里登记的状态）
 import { DOWNLOAD_STAGES, clearParseStage, updateDownloadStage } from './Network/Downloader'
 
+/** 发送结果里把消息 ID 抠出来（不同适配器返回的形状不一样：对象带 messageId、或者就是字符串数组） */
+const reportSent = (options: uploadFileOptions | undefined, sent: any): void => {
+  if (!options?.onSent) return
+  try {
+    const id = typeof sent === 'string'
+      ? sent
+      : (sent?.messageId ?? (Array.isArray(sent) ? sent[0] : ''))
+    if (id) options.onSent(String(id))
+  } catch { /* 拿不到 ID 不影响发送本身 */ }
+}
+
 type uploadFileOptions = {
   /** 是否使用群文件上传 */
   useGroupFile?: boolean
   /** 消息ID，如果有，则将使用该消息ID制作回复元素 */
   message_id?: string
+  /**
+   * 发出去了把消息 ID 交回来（可选）。
+   *
+   * 互动视频用它：下一段播出来之后要**撤回上一段那条视频**，群里只留当前这一段
+   * （不然点几次剧情，群里就躺着一串视频）。
+   */
+  onSent?: (messageId: string) => void
   /** 是否为主动消息 */
   active?: boolean
   /** 主动消息参数 */
@@ -351,12 +369,14 @@ export const uploadFile = async (event: Message, file: fileInfo, videoUrl: strin
         // 是群文件
         const bot = karin.getBot(String(options.activeOption?.uin))!
         logger.mark(`${logger.blue('主动消息:')} 视频大小: ${newFileSize.toFixed(1)}MB 正在通过${logger.yellow('bot.uploadFile')}回复...`)
-        await bot.uploadFile(contact, File, file.originTitle ? `${file.originTitle}.mp4` : `${File.split('/').pop()}`)
+        const sent: any = await bot.uploadFile(contact, File, file.originTitle ? `${file.originTitle}.mp4` : `${File.split('/').pop()}`)
+        reportSent(options, sent)
       } else {
         // 不是群文件
         logger.mark(`${logger.blue('主动消息:')} 视频大小: ${newFileSize.toFixed(1)}MB 正在通过${logger.yellow('karin.sendMsg')}回复...`)
         // 兼容层已经把「没拿到消息 ID」当成失败抛出（见 compat/sendError），所以这里没有异常就是发出去了
-        await karin.sendMsg(selfId, contact, [segment.video(File)], { retryCount: 0 })
+        const sent: any = await karin.sendMsg(selfId, contact, [segment.video(File)], { retryCount: 0 })
+        reportSent(options, sent)
         sendStatus = true
       }
     } else {
@@ -364,12 +384,14 @@ export const uploadFile = async (event: Message, file: fileInfo, videoUrl: strin
       if (useGroupFile) {
         // 是文件
         logger.mark(`${logger.blue('被动消息:')} 视频大小: ${newFileSize.toFixed(1)}MB 正在通过${logger.yellow('e.bot.uploadFile')}回复...`)
-        await event.bot.uploadFile(event.contact, File, file.originTitle ? `${file.originTitle}.mp4` : `${File.split('/').pop()}`)
+        const sent: any = await event.bot.uploadFile(event.contact, File, file.originTitle ? `${file.originTitle}.mp4` : `${File.split('/').pop()}`)
+        reportSent(options, sent)
       } else {
         // 不是文件
         logger.mark(`${logger.blue('被动消息:')} 视频大小: ${newFileSize.toFixed(1)}MB 正在通过${logger.yellow('e.reply')}回复...`)
         // 同上：异常才是失败（没拿到消息 ID 已经由兼容层抛出来了）
-        await event.reply(segment.video(File) || videoUrl)
+        const sent: any = await event.reply(segment.video(File) || videoUrl)
+        reportSent(options, sent)
         sendStatus = true
       }
     }

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

@@ -85,7 +85,11 @@ import {
   buildBilibiliVideoDescRichText,
   getUsernameMetadata
 } from '@/platform/bilibili/dynamic-text'
-import { runInteractiveStory, renderInteractiveChart as renderChart } from '@/platform/bilibili/interactive-story'
+import {
+  rememberStoryVideo,
+  renderInteractiveChart as renderChart,
+  runInteractiveStory
+} from '@/platform/bilibili/interactive-story'
 import { BilibiliDataTypes } from '@/types'
 
 let img: ElementTypes[]
@@ -664,14 +668,13 @@ export class Bilibili extends Base {
               await downloadTask
               await this.sendPreparedVideo()
               /**
-               * 互动视频：**群里不再发「选择按钮」了**（用户要求）。
-               *
-               * 剧情选择整个搬到播放页上（选项贴在视频上、点完显示加载进度）；
-               * 群里如果还同步问一遍，用户会被两处剧情各问一次。
-               * 只有「视频直接发到群里、没走播放页」时，顺手补一张**剧情图**（图片，不是按钮）——
-               * 用户至少能看到这张图里有几条分支。
+               * 互动视频的剧情怎么走，看这次的视频发到哪儿：
+               *   · **走在线播放**（视频没发进群里，用户在看播放页）→ 选项在播放页上贴出来，
+               *     群里不再问一遍，免得两处各问一次（见 sendPreparedVideo 里的 story）；
+               *   · **直接发到群里**（没有播放页）→ 照旧在群里发**带按钮的选择面板**，
+               *     用户点一下播下一段，并撤回上一段视频（用户要求）。
                */
-              if (this.interactive && !this.publishedStory) void this.sendInteractiveChartOnly()
+              if (this.interactive && !this.publishedStory) void this.startInteractiveStory()
             })
           }
         }
@@ -1935,35 +1938,6 @@ export class Bilibili extends Base {
     return this.preparedVideo !== null
   }
 
-  /**
-   * 互动视频发到群里时：只补一张**剧情图**，不问选项（用户要求：群里不要选择按钮）。
-   *
-   * 选项流程在播放页里（见 sendPreparedVideo 的 story）；这里只把「有几条分支」画出来。
-   * 失败只记日志 —— 出不了图不影响视频已经发出去这件事。
-   */
-  private async sendInteractiveChartOnly (): Promise<void> {
-    const interactive = this.interactive
-    if (!interactive) return
-    /** 没勾「流程图」就什么都不做（配置说了算） */
-    if (!Config.bilibili.sendContent.some((item) => item === 'chart')) return
-    try {
-      const info = await fetchInteractiveInfo({ bvid: interactive.bvid, cid: interactive.cid, headers: this.headers })
-      if (!info) return
-      await renderChart({
-        e: this.e,
-        bvid: interactive.bvid,
-        graphVersion: info.graphVersion,
-        cid: interactive.cid,
-        title: this.workInfo?.title ?? '互动视频',
-        notice: info.notice,
-        headers: this.headers,
-        full: true
-      })
-    } catch (error: any) {
-      logger.debug('[互动视频] 群里补剧情图失败（不影响视频）: ' + String(error?.message ?? error))
-    }
-  }
-
   /**
    * 起一次互动剧情（后台长跑，不阻塞解析主流程）。
    *
@@ -2136,10 +2110,17 @@ export class Bilibili extends Base {
       }
       logger.warn('[在线播放] 播放会话登记失败，退回直接发送视频文件')
     }
+    /**
+     * 互动视频（发到群里的那种）：把这条视频的消息 ID 记下来 ——
+     * 用户点了下一个选项之后，这条要撤回，群里只留当前这一段。
+     */
+    const sentOptions = this.interactive
+      ? { onSent: (messageId: string) => rememberStoryVideo(this.e, messageId) }
+      : undefined
     if (totalBytes > Config.app.groupfilevalue) {
-      await uploadFile(this.e, { filepath, totalBytes, originTitle }, videoUrl ?? '', { useGroupFile: true })
+      await uploadFile(this.e, { filepath, totalBytes, originTitle }, videoUrl ?? '', { useGroupFile: true, ...sentOptions })
     } else {
-      await uploadFile(this.e, { filepath, totalBytes, originTitle }, videoUrl ?? '')
+      await uploadFile(this.e, { filepath, totalBytes, originTitle }, videoUrl ?? '', sentOptions)
     }
     return true
   }

package/src/karin/platform/bilibili/interactive-story.ts

@@ -41,6 +41,42 @@ export const RENDER_CHART_COMMAND = '渲染流程图'
 /** 每个频道最近一条「选项消息」，用于发下一条之前撤回 */
 const lastChoiceMessages = new Map<string, string>()
 
+/**
+ * 每个频道最近一条「剧情视频」的消息 ID。
+ *
+ * 用户要求：点一下选项，**上一段视频也要撤回** —— 不然玩几段之后群里躺着一串视频。
+ * 视频是解析链路发的（不是这里发的），所以由那边把它发出去的消息 ID 记进来。
+ */
+const lastStoryVideos = new Map<string, string>()
+
+/** 记下刚发出去的剧情视频（由解析链路在上传成功时调用） */
+export const rememberStoryVideo = (e: Message, messageId: string | undefined): void => {
+  if (!messageId) return
+  lastStoryVideos.set(sessionKeyOf(e), String(messageId))
+}
+
+/**
+ * 取出并清掉「上一条剧情视频」的消息 ID。
+ *
+ * 取出来就删：这条只该被撤回一次，撤回失败也不能反复去点。
+ */
+const takeStoryVideo = (e: Message): string | undefined => {
+  const key = sessionKeyOf(e)
+  const messageId = lastStoryVideos.get(key)
+  if (messageId) lastStoryVideos.delete(key)
+  return messageId
+}
+
+/** 撤回某条消息（失败只记日志，绝不影响剧情） */
+const recallMessage = async (e: Message, messageId: string | undefined): Promise<void> => {
+  if (!messageId) return
+  try {
+    await (e.bot as any)?.recallMsg?.(messageId, channelOf(e))
+  } catch (error: any) {
+    logger.debug('[互动视频] 撤回消息失败: ' + String(error?.message ?? error))
+  }
+}
+
 const platformOf = (e: any): string =>
   String(e?.bot?.bot?.platform ?? e?.bot?.platform ?? e?.platform ?? '')
 
@@ -358,11 +394,19 @@ export const runInteractiveStory = async (options: StoryOptions): Promise<StoryR
     currentCid = choice.cid
 
     if (play) {
+      /**
+       * 用户要求：点一下选项，**上一段视频也要撤回**（群里只留当前这一段）。
+       *
+       * 顺序是「发新的 → 撤旧的」：先取走旧 ID（新的那条发出去时会被重新记上），
+       * 新的发完再撤旧的 —— 中间不会出现「一段视频都没有」的空档。
+       */
+      const previousVideo = takeStoryVideo(target)
       try {
         await play(currentCid, target)
       } catch (error: any) {
         logger.warn('[互动视频] 播放下一段失败（cid=' + currentCid + '）: ' + String(error?.message ?? error))
       }
+      await recallMessage(target, previousVideo)
     }
     node = { ...next, cid: currentCid }
   }