根据需要复用的内容选择导出格式,或示教一个工作流。
可读对话、诊断轨迹、设置备份和可复用工作流是不同类型的产物。最安全的选择,是只导出完成目标所需的最少内容;如果你已经熟悉步骤,示教模式可以从一次手动演示中学习。
应该使用哪种导出或工作流方式?
| 目标 | 命令 | 结果 |
|---|---|---|
| 保存侧边栏中可见的对话 | /export | 便于阅读的 Markdown 对话记录。 |
| 调试已记录的代理运行 | /export --traces | 包含模型回复、工具调用、参数和结果的 Markdown。 |
| 备份或迁移设置 | /export --config | webbrain-config/1 JSON 快照。 |
| 通过一次操作演示学习工作流 | /teach --start <名称> | 从手动演示编译出的无输入值已保存工作流。 |
| 迁移一个可复用自动化 | /workflow --export <id> | 经过清理的 webbrain-workflow/1 JSON 定义。 |
设置快照可能包含提供商 API 密钥、个人资料、用户记忆、自定义技能和权限选择。请像密码备份一样保存,切勿将其附加到公开 issue。
对话与轨迹 Markdown
/export 会保存侧边栏当前显示的消息,并记录导出时的 WebBrain 版本。该文件用于阅读,不能导回 WebBrain。
/export --traces 使用当前对话的本地轨迹记录,可能包含提示词、模型输出、URL、工具参数和工具结果。此 Markdown 文件不包含截图。如果某次运行时没有开启轨迹记录,之后无法补建该次轨迹。
优先使用对话导出。只有在需要工具级细节时才使用轨迹导出;分享前都应检查个人信息。
备份设置
- 输入
/export --config。 - 安全保存下载的
webbrain-config-….json。 - 使用
/import --file恢复,或把 JSON 粘贴在/import后。
快照包含可迁移的设置值,但不包含对话、轨迹、计划任务、用量计数、累计支出,也不包含绑定设备的 Cloud Sync 会话和设备 ID。
schema 字段用于识别兼容性。WebBrain 当前导出并接受 webbrain-config/1。
亲自操作一次,教会 WebBrain 一个工作流
当你熟悉浏览器操作步骤,又不想先让代理完成一次带轨迹的运行时,可以使用示教模式。演示仅限当前标签页,最终会编译成与 /workflow --save 相同、带安全保护的 webbrain-workflow/1 格式。
- 打开起始页面。使用普通
http(s)页面,并停止当前占用该标签页的代理运行。 - 开始示教。输入
/teach --start <名称>,页面上会出现紫色的 WebBrain Teach 指示器。 - 手动完成工作流。在同一标签页中,按可复用流程执行可信点击、完成字段输入、切换复选框或单选按钮、用 Enter 提交并进行导航。
- 按需查看进度。输入
/teach,查看当前工作流名称和已捕获操作数。 - 编译并保存。输入
/teach --end,再打开/workflow运行、重命名、导出或删除学到的工作流。
页面捕获代码只记录字段的语义身份,不读取字段内容。每个完成的字段都会变成运行时参数;以后运行工作流时,WebBrain 会在本地重新询问当前值。
捕获边界
- 只捕获顶层页面中的可信操作;WebBrain 自己执行的操作不会进入示教记录。
- 会话会跟随同一标签页中的导航,最多记录 100 个规范化操作。
- 示教模式与自动代理运行不能同时占用同一标签页。启动代理任务前,请先用
/teach --end结束示教。 - 不支持或不安全的目标会被跳过;保存结果会显示警告,重放时仍要求语义目标匹配唯一明确。
- 即使无法编译出工作流,
/teach --end也会关闭临时示教会话;请修正页面或演示过程后重新开始。
从轨迹创建,再迁移已保存工作流
示教模式适合手动演示。如果代理已经在开启轨迹记录的情况下成功完成任务,也可以直接保存那次执行:
- 开启轨迹记录并成功完成任务。
- 用
/workflow --save <名称>保存。 - 运行
/workflow查找 ID。 - 用
/workflow --export <id>下载。 - 在另一套 WebBrain 中使用
/workflow --import --file。
可移植工作流不是原始轨迹或示教会话。WebBrain 会删除旧元素引用、CSS 选择器、点击坐标、URL 查询字符串和片段,以及曾经输入的字段值。输入值会变成参数,在每次运行时于本地重新收集。
文件保留语义化目标描述、来源站点和路径范围,因此 WebBrain 可以重新查找当前元素,并在匹配不明确时安全停止。正常的执行模式权限、提交确认和结果验证仍然生效。
WebBrain 会分配新的本地 ID 和时间戳,不会覆盖现有工作流。可移植工作流文件上限为 1 MiB。
分享前检查
| 文件 | 至少检查 |
|---|---|
| 对话 Markdown | 消息和系统提示。 |
| 轨迹 Markdown 或轨迹页 JSON | 提示词、URL、参数、结果及内嵌截图。 |
| 设置 JSON | 除非主动删除了所有密钥和隐私值,否则不要分享。 |
| 工作流 JSON | 名称、来源元数据、网站来源和路径范围、目标标签及步骤意图。 |
完整字段和兼容规则见技术格式参考(英文)。
