yuanflow-cli 0.1.4 → 0.1.6

package/src/request.js

@@ -11,10 +11,6 @@ export async function callEndpoint(socialPath, options = {}) {
   const method = options.method || endpoint?.method || 'POST';
   const url = new URL(`/social${normalizedPath}`, baseUrl);
 
-  if (!token) {
-    throw new Error('缺少 token。请设置 YUANCHUANG_API_TOKEN，或执行 yuanflow-cli config set-token <你的令牌>');
-  }
-
   const body = await resolveBody(options);
   if (method.toUpperCase() === 'GET' && body && typeof body === 'object') {
     for (const [key, value] of Object.entries(body)) {
@@ -30,12 +26,16 @@ export async function callEndpoint(socialPath, options = {}) {
       method: method.toUpperCase(),
       url: url.toString(),
       headers: {
-        Authorization: `Bearer ${maskToken(token)}`,
+        ...(token ? { Authorization: `Bearer ${maskToken(token)}` } : {}),
       },
       body: method.toUpperCase() === 'GET' ? undefined : body || {},
     };
   }
 
+  if (!token) {
+    throw new Error('缺少 token。请设置 YUANCHUANG_API_TOKEN，或执行 yuanflow-cli config set-token <你的令牌>');
+  }
+
   const response = await fetch(url, {
     method: method.toUpperCase(),
     headers: {

package/src/work-tool-definitions.js

@@ -0,0 +1,569 @@
+export const DETAIL_ENDPOINTS = {
+  douyin: [
+    {
+      method: 'GET',
+      path: '/douyin/web/fetch_one_video_by_share_url',
+      targetParam: 'share_url',
+      targetMode: 'raw-url',
+      description: '抖音作品详情，优先使用分享链接。',
+    },
+    {
+      method: 'GET',
+      path: '/douyin/web/fetch_one_video',
+      targetParam: 'aweme_id',
+      targetMode: 'id',
+      description: '抖音作品详情，使用 aweme_id。',
+    },
+    {
+      method: 'GET',
+      path: '/douyin/app/v3/fetch_one_video_by_share_url',
+      targetParam: 'share_url',
+      targetMode: 'raw-url',
+      prefer: 'fallback',
+      description: '抖音作品详情备用 app v3 接口。',
+    },
+  ],
+  xiaohongshu: [
+    {
+      method: 'GET',
+      path: '/xiaohongshu/web_v3/fetch_note_detail',
+      targetParam: 'note_id',
+      targetMode: 'id',
+      optionParams: { 'xsec-token': 'xsec_token' },
+      description: '小红书笔记详情。',
+    },
+  ],
+  bilibili: [
+    {
+      method: 'GET',
+      path: '/bilibili/web/fetch_one_video_v3',
+      targetParam: 'url',
+      targetMode: 'raw-url',
+      description: 'B站视频详情，优先使用视频 URL。',
+    },
+    {
+      method: 'GET',
+      path: '/bilibili/web/fetch_one_video',
+      targetParam: 'bv_id',
+      targetMode: 'id',
+      description: 'B站视频详情，使用 BV 号。',
+    },
+  ],
+  wechat_channels: [
+    {
+      method: 'GET',
+      path: '/wechat_channels/fetch_video_detail',
+      targetParam: 'id',
+      targetMode: 'id',
+      optionParams: { 'export-id': 'exportId' },
+      description: '微信视频号视频详情。',
+    },
+  ],
+  wechat_mp: [
+    {
+      method: 'GET',
+      path: '/wechat_mp/web/fetch_mp_article_detail_json',
+      targetParam: 'url',
+      targetMode: 'raw',
+      description: '微信公众号文章详情 JSON。',
+    },
+  ],
+  tiktok: [
+    {
+      method: 'GET',
+      path: '/tiktok/app/v3/fetch_one_video_by_share_url',
+      targetParam: 'share_url',
+      targetMode: 'raw-url',
+      description: 'TikTok 作品详情，优先使用分享链接。',
+    },
+    {
+      method: 'GET',
+      path: '/tiktok/web/fetch_post_detail',
+      targetParam: 'itemId',
+      targetMode: 'id',
+      description: 'TikTok 作品详情，使用 itemId。',
+    },
+  ],
+  instagram: [
+    {
+      method: 'GET',
+      path: '/instagram/v1/fetch_post_by_url',
+      targetParam: 'post_url',
+      targetMode: 'raw-url',
+      description: 'Instagram 帖子详情，使用帖子 URL。',
+    },
+    {
+      method: 'GET',
+      path: '/instagram/v3/get_post_info_by_code',
+      targetParam: 'code',
+      targetMode: 'id',
+      targetKind: 'code',
+      description: 'Instagram 帖子详情，使用 shortcode。',
+    },
+    {
+      method: 'GET',
+      path: '/instagram/v3/get_post_info',
+      targetParam: 'media_id',
+      targetMode: 'id',
+      description: 'Instagram 帖子详情，使用 media_id。',
+    },
+  ],
+  kuaishou: [
+    {
+      method: 'GET',
+      path: '/kuaishou/web/fetch_one_video_by_url',
+      targetParam: 'url',
+      targetMode: 'raw-url',
+      description: '快手作品详情，使用作品链接。',
+    },
+    {
+      method: 'GET',
+      path: '/kuaishou/web/fetch_one_video_v2',
+      targetParam: 'photo_id',
+      targetMode: 'id',
+      description: '快手作品详情，使用 photo_id。',
+    },
+  ],
+  reddit: [
+    {
+      method: 'GET',
+      path: '/reddit/app/fetch_post_details',
+      targetParam: 'post_id',
+      targetMode: 'id',
+      optionParams: { 'comment-id': 'comment_id' },
+      defaults: { need_format: 'true' },
+      description: 'Reddit 帖子详情。',
+    },
+  ],
+  twitter: [
+    {
+      method: 'GET',
+      path: '/twitter/web/fetch_tweet_detail',
+      targetParam: 'tweet_id',
+      targetMode: 'id',
+      description: 'Twitter/X 推文详情。',
+    },
+  ],
+  weibo: [
+    {
+      method: 'GET',
+      path: '/weibo/web_v2/fetch_post_detail',
+      targetParam: 'id',
+      targetMode: 'id',
+      optionParams: { 'long-text': 'is_get_long_text' },
+      description: '微博作品详情。',
+    },
+    {
+      method: 'GET',
+      path: '/weibo/web/fetch_post_detail',
+      targetParam: 'post_id',
+      targetMode: 'id',
+      prefer: 'fallback',
+      description: '微博作品详情备用接口。',
+    },
+  ],
+  youtube: [
+    {
+      method: 'GET',
+      path: '/youtube/web_v2/get_video_info',
+      targetParam: 'video_id',
+      targetMode: 'id',
+      kind: 'video',
+      optionParams: { 'language-code': 'language_code', 'need-format': 'need_format' },
+      description: 'YouTube 视频详情。',
+    },
+    {
+      method: 'GET',
+      path: '/youtube/web_v2/get_post_detail',
+      targetParam: 'post_id',
+      targetMode: 'id',
+      kind: 'post',
+      optionParams: {
+        'language-code': 'language_code',
+        'country-code': 'country_code',
+        'need-format': 'need_format',
+      },
+      description: 'YouTube 社区帖子详情。',
+    },
+  ],
+  zhihu: [
+    {
+      method: 'GET',
+      path: '/zhihu/web/fetch_column_article_detail',
+      targetParam: 'article_id',
+      targetMode: 'id',
+      kind: 'article',
+      description: '知乎专栏文章详情。',
+    },
+    {
+      method: 'GET',
+      path: '/zhihu/web/fetch_question_answers',
+      targetParam: 'question_id',
+      targetMode: 'id',
+      kind: 'question',
+      optionParams: { cursor: 'cursor', limit: 'limit', offset: 'offset', order: 'order' },
+      description: '知乎问题回答列表，可作为问题详情和回答入口。',
+    },
+  ],
+  xigua: [
+    {
+      method: 'GET',
+      path: '/xigua/app/v2/fetch_one_video',
+      targetParam: 'item_id',
+      targetMode: 'id',
+      description: '西瓜视频作品详情。',
+    },
+  ],
+};
+
+export const DOWNLOAD_ENDPOINTS = {
+  douyin: [
+    {
+      method: 'GET',
+      path: '/douyin/app/v3/fetch_video_high_quality_play_url',
+      targetParam: 'share_url',
+      targetMode: 'raw-url',
+      optionParams: { region: 'region' },
+      description: '抖音视频最高画质播放/下载地址查询，优先使用分享链接。',
+    },
+    {
+      method: 'GET',
+      path: '/douyin/app/v3/fetch_video_high_quality_play_url',
+      targetParam: 'aweme_id',
+      targetMode: 'id',
+      optionParams: { region: 'region' },
+      description: '抖音视频最高画质播放/下载地址查询，使用 aweme_id。',
+    },
+    {
+      method: 'GET',
+      path: '/douyin/web/fetch_video_high_quality_play_url',
+      targetParam: 'share_url',
+      targetMode: 'raw-url',
+      optionParams: { region: 'region' },
+      prefer: 'fallback',
+      description: '抖音视频播放/下载地址备用 web 接口。',
+    },
+  ],
+  bilibili: [
+    {
+      method: 'GET',
+      path: '/bilibili/web/fetch_video_play_info',
+      targetParam: 'url',
+      targetMode: 'raw-url',
+      description: 'B站视频播放信息，使用视频 URL。',
+    },
+    {
+      method: 'GET',
+      path: '/bilibili/web/fetch_video_playurl',
+      targetParam: 'bv_id',
+      targetMode: 'id',
+      requiredOptions: ['cid'],
+      optionParams: { cid: 'cid' },
+      description: 'B站视频流地址，使用 BV 号和 cid。',
+    },
+  ],
+  youtube: [
+    {
+      method: 'GET',
+      path: '/youtube/web_v2/get_video_streams',
+      targetParam: 'video_id',
+      targetMode: 'id',
+      description: 'YouTube 视频流信息。',
+    },
+    {
+      method: 'GET',
+      path: '/youtube/web_v2/get_video_streams',
+      targetParam: 'video_url',
+      targetMode: 'raw-url',
+      description: 'YouTube 视频流信息，使用视频 URL。',
+    },
+    {
+      method: 'GET',
+      path: '/youtube/web_v2/get_signed_stream_url',
+      targetParam: 'video_id',
+      targetMode: 'id',
+      requiredOptions: ['itag'],
+      optionParams: { itag: 'itag' },
+      prefer: 'signed',
+      description: 'YouTube 已签名视频流 URL，需要 itag。',
+    },
+  ],
+  xigua: [
+    {
+      method: 'GET',
+      path: '/xigua/app/v2/fetch_one_video_play_url',
+      targetParam: 'item_id',
+      targetMode: 'id',
+      description: '西瓜视频播放链接。',
+    },
+  ],
+};
+
+export const CONTENT_SEARCH_ENDPOINTS = {
+  bilibili: {
+    method: 'GET',
+    path: '/bilibili/web/fetch_general_search',
+    keywordParam: 'keyword',
+    defaults: { order: 'totalrank', page: '1', page_size: '20' },
+    optionParams: {
+      order: 'order',
+      page: 'page',
+      'page-size': 'page_size',
+      duration: 'duration',
+      'pubtime-begin': 'pubtime_begin_s',
+      'pubtime-end': 'pubtime_end_s',
+    },
+    description: 'B站综合搜索。',
+  },
+  douyin: {
+    method: 'POST',
+    path: '/douyin/search/fetch_general_search_v2',
+    keywordParam: 'keyword',
+    bodyMode: true,
+    defaults: {
+      cursor: 0,
+      sort_type: '0',
+      publish_time: '0',
+      filter_duration: '0',
+      content_type: '0',
+      search_id: '',
+      backtrace: '',
+    },
+    optionParams: {
+      cursor: 'cursor',
+      sort: 'sort_type',
+      'sort-type': 'sort_type',
+      'publish-time': 'publish_time',
+      duration: 'filter_duration',
+      'filter-duration': 'filter_duration',
+      'content-type': 'content_type',
+      type: 'content_type',
+      'search-id': 'search_id',
+      backtrace: 'backtrace',
+    },
+    description: '抖音综合搜索 V2。',
+  },
+  xiaohongshu: {
+    method: 'GET',
+    path: '/xiaohongshu/web_v3/fetch_search_notes',
+    keywordParam: 'keyword',
+    optionParams: { page: 'page', sort: 'sort', type: 'note_type', 'note-type': 'note_type' },
+    description: '小红书笔记搜索。',
+  },
+  wechat_channels: {
+    method: 'GET',
+    path: '/wechat_channels/fetch_search_ordinary',
+    keywordParam: 'keywords',
+    description: '微信视频号综合搜索。',
+  },
+  tiktok: {
+    method: 'GET',
+    path: '/tiktok/app/v3/fetch_general_search_result',
+    keywordParam: 'keyword',
+    optionParams: {
+      cursor: 'offset',
+      offset: 'offset',
+      count: 'count',
+      sort: 'sort_type',
+      'sort-type': 'sort_type',
+      'publish-time': 'publish_time',
+    },
+    description: 'TikTok 综合搜索。',
+  },
+  instagram: {
+    method: 'GET',
+    path: '/instagram/v3/general_search',
+    keywordParam: 'query',
+    optionParams: {
+      cursor: 'next_max_id',
+      'next-max-id': 'next_max_id',
+      'rank-token': 'rank_token',
+      metadata: 'enable_metadata',
+    },
+    description: 'Instagram 综合搜索。',
+  },
+  kuaishou: {
+    method: 'GET',
+    path: '/kuaishou/app/search_comprehensive',
+    keywordParam: 'keyword',
+    optionParams: {
+      cursor: 'pcursor',
+      pcursor: 'pcursor',
+      sort: 'sort_type',
+      'sort-type': 'sort_type',
+      'publish-time': 'publish_time',
+      duration: 'duration',
+      scope: 'search_scope',
+    },
+    description: '快手综合搜索。',
+  },
+  reddit: {
+    method: 'GET',
+    path: '/reddit/app/fetch_dynamic_search',
+    keywordParam: 'query',
+    defaults: { search_type: 'post' },
+    optionParams: {
+      type: 'search_type',
+      'search-type': 'search_type',
+      sort: 'sort',
+      cursor: 'after',
+      after: 'after',
+      'time-range': 'time_range',
+      'safe-search': 'safe_search',
+      'allow-nsfw': 'allow_nsfw',
+      'need-format': 'need_format',
+    },
+    description: 'Reddit 动态搜索，默认搜索帖子。',
+  },
+  twitter: {
+    method: 'GET',
+    path: '/twitter/web/fetch_search_timeline',
+    keywordParam: 'keyword',
+    optionParams: { type: 'search_type', 'search-type': 'search_type', cursor: 'cursor' },
+    description: 'Twitter/X 搜索时间线。',
+  },
+  weibo: {
+    method: 'GET',
+    path: '/weibo/web_v2/fetch_advanced_search',
+    keywordParam: 'q',
+    optionParams: {
+      page: 'page',
+      type: 'search_type',
+      'search-type': 'search_type',
+      'include-type': 'include_type',
+      timescope: 'timescope',
+    },
+    description: '微博高级搜索。',
+  },
+  youtube: {
+    method: 'GET',
+    path: '/youtube/web_v2/get_general_search_v2',
+    keywordParam: 'keyword',
+    optionParams: {
+      cursor: 'continuation_token',
+      'continuation-token': 'continuation_token',
+      'upload-date': 'upload_date',
+      type: 'type',
+      duration: 'duration',
+      features: 'features',
+      sort: 'sort_by',
+      'sort-by': 'sort_by',
+    },
+    description: 'YouTube 综合搜索。',
+  },
+  zhihu: {
+    method: 'GET',
+    path: '/zhihu/web/fetch_article_search_v3',
+    keywordParam: 'keyword',
+    optionParams: {
+      cursor: 'offset',
+      offset: 'offset',
+      count: 'limit',
+      limit: 'limit',
+      sort: 'sort',
+      vertical: 'vertical',
+      'time-interval': 'time_interval',
+    },
+    description: '知乎文章搜索。',
+  },
+  xigua: {
+    method: 'GET',
+    path: '/xigua/app/v2/search_video',
+    keywordParam: 'keyword',
+    optionParams: {
+      cursor: 'offset',
+      offset: 'offset',
+      sort: 'order_type',
+      'order-type': 'order_type',
+      'min-duration': 'min_duration',
+      'max-duration': 'max_duration',
+    },
+    description: '西瓜视频搜索。',
+  },
+};
+
+export const USER_SEARCH_ENDPOINTS = {
+  douyin: {
+    method: 'POST',
+    path: '/douyin/search/fetch_user_search_v2',
+    keywordParam: 'keyword',
+    bodyMode: true,
+    defaults: { cursor: 0 },
+    optionParams: { cursor: 'cursor' },
+    description: '抖音用户搜索 V2。',
+  },
+  xiaohongshu: {
+    method: 'GET',
+    path: '/xiaohongshu/web_v3/fetch_search_users',
+    keywordParam: 'keyword',
+    optionParams: { page: 'page' },
+    description: '小红书用户搜索。',
+  },
+  wechat_channels: {
+    method: 'GET',
+    path: '/wechat_channels/fetch_user_search',
+    keywordParam: 'keywords',
+    optionParams: { page: 'page' },
+    description: '微信视频号用户搜索。',
+  },
+  tiktok: {
+    method: 'GET',
+    path: '/tiktok/app/v3/fetch_user_search_result',
+    keywordParam: 'keyword',
+    optionParams: {
+      cursor: 'offset',
+      offset: 'offset',
+      count: 'count',
+      'follower-count': 'user_search_follower_count',
+      'profile-type': 'user_search_profile_type',
+      'other-pref': 'user_search_other_pref',
+    },
+    description: 'TikTok 用户搜索。',
+  },
+  instagram: {
+    method: 'GET',
+    path: '/instagram/v3/search_users',
+    keywordParam: 'query',
+    optionParams: { 'rank-token': 'rank_token' },
+    description: 'Instagram 用户搜索。',
+  },
+  kuaishou: {
+    method: 'GET',
+    path: '/kuaishou/app/search_user_v2',
+    keywordParam: 'keyword',
+    optionParams: { page: 'page' },
+    description: '快手用户搜索。',
+  },
+  weibo: {
+    method: 'GET',
+    path: '/weibo/web_v2/fetch_user_search',
+    keywordParam: 'query',
+    optionParams: {
+      page: 'page',
+      region: 'region',
+      auth: 'auth',
+      gender: 'gender',
+      age: 'age',
+      nickname: 'nickname',
+      tag: 'tag',
+      school: 'school',
+      work: 'work',
+    },
+    description: '微博用户搜索。',
+  },
+  youtube: {
+    method: 'GET',
+    path: '/youtube/web_v2/search_channels',
+    keywordParam: 'keyword',
+    optionParams: { cursor: 'continuation_token', 'continuation-token': 'continuation_token', 'need-format': 'need_format' },
+    description: 'YouTube 频道搜索。',
+  },
+  zhihu: {
+    method: 'GET',
+    path: '/zhihu/web/fetch_user_search_v3',
+    keywordParam: 'keyword',
+    optionParams: { cursor: 'offset', offset: 'offset', count: 'limit', limit: 'limit' },
+    description: '知乎用户搜索。',
+  },
+};
+