hunter-mate 0.1.6 → 0.1.8

package/dist/assets/extension/background/service-worker.js

@@ -991,8 +991,27 @@ var control_runtime_source_default = '"use strict";\n(() => {\n  // src/shared/c
 // src/background/cdp.ts
 var attached = /* @__PURE__ */ new Set();
 var CDP_COMMAND_TIMEOUT_MS = 15e3;
-function send(target, method, params) {
-  return chrome.debugger.sendCommand(target, method, params ?? {});
+function send(target, method, params, timeoutMs = CDP_COMMAND_TIMEOUT_MS) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => {
+      if (target.tabId !== void 0) {
+        chrome.debugger.detach({ tabId: target.tabId }).catch(() => void 0).then(() => {
+          attached.delete(target.tabId);
+        });
+      }
+      reject(new Error(`cdp_timeout: ${method} after ${timeoutMs}ms (tab frozen or unresponsive)`));
+    }, timeoutMs);
+    chrome.debugger.sendCommand(target, method, params ?? {}).then(
+      (v) => {
+        clearTimeout(timer);
+        resolve(v);
+      },
+      (err3) => {
+        clearTimeout(timer);
+        reject(err3);
+      }
+    );
+  });
 }
 function isAttachableUrl(url) {
   if (!url) return false;
@@ -1326,6 +1345,15 @@ chrome.debugger.onDetach.addListener((source) => {
     networkEnabledTabs.delete(source.tabId);
   }
 });
+async function detachIfAttached(tabId) {
+  if (!attached.has(tabId)) return;
+  try {
+    await chrome.debugger.detach({ tabId });
+  } catch {
+  }
+  attached.delete(tabId);
+  networkEnabledTabs.delete(tabId);
+}
 var CDP_ALLOWLIST = /* @__PURE__ */ new Set([
   "Accessibility.enable",
   "Accessibility.getFullAXTree",
@@ -1362,10 +1390,11 @@ async function insertText(tabId, text) {
 }
 async function cdpEvaluate(tabId, expression, timeoutMs = CDP_COMMAND_TIMEOUT_MS) {
   await ensureAttached(tabId);
-  const result = await chrome.debugger.sendCommand(
+  const result = await send(
     { tabId },
     "Runtime.evaluate",
-    { expression, returnByValue: true, awaitPromise: true }
+    { expression, returnByValue: true, awaitPromise: true },
+    timeoutMs
   );
   if (result.exceptionDetails) {
     const errMsg = result.exceptionDetails.exception?.description || result.exceptionDetails.text || "Eval error";
@@ -1534,6 +1563,21 @@ async function captureActiveTabScreenshot2(tab, options = {}) {
   throw new Error("capture_failed_unreachable");
 }
 
+// src/shared/eval-wrap.ts
+function buildEvalSyntaxCheckExpression(script) {
+  return "(() => { try { new Function(" + JSON.stringify("return (async () => (" + script + "\n))();") + "); return true; } catch (e) { return false; } })()";
+}
+function buildEvalExpressionWrapper(script) {
+  return `(async () => { return (
+${script}
+); })()`;
+}
+function buildEvalStatementWrapper(script) {
+  return `(async () => {
+${script}
+})()`;
+}
+
 // src/background/session-groups.ts
 var STORAGE_KEY = "hmSessionGroups";
 var cache = /* @__PURE__ */ new Map();
@@ -1869,8 +1913,48 @@ async function executeControlCommand(rawCommand, rawArgs, options = {}) {
       await chrome.windows.remove(windowId);
       return ok({ closed: true, windowId });
     }
-    const tab = await getControlTab(tabOverride);
-    if (!tab?.id) return err2("no_active_tab");
+    if (command === "hm.linkedin.search") {
+      try {
+        const result = await runLinkedInSearch(controlArgs, log, {
+          sessionId,
+          groupTitle,
+          explicitTab
+        });
+        return ok(result);
+      } catch (e) {
+        const code = e instanceof ControlBlockedError ? e.code : void 0;
+        return err2(e instanceof Error ? e.message : String(e), code);
+      }
+    }
+    if (command === "hm.liepin.search") {
+      try {
+        const result = await runLiepinSearch(controlArgs, log, {
+          sessionId,
+          groupTitle,
+          explicitTab
+        });
+        return ok(result);
+      } catch (e) {
+        const code = e instanceof ControlBlockedError ? e.code : void 0;
+        return err2(e instanceof Error ? e.message : String(e), code);
+      }
+    }
+    let tab = await getControlTab(tabOverride);
+    if (!tab?.id) {
+      if (command === "cp.goto" && typeof controlArgs.url === "string" && controlArgs.url) {
+        const created = await chrome.tabs.create({ url: controlArgs.url, active: false });
+        log("info", "auto-created tab for cp.goto (no active tab)", { tabId: created.id, url: controlArgs.url });
+        if (sessionId && !explicitTab) {
+          addTabToSessionGroup(sessionId, groupTitle, created).catch(
+            (err3) => log("warn", "cp.goto auto-tab addTabToSessionGroup failed", { sessionId, error: err3.message })
+          );
+        }
+        tab = created;
+      } else {
+        return err2("no_active_tab");
+      }
+    }
+    if (!tab.id) return err2("no_active_tab");
     if (sessionId && !explicitTab) {
       ensureSessionGroup(sessionId, groupTitle, tab).catch(
         (err3) => log("warn", "ensureSessionGroup failed", { sessionId, tabId: tab.id, error: err3.message })
@@ -1945,20 +2029,24 @@ async function executeControlCommand(rawCommand, rawArgs, options = {}) {
       if (command === "cp.eval" && typeof controlArgs.script === "string") {
         const script = controlArgs.script;
         const frame = controlArgs.frame;
-        if (frame !== void 0 && isAttachableUrl(tab.url)) {
-          let frameId = typeof frame === "string" ? frame : "";
-          let frameUrl;
-          if (typeof frame === "number" || /^\d+$/.test(String(frame))) {
-            const list = await frameListCdp(tab.id);
-            const target = list.frames?.find((f) => f.index === Number(frame));
-            if (!target) return err2(`frame_not_found: ${frame}`);
-            frameId = target.frame_id;
-            frameUrl = target.url;
+        const tabId = tab.id;
+        const evalWith = async (expr) => {
+          if (frame !== void 0 && isAttachableUrl(tab.url)) {
+            let frameId = typeof frame === "string" ? frame : "";
+            let frameUrl;
+            if (typeof frame === "number" || /^\d+$/.test(String(frame))) {
+              const list = await frameListCdp(tabId);
+              const target = list.frames?.find((f) => f.index === Number(frame));
+              if (!target) throw new Error(`frame_not_found: ${frame}`);
+              frameId = target.frame_id;
+              frameUrl = target.url;
+            }
+            return evaluateInFrame(tabId, expr, frameId, frameUrl);
           }
-          const result2 = await evaluateInFrame(tab.id, `(async () => { ${script} })()`, frameId, frameUrl);
-          return ok(result2);
-        }
-        const result = await cdpEvaluate(tab.id, `(async () => { ${script} })()`);
+          return cdpEvaluate(tabId, expr);
+        };
+        const useExpression = await evalWith(buildEvalSyntaxCheckExpression(script)).catch(() => false) === true;
+        const result = await evalWith(useExpression ? buildEvalExpressionWrapper(script) : buildEvalStatementWrapper(script));
         return ok(result);
       }
       if (command === "hm.linkedin.extract") {
@@ -1983,6 +2071,17 @@ async function executeControlCommand(rawCommand, rawArgs, options = {}) {
           return err2(e instanceof Error ? e.message : String(e));
         }
       }
+      if (command === "hm.liepin.extract") {
+        if (!isAttachableUrl(tab.url)) {
+          return err2("liepin_extract_requires_http_page");
+        }
+        try {
+          const result = await cdpEvaluate(tab.id, LIEPIN_EXTRACT_SOURCE);
+          return ok(result);
+        } catch (e) {
+          return err2(e instanceof Error ? e.message : String(e));
+        }
+      }
       if (command.startsWith("hm.")) {
         return { status: "error", code: "not_implemented", message: `${command} is not implemented yet` };
       }
@@ -2021,6 +2120,13 @@ async function executeControlCommand(rawCommand, rawArgs, options = {}) {
     return err2(e instanceof Error ? e.message : String(e));
   }
 }
+var ControlBlockedError = class extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "ControlBlockedError";
+  }
+};
 function buildInjectionExpression(command, controlArgs) {
   return '(() => { try { if (typeof globalThis.__cpRunControl !== "function" || globalThis.__cpRuntimeVersion !== ' + JSON.stringify(RUNTIME_VERSION) + ") {\n" + control_runtime_source_default + "\n} const r = globalThis.__cpRunControl(" + JSON.stringify(command) + ", " + JSON.stringify(controlArgs) + '); if (r && typeof r.then === "function") { return r; } return r; } catch (e) { return { __cpError: String((e && e.message) || e) }; } })()';
 }
@@ -2213,6 +2319,657 @@ var LINKEDIN_EXTRACT_SOURCE = String.raw`(async () => {
     extractedAt: new Date().toISOString(),
   };
 })()`;
+var LINKEDIN_WALL_CHECK_SOURCE = String.raw`(() => {
+  try {
+    if (document.querySelector('iframe[src*="captcha"], iframe[src*="challenge-platform"]')) return 'CAPTCHA';
+    const bodyText = (document.body && document.body.innerText ? document.body.innerText : '').slice(0, 3000);
+    if (/verify you('| a)re human|captcha|security (check|verification)/i.test(bodyText)) return 'CAPTCHA';
+    const url = location.href;
+    if (/linkedin\.com\/(authwall|uas\/login|login)/i.test(url)) return 'LOGIN_WALL';
+    if (/linkedin\.com\/checkpoint/i.test(url)) return 'CAPTCHA';
+  } catch (e) { /* 检测失败不阻断搜索 */ }
+  return null;
+})()`;
+var LINKEDIN_NEXT_CLICK_SOURCE = String.raw`(async () => {
+  const btn = document.querySelector('button.artdeco-pagination__button--next')
+    || document.querySelector('button[aria-label="Next"]')
+    || document.querySelector('[aria-label="Next"] button');
+  if (!btn || btn.disabled) return false;
+  btn.click();
+  return true;
+})()`;
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+async function waitTabLoaded(tabId, timeoutMs = 25e3) {
+  const t0 = Date.now();
+  let lastUrl = "";
+  let stableHits = 0;
+  while (Date.now() - t0 < timeoutMs) {
+    const t = await chrome.tabs.get(tabId).catch(() => null);
+    if (!t) throw new Error(`tab ${tabId} closed while loading`);
+    if (t.status === "complete") {
+      if (t.url === lastUrl) {
+        stableHits++;
+        if (stableHits >= 2) return;
+      } else {
+        stableHits = 0;
+        lastUrl = t.url || "";
+      }
+    } else {
+      stableHits = 0;
+      lastUrl = "";
+    }
+    await sleep(400);
+  }
+  throw new Error(`tab ${tabId} load timeout after ${timeoutMs}ms`);
+}
+async function runLinkedInSearch(args, log, ctx) {
+  const keywords = typeof args.keywords === "string" ? args.keywords.trim() : "";
+  const filters = args.filters && typeof args.filters === "object" ? args.filters : {};
+  const maxPages = Math.min(Math.max(Number(args.maxPages) || 3, 1), 10);
+  const keepTab = args.keepTab === true;
+  const activateTab = args.activateTab !== false;
+  const loadTimeoutMs = Math.min(Math.max(Number(args.loadTimeoutMs) || 25e3, 5e3), 3e5);
+  const delayBase = typeof args.delayMs === "number" ? Number(args.delayMs) : 2500;
+  let effectiveKeywords = keywords;
+  if (!filters.geoUrn && typeof filters.location === "string" && filters.location.trim()) {
+    effectiveKeywords = (keywords + " " + filters.location.trim()).trim();
+  }
+  if (!effectiveKeywords && !filters.company && !filters.school) {
+    throw new Error("linkedin_search_requires_keywords_or_filters");
+  }
+  const u = new URL("https://www.linkedin.com/search/results/people/");
+  if (effectiveKeywords) u.searchParams.set("keywords", effectiveKeywords);
+  if (typeof filters.geoUrn === "string" && filters.geoUrn) u.searchParams.set("geoUrn", filters.geoUrn);
+  if (typeof filters.company === "string" && filters.company) u.searchParams.set("company", filters.company);
+  if (typeof filters.school === "string" && filters.school) u.searchParams.set("school", filters.school);
+  const tab = await chrome.tabs.create({ url: u.toString(), active: false });
+  log("info", "hm.linkedin.search tab created", { tabId: tab.id, url: u.toString(), maxPages, activateTab });
+  if (activateTab && tab.id != null) {
+    await chrome.tabs.update(tab.id, { active: true }).catch(
+      (err3) => log("warn", "hm.linkedin.search activate tab failed", { tabId: tab.id, error: err3.message })
+    );
+  }
+  if (ctx.sessionId && !ctx.explicitTab && tab.id) {
+    addTabToSessionGroup(ctx.sessionId, ctx.groupTitle, tab).catch(
+      (err3) => log("warn", "hm.linkedin.search addTabToSessionGroup failed", { error: err3.message })
+    );
+  }
+  const leads = /* @__PURE__ */ new Map();
+  let pagesScanned = 0;
+  let lastUrl = "";
+  try {
+    for (let page = 1; page <= maxPages; page++) {
+      if (tab.id == null) break;
+      await waitTabLoaded(tab.id, loadTimeoutMs);
+      const blocked = await cdpEvaluate(tab.id, LINKEDIN_WALL_CHECK_SOURCE).catch(() => null);
+      if (blocked === "CAPTCHA" || blocked === "LOGIN_WALL") {
+        log("warn", "hm.linkedin.search blocked by linkedin risk control", { blocked, page, url: lastUrl });
+        throw new ControlBlockedError(blocked, `linkedin search aborted on page ${page}: ${blocked}`);
+      }
+      const extracted = await cdpEvaluate(tab.id, LINKEDIN_EXTRACT_SOURCE);
+      lastUrl = extracted?.url || lastUrl;
+      const pageLeads = extracted?.links?.talent || [];
+      for (const l of pageLeads) {
+        if (l.url && !leads.has(l.url)) {
+          leads.set(l.url, { url: l.url, name: l.name ?? null, page, source: "linkedin" });
+        }
+      }
+      pagesScanned = page;
+      log("info", "hm.linkedin.search page extracted", { page, pageLeads: pageLeads.length, total: leads.size });
+      if (page >= maxPages) break;
+      const clicked = await cdpEvaluate(tab.id, LINKEDIN_NEXT_CLICK_SOURCE).catch(() => false);
+      const urlBefore = (await chrome.tabs.get(tab.id).catch(() => null))?.url || "";
+      await sleep(clicked ? 2500 : 0);
+      const urlAfterClick = (await chrome.tabs.get(tab.id).catch(() => null))?.url || "";
+      if (!clicked || urlAfterClick === urlBefore) {
+        const next = new URL(u.toString());
+        next.searchParams.set("page", String(page + 1));
+        if (next.toString() === urlBefore) break;
+        await chrome.tabs.update(tab.id, { url: next.toString() });
+        log("debug", "hm.linkedin.search fallback to page param", { page: page + 1 });
+      }
+      await sleep(delayBase + Math.random() * 2500);
+    }
+  } finally {
+    if (!keepTab && tab.id != null) {
+      await closeTabGracefully(tab.id);
+    }
+  }
+  return {
+    keywords: effectiveKeywords,
+    searchUrl: u.toString(),
+    pagesScanned,
+    leadCount: leads.size,
+    leads: Array.from(leads.values()),
+    keepTab,
+    tabId: keepTab ? tab.id ?? null : null
+  };
+}
+var LIEPIN_WALL_CHECK_SOURCE = String.raw`(() => {
+  try {
+    if (location.href === 'about:blank' || !location.hostname) return 'BLANK_KILL';
+    const url = location.href;
+    if (/liepin\.com\/(login|passport|signin)/i.test(url)) return 'LOGIN_WALL';
+    if (/liepin\.com\/(safe|verify|check|captcha|slide)/i.test(url)) return 'CAPTCHA';
+    const bodyText = (document.body && document.body.innerText ? document.body.innerText : '').slice(0, 4000);
+    if (/滑块|拖动验证|安全验证|验证码|verify you are human|请完成安全验证/.test(bodyText)) return 'CAPTCHA';
+    if (document.querySelector('[class*="captcha"], [id*="captcha"], iframe[src*="captcha"], iframe[src*="slide"]')) return 'CAPTCHA';
+    if (/请先登录|登录后查看|立即登录/.test(bodyText) && !document.querySelector('#resume-detail-basic-info')) return 'LOGIN_WALL';
+  } catch (e) { /* 检测失败不阻断 */ }
+  return null;
+})()`;
+var LIEPIN_EXTRACT_SOURCE = String.raw`(async () => {
+  const waitFor = (fn, timeout, interval) => new Promise((resolve) => {
+    const t0 = Date.now();
+    const tick = () => {
+      let v = null;
+      try { v = fn(); } catch (e) {}
+      if (v) return resolve(v);
+      if (Date.now() - t0 > (timeout || 8000)) return resolve(null);
+      setTimeout(tick, interval || 250);
+    };
+    tick();
+  });
+  if (document.readyState !== 'complete') {
+    await waitFor(() => document.readyState === 'complete', 12000, 200);
+  }
+  const clean = (s) => {
+    if (s == null) return null;
+    const t = String(s).replace(/\s+/g, ' ').trim();
+    return t || null;
+  };
+  const txt = (el) => clean(el ? el.textContent : null);
+  const first = (sel, root) => (root || document).querySelector(sel);
+  const attr = (el, name) => (el ? (el.getAttribute(name) || null) : null);
+  const abs = (href) => {
+    if (!href) return null;
+    try { return new URL(href, location.href).toString(); } catch (e) { return href; }
+  };
+  /* sep-info 用 <i></i> 作分隔符:转 | 后按段切分 */
+  const splitByI = (el) => {
+    if (!el) return [];
+    const html = el.innerHTML || '';
+    const holder = document.createElement('div');
+    return html.replace(/<i[^>]*>\s*<\/i>/g, '|').split('|').map((seg) => {
+      holder.innerHTML = seg;
+      return clean(holder.textContent);
+    }).filter(Boolean);
+  };
+  /* (2012.07 - 至今, 14年2个月) → { start, end, duration } */
+  const parsePeriod = (text) => {
+    const m = (text || '').match(/[（(]\s*([^)）]*?)\s*[)）]/);
+    if (!m) return { start: null, end: null, duration: null };
+    const parts = m[1].split(',').map((s) => clean(s)).filter(Boolean);
+    const range = (parts[0] || '').split('-').map((s) => clean(s));
+    return { start: range[0] || null, end: range[1] || null, duration: parts[1] || null };
+  };
+  /* rd-info-col 映射:每个 col 是 title+cont 对(一行可能两个 col) */
+  const readInfoCols = (root) => {
+    const out = {};
+    (root || document).querySelectorAll('.rd-info-col').forEach((col) => {
+      const title = txt(first('.rd-info-col-title', col));
+      const cont = txt(first('.rd-info-col-cont', col));
+      if (title && cont) out[title.replace(/[:：]\s*$/, '')] = cont;
+    });
+    return out;
+  };
+  const resIdFrom = (href, scm) => {
+    if (scm) {
+      const m = scm.match(/cid=([^&]+)/);
+      if (m) return m[1];
+    }
+    if (href) {
+      const m = href.match(/res_id_encode=([^&]+)/);
+      if (m) return m[1];
+    }
+    return null;
+  };
+
+  const url = location.href;
+  const canonical = (document.querySelector('link[rel="canonical"]') || {}).href || url.split('?')[0];
+  const entities = [];
+  const links = { talent: [], company: [], job: [] };
+
+  if (document.querySelector('#resume-detail-basic-info')) {
+    const basic = first('#resume-detail-basic-info');
+    const sepInfos = basic.querySelectorAll('.basic-cont .sep-info');
+    const parts0 = sepInfos.length > 0 ? splitByI(sepInfos[0]) : [];
+    const parts1 = sepInfos.length > 1 ? splitByI(sepInfos[1]) : [];
+    const joined0 = parts0.join(' ');
+    const age = joined0.match(/(\d+)\s*岁/);
+    const workYears = joined0.match(/工作\s*(\d+)\s*年/);
+    const name = txt(first('.name-box .name', basic));
+    const statusBox = first('.res-status-box', basic);
+    const contactTimeRaw = txt(statusBox);
+    const scm = attr(document.querySelector('[data-tlg-scm]'), 'data-tlg-scm');
+
+    const intentRoot = first('#resume-detail-job-exp-info');
+    const workExperiences = [];
+    document.querySelectorAll('#resume-detail-work-info .rd-work-item-cont').forEach((item) => {
+      const cols = readInfoCols(item);
+      workExperiences.push({
+        company: attr(first('.rd-work-comp h5', item), 'title') || txt(first('.rd-work-comp h5', item)),
+        ...parsePeriod(txt(first('.rd-work-time', item))),
+        position: txt(first('.job-name', item)),
+        department: cols['所在部门'] || null,
+        location: cols['工作地点'] || null,
+        subordinates: cols['下属人数'] != null ? Number(cols['下属人数']) : null,
+        reportsTo: cols['汇报对象'] || null,
+        responsibilities: cols['职责业绩'] || null,
+      });
+    });
+    const projects = [];
+    document.querySelectorAll('#resume-detail-project-info .rd-project-item-cont').forEach((item) => {
+      const cols = readInfoCols(item);
+      projects.push({
+        name: attr(first('.rd-project-name h5', item), 'title') || txt(first('.rd-project-name h5', item)),
+        ...parsePeriod(txt(first('.rd-project-time', item))),
+        role: cols['项目职务'] || null,
+        company: cols['所在公司'] || null,
+        description: cols['项目描述'] || null,
+        duties: cols['项目职责'] || null,
+      });
+    });
+    const education = [];
+    document.querySelectorAll('#resume-detail-edu-info .rd-edu-info-item').forEach((item) => {
+      education.push({
+        school: attr(first('.school-name', item), 'title') || txt(first('.school-name', item)),
+        major: attr(first('.school-special', item), 'title') || txt(first('.school-special', item)),
+        degree: attr(first('.school-degree', item), 'title') || txt(first('.school-degree', item)),
+        period: txt(first('.school-time', item)),
+        tags: Array.from(item.querySelectorAll('.edu-school-tags .tag-item')).map((t) => txt(t)).filter(Boolean),
+      });
+    });
+
+    entities.push({
+      entityType: 'talent',
+      platform: 'liepin',
+      resId: resIdFrom(url, scm),
+      name,
+      nameMasked: name ? /\*/.test(name) : undefined,
+      statusTag: txt(first('.user-status-tag', basic)),
+      gender: parts0.find((p) => /^(男|女)$/.test(p)) || null,
+      age: age ? Number(age[1]) : null,
+      city: parts0.find((p) => /^(北京|上海|广州|深圳|天津|重庆|杭州|南京|苏州|成都|武汉|西安|[一-龥]{2,6})$/.test(p) && !/^(男|女|保密)$/.test(p) && !/岁|年/.test(p)) || null,
+      degree: parts0.find((p) => /(博士|硕士|MBA|本科|大专|专科|高中|中专|初中)/.test(p)) || null,
+      workYears: workYears ? Number(workYears[1]) : null,
+      currentCompany: parts0.length ? parts0[parts0.length - 1] : null,
+      currentCompanyMasked: parts0.includes('保密') ? true : undefined,
+      currentPosition: parts1.length ? parts1[0] : null,
+      contactTime: contactTimeRaw ? contactTimeRaw.replace(/^方便联系时间[:：]\s*/, '') : null,
+      photoUrl: (() => { const img = first('.logo-box img', basic); return img ? abs(img.getAttribute('src')) : null; })(),
+      intent: intentRoot ? {
+        position: attr(first('.tabs .title', intentRoot), 'title') || txt(first('.tabs .title', intentRoot)),
+        salary: txt(first('.tabs .salary', intentRoot)),
+        city: txt(first('.dqname-wrap', intentRoot)),
+        industries: Array.from(intentRoot.querySelectorAll('.lebels-wrap span')).map((s) => txt(s)).filter(Boolean),
+      } : null,
+      workExperiences,
+      projects,
+      education,
+      languages: Array.from(document.querySelectorAll('#resume-detail-lang-info .rd-lang-item .lang-name')).map((el) => txt(el)).filter(Boolean),
+      selfEvaluation: txt(first('#resume-detail-self-eva-info .resume-detail-template-cont')),
+      statement: txt(first('.c-detail-statement')),
+      hasAntiScrapeWatermark: document.querySelectorAll('.cozue').length > 0,
+      url: canonical,
+      source: 'liepin',
+    });
+  } else if (document.querySelector('.talent-resume-card')) {
+    /* 人才管理页/搜索结果列表:.talent-resume-card 卡片(事实源 §7) */
+    document.querySelectorAll('.talent-resume-card').forEach((card) => {
+      const a = first('a.resume-title', card) || first('a[href*="showresumedetail"]', card);
+      const href = a ? abs(attr(a, 'href')) : null;
+      const scm = attr(card, 'data-tlg-scm') || '';
+      const titleLine = attr(a, 'title') || txt(a);
+      const eduItem = Array.from(card.querySelectorAll('.info-item')).find((el) => /最高学历/.test(el.textContent || ''));
+      const workLines = [];
+      card.querySelectorAll('.work-info .info-cont p, .info-cont p').forEach((p) => {
+        const comp = first('.comp', p);
+        const pos = first('.rw-title', p);
+        if (comp || pos) {
+          workLines.push({
+            period: txt(p.querySelector('i')),
+            company: attr(comp, 'title') || txt(comp),
+            position: attr(pos, 'title') || txt(pos),
+          });
+        }
+      });
+      const acquired = txt(first('.right-extension .temp-side', card));
+      const lead = {
+        url: href,
+        name: titleLine ? (titleLine.split(/\s*[|｜]\s*/)[0] || titleLine) : null,
+        titleLine,
+        resId: resIdFrom(href, scm),
+        education: eduItem ? clean((eduItem.textContent || '').replace(/^最高学历[:：]?/, '')) : null,
+        recentWork: workLines,
+        acquiredAt: acquired ? acquired.replace(/^获取时间[:：]?/, '') : null,
+        source: 'liepin',
+      };
+      if (lead.url && !links.talent.some((l) => l.url === lead.url)) links.talent.push(lead);
+    });
+  } else {
+    /* 兜底:任何含简历详情链接的页面,提取链接名单 */
+    document.querySelectorAll('a[href*="showresumedetail"]').forEach((a) => {
+      const href = abs(attr(a, 'href'));
+      if (href && !links.talent.some((l) => l.url === href)) {
+        links.talent.push({ url: href, name: txt(a), resId: resIdFrom(href, ''), source: 'liepin' });
+      }
+    });
+  }
+
+  const pageClass = document.querySelector('#resume-detail-basic-info')
+    ? 'talent'
+    : (document.querySelector('.talent-resume-card') ? 'resume-list' : (links.talent.length ? 'list' : 'unknown'));
+  return {
+    url,
+    canonical,
+    pageClass,
+    title: clean(document.title),
+    extractedAt: new Date().toISOString(),
+    entities,
+    links,
+  };
+})()`;
+var LIEPIN_FILL_AND_SEARCH_SOURCE = String.raw`(async (P) => {
+  const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+  const clean = (s) => (s == null ? null : String(s).replace(/\s+/g, ' ').trim() || null);
+  const delay = P.fieldDelayMs && P.fieldDelayMs >= 0 ? P.fieldDelayMs : 1500;
+  const applied = [];
+  const errors = [];
+
+  /* React 受控输入兼容:native setter + input/change 事件 */
+  const setNativeValue = (el, value) => {
+    const setter = Object.getOwnPropertyDescriptor(
+      el instanceof HTMLTextAreaElement ? HTMLTextAreaElement.prototype : HTMLInputElement.prototype,
+      'value',
+    ).set;
+    setter.call(el, value);
+    el.dispatchEvent(new Event('input', { bubbles: true }));
+    el.dispatchEvent(new Event('change', { bubbles: true }));
+  };
+  const setInput = (sel, value) => {
+    const el = document.querySelector(sel);
+    if (!el) { errors.push('missing_input:' + sel); return false; }
+    if (el.disabled) { errors.push('disabled_input:' + sel); return false; }
+    el.focus();
+    setNativeValue(el, String(value));
+    el.blur();
+    return true;
+  };
+  /* 在某个容器内点击包含指定文本的按钮(如"确 定"/"搜 索") */
+  const clickButtonIn = (rootSel, text) => {
+    const root = rootSel ? document.querySelector(rootSel) : document;
+    if (!root) { errors.push('missing_root:' + rootSel); return false; }
+    const btn = Array.from(root.querySelectorAll('button, span, a')).find((b) => {
+      const t = clean(b.textContent);
+      return t && t.replace(/\s+/g, '') === text;
+    });
+    if (!btn) { errors.push('missing_button:' + text + '@' + rootSel); return false; }
+    btn.click();
+    return true;
+  };
+  /* 点击条件 tag(容器可带 #N 出现序号:如 '.sfilter-city#2' = 第 2 个 sfilter-city,即期望城市) */
+  const clickTag = (containerSel, text) => {
+    let sel = containerSel;
+    let idx = 0;
+    const m = String(containerSel).match(/^(.*)#(\d+)$/);
+    if (m) { sel = m[1]; idx = parseInt(m[2], 10) - 1; }
+    const containers = document.querySelectorAll(sel);
+    const container = containers.length > idx ? containers[idx] : null;
+    if (!container) { errors.push('missing_container:' + containerSel); return false; }
+    const tag = Array.from(container.querySelectorAll('label.tag-item, .tag-item, span')).find((el) => {
+      const t = clean(el.textContent);
+      return t && (t === text || t.replace(/\s+/g, '') === String(text).replace(/\s+/g, ''));
+    });
+    if (!tag) { errors.push('missing_tag:' + text + '@' + containerSel); return false; }
+    tag.click();
+    return true;
+  };
+
+  try {
+    /* 1) 关键词:顶部自动补全输入框(与 .search-btn 同容器,placeholder 搜职位/公司/行业等) */
+    if (P.keyword) {
+      const okInput = (() => {
+        const box = document.querySelector('.auto-input-wrap-v3') || document.querySelector('.ant-select-auto-complete');
+        const el = box ? box.querySelector('input.ant-select-selection-search-input') : null;
+        if (!el) { errors.push('missing_input:keyword'); return false; }
+        el.focus();
+        setNativeValue(el, String(P.keyword));
+        el.dispatchEvent(new Event('input', { bubbles: true }));
+        el.dispatchEvent(new Event('change', { bubbles: true }));
+        el.blur();
+        return true;
+      })();
+      if (okInput) applied.push('keyword');
+      await sleep(delay);
+    }
+
+    /* 2) tag 类条件(每次点击后 human-paced) */
+    const tagSteps = [];
+    if (P.city) tagSteps.push(['.sfilter-city', P.city, 'city']);
+    if (P.expectCity) tagSteps.push(['.sfilter-city#2', P.expectCity, 'expectCity']);
+    if (P.workYear) tagSteps.push(['.sfilter-work-year', P.workYear, 'workYear']);
+    if (P.education) tagSteps.push(['.sfilter-edu', P.education, 'education']);
+    if (P.schoolTag) tagSteps.push(['.sfilter-additional', P.schoolTag, 'schoolTag']);
+    if (P.language) tagSteps.push(['.sfilter-lang', P.language, 'language']);
+    for (const [sel, text, key] of tagSteps) {
+      if (clickTag(sel, text)) applied.push(key);
+      await sleep(delay);
+    }
+
+    /* 3) 区间输入类条件:填输入 + 点容器内"确定" */
+    const rangeSteps = [];
+    if (P.ageMin != null || P.ageMax != null) {
+      rangeSteps.push(['#ageLow', P.ageMin, '#ageHigh', P.ageMax, '.age-shadow-box', 'age']);
+    }
+    if (P.wantSalaryMin != null || P.wantSalaryMax != null) {
+      rangeSteps.push(['#wantSalaryLow', P.wantSalaryMin, '#wantSalaryHigh', P.wantSalaryMax, '.sfilter-salary .search-resume-shadow-box', 'wantSalary']);
+    }
+    if (P.nowSalaryMin != null || P.nowSalaryMax != null) {
+      rangeSteps.push(['#nowSalaryLow', P.nowSalaryMin, '#nowSalaryHigh', P.nowSalaryMax, null, 'nowSalary']);
+    }
+    for (const [loSel, lo, hiSel, hi, boxSel, key] of rangeSteps) {
+      let ok = true;
+      if (lo != null) ok = setInput(loSel, lo) && ok;
+      await sleep(Math.max(600, Math.floor(delay / 2)));
+      if (hi != null) ok = setInput(hiSel, hi) && ok;
+      await sleep(Math.max(600, Math.floor(delay / 2)));
+      /* 确定按钮:优先容器内,其次全局匹配(目前年薪容器无专属 class) */
+      if (ok && !clickButtonIn(boxSel, '确定')) {
+        ok = clickButtonIn(null, '确定');
+      }
+      if (ok) applied.push(key);
+      await sleep(delay);
+    }
+
+    /* 4) 工作年限自定义:先点"自定义"tag 解锁输入,再填 + 确定 */
+    if (P.workYearsMin != null || P.workYearsMax != null) {
+      if (clickTag('.sfilter-work-year', '自定义')) {
+        applied.push('workYearCustom');
+        await sleep(delay);
+        let ok = true;
+        if (P.workYearsMin != null) ok = setInput('#workYearsLow', P.workYearsMin) && ok;
+        await sleep(Math.max(600, Math.floor(delay / 2)));
+        if (P.workYearsMax != null) ok = setInput('#workYearsHigh', P.workYearsMax) && ok;
+        await sleep(Math.max(600, Math.floor(delay / 2)));
+        if (ok && clickButtonIn('.year-custom-box', '确定')) applied.push('workYears');
+      }
+      await sleep(delay);
+    }
+
+    /* 5) 复选框:海外工作经验 / 管理经验 */
+    for (const [name, key] of [['workAbroad', 'workAbroad'], ['managerial', 'managerial']]) {
+      if (P[key]) {
+        const input = document.querySelector('input[name="' + name + '"]');
+        if (input && !input.checked) {
+          const wrapper = input.closest('label') || input;
+          wrapper.click();
+          applied.push(key);
+          await sleep(delay);
+        } else if (!input) {
+          errors.push('missing_checkbox:' + name);
+        }
+      }
+    }
+
+    /* 6) 提交搜索前停顿(类人工审阅),点击顶部"搜 索" */
+    await sleep(Math.max(1500, delay));
+    const searchBtn = document.querySelector('button.search-btn');
+    if (!searchBtn) { errors.push('missing_button:search'); return { applied, errors, submitted: false }; }
+    searchBtn.click();
+    applied.push('submit');
+    return { applied, errors, submitted: true };
+  } catch (e) {
+    errors.push('fill_exception:' + String((e && e.message) || e));
+    return { applied, errors, submitted: false };
+  }
+})`;
+var LIEPIN_RESULT_WAIT_SOURCE = String.raw`(() => {
+  return new Promise((resolve) => {
+    const t0 = Date.now();
+    const tick = () => {
+      let hit = false;
+      try {
+        hit = !!(document.querySelector('.talent-resume-card') || document.querySelector('a[href*="showresumedetail"]'));
+        if (!hit && /没有找到|暂无相关|0\s*条结果|共\s*0\s*条/.test(document.body ? document.body.innerText : '')) return resolve('empty');
+      } catch (e) {}
+      if (hit) return resolve(true);
+      if (Date.now() - t0 > 20000) return resolve(false);
+      setTimeout(tick, 400);
+    };
+    tick();
+  });
+})()`;
+var LIEPIN_NEXT_CLICK_SOURCE = String.raw`(async () => {
+  const next = document.querySelector('.ant-pagination-next button')
+    || document.querySelector('.ant-pagination-next')
+    || document.querySelector('button[aria-label="下一页"]');
+  if (!next || next.getAttribute('aria-disabled') === 'true' || next.disabled) return false;
+  next.click();
+  return true;
+})()`;
+function liepinBlockedCode(blocked) {
+  if (blocked === "LOGIN_WALL") return "LIE_PIN_LOGIN_WALL";
+  if (blocked === "BLANK_KILL") return "LIE_PIN_BLANK_KILL";
+  return "LIE_PIN_CAPTCHA";
+}
+async function runLiepinSearch(args, log, ctx) {
+  const keyword = typeof args.keyword === "string" ? args.keyword.trim() : "";
+  if (!keyword) throw new Error("liepin_search_requires_keyword");
+  const maxPages = Math.min(Math.max(Number(args.maxPages) || 1, 1), 5);
+  const keepTab = args.keepTab === true;
+  const fieldDelayMs = typeof args.delayMs === "number" ? Number(args.delayMs) : 1500;
+  const fillParams = { keyword, fieldDelayMs };
+  for (const k of [
+    "city",
+    "expectCity",
+    "workYear",
+    "education",
+    "schoolTag",
+    "language",
+    "ageMin",
+    "ageMax",
+    "wantSalaryMin",
+    "wantSalaryMax",
+    "nowSalaryMin",
+    "nowSalaryMax",
+    "workYearsMin",
+    "workYearsMax",
+    "workAbroad",
+    "managerial"
+  ]) {
+    if (args[k] !== void 0) fillParams[k] = args[k];
+  }
+  const searchUrl = "https://h.liepin.com/search/getConditionItem";
+  const tab = await chrome.tabs.create({ url: searchUrl, active: false });
+  log("info", "hm.liepin.search tab created", { tabId: tab.id, url: searchUrl, maxPages, keyword });
+  if (ctx.sessionId && !ctx.explicitTab && tab.id) {
+    addTabToSessionGroup(ctx.sessionId, ctx.groupTitle, tab).catch(
+      (err3) => log("warn", "hm.liepin.search addTabToSessionGroup failed", { error: err3.message })
+    );
+  }
+  const leads = /* @__PURE__ */ new Map();
+  const applied = [];
+  const fillErrors = [];
+  let pagesScanned = 0;
+  const assertNotBlocked = async (phase) => {
+    if (tab.id == null) return;
+    const t = await chrome.tabs.get(tab.id).catch(() => null);
+    if (!t) throw new Error(`tab closed while ${phase}`);
+    if (!t.url || t.url === "about:blank") {
+      throw new ControlBlockedError("LIE_PIN_BLANK_KILL", `liepin search aborted at ${phase}: page killed to about:blank (secscan)`);
+    }
+    const blocked = await cdpEvaluate(tab.id, LIEPIN_WALL_CHECK_SOURCE).catch(() => null);
+    if (blocked) {
+      const code = liepinBlockedCode(blocked);
+      log("warn", "hm.liepin.search blocked by liepin risk control", { blocked, code, phase });
+      throw new ControlBlockedError(code, `liepin search aborted at ${phase}: ${blocked}`);
+    }
+  };
+  try {
+    if (tab.id == null) throw new Error("failed_to_create_tab");
+    await waitTabLoaded(tab.id, 3e4);
+    await sleep(1500);
+    await assertNotBlocked("after-load");
+    const fillExpr = "(() => { const P = " + JSON.stringify(fillParams) + "; return (" + LIEPIN_FILL_AND_SEARCH_SOURCE + ")(P); })()";
+    const fillResult = await cdpEvaluate(tab.id, fillExpr, 6e4);
+    applied.push(...fillResult?.applied ?? []);
+    fillErrors.push(...fillResult?.errors ?? []);
+    if (!fillResult?.submitted) {
+      log("warn", "hm.liepin.search fill did not submit", { fillErrors });
+      throw new Error("liepin_search_fill_failed: " + fillErrors.join(";"));
+    }
+    log("info", "hm.liepin.search form submitted", { applied, fillErrors });
+    for (let page = 1; page <= maxPages; page++) {
+      if (tab.id == null) break;
+      const waited = await cdpEvaluate(tab.id, LIEPIN_RESULT_WAIT_SOURCE, 3e4).catch(() => false);
+      await sleep(1200);
+      await assertNotBlocked(`page-${page}`);
+      if (waited === "empty") {
+        log("info", "hm.liepin.search empty result", { page });
+        break;
+      }
+      const extracted = await cdpEvaluate(tab.id, LIEPIN_EXTRACT_SOURCE, 3e4);
+      const pageLeads = extracted?.links?.talent || [];
+      for (const l of pageLeads) {
+        if (l.url && !leads.has(l.url)) {
+          leads.set(l.url, {
+            url: l.url,
+            name: l.name ?? null,
+            titleLine: l.titleLine ?? null,
+            resId: l.resId ?? null,
+            page,
+            source: "liepin"
+          });
+        }
+      }
+      pagesScanned = page;
+      log("info", "hm.liepin.search page extracted", { page, pageLeads: pageLeads.length, total: leads.size });
+      if (page >= maxPages) break;
+      const clicked = await cdpEvaluate(tab.id, LIEPIN_NEXT_CLICK_SOURCE).catch(() => false);
+      if (!clicked) break;
+      await sleep(3e3 + Math.random() * 2e3);
+      await assertNotBlocked(`page-${page}-next`);
+    }
+  } finally {
+    if (!keepTab && tab.id != null) {
+      await closeTabGracefully(tab.id);
+    }
+  }
+  return {
+    keyword,
+    searchUrl,
+    pagesScanned,
+    leadCount: leads.size,
+    leads: Array.from(leads.values()),
+    applied,
+    fillErrors,
+    keepTab,
+    tabId: keepTab ? tab.id ?? null : null
+  };
+}
 var HIREDCHINA_EXTRACT_SOURCE = String.raw`(async () => {
   const waitFor = (fn, timeout, interval) => new Promise((resolve) => {
     const t0 = Date.now();
@@ -2436,6 +3193,14 @@ async function handleCookiesCommand(args) {
   }
   throw new Error(`cookies_unknown_action: ${action}`);
 }
+async function closeTabGracefully(tabId) {
+  await detachIfAttached(tabId);
+  await Promise.race([
+    chrome.tabs.remove(tabId),
+    new Promise((_, reject) => setTimeout(() => reject(new Error("tab_remove_timeout")), 5e3))
+  ]).catch(() => {
+  });
+}
 async function handleTabCommand(command, args, log) {
   const tabArg = args.tab ?? args.targetId ?? args.page;
   switch (command) {
@@ -2467,7 +3232,7 @@ async function handleTabCommand(command, args, log) {
     }
     case "cp.tab.close": {
       if (!tabArg) throw new Error("tab_close_requires_tab_id");
-      await chrome.tabs.remove(Number(tabArg));
+      await closeTabGracefully(Number(tabArg));
       return { closed: true, page: String(tabArg) };
     }
     case "cp.tab.bind": {
@@ -2650,7 +3415,7 @@ function maybeDiscover(url, title) {
   });
 }
 
-// ../../node_modules/.pnpm/@chromepilot+logger-kit@0.1.3_@nestjs+common@10.4.22_class-transformer@0.5.1_class-validator@_v44hq6ikmqzoani6tawke4nway/node_modules/@chromepilot/logger-kit/dist/client/logger.js
+// ../../node_modules/.pnpm/@chromepilot+logger-kit@0.1.4_@nestjs+common@10.4.22_class-transformer@0.5.1_class-validator@_legcruqwso5xb42h6lrzoll4b4/node_modules/@chromepilot/logger-kit/dist/client/logger.js
 function stringifyArg(arg) {
   if (typeof arg === "string")
     return arg;
@@ -2802,7 +3567,7 @@ var Logger = class {
   }
 };
 
-// ../../node_modules/.pnpm/@chromepilot+logger-kit@0.1.3_@nestjs+common@10.4.22_class-transformer@0.5.1_class-validator@_v44hq6ikmqzoani6tawke4nway/node_modules/@chromepilot/logger-kit/dist/client/transports/http-transport.js
+// ../../node_modules/.pnpm/@chromepilot+logger-kit@0.1.4_@nestjs+common@10.4.22_class-transformer@0.5.1_class-validator@_legcruqwso5xb42h6lrzoll4b4/node_modules/@chromepilot/logger-kit/dist/client/transports/http-transport.js
 async function createHttpTransport(opts) {
   const serverUrl = opts.serverUrl.replace(/\/$/, "");
   return async (logs) => {
@@ -2989,36 +3754,58 @@ createBackgroundLogForwarder({
 }).then((f) => {
   logForwarder = f;
 });
-var socket = null;
-var SEND_QUEUE_LIMIT = 500;
-var sendQueue = [];
-var queuedDropped = 0;
-function isFullSnapshot(payload) {
-  return payload?.type === "rrweb" && payload?.payload?.type === 2;
-}
-function enqueueRecordingEvent(payload) {
-  sendQueue.push({ raw: JSON.stringify(payload), isSnapshot: isFullSnapshot(payload) });
-  while (sendQueue.length > SEND_QUEUE_LIMIT) {
-    const idx = sendQueue.findIndex((item) => !item.isSnapshot);
-    if (idx === -1) break;
-    sendQueue.splice(idx, 1);
-    queuedDropped++;
-  }
-}
-function flushSendQueue() {
-  if (!socket || socket.readyState !== WebSocket.OPEN || !sendQueue.length) return;
-  while (sendQueue.length) {
-    const item = sendQueue.shift();
+var OFFSCREEN_URL = "offscreen/offscreen.html";
+function sendToOffscreen(raw) {
+  chrome.runtime.sendMessage({ type: "offscreen:send", raw }).catch(() => {
+  });
+}
+function sendInitToOffscreen() {
+  const manifest = chrome.runtime.getManifest();
+  chrome.runtime.sendMessage({ type: "offscreen:init", extensionId: chrome.runtime.id, version: manifest.version }).catch(() => {
+  });
+}
+async function ensureOffscreen() {
+  try {
+    const contexts = await chrome.runtime.getContexts({
+      contextTypes: [chrome.runtime.ContextType.OFFSCREEN_DOCUMENT]
+    });
+    if (contexts.length > 0) {
+      sendInitToOffscreen();
+      return;
+    }
     try {
-      socket.send(item.raw);
-    } catch (e) {
-      console.error("[HunterMate] flush send failed", e);
-      break;
+      await chrome.offscreen.createDocument({
+        url: OFFSCREEN_URL,
+        // D1: WEBSOCKET 枚举从未在正式 Chrome 落地(152 实测抛枚举非法),必须用 WORKERS;
+        // @types/chrome 0.0.268 的 Reason 枚举同样没有 WEBSOCKET 成员,断言方向一致
+        reasons: ["WORKERS"],
+        justification: "hunter-mate \u9700\u4E0E\u672C\u5730 server \u4FDD\u6301\u5E38\u9A7B WebSocket \u8FDE\u63A5(MV3 SW \u4F1A\u88AB\u7A7A\u95F2\u56DE\u6536)"
+      });
+      sendInitToOffscreen();
+    } catch (createErr) {
+      const msg = createErr instanceof Error ? createErr.message : String(createErr);
+      sendLog("warn", "ensureOffscreen createDocument failed, retry after closeDocument", { error: msg });
+      try {
+        await chrome.offscreen.closeDocument();
+      } catch {
+      }
+      await new Promise((r) => setTimeout(r, 1e3));
+      await chrome.offscreen.createDocument({
+        url: OFFSCREEN_URL,
+        reasons: ["WORKERS"],
+        justification: "hunter-mate \u9700\u4E0E\u672C\u5730 server \u4FDD\u6301\u5E38\u9A7B WebSocket \u8FDE\u63A5(MV3 SW \u4F1A\u88AB\u7A7A\u95F2\u56DE\u6536)"
+      });
+      sendInitToOffscreen();
     }
+  } catch (err3) {
+    console.error("[HunterMate] ensureOffscreen failed", err3);
+    sendLog("error", "ensureOffscreen failed", { error: err3 instanceof Error ? err3.message : String(err3) });
   }
-  if (queuedDropped > 0) {
-    console.warn(`[HunterMate] send queue overflow, dropped ${queuedDropped} incremental events (snapshots kept)`);
-    queuedDropped = 0;
+  try {
+    const st = await chrome.runtime.sendMessage({ type: "offscreen:get-state" });
+    state.wsConnected = !!st?.wsConnected;
+    broadcastState();
+  } catch {
   }
 }
 function sendLog(level, message, meta) {
@@ -3026,14 +3813,7 @@ function sendLog(level, message, meta) {
     backgroundLogger[level === "debug" ? "debug" : level]("extension:sendLog", { message, meta });
   } catch {
   }
-  const ws = socket;
-  if (ws?.readyState === WebSocket.OPEN) {
-    try {
-      ws.send(JSON.stringify({ type: "log", level, message, meta }));
-    } catch (e) {
-      console.error("[HunterMate] sendLog failed", e);
-    }
-  }
+  sendToOffscreen(JSON.stringify({ type: "log", level, message, meta }));
   const prefix = `[HunterMate] ${message}`;
   if (level === "debug") {
     console.debug(prefix, meta ?? "");
@@ -3106,99 +3886,72 @@ function broadcastState() {
     });
   });
 }
-function connect() {
-  if (socket) return;
-  socket = new WebSocket(WS_URL);
-  socket.onopen = () => {
-    state.wsConnected = true;
-    console.log("[HunterMate] connected to local server");
-    socket?.send(
-      JSON.stringify({
-        type: "hello",
-        extensionId: chrome.runtime.id,
-        version: chrome.runtime.getManifest().version,
-        capabilities: ["cp.*", "hm.*"]
-      })
-    );
-    flushSendQueue();
-    broadcastState();
-    backgroundLogger.info("ws:connected", { extensionId: chrome.runtime.id });
-  };
-  socket.onclose = () => {
-    socket = null;
-    state.wsConnected = false;
-    broadcastState();
-    backgroundLogger.warn("ws:closed", { reconnectDelayMs: 5e3 });
-    setTimeout(connect, 5e3);
-  };
-  socket.onerror = (err3) => {
-    backgroundLogger.error("ws:error", { message: String(err3) });
-  };
-  socket.onmessage = async (event) => {
-    let data;
-    try {
-      data = JSON.parse(event.data);
-    } catch {
-      return;
-    }
-    if (data.type === "pong" || data.type === "status" || data.type === "ack") return;
-    if (data.type === "reload") {
-      console.log("[HunterMate] received reload broadcast, reloading extension in 200ms...");
-      setTimeout(() => chrome.runtime.reload(), 200);
-      return;
-    }
-    if (data.type === "cmd" && data.requestId) {
-      const startedAt = Date.now();
-      sendLog("info", "extension handling control command", { command: data.command, requestId: data.requestId, params: data.params });
-      let outcome;
-      if (data.command === "hm.status") {
-        const manifest = chrome.runtime.getManifest();
-        outcome = {
-          status: "ok",
-          result: {
-            ...state,
-            tabStatesCount: tabStates.size,
-            extBasePath: chrome.runtime.getURL(""),
-            manifestPermissions: manifest.permissions,
-            hasSidePanelInManifest: manifest.permissions?.includes("sidePanel"),
-            chromeSidePanelType: typeof chrome.sidePanel
-          }
-        };
-      } else {
-        try {
-          outcome = await executeControlCommand(String(data.command ?? ""), data.params ?? {}, {
-            onLog: (level, message, meta) => sendLog(level, message, meta),
-            sessionId: typeof data.sessionId === "string" ? data.sessionId : void 0
-          });
-        } catch (e) {
-          outcome = { status: "error", message: e instanceof Error ? e.message : String(e) };
-        }
-      }
-      const resp = outcome.status === "ok" ? {
-        type: "cmd_response",
-        requestId: data.requestId,
+async function handleServerMessage(data) {
+  if (!data || typeof data !== "object") return;
+  if (data.type === "pong" || data.type === "status" || data.type === "ack") return;
+  if (data.type === "reload") {
+    console.log("[HunterMate] received reload broadcast, reloading extension in 200ms...");
+    setTimeout(() => chrome.runtime.reload(), 200);
+    return;
+  }
+  if (data.type === "cmd" && data.requestId) {
+    const startedAt = Date.now();
+    sendLog("info", "extension handling control command", { command: data.command, requestId: data.requestId, params: data.params });
+    let outcome;
+    if (data.command === "hm.status") {
+      const manifest = chrome.runtime.getManifest();
+      outcome = {
         status: "ok",
-        result: outcome.result,
-        durationMs: Date.now() - startedAt
-      } : {
-        type: "cmd_response",
-        requestId: data.requestId,
-        status: "error",
-        error: { code: outcome.code, message: outcome.message },
-        durationMs: Date.now() - startedAt
+        result: {
+          ...state,
+          tabStatesCount: tabStates.size,
+          extBasePath: chrome.runtime.getURL(""),
+          manifestPermissions: manifest.permissions,
+          hasSidePanelInManifest: manifest.permissions?.includes("sidePanel"),
+          chromeSidePanelType: typeof chrome.sidePanel,
+          wsHeldBy: "offscreen"
+        }
       };
+    } else {
       try {
-        socket?.send(JSON.stringify(resp));
-        sendLog("debug", "cmd_response sent", { requestId: data.requestId, status: resp.status, durationMs: resp.durationMs });
+        outcome = await executeControlCommand(String(data.command ?? ""), data.params ?? {}, {
+          onLog: (level, message, meta) => sendLog(level, message, meta),
+          sessionId: typeof data.sessionId === "string" ? data.sessionId : void 0
+        });
       } catch (e) {
-        sendLog("error", "cmd_response send failed", { requestId: data.requestId, error: e instanceof Error ? e.message : String(e) });
+        outcome = { status: "error", message: e instanceof Error ? e.message : String(e) };
       }
-      return;
     }
-    console.log("[HunterMate] server message", data);
-  };
+    const resp = outcome.status === "ok" ? {
+      type: "cmd_response",
+      requestId: data.requestId,
+      status: "ok",
+      // undefined 显式归一为 null:JSON.stringify 会丢 undefined 键,
+      // 调用方无法区分"无 result 键"与"result 为 undefined"
+      result: outcome.result === void 0 ? null : outcome.result,
+      durationMs: Date.now() - startedAt
+    } : {
+      type: "cmd_response",
+      requestId: data.requestId,
+      status: "error",
+      error: { code: outcome.code, message: outcome.message },
+      durationMs: Date.now() - startedAt
+    };
+    sendToOffscreen(JSON.stringify(resp));
+    sendLog("debug", "cmd_response sent", { requestId: data.requestId, status: resp.status, durationMs: resp.durationMs });
+  }
 }
-connect();
+chrome.runtime.onMessage.addListener((message) => {
+  if (message?.type === "offscreen:ws-state") {
+    state.wsConnected = !!message.wsConnected;
+    broadcastState();
+    return;
+  }
+  if (message?.type === "offscreen:ws-message") {
+    void handleServerMessage(message.payload);
+    return;
+  }
+});
 var RECONNECT_ALARM_NAME = "hm:reconnect";
 function ensureReconnectAlarm() {
   chrome.alarms.create(RECONNECT_ALARM_NAME, { periodInMinutes: 0.5 }).catch((err3) => console.error("[HunterMate] create reconnect alarm failed", err3));
@@ -3206,21 +3959,24 @@ function ensureReconnectAlarm() {
 chrome.alarms.onAlarm.addListener((alarm) => {
   if (alarm.name !== RECONNECT_ALARM_NAME) return;
   checkHttpHealth();
-  if (socket && socket.readyState !== WebSocket.OPEN && socket.readyState !== WebSocket.CONNECTING) {
-    socket = null;
-  }
-  if (!socket) {
-    connect();
-  }
+  sendLog("debug", "sw:alarm-tick", { wsConnected: state.wsConnected });
+  void ensureOffscreen();
 });
 ensureReconnectAlarm();
+void ensureOffscreen();
+chrome.runtime.onInstalled.addListener(() => {
+  console.log("[HunterMate] onInstalled: cold-start offscreen");
+  ensureReconnectAlarm();
+  void ensureOffscreen();
+});
+chrome.runtime.onStartup.addListener(() => {
+  console.log("[HunterMate] onStartup: cold-start offscreen");
+  ensureReconnectAlarm();
+  void ensureOffscreen();
+});
 setInterval(() => {
   checkHttpHealth();
-  if (socket?.readyState === WebSocket.OPEN) {
-    socket.send(JSON.stringify({ type: "ping" }));
-  } else {
-    connect();
-  }
+  void ensureOffscreen();
   broadcastState();
 }, 2e4);
 setInterval(() => {
@@ -3305,11 +4061,7 @@ chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
   if (message.type === "recording-event") {
     const tabId = sender.tab?.id ?? -1;
     const payload = { ...message.payload, tabId };
-    if (socket?.readyState === WebSocket.OPEN) {
-      socket.send(JSON.stringify(payload));
-    } else {
-      enqueueRecordingEvent(payload);
-    }
+    sendToOffscreen(JSON.stringify(payload));
     const ts = tabStates.get(tabId);
     if (ts && message.payload?.sessionId === ts.recordingSessionId) {
       ts.eventCount++;