仰望星辰工作室

docs: 补充二次开发修改说明与版权合规标注

Z zfhsh 提交于 2026-10-03 18:38 · 2a7d022 ·父提交 16d6a54
docs: 补充二次开发修改说明与版权合规标注

- 4 个改造文件头部新增「二次开发修改说明」标注(修改者/日期/内容)
- README.md 新增「二次开发说明」章节,列出修改清单与设计要点
- 保留原作者(梦奈云)版权声明,满足宽松许可证要求
5 个文件变更 +86 -1 3933415854@qq.com
•README.md +24 -0
•templates/default/user/assets/user-neomorphism.css +17 -0
•templates/default/user/head.php +13 -0
•templates/default/user/index.php +16 -0
•templates/default/user/login.php +16 -1
变更内容
diff --git a/README.md b/README.md
index 2bb4b44..906e935 100644
--- a/README.md
+++ b/README.md
@@ -67,6 +67,30 @@
 
 ---
 
+## 二次开发说明
+
+本仓库为 MNBT 的二次开发分支,在官方默认(default)主题基础上完成**用户端 UI 改造**,将 StarIDC 的「新拟态 2.0」视觉语言迁移至 MNBT 用户端。
+
+### 修改清单
+
+| 文件 | 修改内容 |
+|------|---------|
+| `templates/default/user/assets/user-neomorphism.css` | **新增文件**。新拟态 2.0 主题覆盖层:设计 token(CSS 变量)、Bootstrap / Lyear 组件覆盖、布局覆盖、暗色模式适配 |
+| `templates/default/user/head.php` | 引入新拟态主题样式表;调整样式依赖顺序(bootstrap-table / jquery-confirm / user-common 前移),确保覆盖层位于样式链最末 |
+| `templates/default/user/index.php` | 主框架(侧边栏 / 头部 / 多标签 iframe 容器)改造为新拟态风格 |
+| `templates/default/user/login.php` | 登录页改造为新拟态风格(凸起卡片、凹陷输入框、渐变凸起按钮) |
+
+### 设计要点
+
+- **风格来源**:迁移自 StarIDC「新拟态 2.0」主题
+- **实现方式**:CSS 覆盖层「换皮」,保留原有 DOM 结构与全部交互逻辑(iframe 多标签、AJAX、菜单、表单字段名均未改动)
+- **设计 token**:主色渐变 `#5c6bc0 → #7e57c2`;背景 `#e9eef2`;凸起双阴影 `8px 8px 16px`(暗)+ `-8px -8px 16px`(亮),凹陷为 `inset` 反转
+- **暗色模式**:跟随系统 `prefers-color-scheme` 自动切换
+
+> 修改者:zfhsh <3933415854@qq.com> · 修改日期:2026-10-01
+
+---
+
 ## 许可证
 
 本项目采用**宽松许可证**,版权归 [梦奈云](https://github.com/1181469655/MNBT) 所有。
diff --git a/templates/default/user/assets/user-neomorphism.css b/templates/default/user/assets/user-neomorphism.css
index d31e0e6..4913aff 100644
--- a/templates/default/user/assets/user-neomorphism.css
+++ b/templates/default/user/assets/user-neomorphism.css
@@ -1,6 +1,23 @@
 /* ============================================================
    MNBT 用户端 — StarIDC 新拟态 2.0 主题
    基于 StarIDC theme/新拟态2.0/style.css 迁移
+   ============================================================
+
+   【二次开发修改说明】
+   修改者   :zfhsh <3933415854@qq.com>
+   修改日期 :2026-10-01
+   文件性质 :新增文件
+   修改内容 :
+     1. 新增设计 token(CSS 变量):主色渐变、背景、双阴影(凸起/凹陷)、
+        圆角、过渡曲线,并映射 Bootstrap 兼容色
+     2. Bootstrap / Lyear 组件覆盖:卡片、按钮、表单、表格、标签页、
+        进度条、模态框、徽章、提示框等
+     3. 布局覆盖:侧边栏、头部导航、多标签 iframe 容器
+     4. 暗色模式适配(prefers-color-scheme)
+   实现方式 :以 CSS 覆盖层"换皮"实现,不修改原有 DOM 结构与交互逻辑
+
+   原项目版权归梦奈云所有;本修改遵循 MNBT 宽松许可证,
+   保留原作者版权声明并在此注明修改内容。
    ============================================================ */
 
 /* ---------- 1. 设计变量(来自 StarIDC 新拟态2.0) ---------- */
diff --git a/templates/default/user/head.php b/templates/default/user/head.php
index 234d9cc..3a6b3ea 100644
--- a/templates/default/user/head.php
+++ b/templates/default/user/head.php
@@ -1,4 +1,17 @@
 <?php
+/**
+ * 用户端公共头部
+ *
+ * 【二次开发修改说明】
+ * 修改者   :zfhsh <3933415854@qq.com>
+ * 修改日期 :2026-10-01
+ * 修改内容 :
+ *   1. 引入 StarIDC「新拟态 2.0」用户端主题覆盖层 user-neomorphism.css
+ *   2. 调整样式依赖顺序:将 bootstrap-table / jquery-confirm / user-common.css
+ *      由 JS 之后前移至样式区,使新拟态覆盖层位于样式链最末,保证其优先级
+ * 原项目版权归梦奈云所有;本修改遵循 MNBT 宽松许可证,
+ * 保留原作者版权声明并在此注明修改内容。
+ */
 @header('Content-Type: text/html; charset=UTF-8');
 if (defined('ROOT')) {
 	include ROOT . 'cf_up.php';
diff --git a/templates/default/user/index.php b/templates/default/user/index.php
index 75b1bfa..17cdc56 100644
--- a/templates/default/user/index.php
+++ b/templates/default/user/index.php
@@ -1,3 +1,19 @@
+<!--
+  ============================================================
+  用户端主框架(侧边栏 + 头部 + 多标签 iframe 容器)
+  ------------------------------------------------------------
+  【二次开发修改说明】
+  修改者   :zfhsh <3933415854@qq.com>
+  修改日期 :2026-10-01
+  修改内容 :
+    1. 引入 StarIDC「新拟态 2.0」主题覆盖层 user-neomorphism.css
+    2. 侧边栏 / 头部 / 内容容器应用新拟态阴影与圆角
+    3. 头部工具按钮(刷新、主题配色)改为新拟态凸起样式
+    4. iframe 多标签、菜单、AJAX 交互逻辑保持原样未改动
+  原项目版权归梦奈云所有;本修改遵循 MNBT 宽松许可证,
+  保留原作者版权声明并在此注明修改内容。
+  ============================================================
+-->
 <html lang="zh">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
diff --git a/templates/default/user/login.php b/templates/default/user/login.php
index 2ed47f5..5da500a 100644
--- a/templates/default/user/login.php
+++ b/templates/default/user/login.php
@@ -1,4 +1,19 @@
-<?php mnbt_theme_include('head'); ?>
+<?php
+/**
+ * 用户端登录页
+ *
+ * 【二次开发修改说明】
+ * 修改者   :zfhsh <3933415854@qq.com>
+ * 修改日期 :2026-10-01
+ * 修改内容 :
+ *   1. 登录页整体改造为 StarIDC「新拟态 2.0」风格
+ *      (凸起卡片、凹陷输入框、渐变凸起登录按钮)
+ *   2. 表单、验证码、AJAX 登录逻辑与字段名保持原样未改动
+ * 原项目版权归梦奈云所有;本修改遵循 MNBT 宽松许可证,
+ * 保留原作者版权声明并在此注明修改内容。
+ */
+mnbt_theme_include('head');
+?>
 <style>
 html, body { height: 100%; }