mioku-plugin-media 2.0.0 → 2.1.0

package/README.md

@@ -9,6 +9,15 @@
 - 返回封面图、标题、作者、简介和视频文件
 - 可选配置各平台 Cookies 以获取更高质量的视频
 
+## Cookies 配置
+
+配置 Cookies 可获取更高画质和完整解析能力。可使用内置扫码登录命令自动获取，或手动从浏览器复制。
+
+### 手动获取方式
+
+安装 Cookie-Editor 浏览器插件并在对应平台界面登录账号，点击 Cookie-Editor 右下方的导出，选择导出为字符串即可。
+
+
 ## 支持平台
 
 ### 哔哩哔哩
@@ -39,4 +48,4 @@
   },
   "debug": false
 }
-```
+```

package/config.md

@@ -15,7 +15,7 @@ fields:
   - key: base.cookies.kuaishou
     label: 快手 Cookie
     type: textarea
-    description: 快手 Cookie，配置后可获取更完整的视频信息。留空则使用基础解析。
+    description: 快手 Cookie，配置后可正常解析作品。留空则无法解析。
 
   - key: base.cookies.xiaohongshu
     label: 小红书 Cookie
@@ -26,4 +26,9 @@ fields:
     label: 调试模式
     type: switch
     description: 开启后解析失败时直接发送错误信息，不走 AI 通知
+
+  - key: base.maxVideoDurationSeconds
+    label: 视频解析时长上限
+    type: number
+    description: 允许解析的视频最大时长（秒），默认 1200（20分钟）。超过限制的视频将被拒绝解析。
 ---

package/config.ts

@@ -5,6 +5,7 @@ export interface MediaConfig {
     kuaishou: string;
     xiaohongshu: string;
   };
+  maxVideoDurationSeconds: number;
   debug: boolean;
 }
 
@@ -15,5 +16,6 @@ export const MEDIA_DEFAULTS: MediaConfig = {
     kuaishou: "",
     xiaohongshu: "",
   },
+  maxVideoDurationSeconds: 20 * 60,
   debug: false,
 };

package/index.ts

@@ -5,7 +5,7 @@ import { MEDIA_DEFAULTS } from "./config";
 import { createMediaAmagiClient } from "./platforms/amagi-client";
 import { extractMediaUrlFromEvent, resolveShortUrl, isShortUrl } from "./platforms/url-parser";
 import { resolveMedia } from "./platforms/resolvers";
-import { sendMediaResult } from "./utils/message";
+import { sendMediaResult, sendDurationLimitResult } from "./utils/message";
 import { handleMediaError } from "./utils/error-handler";
 import { setMediaRuntimeState, resetMediaRuntimeState } from "./runtime";
 
@@ -102,6 +102,23 @@ export default definePlugin({
         }
 
         const result = await resolveMedia(amagiClient, parsed);
+
+        if (result.duration && config.maxVideoDurationSeconds > 0) {
+          if (result.duration > config.maxVideoDurationSeconds) {
+            ctx.logger.warn(
+              `[media] 视频时长超过限制: ${result.duration}秒 > ${config.maxVideoDurationSeconds}秒`,
+            );
+            await sendDurationLimitResult(
+              ctx,
+              event,
+              parsed,
+              result,
+              Math.floor(config.maxVideoDurationSeconds / 60),
+            );
+            return;
+          }
+        }
+
         await sendMediaResult(ctx, event, parsed, result);
       } catch (error) {
         await handleMediaError({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mioku-plugin-media",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "流媒体解析插件，支持哔哩哔哩、抖音、小红书和快手平台",
   "main": "index.ts",
   "type": "module",

package/platforms/amagi-client.ts

@@ -27,8 +27,14 @@ export function createMediaAmagiClient(config: MediaConfig): AmagiClient {
     bilibili: {
       fetcher: client.bilibili.fetcher,
     },
+    douyin: {
+      fetcher: client.douyin.fetcher,
+    },
     kuaishou: {
       fetcher: client.kuaishou.fetcher,
     },
+    xiaohongshu: {
+      fetcher: client.xiaohongshu.fetcher,
+    },
   };
 }

package/platforms/resolvers/kuaishou.ts

@@ -2,17 +2,74 @@ import type { ParsedMediaResult } from "../../types";
 import type { AmagiClient, ParsedMediaUrl } from "../types";
 import type { PlatformResolver } from "./types";
 
+const KUAISHOU_SHORT_CODE_REGEX = /^([a-zA-Z0-9_-]+)$/;
+
+async function resolveKuaishouShortCode(shortCode: string): Promise<string> {
+  const url = `https://v.kuaishou.com/${shortCode}`;
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 10000);
+    const response = await fetch(url, {
+      redirect: "follow",
+      signal: controller.signal,
+    });
+    clearTimeout(timeout);
+    return response.url || url;
+  } catch {
+    return url;
+  }
+}
+
+function extractPhotoIdFromUrl(url: string): string | null {
+  const shortMatch = url.match(/\/short-video\/([a-zA-Z0-9_-]+)/);
+  if (shortMatch) return shortMatch[1];
+  const photoMatch = url.match(/\/photo\/([a-zA-Z0-9_-]+)/);
+  if (photoMatch) return photoMatch[1];
+  return null;
+}
+
 export class KuaishouResolver implements PlatformResolver {
-  async resolve(client: AmagiClient, parsed: ParsedMediaUrl): Promise<ParsedMediaResult> {
-    const photoId = parsed.id;
+  async resolve(
+    client: AmagiClient,
+    parsed: ParsedMediaUrl,
+  ): Promise<ParsedMediaResult> {
+    let photoId = parsed.id;
 
+    // If id is a short code (just the code like "KfhlEcGV"), resolve it first
+    if (
+      !parsed.id.startsWith("http") &&
+      KUAISHOU_SHORT_CODE_REGEX.test(parsed.id)
+    ) {
+      const resolvedUrl = await resolveKuaishouShortCode(parsed.id);
+      const extracted = extractPhotoIdFromUrl(resolvedUrl);
+      if (extracted) {
+        photoId = extracted;
+      }
+    } else if (parsed.id.startsWith("http")) {
+      // If id is a full URL, extract photoId from URL path
+      const extracted = extractPhotoIdFromUrl(parsed.id);
+      if (extracted) {
+        photoId = extracted;
+      }
+    }
     const result = await client.kuaishou.fetcher.fetchVideoWork({ photoId });
+
     if (!result.success) {
-      const isCookieError = result.code === 401 ||
-        (result.data as any)?.errorDescription?.includes("ck可能已经失效") ||
-        (result.data as any)?.errorDescription?.includes("接口返回内容为空");
-      if (isCookieError) {
-        throw new Error("快手Cookie无效或已过期，请检查配置");
+      const errorInfo = (result.error as any) || {};
+      const amagiError = errorInfo.amagiError as any;
+      const errorDesc =
+        amagiError?.errorDescription || errorInfo.errorDescription || "";
+      const errorCode = result.code as any;
+
+      if (
+        errorDesc.includes("ck可能已经失效") ||
+        errorDesc.includes("接口返回内容为空") ||
+        errorCode === "INVALID_COOKIE" ||
+        errorCode === "UNKNOWN_ERROR"
+      ) {
+        throw new Error(
+          "快手接口返回内容为空，可能是作品不存在、链接有误或需要登录。请确认链接是否正确，或检查作品是否公开。",
+        );
       }
       throw new Error(`快手作品解析失败: ${result.message}`);
     }
@@ -38,10 +95,16 @@ export class KuaishouResolver implements PlatformResolver {
       videoUrl = photo.photoUrl;
     } else if (photo.croppedPhotoUrl) {
       videoUrl = photo.croppedPhotoUrl;
-    } else if (photo.videoResource?.h264?.adaptationSet?.[0]?.representation?.[0]?.url) {
-      videoUrl = photo.videoResource.h264.adaptationSet[0].representation[0].url;
-    } else if (photo.videoResource?.hevc?.adaptationSet?.[0]?.representation?.[0]?.url) {
-      videoUrl = photo.videoResource.hevc.adaptationSet[0].representation[0].url;
+    } else if (
+      photo.videoResource?.h264?.adaptationSet?.[0]?.representation?.[0]?.url
+    ) {
+      videoUrl =
+        photo.videoResource.h264.adaptationSet[0].representation[0].url;
+    } else if (
+      photo.videoResource?.hevc?.adaptationSet?.[0]?.representation?.[0]?.url
+    ) {
+      videoUrl =
+        photo.videoResource.hevc.adaptationSet[0].representation[0].url;
     } else if (photo.manifest?.adaptationSet?.[0]?.representation?.[0]?.url) {
       videoUrl = photo.manifest.adaptationSet[0].representation[0].url;
     }
@@ -49,7 +112,11 @@ export class KuaishouResolver implements PlatformResolver {
     const images: string[] = [];
     if (!videoUrl && photo.images && Array.isArray(photo.images)) {
       for (const img of photo.images) {
-        const url = img?.url || img?.url_list?.[0] || img?.download_addr?.url_list?.[0] || "";
+        const url =
+          img?.url ||
+          img?.url_list?.[0] ||
+          img?.download_addr?.url_list?.[0] ||
+          "";
         if (url) images.push(url);
       }
     }
@@ -70,4 +137,4 @@ export class KuaishouResolver implements PlatformResolver {
       },
     };
   }
-}
+}

package/platforms/types.ts

@@ -44,9 +44,35 @@ export interface AmagiClient {
         typeMode?: "strict" | "loose";
       }): Promise<{
         success: boolean;
-        code?: number;
+        code?: number | string | undefined;
         data: any;
         message?: string;
+        error?: any;
+      }>;
+    };
+  };
+  douyin: {
+    fetcher: {
+      parseWork(options: {
+        aweme_id: string;
+        typeMode?: "strict" | "loose";
+      }): Promise<{
+        success: boolean;
+        data?: any;
+        message?: string;
+      }>;
+    };
+  };
+  xiaohongshu: {
+    fetcher: {
+      fetchNoteDetail(options: {
+        note_id: string;
+        xsec_token: string;
+        typeMode?: "strict" | "loose";
+      }): Promise<{
+        success: boolean;
+        data?: any;
+        message?: string;
       }>;
     };
   };

package/platforms/url-parser.ts

@@ -206,7 +206,8 @@ function parseKuaishouUrl(url: string): ParsedMediaUrl | null {
   // Handle v.kuaishou.com/xxx short URLs like https://v.kuaishou.com/KfhlEcGV
   const shortCodeMatch = url.match(/:\/\/[^/]+\/([a-zA-Z0-9_-]+)/);
   if (shortCodeMatch) {
-    return { platform: "kuaishou", id: shortCodeMatch[1], subtype: "video" };
+    // Store full URL so isShortUrl can detect it and resolveShortUrl can work
+    return { platform: "kuaishou", id: url, subtype: "video" };
   }
 
   return null;
@@ -393,29 +394,29 @@ export function extractMediaUrlFromEvent(event: any): ParsedMediaUrl | null {
 
 export function resolveShortUrl(url: string): Promise<string> {
   return new Promise((resolve) => {
-    try {
-      const controller = new AbortController();
-      const timeout = setTimeout(() => {
-        controller.abort();
-        resolve(url);
-      }, 5000);
-
-      fetch(url, {
-        redirect: "follow",
-        signal: controller.signal,
-        method: "HEAD",
-      })
-        .then((response) => {
-          clearTimeout(timeout);
-          resolve(response.url || url);
-        })
-        .catch(() => {
-          clearTimeout(timeout);
-          resolve(url);
-        });
-    } catch {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => {
+      controller.abort();
       resolve(url);
-    }
+    }, 10000);
+
+    fetch(url, {
+      redirect: "follow",
+      signal: controller.signal,
+    })
+      .then((response) => {
+        clearTimeout(timeout);
+        const finalUrl = response.url;
+        if (finalUrl && finalUrl !== url) {
+          resolve(finalUrl);
+        } else {
+          resolve(url);
+        }
+      })
+      .catch(() => {
+        clearTimeout(timeout);
+        resolve(url);
+      });
   });
 }
 

package/utils/error-handler.ts

@@ -1,5 +1,8 @@
 import type { MiokiContext } from "mioki";
 import type { MediaConfig } from "../types";
+import type { ParsedMediaUrl } from "../platforms/types";
+import type { ParsedMediaResult } from "../types";
+import type { SendNodeElement, SendNodeContentElement } from "napcat-sdk";
 
 function normalizeErrorMessage(error: unknown): string {
   if (error instanceof Error && error.message) {
@@ -24,5 +27,34 @@ export async function handleMediaError(options: {
 }): Promise<void> {
   const { ctx, error, platform } = options;
   const errorMessage = normalizeErrorMessage(error);
-  ctx.logger.error(`[media] ${platform} 解析失败: ${errorMessage}`, error);
+  ctx.logger.error(`[media] ${platform} 解析失败: ${errorMessage}`);
+
+  // 尝试获取 bot 发送错误信息给用户
+  const selfId = event?.self_id != null ? Number(event.self_id) : undefined;
+  const bot =
+    selfId != null && typeof ctx?.pickBot === "function"
+      ? ctx.pickBot(selfId)
+      : undefined;
+
+  if (!bot) return;
+
+  const nickname = String(
+    ctx?.bot?.nickname || event?.sender?.card || event?.sender?.nickname || "媒体解析",
+  );
+  const userId = String(selfId || ctx?.bot?.bot_id || event?.self_id || 0);
+
+  // 构建错误提示消息
+  const errorText = `【${platform}】解析失败\n${errorMessage}`;
+
+  try {
+    if (event?.message_type === "group" && event?.group_id != null) {
+      await bot.sendGroupMsg(event.group_id, [ctx.segment.text(errorText)]);
+      return;
+    }
+    if (event?.user_id != null) {
+      await bot.sendPrivateMsg(event.user_id, [ctx.segment.text(errorText)]);
+    }
+  } catch {
+    // ignore send errors
+  }
 }

package/utils/message.ts

@@ -1,4 +1,8 @@
-import type { SendNodeElement, SendNodeContentElement, ForwardDisplayOptions } from "napcat-sdk";
+import type {
+  SendNodeElement,
+  SendNodeContentElement,
+  ForwardDisplayOptions,
+} from "napcat-sdk";
 import type { ParsedMediaResult, MediaStats } from "../types";
 import type { ParsedMediaUrl } from "../platforms/types";
 
@@ -37,7 +41,10 @@ function formatCount(count?: number): string {
   return String(count);
 }
 
-export function buildInfoMessage(parsed: ParsedMediaUrl, result: ParsedMediaResult): string {
+export function buildInfoMessage(
+  parsed: ParsedMediaUrl,
+  result: ParsedMediaResult,
+): string {
   const platform = PLATFORM_NAMES[parsed.platform] || parsed.platform;
   const lines: string[] = [];
 
@@ -68,24 +75,32 @@ export function buildInfoMessage(parsed: ParsedMediaUrl, result: ParsedMediaResu
   return lines.join("\n");
 }
 
-function buildSummaryText(platform: string, subtype: string | undefined, stats?: MediaStats): string {
+function buildSummaryText(
+  platform: string,
+  subtype: string | undefined,
+  stats?: MediaStats,
+): string {
   if (!stats) return "";
 
   const parts: string[] = [];
 
   if (platform === "bilibili") {
     if (subtype === "live") {
-      if (stats.views != null && stats.views > 0) parts.push(`在线${formatCount(stats.views)}`);
-      if (stats.comments != null && stats.comments > 0) parts.push(`关注${formatCount(stats.comments)}`);
+      if (stats.views != null && stats.views > 0)
+        parts.push(`在线${formatCount(stats.views)}`);
+      if (stats.comments != null && stats.comments > 0)
+        parts.push(`关注${formatCount(stats.comments)}`);
     } else {
       if (stats.likes != null) parts.push(`赞${formatCount(stats.likes)}`);
       if (stats.coins != null) parts.push(`币${formatCount(stats.coins)}`);
-      if (stats.favorites != null) parts.push(`藏${formatCount(stats.favorites)}`);
+      if (stats.favorites != null)
+        parts.push(`藏${formatCount(stats.favorites)}`);
       if (stats.shares != null) parts.push(`转${formatCount(stats.shares)}`);
     }
   } else {
     if (stats.likes != null) parts.push(`赞${formatCount(stats.likes)}`);
-    if (stats.favorites != null) parts.push(`藏${formatCount(stats.favorites)}`);
+    if (stats.favorites != null)
+      parts.push(`藏${formatCount(stats.favorites)}`);
     if (stats.shares != null) parts.push(`转${formatCount(stats.shares)}`);
     if (stats.comments != null) parts.push(`评${formatCount(stats.comments)}`);
   }
@@ -93,7 +108,10 @@ function buildSummaryText(platform: string, subtype: string | undefined, stats?:
   return parts.join(" ");
 }
 
-function buildForwardDisplay(parsed: ParsedMediaUrl, result: ParsedMediaResult): ForwardDisplayOptions {
+function buildForwardDisplay(
+  parsed: ParsedMediaUrl,
+  result: ParsedMediaResult,
+): ForwardDisplayOptions {
   const displayTitle = PLATFORM_DISPLAY_TITLES[parsed.platform] || "媒体解析";
 
   let summary = buildSummaryText(parsed.platform, parsed.subtype, result.stats);
@@ -114,10 +132,7 @@ function buildForwardDisplay(parsed: ParsedMediaUrl, result: ParsedMediaResult):
 
   return {
     source: displayTitle,
-    news: [
-      { text: truncateText(result.title, 26) },
-      { text: result.author },
-    ],
+    news: [{ text: truncateText(result.title, 26) }, { text: result.author }],
     summary,
   };
 }
@@ -149,6 +164,15 @@ function buildForwardNodes(
 ): SendNodeElement[] {
   const nodes: SendNodeElement[] = [];
 
+  // 简介文字优先
+  const infoText = buildInfoMessage(parsed, result);
+  nodes.push({
+    type: "node",
+    user_id: userId,
+    nickname,
+    content: [ctx.segment.text(infoText)],
+  } as SendNodeContentElement);
+
   if (result.coverUrl) {
     nodes.push({
       type: "node",
@@ -158,14 +182,6 @@ function buildForwardNodes(
     } as SendNodeContentElement);
   }
 
-  const infoText = buildInfoMessage(parsed, result);
-  nodes.push({
-    type: "node",
-    user_id: userId,
-    nickname,
-    content: [ctx.segment.text(infoText)],
-  } as SendNodeContentElement);
-
   // 处理图片集/合辑
   if (result.images && result.images.length > 0) {
     // 如果既有图片又有视频/实况图，发送纯图片
@@ -254,7 +270,10 @@ export async function sendMediaResult(
   }
 
   const nickname = String(
-    ctx?.bot?.nickname || event?.sender?.card || event?.sender?.nickname || "媒体解析",
+    ctx?.bot?.nickname ||
+      event?.sender?.card ||
+      event?.sender?.nickname ||
+      "媒体解析",
   );
   const userId = String(selfId || ctx?.bot?.bot_id || event?.self_id || 0);
 
@@ -262,53 +281,112 @@ export async function sendMediaResult(
   const forwardPayload = toOneBotForwardFormat(nodes);
   const display = buildForwardDisplay(parsed, result);
 
-  try {
-    if (event?.message_type === "group" && event?.group_id != null) {
-      await bot.api("send_group_forward_msg", {
-        group_id: event.group_id,
-        messages: forwardPayload,
-        source: display.source,
-        news: display.news,
-        summary: display.summary,
-      });
-      return;
-    }
+  if (event?.message_type === "group" && event?.group_id != null) {
+    await bot.api("send_group_forward_msg", {
+      group_id: event.group_id,
+      messages: forwardPayload,
+      source: display.source,
+      news: display.news,
+      summary: display.summary,
+    });
+    return;
+  }
 
-    if (event?.user_id != null) {
-      await bot.api("send_private_forward_msg", {
-        user_id: event.user_id,
-        messages: forwardPayload,
-        source: display.source,
-        news: display.news,
-        summary: display.summary,
-      });
-      return;
-    }
-  } catch (primaryError) {
-    try {
-      if (event?.message_type === "group" && event?.group_id != null) {
-        const textPayload = [ctx.segment.text(buildInfoMessage(parsed, result))];
-        if (result.coverUrl) {
-          await bot.sendGroupMsg(event.group_id, [ctx.segment.image(result.coverUrl), ...textPayload]);
-        } else {
-          await bot.sendGroupMsg(event.group_id, textPayload);
-        }
-        return;
-      }
-      if (event?.user_id != null) {
-        const textPayload = [ctx.segment.text(buildInfoMessage(parsed, result))];
-        if (result.coverUrl) {
-          await bot.sendPrivateMsg(event.user_id, [ctx.segment.image(result.coverUrl), ...textPayload]);
-        } else {
-          await bot.sendPrivateMsg(event.user_id, textPayload);
-        }
-        return;
-      }
-    } catch {
-      // fallback to text reply
+  if (event?.user_id != null) {
+    await bot.api("send_private_forward_msg", {
+      user_id: event.user_id,
+      messages: forwardPayload,
+      source: display.source,
+      news: display.news,
+      summary: display.summary,
+    });
+  }
+}
+
+export async function sendDurationLimitResult(
+  ctx: any,
+  event: any,
+  parsed: ParsedMediaUrl,
+  result: ParsedMediaResult,
+  limitMinutes: number,
+): Promise<void> {
+  const selfId = event?.self_id != null ? Number(event.self_id) : undefined;
+  const bot =
+    selfId != null && typeof ctx?.pickBot === "function"
+      ? ctx.pickBot(selfId)
+      : undefined;
+
+  if (!bot) {
+    await event.reply(
+      `【${PLATFORM_NAMES[parsed.platform] || parsed.platform}】视频太大了，发不出来～`,
+    );
+    return;
+  }
+
+  const nickname = String(
+    ctx?.bot?.nickname ||
+      event?.sender?.card ||
+      event?.sender?.nickname ||
+      "媒体解析",
+  );
+  const userId = String(selfId || ctx?.bot?.bot_id || event?.self_id || 0);
+
+  const nodes: SendNodeElement[] = [];
+
+  const platform = PLATFORM_NAMES[parsed.platform] || parsed.platform;
+  const mins = Math.floor((result.duration || 0) / 60);
+  const secs = (result.duration || 0) % 60;
+  const infoText = `【${platform}】${result.title}\n作者：${result.author}\n时长：${mins}分${secs}秒\n\n哎嘿，视频太大了发不出来～请选择更短的视频（不超过 ${limitMinutes} 分钟）`;
+
+  nodes.push({
+    type: "node",
+    user_id: userId,
+    nickname,
+    content: [ctx.segment.text(infoText)],
+  } as SendNodeContentElement);
+
+  if (result.coverUrl) {
+    nodes.push({
+      type: "node",
+      user_id: userId,
+      nickname,
+      content: [ctx.segment.image(result.coverUrl)],
+    } as SendNodeContentElement);
+  }
+
+  // 只发图片，不发视频
+  if (result.images && result.images.length > 0) {
+    for (const imageUrl of result.images) {
+      nodes.push({
+        type: "node",
+        user_id: userId,
+        nickname,
+        content: [ctx.segment.image(imageUrl)],
+      } as SendNodeContentElement);
     }
   }
 
-  const infoText = buildInfoMessage(parsed, result);
-  await event.reply(infoText);
-}
+  const forwardPayload = toOneBotForwardFormat(nodes);
+  const displayTitle = PLATFORM_DISPLAY_TITLES[parsed.platform] || "媒体解析";
+
+  if (event?.message_type === "group" && event?.group_id != null) {
+    await bot.api("send_group_forward_msg", {
+      group_id: event.group_id,
+      messages: forwardPayload,
+      source: displayTitle,
+      news: [{ text: truncateText(result.title, 26) }, { text: result.author }],
+      summary: `视频太长无法发送（${mins}分${secs}秒）`,
+    });
+    return;
+  }
+
+  if (event?.user_id != null) {
+    await bot.api("send_private_forward_msg", {
+      user_id: event.user_id,
+      messages: forwardPayload,
+      source: displayTitle,
+      news: [{ text: truncateText(result.title, 26) }, { text: result.author }],
+      summary: `视频太长无法发送（${mins}分${secs}秒）`,
+    });
+  }
+}