From 80b0a1ff61f4ec0f94042fcef457119dbca2d697 Mon Sep 17 00:00:00 2001
From: violettools <violettools.site@gmail.com>
Date: Fri, 23 Jan 2026 14:58:33 +0800
Subject: [PATCH] feat: add browser extension for GitHub download acceleration

---
 CloudflareSpeedTest                 |   1 -
 browser-extension/README.md         |  18 +++
 browser-extension/content.css       |  80 ++++++++++++
 browser-extension/content.js        | 189 ++++++++++++++++++++++++++++
 browser-extension/icons/icon.svg    |  11 ++
 browser-extension/icons/icon128.png | Bin 0 -> 2143 bytes
 browser-extension/icons/icon16.png  | Bin 0 -> 291 bytes
 browser-extension/icons/icon48.png  | Bin 0 -> 802 bytes
 browser-extension/manifest.json     |  39 ++++++
 browser-extension/popup.js          |  55 ++++++++
 test.py                             |  19 +--
 11 files changed, 404 insertions(+), 8 deletions(-)
 delete mode 160000 CloudflareSpeedTest
 create mode 100644 browser-extension/README.md
 create mode 100644 browser-extension/content.css
 create mode 100644 browser-extension/content.js
 create mode 100644 browser-extension/icons/icon.svg
 create mode 100644 browser-extension/icons/icon128.png
 create mode 100644 browser-extension/icons/icon16.png
 create mode 100644 browser-extension/icons/icon48.png
 create mode 100644 browser-extension/manifest.json
 create mode 100644 browser-extension/popup.js

diff --git a/CloudflareSpeedTest b/CloudflareSpeedTest
deleted file mode 160000
index 6eaacd6..0000000
--- a/CloudflareSpeedTest
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit 6eaacd6b2ca37fd43fbb9a9d5d89c94ff96dc162
diff --git a/browser-extension/README.md b/browser-extension/README.md
new file mode 100644
index 0000000..6be49f0
--- /dev/null
+++ b/browser-extension/README.md
@@ -0,0 +1,18 @@
+# CFspider GitHub 加速扩展
+
+CFspider 项目附带的浏览器扩展，用于加速 GitHub 文件下载。
+
+## 安装
+
+1. 打开 Chrome，访问 `chrome://extensions/`
+2. 开启「开发者模式」
+3. 点击「加载已解压的扩展程序」
+4. 选择此 `browser-extension` 文件夹
+
+## 配置
+
+点击扩展图标，填写 Workers 地址和 UUID，保存即可。
+
+## 使用
+
+访问 GitHub Releases 页面，下载链接旁会显示「加速」按钮。
diff --git a/browser-extension/content.css b/browser-extension/content.css
new file mode 100644
index 0000000..796a9f5
--- /dev/null
+++ b/browser-extension/content.css
@@ -0,0 +1,80 @@
+/* CFspider GitHub 加速按钮样式 */
+
+.cfspider-btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  margin-left: 8px;
+  padding: 4px 10px;
+  background: linear-gradient(135deg, #00d4ff 0%, #7b2cbf 100%);
+  color: #fff !important;
+  font-size: 12px;
+  font-weight: 500;
+  border-radius: 6px;
+  text-decoration: none !important;
+  cursor: pointer;
+  transition: all 0.2s ease;
+  vertical-align: middle;
+  white-space: nowrap;
+  box-shadow: 0 2px 8px rgba(0, 212, 255, 0.3);
+}
+
+.cfspider-btn:hover {
+  transform: translateY(-1px);
+  box-shadow: 0 4px 12px rgba(0, 212, 255, 0.4);
+  opacity: 0.95;
+}
+
+.cfspider-btn:active {
+  transform: translateY(0);
+}
+
+.cfspider-btn svg {
+  flex-shrink: 0;
+}
+
+.cfspider-btn.loading {
+  pointer-events: none;
+  opacity: 0.8;
+}
+
+.cfspider-btn .spinner {
+  animation: cfspider-spin 1s linear infinite;
+}
+
+@keyframes cfspider-spin {
+  from {
+    transform: rotate(0deg);
+  }
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+/* GitHub Releases 页面特殊适配 */
+.release-main-section .cfspider-btn {
+  margin-left: 12px;
+}
+
+/* Assets 列表适配 */
+.Box-row .cfspider-btn {
+  margin-left: 8px;
+}
+
+/* 代码下载按钮适配 */
+.get-repo-btn + .cfspider-btn,
+.btn-primary + .cfspider-btn {
+  margin-left: 8px;
+}
+
+/* 暗色主题适配 */
+[data-color-mode="dark"] .cfspider-btn,
+.dark .cfspider-btn {
+  box-shadow: 0 2px 8px rgba(0, 212, 255, 0.2);
+}
+
+[data-color-mode="dark"] .cfspider-btn:hover,
+.dark .cfspider-btn:hover {
+  box-shadow: 0 4px 12px rgba(0, 212, 255, 0.3);
+}
+
diff --git a/browser-extension/content.js b/browser-extension/content.js
new file mode 100644
index 0000000..efeb5f1
--- /dev/null
+++ b/browser-extension/content.js
@@ -0,0 +1,189 @@
+// CFspider GitHub 加速 - Content Script
+
+(function() {
+  'use strict';
+  
+  let config = { workersUrl: '', uuid: '', enabled: true };
+  
+  // GitHub 下载链接匹配模式
+  const GITHUB_DOWNLOAD_PATTERNS = [
+    /https:\/\/github\.com\/[^\/]+\/[^\/]+\/releases\/download\/.+/,
+    /https:\/\/github\.com\/[^\/]+\/[^\/]+\/archive\/.+/,
+    /https:\/\/github\.com\/[^\/]+\/[^\/]+\/raw\/.+/,
+    /https:\/\/objects\.githubusercontent\.com\/.+/,
+    /https:\/\/raw\.githubusercontent\.com\/.+/,
+    /https:\/\/codeload\.github\.com\/.+/,
+    /https:\/\/github\.com\/[^\/]+\/[^\/]+\/suites\/\d+\/artifacts\/.+/
+  ];
+  
+  // 检查是否是 GitHub 下载链接
+  function isGitHubDownloadLink(url) {
+    return GITHUB_DOWNLOAD_PATTERNS.some(pattern => pattern.test(url));
+  }
+  
+  // 生成加速链接
+  function generateAcceleratedUrl(originalUrl) {
+    if (!config.workersUrl || !config.uuid) return null;
+    
+    // 构建代理 URL
+    const workersHost = config.workersUrl.replace(/^https?:\/\//, '').replace(/\/$/, '');
+    const encodedUrl = encodeURIComponent(originalUrl);
+    
+    // 使用 /proxy API
+    return `https://${workersHost}/proxy?url=${encodedUrl}&method=GET`;
+  }
+  
+  // 创建加速按钮
+  function createAccelerateButton(link) {
+    // 检查是否已添加按钮
+    if (link.nextElementSibling?.classList.contains('cfspider-btn')) return;
+    if (link.parentElement.querySelector('.cfspider-btn')) return;
+    
+    const btn = document.createElement('a');
+    btn.className = 'cfspider-btn';
+    btn.innerHTML = `
+      <svg viewBox="0 0 16 16" width="14" height="14" fill="currentColor">
+        <path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Zm4.879-2.773 4.264 2.559a.25.25 0 0 1 0 .428l-4.264 2.559A.25.25 0 0 1 6 10.559V5.442a.25.25 0 0 1 .379-.215Z"/>
+      </svg>
+      加速
+    `;
+    btn.title = 'CFspider 加速下载';
+    btn.href = generateAcceleratedUrl(link.href) || '#';
+    btn.target = '_blank';
+    
+    // 点击事件
+    btn.addEventListener('click', async (e) => {
+      e.preventDefault();
+      e.stopPropagation();
+      
+      if (!config.workersUrl || !config.uuid) {
+        alert('请先在 CFspider 扩展中配置 Workers 地址和 UUID');
+        return;
+      }
+      
+      // 开始下载
+      const acceleratedUrl = generateAcceleratedUrl(link.href);
+      if (acceleratedUrl) {
+        // 显示加载状态
+        btn.classList.add('loading');
+        btn.innerHTML = `
+          <svg class="spinner" viewBox="0 0 16 16" width="14" height="14" fill="currentColor">
+            <path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Z" opacity="0.3"/>
+            <path d="M8 0a8 8 0 0 1 8 8h-1.5A6.5 6.5 0 0 0 8 1.5V0Z"/>
+          </svg>
+          加速中...
+        `;
+        
+        try {
+          // 直接打开加速链接
+          window.open(acceleratedUrl, '_blank');
+          
+          setTimeout(() => {
+            btn.classList.remove('loading');
+            btn.innerHTML = `
+              <svg viewBox="0 0 16 16" width="14" height="14" fill="currentColor">
+                <path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Zm4.879-2.773 4.264 2.559a.25.25 0 0 1 0 .428l-4.264 2.559A.25.25 0 0 1 6 10.559V5.442a.25.25 0 0 1 .379-.215Z"/>
+              </svg>
+              加速
+            `;
+          }, 1500);
+        } catch (err) {
+          console.error('CFspider 加速失败:', err);
+          btn.classList.remove('loading');
+          btn.innerHTML = '失败';
+          setTimeout(() => {
+            btn.innerHTML = `
+              <svg viewBox="0 0 16 16" width="14" height="14" fill="currentColor">
+                <path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Zm4.879-2.773 4.264 2.559a.25.25 0 0 1 0 .428l-4.264 2.559A.25.25 0 0 1 6 10.559V5.442a.25.25 0 0 1 .379-.215Z"/>
+              </svg>
+              加速
+            `;
+          }, 2000);
+        }
+      }
+    });
+    
+    // 插入按钮
+    if (link.parentElement.classList.contains('d-flex') || 
+        link.closest('.Box-row') || 
+        link.closest('.release-main-section')) {
+      link.parentElement.insertBefore(btn, link.nextSibling);
+    } else {
+      link.insertAdjacentElement('afterend', btn);
+    }
+  }
+  
+  // 扫描并处理下载链接
+  function scanDownloadLinks() {
+    if (!config.enabled) return;
+    
+    const links = document.querySelectorAll('a[href]');
+    
+    links.forEach(link => {
+      if (isGitHubDownloadLink(link.href)) {
+        createAccelerateButton(link);
+      }
+    });
+  }
+  
+  // 加载配置
+  async function loadConfig() {
+    try {
+      const result = await chrome.storage.sync.get(['workersUrl', 'uuid', 'enabled']);
+      config = {
+        workersUrl: result.workersUrl || '',
+        uuid: result.uuid || '',
+        enabled: result.enabled !== false
+      };
+    } catch (e) {
+      console.error('CFspider: 加载配置失败', e);
+    }
+  }
+  
+  // 监听配置更新
+  chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
+    if (message.type === 'CONFIG_UPDATED') {
+      config = message.config;
+      scanDownloadLinks();
+    }
+  });
+  
+  // 监听 DOM 变化
+  const observer = new MutationObserver((mutations) => {
+    let shouldScan = false;
+    
+    mutations.forEach(mutation => {
+      if (mutation.addedNodes.length > 0) {
+        shouldScan = true;
+      }
+    });
+    
+    if (shouldScan) {
+      setTimeout(scanDownloadLinks, 100);
+    }
+  });
+  
+  // 初始化
+  async function init() {
+    await loadConfig();
+    scanDownloadLinks();
+    
+    // 监听 DOM 变化
+    observer.observe(document.body, {
+      childList: true,
+      subtree: true
+    });
+    
+    // 页面导航时重新扫描（GitHub 使用 pjax）
+    document.addEventListener('pjax:end', scanDownloadLinks);
+    document.addEventListener('turbo:load', scanDownloadLinks);
+  }
+  
+  // 页面加载完成后初始化
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', init);
+  } else {
+    init();
+  }
+})();
+
diff --git a/browser-extension/icons/icon.svg b/browser-extension/icons/icon.svg
new file mode 100644
index 0000000..5160d06
--- /dev/null
+++ b/browser-extension/icons/icon.svg
@@ -0,0 +1,11 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128">
+  <defs>
+    <linearGradient id="grad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#00d4ff"/>
+      <stop offset="100%" style="stop-color:#7b2cbf"/>
+    </linearGradient>
+  </defs>
+  <rect width="128" height="128" rx="24" fill="url(#grad)"/>
+  <text x="64" y="78" text-anchor="middle" font-family="Arial Black, sans-serif" font-size="48" font-weight="bold" fill="#fff">CF</text>
+</svg>
+
diff --git a/browser-extension/icons/icon128.png b/browser-extension/icons/icon128.png
new file mode 100644
index 0000000000000000000000000000000000000000..759300bd6a634a56929f7a549cbaef834f8f8f56
GIT binary patch
literal 2143
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

literal 0
HcmV?d00001

diff --git a/browser-extension/icons/icon16.png b/browser-extension/icons/icon16.png
new file mode 100644
index 0000000000000000000000000000000000000000..52cde2a4bdf1250f16a2199a94f2b63561548b8a
GIT binary patch
literal 291
zcmV+;0o?wHP)<h;3K|Lk000e1NJLTq000mG000mO1^@s6AM^iV0002$Nkl<Zc${No
zfPpP{{xgsQd{h`g6cbsRk@PT<r5On@QKFgp1{5m^Fg$lrV0h=I$WWpr02Ygo;$isj
ztqjL4>Ov?6u)r9uBAg6?65I?XN1lNBv-Lz7w!i)cX6Igg!!YH+N31Sjgau-^rZB^<
z*WVa+zxj@$0OW$@hT?F(?B0hAPk#Ktbiu#>3=Axc;HU)yQ8s3V-~ay;bO95LvHQ(8
zhH6zo1_e$Q1~E2fh9w4K47$8*xWW$8fIV-%gS~LZMuy>rgB-)5cRv^ozxzSZ0LI~v
pkbEGyiY(xx!U%BzIfg*>0005wO)k6d6dC{k002ovPDHLkV1nGacpv}(

literal 0
HcmV?d00001

diff --git a/browser-extension/icons/icon48.png b/browser-extension/icons/icon48.png
new file mode 100644
index 0000000000000000000000000000000000000000..aaddab7402645165a30721ccb565bbe957de37e4
GIT binary patch
literal 802
zcmV+-1Ks?IP)<h;3K|Lk000e1NJLTq001xm001xu1^@s6R|5Hm0008%Nkl<Zc%1E;
z-Ahw(7{|Zo+1YU~&79lPd<8W{ia@9kyU{3mVUQMdQ&1QE0bN8CM1*zQg%@7g%avUO
zL6BEP*hQs<-V{V-VLG*;&grH*y6v3B`E6k;9gniP{iF{ZcHlfa`#$f7Z36V@`JO;7
z;H?q<bxFu+;RYNLxDc-62yrKVmDXhkIEA>2{vT4BxzB*WW%U1o`wS2`hrl@m&LMCP
zfpZ9)BW~tR)iyIOmN{_3V?()Bgi9g>V=6v|qIl|`$0J`DOX|w?Vj%(Y$tuI2(J?%S
zE1##+>wsAhaHp;i*QyKHW2`1}M2^EJ$5CMwanx;P$JMF=v<>+2DI7(n5sey>06aff
zjN={~W@0LCeVxI>u@GcsInpgID?0bNQNKgNtHu%>cr%7kIlkszE&UUC9gx%FfZ-mv
zQSD^n15pLdedFjHnOh-Vqc<R<xo?7H#3Pw-uik}BLq?3;k_k8WINAB_p`dPQOhy&7
z4+ZgUA;vPLWiIO_bhg-@Y(gc0uF=rC_V;}uc5DS?#Hh(>VXytOi)*G!wh@gORa%o~
z!;!TOxfyyJOLVWd4f^rSzmUERNU1`eS5)L0q7fslF*Tg#^epZzAETqGSzck;)Z)%4
zWW?y@bTV3vP7AE2_2*)~NcefA65S0&sI!}qbq8KdMG%Us$Rh!l${g$3Unq63#y_{)
z&UQi89avHmY&mJ%t#j!{RTJJ`n_PMid|^zb`X^J+MxGAe1s73hCiERH!{ze)73HLz
zwHDj)wy6{@$%G$~7_NT_Ak&CO4daOfj=i72<Ax%fF0!L*zXu(A-Aw3$qN3I=G3PWs
z%r4=~pdYgtE+35zjg^R!K<j`Xr*_$JzSMz3JM&OuGegro9aYgY8A11W7*Br9W2+Xn
z@c)agEJNTN0_PAohrl@m&LMCPfpbXjN93HxTO(|P3~2C}1#eRGHpu{QS@14v-DZFG
gz$$XZ5uNJz4S&r0<Y}W{oB#j-07*qoM6N<$f;EhFH~;_u

literal 0
HcmV?d00001

diff --git a/browser-extension/manifest.json b/browser-extension/manifest.json
new file mode 100644
index 0000000..21b7d53
--- /dev/null
+++ b/browser-extension/manifest.json
@@ -0,0 +1,39 @@
+{
+  "manifest_version": 3,
+  "name": "CFspider GitHub 加速",
+  "version": "1.0.0",
+  "description": "使用 CFspider Workers 加速 GitHub 文件下载",
+  "author": "CFspider",
+  "homepage_url": "https://github.com/violettoolssite/CFspider",
+  "icons": {
+    "16": "icons/icon16.png",
+    "48": "icons/icon48.png",
+    "128": "icons/icon128.png"
+  },
+  "permissions": [
+    "storage"
+  ],
+  "host_permissions": [
+    "https://github.com/*",
+    "https://objects.githubusercontent.com/*",
+    "https://raw.githubusercontent.com/*",
+    "https://codeload.github.com/*"
+  ],
+  "action": {
+    "default_popup": "popup.html",
+    "default_icon": {
+      "16": "icons/icon16.png",
+      "48": "icons/icon48.png"
+    }
+  },
+  "content_scripts": [
+    {
+      "matches": [
+        "https://github.com/*"
+      ],
+      "js": ["content.js"],
+      "css": ["content.css"]
+    }
+  ]
+}
+
diff --git a/browser-extension/popup.js b/browser-extension/popup.js
new file mode 100644
index 0000000..c2cfa79
--- /dev/null
+++ b/browser-extension/popup.js
@@ -0,0 +1,55 @@
+// 加载配置
+document.addEventListener('DOMContentLoaded', async () => {
+  const config = await chrome.storage.sync.get(['workersUrl', 'uuid', 'enabled']);
+  
+  document.getElementById('workersUrl').value = config.workersUrl || '';
+  document.getElementById('uuid').value = config.uuid || '';
+  document.getElementById('enabled').checked = config.enabled !== false;
+});
+
+// 保存配置
+document.getElementById('saveBtn').addEventListener('click', async () => {
+  const workersUrl = document.getElementById('workersUrl').value.trim();
+  const uuid = document.getElementById('uuid').value.trim();
+  const enabled = document.getElementById('enabled').checked;
+  
+  const statusEl = document.getElementById('status');
+  
+  // 验证
+  if (!workersUrl) {
+    statusEl.textContent = '请填写 Workers 地址';
+    statusEl.className = 'status error';
+    return;
+  }
+  
+  if (!uuid) {
+    statusEl.textContent = '请填写 UUID';
+    statusEl.className = 'status error';
+    return;
+  }
+  
+  // UUID 格式验证
+  const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+  if (!uuidRegex.test(uuid)) {
+    statusEl.textContent = 'UUID 格式不正确';
+    statusEl.className = 'status error';
+    return;
+  }
+  
+  // 保存
+  await chrome.storage.sync.set({ workersUrl, uuid, enabled });
+  
+  statusEl.textContent = '配置已保存';
+  statusEl.className = 'status success';
+  
+  // 通知 content script 更新配置
+  const tabs = await chrome.tabs.query({ active: true, currentWindow: true });
+  if (tabs[0] && tabs[0].url.includes('github.com')) {
+    chrome.tabs.sendMessage(tabs[0].id, { type: 'CONFIG_UPDATED', config: { workersUrl, uuid, enabled } });
+  }
+  
+  setTimeout(() => {
+    statusEl.className = 'status';
+  }, 2000);
+});
+
diff --git a/test.py b/test.py
index c3cafc9..4f04e5e 100644
--- a/test.py
+++ b/test.py
@@ -1,11 +1,16 @@
 import cfspider
+import os
 
-# 直接使用海外代理
-response = cfspider.get(
+# 禁用系统代理
+os.environ['NO_PROXY'] = '*'
+os.environ['no_proxy'] = '*'
+
+# VLESS 模式测试（需要 UUID）
+res = cfspider.get(
     "https://httpbin.org/ip",
-    proxies={
-        "http": "http://us.cliproxy.io:3010",
-        "https": "http://2e75108689-region-JP:nf9ssu7a@us.cliproxy.io:3010"
-    }
+    cf_proxies="https://ip.kami666.xyz",
+    uuid="c373c80c-58e4-4e64-8db5-40096905ec58",
 )
-print(response.json())
\ No newline at end of file
+print(f"状态码: {res.status_code}")
+print(f"出口 IP: {res.text}")
+print(f"CF 节点: {res.cf_colo}")