@windrun-huaiin/third-ui 7.3.5 → 7.3.7

package/dist/clerk/fingerprint/fingerprint-client.d.ts

@@ -5,43 +5,35 @@
  */
 /**
  * 生成基于真实浏览器特征的fingerprint ID
- * 使用FingerprintJS收集浏览器特征并生成唯一标识
- * 只能在客户端使用
+ * 使用 FingerprintJS 收集浏览器特征并生成唯一标识
  */
 export declare function generateFingerprintId(): Promise<string>;
 /**
  * 获取当前的fingerprint ID
- * 只能在客户端使用
  */
 export declare function getFingerprintId(): string | null;
 /**
  * 设置fingerprint ID到存储
- * 只能在客户端使用
  */
 export declare function setFingerprintId(fingerprintId: string): void;
 /**
  * 清除fingerprint ID
- * 只能在客户端使用
  */
 export declare function clearFingerprintId(): void;
 /**
  * 获取或生成fingerprint ID
  * 如果不存在则自动生成新的
- * 只能在客户端使用
  */
 export declare function getOrGenerateFingerprintId(): Promise<string>;
 /**
  * 创建包含fingerprint ID的fetch headers
- * 只能在客户端使用
  */
 export declare function createFingerprintHeaders(): Promise<Record<string, string>>;
 /**
  * Hook for generating fingerprint headers
- * 只能在客户端使用
  */
 export declare function useFingerprintHeaders(): () => Promise<Record<string, string>>;
 /**
  * Create a fetch wrapper that automatically includes fingerprint headers
- * 只能在客户端使用
  */
 export declare function createFingerprintFetch(): (url: string | URL | Request, init?: RequestInit) => Promise<Response>;

package/dist/clerk/fingerprint/fingerprint-client.js

@@ -1,92 +1,94 @@
 'use strict';
 
 var tslib_es6 = require('../../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.2/node_modules/tslib/tslib.es6.js');
-var fingerprintShared = require('./fingerprint-shared.js');
 var fp_esm = require('../../node_modules/.pnpm/@fingerprintjs_fingerprintjs@4.6.2/node_modules/@fingerprintjs/fingerprintjs/dist/fp.esm.js');
+var fingerprintShared = require('./fingerprint-shared.js');
 
 /**
  * Fingerprint Client Utilities
  * 客户端专用的指纹生成和管理逻辑
  * 只能在浏览器环境中使用
  */
+/**
+ * 检查浏览器存储（localStorage 和 cookie）中的指纹 ID
+ * 返回有效的 ID 或 null
+ */
+function checkStoredFingerprintId() {
+    if (typeof window === 'undefined') {
+        return null;
+    }
+    // 优先检查 localStorage
+    const localStorageId = localStorage.getItem(fingerprintShared.FINGERPRINT_STORAGE_KEY);
+    if (localStorageId && fingerprintShared.isValidFingerprintId(localStorageId)) {
+        return localStorageId;
+    }
+    // 检查 cookie
+    const cookieId = getCookieValue(fingerprintShared.FINGERPRINT_COOKIE_NAME);
+    if (cookieId && fingerprintShared.isValidFingerprintId(cookieId)) {
+        // 同步到 localStorage
+        localStorage.setItem(fingerprintShared.FINGERPRINT_STORAGE_KEY, cookieId);
+        return cookieId;
+    }
+    return null;
+}
 /**
  * 生成基于真实浏览器特征的fingerprint ID
- * 使用FingerprintJS收集浏览器特征并生成唯一标识
- * 只能在客户端使用
+ * 使用 FingerprintJS 收集浏览器特征并生成唯一标识
  */
 function generateFingerprintId() {
     return tslib_es6.__awaiter(this, void 0, void 0, function* () {
         if (typeof window === 'undefined') {
             throw new Error('generateFingerprintId can only be used in browser environment');
         }
-        // 首先检查现有ID
-        const existingId = getFingerprintId();
-        if (existingId && fingerprintShared.isValidFingerprintId(existingId)) {
+        // 检查现有 ID
+        const existingId = checkStoredFingerprintId();
+        if (existingId) {
+            console.log('Using existing fingerprint ID:', existingId);
             return existingId;
         }
-        // 检查cookie
-        const cookieId = getCookieValue(fingerprintShared.FINGERPRINT_COOKIE_NAME);
-        if (cookieId && fingerprintShared.isValidFingerprintId(cookieId)) {
-            // 同步到localStorage
-            localStorage.setItem(fingerprintShared.FINGERPRINT_STORAGE_KEY, cookieId);
-            return cookieId;
-        }
         try {
-            // 使用FingerprintJS生成基于浏览器特征的指纹
+            // 使用 FingerprintJS 生成指纹
             const fp = yield fp_esm.default.load();
             const result = yield fp.get();
             const fingerprintId = `fp_${result.visitorId}`;
-            // 存储到localStorage和cookie
+            // 存储到 localStorage 和 cookie
             localStorage.setItem(fingerprintShared.FINGERPRINT_STORAGE_KEY, fingerprintId);
-            setCookie(fingerprintShared.FINGERPRINT_COOKIE_NAME, fingerprintId, 365); // 365天过期
+            setCookie(fingerprintShared.FINGERPRINT_COOKIE_NAME, fingerprintId, 365);
+            console.log('Generated new fingerprint ID:', fingerprintId);
             return fingerprintId;
         }
         catch (error) {
             console.warn('Failed to generate fingerprint with FingerprintJS:', error);
-            // 降级方案：生成时间戳+随机数
+            // 降级方案：生成基于时间戳和随机数的 ID
             const fallbackId = `fp_fallback_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
             localStorage.setItem(fingerprintShared.FINGERPRINT_STORAGE_KEY, fallbackId);
             setCookie(fingerprintShared.FINGERPRINT_COOKIE_NAME, fallbackId, 365);
+            console.log('Generated fallback fingerprint ID:', fallbackId);
             return fallbackId;
         }
     });
 }
 /**
  * 获取当前的fingerprint ID
- * 只能在客户端使用
  */
 function getFingerprintId() {
-    if (typeof window === 'undefined') {
-        return null;
-    }
-    // 首先检查localStorage
-    const localStorageId = localStorage.getItem(fingerprintShared.FINGERPRINT_STORAGE_KEY);
-    if (localStorageId) {
-        return localStorageId;
-    }
-    // 检查cookie
-    const cookieId = getCookieValue(fingerprintShared.FINGERPRINT_COOKIE_NAME);
-    if (cookieId) {
-        // 同步到localStorage
-        localStorage.setItem(fingerprintShared.FINGERPRINT_STORAGE_KEY, cookieId);
-        return cookieId;
-    }
-    return null;
+    return checkStoredFingerprintId();
 }
 /**
  * 设置fingerprint ID到存储
- * 只能在客户端使用
  */
 function setFingerprintId(fingerprintId) {
     if (typeof window === 'undefined') {
         throw new Error('setFingerprintId can only be used in browser environment');
     }
+    if (!fingerprintShared.isValidFingerprintId(fingerprintId)) {
+        throw new Error('Invalid fingerprint ID');
+    }
     localStorage.setItem(fingerprintShared.FINGERPRINT_STORAGE_KEY, fingerprintId);
     setCookie(fingerprintShared.FINGERPRINT_COOKIE_NAME, fingerprintId, 365);
 }
 /**
  * 清除fingerprint ID
- * 只能在客户端使用
  */
 function clearFingerprintId() {
     if (typeof window === 'undefined') {
@@ -98,12 +100,12 @@ function clearFingerprintId() {
 /**
  * 获取或生成fingerprint ID
  * 如果不存在则自动生成新的
- * 只能在客户端使用
  */
 function getOrGenerateFingerprintId() {
     return tslib_es6.__awaiter(this, void 0, void 0, function* () {
-        const existingId = getFingerprintId();
+        const existingId = checkStoredFingerprintId();
         if (existingId) {
+            console.log('Retrieved existing fingerprint ID:', existingId);
             return existingId;
         }
         return yield generateFingerprintId();
@@ -111,7 +113,6 @@ function getOrGenerateFingerprintId() {
 }
 /**
  * 创建包含fingerprint ID的fetch headers
- * 只能在客户端使用
  */
 function createFingerprintHeaders() {
     return tslib_es6.__awaiter(this, void 0, void 0, function* () {
@@ -123,14 +124,12 @@ function createFingerprintHeaders() {
 }
 /**
  * Hook for generating fingerprint headers
- * 只能在客户端使用
  */
 function useFingerprintHeaders() {
     return createFingerprintHeaders;
 }
 /**
  * Create a fetch wrapper that automatically includes fingerprint headers
- * 只能在客户端使用
  */
 function createFingerprintFetch() {
     return (url, init) => tslib_es6.__awaiter(this, void 0, void 0, function* () {

package/dist/clerk/fingerprint/fingerprint-client.mjs

@@ -1,90 +1,92 @@
 import { __awaiter } from '../../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.2/node_modules/tslib/tslib.es6.mjs';
-import { FINGERPRINT_STORAGE_KEY, isValidFingerprintId, FINGERPRINT_COOKIE_NAME } from './fingerprint-shared.mjs';
 import index from '../../node_modules/.pnpm/@fingerprintjs_fingerprintjs@4.6.2/node_modules/@fingerprintjs/fingerprintjs/dist/fp.esm.mjs';
+import { isValidFingerprintId, FINGERPRINT_STORAGE_KEY, FINGERPRINT_COOKIE_NAME } from './fingerprint-shared.mjs';
 
 /**
  * Fingerprint Client Utilities
  * 客户端专用的指纹生成和管理逻辑
  * 只能在浏览器环境中使用
  */
+/**
+ * 检查浏览器存储（localStorage 和 cookie）中的指纹 ID
+ * 返回有效的 ID 或 null
+ */
+function checkStoredFingerprintId() {
+    if (typeof window === 'undefined') {
+        return null;
+    }
+    // 优先检查 localStorage
+    const localStorageId = localStorage.getItem(FINGERPRINT_STORAGE_KEY);
+    if (localStorageId && isValidFingerprintId(localStorageId)) {
+        return localStorageId;
+    }
+    // 检查 cookie
+    const cookieId = getCookieValue(FINGERPRINT_COOKIE_NAME);
+    if (cookieId && isValidFingerprintId(cookieId)) {
+        // 同步到 localStorage
+        localStorage.setItem(FINGERPRINT_STORAGE_KEY, cookieId);
+        return cookieId;
+    }
+    return null;
+}
 /**
  * 生成基于真实浏览器特征的fingerprint ID
- * 使用FingerprintJS收集浏览器特征并生成唯一标识
- * 只能在客户端使用
+ * 使用 FingerprintJS 收集浏览器特征并生成唯一标识
  */
 function generateFingerprintId() {
     return __awaiter(this, void 0, void 0, function* () {
         if (typeof window === 'undefined') {
             throw new Error('generateFingerprintId can only be used in browser environment');
         }
-        // 首先检查现有ID
-        const existingId = getFingerprintId();
-        if (existingId && isValidFingerprintId(existingId)) {
+        // 检查现有 ID
+        const existingId = checkStoredFingerprintId();
+        if (existingId) {
+            console.log('Using existing fingerprint ID:', existingId);
             return existingId;
         }
-        // 检查cookie
-        const cookieId = getCookieValue(FINGERPRINT_COOKIE_NAME);
-        if (cookieId && isValidFingerprintId(cookieId)) {
-            // 同步到localStorage
-            localStorage.setItem(FINGERPRINT_STORAGE_KEY, cookieId);
-            return cookieId;
-        }
         try {
-            // 使用FingerprintJS生成基于浏览器特征的指纹
+            // 使用 FingerprintJS 生成指纹
             const fp = yield index.load();
             const result = yield fp.get();
             const fingerprintId = `fp_${result.visitorId}`;
-            // 存储到localStorage和cookie
+            // 存储到 localStorage 和 cookie
             localStorage.setItem(FINGERPRINT_STORAGE_KEY, fingerprintId);
-            setCookie(FINGERPRINT_COOKIE_NAME, fingerprintId, 365); // 365天过期
+            setCookie(FINGERPRINT_COOKIE_NAME, fingerprintId, 365);
+            console.log('Generated new fingerprint ID:', fingerprintId);
             return fingerprintId;
         }
         catch (error) {
             console.warn('Failed to generate fingerprint with FingerprintJS:', error);
-            // 降级方案：生成时间戳+随机数
+            // 降级方案：生成基于时间戳和随机数的 ID
             const fallbackId = `fp_fallback_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
             localStorage.setItem(FINGERPRINT_STORAGE_KEY, fallbackId);
             setCookie(FINGERPRINT_COOKIE_NAME, fallbackId, 365);
+            console.log('Generated fallback fingerprint ID:', fallbackId);
             return fallbackId;
         }
     });
 }
 /**
  * 获取当前的fingerprint ID
- * 只能在客户端使用
  */
 function getFingerprintId() {
-    if (typeof window === 'undefined') {
-        return null;
-    }
-    // 首先检查localStorage
-    const localStorageId = localStorage.getItem(FINGERPRINT_STORAGE_KEY);
-    if (localStorageId) {
-        return localStorageId;
-    }
-    // 检查cookie
-    const cookieId = getCookieValue(FINGERPRINT_COOKIE_NAME);
-    if (cookieId) {
-        // 同步到localStorage
-        localStorage.setItem(FINGERPRINT_STORAGE_KEY, cookieId);
-        return cookieId;
-    }
-    return null;
+    return checkStoredFingerprintId();
 }
 /**
  * 设置fingerprint ID到存储
- * 只能在客户端使用
  */
 function setFingerprintId(fingerprintId) {
     if (typeof window === 'undefined') {
         throw new Error('setFingerprintId can only be used in browser environment');
     }
+    if (!isValidFingerprintId(fingerprintId)) {
+        throw new Error('Invalid fingerprint ID');
+    }
     localStorage.setItem(FINGERPRINT_STORAGE_KEY, fingerprintId);
     setCookie(FINGERPRINT_COOKIE_NAME, fingerprintId, 365);
 }
 /**
  * 清除fingerprint ID
- * 只能在客户端使用
  */
 function clearFingerprintId() {
     if (typeof window === 'undefined') {
@@ -96,12 +98,12 @@ function clearFingerprintId() {
 /**
  * 获取或生成fingerprint ID
  * 如果不存在则自动生成新的
- * 只能在客户端使用
  */
 function getOrGenerateFingerprintId() {
     return __awaiter(this, void 0, void 0, function* () {
-        const existingId = getFingerprintId();
+        const existingId = checkStoredFingerprintId();
         if (existingId) {
+            console.log('Retrieved existing fingerprint ID:', existingId);
             return existingId;
         }
         return yield generateFingerprintId();
@@ -109,7 +111,6 @@ function getOrGenerateFingerprintId() {
 }
 /**
  * 创建包含fingerprint ID的fetch headers
- * 只能在客户端使用
  */
 function createFingerprintHeaders() {
     return __awaiter(this, void 0, void 0, function* () {
@@ -121,14 +122,12 @@ function createFingerprintHeaders() {
 }
 /**
  * Hook for generating fingerprint headers
- * 只能在客户端使用
  */
 function useFingerprintHeaders() {
     return createFingerprintHeaders;
 }
 /**
  * Create a fetch wrapper that automatically includes fingerprint headers
- * 只能在客户端使用
  */
 function createFingerprintFetch() {
     return (url, init) => __awaiter(this, void 0, void 0, function* () {

package/dist/clerk/fingerprint/use-fingerprint.js

@@ -10,6 +10,20 @@ var fingerprintClient = require('./fingerprint-client.js');
  * Accepts configuration to customize API endpoint and behavior
  */
 function useFingerprint(config) {
+    // 服务端渲染检查
+    if (typeof window === 'undefined') {
+        return {
+            fingerprintId: null,
+            xUser: null,
+            xCredit: null,
+            xSubscription: null,
+            isLoading: false,
+            isInitialized: false,
+            error: 'Server-side rendering is not supported',
+            initializeAnonymousUser: () => tslib_es6.__awaiter(this, void 0, void 0, function* () { }),
+            refreshUserData: () => tslib_es6.__awaiter(this, void 0, void 0, function* () { }),
+        };
+    }
     const [fingerprintId, setFingerprintIdState] = React.useState(null);
     const [xUser, setXUser] = React.useState(null);
     const [xCredit, setXCredit] = React.useState(null);
@@ -21,11 +35,9 @@ function useFingerprint(config) {
      * 第一阶段：初始化fingerprint ID
      */
     const initializeFingerprintId = React.useCallback(() => tslib_es6.__awaiter(this, void 0, void 0, function* () {
-        if (typeof window === 'undefined')
-            return null;
         try {
-            // 优先检查现有ID, 没有就生成新的fingerprint ID
             const currentFingerprintId = yield fingerprintClient.getOrGenerateFingerprintId();
+            console.log('Initialized fingerprintId:', currentFingerprintId);
             setFingerprintIdState(currentFingerprintId);
             return currentFingerprintId;
         }
@@ -40,7 +52,12 @@ function useFingerprint(config) {
      */
     const initializeAnonymousUser = React.useCallback(() => tslib_es6.__awaiter(this, void 0, void 0, function* () {
         if (!fingerprintId) {
-            console.warn('Cannot initialize user without fingerprint ID');
+            console.warn('Cannot initialize user: Fingerprint ID is missing', {
+                fingerprintId,
+                isLoading,
+                isInitialized,
+            });
+            setError('Cannot initialize user: Missing fingerprint ID');
             return;
         }
         try {
@@ -86,8 +103,15 @@ function useFingerprint(config) {
      * 刷新用户数据
      */
     const refreshUserData = React.useCallback(() => tslib_es6.__awaiter(this, void 0, void 0, function* () {
-        if (!fingerprintId)
+        if (!fingerprintId) {
+            console.warn('Cannot refresh user data: Fingerprint ID is missing', {
+                fingerprintId,
+                isLoading,
+                isInitialized,
+            });
+            setError('Cannot refresh user data: Missing fingerprint ID');
             return;
+        }
         try {
             setError(null);
             const fingerprintHeaders = yield fingerprintClient.createFingerprintHeaders();
@@ -119,8 +143,14 @@ function useFingerprint(config) {
      * 检查现有用户数据（仅在有fingerprint ID时执行）
      */
     const checkExistingUser = React.useCallback(() => tslib_es6.__awaiter(this, void 0, void 0, function* () {
-        if (!fingerprintId)
+        if (!fingerprintId) {
+            console.warn('Cannot check existing user: Fingerprint ID is missing', {
+                fingerprintId,
+                isLoading,
+                isInitialized,
+            });
             return;
+        }
         try {
             const fingerprintHeaders = yield fingerprintClient.createFingerprintHeaders();
             const response = yield fetch(`${config.apiEndpoint}?fingerprintId=${fingerprintId}`, {
@@ -143,25 +173,27 @@ function useFingerprint(config) {
     }), [fingerprintId, config.apiEndpoint]);
     // 第一阶段：页面加载完成后生成指纹ID
     React.useEffect(() => {
-        if (typeof window === 'undefined')
-            return;
         const initFingerprint = () => tslib_es6.__awaiter(this, void 0, void 0, function* () {
-            yield initializeFingerprintId();
-            setIsLoading(false); // 第一阶段完成，结束加载状态
+            setIsLoading(true);
+            const currentFingerprintId = yield initializeFingerprintId();
+            if (currentFingerprintId) {
+                setIsLoading(false);
+            }
+            else {
+                setIsLoading(false);
+            }
         });
         initFingerprint();
     }, [initializeFingerprintId]);
     // 第二阶段：有指纹ID后检查现有用户
     React.useEffect(() => {
-        if (!fingerprintId || isInitialized)
+        if (!fingerprintId || isInitialized || isLoading)
             return;
         checkExistingUser();
-    }, [fingerprintId, isInitialized, checkExistingUser]);
+    }, [fingerprintId, isInitialized, isLoading, checkExistingUser]);
     // 第三阶段：如果没有现有用户且自动初始化开启，则创建新用户
     React.useEffect(() => {
-        if (!fingerprintId || isInitialized || isLoading || error)
-            return;
-        if (config.autoInitialize === false)
+        if (!fingerprintId || isInitialized || isLoading || error || config.autoInitialize === false)
             return;
         initializeAnonymousUser();
     }, [fingerprintId, isInitialized, isLoading, error, initializeAnonymousUser, config.autoInitialize]);

package/dist/clerk/fingerprint/use-fingerprint.mjs

@@ -8,6 +8,20 @@ import { createFingerprintHeaders, setFingerprintId, getOrGenerateFingerprintId
  * Accepts configuration to customize API endpoint and behavior
  */
 function useFingerprint(config) {
+    // 服务端渲染检查
+    if (typeof window === 'undefined') {
+        return {
+            fingerprintId: null,
+            xUser: null,
+            xCredit: null,
+            xSubscription: null,
+            isLoading: false,
+            isInitialized: false,
+            error: 'Server-side rendering is not supported',
+            initializeAnonymousUser: () => __awaiter(this, void 0, void 0, function* () { }),
+            refreshUserData: () => __awaiter(this, void 0, void 0, function* () { }),
+        };
+    }
     const [fingerprintId, setFingerprintIdState] = useState(null);
     const [xUser, setXUser] = useState(null);
     const [xCredit, setXCredit] = useState(null);
@@ -19,11 +33,9 @@ function useFingerprint(config) {
      * 第一阶段：初始化fingerprint ID
      */
     const initializeFingerprintId = useCallback(() => __awaiter(this, void 0, void 0, function* () {
-        if (typeof window === 'undefined')
-            return null;
         try {
-            // 优先检查现有ID, 没有就生成新的fingerprint ID
             const currentFingerprintId = yield getOrGenerateFingerprintId();
+            console.log('Initialized fingerprintId:', currentFingerprintId);
             setFingerprintIdState(currentFingerprintId);
             return currentFingerprintId;
         }
@@ -38,7 +50,12 @@ function useFingerprint(config) {
      */
     const initializeAnonymousUser = useCallback(() => __awaiter(this, void 0, void 0, function* () {
         if (!fingerprintId) {
-            console.warn('Cannot initialize user without fingerprint ID');
+            console.warn('Cannot initialize user: Fingerprint ID is missing', {
+                fingerprintId,
+                isLoading,
+                isInitialized,
+            });
+            setError('Cannot initialize user: Missing fingerprint ID');
             return;
         }
         try {
@@ -84,8 +101,15 @@ function useFingerprint(config) {
      * 刷新用户数据
      */
     const refreshUserData = useCallback(() => __awaiter(this, void 0, void 0, function* () {
-        if (!fingerprintId)
+        if (!fingerprintId) {
+            console.warn('Cannot refresh user data: Fingerprint ID is missing', {
+                fingerprintId,
+                isLoading,
+                isInitialized,
+            });
+            setError('Cannot refresh user data: Missing fingerprint ID');
             return;
+        }
         try {
             setError(null);
             const fingerprintHeaders = yield createFingerprintHeaders();
@@ -117,8 +141,14 @@ function useFingerprint(config) {
      * 检查现有用户数据（仅在有fingerprint ID时执行）
      */
     const checkExistingUser = useCallback(() => __awaiter(this, void 0, void 0, function* () {
-        if (!fingerprintId)
+        if (!fingerprintId) {
+            console.warn('Cannot check existing user: Fingerprint ID is missing', {
+                fingerprintId,
+                isLoading,
+                isInitialized,
+            });
             return;
+        }
         try {
             const fingerprintHeaders = yield createFingerprintHeaders();
             const response = yield fetch(`${config.apiEndpoint}?fingerprintId=${fingerprintId}`, {
@@ -141,25 +171,27 @@ function useFingerprint(config) {
     }), [fingerprintId, config.apiEndpoint]);
     // 第一阶段：页面加载完成后生成指纹ID
     useEffect(() => {
-        if (typeof window === 'undefined')
-            return;
         const initFingerprint = () => __awaiter(this, void 0, void 0, function* () {
-            yield initializeFingerprintId();
-            setIsLoading(false); // 第一阶段完成，结束加载状态
+            setIsLoading(true);
+            const currentFingerprintId = yield initializeFingerprintId();
+            if (currentFingerprintId) {
+                setIsLoading(false);
+            }
+            else {
+                setIsLoading(false);
+            }
         });
         initFingerprint();
     }, [initializeFingerprintId]);
     // 第二阶段：有指纹ID后检查现有用户
     useEffect(() => {
-        if (!fingerprintId || isInitialized)
+        if (!fingerprintId || isInitialized || isLoading)
             return;
         checkExistingUser();
-    }, [fingerprintId, isInitialized, checkExistingUser]);
+    }, [fingerprintId, isInitialized, isLoading, checkExistingUser]);
     // 第三阶段：如果没有现有用户且自动初始化开启，则创建新用户
     useEffect(() => {
-        if (!fingerprintId || isInitialized || isLoading || error)
-            return;
-        if (config.autoInitialize === false)
+        if (!fingerprintId || isInitialized || isLoading || error || config.autoInitialize === false)
             return;
         initializeAnonymousUser();
     }, [fingerprintId, isInitialized, isLoading, error, initializeAnonymousUser, config.autoInitialize]);

package/dist/main/money-price/money-price-button.js

@@ -89,7 +89,6 @@ function MoneyPriceButton({ planKey, userContext, billingType, onLogin, onUpgrad
     const config = getButtonConfig();
     if (config.hidden)
         return null;
-    // 使用 GradientButton 组件
     return (jsxRuntime.jsx(gradientButton.GradientButton, { title: config.text, icon: config.icon, onClick: config.onClick, disabled: config.disabled || isProcessing, align: "center", className: "w-full", preventDoubleClick: true, loadingText: "Processing..." }));
 }
 

package/dist/main/money-price/money-price-button.mjs

@@ -87,7 +87,6 @@ function MoneyPriceButton({ planKey, userContext, billingType, onLogin, onUpgrad
     const config = getButtonConfig();
     if (config.hidden)
         return null;
-    // 使用 GradientButton 组件
     return (jsx(GradientButton, { title: config.text, icon: config.icon, onClick: config.onClick, disabled: config.disabled || isProcessing, align: "center", className: "w-full", preventDoubleClick: true, loadingText: "Processing..." }));
 }
 

package/dist/main/money-price/money-price-interactive.js

@@ -265,7 +265,7 @@ function MoneyPriceInteractive({ data, config, upgradeApiEndpoint, signInPath })
         };
         return (jsxRuntime.jsx("div", { style: style, className: "bg-gray-700 dark:bg-gray-200 text-gray-100 dark:text-gray-800 text-xs leading-relaxed px-3 py-2 rounded-lg shadow-lg border border-gray-300 dark:border-gray-600 backdrop-blur-sm", children: content }));
     };
-    // 直接渲染按钮，确保宽度占满
+    // 直接渲染按钮
     return (jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [data.plans.map((plan) => (jsxRuntime.jsx("div", { "data-button-placeholder": plan.key, children: jsxRuntime.jsx(moneyPriceButton.MoneyPriceButton, { planKey: plan.key, userContext: userContext, billingType: billingType, onLogin: handleLogin, onUpgrade: handleUpgrade, texts: data.buttonTexts, isProcessing: isProcessing }) }, plan.key))), jsxRuntime.jsx(Tooltip, Object.assign({}, tooltip))] }));
 }
 

package/dist/main/money-price/money-price-interactive.mjs

@@ -263,7 +263,7 @@ function MoneyPriceInteractive({ data, config, upgradeApiEndpoint, signInPath })
         };
         return (jsx("div", { style: style, className: "bg-gray-700 dark:bg-gray-200 text-gray-100 dark:text-gray-800 text-xs leading-relaxed px-3 py-2 rounded-lg shadow-lg border border-gray-300 dark:border-gray-600 backdrop-blur-sm", children: content }));
     };
-    // 直接渲染按钮，确保宽度占满
+    // 直接渲染按钮
     return (jsxs(Fragment, { children: [data.plans.map((plan) => (jsx("div", { "data-button-placeholder": plan.key, children: jsx(MoneyPriceButton, { planKey: plan.key, userContext: userContext, billingType: billingType, onLogin: handleLogin, onUpgrade: handleUpgrade, texts: data.buttonTexts, isProcessing: isProcessing }) }, plan.key))), jsx(Tooltip, Object.assign({}, tooltip))] }));
 }
 

package/dist/main/money-price/money-price.js

@@ -66,7 +66,8 @@ function MoneyPrice(_a) {
                                 if (!(opt && hasDiscount && opt.discountText))
                                     return null;
                                 return (jsxRuntime.jsx("span", { className: "px-2 py-1 text-xs rounded bg-yellow-100 text-yellow-800 font-semibold align-middle text-center inline-flex items-center justify-center whitespace-nowrap", children: opt.discountText.replace('{percent}', String(discountPercent)) }));
-                            })() })] }), jsxRuntime.jsx("div", { className: "grid grid-cols-1 md:grid-cols-3 gap-8", children: data.plans.map((plan, _idx) => (jsxRuntime.jsxs("div", { "data-price-plan": plan.key, className: utils.cn('flex flex-col bg-white dark:bg-gray-800/60 rounded-2xl border border-gray-300 dark:border-[#7c3aed40] transition p-8 h-full shadow-sm dark:shadow-none', 'hover:border-2 hover:border-purple-500', 'focus-within:border-2 focus-within:border-purple-500'), style: { minHeight: maxFeaturesCount * 100 }, children: [jsxRuntime.jsxs("div", { className: "flex items-center gap-2 mb-2", children: [jsxRuntime.jsx("span", { className: "text-xl font-bold text-gray-900 dark:text-gray-100", children: plan.title }), plan.titleTags && plan.titleTags.map((tag, i) => (jsxRuntime.jsx("span", { className: "px-2 py-0.5 text-xs rounded bg-orange-100 text-orange-800 dark:bg-orange-900 dark:text-orange-200 font-semibold align-middle", children: tag }, i)))] }), renderPrice(plan), jsxRuntime.jsx("ul", { className: "flex-1 mb-6 mt-4", children: getFeatureRows(plan).map((feature, i) => (jsxRuntime.jsxs("li", { className: "flex items-center gap-2 mb-2 min-h-[28px]", "data-feature-item": `${plan.key}-${i}`, children: [feature ? (jsxRuntime.jsx("span", { className: "inline-flex items-center justify-center w-5 h-5 rounded-full bg-green-100 text-green-700 dark:bg-green-900 dark:text-green-200 mr-1", children: feature.icon ? jsxRuntime.jsx("span", { children: feature.icon }) : jsxRuntime.jsx("span", { className: "font-bold", children: "\u2713" }) })) : (jsxRuntime.jsx("span", { className: "inline-flex items-center justify-center w-5 h-5 rounded-full mr-1", children: "\u00A0" })), feature && feature.tag && (jsxRuntime.jsx("span", { className: "px-1 py-0.5 text-[6px] rounded bg-blue-100 text-blue-800 dark:bg-blue-900 dark:text-blue-200 font-semibold align-middle", children: feature.tag })), feature ? (jsxRuntime.jsxs("span", { className: "relative group cursor-pointer text-sm text-gray-800 dark:text-gray-200", children: [feature.description, feature.tooltip && (jsxRuntime.jsx("span", { className: "ml-1 align-middle inline-flex", "data-tooltip-trigger": `${plan.key}-${i}`, "data-tooltip-content": feature.tooltip, children: jsxRuntime.jsx("svg", { className: "w-4 h-4", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: jsxRuntime.jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M8.228 9c.549-1.165 2.03-2 3.772-2 2.21 0 4 1.343 4 3 0 1.4-1.278 2.575-3.006 2.907-.542.104-.994.54-.994 1.093m0 3h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" }) }) }))] })) : (jsxRuntime.jsx("span", { children: "\u00A0" }))] }, i))) }), jsxRuntime.jsx("div", { className: "flex-1" }), jsxRuntime.jsx("div", { "data-button-placeholder": plan.key, className: "w-full" })] }, plan.key))) }), jsxRuntime.jsx(moneyPriceInteractive.MoneyPriceInteractive, { data: data, config: config, upgradeApiEndpoint: upgradeApiEndpoint, signInPath: signInPath })] }));
+                            })() })] }), jsxRuntime.jsx("div", { className: "grid grid-cols-1 md:grid-cols-3 gap-8", children: data.plans.map((plan, _idx) => (jsxRuntime.jsxs("div", { "data-price-plan": plan.key, className: utils.cn('flex flex-col bg-white dark:bg-gray-800/60 rounded-2xl border border-gray-300 dark:border-[#7c3aed40] transition p-8 w-full h-full shadow-sm dark:shadow-none', // 添加 w-full
+                        'hover:border-2 hover:border-purple-500', 'focus-within:border-2 focus-within:border-purple-500'), style: { minHeight: maxFeaturesCount * 100 }, children: [jsxRuntime.jsxs("div", { className: "flex items-center gap-2 mb-2", children: [jsxRuntime.jsx("span", { className: "text-xl font-bold text-gray-900 dark:text-gray-100", children: plan.title }), plan.titleTags && plan.titleTags.map((tag, i) => (jsxRuntime.jsx("span", { className: "px-2 py-0.5 text-xs rounded bg-orange-100 text-orange-800 dark:bg-orange-900 dark:text-orange-200 font-semibold align-middle", children: tag }, i)))] }), renderPrice(plan), jsxRuntime.jsx("ul", { className: "flex-1 mb-6 mt-4", children: getFeatureRows(plan).map((feature, i) => (jsxRuntime.jsxs("li", { className: "flex items-center gap-2 mb-2 min-h-[28px]", "data-feature-item": `${plan.key}-${i}`, children: [feature ? (jsxRuntime.jsx("span", { className: "inline-flex items-center justify-center w-5 h-5 rounded-full bg-green-100 text-green-700 dark:bg-green-900 dark:text-green-200 mr-1", children: feature.icon ? jsxRuntime.jsx("span", { children: feature.icon }) : jsxRuntime.jsx("span", { className: "font-bold", children: "\u2713" }) })) : (jsxRuntime.jsx("span", { className: "inline-flex items-center justify-center w-5 h-5 rounded-full mr-1", children: "\u00A0" })), feature && feature.tag && (jsxRuntime.jsx("span", { className: "px-1 py-0.5 text-[6px] rounded bg-blue-100 text-blue-800 dark:bg-blue-900 dark:text-blue-200 font-semibold align-middle", children: feature.tag })), feature ? (jsxRuntime.jsxs("span", { className: "relative group cursor-pointer text-sm text-gray-800 dark:text-gray-200", children: [feature.description, feature.tooltip && (jsxRuntime.jsx("span", { className: "ml-1 align-middle inline-flex", "data-tooltip-trigger": `${plan.key}-${i}`, "data-tooltip-content": feature.tooltip, children: jsxRuntime.jsx("svg", { className: "w-4 h-4", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: jsxRuntime.jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M8.228 9c.549-1.165 2.03-2 3.772-2 2.21 0 4 1.343 4 3 0 1.4-1.278 2.575-3.006 2.907-.542.104-.994.54-.994 1.093m0 3h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" }) }) }))] })) : (jsxRuntime.jsx("span", { children: "\u00A0" }))] }, i))) }), jsxRuntime.jsx("div", { className: "flex-1" }), jsxRuntime.jsx("div", { "data-button-placeholder": plan.key, className: "w-full" })] }, plan.key))) }), jsxRuntime.jsx(moneyPriceInteractive.MoneyPriceInteractive, { data: data, config: config, upgradeApiEndpoint: upgradeApiEndpoint, signInPath: signInPath })] }));
     });
 }
 

package/dist/main/money-price/money-price.mjs

@@ -64,7 +64,8 @@ function MoneyPrice(_a) {
                                 if (!(opt && hasDiscount && opt.discountText))
                                     return null;
                                 return (jsx("span", { className: "px-2 py-1 text-xs rounded bg-yellow-100 text-yellow-800 font-semibold align-middle text-center inline-flex items-center justify-center whitespace-nowrap", children: opt.discountText.replace('{percent}', String(discountPercent)) }));
-                            })() })] }), jsx("div", { className: "grid grid-cols-1 md:grid-cols-3 gap-8", children: data.plans.map((plan, _idx) => (jsxs("div", { "data-price-plan": plan.key, className: cn('flex flex-col bg-white dark:bg-gray-800/60 rounded-2xl border border-gray-300 dark:border-[#7c3aed40] transition p-8 h-full shadow-sm dark:shadow-none', 'hover:border-2 hover:border-purple-500', 'focus-within:border-2 focus-within:border-purple-500'), style: { minHeight: maxFeaturesCount * 100 }, children: [jsxs("div", { className: "flex items-center gap-2 mb-2", children: [jsx("span", { className: "text-xl font-bold text-gray-900 dark:text-gray-100", children: plan.title }), plan.titleTags && plan.titleTags.map((tag, i) => (jsx("span", { className: "px-2 py-0.5 text-xs rounded bg-orange-100 text-orange-800 dark:bg-orange-900 dark:text-orange-200 font-semibold align-middle", children: tag }, i)))] }), renderPrice(plan), jsx("ul", { className: "flex-1 mb-6 mt-4", children: getFeatureRows(plan).map((feature, i) => (jsxs("li", { className: "flex items-center gap-2 mb-2 min-h-[28px]", "data-feature-item": `${plan.key}-${i}`, children: [feature ? (jsx("span", { className: "inline-flex items-center justify-center w-5 h-5 rounded-full bg-green-100 text-green-700 dark:bg-green-900 dark:text-green-200 mr-1", children: feature.icon ? jsx("span", { children: feature.icon }) : jsx("span", { className: "font-bold", children: "\u2713" }) })) : (jsx("span", { className: "inline-flex items-center justify-center w-5 h-5 rounded-full mr-1", children: "\u00A0" })), feature && feature.tag && (jsx("span", { className: "px-1 py-0.5 text-[6px] rounded bg-blue-100 text-blue-800 dark:bg-blue-900 dark:text-blue-200 font-semibold align-middle", children: feature.tag })), feature ? (jsxs("span", { className: "relative group cursor-pointer text-sm text-gray-800 dark:text-gray-200", children: [feature.description, feature.tooltip && (jsx("span", { className: "ml-1 align-middle inline-flex", "data-tooltip-trigger": `${plan.key}-${i}`, "data-tooltip-content": feature.tooltip, children: jsx("svg", { className: "w-4 h-4", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M8.228 9c.549-1.165 2.03-2 3.772-2 2.21 0 4 1.343 4 3 0 1.4-1.278 2.575-3.006 2.907-.542.104-.994.54-.994 1.093m0 3h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" }) }) }))] })) : (jsx("span", { children: "\u00A0" }))] }, i))) }), jsx("div", { className: "flex-1" }), jsx("div", { "data-button-placeholder": plan.key, className: "w-full" })] }, plan.key))) }), jsx(MoneyPriceInteractive, { data: data, config: config, upgradeApiEndpoint: upgradeApiEndpoint, signInPath: signInPath })] }));
+                            })() })] }), jsx("div", { className: "grid grid-cols-1 md:grid-cols-3 gap-8", children: data.plans.map((plan, _idx) => (jsxs("div", { "data-price-plan": plan.key, className: cn('flex flex-col bg-white dark:bg-gray-800/60 rounded-2xl border border-gray-300 dark:border-[#7c3aed40] transition p-8 w-full h-full shadow-sm dark:shadow-none', // 添加 w-full
+                        'hover:border-2 hover:border-purple-500', 'focus-within:border-2 focus-within:border-purple-500'), style: { minHeight: maxFeaturesCount * 100 }, children: [jsxs("div", { className: "flex items-center gap-2 mb-2", children: [jsx("span", { className: "text-xl font-bold text-gray-900 dark:text-gray-100", children: plan.title }), plan.titleTags && plan.titleTags.map((tag, i) => (jsx("span", { className: "px-2 py-0.5 text-xs rounded bg-orange-100 text-orange-800 dark:bg-orange-900 dark:text-orange-200 font-semibold align-middle", children: tag }, i)))] }), renderPrice(plan), jsx("ul", { className: "flex-1 mb-6 mt-4", children: getFeatureRows(plan).map((feature, i) => (jsxs("li", { className: "flex items-center gap-2 mb-2 min-h-[28px]", "data-feature-item": `${plan.key}-${i}`, children: [feature ? (jsx("span", { className: "inline-flex items-center justify-center w-5 h-5 rounded-full bg-green-100 text-green-700 dark:bg-green-900 dark:text-green-200 mr-1", children: feature.icon ? jsx("span", { children: feature.icon }) : jsx("span", { className: "font-bold", children: "\u2713" }) })) : (jsx("span", { className: "inline-flex items-center justify-center w-5 h-5 rounded-full mr-1", children: "\u00A0" })), feature && feature.tag && (jsx("span", { className: "px-1 py-0.5 text-[6px] rounded bg-blue-100 text-blue-800 dark:bg-blue-900 dark:text-blue-200 font-semibold align-middle", children: feature.tag })), feature ? (jsxs("span", { className: "relative group cursor-pointer text-sm text-gray-800 dark:text-gray-200", children: [feature.description, feature.tooltip && (jsx("span", { className: "ml-1 align-middle inline-flex", "data-tooltip-trigger": `${plan.key}-${i}`, "data-tooltip-content": feature.tooltip, children: jsx("svg", { className: "w-4 h-4", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M8.228 9c.549-1.165 2.03-2 3.772-2 2.21 0 4 1.343 4 3 0 1.4-1.278 2.575-3.006 2.907-.542.104-.994.54-.994 1.093m0 3h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" }) }) }))] })) : (jsx("span", { children: "\u00A0" }))] }, i))) }), jsx("div", { className: "flex-1" }), jsx("div", { "data-button-placeholder": plan.key, className: "w-full" })] }, plan.key))) }), jsx(MoneyPriceInteractive, { data: data, config: config, upgradeApiEndpoint: upgradeApiEndpoint, signInPath: signInPath })] }));
     });
 }
 

package/dist/node_modules/.pnpm/cose-base@1.0.3/node_modules/cose-base/cose-base.mjs

@@ -1,4 +1,4 @@
-import { __module as coseBase$1 } from '../../../../../_virtual/cose-base.mjs';
+import { __module as coseBase$1 } from '../../../../../_virtual/cose-base2.mjs';
 import { __require as requireLayoutBase } from '../../../layout-base@1.0.2/node_modules/layout-base/layout-base.mjs';
 
 var coseBase = coseBase$1.exports;

package/dist/node_modules/.pnpm/cose-base@2.2.0/node_modules/cose-base/cose-base.mjs

@@ -1,4 +1,4 @@
-import { __module as coseBase$1 } from '../../../../../_virtual/cose-base2.mjs';
+import { __module as coseBase$1 } from '../../../../../_virtual/cose-base.mjs';
 import { __require as requireLayoutBase } from '../../../layout-base@2.0.1/node_modules/layout-base/layout-base.mjs';
 
 var coseBase = coseBase$1.exports;

package/dist/node_modules/.pnpm/layout-base@1.0.2/node_modules/layout-base/layout-base.mjs

@@ -1,4 +1,4 @@
-import { __module as layoutBase$1 } from '../../../../../_virtual/layout-base.mjs';
+import { __module as layoutBase$1 } from '../../../../../_virtual/layout-base2.mjs';
 
 var layoutBase = layoutBase$1.exports;
 

package/dist/node_modules/.pnpm/layout-base@2.0.1/node_modules/layout-base/layout-base.mjs

@@ -1,4 +1,4 @@
-import { __module as layoutBase$1 } from '../../../../../_virtual/layout-base2.mjs';
+import { __module as layoutBase$1 } from '../../../../../_virtual/layout-base.mjs';
 
 var layoutBase = layoutBase$1.exports;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windrun-huaiin/third-ui",
-  "version": "7.3.5",
+  "version": "7.3.7",
   "description": "Third-party integrated UI components for windrun-huaiin projects",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -75,8 +75,8 @@
     "mermaid": "^11.6.0",
     "react-medium-image-zoom": "^5.2.14",
     "zod": "^3.22.4",
-    "@windrun-huaiin/lib": "^7.1.2",
-    "@windrun-huaiin/base-ui": "^8.1.2"
+    "@windrun-huaiin/base-ui": "^8.1.2",
+    "@windrun-huaiin/lib": "^7.1.2"
   },
   "peerDependencies": {
     "react": "19.1.0",

package/src/clerk/fingerprint/fingerprint-client.ts

@@ -4,102 +4,100 @@
  * 只能在浏览器环境中使用
  */
 
-import { 
-  FINGERPRINT_STORAGE_KEY, 
-  FINGERPRINT_COOKIE_NAME, 
-  isValidFingerprintId 
-} from './fingerprint-shared';
 import FingerprintJS from '@fingerprintjs/fingerprintjs';
+import { FINGERPRINT_STORAGE_KEY, FINGERPRINT_COOKIE_NAME, isValidFingerprintId } from './fingerprint-shared';
 
 /**
- * 生成基于真实浏览器特征的fingerprint ID
- * 使用FingerprintJS收集浏览器特征并生成唯一标识
- * 只能在客户端使用
+ * 检查浏览器存储（localStorage 和 cookie）中的指纹 ID
+ * 返回有效的 ID 或 null
  */
-export async function generateFingerprintId(): Promise<string> {
+function checkStoredFingerprintId(): string | null {
   if (typeof window === 'undefined') {
-    throw new Error('generateFingerprintId can only be used in browser environment');
+    return null;
   }
 
-  // 首先检查现有ID
-  const existingId = getFingerprintId();
-  if (existingId && isValidFingerprintId(existingId)) {
-    return existingId;
+  // 优先检查 localStorage
+  const localStorageId = localStorage.getItem(FINGERPRINT_STORAGE_KEY);
+  if (localStorageId && isValidFingerprintId(localStorageId)) {
+    return localStorageId;
   }
 
-  // 检查cookie
+  // 检查 cookie
   const cookieId = getCookieValue(FINGERPRINT_COOKIE_NAME);
   if (cookieId && isValidFingerprintId(cookieId)) {
-    // 同步到localStorage
+    // 同步到 localStorage
     localStorage.setItem(FINGERPRINT_STORAGE_KEY, cookieId);
     return cookieId;
   }
 
+  return null;
+}
+
+/**
+ * 生成基于真实浏览器特征的fingerprint ID
+ * 使用 FingerprintJS 收集浏览器特征并生成唯一标识
+ */
+export async function generateFingerprintId(): Promise<string> {
+  if (typeof window === 'undefined') {
+    throw new Error('generateFingerprintId can only be used in browser environment');
+  }
+
+  // 检查现有 ID
+  const existingId = checkStoredFingerprintId();
+  if (existingId) {
+    console.log('Using existing fingerprint ID:', existingId);
+    return existingId;
+  }
+
   try {
-    // 使用FingerprintJS生成基于浏览器特征的指纹
+    // 使用 FingerprintJS 生成指纹
     const fp = await FingerprintJS.load();
     const result = await fp.get();
     const fingerprintId = `fp_${result.visitorId}`;
 
-    // 存储到localStorage和cookie
+    // 存储到 localStorage 和 cookie
     localStorage.setItem(FINGERPRINT_STORAGE_KEY, fingerprintId);
-    setCookie(FINGERPRINT_COOKIE_NAME, fingerprintId, 365); // 365天过期
+    setCookie(FINGERPRINT_COOKIE_NAME, fingerprintId, 365);
 
+    console.log('Generated new fingerprint ID:', fingerprintId);
     return fingerprintId;
   } catch (error) {
     console.warn('Failed to generate fingerprint with FingerprintJS:', error);
-    // 降级方案：生成时间戳+随机数
+    // 降级方案：生成基于时间戳和随机数的 ID
     const fallbackId = `fp_fallback_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
-    
     localStorage.setItem(FINGERPRINT_STORAGE_KEY, fallbackId);
     setCookie(FINGERPRINT_COOKIE_NAME, fallbackId, 365);
-    
+
+    console.log('Generated fallback fingerprint ID:', fallbackId);
     return fallbackId;
   }
 }
 
 /**
  * 获取当前的fingerprint ID
- * 只能在客户端使用
  */
 export function getFingerprintId(): string | null {
-  if (typeof window === 'undefined') {
-    return null;
-  }
-
-  // 首先检查localStorage
-  const localStorageId = localStorage.getItem(FINGERPRINT_STORAGE_KEY);
-  if (localStorageId) {
-    return localStorageId;
-  }
-
-  // 检查cookie
-  const cookieId = getCookieValue(FINGERPRINT_COOKIE_NAME);
-  if (cookieId) {
-    // 同步到localStorage
-    localStorage.setItem(FINGERPRINT_STORAGE_KEY, cookieId);
-    return cookieId;
-  }
-
-  return null;
+  return checkStoredFingerprintId();
 }
 
 /**
  * 设置fingerprint ID到存储
- * 只能在客户端使用
  */
 export function setFingerprintId(fingerprintId: string): void {
   if (typeof window === 'undefined') {
     throw new Error('setFingerprintId can only be used in browser environment');
   }
 
+  if (!isValidFingerprintId(fingerprintId)) {
+    throw new Error('Invalid fingerprint ID');
+  }
+
   localStorage.setItem(FINGERPRINT_STORAGE_KEY, fingerprintId);
   setCookie(FINGERPRINT_COOKIE_NAME, fingerprintId, 365);
 }
 
 /**
  * 清除fingerprint ID
- * 只能在客户端使用
  */
 export function clearFingerprintId(): void {
   if (typeof window === 'undefined') {
@@ -113,30 +111,29 @@ export function clearFingerprintId(): void {
 /**
  * 获取或生成fingerprint ID
  * 如果不存在则自动生成新的
- * 只能在客户端使用
  */
 export async function getOrGenerateFingerprintId(): Promise<string> {
-  const existingId = getFingerprintId();
+  const existingId = checkStoredFingerprintId();
   if (existingId) {
+    console.log('Retrieved existing fingerprint ID:', existingId);
     return existingId;
   }
+
   return await generateFingerprintId();
 }
 
 /**
  * 创建包含fingerprint ID的fetch headers
- * 只能在客户端使用
  */
 export async function createFingerprintHeaders(): Promise<Record<string, string>> {
   const fingerprintId = await getOrGenerateFingerprintId();
   return {
-    FINGERPRINT_HEADER_NAME : fingerprintId,
+    FINGERPRINT_HEADER_NAME: fingerprintId,
   };
 }
 
 /**
  * Hook for generating fingerprint headers
- * 只能在客户端使用
  */
 export function useFingerprintHeaders(): () => Promise<Record<string, string>> {
   return createFingerprintHeaders;
@@ -144,7 +141,6 @@ export function useFingerprintHeaders(): () => Promise<Record<string, string>> {
 
 /**
  * Create a fetch wrapper that automatically includes fingerprint headers
- * 只能在客户端使用
  */
 export function createFingerprintFetch() {
   return async (url: string | URL | Request, init?: RequestInit) => {

package/src/clerk/fingerprint/use-fingerprint.ts

@@ -19,6 +19,21 @@ import type {
  * Accepts configuration to customize API endpoint and behavior
  */
 export function useFingerprint(config: FingerprintConfig): UseFingerprintResult {
+  // 服务端渲染检查
+  if (typeof window === 'undefined') {
+    return {
+      fingerprintId: null,
+      xUser: null,
+      xCredit: null,
+      xSubscription: null,
+      isLoading: false,
+      isInitialized: false,
+      error: 'Server-side rendering is not supported',
+      initializeAnonymousUser: async () => {},
+      refreshUserData: async () => {},
+    };
+  }
+
   const [fingerprintId, setFingerprintIdState] = useState<string | null>(null);
   const [xUser, setXUser] = useState<XUser | null>(null);
   const [xCredit, setXCredit] = useState<XCredit | null>(null);
@@ -31,11 +46,9 @@ export function useFingerprint(config: FingerprintConfig): UseFingerprintResult
    * 第一阶段：初始化fingerprint ID
    */
   const initializeFingerprintId = useCallback(async () => {
-    if (typeof window === 'undefined') return null;
-
     try {
-      // 优先检查现有ID, 没有就生成新的fingerprint ID
       const currentFingerprintId = await getOrGenerateFingerprintId();
+      console.log('Initialized fingerprintId:', currentFingerprintId);
       setFingerprintIdState(currentFingerprintId);
       return currentFingerprintId;
     } catch (error) {
@@ -50,7 +63,12 @@ export function useFingerprint(config: FingerprintConfig): UseFingerprintResult
    */
   const initializeAnonymousUser = useCallback(async () => {
     if (!fingerprintId) {
-      console.warn('Cannot initialize user without fingerprint ID');
+      console.warn('Cannot initialize user: Fingerprint ID is missing', {
+        fingerprintId,
+        isLoading,
+        isInitialized,
+      });
+      setError('Cannot initialize user: Missing fingerprint ID');
       return;
     }
 
@@ -103,7 +121,15 @@ export function useFingerprint(config: FingerprintConfig): UseFingerprintResult
    * 刷新用户数据
    */
   const refreshUserData = useCallback(async () => {
-    if (!fingerprintId) return;
+    if (!fingerprintId) {
+      console.warn('Cannot refresh user data: Fingerprint ID is missing', {
+        fingerprintId,
+        isLoading,
+        isInitialized,
+      });
+      setError('Cannot refresh user data: Missing fingerprint ID');
+      return;
+    }
 
     try {
       setError(null);
@@ -140,7 +166,14 @@ export function useFingerprint(config: FingerprintConfig): UseFingerprintResult
    * 检查现有用户数据（仅在有fingerprint ID时执行）
    */
   const checkExistingUser = useCallback(async () => {
-    if (!fingerprintId) return;
+    if (!fingerprintId) {
+      console.warn('Cannot check existing user: Fingerprint ID is missing', {
+        fingerprintId,
+        isLoading,
+        isInitialized,
+      });
+      return;
+    }
 
     try {
       const fingerprintHeaders = await createFingerprintHeaders();
@@ -165,11 +198,14 @@ export function useFingerprint(config: FingerprintConfig): UseFingerprintResult
 
   // 第一阶段：页面加载完成后生成指纹ID
   useEffect(() => {
-    if (typeof window === 'undefined') return;
-
     const initFingerprint = async () => {
-      await initializeFingerprintId();
-      setIsLoading(false); // 第一阶段完成，结束加载状态
+      setIsLoading(true);
+      const currentFingerprintId = await initializeFingerprintId();
+      if (currentFingerprintId) {
+        setIsLoading(false);
+      } else {
+        setIsLoading(false);
+      }
     };
 
     initFingerprint();
@@ -177,15 +213,14 @@ export function useFingerprint(config: FingerprintConfig): UseFingerprintResult
 
   // 第二阶段：有指纹ID后检查现有用户
   useEffect(() => {
-    if (!fingerprintId || isInitialized) return;
+    if (!fingerprintId || isInitialized || isLoading) return;
 
     checkExistingUser();
-  }, [fingerprintId, isInitialized, checkExistingUser]);
+  }, [fingerprintId, isInitialized, isLoading, checkExistingUser]);
 
   // 第三阶段：如果没有现有用户且自动初始化开启，则创建新用户
   useEffect(() => {
-    if (!fingerprintId || isInitialized || isLoading || error) return;
-    if (config.autoInitialize === false) return;
+    if (!fingerprintId || isInitialized || isLoading || error || config.autoInitialize === false) return;
 
     initializeAnonymousUser();
   }, [fingerprintId, isInitialized, isLoading, error, initializeAnonymousUser, config.autoInitialize]);
@@ -201,6 +236,4 @@ export function useFingerprint(config: FingerprintConfig): UseFingerprintResult
     initializeAnonymousUser,
     refreshUserData,
   };
-}
-
-// createFingerprintFetch moved to fingerprint.ts
+}

package/src/main/money-price/money-price-button.tsx

@@ -89,7 +89,6 @@ export function MoneyPriceButton({
   
   if (config.hidden) return null;
   
-  // 使用 GradientButton 组件
   return (
     <GradientButton
       title={config.text}

package/src/main/money-price/money-price-interactive.tsx

@@ -317,7 +317,7 @@ export function MoneyPriceInteractive({
     );
   };
 
-  // 直接渲染按钮，确保宽度占满
+  // 直接渲染按钮
   return (
     <>
       {data.plans.map((plan: any) => (

package/src/main/money-price/money-price.tsx

@@ -205,7 +205,7 @@ export async function MoneyPrice({
             key={plan.key}
             data-price-plan={plan.key}
             className={cn(
-              'flex flex-col bg-white dark:bg-gray-800/60 rounded-2xl border border-gray-300 dark:border-[#7c3aed40] transition p-8 h-full shadow-sm dark:shadow-none',
+              'flex flex-col bg-white dark:bg-gray-800/60 rounded-2xl border border-gray-300 dark:border-[#7c3aed40] transition p-8 w-full h-full shadow-sm dark:shadow-none', // 添加 w-full
               'hover:border-2 hover:border-purple-500',
               'focus-within:border-2 focus-within:border-purple-500'
             )}