For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /ethereal/advanced/plugins.md.

楠枝文档中心

插件兼容清单

适用版本 ≥ 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，主题无需改动
部分插件页面要求主题版本支持（见其它插件页面），主题过旧时可能出现无样式页面
插件自行渲染前台的组件（不走主题模板）样式不会跟随主题，这是插件行为
「关于页」的卡片依赖多个插件，未安装时对应卡片自动隐藏，不会显示空卡
安装插件后若页面样式异常，先强刷，再确认主题是否为最新版本