fix: 跳过浏览器内置页面检测

setube · setube · commit 8f37e1f60bba · 2026-05-10T20:51:16.000+08:00
统一页面支持判断，浏览器内置页和扩展页不再触发后台检测、缓存写入和徽标显示。

补充 WebSocket 子请求观察与通用识别规则，HTTP/HTTPS 页面中的 ws/wss 握手会作为 API 线索合并展示。

插件版本升级到 1.2.2。
diff --git a/package.json b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "stackprism",
   "private": true,
-  "version": "1.2.1",
+  "version": "1.2.2",
   "type": "module",
   "description": "StackPrism 用于检测网页前端、后端、CDN、SaaS、广告营销、统计、登录、支付、网站程序和主题模板线索。",
   "scripts": {
diff --git a/public/rules/headers/header-patterns.json b/public/rules/headers/header-patterns.json
@@ -445,6 +445,19 @@
           }
         ]
       },
+      {
+        "defaults": {
+          "category": "安全与协议",
+          "confidence": "高"
+        },
+        "rules": [
+          {
+            "name": "WebSocket",
+            "patterns": ["url:\\s*wss?://|(?:^|\\n)upgrade:\\s*websocket|(?:^|\\n)sec-websocket-accept:"],
+            "evidence": "WebSocket 握手或 ws/wss 请求 URL"
+          }
+        ]
+      },
       {
         "category": "CMS / 电商平台",
         "name": "Shopify",
diff --git a/public/rules/headers/interesting-headers.json b/public/rules/headers/interesting-headers.json
@@ -34,6 +34,9 @@
       "link",
       "set-cookie",
       "content-type",
+      "upgrade",
+      "sec-websocket-accept",
+      "sec-websocket-protocol",
       "server-timing",
       "x-cdn",
       "x-cdn-provider",
diff --git a/public/rules/page/build-runtime.json b/public/rules/page/build-runtime.json
@@ -53,6 +53,14 @@
           "confidence": "中",
           "selectors": ["link[rel=\"manifest\"]"]
         },
+        {
+          "category": "安全与协议",
+          "name": "WebSocket",
+          "confidence": "中",
+          "resourceOnly": true,
+          "resourceHints": ["ws://", "wss://"],
+          "patterns": ["^wss?://"]
+        },
         {
           "name": "Zone.js",
           "confidence": "高",
diff --git a/public/tech-links.json b/public/tech-links.json
@@ -3,6 +3,7 @@
   "links": {
     "965": "https://www.drupal.org/project/ninesixtyfive",
     "1140": "http://cssgrid.net",
+    "WebSocket": "https://developer.mozilla.org/docs/Web/API/WebSockets_API",
     "Apache Solr Admin": "https://solr.apache.org",
     "Elasticvue": "https://elasticvue.com",
     "Dejavu": "https://github.com/appbaseio/dejavu",
diff --git a/src/background/content-injector.ts b/src/background/content-injector.ts
@@ -1,5 +1,6 @@
-const canInjectContentObserver = (tab: chrome.tabs.Tab): boolean =>
-  typeof tab?.id === 'number' && /^https?:\/\//i.test(String(tab.url || ''))
+import { isDetectablePageUrl } from '@/utils/page-support'
+
+const canInjectContentObserver = (tab: chrome.tabs.Tab): boolean => typeof tab?.id === 'number' && isDetectablePageUrl(tab.url)
 
 export const injectContentObserver = async (tabId: number): Promise<void> => {
   const observerFile = chrome.runtime.getManifest().content_scripts?.[0]?.js?.[0]
diff --git a/src/background/detection.ts b/src/background/detection.ts
@@ -1,13 +1,20 @@
 import { augmentPageWithWordPressThemeStyles } from './wordpress'
 import { buildPopupCacheRecord, cleanPageDetectionRecord } from './popup-cache'
 import { fetchMainHeadersFallback } from './headers'
-import { clearBadge, getTabData, getTabSnapshot, updateBadgeForTab, writeTabData } from './tab-store'
+import { clearBadge, clearTabSession, getTabData, getTabSnapshot, updateBadgeForTab, writeTabData } from './tab-store'
 import { buildEffectivePageRules, loadDetectorSettings, loadTechRules } from './detector-settings'
+import { isDetectablePageUrl } from '@/utils/page-support'
 
 const activeDetectionTimers = new Map<number, ReturnType<typeof setTimeout>>()
 
 export const saveTabDataAndBadge = async (tabId: number, data: any, settings: any) => {
-  const popup = buildPopupCacheRecord(data, settings, await getTabSnapshot(tabId))
+  const tab = await getTabSnapshot(tabId)
+  if (!isDetectablePageUrl(tab.url)) {
+    await clearTabSession(tabId)
+    clearBadge(tabId)
+    return
+  }
+  const popup = buildPopupCacheRecord(data, settings, tab)
   const { popup: _legacyPopup, ...tabData } = data || {}
   await writeTabData(tabId, tabData, popup)
   await updateBadgeForTab(tabId, popup)
@@ -18,6 +25,11 @@ export const refreshAllBadges = async () => {
     const [tabs, settings] = await Promise.all([chrome.tabs.query({}), loadDetectorSettings()])
     for (const tab of tabs) {
       if (typeof tab.id !== 'number' || tab.id < 0) continue
+      if (!isDetectablePageUrl(tab.url)) {
+        await clearTabSession(tab.id)
+        clearBadge(tab.id)
+        continue
+      }
       const data = await getTabData(tab.id)
       if (data && Object.keys(data).length) {
         await saveTabDataAndBadge(tab.id, data, settings)
@@ -34,6 +46,12 @@ export const runActivePageDetection = async (tabId: number) => {
   if (typeof tabId !== 'number' || tabId < 0) return
 
   try {
+    const tab = await getTabSnapshot(tabId)
+    if (!isDetectablePageUrl(tab.url)) {
+      await clearTabSession(tabId)
+      clearBadge(tabId)
+      return
+    }
     const [data, rules, settings] = await Promise.all([getTabData(tabId), loadTechRules(), loadDetectorSettings()])
     const pageRules = buildEffectivePageRules(rules.page || {}, settings)
     await chrome.scripting.executeScript({
diff --git a/src/background/dynamic-snapshot.ts b/src/background/dynamic-snapshot.ts
@@ -1,5 +1,6 @@
 // @ts-nocheck
 import { safeDecodeURIComponent } from '@/utils/url'
+import { isDetectablePageUrl } from '@/utils/page-support'
 import { mergeTechnologyRecords, normalizeDynamicFallbackTechName, shortHeaderUrl } from './merge'
 import {
   createCollector,
@@ -8,7 +9,7 @@ import {
   matchesRuleTextHints,
   passesRulePrefilter
 } from './rule-matcher'
-import { getTabData } from './tab-store'
+import { clearBadge, clearTabSession, getTabData, getTabSnapshot } from './tab-store'
 import { saveTabDataAndBadge, scheduleActivePageDetection } from './detection'
 import { buildEffectivePageRules, loadDetectorSettings, loadTechRules } from './detector-settings'
 
@@ -631,6 +632,13 @@ const processQueuedDynamicSnapshot = async tabId => {
     return
   }
 
+  const tab = await getTabSnapshot(tabId)
+  if (!isDetectablePageUrl(tab.url)) {
+    await clearTabSession(tabId)
+    clearBadge(tabId)
+    return
+  }
+
   const [data, rules, settings] = await Promise.all([getTabData(tabId), loadTechRules(), loadDetectorSettings()])
   data.dynamic = normalizeDynamicSnapshot(snapshot, buildEffectivePageRules(rules.page || {}, settings), data.dynamic)
   data.updatedAt = Date.now()
diff --git a/src/background/index.ts b/src/background/index.ts
@@ -3,9 +3,10 @@ import { clearBadge, clearTabSession } from './tab-store'
 import { clearDynamicSnapshotTimer, clearPendingDynamicSnapshot } from './dynamic-snapshot'
 import { buildHeaderRecord, dedupeApiRecords } from './headers'
 import { clearActiveDetectionTimer, refreshAllBadges, saveTabDataAndBadge, scheduleActivePageDetection } from './detection'
-import { getTabData } from './tab-store'
+import { getTabData, getTabSnapshot } from './tab-store'
 import { SETTINGS_STORAGE_KEY, applyDetectorSettingsUpdate, loadDetectorSettings, loadTechRules } from './detector-settings'
 import { registerMessageRouter } from './message-router'
+import { isDetectablePageUrl, isObservableRequestUrl } from '@/utils/page-support'
 
 registerMessageRouter()
 
@@ -24,7 +25,21 @@ chrome.tabs.onRemoved.addListener(tabId => {
   clearTabSession(tabId)
 })
 
-chrome.tabs.onUpdated.addListener((tabId, changeInfo) => {
+const clearTabDetectionState = (tabId: number) => {
+  clearActiveDetectionTimer(tabId)
+  clearDynamicSnapshotTimer(tabId)
+  clearPendingDynamicSnapshot(tabId)
+  clearBadge(tabId)
+  clearTabSession(tabId).catch(() => {})
+}
+
+chrome.tabs.onUpdated.addListener((tabId, changeInfo, tab) => {
+  const url = changeInfo.url || tab.url || ''
+  if (url && !isDetectablePageUrl(url)) {
+    clearTabDetectionState(tabId)
+    return
+  }
+
   if (changeInfo.status === 'loading') {
     clearActiveDetectionTimer(tabId)
     clearDynamicSnapshotTimer(tabId)
@@ -34,7 +49,11 @@ chrome.tabs.onUpdated.addListener((tabId, changeInfo) => {
   }
 
   if (changeInfo.status === 'complete') {
-    scheduleActivePageDetection(tabId, 600)
+    if (isDetectablePageUrl(url)) {
+      scheduleActivePageDetection(tabId, 600)
+    } else {
+      clearTabDetectionState(tabId)
+    }
   }
 })
 
@@ -48,17 +67,26 @@ chrome.storage.onChanged.addListener((changes, areaName) => {
 chrome.webRequest.onHeadersReceived.addListener(
   details => {
     if (details.tabId < 0 || !details.responseHeaders) return
+    if (!isObservableRequestUrl(details.url)) return
 
-    Promise.all([getTabData(details.tabId), loadTechRules(), loadDetectorSettings()])
-      .then(([data, rules, settings]) => {
+    Promise.all([getTabData(details.tabId), loadTechRules(), loadDetectorSettings(), getTabSnapshot(details.tabId)])
+      .then(([data, rules, settings, tab]) => {
+        if (details.type === 'main_frame' && !isDetectablePageUrl(details.url)) {
+          clearTabDetectionState(details.tabId)
+          return
+        }
+        if (details.type !== 'main_frame' && !isDetectablePageUrl(tab.url)) {
+          clearTabDetectionState(details.tabId)
+          return
+        }
         const record = buildHeaderRecord(details, rules.headers || {}, settings)
         if (details.type === 'main_frame') {
           data.main = record
           data.apis = []
           data.frames = []
           delete data.page
           delete data.dynamic
-        } else if (details.type === 'xmlhttprequest' || (details.type as string) === 'fetch') {
+        } else if (details.type === 'xmlhttprequest' || (details.type as string) === 'fetch' || details.type === 'websocket') {
           data.apis = dedupeApiRecords([record, ...(data.apis || [])])
         } else if (details.type === 'sub_frame') {
           data.frames = dedupeApiRecords([record, ...(data.frames || [])]).slice(0, 10)
@@ -68,6 +96,6 @@ chrome.webRequest.onHeadersReceived.addListener(
       })
       .catch(() => {})
   },
-  { urls: ['<all_urls>'] },
+  { urls: ['http://*/*', 'https://*/*', 'ws://*/*', 'wss://*/*'] },
   ['responseHeaders', 'extraHeaders']
 )
diff --git a/src/background/message-router.ts b/src/background/message-router.ts
@@ -1,11 +1,17 @@
 import { getTechnologyUrl } from './tech-links'
 import { augmentPageWithWordPressThemeStyles, detectWordPressThemeStylesFromPage } from './wordpress'
-import { getTabData, getTabSnapshot } from './tab-store'
+import { clearBadge, clearTabSession, getTabData, getTabSnapshot } from './tab-store'
 import { queueDynamicSnapshot } from './dynamic-snapshot'
 import { addStoredCustomHeaderRules } from './headers'
 import { buildPopupRawResult, cleanPageDetectionRecord, cleanTechnologyRecords, getPopupResultResponse } from './popup-cache'
 import { runActivePageDetection, saveTabDataAndBadge } from './detection'
 import { loadDetectorSettings } from './detector-settings'
+import { checkPageSupport, isDetectablePageUrl } from '@/utils/page-support'
+
+const clearUnsupportedTab = async (tabId: number) => {
+  await clearTabSession(tabId)
+  clearBadge(tabId)
+}
 
 export const registerMessageRouter = () => {
   chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
@@ -36,8 +42,16 @@ export const registerMessageRouter = () => {
         sendResponse({ ok: false, error: '缺少有效 tabId' })
         return false
       }
-      Promise.all([getTabData(tabId), loadDetectorSettings(), getTabSnapshot(tabId)])
-        .then(([data, settings, tab]) => buildPopupRawResult(addStoredCustomHeaderRules(data, settings), settings, tab))
+      getTabSnapshot(tabId)
+        .then(async tab => {
+          const support = checkPageSupport(tab.url)
+          if (!support.supported) {
+            await clearUnsupportedTab(tabId)
+            throw new Error(support.reason)
+          }
+          const [data, settings] = await Promise.all([getTabData(tabId), loadDetectorSettings()])
+          return buildPopupRawResult(addStoredCustomHeaderRules(data, settings), settings, tab)
+        })
         .then(data => sendResponse({ ok: true, data }))
         .catch(error => sendResponse({ ok: false, error: String(error) }))
       return true
@@ -58,7 +72,14 @@ export const registerMessageRouter = () => {
         return false
       }
       sendResponse({ ok: true })
-      runActivePageDetection(tabId).catch(() => {})
+      getTabSnapshot(tabId)
+        .then(tab => {
+          if (!isDetectablePageUrl(tab.url)) {
+            return clearUnsupportedTab(tabId)
+          }
+          return runActivePageDetection(tabId)
+        })
+        .catch(() => {})
       return false
     }
 
@@ -75,9 +96,17 @@ export const registerMessageRouter = () => {
         sendResponse({ ok: false, error: '缺少有效 tabId' })
         return false
       }
-      queueDynamicSnapshot(tabId, message.snapshot)
-      sendResponse({ ok: true })
-      return false
+      getTabSnapshot(tabId)
+        .then(tab => {
+          if (!isDetectablePageUrl(tab.url)) {
+            return clearUnsupportedTab(tabId).then(() => false)
+          }
+          queueDynamicSnapshot(tabId, message.snapshot)
+          return true
+        })
+        .then(queued => sendResponse({ ok: true, queued }))
+        .catch(error => sendResponse({ ok: false, error: String(error) }))
+      return true
     }
 
     if (message.type === 'PAGE_DETECTION_RESULT') {
@@ -86,8 +115,12 @@ export const registerMessageRouter = () => {
         sendResponse({ ok: false, error: '缺少有效 tabId' })
         return false
       }
-      Promise.all([getTabData(tabId), loadDetectorSettings()])
-        .then(async ([data, settings]) => {
+      Promise.all([getTabData(tabId), loadDetectorSettings(), getTabSnapshot(tabId)])
+        .then(async ([data, settings, tab]) => {
+          if (!isDetectablePageUrl(tab.url)) {
+            await clearUnsupportedTab(tabId)
+            return
+          }
           const page = await augmentPageWithWordPressThemeStyles(message.page)
           data.page = cleanPageDetectionRecord(page)
           data.updatedAt = Date.now()
diff --git a/src/background/popup-cache.ts b/src/background/popup-cache.ts
@@ -1,6 +1,6 @@
 import { attachTechnologyLinks } from './tech-links'
 import { addStoredCustomHeaderRules } from './headers'
-import { getPopupCache, getTabData, getTabSnapshot, popupStorageKey, storageKey } from './tab-store'
+import { clearBadge, clearTabSession, getPopupCache, getTabData, getTabSnapshot, popupStorageKey, storageKey } from './tab-store'
 import {
   strongerConfidence,
   suppressDuplicateWebsiteProgramCategories,
@@ -12,6 +12,7 @@ import { categoryIndex, confidenceRank } from '@/utils/category-order'
 import { cleanTechnologyUrl } from '@/utils/url'
 import { cleanStringArray } from '@/utils/normalize-settings'
 import { normalizeTechName } from '@/utils/tech-name'
+import { checkPageSupport } from '@/utils/page-support'
 
 export const POPUP_CACHE_STALE_MS = 2 * 60 * 1000
 const POPUP_CACHE_SCHEMA_VERSION = 1
@@ -72,6 +73,18 @@ const buildTechnologyCounts = (technologies: any[]) => ({
   low: technologies.filter(tech => tech.confidence === '低').length
 })
 
+const buildEmptyPopupResult = (tab: any) => ({
+  url: tab?.url || '',
+  title: tab?.title || '',
+  generatedAt: new Date().toISOString(),
+  updatedAt: 0,
+  technologies: [],
+  counts: buildTechnologyCounts([]),
+  categoryCounts: {},
+  resources: { total: 0 },
+  headerCount: 0
+})
+
 const buildCategoryCounts = (technologies: any[]) =>
   technologies.reduce((acc: Record<string, number>, tech) => {
     acc[tech.category] = (acc[tech.category] || 0) + 1
@@ -243,6 +256,22 @@ export const buildPopupCacheRecord = (data: any, settings: any, tab: any) => {
 }
 
 export const getPopupResultResponse = async (tabId: number) => {
+  const tab = await getTabSnapshot(tabId)
+  const support = checkPageSupport(tab.url)
+  if (!support.supported) {
+    await clearTabSession(tabId)
+    clearBadge(tabId)
+    return {
+      ok: true,
+      data: buildEmptyPopupResult(tab),
+      hasCache: false,
+      stale: false,
+      updatedAt: 0,
+      unsupported: true,
+      reason: support.reason
+    }
+  }
+
   const [storedPopup, settings] = await Promise.all([getPopupCache(tabId), loadDetectorSettings()])
   const cachedPopup = getCachedPopupResult(storedPopup, settings)
   if (cachedPopup) {
@@ -255,7 +284,7 @@ export const getPopupResultResponse = async (tabId: number) => {
     }
   }
 
-  const [data, tab] = await Promise.all([getTabData(tabId), getTabSnapshot(tabId)])
+  const data = await getTabData(tabId)
   const popup = buildPopupCacheRecord(data, settings, tab)
   if (hasStoredDetection(data)) {
     const { popup: legacyPopup, ...tabData } = data || {}
diff --git a/src/manifest.config.ts b/src/manifest.config.ts
diff --git a/src/ui/popup/Popup.vue b/src/ui/popup/Popup.vue
diff --git a/src/utils/page-support.ts b/src/utils/page-support.ts

Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "stackprism",`
`3`	`3`	`"private": true,`
`4`		`- "version": "1.2.1",`
	`4`	`+ "version": "1.2.2",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"description": "StackPrism 用于检测网页前端、后端、CDN、SaaS、广告营销、统计、登录、支付、网站程序和主题模板线索。",`
`7`	`7`	`"scripts": {`