录制会话

录制会话会在您使用某个网页时对其进行观察，并记下它发出的每一次 API 调用：REST、GraphQL、gRPC-web 和 WebSocket。捕获到的调用可以像普通响应一样查看；在 Pro 和 Enterprise 计划中，它们还能变成一个文件夹，里面是真实的、可重放的请求，并已预先填入网页实际发送的内容。

当您手里只有一个 API 的前端时，这是为它编写文档的最短路径：无需配置代理，无需安装证书，无需浏览器扩展。

创建会话

会话可以在树中的任意位置创建（根目录、文件夹或环境文件夹），既可以通过右键菜单（“添加” → “录制会话”），也可以通过“新建”菜单；只有场景不能包含会话。它在侧边栏中显示为一个父节点：点击会话本身会打开其配置页面，而它的每个子行都会打开各自的标签页。

配置只包含四项内容：

• 要在迷你浏览器中打开的页面 url（http://、https:// 或 file://）。在 url 有效之前，“开始录制”按钮保持禁用。
• 要捕获的协议：HTTP、WebSocket、GraphQL、gRPC-web——默认全部勾选。
• 白名单：若干正则表达式；调用只要匹配其中至少一条就会被保留。留空则全部放行。
• 黑名单：若干正则表达式；匹配其中任意一条的调用都会被丢弃。黑名单始终拥有最终决定权。

只有这些设置和推导出的路由会保存到项目文件中。捕获到的调用则只保留在内存里：项目关闭时随之消失，永远不会写入磁盘。

录制

“开始录制”按钮会在迷你浏览器标签页中打开该页面，并在首次加载之前就挂上录制器，因此页面启动时发出的调用——包括一开始就建立的 WebSocket 连接——都会被捕获。侧边栏中会话徽标及其标签页周围的脉动光晕，表示录制正在进行。

像平常一样浏览和使用页面即可。地址栏上的两个按钮控制着会话：

• 暂停录制保持页面打开，但不再存储调用——适合跳过不感兴趣的界面。
• 停止录制卸下录制器并关闭浏览器标签页。已捕获的内容仍然可用。

录制始终是一个明确的操作：应用重新打开时恢复的浏览器标签页不会录制任何内容。

需要您位置的网站会向浏览器请求它，而迷你浏览器默认不会透露任何信息。应用设置隐私部分中的 与嵌入式浏览器共享您的位置 设置默认关闭，会在征求您的同意后提供您的大致位置：来自系统的定位服务，若不可用则改为根据您的 IP 地址做出的城市级估算。关闭后会立即忘记该位置。

捕获

会话的“捕获”行会打开调用视图，调用按运行从最早到最新分组，并在录制期间实时更新。列表滚动到底部时会跟随最新的调用；向上滚动阅读某个调用，列表便保持不动。筛选框可以缩小列表范围；单个调用的详情完全复用请求的响应标签页（正文、信息、Cookie、图表），逐协议对应。

调用的右键菜单可以将其加入白名单或黑名单，并以它的 url 作为预填的匹配模式。您可以把新模式应用到已捕获的调用上：不再通过的调用会被永久删除——应用会先请您确认。

每个会话保留的调用数量有上限（默认 1,000，可在应用设置中调整）；超出后，最早的调用会被丢弃。

推导路由

在 Pro 和 Enterprise 计划中，捕获视图的推导路由按钮会把调用转换为会话“路由”行下的一棵树：

• 调用按路由分组：在不同调用之间变化的路径片段（/pets/1、/pets/2）会变成路径参数 {{petId}}；
• 文件夹沿用路径的静态前缀（api › pets）；gRPC-web 调用按服务归类；
• 每条路由都变成一个普通请求——HTTP、GraphQL、gRPC-web 或 WebSocket——根据最后一次成功的调用预填（请求头、参数、正文），并可立即重放；
• 捕获到的调用会以常规格式写入每个请求的响应历史，并遵守已配置的保留上限；默认显示的响应是最后一次成功调用的响应。

在新的录制之后再次推导会进行合并：只添加新路由，现有请求——包括您已修改过的——保持原样。

在 Community 计划中，录制和查看捕获完全可用；“路由”标签页则显示一条关于 Pro 功能的提示。

通过 AI 助手使用

整套功能都通过 Restorm 的 MCP 服务器对外开放：创建和配置会话、开始和停止录制、读取捕获以及推导路由。这样一来，智能体可以打开一个页面，让它运行一段时间，然后交给您一个可以直接使用的请求文件夹。