用途：在浏览器主机上把一次网页操作旅程记录为证据，产出 <out>/<NAME>-<timestamp>/ 目录，内含 steps.md、screenshots/NNN-<kind>-<label>.png 和 videos/*.webm。steps.md 会省略输入值与查询字符串。
主要能力：录制 WebM 视频；每次点击和页面加载后截图，并在点击位置标红点；生成步骤说明文件。支持 agent 驱动录制（由智能体操作浏览器）和人工驱动录制（人正常使用窗口，结束时在终端按 Enter）。
使用方式：录制器与浏览器驱动需运行在同一主机，产物保存在该主机上。先设置 SKILL_DIR 为包含 SKILL.md 的绝对目录，再通过绝对路径调用捆绑的录制器： SKILL_DIR="/absolute/path/to/record-web-journey" RECORDER="$SKILL_DIR/scripts/record-flow.mjs" AB="$SKILL_DIR/scripts/node_modules/.bin/agent-browser" 每次独立 shell 调用开始时需重新设置 SKILL_DIR、RECORDER、AB、保留的 CDP 端口和 DISPLAY。每个浏览器主机执行一次初始化： "$SKILL_DIR/scripts/setup.sh" "$AB" skills get core 该脚本会在录制器旁安装 agent-browser 与 Playwright，加入 Playwright 的 ffmpeg 辅助程序用于视频，并在没有 Google Chrome 时加入 Chromium；若已有 Chrome 建议用 --chrome。
agent 驱动时，解析出起始 URL、录制 NAME 和步骤；检查主机是否有桌面（pgrep -a Xvnc 或 echo $DISPLAY），有则每次 shell 调用导出 DISPLAY，无则加 --headless；检查 df -h /dev/shm，若为 64M 需重挂到 2G。选择绝对输出目录和可用本地 CDP 端口，在长驻会话中启动录制器，例如： node "$RECORDER" "https://app.example.com/" --name "journey-name" --cdp "$PORT" --out "$OUT" 再用唯一会话名把 agent-browser 附加到该 Chrome 并驱动，每条命令都带 --session 和 --cdp。操作节奏约每秒一次，导航后用 wait --load networkidle；截图在点击后 250 ms 拍摄。折叠下方内容先 scrollintoview @ref，再 wait 1000，再 click @ref。结束时创建 <recordingDir>/STOP，等待录制器打印 Saved N visual steps，再关闭命名会话。
人工驱动示例： node "$RECORDER" https://app.example.com/ -name "F06" --chrome --profile .context/chrome-profile
常用参数：-name 文件夹前缀；--chrome 使用已安装 Chrome；--profile 复用 Chrome 用户数据目录以保留登录；--cdp 暴露 CDP 供 agent-browser 附加；--headless 无窗口；--out 父目录（默认 .context/flow-recordings）；--viewport 视口与视频尺寸（默认 1440x900）；--sign-in 配合 --profile 打开普通 Chrome 通过机器人检查或登录后退出。结束信号：Enter（TTY）、STOP 文件、关闭浏览器、SIGTERM；Enter 或 STOP 走 Playwright 的干净收尾路径。
适用场景：需要留存网页操作证据、复现步骤或人工复核流程的场合。
限制：录制器与浏览器驱动必须同主机，产物留在该主机；共享主机上需检查活动进程、选唯一会话并只关闭该会话；视觉隐藏的 1x1 输入会记录为“(no visible target)”，需选择可见标签或控件；平滑滚动站点需显式等待稳定。其余细节资料未提供。