yuanflow-cli 0.1.43 → 0.1.45

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/src/agent-protocol.js

@@ -8,6 +8,7 @@ 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 = [
   {
@@ -113,6 +114,7 @@ export function buildCommandRegistry() {
   const videoCommands = listVideoCommands();
   const trendingCommands = listTrendingCommands();
   const aiCommands = listAiCommands();
+  const voiceCommands = listVoiceCommands();
   return [
     ...shortcuts,
     ...endpoints,
@@ -125,6 +127,7 @@ export function buildCommandRegistry() {
     ...videoCommands,
     ...trendingCommands,
     ...aiCommands,
+    ...voiceCommands,
   ].sort((left, right) => left.key.localeCompare(right.key));
 }
 

package/src/cli.js

@@ -29,6 +29,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);
@@ -104,6 +105,11 @@ export async function main(argv) {
     return;
   }
 
+  if (command === 'voice') {
+    await handleVoice(rest);
+    return;
+  }
+
   if (command === 'schema') {
     await handleSchema(rest);
     return;
@@ -451,6 +457,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(', ')}`);
@@ -633,6 +653,10 @@ function printHelp() {
   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