# 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](SUMMARY.md)。