插件设置
所有配置项通过侧边栏的 设置 面板管理,下文章节顺序与设置面板界面一致。Mock 规则和设置等持久化数据保存在 chrome.storage.local;扩展 storage 不会跨设备自动同步(无 Chrome 云同步)。
数据管理
位于设置面板顶部,用于备份或迁移插件本地数据。
| 操作 | 说明 |
|---|---|
| 数据备份 | 导出插件数据为 JSON 文件;核心数据来自 chrome.storage.local(Mock、设置等) |
| 数据迁移 | 从备份文件恢复;会覆盖当前 local 数据,请谨慎操作 |
支持的文件格式:
json
{
"app": "reqable",
"version": 1,
"exportedAt": "2025-01-01T00:00:00.000Z",
"data": {
"local": {}
}
}功能开关
| 配置项 | 选项/说明 |
|---|---|
| 语言 | 跟随浏览器(默认)/ 中文 / 英文 |
| 主题 | 跟随系统(默认)/ 浅色 / 深色 |
| YApi 服务地址 | 团队自行部署的 YApi 根地址,例如 https://yapi.example.com;导入前必须配置 |
| 启用 Mock 功能 | 全局 Mock 总开关;关闭后不再按规则返回 Mock 数据 |
AI 模型配置
配置用于 AI 生成 Mock 的模型服务。
接口协议
支持三种协议,按服务商提供的兼容接口选择:
| 协议 | 适用场景 |
|---|---|
| OpenAI | OpenAI 官方、DeepSeek、MiniMax、GLM 等兼容接口 |
| Anthropic | Anthropic 官方或兼容接口 |
| Gemini | Google Gemini 官方接口 |
配置项
- Base URL —
API地址,切换协议时输入框placeholder会切换为对应示例 - API Key — 密钥,密码类型输入框
- 模型名 — 如
gpt-5.4、claude-opus-4-7、gemini-2.5-pro-preview
TIP
多数国产模型(DeepSeek、GLM、MiniMax 等)可使用 OpenAI 协议,填入对应的 Base URL 即可。
Mock 默认策略
控制新建 Mock 规则时的默认配置。修改后不会自动作用于已有 Mock,需手动批量应用。
默认匹配策略
| 策略 | 默认行为 |
|---|---|
| 精确匹配 | URL + 请求体完全一致才命中(默认) |
| 路径匹配 | 仅匹配 URL 路径,忽略 query 和请求体 |
| 自定义匹配 | 新建时使用完整 URL、当前接口方法和请求体 |
| 智能匹配 | 精确优先,未命中降级为路径匹配 |
默认能力开关
以下开关控制新建 Mock 时各项能力的默认启用状态:
- 默认忽略域名匹配
- 默认 Mock 响应(默认开启)
- 默认模拟异常
- 默认模拟超时
- 默认 Mock 请求体
- 默认 Mock 请求头
- 默认 Mock Query
批量应用
- 应用到当前分组 — 仅影响当前选中分组下的已有 Mock
- 应用到全部 Mock — 影响所有分组的全部规则
缓存容灾
当接口返回临时错误时,自动使用本地缓存的成功响应恢复页面。
启用容错处理
开启后,命中以下状态码时自动尝试缓存恢复:
- 标准 HTTP:
500、502、503、504 - Cloudflare / CDN 扩展码:
520–526
每域名最大缓存条数
默认 1500,超出后按写入时间淘汰最旧的数据(FIFO)。可调范围 100–10000。
生效域名规则
限制哪些页面启用容灾缓存。每行一条规则,格式为 type domain:
regex .*example\\.com.*— 正则匹配fully example.com— 完全匹配include localhost— 包含匹配
留空则对所有页面生效。失焦时自动保存。
已记录缓存的域名
展示容灾开启后被访问过并已产生缓存数据的域名列表。列表最多展示最近 300 个域名。
侧边栏配置
| 配置项 | 说明 |
|---|---|
| 关闭侧边栏时保留状态 | 开启后关闭侧边栏只隐藏不销毁,再次打开可保留面板状态 |
| 切换标签页时自动关闭侧边栏 | 离开当前标签页时,自动完全关闭(销毁)侧边栏 |
编辑器显示
| 配置项 | 说明 |
|---|---|
| 显示编辑器行号 | Monaco Editor 是否显示行号,关闭可进一步压缩左侧宽度 |
布局配置
| 配置项 | 选项 |
|---|---|
| Mock 详情展示方式 | 新模式(抽屉) / 旧模式(分栏) |
高级设置
时间戳参数名
声明需要在匹配前忽略的动态参数名。命中后会在生成内容哈希前先剔除这些字段。
影响范围:
URL Query参数- 第一层
JSON请求体字段
默认已包含:_t、t、timestamp、_timestamp
每行一个参数名,例如:
text
_t
timestamp
_v重置为默认设置
设置面板底部的 重置为默认设置 按钮,会恢复 Mock、AI、YApi、容灾、侧边栏、编辑器、布局和高级设置。语言与主题偏好不会被重置。
WARNING
重置仅影响设置项本身,不会清空 Mock 规则列表。如需完整覆盖数据,请使用 数据迁移。
