这是一个专为 Hexo Butterfly 主题量身定制的主页置顶古典散曲/诗词流转卡片功能。它摒弃了市面上常见的现代扁平化或大色块工业设计，完美消融于古典、唯美、乃至“赛博玄学”的博客气韵中，为每一个踏入数字花园的访客翻开一缕跨越时空的线装书香。

✨ 功能亮点

  • ⚡ 零延迟 · 独立闭环：词库完全内置于单一控制脚本中，无需任何外部 API 或不稳定的第三方网络请求，加载速度达到微秒级，完美杜绝因路径冲突或网络波动导致的卡片空白。
  • 🎲 真 · 随机盲盒算法：彻底砸碎了浏览器缓存和特征推荐机制的魔咒。内置前端防重复碰撞算法，确保每次 F5 强制刷新，或者点击下方按钮，摇出的都是全新笺纸，绝不当“复读机”。
  • 🔄 完美适配 PJAX：针对 Butterfly 主题的 PJAX 局域刷新机制进行了深度兼容。无论是初次进入主页，还是从文章页、标签页局部切回主页，卡片均能正常无缝注入并自动流转。
  • ☯️ 双模金石骨相：
    • 白天模式：呈现“宣纸淡底、古籍双边、浓墨书笺”的传统文人风骨。
    • 暗黑模式：自动蜕变为“千年碑拓、阴刻金石、枯墨衬白”的沉静气象，与博客暗色调的琴音、发簪布局完美咬合。

🎨 视觉与排版设计

卡片彻底抛弃了不稳定的横向 flex 布局，改用垂向中式信笺（笺纸）重构版式，即使在手机端或低分辨率屏幕下也绝对不会被无情挤压变形：

🏛️ 顶栏（题签）：落拓大方的「岁 华 纪 胜」古籍题签，居中端立。
📖 中栏（文心）：诗词/散曲主体，采用严谨的衬线体（宋体/楷体系列），字骨清隽，有引水研墨的视觉深度。
🛑 底栏（漆扣）：一枚安安静静锁在最下方的「翻阅新笺」古典燕脂红细按钮，克制、高级且便于交互。

📂 文件架构与部署路径

该功能采用无损注入（Inject）设计，不修改任何主题核心的 .pug 模板，升级主题安全无忧。整体由以下文件矩阵支撑：

1. 样式表 source/css/poem.css

负责渲染卡片的宣纸纹理、内部双衬线边框、燕脂红按钮以及暗黑模式下“金石拓本”的特异性视觉覆写。

2. 控制核心 source/js/poem.js

负责卡片的 DOM 动态生成、主页 #recent-posts 容器自检、PJAX 事件监听、防重复随机算法，并完整内置了当前的专属大词库（如：张可久清丽小令散曲库 / 纳兰容若饮水词库）。

3. 主题配置文件 _config.butterfly.yml

在主题的 inject 注入插槽中进行无缝挂载，配置极为精简：

inject:
  head:
    - <link rel="stylesheet" href="/css/poem.css">
  bottom:
    - <script src="/js/poem.js"></script>