用途：为使用 Hexo 博客框架的用户提供 Butterfly 主题的安装、配置与使用指导。Butterfly 是基于 hexo-theme-melody 的简洁卡片式 Hexo 主题，提供丰富配置选项和标签外挂功能。
主要能力：覆盖主题安装与升级、页面设置（标签页、分类页、友链页等）、主题配置（导航、侧边栏、代码高亮、评论系统、统计等）、标签外挂（Note、Gallery、Tabs、Timeline、Mermaid 等）、常见问题排查以及进阶功能（音乐播放器、图标定制、插件推荐）。
使用方式：安装可执行 git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly，或 Hexo 5.0+ 使用 npm install hexo-theme-butterfly；必装渲染器 npm install hexo-renderer-pug hexo-renderer-stylus --save。随后在 Hexo 根目录 _config.yml 设置 theme: butterfly。建议创建 _config.butterfly.yml 管理配置，升级主题时配置不丢失。特殊页面通过 hexo new page tags 等命令创建并设置对应 type。标签外挂以 {% note info %}、{% tabs %}、{% hideToggle %} 等语法书写。
适用场景：Hexo 博客主题搭建、页面与导航定制、评论与统计接入、内容排版增强及问题排查。
限制：资料未提供具体版本兼容范围、性能数据与收费信息；部分功能依赖额外插件（如字数统计需 npm install hexo-wordcount --save）。详细文档位于 references/ 目录，官方文档为 https://butterfly.js.org/。