yuanflow-cli 0.1.24 → 0.1.26

package/README.md

@@ -159,6 +159,10 @@ yuanflow-cli oss copy --source-key temp/cover.png --target-key final/cover.png -
 
 `browser` 命令是自媒体平台专用浏览器自动化协议，用于账号登录态隔离、Cookie/profile 本地保存、账号页面采集、作品发布前检查和发布流程规划。它不用于普通网页搜索、通用浏览、截图或 CDP 连接。
 
+如果要做发布类任务，先优先用用户电脑里已有的 Chrome，第二优先用 Edge。两个都没有时，再提示用户安装给浏览器自动化用的 Chromium。不要把这件事说得太技术化，直接告诉用户“需要一个能给自动化程序用的浏览器”就够了。
+
+如果 Chromium 连续下载 3 次还是失败，就停止继续重试，明确告诉用户可能是网络、权限、下载源不可用或安全软件拦截，并引导用户手动下载和安装后再继续。
+
 当前命令只返回受控路径、任务计划和 dry-run 预检结果，不直接暴露裸 Playwright 或 Chrome 调试能力：
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yuanflow-cli",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "description": "YuanFlow API CLI and skill installer for supported AI coding agents.",
   "type": "module",
   "license": "MIT",
@@ -71,3 +71,5 @@
     "douyin"
   ]
 }
+
+

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

@@ -13,6 +13,13 @@ emoji: 🧭
 
 本 Skill 只用于自媒体平台的专用浏览器自动化：账号登录态隔离、Cookie/profile 本地保存、账号资料浏览采集、作品页面收集、草稿创建、作品发布前检查和发布执行。
 
+浏览器选择先后顺序要说清楚：
+
+- 先优先使用用户电脑里已经装好的 Chrome。
+- 没有 Chrome，再优先使用 Edge。
+- 如果这两个浏览器都没有，再提示用户安装“给浏览器自动化用的 Chromium”。
+- 这里说的 Chromium，不是让用户去学技术，而是让用户装一个能给自动化程序用的浏览器内核。
+
 不要把它和 YuanFlow 已有的通用浏览器能力混在一起：
 
 - `浏览器启动模式`：通用网页浏览、打开页面、可见窗口、普通搜索。
@@ -62,11 +69,20 @@ yuanflow-cli browser task-plan --platform douyin --task publish --account main -
 ## 固定边界
 
 - Cookie、localStorage、sessionStorage、浏览器 profile 只保存在本地受控目录，不上传、不输出、不写入报告。
+- Cookie/profile 的保存和浏览器品牌无关，始终按“平台 + 帐号别名”分开保存，不和用户日常浏览器混在一起。
 - 扫码、验证码、人机验证、二次验证、风控提醒，必须暂停并让用户手动处理。
 - 发布、删除、修改账号资料、提交草稿、定时发布等会改变线上状态的动作，必须先向用户复述并等待确认。
 - 不做绕过验证码、绕过风控、刷量、批量骚扰、未授权采集或平台禁止的自动化。
 - 不直接调用 shell 执行裸 Playwright、Chrome 调试命令或读取浏览器敏感目录；优先走受控工具。
 
+## 浏览器缺失与下载失败
+
+- 如果本机没有 Chrome 和 Edge，先直接告诉用户：这台电脑没有现成可用的浏览器，需要安装给自动化用的 Chromium。
+- 如果 Chromium 下载连续失败 3 次，就不要一直重试了，直接停下来，把问题说清楚。
+- 这时候要明确告诉用户，常见原因可能是网络、权限、下载源不可用或者安全软件拦截。
+- 同时给用户手动处理的简单步骤：先检查网络，再重新下载 Chromium；如果还是不行，就让用户手动安装后再继续。
+- 不要把这个问题说成账号问题，也不要只说“网络错误”就结束。
+
 ## 支持平台
 
 当前受控协议支持：
@@ -209,9 +225,10 @@ downloads    浏览器下载文件
 ### 登录或保存登录态
 
 1. 先执行 `profile-path` 或 `session-init` 获取账号目录。
-2. 使用该账号专属 profile 打开平台登录页。
-3. 遇到扫码、验证码或风控，暂停并让用户手动处理。
-4. 登录完成后只报告“已保存本地登录态”和 profile 路径，不输出 Cookie 内容。
+2. 先检查本机是否已有 Chrome，次选 Edge；只有都没有时，才提示用户安装 Chromium。
+3. 使用该账号专属 profile 打开平台登录页。
+4. 遇到扫码、验证码或风控，暂停并让用户手动处理。
+5. 登录完成后只报告“已保存本地登录态”和 profile 路径，不输出 Cookie 内容。
 
 ### 账号资料或页面采集
 
@@ -224,10 +241,11 @@ downloads    浏览器下载文件
 
 1. 发布前必须确认平台、帐号、素材、标题、正文、封面、话题、发布时间。
 2. 先执行 `dry-run --task publish` 检查缺失项。
-3. 打开发布入口并填写内容。
-4. 到最终发布按钮前暂停，复述即将发布的内容。
-5. 用户确认后再点击最终发布或保存草稿。
-6. 记录发布结果、作品链接或失败原因到 `tasks` 目录。
+3. 先优先用 Chrome 或 Edge；没有这两个浏览器时，提示用户先安装 Chromium。
+4. 打开发布入口并填写内容。
+5. 到最终发布按钮前暂停，复述即将发布的内容。
+6. 用户确认后再点击最终发布或保存草稿。
+7. 记录发布结果、作品链接或失败原因到 `tasks` 目录。
 
 ## 输出要求
 

package/src/browser-tools.js

@@ -67,6 +67,12 @@ const TASK_ALIASES = {
   账号快照: 'account_snapshot',
 };
 
+const BROWSER_PREFS = {
+  preferred: ['Chrome', 'Edge'],
+  fallback: 'Chromium',
+  retry_limit: 3,
+};
+
 export function listBrowserCommands() {
   const commonOptions = [
     option('--platform', 'platform', true, '平台：douyin、xiaohongshu、weibo、bilibili、tiktok、youtube、twitter。'),
@@ -325,6 +331,7 @@ function buildTaskPlanPayload(options) {
       '发布前最终确认按钮',
       '任何可能修改线上帐号状态的动作',
     ],
+    browser_preferences: browserPreferences(),
     boundaries: browserBoundaries(),
   };
 }
@@ -411,3 +418,14 @@ function browserBoundaries() {
     fallback_tool: 'yuanflow_cli_call browser ...',
   };
 }
+
+function browserPreferences() {
+  return {
+    browser_order: ['Chrome', 'Edge', 'Chromium'],
+    fallback_browser: BROWSER_PREFS.fallback,
+    download_retry_limit: BROWSER_PREFS.retry_limit,
+    download_retry_message: '如果 Chromium 连续下载 3 次还是失败，就不要继续死试了，直接告诉用户可能是网络、权限、下载源不可用或安全软件拦截，并指导用户手动下载安装后再继续。',
+    user_facing_hint:
+      '先看看这台电脑有没有 Chrome；没有就用 Edge；如果这两个都没有，再提示用户安装给浏览器自动化用的 Chromium。',
+  };
+}