3.2.29: 把「自定义 CSS」里的站点样式并入主题公共样式 assets/css/site.css（段落缩进/h2 蓝条/列表缩进与行距），配置项默认置空并一次性清库迁移；自定义 CSS 内联输出改挂 kratos-site 以保持在最末

inc/theme-custom-code.php

@@ -13,15 +13,33 @@
  */
 
 /**
- * 默认自定义 CSS。
+ * 默认自定义 CSS：空。
  *
- * 历史沿革：这些规则原本放在主题目录下的一个 custom 子目录里，是该主题早期的
- * 「自定义样式」入口。改成配置项后，把它作为默认值，保证切换瞬间站点外观
- * 完全不变；同时 `恢复默认` 也能拿回这套样式。
+ * 历史沿革（3.2.29 变更）：
+ * 早年主题目录下有个 custom 子目录当「自定义样式」入口，后来改成配置项，
+ * 那批规则（段落缩进、h2 蓝条、列表缩进）就作为默认值下发，并被写进了库。
+ * 3.2.29 把它们并入主题公共样式 assets/css/site.css，配置项改为默认空 ——
+ * 「站点通用样式」本该跟着主题走，「自定义代码」留给临时覆盖。
  *
- * 想彻底清掉：在后台把「自定义 CSS」清空保存即可（空值会覆盖这里的默认值）。
+ * ⚠️ 不要再用旧的那段 CSS 给配置项兜底：site.css 已经在输出同样的规则，
+ *    再兜底一次就等于全站样式写两遍，且会让后台的框永远显示旧内容。
  */
 function yang_default_custom_css()
+{
+    return '';
+}
+
+/**
+ * 3.2.29 之前作为默认值下发、并已写进数据库的那段 CSS。
+ *
+ * 只用于两件事：
+ *   ① 识别「库里存的还是历史默认值」——输出时跳过，避免与 site.css 重复；
+ *   ② 迁移时比对，确认是可以安全清空的那一份（不是站长自己改过的内容）。
+ *
+ * 这里有意保留原样的换行与缩进：比对前会先做空白归一化，
+ * 所以即使库里的换行是 CRLF、这里的是 LF，也能正确匹配。
+ */
+function yang_legacy_custom_css()
 {
     return <<<'CSS'
 .article .content p{   text-indent:2em   } 
@@ -50,12 +68,48 @@ CSS;
 }
 
 /**
- * 取自定义 CSS（未设置时回退到默认值）
+ * CSS 空白归一化：只用于「是不是同一段代码」的比对，不用于输出。
+ *
+ * 处理：CRLF/CR → LF、连续空白压成一个空格、去掉 `{ } : ; , >` 两侧空白、
+ * 去掉块尾多余的 `;`。这样「同一条规则的不同缩进/换行」会得到同一个字符串。
+ */
+function yang_normalize_css($css)
+{
+    if (!is_string($css)) {
+        return '';
+    }
+    $css = str_replace(array("\r\n", "\r"), "\n", $css);
+    $css = preg_replace('/\s+/', ' ', $css);
+    $css = preg_replace('/\s*([{}:;,>])\s*/', '$1', $css);
+    $css = str_replace(';}', '}', $css);
+    return trim($css);
+}
+
+/**
+ * 库里存的这段 CSS 是否就是「已并入 site.css 的历史默认值」。
+ */
+function yang_is_legacy_custom_css($css)
+{
+    $normalized = yang_normalize_css($css);
+    return $normalized !== '' && $normalized === yang_normalize_css(yang_legacy_custom_css());
+}
+
+/**
+ * 取自定义 CSS（未设置时为空）。
+ *
+ * 历史默认值已被 site.css 接管：库里若还是它，这里返回空串，
+ * 避免同一批规则在页面上出现两遍。真正自己改过的内容原样返回。
  */
 function yang_custom_css()
 {
     $css = kratos_option('g_custom_css', yang_default_custom_css());
-    return is_string($css) ? $css : '';
+    if (!is_string($css)) {
+        return '';
+    }
+    if (yang_is_legacy_custom_css($css)) {
+        return '';
+    }
+    return $css;
 }
 
 /**
@@ -65,4 +119,40 @@ function yang_custom_js()
 {
     $js = kratos_option('g_custom_js', '');
     return is_string($js) ? $js : '';
-}
+}
+
+/**
+ * 一次性迁移：把库里那段「历史默认 CSS」清成空串。
+ *
+ * 为什么需要：std / 默认值只在「后台预填」和「恢复默认」时起作用，
+ * 运行时 kratos_option() 只查库 —— 库里的旧值不清，后台那个框就永远
+ * 显示着已经并入 site.css 的旧内容，站长以为它还在生效。
+ *
+ * 为什么挂在 admin_init：
+ *   · 只影响后台请求，前台一个写操作都不做；
+ *   · 用户升级后第一次进后台就自动完成，不需要额外操作。
+ *
+ * ⚠️ 三条护栏：
+ *   ① 有 $_POST 时直接退出 —— 本函数会走 update_option()，而 update_option()
+ *      内部会跑 sanitize_option_kratos（= validate_options）。那个回调看到
+ *      $_POST['reset'] 会返回「全部默认值」⇒ 用户在后台点保存/恢复默认的
+ *      那一下，配置会被我们顺手改成默认值。所以提交请求里绝不插手。
+ *   ② 只清「与历史默认值逐字等价」的内容 —— 站长自己改过的一个字都不碰。
+ *   ③ 清空而不是删键：删键会被 validate_options 用库里的旧值补回来。
+ */
+function yang_custom_code_migrate()
+{
+    if (!empty($_POST)) {
+        return;
+    }
+    $saved = get_option('kratos');
+    if (!is_array($saved) || !isset($saved['g_custom_css'])) {
+        return;
+    }
+    if (!yang_is_legacy_custom_css($saved['g_custom_css'])) {
+        return;
+    }
+    $saved['g_custom_css'] = '';
+    update_option('kratos', $saved);
+}
+add_action('admin_init', 'yang_custom_code_migrate');