Discuz！ 插件小蟻歷史上的今天

 一、插件介紹

小蟻歷史上的今天是一款面向Discuz！ 論壇的內容型插件，把「歷史上的今天」搬到站點里：每天自動聚合當日發生的歷史大事、誕辰與逝世，既有獨立展示頁，也能以論壇首頁小部件和前台DIY模塊的形式嵌入任意頁面。
插件內置百度百科官方、Tmini、客官API、接口盒子四個免費數據源，站長可在後台自選主接口，並用下拉框排定備用接口順序； 主接口失效時自動按順序切換，連續失敗自動熔斷，全部失敗時繼續展示最近一次緩存，頁面永不空白。
數據採用本地緩存：百度百科源一次拉取整月、其餘源每日一次，全部落盤到插件`cache/`目錄，不產生接口限頻，也不給服務器增加額外負擔。

插件演示：https://fjxiaoyidzx50.fqlook.cn/plugin.php?id=fjxiaoyi_today:index

二、插件特點

1.四個數據源+自動容災
百度百科官方（免KEY，含標題/年份/描述/鏈接/節日/配圖，支持按月拉取）\Tmini（默認免KEY，可選專屬ckey）\客官API（免KEY）\接口盒子（需註冊ID+KEY，未申請時以公共測試ID兜底）
失效判定覆蓋HTTP非200、業務code異常、JSON解析失敗、事件為空、限頻/鑒權錯誤； 連續失敗3次熔斷30分鐘后自動試探恢復。
2.接口地址全可改四個數據源的調用網址都能在後台直接編輯，並支持一鍵恢復內置默認地址——官方接口地址若有變動，站長改配置即可，無需改代碼。
3.按日期查看（日曆）獨立頁頂部提供當月月曆，點任意日期即切換查看（`？m=&d=`）； 已選日期高亮，非今天時提供「回到今天」。 百度百科源為月級接口，同月內切換任意日期零新增請求，僅在跨月時各拉取一次。
4.兩套內置模板，一鍵換膚「暖金古典」與「蔚藍星海」兩套模板，後台一鍵切換，各帶一套分類圖標（35 × 35px）與內置banner背景圖； 每套模板的banner可分別上傳自定義圖片（JPG/PNG/WebP，推薦1600 × 533）並能分別一鍵恢復默認，互不干擾。
5.前台DIY模塊（可拖拽）已註冊到Discuz前台DIY模塊列表，門戶首頁、頻道頁、論壇首頁、主題列表等任意DIY頁面均可拖入。 屬性面板可調：展示樣式（緊湊雙列/單列卡片（含簡介）/豎向時間軸）、顯示條數（1~50）、事件類型（大事記/誕生/逝世）、指定日期（留空為今天，或填「月-日」固定某天）、是否顯示節日/年份/簡介/配圖/百科鏈接/專題入口、圓角、與同框架模塊自動等高，以及配色方案（跟隨插件設置或單獨指定模板）。
模塊只讀本地緩存、不發起任何聯網請求，放在高頻頁面也不會拖慢站點。
6.手機版全適配獨立頁面與首頁小部件均內置手機模板（`template/touch/`），由Discuz自動切換，無需額外設置； 後台全部設置（模板配色、banner、圖標、自定義鏈接、百科開關）同步生效。 手機版日曆默認摺疊，展開后可選「年/月/日」查看，非今天日期時出現「回到今天」。
7.日曆下方自定義鏈接獨立頁右側日曆下方支持站長自定義鏈接（圖標+標題+副標題+鏈接），格式為`圖標|標題|副標題|鏈接`，每行一條； 內置維基百科、百度百科日曆、On This Day三條默認鏈接，可一鍵恢復默認。 協議已過濾`javascript：`/`data：`。
8.合規與安全可一鍵隱藏事件條目上的「查看百科」外鏈，改為在頁面標註實際數據來源，避免過度外鏈； 全部輸出經`dhtmlspecialchars()`轉義，外部請求開啟SSL證書校驗，卸載腳本自動清理緩存與運行期上傳文件。

三、站長選擇這個插件的理由

1.開箱即用，零成本：百度百科官方與客官API完全免KEY，裝完就能用； 不需要申請、不用付費。
2.數據不會斷：四源互為備份+自動熔斷+舊緩存兜底，任一接口掛掉都不會導致頁面空白。
3.對服務器友好：數據全部本地緩存，頁面渲染從不聯網，無接口限頻風險，也不拖慢論壇。
4.內容有質量：唯一提供節日與事件配圖的百度百科官方源作為默認主源，展示效果優於純文本源。
5.改動零門檻：接口地址、顯示開關、模板配色、自定義鏈接全在後台點點鼠標即可完成，不需要改代碼。
6.融入站點而非外掛：可作為論壇首頁小部件，也能作為DIY模塊拖進門戶、頻道、版塊列表任意位置，與現有頁面渾然一體。
7.PC/手機雙端齊全：手機模板隨Discuz自動切換，手機端體驗完整。
8.乾淨、合規：不建自建數據表，卸載無殘留； 可隱藏外鏈並標註來源； 輸出轉義、SSL校驗齊備。
9.廣泛兼容：同時支持Discuz！ X3.4/X3.5/X5.0/X5.1，UTF-8 簡體中文編碼，升級換代無痛。