把中文維基百科的管理員積壓工作(速刪、VIP、RFPP、各種申請……)同步到 Telegram 頻道:有新任務時發訊息,任務處理完就刪除或標記訊息,並在頻道描述顯示各類別的數量。
觸發端(監看維基的頁面編輯與分類變動)
└─ 依頁名或分類名執行 php sender.php -r <type>
├─ 抓維基頁面(action=raw)或分類成員(API)
├─ 和 DB 的 task 表比對:新任務 sendMessage、內容變了 editMessage、消失了 deleteMessage
└─ 有變動時更新頻道描述
sender.php 主要由觸發端在事件發生時執行。另外由 cron 執行 sender.php --stale 作為保底:每次挑一個超過 stalelimit(預設 24 小時)沒有執行的類別來跑,讓執行失敗或頁面一直沒被編輯的類別,也能每天至少更新一次。每次只跑一個類別,是為了避開 Telegram 的發送上限。
| 檔案 | 用途 |
|---|---|
sender.php |
主程式。-r <type> 執行指定類別(可重複),--stale 執行最久沒跑的類別,-f 忽略鎖,-d 強制更新頻道描述,--del <message_id> 刪除一則訊息 |
renew.php |
重發快超過 48 小時的訊息(Telegram bot 只能刪除 48 小時內的訊息)。建議每 5 分鐘執行 |
cleanlog.php |
刪除超過 logkeep 的 log。建議每天執行 |
delete.php |
手動刪除訊息:php delete.php <id> 或 <起>-<迄> |
function/wikipedia.php |
各類別的抓取與解析(handler) |
function/telegram.php |
Telegram API:發送、編輯、刪除訊息與更新描述 |
function/function.php |
鎖、fetchUrl 等共用函式 |
| 表 | 內容 |
|---|---|
task |
頻道上目前的任務,每則訊息一列。starttime 為首次偵測時間,date 為訊息送出時間。沒有實際發送的任務(hidden 類別、超過 csdbotlimit 的速刪)message_id 為負數的佔位值,編輯與刪除時不會呼叫 Telegram API |
task_type |
每個類別一列:locked_at(執行中的鎖)、last_run(最後執行結束)、last_found(最後偵測到新任務) |
log |
觸發紀錄(request: <type>、--stale 的 stale: <type>)與錯誤(send fail、edit fail、中止原因等) |
-
git submodule update --init(function/Mediawiki-urlencode) -
匯入
install/database.sql -
建立
config/config.php覆寫config/config.default.php的設定,至少要有token、chat_id與 DB 連線資訊 -
設定排程:
*/5 * * * * php /path/to/renew.php 3-59/10 * * * * php /path/to/sender.php --stale 16 2 * * * php /path/to/cleanlog.php--stale每 10 分鐘跑一個類別,一天 144 次,足夠讓所有類別每天輪到。分鐘錯開renew.php,避免同時發訊息。 -
讓觸發端在對應頁面或分類有變動時執行
php sender.php -r <type>
需要 PHP 8.0 以上(使用 str_starts_with),以及 pdo_mysql、mbstring。
| 設定 | 說明 |
|---|---|
typelist |
頻道描述中每個 %name% 由哪些類別加總。新增類別要記得加進對應群組與 sum |
ChatDescription |
頻道描述範本 |
disabletype |
停用的類別:照常解析,但不發訊息也不存 DB |
hiddentype |
隱藏的類別:不發訊息,但存進 DB(只計入頻道描述的數量),renew.php 也會略過 |
renewlimit |
訊息送出多久後由 renew.php 重發 |
locklimit |
鎖的逾時秒數,超過就視為失效 |
stalelimit |
--stale 視為過久沒執行的秒數,預設 86400 |
csdbotlimit |
同一個機器人掛的速刪最多發幾則 |
BadRequester |
VIP 中要忽略的提報人 |
EPFULL.ignore_pattern |
epfull 中要忽略的頁名 |
類別名稱和頁名都是精確比對,任何一處對不上都會被靜默略過,不會報錯。
- 新增類別:
- 在觸發端加上頁名或分類名到
-r <type>的對應 - 在
sender.php加上if (in_array("<type>", $run))區塊 - 在
config.default.php的typelist加入對應群組與sum,需要的話也改ChatDescription
- 在觸發端加上頁名或分類名到
- 頁面改名:觸發端和
sender.php兩邊都要改成新頁名。sender 用action=raw抓頁面,不會跟隨重定向,抓到舊頁名只會拿到#REDIRECT。
- 頁面格式會變。 類別突然變成 0 筆時,先懷疑 regex。曾出現過的格式變化有:
====[[User:X]]====加了空格*{{status變成* {{status- VIP 從
===改為==標題 {{User|X}}改為{{vandal|X}}- 機器人使用繁體「處理:」
- regex 沒有
/u修飾詞。 不要在字元類別中放中文,[处處]會逐 byte 比對。要寫成(?:处|處)。 - 抓取失敗必須中止。
fetchUrl()遇到網路錯誤或非 2xx 回應時,會呼叫abortRun()解鎖並結束。如果把錯誤頁當成內容解析,會得到空清單,進而刪光頻道上該類別的所有訊息。Wikimedia 要求 User-Agent,沒帶會回 403。 - Telegram 的錯誤描述可能附加說明。 判斷可忽略的錯誤時用前綴比對(
str_starts_with),不要用精確比對。 - Telegram 群組發送上限約每分鐘 20 則。 超過會回 429,
sendMessage()目前不會重試,所以一次補發大量訊息時,會有一部分送不出去。
各類別最後觸發、執行與偵測到新任務的時間:
SELECT t.type, t.last_run, t.last_found, t.locked_at,
(SELECT MAX(time) FROM log WHERE msg REGEXP CONCAT('^request: (.*, )?', t.type, '(,|$)')) AS last_request,
(SELECT COUNT(*) FROM task WHERE task.type = t.type) AS tasks
FROM task_type t ORDER BY t.last_run;最近的錯誤:
SELECT * FROM log WHERE msg NOT LIKE 'request:%' ORDER BY id DESC LIMIT 20;試跑解析結果而不發出訊息:直接執行 sender.php 一定會發 Telegram 訊息。要試跑時,另寫一支腳本,載入 config、function.php、database.php、wikipedia.php,並自行定義假的 sendMessage、editMessage、deleteMessage(不要載入 telegram.php),再呼叫對應的 handler,例如:
CategoryMemberHandler("unblock", "#封禁申訴", "Category:封禁及禁制申诉", "page");
(new VIPHandler())->run(); // class handler 也可以繼承後覆寫 send_message / delete_message只想看 regex 比對結果時,可以直接呼叫 PageMatchList($page, $regex)。