Skip to content

Latest commit

 

History

History
125 lines (102 loc) · 8.63 KB

File metadata and controls

125 lines (102 loc) · 8.63 KB

斜杠命令

WebBrain 接受作为输入框某行开头的斜杠命令。在面板内输入 /help 可查看完整的用法 签名和参数说明。输入规范命令并加一个空格后,自动补全会显示该命令可用的参数。

命令参考

命令 作用
/help 显示可用命令列表
/ask 发送前切换到 Ask 模式
/act 发送前切换到 Act 模式
/dev 发送前切换到 Dev 模式
/plan 以规划意图切换到 Ask 模式
/schedule [提示词] 创建计划任务,并可预填提示词
/schedule --list 显示计划任务
/watch [--keep] [--secs <30-120>] [--long | --short] <条件与动作> [/beep] 轮询当前页面的某个条件;除非设置 --keep,否则首次匹配后停止,并可播放后台提示音
/progress 显示当前进度记录
/scratchpad 显示当前草稿板
/scratchpad --append <文本> 将文本追加到当前草稿板
/scratchpad --clear 清除当前草稿板
/memory 显示已保存的用户记忆
/memory --add <文本> 将用户偏好保存到记忆
/memory --forget <id> 按 ID 删除一条记忆
/workflow 打开工作流管理卡片,可直接运行、重命名、导出或二次确认后删除
/workflow --save <名称> 将最近一次成功的追踪运行编译为可复用、不含具体值的工作流
/workflow --run <id> 在 Act 模式运行已保存的工作流,并在本地收集运行时参数
/workflow --delete <id> 删除已保存的工作流
/workflow --export <id> 下载经过清洗的可移植 webbrain-workflow/1 JSON 文件
/workflow --import --file 将可移植工作流文件导入为新的本地工作流
/teach 显示当前标签页的示教状态和已捕获操作数
/teach --start <名称> 开始从您演示的点击和字段编辑中学习工作流
/teach --end 结束示教,并将捕获的操作编译为不含实际输入值的已保存工作流
/allow-api 按对话的 API 变更覆盖。 参见下文
/foreground [提示词] 为视觉兼容性在前台运行一次本地任务
/dangerously-skip-permissions 全局权限提示绕过。 无需打开设置即可关闭「操作前询问」。在你重新启用该设置之前,WebBrain 将不再按站点弹出提示。
/compact 强制压缩当前对话上下文
/verbose 切换详细/压缩工具显示
/reset 清除对话与所有按对话的标志
/screenshot [--full-page] 捕获可见标签页;使用 --full-page 捕获完整可滚动页面(仅 Chrome)
/record [--full-screen] [--hide-recording-indicator] [--transcribe] 录制当前标签页;使用 --full-screen 录制屏幕或窗口(仅 Chrome),--hide-recording-indicator 隐藏横幅,--transcribe 在停止后保存转录
/export [--traces | --config] 下载带版本戳的对话 Markdown;--traces 导出带版本戳的工具链;--config 导出设置快照
/import <json> 导入内联粘贴的设置快照
/import --file 选择并导入设置快照 JSON 文件
/profile 无需打开设置即可切换资料自动填充
/vision 在当前提供商上切换视觉模式(截图理解)

/watch

/watch 会立即执行第一次检查,之后默认每 60 秒轮询一次。--secs 接受 30–120 秒。

相对条件(例如「当出现新提交时」)会在第一次检查时建立基线;绝对条件(例如「当 CI 变绿时」)可以立即匹配。

结尾的 /beep 会启用仅限 watch 的提示音工具;--short--long 选择音调。提示音 只在验证动作成功后播放,--keep 会抑制同一稳定事件键的重复提示音。如果模型验证了 动作但省略了可选的提示音工具,watch 会记录该警告,并在无声的情况下完成或继续。

轮询在专用的非活动标签页中进行,因此离开发起页面不会把它导航回被监视的 URL;watch 结束时会关闭该辅助标签页。短暂的轮询失败可以容忍;连续三次失败会停止 watch。

/foreground

常规本地运行会固定在最初的标签页上执行,不会激活该标签页或聚焦其窗口。Chrome 通过 CDP 截图,并仅在该次运行期间模拟焦点;Firefox 使用 tabs.captureTab 直接捕获目标 标签页。如果 Chrome 多次返回空白的后台画面,WebBrain 会丢弃该画面,继续使用 DOM 和无障碍数据。

若某个网站无法在后台正确渲染视觉状态,可使用 /foreground <提示词> 作为仅对本次 运行生效的兼容模式。它会为该次运行恢复标签页激活和窗口聚焦,不会成为持久设置。 托管 Cloud 运行仍保留现有前台行为,因为其浏览器专用于该任务。

/allow-api

/allow-api 会为当前对话解除 UI 优先限制,使智能体在 UI 失败时可通过 fetch_urlresearch_url 使用 POST/PUT/PATCH/DELETE。激活期间会显示徽章,并在 /reset 时清除。

若要让相同策略在不同对话和浏览器重启后继续生效,请在设置 → 常规 → 高级中开启 始终允许 API 变更。该设置默认关闭,并会一直生效到你手动关闭。/reset 仍会清除 当前对话的 /allow-api 覆盖,但不会更改此持久设置。

默认的 UI 优先规则之所以存在,是因为 API 操作是不可见的(你看不到发送了什么内容), 通常需要你可能尚未配置的独立认证令牌,并且其影响范围可能比一次可见的误点击大得多。 只有当你已为某项特定工作权衡决定接受该取舍时,才使用 /allow-api。参见 安全模型

运行捕获后缀

这些后缀有意不出现在 /help 和自动补全中。

在普通提示词末尾追加 /record [--save-as <文件名>],会在运行开始前立即录制当前 标签页,并在该运行结束时停止并保存 WebM(仅 Chrome)。

在普通提示词末尾追加 /screenshot [--save-as <文件名>],会在运行前后各保存一张 视口截图(Chrome 与 Firefox)。例如 测试结账流程 /screenshot --save-as checkout.png 会保存 checkout-before.pngcheckout-after.png;若不带 --save-as,WebBrain 使用带时间戳的文件名。

对于这个诊断后缀,Chrome 可能会在保存「之后」截图前重新激活发起运行的标签页; Firefox 会直接捕获该标签页而不激活它。如果录制或初始截图无法启动并保存,该运行不会 被发送。独立的 /record/screenshot 保持原有行为。

导出、快照与工作流

每种导出的完整 schema 和隐私属性见 导出与工作流格式(英文)。简要说明:

  • 设置快照 使用 webbrain-config/1 架构,包含所有可移植的设置值,包括提供商、 视觉、转录和 CapSolver API 密钥、资料数据、用户记忆、自定义技能和权限选择。 该 JSON 是明文的,应妥善保管。 设备绑定的 Cloud Sync 会话/设备 ID、对话、 追踪、计划任务、用量计数器和累计花费不会被导出。
  • 已保存的工作流 使用独立的 webbrain-workflow/1 架构;它们不是原始的追踪回放。 历史 ref_id 值、动作 CSS 选择器、坐标、查询字符串、片段和输入的字段值都会被排除。 输入值会成为运行时参数,每个动作都绑定到记录时的来源和 URL 族。运行时 WebBrain 会 解析一个新的可访问性树目标,并通过常规的 Act 权限、提交确认和验证关卡执行。目标 不明确时会安全失败。如果某个动作可能已经发生但结果未知,回放会停止而不是重试。 运行时参数值不会保存到工作流、对话、用户记忆、回放追踪或 Agent 回退提示中;它们 仍会通过所请求的浏览器动作送达目标页面。原始的可选源追踪保持独立,在用户删除该 追踪前可能包含原始工具参数。
  • 如果回放起点在已保存的来源或 URL 族之外,确定性回放会将控制权连同经过清洗的起始 范围交给 Agent,以便常规的导航、权限和验证规则可以恢复该工作流,而不是立即结束它。
  • 可移植工作流文件 包含经过清洗的原始 webbrain-workflow/1 定义,大小上限 1 MiB。导出会在下载前重新规范化定义。导入会再次规范化,并分配新的本地 ID 和时间戳, 且永不覆盖已有工作流,因此同一文件可以安全地在 Chrome、Firefox 和 WebBrain Cloud 之间迁移。