docs(authRedirect): 改进代码注释格式并添加类型标注

将单行注释改为多行文档注释并添加JSDoc类型标注，提高代码可读性和IDE支持

@@ -3,9 +3,16 @@ import { routerStore } from '@/stores/router'
 import { buildApiUrl } from './tools'
 import { buildApiUrl } from './tools'
 
 
 // 改进：添加全局状态变量注释
 // 改进：添加全局状态变量注释
-// 上一次跳转到授权页的时间戳，用于防抖（避免短时间内重复跳转）
+/**
+ * 上一次跳转到授权页的时间戳，用于防抖（避免短时间内重复跳转）
+ * @type {number}
+ */
 let last_navigate_auth_at = 0
 let last_navigate_auth_at = 0
-// 是否正在跳转到授权页，用于防重复（避免并发跳转）
+
+/**
+ * 是否正在跳转到授权页，用于防重复（避免并发跳转）
+ * @type {boolean}
+ */
 let navigating_to_auth = false
 let navigating_to_auth = false
 
 
 /**
 /**
@@ -228,8 +235,17 @@ export const silentAuth = async (on_success, on_error, options) => {
     }
     }
 }
 }
 
 
-const NAVIGATE_AUTH_COOLDOWN_MS = 1200  // 防重复跳转冷却时间
-const NAVIGATING_RESET_DELAY_MS = 300    // 导航状态重置延迟
+/**
+ * 防重复跳转冷却时间 (毫秒)
+ * @type {number}
+ */
+const NAVIGATE_AUTH_COOLDOWN_MS = 1200
+
+/**
+ * 导航状态重置延迟时间 (毫秒)
+ * @type {number}
+ */
+const NAVIGATING_RESET_DELAY_MS = 300
 
 
 /**
 /**
  * 跳转到授权页（降级方案）
  * 跳转到授权页（降级方案）