yuanflow-cli 0.1.40 → 0.1.42

package/src/cli.js

@@ -28,6 +28,7 @@ import {
   searchUsers,
 } from './work-tools.js';
 import { fetchVideoHotList } from './trending-tools.js';
+import { formatAiHelp, runAiCommand } from './ai-tools.js';
 
 export async function main(argv) {
   const args = argv.slice(2);
@@ -98,6 +99,11 @@ export async function main(argv) {
     return;
   }
 
+  if (command === 'ai') {
+    await handleAi(rest);
+    return;
+  }
+
   if (command === 'schema') {
     await handleSchema(rest);
     return;
@@ -431,6 +437,20 @@ async function handleVideo(args) {
   });
 }
 
+async function handleAi(args) {
+  const { positionals, options } = parseOptions(args);
+  const [action = 'help', ...rest] = positionals;
+  if (action === 'help' && !isAgentJsonFormat(options)) {
+    console.log(formatAiHelp());
+    return;
+  }
+  const result = await runAiCommand({ action, rest, options });
+  await outputResult(result, { ...options, output: undefined }, {
+    command: `ai ${[action, ...rest].filter(Boolean).join(' ')}`,
+    meta: { endpoint: result.endpoint?.path, kind: result.endpoint?.kind || 'ai-model' },
+  });
+}
+
 async function handleGeneratedCommand(platform, args) {
   if (!getPlatforms().includes(platform)) {
     throw new Error(`未知平台：${platform}。可用平台：${getPlatforms().join(', ')}`);
@@ -609,15 +629,29 @@ function printHelp() {
   yuanflow-cli video timeline --project "D:\\素材\\yuanflow-video-edit" --fps 1 --format agent-json
   yuanflow-cli video visual-review --project "D:\\素材\\yuanflow-video-edit" --review-file "D:\\素材\\yuanflow-video-edit\\visual_review.agent.json" --format agent-json
   yuanflow-cli video plan --project "D:\\素材\\yuanflow-video-edit" --timeline-plan "D:\\素材\\yuanflow-video-edit\\timeline_plan.agent.json" --format agent-json
+  yuanflow-cli ai qwen3-vl-plus --prompt "描述这张图" --image-url "https://example.com/image.png" --dry-run
+  yuanflow-cli ai qwen3-vl-plus --prompt "总结这个视频画面" --video-url "https://example.com/video.mp4" --dry-run
+  yuanflow-cli ai qwen3-vl-plus --prompt "描述本地图片" --image-file "D:\\素材\\cover.png" --dry-run
+  yuanflow-cli ai qwen3-vl-plus --prompt "描述本地视频" --video-file "D:\\素材\\demo.mp4" --dry-run
+  yuanflow-cli ai qwen-voice-enrollment --file "D:\\voice\\sample.wav" --name demo --activate --dry-run
+  yuanflow-cli ai qwen3-tts-vc-realtime-2026-01-15 --text "你好" --voice voice_xxx --output "D:\\voice\\qwen.mp3" --dry-run
+  yuanflow-cli ai fun-asr --audio-url "https://example.com/audio.wav" --response-format verbose_json --dry-run
+  yuanflow-cli ai doubao-tts voices --dry-run
+  yuanflow-cli ai doubao-tts voice --voice zh_female_xiaohe_uranus_bigtts --dry-run
+  yuanflow-cli ai doubao-tts voice-download --voice zh_female_xiaohe_uranus_bigtts --output "D:\\voice\\preview.mp3" --dry-run
+  yuanflow-cli ai doubao-tts --text "你好" --voice zh_female_xiaohe_uranus_bigtts --output "D:\\voice\\doubao.mp3" --dry-run
   yuanflow-cli list douyin
 
 说明：
-  社媒请求调用 Yuan API 的 /social/*path；知识库和 OSS 原子能力调用 /api/* 或 /atomic/*。
+  社媒请求调用 YuanFlow API 的 /social/*path；知识库和 YuanFlow 文件中转调用 /api/* 或 /atomic/*。
+  ai 命令调用 YuanFlow API OpenAI 兼容端点，模型名使用 YuanFlow API 对外模型参数，不暴露底层供应商内部模型名。
+  qwen3-vl-plus 支持 --image-url、--video-url、--image-file、--video-file 四选一；视频建议最大 2GB、时长 2 秒到 1 小时。
+  qwen3-vl-plus 本地图片/视频会先走 YuanFlow 文件中转，内部调用 /atomic/oss/temp-upload 后把 signed_url 提交给模型。
   browser 命令是自媒体平台专用浏览器自动化协议，只返回受控 profile/cookie/任务路径与执行计划，不用于普通网页搜索。
   video 命令是视频智能剪辑基础链路：规则库策略快照、主音频+B-roll、ASR 时间戳对齐、1秒1帧抽帧、视觉理解回写、Agent 生成 timeline_plan/EDL、CLI 校验和渲染。
   需要鉴权的请求都会使用 Authorization: Bearer <token>。
   token 优先级：--token > YUANCHUANG_API_TOKEN > 本地 config.token。
-  YuanFlow 主程序内使用时，token 由主程序认证系统注入，不需要手动配置。
+  YuanFlow-main 内置环境使用时，token 由 YuanFlow-main 内置环境注入，不需要手动配置。
   AI Agent 推荐使用 --format agent-json 获取稳定 JSON 外壳。
 `);
 }

package/src/comment-collector.js

@@ -454,7 +454,7 @@ export function listCommentCommands() {
     options: buildCommentCommandOptions(endpoint),
     queryParams: buildCommentCommandQueryParams(endpoint),
     requestBody: endpoint.bodyMode ? buildCommentCommandRequestBody(endpoint) : null,
-    returns: '返回评论列表、翻页游标和平台原始响应字段，字段以上游接口实际响应为准。',
+    returns: '返回评论列表、翻页游标和平台原始响应字段，字段以 YuanFlow API 实际响应为准。',
   }));
 }
 

package/src/oss-tools.js

@@ -12,14 +12,14 @@ export function listOssCommands() {
       key: 'oss.temp-upload',
       command: 'oss temp-upload',
       kind: 'oss-atomic',
-      description: '上传本地文件到 Yuan API 临时 OSS bucket，并返回对象 key 和临时访问信息。',
+      description: '上传本地文件到 YuanFlow 文件中转，并返回对象 key 和临时访问信息。',
       method: 'POST',
       apiPath: OSS_TEMP_UPLOAD_PATH,
       positionals: [],
       options: [
         { flag: '--file', name: 'file', required: true, label: '本地文件路径。' },
         { flag: '--filename', name: 'filename', required: false, label: '上传时使用的文件名，默认取本地文件名。' },
-        { flag: '--key', name: 'key', required: false, label: '可选 OSS 对象 key。' },
+        { flag: '--key', name: 'key', required: false, label: '可选文件对象 key。' },
         { flag: '--content-type', name: 'contentType', required: false, label: '文件 MIME 类型，默认 application/octet-stream。' },
         ...commonOptions(),
       ],
@@ -29,19 +29,19 @@ export function listOssCommands() {
         content_base64: '<base64>',
         content_type: '<content-type>',
       },
-      returns: '返回 bucket、key、url、signed_url、expires_at 等字段，字段以后端实际响应为准。',
+      returns: '返回 bucket、key、url、signed_url、expires_at 等字段，字段以 YuanFlow API 实际响应为准。',
     },
     {
       key: 'oss.signed-url',
       command: 'oss signed-url',
       kind: 'oss-atomic',
-      description: '为已有 OSS 对象生成临时签名访问链接。',
+      description: '为已有文件中转对象生成临时签名访问链接。',
       method: 'POST',
       apiPath: OSS_SIGNED_URL_PATH,
       positionals: [],
       options: [
-        { flag: '--key', name: 'key', required: true, label: 'OSS 对象 key。' },
-        { flag: '--bucket', name: 'bucket', required: false, label: '可选 bucket，不传则使用后端默认配置。' },
+        { flag: '--key', name: 'key', required: true, label: '文件对象 key。' },
+        { flag: '--bucket', name: 'bucket', required: false, label: '可选 bucket，不传则使用 YuanFlow 默认配置。' },
         { flag: '--ttl-seconds', name: 'ttlSeconds', required: false, label: '签名有效期，最大 86400 秒。' },
         { flag: '--method', name: 'method', required: false, label: '签名方法：GET、PUT、HEAD。' },
         ...commonOptions(),
@@ -52,19 +52,19 @@ export function listOssCommands() {
         ttl_seconds: 1800,
         method: 'GET',
       },
-      returns: '返回签名 URL、过期时间和对象信息，字段以后端实际响应为准。',
+      returns: '返回签名 URL、过期时间和对象信息，字段以 YuanFlow API 实际响应为准。',
     },
     {
       key: 'oss.copy',
       command: 'oss copy',
       kind: 'oss-atomic',
-      description: '复制 OSS 对象到目标 key。',
+      description: '复制文件中转对象到目标 key。',
       method: 'POST',
       apiPath: OSS_COPY_PATH,
       positionals: [],
       options: [
-        { flag: '--source-key', name: 'sourceKey', required: true, label: '源 OSS 对象 key。' },
-        { flag: '--target-key', name: 'targetKey', required: true, label: '目标 OSS 对象 key。' },
+        { flag: '--source-key', name: 'sourceKey', required: true, label: '源文件对象 key。' },
+        { flag: '--target-key', name: 'targetKey', required: true, label: '目标文件对象 key。' },
         { flag: '--source-bucket', name: 'sourceBucket', required: false, label: '可选源 bucket。' },
         { flag: '--target-bucket', name: 'targetBucket', required: false, label: '可选目标 bucket。' },
         ...commonOptions(),
@@ -75,7 +75,7 @@ export function listOssCommands() {
         source_bucket: '<optional source bucket>',
         target_bucket: '<optional target bucket>',
       },
-      returns: '返回复制后的对象信息，字段以后端实际响应为准。',
+      returns: '返回复制后的对象信息，字段以 YuanFlow API 实际响应为准。',
     },
   ];
 }

package/src/shortcuts.js

@@ -7,7 +7,7 @@ export const shortcuts = [
     socialPath: '/douyin/app/v3/fetch_multi_video_v2',
     positionals: [{ name: 'url', label: '作品链接' }],
     options: [],
-    returns: '返回作品基础信息、作者信息、互动统计、媒体信息等字段，字段结构以上游实际响应为准。',
+    returns: '返回作品基础信息、作者信息、互动统计、媒体信息等字段，字段结构以 YuanFlow API 实际响应为准。',
     alternatives: [
       'GET /social/douyin/app/v3/fetch_one_video_by_share_url?share_url=...',
       'GET /social/douyin/web/fetch_one_video?aweme_id=...',
@@ -21,7 +21,7 @@ export const shortcuts = [
     socialPath: '/douyin/app/v3/fetch_video_high_quality_play_url',
     positionals: [{ name: 'share_url', label: '作品链接或分享链接' }],
     options: [{ flag: 'region', name: 'region', label: '地区，可选，如 CN' }],
-    returns: '返回视频播放地址、清晰度信息、媒体地址等；是否可直接下载取决于上游返回和目标平台限制。',
+    returns: '返回视频播放地址、清晰度信息、媒体地址等；是否可直接下载取决于 YuanFlow API 返回和目标平台限制。',
     alternatives: [
       'POST /social/douyin/app/v3/fetch_multi_video_high_quality_play_url',
       'GET /social/douyin/web/fetch_video_high_quality_play_url',
@@ -280,7 +280,7 @@ export const shortcuts = [
   {
     platform: 'wechat',
     command: 'channels-home',
-    description: '微信视频号主页采集，参数结构通常需要用 --json 传入上游要求的完整请求体。',
+    description: '微信视频号主页采集，参数结构通常需要用 --json 传入接口要求的完整请求体。',
     method: 'POST',
     socialPath: '/wechat_channels/fetch_home_page',
     positionals: [],

package/src/trending-tools.js

@@ -26,7 +26,7 @@ export function listTrendingCommands() {
         { flag: '--date-window', name: 'date_window', required: false, label: '时间窗口，默认 2 按天' },
         { flag: '--tags-json', name: 'tags', required: false, label: '垂类标签 JSON 数组，空则全部垂类' },
       ],
-      returns: '返回五类视频热榜的统一 JSON，字段结构以上游实际响应为准。',
+      returns: '返回五类视频热榜的统一 JSON，字段结构以 YuanFlow API 实际响应为准。',
     },
   ];
 }

package/src/work-tools.js

@@ -148,8 +148,8 @@ function workCommand(platform, action, endpoint, kind) {
     requestBody: endpoint.bodyMode ? requestBodyExample(endpoint, 'target') : null,
     returns:
       action === 'download'
-        ? '返回作品可播放媒体信息、下载地址候选或视频流信息，字段以上游实际响应为准。'
-        : '返回作品详情、作者信息、正文/标题、互动统计和媒体信息，字段以上游实际响应为准。',
+        ? '返回作品可播放媒体信息、下载地址候选或视频流信息，字段以 YuanFlow API 实际响应为准。'
+        : '返回作品详情、作者信息、正文/标题、互动统计和媒体信息，字段以 YuanFlow API 实际响应为准。',
   };
 }
 
@@ -167,8 +167,8 @@ function searchCommand(platform, action, endpoint, kind) {
     requestBody: endpoint.bodyMode ? requestBodyExample(endpoint, 'keyword') : null,
     returns:
       action === 'users'
-        ? '返回用户/频道搜索结果、分页字段和平台原始摘要字段，字段以上游实际响应为准。'
-        : '返回内容搜索结果、分页字段和平台原始摘要字段，字段以上游实际响应为准。',
+        ? '返回用户/频道搜索结果、分页字段和平台原始摘要字段，字段以 YuanFlow API 实际响应为准。'
+        : '返回内容搜索结果、分页字段和平台原始摘要字段，字段以 YuanFlow API 实际响应为准。',
   };
 }