yuanflow-cli 0.1.44 → 0.1.46

package/skills/yuanflow-skill//347/233/264/346/222/255/350/257/235/346/234/257/347/224/237/346/210/220/SKILL.md

@@ -16,6 +16,10 @@ emoji: 🎤
 
 不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
 
+## YuanFlow-main 内置环境
+
+在 YuanFlow-main 内置环境中，只有需要调用知识库、个人创作库、HTML 报告或其它 YuanFlow 能力时，才使用 `yuanflow_cli_call`、`yuanflow_image_request`、`artifact_files_register` 等受控工具。token、受管包路径和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
+
 本 Skill 用于生成直播话术和直播节奏脚本。执行时必须先查历史资产，再查自媒体知识库，最后结合用户本次直播目标输出可直接使用的话术。
 
 ## 固定流程

package/skills/yuanflow-skill//350/207/252/345/252/222/344/275/223/346/265/217/350/247/210/345/231/250/350/207/252/345/212/250/345/214/226/SKILL.md

@@ -130,13 +130,13 @@ yuanflow-cli browser task-plan --platform douyin --task publish --account main -
 默认本地根目录：
 
 ```text
-%APPDATA%\YuanFlow\runtime_tools\browser-automation
+由运行环境管理的 YuanFlow 浏览器自动化目录
 ```
 
 单账号目录：
 
 ```text
-%APPDATA%\YuanFlow\runtime_tools\browser-automation\accounts\<platform>\<account>
+<浏览器自动化目录>/accounts/<platform>/<account>
 ```
 
 关键子目录：
@@ -235,13 +235,13 @@ downloads    浏览器下载文件
     "--account",
     "main",
     "--file",
-    "D:\\media\\post.mp4",
+    "<本地发布素材路径>",
     "--title",
     "标题",
     "--caption",
     "正文",
     "--cover",
-    "D:\\media\\cover.png",
+    "<本地封面路径>",
     "--format",
     "agent-json"
   ]

package/skills/yuanflow-skill//350/247/206/350/247/211/347/220/206/350/247/243/SKILL.md

@@ -50,11 +50,11 @@ emoji: 👁️
 ## 外部 CLI 示例
 
 ```powershell
-yuanflow-cli ai qwen3-vl-plus --prompt "描述这张图的主体、文字和环境" --image-file "D:\素材\cover.png" --format agent-json
+yuanflow-cli ai qwen3-vl-plus --prompt "描述这张图的主体、文字和环境" --image-file "<本地图片路径>" --format agent-json
 ```
 
 ```powershell
-yuanflow-cli ai qwen3-vl-plus --prompt "总结视频画面变化和关键细节" --video-file "D:\素材\demo.mp4" --format agent-json
+yuanflow-cli ai qwen3-vl-plus --prompt "总结视频画面变化和关键细节" --video-file "<本地视频路径>" --format agent-json
 ```
 
 ## YuanFlow-main 内置环境
@@ -109,7 +109,7 @@ yuanflow-cli ai qwen3-vl-plus --prompt "总结视频画面变化和关键细节"
     "--prompt",
     "请识别这张图片中的关键信息，并按主体、文字、细节、可能风险输出。",
     "--image-file",
-    "D:\\素材\\cover.png",
+    "<本地图片路径>",
     "--format",
     "agent-json"
   ],
@@ -127,7 +127,7 @@ yuanflow-cli ai qwen3-vl-plus --prompt "总结视频画面变化和关键细节"
     "--prompt",
     "请按时间顺序总结视频画面变化、人物动作、关键物品和屏幕文字。",
     "--video-file",
-    "D:\\素材\\demo.mp4",
+    "<本地视频路径>",
     "--format",
     "agent-json"
   ],

package/skills/yuanflow-skill//350/247/206/351/242/221/346/212/225/346/265/201/347/255/226/347/225/245/SKILL.md

@@ -40,7 +40,7 @@ emoji: 📈
    - Windows 外部 Agent 默认保存到：
 
 ```text
-%APPDATA%\YuanFlow\runtime_tools\video-ad-strategy\account-context
+由运行环境管理的 YuanFlow 视频投流帐号上下文目录
 ```
 
    - 文件名建议：

package/skills/yuanflow-skill//350/247/206/351/242/221/346/213/206/350/247/243/SKILL.md

@@ -96,7 +96,7 @@ YuanFlow-main 内置环境调用见后文专属小节。
 解析到可访问视频 URL 后，经用户授权保存到本地临时文件，再提交 qwen3-vl-plus。保存文件时使用清晰路径，例如：
 
 ```text
-D:\素材\yuanflow-video-breakdown\input.mp4
+<视频拆解工作目录>/input.mp4
 ```
 
 保存方式：
@@ -109,14 +109,14 @@ D:\素材\yuanflow-video-breakdown\input.mp4
 外部 Agent 可用的保存示例：
 
 ```powershell
-New-Item -ItemType Directory -Force "D:\素材\yuanflow-video-breakdown"
-Invoke-WebRequest -Uri "<解析得到的视频直链>" -OutFile "D:\素材\yuanflow-video-breakdown\input.mp4"
+New-Item -ItemType Directory -Force "<视频拆解工作目录>"
+Invoke-WebRequest -Uri "<解析得到的视频直链>" -OutFile "<视频拆解工作目录>/input.mp4"
 ```
 
 如果是 m3u8：
 
 ```powershell
-ffmpeg -y -i "<解析得到的 m3u8 地址>" -c copy "D:\素材\yuanflow-video-breakdown\input.mp4"
+ffmpeg -y -i "<解析得到的 m3u8 地址>" -c copy "<视频拆解工作目录>/input.mp4"
 ```
 
 如果平台解析只返回播放候选而没有稳定下载 URL，说明当前链接需要用户提供可下载文件，或先让用户使用其它授权方式保存视频。
@@ -128,7 +128,7 @@ ffmpeg -y -i "<解析得到的 m3u8 地址>" -c copy "D:\素材\yuanflow-video-b
 外部 CLI 示例：
 
 ```powershell
-yuanflow-cli ai qwen3-vl-plus --prompt "你是自媒体视频拆解助手。请按知识库规则拆解这个视频：..." --video-file "D:\素材\yuanflow-video-breakdown\input.mp4" --format agent-json
+yuanflow-cli ai qwen3-vl-plus --prompt "你是自媒体视频拆解助手。请按知识库规则拆解这个视频：..." --video-file "<本地视频路径>" --format agent-json
 ```
 
 ## YuanFlow-main 内置环境
@@ -145,7 +145,7 @@ YuanFlow-main 内置工具示例：
     "--prompt",
     "你是自媒体视频拆解助手。请严格按以下知识库规则拆解这个对标视频：\\n【知识库规则摘要】...\\n【用户目标】学习该视频的选题、开头、脚本结构、镜头节奏和可复用创作方法。\\n请输出：1. 一句话总结；2. 视频定位；3. 开头钩子；4. 内容结构；5. 镜头/画面节奏；6. 情绪和转化设计；7. 可复用模板；8. 不建议照搬的风险。",
     "--video-file",
-    "D:\\素材\\yuanflow-video-breakdown\\input.mp4",
+    "<本地视频路径>",
     "--format",
     "agent-json"
   ],

package/skills/yuanflow-skill//350/247/206/351/242/221/346/231/272/350/203/275/345/211/252/350/276/221/SKILL.md

@@ -93,9 +93,9 @@ YuanFlow-main 内置环境优先用 `yuanflow_cli_call` 调用知识库，不要
 
 ```bash
 yuanflow-cli video strategy \
-  --project "D:\素材\yuanflow-video-edit" \
+  --project "<剪辑项目目录>" \
   --template-type talking_head \
-  --rules-file "D:\规则\logic.json,D:\规则\talking_head.json,D:\规则\cli.json" \
+  --rules-file "<剪辑逻辑规则文件>,<口播模板规则文件>,<CLI校验规则文件>" \
   --format agent-json
 ```
 
@@ -136,11 +136,11 @@ CLI 会生成 `strategy_snapshot.json`，后续 Agent 必须基于这个快照
     "video",
     "init",
     "--input",
-    "D:\\素材",
+    "<素材目录>",
     "--primary-audio",
-    "D:\\素材\\口播.mp3",
+    "<主音频文件>",
     "--broll",
-    "D:\\素材\\素材1.mp4,D:\\素材\\素材2.mp4",
+    "<B-roll文件1>,<B-roll文件2>",
     "--target-duration",
     "60",
     "--aspect",
@@ -157,9 +157,9 @@ CLI 会生成 `strategy_snapshot.json`，后续 Agent 必须基于这个快照
 
 ```bash
 yuanflow-cli video init \
-  --input "D:\素材" \
-  --primary-audio "D:\素材\口播.mp3" \
-  --broll "D:\素材\素材1.mp4,D:\素材\素材2.mp4" \
+  --input "<素材目录>" \
+  --primary-audio "<主音频文件>" \
+  --broll "<B-roll文件1>,<B-roll文件2>" \
   --target-duration 60 \
   --aspect 9:16 \
   --format agent-json
@@ -168,7 +168,7 @@ yuanflow-cli video init \
 ### 2. 扫描素材
 
 ```bash
-yuanflow-cli video inspect --project "D:\素材\yuanflow-video-edit" --format agent-json
+yuanflow-cli video inspect --project "<剪辑项目目录>" --format agent-json
 ```
 
 如果只是验证命令结构，可以加 `--dry-run`。
@@ -179,8 +179,8 @@ yuanflow-cli video inspect --project "D:\素材\yuanflow-video-edit" --format ag
 
 ```bash
 yuanflow-cli video align \
-  --project "D:\素材\yuanflow-video-edit" \
-  --asr-file "D:\素材\asr.json" \
+  --project "<剪辑项目目录>" \
+  --asr-file "<ASR结果文件>" \
   --format agent-json
 ```
 
@@ -199,7 +199,7 @@ yuanflow-cli video align \
 
 ```bash
 yuanflow-cli video timeline \
-  --project "D:\素材\yuanflow-video-edit" \
+  --project "<剪辑项目目录>" \
   --fps 1 \
   --format agent-json
 ```
@@ -237,8 +237,8 @@ Agent 或人工查看抽帧图片后，先写出 `visual_review.agent.json`，
 
 ```bash
 yuanflow-cli video visual-review \
-  --project "D:\素材\yuanflow-video-edit" \
-  --review-file "D:\素材\yuanflow-video-edit\visual_review.agent.json" \
+  --project "<剪辑项目目录>" \
+  --review-file "<视觉理解回写文件>" \
   --format agent-json
 ```
 
@@ -330,8 +330,8 @@ Agent 读取：
 
 ```bash
 yuanflow-cli video plan \
-  --project "D:\素材\yuanflow-video-edit" \
-  --timeline-plan "D:\素材\yuanflow-video-edit\timeline_plan.agent.json" \
+  --project "<剪辑项目目录>" \
+  --timeline-plan "<时间线计划文件>" \
   --format agent-json
 ```
 
@@ -339,9 +339,9 @@ yuanflow-cli video plan \
 
 ```bash
 yuanflow-cli video plan \
-  --project "D:\素材\yuanflow-video-edit" \
-  --timeline-plan "D:\素材\yuanflow-video-edit\timeline_plan.agent.json" \
-  --edl "D:\素材\yuanflow-video-edit\edl.agent.json" \
+  --project "<剪辑项目目录>" \
+  --timeline-plan "<时间线计划文件>" \
+  --edl "<EDL文件>" \
   --format agent-json
 ```
 
@@ -350,14 +350,14 @@ yuanflow-cli video plan \
 ### 8. 渲染预览和自检
 
 ```bash
-yuanflow-cli video render-preview --project "D:\素材\yuanflow-video-edit" --format agent-json
-yuanflow-cli video evaluate --project "D:\素材\yuanflow-video-edit" --file "D:\素材\yuanflow-video-edit\preview.mp4" --format agent-json
+yuanflow-cli video render-preview --project "<剪辑项目目录>" --format agent-json
+yuanflow-cli video evaluate --project "<剪辑项目目录>" --file "<预览视频文件>" --format agent-json
 ```
 
 ### 9. 最终导出
 
 ```bash
-yuanflow-cli video render-final --project "D:\素材\yuanflow-video-edit" --format agent-json
+yuanflow-cli video render-final --project "<剪辑项目目录>" --format agent-json
 ```
 
 完成后在 YuanFlow-main 内置环境必须调用 `artifact_files_register` 登记 `final.mp4`、`edl.json` 和 `eval_report.json`，不要只告诉用户内部路径。

package/skills/yuanflow-skill//351/200/211/351/242/230/347/255/226/345/210/222/SKILL.md

@@ -16,6 +16,10 @@ emoji: 💡
 
 不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
 
+## YuanFlow-main 内置环境
+
+在 YuanFlow-main 内置环境中，只有需要调用知识库、个人创作库、HTML 报告或其它 YuanFlow 能力时，才使用 `yuanflow_cli_call`、`yuanflow_image_request`、`artifact_files_register` 等受控工具。token、受管包路径和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
+
 本 Skill 用于产出选题池、系列选题和选题优先级。执行时必须先查历史资产，再查自媒体知识库，最后结合用户本次目标输出可执行选题。
 
 ## 固定流程

package/skills/yuanflow-skill//351/237/263/350/247/206/351/242/221/345/234/250/347/272/277/350/275/254/346/226/207/345/255/227/SKILL.md

@@ -45,7 +45,7 @@ emoji: ☁️
 视频输入必须先抽音频：
 
 ```powershell
-ffmpeg -y -i "C:\path\to\input.mp4" -vn -acodec libmp3lame -ar 44100 -ac 2 "transcription-input.mp3"
+ffmpeg -y -i "<本地视频路径>" -vn -acodec libmp3lame -ar 44100 -ac 2 "transcription-input.mp3"
 ```
 
 如果 ffmpeg 不可用，必须明确告诉用户缺少 ffmpeg，不能伪造转写结果。
@@ -60,7 +60,7 @@ YuanFlow-main 内置环境优先调用 `yuanflow_cli_call`，使用兼容子命
     "oss",
     "temp-upload",
     "--file",
-    "C:\\path\\to\\transcription-input.mp3",
+    "<本地音频路径>",
     "--filename",
     "transcription-input.mp3",
     "--content-type",

package/src/agent-protocol.js

@@ -5,9 +5,9 @@ import { listKnowledgeCommands } from './knowledge-tools.js';
 import { listOssCommands } from './oss-tools.js';
 import { listBrowserCommands } from './browser-tools.js';
 import { listSearchCommands, listWorkCommands } from './work-tools.js';
-import { listVideoCommands } from './video-tools.js';
 import { listTrendingCommands } from './trending-tools.js';
 import { listAiCommands } from './ai-tools.js';
+import { listVoiceCommands } from './voice-tools.js';
 
 const ERROR_MAP = [
   {
@@ -110,9 +110,9 @@ export function buildCommandRegistry() {
   const knowledgeCommands = listKnowledgeCommands();
   const ossCommands = listOssCommands();
   const browserCommands = listBrowserCommands();
-  const videoCommands = listVideoCommands();
   const trendingCommands = listTrendingCommands();
   const aiCommands = listAiCommands();
+  const voiceCommands = listVoiceCommands();
   return [
     ...shortcuts,
     ...endpoints,
@@ -122,9 +122,9 @@ export function buildCommandRegistry() {
     ...knowledgeCommands,
     ...ossCommands,
     ...browserCommands,
-    ...videoCommands,
     ...trendingCommands,
     ...aiCommands,
+    ...voiceCommands,
   ].sort((left, right) => left.key.localeCompare(right.key));
 }
 

package/src/cli.js

@@ -20,7 +20,6 @@ import { collectComments } from './comment-collector.js';
 import { getKnowledgeDocs, navigateKnowledge } from './knowledge-tools.js';
 import { copyObject, signedUrl, tempUpload } from './oss-tools.js';
 import { runBrowserCommand } from './browser-tools.js';
-import { runVideoCommand } from './video-tools.js';
 import {
   getWorkDetail,
   getWorkDownload,
@@ -29,6 +28,7 @@ import {
 } from './work-tools.js';
 import { fetchVideoHotList } from './trending-tools.js';
 import { formatAiHelp, runAiCommand } from './ai-tools.js';
+import { formatVoiceHelp, runVoiceCommand } from './voice-tools.js';
 
 export async function main(argv) {
   const args = argv.slice(2);
@@ -94,13 +94,13 @@ export async function main(argv) {
     return;
   }
 
-  if (command === 'video') {
-    await handleVideo(rest);
+  if (command === 'ai') {
+    await handleAi(rest);
     return;
   }
 
-  if (command === 'ai') {
-    await handleAi(rest);
+  if (command === 'voice') {
+    await handleVoice(rest);
     return;
   }
 
@@ -427,16 +427,6 @@ async function handleBrowser(args) {
   });
 }
 
-async function handleVideo(args) {
-  const { positionals, options } = parseOptions(args);
-  const [action = 'init'] = positionals;
-  const result = await runVideoCommand({ action, options });
-  await outputResult(result, options, {
-    command: `video ${action}`,
-    meta: { kind: 'video-editing' },
-  });
-}
-
 async function handleAi(args) {
   const { positionals, options } = parseOptions(args);
   const [action = 'help', ...rest] = positionals;
@@ -451,6 +441,20 @@ async function handleAi(args) {
   });
 }
 
+async function handleVoice(args) {
+  const { positionals, options } = parseOptions(args);
+  const [action = 'help'] = positionals;
+  if (action === 'help' && !isAgentJsonFormat(options)) {
+    console.log(formatVoiceHelp());
+    return;
+  }
+  const result = await runVoiceCommand({ action, options });
+  await outputResult(result, { ...options, output: undefined }, {
+    command: `voice ${action}`,
+    meta: { endpoint: result.endpoint?.path, kind: result.endpoint?.kind || 'voice' },
+  });
+}
+
 async function handleGeneratedCommand(platform, args) {
   if (!getPlatforms().includes(platform)) {
     throw new Error(`未知平台：${platform}。可用平台：${getPlatforms().join(', ')}`);
@@ -623,16 +627,14 @@ function printHelp() {
   yuanflow-cli oss signed-url --key path/to/file.png --ttl-seconds 1800 --format agent-json
   yuanflow-cli browser profile-path --platform douyin --account main --format agent-json
   yuanflow-cli browser task-plan --platform xiaohongshu --task publish --account main --format agent-json
-  yuanflow-cli video init --input "D:\\素材" --primary-audio "D:\\素材\\口播.mp3" --broll "D:\\素材\\画面.mp4" --format agent-json
-  yuanflow-cli video strategy --project "D:\\素材\\yuanflow-video-edit" --template-type talking_head --rules-file "D:\\规则\\logic.json,D:\\规则\\template.json,D:\\规则\\cli.json" --format agent-json
-  yuanflow-cli video align --project "D:\\素材\\yuanflow-video-edit" --asr-file "D:\\素材\\asr.json" --format agent-json
-  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 voice clone --file-transfer "D:\\voice\\sample.wav" --name demo --activate --dry-run
+  yuanflow-cli voice list --dry-run
+  yuanflow-cli voice activate --voice voice_xxx --dry-run
+  yuanflow-cli voice replicate --text "你好" --voice voice_xxx --output "D:\\voice\\replicate.mp3" --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
@@ -648,7 +650,7 @@ function printHelp() {
   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 校验和渲染。
+  视频智能剪辑和视频制作执行链已迁移到独立项目 D:\\AI_project\\视频制作，不再由 yuanflow-cli video 命令提供；视频拆解仍由 yuanflow-skill 的“视频拆解”提供。
   需要鉴权的请求都会使用 Authorization: Bearer <token>。
   token 优先级：--token > YUANCHUANG_API_TOKEN > 本地 config.token。
   YuanFlow-main 内置环境使用时，token 由 YuanFlow-main 内置环境注入，不需要手动配置。