Github代理功能测试成功

Co-authored-by: Copilot <copilot@github.com>

README.md

@@ -1,3 +1,110 @@
+
 # Hugs-Proxy
 
-一个轻量的学术资源加速/反代下载小工具：把 GitHub 的下载链接通过本地 HTTP 服务转发，从而在某些网络环境下提升可用性。
+> 本项目目前支持Github,后面可能会增加HuggingFace......
+
+一个**轻量的 GitHub 资源加速/反代下载**小工具：把 GitHub 的下载链接（Release、Archive、Raw、Gist、部分 git/info 相关请求）通过本地 HTTP 服务转发，从而在某些网络环境下提升可用性。
+
+本项目默认只监听 `127.0.0.1`，更改为对外监听前请务必阅读“安全提示”。
+
+## 特性
+
+- 支持代理的链接类型（不匹配会返回 403）：
+	- `github.com/<owner>/<repo>/releases/...`
+	- `github.com/<owner>/<repo>/archive/...`
+	- `github.com/<owner>/<repo>/blob/...`（会自动改写为 `.../raw/...` 进行下载）
+	- `github.com/<owner>/<repo>/raw/...`
+	- `github.com/<owner>/<repo>/info/...`、`github.com/<owner>/<repo>/git-...`
+	- `raw.githubusercontent.com/<owner>/<repo>/...`
+	- `gist.github.com/...`、`gist.githubusercontent.com/...`
+- 白名单/黑名单（先白名单，后黑名单）
+- 大文件保护：响应体 `Content-Length` 超过 1GB 时直接 302 重定向到源站，避免本机带宽/内存压力
+- 处理上游重定向：对可识别的 GitHub 下载链接会改写 `Location`，让跳转继续走本代理
+
+## 快速开始
+
+### 1) 运行
+
+在仓库根目录执行：
+
+```bash
+go run .
+```
+
+默认监听：`127.0.0.1:2005`
+
+### 2) 使用方式
+
+访问路径就是你要代理的目标 URL（去掉前面的 `/`）：
+
+```text
+http://127.0.0.1:2005/<目标URL>
+```
+
+目标 URL 可以写全（推荐），也可以省略 scheme（会自动补 `https://`）。示例：
+
+- Release 文件：
+
+```text
+http://127.0.0.1:2005/https://github.com/OWNER/REPO/releases/download/v1.0.0/app-darwin-amd64.zip
+```
+
+- 仓库归档（archive）：
+
+```text
+http://127.0.0.1:2005/https://github.com/OWNER/REPO/archive/refs/heads/main.zip
+```
+
+- Raw 文件（也可以给 `blob`，服务端会自动替换为 `raw`）：
+
+```text
+http://127.0.0.1:2005/https://github.com/OWNER/REPO/blob/main/README.md
+```
+
+- raw.githubusercontent.com：
+
+```text
+http://127.0.0.1:2005/https://raw.githubusercontent.com/OWNER/REPO/main/README.md
+```
+
+如果你传入的链接不属于上面支持的 GitHub 资源格式，会返回：`403 Invalid input.`
+
+## 配置
+
+目前所有配置都在 [main.go](main.go) 顶部的“配置区域”，修改后重新运行即可：
+
+- `host`：监听地址（默认 `127.0.0.1`）
+- `port`：监听端口（默认 `2005`）
+- `sizeLimit`：大文件阈值（默认 `1GB`）
+- `whiteListStr`：白名单（多行字符串，每行一条规则）
+- `blackListStr`：黑名单（多行字符串，每行一条规则）
+
+### 白名单/黑名单规则
+
+每行一条，支持三种写法：
+
+- `user1`：匹配/封禁 `user1` 下的所有仓库
+- `user1/repo1`：匹配/封禁 `user1/repo1`
+- `*/repo1`：匹配/封禁所有名为 `repo1` 的仓库
+
+判定顺序：
+
+1. **白名单优先生效**：如果白名单非空，则必须至少命中一条白名单规则，否则直接拒绝（403）。
+2. **再匹配黑名单**：命中任意黑名单规则则拒绝（403）。
+
+
+
+## 常见问题
+
+### 为什么有时会直接跳转到 GitHub？
+
+当上游响应 `Content-Length` 大于 `sizeLimit`（默认 1GB）时，程序会返回 302 重定向到目标 URL，而不是继续转发大文件内容。
+
+### 支持 Git Clone / Git LFS 吗？
+
+本项目主要面向“下载/获取资源”。它只放行并代理部分与 GitHub 资源下载相关的 URL 形态；不保证覆盖完整的 Git 协议或 Git LFS 场景。
+
+## License
+
+详见 License 文件
+