op-packages/luci-theme-aurora/README_zh.md
2026-04-13 03:35:37 +08:00

6.6 KiB
Raw Blame History

English | 简体中文

Aurora Theme

一款基于 Vite 和 Tailwind CSS 构建的现代 OpenWrt LuCI 主题。

🏔️ 纯净 | 🦢 优雅 | 📱 响应式 | 🌗 深色/浅色模式 | ⚙️ 可配置

OpenWrt Chrome Safari Firefox GitHub release Downloads Discord
Multi-Device Showcase

Note

🤖 AI 工作流探索中…

大家好,最近工作比较忙,能投入到 Aurora 主题的时间有限,但我不希望 Aurora 因此停滞不前,所以最近一直在研究 AI 工作流,希望借助 AI 来分担一部分工作,尤其是调试方面。

目前主题积压了不少 issue其实大部分都是第三方插件的样式兼容问题。这类问题说大不大但调起来真的很耗时间——你得先装上对应的插件有时候路由器还得满足特定条件才能复现。

归根结底LuCI 本身只提供了一套基础的 Web 组件,插件作者想实现更复杂的交互,就只能用 HTML + CSS + JS 自行实现没有统一的规范各种兼容问题在所难免。LuCI 插件数量庞大,要逐一做好兼容,工作量可想而知——更何况有些插件本身也没有按照 LuCI JS 的规范来开发。

所以我希望引入 AI把这些琐碎但繁重的任务交给它来完成如果能实现自动化那就更理想了。如果你有更好的建议或想法欢迎来 Discord 聊聊。

特性

  • 现代化:内容优先的现代化 UI 设计,布局整洁,动画优雅。
  • 移动端友好:针对移动端的交互和显示进行了优化,适配手机和平板设备。
  • 主题切换:内置主题切换器,支持在自动(跟随系统)、浅色和深色模式之间无缝切换。
  • 悬浮工具栏:提供可点击的图标按钮,用于快速访问常用页面。
  • 高度可定制luci-app-aurora-config 插件内置多套主题预设,可自由切换;同时还支持自定义颜色、导航子菜单样式、主题 Logo以及添加或编辑悬浮工具栏中的常用页面。

预览

Theme Demo
概览 — 现代 UI 与优雅动效

Dark and Light Preview Mobile Preview

兼容性

  • OpenWrt:需要 OpenWrt 23.05.0 或更高版本,因为本主题使用了 ucode 模板和 LuCI JavaScript APIs。
  • 浏览器:基于 TailwindCSS v4 构建。兼容以下现代浏览器:
    • Chrome/Edge 111+ (2023 年 3 月发布)
    • Safari 16.4+ (2023 年 3 月发布)
    • Firefox 128+ (2024 年 7 月发布)

安装

OpenWrt 25.12+ 和 Snapshot 版本使用 apk;其他版本使用 opkg

提示:您可以运行 opkg --versionapk --version 来确认您的包管理器。如果有输出内容(而非 "not found"),那就是您的包管理器。

  • opkg (OpenWrt < 25.12):

    cd /tmp && uclient-fetch -O luci-theme-aurora.ipk https://github.com/eamonxg/luci-theme-aurora/releases/latest/download/luci-theme-aurora_0.11.0-r20260208_all.ipk && opkg install luci-theme-aurora.ipk
    
  • apk (OpenWrt 25.12+ 及 snapshots):

    cd /tmp && uclient-fetch -O luci-theme-aurora.apk https://github.com/eamonxg/luci-theme-aurora/releases/latest/download/luci-theme-aurora-0.11.0-r20260208.apk && apk add --allow-untrusted luci-theme-aurora.apk
    

加入贡献

关于开发

步入 2026 年,前端工具链已相当成熟先进,并且现代浏览器也支持了很多有趣的新特性。所以全面拥抱现代前端生态是 Aurora 主题的核心理念。

Aurora 使用 Vite 作为构建工具。

  • 在开发过程中,您可以自由选择并集成任何 CSS 工具链。
  • 在生产环境中,提供多种策略来优化打包资源。
  • 最重要的是,借助于本地代理服务器,样式的修改可以实时预览!

更多开发信息,请参阅 开发文档

社区

我建立了一个 Discord 服务器 —— 欢迎来聊天!👋 加入 Discord

许可与致谢

本项目基于 Apache License 2.0 许可开源。

生产构建结构基于官方 OpenWrt 主题 luci-theme-bootstrap

视觉风格和部分实现受到 AppleVercel 的影响。

本项目使用现代前端技术栈开发,包括 ViteTailwind CSS