yuanflow-cli 0.1.22 → 0.1.23

package/README.md

@@ -41,6 +41,8 @@ yuanflow-cli douyin user-posts <sec_user_id> --count 20 --cursor 0 --format agen
 yuanflow-cli knowledge docs --format agent-json
 yuanflow-cli knowledge entry --output-format short_video_script --domain 自媒体运营 --content-goal "写一个创业者短视频选题" --target-audience 创业者 --format agent-json
 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 list douyin
 ```
 
@@ -153,6 +155,29 @@ yuanflow-cli oss copy --source-key temp/cover.png --target-key final/cover.png -
 
 上传本地文件前必须确认用户授权，不能上传密钥、cookie、账号凭据或隐私文件。
 
+### 自媒体浏览器自动化
+
+`browser` 命令是自媒体平台专用浏览器自动化协议，用于账号登录态隔离、Cookie/profile 本地保存、账号页面采集、作品发布前检查和发布流程规划。它不用于普通网页搜索、通用浏览、截图或 CDP 连接。
+
+当前命令只返回受控路径、任务计划和 dry-run 预检结果，不直接暴露裸 Playwright 或 Chrome 调试能力：
+
+```bash
+yuanflow-cli browser profile-path --platform douyin --account main --format agent-json
+yuanflow-cli browser session-init --platform xiaohongshu --account main --format agent-json
+yuanflow-cli browser cookie-policy --platform douyin --account main --format agent-json
+yuanflow-cli browser task-plan --platform douyin --task publish --account main --format agent-json
+yuanflow-cli browser dry-run --platform xiaohongshu --task publish --account main --file ./post.mp4 --title "标题" --caption "正文" --cover ./cover.png --format agent-json
+```
+
+支持平台：`douyin`、`xiaohongshu`、`weibo`、`bilibili`、`tiktok`、`youtube`、`twitter`。
+
+固定边界：
+
+- Cookie、localStorage、sessionStorage 和 profile 只保存在本地受控目录，不输出、不上传。
+- 扫码、验证码、人机验证、平台风控必须暂停并让用户手动处理。
+- 最终发布、删除、修改账号资料等线上状态变更前必须获得用户确认。
+- 普通网页浏览请使用 YuanFlow 通用浏览器能力，不使用本命令。
+
 ### 音视频在线转文字
 
 `音视频在线转文字` 随 npm 包安装到 Skill bundle，用于通过 YuanFlow 在线 ASR 接口把音频或视频转成干净文本。视频输入需要先用 ffmpeg 分离音频，再上传 OSS。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yuanflow-cli",
-  "version": "0.1.22",
+  "version": "0.1.23",
   "description": "YuanFlow API CLI and skill installer for supported AI coding agents.",
   "type": "module",
   "license": "MIT",

package/skills/yuanflow-skill/README.md

@@ -12,6 +12,7 @@ YuanFlow Skill 是 `yuanflow-cli` 的 Agent Skill 仓库，用于把社媒平台
 - `HTML报告生成/`：单页 HTML 报告生成 Skill，内置 9 种米色留白报告模板。
 - `本地音视频转文字/`：本地 SenseVoice 音视频转文字 Skill，首次明确使用时按需下载模型。
 - `音视频在线转文字/`：通过 YuanFlow 在线 ASR 接口把音频或视频转成干净文本，视频会先抽取音频并通过 OSS 中转。
+- `自媒体浏览器自动化/`：自媒体平台专用浏览器自动化 Skill，用于登录态隔离、Cookie/profile 本地保存、页面采集和作品发布流程。
 - `帐号监控/`：帐号搜索、主页资料、主页作品、历史快照、变化对比和 HTML 可视化分流 Skill。
 - `个人创作库/`：长期保存、整理、复盘和复用用户认可的自媒体合格产出物。
 - `IP运营/`：先查个人创作库历史记录，再结合自媒体知识库输出 IP 运营方案。
@@ -33,6 +34,7 @@ YuanFlow Skill 是 `yuanflow-cli` 的 Agent Skill 仓库，用于把社媒平台
 - 把自媒体分析、数据复盘、文案方案、账号监控、知识梳理和执行计划生成可直接打开的单页 HTML 报告。
 - 在用户明确要求本地转写时，把本地音频或视频转成文字；视频会先抽取音频，模型和缓存都保存在 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` 分层查询方法摘要。
@@ -108,6 +110,8 @@ yuanflow-skill list-skills
 │  └─ scripts/
 ├─ 音视频在线转文字
 │  └─ SKILL.md
+├─ 自媒体浏览器自动化
+│  └─ SKILL.md
 ├─ 个人创作库
 │  ├─ SKILL.md
 │  ├─ raw/

package/skills/yuanflow-skill/SKILL.md

@@ -24,6 +24,7 @@ description: Use when the user asks about social-media API workflows, platform d
 - `HTML报告生成/`
 - `本地音视频转文字/`
 - `音视频在线转文字/`
+- `自媒体浏览器自动化/`
 - `帐号监控/`
 - `个人创作库/`
 - `IP运营/`
@@ -180,7 +181,21 @@ description: Use when the user asks about social-media API workflows, platform d
 
 - `OSS文件中转工具`
 
-### 11. 走 `生图技能`
+### 11. 走 `自媒体浏览器自动化`
+
+遇到下面这些需求，优先进入这个子 Skill：
+
+- 自媒体平台浏览器自动化、账号登录态隔离、Cookie/profile 本地保存。
+- 抖音、小红书、微博、Bilibili、TikTok、YouTube、Twitter/X 的页面浏览采集、账号资料快照、作品发布、草稿保存或发布前检查。
+- 用户明确要求用浏览器完成自媒体平台登录、采集或发布。
+
+不要把它用于普通网页搜索、通用浏览、截图或 CDP 连接；这些仍交给 YuanFlow 原有通用浏览器能力。
+
+子 Skill 名称：
+
+- `自媒体浏览器自动化`
+
+### 12. 走 `生图技能`
 
 遇到下面这些需求，优先进入这个子 Skill：
 
@@ -192,7 +207,7 @@ description: Use when the user asks about social-media API workflows, platform d
 
 - `生图技能`
 
-### 12. 走 `HTML报告生成`
+### 13. 走 `HTML报告生成`
 
 遇到下面这些需求，优先进入这个子 Skill：
 
@@ -204,7 +219,7 @@ description: Use when the user asks about social-media API workflows, platform d
 
 - `HTML报告生成`
 
-### 13. 走 `个人创作库`
+### 14. 走 `个人创作库`
 
 遇到下面这些需求，优先进入这个子 Skill：
 
@@ -218,7 +233,7 @@ description: Use when the user asks about social-media API workflows, platform d
 
 - `个人创作库`
 
-### 14. 走 `本地音视频转文字`
+### 15. 走 `本地音视频转文字`
 
 只有当用户明确要求使用本地音视频转文字、本地转写、本地 ASR、离线转写或本地模型把音频/视频转成文字时，才进入这个子 Skill。
 
@@ -228,7 +243,7 @@ description: Use when the user asks about social-media API workflows, platform d
 
 - `本地音视频转文字`
 
-### 15. 走 `音视频在线转文字`
+### 16. 走 `音视频在线转文字`
 
 遇到下面这些需求，优先进入这个子 Skill：
 

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/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));
 }
 

package/src/browser-tools.js

@@ -0,0 +1,413 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+const SUPPORTED_PLATFORMS = {
+  douyin: {
+    label: '抖音',
+    domains: ['douyin.com'],
+    publishChecklist: ['视频文件', '标题/文案', '封面', '话题', '发布时间', '目标帐号'],
+  },
+  xiaohongshu: {
+    label: '小红书',
+    domains: ['xiaohongshu.com'],
+    publishChecklist: ['图片或视频', '标题', '正文', '话题', '发布时间', '目标帐号'],
+  },
+  weibo: {
+    label: '微博',
+    domains: ['weibo.com'],
+    publishChecklist: ['正文', '图片或视频', '话题', '发布时间', '目标帐号'],
+  },
+  bilibili: {
+    label: 'Bilibili',
+    domains: ['bilibili.com'],
+    publishChecklist: ['视频文件', '标题', '简介', '分区', '封面', '标签', '发布时间', '目标帐号'],
+  },
+  tiktok: {
+    label: 'TikTok',
+    domains: ['tiktok.com'],
+    publishChecklist: ['视频文件', 'caption', 'hashtags', 'schedule', 'target account'],
+  },
+  youtube: {
+    label: 'YouTube',
+    domains: ['youtube.com'],
+    publishChecklist: ['视频文件', '标题', '简介', '缩略图', '标签', '可见性', '发布时间', '目标频道'],
+  },
+  twitter: {
+    label: 'Twitter/X',
+    domains: ['x.com', 'twitter.com'],
+    publishChecklist: ['正文', '图片或视频', '话题', '发布时间', '目标帐号'],
+  },
+};
+
+const PLATFORM_ALIASES = {
+  抖音: 'douyin',
+  小红书: 'xiaohongshu',
+  xhs: 'xiaohongshu',
+  微博: 'weibo',
+  b站: 'bilibili',
+  哔哩哔哩: 'bilibili',
+  youtube: 'youtube',
+  油管: 'youtube',
+  x: 'twitter',
+  twitter: 'twitter',
+  推特: 'twitter',
+};
+
+const TASK_ALIASES = {
+  publish: 'publish',
+  发布: 'publish',
+  collect: 'collect',
+  采集: 'collect',
+  login: 'login',
+  登录: 'login',
+  account_snapshot: 'account_snapshot',
+  snapshot: 'account_snapshot',
+  帐号快照: 'account_snapshot',
+  账号快照: 'account_snapshot',
+};
+
+export function listBrowserCommands() {
+  const commonOptions = [
+    option('--platform', 'platform', true, '平台：douyin、xiaohongshu、weibo、bilibili、tiktok、youtube、twitter。'),
+    option('--account', 'account', false, '帐号别名，默认 main。只用于本地 profile/cookie 分区。'),
+    option('--format', 'format', false, 'Agent 调用建议传 agent-json。'),
+  ];
+  return [
+    {
+      key: 'browser.profile-path',
+      command: 'browser profile-path',
+      kind: 'browser-automation',
+      description: '返回自媒体平台专用浏览器 profile、cookie、任务缓存路径。',
+      method: 'LOCAL',
+      positionals: [],
+      options: commonOptions,
+      returns: '返回受控本地目录，不读取或输出 cookie 内容。',
+    },
+    {
+      key: 'browser.session-init',
+      command: 'browser session-init',
+      kind: 'browser-automation',
+      description: '初始化自媒体平台专用浏览器帐号目录和本地元数据。',
+      method: 'LOCAL',
+      positionals: [],
+      options: commonOptions,
+      returns: '创建 profile、cookies、tasks、snapshots 目录，并返回路径。',
+    },
+    {
+      key: 'browser.cookie-policy',
+      command: 'browser cookie-policy',
+      kind: 'browser-automation',
+      description: '返回自媒体平台 Cookie/profile 保存规则和敏感信息处理边界。',
+      method: 'LOCAL',
+      positionals: [],
+      options: commonOptions,
+      returns: '返回 Cookie 保存路径和隐私边界说明，不输出 Cookie 值。',
+    },
+    {
+      key: 'browser.task-plan',
+      command: 'browser task-plan',
+      kind: 'browser-automation',
+      description: '生成自媒体浏览器采集、帐号快照、登录或作品发布的受控执行计划。',
+      method: 'LOCAL',
+      positionals: [],
+      options: [
+        ...commonOptions,
+        option('--task', 'task', true, '任务：publish、collect、login、account_snapshot。'),
+        option('--target', 'target', false, '主页、作品或发布入口 URL。'),
+      ],
+      returns: '返回步骤、用户确认项、风控暂停点和可保存数据清单。',
+    },
+    {
+      key: 'browser.dry-run',
+      command: 'browser dry-run',
+      kind: 'browser-automation',
+      description: '预检一次自媒体浏览器自动化任务，不启动浏览器、不提交发布。',
+      method: 'LOCAL',
+      positionals: [],
+      options: [
+        ...commonOptions,
+        option('--task', 'task', true, '任务：publish、collect、login、account_snapshot。'),
+        option('--target', 'target', false, '主页、作品或发布入口 URL。'),
+        option('--file', 'file', false, '待发布素材路径，仅用于预检记录，不读取文件内容。'),
+        option('--title', 'title', false, '待发布标题。'),
+        option('--caption', 'caption', false, '待发布正文或 caption。'),
+        option('--cover', 'cover', false, '封面路径。'),
+      ],
+      returns: '返回预检结果和缺失确认项。',
+    },
+  ];
+}
+
+export function runBrowserCommand({ action, options }) {
+  const normalizedAction = normalizeAction(action);
+  if (normalizedAction === 'profile-path') {
+    return buildProfilePayload(options, { create: false });
+  }
+  if (normalizedAction === 'session-init') {
+    return buildSessionInitPayload(options);
+  }
+  if (normalizedAction === 'cookie-policy') {
+    return buildCookiePolicyPayload(options);
+  }
+  if (normalizedAction === 'task-plan') {
+    return buildTaskPlanPayload(options);
+  }
+  if (normalizedAction === 'dry-run') {
+    return buildDryRunPayload(options);
+  }
+  throw new Error('未知 browser 命令。用法：yuanflow-cli browser profile-path|session-init|cookie-policy|task-plan|dry-run');
+}
+
+function option(flag, name, required, label) {
+  return { flag, name, required, label };
+}
+
+function normalizeAction(action) {
+  return String(action || 'profile-path').trim().toLowerCase();
+}
+
+function normalizePlatform(value) {
+  const raw = String(value || '').trim();
+  const lowered = raw.toLowerCase();
+  const platform = PLATFORM_ALIASES[raw] || PLATFORM_ALIASES[lowered] || lowered;
+  if (!platform) {
+    throw new Error('缺少 --platform，例如 douyin、xiaohongshu、bilibili。');
+  }
+  if (!SUPPORTED_PLATFORMS[platform]) {
+    throw new Error(`不支持的平台：${raw}。当前支持：${Object.keys(SUPPORTED_PLATFORMS).join(', ')}`);
+  }
+  return platform;
+}
+
+function normalizeTask(value) {
+  const raw = String(value || '').trim();
+  const lowered = raw.toLowerCase();
+  const task = TASK_ALIASES[raw] || TASK_ALIASES[lowered] || lowered;
+  if (!task) {
+    throw new Error('缺少 --task，例如 publish、collect、login、account_snapshot。');
+  }
+  if (!['publish', 'collect', 'login', 'account_snapshot'].includes(task)) {
+    throw new Error(`不支持的 browser task：${raw}。`);
+  }
+  return task;
+}
+
+function safeSegment(value, fallback) {
+  const text = String(value || fallback || 'default').trim();
+  return text
+    .replace(/[<>:"/\\|?*\x00-\x1f]/g, '-')
+    .replace(/\s+/g, '-')
+    .slice(0, 80) || fallback;
+}
+
+function automationRoot() {
+  const configured = process.env.YUANFLOW_BROWSER_AUTOMATION_HOME;
+  if (configured) {
+    return path.resolve(configured);
+  }
+  const appData = process.env.APPDATA;
+  if (appData) {
+    return path.join(appData, 'YuanFlow', 'runtime_tools', 'browser-automation');
+  }
+  return path.join(os.homedir(), '.yuanflow', 'runtime_tools', 'browser-automation');
+}
+
+function buildPaths(options) {
+  const platform = normalizePlatform(options.named?.platform);
+  const account = safeSegment(options.named?.account || 'main', 'main');
+  const root = automationRoot();
+  const accountRoot = path.join(root, 'accounts', platform, account);
+  return {
+    platform,
+    platformLabel: SUPPORTED_PLATFORMS[platform].label,
+    account,
+    root,
+    accountRoot,
+    profileDir: path.join(accountRoot, 'profile'),
+    cookieFile: path.join(accountRoot, 'cookies', 'cookies.json'),
+    accountMetaFile: path.join(accountRoot, 'account.json'),
+    taskDir: path.join(accountRoot, 'tasks'),
+    snapshotDir: path.join(accountRoot, 'snapshots'),
+    downloadDir: path.join(accountRoot, 'downloads'),
+  };
+}
+
+function ensurePathSet(paths) {
+  for (const item of [
+    paths.profileDir,
+    path.dirname(paths.cookieFile),
+    paths.taskDir,
+    paths.snapshotDir,
+    paths.downloadDir,
+  ]) {
+    mkdirSync(item, { recursive: true });
+  }
+}
+
+function buildProfilePayload(options, { create }) {
+  const paths = buildPaths(options);
+  if (create && !options.dryRun) {
+    ensurePathSet(paths);
+  }
+  return {
+    type: 'self-media-browser-profile',
+    created: Boolean(create && !options.dryRun),
+    dryRun: Boolean(options.dryRun),
+    platform: paths.platform,
+    platform_label: paths.platformLabel,
+    account: paths.account,
+    paths,
+    boundaries: browserBoundaries(),
+  };
+}
+
+function buildSessionInitPayload(options) {
+  const payload = buildProfilePayload(options, { create: true });
+  if (!options.dryRun) {
+    writeFileSync(
+      payload.paths.accountMetaFile,
+      `${JSON.stringify(
+        {
+          platform: payload.platform,
+          platform_label: payload.platform_label,
+          account: payload.account,
+          updated_at: new Date().toISOString(),
+          note: 'YuanFlow self-media browser automation account metadata. Cookie values are not written here.',
+        },
+        null,
+        2,
+      )}\n`,
+      'utf8',
+    );
+  }
+  return payload;
+}
+
+function buildCookiePolicyPayload(options) {
+  const paths = buildPaths(options);
+  return {
+    type: 'self-media-cookie-policy',
+    platform: paths.platform,
+    platform_label: paths.platformLabel,
+    account: paths.account,
+    paths,
+    policy: [
+      'Cookie 和登录态只保存在本地受控 profile/cookies 目录。',
+      '不要在最终回复、日志、HTML 报告、截图说明或任务文件里输出 Cookie 值。',
+      '扫码、验证码、人机验证、风控二次确认必须暂停并让用户手动处理。',
+      '除非用户明确要求，不要上传 Cookie、localStorage、sessionStorage 或浏览器 profile。',
+      '普通网页浏览、搜索和截图不要使用本能力，应使用通用浏览器能力。',
+    ],
+    boundaries: browserBoundaries(),
+  };
+}
+
+function buildTaskPlanPayload(options) {
+  const paths = buildPaths(options);
+  const task = normalizeTask(options.named?.task);
+  const target = String(options.named?.target || '').trim();
+  return {
+    type: 'self-media-browser-task-plan',
+    platform: paths.platform,
+    platform_label: paths.platformLabel,
+    account: paths.account,
+    task,
+    target,
+    paths,
+    steps: buildTaskSteps({ platform: paths.platform, task, target }),
+    user_confirmation_required: confirmationItems(paths.platform, task),
+    pause_points: [
+      '登录二维码',
+      '短信/邮箱/设备二次验证',
+      '验证码或滑块',
+      '平台风控提醒',
+      '发布前最终确认按钮',
+      '任何可能修改线上帐号状态的动作',
+    ],
+    boundaries: browserBoundaries(),
+  };
+}
+
+function buildDryRunPayload(options) {
+  const plan = buildTaskPlanPayload(options);
+  const provided = {
+    file: options.named?.file || '',
+    title: options.named?.title || '',
+    caption: options.named?.caption || '',
+    cover: options.named?.cover || '',
+    target: options.named?.target || '',
+  };
+  const missing = plan.user_confirmation_required.filter((item) => {
+    if (item.includes('素材')) return !provided.file;
+    if (item.includes('标题')) return !provided.title;
+    if (item.includes('正文') || item.includes('文案') || item.includes('caption')) return !provided.caption;
+    if (item.includes('封面')) return !provided.cover;
+    return false;
+  });
+  return {
+    ...plan,
+    dryRun: true,
+    provided,
+    missing_confirmation_items: missing,
+    ready_for_execution: missing.length === 0,
+    note: 'dry-run 只做参数和流程预检，不启动浏览器、不读取素材、不提交发布。',
+  };
+}
+
+function buildTaskSteps({ platform, task, target }) {
+  const platformInfo = SUPPORTED_PLATFORMS[platform];
+  if (task === 'login') {
+    return [
+      `使用 ${platformInfo.label} 专用 profile 打开平台登录页。`,
+      '如出现扫码、验证码或二次验证，暂停并等待用户手动完成。',
+      '登录成功后只保存本地 profile/cookie 状态，不输出敏感字段。',
+      '记录帐号别名、平台和最后验证时间。',
+    ];
+  }
+  if (task === 'collect' || task === 'account_snapshot') {
+    return [
+      `使用 ${platformInfo.label} 专用 profile 打开目标页面${target ? `：${target}` : ''}。`,
+      '采集公开可见的帐号资料、页面文本、作品列表和页面状态。',
+      '需要滚动或翻页时按平台页面状态逐步执行，避免高频请求。',
+      '保存本地快照，后续用于变化对比。',
+    ];
+  }
+  return [
+    `使用 ${platformInfo.label} 专用 profile 打开创作/发布入口。`,
+    `发布前核对：${platformInfo.publishChecklist.join('、')}。`,
+    '填入素材、标题、正文、封面、话题和定时发布设置。',
+    '到达最终发布按钮前暂停，向用户复述发布内容并等待确认。',
+    '用户确认后再点击最终发布或保存草稿。',
+    '记录发布结果、作品链接或失败原因。',
+  ];
+}
+
+function confirmationItems(platform, task) {
+  if (task === 'publish') {
+    return SUPPORTED_PLATFORMS[platform].publishChecklist;
+  }
+  if (task === 'login') {
+    return ['平台', '帐号别名', '是否允许本地保存登录态'];
+  }
+  return ['平台', '帐号别名', '采集目标 URL 或帐号标识', '采集范围'];
+}
+
+function browserBoundaries() {
+  return {
+    use_for: [
+      '自媒体平台登录态隔离',
+      '账号资料和作品页面采集',
+      '账号信息快照保存',
+      '作品发布、草稿保存和发布前检查',
+    ],
+    not_for: [
+      '普通网页搜索',
+      '通用网页浏览或截图',
+      '绕过验证码、人机验证、平台风控',
+      '未授权抓取、批量骚扰、刷量或违规自动化',
+    ],
+    preferred_runtime_tool: 'yuanflow_browser_automation',
+    fallback_tool: 'yuanflow_cli_call browser ...',
+  };
+}

package/src/cli.js

@@ -19,6 +19,7 @@ import { findShortcut, listShortcuts } from './shortcuts.js';
 import { collectComments } from './comment-collector.js';
 import { getKnowledgeDocs, navigateKnowledge } from './knowledge-tools.js';
 import { copyObject, signedUrl, tempUpload } from './oss-tools.js';
+import { runBrowserCommand } from './browser-tools.js';
 import {
   getWorkDetail,
   getWorkDownload,
@@ -80,6 +81,11 @@ export async function main(argv) {
     return;
   }
 
+  if (command === 'browser') {
+    await handleBrowser(rest);
+    return;
+  }
+
   if (command === 'schema') {
     await handleSchema(rest);
     return;
@@ -380,6 +386,16 @@ async function handleOss(args) {
   });
 }
 
+async function handleBrowser(args) {
+  const { positionals, options } = parseOptions(args);
+  const [action = 'profile-path'] = positionals;
+  const result = runBrowserCommand({ action, options });
+  await outputResult(result, options, {
+    command: `browser ${action}`,
+    meta: { kind: 'self-media-browser-automation' },
+  });
+}
+
 async function handleGeneratedCommand(platform, args) {
   if (!getPlatforms().includes(platform)) {
     throw new Error(`未知平台：${platform}。可用平台：${getPlatforms().join(', ')}`);
@@ -549,10 +565,13 @@ function printHelp() {
   yuanflow-cli knowledge docs --dry-run
   yuanflow-cli knowledge entry --output-format short_video_script --domain 自媒体运营 --content-goal "写一个创业者短视频选题" --target-audience 创业者 --format agent-json
   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 list douyin
 
 说明：
   社媒请求调用 Yuan API 的 /social/*path；知识库和 OSS 原子能力调用 /api/* 或 /atomic/*。
+  browser 命令是自媒体平台专用浏览器自动化协议，只返回受控 profile/cookie/任务路径与执行计划，不用于普通网页搜索。
   需要鉴权的请求都会使用 Authorization: Bearer <token>。
   token 优先级：--token > YUANCHUANG_API_TOKEN > 本地 config.token。
   YuanFlow 主程序内使用时，token 由主程序认证系统注入，不需要手动配置。