> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# 插件兼容清单

> 适用版本 ≥ 2.0.0 ｜ 后台路径：插件（Halo 后台）

主题核心功能不依赖插件，但很多页面与卡片由插件提供数据。下表按「深度集成 / 建议安装 / 可选」分类，安装后对应功能自动生效，无需主题侧额外配置。

## 深度集成

| 插件      | 作用          | 关联功能                              |
| ------- | ----------- | --------------------------------- |
| 搜索      | 文章全文搜索      | 菜单栏搜索入口                           |
| 评论      | 评论系统        | 文章页、独立页面、友链页评论区                   |
| 瞬间      | 说说 / 动态     | `/moments` 页面、首页瞬间预览条             |
| 图库      | 相册展示        | `/photos` 页面                      |
| 链接管理    | 友链与动态数据     | `/links` 友链页、朋友圈页、关于页「我的朋友」、页脚友链墙 |
| 项目集     | 项目作品集       | `/portfolio` 页面、关于页「本人项目」         |
| 装备管理    | 装备展示        | `/equipments` 页面                  |
| 日程日历    | 日程 / 日历     | `/schedule-calendar` 页面、最近日程小组件   |
| 追番      | 番剧 / 追剧     | `/bangumis` 页面                    |
| 心愿便签    | 心愿墙         | 心愿便签模板页                           |
| 文章订阅    | 邮箱订阅        | 关于页「订阅更新」卡片                       |
| API 扩展包 | 字数统计、降低后端压力 | 站点统计「总字数」、访问量类统计                  |

## 建议安装

| 插件                 | 作用     | 缺失影响               |
| ------------------ | ------ | ------------------ |
| RSS                | 生成订阅地址 | 页脚 RSS 链接会 404     |
| Sitemap            | 生成站点地图 | 页脚 Sitemap 链接会 404 |
| lightgallery.js 灯箱 | 正文图片放大 | 点击图片无法放大           |
| Shiki 代码高亮         | 代码块高亮  | 代码块无语法高亮，仅等宽显示     |

## 可选 / 按需

| 类型      | 说明                                   |
| ------- | ------------------------------------ |
| 人机验证    | 主题登录页已对常见验证组件做样式兼容                   |
| 代码高亮类插件 | 与主题排版不冲突，择一安装即可                      |
| 统计类插件   | 与站内站点统计并行时注意重复计数                     |
| 页脚注入类插件 | 通过 `<halo:footer />` 扩展点输出，主题已补齐该扩展点 |

## 注意事项

- 插件页面使用主题模板渲染，**插件停用后路径会 404**，主题无需改动
- 部分插件页面要求主题版本支持（见 [其它插件页面](/ethereal/content/plugin-pages.md)），主题过旧时可能出现无样式页面
- 插件自行渲染前台的组件（不走主题模板）样式不会跟随主题，这是插件行为
- 「关于页」的卡片依赖多个插件，未安装时对应卡片自动隐藏，不会显示空卡
- 安装插件后若页面样式异常，先强刷，再确认主题是否为最新版本