mioku-plugin-media 1.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

@@ -1,11 +1,11 @@
 import { definePlugin, type MiokiContext } from "mioki";
-import type { ConfigService } from "../../src/services/config/tpyes";
+import type { ConfigService } from "mioku";
 import type { MediaConfig } from "./types";
 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,8 +1,9 @@
 {
   "name": "mioku-plugin-media",
-  "version": "1.0.0",
+  "version": "2.1.0",
   "description": "流媒体解析插件，支持哔哩哔哩、抖音、小红书和快手平台",
   "main": "index.ts",
+  "type": "module",
   "keywords": [
     "mioku"
   ],
@@ -28,6 +29,14 @@
           "role": "member"
         }
       ]
+    },
+    "peerDependencies": {
+      "mioku": "^0.8.0",
+      "mioki": "^0.16.0"
+    },
+    "devDependencies": {
+      "mioku": "workspace:*",
+      "mioki": "^0.16.0"
     }
   }
 }

package/platforms/amagi-client.ts

@@ -1,7 +1,8 @@
 import { createAmagiClient } from "@ikenxuan/amagi";
 import type { MediaConfig } from "../types";
+import type { AmagiClient } from "./types";
 
-export function createMediaAmagiClient(config: MediaConfig): any {
+export function createMediaAmagiClient(config: MediaConfig): AmagiClient {
   const cookies: Record<string, string> = {};
 
   if (config.cookies.bilibili?.trim()) {
@@ -17,8 +18,23 @@ export function createMediaAmagiClient(config: MediaConfig): any {
     cookies.xiaohongshu = config.cookies.xiaohongshu.trim();
   }
 
-  return createAmagiClient({
+  const client = createAmagiClient({
     cookies,
     request: { timeout: 15000 },
   });
+
+  return {
+    bilibili: {
+      fetcher: client.bilibili.fetcher,
+    },
+    douyin: {
+      fetcher: client.douyin.fetcher,
+    },
+    kuaishou: {
+      fetcher: client.kuaishou.fetcher,
+    },
+    xiaohongshu: {
+      fetcher: client.xiaohongshu.fetcher,
+    },
+  };
 }

package/platforms/resolvers/bilibili.ts

@@ -3,23 +3,41 @@ import type { ParsedMediaUrl } from "../types";
 import type { PlatformResolver } from "./types";
 
 export class BilibiliResolver implements PlatformResolver {
+  private readonly BV_REGEX = /\b(BV[a-zA-Z0-9]{10,})\b/;
+  private readonly AV_REGEX = /\b(av\d+)\b/i;
+
   async resolve(client: any, parsed: ParsedMediaUrl): Promise<ParsedMediaResult> {
+    if (parsed.subtype === "live") {
+      return this.resolveLive(client, parsed);
+    }
+
+    // 如果 id 是短链接 URL，先尝试解析出 BV 号
     let bvid = parsed.id;
     let avid: number | undefined;
 
-    if (bvid.startsWith("av")) {
-      avid = parseInt(bvid.slice(2), 10);
-    }
-
     if (bvid.startsWith("http")) {
-      const infoResult = await client.bilibili.fetcher.fetchVideoInfo({ bvid: "" });
-      if (!infoResult.success) {
-        throw new Error(`B站视频信息获取失败: ${infoResult.message}`);
-      }
-      const data = infoResult.data?.data || infoResult.data;
-      bvid = data?.bvid || "";
-      avid = data?.aid;
-      if (!bvid) {
+      // 尝试从 URL 中直接提取 BV 号
+      const bvMatch = bvid.match(this.BV_REGEX);
+      const avMatch = bvid.match(this.AV_REGEX);
+      if (bvMatch) {
+        bvid = bvMatch[1];
+      } else if (avMatch) {
+        // 如果是 AV 号，先转换成 BV 号
+        avid = parseInt(avMatch[1].replace("av", ""), 10);
+        try {
+          const infoResult = await client.bilibili.fetcher.fetchVideoInfo({ bvid: `av${avid}` });
+          if (infoResult.success) {
+            const data = infoResult.data?.data || infoResult.data;
+            bvid = data?.bvid || "";
+            avid = data?.aid;
+          }
+        } catch {
+          // ignore conversion errors
+        }
+        if (!bvid) {
+          throw new Error("B站短链接解析失败，无法获取BV号");
+        }
+      } else {
         throw new Error("B站短链接解析失败，无法获取BV号");
       }
     }
@@ -92,4 +110,75 @@ export class BilibiliResolver implements PlatformResolver {
       },
     };
   }
+
+  private async resolveLive(client: any, parsed: ParsedMediaUrl): Promise<ParsedMediaResult> {
+    const roomId = parsed.id;
+
+    try {
+      const [liveInfoResult, initInfoResult] = await Promise.all([
+        client.bilibili.fetcher.fetchLiveRoomInfo({
+          room_id: roomId,
+        }),
+        client.bilibili.fetcher.fetchLiveRoomInitInfo({
+          room_id: roomId,
+        }),
+      ]);
+
+      if (!liveInfoResult.success) {
+        throw new Error(`B站直播间信息获取失败: ${liveInfoResult.message}`);
+      }
+
+      const liveData = liveInfoResult.data?.data || liveInfoResult.data;
+      if (!liveData) {
+        throw new Error("B站直播间信息为空");
+      }
+
+      const initData = initInfoResult.data?.data || initInfoResult.data;
+      const anchorUid = initData?.uid || liveData.uid;
+
+      let author = "未知主播";
+      if (anchorUid) {
+        try {
+          const userCardResult = await client.bilibili.fetcher.fetchUserCard({
+            host_mid: Number(anchorUid),
+          });
+          if (userCardResult.success) {
+            const cardData = userCardResult.data?.data || userCardResult.data;
+            author = cardData?.card?.uname || cardData?.uname || author;
+          }
+        } catch {
+          // ignore user card fetch errors
+        }
+      }
+
+      const title = liveData.title || "未知标题";
+      const description = liveData.description || "";
+      const coverUrl = liveData.user_cover || liveData.cover || "";
+      const liveStatus = liveData.live_status;
+      const isLive = liveStatus === 1;
+      const online = liveData.online || 0;
+      const attention = liveData.attention || 0;
+
+      return {
+        title,
+        author,
+        description,
+        coverUrl,
+        videoUrl: isLive ? `https://live.bilibili.com/${roomId}` : "",
+        duration: 0,
+        stats: {
+          likes: 0,
+          coins: 0,
+          favorites: 0,
+          shares: 0,
+          views: online,
+          comments: attention,
+          danmaku: 0,
+        },
+        liveStatus: isLive ? "直播中" : "未开播",
+      };
+    } catch (error) {
+      throw new Error(`B站直播间解析失败: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
 }

package/platforms/resolvers/douyin.ts

@@ -19,6 +19,28 @@ export class DouyinResolver implements PlatformResolver {
     }
 
     const detail = data.aweme_detail || data;
+
+    // 判断作品类型：0=视频, 68=图集, 163=文章
+    const awemeType = detail.aweme_type;
+    const isArticle = awemeType === 163;
+    const isVideo = awemeType === 0 || awemeType === 55;
+    const isSlides = detail.is_slides === true;
+
+    // 文章类型
+    if (isArticle) {
+      return this.resolveArticleWork(detail);
+    }
+
+    // 图集/合辑类型（包含 images 数组）
+    if (!isVideo && !isArticle && detail.images) {
+      return this.resolveImageSet(detail, isSlides);
+    }
+
+    // 视频类型
+    return this.resolveVideoWork(detail);
+  }
+
+  private resolveVideoWork(detail: any): ParsedMediaResult {
     const title = detail.desc || detail.item_title || "未知标题";
     const author = detail.author?.nickname || "未知作者";
     const description = detail.desc || "";
@@ -48,26 +70,133 @@ export class DouyinResolver implements PlatformResolver {
       }
     }
 
+    const statistics = detail.statistics || detail.stats || {};
+
+    return {
+      title,
+      author,
+      description,
+      coverUrl,
+      videoUrl,
+      duration,
+      stats: {
+        likes: statistics.digg_count,
+        favorites: statistics.collect_count,
+        shares: statistics.share_count,
+        comments: statistics.comment_count,
+        views: statistics.play_count,
+      },
+    };
+  }
+
+  private resolveArticleWork(detail: any): ParsedMediaResult {
+    const articleInfo = detail.article_info || {};
+    const title = articleInfo.article_title || "未知标题";
+    const author = detail.author?.nickname || "未知作者";
+    const description = articleInfo.article_content || "";
+
+    // 文章类型的封面图
+    const coverUrl =
+      detail.video?.origin_cover?.url_list?.[0] ||
+      detail.video?.cover?.url_list?.[0] ||
+      "";
+
+    const statistics = detail.statistics || detail.stats || {};
+
+    return {
+      title,
+      author,
+      description,
+      coverUrl,
+      videoUrl: "",
+      stats: {
+        likes: statistics.digg_count,
+        favorites: statistics.collect_count,
+        shares: statistics.share_count,
+        comments: statistics.comment_count,
+        views: statistics.play_count,
+      },
+    };
+  }
+
+  private resolveImageSet(detail: any, isSlides: boolean): ParsedMediaResult {
+    const title = detail.preview_title || detail.desc || "未知标题";
+    const author = detail.author?.nickname || "未知作者";
+    const description = detail.desc || "";
+    const statistics = detail.statistics || detail.stats || {};
+
+    // 处理图片列表 - 收集所有静态图片URL
     const images: string[] = [];
     if (detail.images && Array.isArray(detail.images)) {
       for (const img of detail.images) {
-        const url =
-          img?.url_list?.[0] ||
-          img?.download_addr?.url_list?.[0] ||
-          "";
-        if (url) images.push(url);
+        // clip_type: 2=静态图片, 4=短视频, 5=实况图
+        // 静态图片优先使用 url_list[0] 或 url_list[1]
+        if (img.clip_type === 2 || img.clip_type === undefined) {
+          const url =
+            img.url_list?.[0] ||
+            img.url_list?.[1] ||
+            img.download_addr?.url_list?.[0] ||
+            "";
+          if (url) images.push(url);
+        }
       }
     }
 
-    const statistics = detail.statistics || detail.stats || {};
+    // 获取封面（第一张图或视频封面）
+    const coverUrl =
+      detail.images?.[0]?.url_list?.[0] ||
+      detail.images?.[0]?.url_list?.[1] ||
+      detail.video?.cover?.url_list?.[0] ||
+      "";
+
+    // 判断是否有实况图（clip_type !== 2）
+    const hasLivePhoto = detail.images?.some(
+      (img: any) => (img.clip_type ?? 2) !== 2
+    );
+
+    // 对于图集/合辑，可能有背景音乐
+    let musicUrl = "";
+    if (detail.music) {
+      if (detail.music.play_url?.uri) {
+        musicUrl = detail.music.play_url.uri;
+      } else if (detail.music.extra) {
+        try {
+          const extraData = JSON.parse(detail.music.extra);
+          if (extraData.original_song_url) {
+            musicUrl = extraData.original_song_url;
+          }
+        } catch {
+          // ignore parse error
+        }
+      }
+    }
+
+    // 收集视频URL（用于短视频或实况图）
+    const videoUrls: string[] = [];
+    if (detail.images && Array.isArray(detail.images)) {
+      for (const img of detail.images) {
+        // 短视频或实况图视频
+        if (img.clip_type === 4 || img.clip_type === 5) {
+          if (img.video?.play_addr_h264?.uri) {
+            videoUrls.push(
+              `https://aweme.snssdk.com/aweme/v1/play/?video_id=${img.video.play_addr_h264.uri}&ratio=1080p&line=0`
+            );
+          }
+        }
+      }
+    }
 
     return {
       title,
       author,
       description,
       coverUrl,
-      videoUrl,
-      duration,
+      videoUrl: "",
+      images,
+      videoUrls,
+      musicUrl,
+      hasLivePhoto,
+      isSlides,
       stats: {
         likes: statistics.digg_count,
         favorites: statistics.collect_count,

package/platforms/resolvers/index.ts

@@ -1,4 +1,4 @@
-import type { ParsedMediaUrl } from "../types";
+import type { AmagiClient, ParsedMediaUrl } from "../types";
 import type { ParsedMediaResult } from "../../types";
 import type { PlatformResolver } from "./types";
 import { BilibiliResolver } from "./bilibili";
@@ -14,7 +14,7 @@ const resolvers: Record<string, PlatformResolver> = {
 };
 
 export async function resolveMedia(
-  client: any,
+  client: AmagiClient,
   parsed: ParsedMediaUrl,
 ): Promise<ParsedMediaResult> {
   const resolver = resolvers[parsed.platform];

package/platforms/resolvers/kuaishou.ts

@@ -1,13 +1,76 @@
 import type { ParsedMediaResult } from "../../types";
-import type { ParsedMediaUrl } 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: any, 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 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}`);
     }
 
@@ -32,20 +95,39 @@ 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;
     }
 
+    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] ||
+          "";
+        if (url) images.push(url);
+      }
+    }
+
     return {
       title,
       author,
       description,
       coverUrl,
       videoUrl,
+      images: images.length > 0 ? images : undefined,
       duration,
       stats: {
         likes: photo.likeCount || photo.likeCnt,

package/platforms/resolvers/xiaohongshu.ts

@@ -39,12 +39,27 @@ export class XiaohongshuResolver implements PlatformResolver {
         noteData.image_list?.[0]?.url_pre ||
         "";
 
+      // 收集图片列表
+      const images: string[] = [];
+      if (noteData.image_list && Array.isArray(noteData.image_list)) {
+        for (const img of noteData.image_list) {
+          const url =
+            img?.url ||
+            img?.url_default ||
+            img?.url_pre ||
+            img?.download_addr?.url_list?.[0] ||
+            "";
+          if (url) images.push(url);
+        }
+      }
+
       return {
         title,
         author,
         description,
         coverUrl,
         videoUrl: "",
+        images: images.length > 0 ? images : undefined,
         stats: buildXhsStats(noteData.interact_info),
       };
     }
@@ -70,12 +85,52 @@ export class XiaohongshuResolver implements PlatformResolver {
         "";
     }
 
+    // 收集图片列表
+    const images: string[] = [];
+    if (noteCard.image_list && Array.isArray(noteCard.image_list)) {
+      for (const img of noteCard.image_list) {
+        const url =
+          img?.url ||
+          img?.url_default ||
+          img?.url_pre ||
+          img?.download_addr?.url_list?.[0] ||
+          "";
+        if (url) images.push(url);
+      }
+    }
+
+    // 判断是否有实况图（检查是否有 stream 数据）
+    const hasLivePhoto = noteCard.image_list?.some(
+      (img: any) => img.live_photo && img.stream
+    );
+
+    // 收集实况图视频流URL
+    const videoUrls: string[] = [];
+    if (noteCard.image_list && Array.isArray(noteCard.image_list)) {
+      for (const img of noteCard.image_list) {
+        if (img.stream) {
+          // 按优先级 h264 > h265 > av1 > h266
+          const streamData = img.stream;
+          if (streamData.h264?.length > 0) {
+            videoUrls.push(streamData.h264[0].master_url);
+          } else if (streamData.h265?.length > 0) {
+            videoUrls.push(streamData.h265[0].master_url);
+          } else if (streamData.av1?.length > 0) {
+            videoUrls.push(streamData.av1[0].master_url);
+          }
+        }
+      }
+    }
+
     return {
       title,
       author,
       description,
       coverUrl,
       videoUrl,
+      images: images.length > 0 ? images : undefined,
+      videoUrls: videoUrls.length > 0 ? videoUrls : undefined,
+      hasLivePhoto,
       stats: buildXhsStats(noteCard.interact_info),
     };
   }
@@ -89,4 +144,4 @@ function buildXhsStats(interactInfo: any): import("../../types").MediaStats {
     comments: parseInt(interactInfo.comment_count, 10) || undefined,
     shares: parseInt(interactInfo.share_count, 10) || undefined,
   };
-}
+}