mcpField
B
browser-record

browser-record

github.com/ruvnetAgent 工作流80.0k718 次安装今天更新
代码仓库

关于 browser-record

browser-record 面向需要保留交互轨迹以供回放或分析的浏览器任务。它创建并索引会话，同时记录操作与页面状态。

主要功能

  1. 01创建具名浏览器会话
  2. 02捕获无障碍树和截图
  3. 03记录交互轨迹
  4. 04压缩并索引会话产物

适用场景

  1. 01保存网站探索过程以便复查
  2. 02为后续浏览器技能建立会话

MCP 相关

它通过 MCP 浏览器工具打开浏览器，并将会话操作关联到记录的轨迹。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/ruvnet/ruflo --skill browser-record

安装后在 Claude Code 中输入/browser-record确认已加载。

详细介绍

浏览器记录

所有其他浏览器技能组合所依赖的基础技能。它会打开一个命名的浏览器会话，为其分配一个 RVF 容器，并将每个操作绑定到一个 ruvector 轨迹步骤。在此插件中运行浏览器会话时，必须调用此技能（或封装了此技能的技能）。

使用时机

  • 开始任何并非一次性临时探测的浏览器交互。
  • 交互式浏览网站，同时保留轨迹以供之后重放或分析。
  • 建立可供下游技能（browser-extract、browser-form-fill、browser-test）组合使用的可复用会话。

步骤

  1. 分配会话 ID 和 RVF 容器： 
    SID="$(date +%Y%m%d-%H%M%S)-${TASK_SLUG:-record}"
npx -y [email protected] rvf create "$SID.rvf" --dimension 384
npx -y [email protected] hooks trajectory-begin --session-id "$SID" --task "$1"
  2. 打开浏览器：通过 mcp__plugin_ruflo-core_ruflo__browser_open 并传入 URL。
  3. 捕获初始状态：使用 browser_snapshot 获取无障碍树，使用 browser_screenshot 获取基准图像。
  4. 对于每次交互，在操作前后记录一个轨迹步骤： 
    npx -y [email protected] hooks trajectory-step \
  --session-id "$SID" --action click --args '{"selector":"#login"}' --result ok
  5. 干净地结束： 
    npx -y [email protected] hooks trajectory-end --session-id "$SID" --verdict pass
npx -y [email protected] rvf compact "$SID.rvf"
  6. 在 AgentDB 中建立索引，归入 browser-sessions： 
    npx -y @claude-flow/cli@latest memory store --namespace browser-sessions \
  --key "$SID" --value "{rvf_id:$SID,host:...,task:...,verdict:pass}"

注意事项

  • 在 browser_session_record MCP 工具发布之前（ADR-0001 §7），此技能会在自身的 bash 步骤中驱动整个生命周期。请勿在没有这些封装的情况下直接调用 mcp__plugin_ruflo-core_ruflo__browser_open。
  • 会话 ID 格式固定为：<YYYYMMDD-HHMMSS>-<task-slug>。下游 /ruflo-browser ls 会解析此格式。
  • --with-dom 开销较大（每次导航都会转储完整 HTML）。默认关闭。
  • AIDefence 会在提取时而非导航时进行检查。browser-record 是一项基础技能；内容读取技能（browser-extract、browser-test）负责脱敏。

评论

支持 Markdown