# mediaProxy (goProxy) 开发与调试指南

本文档详细介绍了 drpy-plugin 中 `mediaProxy` (由 Go 编写的视频代理服务，即 `goProxy`) 的完整开发、测试、调试及编译打包流程。

## 1. 环境准备

确保您的本地开发环境已安装以下工具：
- **Go**: 建议 1.21 或更高版本（用于编译 `proxy.go`）
- **Python**: 3.x（用于运行模拟播放器及测试脚本）
- **PowerShell**: Windows 环境默认自带（用于执行编译及打包脚本）
- **Git**: 用于版本控制
- **UPX**: 可选，用于压缩编译后的可执行文件（在 Android 环境下能大幅缩小体积）

## 2. 本地启动代理服务

在开发阶段，我们直接使用 Go 命令在本地启动代理服务。服务默认运行在 `5575` 端口。

```powershell
cd mediaProxy
go run proxy.go -port 5575
```

如果需要查看更详细的调试信息（例如每个分片的下载情况、错误日志），请添加 `-debug` 参数：

```powershell
go run proxy.go -debug -port 5575
```

## 3. 测试与模拟播放器请求

在本地服务启动后，需要验证代理是否能正确处理视频的完整播放以及拖拽操作（即 HTTP Range 请求）。

### 3.1 准备测试数据

在 `mediaProxy` 目录下创建一个名为 `playinfo.txt` 的文件，将你需要测试的视频直链（例如迅雷等网盘解析出的原始播放链接）粘贴进去。

### 3.2 运行测试脚本

我们编写了两个 Python 脚本来模拟不同场景的测试：

1. **基础流程测试 (`test_proxy.py`)**: 
   该脚本模拟了完整下载、拖拽到中部、拖拽到尾部以及拖拽后继续播放四个场景。
   ```powershell
   python test_proxy.py
   ```
   **预期结果**: 各个场景返回 `206 Partial Content`，并且能正确下载对应字节数的数据。

2. **播放器模拟测试 (`test_player_sim.py`)**:
   该脚本更贴近实际播放器的行为，通过读取 `playinfo.txt` 中的链接，发起不同 `Range` 的请求，并打印响应头，方便检查 `Content-Range` 和 `Content-Length` 是否正确。
   ```powershell
   python test_player_sim.py
   ```

## 4. 调试错误与代码修改

当遇到播放截断、无法拖拽等问题时，通常是因为 HTTP Range 处理或并发控制不当。以下是常见的排查点：

- **观察 Debug 日志**: 
  检查 `go run proxy.go -debug` 输出的日志，特别关注 `statusCode`、`Range` 以及 `ProxyRead/ProxyWorker` 相关的报错。
- **416 错误处理**: 
  网盘（如迅雷）在请求到达文件末尾时常返回 `416 Range Not Satisfiable`。这**不是**一个致命错误，代理不应该直接中断。正确的做法是跳出当前分片的下载循环，平滑结束。
- **429/503 频率限制**: 
  多线程并发请求可能触发服务器的防刷机制。需要加入退避重试（Retry Backoff）机制，并在 `handleGetMethod` 中限制最大线程数（如限制为 16）。
- **Context 与协程泄漏**: 
  使用 `context.WithCancel` 控制并发任务的生命周期。当主请求结束（如用户关闭播放器）时，通过 `cancel()` 通知所有 worker 退出，避免后台持续下载导致内存和连接泄漏。

> **修改建议**: 所有代理逻辑的核心在 `ConcurrentDownload`、`ProxyRead` 以及 `ProxyWorker` 三个函数中，修改时需仔细处理 `channel` 和 `buffer` 的读写。

## 5. 编译 Android 二进制文件

在本地测试通过后，需要将 `proxy.go` 交叉编译为 Android 平台可执行文件。

在 `mediaProxy` 目录下，直接运行提供的 PowerShell 脚本：

```powershell
.\scripts\build_goproxy.ps1
```

**脚本主要工作**:
1. 设置环境变量 `GOOS=linux`，分别针对 `GOARCH=arm` (32位) 和 `GOARCH=arm64` (64位) 进行编译。
2. 禁用 CGO (`CGO_ENABLED=0`)，移除调试信息 (`-ldflags="-s -w"`) 以减小体积。
3. 输出文件存放至 `goProxy/goProxy-arm` 和 `goProxy/goProxy-arm64`。
4. (可选) 如果系统中存在 `upx` 命令，脚本会自动对编译结果进行 UPX 压缩。

## 6. 打包 custom_spider.jar

编译好的 Android 可执行文件最终需要打包进 `custom_spider.jar` 中的 `assets` 目录下供 TVBox 等客户端使用。

在 `mediaProxy` 目录下，运行打包脚本：

```powershell
.\scripts\update_jar.ps1
```

**脚本主要工作**:
1. 将 `goProxy` 目录下的 `goProxy-arm` 和 `goProxy-arm64` 添加或更新到上一级目录的 `custom_spider.jar` 的 `assets/` 路径中。
2. 自动计算更新后 `custom_spider.jar` 的 MD5 值。
3. 将生成的 MD5 值写入 `custom_spider.jar.md5` 文件中。

至此，整个开发、测试、编译、打包的闭环流程完成。你可以将生成的 `custom_spider.jar` 和 `custom_spider.jar.md5` 发布到你的源中供用户更新。