yuanflow-cli 0.1.36 → 0.1.39

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 源码。
 
 ## 安装
 
@@ -43,6 +44,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
 ```
 
@@ -131,6 +135,25 @@ Agent 应先查看 `knowledge docs`，再把用户需求整理成 `task_frame`
 
 `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` 命令执行。第一版人工测试流程是：查询规则包、保存策略快照、扫描素材、导入文案、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 transcribe --project "D:\素材\yuanflow-video-edit" --script-file "D:\素材\口播文案.txt" --format agent-json
+yuanflow-cli video timeline --project "D:\素材\yuanflow-video-edit" --fps 1 --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
+```
+
+`--template-type` 当前支持 `talking_head` 和 `short_video_sales`。知识库查询由 `knowledge` 命令负责，`video` 命令只导入规则结果并保存 `strategy_snapshot.json`，不直接远程查规则库。
+
 ### 业务创作类 Skill
 
 以下业务 Skill 随 npm 包一起安装，统一流程是：先检查 `个人创作库` 是否有对应历史参考记录，再调用 `自媒体知识库` 按 `next_actions` 分层查询方法摘要，最后结合用户要求输出结果。输出后会询问用户是否满意、是否记录到个人创作库，并询问是否需要生成 HTML 可视化汇总。

package/package.json

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

package/skills/yuanflow-skill/HTML/346/212/245/345/221/212/347/224/237/346/210/220/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: HTML报告生成
 description: 当用户需要把自媒体分析、数据复盘、文案方案、账号监控、知识梳理、执行计划等内容生成可直接打开阅读的单页 HTML 报告时使用本技能。优先使用内置 9 种单页报告模板，并按内容选择报告形态、视觉主题和结构化字段。
+emoji: 🧾
 ---
 
 # HTML 报告生成

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

@@ -1,6 +1,7 @@
 ---
 name: IP运营
 description: 当用户需要设计个人或品牌 IP 的内容运营节奏、栏目组合、互动策略、增长路径，或诊断 IP 运营卡点时使用。
+emoji: 🪪
 ---
 
 # IP运营

package/skills/yuanflow-skill/OSS/346/226/207/344/273/266/344/270/255/350/275/254/345/267/245/345/205/267/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: OSS文件中转工具
 description: 当用户需要把本地文件上传到 YuanFlow 临时 OSS、生成对象签名访问链接、复制 OSS 对象，或为自媒体工作流准备图片、音频、视频、文档中转链接时使用。
+emoji: 🔗
 ---
 
 # OSS 文件中转工具

package/skills/yuanflow-skill/README.md

@@ -11,6 +11,7 @@ YuanFlow Skill 是 `yuanflow-cli` 的 Agent Skill 仓库，用于把社媒平台
 - `生图技能/`：图片生成与编辑 Skill，优先走 YuanFlow 内置 `yuanflow_image_request`。
 - `公众号生成与发布/`：公众号文章创作、主题预览、微信内联 HTML 排版、正文图片上传和草稿箱推送 Skill。
 - `小红书运营与发布/`：小红书选题调研、笔记搜索、账号分析、评论采集、文案创作、图文/视频发布和互动操作 Skill。
+- `视频智能剪辑/`：主音频 + B-roll 素材智能剪辑 Skill，先查自媒体知识库的视频剪辑策略，保存 `strategy_snapshot.json`，再按 1 秒 1 帧抽帧，由 Agent 生成 `timeline_plan` 和 EDL，交给 `yuanflow-cli video` 校验和渲染。
 - `HTML报告生成/`：单页 HTML 报告生成 Skill，内置 9 种米色留白报告模板。
 - `本地音视频转文字/`：本地 SenseVoice 音视频转文字 Skill，首次明确使用时按需下载模型。
 - `音视频在线转文字/`：通过 YuanFlow 在线 ASR 接口把音频或视频转成干净文本，视频会先抽取音频并通过 OSS 中转。
@@ -24,6 +25,7 @@ YuanFlow Skill 是 `yuanflow-cli` 的 Agent Skill 仓库，用于把社媒平台
 - `文案创作/`：先查历史文案和表达资产，再结合自媒体知识库输出文案。
 - `视频投流策略/`：先查历史发布和投放复盘，再结合自媒体知识库输出视频投流策略。
 - `直播投流策略/`：先查历史直播和投放复盘，再结合自媒体知识库输出直播投流策略。
+- `飞书官方技能/`：通过 YuanFlow 受控工具托管安装并调用飞书官方 `@larksuite/cli`，用于飞书文档、表格、多维表格、日历、邮箱、任务、通讯录、即时消息、知识库和 OpenAPI 等办公任务。
 
 ## 适用场景
 
@@ -36,12 +38,14 @@ YuanFlow Skill 是 `yuanflow-cli` 的 Agent Skill 仓库，用于把社媒平台
 - 把自媒体分析、数据复盘、文案方案、账号监控、知识梳理和执行计划生成可直接打开的单页 HTML 报告。
 - 生成或改写公众号文章，进入主题选择预览后导出微信公众号编辑器可粘贴 HTML，或推送到公众号草稿箱。
 - 处理小红书单段或全流程任务，例如只写文案、只采集笔记、只分析账号、只采集评论、只做点赞收藏评论回复，或完整执行图文/视频发布流程；每轮开始前必须明确任务边界。
+- 在用户要求智能剪辑、自动剪辑、主音频匹配 B-roll、重排视频画面或生成剪辑预览时，使用视频智能剪辑 Skill；第一版先查规则库，导入策略快照，抽帧频率固定 1 秒 1 帧，由 Agent 看抽帧图生成 `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 源码。
 
 ## 双环境使用方式
 
@@ -112,6 +116,8 @@ yuanflow-skill list-skills
 ├─ 小红书运营与发布
 │  ├─ SKILL.md
 │  └─ references/
+├─ 视频智能剪辑
+│  └─ SKILL.md
 ├─ HTML报告生成
 │  ├─ SKILL.md
 │  ├─ templates/

package/skills/yuanflow-skill/SKILL.md

@@ -23,6 +23,7 @@ description: 当用户需要处理自媒体平台接口工作流、平台数据
 - `生图技能/`
 - `公众号生成与发布/`
 - `小红书运营与发布/`
+- `视频智能剪辑/`
 - `HTML报告生成/`
 - `本地音视频转文字/`
 - `音视频在线转文字/`
@@ -36,6 +37,7 @@ description: 当用户需要处理自媒体平台接口工作流、平台数据
 - `文案创作/`
 - `视频投流策略/`
 - `直播投流策略/`
+- `飞书官方技能/`
 
 ## 环境判断
 
@@ -154,6 +156,7 @@ description: 当用户需要处理自媒体平台接口工作流、平台数据
 | 账号人设、内容边界、目标受众、价值主张、栏目方向 | `帐号定位` |
 | 选题池、系列选题、热点选题、选题优先级排序 | `选题策划` |
 | 小红书、公众号、朋友圈、短视频口播、直播预告、海报或转化型文案 | `文案创作` |
+| 主音频匹配 B-roll、自动剪辑、重排画面、生成剪辑预览或成片 | `视频智能剪辑` |
 | 短视频、图文视频或内容素材的投流目标、人群、预算、素材分层、测试节奏 | `视频投流策略` |
 | 直播间、直播预热、直播引流、直播成交的投放人群、预算、素材、节奏和复盘 | `直播投流策略` |
 

package/skills/yuanflow-skill/yuanflow-cli/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: YuanFlow原子接口工具
 description: 当用户需要通过 YuanFlow CLI 调用自媒体平台原子接口时使用，包括抖音、小红书、Bilibili、微信视频号、微信公众号、TikTok、YouTube、微博、知乎、Instagram、Twitter/X、Reddit 等平台的数据查询、命令发现、参数结构查看、dry-run 预检和稳定 agent-json 输出。
+emoji: ⚙️
 ---
 
 # YuanFlow CLI

package/skills/yuanflow-skill//344/270/252/344/272/272/345/210/233/344/275/234/345/272/223/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: 个人创作库
 description: 当用户要求保存、归档、整理、沉淀、复盘、回看、复用自媒体创作成果，或明确说“加入个人创作库”“保存到创作库”“整理我的历史作品/脚本/文案/选题/标题/发布复盘”时使用。本 Skill 只负责收集和维护用户已经认可的合格产出物，不替代选题、文案、脚本、生图、帐号监控等从 0 到 1 的创作能力。
+emoji: 🗂️
 ---
 
 # 个人创作库
@@ -152,4 +153,3 @@ config.managed_skill_dir
 ```
 
 在没有明确用户授权前，不要删除、覆盖或批量移动用户已有创作资料。
-

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

@@ -1,6 +1,7 @@
 ---
 name: 公众号生成与发布
 description: 当用户需要公众号文章创作、文章改写、Markdown 排版、主题预览、HTML 导出或推送到微信公众号草稿箱时使用。
+emoji: 📰
 ---
 
 # 公众号生成与发布

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

@@ -1,6 +1,7 @@
 ---
 name: 小红书运营与发布
 description: 当用户需要小红书选题调研、文案创作、笔记搜索、账号分析、评论采集、图文或视频发布、点赞收藏评论回复等小红书运营任务时使用。
+emoji: 📕
 ---
 
 # 小红书运营与发布
@@ -16,11 +17,12 @@ description: 当用户需要小红书选题调研、文案创作、笔记搜索
 1. 本轮任务边界：只做调研、只写文案、只采集、只分析账号、只互动、只发布，还是完整流程。
 2. 目标对象：关键词、笔记链接、笔记 ID、账号主页、用户 ID、本地图片、本地视频或已有文案。
 3. 是否需要真实执行写操作：发布、评论、回复、点赞、收藏都属于写操作。
-4. 发布确认策略：
+4. 是否涉及封面或正文插图：如果需要生成封面或插图，必须使用 `生图技能`，并先和用户确认图片比例是 4:3 还是 3:4；用户已明确给出比例时直接采用。
+5. 发布确认策略：
    - 默认每次真实发布前必须向用户确认。
    - 如果用户明确说“后续都自动直接发布”“这个账号以后不用重复问”，可以把该偏好作为用户记忆；后续同类任务不重复确认，但仍需在执行结果里说明已按用户记忆自动执行。
-5. 评论和回复默认必须确认；点赞、收藏可按用户明确指令直接执行。
-6. 登录态使用 YuanFlow 独立浏览器配置，不要求用户复用默认 Chrome，不读取用户默认浏览器 Cookie。
+6. 评论和回复默认必须确认；点赞、收藏可按用户明确指令直接执行。
+7. 登录态使用 YuanFlow 独立浏览器配置，不要求用户复用默认 Chrome，不读取用户默认浏览器 Cookie。
 
 ## 能力分流
 
@@ -29,7 +31,8 @@ description: 当用户需要小红书选题调研、文案创作、笔记搜索
 | 搜索笔记、找素材、查热点 | 使用小红书搜索能力，必要时读取笔记详情 |
 | 账号分析、竞品分析 | 搜索用户或读取用户主页，再采集近期笔记 |
 | 评论采集、用户反馈分析 | 使用评论采集能力，必要时继续采集二级评论 |
-| 写小红书文案 | 先确认产品、受众、风格、字数、是否需要图片，再创作文案 |
+| 写小红书文案 | 先确认产品、受众、风格、字数、是否需要图片，再查知识库写作方法论，最后创作文案 |
+| 生成封面、正文插图 | 先确认画面用途和 4:3 / 3:4 比例，再使用生图技能生成 |
 | 发布图文笔记 | 检查标题、正文、图片、话题、可见性、账号登录态，再发布 |
 | 发布视频笔记 | 检查标题、正文、视频、封面、话题、可见性、账号登录态，再发布 |
 | 点赞、收藏、评论、回复 | 先确认目标笔记和动作，评论/回复需确认具体文本 |
@@ -84,14 +87,23 @@ yuanflow-cli browser dry-run --platform xiaohongshu --task publish --title "标
 
 1. 先确认任务边界：只写标题、只写正文、标题+正文、发布版笔记、种草文案、测评文案、探店文案、合集文案或完整发布流程。
 2. 确认账号定位、目标用户、产品/主题、语气风格、禁忌表达、字数范围、是否需要话题标签。
-3. 如果用户要求参考平台趋势，先采集或搜索同类笔记，再创作。
-4. 输出小红书文案时默认包含：
+3. 写任何小红书文案前，必须先使用 `自媒体知识库` 查找并参考对应写作方法论，例如选题、标题、钩子、种草、测评、探店、合集、转化或发布策略；不要跳过知识库直接凭空输出文案。
+4. 如果用户要求参考平台趋势，先采集或搜索同类笔记，再结合知识库方法论创作。
+5. 输出小红书文案时默认包含：
    - 标题候选
    - 正文
    - 话题标签
    - 配图建议
    - 发布注意事项
-5. 用户只要求“写文案”时，不擅自进入发布流程。
+6. 用户只要求“写文案”时，不擅自进入发布流程。
+
+## 封面和插图生成流程
+
+1. 遇到封面、首图、正文插图、配图、图片素材等生成需求时，必须使用 `生图技能`。
+2. 生图前先确认图片比例：4:3 或 3:4。用户未说明时必须追问；用户已说明时直接采用。
+3. 生成封面时先确认用途：发布封面、正文首图、对比图、清单图、测评图或场景图。
+4. 生成正文插图时先确认插入位置：开头、痛点段、步骤段、案例段、总结段或用户指定段落。
+5. 提示词应围绕中文小红书语境、目标人群和内容主题规划；如需要图中文字，默认使用清晰简体中文，不要生成英文文字，除非用户明确要求英文或双语。
 
 ## 发布流程
 
@@ -100,8 +112,11 @@ 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. 任务完整结束后可以询问用户对结果是否满意；如果用户明确表示满意，可将最终结果、素材路径、关键制作流程、发布前检查结论保存到 `个人创作库`，便于后续复用。
 
 ### 视频笔记
 
@@ -144,4 +159,3 @@ yuanflow-cli browser dry-run --platform xiaohongshu --task publish --title "标
 - 把小红书 MCP 当成独立安装项使用。
 - 未经确认就评论或回复。
 - 采集结果直接粘 JSON，没有做归纳。
-

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

@@ -1,6 +1,7 @@
 ---
 name: 帐号定位
 description: 当用户需要梳理账号人设、内容边界、目标受众、价值主张、栏目方向、商业化路径或账号转型时使用。
+emoji: 🧭
 ---
 
 # 帐号定位

package/skills/yuanflow-skill//345/270/220/345/217/267/347/233/221/346/216/247/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: 帐号监控
 description: 当用户需要监控或研究抖音、小红书、微博、知乎、Bilibili、TikTok、YouTube、Twitter/X 等平台的账号、创作者、频道、博主、竞品主页或账号首页时使用，覆盖账号搜索、主页详情、主页作品、历史快照、指标对比和可选 HTML 可视化。
+emoji: 📊
 ---
 
 # 帐号监控

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

@@ -1,6 +1,7 @@
 ---
 name: 文案创作
 description: 当用户需要生成、改写、润色或重组小红书、公众号、朋友圈、短视频口播、直播预告、海报或转化型文案时使用。
+emoji: ✍️
 ---
 
 # 文案创作

package/skills/yuanflow-skill//346/234/254/345/234/260/351/237/263/350/247/206/351/242/221/350/275/254/346/226/207/345/255/227/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: 本地音视频转文字
 description: 仅当用户明确要求使用本地音视频转文字、本地转写、本地 ASR、离线/本地模型把音频或视频转成文字时使用；不要因为用户普通提到音频、视频、文案或总结就自动使用。
+emoji: 🎙️
 ---
 
 # 本地音视频转文字

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

@@ -1,6 +1,7 @@
 ---
 name: 生图技能
 description: 当用户要求生成图片、画图、出图、制作海报或视觉素材、编辑图片、修改本地图片，或调用 YuanFlow 图片生成/图片编辑接口时使用。
+emoji: 🎨
 ---
 
 # 生图技能

package/skills/yuanflow-skill//347/233/264/346/222/255/346/212/225/346/265/201/347/255/226/347/225/245/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: 直播投流策略
 description: 当用户需要为直播间、直播预热、直播引流、直播成交或直播间投放制定人群、预算、素材、节奏和复盘策略时使用。
+emoji: 📡
 ---
 
 # 直播投流策略

package/skills/yuanflow-skill//347/233/264/346/222/255/350/257/235/346/234/257/347/224/237/346/210/220/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: 直播话术生成
 description: 当用户需要生成直播开场、留人、转场、成交、互动、控场或直播节奏话术脚本时使用。
+emoji: 🎤
 ---
 
 # 直播话术生成

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

@@ -1,6 +1,7 @@
 ---
 name: 自媒体知识库
 description: 当用户需要做自媒体选题、开头钩子、脚本、文案、标题、改写、评分、剪辑建议、发布策略，或明确要求查询 YuanFlow 自媒体知识库时使用。
+emoji: 🧠
 ---
 
 # 自媒体知识库
@@ -24,6 +25,7 @@ description: 当用户需要做自媒体选题、开头钩子、脚本、文案
 - 自媒体文案、标题、内容改写。
 - 内容评分、复盘、优化建议。
 - 剪辑建议、发布策略、平台适配。
+- 视频剪辑策略、口播剪辑模板、短视频带货剪辑模板、EDL 校验和基础渲染规则。
 
 当前公开方向包括：
 
@@ -36,6 +38,7 @@ description: 当用户需要做自媒体选题、开头钩子、脚本、文案
 - `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

@@ -1,6 +1,7 @@
 ---
 name: 视频投流策略
 description: 当用户需要为短视频、图文视频或内容素材制定投流目标、人群、预算、素材分层、测试节奏和数据调整策略时使用。正式制定前必须先确认投流账号主页 URL，并通过帐号监控采集该账号最近 5 条视频完整数据作为策略依据。
+emoji: 📈
 ---
 
 # 视频投流策略