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 简体中文编码，升级换代无痛。