yuanflow-cli 0.1.45 → 0.1.46

package/README.md

@@ -48,9 +48,6 @@ yuanflow-cli knowledge entry --output-format short_video_script --domain 自媒
 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 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" --format agent-json
 yuanflow-cli ai qwen3-vl-plus --prompt "总结这个视频画面" --video-url "https://example.com/video.mp4" --format agent-json
 yuanflow-cli ai qwen3-vl-plus --prompt "描述本地视频" --video-file "D:\素材\demo.mp4" --format agent-json
@@ -299,25 +296,15 @@ Agent 应先查看 `knowledge docs`，再把用户需求整理成 `task_frame`
 
 `knowledge entry`、`knowledge packs`、`knowledge evaluate` 会按规则库实际校验要求本地检查 `task_frame.domain` 和 `task_frame.content_goal`，CLI 调用时必须传 `--domain` 和 `--content-goal`，或通过 `--task-frame-file` 提供同名字段。`rules` 和 `rule-detail` 用于按已选包/规则继续下钻，仍必须分别传 `--pack-code` 或 `--rule-code`。
 
-### 视频智能剪辑
+### 视频制作能力迁移
 
-视频剪辑链路先查自媒体知识库中的 `video_editing_strategy`，再进入 `video` 命令执行。第一版人工测试流程是：查询规则包、保存策略快照、扫描素材、通过“音视频在线转文字”取得 ASR/时间戳结果、导入音频对齐、1 秒 1 帧抽帧、导入视觉理解结果、Agent 生成 `timeline_plan.agent.json`、CLI 校验并渲染。
+视频智能剪辑、主音频+B-roll、EDL 校验和基础渲染链路已迁移到独立项目维护，不再作为 `yuanflow-cli video` 命令提供。独立开发目录：
 
-```bash
-yuanflow-cli knowledge rules --pack-code video_edit_logic_layer_pack --domain 视频剪辑 --content-goal "口播视频剪辑，需要主音频匹配 B-roll 并生成 EDL" --output-format video_edit_plan --format agent-json --output "D:\规则\logic.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:\规则\talking_head.json,D:\规则\cli.json" --format agent-json
-yuanflow-cli video inspect --project "D:\素材\yuanflow-video-edit" --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 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-final --project "D:\素材\yuanflow-video-edit" --format agent-json
+```text
+D:\AI_project\视频制作
 ```
 
-`video align` 只导入已有 ASR 或 forced alignment 结果，不直接调用在线 ASR；在线 ASR 由“音视频在线转文字”Skill 执行。`video visual-review` 只导入 Agent/人工对抽帧图片的视觉理解，不替 Agent 做语义判断。`--template-type` 当前支持 `talking_head` 和 `short_video_sales`。知识库查询由 `knowledge` 命令负责，`video` 命令只导入规则结果并保存 `strategy_snapshot.json`，不直接远程查规则库。
+`YuanFlow-cli` 仍保留通用视频理解、视频拆解、音视频在线转文字、作品下载和知识库查询等通用能力；视频制作项目后续按需调用这些通用能力。
 
 ### 业务创作类 Skill
 
@@ -383,7 +370,7 @@ yuanflow-cli browser dry-run --platform xiaohongshu --task publish --account mai
 3. 使用 `yuanflow-cli oss temp-upload` 上传音频到 YuanFlow 文件中转。
 4. ASR 请求必须优先使用文件中转返回的 `data.signed_url` 作为 `metadata.audio_url`，不要优先使用裸域名 `data.url`。
 5. 调用 `POST https://open.yuanchuangai.com/v1/audio/transcriptions`，模型 `doubao-asr`，`response_format=json`。
-6. 默认只返回响应里的 `text` 干净文本；视频剪辑任务需要音频对齐时，要优先保留 ASR 响应中的 `segments` / `words` 时间戳结构，后续交给 `yuanflow-cli video align --asr-file` 导入。接口没有返回时间戳时，不编造时间戳，改用 forced alignment 或人工按文案切分时间。
+6. 默认只返回响应里的 `text` 干净文本；视频制作项目需要音频对齐时，要优先保留 ASR 响应中的 `segments` / `words` 时间戳结构，后续交给独立视频制作项目导入。接口没有返回时间戳时，不编造时间戳，改用 forced alignment 或人工按文案切分时间。
 
 请求体示例：
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yuanflow-cli",
-  "version": "0.1.45",
+  "version": "0.1.46",
   "description": "YuanFlow 自媒体 API CLI 与 Skill 安装器。",
   "type": "module",
   "license": "MIT",

package/skills/yuanflow-skill/HTML/346/212/245/345/221/212/347/224/237/346/210/220/SKILL.md

@@ -16,6 +16,10 @@ emoji: 🧾
 
 不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
 
+## YuanFlow-main 内置环境
+
+在 YuanFlow-main 内置环境中，只有需要调用 CLI、文件中转、图片能力或写入受控产物时，才使用 `yuanflow_cli_call`、`yuanflow_image_request`、`artifact_files_register` 等受控工具。token、受管包路径和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
+
 本 Skill 用于生成一个可直接打开阅读的单页 HTML 报告。它不是后台 Dashboard，也不是多页面站点，而是面向最终用户查阅的视觉化长文报告页。
 
 ## 核心原则

package/skills/yuanflow-skill/IP/350/277/220/350/220/245/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 用于围绕个人 IP 或品牌 IP 制定持续运营方案。执行时必须先查历史资产，再查自媒体知识库，最后结合用户本次目标输出可执行方案。
 
 ## 固定流程

package/skills/yuanflow-skill/README.md

@@ -18,6 +18,8 @@ YuanFlow Skill 是 `yuanflow-cli` 的 Agent Skill 仓库，用于把社媒平台
 - `HTML报告生成/`：单页 HTML 报告生成 Skill，内置 9 种米色留白报告模板。
 - `本地音视频转文字/`：本地 SenseVoice 音视频转文字 Skill，首次明确使用时按需下载模型。
 - `音视频在线转文字/`：通过 YuanFlow 在线 ASR 接口把音频或视频转成干净文本，视频会先抽取音频并通过 YuanFlow 文件中转。
+- `声音克隆/`：通过 `yuanflow-cli voice clone/list/activate` 创建、查询和激活声音克隆音色，返回可复用的 `voice_xxx`。
+- `声音复刻/`：通过 `yuanflow-cli voice replicate` 使用已有 `voice_xxx` 或默认音色把文本合成为复刻音频文件。
 - `自媒体浏览器自动化/`：自媒体平台专用浏览器自动化 Skill，用于登录态隔离、Cookie/profile 本地保存、页面采集和作品发布流程。
 - `帐号监控/`：帐号搜索、主页资料、主页作品、历史快照、变化对比和 HTML 可视化分流 Skill。
 - `个人创作库/`：长期保存、整理、复盘和复用用户认可的自媒体合格产出物。
@@ -47,6 +49,7 @@ YuanFlow Skill 是 `yuanflow-cli` 的 Agent Skill 仓库，用于把社媒平台
 - 在用户要求智能剪辑、自动剪辑、主音频匹配 B-roll、重排视频画面或生成剪辑预览时，使用视频智能剪辑 Skill；第一版先查规则库，导入策略快照，用“音视频在线转文字”或 forced alignment 建立音频对齐，抽帧频率固定 1 秒 1 帧，再回写视觉理解结果，最后生成 `timeline_plan` 和 EDL。
 - 在用户明确要求本地转写时，把本地音频或视频转成文字；视频会先抽取音频，模型和缓存都保存在 Skill 自己目录下。
 - 在用户要求在线转写、云端转写或 doubao-asr 时，把本地音频或视频经 YuanFlow 文件中转后提交在线 ASR，默认只返回干净文本。
+- 在用户要求创建声音克隆、查询已有克隆音色 ID、激活默认克隆音色或生成声音复刻音频时，使用声音克隆或声音复刻 Skill；声音复刻前必须先拿到 `voice_xxx` 或使用已激活默认音色。
 - 在用户要求自媒体平台浏览器自动化、账号登录态隔离、Cookie/profile 保存、平台页面采集或作品发布时，使用专用自媒体浏览器自动化 Skill；普通网页浏览和搜索仍使用通用浏览器能力。
 - 监控抖音、小红书、微博、知乎、Bilibili、TikTok、YouTube、Twitter/X 帐号主页，保存快照并对比历史变化；抖音链路优先使用 `get-sec-user-id -> user-profile -> user-posts -> works detail`。
 - 在用户要求保存、归档、复盘或复用已完成创作成果时，把选题、标题、文案、脚本、封面、剪辑思路、发布计划和数据复盘沉淀进个人创作库。

package/skills/yuanflow-skill//344/270/252/344/272/272/345/210/233/344/275/234/345/272/223/SKILL.md

@@ -156,10 +156,10 @@ meta/
 
 在 YuanFlow-main 内置环境，本 Skill 是托管 CLI Skill 的一个整体目录。不要把 `library/` 下的分类当成独立 Skill 安装，也不要在子目录里创建 `SKILL.md`。
 
-如果需要写入文件，优先使用当前 Skill 的真实目录：
+如果需要写入文件，优先使用 YuanFlow-main 受控运行时返回的当前 Skill 真实目录；外部用户安装时，则以当前 Skill 安装目录为准。
 
 ```text
-config.managed_skill_dir
+<当前 Skill 安装目录>
 ```
 
 在没有明确用户授权前，不要删除、覆盖或批量移动用户已有创作资料。

package/skills/yuanflow-skill//345/205/254/344/274/227/345/217/267/347/224/237/346/210/220/344/270/216/345/217/221/345/270/203/SKILL.md

@@ -89,7 +89,7 @@ Agent 在排版前应做结构化增强，但不能改变事实：
 
 ```bash
 python scripts/wechat_draft.py \
-  --credentials-file "D:\path\to\wechat-credentials.txt" \
+  --credentials-file "<公众号凭证文件路径>" \
   --input article.md \
   --theme newspaper \
   --cover-image cover.png \
@@ -102,7 +102,7 @@ python scripts/wechat_draft.py \
 
 ```bash
 python scripts/wechat_draft.py \
-  --credentials-file "D:\path\to\wechat-credentials.txt" \
+  --credentials-file "<公众号凭证文件路径>" \
   --input article.md \
   --theme newspaper \
   --draft-media-id MEDIA_ID \

package/skills/yuanflow-skill//345/210/233/344/275/234/346/200/273/347/233/221/SKILL.md

@@ -16,6 +16,10 @@ emoji: 🎯
 
 不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
 
+## YuanFlow-main 内置环境
+
+在 YuanFlow-main 内置环境中，只有需要调度其它 Skill、调用 CLI、登记产物或写入受控工作台时，才使用 `yuanflow_cli_call`、`yuanflow_image_request`、`content_workbench_update`、`artifact_files_register` 等受控工具。token、受管包路径和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
+
 本 Skill 是 YuanFlow 自媒体创作链路的把控与验收角色。它不替代具体执行技能，而是负责判断创作目标是否清楚、选题是否成立、内容是否有创新、结构是否完整、表达是否适合平台，以及最终产物是否达到可发布或可交付标准。
 
 ## 分类

package/skills/yuanflow-skill//345/243/260/351/237/263/345/205/213/351/232/206/SKILL.md

@@ -27,13 +27,13 @@ emoji: 🎙️
 推荐本地文件使用 YuanFlow 文件中转：
 
 ```powershell
-yuanflow-cli voice clone --file-transfer "D:\voice\sample.wav" --name "我的声音" --activate --format agent-json
+yuanflow-cli voice clone --file-transfer "<本地声音样本路径>" --name "我的声音" --activate --format agent-json
 ```
 
 如果用户明确希望直接提交本地音频：
 
 ```powershell
-yuanflow-cli voice clone --file "D:\voice\sample.wav" --name "我的声音" --activate --format agent-json
+yuanflow-cli voice clone --file "<本地声音样本路径>" --name "我的声音" --activate --format agent-json
 ```
 
 如果已经有可访问音频 URL：
@@ -97,7 +97,7 @@ yuanflow-cli voice activate --voice voice_xxx --format agent-json
     "voice",
     "clone",
     "--file-transfer",
-    "D:\\voice\\sample.wav",
+    "<本地声音样本路径>",
     "--name",
     "我的声音",
     "--activate",

package/skills/yuanflow-skill//345/243/260/351/237/263/345/244/215/345/210/273/SKILL.md

@@ -38,19 +38,19 @@ yuanflow-cli voice list --format agent-json
 ## 生成复刻音频
 
 ```powershell
-yuanflow-cli voice replicate --text "你好，这是声音复刻测试。" --voice voice_xxx --output "D:\voice\replicate.mp3" --format agent-json
+yuanflow-cli voice replicate --text "你好，这是声音复刻测试。" --voice voice_xxx --output "<输出音频路径>" --format agent-json
 ```
 
 如果用户要求使用默认音色：
 
 ```powershell
-yuanflow-cli voice replicate --text "你好，这是声音复刻测试。" --voice default --output "D:\voice\replicate.mp3" --format agent-json
+yuanflow-cli voice replicate --text "你好，这是声音复刻测试。" --voice default --output "<输出音频路径>" --format agent-json
 ```
 
 默认输出 `mp3`。用户要求 wav 或 pcm 时，增加 `--response-format`：
 
 ```powershell
-yuanflow-cli voice replicate --text "测试内容" --voice voice_xxx --response-format wav --output "D:\voice\replicate.wav" --format agent-json
+yuanflow-cli voice replicate --text "测试内容" --voice voice_xxx --response-format wav --output "<输出音频路径>" --format agent-json
 ```
 
 ## 输出要求
@@ -59,7 +59,7 @@ yuanflow-cli voice replicate --text "测试内容" --voice voice_xxx --response-
 
 ```text
 复刻音频已生成：
-文件路径：D:\voice\replicate.mp3
+文件路径：`<输出音频路径>`
 使用音色：voice_xxx
 ```
 

package/skills/yuanflow-skill//345/260/217/347/272/242/344/271/246/350/277/220/350/220/245/SKILL.md

@@ -85,7 +85,7 @@ yuanflow-cli comments collect --platform xiaohongshu --target "笔记链接或
 yuanflow-cli browser session-init --platform xiaohongshu --account main --format agent-json
 yuanflow-cli browser profile-path --platform xiaohongshu --account main --format agent-json
 yuanflow-cli browser task-plan --platform xiaohongshu --task login --format agent-json
-yuanflow-cli browser dry-run --platform xiaohongshu --task publish --title "标题" --caption "正文" --file "D:\path\image.png" --format agent-json
+yuanflow-cli browser dry-run --platform xiaohongshu --task publish --title "标题" --caption "正文" --file "<本地图片路径>" --format agent-json
 ```
 
 ## 调研与采集流程

package/skills/yuanflow-skill//345/260/217/347/272/242/344/271/246/350/277/220/350/220/245/references/commands.md

@@ -27,7 +27,7 @@ yuanflow-cli xiaohongshu web-v3 fetch-user-notes --user_id "用户ID" --format a
 yuanflow-cli browser session-init --platform xiaohongshu --account main --format agent-json
 yuanflow-cli browser profile-path --platform xiaohongshu --account main --format agent-json
 yuanflow-cli browser task-plan --platform xiaohongshu --task login --format agent-json
-yuanflow-cli browser dry-run --platform xiaohongshu --task publish --title "标题" --caption "正文" --file "D:\path\asset.png" --format agent-json
+yuanflow-cli browser dry-run --platform xiaohongshu --task publish --title "标题" --caption "正文" --file "<本地素材路径>" --format agent-json
 ```
 
 ## 写操作边界
@@ -36,4 +36,3 @@ yuanflow-cli browser dry-run --platform xiaohongshu --task publish --title "标
 - 点赞和收藏：用户明确要求后可执行。
 - 评论和回复：默认确认文本和目标。
 - 所有失败必须报告失败阶段，不能伪造成功。
-

package/skills/yuanflow-skill//345/270/220/345/217/267/345/256/232/344/275/215/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//345/270/220/345/217/267/347/233/221/346/216/247/SKILL.md

@@ -43,7 +43,7 @@ YuanFlow-main 内置环境默认保存到程序数据目录：
 Windows 外部 Agent 默认保存到：
 
 ```text
-%APPDATA%\YuanFlow\runtime_tools\account-monitor\snapshots
+由运行环境管理的 YuanFlow 帐号监控快照目录
 ```
 
 快照文件名建议：

package/skills/yuanflow-skill//346/226/207/346/241/210/345/210/233/344/275/234/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//346/234/254/345/234/260/351/237/263/350/247/206/351/242/221/350/275/254/346/226/207/345/255/227/SKILL.md

@@ -32,14 +32,14 @@ emoji: 🎙️
 - 用户只是提到音频、视频、文案、脚本，但没有要求本地转写。
 - 用户要求在线识别、云端转写或其它指定服务。
 
-## 固定目录
+## 运行目录
 
 本 Skill 的脚本目录为当前 Skill 目录下的 `scripts/`。
 
-默认运行目录：
+默认运行目录由当前运行环境管理，不要求外部用户使用固定安装路径。
 
-- Windows：`%APPDATA%/YuanFlow/runtime_tools/local-transcribe`
-- 其它系统：`~/.yuanflow/runtime_tools/local-transcribe`
+- Windows：当前用户数据目录下的 YuanFlow 本地转写运行目录。
+- 其它系统：当前用户主目录下的 YuanFlow 本地转写运行目录。
 
 默认子目录：
 
@@ -50,14 +50,16 @@ emoji: 🎙️
 
 虚拟环境仍创建在当前 Skill 的 `scripts/.venv`，不要全局安装依赖。
 
-在 YuanFlow 程序内置环境中，`skill_read` 返回的 `config.managed_skill_dir` 是当前 Skill 的真实目录。执行脚本时优先以这个目录为基准：
+不要把模型下载到用户桌面、项目根目录或系统临时目录。不要把模型文件打包进 Skill 或 npm 包。Windows 下 FunASR/SentencePiece 对中文路径不稳定，所以不要强制把模型放到中文 Skill 安装目录下。
+
+## YuanFlow-main 内置环境
+
+在 YuanFlow-main 内置环境中，当前 Skill 的真实目录由受控运行时返回。执行脚本时优先以这个目录为基准，不要求用户手动填写 Skill 安装路径：
 
 ```powershell
-cd "<config.managed_skill_dir>\scripts"
+cd "<当前 Skill 安装目录>\scripts"
 ```
 
-不要把模型下载到用户桌面、项目根目录或系统临时目录。不要把模型文件打包进 Skill 或 npm 包。Windows 下 FunASR/SentencePiece 对中文路径不稳定，所以不要强制把模型放到中文 Skill 安装目录下。
-
 ## 首次使用模型下载规则
 
 开始转写前先检查模型目录是否已经存在：
@@ -78,7 +80,7 @@ cd "<config.managed_skill_dir>\scripts"
 
 1. 确认用户明确要求本地转写。
 2. 读取本 Skill 完整说明。
-3. 定位 `config.managed_skill_dir` 或当前 Skill 目录。
+3. 定位当前 Skill 安装目录。
 4. 检查 Python 虚拟环境和依赖；不要全局安装依赖。
 5. 如果用户提供的是视频，先转为音频，再把音频转成文字。
 6. 如果用户提供的是音频，直接转成文字。
@@ -109,20 +111,20 @@ py -3.10 -m venv .venv
 
 ```powershell
 cd "<Skill目录>\scripts"
-.\.venv\Scripts\python.exe .\transcribe_media.py "C:\path\to\input.mp3"
+.\.venv\Scripts\python.exe .\transcribe_media.py "<本地音频路径>"
 ```
 
 视频示例：
 
 ```powershell
 cd "<Skill目录>\scripts"
-.\.venv\Scripts\python.exe .\transcribe_media.py "C:\path\to\input.mp4"
+.\.venv\Scripts\python.exe .\transcribe_media.py "<本地视频路径>"
 ```
 
 YuanFlow Agent 工具调用时推荐生成 UTF-16LE base64 后执行：
 
 ```powershell
-$script = "Set-Location -LiteralPath '<Skill目录>\scripts'; .\.venv\Scripts\python.exe .\transcribe_media.py 'C:\path\to\input.mp3'"
+$script = "Set-Location -LiteralPath '<Skill目录>\scripts'; .\.venv\Scripts\python.exe .\transcribe_media.py '<本地音频路径>'"
 $encoded = [Convert]::ToBase64String([Text.Encoding]::Unicode.GetBytes($script))
 powershell -NoProfile -ExecutionPolicy Bypass -EncodedCommand $encoded
 ```
@@ -130,7 +132,7 @@ powershell -NoProfile -ExecutionPolicy Bypass -EncodedCommand $encoded
 如果尚未创建虚拟环境，把 `$script` 改成：
 
 ```powershell
-Set-Location -LiteralPath '<Skill目录>\scripts'; if (-not (Test-Path -LiteralPath '.\.venv\Scripts\python.exe')) { py -3.10 -m venv .venv }; .\.venv\Scripts\python.exe -m pip install -r requirements-transcribe.txt; .\.venv\Scripts\python.exe .\transcribe_media.py 'C:\path\to\input.mp3'
+Set-Location -LiteralPath '<Skill目录>\scripts'; if (-not (Test-Path -LiteralPath '.\.venv\Scripts\python.exe')) { py -3.10 -m venv .venv }; .\.venv\Scripts\python.exe -m pip install -r requirements-transcribe.txt; .\.venv\Scripts\python.exe .\transcribe_media.py '<本地音频路径>'
 ```
 
 常用参数：

package/skills/yuanflow-skill//347/224/237/345/233/276/346/212/200/350/203/275/SKILL.md

@@ -63,7 +63,7 @@ emoji: 🎨
   "mode": "edit",
   "model": "gpt-image-2-c",
   "prompt": "把杯子改成红色，保持背景不变",
-  "image_path": "D:\\path\\to\\source.png"
+  "image_path": "<本地参考图片路径>"
 }
 ```
 
@@ -135,7 +135,7 @@ curl https://open.yuanchuangai.com/v1/images/edits \
   -H "Authorization: Bearer $YUAN_API_KEY" \
   -F "model=gpt-image-2-c" \
   -F "prompt=把杯子改成红色，保持背景不变" \
-  -F "image=@D:/path/to/source.png"
+  -F "image=@<本地参考图片路径>"
 ```
 
 ## 输出要求

package/skills/yuanflow-skill//347/233/264/346/222/255/346/212/225/346/265/201/347/255/226/347/225/245/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//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`，不要只告诉用户内部路径。