三步上手

• 拖拽：把左侧节点拖进画布（或双击节点库 / 悬停点 + 快捷添加）
• 配置：点选画布中的步骤卡片，右侧面板填写参数与策略
• 导出：顶栏「生成脚本」→ async / sync 双版本，复制或下载 .py 直接运行

定位参数三态写法（v3.5.0）

• 字符串：CSS 或智能前缀，如 #kw、r=button, 提交、ph=用户名
• 结构化 FieldLocator：七种定位（role / placeholder / label / text / test_id / xpath / css），组件库页面首选
• 多候选元组：多个定位任一命中即成功（逗号「或」语义），适合「组件库优先 + CSS 兜底」

值与变量

• 提取类节点（取文本 / 计数 / 批量文本 / 取属性 / 表格）可把结果存入变量
• 任意「值」输入框支持表达式：以 = 开头按 Python 表达式生成，例如 =ctx["keyword"]

失败与重试（与 RPATaskFlow 一致）

• retries：步骤失败自动重试次数（间隔 retry_delay 秒）
• 点击 / 填充等返回 bool 的操作，失败会主动抛错 → 才能触发重试链
• on_error：仍失败后的策略——中断（默认）/ 容忍继续（流程标记 partial）/ 再试一次
• screenshot_on_fail：失败自动截图存证（默认开）

数据保存

流程自动保存在浏览器 localStorage（本机数据不出门）。顶栏可管理多个流程方案、导出 JSON 分享、导入恢复。「自定义代码」节点中可直接使用 browser 与 ctx。

本地实时服务（v3.6.0 二期）

• 拾取：选择器字段旁「🎯 从页面拾取」→ 输入网址打开真实浏览器 → hover 高亮、点击元素自动生成 FieldLocator（也可从元素清单点选）
• 试跑：顶栏「▶ 试跑」→ 当前流程直接在本地执行，每步状态实时回填画布，失败自动截图
• 启动服务：仓库根目录执行 uv run python tools/flow_studio_server.py（默认 127.0.0.1:8930，顶栏状态灯变绿即连接成功）
• 不启动服务时，编排与导出脚本功能完全不受影响