yuanflow-cli 0.1.21 → 0.1.23

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 由主程序认证系统注入，不需要手动配置。