@windrun-huaiin/third-ui 14.4.1 → 14.4.3

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

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

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

@@ -27,17 +27,39 @@ function setLocalStorageValue(key, value) {
 }
 function getDebugFingerprintOverride() {
     const value = getLocalStorageValue(fingerprintShared.FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY);
-    if (!value || !fingerprintShared.isValidFingerprintId(value)) {
+    if (!value || !fingerprintShared.isValidFingerprintId(value) || !fingerprintShared.isDebugFingerprintId(value)) {
         return null;
     }
     return value;
 }
 function setDebugFingerprintOverride(fingerprintId) {
-    if (!fingerprintShared.isValidFingerprintId(fingerprintId)) {
+    if (!fingerprintShared.isValidFingerprintId(fingerprintId) || !fingerprintShared.isDebugFingerprintId(fingerprintId)) {
         throw new Error('Invalid fingerprint ID');
     }
     setLocalStorageValue(fingerprintShared.FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY, fingerprintId);
 }
+function buildDebugFingerprintId() {
+    const timestamp = new Date().toISOString().replace(/[-:TZ.]/g, '').slice(0, 14);
+    const randomSuffix = Math.random().toString(36).slice(2, 8);
+    return `${fingerprintShared.FINGERPRINT_DEBUG_PREFIX}${timestamp}_${randomSuffix}`;
+}
+function getOrCreateDebugFingerprintOverride() {
+    const existing = getDebugFingerprintOverride();
+    if (existing) {
+        return existing;
+    }
+    const nextFingerprintId = buildDebugFingerprintId();
+    setDebugFingerprintOverride(nextFingerprintId);
+    return nextFingerprintId;
+}
+function regenerateDebugFingerprintOverride() {
+    const nextFingerprintId = buildDebugFingerprintId();
+    setDebugFingerprintOverride(nextFingerprintId);
+    return nextFingerprintId;
+}
 
+exports.buildDebugFingerprintId = buildDebugFingerprintId;
 exports.getDebugFingerprintOverride = getDebugFingerprintOverride;
+exports.getOrCreateDebugFingerprintOverride = getOrCreateDebugFingerprintOverride;
+exports.regenerateDebugFingerprintOverride = regenerateDebugFingerprintOverride;
 exports.setDebugFingerprintOverride = setDebugFingerprintOverride;

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

@@ -1,5 +1,5 @@
 "use client";
-import { isValidFingerprintId, FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY } from './fingerprint-shared.mjs';
+import { isValidFingerprintId, isDebugFingerprintId, FINGERPRINT_DEBUG_PREFIX, FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY } from './fingerprint-shared.mjs';
 
 function getLocalStorageValue(key) {
     if (typeof window === 'undefined') {
@@ -25,16 +25,35 @@ function setLocalStorageValue(key, value) {
 }
 function getDebugFingerprintOverride() {
     const value = getLocalStorageValue(FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY);
-    if (!value || !isValidFingerprintId(value)) {
+    if (!value || !isValidFingerprintId(value) || !isDebugFingerprintId(value)) {
         return null;
     }
     return value;
 }
 function setDebugFingerprintOverride(fingerprintId) {
-    if (!isValidFingerprintId(fingerprintId)) {
+    if (!isValidFingerprintId(fingerprintId) || !isDebugFingerprintId(fingerprintId)) {
         throw new Error('Invalid fingerprint ID');
     }
     setLocalStorageValue(FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY, fingerprintId);
 }
+function buildDebugFingerprintId() {
+    const timestamp = new Date().toISOString().replace(/[-:TZ.]/g, '').slice(0, 14);
+    const randomSuffix = Math.random().toString(36).slice(2, 8);
+    return `${FINGERPRINT_DEBUG_PREFIX}${timestamp}_${randomSuffix}`;
+}
+function getOrCreateDebugFingerprintOverride() {
+    const existing = getDebugFingerprintOverride();
+    if (existing) {
+        return existing;
+    }
+    const nextFingerprintId = buildDebugFingerprintId();
+    setDebugFingerprintOverride(nextFingerprintId);
+    return nextFingerprintId;
+}
+function regenerateDebugFingerprintOverride() {
+    const nextFingerprintId = buildDebugFingerprintId();
+    setDebugFingerprintOverride(nextFingerprintId);
+    return nextFingerprintId;
+}
 
-export { getDebugFingerprintOverride, setDebugFingerprintOverride };
+export { buildDebugFingerprintId, getDebugFingerprintOverride, getOrCreateDebugFingerprintOverride, regenerateDebugFingerprintOverride, setDebugFingerprintOverride };

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

@@ -81,15 +81,11 @@ function FingerprintStatus() {
         }
     }, [xUser]);
     React.useEffect(() => {
-        const debugFingerprintOverride = fingerprintDebug.getDebugFingerprintOverride();
-        if (debugFingerprintOverride) {
-            setActiveDebugFingerprintId(debugFingerprintOverride);
+        if (panelMode !== 'test') {
             return;
         }
-        const nextFingerprintId = buildDebugFingerprintId();
-        fingerprintDebug.setDebugFingerprintOverride(nextFingerprintId);
-        setActiveDebugFingerprintId(nextFingerprintId);
-    }, []);
+        setActiveDebugFingerprintId((current) => current !== null && current !== void 0 ? current : fingerprintDebug.getOrCreateDebugFingerprintOverride());
+    }, [panelMode]);
     const creditBuckets = React.useMemo(() => {
         if (!xCredit)
             return [];
@@ -147,11 +143,12 @@ 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;
+        const debugFingerprintId = activeDebugFingerprintId !== null && activeDebugFingerprintId !== void 0 ? activeDebugFingerprintId : fingerprintDebug.getOrCreateDebugFingerprintOverride();
         if (!debugFingerprintId) {
             setTestResult('Test fingerprint override is not ready yet.');
             return;
         }
+        setActiveDebugFingerprintId(debugFingerprintId);
         setIsRunningTest(true);
         setTestResult(`Running Frontend Prevention Test with fingerprint: ${debugFingerprintId}`);
         try {
@@ -192,11 +189,12 @@ function FingerprintStatus() {
         }
     });
     const runRawParallelPostTest = () => tslib_es6.__awaiter(this, void 0, void 0, function* () {
-        const normalizedFingerprintId = activeDebugFingerprintId;
+        const normalizedFingerprintId = activeDebugFingerprintId !== null && activeDebugFingerprintId !== void 0 ? activeDebugFingerprintId : fingerprintDebug.getOrCreateDebugFingerprintOverride();
         if (!normalizedFingerprintId) {
             setTestResult('Test fingerprint override is not ready yet.');
             return;
         }
+        setActiveDebugFingerprintId(normalizedFingerprintId);
         setIsRunningTest(true);
         setTestResult(`Running Backend Idempotency Test with fingerprint: ${normalizedFingerprintId}`);
         try {
@@ -245,8 +243,7 @@ function FingerprintStatus() {
         }
     });
     const regenerateTestFingerprint = () => {
-        const nextFingerprintId = buildDebugFingerprintId();
-        fingerprintDebug.setDebugFingerprintOverride(nextFingerprintId);
+        const nextFingerprintId = fingerprintDebug.regenerateDebugFingerprintOverride();
         setActiveDebugFingerprintId(nextFingerprintId);
         setTestResult(`Generated test fingerprint override: ${nextFingerprintId}`);
     };
@@ -338,11 +335,6 @@ function StatusTag({ value }) {
     const badgeClass = colorMap[normalized] || defaultColor;
     return (jsxRuntime.jsx("span", { className: utils.cn('inline-block rounded-full px-2 py-0.5 text-xs capitalize font-medium', badgeClass), children: value }));
 }
-function buildDebugFingerprintId() {
-    const timestamp = new Date().toISOString().replace(/[-:TZ.]/g, '').slice(0, 14);
-    const randomSuffix = Math.random().toString(36).slice(2, 8);
-    return `fp_test_dbg_${timestamp}_${randomSuffix}`;
-}
 function formatErrorMessage(error) {
     if (error instanceof Error) {
         return error.message;

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

@@ -8,7 +8,7 @@ import { createContext, useContext, useState, useRef, useEffect, useMemo } from
 import { useFingerprint } from './use-fingerprint.mjs';
 import { CopyableText } from '@windrun-huaiin/base-ui/ui';
 import { createFingerprintHeaders } from './fingerprint-client.mjs';
-import { getDebugFingerprintOverride, setDebugFingerprintOverride } from './fingerprint-debug.mjs';
+import { getOrCreateDebugFingerprintOverride, regenerateDebugFingerprintOverride } from './fingerprint-debug.mjs';
 import { FINGERPRINT_SOURCE_REFER } from './fingerprint-shared.mjs';
 
 const FingerprintContext = createContext(undefined);
@@ -79,15 +79,11 @@ function FingerprintStatus() {
         }
     }, [xUser]);
     useEffect(() => {
-        const debugFingerprintOverride = getDebugFingerprintOverride();
-        if (debugFingerprintOverride) {
-            setActiveDebugFingerprintId(debugFingerprintOverride);
+        if (panelMode !== 'test') {
             return;
         }
-        const nextFingerprintId = buildDebugFingerprintId();
-        setDebugFingerprintOverride(nextFingerprintId);
-        setActiveDebugFingerprintId(nextFingerprintId);
-    }, []);
+        setActiveDebugFingerprintId((current) => current !== null && current !== void 0 ? current : getOrCreateDebugFingerprintOverride());
+    }, [panelMode]);
     const creditBuckets = useMemo(() => {
         if (!xCredit)
             return [];
@@ -145,11 +141,12 @@ 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;
+        const debugFingerprintId = activeDebugFingerprintId !== null && activeDebugFingerprintId !== void 0 ? activeDebugFingerprintId : getOrCreateDebugFingerprintOverride();
         if (!debugFingerprintId) {
             setTestResult('Test fingerprint override is not ready yet.');
             return;
         }
+        setActiveDebugFingerprintId(debugFingerprintId);
         setIsRunningTest(true);
         setTestResult(`Running Frontend Prevention Test with fingerprint: ${debugFingerprintId}`);
         try {
@@ -190,11 +187,12 @@ function FingerprintStatus() {
         }
     });
     const runRawParallelPostTest = () => __awaiter(this, void 0, void 0, function* () {
-        const normalizedFingerprintId = activeDebugFingerprintId;
+        const normalizedFingerprintId = activeDebugFingerprintId !== null && activeDebugFingerprintId !== void 0 ? activeDebugFingerprintId : getOrCreateDebugFingerprintOverride();
         if (!normalizedFingerprintId) {
             setTestResult('Test fingerprint override is not ready yet.');
             return;
         }
+        setActiveDebugFingerprintId(normalizedFingerprintId);
         setIsRunningTest(true);
         setTestResult(`Running Backend Idempotency Test with fingerprint: ${normalizedFingerprintId}`);
         try {
@@ -243,8 +241,7 @@ function FingerprintStatus() {
         }
     });
     const regenerateTestFingerprint = () => {
-        const nextFingerprintId = buildDebugFingerprintId();
-        setDebugFingerprintOverride(nextFingerprintId);
+        const nextFingerprintId = regenerateDebugFingerprintOverride();
         setActiveDebugFingerprintId(nextFingerprintId);
         setTestResult(`Generated test fingerprint override: ${nextFingerprintId}`);
     };
@@ -336,11 +333,6 @@ function StatusTag({ value }) {
     const badgeClass = colorMap[normalized] || defaultColor;
     return (jsx("span", { className: cn('inline-block rounded-full px-2 py-0.5 text-xs capitalize font-medium', badgeClass), children: value }));
 }
-function buildDebugFingerprintId() {
-    const timestamp = new Date().toISOString().replace(/[-:TZ.]/g, '').slice(0, 14);
-    const randomSuffix = Math.random().toString(36).slice(2, 8);
-    return `fp_test_dbg_${timestamp}_${randomSuffix}`;
-}
 function formatErrorMessage(error) {
     if (error instanceof Error) {
         return error.message;

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

@@ -10,11 +10,13 @@ export declare const FINGERPRINT_SOURCE_REFER = "x-source-ref";
 export declare const FINGERPRINT_FIRST_TOUCH_STORAGE_KEY = "__x_first_touch";
 export declare const FINGERPRINT_FIRST_TOUCH_COOKIE_NAME = "__x_first_touch";
 export declare const FINGERPRINT_FIRST_TOUCH_HEADER = "x-first-touch";
+export declare const FINGERPRINT_DEBUG_PREFIX = "fp_test_dbg_";
 /**
  * 验证fingerprint ID格式
  * 可以在客户端和服务端使用
  */
 export declare function isValidFingerprintId(fingerprintId: string): boolean;
+export declare function isDebugFingerprintId(fingerprintId: string | null | undefined): boolean;
 export declare const FINGERPRINT_CONSTANTS: {
     readonly STORAGE_KEY: "__x_fingerprint_id";
     readonly DEBUG_OVERRIDE_STORAGE_KEY: "__x_fingerprint_debug_override";
@@ -23,4 +25,5 @@ export declare const FINGERPRINT_CONSTANTS: {
     readonly FIRST_TOUCH_STORAGE_KEY: "__x_first_touch";
     readonly FIRST_TOUCH_COOKIE_NAME: "__x_first_touch";
     readonly FIRST_TOUCH_HEADER: "x-first-touch";
+    readonly DEBUG_PREFIX: "fp_test_dbg_";
 };

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

@@ -13,6 +13,7 @@ const FINGERPRINT_SOURCE_REFER = 'x-source-ref';
 const FINGERPRINT_FIRST_TOUCH_STORAGE_KEY = '__x_first_touch';
 const FINGERPRINT_FIRST_TOUCH_COOKIE_NAME = '__x_first_touch';
 const FINGERPRINT_FIRST_TOUCH_HEADER = 'x-first-touch';
+const FINGERPRINT_DEBUG_PREFIX = 'fp_test_dbg_';
 /**
  * 验证fingerprint ID格式
  * 可以在客户端和服务端使用
@@ -24,7 +25,14 @@ function isValidFingerprintId(fingerprintId) {
     // - fp_ + FingerprintJS visitorId (变长字符串)
     // - fp_fallback_ + 时间戳_随机字符串 (客户端降级方案)
     // - fp_server_ + 时间戳_随机字符串 (服务端降级)
-    return /^fp(_fallback|_server)?_[a-zA-Z0-9_]+$/.test(fingerprintId);
+    // - fp_test_dbg_ + 时间戳_随机字符串 (调试并发测试)
+    return /^fp(_fallback|_server|_test_dbg)?_[a-zA-Z0-9_]+$/.test(fingerprintId);
+}
+function isDebugFingerprintId(fingerprintId) {
+    if (!fingerprintId) {
+        return false;
+    }
+    return fingerprintId.startsWith(FINGERPRINT_DEBUG_PREFIX);
 }
 // 常量导出
 const FINGERPRINT_CONSTANTS = {
@@ -35,15 +43,18 @@ const FINGERPRINT_CONSTANTS = {
     FIRST_TOUCH_STORAGE_KEY: FINGERPRINT_FIRST_TOUCH_STORAGE_KEY,
     FIRST_TOUCH_COOKIE_NAME: FINGERPRINT_FIRST_TOUCH_COOKIE_NAME,
     FIRST_TOUCH_HEADER: FINGERPRINT_FIRST_TOUCH_HEADER,
+    DEBUG_PREFIX: FINGERPRINT_DEBUG_PREFIX,
 };
 
 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_DEBUG_PREFIX = FINGERPRINT_DEBUG_PREFIX;
 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;
 exports.FINGERPRINT_HEADER_NAME = FINGERPRINT_HEADER_NAME;
 exports.FINGERPRINT_SOURCE_REFER = FINGERPRINT_SOURCE_REFER;
 exports.FINGERPRINT_STORAGE_KEY = FINGERPRINT_STORAGE_KEY;
+exports.isDebugFingerprintId = isDebugFingerprintId;
 exports.isValidFingerprintId = isValidFingerprintId;

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

@@ -11,6 +11,7 @@ const FINGERPRINT_SOURCE_REFER = 'x-source-ref';
 const FINGERPRINT_FIRST_TOUCH_STORAGE_KEY = '__x_first_touch';
 const FINGERPRINT_FIRST_TOUCH_COOKIE_NAME = '__x_first_touch';
 const FINGERPRINT_FIRST_TOUCH_HEADER = 'x-first-touch';
+const FINGERPRINT_DEBUG_PREFIX = 'fp_test_dbg_';
 /**
  * 验证fingerprint ID格式
  * 可以在客户端和服务端使用
@@ -22,7 +23,14 @@ function isValidFingerprintId(fingerprintId) {
     // - fp_ + FingerprintJS visitorId (变长字符串)
     // - fp_fallback_ + 时间戳_随机字符串 (客户端降级方案)
     // - fp_server_ + 时间戳_随机字符串 (服务端降级)
-    return /^fp(_fallback|_server)?_[a-zA-Z0-9_]+$/.test(fingerprintId);
+    // - fp_test_dbg_ + 时间戳_随机字符串 (调试并发测试)
+    return /^fp(_fallback|_server|_test_dbg)?_[a-zA-Z0-9_]+$/.test(fingerprintId);
+}
+function isDebugFingerprintId(fingerprintId) {
+    if (!fingerprintId) {
+        return false;
+    }
+    return fingerprintId.startsWith(FINGERPRINT_DEBUG_PREFIX);
 }
 // 常量导出
 const FINGERPRINT_CONSTANTS = {
@@ -33,6 +41,7 @@ const FINGERPRINT_CONSTANTS = {
     FIRST_TOUCH_STORAGE_KEY: FINGERPRINT_FIRST_TOUCH_STORAGE_KEY,
     FIRST_TOUCH_COOKIE_NAME: FINGERPRINT_FIRST_TOUCH_COOKIE_NAME,
     FIRST_TOUCH_HEADER: FINGERPRINT_FIRST_TOUCH_HEADER,
+    DEBUG_PREFIX: FINGERPRINT_DEBUG_PREFIX,
 };
 
-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 };
+export { FINGERPRINT_CONSTANTS, FINGERPRINT_COOKIE_NAME, FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY, FINGERPRINT_DEBUG_PREFIX, FINGERPRINT_FIRST_TOUCH_COOKIE_NAME, FINGERPRINT_FIRST_TOUCH_HEADER, FINGERPRINT_FIRST_TOUCH_STORAGE_KEY, FINGERPRINT_HEADER_NAME, FINGERPRINT_SOURCE_REFER, FINGERPRINT_STORAGE_KEY, isDebugFingerprintId, isValidFingerprintId };

package/dist/clerk/fingerprint/index.js

@@ -11,12 +11,14 @@ 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_DEBUG_PREFIX = fingerprintShared.FINGERPRINT_DEBUG_PREFIX;
 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;
 exports.FINGERPRINT_HEADER_NAME = fingerprintShared.FINGERPRINT_HEADER_NAME;
 exports.FINGERPRINT_SOURCE_REFER = fingerprintShared.FINGERPRINT_SOURCE_REFER;
 exports.FINGERPRINT_STORAGE_KEY = fingerprintShared.FINGERPRINT_STORAGE_KEY;
+exports.isDebugFingerprintId = fingerprintShared.isDebugFingerprintId;
 exports.isValidFingerprintId = fingerprintShared.isValidFingerprintId;
 exports.clearFingerprintId = fingerprintClient.clearFingerprintId;
 exports.createFingerprintFetch = fingerprintClient.createFingerprintFetch;

package/dist/clerk/fingerprint/index.mjs

@@ -1,5 +1,5 @@
 "use client";
-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 { FINGERPRINT_CONSTANTS, FINGERPRINT_COOKIE_NAME, FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY, FINGERPRINT_DEBUG_PREFIX, FINGERPRINT_FIRST_TOUCH_COOKIE_NAME, FINGERPRINT_FIRST_TOUCH_HEADER, FINGERPRINT_FIRST_TOUCH_STORAGE_KEY, FINGERPRINT_HEADER_NAME, FINGERPRINT_SOURCE_REFER, FINGERPRINT_STORAGE_KEY, isDebugFingerprintId, 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

@@ -8,12 +8,14 @@ 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_DEBUG_PREFIX = fingerprintShared.FINGERPRINT_DEBUG_PREFIX;
 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;
 exports.FINGERPRINT_HEADER_NAME = fingerprintShared.FINGERPRINT_HEADER_NAME;
 exports.FINGERPRINT_SOURCE_REFER = fingerprintShared.FINGERPRINT_SOURCE_REFER;
 exports.FINGERPRINT_STORAGE_KEY = fingerprintShared.FINGERPRINT_STORAGE_KEY;
+exports.isDebugFingerprintId = fingerprintShared.isDebugFingerprintId;
 exports.isValidFingerprintId = fingerprintShared.isValidFingerprintId;
 exports.extractFingerprintFromNextRequest = fingerprintServer.extractFingerprintFromNextRequest;
 exports.extractFingerprintFromNextStores = fingerprintServer.extractFingerprintFromNextStores;

package/dist/clerk/fingerprint/server.mjs

@@ -1,2 +1,2 @@
-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 { FINGERPRINT_CONSTANTS, FINGERPRINT_COOKIE_NAME, FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY, FINGERPRINT_DEBUG_PREFIX, FINGERPRINT_FIRST_TOUCH_COOKIE_NAME, FINGERPRINT_FIRST_TOUCH_HEADER, FINGERPRINT_FIRST_TOUCH_STORAGE_KEY, FINGERPRINT_HEADER_NAME, FINGERPRINT_SOURCE_REFER, FINGERPRINT_STORAGE_KEY, isDebugFingerprintId, isValidFingerprintId } from './fingerprint-shared.mjs';
 export { extractFingerprintFromNextRequest, extractFingerprintFromNextStores, extractFingerprintId, generateServerFingerprintId } from './fingerprint-server.mjs';

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

@@ -99,8 +99,13 @@ function useFingerprint(config) {
                 setXCredit(data.xCredit || null);
                 setXSubscription(data.xSubscription || null);
                 setIsInitialized(true);
-                if (((_a = data.xUser) === null || _a === void 0 ? void 0 : _a.fingerprintId) && data.xUser.fingerprintId !== fingerprintId) {
-                    setFingerprintIdState(data.xUser.fingerprintId);
+                const canonicalFingerprintId = (_a = data.xUser) === null || _a === void 0 ? void 0 : _a.fingerprintId;
+                if (canonicalFingerprintId &&
+                    fingerprintShared.isValidFingerprintId(canonicalFingerprintId) &&
+                    !fingerprintShared.isDebugFingerprintId(canonicalFingerprintId) &&
+                    canonicalFingerprintId !== fingerprintId) {
+                    setFingerprintIdState(canonicalFingerprintId);
+                    fingerprintClient.setFingerprintId(canonicalFingerprintId);
                 }
             }
             else {

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

@@ -1,8 +1,8 @@
 "use client";
 import { __awaiter } from '../../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.3/node_modules/tslib/tslib.es6.mjs';
 import { useState, useRef, useCallback, useEffect } from 'react';
-import { getOrCreateFirstTouchData, getOrGenerateFingerprintId, createFingerprintHeaders } from './fingerprint-client.mjs';
-import { FINGERPRINT_SOURCE_REFER } from './fingerprint-shared.mjs';
+import { getOrCreateFirstTouchData, getOrGenerateFingerprintId, createFingerprintHeaders, setFingerprintId } from './fingerprint-client.mjs';
+import { FINGERPRINT_SOURCE_REFER, isValidFingerprintId, isDebugFingerprintId } from './fingerprint-shared.mjs';
 
 /**
  * Hook for managing fingerprint ID and anonymous user data
@@ -97,8 +97,13 @@ function useFingerprint(config) {
                 setXCredit(data.xCredit || null);
                 setXSubscription(data.xSubscription || null);
                 setIsInitialized(true);
-                if (((_a = data.xUser) === null || _a === void 0 ? void 0 : _a.fingerprintId) && data.xUser.fingerprintId !== fingerprintId) {
-                    setFingerprintIdState(data.xUser.fingerprintId);
+                const canonicalFingerprintId = (_a = data.xUser) === null || _a === void 0 ? void 0 : _a.fingerprintId;
+                if (canonicalFingerprintId &&
+                    isValidFingerprintId(canonicalFingerprintId) &&
+                    !isDebugFingerprintId(canonicalFingerprintId) &&
+                    canonicalFingerprintId !== fingerprintId) {
+                    setFingerprintIdState(canonicalFingerprintId);
+                    setFingerprintId(canonicalFingerprintId);
                 }
             }
             else {

package/dist/fuma/mdx/toc-clerk-portable.js

@@ -45,6 +45,10 @@ const CLERK_ACTIVE_ANIMATION_EASING = 'cubic-bezier(0.22, 1, 0.36, 1)';
 const CLERK_TEXT_GAP_FROM_PATH = 12;
 // Radius of numbered step badges rendered on top of the path centerline.
 const CLERK_STEP_BADGE_RADIUS = 7;
+// Visual line offsets by grouped heading depth: 1/2, 3, 4, >4.
+const CLERK_DEPTH_GROUP_LINE_OFFSETS = [6, 18, 30, 42];
+// Max number of characters rendered for a TOC label before trimming with ellipsis.
+const CLERK_MAX_LABEL_LENGTH = 44;
 function PortableClerkTOC({ toc, header, footer, title, emptyLabel = 'No headings', className, }) {
     return (jsxRuntime.jsxs(page.PageTOC, { className: className, children: [header, title !== null && title !== void 0 ? title : jsxRuntime.jsx(page.PageTOCTitle, {}), jsxRuntime.jsx(PortableClerkTOCScrollArea, { children: jsxRuntime.jsx(PortableClerkTOCItems, { toc: toc, emptyLabel: emptyLabel }) }), footer] }));
 }
@@ -124,16 +128,16 @@ function PortableClerkTOCItems(_a) {
     if (toc.length === 0) {
         return (jsxRuntime.jsx("div", { className: "rounded-lg border bg-fd-card p-3 text-xs text-fd-muted-foreground", children: emptyLabel }));
     }
-    return (jsxRuntime.jsxs("div", Object.assign({ ref: mergeRefs(containerRef, ref), className: cn('relative flex flex-col', className) }, props, { children: [jsxRuntime.jsx(ClerkOutline, { path: outlinePath, items: layout.items, activePath: activePath, activeAnchors: activeAnchors, activeEndpoint: activeEndpoint }), metas.map((meta, i) => (jsxRuntime.jsx(PortableClerkTOCItem, { item: meta.item, isActive: activeAnchors.includes(meta.item.url.slice(1)), resolvedContent: meta.resolvedContent, itemPadding: meta.itemPadding, contentRef: (node) => {
+    return (jsxRuntime.jsxs("div", Object.assign({ ref: mergeRefs(containerRef, ref), className: cn('relative flex flex-col', className) }, props, { children: [jsxRuntime.jsx(ClerkOutline, { path: outlinePath, items: layout.items, activePath: activePath, activeAnchors: activeAnchors, activeEndpoint: activeEndpoint }), metas.map((meta, i) => (jsxRuntime.jsx(PortableClerkTOCItem, { item: meta.item, isActive: activeAnchors.includes(meta.item.url.slice(1)), resolvedContent: meta.resolvedContent, fullTitle: meta.fullTitle, itemPadding: meta.itemPadding, contentRef: (node) => {
                     contentRefs.current[i] = node;
                 }, ref: (node) => {
                     itemRefs.current[i] = node;
                 } }, meta.item.url)))] })));
 }
-function PortableClerkTOCItem({ item, isActive, resolvedContent, itemPadding, contentRef, ref, }) {
-    return (jsxRuntime.jsx(Primitive__namespace.TOCItem, { ref: ref, href: item.url, "data-clerk-item": "", style: {
+function PortableClerkTOCItem({ item, isActive, resolvedContent, fullTitle, itemPadding, contentRef, ref, }) {
+    return (jsxRuntime.jsx(Primitive__namespace.TOCItem, { ref: ref, href: item.url, "data-clerk-item": "", title: fullTitle !== null && fullTitle !== void 0 ? fullTitle : undefined, style: {
             paddingInlineStart: itemPadding,
-        }, className: cn('prose group relative py-1.5 text-sm transition-colors wrap-anywhere first:pt-0 last:pb-0 hover:text-fd-accent-foreground', isActive ? lib.themeIconColor : 'text-fd-muted-foreground'), children: jsxRuntime.jsx("span", { ref: contentRef, className: "relative z-10", children: resolvedContent }) }));
+        }, className: cn('prose group relative py-1.5 text-sm transition-colors first:pt-0 last:pb-0 hover:text-fd-accent-foreground', isActive ? lib.themeIconColor : 'text-fd-muted-foreground'), children: jsxRuntime.jsx("span", { ref: contentRef, className: "relative z-10 block overflow-hidden text-ellipsis whitespace-nowrap", children: resolvedContent }) }));
 }
 function ClerkOutline({ path, items, activePath, activeAnchors, activeEndpoint, }) {
     const activeSet = new Set(activeAnchors);
@@ -176,19 +180,33 @@ function getItemOffset(depth) {
     return lineOffset + badgeRadius + CLERK_TEXT_GAP_FROM_PATH;
 }
 function getLineOffset(depth) {
-    return depth >= 3 ? 18 : 6;
+    const group = getDepthGroup(depth);
+    return CLERK_DEPTH_GROUP_LINE_OFFSETS[group];
 }
 function getVisualLinePosition(depth) {
     return getLineOffset(depth);
 }
+function getDepthGroup(depth) {
+    if (depth <= 2)
+        return 0;
+    if (depth === 3)
+        return 1;
+    if (depth === 4)
+        return 2;
+    return 3;
+}
 function resolveClerkItem(item) {
     const isH3 = item.depth === 3;
     const rawTitle = typeof item.title === 'string' ? item.title : '';
     const { isStep, displayStep, content } = getStepInfoFromTitle(rawTitle);
     let stepNumber = isH3 && isStep ? String(displayStep) : null;
     let resolvedContent = item.title;
+    let fullTitle = rawTitle || null;
     if (isH3 && isStep) {
         resolvedContent = content !== null && content !== void 0 ? content : item.title;
+        if (typeof content === 'string') {
+            fullTitle = content;
+        }
     }
     if (isH3 && !stepNumber) {
         const urlNum = getDigitsFromUrl(item.url);
@@ -199,18 +217,30 @@ function resolveClerkItem(item) {
                 const match = rawTitle.match(/^(\d+(?:\.\d+)*\.?)\s+(.+)$/);
                 if (match === null || match === void 0 ? void 0 : match[2]) {
                     resolvedContent = match[2];
+                    fullTitle = match[2];
                 }
             }
         }
     }
+    if (typeof resolvedContent === 'string') {
+        fullTitle = resolvedContent;
+        resolvedContent = truncateClerkLabel(resolvedContent);
+    }
     return {
         item,
         resolvedContent,
+        fullTitle,
         stepNumber,
         itemPadding: getItemOffset(item.depth),
         lineOffset: getVisualLinePosition(item.depth),
     };
 }
+function truncateClerkLabel(value) {
+    const normalized = value.trim();
+    if (normalized.length <= CLERK_MAX_LABEL_LENGTH)
+        return normalized;
+    return `${normalized.slice(0, CLERK_MAX_LABEL_LENGTH).trimEnd()}...`;
+}
 function buildOutlinePath(items) {
     if (items.length === 0)
         return '';

package/dist/fuma/mdx/toc-clerk-portable.mjs

@@ -24,6 +24,10 @@ const CLERK_ACTIVE_ANIMATION_EASING = 'cubic-bezier(0.22, 1, 0.36, 1)';
 const CLERK_TEXT_GAP_FROM_PATH = 12;
 // Radius of numbered step badges rendered on top of the path centerline.
 const CLERK_STEP_BADGE_RADIUS = 7;
+// Visual line offsets by grouped heading depth: 1/2, 3, 4, >4.
+const CLERK_DEPTH_GROUP_LINE_OFFSETS = [6, 18, 30, 42];
+// Max number of characters rendered for a TOC label before trimming with ellipsis.
+const CLERK_MAX_LABEL_LENGTH = 44;
 function PortableClerkTOC({ toc, header, footer, title, emptyLabel = 'No headings', className, }) {
     return (jsxs(PageTOC, { className: className, children: [header, title !== null && title !== void 0 ? title : jsx(PageTOCTitle, {}), jsx(PortableClerkTOCScrollArea, { children: jsx(PortableClerkTOCItems, { toc: toc, emptyLabel: emptyLabel }) }), footer] }));
 }
@@ -103,16 +107,16 @@ function PortableClerkTOCItems(_a) {
     if (toc.length === 0) {
         return (jsx("div", { className: "rounded-lg border bg-fd-card p-3 text-xs text-fd-muted-foreground", children: emptyLabel }));
     }
-    return (jsxs("div", Object.assign({ ref: mergeRefs(containerRef, ref), className: cn('relative flex flex-col', className) }, props, { children: [jsx(ClerkOutline, { path: outlinePath, items: layout.items, activePath: activePath, activeAnchors: activeAnchors, activeEndpoint: activeEndpoint }), metas.map((meta, i) => (jsx(PortableClerkTOCItem, { item: meta.item, isActive: activeAnchors.includes(meta.item.url.slice(1)), resolvedContent: meta.resolvedContent, itemPadding: meta.itemPadding, contentRef: (node) => {
+    return (jsxs("div", Object.assign({ ref: mergeRefs(containerRef, ref), className: cn('relative flex flex-col', className) }, props, { children: [jsx(ClerkOutline, { path: outlinePath, items: layout.items, activePath: activePath, activeAnchors: activeAnchors, activeEndpoint: activeEndpoint }), metas.map((meta, i) => (jsx(PortableClerkTOCItem, { item: meta.item, isActive: activeAnchors.includes(meta.item.url.slice(1)), resolvedContent: meta.resolvedContent, fullTitle: meta.fullTitle, itemPadding: meta.itemPadding, contentRef: (node) => {
                     contentRefs.current[i] = node;
                 }, ref: (node) => {
                     itemRefs.current[i] = node;
                 } }, meta.item.url)))] })));
 }
-function PortableClerkTOCItem({ item, isActive, resolvedContent, itemPadding, contentRef, ref, }) {
-    return (jsx(Primitive.TOCItem, { ref: ref, href: item.url, "data-clerk-item": "", style: {
+function PortableClerkTOCItem({ item, isActive, resolvedContent, fullTitle, itemPadding, contentRef, ref, }) {
+    return (jsx(Primitive.TOCItem, { ref: ref, href: item.url, "data-clerk-item": "", title: fullTitle !== null && fullTitle !== void 0 ? fullTitle : undefined, style: {
             paddingInlineStart: itemPadding,
-        }, className: cn('prose group relative py-1.5 text-sm transition-colors wrap-anywhere first:pt-0 last:pb-0 hover:text-fd-accent-foreground', isActive ? themeIconColor : 'text-fd-muted-foreground'), children: jsx("span", { ref: contentRef, className: "relative z-10", children: resolvedContent }) }));
+        }, className: cn('prose group relative py-1.5 text-sm transition-colors first:pt-0 last:pb-0 hover:text-fd-accent-foreground', isActive ? themeIconColor : 'text-fd-muted-foreground'), children: jsx("span", { ref: contentRef, className: "relative z-10 block overflow-hidden text-ellipsis whitespace-nowrap", children: resolvedContent }) }));
 }
 function ClerkOutline({ path, items, activePath, activeAnchors, activeEndpoint, }) {
     const activeSet = new Set(activeAnchors);
@@ -155,19 +159,33 @@ function getItemOffset(depth) {
     return lineOffset + badgeRadius + CLERK_TEXT_GAP_FROM_PATH;
 }
 function getLineOffset(depth) {
-    return depth >= 3 ? 18 : 6;
+    const group = getDepthGroup(depth);
+    return CLERK_DEPTH_GROUP_LINE_OFFSETS[group];
 }
 function getVisualLinePosition(depth) {
     return getLineOffset(depth);
 }
+function getDepthGroup(depth) {
+    if (depth <= 2)
+        return 0;
+    if (depth === 3)
+        return 1;
+    if (depth === 4)
+        return 2;
+    return 3;
+}
 function resolveClerkItem(item) {
     const isH3 = item.depth === 3;
     const rawTitle = typeof item.title === 'string' ? item.title : '';
     const { isStep, displayStep, content } = getStepInfoFromTitle(rawTitle);
     let stepNumber = isH3 && isStep ? String(displayStep) : null;
     let resolvedContent = item.title;
+    let fullTitle = rawTitle || null;
     if (isH3 && isStep) {
         resolvedContent = content !== null && content !== void 0 ? content : item.title;
+        if (typeof content === 'string') {
+            fullTitle = content;
+        }
     }
     if (isH3 && !stepNumber) {
         const urlNum = getDigitsFromUrl(item.url);
@@ -178,18 +196,30 @@ function resolveClerkItem(item) {
                 const match = rawTitle.match(/^(\d+(?:\.\d+)*\.?)\s+(.+)$/);
                 if (match === null || match === void 0 ? void 0 : match[2]) {
                     resolvedContent = match[2];
+                    fullTitle = match[2];
                 }
             }
         }
     }
+    if (typeof resolvedContent === 'string') {
+        fullTitle = resolvedContent;
+        resolvedContent = truncateClerkLabel(resolvedContent);
+    }
     return {
         item,
         resolvedContent,
+        fullTitle,
         stepNumber,
         itemPadding: getItemOffset(item.depth),
         lineOffset: getVisualLinePosition(item.depth),
     };
 }
+function truncateClerkLabel(value) {
+    const normalized = value.trim();
+    if (normalized.length <= CLERK_MAX_LABEL_LENGTH)
+        return normalized;
+    return `${normalized.slice(0, CLERK_MAX_LABEL_LENGTH).trimEnd()}...`;
+}
 function buildOutlinePath(items) {
     if (items.length === 0)
         return '';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windrun-huaiin/third-ui",
-  "version": "14.4.1",
+  "version": "14.4.3",
   "description": "Third-party integrated UI components for windrun-huaiin projects",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

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

@@ -1,7 +1,9 @@
 'use client';
 
 import {
+  FINGERPRINT_DEBUG_PREFIX,
   FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY,
+  isDebugFingerprintId,
   isValidFingerprintId,
 } from './fingerprint-shared';
 
@@ -31,7 +33,7 @@ function setLocalStorageValue(key: string, value: string): void {
 
 export function getDebugFingerprintOverride(): string | null {
   const value = getLocalStorageValue(FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY);
-  if (!value || !isValidFingerprintId(value)) {
+  if (!value || !isValidFingerprintId(value) || !isDebugFingerprintId(value)) {
     return null;
   }
 
@@ -39,9 +41,32 @@ export function getDebugFingerprintOverride(): string | null {
 }
 
 export function setDebugFingerprintOverride(fingerprintId: string): void {
-  if (!isValidFingerprintId(fingerprintId)) {
+  if (!isValidFingerprintId(fingerprintId) || !isDebugFingerprintId(fingerprintId)) {
     throw new Error('Invalid fingerprint ID');
   }
 
   setLocalStorageValue(FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY, fingerprintId);
 }
+
+export function buildDebugFingerprintId(): string {
+  const timestamp = new Date().toISOString().replace(/[-:TZ.]/g, '').slice(0, 14);
+  const randomSuffix = Math.random().toString(36).slice(2, 8);
+  return `${FINGERPRINT_DEBUG_PREFIX}${timestamp}_${randomSuffix}`;
+}
+
+export function getOrCreateDebugFingerprintOverride(): string {
+  const existing = getDebugFingerprintOverride();
+  if (existing) {
+    return existing;
+  }
+
+  const nextFingerprintId = buildDebugFingerprintId();
+  setDebugFingerprintOverride(nextFingerprintId);
+  return nextFingerprintId;
+}
+
+export function regenerateDebugFingerprintOverride(): string {
+  const nextFingerprintId = buildDebugFingerprintId();
+  setDebugFingerprintOverride(nextFingerprintId);
+  return nextFingerprintId;
+}

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

@@ -9,8 +9,8 @@ import { useFingerprint } from './use-fingerprint';
 import { CopyableText } from '@windrun-huaiin/base-ui/ui';
 import { createFingerprintHeaders } from './fingerprint-client';
 import {
-  getDebugFingerprintOverride,
-  setDebugFingerprintOverride,
+  getOrCreateDebugFingerprintOverride,
+  regenerateDebugFingerprintOverride,
 } from './fingerprint-debug';
 import { FINGERPRINT_SOURCE_REFER } from './fingerprint-shared';
 
@@ -112,16 +112,12 @@ export function FingerprintStatus() {
   }, [xUser]);
 
   useEffect(() => {
-    const debugFingerprintOverride = getDebugFingerprintOverride();
-    if (debugFingerprintOverride) {
-      setActiveDebugFingerprintId(debugFingerprintOverride);
+    if (panelMode !== 'test') {
       return;
     }
 
-    const nextFingerprintId = buildDebugFingerprintId();
-    setDebugFingerprintOverride(nextFingerprintId);
-    setActiveDebugFingerprintId(nextFingerprintId);
-  }, []);
+    setActiveDebugFingerprintId((current) => current ?? getOrCreateDebugFingerprintOverride());
+  }, [panelMode]);
 
   const creditBuckets = useMemo(() => {
     if (!xCredit) return [];
@@ -185,12 +181,13 @@ export function FingerprintStatus() {
   );
 
   const runContextParallelInitTest = async () => {
-    const debugFingerprintId = activeDebugFingerprintId;
+    const debugFingerprintId = activeDebugFingerprintId ?? getOrCreateDebugFingerprintOverride();
     if (!debugFingerprintId) {
       setTestResult('Test fingerprint override is not ready yet.');
       return;
     }
 
+    setActiveDebugFingerprintId(debugFingerprintId);
     setIsRunningTest(true);
     setTestResult(`Running Frontend Prevention Test with fingerprint: ${debugFingerprintId}`);
 
@@ -240,12 +237,13 @@ export function FingerprintStatus() {
   };
 
   const runRawParallelPostTest = async () => {
-    const normalizedFingerprintId = activeDebugFingerprintId;
+    const normalizedFingerprintId = activeDebugFingerprintId ?? getOrCreateDebugFingerprintOverride();
     if (!normalizedFingerprintId) {
       setTestResult('Test fingerprint override is not ready yet.');
       return;
     }
 
+    setActiveDebugFingerprintId(normalizedFingerprintId);
     setIsRunningTest(true);
     setTestResult(`Running Backend Idempotency Test with fingerprint: ${normalizedFingerprintId}`);
 
@@ -303,8 +301,7 @@ export function FingerprintStatus() {
   };
 
   const regenerateTestFingerprint = () => {
-    const nextFingerprintId = buildDebugFingerprintId();
-    setDebugFingerprintOverride(nextFingerprintId);
+    const nextFingerprintId = regenerateDebugFingerprintOverride();
     setActiveDebugFingerprintId(nextFingerprintId);
     setTestResult(`Generated test fingerprint override: ${nextFingerprintId}`);
   };
@@ -680,12 +677,6 @@ function StatusTag({ value }: { value: string | undefined | null }) {
   );
 }
 
-function buildDebugFingerprintId() {
-  const timestamp = new Date().toISOString().replace(/[-:TZ.]/g, '').slice(0, 14);
-  const randomSuffix = Math.random().toString(36).slice(2, 8);
-  return `fp_test_dbg_${timestamp}_${randomSuffix}`;
-}
-
 function formatErrorMessage(error: unknown) {
   if (error instanceof Error) {
     return error.message;

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

@@ -12,6 +12,7 @@ export const FINGERPRINT_SOURCE_REFER = 'x-source-ref';
 export const FINGERPRINT_FIRST_TOUCH_STORAGE_KEY = '__x_first_touch';
 export const FINGERPRINT_FIRST_TOUCH_COOKIE_NAME = '__x_first_touch';
 export const FINGERPRINT_FIRST_TOUCH_HEADER = 'x-first-touch';
+export const FINGERPRINT_DEBUG_PREFIX = 'fp_test_dbg_';
 
 /**
  * 验证fingerprint ID格式
@@ -23,7 +24,16 @@ export function isValidFingerprintId(fingerprintId: string): boolean {
   // - fp_ + FingerprintJS visitorId (变长字符串)
   // - fp_fallback_ + 时间戳_随机字符串 (客户端降级方案)
   // - fp_server_ + 时间戳_随机字符串 (服务端降级)
-  return /^fp(_fallback|_server)?_[a-zA-Z0-9_]+$/.test(fingerprintId);
+  // - fp_test_dbg_ + 时间戳_随机字符串 (调试并发测试)
+  return /^fp(_fallback|_server|_test_dbg)?_[a-zA-Z0-9_]+$/.test(fingerprintId);
+}
+
+export function isDebugFingerprintId(fingerprintId: string | null | undefined): boolean {
+  if (!fingerprintId) {
+    return false;
+  }
+
+  return fingerprintId.startsWith(FINGERPRINT_DEBUG_PREFIX);
 }
 
 // 常量导出
@@ -35,4 +45,5 @@ export const FINGERPRINT_CONSTANTS = {
   FIRST_TOUCH_STORAGE_KEY: FINGERPRINT_FIRST_TOUCH_STORAGE_KEY,
   FIRST_TOUCH_COOKIE_NAME: FINGERPRINT_FIRST_TOUCH_COOKIE_NAME,
   FIRST_TOUCH_HEADER: FINGERPRINT_FIRST_TOUCH_HEADER,
+  DEBUG_PREFIX: FINGERPRINT_DEBUG_PREFIX,
 } as const;

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

@@ -4,7 +4,8 @@ import { useCallback, useEffect, useRef, useState } from 'react';
 import {
   createFingerprintHeaders,
   getOrCreateFirstTouchData,
-  getOrGenerateFingerprintId
+  getOrGenerateFingerprintId,
+  setFingerprintId,
 } from './fingerprint-client';
 import type {
   FingerprintConfig,
@@ -13,7 +14,7 @@ import type {
   XSubscription,
   XUser
 } from './types';
-import { FINGERPRINT_SOURCE_REFER } from './fingerprint-shared'
+import { FINGERPRINT_SOURCE_REFER, isDebugFingerprintId, isValidFingerprintId } from './fingerprint-shared'
 
 /**
  * Hook for managing fingerprint ID and anonymous user data
@@ -121,8 +122,15 @@ export function useFingerprint(config: FingerprintConfig): UseFingerprintResult
         setXSubscription(data.xSubscription || null);
         setIsInitialized(true);
 
-        if (data.xUser?.fingerprintId && data.xUser.fingerprintId !== fingerprintId) {
-          setFingerprintIdState(data.xUser.fingerprintId);
+        const canonicalFingerprintId = data.xUser?.fingerprintId;
+        if (
+          canonicalFingerprintId &&
+          isValidFingerprintId(canonicalFingerprintId) &&
+          !isDebugFingerprintId(canonicalFingerprintId) &&
+          canonicalFingerprintId !== fingerprintId
+        ) {
+          setFingerprintIdState(canonicalFingerprintId);
+          setFingerprintId(canonicalFingerprintId);
         }
       } else {
         throw new Error(data.error || 'Unknown error occurred');

package/src/fuma/mdx/toc-clerk-portable.tsx

@@ -40,6 +40,7 @@ type PortableClerkTOCProps = {
 type ClerkItemMeta = {
   item: TOCItemType;
   resolvedContent: ReactNode;
+  fullTitle: string | null;
   stepNumber: string | null;
   itemPadding: number;
   lineOffset: number;
@@ -70,6 +71,10 @@ const CLERK_ACTIVE_ANIMATION_EASING = 'cubic-bezier(0.22, 1, 0.36, 1)';
 const CLERK_TEXT_GAP_FROM_PATH = 12;
 // Radius of numbered step badges rendered on top of the path centerline.
 const CLERK_STEP_BADGE_RADIUS = 7;
+// Visual line offsets by grouped heading depth: 1/2, 3, 4, >4.
+const CLERK_DEPTH_GROUP_LINE_OFFSETS = [6, 18, 30, 42] as const;
+// Max number of characters rendered for a TOC label before trimming with ellipsis.
+const CLERK_MAX_LABEL_LENGTH = 44;
 
 export function PortableClerkTOC({
   toc,
@@ -250,6 +255,7 @@ export function PortableClerkTOCItems({
           item={meta.item}
           isActive={activeAnchors.includes(meta.item.url.slice(1))}
           resolvedContent={meta.resolvedContent}
+          fullTitle={meta.fullTitle}
           itemPadding={meta.itemPadding}
           contentRef={(node: HTMLSpanElement | null) => {
             contentRefs.current[i] = node;
@@ -267,6 +273,7 @@ function PortableClerkTOCItem({
   item,
   isActive,
   resolvedContent,
+  fullTitle,
   itemPadding,
   contentRef,
   ref,
@@ -274,6 +281,7 @@ function PortableClerkTOCItem({
   item: TOCItemType;
   isActive: boolean;
   resolvedContent: ReactNode;
+  fullTitle: string | null;
   itemPadding: number;
   contentRef?: ((node: HTMLSpanElement | null) => void) | null;
   ref?: ((node: HTMLAnchorElement | null) => void) | null;
@@ -283,15 +291,19 @@ function PortableClerkTOCItem({
       ref={ref}
       href={item.url}
       data-clerk-item=""
+      title={fullTitle ?? undefined}
       style={{
         paddingInlineStart: itemPadding,
       }}
       className={cn(
-        'prose group relative py-1.5 text-sm transition-colors wrap-anywhere first:pt-0 last:pb-0 hover:text-fd-accent-foreground',
+        'prose group relative py-1.5 text-sm transition-colors first:pt-0 last:pb-0 hover:text-fd-accent-foreground',
         isActive ? themeIconColor : 'text-fd-muted-foreground',
       )}
     >
-      <span ref={contentRef} className="relative z-10">
+      <span
+        ref={contentRef}
+        className="relative z-10 block overflow-hidden text-ellipsis whitespace-nowrap"
+      >
         {resolvedContent}
       </span>
     </Primitive.TOCItem>
@@ -453,22 +465,34 @@ function getItemOffset(depth: number): number {
 }
 
 function getLineOffset(depth: number): number {
-  return depth >= 3 ? 18 : 6;
+  const group = getDepthGroup(depth);
+  return CLERK_DEPTH_GROUP_LINE_OFFSETS[group];
 }
 
 function getVisualLinePosition(depth: number): number {
   return getLineOffset(depth);
 }
 
+function getDepthGroup(depth: number): number {
+  if (depth <= 2) return 0;
+  if (depth === 3) return 1;
+  if (depth === 4) return 2;
+  return 3;
+}
+
 function resolveClerkItem(item: TOCItemType): ClerkItemMeta {
   const isH3 = item.depth === 3;
   const rawTitle = typeof item.title === 'string' ? item.title : '';
   const { isStep, displayStep, content } = getStepInfoFromTitle(rawTitle);
   let stepNumber: string | null = isH3 && isStep ? String(displayStep) : null;
   let resolvedContent: ReactNode = item.title;
+  let fullTitle: string | null = rawTitle || null;
 
   if (isH3 && isStep) {
     resolvedContent = content ?? item.title;
+    if (typeof content === 'string') {
+      fullTitle = content;
+    }
   }
 
   if (isH3 && !stepNumber) {
@@ -480,20 +504,34 @@ function resolveClerkItem(item: TOCItemType): ClerkItemMeta {
         const match = rawTitle.match(/^(\d+(?:\.\d+)*\.?)\s+(.+)$/);
         if (match?.[2]) {
           resolvedContent = match[2];
+          fullTitle = match[2];
         }
       }
     }
   }
 
+  if (typeof resolvedContent === 'string') {
+    fullTitle = resolvedContent;
+    resolvedContent = truncateClerkLabel(resolvedContent);
+  }
+
   return {
     item,
     resolvedContent,
+    fullTitle,
     stepNumber,
     itemPadding: getItemOffset(item.depth),
     lineOffset: getVisualLinePosition(item.depth),
   };
 }
 
+function truncateClerkLabel(value: string): string {
+  const normalized = value.trim();
+  if (normalized.length <= CLERK_MAX_LABEL_LENGTH) return normalized;
+
+  return `${normalized.slice(0, CLERK_MAX_LABEL_LENGTH).trimEnd()}...`;
+}
+
 function buildOutlinePath(items: ClerkItemMeasure[]): string {
   if (items.length === 0) return '';
 

package/src/styles/fuma.css

@@ -3,6 +3,19 @@
   @apply top-20!;
 }
 
+@media (min-width: 1280px) {
+  /* 给桌面端固定 TOC 留一点底部呼吸感，避免视觉上直接压到 footer */
+  #nd-toc {
+    bottom: 1.25rem !important;
+  }
+
+  /* 文档主区域补一小段底部缓冲，减少 footer 刚进入视口就与 TOC 相撞 */
+  #nd-page {
+    padding-bottom: 5rem !important;
+    min-height: calc(100dvh - 5rem) !important;
+  }
+}
+
 /* 移动端文章目录下拉框的边距，建议移动端不要目录导航 96px */
 #nd-tocnav {
   @apply top-24!;
@@ -35,7 +48,7 @@ button[aria-label="Open Search"][data-search=""] {
 
 /* Custome Fuma Steps */
 .fd-step::before {
-  @apply size-5 -start-2.5 rounded-full;
+  @apply size-5 -inset-s-2.5 rounded-full;
   background-color: #000; 
   color: #fff;
   font-size: 0.75rem; 
@@ -128,4 +141,4 @@ button[aria-label="Open Search"][data-search=""] {
   [data-rmiz-modal-img] {
     transition-duration: 0.01ms !important;
   }
-} 
+}