安装配置

安装步骤

1. 下载扩展

从 CDN 下载最新安装包 并解压。

如果当前还没有可用的公开安装包，也可以从源码构建：

pnpm install
pnpm build

构建完成后，扩展目录位于 .output/chrome-mv3/。

2. 安装到浏览器

1. 准备扩展目录：解压下载的 .zip，或使用源码构建生成的 .output/chrome-mv3/
2. 打开扩展管理页：Chrome 访问 chrome://extensions/，Edge 访问 edge://extensions/
3. 开启右上角的 开发者模式
4. 点击 加载已解压的扩展程序，选择上一步准备好的扩展目录

3. 验证安装

安装成功后，工具栏会出现 reqable 图标。点击图标打开 Popup 弹窗（Mock 开关等）；页面内侧边栏需通过下方方式唤出。

打开功能面板

通过以下方式打开 reqable 功能面板：

方式	操作
快捷键	macOS 默认 ⌘ + H；Windows 默认 Ctrl + Shift + H；Linux 默认 Ctrl + H，用于切换侧边栏显示/隐藏
页面右键	页面空白处右键 → 打开 reqable
扩展图标右键	工具栏扩展图标右键 → 打开 reqable
开发者工具	打开浏览器开发者工具 → Mock 面板 标签，适合需要更大工作区的 Mock 监控场景

快捷键可在 chrome://extensions/shortcuts 中自定义。

说明

• 点击扩展图标本身打开的是 Popup，不是侧边栏。
• macOS 上扩展 manifest 中的 Ctrl+H 会被 Chrome 自动映射为 ⌘ + H。Windows 因 Ctrl + H 被 Chrome 用于打开历史记录，默认使用 Ctrl + Shift + H。
• 侧边栏处于打开状态时刷新当前页面，会自动恢复显示（仅限同一页面，不跨页）。

常见问题

扩展没有拦截到请求？

1. 确认 Popup 弹窗中的 Mock 开关 已开启
2. 刷新页面后再操作
3. 检查控制台是否有错误信息

Mock 不生效？

1. 确认 Mock 开关 已开启
2. 确认对应规则已启用（checkbox 勾选状态）
3. 检查 匹配策略 和 URL 是否正确
4. 刷新页面重试

侧边栏无法打开？

1. 安装或更新扩展后，刷新目标页面（已打开的页面不会自动注入，需刷新后才可唤出侧边栏）
2. 确认页面已加载完成后再操作
3. 尝试切换标签页后重试
4. 检查扩展是否被浏览器禁用