yuanflow-cli 0.1.18 → 0.1.20

package/README.md

@@ -141,6 +141,31 @@ yuanflow-cli oss copy --source-key temp/cover.png --target-key final/cover.png -
 
 上传本地文件前必须确认用户授权，不能上传密钥、cookie、账号凭据或隐私文件。
 
+### 音视频在线转文字
+
+`音视频在线转文字` 随 npm 包安装到 Skill bundle，用于通过 YuanFlow 在线 ASR 接口把音频或视频转成干净文本。视频输入需要先用 ffmpeg 分离音频，再上传 OSS。
+
+固定链路：
+
+1. 判断用户提交的是音频还是视频。
+2. 视频先抽取为音频，音频上传前改成英文文件名。
+3. 使用 `yuanflow-cli oss temp-upload` 上传音频。
+4. ASR 请求必须优先使用 OSS 返回的 `data.signed_url` 作为 `metadata.audio_url`，不要优先使用裸域名 `data.url`。
+5. 调用 `POST https://open.yuanchuangai.com/v1/audio/transcriptions`，模型 `doubao-asr`，`response_format=json`。
+6. 默认只返回响应里的 `text` 干净文本；用户要求时间戳时再检查响应结构，不编造时间戳。
+
+请求体示例：
+
+```json
+{
+  "model": "doubao-asr",
+  "response_format": "json",
+  "metadata": {
+    "audio_url": "<OSS signed_url>"
+  }
+}
+```
+
 ### 生图技能
 
 `生图技能` 随 npm 包安装到 Skill bundle。YuanFlow 主程序内优先使用受控工具 `yuanflow_image_request`，自动注入当前用户 token 并缓存返回图片。

package/package.json

@@ -1,73 +1,73 @@
-{
-  "name": "yuanflow-cli",
-  "version": "0.1.18",
-  "description": "YuanFlow API CLI and skill installer for supported AI coding agents.",
-  "type": "module",
-  "license": "MIT",
-  "private": false,
-  "author": "zktlove",
-  "publishConfig": {
-    "access": "public"
-  },
-  "bin": {
-    "yuanflow-cli": "bin/yuanflow-cli.js",
-    "yuanflow-skill": "bin/yuanflow-skill.cjs"
-  },
-  "scripts": {
-    "postinstall": "node ./bin/yuanflow-skill.cjs install --postinstall",
-    "generate": "node ./scripts/generate-registry.js",
-    "start": "node ./bin/yuanflow-cli.js",
-    "test": "node --test test/*.test.js tests/*.test.cjs",
-    "pack:check": "npm pack --dry-run",
-    "release:check": "node ./bin/yuanflow-skill.cjs release-check",
-    "publish:help": "node ./bin/yuanflow-skill.cjs publish-help"
-  },
-  "files": [
-    "bin",
-    "src",
-    "generated",
-    "scripts",
-    "lib",
-    "skills",
-    "README.md",
-    "LICENSE"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/zktlove/yuanflow-cli.git"
-  },
-  "homepage": "https://github.com/zktlove/yuanflow-cli#readme",
-  "bugs": {
-    "url": "https://github.com/zktlove/yuanflow-cli/issues"
-  },
-  "yuanflowSkill": {
-    "skillRepo": {
-      "owner": "zktlove",
-      "repo": "yuanflow-skill",
-      "ref": "main"
-    }
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "keywords": [
-    "skills",
-    "ai-agent",
-    "codex",
-    "claude-code",
-    "cursor",
-    "opencode",
-    "github-copilot",
-    "gemini-cli",
-    "kimi-cli",
-    "openclaw",
-    "trae",
-    "windsurf",
-    "qoder",
-    "qwen-code",
-    "yuanflow-cli",
-    "yuanflow-skill",
-    "xiaohongshu",
-    "douyin"
-  ]
-}
+{
+  "name": "yuanflow-cli",
+  "version": "0.1.20",
+  "description": "YuanFlow API CLI and skill installer for supported AI coding agents.",
+  "type": "module",
+  "license": "MIT",
+  "private": false,
+  "author": "zktlove",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "yuanflow-cli": "bin/yuanflow-cli.js",
+    "yuanflow-skill": "bin/yuanflow-skill.cjs"
+  },
+  "scripts": {
+    "postinstall": "node ./bin/yuanflow-skill.cjs install --postinstall",
+    "generate": "node ./scripts/generate-registry.js",
+    "start": "node ./bin/yuanflow-cli.js",
+    "test": "node --test test/*.test.js tests/*.test.cjs",
+    "pack:check": "npm pack --dry-run",
+    "release:check": "node ./bin/yuanflow-skill.cjs release-check",
+    "publish:help": "node ./bin/yuanflow-skill.cjs publish-help"
+  },
+  "files": [
+    "bin",
+    "src",
+    "generated",
+    "scripts",
+    "lib",
+    "skills",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zktlove/yuanflow-cli.git"
+  },
+  "homepage": "https://github.com/zktlove/yuanflow-cli#readme",
+  "bugs": {
+    "url": "https://github.com/zktlove/yuanflow-cli/issues"
+  },
+  "yuanflowSkill": {
+    "skillRepo": {
+      "owner": "zktlove",
+      "repo": "yuanflow-skill",
+      "ref": "main"
+    }
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "skills",
+    "ai-agent",
+    "codex",
+    "claude-code",
+    "cursor",
+    "opencode",
+    "github-copilot",
+    "gemini-cli",
+    "kimi-cli",
+    "openclaw",
+    "trae",
+    "windsurf",
+    "qoder",
+    "qwen-code",
+    "yuanflow-cli",
+    "yuanflow-skill",
+    "xiaohongshu",
+    "douyin"
+  ]
+}

package/skills/yuanflow-skill/README.md

@@ -11,6 +11,7 @@ YuanFlow Skill 是 `yuanflow-cli` 的 Agent Skill 仓库，用于把社媒平台
 - `生图技能/`：图片生成与编辑 Skill，优先走 YuanFlow 内置 `yuanflow_image_request`。
 - `HTML报告生成/`：单页 HTML 报告生成 Skill，内置 9 种米色留白报告模板。
 - `本地音视频转文字/`：本地 SenseVoice 音视频转文字 Skill，首次明确使用时按需下载模型。
+- `音视频在线转文字/`：通过 YuanFlow 在线 ASR 接口把音频或视频转成干净文本，视频会先抽取音频并通过 OSS 中转。
 - `帐号监控/`：帐号搜索、主页资料、主页作品、历史快照、变化对比和 HTML 可视化分流 Skill。
 - `个人创作库/`：长期保存、整理、复盘和复用用户认可的自媒体合格产出物。
 
@@ -24,6 +25,7 @@ YuanFlow Skill 是 `yuanflow-cli` 的 Agent Skill 仓库，用于把社媒平台
 - 生成图片、编辑图片，并缓存返回 URL 或 base64 图片。生成图片必填 `prompt`，可选 `size / quality / style / n / response_format`；编辑图片必须通过 multipart 上传本地图片。
 - 把自媒体分析、数据复盘、文案方案、账号监控、知识梳理和执行计划生成可直接打开的单页 HTML 报告。
 - 在用户明确要求本地转写时，把本地音频或视频转成文字；视频会先抽取音频，模型和缓存都保存在 Skill 自己目录下。
+- 在用户要求在线转写、云端转写或 doubao-asr 时，把本地音频或视频经 OSS 中转后提交在线 ASR，默认只返回干净文本。
 - 监控抖音、小红书、微博、知乎、Bilibili、TikTok、YouTube、Twitter/X 帐号主页，保存快照并对比历史变化；抖音链路优先使用 `get-sec-user-id -> user-profile -> user-posts -> works detail`。
 - 在用户要求保存、归档、复盘或复用已完成创作成果时，把选题、标题、文案、脚本、封面、剪辑思路、发布计划和数据复盘沉淀进个人创作库。
 
@@ -96,6 +98,8 @@ yuanflow-skill list-skills
 ├─ 本地音视频转文字
 │  ├─ SKILL.md
 │  └─ scripts/
+├─ 音视频在线转文字
+│  └─ SKILL.md
 ├─ 个人创作库
 │  ├─ SKILL.md
 │  ├─ raw/

package/skills/yuanflow-skill/SKILL.md

@@ -23,6 +23,7 @@ description: Use when the user asks about social-media API workflows, platform d
 - `生图技能/`
 - `HTML报告生成/`
 - `本地音视频转文字/`
+- `音视频在线转文字/`
 - `帐号监控/`
 - `个人创作库/`
 
@@ -204,6 +205,20 @@ description: Use when the user asks about social-media API workflows, platform d
 
 - `本地音视频转文字`
 
+### 13. 走 `音视频在线转文字`
+
+遇到下面这些需求，优先进入这个子 Skill：
+
+- 用户要求在线转文字、云端转写、快速转写、音频识别或视频提取文字。
+- 用户提供本地音频或视频文件，并希望通过 YuanFlow 在线 ASR 获取完整文字稿。
+- 用户明确要求使用 `doubao-asr`。
+
+如果用户明确要求离线、本地模型或本地 ASR，改用 `本地音视频转文字`。
+
+子 Skill 名称：
+
+- `音视频在线转文字`
+
 ## 多需求时怎么处理
 
 如果用户一次提了多段流程，不要强行塞进一个子 Skill，按阶段拆开：

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

@@ -7,6 +7,18 @@ description: Use when the user asks to generate images, create pictures, make po
 
 当用户提到生成图片、画图、出图、做海报、生成视觉素材、编辑图片或修改本地图片时，优先使用本 Skill。
 
+## 提示词参考
+
+当用户需求比较模糊、没有明确风格方向，或需要补足海报、商品图、角色、人像、UI 截图、信息图、科研图等提示词结构时，可按需读取 `references/image-prompt-reference.md`。
+
+该参考库只作为方向参考，不是强制模板：
+
+- 用户已经给出明确提示词时，以用户提示词为主。
+- 不要原样复制案例，要结合用户主题、平台、比例、文字、保存要求重新改写。
+- 只借鉴案例里的构图、镜头、材质、灯光、版式、文字约束、负面提示和 JSON/config-style 结构。
+- 不要主动加入案例中的真实品牌、真实人物、个人签名、Logo、水印或作者标识。
+- 中文海报、信息图、社交截图等含文字场景，需要明确要求文字清晰、简体中文、不乱码、层级正确。
+
 ## YuanFlow 内置环境
 
 如果当前 Agent 可用 `yuanflow_image_request`，优先使用该受控工具。它会自动注入当前用户 token，并把接口返回的 URL 或 base64 图片缓存为可预览资源。