first commit

2026-01-29 12:03:28 +08:00
commit 3ecfab1212
18 changed files with 34678 additions and 0 deletions
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -0,0 +1,131 @@
+# 安装指南
+
+## 安装步骤
+
+### 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`，添加：
+   ```json
+   "web_accessible_resources": [
+     {
+       "resources": ["crypto-js.min.js"],
+       "matches": ["<all_urls>"]
+     }
+   ]
+   ```
+
+4. 修改 `content-script.js`，在开头加载 CryptoJS：
+   ```javascript
+   // 从本地加载 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` 的末尾添加：
+```typescript
+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. 点击"移除"按钮
+