From 68b62fa142dfd6d8f824cbcd90afd243b9c4bc1b Mon Sep 17 00:00:00 2001
From: nanhaoluo <3075912108@qq.com>
Date: Thu, 15 Jan 2026 15:51:40 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E5=A2=9E=E5=8A=A0=E5=89=8D=E7=AB=AF?=
 =?UTF-8?q?=E8=87=AA=E5=8A=A8=E5=88=B7=E6=96=B0=E5=8A=9F=E8=83=BD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 新增自动刷新选项，检测到版本更新时自动刷新用户浏览器
- 使用 localStorage 存储版本号进行比对
- 设置5秒冷却期防止刷新循环
- 刷新前清理浏览器 Service Worker 缓存
---
 functions.php | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++
 settings.php  | 16 +++++++++++++++
 2 files changed, 73 insertions(+)

diff --git a/functions.php b/functions.php
index 9e88a91..a404563 100644
--- a/functions.php
+++ b/functions.php
@@ -335,6 +335,63 @@ function argon_frontend_hot_reload_notice() {
 }
 add_action('wp_footer', 'argon_frontend_hot_reload_notice');
 
+// 前端自动刷新脚本
+function argon_hot_reload_auto_refresh_script() {
+	if (get_option('argon_enable_hot_reload', 'false') != 'true') {
+		return;
+	}
+	if (get_option('argon_hot_reload_auto_refresh', 'false') != 'true') {
+		return;
+	}
+	
+	$current_version = $GLOBALS['theme_version'];
+	?>
+	<script id="argon-hot-reload-checker">
+	(function() {
+		var currentVersion = '<?php echo esc_js($current_version); ?>';
+		var storageKey = 'argon_theme_version';
+		var lastRefreshKey = 'argon_last_refresh';
+		var refreshCooldown = 5000; // 5秒冷却，防止刷新循环
+		
+		// 获取存储的版本
+		var storedVersion = localStorage.getItem(storageKey);
+		var lastRefresh = parseInt(localStorage.getItem(lastRefreshKey) || '0', 10);
+		var now = Date.now();
+		
+		// 如果没有存储版本，先存储当前版本
+		if (!storedVersion) {
+			localStorage.setItem(storageKey, currentVersion);
+			return;
+		}
+		
+		// 版本不同且不在冷却期内，执行刷新
+		if (storedVersion !== currentVersion && (now - lastRefresh) > refreshCooldown) {
+			// 先更新存储，防止刷新循环
+			localStorage.setItem(storageKey, currentVersion);
+			localStorage.setItem(lastRefreshKey, now.toString());
+			
+			// 清理浏览器缓存后刷新
+			if ('caches' in window) {
+				caches.keys().then(function(names) {
+					names.forEach(function(name) {
+						caches.delete(name);
+					});
+				}).then(function() {
+					location.reload(true);
+				});
+			} else {
+				location.reload(true);
+			}
+		} else if (storedVersion !== currentVersion) {
+			// 版本不同但在冷却期，只更新存储
+			localStorage.setItem(storageKey, currentVersion);
+		}
+	})();
+	</script>
+	<?php
+}
+add_action('wp_head', 'argon_hot_reload_auto_refresh_script', 1);
+
 // 初始化热更新检测
 add_action('init', 'argon_hot_reload_init');
 
diff --git a/settings.php b/settings.php
index 787e5b5..11bd049 100644
--- a/settings.php
+++ b/settings.php
@@ -4655,6 +4655,20 @@ window.pjaxLoaded = function(){
 
 							
 
+							<?php $argon_hot_reload_auto_refresh = get_option('argon_hot_reload_auto_refresh', 'false'); ?>
+
+							<label style="display:block;margin-top:10px;">
+
+								<input type="checkbox" name="argon_hot_reload_auto_refresh" value="true" <?php if ($argon_hot_reload_auto_refresh=='true'){echo 'checked';}?>/> 
+
+								<?php _e('自动刷新页面（检测到版本更新时自动刷新用户浏览器）', 'argon');?>
+
+							</label>
+
+							<p class="description" style="margin-left:24px;"><?php _e('推荐开启。用户访问时如检测到主题版本变化，将自动刷新页面以加载最新功能。', 'argon');?></p>
+
+							
+
 							<?php $argon_hot_reload_frontend_notice = get_option('argon_hot_reload_frontend_notice', 'false'); ?>
 
 							<label style="display:block;margin-top:10px;">
@@ -5406,6 +5420,8 @@ function argon_update_themeoptions(){
 
 		argon_update_option_checkbox('argon_enable_hot_reload');
 
+		argon_update_option_checkbox('argon_hot_reload_auto_refresh');
+
 		argon_update_option_checkbox('argon_hot_reload_frontend_notice');
 
 		argon_update_option('argon_enable_into_article_animation');