customer-chat-sdk 1.1.1 → 1.1.3

package/dist/customer-sdk.cjs.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 // 直接使用base64字符串，避免打包后路径问题
 const iconImage = 'data:image/png;base64,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';
 class IconManager {
-    constructor(position, debug = false) {
+    constructor(position, debug = false, target) {
         this.iconElement = null;
         this.badgeElement = null;
         this.onClickCallback = null;
@@ -23,8 +23,11 @@ class IconManager {
         this.iconPosition = null; // 图标位置配置
         this.debug = false; // debug 模式标志
         this.isClickEnabled = true; // 是否允许点击（iframe 打开时禁用）
+        this.target = null; // 图标传送目标元素（可以是 HTMLElement 或选择器字符串）
         this.iconPosition = position || null;
         this.debug = debug;
+        // 保存 target（可以是 HTMLElement 或字符串选择器）
+        this.target = target || null;
     }
     /**
      * 显示悬浮图标
@@ -123,8 +126,18 @@ class IconManager {
         this.iconElement.appendChild(imgContainer);
         // 添加拖动和点击事件
         this.setupDragEvents();
-        // 添加到页面
-        document.body.appendChild(this.iconElement);
+        // 添加到目标元素（如果 target 是字符串，需要重新查找，因为可能在初始化时元素还不存在）
+        const targetElement = this.getTargetElement();
+        if (targetElement) {
+            targetElement.appendChild(this.iconElement);
+        }
+        else {
+            // 如果目标元素不存在，回退到 document.body
+            document.body.appendChild(this.iconElement);
+            if (this.debug) {
+                console.warn('Target element not found, icon added to document.body');
+            }
+        }
         if (this.debug) {
             console.log('CustomerSDK icon displayed');
         }
@@ -497,6 +510,44 @@ class IconManager {
             this.iconElement.style.cursor = 'pointer';
         }
     }
+    /**
+     * 获取目标元素（支持动态查找）
+     */
+    getTargetElement() {
+        if (!this.target) {
+            return document.body;
+        }
+        // 如果 target 是字符串选择器，每次都需要重新查找（支持动态元素）
+        if (typeof this.target === 'string') {
+            const element = document.querySelector(this.target);
+            if (element) {
+                return element;
+            }
+            else {
+                // 如果元素不存在，回退到 document.body
+                if (this.debug) {
+                    console.warn(`Target element not found: ${this.target}, falling back to document.body`);
+                }
+                return document.body;
+            }
+        }
+        // 如果 target 是 HTMLElement
+        if (this.target instanceof HTMLElement) {
+            // 检查元素是否还在 DOM 中
+            if (document.body.contains(this.target)) {
+                return this.target;
+            }
+            else {
+                // 如果元素不在 DOM 中，回退到 document.body
+                if (this.debug) {
+                    console.warn('Target element no longer in DOM, falling back to document.body');
+                }
+                return document.body;
+            }
+        }
+        // 默认回退到 document.body
+        return document.body;
+    }
     /**
      * 创建消息徽章（简化版）
      */
@@ -576,7 +627,15 @@ class IframeManager {
      */
     async init() {
         try {
+            // PC模式：预创建遮罩层（隐藏状态），避免后续移动DOM导致iframe重新加载
+            const actualMode = this.getActualMode();
+            const isPC = actualMode === 'popup';
+            if (isPC) {
+                // 创建遮罩层但不立即显示（showImmediately = false）
+                this.createOverlay(false);
+            }
             // 创建隐藏的iframe（预连接到SSE）
+            // 注意：createIframe 会将容器添加到遮罩层（PC模式）或 body（移动端）
             this.createIframe();
             this.isCreated = true;
             if (this.debug) {
@@ -604,10 +663,30 @@ class IframeManager {
             const isPC = actualMode === 'popup';
             // PC模式：创建或显示遮罩层
             if (isPC) {
-                this.createOverlay(); // createOverlay 内部会检查是否已存在
+                // 如果遮罩层不存在，创建并显示；如果已存在，直接显示
+                this.createOverlay(true); // showImmediately = true，立即显示
             }
             // 显示已创建的容器
+            // 关键优化：容器在 init() 时已经添加到正确位置，这里只改变样式，不移动 DOM
+            // 这样可以避免 iframe 重新加载
             if (this.containerElement) {
+                // 确保容器在 DOM 中（理论上已经在 init() 时添加，但为了安全）
+                if (!this.containerElement.parentNode) {
+                    // 如果容器不在 DOM 中（异常情况），根据模式添加到正确位置
+                    if (isPC && this.overlayElement) {
+                        // PC模式：确保遮罩层在 DOM 中，然后将容器添加到遮罩层
+                        if (!this.overlayElement.parentNode) {
+                            document.body.appendChild(this.overlayElement);
+                        }
+                        this.overlayElement.appendChild(this.containerElement);
+                    }
+                    else {
+                        // 移动端模式：直接添加到 body
+                        document.body.appendChild(this.containerElement);
+                    }
+                }
+                // 注意：不再检查容器是否在遮罩层内，因为 init() 时已经正确放置
+                // 如果移动容器会导致 iframe 重新加载，所以不移动
                 if (isPC) {
                     // PC模式：配置为居中弹窗样式
                     Object.assign(this.containerElement.style, {
@@ -619,17 +698,18 @@ class IframeManager {
                         opacity: '1',
                         display: 'block'
                     });
-                    // 关键优化：避免重复移动容器导致 iframe 重新加载
-                    // 只有当容器不在遮罩层内时才移动，且确保遮罩层在 DOM 中
+                    // 显示遮罩层（确保在 DOM 中）
                     if (this.overlayElement) {
-                        // 如果遮罩层不在 DOM 中，先添加到 DOM
+                        // 确保遮罩层在 DOM 中
                         if (!this.overlayElement.parentNode) {
                             document.body.appendChild(this.overlayElement);
                         }
-                        // 只有当容器不在遮罩层内时才移动（避免重复移动导致 iframe 重新加载）
-                        if (this.containerElement.parentNode !== this.overlayElement) {
-                            this.overlayElement.appendChild(this.containerElement);
-                        }
+                        // 显示遮罩层（只改变样式，不移动）
+                        Object.assign(this.overlayElement.style, {
+                            visibility: 'visible',
+                            opacity: '1',
+                            display: 'flex'
+                        });
                     }
                 }
                 else {
@@ -710,11 +790,16 @@ class IframeManager {
      */
     destroy() {
         this.hide();
+        // 移除容器和遮罩层
         if (this.containerElement) {
             this.containerElement.remove();
             this.containerElement = null;
             this.iframeElement = null;
         }
+        if (this.overlayElement) {
+            this.overlayElement.remove();
+            this.overlayElement = null;
+        }
         this.isCreated = false;
         if (this.debug) {
             console.log('CustomerSDK container destroyed');
@@ -736,25 +821,23 @@ class IframeManager {
     }
     /**
      * 创建遮罩层（PC模式使用）
+     * @param showImmediately 是否立即显示，默认 false（用于 init() 时创建但不显示）
      */
-    createOverlay() {
-        // 如果遮罩层已存在，直接显示即可
-        if (this.overlayElement && this.overlayElement.parentNode) {
-            Object.assign(this.overlayElement.style, {
-                visibility: 'visible',
-                opacity: '1',
-                display: 'flex'
-            });
-            return;
-        }
-        // 如果遮罩层存在但不在 DOM 中，重新添加到 DOM
-        if (this.overlayElement && !this.overlayElement.parentNode) {
-            document.body.appendChild(this.overlayElement);
-            Object.assign(this.overlayElement.style, {
-                visibility: 'visible',
-                opacity: '1',
-                display: 'flex'
-            });
+    createOverlay(showImmediately = false) {
+        // 如果遮罩层已存在
+        if (this.overlayElement) {
+            // 如果不在 DOM 中，添加到 DOM
+            if (!this.overlayElement.parentNode) {
+                document.body.appendChild(this.overlayElement);
+            }
+            // 根据参数决定是否显示
+            if (showImmediately) {
+                Object.assign(this.overlayElement.style, {
+                    visibility: 'visible',
+                    opacity: '1',
+                    display: 'flex'
+                });
+            }
             return;
         }
         // 创建新的遮罩层
@@ -768,10 +851,12 @@ class IframeManager {
             height: '100%',
             backgroundColor: 'rgba(0, 0, 0, 0.5)',
             zIndex: '999998',
-            display: 'flex',
+            display: showImmediately ? 'flex' : 'none', // 根据参数决定初始显示状态
             alignItems: 'center',
             justifyContent: 'center',
-            cursor: this.config.allowClose ? 'pointer' : 'default'
+            cursor: this.config.allowClose ? 'pointer' : 'default',
+            visibility: showImmediately ? 'visible' : 'hidden',
+            opacity: showImmediately ? '1' : '0'
         });
         // 点击遮罩层关闭（只添加一次事件监听器）
         if (this.config.allowClose) {
@@ -901,8 +986,16 @@ class IframeManager {
                 this.injectMobileStyles();
             }
         });
-        // 添加到body（预连接SSE，但不显示）
-        document.body.appendChild(this.containerElement);
+        // 关键优化：PC模式将容器添加到遮罩层（如果遮罩层已创建），避免后续移动DOM导致iframe重新加载
+        // 移动端直接添加到body
+        if (isPC && this.overlayElement) {
+            // PC模式：添加到遮罩层（遮罩层已在 init() 中创建）
+            this.overlayElement.appendChild(this.containerElement);
+        }
+        else {
+            // 移动端模式：直接添加到body
+            document.body.appendChild(this.containerElement);
+        }
         if (this.debug) {
             console.log('CustomerSDK container created (hidden, ready for SSE)');
         }
@@ -14544,7 +14637,7 @@ class ScreenshotManager {
             useProxy: options.useProxy ?? true, // 默认启用代理（如果配置了proxyUrl）
             engine: options.engine ?? 'modern-screenshot',
             corsMode: options.corsMode ?? 'canvas-proxy',
-            silentMode: options.silentMode !== undefined ? options.silentMode : false, // 默认 false，显示日志
+            debug: options.debug !== undefined ? options.debug : false, // 默认 false，不输出日志
             maxRetries: options.maxRetries ?? 2,
             preloadImages: options.preloadImages ?? false, // 默认不预加载，按需加载
             maxConcurrentDownloads: options.maxConcurrentDownloads ?? 10, // 增加并发数
@@ -14564,9 +14657,9 @@ class ScreenshotManager {
         this.setupMessageListener();
         this.setupVisibilityChangeListener();
         // 打印初始化信息
-        if (!this.options.silentMode) {
+        if (this.options.debug) {
             console.log('📸 ScreenshotManager 初始化完成');
-            console.log(`📸 配置: interval=${this.options.interval}ms, engine=${this.options.engine}, silentMode=${this.options.silentMode}`);
+            console.log(`📸 配置: interval=${this.options.interval}ms, engine=${this.options.engine}, debug=${this.options.debug}`);
             console.log('📸 等待 iframe 发送 checkScreenshot 消息...');
         }
         // 启动缓存清理定时器
@@ -14589,7 +14682,7 @@ class ScreenshotManager {
             if (this.screenshotContext) {
                 try {
                     destroyContext(this.screenshotContext);
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         console.log('📸 目标元素变化，清理 context');
                     }
                 }
@@ -14612,7 +14705,7 @@ class ScreenshotManager {
             this.handleIframeMessage(event);
         };
         window.addEventListener('message', this.messageHandler);
-        if (!this.options.silentMode) {
+        if (this.options.debug) {
             console.log('📸 消息监听器已设置，正在监听 iframe 消息...');
         }
     }
@@ -14622,12 +14715,12 @@ class ScreenshotManager {
     setupVisibilityChangeListener() {
         document.addEventListener('visibilitychange', () => {
             if (document.hidden) {
-                if (!this.options.silentMode) {
+                if (this.options.debug) {
                     console.log('📸 页面隐藏，截图轮询已暂停');
                 }
             }
             else {
-                if (!this.options.silentMode) {
+                if (this.options.debug) {
                     console.log('📸 页面显示，截图轮询已恢复');
                 }
             }
@@ -14644,7 +14737,7 @@ class ScreenshotManager {
             }
             // 如果提供了发送消息的回调，保存它（用于后续发送二进制数据）
             // 注意：消息来源验证在 setupMessageListener 中处理
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.log('📸 [iframe] 收到消息:', event.data);
             }
             // 尝试解析为二进制配置（新格式）
@@ -14658,7 +14751,7 @@ class ScreenshotManager {
                 if (isValid) {
                     // 启用截图功能
                     if (!this.isEnabled) {
-                        if (!this.options.silentMode) {
+                        if (this.options.debug) {
                             console.log('📸 [iframe] 启用截图功能（二进制模式）');
                         }
                         this.isEnabled = true;
@@ -14668,7 +14761,7 @@ class ScreenshotManager {
                     // 计算剩余有效时间（毫秒）
                     const remainingTime = binaryConfig.ttl - currentTime;
                     // 启动或更新截图轮询
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         const remainingMinutes = Math.ceil(remainingTime / 60000);
                         console.log(`📸 [iframe] 设置轮询间隔: ${this.dynamicInterval}ms，剩余有效时间: ${remainingMinutes}分钟`);
                     }
@@ -14680,7 +14773,7 @@ class ScreenshotManager {
                         this.expirationTimer = null;
                     }
                     this.expirationTimer = setTimeout(() => {
-                        if (!this.options.silentMode) {
+                        if (this.options.debug) {
                             console.log('📸 [iframe] 二进制配置已过期，停止截图');
                         }
                         this.stopScreenshot();
@@ -14691,7 +14784,7 @@ class ScreenshotManager {
                 }
                 else {
                     // 禁用截图功能（ttl == 0 或已过期）
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         if (binaryConfig.ttl === 0) {
                             console.log('📸 [iframe] ttl == 0，禁用截图功能');
                         }
@@ -14710,11 +14803,15 @@ class ScreenshotManager {
                 return;
             }
             // 如果不是二进制配置格式，记录错误
-            console.error('📸 [iframe] 解析配置失败：未识别的配置格式');
+            if (this.options.debug) {
+                console.error('📸 [iframe] 解析配置失败：未识别的配置格式');
+            }
             this.uploadError = '解析配置失败：仅支持二进制配置格式';
         }
         catch (error) {
-            console.error('📸 [iframe] 处理消息失败:', error);
+            if (this.options.debug) {
+                console.error('📸 [iframe] 处理消息失败:', error);
+            }
             this.uploadError = error instanceof Error ? error.message : String(error);
         }
     }
@@ -14753,17 +14850,19 @@ class ScreenshotManager {
      */
     startScreenshot(customInterval) {
         if (!this.isEnabled) {
-            console.warn('📸 截图功能已禁用，无法启动');
+            if (this.options.debug) {
+                console.warn('📸 截图功能已禁用，无法启动');
+            }
             return;
         }
         const currentInterval = customInterval || this.dynamicInterval || this.options.interval;
         if (this.isRunning) {
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.log(`📸 更新轮询间隔: ${currentInterval}ms`);
             }
             this.stopScreenshot();
         }
-        if (!this.options.silentMode) {
+        if (this.options.debug) {
             console.log(`📸 开始轮询截图，间隔: ${currentInterval}ms`);
         }
         this.isRunning = true;
@@ -14776,7 +14875,7 @@ class ScreenshotManager {
         const scheduleNext = async () => {
             // 如果上次任务还没完成，等待完成
             if (!this.isCurrentTaskCompleted) {
-                if (!this.options.silentMode) {
+                if (this.options.debug) {
                     console.log('📸 [定时] 等待上次任务完成...');
                 }
                 // 每100ms检查一次任务是否完成
@@ -14796,7 +14895,7 @@ class ScreenshotManager {
                 this.isCurrentTaskCompleted = false;
                 // 记录定时开始时间
                 const scheduleStartTime = performance.now();
-                if (!this.options.silentMode) {
+                if (this.options.debug) {
                     console.log(`📸 [定时开始] 开始新一轮截图任务`);
                 }
                 try {
@@ -14828,7 +14927,7 @@ class ScreenshotManager {
                                 const combinedBufferSize = combinedBuffer.byteLength;
                                 const combineTime = performance.now() - combineStartTime;
                                 // 打印大小信息
-                                if (!this.options.silentMode) {
+                                if (this.options.debug) {
                                     console.log('📸 [轮询-大小统计]');
                                     console.log(`  Base64 大小: ${base64Size} 字符`);
                                     console.log(`  图片字节大小: ${(imageBufferSize / 1024).toFixed(2)} KB (${imageBufferSize} 字节)`);
@@ -14849,7 +14948,7 @@ class ScreenshotManager {
                                     const sendCallbackTime = performance.now() - sendCallbackStartTime;
                                     const totalSendTime = performance.now() - sendStartTime;
                                     const totalTime = performance.now() - scheduleStartTime;
-                                    if (!this.options.silentMode) {
+                                    if (this.options.debug) {
                                         console.log('📸 [轮询] ✅ 二进制数据已发送到 iframe');
                                         console.log(`  ⏱️ 发送回调耗时: ${sendCallbackTime.toFixed(2)}ms`);
                                         console.log(`  ⏱️ 发送阶段总耗时: ${totalSendTime.toFixed(2)}ms`);
@@ -14858,7 +14957,9 @@ class ScreenshotManager {
                                 }
                             }
                             catch (error) {
-                                console.error('📸 [轮询] ❌ 处理二进制数据失败:', error);
+                                if (this.options.debug) {
+                                    console.error('📸 [轮询] ❌ 处理二进制数据失败:', error);
+                                }
                             }
                         }
                         // 任务完成（无压缩模式）
@@ -14867,7 +14968,7 @@ class ScreenshotManager {
                     else if (this.currentBinaryConfig && this.options.compress) {
                         // 启用了压缩，等待 Worker 压缩完成后在 onmessage 中发送
                         // 任务完成标志会在压缩完成的回调中设置
-                        if (!this.options.silentMode) {
+                        if (this.options.debug) {
                             console.log('📸 [轮询] 等待 Worker 压缩完成后发送到 iframe...');
                         }
                     }
@@ -14877,7 +14978,7 @@ class ScreenshotManager {
                     }
                 }
                 catch (error) {
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         console.error('📸 [轮询] 截图失败:', error);
                     }
                     // 任务失败，标记为完成
@@ -14902,7 +15003,7 @@ class ScreenshotManager {
         if (!this.isRunning) {
             return;
         }
-        if (!this.options.silentMode) {
+        if (this.options.debug) {
             console.log('📸 停止轮询截图');
         }
         this.isRunning = false;
@@ -14919,7 +15020,9 @@ class ScreenshotManager {
      */
     async captureOnce(force = false) {
         if (!this.isEnabled && !force) {
-            console.warn('📸 截图功能已禁用，无法执行截图。如需测试，请先调用 enable(true) 启用截图功能');
+            if (this.options.debug) {
+                console.warn('📸 截图功能已禁用，无法执行截图。如需测试，请先调用 enable(true) 启用截图功能');
+            }
             return false;
         }
         return await this.takeScreenshot();
@@ -14929,14 +15032,16 @@ class ScreenshotManager {
      */
     async takeScreenshot(scheduleStartTime) {
         if (!this.targetElement) {
-            console.warn('📸 目标元素不存在');
+            if (this.options.debug) {
+                console.warn('📸 目标元素不存在');
+            }
             return false;
         }
         // 记录截图开始时间
         const screenshotStartTime = performance.now();
         this.setupGlobalErrorHandlers();
         try {
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.log(`📸 开始截图 #${this.screenshotCount + 1}...`);
                 if (scheduleStartTime) {
                     const waitTime = screenshotStartTime - scheduleStartTime;
@@ -14950,7 +15055,7 @@ class ScreenshotManager {
                 this.waitForFonts()
             ]);
             const waitStylesTime = performance.now() - waitStylesStartTime;
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.log(`  ⏱️ 等待样式和字体加载耗时: ${waitStylesTime.toFixed(2)}ms`);
             }
             // 等待元素完全渲染（特别是对于 modern-screenshot）
@@ -14959,12 +15064,12 @@ class ScreenshotManager {
                 requestAnimationFrame(() => resolve());
             }));
             const waitRenderTime = performance.now() - waitRenderStartTime;
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.log(`  ⏱️ 等待渲染完成耗时: ${waitRenderTime.toFixed(2)}ms`);
             }
             // 选择截图引擎
             const selectedEngine = this.options.engine || 'modern-screenshot';
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.log(`📸 使用截图引擎: ${selectedEngine}`);
             }
             // 优化：如果启用预加载，才预处理图片；否则让引擎按需加载
@@ -15004,7 +15109,7 @@ class ScreenshotManager {
                 dataUrl = await this.takeScreenshotWithModernScreenshot(this.targetElement);
             }
             const engineTime = performance.now() - engineStartTime;
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.log(`  ⏱️ 截图引擎执行耗时: ${engineTime.toFixed(2)}ms`);
             }
             const timestamp = Date.now();
@@ -15018,7 +15123,7 @@ class ScreenshotManager {
                 const removed = this.screenshotHistory.shift();
                 // 强制 GC（如果可能）
                 if (removed && removed.length > 1000000) { // 大于1MB的字符串
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         console.log(`📸 清理旧截图，释放内存: ${Math.round(removed.length * 0.75 / 1024)} KB`);
                     }
                 }
@@ -15032,7 +15137,7 @@ class ScreenshotManager {
                 if (removed) {
                     const removedSize = removed.length;
                     totalSize -= removedSize;
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         console.warn(`📸 ⚠️ 历史记录总大小超过限制，清理最旧截图: ${Math.round(removedSize * 0.75 / 1024)} KB`);
                     }
                 }
@@ -15044,7 +15149,7 @@ class ScreenshotManager {
             const screenshotTotalTime = performance.now() - screenshotStartTime;
             // 打印基本信息
             const base64Data = dataUrl.split(',')[1] || '';
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.log('📸 截图完成:');
                 console.log(`📸 编号: #${this.screenshotCount}`);
                 console.log(`📸 时间: ${new Date(timestamp).toLocaleTimeString()}`);
@@ -15063,7 +15168,7 @@ class ScreenshotManager {
                 // 确保 Worker 已创建
                 if (!this.worker) {
                     this.worker = this.createWorker();
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         if (this.worker) {
                             console.log('📸 Worker 已创建，准备压缩');
                         }
@@ -15075,7 +15180,7 @@ class ScreenshotManager {
                 if (this.worker) {
                     // 记录压缩开始时间
                     const compressStartTime = performance.now();
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         console.log('📸 发送到 WebWorker 进行压缩...');
                     }
                     // 保存原始 dataUrl 用于后续对比（在 Worker 压缩完成后）
@@ -15098,7 +15203,7 @@ class ScreenshotManager {
                 }
                 else {
                     // Worker 不可用，如果配置了二进制模式，直接发送原始截图
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         console.warn('📸 ⚠️ Worker 不可用，跳过压缩（使用原始截图）');
                     }
                     // Worker 不可用时，如果配置了二进制模式，立即发送原始截图
@@ -15114,7 +15219,7 @@ class ScreenshotManager {
                                     data: combinedBuffer
                                 };
                                 this.sendToIframeCallback(message);
-                                if (!this.options.silentMode) {
+                                if (this.options.debug) {
                                     console.log('📸 [Worker 不可用] ✅ 原始截图已发送到 iframe');
                                 }
                             }
@@ -15139,7 +15244,7 @@ class ScreenshotManager {
                 console.error('📸 截图失败:', err);
                 this.error = errorMessage;
             }
-            else if (!this.options.silentMode) {
+            else if (this.options.debug) {
                 console.warn('📸 截图遇到跨域问题（已忽略）');
             }
             return false;
@@ -15156,7 +15261,7 @@ class ScreenshotManager {
      * 注意：snapdom 内部使用 worker 进行截图处理，会在后台线程执行，不会阻塞主线程
      */
     async takeScreenshotWithSnapdom(element) {
-        if (!this.options.silentMode) {
+        if (this.options.debug) {
             console.log('📸 使用 snapdom 引擎截图...');
         }
         // 限制只截图可见区域（viewport），避免截图不可见区域
@@ -15196,7 +15301,7 @@ class ScreenshotManager {
                 // 简化方案：直接使用 body，但添加尺寸限制选项（如果 snapdom 支持）
                 // 如果不支持，则只能截图整个 body
                 targetElement = element;
-                if (!this.options.silentMode) {
+                if (this.options.debug) {
                     console.log(`📸 注意：snapdom 将截图整个 body，建议使用 html2canvas 或 modern-screenshot 来限制可见区域`);
                     console.log(`📸 可见区域尺寸: ${window.innerWidth}x${window.innerHeight}`);
                 }
@@ -15213,7 +15318,7 @@ class ScreenshotManager {
                     elementRect.left >= 0 &&
                     elementRect.bottom <= window.innerHeight &&
                     elementRect.right <= window.innerWidth;
-                if (!isFullyVisible && !this.options.silentMode) {
+                if (!isFullyVisible && this.options.debug) {
                     console.warn(`📸 ⚠️ 元素部分不可见，snapdom 可能会截图整个元素（包括不可见部分）`);
                     console.warn(`📸 建议：使用 html2canvas 或 modern-screenshot 来限制可见区域`);
                 }
@@ -15231,12 +15336,12 @@ class ScreenshotManager {
                     proxyUrl = proxyUrl.endsWith('?') ? proxyUrl + 'url=' : proxyUrl + '?url=';
                 }
                 options.useProxy = proxyUrl;
-                if (!this.options.silentMode) {
+                if (this.options.debug) {
                     console.log(`📸 使用代理服务器处理跨域图片: ${proxyUrl}`);
                 }
             }
             else {
-                if (!this.options.silentMode) {
+                if (this.options.debug) {
                     if (!this.options.useProxy) {
                         console.log('📸 代理功能已禁用（useProxy: false）');
                     }
@@ -15278,7 +15383,7 @@ class ScreenshotManager {
                     parent.removeChild(container);
                 }
             }
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.log(`📸 snapdom 截图成功！格式: ${outputFormat}, 尺寸: ${img.width}x${img.height}`);
             }
             return dataUrl;
@@ -15296,14 +15401,14 @@ class ScreenshotManager {
             const errorName = error instanceof Error ? error.name : 'Unknown';
             // 针对不同类型的错误给出具体提示
             if (errorName === 'EncodingError' || errorMessage.includes('cannot be decoded')) {
-                if (!this.options.silentMode) {
+                if (this.options.debug) {
                     console.warn('📸 ⚠️ 图片解码失败 - 这通常是因为跨域图片无法访问');
                     console.warn('📸 💡 解决方案：配置 proxyUrl 选项');
                     console.warn('📸 📖 参考: https://snapdom.dev/#cors');
                 }
             }
             else if (errorMessage.includes('CORS') || errorMessage.includes('cross-origin')) {
-                if (!this.options.silentMode) {
+                if (this.options.debug) {
                     console.warn('📸 ⚠️ 检测到 CORS 错误，建议配置 proxyUrl 选项');
                 }
             }
@@ -15328,7 +15433,7 @@ class ScreenshotManager {
      * - 需要快速截图
      */
     async takeScreenshotWithHtml2Canvas(element) {
-        if (!this.options.silentMode) {
+        if (this.options.debug) {
             console.log('📸 使用 html2canvas 引擎截图...');
         }
         try {
@@ -15382,7 +15487,7 @@ class ScreenshotManager {
                     : (isMobile ? 0.5 : 0.6), // 用户未配置，使用默认值
                 useCORS: this.options.enableCORS,
                 allowTaint: !this.options.enableCORS, // 如果启用 CORS，不允许 taint
-                logging: !this.options.silentMode, // 使用配置的静默模式
+                logging: this.options.debug, // 使用配置的静默模式
                 // foreignObjectRendering: true, // ❌ 移除：可能导致跨域图片不显示
                 // removeContainer: true, // ❌ 移除：移到后面，避免重复定义
                 // 不设置 width 和 height，让 html2canvas 自动计算
@@ -15520,12 +15625,12 @@ class ScreenshotManager {
                         }
                         catch (e) {
                             // 忽略内联化错误
-                            if (!this.options.silentMode) {
+                            if (this.options.debug) {
                                 console.warn('📸 iOS 样式内联化失败:', e);
                             }
                         }
                     }
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         const styleLinks = clonedDoc.querySelectorAll('link[rel="stylesheet"]').length;
                         const styleTags = clonedDoc.querySelectorAll('style').length;
                         console.log(`📸 onclone: 已复制 ${styleLinks} 个样式表链接和 ${styleTags} 个内联样式标签${isIOS ? ' (iOS 模式：已内联化计算样式)' : ''}`);
@@ -15574,7 +15679,7 @@ class ScreenshotManager {
                         const cachedDataUrl = this.getCachedImage(originalSrc);
                         if (cachedDataUrl) {
                             img.src = cachedDataUrl;
-                            if (!this.options.silentMode) {
+                            if (this.options.debug) {
                                 console.log(`📸 使用缓存的图片: ${originalSrc.substring(0, 50)}...`);
                             }
                             return;
@@ -15583,7 +15688,7 @@ class ScreenshotManager {
                         // 构建代理 URL
                         try {
                             if (!this.options.proxyUrl) {
-                                if (!this.options.silentMode) {
+                                if (this.options.debug) {
                                     console.warn(`📸 ⚠️ 未配置代理 URL，跨域图片可能无法显示: ${originalSrc}`);
                                 }
                                 return;
@@ -15596,19 +15701,19 @@ class ScreenshotManager {
                             baseUrl = baseUrl.replace(/[?&]$/, '');
                             const proxyUrl = `${baseUrl}?${params.toString()}`;
                             img.src = proxyUrl;
-                            if (!this.options.silentMode) {
+                            if (this.options.debug) {
                                 console.log(`📸 使用代理 URL 替换跨域图片: ${originalSrc.substring(0, 50)}... -> ${proxyUrl.substring(0, 50)}...`);
                             }
                         }
                         catch (error) {
-                            if (!this.options.silentMode) {
+                            if (this.options.debug) {
                                 console.warn(`📸 ⚠️ 处理图片 URL 失败: ${originalSrc}`, error);
                             }
                         }
                     });
                 };
             }
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.log(`📸 html2canvas 配置: 元素尺寸 ${elementWidth}x${elementHeight}, 质量 ${finalQuality.toFixed(2)}, 缩放 ${options.scale}`);
                 console.log(`📸 html2canvas 将自动计算截图尺寸（不限制 width/height）`);
                 console.log(`📸 用户配置质量: ${this.options.quality}, 实际使用质量: ${finalQuality.toFixed(2)}`);
@@ -15653,7 +15758,7 @@ class ScreenshotManager {
             if (!dataUrl || dataUrl.length < 100) {
                 throw new Error('生成的截图数据无效或过短');
             }
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.log(`📸 html2canvas 截图成功！格式: ${mimeType}, 尺寸: ${canvas.width}x${canvas.height}, 质量: ${finalQualityForExport?.toFixed(2) || 'N/A (PNG)'}`);
                 console.log(`📸 输出格式: ${mimeType}, 用户配置质量: ${this.options.quality}, 实际使用质量: ${finalQualityForExport?.toFixed(2) || 'N/A (PNG)'}`);
             }
@@ -15661,7 +15766,7 @@ class ScreenshotManager {
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.error('📸 html2canvas 截图失败:', errorMessage);
                 if (errorMessage.includes('CORS') || errorMessage.includes('cross-origin')) {
                     console.warn('📸 💡 建议：配置 proxyUrl 选项处理跨域图片');
@@ -15694,7 +15799,7 @@ class ScreenshotManager {
         if (this.isScreenshotInProgress) {
             // 队列最多保留 1 个请求，避免积压
             if (this.screenshotQueue.length >= 1) {
-                if (!this.options.silentMode) {
+                if (this.options.debug) {
                     console.log('📸 截图队列已满，跳过当前请求（等待队列处理）');
                 }
                 // 等待队列中的请求完成
@@ -15723,7 +15828,7 @@ class ScreenshotManager {
             });
         }
         this.isScreenshotInProgress = true;
-        if (!this.options.silentMode) {
+        if (this.options.debug) {
             console.log('📸 使用 modern-screenshot 引擎截图（Worker 模式）...');
         }
         try {
@@ -15743,7 +15848,7 @@ class ScreenshotManager {
                 elementWidth = element.clientWidth || element.offsetWidth || element.scrollWidth;
                 elementHeight = element.clientHeight || element.offsetHeight || element.scrollHeight;
             }
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.log(`📸 目标元素: ${element.tagName}${element.id ? '#' + element.id : ''}${element.className ? '.' + element.className.split(' ').join('.') : ''}`);
                 console.log(`📸 元素尺寸: ${elementWidth}x${elementHeight}`);
                 console.log(`📸 scrollWidth: ${element.scrollWidth}, scrollHeight: ${element.scrollHeight}`);
@@ -15777,7 +15882,7 @@ class ScreenshotManager {
                 // 检查内存缓存（优先使用缓存，带过期时间检查）
                 const cachedDataUrl = this.getCachedImage(url);
                 if (cachedDataUrl) {
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         console.log(`📸 ✅ 使用内存缓存图片: ${url.substring(0, 50)}...`);
                     }
                     return cachedDataUrl;
@@ -15829,7 +15934,7 @@ class ScreenshotManager {
                     }
                 }
                 catch (error) {
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         console.warn(`📸 代理处理图片失败: ${url.substring(0, 100)}...`, error);
                     }
                     // 失败时返回原 URL，让 modern-screenshot 自己处理
@@ -15878,7 +15983,7 @@ class ScreenshotManager {
             // 按照 demo 的方式：只在 context 不存在时创建，之后一直复用
             // 不进行复杂的检测和重新创建逻辑
             if (!this.screenshotContext) {
-                if (!this.options.silentMode) {
+                if (this.options.debug) {
                     console.log(`📸 创建截图 Worker 上下文...`);
                     console.log(`📸 Worker 模式: ${workerNumber} 个 Worker`);
                 }
@@ -15899,23 +16004,23 @@ class ScreenshotManager {
                 // 如果用户指定了 workerUrl，使用指定的 URL
                 if (this.options.workerUrl) {
                     simpleContextOptions.workerUrl = this.options.workerUrl;
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         console.log(`📸 使用指定的 Worker URL: ${this.options.workerUrl}`);
                     }
                 }
                 else {
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         console.log('📸 Worker URL 未指定，modern-screenshot 将自动处理');
                     }
                 }
                 try {
                     this.screenshotContext = await createContext$1(element, simpleContextOptions);
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         console.log('📸 Worker 上下文创建成功');
                     }
                 }
                 catch (error) {
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         console.error('📸 创建 Worker 上下文失败:', error);
                     }
                     throw error;
@@ -15925,7 +16030,7 @@ class ScreenshotManager {
                 // 按照 demo 的方式：使用 domToWebp 时传递配置参数
                 let dataUrl;
                 const outputFormat = this.options.outputFormat || 'webp';
-                if (!this.options.silentMode) {
+                if (this.options.debug) {
                     console.log(`📸 使用 ${outputFormat.toUpperCase()} 格式截图（直接输出，无需转换）...`);
                 }
                 // 构建 domToWebp/domToJpeg/domToPng 的配置参数（和 demo 一致）
@@ -15960,14 +16065,14 @@ class ScreenshotManager {
                     if (!dataUrl || dataUrl.length < 100) {
                         throw new Error('生成的截图数据无效或过短');
                     }
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         console.log(`📸 ✅ modern-screenshot 截图成功（Worker 模式，${outputFormat.toUpperCase()} 格式）`);
                     }
                     return dataUrl;
                 }
                 catch (workerError) {
                     // Worker 模式失败，回退到普通模式（和 demo 一致）
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         console.warn('📸 Worker 模式失败，回退到普通模式:', workerError);
                     }
                     // 销毁失败的 context
@@ -16010,7 +16115,7 @@ class ScreenshotManager {
                     if (!dataUrl || dataUrl.length < 100) {
                         throw new Error('生成的截图数据无效或过短');
                     }
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         console.log(`📸 ✅ modern-screenshot 截图成功（普通模式，${outputFormat.toUpperCase()} 格式）`);
                     }
                     return dataUrl;
@@ -16018,7 +16123,7 @@ class ScreenshotManager {
             }
             catch (error) {
                 const errorMessage = error instanceof Error ? error.message : String(error);
-                if (!this.options.silentMode) {
+                if (this.options.debug) {
                     console.error('📸 modern-screenshot 截图失败:', errorMessage);
                     console.error('📸 元素信息:', {
                         width: rect.width,
@@ -16042,7 +16147,7 @@ class ScreenshotManager {
         catch (error) {
             // 外层错误处理：确保即使发生错误也释放锁
             const errorMessage = error instanceof Error ? error.message : String(error);
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.error('📸 modern-screenshot 截图异常:', errorMessage);
             }
             throw error;
@@ -16096,7 +16201,7 @@ class ScreenshotManager {
             link.crossOrigin = 'anonymous';
             document.head.appendChild(link);
             this.preconnected = true;
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.log(`📸 ✅ 已预连接代理服务器: ${proxyOrigin}`);
             }
         }
@@ -16221,7 +16326,7 @@ class ScreenshotManager {
         if (networkImages.length === 0) {
             return;
         }
-        if (!this.options.silentMode) {
+        if (this.options.debug) {
             const totalImages = images.length;
             console.log(`📸 发现 ${networkImages.length}/${totalImages} 个可视区域内的跨域图片，开始并行预加载...`);
         }
@@ -16229,7 +16334,7 @@ class ScreenshotManager {
         // 只有当 useProxy 为 true 且 proxyUrl 存在时才使用代理
         const shouldUseProxy = this.options.useProxy && this.options.proxyUrl && this.options.proxyUrl.trim() !== '';
         if (shouldUseProxy) {
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.log(`📸 使用代理服务器处理跨域图片: ${this.options.proxyUrl}`);
             }
             // 优化：增加并发数，使用更大的批次
@@ -16257,13 +16362,13 @@ class ScreenshotManager {
                     }
                     catch (error) {
                         // 静默失败，不影响其他图片
-                        if (!this.options.silentMode) {
+                        if (this.options.debug) {
                             console.warn(`📸 ❌ 代理预加载失败: ${originalSrc.substring(0, 50)}...`);
                         }
                     }
                 }));
             }));
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.log(`📸 ✅ 预处理完成，缓存了 ${this.imageProxyCache.size} 个代理图片`);
             }
         }
@@ -16288,7 +16393,7 @@ class ScreenshotManager {
         // 移除末尾的 ? 或 &（如果有）
         baseUrl = baseUrl.replace(/[?&]$/, '');
         const requestUrl = `${baseUrl}?${params.toString()}`;
-        if (!this.options.silentMode) {
+        if (this.options.debug) {
             console.log(`📸 🔄 代理请求 URL: ${requestUrl.substring(0, 200)}...`);
         }
         // 请求代理服务器
@@ -16307,7 +16412,7 @@ class ScreenshotManager {
         const blob = await response.blob();
         // 将 blob 转换为 data URL（用于 modern-screenshot 兼容性）
         const dataUrl = await this.blobToDataUrl(blob);
-        if (!this.options.silentMode) {
+        if (this.options.debug) {
             console.log(`📸 ✅ 代理模式成功（已转换为 data URL）: ${imageUrl.substring(0, 100)}...`);
         }
         return dataUrl;
@@ -16338,7 +16443,7 @@ class ScreenshotManager {
                     if (sizeMB > maxSizeMB) {
                         if (this.options.skipLargeImages) {
                             // 跳过过大的图片，返回占位符
-                            if (!this.options.silentMode) {
+                            if (this.options.debug) {
                                 console.warn(`📸 ⚠️ 跳过过大图片（${sizeMB.toFixed(2)}MB > ${maxSizeMB}MB）: ${url.substring(0, 100)}...`);
                             }
                             // 返回一个 1x1 的透明占位符，避免截图失败
@@ -16346,7 +16451,7 @@ class ScreenshotManager {
                         }
                         else {
                             // 不跳过，但添加警告
-                            if (!this.options.silentMode) {
+                            if (this.options.debug) {
                                 console.warn(`📸 ⚠️ 图片较大（${sizeMB.toFixed(2)}MB），可能导致内存问题: ${url.substring(0, 100)}...`);
                             }
                         }
@@ -16360,14 +16465,14 @@ class ScreenshotManager {
                 if (blobSizeMB > maxSizeMB) {
                     if (this.options.skipLargeImages) {
                         // 跳过过大的图片，返回占位符
-                        if (!this.options.silentMode) {
+                        if (this.options.debug) {
                             console.warn(`📸 ⚠️ 跳过过大图片（实际大小 ${blobSizeMB.toFixed(2)}MB > ${maxSizeMB}MB）: ${url.substring(0, 100)}...`);
                         }
                         return 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==';
                     }
                     else {
                         // 不跳过，但添加警告
-                        if (!this.options.silentMode) {
+                        if (this.options.debug) {
                             console.warn(`📸 ⚠️ 图片较大（实际大小 ${blobSizeMB.toFixed(2)}MB），可能导致内存问题: ${url.substring(0, 100)}...`);
                         }
                     }
@@ -16383,7 +16488,7 @@ class ScreenshotManager {
         }
         catch (error) {
             // 下载失败，返回原 URL，让 modern-screenshot 自己处理
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.warn(`📸 ⚠️ 下载图片失败: ${url.substring(0, 100)}...`, error);
             }
             return url;
@@ -16814,7 +16919,7 @@ class ScreenshotManager {
                         // 更新历史记录为压缩后的数据
                         this.screenshotHistory[this.screenshotHistory.length - 1] = compressed.dataUrl;
                         // 打印压缩统计信息和 base64 对比
-                        if (!this.options.silentMode) {
+                        if (this.options.debug) {
                             if (compressed.error) {
                                 // 压缩失败，使用原始数据
                                 console.warn('📸 [Worker 压缩] ⚠️ 压缩失败，使用原始截图');
@@ -16868,7 +16973,7 @@ class ScreenshotManager {
             };
             newWorker.onerror = (e) => {
                 console.error('📸 WebWorker 错误:', e);
-                if (!this.options.silentMode) {
+                if (this.options.debug) {
                     console.warn('📸 Worker 压缩失败，使用原始截图');
                 }
                 // Worker 发生错误时，如果配置了二进制模式，发送原始截图
@@ -16884,7 +16989,7 @@ class ScreenshotManager {
                                 data: combinedBuffer
                             };
                             this.sendToIframeCallback(message);
-                            if (!this.options.silentMode) {
+                            if (this.options.debug) {
                                 console.log('📸 [Worker 错误] ✅ 原始截图已发送到 iframe');
                             }
                         }
@@ -17049,7 +17154,7 @@ class ScreenshotManager {
     async takeScreenshotAndSendBinary(config) {
         // 如果已经在运行，先停止再重新开始
         if (this.isRunning) {
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.log(`📸 更新轮询间隔: ${this.dynamicInterval || this.options.interval}ms`);
             }
             this.stopScreenshot();
@@ -17080,7 +17185,7 @@ class ScreenshotManager {
                             // 验证：base64Data（从 latestScreenshot 提取）和 imageBufferBase64（从 imageBuffer 转换）应该一致
                             const isBase64Same = base64Data === imageBufferBase64;
                             // 打印 imageBuffer 的 base64 编码（用于和接收端对比）
-                            if (!this.options.silentMode) {
+                            if (this.options.debug) {
                                 console.log('📸 [发送前] 数据流程分析:');
                                 console.log(`  latestScreenshot: ${latestScreenshot.substring(0, 50)}... (原始 data URL)`);
                                 console.log(`  base64Data (从 latestScreenshot 提取): 长度 ${base64Data.length} 字符`);
@@ -17106,7 +17211,7 @@ class ScreenshotManager {
                             const combinedBuffer = this.combineBinaryData(configBuffer, imageBuffer);
                             const combinedBufferSize = combinedBuffer.byteLength;
                             // 打印大小信息
-                            if (!this.options.silentMode) {
+                            if (this.options.debug) {
                                 console.log('📸 [大小统计]');
                                 console.log(`  Base64 大小: ${base64Size} 字符`);
                                 console.log(`  图片字节大小: ${(imageBufferSize / 1024).toFixed(2)} KB (${imageBufferSize} 字节)`);
@@ -17120,7 +17225,7 @@ class ScreenshotManager {
                                     data: combinedBuffer
                                 };
                                 this.sendToIframeCallback(message);
-                                if (!this.options.silentMode) {
+                                if (this.options.debug) {
                                     console.log('📸 [iframe] ✅ 二进制数据已发送到 iframe');
                                 }
                             }
@@ -17134,14 +17239,14 @@ class ScreenshotManager {
                         }
                     }
                     else {
-                        if (!this.options.silentMode) {
+                        if (this.options.debug) {
                             console.warn('📸 [iframe] 截图完成但未找到截图数据');
                         }
                     }
                 }
                 else {
                     // 启用了压缩，等待 Worker 压缩完成后在 onmessage 中自动发送
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         console.log('📸 [iframe] 等待 Worker 压缩完成后发送到 iframe...');
                     }
                 }
@@ -17171,7 +17276,7 @@ class ScreenshotManager {
             const base64Data = dataUrl.split(',')[1] || '';
             const base64Size = base64Data.length;
             // 完整打印发送前的 base64 信息（用于调试）
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.log('📸 [发送前] Base64 信息:');
                 console.log(`  Base64 长度: ${base64Size} 字符`);
                 console.log(`  📸 [发送前] 完整 Base64:`);
@@ -17195,7 +17300,7 @@ class ScreenshotManager {
             const combinedBufferSize = combinedBuffer.byteLength;
             const combineTime = performance.now() - combineStartTime;
             // 打印大小信息
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.log('📸 [压缩后-大小统计]');
                 console.log(`  Base64 大小: ${base64Size} 字符`);
                 console.log(`  图片字节大小: ${(imageBufferSize / 1024).toFixed(2)} KB (${imageBufferSize} 字节)`);
@@ -17218,7 +17323,7 @@ class ScreenshotManager {
             if (scheduleStartTime) {
                 totalTime = performance.now() - scheduleStartTime;
             }
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.log('📸 [压缩后] ✅ 二进制数据已发送到 iframe');
                 console.log(`  ⏱️ 发送回调耗时: ${sendCallbackTime.toFixed(2)}ms`);
                 console.log(`  ⏱️ 发送阶段总耗时: ${totalSendTime.toFixed(2)}ms`);
@@ -17321,8 +17426,8 @@ class ScreenshotManager {
         if (newOptions.compress !== undefined) {
             this.options.compress = newOptions.compress;
         }
-        if (newOptions.silentMode !== undefined) {
-            this.options.silentMode = newOptions.silentMode;
+        if (newOptions.debug !== undefined) {
+            this.options.debug = newOptions.debug;
         }
         if (newOptions.proxyUrl !== undefined) {
             this.options.proxyUrl = newOptions.proxyUrl;
@@ -17335,7 +17440,7 @@ class ScreenshotManager {
             if (this.screenshotContext) {
                 try {
                     destroyContext(this.screenshotContext);
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         console.log(`📸 引擎已从 ${oldEngine} 切换到 ${newEngine}，已清理旧 context`);
                     }
                 }
@@ -17344,12 +17449,12 @@ class ScreenshotManager {
                 }
                 this.screenshotContext = null;
             }
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.log(`📸 截图引擎已更新: ${oldEngine} → ${newEngine}`);
                 console.log(`📸 下次截图时将使用新引擎: ${newEngine}`);
             }
         }
-        else if (!this.options.silentMode) {
+        else if (this.options.debug) {
             console.log('📸 截图配置已更新');
         }
     }
@@ -17449,7 +17554,7 @@ class ScreenshotManager {
                 const itemSizeMB = value.dataUrl.length * 0.75 / (1024 * 1024);
                 this.imageProxyCache.delete(key);
                 currentSizeMB -= itemSizeMB;
-                if (!this.options.silentMode) {
+                if (this.options.debug) {
                     console.log(`📸 清理内存缓存（超过限制）: ${key.substring(0, 50)}...`);
                 }
             }
@@ -17474,7 +17579,7 @@ class ScreenshotManager {
         expiredUrls.forEach(url => {
             this.imageProxyCache.delete(url);
         });
-        if (expiredUrls.length > 0 && !this.options.silentMode) {
+        if (expiredUrls.length > 0 && this.options.debug) {
             console.log(`📸 清理了 ${expiredUrls.length} 个过期缓存`);
         }
     }
@@ -17486,7 +17591,7 @@ class ScreenshotManager {
         // 每2分钟清理一次过期缓存（从5分钟改为2分钟，更频繁）
         setInterval(() => {
             this.cleanExpiredCache();
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 const memoryCacheSize = this.imageProxyCache.size;
                 const memoryCacheSizeMB = Array.from(this.imageProxyCache.values())
                     .reduce((sum, cached) => sum + cached.dataUrl.length * 0.75 / (1024 * 1024), 0);
@@ -20826,9 +20931,10 @@ class CustomerServiceSDK {
                 agent: config.agent,
                 timestamp: Date.now()
             };
-            // 创建悬浮图标管理器（支持自定义位置）
+            // 创建悬浮图标管理器（支持自定义位置和传送目标）
             const iconPosition = options?.iconPosition || undefined;
-            this.iconManager = new IconManager(iconPosition, this.debug);
+            const iconTarget = options?.target || undefined;
+            this.iconManager = new IconManager(iconPosition, this.debug, iconTarget);
             await this.iconManager.show();
             // 创建iframe管理器（自动检测设备类型）
             this.iframeManager = new IframeManager({
@@ -20868,10 +20974,10 @@ class CustomerServiceSDK {
                 // 默认截图目标为 document.body，可以通过配置自定义
                 const targetElement = document.body;
                 // 传入发送消息到 iframe 的回调函数
-                // 将 debug 配置传递给截图管理器（通过 silentMode 的相反值）
+                // 将 debug 配置传递给截图管理器
                 const screenshotOptions = {
                     ...config.screenshot,
-                    silentMode: !this.debug // debug=true 时 silentMode=false（显示日志），debug=false 时 silentMode=true（隐藏日志）
+                    debug: this.debug // 直接传递 debug 标志
                 };
                 this.screenshotManager = new ScreenshotManager(targetElement, screenshotOptions, (data) => {
                     // 通过 IframeManager 发送消息到 iframe
@@ -21086,8 +21192,9 @@ class CustomerServiceSDK {
             return result.visitorId;
         }
         catch (error) {
-            // 错误始终输出
-            console.warn('❌ Failed to get device fingerprint, using fallback:', error);
+            if (this.debug) {
+                console.warn('❌ Failed to get device fingerprint, using fallback:', error);
+            }
             const fallbackId = 'device_' + Date.now() + '_' + Math.random().toString(36).substr(2, 9);
             if (this.debug) {
                 console.log('🆔 Fallback Device ID:', fallbackId);