op-packages/README_zh.md at 15bc162efbd6ea309f00c33f6cbba94f2eaf9dd6

cwx/op-packages

Fork 0

mirror of https://github.com/kiddin9/op-packages.git synced 2026-07-27 02:11:19 +08:00

github-actions[bot] 15bc162efb 🎉 Sync 2026-06-28 20:31:01

2026-06-28 20:31:01 +08:00

7.7 KiB

Raw Blame History

English | 简体中文

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

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

特性

现代化：内容优先的现代化 UI 设计，布局整洁，动画优雅。
移动端友好：针对移动端的交互和显示进行了优化，适配手机和平板设备。
主题切换：内置主题切换器，支持在自动（跟随系统）、浅色和深色模式之间无缝切换。
悬浮工具栏：提供可点击的图标按钮，用于快速访问常用页面。
可安装（PWA）：内置 Web 应用清单（manifest）与应用图标，可将 LuCI 安装到主屏幕，像原生应用一样启动。
高度可定制：luci-app-aurora-config 插件内置多套主题预设，可自由切换；同时还支持自定义浅色/深色色彩令牌、导航布局（Mega Menu、下拉菜单、侧边栏）、布局间距、字体排版、品牌标识（Logo、favicon、登录背景），以及添加或编辑悬浮工具栏中的常用页面。

预览

_{✨ 概览 — 现代 UI 与优雅动效}

兼容性

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 --version 或 apk --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_1.0.0-r20260619_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-1.0.0-r20260619.apk && apk add --allow-untrusted luci-theme-aurora.apk

从源码构建

使用 OpenWrt 构建系统自行编译。主机前置条件见 Build system setup。产物位于 bin/packages/<arch>/base/（例如 bin/packages/x86_64/base/luci-theme-aurora_*_all.ipk），拷贝到路由器后按上文方式安装即可。

通过 OpenWrt buildroot

# 克隆 OpenWrt——openwrt-24.10 分支构建 .ipk，main 分支构建 .apk
git clone https://github.com/openwrt/openwrt.git
cd openwrt
git checkout openwrt-24.10       # 省略则停留在 main（snapshot → .apk）

# 加入本软件包并安装 feeds（提供 luci-base）
git clone https://github.com/eamonxg/luci-theme-aurora.git package/luci-theme-aurora
./scripts/feeds update -a
./scripts/feeds install -a

# 在 menuconfig 中勾选主题：LuCI → Themes → luci-theme-aurora
make menuconfig

# 先编译主机工具与工具链，再编译本软件包
make tools/install -j$(nproc)
make toolchain/install -j$(nproc)
make package/luci-theme-aurora/compile -j$(nproc) V=s

通过预编译 SDK（更快）

OpenWrt SDK 自带预编译工具链，可省去 tools/install / toolchain/install 步骤。从 downloads.openwrt.org 下载与目标匹配的 SDK（release SDK 构建 .ipk，snapshot SDK 构建 .apk）并解压，然后在 SDK 目录中执行：

git clone https://github.com/eamonxg/luci-theme-aurora.git package/luci-theme-aurora
./scripts/feeds update -a
./scripts/feeds install -a

# 在 menuconfig 中勾选主题：LuCI → Themes → luci-theme-aurora
make menuconfig
make package/luci-theme-aurora/compile -j$(nproc) V=s