Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/jimmy-is-me/spam-user-cleaner/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
WordPress 外掛，根據使用者名稱 (
user_login) 關鍵字批次偵測並刪除垃圾機器人帳號，支援預覽確認、個別排除、勾選精準刪除與智能速度調節。
✨ 功能特色
| 功能 | 說明 |
|---|---|
| 📝 手動輸入關鍵字 | 後台可隨時新增/修改，每行一個，支援 # 開頭的註解行 |
| 🔍 完整搜尋結果顯示 | 先載入所有符合帳號供確認，再決定是否刪除，避免誤刪 |
| 🚫 個別排除 | 對特定帳號點「排除」，即可從刪除範圍中移除 |
| ✅ 勾選刪除 | 可勾選特定帳號精準刪除，不必全部清除 |
| ⚡ 智能速度調節 | 自動 / 保守 / 標準 / 積極，依伺服器記憶體與 CPU 負載動態調整 |
| 📊 即時進度條 | 全程顯示刪除進度、剩餘數量、目前批次模式 |
| ⏹ 暫停按鈕 | 可隨時暫停批次刪除 |
| 🛡️ 雙重保護 | 僅處理 subscriber 角色，具備 manage_options 的管理員帳號永不刪除 |
📦 安裝方式
- 下載 spam-user-cleaner zip檔案
- 上傳至 WordPress 網站
- 到 WordPress 後台 外掛 頁面，啟用「垃圾機器人帳號清除工具」
- 進入 工具 → 垃圾帳號清除
🚀 使用流程
輸入關鍵字 → 儲存計算 → 載入清單預覽 → 排除真實帳號 → 勾選刪除 or 批次清空
- 在關鍵字區輸入要比對的使用者名稱片段（例如
btc、trade、blogspot） - 點「💾 儲存並重新計算」，確認符合筆數
- 點「📋 載入清單」，查看所有符合帳號（每頁 200 筆，支援分頁）
- 對不想刪除的帳號點「🚫 排除」
- 選擇以下其中一種刪除方式：
- 「🗑️ 刪除勾選的帳號」→ 精準刪除目前勾選的帳號
- 「全部批次刪除」→ 根據關鍵字自動分批清空所有符合帳號
⚡ 速度模式說明
| 模式 | 每批筆數 | 間隔時間 | 適用情境 |
|---|---|---|---|
| 🤖 自動 | 動態決定 | 動態 | 預設推薦，依伺服器狀態自動選擇 |
| 🐢 保守 | 50 筆 | 2 秒 | 低規格主機、尖峰時段 |
| 🚗 標準 | 200 筆 | 1 秒 | 一般共用主機 |
| 🚀 積極 | 500 筆 | 無 | VPS / 獨立伺服器、離峰時段 |
🔍 搜尋欄位
本外掛搜尋的是 wp_users.user_login（使用者名稱）欄位。
例如設定關鍵字 btc，會匹配以下帳號：
abcbtc99
btc_trader
mybtcwallet2024
🛡️ 安全機制
- 所有 Ajax 請求均使用 WordPress Nonce 驗證，防止 CSRF 攻擊
- 僅刪除 subscriber 角色帳號
- 具備
manage_options權限的帳號永遠不會被刪除，即使使用者名稱符合關鍵字 - 刪除帳號時，文章內容自動重新分配給管理員（ID=1）
⚠️ 注意事項
- 執行刪除前請先備份資料庫，此操作無法復原
- 建議先用「載入清單」確認結果，再執行刪除
- 10 萬筆帳號建議使用「標準」或「保守」模式，避免伺服器逾時
📋 預設關鍵字
blogspot btc usdt usd euro trade trading crypto forex
可在後台頁面隨時修改，儲存後立即生效。
📁 檔案結構
spam-user-cleaner/ └── spam-user-cleaner.php ← 唯一檔案，單檔外掛
📄 License
MIT License