koishi-plugin-kkk 1.0.8 → 1.0.9

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # 更新日志
 
+## 1.0.9
+
+### 变更
+- **面板不再从独立 URL 进**：`/kkk`、`/kkk/edit` 以及 `/kkk/assets/*` 在未授权时直接返回 404
+  （以前是一个「需要先登录」的提示页）。面板只从控制台侧边栏「kkk 配置」进，
+  凭据由控制台页面通过 RPC 换取的面板 token 交付。
+- **QQ 平台单独的视频体积阈值**：新增配置项 `qqGroupFileLimitMB`（QQ 适配器分组，默认 30）——
+  视频超过该体积时改用「群文件」发送，不再受上游 `usegroupfile` 开关影响；
+  其它平台仍按上游的「群文件上传」+ `groupfilevalue` 判断。
+
+### 修复
+- 之前 30MB~100MB 的视频没有按群文件发送：运行时配置里 `groupfilevalue` 是 100（不是 30），
+  这一区间会走视频通道，被 QQ 压缩/改名。现在 QQ 用上面的独立阈值判断。
+
 ## 1.0.8
 
 ### 修复

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

@@ -179,17 +179,27 @@ const uploadFile = async (event, file, videoUrl, options) => {
         ];
         await node_karin_1.default.sendMsg(selfId, contact, message2);
     }
-    // 判断是否使用群文件上传
-    if (options) {
-        options.useGroupFile = Config_1.Config.app.usegroupfile && newFileSize > Config_1.Config.app.groupfilevalue;
-    }
-    if (Config_1.Config.app.videoSendMode === 'base64' && !options?.useGroupFile) {
+    /**
+     * 判断是否使用群文件上传。
+     *
+     * QQ 单独一套阈值（配置项 `qqGroupFileLimitMB`，默认 30）：超过就按群文件发。
+     * 原因是 QQ 对富媒体视频会压缩、改名甚至丢掉后缀，几十 MB 的视频走「视频」通道基本没法看；
+     * 其它平台仍旧按上游的「群文件上传」开关 + `groupfilevalue` 走。
+     */
+    const platform = String(event?.platform ?? event?.bot?.platform ?? '');
+    const qqLimit = Number(Config_1.Config.qqGroupFileLimitMB ?? 30);
+    const useGroupFile = /qq/i.test(platform) && qqLimit > 0
+        ? newFileSize > qqLimit
+        : Config_1.Config.app.usegroupfile && newFileSize > Config_1.Config.app.groupfilevalue;
+    if (options)
+        options.useGroupFile = useGroupFile;
+    if (Config_1.Config.app.videoSendMode === 'base64' && !useGroupFile) {
         const videoBuffer = node_fs_1.default.readFileSync(file.filepath);
         File = `base64://${videoBuffer.toString('base64')}`;
         node_karin_1.logger.mark(`已开启视频文件 base64转换 正在进行${node_karin_1.logger.yellow('base64转换中')}...`);
     }
     else
-        File = options?.useGroupFile ? file.filepath : `file://${file.filepath}`;
+        File = useGroupFile ? file.filepath : `file://${file.filepath}`;
     /**
      * 发送前：撤掉上一条「收到请求，开始下载」，并回一句「发送中…」。
      * 大文件上传（几十 MB 走文件通道）要等好几秒，没有任何反馈的话用户会以为机器人卡住了。
@@ -200,7 +210,7 @@ const uploadFile = async (event, file, videoUrl, options) => {
     try {
         if (!options?.active) {
             await (0, QqPanel_1.recallLastPanel)(event);
-            const tipText = options?.useGroupFile
+            const tipText = useGroupFile
                 ? '发送中…（超过 QQ 限制，将以群文件发送）'
                 : '发送中…';
             const tip = await event.reply(tipText);
@@ -213,7 +223,7 @@ const uploadFile = async (event, file, videoUrl, options) => {
     try {
         // 是主动消息
         if (options?.active) {
-            if (options.useGroupFile) {
+            if (useGroupFile) {
                 // 是群文件
                 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')}回复...`);
@@ -228,7 +238,7 @@ const uploadFile = async (event, file, videoUrl, options) => {
         }
         else {
             // 不是主动消息
-            if (options?.useGroupFile) {
+            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()}`);

package/lib/qqFields.json

@@ -71,5 +71,15 @@
         "label": "卡片文字识别密钥",
         "secret": true,
         "description": "群里转发过来的分享卡片没有链接，只能靠截图识别出标题和作者再去搜索。填自己的免费密钥更稳定：https://ocr.space/ocrapi 。留空会用公共测试密钥，容易被限流。"
+    },
+    {
+        "key": "qqGroupFileLimitMB",
+        "group": "视频发送",
+        "type": "number",
+        "default": 30,
+        "min": 0,
+        "max": 2000,
+        "label": "群文件发送阈值（MB）",
+        "description": "视频体积超过这个值时，改用「群文件」发送。QQ 对富媒体视频会压缩、改名甚至丢掉后缀，走群文件才能原样发出去；填 0 表示不启用。"
     }
 ]

package/lib/webui.js

@@ -406,16 +406,10 @@ function registerWebUi({ ctx, config, rawConfig, logger, pluginRoot }) {
             return false;
         if (await consoleAuthed(response))
             return false;
-        response.status = 401;
-        response.type = 'text/html; charset=utf-8';
-        response.body = [
-            '<!doctype html><meta charset="utf-8">',
-            '<div style="font-family:system-ui;padding:40px;line-height:1.8">',
-            '<h2>需要先登录 Koishi 控制台</h2>',
-            '<p>配置面板已开启登录校验（插件配置里的 <code>webUiAuth</code>）。</p>',
-            '<p><a href="/">去登录控制台</a>，登录后再回到本页面。</p>',
-            '</div>',
-        ].join('');
+        // 直接当成「没有这个页面」：面板只从控制台侧边栏进，独立 URL 不给任何提示
+        response.status = 404;
+        response.type = 'text/plain; charset=utf-8';
+        response.body = 'Not Found';
         return true;
     };
     /**
@@ -475,7 +469,9 @@ function registerWebUi({ ctx, config, rawConfig, logger, pluginRoot }) {
         });
     }
     /* ---------------- 简易编辑页（改插件配置） ---------------- */
-    server.get('/kkk/edit', (response) => {
+    server.get('/kkk/edit', async (response) => {
+        if (await pageDenied(response))
+            return;
         let body;
         try {
             body = node_fs_1.default.readFileSync(node_path_1.default.join(pluginRoot, 'assets', 'webui.html'), 'utf-8');

package/package.json

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

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

@@ -1,497 +1,506 @@
-import fs from 'node:fs'
-
-import karin, { type Contact, logger, Message, segment } from 'node-karin'
-import type { AxiosHeaders, AxiosRequestConfig, Method, RawAxiosRequestHeaders } from 'node-karin/axios'
-
-import { baseHeaders, Common, compressVideo, extractTotalBytesFromHeaders, getMediaDuration, Networks } from '@/module/utils'
-import { Config } from '@/module/utils/Config'
-// 撤回上一条面板 + 「发送中…」提示（见 QqPanel 的 recallLastPanel）
-import { recallLastPanel } from '@/module/utils/QqPanel'
-import type { pushlistConfig } from '@/types/config/pushlist'
-
-import { AmagiBase } from './amagiClient'
-
-type uploadFileOptions = {
-  /** 是否使用群文件上传 */
-  useGroupFile?: boolean
-  /** 消息ID，如果有，则将使用该消息ID制作回复元素 */
-  message_id?: string
-  /** 是否为主动消息 */
-  active?: boolean
-  /** 主动消息参数 */
-  activeOption?: {
-    /** 机器人账号 */
-    uin: string
-    /** 群号 */
-    group_id: string
-  }
-}
-
-/** 最少都要传一个 */
-type title = {
-  /** 文件名：自定义 */
-  originTitle?: string
-  /** 文件名：tmp + 时间戳 */
-  timestampTitle?: string
-}
-
-type downloadFileOptions = {
-  /** 视频链接 */
-  video_url: string
-  /** 文件名 */
-  title: title
-  /** 下载文件类型，默认为'.mp4'。 */
-  filetype?: string
-  /** 自定义请求头，将使用该请求头下载文件。 */
-  headers?: object
-}
-
-export type fileInfo = {
-  /** 视频文件的绝对路径 */
-  filepath: string
-  /** 视频文件大小 */
-  totalBytes: number
-  /** 文件名：自定义 */
-  originTitle?: title['originTitle']
-  /** 文件名：tmp + 时间戳 */
-  timestampTitle?: title['timestampTitle']
-}
-
-/**
- * 表示HTTP请求方法的请求头类型
- * @remarks
- * 这是一个部分类型，将HTTP方法映射到对应的AxiosHeaders类型
- * @property [method] - 每个HTTP方法(小写)对应的请求头
- * @property common - 通用请求头
- */
-type MethodsHeaders = Partial<
-  {
-    [Key in Method as Lowercase<Key>]: AxiosHeaders
-  } & { common: AxiosHeaders }
->
-
-/**
- * 下载文件的配置选项接口
- * @interface
- * @property title - 文件名
- * @property [headers] - 用于下载文件的请求头
- * @defaultValue headers - {}
- */
-export type downLoadFileOptions = {
-  /** 文件名 */
-  title: string
-  /**
-   * 将使用该请求头下载文件。
-   * @default {}
-   */
-  headers?: (RawAxiosRequestHeaders & MethodsHeaders) | AxiosHeaders
-  /** 文件保存路径 */
-  filepath?: string
-}
-
-/**
- * 基础基类
- * @remarks 提供事件上下文与通用请求头，继承自 `AmagiBase` 以复用 Amagi 客户端。
- */
-export class Base extends AmagiBase {
-  /** 事件对象 */
-  e: Message
-  /** 请求头 */
-  headers: AxiosRequestConfig['headers']
-
-  /**
-   * 构造函数：初始化事件与请求头
-   * @param e 消息事件对象
-   */
-  constructor(e: Message) {
-    super()
-    this.e = e
-    this.headers = baseHeaders
-  }
-}
-
-/** 统计每个平台使用最多的机器人ID和使用次数 */
-type PlatformBotStats = {
-  /** 机器人ID */
-  botId: string
-  /** 使用次数 */
-  count: number
-}
-
-/**
- * 统计每个平台使用最多的机器人ID和使用次数
- * @param pushList - 推送列表配置
- * @returns
- */
-export const statBotId = (pushList: pushlistConfig): { douyin: PlatformBotStats; bilibili: PlatformBotStats } => {
-  const platformBotCount = {
-    douyin: new Map<string, number>(),
-    bilibili: new Map<string, number>()
-  }
-
-  // 统计抖音平台机器人使用次数
-  pushList.douyin.forEach((item) => {
-    item.group_id.forEach((gid) => {
-      const botId = gid.split(':')[1]
-      platformBotCount.douyin.set(botId, (platformBotCount.douyin.get(botId) ?? 0) + 1)
-    })
-  })
-
-  // 统计B站平台机器人使用次数
-  pushList.bilibili.forEach((item) => {
-    item.group_id.forEach((gid) => {
-      const botId = gid.split(':')[1]
-      platformBotCount.bilibili.set(botId, (platformBotCount.bilibili.get(botId) ?? 0) + 1)
-    })
-  })
-
-  // 获取抖音平台使用最多的机器人
-  let douyinMaxCount = 0
-  let douyinMostFrequentBot = ''
-  platformBotCount.douyin.forEach((count, botId) => {
-    if (count > douyinMaxCount) {
-      douyinMaxCount = count
-      douyinMostFrequentBot = botId
-    }
-  })
-
-  // 获取B站平台使用最多的机器人
-  let biliMaxCount = 0
-  let biliMostFrequentBot = ''
-  platformBotCount.bilibili.forEach((count, botId) => {
-    if (count > biliMaxCount) {
-      biliMaxCount = count
-      biliMostFrequentBot = botId
-    }
-  })
-
-  return {
-    douyin: {
-      botId: douyinMostFrequentBot,
-      count: douyinMaxCount
-    },
-    bilibili: {
-      botId: biliMostFrequentBot,
-      count: biliMaxCount
-    }
-  }
-}
-
-/** 过万整除 */
-export const Count = (count: number): string => {
-  if (count >= 100000000) {
-    return (count / 100000000).toFixed(1) + '亿'
-  } else if (count >= 10000) {
-    return (count / 10000).toFixed(1) + '万'
-  } else {
-    return count?.toString() ?? '无法获取'
-  }
-}
-
-/**
- * 上传视频文件
- * @param event - 消息事件
- * @param file - 包含本地视频文件信息的对象。
- * @param videoUrl 视频直链，无则传空字符串
- * @param options 上传参数
- * @returns
- */
-export const uploadFile = async (event: Message, file: fileInfo, videoUrl: string, options?: uploadFileOptions): Promise<boolean> => {
-  let sendStatus: boolean = true
-  let File: string
-  let newFileSize = file.totalBytes
-  let selfId: string
-  let contact: Contact
-
-  if (options?.active) {
-    selfId = options?.activeOption?.uin as string
-    contact = karin.contactGroup(options?.activeOption?.group_id as string)
-  } else {
-    selfId = event.selfId
-    contact = event.contact
-  }
-
-  // 判断是否需要压缩后再上传
-  if (Config.app.compress && file.totalBytes > Config.app.compresstrigger) {
-    const Duration = await getMediaDuration(file.filepath)
-    logger.warn(
-      logger.yellow(
-        `视频大小 (${file.totalBytes} MB) 触发压缩条件（设定值：${Config.app.compresstrigger} MB），正在进行压缩至${Config.app.compressvalue} MB...`
-      )
-    )
-    const message = [
-      segment.text(
-        `视频大小 (${file.totalBytes} MB) 触发压缩条件（设定值：${Config.app.compresstrigger} MB），正在进行压缩至${Config.app.compressvalue} MB...`
-      ),
-      options?.message_id ? segment.reply(options.message_id) : segment.text('')
-    ]
-
-    const msg1 = await karin.sendMsg(selfId, contact, message)
-    // 计算目标视频平均码率
-    const targetBitrate = Common.calculateBitrate(Config.app.compresstrigger, Duration) * 0.75
-    // 执行压缩
-    const startTime = Date.now()
-    const outputPath = `${Common.tempDri.video}tmp_${Date.now()}.mp4`
-    await compressVideo({ inputPath: file.filepath, outputPath, targetBitrate })
-    file.filepath = outputPath
-    const endTime = Date.now()
-    // 再次检查大小
-    newFileSize = await Common.getVideoFileSize(file.filepath)
-    logger.debug(
-      `原始视频大小为: ${file.totalBytes.toFixed(1)} MB, ${logger.green(`经 FFmpeg 压缩后最终视频大小为: ${newFileSize.toFixed(1)} MB，原视频文件已删除`)}`
-    )
-
-    const message2 = [
-      segment.text(`压缩后最终视频大小为: ${newFileSize.toFixed(1)} MB，压缩耗时：${((endTime - startTime) / 1000).toFixed(1)} 秒`),
-      segment.reply(msg1.messageId)
-    ]
-    await karin.sendMsg(selfId, contact, message2)
-  }
-
-  // 判断是否使用群文件上传
-  if (options) {
-    options.useGroupFile = Config.app.usegroupfile && newFileSize > Config.app.groupfilevalue
-  }
-
-  if (Config.app.videoSendMode === 'base64' && !options?.useGroupFile) {
-    const videoBuffer = fs.readFileSync(file.filepath)
-    File = `base64://${videoBuffer.toString('base64')}`
-    logger.mark(`已开启视频文件 base64转换 正在进行${logger.yellow('base64转换中')}...`)
-  } else File = options?.useGroupFile ? file.filepath : `file://${file.filepath}`
-
-  /**
-   * 发送前：撤掉上一条「收到请求，开始下载」，并回一句「发送中…」。
-   * 大文件上传（几十 MB 走文件通道）要等好几秒，没有任何反馈的话用户会以为机器人卡住了。
-   *
-   * 超过 QQ 富媒体限制、要走群文件的那一档，在这里说清楚（表格里不再做文件标记）。
-   */
-  let sendingTipId: string | undefined
-  try {
-    if (!options?.active) {
-      await recallLastPanel(event)
-      const tipText = options?.useGroupFile
-        ? '发送中…（超过 QQ 限制，将以群文件发送）'
-        : '发送中…'
-      const tip: any = await event.reply(tipText)
-      sendingTipId = tip?.messageId
-    }
-  } catch (error) {
-    logger.debug('发送中提示失败: ' + String(error))
-  }
-
-  try {
-    // 是主动消息
-    if (options?.active) {
-      if (options.useGroupFile) {
-        // 是群文件
-        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()}`)
-      } else {
-        // 不是群文件
-        logger.mark(`${logger.blue('主动消息:')} 视频大小: ${newFileSize.toFixed(1)}MB 正在通过${logger.yellow('karin.sendMsg')}回复...`)
-        const status = await karin.sendMsg(selfId, contact, [segment.video(File)], { retryCount: 0 })
-        sendStatus = status.messageId ? true : false
-      }
-    } else {
-      // 不是主动消息
-      if (options?.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()}`)
-      } else {
-        // 不是文件
-        logger.mark(`${logger.blue('被动消息:')} 视频大小: ${newFileSize.toFixed(1)}MB 正在通过${logger.yellow('e.reply')}回复...`)
-        const status = await event.reply(segment.video(File) || videoUrl)
-        sendStatus = status.messageId ? true : false
-      }
-    }
-    // 发成功了就把「发送中…」收掉，群里只留下真正的视频
-    if (sendingTipId) {
-      try {
-        await (event.bot as any)?.recallMsg?.(sendingTipId, String(event.contact?.peer ?? event.channelId ?? ''))
-      } catch { /* 撤回失败无所谓 */ }
-    }
-    return sendStatus
-  } catch (error) {
-    if (options && options.active === false) {
-      await event.reply('视频文件上传失败' + JSON.stringify(error, null, 2))
-    }
-    logger.error('视频文件上传错误,' + String(error))
-    throw error // 重新抛出错误，让 wrapWithErrorHandler 能够捕获
-  } finally {
-    const filePath = file.filepath
-    Common.registerVideoPreview(filePath, Config.app.removeCache, 30 * 60 * 1000)
-    logger.mark(
-      `临时预览地址：http://localhost:${process.env.HTTP_PORT!}/kkk/ssr/video/${encodeURIComponent(filePath.split('/').pop() ?? '')}`
-    )
-    if (Config.app.removeCache) {
-      logger.info(`文件 ${filePath} 将在 30 分钟后删除`)
-    }
-    setTimeout(
-      async () => {
-        const removed = await Common.removeFile(filePath)
-        if (removed) {
-          Common.markVideoPreviewRemoved(filePath)
-        }
-      },
-      30 * 60 * 1000
-    )
-  }
-}
-
-/**
- * 下载视频并上传到群
- * @param event 事件
- * @param downloadOpt 下载参数
- * @param uploadOpt 上传参数
- * @returns
- */
-export const downloadVideo = async (event: Message, downloadOpt: downloadFileOptions, uploadOpt?: uploadFileOptions): Promise<boolean> => {
-  /** 获取文件大小 */
-  const fileHeaders = await new Networks({
-    url: downloadOpt.video_url,
-    headers: downloadOpt.headers ?? baseHeaders
-  }).getHeaders()
-  const fileSizeContent = extractTotalBytesFromHeaders(fileHeaders)
-  const fileSizeInMB = (fileSizeContent / (1024 * 1024)).toFixed(2)
-  const fileSize = parseInt(parseFloat(fileSizeInMB).toFixed(2))
-  if (fileSizeContent > 0 && Config.app.usefilelimit && fileSize > Config.app.filelimit) {
-    const message = segment.text(
-      `视频：「${
-        downloadOpt.title.originTitle ?? 'Error: 文件名获取失败'
-      }」大小 (${fileSizeInMB} MB) 超出最大限制（设定值：${Config.app.filelimit} MB），已取消上传`
-    )
-    const selfId = event.selfId || (uploadOpt?.activeOption?.uin as string)
-    const contact = event.contact || karin.contactGroup(uploadOpt?.activeOption?.group_id as string) || karin.contactFriend(selfId)
-
-    await karin.sendMsg(selfId, contact, message)
-    return false
-  }
-
-  // 下载文件，视频URL，标题和自定义headers
-  let res = await downloadFile(downloadOpt.video_url, {
-    title: Config.app.removeCache ? (downloadOpt.title.timestampTitle as string) : processFilename(downloadOpt.title.originTitle!, 50),
-    headers: downloadOpt.headers ?? baseHeaders
-  })
-  res = { ...res, ...downloadOpt.title }
-  // 将下载的文件大小转换为MB并保留两位小数
-  res.totalBytes = Number((res.totalBytes / (1024 * 1024)).toFixed(2))
-  /** 上传视频 */
-  return await uploadFile(event, res, downloadOpt.video_url, uploadOpt)
-}
-
-/**
- * 异步下载文件的函数。
- * @param videoUrl 下载地址。
- * @param opt 配置选项，包括标题、请求头等。
- * @returns 返回一个包含文件路径和总字节数的对象。
- */
-export const downloadFile = async (videoUrl: string, opt: downLoadFileOptions): Promise<fileInfo> => {
-  // 记录开始时间
-  const startTime = Date.now()
-
-  // 从配置中读取限速设置
-  const uploadConfig = Config.app
-  const throttleConfig = {
-    enabled: uploadConfig.downloadThrottle ?? false,
-    maxSpeed: (uploadConfig.downloadMaxSpeed ?? 10) * 1024 * 1024, // MB/s -> bytes/s
-    autoReduceRatio: uploadConfig.downloadAutoReduce ? 0.6 : 1, // 降速比例
-    minSpeed: (uploadConfig.downloadMinSpeed ?? 1) * 1024 * 1024 // MB/s -> bytes/s
-  }
-
-  try {
-    // 使用 networks 类进行文件下载，并通过回调函数实时更新下载进度
-    const { filepath, totalBytes } = await new Networks({
-      url: videoUrl,
-      headers: opt.headers ?? baseHeaders,
-      filepath: opt.filepath ?? Common.tempDri.video + opt.title,
-      timeout: 60000, // 增加超时时间
-      maxRetries: 3, // 增加重试次数
-      throttle: throttleConfig
-    }).downloadStream((downloadedBytes, totalBytes) => {
-      // 定义进度条长度及生成进度条字符串的函数
-      const barLength = 45
-      const generateProgressBar = (progressPercentage: number) => {
-        const clampedPercentage = Math.min(100, Math.max(0, progressPercentage))
-        const filledLength = Math.floor((clampedPercentage / 100) * barLength)
-        const emptyLength = Math.max(0, barLength - filledLength)
-        return `[${'\u2588'.repeat(filledLength)}${'\u2591'.repeat(emptyLength)}]`
-      }
-
-      // 计算当前下载进度百分比
-      const progressPercentage = totalBytes > 0 ? Math.min(100, (downloadedBytes / totalBytes) * 100) : 0
-
-      // 计算动态 RGB 颜色
-      const red = Math.floor(255 - (255 * progressPercentage) / 100) // 红色分量随进度减少
-      const coloredPercentage = logger.chalk.rgb(red, 255, 0)(`${progressPercentage.toFixed(1)}%`)
-
-      // 计算下载速度（MB/s）
-      const elapsedTime = (Date.now() - startTime) / 1000
-      const speed = downloadedBytes / elapsedTime
-      const formattedSpeed = (speed / 1048576).toFixed(1) + ' MB/s'
-
-      // 计算剩余时间
-      const remainingBytes = totalBytes - downloadedBytes // 剩余字节数
-      const remainingTime = remainingBytes / speed // 剩余时间（秒）
-      const formattedRemainingTime =
-        remainingTime > 60 ? `${Math.floor(remainingTime / 60)}min ${Math.floor(remainingTime % 60)}s` : `${remainingTime.toFixed(0)}s`
-
-      // 计算已下载和总下载的文件大小（MB）
-      const downloadedSizeMB = (downloadedBytes / 1048576).toFixed(1)
-      const totalSizeMB = (totalBytes / 1048576).toFixed(1)
-
-      // 打印下载进度、速度和剩余时间
-      console.log(
-        `⬇️  ${opt.title ?? (opt.filepath && opt.filepath.split('/').pop()) ?? '未知文件'} ${generateProgressBar(progressPercentage)} ${coloredPercentage} ${downloadedSizeMB}/${totalSizeMB} MB | ${formattedSpeed} 剩余: ${formattedRemainingTime}\r`
-      )
-    })
-
-    return { filepath, totalBytes }
-  } catch (error) {
-    // 检查是否为网络环境变化或服务器风控导致的错误
-    const errorMessage = error instanceof Error ? error.message : String(error)
-    const isNetworkChangeError = /ECONNRESET|ETIMEDOUT|ECONNABORTED|aborted|timeout|network|连接被重置|连接超时|连接中止/i.test(
-      errorMessage
-    )
-
-    if (isNetworkChangeError) {
-      logger.error('下载失败，可能是由于网络环境变化（如代理切换、VPN切换）或服务器风控导致')
-      logger.error(`文件: ${opt.title}`)
-      logger.error(`错误详情: ${errorMessage}`)
-
-      if (!uploadConfig.downloadThrottle) {
-        logger.error('提示: 如果频繁出现此错误，建议在配置中开启「下载限速」功能')
-      }
-    }
-
-    throw error
-  }
-}
-
-/**
- * 处理文件名长度，保留文件扩展名
- * @param filename 原始文件名
- * @param maxLength 最大长度（不包括扩展名）
- * @returns 处理后的文件名
- */
-const processFilename = (filename: string, maxLength: number = 50): string => {
-  // 提取文件扩展名
-  const lastDotIndex = filename.lastIndexOf('.')
-  const hasExtension = lastDotIndex > 0 && lastDotIndex < filename.length - 1
-
-  if (!hasExtension) {
-    // 没有扩展名，直接截取并清理特殊字符
-    return filename.substring(0, maxLength).replace(/[\\/:*?"<>|\r\n\s]/g, ' ')
-  }
-
-  // 分离文件名主体和扩展名
-  const nameWithoutExt = filename.substring(0, lastDotIndex)
-  const extension = filename.substring(lastDotIndex)
-
-  // 对文件名主体进行长度限制和特殊字符清理
-  const processedName = nameWithoutExt.substring(0, maxLength).replace(/[\\/:*?"<>|\r\n\s]/g, ' ')
-
-  // 重新拼接文件名和扩展名
-  return processedName + '...' + extension
-}
+import fs from 'node:fs'
+
+import karin, { type Contact, logger, Message, segment } from 'node-karin'
+import type { AxiosHeaders, AxiosRequestConfig, Method, RawAxiosRequestHeaders } from 'node-karin/axios'
+
+import { baseHeaders, Common, compressVideo, extractTotalBytesFromHeaders, getMediaDuration, Networks } from '@/module/utils'
+import { Config } from '@/module/utils/Config'
+// 撤回上一条面板 + 「发送中…」提示（见 QqPanel 的 recallLastPanel）
+import { recallLastPanel } from '@/module/utils/QqPanel'
+import type { pushlistConfig } from '@/types/config/pushlist'
+
+import { AmagiBase } from './amagiClient'
+
+type uploadFileOptions = {
+  /** 是否使用群文件上传 */
+  useGroupFile?: boolean
+  /** 消息ID，如果有，则将使用该消息ID制作回复元素 */
+  message_id?: string
+  /** 是否为主动消息 */
+  active?: boolean
+  /** 主动消息参数 */
+  activeOption?: {
+    /** 机器人账号 */
+    uin: string
+    /** 群号 */
+    group_id: string
+  }
+}
+
+/** 最少都要传一个 */
+type title = {
+  /** 文件名：自定义 */
+  originTitle?: string
+  /** 文件名：tmp + 时间戳 */
+  timestampTitle?: string
+}
+
+type downloadFileOptions = {
+  /** 视频链接 */
+  video_url: string
+  /** 文件名 */
+  title: title
+  /** 下载文件类型，默认为'.mp4'。 */
+  filetype?: string
+  /** 自定义请求头，将使用该请求头下载文件。 */
+  headers?: object
+}
+
+export type fileInfo = {
+  /** 视频文件的绝对路径 */
+  filepath: string
+  /** 视频文件大小 */
+  totalBytes: number
+  /** 文件名：自定义 */
+  originTitle?: title['originTitle']
+  /** 文件名：tmp + 时间戳 */
+  timestampTitle?: title['timestampTitle']
+}
+
+/**
+ * 表示HTTP请求方法的请求头类型
+ * @remarks
+ * 这是一个部分类型，将HTTP方法映射到对应的AxiosHeaders类型
+ * @property [method] - 每个HTTP方法(小写)对应的请求头
+ * @property common - 通用请求头
+ */
+type MethodsHeaders = Partial<
+  {
+    [Key in Method as Lowercase<Key>]: AxiosHeaders
+  } & { common: AxiosHeaders }
+>
+
+/**
+ * 下载文件的配置选项接口
+ * @interface
+ * @property title - 文件名
+ * @property [headers] - 用于下载文件的请求头
+ * @defaultValue headers - {}
+ */
+export type downLoadFileOptions = {
+  /** 文件名 */
+  title: string
+  /**
+   * 将使用该请求头下载文件。
+   * @default {}
+   */
+  headers?: (RawAxiosRequestHeaders & MethodsHeaders) | AxiosHeaders
+  /** 文件保存路径 */
+  filepath?: string
+}
+
+/**
+ * 基础基类
+ * @remarks 提供事件上下文与通用请求头，继承自 `AmagiBase` 以复用 Amagi 客户端。
+ */
+export class Base extends AmagiBase {
+  /** 事件对象 */
+  e: Message
+  /** 请求头 */
+  headers: AxiosRequestConfig['headers']
+
+  /**
+   * 构造函数：初始化事件与请求头
+   * @param e 消息事件对象
+   */
+  constructor(e: Message) {
+    super()
+    this.e = e
+    this.headers = baseHeaders
+  }
+}
+
+/** 统计每个平台使用最多的机器人ID和使用次数 */
+type PlatformBotStats = {
+  /** 机器人ID */
+  botId: string
+  /** 使用次数 */
+  count: number
+}
+
+/**
+ * 统计每个平台使用最多的机器人ID和使用次数
+ * @param pushList - 推送列表配置
+ * @returns
+ */
+export const statBotId = (pushList: pushlistConfig): { douyin: PlatformBotStats; bilibili: PlatformBotStats } => {
+  const platformBotCount = {
+    douyin: new Map<string, number>(),
+    bilibili: new Map<string, number>()
+  }
+
+  // 统计抖音平台机器人使用次数
+  pushList.douyin.forEach((item) => {
+    item.group_id.forEach((gid) => {
+      const botId = gid.split(':')[1]
+      platformBotCount.douyin.set(botId, (platformBotCount.douyin.get(botId) ?? 0) + 1)
+    })
+  })
+
+  // 统计B站平台机器人使用次数
+  pushList.bilibili.forEach((item) => {
+    item.group_id.forEach((gid) => {
+      const botId = gid.split(':')[1]
+      platformBotCount.bilibili.set(botId, (platformBotCount.bilibili.get(botId) ?? 0) + 1)
+    })
+  })
+
+  // 获取抖音平台使用最多的机器人
+  let douyinMaxCount = 0
+  let douyinMostFrequentBot = ''
+  platformBotCount.douyin.forEach((count, botId) => {
+    if (count > douyinMaxCount) {
+      douyinMaxCount = count
+      douyinMostFrequentBot = botId
+    }
+  })
+
+  // 获取B站平台使用最多的机器人
+  let biliMaxCount = 0
+  let biliMostFrequentBot = ''
+  platformBotCount.bilibili.forEach((count, botId) => {
+    if (count > biliMaxCount) {
+      biliMaxCount = count
+      biliMostFrequentBot = botId
+    }
+  })
+
+  return {
+    douyin: {
+      botId: douyinMostFrequentBot,
+      count: douyinMaxCount
+    },
+    bilibili: {
+      botId: biliMostFrequentBot,
+      count: biliMaxCount
+    }
+  }
+}
+
+/** 过万整除 */
+export const Count = (count: number): string => {
+  if (count >= 100000000) {
+    return (count / 100000000).toFixed(1) + '亿'
+  } else if (count >= 10000) {
+    return (count / 10000).toFixed(1) + '万'
+  } else {
+    return count?.toString() ?? '无法获取'
+  }
+}
+
+/**
+ * 上传视频文件
+ * @param event - 消息事件
+ * @param file - 包含本地视频文件信息的对象。
+ * @param videoUrl 视频直链，无则传空字符串
+ * @param options 上传参数
+ * @returns
+ */
+export const uploadFile = async (event: Message, file: fileInfo, videoUrl: string, options?: uploadFileOptions): Promise<boolean> => {
+  let sendStatus: boolean = true
+  let File: string
+  let newFileSize = file.totalBytes
+  let selfId: string
+  let contact: Contact
+
+  if (options?.active) {
+    selfId = options?.activeOption?.uin as string
+    contact = karin.contactGroup(options?.activeOption?.group_id as string)
+  } else {
+    selfId = event.selfId
+    contact = event.contact
+  }
+
+  // 判断是否需要压缩后再上传
+  if (Config.app.compress && file.totalBytes > Config.app.compresstrigger) {
+    const Duration = await getMediaDuration(file.filepath)
+    logger.warn(
+      logger.yellow(
+        `视频大小 (${file.totalBytes} MB) 触发压缩条件（设定值：${Config.app.compresstrigger} MB），正在进行压缩至${Config.app.compressvalue} MB...`
+      )
+    )
+    const message = [
+      segment.text(
+        `视频大小 (${file.totalBytes} MB) 触发压缩条件（设定值：${Config.app.compresstrigger} MB），正在进行压缩至${Config.app.compressvalue} MB...`
+      ),
+      options?.message_id ? segment.reply(options.message_id) : segment.text('')
+    ]
+
+    const msg1 = await karin.sendMsg(selfId, contact, message)
+    // 计算目标视频平均码率
+    const targetBitrate = Common.calculateBitrate(Config.app.compresstrigger, Duration) * 0.75
+    // 执行压缩
+    const startTime = Date.now()
+    const outputPath = `${Common.tempDri.video}tmp_${Date.now()}.mp4`
+    await compressVideo({ inputPath: file.filepath, outputPath, targetBitrate })
+    file.filepath = outputPath
+    const endTime = Date.now()
+    // 再次检查大小
+    newFileSize = await Common.getVideoFileSize(file.filepath)
+    logger.debug(
+      `原始视频大小为: ${file.totalBytes.toFixed(1)} MB, ${logger.green(`经 FFmpeg 压缩后最终视频大小为: ${newFileSize.toFixed(1)} MB，原视频文件已删除`)}`
+    )
+
+    const message2 = [
+      segment.text(`压缩后最终视频大小为: ${newFileSize.toFixed(1)} MB，压缩耗时：${((endTime - startTime) / 1000).toFixed(1)} 秒`),
+      segment.reply(msg1.messageId)
+    ]
+    await karin.sendMsg(selfId, contact, message2)
+  }
+
+  /**
+   * 判断是否使用群文件上传。
+   *
+   * QQ 单独一套阈值（配置项 `qqGroupFileLimitMB`，默认 30）：超过就按群文件发。
+   * 原因是 QQ 对富媒体视频会压缩、改名甚至丢掉后缀，几十 MB 的视频走「视频」通道基本没法看；
+   * 其它平台仍旧按上游的「群文件上传」开关 + `groupfilevalue` 走。
+   */
+  const platform = String((event as any)?.platform ?? (event as any)?.bot?.platform ?? '')
+  const qqLimit = Number((Config as any).qqGroupFileLimitMB ?? 30)
+  const useGroupFile = /qq/i.test(platform) && qqLimit > 0
+    ? newFileSize > qqLimit
+    : Config.app.usegroupfile && newFileSize > Config.app.groupfilevalue
+  if (options) options.useGroupFile = useGroupFile
+
+  if (Config.app.videoSendMode === 'base64' && !useGroupFile) {
+    const videoBuffer = fs.readFileSync(file.filepath)
+    File = `base64://${videoBuffer.toString('base64')}`
+    logger.mark(`已开启视频文件 base64转换 正在进行${logger.yellow('base64转换中')}...`)
+  } else File = useGroupFile ? file.filepath : `file://${file.filepath}`
+
+  /**
+   * 发送前：撤掉上一条「收到请求，开始下载」，并回一句「发送中…」。
+   * 大文件上传（几十 MB 走文件通道）要等好几秒，没有任何反馈的话用户会以为机器人卡住了。
+   *
+   * 超过 QQ 富媒体限制、要走群文件的那一档，在这里说清楚（表格里不再做文件标记）。
+   */
+  let sendingTipId: string | undefined
+  try {
+    if (!options?.active) {
+      await recallLastPanel(event)
+      const tipText = useGroupFile
+        ? '发送中…（超过 QQ 限制，将以群文件发送）'
+        : '发送中…'
+      const tip: any = await event.reply(tipText)
+      sendingTipId = tip?.messageId
+    }
+  } catch (error) {
+    logger.debug('发送中提示失败: ' + String(error))
+  }
+
+  try {
+    // 是主动消息
+    if (options?.active) {
+      if (useGroupFile) {
+        // 是群文件
+        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()}`)
+      } else {
+        // 不是群文件
+        logger.mark(`${logger.blue('主动消息:')} 视频大小: ${newFileSize.toFixed(1)}MB 正在通过${logger.yellow('karin.sendMsg')}回复...`)
+        const status = await karin.sendMsg(selfId, contact, [segment.video(File)], { retryCount: 0 })
+        sendStatus = status.messageId ? true : false
+      }
+    } else {
+      // 不是主动消息
+      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()}`)
+      } else {
+        // 不是文件
+        logger.mark(`${logger.blue('被动消息:')} 视频大小: ${newFileSize.toFixed(1)}MB 正在通过${logger.yellow('e.reply')}回复...`)
+        const status = await event.reply(segment.video(File) || videoUrl)
+        sendStatus = status.messageId ? true : false
+      }
+    }
+    // 发成功了就把「发送中…」收掉，群里只留下真正的视频
+    if (sendingTipId) {
+      try {
+        await (event.bot as any)?.recallMsg?.(sendingTipId, String(event.contact?.peer ?? event.channelId ?? ''))
+      } catch { /* 撤回失败无所谓 */ }
+    }
+    return sendStatus
+  } catch (error) {
+    if (options && options.active === false) {
+      await event.reply('视频文件上传失败' + JSON.stringify(error, null, 2))
+    }
+    logger.error('视频文件上传错误,' + String(error))
+    throw error // 重新抛出错误，让 wrapWithErrorHandler 能够捕获
+  } finally {
+    const filePath = file.filepath
+    Common.registerVideoPreview(filePath, Config.app.removeCache, 30 * 60 * 1000)
+    logger.mark(
+      `临时预览地址：http://localhost:${process.env.HTTP_PORT!}/kkk/ssr/video/${encodeURIComponent(filePath.split('/').pop() ?? '')}`
+    )
+    if (Config.app.removeCache) {
+      logger.info(`文件 ${filePath} 将在 30 分钟后删除`)
+    }
+    setTimeout(
+      async () => {
+        const removed = await Common.removeFile(filePath)
+        if (removed) {
+          Common.markVideoPreviewRemoved(filePath)
+        }
+      },
+      30 * 60 * 1000
+    )
+  }
+}
+
+/**
+ * 下载视频并上传到群
+ * @param event 事件
+ * @param downloadOpt 下载参数
+ * @param uploadOpt 上传参数
+ * @returns
+ */
+export const downloadVideo = async (event: Message, downloadOpt: downloadFileOptions, uploadOpt?: uploadFileOptions): Promise<boolean> => {
+  /** 获取文件大小 */
+  const fileHeaders = await new Networks({
+    url: downloadOpt.video_url,
+    headers: downloadOpt.headers ?? baseHeaders
+  }).getHeaders()
+  const fileSizeContent = extractTotalBytesFromHeaders(fileHeaders)
+  const fileSizeInMB = (fileSizeContent / (1024 * 1024)).toFixed(2)
+  const fileSize = parseInt(parseFloat(fileSizeInMB).toFixed(2))
+  if (fileSizeContent > 0 && Config.app.usefilelimit && fileSize > Config.app.filelimit) {
+    const message = segment.text(
+      `视频：「${
+        downloadOpt.title.originTitle ?? 'Error: 文件名获取失败'
+      }」大小 (${fileSizeInMB} MB) 超出最大限制（设定值：${Config.app.filelimit} MB），已取消上传`
+    )
+    const selfId = event.selfId || (uploadOpt?.activeOption?.uin as string)
+    const contact = event.contact || karin.contactGroup(uploadOpt?.activeOption?.group_id as string) || karin.contactFriend(selfId)
+
+    await karin.sendMsg(selfId, contact, message)
+    return false
+  }
+
+  // 下载文件，视频URL，标题和自定义headers
+  let res = await downloadFile(downloadOpt.video_url, {
+    title: Config.app.removeCache ? (downloadOpt.title.timestampTitle as string) : processFilename(downloadOpt.title.originTitle!, 50),
+    headers: downloadOpt.headers ?? baseHeaders
+  })
+  res = { ...res, ...downloadOpt.title }
+  // 将下载的文件大小转换为MB并保留两位小数
+  res.totalBytes = Number((res.totalBytes / (1024 * 1024)).toFixed(2))
+  /** 上传视频 */
+  return await uploadFile(event, res, downloadOpt.video_url, uploadOpt)
+}
+
+/**
+ * 异步下载文件的函数。
+ * @param videoUrl 下载地址。
+ * @param opt 配置选项，包括标题、请求头等。
+ * @returns 返回一个包含文件路径和总字节数的对象。
+ */
+export const downloadFile = async (videoUrl: string, opt: downLoadFileOptions): Promise<fileInfo> => {
+  // 记录开始时间
+  const startTime = Date.now()
+
+  // 从配置中读取限速设置
+  const uploadConfig = Config.app
+  const throttleConfig = {
+    enabled: uploadConfig.downloadThrottle ?? false,
+    maxSpeed: (uploadConfig.downloadMaxSpeed ?? 10) * 1024 * 1024, // MB/s -> bytes/s
+    autoReduceRatio: uploadConfig.downloadAutoReduce ? 0.6 : 1, // 降速比例
+    minSpeed: (uploadConfig.downloadMinSpeed ?? 1) * 1024 * 1024 // MB/s -> bytes/s
+  }
+
+  try {
+    // 使用 networks 类进行文件下载，并通过回调函数实时更新下载进度
+    const { filepath, totalBytes } = await new Networks({
+      url: videoUrl,
+      headers: opt.headers ?? baseHeaders,
+      filepath: opt.filepath ?? Common.tempDri.video + opt.title,
+      timeout: 60000, // 增加超时时间
+      maxRetries: 3, // 增加重试次数
+      throttle: throttleConfig
+    }).downloadStream((downloadedBytes, totalBytes) => {
+      // 定义进度条长度及生成进度条字符串的函数
+      const barLength = 45
+      const generateProgressBar = (progressPercentage: number) => {
+        const clampedPercentage = Math.min(100, Math.max(0, progressPercentage))
+        const filledLength = Math.floor((clampedPercentage / 100) * barLength)
+        const emptyLength = Math.max(0, barLength - filledLength)
+        return `[${'\u2588'.repeat(filledLength)}${'\u2591'.repeat(emptyLength)}]`
+      }
+
+      // 计算当前下载进度百分比
+      const progressPercentage = totalBytes > 0 ? Math.min(100, (downloadedBytes / totalBytes) * 100) : 0
+
+      // 计算动态 RGB 颜色
+      const red = Math.floor(255 - (255 * progressPercentage) / 100) // 红色分量随进度减少
+      const coloredPercentage = logger.chalk.rgb(red, 255, 0)(`${progressPercentage.toFixed(1)}%`)
+
+      // 计算下载速度（MB/s）
+      const elapsedTime = (Date.now() - startTime) / 1000
+      const speed = downloadedBytes / elapsedTime
+      const formattedSpeed = (speed / 1048576).toFixed(1) + ' MB/s'
+
+      // 计算剩余时间
+      const remainingBytes = totalBytes - downloadedBytes // 剩余字节数
+      const remainingTime = remainingBytes / speed // 剩余时间（秒）
+      const formattedRemainingTime =
+        remainingTime > 60 ? `${Math.floor(remainingTime / 60)}min ${Math.floor(remainingTime % 60)}s` : `${remainingTime.toFixed(0)}s`
+
+      // 计算已下载和总下载的文件大小（MB）
+      const downloadedSizeMB = (downloadedBytes / 1048576).toFixed(1)
+      const totalSizeMB = (totalBytes / 1048576).toFixed(1)
+
+      // 打印下载进度、速度和剩余时间
+      console.log(
+        `⬇️  ${opt.title ?? (opt.filepath && opt.filepath.split('/').pop()) ?? '未知文件'} ${generateProgressBar(progressPercentage)} ${coloredPercentage} ${downloadedSizeMB}/${totalSizeMB} MB | ${formattedSpeed} 剩余: ${formattedRemainingTime}\r`
+      )
+    })
+
+    return { filepath, totalBytes }
+  } catch (error) {
+    // 检查是否为网络环境变化或服务器风控导致的错误
+    const errorMessage = error instanceof Error ? error.message : String(error)
+    const isNetworkChangeError = /ECONNRESET|ETIMEDOUT|ECONNABORTED|aborted|timeout|network|连接被重置|连接超时|连接中止/i.test(
+      errorMessage
+    )
+
+    if (isNetworkChangeError) {
+      logger.error('下载失败，可能是由于网络环境变化（如代理切换、VPN切换）或服务器风控导致')
+      logger.error(`文件: ${opt.title}`)
+      logger.error(`错误详情: ${errorMessage}`)
+
+      if (!uploadConfig.downloadThrottle) {
+        logger.error('提示: 如果频繁出现此错误，建议在配置中开启「下载限速」功能')
+      }
+    }
+
+    throw error
+  }
+}
+
+/**
+ * 处理文件名长度，保留文件扩展名
+ * @param filename 原始文件名
+ * @param maxLength 最大长度（不包括扩展名）
+ * @returns 处理后的文件名
+ */
+const processFilename = (filename: string, maxLength: number = 50): string => {
+  // 提取文件扩展名
+  const lastDotIndex = filename.lastIndexOf('.')
+  const hasExtension = lastDotIndex > 0 && lastDotIndex < filename.length - 1
+
+  if (!hasExtension) {
+    // 没有扩展名，直接截取并清理特殊字符
+    return filename.substring(0, maxLength).replace(/[\\/:*?"<>|\r\n\s]/g, ' ')
+  }
+
+  // 分离文件名主体和扩展名
+  const nameWithoutExt = filename.substring(0, lastDotIndex)
+  const extension = filename.substring(lastDotIndex)
+
+  // 对文件名主体进行长度限制和特殊字符清理
+  const processedName = nameWithoutExt.substring(0, maxLength).replace(/[\\/:*?"<>|\r\n\s]/g, ' ')
+
+  // 重新拼接文件名和扩展名
+  return processedName + '...' + extension
+}

package/src/qqFields.json

@@ -71,5 +71,15 @@
     "label": "卡片文字识别密钥",
     "secret": true,
     "description": "群里转发过来的分享卡片没有链接，只能靠截图识别出标题和作者再去搜索。填自己的免费密钥更稳定：https://ocr.space/ocrapi 。留空会用公共测试密钥，容易被限流。"
+  },
+  {
+    "key": "qqGroupFileLimitMB",
+    "group": "视频发送",
+    "type": "number",
+    "default": 30,
+    "min": 0,
+    "max": 2000,
+    "label": "群文件发送阈值（MB）",
+    "description": "视频体积超过这个值时，改用「群文件」发送。QQ 对富媒体视频会压缩、改名甚至丢掉后缀，走群文件才能原样发出去；填 0 表示不启用。"
   }
 ]

package/src/webui.ts

@@ -414,16 +414,10 @@ export function registerWebUi ({ ctx, config, rawConfig, logger, pluginRoot }: W
   const pageDenied = async (response: any): Promise<boolean> => {
     if (!authRequired()) return false
     if (await consoleAuthed(response)) return false
-    response.status = 401
-    response.type = 'text/html; charset=utf-8'
-    response.body = [
-      '<!doctype html><meta charset="utf-8">',
-      '<div style="font-family:system-ui;padding:40px;line-height:1.8">',
-      '<h2>需要先登录 Koishi 控制台</h2>',
-      '<p>配置面板已开启登录校验（插件配置里的 <code>webUiAuth</code>）。</p>',
-      '<p><a href="/">去登录控制台</a>，登录后再回到本页面。</p>',
-      '</div>',
-    ].join('')
+    // 直接当成「没有这个页面」：面板只从控制台侧边栏进，独立 URL 不给任何提示
+    response.status = 404
+    response.type = 'text/plain; charset=utf-8'
+    response.body = 'Not Found'
     return true
   }
 
@@ -482,7 +476,8 @@ export function registerWebUi ({ ctx, config, rawConfig, logger, pluginRoot }: W
 
   /* ---------------- 简易编辑页（改插件配置） ---------------- */
 
-  server.get('/kkk/edit', (response: any) => {
+  server.get('/kkk/edit', async (response: any) => {
+    if (await pageDenied(response)) return
     let body: string
     try {
       body = fs.readFileSync(path.join(pluginRoot, 'assets', 'webui.html'), 'utf-8')