yuanflow-cli 0.1.37 → 0.1.40

package/src/trending-tools.js

@@ -0,0 +1,117 @@
+import { callEndpoint } from './request.js';
+
+const VIDEO_HOT_LIST_PATH = '/douyin/billboard/fetch_hot_total_video_list';
+
+const VIDEO_HOT_BOARD_TYPES = [
+  { subType: 1001, label: '视频总榜' },
+  { subType: 1002, label: '低粉爆款' },
+  { subType: 1003, label: '高完播率' },
+  { subType: 1004, label: '高涨粉率' },
+  { subType: 1005, label: '高点赞率' },
+];
+
+export function listTrendingCommands() {
+  return [
+    {
+      key: 'trending.video-hot-list',
+      command: 'trending video-hot-list',
+      kind: 'trending',
+      description: '一次性查询抖音视频热榜五类榜单：视频总榜、低粉爆款、高完播率、高涨粉率、高点赞率。',
+      method: 'POST',
+      socialPath: VIDEO_HOT_LIST_PATH,
+      positionals: [],
+      options: [
+        { flag: '--page', name: 'page', required: false, label: '页码，默认 1' },
+        { flag: '--page-size', name: 'page_size', required: false, label: '每页数量，默认 10' },
+        { flag: '--date-window', name: 'date_window', required: false, label: '时间窗口，默认 2 按天' },
+        { flag: '--tags-json', name: 'tags', required: false, label: '垂类标签 JSON 数组，空则全部垂类' },
+      ],
+      returns: '返回五类视频热榜的统一 JSON，字段结构以上游实际响应为准。',
+    },
+  ];
+}
+
+export async function fetchVideoHotList({ options }) {
+  const query = buildVideoHotListQuery(options);
+  const boards = [];
+
+  for (const board of VIDEO_HOT_BOARD_TYPES) {
+    const requestBody = {
+      page: query.page,
+      page_size: query.page_size,
+      date_window: query.date_window,
+      sub_type: board.subType,
+      ...(query.tags !== undefined ? { tags: query.tags } : {}),
+    };
+    const response = await callEndpoint(VIDEO_HOT_LIST_PATH, {
+      ...options,
+      method: 'POST',
+      body: requestBody,
+    });
+    boards.push({
+      sub_type: board.subType,
+      label: board.label,
+      request: requestBody,
+      response,
+    });
+  }
+
+  return {
+    platform: 'douyin',
+    endpoint: {
+      method: 'POST',
+      path: VIDEO_HOT_LIST_PATH,
+      kind: 'video-hot-list',
+    },
+    query,
+    boards,
+    guidance: [
+      '结合用户个人创作信息、个人创作库历史记录、历史任务或对话记录输出建议。',
+      '不要只罗列榜单，必须区分五类榜单来源并提炼可执行选题和内容结构。',
+      '重点比较总榜、低粉爆款、高完播率、高涨粉率、高点赞率之间的差异。',
+    ],
+  };
+}
+
+function buildVideoHotListQuery(options = {}) {
+  return {
+    page: parsePositiveInteger(options.named?.page, 1, 'page'),
+    page_size: parsePositiveInteger(options.named?.['page-size'] ?? options.named?.page_size, 10, 'page_size'),
+    date_window: parsePositiveInteger(options.named?.['date-window'] ?? options.named?.date_window, 2, 'date_window'),
+    ...(parseTags(options.named?.['tags-json'] ?? options.named?.tags) !== undefined
+      ? { tags: parseTags(options.named?.['tags-json'] ?? options.named?.tags) }
+      : {}),
+  };
+}
+
+function parsePositiveInteger(value, fallback, name) {
+  if (value === undefined || value === null || value === '') {
+    return fallback;
+  }
+  const number = Number(value);
+  if (!Number.isInteger(number) || number <= 0) {
+    throw new Error(`${name} 必须是正整数。`);
+  }
+  return number;
+}
+
+function parseTags(value) {
+  if (value === undefined || value === null || value === '') {
+    return undefined;
+  }
+  if (Array.isArray(value)) {
+    return value;
+  }
+  try {
+    const parsed = JSON.parse(String(value));
+    if (!Array.isArray(parsed)) {
+      throw new Error('tags-json 必须是数组。');
+    }
+    return parsed;
+  } catch (error) {
+    if (error?.message === 'tags-json 必须是数组。') {
+      throw error;
+    }
+    throw new Error('tags-json 必须是合法 JSON 数组。');
+  }
+}