Files
chromeEvent/INSTALL.md
2026-01-29 12:03:28 +08:00

3.2 KiB
Raw Blame History

安装指南

安装步骤

1. 准备图标文件(可选)

插件需要图标文件才能正常显示。如果你暂时没有图标,可以:

  • 跳过这一步,浏览器会使用默认图标
  • 或者创建三个 PNG 文件:
    • icon16.png (16x16)
    • icon48.png (48x48)
    • icon128.png (128x128)

2. 在 Chrome/Edge/Brave 中安装

  1. 打开浏览器

  2. 访问扩展管理页面:

    • Chrome: 在地址栏输入 chrome://extensions/
    • Edge: 在地址栏输入 edge://extensions/
    • Brave: 在地址栏输入 brave://extensions/
  3. 开启右上角的"开发者模式"开关

  4. 点击"加载已解压的扩展程序"按钮

  5. 选择 browser-extension 文件夹(包含 manifest.json 的文件夹)

  6. 插件安装完成!

3. 使用插件

  1. 访问目标网站(你的项目)

  2. 打开开发者工具F12在控制台可以看到

    ✅ XHR 解密插件已启动
    
  3. 触发一些请求后,控制台会输出解密信息:

    🔓 XHR 解密 [POST] /api/example
      🔑 密钥: 1234567890123456
      📤 请求: { ... }
      📥 响应: { ... }
    
  4. 点击浏览器工具栏中的插件图标,打开弹窗查看所有解密记录

注意事项

重要:解密功能需要从页面获取解密函数

由于项目代码没有暴露解密工具,插件需要从页面环境获取解密函数。有以下几种方案:

方案1从页面模块系统获取推荐

插件会尝试注入脚本到页面,访问页面的模块系统来获取 Decrypt 函数。

如果这种方式不起作用,需要:

方案2修改插件添加 CryptoJS 支持

  1. 下载 CryptoJS 库:https://cdnjs.cloudflare.com/ajax/libs/crypto-js/4.1.1/crypto-js.min.js

  2. 将 CryptoJS 库放入 browser-extension 文件夹

  3. 修改 manifest.json,添加:

    "web_accessible_resources": [
      {
        "resources": ["crypto-js.min.js"],
        "matches": ["<all_urls>"]
      }
    ]
    
  4. 修改 content-script.js,在开头加载 CryptoJS

    // 从本地加载 CryptoJS
    const script = document.createElement('script');
    script.src = chrome.runtime.getURL('crypto-js.min.js');
    script.onload = function() {
      // CryptoJS 加载完成
    };
    document.head.appendChild(script);
    

方案3临时修改项目代码不推荐

如果需要最简单的方式,可以临时修改项目代码暴露解密工具:

src/utils/request.ts 的末尾添加:

if (typeof window !== 'undefined') {
  (window as any).__DECRYPT_TOOLS__ = {
    Decrypt,
    Encrypt,
    getMap: () => map,
    getKey: (url: string, uuid: string) => {
      return map?.[url + '/' + uuid]?.timestampKey;
    }
  };
}

故障排查

插件没有反应

  1. 检查控制台是否有错误信息
  2. 确认页面已完全加载
  3. 检查是否有 XHR 请求发生

解密失败

  1. 检查是否能从页面获取解密函数
  2. 查看控制台的错误信息
  3. 尝试使用方案2或方案3

插件图标不显示

  1. 确认图标文件存在
  2. 检查 manifest.json 中的图标路径
  3. 重新加载插件

卸载

  1. 访问扩展管理页面
  2. 找到"XHR 请求解密工具"
  3. 点击"移除"按钮