yuanflow-cli 0.1.43 → 0.1.45

package/README.md

@@ -5,6 +5,8 @@ YuanFlow 的 npm 包，包含两个命令入口：
 - `yuanflow-cli`：社媒 API 转 CLI，覆盖完整 registry、快捷命令、schema、dry-run 和 agent-json 输出。
 - `yuanflow-skill`：把 `YuanFlow-skill` 注入到本机支持的 AI Agent skills 目录。
 - `飞书官方技能`：YuanFlow-main 内置环境通过受控工具托管安装并调用飞书官方 `@larksuite/cli`，npm 包只提供 Skill 说明，不复制官方 CLI 源码。
+- `视觉卡片生成`：作为 Skill、HTML 模板、参考文档和检查脚本随包分发，不新增独立 `yuanflow-cli visual-card` 命令。
+- `声音克隆 / 声音复刻`：通过 `yuanflow-cli voice` 命令创建、查询、激活 `voice_xxx`，并把文本复刻生成音频文件。
 
 ## 安装
 
@@ -19,6 +21,7 @@ npm install -g yuanflow-cli
 ```bash
 yuanflow-cli --help
 yuanflow-skill list-agents
+yuanflow-skill list-skills
 ```
 
 ## API CLI
@@ -51,6 +54,10 @@ yuanflow-cli video plan --project "D:\素材\yuanflow-video-edit" --timeline-pla
 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
+yuanflow-cli voice clone --file-transfer "D:\voice\sample.wav" --name "我的声音" --activate --format agent-json
+yuanflow-cli voice list --format agent-json
+yuanflow-cli voice activate --voice voice_xxx --format agent-json
+yuanflow-cli voice replicate --text "你好，这是声音复刻测试。" --voice voice_xxx --output "D:\voice\replicate.mp3" --format agent-json
 yuanflow-cli ai doubao-tts voices --format agent-json
 yuanflow-cli ai doubao-tts voice --voice zh_female_xiaohe_uranus_bigtts --format agent-json
 yuanflow-cli ai doubao-tts voice-download --voice zh_female_xiaohe_uranus_bigtts --output "D:\voice\preview.mp3" --format agent-json
@@ -67,6 +74,33 @@ YUANCHUANG_API_TOKEN=<你的令牌>
 
 token 优先级：`--token` > `YUANCHUANG_API_TOKEN` > 本地 `config.token`。独立 CLI 用户可以使用环境变量或 `config set-token`；在 YuanFlow-main 内置环境使用时，token 由 YuanFlow-main 内置环境注入，不需要手动配置。本地图片/视频上传统一使用 YuanFlow 文件中转，不需要用户配置第三方平台 Key。
 
+### 声音克隆与声音复刻
+
+`voice` 命令组用于创建声音克隆、查询已有克隆音色 ID、激活默认音色，并使用 `voice_xxx` 把文本复刻为音频文件。声音复刻前必须先有 `voice_xxx`，或已激活默认音色。
+
+```bash
+# 创建声音克隆：本地音频先走 YuanFlow 文件中转
+yuanflow-cli voice clone --file-transfer "D:\voice\sample.wav" --name "我的声音" --activate --format agent-json
+
+# 查询已有声音克隆 ID
+yuanflow-cli voice list --format agent-json
+
+# 激活某个克隆音色为默认音色
+yuanflow-cli voice activate --voice voice_xxx --format agent-json
+
+# 使用克隆音色生成复刻音频
+yuanflow-cli voice replicate --text "你好，这是声音复刻测试。" --voice voice_xxx --output "D:\voice\replicate.mp3" --format agent-json
+```
+
+命令清单：
+
+- `voice clone`：`POST /v1/audio/voices`，创建声音克隆，常用参数 `--file`、`--file-transfer`、`--audio-url`、`--name`、`--activate`。
+- `voice list`：`GET /v1/audio/voices`，查询当前用户已有声音克隆音色 ID。
+- `voice activate`：`POST /v1/audio/voices/{voice_xxx}/activate`，把已有声音克隆设为默认音色。
+- `voice replicate`：`POST /v1/audio/speech`，使用 `voice_xxx` 或 `default` 生成复刻音频，真实调用时必须传 `--output`。
+
+`--file-transfer` 会先通过 YuanFlow 文件中转上传本地音频，再把临时访问链接提交给 YuanFlow API。`--file` 保留为直接提交本地音频的兼容方式。`--file`、`--file-transfer` 和 `--audio-url` 只能选择一个。
+
 ### AI 模型命令
 
 `ai` 命令用于调用 YuanFlow API 的 OpenAI 兼容端点。CLI 对外只使用 YuanFlow API 模型参数，不暴露底层供应商内部模型名。
@@ -77,8 +111,6 @@ yuanflow-cli ai qwen3-vl-plus --prompt "描述这张图" --image-url "https://ex
 yuanflow-cli ai qwen3-vl-plus --prompt "总结这个视频画面" --video-url "https://example.com/video.mp4" --format agent-json
 yuanflow-cli ai qwen3-vl-plus --prompt "描述本地图片" --image-file "D:\素材\cover.png" --format agent-json
 yuanflow-cli ai qwen3-vl-plus --prompt "描述本地视频" --video-file "D:\素材\demo.mp4" --format agent-json
-yuanflow-cli ai qwen-voice-enrollment --file "D:\voice\sample.wav" --name demo --activate --format agent-json
-yuanflow-cli ai qwen3-tts-vc-realtime-2026-01-15 --text "你好" --voice voice_xxx --output "D:\voice\qwen.mp3" --format agent-json
 yuanflow-cli ai fun-asr --audio-url "https://example.com/audio.wav" --response-format verbose_json --format agent-json
 yuanflow-cli ai doubao-tts voices --format agent-json
 yuanflow-cli ai doubao-tts voice --voice zh_female_xiaohe_uranus_bigtts --format agent-json
@@ -120,8 +152,6 @@ yuanflow-cli ai qwen3-vl-plus --prompt "描述本地视频" --video-file "D:\素
 命令清单：
 
 - `ai qwen3-vl-plus`：`POST /v1/chat/completions`，文本/图片/视频理解，常用参数 `--prompt`、`--image-url`、`--video-url`、`--image-file`、`--video-file`。
-- `ai qwen-voice-enrollment`：`POST /v1/audio/voices`，音色复刻，常用参数 `--file` 或 `--audio-url`、`--name`、`--activate`。
-- `ai qwen3-tts-vc-realtime-2026-01-15`：`POST /v1/audio/speech`，复刻音色合成，`--voice` 使用 `voice_xxx` 或 `default`。
 - `ai fun-asr`：`POST /v1/audio/transcriptions`，语音识别，`--audio-url` 适合远程音频，`--file` 适合本地音频直传。
 - `ai doubao-tts`：`POST /v1/audio/speech`，豆包语音合成，`--voice` 直接传豆包官方音色 ID。
 - `ai doubao-tts voices`：`GET /api/voice-assets/doubao/voices`，查询 doubao-tts 可用音色列表。

package/package.json

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

package/skills/yuanflow-skill/README.md

@@ -11,6 +11,7 @@ YuanFlow Skill 是 `yuanflow-cli` 的 Agent Skill 仓库，用于把社媒平台
 - `视频拆解/`：自媒体创作场景的对标视频拆解 Skill，先查自媒体知识库对标拆解规则，再用 `qwen3-vl-plus` 上传视频并按规则拆解。
 - `YuanFlow文件中转工具/`：YuanFlow 文件中转、签名链接、对象复制 Skill，内部兼容命令走 `yuanflow-cli oss`。
 - `生图技能/`：图片生成与编辑 Skill，优先走 YuanFlow-main 内置环境的 `yuanflow_image_request`。
+- `视觉卡片生成/`：小红书图文卡片、公众号封面、文章插图、海报、信息图和商业视觉方案卡生成 Skill，使用 HTML 模板、风格参考和质量检查脚本完成交付。
 - `公众号生成与发布/`：公众号文章创作、主题预览、微信内联 HTML 排版、正文图片上传和草稿箱推送 Skill。
 - `小红书运营/`：小红书选题调研、笔记搜索、账号分析、评论采集、文案创作、发布前检查和互动操作 Skill；不建议浏览器自动发布作品，除非用户明确无视平台识别和限流风险并强制要求。
 - `视频智能剪辑/`：主音频 + B-roll 素材智能剪辑 Skill，先查自媒体知识库的视频剪辑策略，保存 `strategy_snapshot.json`，再通过 ASR/forced alignment 导入 `audio_alignment.json`，按 1 秒 1 帧抽帧并回写视觉理解，由 Agent 生成 `timeline_plan` 和 EDL，交给 `yuanflow-cli video` 校验和渲染。
@@ -39,6 +40,7 @@ YuanFlow Skill 是 `yuanflow-cli` 的 Agent Skill 仓库，用于把社媒平台
 - 对自媒体对标视频、爆款视频、竞品视频做内容结构、开头钩子、脚本节奏、镜头节奏和可复用创作方法拆解；开始前先查自媒体知识库规则，视频 URL 先解析并保存本地。
 - 上传文件到 YuanFlow 文件中转、生成签名链接或复制文件对象。
 - 生成图片、编辑图片，并缓存返回 URL 或 base64 图片。生成图片必填 `prompt`，可选 `size / quality / style / n / response_format`；编辑图片必须通过 multipart 上传本地图片。
+- 生成小红书图文卡片、公众号封面、文章插图、社交媒体配图、海报、信息图和商业视觉方案卡；视觉卡片生成不新增独立 CLI 命令，按 Skill 模板、参考文档和检查脚本完成。
 - 把自媒体分析、数据复盘、文案方案、账号监控、知识梳理和执行计划生成可直接打开的单页 HTML 报告。
 - 生成或改写公众号文章，进入主题选择预览后导出微信公众号编辑器可粘贴 HTML，或推送到公众号草稿箱。
 - 处理小红书单段或全流程任务，例如只写文案、只采集笔记、只分析账号、只采集评论、只做点赞收藏评论回复，或完整执行图文/视频发布流程；每轮开始前必须明确任务边界。写小红书文案前先查自媒体知识库方法论，遇到封面或正文插图生成时先确认 4:3 或 3:4 比例并调用生图技能。
@@ -115,6 +117,11 @@ yuanflow-skill list-skills
 │  └─ SKILL.md
 ├─ 生图技能
 │  └─ SKILL.md
+├─ 视觉卡片生成
+│  ├─ SKILL.md
+│  ├─ assets/
+│  ├─ references/
+│  └─ scripts/
 ├─ 公众号生成与发布
 │  ├─ SKILL.md
 │  ├─ scripts/

package/skills/yuanflow-skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: YuanFlow技能总入口
-description: 当用户需要处理自媒体平台接口工作流、平台数据查询、命令发现、生图、YuanFlow 文件中转、知识库查询、HTML 报告生成，或需要在 YuanFlow 子技能之间选择合适能力时使用。
+description: 当用户需要处理自媒体平台接口工作流、平台数据查询、命令发现、生图、视觉卡片生成、YuanFlow 文件中转、知识库查询、HTML 报告生成，或需要在 YuanFlow 子技能之间选择合适能力时使用。
 ---
 
 # YuanFlow Skill
@@ -23,6 +23,7 @@ description: 当用户需要处理自媒体平台接口工作流、平台数据
 - `视频拆解/`
 - `YuanFlow文件中转工具/`
 - `生图技能/`
+- `视觉卡片生成/`
 - `公众号生成与发布/`
 - `小红书运营/`
 - `热门内容整理/`
@@ -228,7 +229,21 @@ description: 当用户需要处理自媒体平台接口工作流、平台数据
 
 - `生图技能`
 
-### 13. 走 `HTML报告生成`
+### 13. 走 `视觉卡片生成`
+
+遇到下面这些需求，优先进入这个子 Skill：
+
+- 生成小红书图文卡片、公众号封面、文章插图、社交媒体配图、海报、信息图或商业视觉方案卡。
+- 用户提供主题、文章、截图、照片、笔记、提纲或脚本，希望转成可复用、可检查、可商业交付的视觉卡片。
+- 用户要求多风格配图、封面设计、卡片排版、视觉风格探索或 HTML 视觉模板输出。
+
+如果用户只要求生成图片素材或编辑图片，先用 `生图技能`；如果用户要求把完整方案整理成长文报告，改用 `HTML报告生成`。
+
+子 Skill 名称：
+
+- `视觉卡片生成`
+
+### 14. 走 `HTML报告生成`
 
 遇到下面这些需求，优先进入这个子 Skill：
 
@@ -240,7 +255,7 @@ description: 当用户需要处理自媒体平台接口工作流、平台数据
 
 - `HTML报告生成`
 
-### 14. 走 `公众号生成与发布`
+### 15. 走 `公众号生成与发布`
 
 遇到下面这些需求，优先进入这个子 Skill：
 
@@ -252,7 +267,7 @@ description: 当用户需要处理自媒体平台接口工作流、平台数据
 
 - `公众号生成与发布`
 
-### 15. 走 `小红书运营`
+### 16. 走 `小红书运营`
 
 遇到下面这些需求，优先进入这个子 Skill：
 
@@ -266,7 +281,7 @@ description: 当用户需要处理自媒体平台接口工作流、平台数据
 
 - `小红书运营`
 
-### 16. 走 `个人创作库`
+### 17. 走 `个人创作库`
 
 遇到下面这些需求，优先进入这个子 Skill：
 
@@ -280,7 +295,7 @@ description: 当用户需要处理自媒体平台接口工作流、平台数据
 
 - `个人创作库`
 
-### 17. 走 `本地音视频转文字`
+### 18. 走 `本地音视频转文字`
 
 只有当用户明确要求使用本地音视频转文字、本地转写、本地 ASR、离线转写或本地模型把音频/视频转成文字时，才进入这个子 Skill。
 
@@ -290,7 +305,7 @@ description: 当用户需要处理自媒体平台接口工作流、平台数据
 
 - `本地音视频转文字`
 
-### 18. 走 `音视频在线转文字`
+### 19. 走 `音视频在线转文字`
 
 遇到下面这些需求，优先进入这个子 Skill：
 
@@ -304,7 +319,7 @@ description: 当用户需要处理自媒体平台接口工作流、平台数据
 
 - `音视频在线转文字`
 
-### 19. 走 `视觉理解`
+### 20. 走 `视觉理解`
 
 遇到下面这些需求，优先进入这个子 Skill：
 
@@ -318,7 +333,7 @@ description: 当用户需要处理自媒体平台接口工作流、平台数据
 
 - `视觉理解`
 
-### 20. 走 `视频拆解`
+### 21. 走 `视频拆解`
 
 遇到下面这些需求，优先进入这个子 Skill：
 

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

@@ -0,0 +1,146 @@
+---
+name: 声音克隆
+description: 当用户需要创建声音克隆、查询已有声音克隆音色 ID、激活默认克隆音色，或为后续声音复刻准备 voice_xxx 时使用。本 Skill 通过 YuanFlow API 和 yuanflow-cli voice 命令完成。
+emoji: 🎙️
+---
+
+# 声音克隆
+
+本 Skill 用于把参考音频注册成可复用的声音克隆音色，并返回 `voice_xxx` 音色 ID。后续要生成复刻音频时，交给 `声音复刻` Skill。
+
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用时，优先使用 `yuanflow-cli voice ...` 命令。
+
+1. 先确认本机可执行 `yuanflow-cli --help`。
+2. 外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+3. 选择音频输入方式：
+   - 本地音频直接提交：`--file`
+   - 本地音频先走 YuanFlow 文件中转：`--file-transfer`
+   - 已有公网音频链接：`--audio-url`
+4. 创建成功后，保存返回的 `voice_xxx`。这是后续声音复刻必须使用的音色 ID。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
+## 创建声音克隆
+
+推荐本地文件使用 YuanFlow 文件中转：
+
+```powershell
+yuanflow-cli voice clone --file-transfer "D:\voice\sample.wav" --name "我的声音" --activate --format agent-json
+```
+
+如果用户明确希望直接提交本地音频：
+
+```powershell
+yuanflow-cli voice clone --file "D:\voice\sample.wav" --name "我的声音" --activate --format agent-json
+```
+
+如果已经有可访问音频 URL：
+
+```powershell
+yuanflow-cli voice clone --audio-url "https://example.com/sample.wav" --name "我的声音" --activate --format agent-json
+```
+
+返回里重点读取：
+
+```text
+data.response.id
+```
+
+如果响应结构被 Agent JSON 包裹，优先找 `voice_xxx` 格式的 `id` 字段。不要把内部原始音色参数展示给用户。
+
+## 查询已有声音克隆 ID
+
+当用户已经做过声音克隆但忘记 ID，先查询：
+
+```powershell
+yuanflow-cli voice list --format agent-json
+```
+
+输出时只需要整理这些字段：
+
+```text
+声音名称：
+音色 ID：voice_xxx
+状态：
+是否默认：
+创建时间：
+```
+
+如果没有可用音色，提示用户先提供参考音频创建声音克隆。
+
+## 激活默认音色
+
+如果用户希望后续用 `default` 复刻，或指定某个克隆音色为默认：
+
+```powershell
+yuanflow-cli voice activate --voice voice_xxx --format agent-json
+```
+
+## 音频要求
+
+- 优先使用清晰、无背景音乐、无明显混响的人声音频。
+- 建议使用 wav、mp3、m4a、flac 等常见格式。
+- 文件过大、噪音明显或多人混说时，先让用户换音频或裁剪。
+- 不要上传身份证、合同、私密通话、未授权人物声音等敏感内容，除非用户明确确认且任务确实需要。
+
+## YuanFlow-main 内置环境
+
+只有在 YuanFlow-main 内置环境中，才使用受控工具 `yuanflow_cli_call`。token、受管包路径和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
+
+创建声音克隆：
+
+```json
+{
+  "args": [
+    "voice",
+    "clone",
+    "--file-transfer",
+    "D:\\voice\\sample.wav",
+    "--name",
+    "我的声音",
+    "--activate",
+    "--format",
+    "agent-json"
+  ],
+  "timeout": 300
+}
+```
+
+查询已有声音克隆：
+
+```json
+{
+  "args": [
+    "voice",
+    "list",
+    "--format",
+    "agent-json"
+  ],
+  "timeout": 120
+}
+```
+
+激活默认音色：
+
+```json
+{
+  "args": [
+    "voice",
+    "activate",
+    "--voice",
+    "voice_xxx",
+    "--format",
+    "agent-json"
+  ],
+  "timeout": 120
+}
+```
+
+## 失败处理
+
+- token 缺失：说明需要配置 YuanFlow API token，或在 YuanFlow-main 受控环境中运行。
+- 没有返回 `voice_xxx`：说明声音克隆未完成，不要继续声音复刻。
+- 已存在克隆限制：先用 `voice list` 查询已有音色，必要时让用户选择已有 `voice_xxx` 继续。
+- 音频不可访问：如果使用 URL，让用户换成可访问链接；如果是本地文件，改用 `--file-transfer`。

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

@@ -0,0 +1,103 @@
+---
+name: 声音复刻
+description: 当用户需要使用已有声音克隆 ID 生成复刻语音、把文字合成为用户克隆声音，或要求根据 voice_xxx 输出音频文件时使用。使用前必须先完成声音克隆或查询到已有 voice_xxx。
+emoji: 🔊
+---
+
+# 声音复刻
+
+本 Skill 用于把文本合成为已有克隆音色的音频。使用前必须满足其中一个条件：
+
+- 已通过 `声音克隆` Skill 创建过声音克隆，并拿到 `voice_xxx`。
+- 已通过 `yuanflow-cli voice list` 查询到可用 `voice_xxx`。
+- 用户明确指定使用已激活默认音色 `default`。
+
+如果没有声音克隆 ID，先调用 `声音克隆`，不要直接复刻。
+
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用时，优先使用 `yuanflow-cli voice replicate`。
+
+1. 先确认本机可执行 `yuanflow-cli --help`。
+2. 外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+3. 确认 `--voice` 是 `voice_xxx` 或 `default`。
+4. 用 `--output` 指定音频保存路径。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API，不要求用户配置第三方平台 Key。
+
+## 查询或确认音色 ID
+
+如果用户没有提供 `voice_xxx`，先查询：
+
+```powershell
+yuanflow-cli voice list --format agent-json
+```
+
+如果列表中没有可用音色，转到 `声音克隆` Skill，先创建声音克隆。
+
+## 生成复刻音频
+
+```powershell
+yuanflow-cli voice replicate --text "你好，这是声音复刻测试。" --voice voice_xxx --output "D:\voice\replicate.mp3" --format agent-json
+```
+
+如果用户要求使用默认音色：
+
+```powershell
+yuanflow-cli voice replicate --text "你好，这是声音复刻测试。" --voice default --output "D:\voice\replicate.mp3" --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
+```
+
+## 输出要求
+
+最终回复给用户时说明：
+
+```text
+复刻音频已生成：
+文件路径：D:\voice\replicate.mp3
+使用音色：voice_xxx
+```
+
+如果命令返回 agent-json，优先读取：
+
+```text
+data.response.output
+data.response.bytes
+data.response.content_type
+```
+
+## YuanFlow-main 内置环境
+
+只有在 YuanFlow-main 内置环境中，才使用受控工具 `yuanflow_cli_call`。token、受管包路径和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
+
+```json
+{
+  "args": [
+    "voice",
+    "replicate",
+    "--text",
+    "你好，这是声音复刻测试。",
+    "--voice",
+    "voice_xxx",
+    "--output",
+    "replicate.mp3",
+    "--format",
+    "agent-json"
+  ],
+  "timeout": 300
+}
+```
+
+在 YuanFlow-main 内置环境里，`--output` 会被限制到受控输出目录。不要要求用户手动传程序数据目录，也不要绕过 `yuanflow_cli_call` 直接写本地文件。
+
+## 失败处理
+
+- 缺少 `voice_xxx`：先调用 `声音克隆` 的查询流程或创建流程。
+- 音色不存在或无权限：提示用户重新查询 `voice list`，不要猜测 ID。
+- 输出路径被拒绝：在 YuanFlow-main 内置环境中改用相对文件名，让受控工具自动放入输出目录。
+- 生成失败：报告 YuanFlow API 返回的简短错误，不暴露 token、Authorization header 或完整敏感链接。

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

@@ -0,0 +1,77 @@
+---
+name: 视觉卡片生成
+description: 当用户需要生成小红书图文卡片、公众号封面、文章插图、社交媒体配图、海报、信息图、视觉方案卡、商业风格设计图或多风格配图时使用。本 Skill 使用 HTML 模板、风格参考和质量检查脚本生成可复用、可检查、可商业交付的视觉卡片。
+emoji: 🖼️
+---
+
+# 视觉卡片生成
+
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用本 Skill 时，优先按本 Skill 的模板和参考文档完成视觉卡片生成；如果任务中需要上传素材、生成图片、理解图片/视频或调用 YuanFlow API，再使用本地 `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 本身不新增独立 `yuanflow-cli visual-card` 命令。它通过 Skill 说明、HTML 模板、参考文档和检查脚本完成视觉卡片生产。
+
+## YuanFlow-main 内置环境
+
+只有在 YuanFlow-main 内置环境中，才使用 `yuanflow_cli_call`、`yuanflow_image_request`、`content_workbench_update`、`artifact_files_register` 等受控工具。token、受管包路径、程序数据目录和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
+
+如果用户需要先生成图片素材，可调用 `生图技能` 或 YuanFlow-main 内置图片能力；如果需要理解用户提供的图片/视频素材，可调用 `视觉理解`；如果需要上传本地素材给在线能力使用，可调用 `YuanFlow文件中转工具`。
+
+## 适用输出
+
+- 小红书图文：3:4 封面和 3-9 张正文卡片。
+- 公众号封面：21:9 主封面、1:1 次封面、3:4 竖版封面。
+- 文章插图：16:9、4:3、3:2 的正文配图。
+- 社交媒体视觉：海报、活动图、概念图、产品卖点图、数据图、流程图。
+- 设计方案卡：风格探索板、品牌视觉方向、信息架构卡片、方案对比图。
+
+## 生成流程
+
+1. 识别任务类型：封面、图文卡片、文章插图、社交配图、海报、信息图、风格探索。
+2. 读取 `references/commercial-system.md`，确认比例、尺寸、页面角色、文字限制、证据需求和质量门禁。
+3. 从 `references/style-atlas.md` 选择一个主风格和一个子风格；用户未指定时，按传播目标选择。
+4. 从 `assets/templates/` 复制最接近的 HTML 模板到任务输出目录，命名为 `index.html`。
+5. 在 `.poster` 节点上设置 `data-style`、`data-ratio`，并按页面目标调整布局模块。
+6. 参考 `references/layout-playbook.md` 和 `references/use-case-recipes.md` 组织页面结构，避免每页都变成重复的标题加卡片。
+7. 如果图片或截图是证据，优先使用用户提供的真实素材；如果需要生成图片，只把生成图作为素材，最终文字仍放在 HTML 中排版。
+8. 参考 `references/quality-check.md` 做最终检查；生成 HTML 后尽量运行检查脚本。
+
+检查命令：
+
+```bash
+python scripts/check_visual_card.py <index.html>
+```
+
+## 风格选择规则
+
+- 一组输出默认只使用一个主风格，除非用户明确要求做多风格探索。
+- 通过风格、色板、布局、材质、图片处理和文案节奏制造变化，不靠随机装饰。
+- 不使用无意义气泡、假数据、假 UI、假截图、占位文字或不可读小字。
+- 小红书封面优先保证缩略图可读：主标题清楚，主体视觉明确，正文不拥挤。
+- 文章插图优先服务文章论点，不做成硬广横幅。
+- 不同封面比例要分别设计，不能把 21:9 直接裁成 1:1 或 3:4。
+
+## 资源说明
+
+- `references/style-atlas.md`：风格体系、子风格、识别测试、反模式、HTML 骨架。
+- `references/commercial-system.md`：商业交付骨架、生产标准、复用矩阵。
+- `references/use-case-recipes.md`：封面、文章插图、社交配图、海报和风格探索配方。
+- `references/layout-playbook.md`：按输出类型和内容模式选择布局。
+- `references/quality-check.md`：最终质量检查清单。
+- `assets/templates/`：可复制使用的 HTML 母版。
+- `overview.html`：成熟风格系统和矩阵总览。
+- `scripts/check_visual_card.py`：HTML 静态检查脚本，只依赖 Python 标准库。
+
+## 交付要求
+
+- 给出输出目录路径。
+- 如用户要求渲染图片，给出渲染后的图片文件路径。
+- 简短说明使用的风格、比例和页面数量。
+- 如果使用了网页图片或外部素材，在任务目录中记录来源链接，并在回复中说明。

package/skills/yuanflow-skill//350/247/206/350/247/211/345/215/241/347/211/207/347/224/237/346/210/220/agents/openai.yaml

@@ -0,0 +1,8 @@
+interface:
+  display_name: "视觉卡片生成"
+  short_description: "生成小红书图文、封面、文章插图、海报和商业视觉卡片。"
+  brand_color: "#C8372D"
+  default_prompt: "使用 $视觉卡片生成 将主题、文章、截图、照片、笔记、提纲或脚本转成小红书图文卡片、公众号封面、文章插图、海报或商业视觉设计图。"
+
+policy:
+  allow_implicit_invocation: true

package/skills/yuanflow-skill//350/247/206/350/247/211/345/215/241/347/211/207/347/224/237/346/210/220/assets/templates/editorial-publishing.html

@@ -0,0 +1,65 @@
+<!doctype html>
+<html lang="zh-CN" data-parent-style="editorial-publishing">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width,initial-scale=1">
+  <title>Editorial Publishing Template</title>
+  <style>
+    :root {
+      --paper: #f3f0e8;
+      --ink: #12100d;
+      --muted: #716a60;
+      --line: rgba(18,16,13,.22);
+      --accent: #9b2f24;
+      --serif: "Songti SC", "STSong", "SimSun", serif;
+      --sans: system-ui, sans-serif;
+      --mono: ui-monospace, monospace;
+    }
+    * { box-sizing: border-box; }
+    body { margin: 0; padding: 48px; background: #1c1a17; font-family: var(--sans); }
+    .sheet { display: flex; flex-direction: column; align-items: center; gap: 42px; }
+    .poster { position: relative; overflow: hidden; background: var(--paper); color: var(--ink); isolation: isolate; }
+    .poster[data-ratio="xhs"] { width: 1080px; height: 1440px; }
+    .poster[data-ratio="article"] { width: 1600px; height: 900px; }
+    .poster[data-ratio="wide"] { width: 2100px; height: 900px; }
+    .paper-grain { position: absolute; inset: 0; opacity: .26; mix-blend-mode: multiply; background-image: radial-gradient(rgba(0,0,0,.06) 1px, transparent 1.5px); background-size: 4px 4px; }
+    .ep-pad { position: relative; z-index: 2; height: 100%; padding: 88px; display: flex; flex-direction: column; }
+    [data-ratio="article"] .ep-pad, [data-ratio="wide"] .ep-pad { padding: 76px 110px; }
+    .ep-issue, .ep-strip, .small-label { font-family: var(--mono); letter-spacing: .16em; text-transform: uppercase; color: var(--muted); }
+    .ep-issue { font-size: 20px; margin: 0 0 34px; }
+    .ep-title { font-family: var(--serif); font-weight: 500; font-size: 112px; line-height: 1.08; letter-spacing: .04em; margin: 0; max-width: 880px; }
+    .ep-deck { font-family: var(--serif); font-size: 32px; line-height: 1.55; color: var(--muted); max-width: 640px; }
+    .ep-photo { margin: 44px 0 0; height: 460px; background: #d9d0c2; overflow: hidden; border: 1px solid var(--line); }
+    .ep-photo.small { width: 52%; height: 360px; margin-left: auto; }
+    .ep-photo img, .object-frame img { width: 100%; height: 100%; object-fit: cover; display: block; }
+    .ep-strip { margin-top: auto; padding-top: 18px; border-top: 1px solid var(--line); display: flex; justify-content: space-between; font-size: 18px; }
+    .book-page { border: 18px solid rgba(155,47,36,.18); }
+    .vertical { writing-mode: vertical-rl; letter-spacing: .18em; }
+    .seal { width: 64px; height: 64px; border: 2px solid var(--accent); color: var(--accent); display: grid; place-items: center; font-family: var(--serif); margin-top: 28px; }
+    .newspaper { display: grid; grid-template-rows: auto auto 1fr; }
+    .masthead { font-family: var(--serif); font-size: 34px; letter-spacing: .18em; border-bottom: 4px double var(--ink); padding-bottom: 16px; margin: 0 0 32px; }
+    .news-grid { display: grid; grid-template-columns: 1fr 1fr .7fr; gap: 26px; margin-top: 40px; }
+    .news-grid article { border-top: 1px solid var(--line); padding-top: 18px; font-family: var(--serif); font-size: 26px; line-height: 1.55; }
+    .mini-chart { display: flex; gap: 18px; align-items: end; border: 1px solid var(--line); padding: 26px; }
+    .mini-chart span { flex: 1; height: var(--h); background: var(--accent); }
+    .gallery { display: grid; grid-template-columns: 1.2fr .8fr; gap: 54px; align-items: end; }
+    .object-frame { margin: 0; height: 620px; background: #dedbd2; }
+    .plaque { border-top: 1px solid var(--line); padding-top: 24px; }
+    .plaque h2 { font-family: var(--serif); font-size: 54px; margin: 0 0 18px; }
+    .plaque p { font-family: var(--serif); color: var(--muted); font-size: 26px; line-height: 1.55; }
+  </style>
+</head>
+<body>
+  <main class="sheet">
+    <section class="poster magazine-paper" data-ratio="xhs" data-style="magazine-paper">
+      <div class="paper-grain"></div>
+      <main class="ep-pad">
+        <p class="ep-issue">VOL. 04 / FIELD NOTE / 2026</p>
+        <h1 class="ep-title">在信息里<br>找到一条路</h1>
+        <figure class="ep-photo"><img src="assets/hero.jpg" alt=""></figure>
+        <div class="ep-strip"><span>观察</span><span>方法</span><span>结论</span></div>
+      </main>
+    </section>
+  </main>
+</body>
+</html>