基于 Vite + Tailwind CSS v4 + DaisyUI + Alpine.js 构建的现代化 Halo 2.0 博客主题
Sky Blog Theme 是一款功能丰富、高度可定制的 Halo 2.0 主题,采用现代前端技术栈开发。
核心特点:
- 🎨 35 套 DaisyUI 主题,可视化预览切换
- 🧩 首页自由排印 Widget 组件流
- 👾 独家 Illustration 动态怪兽表情登录
- 📱 面向移动端和桌面端的响应式布局
- ⚡ 按页面拆分资源并适配 PJAX 生命周期
- 🔧 灵活的后台配置
- 🧩 丰富的插件适配
| 链接 | 说明 |
|---|---|
| 在线演示 | 5ee 博客 |
| 完整文档 | 配置指南和使用说明 |
| 应用市场 | Halo 官方应用市场 |
| 功能 | 说明 |
|---|---|
| 🎨 35 套主题 | DaisyUI 预设主题,可视化预览选择 |
| 🌓 明暗切换 | 浅色/深色主题独立配置,全景背景蒙版 |
| 🧩 Widget 流 | 首页可拖拽式/自由排序功能模块组件流 |
| 👾 动态插画登录 | 认证页独家插画视线跟随、害羞看密码体验 |
| 📱 响应式 | 移动端和桌面端布局(带高斯模糊侧边栏) |
| ⚡ 加载动画 | 多种动画样式,避免闪烁 |
| 🎯 悬浮控制栏 | 多种样式可选 |
| 📝 列表风格 | 卡片/列表/杂志/极简 |
| 🌐 背景定制 | 图片背景、天气联动和 3 种首页背景特效 |
| 📊 GitHub 热力图 | 贡献统计展示 |
| 🖼️ 高级图库 | JS Masonry 瀑布流、照片详情页、无限滚动、PJAX 适配 |
| 📚 文档中心 | 集成 Docsme 项目、目录、正文和评论 |
| 👤 作者主页 | 独立模板,支持文章/瞬间/动态展示 |
| 💻 极客终端 | 独家终端风格认证界面 |
| 🧊 玻璃拟态 | 全局磨砂质感设计 |
| 🏷️ 丰富短代码 | 提示块/折叠/标签页/时间轴等 |
| 🔍 全局搜索 | 支持文章/页面/瞬间/分类搜索 |
| 🎭 Iconify 图标 | 菜单/分类/标签/装备支持自定义图标选择器 |
| 📸 瞬间动态 | 前端发布瞬间,内置1/2/3/4+多图自适应瀑布流网格及弹性悬浮动画 |
| 🧭 归档探索 | 按年月组织的时间树视图,支持分页 |
| 模板 | 文件 | 说明 |
|---|---|---|
| 首页 | index.html |
文章列表、瞬间、朋友动态 Tab 切换 |
| 文章 | post.html |
文章详情、目录、评论、SEO 优化 |
| 页面 | page.html |
独立页面 |
| 作者 | author.html |
作者主页、文章/瞬间列表 |
| 归档 | archives.html |
按年月归档 |
| 分类 | categories.html / category.html |
分类列表/分类文章 |
| 标签 | tags.html / tag.html |
标签云/标签文章 |
| 模板 | 文件 | 说明 |
|---|---|---|
| 关于页 | page_about.html |
个人介绍、技术栈、GitHub 统计 |
| 卡片风格 | category-card.html |
分类文章卡片布局 |
| 列表风格 | category-list.html |
分类文章列表布局 |
| 杂志风格 | category-magazine.html |
分类文章杂志布局 |
| 极简风格 | category-minimal.html |
分类文章极简布局 |
| 模板 | 文件 | 依赖插件 | 说明 |
|---|---|---|---|
| 友链 | links.html |
PluginLinks | 友情链接、RSS 动态与申请 |
| 图库 | photos.html / photo.html |
PluginPhotos | 瀑布流图库、照片详情 |
| 瞬间 | moments.html / moment.html |
PluginMoments | 瞬间列表/详情 |
| 文档 | docs.html / doc.html / doc-catalog.html |
plugin-docsme | 知识库文档 |
| 追番 | bangumis.html |
plugin-bilibili-bangumi | Bilibili 追番 |
| Steam | steam.html |
halo-plugin-steam | Steam 游戏库 |
| 装备 | equipments.html |
plugin-equipment | 装备分组展示 |
| 豆瓣 | douban.html |
plugin-douban | 类型、题材筛选 |
| 组件 | 说明 | 依赖 |
|---|---|---|
| 作者卡片 | 头像、名称、简介、社交链接 | 无 |
| 欢迎卡片 | 天气信息、问候语、日期显示 | 无 |
| 最新文章 | 最新发布的文章列表 | 无 |
| 热门文章 | 访问量最高的文章列表 | 无 |
| 分类列表 | 文章分类导航 | 无 |
| 标签云 | 文章标签聚合 | 无 |
| 博客统计 | 文章数、分类数、标签数、最后更新 | 无 |
| 文章目录 | 当前正文标题导航 | 无 |
| 归档导航 | 按年月定位文章 | 无 |
| 追番卡片 | Bilibili 追番轮播展示 | plugin-bilibili-bangumi |
| Steam 卡片 | Steam 游戏信息展示 | steam |
| 在线统计 | 在线人数和访问统计 | online |
| 技术 | 版本 | 说明 |
|---|---|---|
| Vite | 8.x | 构建工具 |
| Tailwind CSS | 4.x | 原子化 CSS |
| DaisyUI | 5.x | UI 组件库 |
| Alpine.js | 3.x | 响应式框架 |
| Thymeleaf | 3.x | 模板引擎 |
| TypeScript | 6.x | 类型安全 |
主题对以下插件提供模板、DOM 或样式集成。当前实装版本、官方稳定目标及本轮验证边界见当前逐插件结果;契约基线见插件适配矩阵,以往测试保留在历史运行态审计。安装后仍需在目标 Halo 站点回归。下表中的 ✅ 只表示仓库存在主题集成,不表示当前站点安装版本已完成运行态测试;未进入矩阵的插件也不能自动视为兼容。
| 插件 | 应用市场 | GitHub | 主题支持 |
|---|---|---|---|
| 瞬间管理 | app-SnwWD | plugin-moments | ✅ 前端发布、媒体上传 |
| 朋友圈(退役) | app-yISsV | plugin-friends | 不再适配;RSS 动态统一使用 PluginLinks /links?view=friends |
| Docsme 文档 | app-yffxw | - | ✅ 按 1.7.0 契约集成项目、目录、正文和 DocTree 评论 |
| 图库管理 | app-BmQJW | plugin-photos | ✅ 瀑布流相册、照片详情页、PJAX 生命周期适配 |
| 链接管理 | app-hfbQg | plugin-links | ✅ 友链、分组、RSS 动态与申请统一展示 |
| 友链提交(退役) | app-glejqzwk | plugin-link-submit | 不再适配;访客申请统一使用 PluginLinks 2.3.0 的申请接口 |
| 联系表单 | app-gSebd | - | ✅ 兼容 2.1.0 的 embed/trigger/自动展示与 PJAX 清理,保留旧版变量;提交、上传及通知未验 |
| 超链接卡片 | - | plugin-editor-hyperlink-card | ✅ 块级/行内 Shadow DOM、390px、暗色与 PJAX 重入通过 |
| 抽奖卡片 | - | plugin-lottery | ✅ 宿主布局;参与、验证码和开奖需有效活动回归 |
| 限制阅读 | app-TzRqd | - | ✅ 宿主、登录和文章/单页评论依赖;各模式待实站回归 |
| 维护模式 | - | plugin-maintenance | ✅ 1.1.0 独立品牌模板与返回入口;真实全站切换未执行 |
| 插件 | 应用市场 | GitHub | 主题支持 |
|---|---|---|---|
| Bilibili 追番 | app-OTFPN | plugin-bilibili-bangumi | ✅ 追番列表、轮播卡片 |
| Steam 游戏库 | app-0ojqyzfh | plugin-steam | ✅ 游戏库展示、侧边栏卡片 |
| 投票管理 | app-veyvzyhv | plugin-vote | ✅ 1.1.3 的 25 个主题变量与结束态组件通过;有效投票写操作未验收 |
| 装备管理 | app-ytygyqml | plugin-equipment | ✅ 装备展示/我的装备 |
| 豆瓣记录 | app-srBOL | plugin-douban | ✅ 海报网格/筛选展示 |
| 插件 | 应用市场 | GitHub | 主题支持 |
|---|---|---|---|
| Shiki 代码高亮 | app-kzloktzn | plugin-shiki | ✅ 代码块美化 |
| KaTeX 数学公式 | - | plugin-katex | ✅ 3.0.0 公式溢出与 PJAX 脚本重执行契约 |
| 搜索组件 | app-DlacW | plugin-search-widget | ✅ 全局搜索 |
| 评论组件 | app-YXyaD | plugin-comment-widget | ✅ 评论系统 |
| 文本绘图 | app-ahBRi | plugin-text-diagram | ✅ 1.5.2 默认节点、SVG、明暗重绘与 PJAX 重入通过 |
| AI 助手 | app-riNgb | - | ✅ 3.0.0 摘要宿主契约;前阶段 3.1.0 + Foundation 1.3.0 的既有摘要读取、展示与 PJAX 离页清理有证据,模型生成、自动注入、RAG/编辑器 AI 未验,见适配状态 |
| lightgallery | app-OoggD | plugin-lightgallery | ✅ 稳定 selector DOM 与 PJAX 后兼容重放 |
| Passkey 认证 | app-g7tggrco | plugin-auth-passkey | ✅ 登录入口和认证 options 请求通过;真实凭据认证未执行 |
| 在线统计 | - | - | ✅ 插件可用时显示;禁用或失败时不再请求 API |
瞬间前端发布功能需要配置存储策略。这里描述的是 Halo 通用附件上传能力,不是对每个存储插件版本的兼容承诺。
| 存储插件 | 图片 | 视频 | 音频 | 状态 | 说明 |
|---|---|---|---|---|---|
| 本地存储 | ✅ | ✅ | ✅ | 推荐 | 内置,无需配置 |
| S3/OSS | ✅ | ✅ | ✅ | 推荐 | 云存储,支持 CDN |
| Lsky 图床 | ✅ | ❌ | ❌ | 可用 | 仅支持图片,有压缩 |
| Alist | ❌ | ❌ | ❌ | 不可用 | 当前主题不支持 |
Alist 说明:当前主题直接标记 Alist 存储不可用,不作为瞬间前端发布后端,也不安排真实上传复测。请使用本地存储或 S3。
方式 1:应用市场(推荐)
- Halo 后台 → 外观 → 主题
- 点击右上角 "安装主题" → "从应用市场安装"
- 搜索 "Sky Blog" 并安装
方式 2:手动安装
- 从 Releases 下载最新版本
- Halo 后台 → 外观 → 主题 → 安装主题
- 上传
.zip文件并启用
- 启用主题后,点击主题卡片的 "主题设置"
- 根据需要配置各个模块(参考 完整文档)
- 建议配置项:
- 通用设置 → 选择主题和颜色
- 首页设置 → 配置头部背景
- 导航设置 → 配置菜单和 Logo
安装以下插件以获得完整体验:
- 必装:搜索组件、评论组件
- 推荐:瞬间、图库、链接管理、装备管理
- 可选:Docsme 文档、追番、Steam、豆瓣、Passkey 认证
- 友链版本:当前实装和稳定目标为 PluginLinks 2.5.0,主题继续采用 2.3.0 的 Finder/API 契约;访客站内申请需在插件后台开启申请功能,申请/审核写入未验。旧版朋友圈和友链提交插件已退出主题集成。
- Node.js
>=24.18.0 <25(本地版本文件与 CI 固定为24.21.0) - pnpm
12.6.0 - Java 21+ (运行 Halo)
使用 nvm 时,在项目目录执行 nvm use,再运行下方的 pnpm 命令;其他版本管理器可读取 .node-version。
pnpm install # 安装依赖
pnpm dev # 开发模式(热更新)
pnpm build # 校验插件契约、构建资源并打包主题
pnpm lint # 代码检查
pnpm verify:plugin-contracts # 校验版本矩阵与模板契约
pnpm format # 代码格式化theme-sky-blog-1/
├── src/ # 前端源码
│ ├── common/ # 公共资源(main.js, CSS, Alpine 组件)
│ ├── pages/ # 页面特定资源
│ └── static/ # 静态资源
├── templates/ # Halo 模板文件
│ ├── assets/ # 构建产物(自动生成)
│ └── modules/ # 模板模块
├── docs/ # 主题配置文档
├── theme.yaml # 主题元数据
├── settings.yaml # 后台配置表单
└── vite.config.ts # Vite 构建配置
完整的配置文档请访问:
如果你遇到问题或有功能建议:
- GitHub Issues:提交 Issue
- 加入社群:与其他用户交流
| 企业微信(备注进群) | QQ 群 |
|---|---|
![]() |
![]() |
⚠️ 卖服务器的广告人,就不要加了。
欢迎提交 PR 和 Issue!
贡献指南:
- Fork 项目并创建分支
- 遵循项目代码规范(ESLint + Prettier)
- 提交前运行
pnpm lint、pnpm verify:plugin-contracts和pnpm build-only - 提交信息遵循 Conventional Commits
如果这个主题对你有帮助,欢迎 Star 支持!
感谢以下开源项目:
- Halo - 强大的博客系统
- Tailwind CSS - 原子化 CSS 框架
- DaisyUI - Tailwind CSS 组件库
- Alpine.js - 轻量级 JS 框架
- Vite - 快速的构建工具

