yuanflow-cli 0.1.42 → 0.1.44

package/skills/yuanflow-skill//350/247/206/350/247/211/345/215/241/347/211/207/347/224/237/346/210/220/references/use-case-recipes.md

@@ -0,0 +1,116 @@
+# Use Case Recipes
+
+## 1. Xiaohongshu Cover
+
+Fixed:
+
+- Ratio: `1080x1440`.
+- Must read at 360px wide.
+- Title should be short, usually 8-18 Chinese characters.
+- One strong visual signal: face/object/screenshot/title block/large number.
+
+Recommended style families:
+
+- Pop Magazine for trend and consumer hooks.
+- Chinese Editorial for travel, culture, food, reading, personal essays.
+- Product Cutout for recommendations and product posts.
+- Neo-Brutalist for warnings and opinion hooks.
+
+Modules:
+
+- `hero-title`, `image-led`, `object-callout`, `split-compare`, `data-chart`.
+
+## 2. Xiaohongshu Carousel
+
+Fixed:
+
+- 5-9 pages unless the source is very short.
+- Page 1 cover, page 2 context, middle pages evidence/method/detail, final page summary.
+- Use repeated metadata, but vary the layout module.
+
+Recommended module sequence:
+
+`hero-title` -> `evidence-feature` -> `ledger-list` -> `diagram-flow` -> `matrix-grid` -> `split-compare` -> `quote-page`.
+
+## 3. Article Illustration
+
+Fixed:
+
+- Ratio: `1600x900`, `1440x1080`, or `1500x1000`.
+- One concept only; title optional.
+- Avoid social-media hook language unless the article needs it.
+
+Recommended style families:
+
+- Calm Diagram for frameworks.
+- Blueprint Technical for architecture and systems.
+- Museum Label for objects and design analysis.
+- Editorial Paper for essays.
+- Data Newspaper for research/report summaries.
+
+## 4. WeChat Cover Pair
+
+Fixed:
+
+- Main cover: `2100x900`.
+- Square cover: `1080x1080`.
+- Compose separately. Do not crop the wide cover into square.
+- Square cover should usually use a shorter title and fewer elements.
+
+Recommended style families:
+
+- Editorial Paper, Luxury Minimal, Chinese Editorial, Event Key Visual.
+
+## 5. Design Graphic / Design Draft
+
+Fixed:
+
+- Decide function first: explain, persuade, summarize, decorate, or compare.
+- Use annotations and labels only when they clarify the design.
+- Keep source/editability: HTML and CSS must stay understandable.
+
+Recommended style families:
+
+- Swiss Data for structured product diagrams.
+- Blueprint Technical for architecture.
+- Product Cutout for feature graphics.
+- Calm Diagram for frameworks.
+- Maximal Poster for campaign direction.
+
+## 6. Product Recommendation / Product Feature Image
+
+Fixed:
+
+- Product/screenshot must be large enough to inspect.
+- Benefits must be true to source.
+- Use 2-4 callouts, not a paragraph cloud.
+
+Recommended style families:
+
+- Product Cutout, Museum Label, Luxury Minimal, Swiss Data.
+
+## 7. Event / Course / Launch Poster
+
+Fixed:
+
+- Title, date/time, host/location, and CTA have separate hierarchy.
+- Key visual should dominate; logistics should not become the headline.
+
+Recommended style families:
+
+- Event Key Visual, Maximal Poster, Neo-Brutalist, Luxury Minimal.
+
+## 8. Style Exploration
+
+Fixed:
+
+- Same source topic across variants.
+- Keep the ratio and core copy stable enough for comparison.
+- Generate 3-6 variants, each changing at least style family + layout + image treatment.
+
+Good variant sets:
+
+- Professional: Swiss Data / Editorial Paper / Luxury Minimal.
+- Social growth: Pop Magazine / Product Cutout / Neo-Brutalist.
+- Article and report: Data Newspaper / Calm Diagram / Museum Label.
+- Lifestyle: Chinese Editorial / Soft Studio / Film Contact Sheet.

package/skills/yuanflow-skill//350/247/206/350/247/211/345/215/241/347/211/207/347/224/237/346/210/220/scripts/check_visual_card.py

@@ -0,0 +1,92 @@
+#!/usr/bin/env python3
+"""Lightweight static checks for YuanFlow visual-card HTML."""
+
+from __future__ import annotations
+
+import re
+import sys
+from pathlib import Path
+
+KNOWN_STYLES = {
+    "magazine-paper",
+    "editorial-paper",
+    "chinese-literary",
+    "swiss-data",
+    "pop-magazine",
+    "neo-brutalist",
+    "chinese-editorial",
+    "luxury-minimal",
+    "blueprint-technical",
+    "soft-studio",
+    "collage-desk",
+    "cyber-interface",
+    "botanical-organic",
+    "playful-toy",
+    "film-contact-sheet",
+    "museum-label",
+    "maximal-poster",
+    "calm-diagram",
+    "data-newspaper",
+    "handwritten-lab",
+    "event-key-visual",
+    "product-cutout",
+    "brand-system",
+    "app-feature",
+}
+
+KNOWN_RATIOS = {"xhs", "square", "wide", "article", "poster"}
+
+
+def main() -> int:
+    if len(sys.argv) != 2:
+        print("Usage: python check_visual_card.py <index.html>")
+        return 2
+
+    html_path = Path(sys.argv[1])
+    if not html_path.exists():
+        print(f"FAIL: file not found: {html_path}")
+        return 1
+
+    text = html_path.read_text(encoding="utf-8")
+    failures: list[str] = []
+    warnings: list[str] = []
+
+    if '<meta charset="utf-8">' not in text.lower():
+        failures.append("missing utf-8 charset meta")
+    if re.search(r"\b(TODO|Lorem ipsum|标题占位|替换标题)\b", text, re.I):
+        failures.append("placeholder text remains")
+    if ".poster" not in text:
+        failures.append("missing .poster class")
+    poster_count = len(re.findall(r'class="[^"]*\bposter\b[^"]*"', text))
+    style_values = re.findall(r'data-style="([^"]+)"', text)
+    ratio_values = re.findall(r'data-ratio="([^"]+)"', text)
+    if poster_count and len(style_values) < poster_count:
+        failures.append("some .poster nodes are missing data-style")
+    if poster_count and len(ratio_values) < poster_count:
+        failures.append("some .poster nodes are missing data-ratio")
+    unknown_styles = sorted(set(style_values) - KNOWN_STYLES)
+    unknown_ratios = sorted(set(ratio_values) - KNOWN_RATIOS)
+    if unknown_styles:
+        warnings.append("unknown data-style values: " + ", ".join(unknown_styles))
+    if unknown_ratios:
+        warnings.append("unknown data-ratio values: " + ", ".join(unknown_ratios))
+    if not re.search(r"width:\s*\d+px", text) or not re.search(r"height:\s*\d+px", text):
+        warnings.append("no fixed pixel poster width/height detected")
+    if "data-style=" not in text:
+        warnings.append("no data-style style family marker detected")
+    if "data-ratio=" not in text:
+        warnings.append("no data-ratio marker detected")
+
+    for item in failures:
+        print(f"FAIL: {item}")
+    for item in warnings:
+        print(f"WARN: {item}")
+
+    if failures:
+        return 1
+    print("PASS: visual-card HTML basic checks passed")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

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

@@ -10,13 +10,14 @@ emoji: 👁️
 
 不要把它写成自媒体拆解、爆款分析或创作策略技能；这些需求交给 `视频拆解`。
 
-## 环境判断
+## 外部 CLI 主流程
 
-1. 在 YuanFlow-main 内置环境，优先调用受控工具 `yuanflow_cli_call`。
-2. 外部 Agent 且本机有 CLI 时，直接执行 `yuanflow-cli`。
-3. 外部 Agent 没有 CLI 时，再提示用户安装 `npm install -g yuanflow-cli`。
+外部 Agent 或用户直接使用时，优先用 `yuanflow-cli ai qwen3-vl-plus`。
 
-不要让用户手动提供 YuanFlow token。YuanFlow-main 内置环境会注入认证 token；外部 CLI 使用 `YUANCHUANG_API_TOKEN`。
+1. 先确认本机可执行 `yuanflow-cli --help`。
+2. 外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+3. 根据输入选择 `--image-url`、`--video-url`、`--image-file` 或 `--video-file`。
+4. 本地图片/视频会先经过 YuanFlow 文件中转，再提交给 YuanFlow API。
 
 本地图片/视频上传依赖 CLI 的 YuanFlow 文件中转能力。外部 Agent 只需要配置 YuanFlow API token；不要要求用户提供第三方平台 Key，也不要在回复里展示完整 token。
 
@@ -33,7 +34,7 @@ emoji: 👁️
 
 - 视频 URL 需要能被 YuanFlow API 访问，响应头建议包含 `Content-Length` 和 `Content-Type`。
 - 视觉模型侧建议单个视频最大 2GB，时长 2 秒到 1 小时。
-- 本地文件会先通过 YuanFlow 文件中转 `POST /atomic/oss/temp-upload` 上传，CLI 取返回的 `signed_url` 后再调用 `/v1/chat/completions`。
+- 本地文件会先通过 YuanFlow 文件中转上传，CLI 取返回的临时访问链接后再提交给 YuanFlow API。
 - 本地文件过大时，让用户压缩、裁剪、换文件，或改用可公网访问的视频 URL。
 - 不要上传密钥、cookie、身份证、合同、私密聊天记录等敏感文件，除非用户明确确认且任务确实需要。
 
@@ -46,6 +47,20 @@ emoji: 👁️
 5. 调用 qwen3-vl-plus。
 6. 整理输出：先给结论，再给画面证据，再给不确定项。
 
+## 外部 CLI 示例
+
+```powershell
+yuanflow-cli ai qwen3-vl-plus --prompt "描述这张图的主体、文字和环境" --image-file "D:\素材\cover.png" --format agent-json
+```
+
+```powershell
+yuanflow-cli ai qwen3-vl-plus --prompt "总结视频画面变化和关键细节" --video-file "D:\素材\demo.mp4" --format agent-json
+```
+
+## YuanFlow-main 内置环境
+
+在 YuanFlow-main 内置环境，优先调用受控工具 `yuanflow_cli_call`。token、受管包路径和输出目录由 YuanFlow-main 管理，不要要求用户手动提供 YuanFlow token。
+
 ## YuanFlow-main 内置工具调用示例
 
 图片 URL：
@@ -120,16 +135,6 @@ emoji: 👁️
 }
 ```
 
-## 外部 CLI 示例
-
-```powershell
-yuanflow-cli ai qwen3-vl-plus --prompt "描述这张图的主体、文字和环境" --image-file "D:\素材\cover.png" --format agent-json
-```
-
-```powershell
-yuanflow-cli ai qwen3-vl-plus --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

@@ -6,6 +6,16 @@ emoji: 📈
 
 # 视频投流策略
 
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用本 Skill 时，先按当前 Skill 说明完成任务；需要查询知识库、生成报告、文件中转或调用平台数据时，使用本地 `yuanflow-cli` 命令。
+
+1. 如果本地可执行 `yuanflow-cli --help`，直接使用本地 CLI。
+2. 如果本地没有 `yuanflow-cli`，再提示用户安装 `npm install -g yuanflow-cli`。
+3. 外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
 本 Skill 用于制定视频内容投流策略。执行时必须先确认投流对象账号，再采集该账号最近视频数据，之后再查历史资产和自媒体知识库，最后结合账号视频表现输出可执行投放方案。
 
 ## 固定流程

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

@@ -16,13 +16,14 @@ emoji: 🎬
 4. 把知识库拆解规则写进 prompt，让模型按规则拆解视频。
 5. 整理成适合自媒体创作复用的详细拆解报告。
 
-## 环境判断
+## 外部 CLI 主流程
 
-1. 在 YuanFlow-main 内置环境，优先调用受控工具 `yuanflow_cli_call`。
-2. 外部 Agent 且本机有 CLI 时，直接执行 `yuanflow-cli`。
-3. 外部 Agent 没有 CLI 时，再提示用户安装 `npm install -g yuanflow-cli`。
+外部 Agent 或用户直接使用时，先用 `yuanflow-cli knowledge ...` 查询拆解规则，再用 `yuanflow-cli ai qwen3-vl-plus` 处理视频。
 
-不要让用户手动提供 YuanFlow token。YuanFlow-main 内置环境会注入认证 token；外部 CLI 使用 `YUANCHUANG_API_TOKEN`。
+1. 先确认本机可执行 `yuanflow-cli --help`。
+2. 外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+3. 本地视频会先经过 YuanFlow 文件中转，再提交给 YuanFlow API。
+4. 如果是平台视频 URL，先解析并在用户授权后保存到本地文件。
 
 本地视频上传依赖 qwen3-vl-plus 的 YuanFlow 文件中转能力。外部 Agent 只需要配置 YuanFlow API token；不要要求用户提供第三方平台 Key。
 
@@ -54,28 +55,14 @@ emoji: 🎬
 
 必须先调用知识库，不要直接上传视频拆解。
 
-YuanFlow-main 内置工具示例：
+外部 CLI 示例：
 
-```json
-{
-  "args": [
-    "knowledge",
-    "entry",
-    "--output-format",
-    "video_breakdown",
-    "--domain",
-    "自媒体运营",
-    "--content-goal",
-    "对标视频拆解，提炼内容结构、脚本节奏、镜头设计和可复用创作方法",
-    "--target-audience",
-    "自媒体创作者",
-    "--format",
-    "agent-json"
-  ],
-  "timeout": 180
-}
+```powershell
+yuanflow-cli knowledge entry --output-format video_breakdown --domain 自媒体运营 --content-goal "对标视频拆解，提炼内容结构、脚本节奏、镜头设计和可复用创作方法" --target-audience 自媒体创作者 --format agent-json
 ```
 
+YuanFlow-main 内置环境调用见后文专属小节。
+
 如果返回 `next_actions`，继续按推荐调用 `packs`、`rules` 或 `rule-detail`。优先查询与以下方向相关的规则：
 
 - 对标拆解
@@ -87,12 +74,6 @@ YuanFlow-main 内置工具示例：
 - 账号定位
 - 带货/转化结构
 
-外部 CLI 示例：
-
-```powershell
-yuanflow-cli knowledge entry --output-format video_breakdown --domain 自媒体运营 --content-goal "对标视频拆解，提炼内容结构、脚本节奏、镜头设计和可复用创作方法" --target-audience 自媒体创作者 --format agent-json
-```
-
 ### 3. 视频 URL 先解析并保存本地
 
 如果用户提交的是平台视频 URL，先用 `作品下载综合工具` 或 `yuanflow-cli works download` 解析可播放/下载地址候选。
@@ -104,32 +85,14 @@ yuanflow-cli knowledge entry --output-format video_breakdown --domain 自媒体
 - `youtube.com`、`youtu.be`：`--platform youtube`。
 - `ixigua.com`：`--platform xigua`。
 
-YuanFlow-main 内置工具示例：
-
-```json
-{
-  "args": [
-    "works",
-    "download",
-    "--platform",
-    "douyin",
-    "--target",
-    "https://v.douyin.com/xxx/",
-    "--region",
-    "CN",
-    "--format",
-    "agent-json"
-  ],
-  "timeout": 180
-}
-```
-
 外部 CLI 示例：
 
 ```powershell
 yuanflow-cli works download --platform douyin --target "https://v.douyin.com/xxx/" --region CN --format agent-json
 ```
 
+YuanFlow-main 内置环境调用见后文专属小节。
+
 解析到可访问视频 URL 后，经用户授权保存到本地临时文件，再提交 qwen3-vl-plus。保存文件时使用清晰路径，例如：
 
 ```text
@@ -162,6 +125,16 @@ ffmpeg -y -i "<解析得到的 m3u8 地址>" -c copy "D:\素材\yuanflow-video-b
 
 把知识库查询到的规则摘要压缩进 prompt。不要只让模型“分析视频”，必须告诉它按规则拆解。
 
+外部 CLI 示例：
+
+```powershell
+yuanflow-cli ai qwen3-vl-plus --prompt "你是自媒体视频拆解助手。请按知识库规则拆解这个视频：..." --video-file "D:\素材\yuanflow-video-breakdown\input.mp4" --format agent-json
+```
+
+## YuanFlow-main 内置环境
+
+在 YuanFlow-main 内置环境，优先调用受控工具 `yuanflow_cli_call`。token、受管包路径和输出目录由 YuanFlow-main 管理，不要要求用户手动提供 YuanFlow token。
+
 YuanFlow-main 内置工具示例：
 
 ```json
@@ -180,16 +153,10 @@ YuanFlow-main 内置工具示例：
 }
 ```
 
-外部 CLI 示例：
-
-```powershell
-yuanflow-cli ai qwen3-vl-plus --prompt "你是自媒体视频拆解助手。请按知识库规则拆解这个视频：..." --video-file "D:\素材\yuanflow-video-breakdown\input.mp4" --format agent-json
-```
-
 ## 调用限制和注意事项
 
 - qwen3-vl-plus 视频建议单个视频最大 2GB，时长 2 秒到 1 小时。
-- 本地视频上传时，CLI 会先调用 YuanFlow 文件中转 `POST /atomic/oss/temp-upload`，再把返回的 `signed_url` 提交给 YuanFlow API。
+- 本地视频上传时，CLI 会先调用 YuanFlow 文件中转，再把返回的临时访问链接提交给 YuanFlow API。
 - 本地文件过大时，让用户压缩、裁剪、提供短版本，或改用可公网访问的视频 URL。
 - 对标视频拆解只能用于学习结构、表达和创作方法，不要鼓励搬运、洗稿、规避版权或冒充原创。
 

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

@@ -15,6 +15,16 @@ tags:
 ---
 
 # 视频智能剪辑技能
+
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用时，优先使用本 Skill 文档中的 `yuanflow-cli ...` 命令示例；如果本地没有 CLI，再提示安装 `npm install -g yuanflow-cli`。外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
+## YuanFlow-main 内置环境
+
+只有在 YuanFlow-main 内置环境中，才使用 `yuanflow_cli_call`、`yuanflow_image_request`、`content_workbench_update`、`artifact_files_register` 等受控工具。token、受管包路径、程序数据目录和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
 
 当用户要求自动剪辑、智能剪辑、用口播音频匹配画面、把 B-roll 素材配成视频、重排视频画面、生成预览剪辑或导出成片时，使用本 Skill。
 

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

@@ -6,6 +6,16 @@ emoji: 💡
 
 # 选题策划
 
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用本 Skill 时，先按当前 Skill 说明完成任务；需要查询知识库、生成报告、文件中转或调用平台数据时，使用本地 `yuanflow-cli` 命令。
+
+1. 如果本地可执行 `yuanflow-cli --help`，直接使用本地 CLI。
+2. 如果本地没有 `yuanflow-cli`，再提示用户安装 `npm install -g yuanflow-cli`。
+3. 外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
 本 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

@@ -5,6 +5,16 @@ emoji: ☁️
 ---
 
 # 音视频在线转文字
+
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用时，优先使用本 Skill 文档中的 `yuanflow-cli ...` 命令示例；如果本地没有 CLI，再提示安装 `npm install -g yuanflow-cli`。外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
+## YuanFlow-main 内置环境
+
+只有在 YuanFlow-main 内置环境中，才使用 `yuanflow_cli_call`、`yuanflow_image_request`、`content_workbench_update`、`artifact_files_register` 等受控工具。token、受管包路径、程序数据目录和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
 
 本 Skill 使用 YuanFlow 网关的在线 ASR 能力，把音频或视频转成文字。它不下载本地模型；如果用户明确要求离线、本地模型或本地 ASR，改用 `本地音视频转文字`。
 

package/skills/yuanflow-skill//351/243/236/344/271/246/345/256/230/346/226/271/346/212/200/350/203/275/SKILL.md

@@ -5,6 +5,16 @@ emoji: 🪽
 ---
 
 # 飞书官方技能
+
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用时，优先使用本 Skill 文档中的 `yuanflow-cli ...` 命令示例；如果本地没有 CLI，再提示安装 `npm install -g yuanflow-cli`。外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
+## YuanFlow-main 内置环境
+
+只有在 YuanFlow-main 内置环境中，才使用 `yuanflow_cli_call`、`yuanflow_image_request`、`content_workbench_update`、`artifact_files_register` 等受控工具。token、受管包路径、程序数据目录和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
 
 本 Skill 对接飞书官方发布的 `@larksuite/cli` 和官方 Skill 体系。YuanFlow 不复制、不改造官方 CLI 源码，只负责安装、托管、认证状态检查、权限续接和受控调用。