yuanflow-cli 0.1.37 → 0.1.40

package/README.md

@@ -4,6 +4,7 @@ YuanFlow 的 npm 包，包含两个命令入口：
 
 - `yuanflow-cli`：社媒 API 转 CLI，覆盖完整 registry、快捷命令、schema、dry-run 和 agent-json 输出。
 - `yuanflow-skill`：把 `YuanFlow-skill` 注入到本机支持的 AI Agent skills 目录。
+- `飞书官方技能`：YuanFlow 主程序内通过受控工具托管安装并调用飞书官方 `@larksuite/cli`，npm 包只提供 Skill 说明，不复制官方 CLI 源码。
 
 ## 安装
 
@@ -35,6 +36,7 @@ yuanflow-cli works detail --platform douyin --target "https://v.douyin.com/xxx/"
 yuanflow-cli works download --platform douyin --target "https://v.douyin.com/xxx/" --region CN --format agent-json
 yuanflow-cli search content --platform xiaohongshu --keyword "美妆" --format agent-json
 yuanflow-cli search users --platform instagram --keyword "nasa" --format agent-json
+yuanflow-cli trending video-hot-list --format agent-json
 yuanflow-cli douyin web get-sec-user-id --url "https://v.douyin.com/xxx/" --format agent-json
 yuanflow-cli douyin user-profile <sec_user_id> --format agent-json
 yuanflow-cli douyin user-posts <sec_user_id> --count 20 --cursor 0 --format agent-json
@@ -43,6 +45,9 @@ 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 list douyin
 ```
 
@@ -95,6 +100,26 @@ yuanflow-cli search users --platform instagram --keyword "nasa" --format agent-j
 
 Agent 不确定参数时先执行 `commands list`，再用 `schema works.douyin.detail` 或 `schema search.xiaohongshu.content` 查看参数。`--dry-run` 可预览请求映射，不发起真实接口请求，也不要求 token。
 
+### 热门内容整理
+
+热门内容整理统一走 `trending video-hot-list`，一次性查询抖音视频热榜五类榜单，并输出统一 JSON：
+
+```bash
+yuanflow-cli trending video-hot-list --format agent-json
+yuanflow-cli trending video-hot-list --page 1 --page-size 10 --date-window 2 --format agent-json
+yuanflow-cli trending video-hot-list --tags-json "[{\"value\":\"顶级垂类标签id\",\"children\":[{\"value\":\"子级垂类标签id\"}]}]" --format agent-json
+```
+
+默认查询：
+
+- `1001` 视频总榜
+- `1002` 低粉爆款
+- `1003` 高完播率
+- `1004` 高涨粉率
+- `1005` 高点赞率
+
+Agent 使用该命令后，应结合用户个人创作信息、个人创作库历史记录、历史任务或对话记录，输出可执行的选题、内容结构和发布建议，而不是只罗列榜单。
+
 ### 帐号监控
 
 `帐号监控` 随 npm 包安装到 Skill bundle，用于把帐号搜索、主页资料、主页作品、历史快照和变化对比串成稳定流程。
@@ -129,8 +154,30 @@ yuanflow-cli knowledge rule-detail --rule-code some_rule_code --output-format sh
 
 Agent 应先查看 `knowledge docs`，再把用户需求整理成 `task_frame`，按接口返回的 `next_actions` 渐进查询。v2 接口不要求 `task_intent`；旧字段仅保留兼容。`packs`、`rules` 的 `data` 可能直接是数组，Agent 不应假设固定对象结构，应优先读取 `next_actions` 继续下钻。
 
+查询前必须先明确用户具体需求，再从知识库的一级能力开始，依次使用渐进式查询。不能跳级、跨越式查询。
+
 `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 校验并渲染。
+
+```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
+```
+
+`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`，不直接远程查规则库。
+
 ### 业务创作类 Skill
 
 以下业务 Skill 随 npm 包一起安装，统一流程是：先检查 `个人创作库` 是否有对应历史参考记录，再调用 `自媒体知识库` 按 `next_actions` 分层查询方法摘要，最后结合用户要求输出结果。输出后会询问用户是否满意、是否记录到个人创作库，并询问是否需要生成 HTML 可视化汇总。
@@ -140,6 +187,8 @@ Agent 应先查看 `knowledge docs`，再把用户需求整理成 `task_frame`
 - `帐号定位`：账号人设、内容边界、目标受众、价值主张和栏目方向。
 - `选题策划`：选题池、系列选题、热点选题和选题优先级排序。
 - `文案创作`：小红书、公众号、朋友圈、短视频口播、直播预告、海报和转化型文案。
+- `热门内容整理`：一次性查询视频总榜、低粉爆款、高完播率、高涨粉率、高点赞率，并结合用户创作方向输出建议。
+- `创作总监`：负责内容方向把控、创新判断、复查验收和跨技能创作统筹。
 - `视频投流策略`：短视频、图文视频或内容素材的投流目标、人群、预算、素材分层和测试节奏。
 - `直播投流策略`：直播预热、直播引流、直播成交和直播间投放的人群、预算、素材、节奏和复盘策略。
 
@@ -193,7 +242,7 @@ yuanflow-cli browser dry-run --platform xiaohongshu --task publish --account mai
 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` 干净文本；用户要求时间戳时再检查响应结构，不编造时间戳。
+6. 默认只返回响应里的 `text` 干净文本；视频剪辑任务需要音频对齐时，要优先保留 ASR 响应中的 `segments` / `words` 时间戳结构，后续交给 `yuanflow-cli video align --asr-file` 导入。接口没有返回时间戳时，不编造时间戳，改用 forced alignment 或人工按文案切分时间。
 
 请求体示例：
 

package/package.json

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

package/skills/yuanflow-skill/IP/350/277/220/350/220/245/SKILL.md

@@ -16,6 +16,7 @@ emoji: 🪪
    - 如果没有命中，说明“未发现可用历史参考记录”，继续下一步。
 2. 调用 `自媒体知识库`。
    - 先查 `knowledge docs` 或 `knowledge entry`，根据用户目标构造 `domain` 和 `content_goal`。
+   - 查询时，必须先明确用户具体需求，然后从知识库的一级能力开始，依次使用渐进式查询。不能跳级、跨越式查询。
    - 按返回的 `next_actions` 分层查看 `packs`、`rules` 或 `rule-detail`，直到拿到足够的方法摘要。
    - 不要自己拼 SQL，不要跳过知识库直接凭空输出。
 3. 结合用户要求、历史参考记录和知识库结果，完成 IP 运营方案。

package/skills/yuanflow-skill/README.md

@@ -10,7 +10,10 @@ YuanFlow Skill 是 `yuanflow-cli` 的 Agent Skill 仓库，用于把社媒平台
 - `OSS文件中转工具/`：OSS 临时上传、签名链接、对象复制 Skill，走 `yuanflow-cli oss`。
 - `生图技能/`：图片生成与编辑 Skill，优先走 YuanFlow 内置 `yuanflow_image_request`。
 - `公众号生成与发布/`：公众号文章创作、主题预览、微信内联 HTML 排版、正文图片上传和草稿箱推送 Skill。
-- `小红书运营与发布/`：小红书选题调研、笔记搜索、账号分析、评论采集、文案创作、图文/视频发布和互动操作 Skill。
+- `小红书运营/`：小红书选题调研、笔记搜索、账号分析、评论采集、文案创作、发布前检查和互动操作 Skill；不建议浏览器自动发布作品，除非用户明确无视平台识别和限流风险并强制要求。
+- `热门内容整理/`：一次性查询视频总榜、低粉爆款、高完播率、高涨粉率、高点赞率，并结合用户创作方向输出建议。
+- `创作总监/`：负责内容方向把控、创新判断、复查验收和跨技能创作统筹。
+- `视频智能剪辑/`：主音频 + B-roll 素材智能剪辑 Skill，先查自媒体知识库的视频剪辑策略，保存 `strategy_snapshot.json`，再通过 ASR/forced alignment 导入 `audio_alignment.json`，按 1 秒 1 帧抽帧并回写视觉理解，由 Agent 生成 `timeline_plan` 和 EDL，交给 `yuanflow-cli video` 校验和渲染。
 - `HTML报告生成/`：单页 HTML 报告生成 Skill，内置 9 种米色留白报告模板。
 - `本地音视频转文字/`：本地 SenseVoice 音视频转文字 Skill，首次明确使用时按需下载模型。
 - `音视频在线转文字/`：通过 YuanFlow 在线 ASR 接口把音频或视频转成干净文本，视频会先抽取音频并通过 OSS 中转。
@@ -24,6 +27,7 @@ YuanFlow Skill 是 `yuanflow-cli` 的 Agent Skill 仓库，用于把社媒平台
 - `文案创作/`：先查历史文案和表达资产，再结合自媒体知识库输出文案。
 - `视频投流策略/`：先查历史发布和投放复盘，再结合自媒体知识库输出视频投流策略。
 - `直播投流策略/`：先查历史直播和投放复盘，再结合自媒体知识库输出直播投流策略。
+- `飞书官方技能/`：通过 YuanFlow 受控工具托管安装并调用飞书官方 `@larksuite/cli`，用于飞书文档、表格、多维表格、日历、邮箱、任务、通讯录、即时消息、知识库和 OpenAPI 等办公任务。
 
 ## 适用场景
 
@@ -36,12 +40,14 @@ YuanFlow Skill 是 `yuanflow-cli` 的 Agent Skill 仓库，用于把社媒平台
 - 把自媒体分析、数据复盘、文案方案、账号监控、知识梳理和执行计划生成可直接打开的单页 HTML 报告。
 - 生成或改写公众号文章，进入主题选择预览后导出微信公众号编辑器可粘贴 HTML，或推送到公众号草稿箱。
 - 处理小红书单段或全流程任务，例如只写文案、只采集笔记、只分析账号、只采集评论、只做点赞收藏评论回复，或完整执行图文/视频发布流程；每轮开始前必须明确任务边界。
+- 在用户要求智能剪辑、自动剪辑、主音频匹配 B-roll、重排视频画面或生成剪辑预览时，使用视频智能剪辑 Skill；第一版先查规则库，导入策略快照，用“音视频在线转文字”或 forced alignment 建立音频对齐，抽帧频率固定 1 秒 1 帧，再回写视觉理解结果，最后生成 `timeline_plan` 和 EDL。
 - 在用户明确要求本地转写时，把本地音频或视频转成文字；视频会先抽取音频，模型和缓存都保存在 Skill 自己目录下。
 - 在用户要求在线转写、云端转写或 doubao-asr 时，把本地音频或视频经 OSS 中转后提交在线 ASR，默认只返回干净文本。
 - 在用户要求自媒体平台浏览器自动化、账号登录态隔离、Cookie/profile 保存、平台页面采集或作品发布时，使用专用自媒体浏览器自动化 Skill；普通网页浏览和搜索仍使用通用浏览器能力。
 - 监控抖音、小红书、微博、知乎、Bilibili、TikTok、YouTube、Twitter/X 帐号主页，保存快照并对比历史变化；抖音链路优先使用 `get-sec-user-id -> user-profile -> user-posts -> works detail`。
 - 在用户要求保存、归档、复盘或复用已完成创作成果时，把选题、标题、文案、脚本、封面、剪辑思路、发布计划和数据复盘沉淀进个人创作库。
 - 处理 IP 运营、直播话术、帐号定位、选题策划、文案创作、视频投流和直播投流等业务创作任务；这些 Skill 会先查个人创作库历史参考记录，再按自媒体知识库 `next_actions` 分层查询方法摘要。
+- 处理飞书/Lark 办公任务时，使用飞书官方技能；YuanFlow 只托管官方 CLI 的安装、认证状态、执行看板续接和受控调用，不复制或修改官方 CLI 源码。
 
 ## 双环境使用方式
 
@@ -109,9 +115,13 @@ yuanflow-skill list-skills
 │  ├─ themes/
 │  ├─ references/
 │  └─ tests/
-├─ 小红书运营与发布
+├─ 小红书运营
+├─ 热门内容整理
+├─ 创作总监
 │  ├─ SKILL.md
 │  └─ references/
+├─ 视频智能剪辑
+│  └─ SKILL.md
 ├─ HTML报告生成
 │  ├─ SKILL.md
 │  ├─ templates/

package/skills/yuanflow-skill/SKILL.md

@@ -22,7 +22,10 @@ description: 当用户需要处理自媒体平台接口工作流、平台数据
 - `OSS文件中转工具/`
 - `生图技能/`
 - `公众号生成与发布/`
-- `小红书运营与发布/`
+- `小红书运营/`
+- `热门内容整理/`
+- `创作总监/`
+- `视频智能剪辑/`
 - `HTML报告生成/`
 - `本地音视频转文字/`
 - `音视频在线转文字/`
@@ -36,6 +39,7 @@ description: 当用户需要处理自媒体平台接口工作流、平台数据
 - `文案创作/`
 - `视频投流策略/`
 - `直播投流策略/`
+- `飞书官方技能/`
 
 ## 环境判断
 
@@ -138,6 +142,7 @@ description: 当用户需要处理自媒体平台接口工作流、平台数据
 - 自媒体选题、开头钩子、脚本、文案、标题、改写、评分、剪辑建议、发布策略。
 - 用户明确要求查询 YuanFlow 自媒体知识库、方法包、规则方向。
 - 需要按照知识库 `next_actions` 渐进式查询方法论摘要。
+- 查询前必须先明确用户具体需求，再从知识库的一级能力开始，依次使用渐进式查询。不能跳级、跨越式查询。
 
 子 Skill 名称：
 
@@ -154,6 +159,9 @@ description: 当用户需要处理自媒体平台接口工作流、平台数据
 | 账号人设、内容边界、目标受众、价值主张、栏目方向 | `帐号定位` |
 | 选题池、系列选题、热点选题、选题优先级排序 | `选题策划` |
 | 小红书、公众号、朋友圈、短视频口播、直播预告、海报或转化型文案 | `文案创作` |
+| 热点内容、爆款案例、高完播、高涨粉、高点赞内容整理和创作建议 | `热门内容整理` |
+| 内容方向把控、创新判断、复查验收、上线前质量门禁 | `创作总监` |
+| 主音频匹配 B-roll、自动剪辑、重排画面、生成剪辑预览或成片 | `视频智能剪辑` |
 | 短视频、图文视频或内容素材的投流目标、人群、预算、素材分层、测试节奏 | `视频投流策略` |
 | 直播间、直播预热、直播引流、直播成交的投放人群、预算、素材、节奏和复盘 | `直播投流策略` |
 
@@ -233,7 +241,7 @@ description: 当用户需要处理自媒体平台接口工作流、平台数据
 
 - `公众号生成与发布`
 
-### 15. 走 `小红书运营与发布`
+### 15. 走 `小红书运营`
 
 遇到下面这些需求，优先进入这个子 Skill：
 
@@ -241,11 +249,11 @@ description: 当用户需要处理自媒体平台接口工作流、平台数据
 - 用户要求写小红书文案、准备发布笔记、检查素材、生成话题标签。
 - 用户要求对小红书笔记点赞、收藏、评论或回复。
 
-它可以执行完整流程，也可以只做部分能力。每次开始前必须先明确用户本轮任务边界：只写文案、只采集、只分析、只互动、只发布，还是完整流程。
+它可以执行完整流程，也可以只做部分能力。每次开始前必须先明确用户本轮任务边界：只写文案、只采集、只分析、只互动、只发布，还是完整流程。默认不建议使用浏览器自动发布作品，因为平台识别算法可能检测并限流；只有用户明确无视此说明并强制要求时才允许自动发布。
 
 子 Skill 名称：
 
-- `小红书运营与发布`
+- `小红书运营`
 
 ### 16. 走 `个人创作库`
 

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

@@ -36,7 +36,7 @@ emoji: 📰
 ### 完全重新创作
 
 1. 先明确主题、读者、账号定位、文章目的和期望风格。
-2. 使用 `自媒体知识库` 查询公众号创作相关知识点，根据主题构造 `domain` 和 `content_goal`。
+2. 使用 `自媒体知识库` 查询公众号创作相关知识点，根据主题构造 `domain` 和 `content_goal`。查询时，必须先明确用户具体需求，然后从知识库的一级能力开始，依次使用渐进式查询。不能跳级、跨越式查询。
 3. 结合知识库结果输出文章结构、标题候选和正文。
 4. 用户确认正文后再进入排版、导出或草稿箱流程。
 

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

@@ -0,0 +1,94 @@
+---
+name: 创作总监
+description: 当用户需要对自媒体内容进行方向把控、创新判断、结构复查、质量验收、上线前审稿或跨技能创作统筹时使用。
+emoji: 🎯
+---
+
+# 创作总监
+
+本 Skill 是 YuanFlow 自媒体创作链路的把控与验收角色。它不替代具体执行技能，而是负责判断创作目标是否清楚、选题是否成立、内容是否有创新、结构是否完整、表达是否适合平台，以及最终产物是否达到可发布或可交付标准。
+
+## 分类
+
+自媒体技能区
+
+## 核心职责
+
+1. 把控：明确用户目标、平台、受众、账号定位和成败标准。
+2. 创新：判断内容是否有新角度、新表达、新结构或新组合，避免同质化。
+3. 复查：检查选题、标题、开头、脚本、文案、画面、封面、话题、节奏和转化逻辑。
+4. 验收：给出是否可发布、需要修改、需要重做或需要补数据的结论。
+5. 调度：根据任务需要调用个人创作库、自媒体知识库、热门内容整理、选题策划、文案创作、视频智能剪辑、HTML报告生成等技能。
+
+## 开始前必须确认
+
+1. 本次要把控的对象：选题、标题、脚本、文案、封面、视频结构、发布计划、复盘报告或完整项目。
+2. 目标平台：抖音、小红书、公众号、视频号、B站、快手、TikTok、YouTube 或其它。
+3. 目标用户和账号定位。
+4. 用户当前阶段：从 0 到 1 创作、半成品复查、发布前验收、发布后复盘。
+5. 是否允许调用其它技能补充数据或重新生成内容。
+
+## 调度逻辑
+
+根据用户任务选择能力：
+
+- 需要历史资产：调用 `个人创作库`。
+- 需要方法论：调用 `自媒体知识库`。查询时，必须先明确用户具体需求，然后从知识库的一级能力开始，依次使用渐进式查询。不能跳级、跨越式查询。
+- 需要趋势和爆款参考：调用 `热门内容整理`。
+- 需要选题池：调用 `选题策划`。
+- 需要标题、脚本、正文、发布文案：调用 `文案创作`。
+- 需要小红书专项流程：调用 `小红书运营`。
+- 需要公众号草稿和排版：调用 `公众号生成与发布`。
+- 需要视频剪辑结构：调用 `视频智能剪辑`。
+- 需要可视化汇总：调用 `HTML报告生成`。
+
+## 把控维度
+
+### 1. 目标把控
+
+- 用户真正想要的是增长、转化、建立信任、表达观点、带货、获客、沉淀品牌，还是完成一次内容交付。
+- 内容是否服务于这个目标，而不是只追求热闹。
+
+### 2. 选题把控
+
+- 是否有明确受众。
+- 是否有足够痛点、爽点、利益点或新信息。
+- 是否和账号长期定位一致。
+- 是否有平台适配性。
+
+### 3. 创新把控
+
+- 是否只是套模板。
+- 是否有独特观点、案例、反常识、结构创新、表达创新或视觉创新。
+- 是否能形成用户记忆点。
+
+### 4. 结构复查
+
+- 开头是否足够快进入主题。
+- 中段是否有递进，而不是平铺。
+- 结尾是否有明确行动、观点或记忆点。
+- 是否存在信息重复、逻辑跳跃或表达过载。
+
+### 5. 发布验收
+
+- 标题、封面、正文、脚本、话题、素材是否完整。
+- 是否存在平台风险、夸大承诺、敏感表达、侵权风险或自动化发布风险。
+- 小红书等平台不建议使用浏览器自动化直接发布作品，除非用户明确无视平台识别和限流风险并强制要求。
+
+## 输出格式
+
+默认输出：
+
+1. 总体判断：可继续 / 需要修改 / 建议重做。
+2. 核心问题：按影响优先级列出。
+3. 创新建议：给出可执行的新角度或新结构。
+4. 修改清单：明确改哪里、怎么改。
+5. 验收标准：修改后用什么标准判断合格。
+6. 下一步建议：进入具体技能执行，或生成 HTML 汇总报告。
+
+## 注意事项
+
+- 不要只夸内容，要敢于指出不可发布的问题。
+- 不要替具体技能编造已经查询到的数据；需要数据就调用对应技能。
+- 不要把所有内容都推倒重做，优先判断能否局部修复。
+- 用户只要轻量建议时，输出短版；用户要求完整审稿时，再输出详细版。

package/skills/yuanflow-skill//345/260/217/347/272/242/344/271/246/350/277/220/350/220/245/{344/270/216/345/217/221/345/270/203/SKILL.md → SKILL.md}

@@ -1,13 +1,15 @@
 ---
-name: 小红书运营与发布
+name: 小红书运营
 description: 当用户需要小红书选题调研、文案创作、笔记搜索、账号分析、评论采集、图文或视频发布、点赞收藏评论回复等小红书运营任务时使用。
 emoji: 📕
 ---
 
-# 小红书运营与发布
+# 小红书运营
 
 本 Skill 用于把小红书任务从“明确边界、采集分析、内容创作、素材检查、登录确认、发布执行、互动操作、结果回报”串成一个可控流程。它拥有完整能力，但用户可以只使用其中一部分，例如只写文案、只采集笔记、只分析账号、只采集评论、只做发布前检查，或一次性完成完整运营流程。
 
+重要提醒：不建议让 Agent 使用浏览器自动化直接发布作品。小红书等平台的识别算法可能检测自动化发布行为，并对账号内容进行限流或风控。除非用户在看到此说明后仍明确要求“无视风险，强制使用浏览器自动发布”，否则本 Skill 默认只做发布前检查、素材整理、文案准备和人工发布指导。
+
 ## 分类
 
 自媒体技能区
@@ -20,7 +22,8 @@ emoji: 📕
 4. 是否涉及封面或正文插图：如果需要生成封面或插图，必须使用 `生图技能`，并先和用户确认图片比例是 4:3 还是 3:4；用户已明确给出比例时直接采用。
 5. 发布确认策略：
    - 默认每次真实发布前必须向用户确认。
-   - 如果用户明确说“后续都自动直接发布”“这个账号以后不用重复问”，可以把该偏好作为用户记忆；后续同类任务不重复确认，但仍需在执行结果里说明已按用户记忆自动执行。
+   - 不建议自动发布作品，因为平台识别算法可能检测并限流。只有用户明确表示已了解风险且强制要求浏览器自动发布时，才允许继续执行自动化发布。
+   - 如果用户明确说“后续都自动直接发布”“这个账号以后不用重复问”，必须再次提示平台自动化发布限流风险；用户仍明确坚持后，才可以把该偏好作为用户记忆；后续同类任务不重复确认，但仍需在执行结果里说明已按用户记忆自动执行。
 6. 评论和回复默认必须确认；点赞、收藏可按用户明确指令直接执行。
 7. 登录态使用 YuanFlow 独立浏览器配置，不要求用户复用默认 Chrome，不读取用户默认浏览器 Cookie。
 
@@ -88,6 +91,7 @@ yuanflow-cli browser dry-run --platform xiaohongshu --task publish --title "标
 1. 先确认任务边界：只写标题、只写正文、标题+正文、发布版笔记、种草文案、测评文案、探店文案、合集文案或完整发布流程。
 2. 确认账号定位、目标用户、产品/主题、语气风格、禁忌表达、字数范围、是否需要话题标签。
 3. 写任何小红书文案前，必须先使用 `自媒体知识库` 查找并参考对应写作方法论，例如选题、标题、钩子、种草、测评、探店、合集、转化或发布策略；不要跳过知识库直接凭空输出文案。
+   - 查询时，必须先明确用户具体需求，然后从知识库的一级能力开始，依次使用渐进式查询。不能跳级、跨越式查询。
 4. 如果用户要求参考平台趋势，先采集或搜索同类笔记，再结合知识库方法论创作。
 5. 输出小红书文案时默认包含：
    - 标题候选
@@ -112,15 +116,18 @@ yuanflow-cli browser dry-run --platform xiaohongshu --task publish --title "标
 1. 检查标题、正文、图片列表、话题、可见性、发布时间和目标账号。
 2. 图片必须是本地可访问路径或 YuanFlow 资源路径。
 3. 标题应符合小红书长度限制，过长时先给用户改写建议。
-4. 默认发布前确认；用户已明确授权自动发布时，可直接执行。
-5. 发布失败时报告失败阶段：未登录、素材不存在、上传失败、页面元素变化、提交失败或平台风控。
+4. 话题必须通过平台官方候选插入，优先使用 `yuanflow_browser_automation` 的 `select-platform-topics`；成功标准是正文编辑器 DOM 中出现 `a.tiptap-topic`、`data-topic`、`contenteditable="false"`，不能只看见普通 `#关键词` 文本。
+5. 话题异常时先用 `inspect-platform-topic-dom` 写出 DOM 诊断文件，再根据诊断重试；不要只靠坐标、截图颜色或文本候选点击判断。
+6. 默认发布前确认；不建议浏览器自动发布。只有用户明确表示无视平台识别和限流风险、强制要求自动发布时，才可执行自动化发布。
+7. 发布失败时报告失败阶段：未登录、素材不存在、上传失败、页面元素变化、提交失败或平台风控。
+8. 任务完整结束后可以询问用户对结果是否满意；如果用户明确表示满意，可将最终结果、素材路径、关键制作流程、发布前检查结论保存到 `个人创作库`，便于后续复用。
 
 ### 视频笔记
 
 1. 检查标题、正文、视频路径、封面、话题、可见性、发布时间和目标账号。
 2. 视频路径必须是本地可访问文件。
 3. 不要把图文和视频混成一个发布任务。
-4. 默认发布前确认；用户已明确授权自动发布时，可直接执行。
+4. 默认发布前确认；不建议浏览器自动发布。只有用户明确表示无视平台识别和限流风险、强制要求自动发布时，才可执行自动化发布。
 
 ## 互动流程
 
@@ -151,6 +158,7 @@ yuanflow-cli browser dry-run --platform xiaohongshu --task publish --title "标
 ## 常见错误
 
 - 用户只想写文案，却直接尝试发布。
+- 用户没有明确无视平台风控风险，却使用浏览器自动发布作品。
 - 采集任务没有确认关键词、数量或目标笔记。
 - 发布前没有检查图片/视频路径是否存在。
 - 把小红书 MCP 当成独立安装项使用。

package/skills/yuanflow-skill//345/270/220/345/217/267/345/256/232/344/275/215/SKILL.md

@@ -16,6 +16,7 @@ emoji: 🧭
    - 如果没有命中，说明“未发现可用历史参考记录”，继续下一步。
 2. 调用 `自媒体知识库`。
    - 先查 `knowledge docs` 或 `knowledge entry`，根据账号行业、目标人群、内容目标和商业目标构造 `domain` 和 `content_goal`。
+   - 查询时，必须先明确用户具体需求，然后从知识库的一级能力开始，依次使用渐进式查询。不能跳级、跨越式查询。
    - 按返回的 `next_actions` 分层查看 `packs`、`rules` 或 `rule-detail`，直到拿到足够的方法摘要。
    - 不要自己拼 SQL，不要跳过知识库直接凭空输出。
 3. 结合用户要求、历史参考记录和知识库结果，输出账号定位方案。

package/skills/yuanflow-skill//346/226/207/346/241/210/345/210/233/344/275/234/SKILL.md

@@ -16,6 +16,7 @@ emoji: ✍️
    - 如果没有命中，说明“未发现可用历史参考记录”，继续下一步。
 2. 调用 `自媒体知识库`。
    - 先查 `knowledge docs` 或 `knowledge entry`，根据平台、受众、语气、内容目标和转化目标构造 `domain` 和 `content_goal`。
+   - 查询时，必须先明确用户具体需求，然后从知识库的一级能力开始，依次使用渐进式查询。不能跳级、跨越式查询。
    - 按返回的 `next_actions` 分层查看 `packs`、`rules` 或 `rule-detail`，直到拿到足够的方法摘要。
    - 不要自己拼 SQL，不要跳过知识库直接凭空输出。
 3. 结合用户要求、历史参考记录和知识库结果，输出文案。

package/skills/yuanflow-skill//347/203/255/351/227/250/345/206/205/345/256/271/346/225/264/347/220/206/SKILL.md

@@ -0,0 +1,83 @@
+---
+name: 热门内容整理
+description: 当用户需要整理抖音视频热榜、爆款案例、高完播率、高涨粉率、高点赞率内容，并结合个人创作方向输出创作建议时使用。
+emoji: 🔥
+---
+
+# 热门内容整理
+
+本 Skill 用于把热门内容从“榜单采集、结构化整理、创作相关性判断、个人化建议”串成完整流程。它不是简单罗列链接，而是帮助用户判断哪些热点值得借鉴、如何借鉴、哪些不适合照搬。
+
+## 分类
+
+自媒体技能区
+
+## 开始前必须确认
+
+1. 用户的创作方向、账号定位、目标平台和目标受众。
+2. 用户希望参考的主题、行业、关键词或内容垂类；如果用户没有指定，先按全部垂类查询。
+3. 是否已有个人创作库历史记录、历史任务或历史对话可参考。
+4. 输出目标：选题建议、内容拆解、脚本方向、账号定位参考、投放素材参考或复盘报告。
+
+## 数据查询逻辑
+
+优先使用 YuanFlow 受控工具 `yuanflow_cli_call` 调用：
+
+```bash
+yuanflow-cli trending video-hot-list --format agent-json
+```
+
+默认参数：
+
+- `page=1`
+- `page_size=10`
+- `date_window=2`
+- `tags` 为空时查询全部垂类
+
+必须一次性查询全部榜单分类：
+
+- `1001` 视频总榜
+- `1002` 低粉爆款
+- `1003` 高完播率
+- `1004` 高涨粉率
+- `1005` 高点赞率
+
+如果用户明确指定垂类标签，使用 `--tags-json` 传入：
+
+```bash
+yuanflow-cli trending video-hot-list --tags-json "[{\"value\":\"顶级垂类标签id\",\"children\":[{\"value\":\"子级垂类标签id\"}]}]" --format agent-json
+```
+
+## 分析流程
+
+1. 先读取个人创作库，查找用户过往的选题、文案、脚本、发布计划和数据复盘。
+2. 再执行五类榜单查询，按榜单分类保存结果。
+3. 对每个榜单提取标题、主题、表达形式、互动指标、账号特征和可复用方法。
+4. 交叉比较五个榜单，识别共同趋势和差异：
+   - 总榜代表平台当前广泛热度。
+   - 低粉爆款代表普通账号可借鉴机会。
+   - 高完播率代表内容结构和留存能力。
+   - 高涨粉率代表人设、系列化和关注理由。
+   - 高点赞率代表情绪价值、观点共鸣和表达记忆点。
+5. 结合用户个人创作信息、创作库历史记录、历史任务或对话记录，给出个人化建议。
+
+## 输出结构
+
+必须输出：
+
+1. 查询范围和参数说明。
+2. 五类榜单摘要。
+3. 热点共同规律。
+4. 与用户创作方向最相关的机会点。
+5. 不建议照搬的风险点。
+6. 可执行选题建议。
+7. 可执行内容结构建议。
+8. 下一步建议：是否进入选题策划、文案创作、创作总监复查或 HTML 报告生成。
+
+## 注意事项
+
+- 不把“热门”简单等同于“适合用户做”。
+- 不只看播放或点赞，要结合完播、涨粉、账号体量和内容形式判断。
+- 不要把五个榜单混成一个列表，必须保留分类来源。
+- 不要跳过用户个人创作信息；没有历史记录时要明确说明“未读取到可参考历史”。
+- 如果用户需要沉淀结果，询问是否写入个人创作库。

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,7 @@ emoji: 📡
    - 如果没有命中，说明“未发现可用历史参考记录”，继续下一步。
 2. 调用 `自媒体知识库`。
    - 先查 `knowledge docs` 或 `knowledge entry`，根据直播平台、直播目标、产品、预算和目标人群构造 `domain` 和 `content_goal`。
+   - 查询时，必须先明确用户具体需求，然后从知识库的一级能力开始，依次使用渐进式查询。不能跳级、跨越式查询。
    - 按返回的 `next_actions` 分层查看 `packs`、`rules` 或 `rule-detail`，直到拿到足够的方法摘要。
    - 不要自己拼 SQL，不要跳过知识库直接凭空输出。
 3. 结合用户要求、历史参考记录和知识库结果，输出直播投流策略。

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,7 @@ emoji: 🎤
    - 如果没有命中，说明“未发现可用历史参考记录”，继续下一步。
 2. 调用 `自媒体知识库`。
    - 先查 `knowledge docs` 或 `knowledge entry`，根据直播主题、产品、目标人群和转化目标构造 `domain` 和 `content_goal`。
+   - 查询时，必须先明确用户具体需求，然后从知识库的一级能力开始，依次使用渐进式查询。不能跳级、跨越式查询。
    - 按返回的 `next_actions` 分层查看 `packs`、`rules` 或 `rule-detail`，直到拿到足够的方法摘要。
    - 不要自己拼 SQL，不要跳过知识库直接凭空输出。
 3. 结合用户要求、历史参考记录和知识库结果，输出直播话术。

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

@@ -83,6 +83,24 @@ yuanflow-cli browser task-plan --platform douyin --task publish --account main -
 - 同时给用户手动处理的简单步骤：先检查网络，再重新下载 Chromium；如果还是不行，就让用户手动安装后再继续。
 - 不要把这个问题说成账号问题，也不要只说“网络错误”就结束。
 
+## 统一错误恢复协议
+
+自媒体平台自动化遇到可恢复错误时，先按下面协议重规划，不能把一次工具错误直接理解成“工具不支持继续执行”：
+
+- `browser-use-not-started`：说明当前浏览器上下文没有页面。先用同平台、同账号 profile 打开该平台发布入口，再重试原安全动作；如果用户已经停在平台页面，也可以读取当前页快照后续接。
+- `browser-fill-target-required`：说明 Agent 没给出 selector、fields_json 或平台专用动作。先执行安全重规划：打开发布入口并读取 DOM 快照，再根据真实控件选择 `fields_json`、`selector`、`browser-batch` 或平台专用动作继续填写。
+- `browser-use-nested-batch-not-supported` 或嵌套 `batch`：先做 batch 展平，把多层 batch 变成单层动作列表，再提交给受控浏览器。不要把 batch 放进 batch 里反复调用。
+- 任何错误动作重规划都必须保留原任务约束：不越过登录、验证码、风控、最终发布、删除、支付、授权等安全边界。
+- 如果连续重规划仍失败，先输出当前页面、已完成字段、失败动作和下一步候补方案，不要改写任务目标，也不要退回“只能人工发布”的结论。
+
+### 话题 DOM 识别原则
+
+- 平台话题必须以官方 DOM 节点为准，不以纯文本、截图颜色或坐标点击作为完成证据。
+- 识别官方话题时优先检查 `a.tiptap-topic`、`data-topic`、`data-type`、`contenteditable="false"`、`role`、`class/id` 中包含 `topic`、`hash`、`mention`、`tag` 的节点。
+- 页面已展示推荐话题时，优先使用带 `recommend-topic-wrapper`、`data-impression`、`tagTarget/tagId` 等语义信息的推荐话题 tag；这是官方 DOM 候选入口，不要退回坐标点击。
+- 如果官方候选没被识别，先调用 `inspect-platform-topic-dom` 导出诊断，再根据 DOM 重新选择候选；不要继续在正文里盲打 `#话题`。
+- 话题修正失败时，下一步应先恢复或校验正文，再重新处理话题候选，防止正文被误覆盖。
+
 ## 支持平台
 
 当前受控协议支持：
@@ -243,9 +261,11 @@ downloads    浏览器下载文件
 2. 先执行 `dry-run --task publish` 检查缺失项。
 3. 先优先用 Chrome 或 Edge；没有这两个浏览器时，提示用户先安装 Chromium。
 4. 打开发布入口并填写内容。
-5. 到最终发布按钮前暂停，复述即将发布的内容。
-6. 用户确认后再点击最终发布或保存草稿。
-7. 记录发布结果、作品链接或失败原因到 `tasks` 目录。
+5. 小红书话题必须走 `select-platform-topics`，以官方 DOM 节点为准：`a.tiptap-topic`、`data-topic`、`contenteditable="false"`；不能把普通 `#关键词` 文本或候选列表文本当作完成。
+6. 小红书话题识别异常时调用 `inspect-platform-topic-dom` 输出诊断文件，再根据 DOM 重试；不要只靠坐标、截图颜色或文本候选点击。
+7. 到最终发布按钮前暂停，复述即将发布的内容。
+8. 用户确认后再点击最终发布或保存草稿。
+9. 记录发布结果、作品链接或失败原因到 `tasks` 目录。
 
 ## 输出要求
 

package/skills/yuanflow-skill//350/207/252/345/252/222/344/275/223/347/237/245/350/257/206/345/272/223/SKILL.md

@@ -8,6 +8,8 @@ emoji: 🧠
 
 这个 Skill 负责使用 YuanFlow 的自媒体知识库原子能力。它和社媒数据采集、作品评论、作品下载是独立能力，不要混用接口。
 
+查询时，必须先明确用户具体需求，然后从知识库的一级能力开始，依次使用渐进式查询。不能跳级、跨越式查询。
+
 ## 环境判断
 
 1. 在 YuanFlow 主程序内，优先调用内置工具 `yuanflow_cli_call`。
@@ -25,6 +27,7 @@ emoji: 🧠
 - 自媒体文案、标题、内容改写。
 - 内容评分、复盘、优化建议。
 - 剪辑建议、发布策略、平台适配。
+- 视频剪辑策略、口播剪辑模板、短视频带货剪辑模板、EDL 校验和基础渲染规则。
 
 当前公开方向包括：
 
@@ -37,6 +40,7 @@ emoji: 🧠
 - `title_generation`：标题生成。
 - `rewrite`：内容改写。
 - `editing_strategy`：剪辑建议。
+- `video_editing_strategy`：视频剪辑策略。
 - `publishing_strategy`：发布策略。
 
 ## 推荐流程

package/skills/yuanflow-skill//350/247/206/351/242/221/346/212/225/346/265/201/347/255/226/347/225/245/SKILL.md

@@ -46,6 +46,7 @@ emoji: 📈
    - 如果没有命中，说明“未发现可用历史参考记录”，继续下一步。
 5. 调用 `自媒体知识库`。
    - 先查 `knowledge docs` 或 `knowledge entry`，根据平台、投放目标、预算、人群和素材类型构造 `domain` 和 `content_goal`。
+   - 查询时，必须先明确用户具体需求，然后从知识库的一级能力开始，依次使用渐进式查询。不能跳级、跨越式查询。
    - 按返回的 `next_actions` 分层查看 `packs`、`rules` 或 `rule-detail`，直到拿到足够的方法摘要。
    - 不要自己拼 SQL，不要跳过知识库直接凭空输出。
 6. 结合用户要求、账号最近 5 条视频数据、历史参考记录和知识库结果，输出视频投流策略。