bro: 修复必应/百度搜索无结果，并支持网页内直接下载扩展

- 扩展改为用后台标签页真实加载搜索结果页并读取渲染后 DOM（fetchPage），
  规避搜索引擎防爬校验（百度安全验证、必应 JS 校验）导致的空结果，裸 fetch 作兜底
- 前端识别安全验证页并给出明确提示
- 搜索页提示条与设置弹层新增「下载扩展 .zip」按钮，点击即可直接下载，无需前往仓库
- 同步重建 bro-bridge.zip

Author: HiCodeHC

bro/bro-bridge.zip

@@ -242,7 +242,22 @@ main { max-width: 1080px; margin: 0 auto; padding: 26px 22px 60px; }
   margin-bottom: 18px; line-height: 1.6;
 }
 
+/* 提示条内的下载链接 */
+.banner-link {
+  display: inline-block; margin: 0 4px; padding: 1px 8px;
+  background: #fff; border: 1px solid #cfe0ff; border-radius: 999px;
+  color: var(--brand); text-decoration: none; font-size: 12px; font-weight: 600;
+  white-space: nowrap;
+}
+.banner-link:hover { background: #f2f7ff; }
+
 /* 扩展安装引导 */
+.download-row {
+  display: flex; align-items: center; gap: 10px; flex-wrap: wrap;
+  background: #f5f8ff; border: 1px solid #dbe6ff; border-radius: 10px;
+  padding: 10px 12px; margin: 10px 0 14px;
+}
+.download-row a.primary { text-decoration: none; display: inline-block; }
 .guide-list { color: var(--muted); font-size: 13px; line-height: 1.9; padding-left: 20px; margin: 8px 0 0; }
 .guide-list code, .modal-card code { background: #f3f5fb; padding: 1px 5px; border-radius: 5px; font-size: 12px; }
 #guide .state { margin: 4px 0 12px; }

bro/css/style.css

@@ -28,6 +28,45 @@ async function fetchText(url) {
   return { status: res.status, finalUrl: res.url, text };
 }
 
+// 等待标签页加载完成（status === 'complete'），带超时
+function waitForTabComplete(tabId, timeout = 25000) {
+  return new Promise((resolve, reject) => {
+    let settled = false;
+    const finish = (err) => {
+      if (settled) return;
+      settled = true;
+      chrome.tabs.onUpdated.removeListener(onUpdated);
+      clearTimeout(timer);
+      err ? reject(err) : resolve();
+    };
+    const onUpdated = (id, info) => { if (id === tabId && info.status === 'complete') finish(); };
+    chrome.tabs.onUpdated.addListener(onUpdated);
+    const timer = setTimeout(() => finish(new Error('页面加载超时')), timeout);
+    // 可能监听前就已加载完成
+    chrome.tabs.get(tabId).then((t) => { if (t && t.status === 'complete') finish(); }).catch(() => {});
+  });
+}
+
+// 后台标签页真实加载目标页，读取渲染后的 DOM。
+// 搜索引擎的防爬校验（如百度安全验证、必应 JS 校验）会拦截裸 fetch；
+// 用真实标签页加载等价于用户在浏览器里打开，可带回完整请求头、Cookie 与脚本渲染结果。
+async function fetchViaTab(url, { timeout = 25000, settle = 700 } = {}) {
+  const tab = await chrome.tabs.create({ url, active: false });
+  try {
+    await waitForTabComplete(tab.id, timeout);
+    await sleep(settle); // 等待结果脚本渲染进 DOM
+    const injected = await chrome.scripting.executeScript({
+      target: { tabId: tab.id },
+      func: () => document.documentElement.outerHTML,
+    });
+    const html = injected && injected[0] ? injected[0].result : '';
+    if (!html) throw new Error('未能读取页面内容');
+    return { status: 200, finalUrl: url, text: html };
+  } finally {
+    chrome.tabs.remove(tab.id).catch(() => {});
+  }
+}
+
 /* ------------------------------ 站点代理 ------------------------------ */
 async function ensureTab(site) {
   const cfg = SITES[site];
@@ -75,6 +114,16 @@ async function handle(method, params = {}) {
     case 'fetch':
       return fetchText(params.url);
 
+    // 搜索引擎抓取主通道：后台标签页真实加载，规避防爬校验与 JS 渲染问题
+    case 'fetchPage':
+      try {
+        return await fetchViaTab(params.url);
+      } catch (err) {
+        // 标签页方式失败时回退到网络抓取，尽量给出结果
+        const r = await fetchText(params.url);
+        return { ...r, fallback: String(err?.message || err) };
+      }
+
     case 'ai.open':
       return aiCall(params.site, 'state');
     case 'ai.state':

bro/extension/background.js

@@ -28,7 +28,9 @@
     <!-- 搜索视图 -->
     <section id="view-search" class="view active">
       <div id="bridgeBanner" class="banner hidden">
-        未检测到 bro bridge 扩展。搜索与 AI 功能依赖该扩展提供浏览器原生特权接口（不依赖任何外部运行时）。点右上角「设置」查看安装步骤。
+        <span>未检测到 bro bridge 扩展。搜索与 AI 功能依赖该扩展提供浏览器原生特权接口（不依赖任何外部运行时）。</span>
+        <a class="banner-link" href="bro-bridge.zip" download="bro-bridge.zip">下载扩展 .zip</a>
+        <span>解压后在扩展管理页「加载已解压的扩展程序」中选择解压目录即可。点右上角「设置」查看完整步骤。</span>
       </div>
 
       <div class="hero">
@@ -72,11 +74,19 @@ <h1 class="hero-title">搜索</h1>
     <div class="modal-card" id="guide">
       <h3>bro bridge 扩展</h3>
       <p class="muted state"></p>
+
+      <div class="download-row">
+        <a id="downloadZip" class="primary" href="bro-bridge.zip" download="bro-bridge.zip">下载扩展 .zip</a>
+        <span class="muted">无需前往仓库，点击即可直接下载。</span>
+      </div>
+
       <p class="muted">安装步骤：</p>
       <ol class="guide-list">
+        <li>点击上方「下载扩展 .zip」，把 <code>bro-bridge.zip</code> 下载到本地</li>
+        <li>解压该压缩包，得到一个包含 <code>manifest.json</code> 的文件夹</li>
         <li>打开浏览器扩展管理页（Chrome / Edge 地址栏输入 <code>chrome://extensions</code>）</li>
         <li>打开右上角「开发者模式」</li>
-        <li>点「加载已解压的扩展程序」，选择本仓库中的 <code>bro/extension</code> 目录</li>
+        <li>点「加载已解压的扩展程序」，选择第 2 步解压出的文件夹</li>
         <li>回到本页刷新，右上角状态应变为「扩展已连接」</li>
       </ol>
       <div class="modal-actions">

bro/index.html

@@ -241,10 +241,15 @@
 
     try {
       const url = window.BRO_ENGINES.url(engine, query, mode, page);
-      const data = await bridgeCall('fetch', { url });
+      // 用后台标签页真实加载目标结果页，避免裸 fetch 被搜索引擎防爬校验拦截
+      const data = await bridgeCall('fetchPage', { url }, 45000);
       const list = window.BRO_ENGINES.parse(engine, mode, data.text);
       if (!list.length) {
-        status.textContent = `没有解析到结果（${currentEngine()?.label}）。目标站点可能改版或被限制，换一个引擎再试。`;
+        if (/wappass\.baidu|安全验证|请输入验证码|verify|unusual traffic/i.test(data.text || '')) {
+          status.textContent = `「${currentEngine()?.label}」返回了安全验证页。请先在浏览器中正常打开一次该引擎并完成验证后重试，或更换其它引擎。`;
+        } else {
+          status.textContent = `没有解析到结果（${currentEngine()?.label}）。目标站点可能改版或被限制，换一个引擎再试。`;
+        }
         return;
       }
       status.textContent = `来自「${currentEngine()?.label}」的 ${list.length} 条结果（扩展静默抓取）`;