科幻主题插件（xnx_scifi）

一套完整的霓虹赛博朋克科幻皮肤：暗色 / 明亮两套样式（前台可自由切换）、深空霓虹辉光、网格 / 扫描线特效、粒子星空动画，并支持管理员上传自定义背景图，组合出专属科幻风格。不修改任何核心文件。

—

## 介绍

科幻主题（xnx_scifi）—— 把论坛搬进赛博空间。

这是一套开箱即用的完整科幻皮肤，装上即拥有沉浸式赛博朋克观感，管理员零代码配置：

- 🌌 深空暗黑底色：深邃的星海渐变背景，配合霓虹辉光，一打开就是科幻片的氛围；玻璃拟态卡片、发光描边、透明毛玻璃导航栏，细节拉满。
- 🌈 5 套霓虹配色：赛博青、霓虹紫红、矩阵绿、量子紫、琥珀金——主色、链接、按钮、辉光、星空颜色全站联动，一键切换整套氛围。
- ✨ 三大动态特效：
- 粒子星空：发光粒子缓缓漂移闪烁（canvas 实现，自动尊重系统「减少动态效果」设置，密度可调）
- 网格背景：科幻 HUD 网格线铺底
- 扫描线特效：CRT 显示器风格的横纹，叠加全站不挡点击
- 🎨 自定义背景图：上传你自己的图片（JPG/PNG/WebP/GIF，≤5MB）作为全站背景，配合遮罩浓度（保证文字清晰）与背景模糊调节，再加上飘动的发光粒子——一张图就能拼出独一无二的科幻世界。
- ⚡ 辉光强度三档：微弱 / 标准 / 强烈，霓虹感随心调。
- 🌗 明暗双样式，用户自由切换：科幻主题同时提供「暗色」与「明亮」两套完整样式（霓虹配色在明亮下自动切换为深色变体保证对比度）；后台可选「继承（用户自由切换）/ 强制暗色 / 强制明亮」。
- 🧩 自定义 CSS + 总开关：资深站长可注入任意样式；一键关闭即完全恢复默认主题，零残留。
- ⚙️ 零侵入、安全可靠：纯 CSS 变量 + Hook 实现，不修改任何核心文件；背景图存储与文件操作全部经过安全 IO 白名单；卸载自动清理配置与图片，无残留。

适用版本：XIUNOX 1.1.x ｜ 安装：放入 plugin/ 目录 → 后台安装启用 → 进入「设置」选配色、传背景图 → 前台预览。

—

## 功能

- 霓虹配色 ×5：赛博青 / 霓虹紫红 / 矩阵绿 / 量子紫 / 琥珀金——主色、链接、按钮、辉光与星空颜色全部联动。
- 辉光强度：微弱 / 标准 / 强烈三档，全局生效。
- 特效开关：
- 网格背景（深空科幻网格线）
- 扫描线特效（CRT 横纹，不影响点击）
- 粒子星空（canvas 发光粒子缓慢漂移，自动尊重系统「减少动态效果」设置，密度可调 20~150）
- 明暗模式：科幻主题同时提供「暗色」与「明亮」两套完整样式，霓虹配色在明亮模式下自动切换为深色变体以保证对比度；后台可选「继承（用户自由切换）/ 强制暗色 / 强制明亮」——选择「继承」时，前台导航栏可自由切换明暗或跟随系统。
- 自定义背景图：上传 JPG/PNG/WebP/GIF（最大 5MB）作为全站背景，支持遮罩浓度（0~90%，保证文字可读）与背景模糊（0~24px）调节；可随时删除。
- 自定义 CSS：向全站 <head> 注入自定义样式。
- 总开关：关闭后不输出任何效果，前台恢复系统默认主题。

## 安装

1. 将 xnx_scifi 目录放入网站 plugin/ 目录。
2. 后台「插件」列表找到「科幻主题」，点击安装并启用。
3. 点击「设置」进入主题设置页配置（上传背景图、调辉光等），保存后点「前往前台预览」。

## 文件说明

<br>plugin/xnx_scifi/<br>├── conf.json # 插件清单<br>├── install.php # 安装：默认配置 + 背景图目录<br>├── uninstall.php # 卸载：清除配置与背景图<br>├── setting.php # 后台设置页逻辑（含背景图上传）<br>├── lib/scifi_defs.php # 配色方案 + 科幻 CSS 生成 + 配置辅助<br>├── view/htm/setting.htm # 后台设置页 UI<br>└── hook/<br> ├── header_bootstrap_after.htm # 注入科幻 CSS（hooks_rank 200，优先于主题美化插件）<br> ├── header_body_start.htm # 给 <html> 加科幻皮肤类/属性（防闪烁）<br> ├── footer_js_after.htm # 粒子星空动画<br> └── lang_zh_cn_bbs.php # 语言键（zh-cn）<br>

## 说明与限制

- 背景图存储在 upload/xnx_scifi/（upload/ 在插件安全 IO 白名单内），文件名固定为 background.{ext}，卸载插件时一并删除。
- 背景图 URL 使用 conf.upload_url 拼接，若配置了 CDN 上传域会自动生效。
- 自定义 CSS 提交时会被 strip_tags 过滤（与核心插件设置一致），请勿在样式中包含 < 字符。
- 与「主题美化」插件（xnx_theme）同时启用时，本插件 hooks_rank 更高，科幻样式优先生效；建议二选一使用。
- 版本兼容：XIUNOX 1.1.x（bbs_version: 1.1）。