twpkinfo-adblocker/README.md

TWPKInfo 廣告清除器

一個專為台灣寶可夢資訊站（TWPKInfo）設計的使用者腳本，移除廣告和多餘介面元素，讓地圖功能更純淨好用。

功能特色

🧹 介面清理

• 移除頂部導覽列：隱藏網站標題、主選單等導覽元素
• 清除底部功能列：移除底部導航欄和廣告區塊
• 廣告阻擋：完全阻止 Google AdSense 廣告載入
• 動態監控：即時偵測並清理新增的廣告元素

🗺️ 地圖最佳化

• 全屏地圖：地圖自動擴展至整個瀏覽器視窗
• 保留地圖控制：完整保留縮放、定位等 Leaflet 地圖功能
• 響應式調整：視窗大小變化時自動重新調整地圖尺寸

🔧 使用體驗增強

• 中文工具提示：為地圖控制按鈕添加清晰的中文說明
• 智慧定位：工具提示會根據螢幕邊界自動調整顯示位置
• 快速識別：滑鼠懸停即可了解各按鈕功能

技術規格

清理策略

使用多重偵測機制確保完整清理：

1. 位置偵測：識別固定定位在底部的元素
2. 尺寸分析：移除符合導航列特徵的大型元素
3. 類名匹配：依據 CSS 類名模式過濾
4. 內容識別：根據文字內容判斷元素性質
5. 結構分析：檢查 DOM 層級結構關係

保護機制

嚴格保護重要功能元素：

• #map 主地圖容器
• .leaflet-container 地圖引擎
• .leaflet-control-* 地圖控制元件
• [class*="pokemon"] 寶可夢相關元素
• .leaflet-control-attribution 地圖版權資訊

工具提示系統

• 純 CSS 實現：使用偽元素避免 JavaScript 衝突
• 自適應佈局：根據可視區域自動調整顯示方向
• 多重觸發：支援滑鼠懸停、鍵盤焦點、螢幕閱讀器

支援頁面

• 主地圖：https://twpkinfo.com/
• 道館地圖：https://twpkinfo.com/igym.aspx
• 寶可夢地圖：https://twpkinfo.com/ipoke.aspx
• 任務地圖：https://twpkinfo.com/iquest.aspx
• 所有子域：https://*.twpkinfo.com/*

兼容性

瀏覽器支援

• Chrome / Chromium：✅ 完全支援
• Firefox：✅ 完全支援
• Safari：✅ 支援（需安裝 Userscripts 擴充功能）
• Edge：✅ 完全支援

使用者腳本管理器

• Tampermonkey：✅ 推薦使用
• Greasemonkey：✅ 支援
• Violentmonkey：✅ 支援
• Userscripts Safari：✅ 支援

效能特性

• 輕量級：腳本大小 < 20KB
• 低記憶體：使用 CSS 隱藏取代 DOM 移除
• 高效能：智慧節流避免過度執行
• 非侵入性：不影響網站核心功能

版本資訊

當前版本：1.1.7
授權條款：MIT License
執行時機：頁面開始載入時（document-start）
權限需求：無需特殊權限（@grant none）

API 文件

主要函數

addCleanupCSS()

注入清理樣式規則，隱藏廣告和導覽元素。

cleanupBottomBar()

移除底部功能列，返回清理元素數量。

cleanupTopNavigation()

清理頂部導覽列，返回移除元素數量。

applyToolbarTooltips()

為地圖工具添加中文工具提示。

startCleanupMonitor()

啟動動態內容監控，自動清理新增元素。

配置選項

腳本內建智慧偵測，通常無需手動配置。如需客製化，可修改以下區段：

• CSS 選擇器規則（第 36-208 行）
• 工具提示文字對應（第 259-306 行）
• 偵測策略參數（第 354-390 行）

更新日誌

查看完整更新紀錄和技術變更，請參閱 SUMMARY.md。