一个全新的 OpenWrt 主题 · v3

Argon 是一款干净整洁的 OpenWrt LuCI 主题，
允许用户使用图片或视频自定义其登录界面。
它还支持在浅色模式和深色模式之间自动或手动切换。

English · 简体中文

观看桌面演示 · MP4

3.1 新特性

在线更新主题：检查稳定版，通过固件原生 APK 或 OPKG 安装，保留 Argon 设置，校验安装包 SHA256 和大小。
布局修复：优化 Dashboard 操作区、概览布局、动态列表和自定义 IP/MAC 输入框，兼顾窄屏、亮暗色和 RTL 布局。
兼容性改进：改善稳定版 OpenWrt 固件上的兼容性。

v3.0.0 及更早版本用户需先手动安装一次 v3.1.2，之后即可使用在线更新。v3.1.0 及以上用户可直接通过主题更新升级。详见更新日志。

3.0 主要特性

内置 Argon Config：主题设置随主题安装，无需独立插件。
广泛适配第三方应用：针对大多数第三方 LuCI 应用优化布局、表单和表格，兼顾桌面、手机与亮暗模式。
两套登录界面：经典侧栏与居中卡片，自由选择。
亮暗配色：顶部快捷切换或跟随系统，支持自定义主色。
个性化外观：调节毛玻璃效果，设置图片或视频背景，上传网站图标和登录 Logo。
桌面与手机适配：适应不同屏幕尺寸的响应式布局。

安装

3.0 已将主题和配置功能合并到 luci-theme-argon，全新安装只需这一个包。 前往 Releases 下载与固件原生包管理器匹配的格式。已有旧版独立配置插件的用户，请先按下方迁移步骤操作。

包管理器	包格式	安装命令
`opkg`	`.ipk`	`opkg install ./luci-theme-argon_*.ipk`
APK v3（`apk-tools 3.x`）	`.apk`	`apk add --allow-untrusted ./luci-theme-argon-*.apk`

安装前执行 opkg update 或 apk update。APK v2 无法读取本项目的 APK 包，请沿用固件原生包管理器。

需要翻译时，安装同次发行、相同格式的 luci-i18n-argon-config-<语言> 语言包。

在 系统 → 系统 → 语言和界面 → 主题 中选择 Argon。

已安装旧版 luci-app-argon-config？如何迁移到 3.0

仅适用于已安装旧版独立配置插件的用户；没有安装过该插件可跳过。

3.0 的设置页面、配色、背景和 Logo 管理都在主题包内。发行附件中的 luci-app-argon-config 是沿用旧包名的空迁移包，用于保留旧配置并将文件交给主题，不是另一个配置插件。

从主题仓库同一次发行中下载 luci-app-argon-config 迁移包和 luci-theme-argon 主题包，格式一致。
将两个文件放到路由器同一目录，在该目录打开终端。无需先卸载旧插件，按固件选择下面一组命令；第一条成功后，再执行第二条。

# opkg
opkg install ./luci-app-argon-config_*.ipk
opkg install ./luci-theme-argon_*.ipk

# APK v3
apk add --allow-untrusted ./luci-app-argon-config-*.apk
apk add --allow-untrusted ./luci-theme-argon-*.apk

第一步将旧插件升级为空迁移包，第二步安装包含配置功能的新主题，并恢复已有设置。之后继续在 系统 → Argon 主题设置 中配置即可。

自定义

打开 系统 → Argon 主题设置，调整登录布局、配色、毛玻璃、壁纸和图标。页面右上角可切换亮色模式、暗色模式、跟随系统，也会应用于登录页。

背景支持本地图片、视频，以及 Bing、Unsplash、Wallhaven 在线壁纸；Unsplash 需填写 API Access Key。网站图标和登录 Logo 支持 PNG，每边 16–1024 像素、最大 1 MiB，网站图标需为正方形。

在主题更新中手动检查最新稳定版、查看更新日志，并下载与固件包管理器匹配的安装包。

检测到更高版本后，可点击立即更新并确认，通过固件自带的 APK 或 OPKG 安装主题，保留当前 Argon 配置。页面显示下载、校验、安装状态及安装日志，刷新页面后可继续查看进度；安装完成后重新加载页面。自动安装要求正式发布提供对应安装包及 SHA256 校验值，不执行降级。此功能更新主题主包，独立语言包仍由系统包管理器管理。

自行编译固件时，不要再同时引入旧版独立 luci-app-argon-config 插件；它会与主题内置文件冲突。已有自动编译脚本的调整方式见源码构建说明。