3.2 KiB
3.2 KiB
安装指南
安装步骤
1. 准备图标文件(可选)
插件需要图标文件才能正常显示。如果你暂时没有图标,可以:
- 跳过这一步,浏览器会使用默认图标
- 或者创建三个 PNG 文件:
icon16.png(16x16)icon48.png(48x48)icon128.png(128x128)
2. 在 Chrome/Edge/Brave 中安装
-
打开浏览器
-
访问扩展管理页面:
- Chrome: 在地址栏输入
chrome://extensions/ - Edge: 在地址栏输入
edge://extensions/ - Brave: 在地址栏输入
brave://extensions/
- Chrome: 在地址栏输入
-
开启右上角的"开发者模式"开关
-
点击"加载已解压的扩展程序"按钮
-
选择
browser-extension文件夹(包含 manifest.json 的文件夹) -
插件安装完成!
3. 使用插件
-
访问目标网站(你的项目)
-
打开开发者工具(F12),在控制台可以看到:
✅ XHR 解密插件已启动 -
触发一些请求后,控制台会输出解密信息:
🔓 XHR 解密 [POST] /api/example 🔑 密钥: 1234567890123456 📤 请求: { ... } 📥 响应: { ... } -
点击浏览器工具栏中的插件图标,打开弹窗查看所有解密记录
注意事项
重要:解密功能需要从页面获取解密函数
由于项目代码没有暴露解密工具,插件需要从页面环境获取解密函数。有以下几种方案:
方案1:从页面模块系统获取(推荐)
插件会尝试注入脚本到页面,访问页面的模块系统来获取 Decrypt 函数。
如果这种方式不起作用,需要:
方案2:修改插件添加 CryptoJS 支持
-
下载 CryptoJS 库:https://cdnjs.cloudflare.com/ajax/libs/crypto-js/4.1.1/crypto-js.min.js
-
将 CryptoJS 库放入
browser-extension文件夹 -
修改
manifest.json,添加:"web_accessible_resources": [ { "resources": ["crypto-js.min.js"], "matches": ["<all_urls>"] } ] -
修改
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;
}
};
}
故障排查
插件没有反应
- 检查控制台是否有错误信息
- 确认页面已完全加载
- 检查是否有 XHR 请求发生
解密失败
- 检查是否能从页面获取解密函数
- 查看控制台的错误信息
- 尝试使用方案2或方案3
插件图标不显示
- 确认图标文件存在
- 检查 manifest.json 中的图标路径
- 重新加载插件
卸载
- 访问扩展管理页面
- 找到"XHR 请求解密工具"
- 点击"移除"按钮