📼 录制与回放

录制功能将真实请求 / 响应保存下来，供回放、转 Mock 与问题排查使用。管理后台「HTTP Mock → 录制」页面管理录制数据。

如何录制

1. 在规则中设置 mode: proxy 且开启 录制（record: true）
2. 请求经过代理端转发到下游
3. 系统自动保存请求（方法、路径、请求头、Query、请求体）与响应（状态码、响应头、响应体）到 SQLite

mode: proxy
record: true

录制数据内容

一条录制记录包含：

字段	说明
所属服务 / 规则	命中的服务与规则
方法 / 路径	请求方法与接口路径
请求头 / Query / 请求体	请求快照
响应状态码 / 响应头 / 响应体	响应快照
截断标记	请求 / 响应体超过上限被截断，或二进制非文本响应体未录制

录制上限

• 单条请求 / 响应体上限：proxy.maxRecordSize（默认 64M），超出截断
• 全局录制条数上限：proxy.maxRecords（默认 10000），超出自动淘汰最旧记录
• 二进制 / 非文本响应体不录制（responseBodySkipped）

查询与筛选

录制列表支持按条件筛选：

• 服务：按所属服务过滤
• 规则：按规则过滤
• 关键字：按路径 / 方法等关键字模糊搜索
• 时间范围：按录制时间过滤

一键转 Mock

将录制数据转换为 Mock 规则，实现「流量变规则」：

1. 在录制列表选择目标录制记录
2. 点击「转为 Mock」
3. 系统自动创建一条 mode: mock 规则，响应内容来自录制快照
4. 可在规则管理中查看与调整

对应 API：POST /api/records/:id/to-mock

回放

对录制数据进行回放，验证下游服务或对比前后行为：

• 按录制数据重新构造请求并发送到代理端
• 观察当前响应与录制响应的差异
• 对应 API：POST /api/replay

数据管理

• 删除单条：移除不需要的录制记录
• 清空全部：按筛选条件一键清空录制数据（对应 DELETE /api/records）

WARNING

清空操作不可恢复，请谨慎操作。

相关 API

方法	路径	说明
GET	/api/records	录制列表（支持筛选分页）
GET	/api/records/:id	录制详情
POST	/api/records/:id/to-mock	转 Mock 规则
DELETE	/api/records/:id	删除单条
DELETE	/api/records	清空录制
POST	/api/replay	回放