yuanflow-cli 0.1.21 → 0.1.23

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

@@ -0,0 +1,241 @@
+---
+name: 自媒体浏览器自动化
+description: Use when the user asks to automate self-media platform browser work such as Douyin, Xiaohongshu, Weibo, Bilibili, TikTok, YouTube, or Twitter/X account login-state management, Cookie/profile storage, profile/page collection, creator account data browsing, draft creation, or publishing works. Do not use for ordinary web browsing, general search, or screenshots.
+tags:
+  - browser-automation
+  - self-media
+  - profile
+  - cookie
+emoji: 🧭
+---
+
+# 自媒体浏览器自动化
+
+本 Skill 只用于自媒体平台的专用浏览器自动化：账号登录态隔离、Cookie/profile 本地保存、账号资料浏览采集、作品页面收集、草稿创建、作品发布前检查和发布执行。
+
+不要把它和 YuanFlow 已有的通用浏览器能力混在一起：
+
+- `浏览器启动模式`：通用网页浏览、打开页面、可见窗口、普通搜索。
+- `浏览器CDP`：连接已有 Chrome、扫描 CDP 端口、共享浏览器实例。
+- `自媒体浏览器自动化`：面向抖音、小红书、微博、Bilibili、TikTok、YouTube、Twitter/X 等平台的账号和发布流程。
+
+普通网页搜索、资料查询、截图、打开页面，不使用本 Skill。只有任务涉及自媒体平台账号、登录态、平台页面采集、Cookie/profile、作品发布或草稿保存时，才使用本 Skill。
+
+## 调用优先级
+
+在 YuanFlow 主程序内，优先调用受控工具：
+
+```json
+{
+  "action": "task-plan",
+  "platform": "douyin",
+  "task": "publish",
+  "account": "main"
+}
+```
+
+如果当前 Agent 没有 `yuanflow_browser_automation`，再使用 `yuanflow_cli_call` 调用托管 CLI：
+
+```json
+{
+  "args": [
+    "browser",
+    "task-plan",
+    "--platform",
+    "douyin",
+    "--task",
+    "publish",
+    "--account",
+    "main",
+    "--format",
+    "agent-json"
+  ]
+}
+```
+
+外部命令：
+
+```powershell
+yuanflow-cli browser task-plan --platform douyin --task publish --account main --format agent-json
+```
+
+## 固定边界
+
+- Cookie、localStorage、sessionStorage、浏览器 profile 只保存在本地受控目录，不上传、不输出、不写入报告。
+- 扫码、验证码、人机验证、二次验证、风控提醒，必须暂停并让用户手动处理。
+- 发布、删除、修改账号资料、提交草稿、定时发布等会改变线上状态的动作，必须先向用户复述并等待确认。
+- 不做绕过验证码、绕过风控、刷量、批量骚扰、未授权采集或平台禁止的自动化。
+- 不直接调用 shell 执行裸 Playwright、Chrome 调试命令或读取浏览器敏感目录；优先走受控工具。
+
+## 支持平台
+
+当前受控协议支持：
+
+| 平台参数 | 平台 |
+| --- | --- |
+| `douyin` | 抖音 |
+| `xiaohongshu` | 小红书 |
+| `weibo` | 微博 |
+| `bilibili` | Bilibili |
+| `tiktok` | TikTok |
+| `youtube` | YouTube |
+| `twitter` | Twitter/X |
+
+## 本地目录
+
+默认本地根目录：
+
+```text
+%APPDATA%\YuanFlow\runtime_tools\browser-automation
+```
+
+单账号目录：
+
+```text
+%APPDATA%\YuanFlow\runtime_tools\browser-automation\accounts\<platform>\<account>
+```
+
+关键子目录：
+
+```text
+profile      浏览器 profile
+cookies      Cookie 状态文件目录，仅保存本地，不输出值
+tasks        任务预检、草稿、发布记录
+snapshots    页面采集和帐号快照
+downloads    浏览器下载文件
+```
+
+## 常用命令
+
+查看 profile 和 Cookie 路径：
+
+```json
+{
+  "args": [
+    "browser",
+    "profile-path",
+    "--platform",
+    "douyin",
+    "--account",
+    "main",
+    "--format",
+    "agent-json"
+  ]
+}
+```
+
+初始化账号目录：
+
+```json
+{
+  "args": [
+    "browser",
+    "session-init",
+    "--platform",
+    "xiaohongshu",
+    "--account",
+    "main",
+    "--format",
+    "agent-json"
+  ]
+}
+```
+
+查看 Cookie/profile 规则：
+
+```json
+{
+  "args": [
+    "browser",
+    "cookie-policy",
+    "--platform",
+    "douyin",
+    "--account",
+    "main",
+    "--format",
+    "agent-json"
+  ]
+}
+```
+
+生成发布任务计划：
+
+```json
+{
+  "args": [
+    "browser",
+    "task-plan",
+    "--platform",
+    "douyin",
+    "--task",
+    "publish",
+    "--account",
+    "main",
+    "--format",
+    "agent-json"
+  ]
+}
+```
+
+预检发布参数：
+
+```json
+{
+  "args": [
+    "browser",
+    "dry-run",
+    "--platform",
+    "xiaohongshu",
+    "--task",
+    "publish",
+    "--account",
+    "main",
+    "--file",
+    "D:\\media\\post.mp4",
+    "--title",
+    "标题",
+    "--caption",
+    "正文",
+    "--cover",
+    "D:\\media\\cover.png",
+    "--format",
+    "agent-json"
+  ]
+}
+```
+
+## 任务流程
+
+### 登录或保存登录态
+
+1. 先执行 `profile-path` 或 `session-init` 获取账号目录。
+2. 使用该账号专属 profile 打开平台登录页。
+3. 遇到扫码、验证码或风控，暂停并让用户手动处理。
+4. 登录完成后只报告“已保存本地登录态”和 profile 路径，不输出 Cookie 内容。
+
+### 账号资料或页面采集
+
+1. 确认平台、帐号别名、采集目标 URL 或账号标识。
+2. 使用 `task-plan --task collect` 或 `task-plan --task account_snapshot` 获取计划。
+3. 只采集公开可见页面信息、页面文本、作品列表和必要截图。
+4. 保存到 `snapshots` 目录，后续可与历史快照对比。
+
+### 作品发布
+
+1. 发布前必须确认平台、帐号、素材、标题、正文、封面、话题、发布时间。
+2. 先执行 `dry-run --task publish` 检查缺失项。
+3. 打开发布入口并填写内容。
+4. 到最终发布按钮前暂停，复述即将发布的内容。
+5. 用户确认后再点击最终发布或保存草稿。
+6. 记录发布结果、作品链接或失败原因到 `tasks` 目录。
+
+## 输出要求
+
+最终回复要简短说明：
+
+- 使用的平台和帐号别名。
+- 本次任务类型。
+- profile、任务记录或快照保存路径。
+- 是否需要用户手动处理登录、验证码、风控或最终发布确认。
+
+失败时说明卡在哪一步、调用了什么受控命令、返回的 `error.code` 和 `error.message`。不要泄露 token、Authorization header、Cookie、localStorage 或 sessionStorage。

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

@@ -105,3 +105,13 @@ yuanflow-cli knowledge rules \
 - v2 接口不要求 `task_intent`；旧字段只作为兼容字段，不要在新调用里默认填写。
 - `packs`、`rules` 的 `data` 可能直接是数组，不要假设固定 `{ packs: [] }` 或 `{ rules: [] }` 结构。
 - 如果用户只是在问“有什么知识库方向”，先用 `knowledge docs`。
+
+## HTML 可视化
+
+完成知识库查询、内容创作、评估或策略输出后，必须询问：
+
+```text
+是否需要我把本次方案生成 HTML 可视化汇总？
+```
+
+只有用户明确确认后，才读取并使用 `HTML报告生成` Skill。不要默认生成 HTML。

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

@@ -0,0 +1,53 @@
+---
+name: 视频投流策略
+description: 当用户需要为短视频、图文视频或内容素材制定投流目标、人群、预算、素材分层、测试节奏和数据调整策略时使用。
+---
+
+# 视频投流策略
+
+本 Skill 用于制定视频内容投流策略。执行时必须先查历史资产，再查自媒体知识库，最后结合用户本次目标输出可执行投放方案。
+
+## 固定流程
+
+1. 先读取 `个人创作库`。
+   - 优先检查 `library/publishing-plans/`、`library/performance-reviews/`、`library/best-works/`、`library/topics/`、`library/copywriting/`。
+   - 如果发现历史投放计划、发布复盘、表现好的素材、选题或转化文案，标记为“历史参考记录”。
+   - 如果没有命中，说明“未发现可用历史参考记录”，继续下一步。
+2. 调用 `自媒体知识库`。
+   - 先查 `knowledge docs` 或 `knowledge entry`，根据平台、投放目标、预算、人群和素材类型构造 `domain` 和 `content_goal`。
+   - 按返回的 `next_actions` 分层查看 `packs`、`rules` 或 `rule-detail`，直到拿到足够的方法摘要。
+   - 不要自己拼 SQL，不要跳过知识库直接凭空输出。
+3. 结合用户要求、历史参考记录和知识库结果，输出视频投流策略。
+4. 输出后询问用户是否满意，是否要记录到 `个人创作库`。
+
+## 核心拆解
+
+- 投放目标：曝光、涨粉、线索、成交或复购。
+- 目标人群：基础人群、兴趣人群、相似人群、重定向人群。
+- 预算区间：测试预算、放量预算、止损线。
+- 素材层级：主素材、变体素材、补充素材、淘汰素材。
+- 观察指标：播放、完播、互动、点击、留资、成交。
+- 调整节奏：观察周期、加预算条件、降预算条件、停投条件。
+
+## 输出要求
+
+- 优先按“目标 / 人群 / 素材 / 预算 / 指标 / 调整规则”输出。
+- 指标要和目标对应，不能乱配。
+- 如果没有预算信息，要明确写出“需补充预算区间”。
+- 不把自然流量逻辑和投流逻辑混为一谈。
+
+## 结尾固定询问
+
+输出完成后必须询问：
+
+```text
+这版视频投流策略是否满意？如果满意，我可以把本次结果整理并记录到个人创作库中。
+```
+
+同时询问：
+
+```text
+是否需要我把本次方案生成 HTML 可视化汇总？
+```
+
+只有用户明确确认后，才读取并使用 `个人创作库` 或 `HTML报告生成` Skill。不要默认写入或默认生成 HTML。

package/skills/yuanflow-skill//351/200/211/351/242/230/347/255/226/345/210/222/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: 选题策划
+description: 当用户需要围绕目标受众、账号定位、内容目标、热点或系列方向产出选题池并排序优先级时使用。
+---
+
+# 选题策划
+
+本 Skill 用于产出选题池、系列选题和选题优先级。执行时必须先查历史资产，再查自媒体知识库，最后结合用户本次目标输出可执行选题。
+
+## 固定流程
+
+1. 先读取 `个人创作库`。
+   - 优先检查 `library/topics/`、`library/titles/`、`library/account-positioning/`、`library/performance-reviews/`、`library/best-works/`。
+   - 如果发现历史选题、标题、账号定位、爆款复盘或表现好的内容，标记为“历史参考记录”。
+   - 如果没有命中，说明“未发现可用历史参考记录”，继续下一步。
+2. 调用 `自媒体知识库`。
+   - 先查 `knowledge docs` 或 `knowledge entry`，根据平台、受众、内容目标和选题方向构造 `domain` 和 `content_goal`。
+   - 按返回的 `next_actions` 分层查看 `packs`、`rules` 或 `rule-detail`，直到拿到足够的方法摘要。
+   - 不要自己拼 SQL，不要跳过知识库直接凭空输出。
+3. 结合用户要求、历史参考记录和知识库结果，输出选题策划结果。
+4. 输出后询问用户是否满意，是否要记录到 `个人创作库`。
+
+## 标准产出
+
+- 选题标题。
+- 选题意图。
+- 适配平台。
+- 建议形式。
+- 适配人群。
+- 为什么值得做。
+- 优先级。
+
+## 输出要求
+
+- 至少区分“高优先级 / 中优先级 / 储备”。
+- 对每个选题说明面向什么人、解决什么问题。
+- 如果用户只给了模糊方向，要先把方向拆开再出选题。
+- 不只给标题，不把热点堆砌成无差别清单。
+
+## 结尾固定询问
+
+输出完成后必须询问：
+
+```text
+这组选题是否满意？如果满意，我可以把本次结果整理并记录到个人创作库中。
+```
+
+同时询问：
+
+```text
+是否需要我把本次方案生成 HTML 可视化汇总？
+```
+
+只有用户明确确认后，才读取并使用 `个人创作库` 或 `HTML报告生成` Skill。不要默认写入或默认生成 HTML。

package/src/agent-protocol.js

@@ -3,6 +3,7 @@ import { listShortcuts } from './shortcuts.js';
 import { listCommentCommands } from './comment-collector.js';
 import { listKnowledgeCommands } from './knowledge-tools.js';
 import { listOssCommands } from './oss-tools.js';
+import { listBrowserCommands } from './browser-tools.js';
 import { listSearchCommands, listWorkCommands } from './work-tools.js';
 
 const ERROR_MAP = [
@@ -105,6 +106,7 @@ export function buildCommandRegistry() {
   const searchCommands = listSearchCommands();
   const knowledgeCommands = listKnowledgeCommands();
   const ossCommands = listOssCommands();
+  const browserCommands = listBrowserCommands();
   return [
     ...shortcuts,
     ...endpoints,
@@ -113,6 +115,7 @@ export function buildCommandRegistry() {
     ...searchCommands,
     ...knowledgeCommands,
     ...ossCommands,
+    ...browserCommands,
   ].sort((left, right) => left.key.localeCompare(right.key));
 }