@windrun-huaiin/third-ui 14.1.1 → 14.2.0

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

@@ -0,0 +1,2 @@
+export declare function getDebugFingerprintOverride(): string | null;
+export declare function setDebugFingerprintOverride(fingerprintId: string): void;

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

@@ -0,0 +1,43 @@
+"use client";
+'use strict';
+
+var fingerprintShared = require('./fingerprint-shared.js');
+
+function getLocalStorageValue(key) {
+    if (typeof window === 'undefined') {
+        return null;
+    }
+    try {
+        return window.localStorage.getItem(key);
+    }
+    catch (_a) {
+        return null;
+    }
+}
+function setLocalStorageValue(key, value) {
+    if (typeof window === 'undefined') {
+        return;
+    }
+    try {
+        window.localStorage.setItem(key, value);
+    }
+    catch (_a) {
+        // Ignore storage failures in debug helpers.
+    }
+}
+function getDebugFingerprintOverride() {
+    const value = getLocalStorageValue(fingerprintShared.FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY);
+    if (!value || !fingerprintShared.isValidFingerprintId(value)) {
+        return null;
+    }
+    return value;
+}
+function setDebugFingerprintOverride(fingerprintId) {
+    if (!fingerprintShared.isValidFingerprintId(fingerprintId)) {
+        throw new Error('Invalid fingerprint ID');
+    }
+    setLocalStorageValue(fingerprintShared.FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY, fingerprintId);
+}
+
+exports.getDebugFingerprintOverride = getDebugFingerprintOverride;
+exports.setDebugFingerprintOverride = setDebugFingerprintOverride;

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

@@ -0,0 +1,40 @@
+"use client";
+import { isValidFingerprintId, FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY } from './fingerprint-shared.mjs';
+
+function getLocalStorageValue(key) {
+    if (typeof window === 'undefined') {
+        return null;
+    }
+    try {
+        return window.localStorage.getItem(key);
+    }
+    catch (_a) {
+        return null;
+    }
+}
+function setLocalStorageValue(key, value) {
+    if (typeof window === 'undefined') {
+        return;
+    }
+    try {
+        window.localStorage.setItem(key, value);
+    }
+    catch (_a) {
+        // Ignore storage failures in debug helpers.
+    }
+}
+function getDebugFingerprintOverride() {
+    const value = getLocalStorageValue(FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY);
+    if (!value || !isValidFingerprintId(value)) {
+        return null;
+    }
+    return value;
+}
+function setDebugFingerprintOverride(fingerprintId) {
+    if (!isValidFingerprintId(fingerprintId)) {
+        throw new Error('Invalid fingerprint ID');
+    }
+    setLocalStorageValue(FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY, fingerprintId);
+}
+
+export { getDebugFingerprintOverride, setDebugFingerprintOverride };

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

@@ -10,6 +10,7 @@ var React = require('react');
 var useFingerprint = require('./use-fingerprint.js');
 var ui = require('@windrun-huaiin/base-ui/ui');
 var fingerprintClient = require('./fingerprint-client.js');
+var fingerprintDebug = require('./fingerprint-debug.js');
 var fingerprintShared = require('./fingerprint-shared.js');
 
 const FingerprintContext = React.createContext(undefined);
@@ -52,13 +53,14 @@ function withFingerprint(Component, config) {
  * 组件：显示用户状态和积分信息（用于调试）
  */
 function FingerprintStatus() {
-    const { fingerprintId, xUser, xCredit, xSubscription, error, clearError, initializeAnonymousUser, } = useFingerprintContext();
+    const { fingerprintId, xUser, xCredit, xSubscription, error, clearError, } = useFingerprintContext();
     const [isOpen, setIsOpen] = React.useState(false);
     const [panelMode, setPanelMode] = React.useState('info');
-    const [testFingerprintId, setTestFingerprintId] = React.useState('');
     const [testResult, setTestResult] = React.useState('');
     const [isRunningTest, setIsRunningTest] = React.useState(false);
     const modalRef = React.useRef(null);
+    const isInitializingDebugAnonymousUserRef = React.useRef(false);
+    const [activeDebugFingerprintId, setActiveDebugFingerprintId] = React.useState(null);
     const handleToggle = () => setIsOpen(prev => !prev);
     const handleBackdropClick = (e) => {
         if (e.target === e.currentTarget)
@@ -79,12 +81,15 @@ function FingerprintStatus() {
         }
     }, [xUser]);
     React.useEffect(() => {
-        if (testFingerprintId) {
+        const debugFingerprintOverride = fingerprintDebug.getDebugFingerprintOverride();
+        if (debugFingerprintOverride) {
+            setActiveDebugFingerprintId(debugFingerprintOverride);
             return;
         }
-        const defaultFingerprintId = buildDebugFingerprintId();
-        setTestFingerprintId(defaultFingerprintId);
-    }, [testFingerprintId]);
+        const nextFingerprintId = buildDebugFingerprintId();
+        fingerprintDebug.setDebugFingerprintOverride(nextFingerprintId);
+        setActiveDebugFingerprintId(nextFingerprintId);
+    }, []);
     const creditBuckets = React.useMemo(() => {
         if (!xCredit)
             return [];
@@ -142,31 +147,58 @@ function FingerprintStatus() {
     const subStatus = subscriptionStatus.status;
     const themedGhostButtonClass = utils.cn('border-slate-200 bg-white/90 hover:bg-slate-50 dark:border-white/10 dark:bg-slate-950/80 dark:hover:bg-slate-900', 'hover:border-current', lib.themeIconColor);
     const runContextParallelInitTest = () => tslib_es6.__awaiter(this, void 0, void 0, function* () {
+        const debugFingerprintId = activeDebugFingerprintId;
+        if (!debugFingerprintId) {
+            setTestResult('Test fingerprint override is not ready yet.');
+            return;
+        }
         setIsRunningTest(true);
-        setTestResult('Running context parallel init x3...');
+        setTestResult(`Running Frontend Prevention Test with fingerprint: ${debugFingerprintId}`);
         try {
             yield Promise.all([
-                initializeAnonymousUser(),
-                initializeAnonymousUser(),
-                initializeAnonymousUser(),
+                initializeDebugAnonymousUser(debugFingerprintId),
+                initializeDebugAnonymousUser(debugFingerprintId),
+                initializeDebugAnonymousUser(debugFingerprintId),
             ]);
-            setTestResult(`Context parallel init finished. Active fingerprint: ${fingerprintId || '--'}`);
+            setTestResult(`Frontend Prevention Test finished. Active test fingerprint: ${debugFingerprintId}`);
         }
         catch (testError) {
-            setTestResult(`Context parallel init failed: ${formatErrorMessage(testError)}`);
+            setTestResult(`Frontend Prevention Test failed: ${formatErrorMessage(testError)}`);
         }
         finally {
             setIsRunningTest(false);
         }
     });
+    const initializeDebugAnonymousUser = (debugFingerprintId) => tslib_es6.__awaiter(this, void 0, void 0, function* () {
+        if (isInitializingDebugAnonymousUserRef.current) {
+            return;
+        }
+        try {
+            isInitializingDebugAnonymousUserRef.current = true;
+            const fingerprintHeaders = yield fingerprintClient.createFingerprintHeaders();
+            const response = yield fetch('/api/user/anonymous/init', {
+                method: 'POST',
+                headers: Object.assign(Object.assign({ 'Content-Type': 'application/json', [fingerprintShared.FINGERPRINT_SOURCE_REFER]: document.referrer || '' }, fingerprintHeaders), { 'x-fingerprint-id-v8': debugFingerprintId }),
+                body: JSON.stringify({ fingerprintId: debugFingerprintId }),
+            });
+            if (!response.ok) {
+                const errorData = yield response.json().catch(() => ({}));
+                throw new Error(errorData.error || 'Failed to initialize anonymous user');
+            }
+            yield response.json().catch(() => ({}));
+        }
+        finally {
+            isInitializingDebugAnonymousUserRef.current = false;
+        }
+    });
     const runRawParallelPostTest = () => tslib_es6.__awaiter(this, void 0, void 0, function* () {
-        const normalizedFingerprintId = testFingerprintId.trim();
+        const normalizedFingerprintId = activeDebugFingerprintId;
         if (!normalizedFingerprintId) {
-            setTestResult('Please input a valid test fingerprint id.');
+            setTestResult('Test fingerprint override is not ready yet.');
             return;
         }
         setIsRunningTest(true);
-        setTestResult(`Running raw POST x3 with fingerprint: ${normalizedFingerprintId}`);
+        setTestResult(`Running Backend Idempotency Test with fingerprint: ${normalizedFingerprintId}`);
         try {
             const fingerprintHeaders = yield fingerprintClient.createFingerprintHeaders();
             const requests = Array.from({ length: 3 }, () => fetch('/api/user/anonymous/init', {
@@ -197,7 +229,7 @@ function FingerprintStatus() {
                 .filter((payload) => !payload.ok)
                 .map((payload) => `${payload.status}${payload.error ? `:${payload.error}` : ''}`);
             setTestResult([
-                `Raw POST x3 done.`,
+                `Backend Idempotency Test done.`,
                 `created=${createdUserIds.length}`,
                 `reused=${reusedUserIds.length}`,
                 `failed=${failedStatuses.length}`,
@@ -206,31 +238,17 @@ function FingerprintStatus() {
             ].filter(Boolean).join('\n'));
         }
         catch (testError) {
-            setTestResult(`Raw POST test failed: ${formatErrorMessage(testError)}`);
+            setTestResult(`Backend Idempotency Test failed: ${formatErrorMessage(testError)}`);
         }
         finally {
             setIsRunningTest(false);
         }
     });
-    const applyTestFingerprintAndReload = () => {
-        const normalizedFingerprintId = testFingerprintId.trim();
-        if (!normalizedFingerprintId) {
-            setTestResult('Please input a valid test fingerprint id before applying.');
-            return;
-        }
-        try {
-            fingerprintClient.setFingerprintId(normalizedFingerprintId);
-            setTestResult(`Applied test fingerprint and reloading: ${normalizedFingerprintId}`);
-            window.location.reload();
-        }
-        catch (testError) {
-            setTestResult(`Apply test fingerprint failed: ${formatErrorMessage(testError)}`);
-        }
-    };
     const regenerateTestFingerprint = () => {
         const nextFingerprintId = buildDebugFingerprintId();
-        setTestFingerprintId(nextFingerprintId);
-        setTestResult(`Generated test fingerprint: ${nextFingerprintId}`);
+        fingerprintDebug.setDebugFingerprintOverride(nextFingerprintId);
+        setActiveDebugFingerprintId(nextFingerprintId);
+        setTestResult(`Generated test fingerprint override: ${nextFingerprintId}`);
     };
     return (jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [!isOpen && (jsxRuntime.jsx("button", { onClick: handleToggle, type: "button", "aria-label": "Fingerprint debug panel", className: utils.cn('fixed left-2 top-2 md:left-2 md:top-3 z-10000 inline-flex size-8 md:size-11 items-center justify-center rounded-full', lib.themeButtonGradientClass, lib.themeButtonGradientHoverClass, 'text-white rounded-full shadow-lg hover:shadow-xl transition-all duration-300'), children: jsxRuntime.jsx(server.globalLucideIcons.Lightbulb, { className: "size-6 text-white" }) })), isOpen && (jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [jsxRuntime.jsx("div", { onClick: handleBackdropClick, className: "fixed inset-0 z-9998 bg-black/60 backdrop-blur-sm" }), jsxRuntime.jsxs("div", { ref: modalRef, className: utils.cn('fixed inset-3 z-9999 mx-auto w-[min(95vw,520px)] overflow-y-auto rounded-2xl border', 'border-slate-200/70 bg-white/95 p-4 shadow-2xl backdrop-blur-sm', 'font-sans text-sm text-slate-700 dark:border-white/12 dark:bg-slate-950/95 dark:text-slate-200', 'sm:inset-auto md:left-2 sm:top-1 md:right-auto sm:w-[min(520px,95vw)] sm:p-5'), children: [jsxRuntime.jsx("header", { className: "mb-4", children: jsxRuntime.jsxs("div", { className: "flex items-start justify-between gap-3", children: [jsxRuntime.jsxs("div", { className: utils.cn("flex items-center gap-2 text-base font-bold tracking-wider", lib.themeIconColor), children: [jsxRuntime.jsx(server.globalLucideIcons.ShieldUser, { className: "size-4" }), "Fingerprint Debug Panel"] }), jsxRuntime.jsxs("div", { className: "flex items-center gap-2", children: [jsxRuntime.jsxs("button", { type: "button", onClick: () => setPanelMode((prev) => prev === 'info' ? 'test' : 'info'), className: utils.cn('inline-flex items-center gap-2 rounded-full border px-2 py-1 text-[11px] font-semibold shadow-sm transition-all duration-200', panelMode === 'test'
                                                         ? utils.cn('border-transparent text-white', lib.themeButtonGradientClass, lib.themeButtonGradientHoverClass)
@@ -254,7 +272,7 @@ function FingerprintStatus() {
                                                     { label: 'SubID', value: jsxRuntime.jsx(ui.CopyableText, { text: (xSubscription === null || xSubscription === void 0 ? void 0 : xSubscription.paySubscriptionId) || '' }) },
                                                     { label: 'OrderID', value: jsxRuntime.jsx(ui.CopyableText, { text: (xSubscription === null || xSubscription === void 0 ? void 0 : xSubscription.orderId) || '' }) },
                                                     { label: 'PriceID', value: jsxRuntime.jsx(ui.CopyableText, { text: (xSubscription === null || xSubscription === void 0 ? void 0 : xSubscription.priceId) || '' }) },
-                                                ] })] })) : (jsxRuntime.jsxs("div", { className: "space-y-3 rounded-xl border border-slate-200/70 bg-white/85 p-4 shadow-sm dark:border-white/12 dark:bg-slate-900/45", children: [jsxRuntime.jsx(PanelHeader, { icon: jsxRuntime.jsx(server.globalLucideIcons.DatabaseZap, { className: "size-4" }), title: "Concurrent Base Info", rightInfo: jsxRuntime.jsx(StatusTag, { value: isRunningTest ? 'pending' : 'idle' }) }), jsxRuntime.jsxs("div", { className: "space-y-2 text-xs text-slate-500 dark:text-slate-300", children: [jsxRuntime.jsxs("div", { className: "flex items-center justify-between gap-3", children: [jsxRuntime.jsx("span", { className: "text-slate-400 dark:text-slate-500", children: "Current Browser" }), jsxRuntime.jsx(ui.CopyableText, { text: fingerprintId || '' })] }), jsxRuntime.jsxs("div", { className: "space-y-1", children: [jsxRuntime.jsx("span", { className: "text-slate-400 dark:text-slate-500", children: "Generate New" }), jsxRuntime.jsxs("div", { className: "flex items-center gap-2 py-1", children: [jsxRuntime.jsx("input", { value: testFingerprintId, onChange: (e) => setTestFingerprintId(e.target.value), className: "min-w-0 flex-1 rounded-lg border border-slate-200 bg-white px-3 py-2 font-mono text-[0.5rem] sm:text-[0.625rem] md:text-xs leading-tight text-slate-700 outline-none transition focus:border-slate-400 dark:border-white/10 dark:bg-slate-950 dark:text-slate-100", placeholder: "fp_test_dbg_20260322_xxx" }), jsxRuntime.jsx("button", { type: "button", disabled: isRunningTest, onClick: regenerateTestFingerprint, "aria-label": "Generate new test fingerprint", className: "inline-flex size-9 items-center justify-center rounded-lg border border-slate-200 bg-slate-50 text-slate-700 transition hover:border-slate-300 hover:bg-slate-100 disabled:cursor-not-allowed disabled:opacity-50 dark:border-white/10 dark:bg-slate-950 dark:text-slate-100 dark:hover:bg-slate-900", children: jsxRuntime.jsx(server.globalLucideIcons.RefreshCcw, { className: "size-4" }) }), jsxRuntime.jsx("button", { type: "button", disabled: isRunningTest, onClick: applyTestFingerprintAndReload, "aria-label": "Apply test fingerprint", className: "inline-flex size-9 items-center justify-center rounded-lg border border-slate-200 bg-slate-50 text-slate-700 transition hover:border-slate-300 hover:bg-slate-100 disabled:cursor-not-allowed disabled:opacity-50 dark:border-white/10 dark:bg-slate-950 dark:text-slate-100 dark:hover:bg-slate-900", children: jsxRuntime.jsx(server.globalLucideIcons.CheckCheck, { className: "size-4" }) })] })] })] }), jsxRuntime.jsxs("div", { className: "grid grid-cols-1 gap-2 sm:grid-cols-2", children: [jsxRuntime.jsx("button", { type: "button", disabled: isRunningTest, onClick: runContextParallelInitTest, className: utils.cn('shrink-0 rounded-full border px-3 py-2 text-xs font-semibold transition-all duration-200 disabled:cursor-not-allowed disabled:opacity-50', themedGhostButtonClass), children: "Frontend Prevention Test" }), jsxRuntime.jsx("button", { type: "button", disabled: isRunningTest, onClick: runRawParallelPostTest, className: utils.cn('shrink-0 rounded-full border px-3 py-2 text-xs font-semibold text-white shadow-sm transition-all duration-200 disabled:cursor-not-allowed disabled:opacity-50', 'border-transparent', lib.themeButtonGradientClass, lib.themeButtonGradientHoverClass), children: "Backend Idempotency Test" })] }), jsxRuntime.jsx("div", { className: "rounded-lg border border-dashed border-slate-200 bg-slate-50/80 p-3 dark:border-white/10 dark:bg-slate-950/50", children: jsxRuntime.jsx("pre", { className: "overflow-x-auto whitespace-pre-wrap break-all font-mono text-[11px] leading-5 text-slate-600 dark:text-slate-300", children: testResult || 'No test executed yet.' }) })] })), error && (jsxRuntime.jsxs("div", { className: "flex items-start justify-between gap-3 rounded-xl border border-amber-200 bg-amber-50 p-3 text-xs text-amber-600 shadow-sm dark:border-amber-500/40 dark:bg-amber-500/10 dark:text-amber-200", children: [jsxRuntime.jsxs("div", { className: "flex items-start gap-2", children: [jsxRuntime.jsx(server.globalLucideIcons.X, { className: "mt-0.5 size-4 shrink-0" }), jsxRuntime.jsx("span", { children: error })] }), jsxRuntime.jsx("button", { type: "button", "aria-label": "Dismiss error", onClick: clearError, className: "shrink-0 rounded-full p-1 text-amber-500 transition hover:bg-amber-100 hover:text-amber-700 dark:text-amber-200 dark:hover:bg-amber-500/10 dark:hover:text-amber-100", children: jsxRuntime.jsx(server.globalLucideIcons.X, { className: "size-4" }) })] }))] })] })] }))] }));
+                                                ] })] })) : (jsxRuntime.jsxs("div", { className: "space-y-3 rounded-xl border border-slate-200/70 bg-white/85 p-4 shadow-sm dark:border-white/12 dark:bg-slate-900/45", children: [jsxRuntime.jsx(PanelHeader, { icon: jsxRuntime.jsx(server.globalLucideIcons.DatabaseZap, { className: "size-4" }), title: "Concurrent Base Info", rightInfo: jsxRuntime.jsx(StatusTag, { value: isRunningTest ? 'pending' : 'idle' }) }), jsxRuntime.jsxs("div", { className: "space-y-2 text-xs text-slate-500 dark:text-slate-300", children: [jsxRuntime.jsxs("div", { className: "flex items-center justify-between gap-3", children: [jsxRuntime.jsx("span", { className: "text-slate-400 dark:text-slate-500", children: "Real Browser" }), jsxRuntime.jsx(ui.CopyableText, { text: fingerprintId || '' })] }), jsxRuntime.jsxs("div", { className: "space-y-1", children: [jsxRuntime.jsx("span", { className: "text-slate-400 dark:text-slate-500", children: "Test Override" }), jsxRuntime.jsxs("div", { className: "flex items-center gap-2 py-1", children: [jsxRuntime.jsx("div", { className: "min-w-0 flex-1 rounded-lg border border-slate-200 bg-white px-3 py-2 font-mono text-[0.5rem] sm:text-[0.625rem] md:text-xs leading-tight text-slate-700 dark:border-white/10 dark:bg-slate-950 dark:text-slate-100", children: jsxRuntime.jsx(ui.CopyableText, { text: activeDebugFingerprintId || '' }) }), jsxRuntime.jsx("button", { type: "button", disabled: isRunningTest, onClick: regenerateTestFingerprint, "aria-label": "Generate new test fingerprint", className: "inline-flex size-9 items-center justify-center rounded-lg border border-slate-200 bg-slate-50 text-slate-700 transition hover:border-slate-300 hover:bg-slate-100 disabled:cursor-not-allowed disabled:opacity-50 dark:border-white/10 dark:bg-slate-950 dark:text-slate-100 dark:hover:bg-slate-900", children: jsxRuntime.jsx(server.globalLucideIcons.RefreshCcw, { className: "size-4" }) })] })] })] }), jsxRuntime.jsxs("div", { className: "grid grid-cols-1 gap-2 sm:grid-cols-2", children: [jsxRuntime.jsx("button", { type: "button", disabled: isRunningTest, onClick: runContextParallelInitTest, className: utils.cn('shrink-0 rounded-full border px-3 py-2 text-xs font-semibold transition-all duration-200 disabled:cursor-not-allowed disabled:opacity-50', themedGhostButtonClass), children: "Frontend Prevention Test" }), jsxRuntime.jsx("button", { type: "button", disabled: isRunningTest, onClick: runRawParallelPostTest, className: utils.cn('shrink-0 rounded-full border px-3 py-2 text-xs font-semibold text-white shadow-sm transition-all duration-200 disabled:cursor-not-allowed disabled:opacity-50', 'border-transparent', lib.themeButtonGradientClass, lib.themeButtonGradientHoverClass), children: "Backend Idempotency Test" })] }), jsxRuntime.jsx("div", { className: "rounded-lg border border-dashed border-slate-200 bg-slate-50/80 p-3 dark:border-white/10 dark:bg-slate-950/50", children: jsxRuntime.jsx("pre", { className: "overflow-x-auto whitespace-pre-wrap break-all font-mono text-[11px] leading-5 text-slate-600 dark:text-slate-300", children: testResult || 'No test executed yet.' }) })] })), error && (jsxRuntime.jsxs("div", { className: "flex items-start justify-between gap-3 rounded-xl border border-amber-200 bg-amber-50 p-3 text-xs text-amber-600 shadow-sm dark:border-amber-500/40 dark:bg-amber-500/10 dark:text-amber-200", children: [jsxRuntime.jsxs("div", { className: "flex items-start gap-2", children: [jsxRuntime.jsx(server.globalLucideIcons.X, { className: "mt-0.5 size-4 shrink-0" }), jsxRuntime.jsx("span", { children: error })] }), jsxRuntime.jsx("button", { type: "button", "aria-label": "Dismiss error", onClick: clearError, className: "shrink-0 rounded-full p-1 text-amber-500 transition hover:bg-amber-100 hover:text-amber-700 dark:text-amber-200 dark:hover:bg-amber-500/10 dark:hover:text-amber-100", children: jsxRuntime.jsx(server.globalLucideIcons.X, { className: "size-4" }) })] }))] })] })] }))] }));
 }
 /* ==================== 新增辅助组件 ==================== */
 // 标题行：左侧图标+标题，右侧信息（右对齐）

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

@@ -7,7 +7,8 @@ import { cn } from '@windrun-huaiin/lib/utils';
 import { createContext, useContext, useState, useRef, useEffect, useMemo } from 'react';
 import { useFingerprint } from './use-fingerprint.mjs';
 import { CopyableText } from '@windrun-huaiin/base-ui/ui';
-import { setFingerprintId, createFingerprintHeaders } from './fingerprint-client.mjs';
+import { createFingerprintHeaders } from './fingerprint-client.mjs';
+import { getDebugFingerprintOverride, setDebugFingerprintOverride } from './fingerprint-debug.mjs';
 import { FINGERPRINT_SOURCE_REFER } from './fingerprint-shared.mjs';
 
 const FingerprintContext = createContext(undefined);
@@ -50,13 +51,14 @@ function withFingerprint(Component, config) {
  * 组件：显示用户状态和积分信息（用于调试）
  */
 function FingerprintStatus() {
-    const { fingerprintId, xUser, xCredit, xSubscription, error, clearError, initializeAnonymousUser, } = useFingerprintContext();
+    const { fingerprintId, xUser, xCredit, xSubscription, error, clearError, } = useFingerprintContext();
     const [isOpen, setIsOpen] = useState(false);
     const [panelMode, setPanelMode] = useState('info');
-    const [testFingerprintId, setTestFingerprintId] = useState('');
     const [testResult, setTestResult] = useState('');
     const [isRunningTest, setIsRunningTest] = useState(false);
     const modalRef = useRef(null);
+    const isInitializingDebugAnonymousUserRef = useRef(false);
+    const [activeDebugFingerprintId, setActiveDebugFingerprintId] = useState(null);
     const handleToggle = () => setIsOpen(prev => !prev);
     const handleBackdropClick = (e) => {
         if (e.target === e.currentTarget)
@@ -77,12 +79,15 @@ function FingerprintStatus() {
         }
     }, [xUser]);
     useEffect(() => {
-        if (testFingerprintId) {
+        const debugFingerprintOverride = getDebugFingerprintOverride();
+        if (debugFingerprintOverride) {
+            setActiveDebugFingerprintId(debugFingerprintOverride);
             return;
         }
-        const defaultFingerprintId = buildDebugFingerprintId();
-        setTestFingerprintId(defaultFingerprintId);
-    }, [testFingerprintId]);
+        const nextFingerprintId = buildDebugFingerprintId();
+        setDebugFingerprintOverride(nextFingerprintId);
+        setActiveDebugFingerprintId(nextFingerprintId);
+    }, []);
     const creditBuckets = useMemo(() => {
         if (!xCredit)
             return [];
@@ -140,31 +145,58 @@ function FingerprintStatus() {
     const subStatus = subscriptionStatus.status;
     const themedGhostButtonClass = cn('border-slate-200 bg-white/90 hover:bg-slate-50 dark:border-white/10 dark:bg-slate-950/80 dark:hover:bg-slate-900', 'hover:border-current', themeIconColor);
     const runContextParallelInitTest = () => __awaiter(this, void 0, void 0, function* () {
+        const debugFingerprintId = activeDebugFingerprintId;
+        if (!debugFingerprintId) {
+            setTestResult('Test fingerprint override is not ready yet.');
+            return;
+        }
         setIsRunningTest(true);
-        setTestResult('Running context parallel init x3...');
+        setTestResult(`Running Frontend Prevention Test with fingerprint: ${debugFingerprintId}`);
         try {
             yield Promise.all([
-                initializeAnonymousUser(),
-                initializeAnonymousUser(),
-                initializeAnonymousUser(),
+                initializeDebugAnonymousUser(debugFingerprintId),
+                initializeDebugAnonymousUser(debugFingerprintId),
+                initializeDebugAnonymousUser(debugFingerprintId),
             ]);
-            setTestResult(`Context parallel init finished. Active fingerprint: ${fingerprintId || '--'}`);
+            setTestResult(`Frontend Prevention Test finished. Active test fingerprint: ${debugFingerprintId}`);
         }
         catch (testError) {
-            setTestResult(`Context parallel init failed: ${formatErrorMessage(testError)}`);
+            setTestResult(`Frontend Prevention Test failed: ${formatErrorMessage(testError)}`);
         }
         finally {
             setIsRunningTest(false);
         }
     });
+    const initializeDebugAnonymousUser = (debugFingerprintId) => __awaiter(this, void 0, void 0, function* () {
+        if (isInitializingDebugAnonymousUserRef.current) {
+            return;
+        }
+        try {
+            isInitializingDebugAnonymousUserRef.current = true;
+            const fingerprintHeaders = yield createFingerprintHeaders();
+            const response = yield fetch('/api/user/anonymous/init', {
+                method: 'POST',
+                headers: Object.assign(Object.assign({ 'Content-Type': 'application/json', [FINGERPRINT_SOURCE_REFER]: document.referrer || '' }, fingerprintHeaders), { 'x-fingerprint-id-v8': debugFingerprintId }),
+                body: JSON.stringify({ fingerprintId: debugFingerprintId }),
+            });
+            if (!response.ok) {
+                const errorData = yield response.json().catch(() => ({}));
+                throw new Error(errorData.error || 'Failed to initialize anonymous user');
+            }
+            yield response.json().catch(() => ({}));
+        }
+        finally {
+            isInitializingDebugAnonymousUserRef.current = false;
+        }
+    });
     const runRawParallelPostTest = () => __awaiter(this, void 0, void 0, function* () {
-        const normalizedFingerprintId = testFingerprintId.trim();
+        const normalizedFingerprintId = activeDebugFingerprintId;
         if (!normalizedFingerprintId) {
-            setTestResult('Please input a valid test fingerprint id.');
+            setTestResult('Test fingerprint override is not ready yet.');
             return;
         }
         setIsRunningTest(true);
-        setTestResult(`Running raw POST x3 with fingerprint: ${normalizedFingerprintId}`);
+        setTestResult(`Running Backend Idempotency Test with fingerprint: ${normalizedFingerprintId}`);
         try {
             const fingerprintHeaders = yield createFingerprintHeaders();
             const requests = Array.from({ length: 3 }, () => fetch('/api/user/anonymous/init', {
@@ -195,7 +227,7 @@ function FingerprintStatus() {
                 .filter((payload) => !payload.ok)
                 .map((payload) => `${payload.status}${payload.error ? `:${payload.error}` : ''}`);
             setTestResult([
-                `Raw POST x3 done.`,
+                `Backend Idempotency Test done.`,
                 `created=${createdUserIds.length}`,
                 `reused=${reusedUserIds.length}`,
                 `failed=${failedStatuses.length}`,
@@ -204,31 +236,17 @@ function FingerprintStatus() {
             ].filter(Boolean).join('\n'));
         }
         catch (testError) {
-            setTestResult(`Raw POST test failed: ${formatErrorMessage(testError)}`);
+            setTestResult(`Backend Idempotency Test failed: ${formatErrorMessage(testError)}`);
         }
         finally {
             setIsRunningTest(false);
         }
     });
-    const applyTestFingerprintAndReload = () => {
-        const normalizedFingerprintId = testFingerprintId.trim();
-        if (!normalizedFingerprintId) {
-            setTestResult('Please input a valid test fingerprint id before applying.');
-            return;
-        }
-        try {
-            setFingerprintId(normalizedFingerprintId);
-            setTestResult(`Applied test fingerprint and reloading: ${normalizedFingerprintId}`);
-            window.location.reload();
-        }
-        catch (testError) {
-            setTestResult(`Apply test fingerprint failed: ${formatErrorMessage(testError)}`);
-        }
-    };
     const regenerateTestFingerprint = () => {
         const nextFingerprintId = buildDebugFingerprintId();
-        setTestFingerprintId(nextFingerprintId);
-        setTestResult(`Generated test fingerprint: ${nextFingerprintId}`);
+        setDebugFingerprintOverride(nextFingerprintId);
+        setActiveDebugFingerprintId(nextFingerprintId);
+        setTestResult(`Generated test fingerprint override: ${nextFingerprintId}`);
     };
     return (jsxs(Fragment, { children: [!isOpen && (jsx("button", { onClick: handleToggle, type: "button", "aria-label": "Fingerprint debug panel", className: cn('fixed left-2 top-2 md:left-2 md:top-3 z-10000 inline-flex size-8 md:size-11 items-center justify-center rounded-full', themeButtonGradientClass, themeButtonGradientHoverClass, 'text-white rounded-full shadow-lg hover:shadow-xl transition-all duration-300'), children: jsx(globalLucideIcons.Lightbulb, { className: "size-6 text-white" }) })), isOpen && (jsxs(Fragment, { children: [jsx("div", { onClick: handleBackdropClick, className: "fixed inset-0 z-9998 bg-black/60 backdrop-blur-sm" }), jsxs("div", { ref: modalRef, className: cn('fixed inset-3 z-9999 mx-auto w-[min(95vw,520px)] overflow-y-auto rounded-2xl border', 'border-slate-200/70 bg-white/95 p-4 shadow-2xl backdrop-blur-sm', 'font-sans text-sm text-slate-700 dark:border-white/12 dark:bg-slate-950/95 dark:text-slate-200', 'sm:inset-auto md:left-2 sm:top-1 md:right-auto sm:w-[min(520px,95vw)] sm:p-5'), children: [jsx("header", { className: "mb-4", children: jsxs("div", { className: "flex items-start justify-between gap-3", children: [jsxs("div", { className: cn("flex items-center gap-2 text-base font-bold tracking-wider", themeIconColor), children: [jsx(globalLucideIcons.ShieldUser, { className: "size-4" }), "Fingerprint Debug Panel"] }), jsxs("div", { className: "flex items-center gap-2", children: [jsxs("button", { type: "button", onClick: () => setPanelMode((prev) => prev === 'info' ? 'test' : 'info'), className: cn('inline-flex items-center gap-2 rounded-full border px-2 py-1 text-[11px] font-semibold shadow-sm transition-all duration-200', panelMode === 'test'
                                                         ? cn('border-transparent text-white', themeButtonGradientClass, themeButtonGradientHoverClass)
@@ -252,7 +270,7 @@ function FingerprintStatus() {
                                                     { label: 'SubID', value: jsx(CopyableText, { text: (xSubscription === null || xSubscription === void 0 ? void 0 : xSubscription.paySubscriptionId) || '' }) },
                                                     { label: 'OrderID', value: jsx(CopyableText, { text: (xSubscription === null || xSubscription === void 0 ? void 0 : xSubscription.orderId) || '' }) },
                                                     { label: 'PriceID', value: jsx(CopyableText, { text: (xSubscription === null || xSubscription === void 0 ? void 0 : xSubscription.priceId) || '' }) },
-                                                ] })] })) : (jsxs("div", { className: "space-y-3 rounded-xl border border-slate-200/70 bg-white/85 p-4 shadow-sm dark:border-white/12 dark:bg-slate-900/45", children: [jsx(PanelHeader, { icon: jsx(globalLucideIcons.DatabaseZap, { className: "size-4" }), title: "Concurrent Base Info", rightInfo: jsx(StatusTag, { value: isRunningTest ? 'pending' : 'idle' }) }), jsxs("div", { className: "space-y-2 text-xs text-slate-500 dark:text-slate-300", children: [jsxs("div", { className: "flex items-center justify-between gap-3", children: [jsx("span", { className: "text-slate-400 dark:text-slate-500", children: "Current Browser" }), jsx(CopyableText, { text: fingerprintId || '' })] }), jsxs("div", { className: "space-y-1", children: [jsx("span", { className: "text-slate-400 dark:text-slate-500", children: "Generate New" }), jsxs("div", { className: "flex items-center gap-2 py-1", children: [jsx("input", { value: testFingerprintId, onChange: (e) => setTestFingerprintId(e.target.value), className: "min-w-0 flex-1 rounded-lg border border-slate-200 bg-white px-3 py-2 font-mono text-[0.5rem] sm:text-[0.625rem] md:text-xs leading-tight text-slate-700 outline-none transition focus:border-slate-400 dark:border-white/10 dark:bg-slate-950 dark:text-slate-100", placeholder: "fp_test_dbg_20260322_xxx" }), jsx("button", { type: "button", disabled: isRunningTest, onClick: regenerateTestFingerprint, "aria-label": "Generate new test fingerprint", className: "inline-flex size-9 items-center justify-center rounded-lg border border-slate-200 bg-slate-50 text-slate-700 transition hover:border-slate-300 hover:bg-slate-100 disabled:cursor-not-allowed disabled:opacity-50 dark:border-white/10 dark:bg-slate-950 dark:text-slate-100 dark:hover:bg-slate-900", children: jsx(globalLucideIcons.RefreshCcw, { className: "size-4" }) }), jsx("button", { type: "button", disabled: isRunningTest, onClick: applyTestFingerprintAndReload, "aria-label": "Apply test fingerprint", className: "inline-flex size-9 items-center justify-center rounded-lg border border-slate-200 bg-slate-50 text-slate-700 transition hover:border-slate-300 hover:bg-slate-100 disabled:cursor-not-allowed disabled:opacity-50 dark:border-white/10 dark:bg-slate-950 dark:text-slate-100 dark:hover:bg-slate-900", children: jsx(globalLucideIcons.CheckCheck, { className: "size-4" }) })] })] })] }), jsxs("div", { className: "grid grid-cols-1 gap-2 sm:grid-cols-2", children: [jsx("button", { type: "button", disabled: isRunningTest, onClick: runContextParallelInitTest, className: cn('shrink-0 rounded-full border px-3 py-2 text-xs font-semibold transition-all duration-200 disabled:cursor-not-allowed disabled:opacity-50', themedGhostButtonClass), children: "Frontend Prevention Test" }), jsx("button", { type: "button", disabled: isRunningTest, onClick: runRawParallelPostTest, className: cn('shrink-0 rounded-full border px-3 py-2 text-xs font-semibold text-white shadow-sm transition-all duration-200 disabled:cursor-not-allowed disabled:opacity-50', 'border-transparent', themeButtonGradientClass, themeButtonGradientHoverClass), children: "Backend Idempotency Test" })] }), jsx("div", { className: "rounded-lg border border-dashed border-slate-200 bg-slate-50/80 p-3 dark:border-white/10 dark:bg-slate-950/50", children: jsx("pre", { className: "overflow-x-auto whitespace-pre-wrap break-all font-mono text-[11px] leading-5 text-slate-600 dark:text-slate-300", children: testResult || 'No test executed yet.' }) })] })), error && (jsxs("div", { className: "flex items-start justify-between gap-3 rounded-xl border border-amber-200 bg-amber-50 p-3 text-xs text-amber-600 shadow-sm dark:border-amber-500/40 dark:bg-amber-500/10 dark:text-amber-200", children: [jsxs("div", { className: "flex items-start gap-2", children: [jsx(globalLucideIcons.X, { className: "mt-0.5 size-4 shrink-0" }), jsx("span", { children: error })] }), jsx("button", { type: "button", "aria-label": "Dismiss error", onClick: clearError, className: "shrink-0 rounded-full p-1 text-amber-500 transition hover:bg-amber-100 hover:text-amber-700 dark:text-amber-200 dark:hover:bg-amber-500/10 dark:hover:text-amber-100", children: jsx(globalLucideIcons.X, { className: "size-4" }) })] }))] })] })] }))] }));
+                                                ] })] })) : (jsxs("div", { className: "space-y-3 rounded-xl border border-slate-200/70 bg-white/85 p-4 shadow-sm dark:border-white/12 dark:bg-slate-900/45", children: [jsx(PanelHeader, { icon: jsx(globalLucideIcons.DatabaseZap, { className: "size-4" }), title: "Concurrent Base Info", rightInfo: jsx(StatusTag, { value: isRunningTest ? 'pending' : 'idle' }) }), jsxs("div", { className: "space-y-2 text-xs text-slate-500 dark:text-slate-300", children: [jsxs("div", { className: "flex items-center justify-between gap-3", children: [jsx("span", { className: "text-slate-400 dark:text-slate-500", children: "Real Browser" }), jsx(CopyableText, { text: fingerprintId || '' })] }), jsxs("div", { className: "space-y-1", children: [jsx("span", { className: "text-slate-400 dark:text-slate-500", children: "Test Override" }), jsxs("div", { className: "flex items-center gap-2 py-1", children: [jsx("div", { className: "min-w-0 flex-1 rounded-lg border border-slate-200 bg-white px-3 py-2 font-mono text-[0.5rem] sm:text-[0.625rem] md:text-xs leading-tight text-slate-700 dark:border-white/10 dark:bg-slate-950 dark:text-slate-100", children: jsx(CopyableText, { text: activeDebugFingerprintId || '' }) }), jsx("button", { type: "button", disabled: isRunningTest, onClick: regenerateTestFingerprint, "aria-label": "Generate new test fingerprint", className: "inline-flex size-9 items-center justify-center rounded-lg border border-slate-200 bg-slate-50 text-slate-700 transition hover:border-slate-300 hover:bg-slate-100 disabled:cursor-not-allowed disabled:opacity-50 dark:border-white/10 dark:bg-slate-950 dark:text-slate-100 dark:hover:bg-slate-900", children: jsx(globalLucideIcons.RefreshCcw, { className: "size-4" }) })] })] })] }), jsxs("div", { className: "grid grid-cols-1 gap-2 sm:grid-cols-2", children: [jsx("button", { type: "button", disabled: isRunningTest, onClick: runContextParallelInitTest, className: cn('shrink-0 rounded-full border px-3 py-2 text-xs font-semibold transition-all duration-200 disabled:cursor-not-allowed disabled:opacity-50', themedGhostButtonClass), children: "Frontend Prevention Test" }), jsx("button", { type: "button", disabled: isRunningTest, onClick: runRawParallelPostTest, className: cn('shrink-0 rounded-full border px-3 py-2 text-xs font-semibold text-white shadow-sm transition-all duration-200 disabled:cursor-not-allowed disabled:opacity-50', 'border-transparent', themeButtonGradientClass, themeButtonGradientHoverClass), children: "Backend Idempotency Test" })] }), jsx("div", { className: "rounded-lg border border-dashed border-slate-200 bg-slate-50/80 p-3 dark:border-white/10 dark:bg-slate-950/50", children: jsx("pre", { className: "overflow-x-auto whitespace-pre-wrap break-all font-mono text-[11px] leading-5 text-slate-600 dark:text-slate-300", children: testResult || 'No test executed yet.' }) })] })), error && (jsxs("div", { className: "flex items-start justify-between gap-3 rounded-xl border border-amber-200 bg-amber-50 p-3 text-xs text-amber-600 shadow-sm dark:border-amber-500/40 dark:bg-amber-500/10 dark:text-amber-200", children: [jsxs("div", { className: "flex items-start gap-2", children: [jsx(globalLucideIcons.X, { className: "mt-0.5 size-4 shrink-0" }), jsx("span", { children: error })] }), jsx("button", { type: "button", "aria-label": "Dismiss error", onClick: clearError, className: "shrink-0 rounded-full p-1 text-amber-500 transition hover:bg-amber-100 hover:text-amber-700 dark:text-amber-200 dark:hover:bg-amber-500/10 dark:hover:text-amber-100", children: jsx(globalLucideIcons.X, { className: "size-4" }) })] }))] })] })] }))] }));
 }
 /* ==================== 新增辅助组件 ==================== */
 // 标题行：左侧图标+标题，右侧信息（右对齐）

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

@@ -3,6 +3,7 @@
  * 客户端和服务端共享的常量、类型和验证逻辑
  */
 export declare const FINGERPRINT_STORAGE_KEY = "__x_fingerprint_id";
+export declare const FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY = "__x_fingerprint_debug_override";
 export declare const FINGERPRINT_HEADER_NAME = "x-fingerprint-id-v8";
 export declare const FINGERPRINT_COOKIE_NAME = "__x_fingerprint_id";
 export declare const FINGERPRINT_SOURCE_REFER = "x-source-ref";
@@ -16,6 +17,7 @@ export declare const FINGERPRINT_FIRST_TOUCH_HEADER = "x-first-touch";
 export declare function isValidFingerprintId(fingerprintId: string): boolean;
 export declare const FINGERPRINT_CONSTANTS: {
     readonly STORAGE_KEY: "__x_fingerprint_id";
+    readonly DEBUG_OVERRIDE_STORAGE_KEY: "__x_fingerprint_debug_override";
     readonly HEADER_NAME: "x-fingerprint-id-v8";
     readonly COOKIE_NAME: "__x_fingerprint_id";
     readonly FIRST_TOUCH_STORAGE_KEY: "__x_first_touch";

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

@@ -6,6 +6,7 @@
  */
 // Fingerprint ID的存储键和header名
 const FINGERPRINT_STORAGE_KEY = '__x_fingerprint_id';
+const FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY = '__x_fingerprint_debug_override';
 const FINGERPRINT_HEADER_NAME = 'x-fingerprint-id-v8';
 const FINGERPRINT_COOKIE_NAME = '__x_fingerprint_id';
 const FINGERPRINT_SOURCE_REFER = 'x-source-ref';
@@ -28,6 +29,7 @@ function isValidFingerprintId(fingerprintId) {
 // 常量导出
 const FINGERPRINT_CONSTANTS = {
     STORAGE_KEY: FINGERPRINT_STORAGE_KEY,
+    DEBUG_OVERRIDE_STORAGE_KEY: FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY,
     HEADER_NAME: FINGERPRINT_HEADER_NAME,
     COOKIE_NAME: FINGERPRINT_COOKIE_NAME,
     FIRST_TOUCH_STORAGE_KEY: FINGERPRINT_FIRST_TOUCH_STORAGE_KEY,
@@ -37,6 +39,7 @@ const FINGERPRINT_CONSTANTS = {
 
 exports.FINGERPRINT_CONSTANTS = FINGERPRINT_CONSTANTS;
 exports.FINGERPRINT_COOKIE_NAME = FINGERPRINT_COOKIE_NAME;
+exports.FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY = FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY;
 exports.FINGERPRINT_FIRST_TOUCH_COOKIE_NAME = FINGERPRINT_FIRST_TOUCH_COOKIE_NAME;
 exports.FINGERPRINT_FIRST_TOUCH_HEADER = FINGERPRINT_FIRST_TOUCH_HEADER;
 exports.FINGERPRINT_FIRST_TOUCH_STORAGE_KEY = FINGERPRINT_FIRST_TOUCH_STORAGE_KEY;

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

@@ -4,6 +4,7 @@
  */
 // Fingerprint ID的存储键和header名
 const FINGERPRINT_STORAGE_KEY = '__x_fingerprint_id';
+const FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY = '__x_fingerprint_debug_override';
 const FINGERPRINT_HEADER_NAME = 'x-fingerprint-id-v8';
 const FINGERPRINT_COOKIE_NAME = '__x_fingerprint_id';
 const FINGERPRINT_SOURCE_REFER = 'x-source-ref';
@@ -26,6 +27,7 @@ function isValidFingerprintId(fingerprintId) {
 // 常量导出
 const FINGERPRINT_CONSTANTS = {
     STORAGE_KEY: FINGERPRINT_STORAGE_KEY,
+    DEBUG_OVERRIDE_STORAGE_KEY: FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY,
     HEADER_NAME: FINGERPRINT_HEADER_NAME,
     COOKIE_NAME: FINGERPRINT_COOKIE_NAME,
     FIRST_TOUCH_STORAGE_KEY: FINGERPRINT_FIRST_TOUCH_STORAGE_KEY,
@@ -33,4 +35,4 @@ const FINGERPRINT_CONSTANTS = {
     FIRST_TOUCH_HEADER: FINGERPRINT_FIRST_TOUCH_HEADER,
 };
 
-export { FINGERPRINT_CONSTANTS, FINGERPRINT_COOKIE_NAME, FINGERPRINT_FIRST_TOUCH_COOKIE_NAME, FINGERPRINT_FIRST_TOUCH_HEADER, FINGERPRINT_FIRST_TOUCH_STORAGE_KEY, FINGERPRINT_HEADER_NAME, FINGERPRINT_SOURCE_REFER, FINGERPRINT_STORAGE_KEY, isValidFingerprintId };
+export { FINGERPRINT_CONSTANTS, FINGERPRINT_COOKIE_NAME, FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY, FINGERPRINT_FIRST_TOUCH_COOKIE_NAME, FINGERPRINT_FIRST_TOUCH_HEADER, FINGERPRINT_FIRST_TOUCH_STORAGE_KEY, FINGERPRINT_HEADER_NAME, FINGERPRINT_SOURCE_REFER, FINGERPRINT_STORAGE_KEY, isValidFingerprintId };

package/dist/clerk/fingerprint/index.js

@@ -10,6 +10,7 @@ var fingerprintProvider = require('./fingerprint-provider.js');
 
 exports.FINGERPRINT_CONSTANTS = fingerprintShared.FINGERPRINT_CONSTANTS;
 exports.FINGERPRINT_COOKIE_NAME = fingerprintShared.FINGERPRINT_COOKIE_NAME;
+exports.FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY = fingerprintShared.FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY;
 exports.FINGERPRINT_FIRST_TOUCH_COOKIE_NAME = fingerprintShared.FINGERPRINT_FIRST_TOUCH_COOKIE_NAME;
 exports.FINGERPRINT_FIRST_TOUCH_HEADER = fingerprintShared.FINGERPRINT_FIRST_TOUCH_HEADER;
 exports.FINGERPRINT_FIRST_TOUCH_STORAGE_KEY = fingerprintShared.FINGERPRINT_FIRST_TOUCH_STORAGE_KEY;

package/dist/clerk/fingerprint/index.mjs

@@ -1,5 +1,5 @@
 "use client";
-export { FINGERPRINT_CONSTANTS, FINGERPRINT_COOKIE_NAME, FINGERPRINT_FIRST_TOUCH_COOKIE_NAME, FINGERPRINT_FIRST_TOUCH_HEADER, FINGERPRINT_FIRST_TOUCH_STORAGE_KEY, FINGERPRINT_HEADER_NAME, FINGERPRINT_SOURCE_REFER, FINGERPRINT_STORAGE_KEY, isValidFingerprintId } from './fingerprint-shared.mjs';
+export { FINGERPRINT_CONSTANTS, FINGERPRINT_COOKIE_NAME, FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY, FINGERPRINT_FIRST_TOUCH_COOKIE_NAME, FINGERPRINT_FIRST_TOUCH_HEADER, FINGERPRINT_FIRST_TOUCH_STORAGE_KEY, FINGERPRINT_HEADER_NAME, FINGERPRINT_SOURCE_REFER, FINGERPRINT_STORAGE_KEY, isValidFingerprintId } from './fingerprint-shared.mjs';
 export { clearFingerprintId, createFingerprintFetch, createFingerprintHeaders, generateFingerprintId, getFingerprintId, getOrCreateFirstTouchData, getOrGenerateFingerprintId, setFingerprintId, useFingerprintHeaders } from './fingerprint-client.mjs';
 export { useFingerprint } from './use-fingerprint.mjs';
 export { FingerprintProvider, FingerprintStatus, useFingerprintContext, useFingerprintContextSafe, withFingerprint } from './fingerprint-provider.mjs';

package/dist/clerk/fingerprint/server.js

@@ -7,6 +7,7 @@ var fingerprintServer = require('./fingerprint-server.js');
 
 exports.FINGERPRINT_CONSTANTS = fingerprintShared.FINGERPRINT_CONSTANTS;
 exports.FINGERPRINT_COOKIE_NAME = fingerprintShared.FINGERPRINT_COOKIE_NAME;
+exports.FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY = fingerprintShared.FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY;
 exports.FINGERPRINT_FIRST_TOUCH_COOKIE_NAME = fingerprintShared.FINGERPRINT_FIRST_TOUCH_COOKIE_NAME;
 exports.FINGERPRINT_FIRST_TOUCH_HEADER = fingerprintShared.FINGERPRINT_FIRST_TOUCH_HEADER;
 exports.FINGERPRINT_FIRST_TOUCH_STORAGE_KEY = fingerprintShared.FINGERPRINT_FIRST_TOUCH_STORAGE_KEY;

package/dist/clerk/fingerprint/server.mjs

@@ -1,2 +1,2 @@
-export { FINGERPRINT_CONSTANTS, FINGERPRINT_COOKIE_NAME, FINGERPRINT_FIRST_TOUCH_COOKIE_NAME, FINGERPRINT_FIRST_TOUCH_HEADER, FINGERPRINT_FIRST_TOUCH_STORAGE_KEY, FINGERPRINT_HEADER_NAME, FINGERPRINT_SOURCE_REFER, FINGERPRINT_STORAGE_KEY, isValidFingerprintId } from './fingerprint-shared.mjs';
+export { FINGERPRINT_CONSTANTS, FINGERPRINT_COOKIE_NAME, FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY, FINGERPRINT_FIRST_TOUCH_COOKIE_NAME, FINGERPRINT_FIRST_TOUCH_HEADER, FINGERPRINT_FIRST_TOUCH_STORAGE_KEY, FINGERPRINT_HEADER_NAME, FINGERPRINT_SOURCE_REFER, FINGERPRINT_STORAGE_KEY, isValidFingerprintId } from './fingerprint-shared.mjs';
 export { extractFingerprintFromNextRequest, extractFingerprintFromNextStores, extractFingerprintId, generateServerFingerprintId } from './fingerprint-server.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windrun-huaiin/third-ui",
-  "version": "14.1.1",
+  "version": "14.2.0",
   "description": "Third-party integrated UI components for windrun-huaiin projects",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -86,8 +86,8 @@
     "react-medium-image-zoom": "^5.4.1",
     "swiper": "^12.1.2",
     "zod": "^4.3.6",
-    "@windrun-huaiin/base-ui": "^14.0.2",
-    "@windrun-huaiin/lib": "^14.0.0"
+    "@windrun-huaiin/base-ui": "^14.0.3",
+    "@windrun-huaiin/lib": "^14.0.1"
   },
   "peerDependencies": {
     "clsx": "^2.1.1",

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

@@ -0,0 +1,47 @@
+'use client';
+
+import {
+  FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY,
+  isValidFingerprintId,
+} from './fingerprint-shared';
+
+function getLocalStorageValue(key: string): string | null {
+  if (typeof window === 'undefined') {
+    return null;
+  }
+
+  try {
+    return window.localStorage.getItem(key);
+  } catch {
+    return null;
+  }
+}
+
+function setLocalStorageValue(key: string, value: string): void {
+  if (typeof window === 'undefined') {
+    return;
+  }
+
+  try {
+    window.localStorage.setItem(key, value);
+  } catch {
+    // Ignore storage failures in debug helpers.
+  }
+}
+
+export function getDebugFingerprintOverride(): string | null {
+  const value = getLocalStorageValue(FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY);
+  if (!value || !isValidFingerprintId(value)) {
+    return null;
+  }
+
+  return value;
+}
+
+export function setDebugFingerprintOverride(fingerprintId: string): void {
+  if (!isValidFingerprintId(fingerprintId)) {
+    throw new Error('Invalid fingerprint ID');
+  }
+
+  setLocalStorageValue(FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY, fingerprintId);
+}

package/src/clerk/fingerprint/fingerprint-provider.tsx

@@ -7,7 +7,11 @@ import React, { createContext, useContext, useEffect, useMemo, useRef, useState
 import type { FingerprintContextType, FingerprintProviderProps } from './types';
 import { useFingerprint } from './use-fingerprint';
 import { CopyableText } from '@windrun-huaiin/base-ui/ui';
-import { createFingerprintHeaders, setFingerprintId } from './fingerprint-client';
+import { createFingerprintHeaders } from './fingerprint-client';
+import {
+  getDebugFingerprintOverride,
+  setDebugFingerprintOverride,
+} from './fingerprint-debug';
 import { FINGERPRINT_SOURCE_REFER } from './fingerprint-shared';
 
 const FingerprintContext = createContext<FingerprintContextType | undefined>(undefined);
@@ -77,15 +81,15 @@ export function FingerprintStatus() {
     xSubscription,
     error,
     clearError,
-    initializeAnonymousUser,
   } = useFingerprintContext();
 
   const [isOpen, setIsOpen] = useState(false);
   const [panelMode, setPanelMode] = useState<'info' | 'test'>('info');
-  const [testFingerprintId, setTestFingerprintId] = useState('');
   const [testResult, setTestResult] = useState<string>('');
   const [isRunningTest, setIsRunningTest] = useState(false);
   const modalRef = useRef<HTMLDivElement>(null);
+  const isInitializingDebugAnonymousUserRef = useRef(false);
+  const [activeDebugFingerprintId, setActiveDebugFingerprintId] = useState<string | null>(null);
 
   const handleToggle = () => setIsOpen(prev => !prev);
 
@@ -108,13 +112,16 @@ export function FingerprintStatus() {
   }, [xUser]);
 
   useEffect(() => {
-    if (testFingerprintId) {
+    const debugFingerprintOverride = getDebugFingerprintOverride();
+    if (debugFingerprintOverride) {
+      setActiveDebugFingerprintId(debugFingerprintOverride);
       return;
     }
 
-    const defaultFingerprintId = buildDebugFingerprintId();
-    setTestFingerprintId(defaultFingerprintId);
-  }, [testFingerprintId]);
+    const nextFingerprintId = buildDebugFingerprintId();
+    setDebugFingerprintOverride(nextFingerprintId);
+    setActiveDebugFingerprintId(nextFingerprintId);
+  }, []);
 
   const creditBuckets = useMemo(() => {
     if (!xCredit) return [];
@@ -178,32 +185,69 @@ export function FingerprintStatus() {
   );
 
   const runContextParallelInitTest = async () => {
+    const debugFingerprintId = activeDebugFingerprintId;
+    if (!debugFingerprintId) {
+      setTestResult('Test fingerprint override is not ready yet.');
+      return;
+    }
+
     setIsRunningTest(true);
-    setTestResult('Running context parallel init x3...');
+    setTestResult(`Running Frontend Prevention Test with fingerprint: ${debugFingerprintId}`);
 
     try {
       await Promise.all([
-        initializeAnonymousUser(),
-        initializeAnonymousUser(),
-        initializeAnonymousUser(),
+        initializeDebugAnonymousUser(debugFingerprintId),
+        initializeDebugAnonymousUser(debugFingerprintId),
+        initializeDebugAnonymousUser(debugFingerprintId),
       ]);
-      setTestResult(`Context parallel init finished. Active fingerprint: ${fingerprintId || '--'}`);
+      setTestResult(`Frontend Prevention Test finished. Active test fingerprint: ${debugFingerprintId}`);
     } catch (testError) {
-      setTestResult(`Context parallel init failed: ${formatErrorMessage(testError)}`);
+      setTestResult(`Frontend Prevention Test failed: ${formatErrorMessage(testError)}`);
     } finally {
       setIsRunningTest(false);
     }
   };
 
+  const initializeDebugAnonymousUser = async (debugFingerprintId: string) => {
+    if (isInitializingDebugAnonymousUserRef.current) {
+      return;
+    }
+
+    try {
+      isInitializingDebugAnonymousUserRef.current = true;
+
+      const fingerprintHeaders = await createFingerprintHeaders();
+      const response = await fetch('/api/user/anonymous/init', {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          [FINGERPRINT_SOURCE_REFER]: document.referrer || '',
+          ...fingerprintHeaders,
+          'x-fingerprint-id-v8': debugFingerprintId,
+        },
+        body: JSON.stringify({ fingerprintId: debugFingerprintId }),
+      });
+
+      if (!response.ok) {
+        const errorData = await response.json().catch(() => ({}));
+        throw new Error(errorData.error || 'Failed to initialize anonymous user');
+      }
+
+      await response.json().catch(() => ({}));
+    } finally {
+      isInitializingDebugAnonymousUserRef.current = false;
+    }
+  };
+
   const runRawParallelPostTest = async () => {
-    const normalizedFingerprintId = testFingerprintId.trim();
+    const normalizedFingerprintId = activeDebugFingerprintId;
     if (!normalizedFingerprintId) {
-      setTestResult('Please input a valid test fingerprint id.');
+      setTestResult('Test fingerprint override is not ready yet.');
       return;
     }
 
     setIsRunningTest(true);
-    setTestResult(`Running raw POST x3 with fingerprint: ${normalizedFingerprintId}`);
+    setTestResult(`Running Backend Idempotency Test with fingerprint: ${normalizedFingerprintId}`);
 
     try {
       const fingerprintHeaders = await createFingerprintHeaders();
@@ -243,7 +287,7 @@ export function FingerprintStatus() {
 
       setTestResult(
         [
-          `Raw POST x3 done.`,
+          `Backend Idempotency Test done.`,
           `created=${createdUserIds.length}`,
           `reused=${reusedUserIds.length}`,
           `failed=${failedStatuses.length}`,
@@ -252,32 +296,17 @@ export function FingerprintStatus() {
         ].filter(Boolean).join('\n')
       );
     } catch (testError) {
-      setTestResult(`Raw POST test failed: ${formatErrorMessage(testError)}`);
+      setTestResult(`Backend Idempotency Test failed: ${formatErrorMessage(testError)}`);
     } finally {
       setIsRunningTest(false);
     }
   };
 
-  const applyTestFingerprintAndReload = () => {
-    const normalizedFingerprintId = testFingerprintId.trim();
-    if (!normalizedFingerprintId) {
-      setTestResult('Please input a valid test fingerprint id before applying.');
-      return;
-    }
-
-    try {
-      setFingerprintId(normalizedFingerprintId);
-      setTestResult(`Applied test fingerprint and reloading: ${normalizedFingerprintId}`);
-      window.location.reload();
-    } catch (testError) {
-      setTestResult(`Apply test fingerprint failed: ${formatErrorMessage(testError)}`);
-    }
-  };
-
   const regenerateTestFingerprint = () => {
     const nextFingerprintId = buildDebugFingerprintId();
-    setTestFingerprintId(nextFingerprintId);
-    setTestResult(`Generated test fingerprint: ${nextFingerprintId}`);
+    setDebugFingerprintOverride(nextFingerprintId);
+    setActiveDebugFingerprintId(nextFingerprintId);
+    setTestResult(`Generated test fingerprint override: ${nextFingerprintId}`);
   };
 
   return (
@@ -442,18 +471,15 @@ export function FingerprintStatus() {
 
                   <div className="space-y-2 text-xs text-slate-500 dark:text-slate-300">
                     <div className="flex items-center justify-between gap-3">
-                      <span className="text-slate-400 dark:text-slate-500">Current Browser</span>
+                      <span className="text-slate-400 dark:text-slate-500">Real Browser</span>
                       <CopyableText text={fingerprintId || ''} />
                     </div>
                     <div className="space-y-1">
-                      <span className="text-slate-400 dark:text-slate-500">Generate New</span>
+                      <span className="text-slate-400 dark:text-slate-500">Test Override</span>
                       <div className="flex items-center gap-2 py-1">
-                        <input
-                          value={testFingerprintId}
-                          onChange={(e) => setTestFingerprintId(e.target.value)}
-                          className="min-w-0 flex-1 rounded-lg border border-slate-200 bg-white px-3 py-2 font-mono text-[0.5rem] sm:text-[0.625rem] md:text-xs leading-tight text-slate-700 outline-none transition focus:border-slate-400 dark:border-white/10 dark:bg-slate-950 dark:text-slate-100"
-                          placeholder="fp_test_dbg_20260322_xxx"
-                        />
+                        <div className="min-w-0 flex-1 rounded-lg border border-slate-200 bg-white px-3 py-2 font-mono text-[0.5rem] sm:text-[0.625rem] md:text-xs leading-tight text-slate-700 dark:border-white/10 dark:bg-slate-950 dark:text-slate-100">
+                          <CopyableText text={activeDebugFingerprintId || ''} />
+                        </div>
                         <button
                           type="button"
                           disabled={isRunningTest}
@@ -463,15 +489,6 @@ export function FingerprintStatus() {
                         >
                           <icons.RefreshCcw className="size-4" />
                         </button>
-                        <button
-                          type="button"
-                          disabled={isRunningTest}
-                          onClick={applyTestFingerprintAndReload}
-                          aria-label="Apply test fingerprint"
-                          className="inline-flex size-9 items-center justify-center rounded-lg border border-slate-200 bg-slate-50 text-slate-700 transition hover:border-slate-300 hover:bg-slate-100 disabled:cursor-not-allowed disabled:opacity-50 dark:border-white/10 dark:bg-slate-950 dark:text-slate-100 dark:hover:bg-slate-900"
-                        >
-                          <icons.CheckCheck className="size-4" />
-                        </button>
                       </div>
                     </div>
                   </div>

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

@@ -5,6 +5,7 @@
 
 // Fingerprint ID的存储键和header名
 export const FINGERPRINT_STORAGE_KEY = '__x_fingerprint_id';
+export const FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY = '__x_fingerprint_debug_override';
 export const FINGERPRINT_HEADER_NAME = 'x-fingerprint-id-v8';
 export const FINGERPRINT_COOKIE_NAME = '__x_fingerprint_id';
 export const FINGERPRINT_SOURCE_REFER = 'x-source-ref';
@@ -28,6 +29,7 @@ export function isValidFingerprintId(fingerprintId: string): boolean {
 // 常量导出
 export const FINGERPRINT_CONSTANTS = {
   STORAGE_KEY: FINGERPRINT_STORAGE_KEY,
+  DEBUG_OVERRIDE_STORAGE_KEY: FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY,
   HEADER_NAME: FINGERPRINT_HEADER_NAME,
   COOKIE_NAME: FINGERPRINT_COOKIE_NAME,
   FIRST_TOUCH_STORAGE_KEY: FINGERPRINT_FIRST_TOUCH_STORAGE_KEY,