Discuz!插件 小蚁韩国万年历

一、插件说明
小蚁韩国万年历是福建小蚁网络科技面向 Discuz! 社区打造的专业历法类插件。插件以“韩国历法查询”为核心，将公历、韩国阴历、干支生肖、二十四节气、韩国公休日与中国法定节假日整合于同一张月历之中，同步提供阴阳历双向转换、下个公休日倒计时、本月日程一览等实用功能，并以 PC 与 WAP 双端响应式布局呈现，适配中文、韩文、繁体三种语言环境。

插件全部核心算法与资源均本地化实现，不依赖任何远程接口，安装即用、稳定可靠；所有数据与功能开关均可在后台可视化配置，无需改动任何 Discuz 核心文件，完全通过系统原生钩子与插件机制承载，安全合规、升级无忧。

一句话定位 ：把“韩国日历 + 中韩节假日 + 二十四节气 + 阴阳历转换”装进一个插件，中文韩文站点皆可即装即用。

二、核心功能
1. 中韩双历同屏对照 ：韩国公休日以红色标记，中国法定节假日以绿色下划线标记，中国调休上班日以灰色下划线标记，两国节假日同日时并列显示，互不干扰。
2. 完整历法信息 ：公历、韩国阴历（含闰月）、干支、生肖、二十四节气与节气释义，一屏尽览。
3. 二十四节气自动切换 ：支持“按当前节气自动切换顶部大图”“固定图片”“固定图+节气当天切换”三种模式，内置多套节气图标库，可在后台自由更换。
4. 节假日数据体系 ：内置韩国 2026/2027 公休日、中国 2026 法定节假日（含调休上班日）；采用“内置算法 → 官方/导入年度数据 → 站长自定义覆盖”三级优先级，支持后台表单、批量录入与 JSON 导入导出，未来年度可自主维护。
5. 阴阳历双向转换 ：公历转阴历、阴历转公历（支持闰月），即时给出结果。
6. 日程与倒计时 ：展示本月主要日程、纪念日、传统节日、无损日，并显示下一个公休日及剩余天数。
7. 多语言与多端 ：简体中文、繁体中文、韩语三语包，前台可切换；PC 与 WAP 独立模板，移动端体验完整。
8. SEO 增强 ：标题、摘要、关键词支持十四种占位符模板，输出 canonical 自引用、robots 指令与 Open Graph / Twitter 社交分享卡片（含 1:1 分享缩略图上传），助力搜索引擎收录与社交传播。
9. 可视化后台 ：基础与显示、SEO 设置、节气图片、年度公休日、批量添加、自定义日期、翻译接口、数据与说明共八大模块，全部图形化操作。
10. 可选智能翻译 ：后台可接入小牛翻译（NiuTrans）实现一键翻译，内置本地术语表优先匹配，命中术语不消耗接口额度；未启用时核心功能完全不受影响。
三、产品卖点
- 差异化定位，填补空白 ：市面上历法插件多聚焦农历或单一节日，本插件首创“韩国历法 + 中韩节假日同屏对照”一体化方案，精准服务中韩双语社区、韩流文化、留学移民、跨境电商等垂直场景。
- 开箱即用，免配置负担 ：内置韩国与中国官方年度节假日数据，安装即自动写入，无需站长手工整理，运营零门槛。
- 零外部依赖，稳定高效 ：历法换算、节气推演、节假日算法、图片与脚本资源全部本地化，不依赖任何第三方接口，加载快、无失效风险，长期运行更安心。
- 合规安全，通过审查标准 ：全程使用系统原生钩子与插件封装，不改核心；数据库操作统一走 Discuz 内置 DB 类并做参数过滤；输入输出经原生安全函数处理，具备 CSRF 令牌校验与权限控制，完全符合应用中心上架规范。
- 高度可定制，兼顾个性与统一 ：多套内置主题配色并支持自定义主色，顶部大图、节气图标、显示项开关、每周起始日均可按站点调性自由调整。
- 干净卸载，无残留 ：配备安装、升级、卸载与自检脚本，卸载时可完整清理插件数据，不留脏数据。