Cross Request Master

专为 YApi 接口管理平台定制的 Chrome 扩展，支持绕过 CORS 限制并自动生成 cURL 命令。

目录

• 功能特性
• 安装
• 快速开始
• 高级用法
• 工作原理
• 安全说明
• 开发指南
• 贡献
• 项目文档
• 支持项目
• 许可证

功能特性

• 跨域请求支持 - 绕过浏览器 CORS 限制，直接测试跨域接口
• cURL 命令生成 - 自动生成完整 cURL 命令，一键复制分享
• 智能网站检测 - 自动识别 YApi 等 API 管理平台，按需激活功能
• jQuery 集成 - 智能拦截 jQuery ajax 请求，无需修改现有代码
• Manifest V3 - 基于最新 Chrome 扩展标准开发

安装

方式一：Chrome Web Store（推荐）

1. 点击上方按钮或访问 Chrome Web Store
2. 点击"添加至 Chrome"按钮
3. 确认安装即可

方式二：开发者模式安装

1. 下载或克隆本仓库到本地

   git clone https://github.com/leeguooooo/cross-request-master.git

2. 打开 Chrome 浏览器，访问 chrome://extensions/

3. 开启右上角的"开发者模式"

4. 点击"加载已解压的扩展程序"，选择项目目录

快速开始

在 YApi 中使用

安装后在 YApi 接口页面正常发送请求，扩展会自动：

• 处理跨域请求
• 在页面右上角显示 cURL 命令
• 点击"复制"按钮即可分享

在其他网页中使用

在任意网页的控制台或脚本中调用：

window.crossRequest({
    url: 'https://api.example.com/data',
    method: 'GET',
    headers: {
        'Authorization': 'Bearer token'
    },
    success: function(res, header, data) {
        console.log('Success:', res);
    },
    error: function(err, header, data) {
        console.error('Error:', err);
    }
});

高级用法

jQuery 集成

扩展根据网站类型自动采用不同的拦截策略：

YApi 等目标网站（自动检测）

默认拦截所有 jQuery ajax 请求。如需禁用：

$.ajax({
    url: 'https://api.example.com/data',
    method: 'GET',
    crossRequest: false,  // 禁用扩展，使用原生 ajax
    success: function(data) {
        console.log(data);
    }
});

其他网站

默认不拦截，需显式启用：

$.ajax({
    url: 'https://api.example.com/data',
    method: 'GET',
    crossRequest: true,  // 启用扩展处理
    success: function(data) {
        console.log(data);
    }
});

手动启用完整模式

在页面 HTML 中添加 meta 标签强制启用：

<meta name="cross-request-enabled">

工作原理

智能检测

扩展会根据以下特征自动识别目标网站：

• Meta 标签包含 "yapi"、"api管理"、"接口管理"
• 页面标题包含 "yapi"
• URL 路径和域名组合匹配（如 /interface/ + yapi 域名）

运行模式

完整模式（YApi 等目标网站）

• 启用 DOM 监听和请求处理
• 显示 cURL 命令弹窗
• jQuery 默认拦截
• 输出调试日志

静默模式（其他网站）

• 启用核心 API（支持手动调用）
• 隐藏 UI 和日志
• jQuery opt-in 拦截

技术架构

• Content Script - 注入到网页，监听和拦截请求
• Background Service Worker - 处理实际的跨域请求
• Message Passing - Chrome Runtime API 进行通信

安全说明

警告: 本扩展仅供开发测试使用，请勿在生产环境使用。

• 扩展默认允许所有域名的跨域请求
• 不要在银行、支付等敏感网站启用
• 请求会被扩展拦截和处理，可能影响网站正常功能
• 使用时请遵守目标 API 的使用条款和安全政策

开发指南

项目结构

cross-request-master/
├── manifest.json          # 扩展配置
├── background.js          # Service Worker
├── content-script.js      # Content Script
├── index.js              # 注入脚本
├── popup.html/js         # 扩展弹窗
└── icons/                # 图标资源

本地开发

1. 修改代码后，在 chrome://extensions/ 点击"重新加载"
2. 打开浏览器控制台查看日志
3. 在 YApi 测试页面验证功能

测试

详细测试步骤请参考 TESTING.md

快速检查项：

• YApi 网站：cURL 弹窗显示 + 控制台有日志
• 普通网站：无 UI 弹窗 + 手动调用正常工作

技术栈

• Chrome Extension Manifest V3
• Service Worker
• Content Scripts
• Vanilla JavaScript

贡献

欢迎提交 Issue 和 Pull Request！

贡献者

感谢所有为本项目做出贡献的开发者：

如何贡献

提交问题时请提供：

1. Chrome 版本和扩展版本
2. 详细的错误信息和复现步骤
3. 预期行为和实际行为

支持项目

如果本项目对你有帮助，欢迎通过以下方式支持：

• Star 本仓库
• 提交 Issue 反馈问题
• 提交 PR 贡献代码

赞助开发

如果你觉得这个项目对你有帮助，可以请作者喝杯咖啡：

GitHub Sponsors

微信 / 支付宝

你的支持是项目持续维护和改进的动力！

更新日志

查看 CHANGELOG.md 了解详细的版本更新历史。

最新版本 v4.5.3 (2025-01-XX)

• ✅ 成功上架 Chrome Web Store
• ✅ 修复 YApi request/response 脚本兼容性（Issue #19）
• ✅ 修复合法 JSON 标量值丢失问题（0、false、null、""）
• ✅ 添加完整的开发工具链（ESLint、Prettier、Jest）
• ✅ 添加 CI/CD 自动化（GitHub Actions）
• ✅ 完善文档和贡献指南

查看 CHANGELOG.md 了解详细信息。

开发者文档

参与贡献

• CONTRIBUTING.md - 贡献指南

  • 开发环境设置（npm install, npm test, npm run lint）
  • 代码规范和最佳实践（ESLint + Prettier）
  • 提交和 PR 流程
  • Falsy 值处理特别说明

• ROADMAP.md - 技术路线图

  • 短期目标：模块化重构、消除重复代码
  • 中期目标：TypeScript 迁移、功能扩展
  • 长期目标：插件系统、团队协作

项目配置

• .github/workflows/ci.yml - CI/CD 配置
  • 自动 Lint 检查
  • 自动测试和覆盖率
  • 扩展打包和验证
• .eslintrc.json - ESLint 配置
• .prettierrc.json - Prettier 配置
• package.json - npm scripts 和依赖
• tests/ - 测试套件（39 个测试用例）

许可证

MIT License

Chrome Web Store

🎉 Cross Request Master 已成功上架 Chrome Web Store！

• 扩展 ID: efgjanhcajpiljllnehiinpmicghbgfm
• 当前版本: v4.5.3
• 用户数: 130+ 用户
• 评分: 待评分（新上架）

安装方式

1. 推荐方式: 直接访问 Chrome Web Store 安装
2. 开发者方式: 下载源码本地安装（见上方安装说明）

更新说明

• 扩展会自动更新到最新版本
• 如需手动更新，请访问 Chrome Web Store 页面
• 开发版本需要手动重新加载

相关链接

• Chrome Web Store - 官方商店页面
• GitHub Issues
• Chrome Extension 开发文档
• YApi 官网

---

Made by leeguooooo