FIT2CLOUD
深色模式 的图标

深色模式

93
24

为 Halo 后台管理面板提供深色/浅色模式切换,支持跟随系统、手动切换和偏好记忆

1.1.2
Serendipity 发布于
>=2.25.0

Halo 深色模式 v1.1.2

为 Halo 后台管理面板提供深色/浅色模式切换。插件内置 Dark Reader 通用暗色引擎,自动分析页面 CSS 与 DOM,无需逐页手工适配,即可覆盖 Halo 核心页面和第三方插件页面。

功能特性

  • 三种主题模式:浅色(light)、深色(dark)、跟随系统(auto
  • 偏好记忆:自动将选择持久化到 localStorage,刷新不丢失
  • 跟随系统:切换系统外观时自动响应(auto 模式)
  • Dark Reader 通用引擎:自动转换 Halo 核心页面与第三方插件页面,动态渲染内容也能适配
  • 官方外观分组:设置入口位于 Halo「外观」分组,与主题、菜单、插件同组
  • 零后端依赖:纯前端实现,不依赖额外后端 API,安装即用

🆕 本次更新(v1.1.2)

  • 更新插件 Logo 为新的深色风格图标
  • 更新 README 截图预览:插件信息、模式选择、文章写作、仪表盘、主题界面

安装

  1. 从本 Release 下载 plugin-dark-mode-1.1.0.jar
  2. 在 Halo 后台「插件管理」中上传并安装
  3. 启用插件后,进入「外观 → 深色模式」设置页面选择显示模式

使用

配置项 可选值 说明
主题模式 light 始终使用浅色模式
主题模式 dark 始终使用深色模式
主题模式 auto 跟随系统外观自动切换

验证

  • 前端 8 项单元测试全部通过,type-check / lint / build 全绿
  • ./gradlew build 构建成功,JAR 内 ui/main.js 包含 Dark Reader 引擎,logo.png 为新图标
  • 切换深浅色后在 Halo 核心页面与第三方插件页面验证通过

环境要求

  • Halo >= 2.25.0

资源下载

  • plugin-dark-mode-1.1.2.jar