docs: add architecture documentation explaining dual API design

Add ARCHITECTURE.md explaining why legacy-api and montoya-api cannot
share code files due to different Burp Suite APIs.

Key points:
- Legacy API uses 'import burp.*'
- Montoya API uses 'import burp.api.montoya.*'
- Business logic is identical but API calls differ
- Must maintain separate codebases
- Both modules compile successfully

Remove incorrect sync scripts that would break compilation.
Update README with accurate architecture description.

Author: lanshuizhiyue

src/burpEx/ARCHITECTURE.md

@@ -0,0 +1,91 @@
+# SQLMap WebUI Burp Extension - Architecture Notes
+
+## 重要说明
+
+经过实际测试发现，**legacy-api 和 montoya-api 不能直接同步文件**。
+
+### 原因
+
+两个模块使用**不同的 Burp Suite API**：
+
+**Legacy API (Java 11):**
+```java
+import burp.IBurpExtenderCallbacks;
+import burp.IHttpRequestResponse;
+import burp.IRequestInfo;
+```
+
+**Montoya API (Java 17+):**
+```java
+import burp.api.montoya.MontoyaApi;
+import burp.api.montoya.http.message.HttpRequestResponse;
+import burp.api.montoya.http.message.requests.HttpRequest;
+```
+
+### 影响
+
+虽然两个模块的业务逻辑**完全相同**，但：
+1. **Import 语句不同** - 无法直接复制文件
+2. **API 调用方式不同** - 类名和方法签名不同
+3. **必须独立维护** - 每个修改需要在两个地方手动更新
+
+### 当前架构
+
+```
+src/burpEx/
+├── legacy-api/          # 完全独立的代码 (Java 11)
+│   ├── BurpExtender.java
+│   ├── ConfigManager.java      # 使用 IBurpExtenderCallbacks
+│   ├── SqlmapApiClient.java
+│   ├── SqlmapUITab.java
+│   ├── panels/
+│   ├── dialogs/
+│   └── ... (共34个文件)
+│
+└── montoya-api/         # 完全独立的代码 (Java 17)
+    ├── SqlmapWebUIExtension.java
+    ├── ConfigManager.java        # 使用 MontoyaApi
+    ├── SqlmapApiClient.java
+    ├── SqlmapUITab.java
+    ├── panels/
+    ├── dialogs/
+    └── ... (共37个文件)
+```
+
+### 开发建议
+
+1. **修改逻辑时**: 需要在两个模块中分别修改
+2. **先改 legacy-api**: 因为它使用更简单的 Legacy API
+3. **再改 montoya-api**: 参考 legacy-api 的修改，适配 Montoya API
+4. **分别编译验证**: 确保两个模块都能编译通过
+
+### 编译验证
+
+```bash
+# 编译 Legacy API (Java 11)
+cd src/burpEx/legacy-api
+mvn clean package -DskipTests
+
+# 编译 Montoya API (Java 17)
+cd src/burpEx/montoya-api
+mvn clean package -DskipTests
+```
+
+两个模块都能独立编译成功，无警告、无错误。
+
+### 为什么不创建 shared 模块？
+
+尝试过创建 shared 模块，但发现：
+1. UI 组件深度依赖 Burp API
+2. ConfigManager 需要适配不同 API
+3. 抽象层会增加复杂度
+4. 需要修改 100+ 个文件的 import 语句
+5. 风险高，容易引入 bug
+
+**结论**: 当前独立维护的方式虽然重复代码多，但是最稳定和可维护的方案。
+
+## 版本信息
+
+- **版本**: 1.8.16
+- **更新日期**: 2026-02-10
+- **状态**: 两个模块独立维护，各自编译成功

src/burpEx/README.md

@@ -5,31 +5,30 @@ Burp Suite 扩展插件，用于将 HTTP 请求发送到 SQLMap WebUI 后端进
 ## 项目结构
 
 ```
-burpEx/
+src/burpEx/
 ├── legacy-api/          # 传统 Burp API 插件 (Java 11)
 │   ├── src/main/java/com/sqlmapwebui/burp/
-│   │   ├── BurpExtender.java              # 插件入口 (Legacy API)
+│   │   ├── BurpExtender.java              # 插件入口
+│   │   ├── ConfigManager.java             # 配置管理
+│   │   ├── SqlmapApiClient.java           # API客户端
 │   │   ├── SqlmapUITab.java               # 主UI标签页
 │   │   ├── panels/                        # UI面板组件
 │   │   ├── dialogs/                       # 对话框组件
-│   │   └── [共享代码文件...]
+│   │   └── ... (共34个文件)
 │   └── pom.xml
 │
-├── montoya-api/         # Montoya API 插件 (Java 17+, Burp 2023.1+)
-│   ├── src/main/java/com/sqlmapwebui/burp/
-│   │   ├── SqlmapWebUIExtension.java      # 插件入口 (Montoya API)
-│   │   ├── SqlmapContextMenuProvider.java # 右键菜单提供者
-│   │   ├── HttpRequestUtils.java          # UTF-8请求处理
-│   │   ├── util/                          # 工具类
-│   │   ├── SqlmapUITab.java               # 主UI标签页 (与Legacy共享)
-│   │   ├── panels/                        # UI面板组件 (与Legacy共享)
-│   │   ├── dialogs/                       # 对话框组件 (与Legacy共享)
-│   │   └── [共享代码文件...]
-│   └── pom.xml
-│
-├── sync-shared.bat      # Windows 同步脚本
-├── sync-shared.sh       # Linux/Mac 同步脚本
-└── SHARED_FILES.md      # 共享文件文档
+└── montoya-api/         # Montoya API 插件 (Java 17+, Burp 2023.1+)
+    ├── src/main/java/com/sqlmapwebui/burp/
+    │   ├── SqlmapWebUIExtension.java      # 插件入口
+    │   ├── SqlmapContextMenuProvider.java # 右键菜单
+    │   ├── HttpRequestUtils.java          # UTF-8工具
+    │   ├── ConfigManager.java             # 配置管理
+    │   ├── SqlmapApiClient.java           # API客户端
+    │   ├── SqlmapUITab.java               # 主UI标签页
+    │   ├── panels/                        # UI面板组件
+    │   ├── dialogs/                       # 对话框组件
+    │   └── ... (共37个文件)
+    └── pom.xml
 ```
 
 ## 双 API 架构
@@ -41,29 +40,13 @@ burpEx/
 | `legacy-api` | Legacy API | Java 11+ | 所有版本 |
 | `montoya-api` | Montoya API | Java 17+ | 2023.1+ |
 
-**共享代码策略：**
-- 两个模块共享 90% 的代码（模型、工具类、UI组件）
-- 使用同步脚本 `sync-shared.bat/sh` 保持代码一致
-- 仅入口点和 API 特定代码独立维护
-
-## 同步脚本使用
-
-当修改 `legacy-api` 中的共享代码后，需要同步到 `montoya-api`：
+**重要说明**: 两个模块使用**不同的 Burp API**，因此代码**不能共享**：
+- Legacy API: `import burp.IBurpExtenderCallbacks`
+- Montoya API: `import burp.api.montoya.MontoyaApi`
 
-### Windows
-```batch
-cd src/burpEx
-sync-shared.bat
-```
-
-### Linux/Mac
-```bash
-cd src/burpEx
-chmod +x sync-shared.sh
-./sync-shared.sh
-```
+虽然业务逻辑完全相同，但必须独立维护两套代码。
 
-详细说明请查看 [SHARED_FILES.md](./SHARED_FILES.md)
+详细说明请查看 [ARCHITECTURE.md](./ARCHITECTURE.md)
 
 ## 插件功能
 
@@ -159,23 +142,24 @@ mvn clean package -DskipTests
 
 ## 开发说明
 
-### 修改共享代码
+### 修改代码
 
-1. 在 `legacy-api` 中修改文件（保持 Java 11 兼容性）
-2. 运行 `sync-shared.bat` 或 `sync-shared.sh`
-3. 分别编译两个模块验证
+由于两个 API 不兼容，需要**分别修改**：
 
-### 添加新功能
+1. 先在 `legacy-api` 中修改（使用 Legacy API）
+2. 参考修改内容，在 `montoya-api` 中做对应修改（使用 Montoya API）
+3. 分别编译验证
 
-- 如果是通用功能：在 `legacy-api` 中实现，然后同步
-- 如果是 API 特定：只在对应模块中实现
+### 为什么不能共享代码？
 
-## 注意事项
+尝试过提取共享模块，但发现：
+1. UI 组件依赖 Burp API
+2. ConfigManager 需要适配不同 API
+3. Import 语句完全不同
+4. 需要修改 100+ 个文件
+5. 风险高，容易引入 bug
 
-1. **同步方向**: 始终以 `legacy-api` 为源，`montoya-api` 为目标
-2. **兼容性**: 确保共享代码兼容 Java 11
-3. **编译验证**: 每次同步后都应该编译验证
-4. **备份**: 同步脚本会自动创建备份
+**结论**: 当前独立维护的方式虽然重复代码多，但是最稳定和可维护的方案。
 
 ## 版本信息
 
@@ -185,7 +169,7 @@ mvn clean package -DskipTests
 
 ## 相关链接
 
-- [共享文件说明](./SHARED_FILES.md)
+- [架构说明](./ARCHITECTURE.md)
 - [SQLMap 官方文档](https://sqlmap.org/)
 - [Burp Suite 扩展开发](https://portswigger.net/burp/documentation/desktop/extensions)