customer-chat-sdk 1.1.0 → 1.1.2

package/dist/customer-sdk.esm.js

@@ -1,7 +1,7 @@
 // 直接使用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;
@@ -13,10 +13,17 @@ class IconManager {
         this.iconStartY = 0;
         this.dragMoveHandler = null;
         this.dragEndHandler = null;
+        this.checkDragHandler = null; // 临时拖动检测监听器
+        this.dragStartHandler = null; // 拖动开始事件监听器
+        this.touchStartHandler = null; // 触摸开始事件监听器
         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;
     }
     /**
      * 显示悬浮图标
@@ -30,7 +37,7 @@ class IconManager {
         this.iconElement.className = 'customer-sdk-icon';
         // 直接设置样式 - 图标容器
         const defaultStyle = {
-            position: 'fixed',
+            position: 'absolute',
             width: '30px',
             height: '30px',
             backgroundColor: 'transparent', // 移除背景色，让图片直接显示
@@ -39,7 +46,7 @@ class IconManager {
             alignItems: 'center',
             justifyContent: 'center',
             cursor: 'pointer',
-            zIndex: '999999',
+            zIndex: '1000002', // 确保图标始终在最上层（遮罩层 999998，iframe 容器 999999）
             boxShadow: '0 4px 12px rgba(0, 0, 0, 0.15)',
             userSelect: 'none',
             transition: 'transform 0.2s ease',
@@ -115,8 +122,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');
         }
@@ -266,9 +283,11 @@ class IconManager {
         // 绑定事件处理器（用于后续清理）
         this.dragMoveHandler = this.handleDragMove.bind(this);
         this.dragEndHandler = this.handleDragEnd.bind(this);
-        // 只在图标上监听开始事件
-        this.iconElement.addEventListener('mousedown', this.handleDragStart.bind(this));
-        this.iconElement.addEventListener('touchstart', this.handleDragStart.bind(this), { passive: false });
+        this.dragStartHandler = this.handleDragStart.bind(this);
+        // 只在图标上监听开始事件（保存引用以便后续移除）
+        this.iconElement.addEventListener('mousedown', this.dragStartHandler);
+        this.touchStartHandler = this.handleDragStart.bind(this);
+        this.iconElement.addEventListener('touchstart', this.touchStartHandler, { passive: false });
     }
     /**
      * 开始拖动
@@ -291,12 +310,33 @@ class IconManager {
         const rect = this.iconElement.getBoundingClientRect();
         this.iconStartX = rect.left;
         this.iconStartY = rect.top;
-        // 添加拖动样式
-        this.iconElement.style.transition = 'none';
-        this.iconElement.style.cursor = 'grabbing';
+        // 注意：不要在这里立即移除 transition 和设置 cursor
+        // 只有在真正开始拖动时才修改样式，避免点击时图标位置跳动
         // 只在真正开始拖动时添加document事件监听
         // 先添加一个临时的move监听器来检测是否真的在拖动
         const checkDrag = (moveEvent) => {
+            // 检测事件目标：如果事件发生在iframe或其他元素上，停止检测拖动
+            const target = moveEvent.target;
+            if (target && target !== this.iconElement && !this.iconElement?.contains(target)) {
+                // 检查是否是iframe相关元素
+                const isIframeElement = target.tagName === 'IFRAME' ||
+                    target.closest('iframe') ||
+                    target.closest('.customer-sdk-container') ||
+                    target.closest('.customer-sdk-overlay');
+                if (isIframeElement) {
+                    // 如果事件发生在iframe相关元素上，停止检测并清理监听器
+                    if (this.checkDragHandler) {
+                        if ('touches' in moveEvent) {
+                            document.removeEventListener('touchmove', this.checkDragHandler);
+                        }
+                        else {
+                            document.removeEventListener('mousemove', this.checkDragHandler);
+                        }
+                        this.checkDragHandler = null;
+                    }
+                    return;
+                }
+            }
             const moveX = 'touches' in moveEvent ? moveEvent.touches[0].clientX : moveEvent.clientX;
             const moveY = 'touches' in moveEvent ? moveEvent.touches[0].clientY : moveEvent.clientY;
             const deltaX = moveX - this.dragStartX;
@@ -304,12 +344,20 @@ class IconManager {
             // 如果移动距离超过5px，开始拖动
             if (Math.abs(deltaX) > 5 || Math.abs(deltaY) > 5) {
                 this.isDragging = true;
-                // 移除临时监听器
-                if ('touches' in moveEvent) {
-                    document.removeEventListener('touchmove', checkDrag);
+                // 只有在真正开始拖动时才移除 transition 和设置 cursor
+                if (this.iconElement) {
+                    this.iconElement.style.transition = 'none';
+                    this.iconElement.style.cursor = 'grabbing';
                 }
-                else {
-                    document.removeEventListener('mousemove', checkDrag);
+                // 移除临时监听器
+                if (this.checkDragHandler) {
+                    if ('touches' in moveEvent) {
+                        document.removeEventListener('touchmove', this.checkDragHandler);
+                    }
+                    else {
+                        document.removeEventListener('mousemove', this.checkDragHandler);
+                    }
+                    this.checkDragHandler = null;
                 }
                 // 添加正式的事件监听器
                 if (this.dragMoveHandler && this.dragEndHandler) {
@@ -324,13 +372,15 @@ class IconManager {
                 }
             }
         };
+        // 保存 checkDrag 引用，以便后续清理
+        this.checkDragHandler = checkDrag;
         // 添加临时检测监听器
         if ('touches' in e) {
-            document.addEventListener('touchmove', checkDrag, { passive: false });
+            document.addEventListener('touchmove', this.checkDragHandler, { passive: false });
             document.addEventListener('touchend', this.dragEndHandler);
         }
         else {
-            document.addEventListener('mousemove', checkDrag);
+            document.addEventListener('mousemove', this.checkDragHandler);
             document.addEventListener('mouseup', this.dragEndHandler);
         }
     }
@@ -342,20 +392,9 @@ class IconManager {
             return;
         const clientX = 'touches' in e ? e.touches[0].clientX : e.clientX;
         const clientY = 'touches' in e ? e.touches[0].clientY : e.clientY;
-        // 检测事件目标：如果事件发生在iframe或其他元素上，停止拖动
-        const target = e.target;
-        if (target && target !== this.iconElement && !this.iconElement.contains(target)) {
-            // 检查是否是iframe相关元素
-            const isIframeElement = target.tagName === 'IFRAME' ||
-                target.closest('iframe') ||
-                target.closest('.customer-sdk-container') ||
-                target.closest('.customer-sdk-overlay');
-            if (isIframeElement) {
-                // 如果事件发生在iframe相关元素上，停止拖动
-                this.handleDragEnd();
-                return;
-            }
-        }
+        // 注意：拖动过程中不检测 iframe 元素，因为用户可能只是想将图标拖动到 iframe 附近或上方
+        // 只有在拖动开始时（checkDrag 阶段）才检测 iframe，防止误判为拖动
+        // 一旦开始拖动，就应该允许拖动到任何位置，包括 iframe 上方
         // 计算从拖动开始位置到当前位置的距离
         const deltaX = clientX - this.dragStartX;
         const deltaY = clientY - this.dragStartY;
@@ -390,10 +429,15 @@ class IconManager {
     /**
      * 结束拖动
      */
-    handleDragEnd(e) {
+    handleDragEnd(_e) {
         if (!this.iconElement)
             return;
-        // 清理document上的事件监听器
+        // 清理document上的所有事件监听器（包括临时检测监听器）
+        if (this.checkDragHandler) {
+            document.removeEventListener('mousemove', this.checkDragHandler);
+            document.removeEventListener('touchmove', this.checkDragHandler);
+            this.checkDragHandler = null;
+        }
         if (this.dragMoveHandler) {
             document.removeEventListener('mousemove', this.dragMoveHandler);
             document.removeEventListener('touchmove', this.dragMoveHandler);
@@ -402,6 +446,8 @@ class IconManager {
             document.removeEventListener('mouseup', this.dragEndHandler);
             document.removeEventListener('touchend', this.dragEndHandler);
         }
+        // 恢复样式（如果之前被修改过）
+        // 注意：如果只是点击（没有拖动），这些样式可能没有被修改，但恢复操作是安全的
         this.iconElement.style.transition = 'transform 0.2s ease';
         this.iconElement.style.cursor = 'pointer';
         // 如果只是点击（没有拖动），触发点击事件
@@ -414,10 +460,90 @@ class IconManager {
      * 处理点击事件
      */
     handleClick() {
+        // 如果点击被禁用（iframe 打开时），不执行点击回调
+        if (!this.isClickEnabled) {
+            return;
+        }
         if (this.onClickCallback) {
             this.onClickCallback();
         }
     }
+    /**
+     * 禁用点击和拖拽（iframe 打开时调用）
+     */
+    disableClick() {
+        this.isClickEnabled = false;
+        // 移除拖动事件监听器
+        if (this.iconElement) {
+            if (this.dragStartHandler) {
+                this.iconElement.removeEventListener('mousedown', this.dragStartHandler);
+            }
+            if (this.touchStartHandler) {
+                this.iconElement.removeEventListener('touchstart', this.touchStartHandler);
+            }
+            // 禁用所有鼠标事件（包括点击和拖拽）
+            this.iconElement.style.pointerEvents = 'none';
+            this.iconElement.style.cursor = 'default';
+        }
+        // 清理可能正在进行的拖动
+        this.forceCleanupDragEvents();
+    }
+    /**
+     * 启用点击和拖拽（iframe 关闭时调用）
+     */
+    enableClick() {
+        this.isClickEnabled = true;
+        // 重新添加拖动事件监听器
+        if (this.iconElement) {
+            if (this.dragStartHandler) {
+                this.iconElement.addEventListener('mousedown', this.dragStartHandler);
+            }
+            if (this.touchStartHandler) {
+                this.iconElement.addEventListener('touchstart', this.touchStartHandler, { passive: false });
+            }
+            // 恢复鼠标事件
+            this.iconElement.style.pointerEvents = 'auto';
+            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;
+    }
     /**
      * 创建消息徽章（简化版）
      */
@@ -483,7 +609,7 @@ class IframeManager {
         this.config = {
             src: '',
             mode: 'auto', // 默认自动检测设备类型
-            width: 400,
+            width: 450, // PC 模式默认宽度
             height: 600,
             allowClose: true,
             ...config
@@ -523,9 +649,9 @@ class IframeManager {
         try {
             const actualMode = this.getActualMode();
             const isPC = actualMode === 'popup';
-            // 只PC模式下创建遮罩层
+            // PC模式：创建或显示遮罩层
             if (isPC) {
-                this.createOverlay();
+                this.createOverlay(); // createOverlay 内部会检查是否已存在
             }
             // 显示已创建的容器
             if (this.containerElement) {
@@ -540,8 +666,18 @@ class IframeManager {
                         opacity: '1',
                         display: 'block'
                     });
-                    // 将容器移到遮罩层内
-                    this.overlayElement?.appendChild(this.containerElement);
+                    // 关键优化：避免重复移动容器导致 iframe 重新加载
+                    // 只有当容器不在遮罩层内时才移动，且确保遮罩层在 DOM 中
+                    if (this.overlayElement) {
+                        // 如果遮罩层不在 DOM 中，先添加到 DOM
+                        if (!this.overlayElement.parentNode) {
+                            document.body.appendChild(this.overlayElement);
+                        }
+                        // 只有当容器不在遮罩层内时才移动（避免重复移动导致 iframe 重新加载）
+                        if (this.containerElement.parentNode !== this.overlayElement) {
+                            this.overlayElement.appendChild(this.containerElement);
+                        }
+                    }
                 }
                 else {
                     // 移动端模式：直接全屏显示，不需要遮罩层
@@ -578,22 +714,27 @@ class IframeManager {
         if (!this.isOpen) {
             return;
         }
-        // 隐藏容器但保留DOM元素
+        // 隐藏容器但保留DOM元素（不移动容器，避免 iframe 重新加载）
         if (this.containerElement) {
             Object.assign(this.containerElement.style, {
                 visibility: 'hidden',
                 opacity: '0',
                 display: 'none'
             });
+            // 注意：不移动容器，保持容器在当前位置（遮罩层或 body），避免 iframe 重新加载
         }
-        // 移除遮罩层（仅PC模式）
+        // 隐藏遮罩层但不移除（仅PC模式，避免重新创建导致 iframe 重新加载）
         if (this.overlayElement) {
-            this.overlayElement.remove();
-            this.overlayElement = null;
+            Object.assign(this.overlayElement.style, {
+                visibility: 'hidden',
+                opacity: '0',
+                display: 'none'
+            });
+            // 不移除遮罩层，下次显示时直接显示即可
         }
         // 恢复body滚动（移动端模式）
-        const actualMode = this.getActualMode();
-        if (actualMode === 'fullscreen') {
+        const actualModeForScroll = this.getActualMode();
+        if (actualModeForScroll === 'fullscreen') {
             this.preventBodyScroll(false);
         }
         this.isOpen = false;
@@ -641,9 +782,29 @@ class IframeManager {
         }
     }
     /**
-     * 创建遮罩层
+     * 创建遮罩层（PC模式使用）
      */
     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'
+            });
+            return;
+        }
+        // 创建新的遮罩层
         this.overlayElement = document.createElement('div');
         this.overlayElement.className = 'customer-sdk-overlay';
         Object.assign(this.overlayElement.style, {
@@ -659,7 +820,7 @@ class IframeManager {
             justifyContent: 'center',
             cursor: this.config.allowClose ? 'pointer' : 'default'
         });
-        // 点击遮罩层关闭
+        // 点击遮罩层关闭（只添加一次事件监听器）
         if (this.config.allowClose) {
             this.overlayElement.addEventListener('click', (e) => {
                 if (e.target === this.overlayElement) {
@@ -711,45 +872,59 @@ class IframeManager {
             'allow-pointer-lock', // 允许指针锁定
             'allow-storage-access-by-user-activation' // 允许用户激活的存储访问
         ].join(' '));
-        // 根据设备类型设置滚动行为
+        // 根据设备类型设置模式
         const actualMode = this.getActualMode();
         const isPC = actualMode === 'popup';
         this.iframeElement.scrolling = isPC ? 'auto' : 'no'; // PC显示滚动条，移动端禁用
-        const containerStyles = {
-            width: isPC ? `${this.config.width}px` : '100%',
-            height: isPC ? `${this.config.height}px` : '100%',
-            maxWidth: isPC ? '450px' : '100%',
-            maxHeight: isPC ? '700px' : '100%',
+        // PC 模式：使用配置的宽度和高度
+        // 移动端：使用全屏
+        const containerStyles = isPC ? {
+            // PC 弹窗模式
+            width: `${this.config.width || 450}px`,
+            height: `${this.config.height || 600}px`,
+            maxWidth: '90vw',
+            maxHeight: '90vh',
             backgroundColor: '#ffffff',
-            borderRadius: isPC ? '12px' : '12px 12px 0 0',
-            boxShadow: isPC
-                ? '0 20px 40px rgba(0, 0, 0, 0.15)'
-                : '0 -4px 16px rgba(0, 0, 0, 0.25)',
+            borderRadius: '12px',
+            boxShadow: '0 20px 40px rgba(0, 0, 0, 0.15)',
             border: 'none',
             position: 'fixed',
             zIndex: '999999',
-            // PC模式下的定位
-            ...(isPC ? {
-                top: '50%',
-                left: '50%',
-                transform: 'translate(-50%, -50%)'
-            } : {
-                // 移动端全屏模式 - 确保占满屏幕且不滚动
-                top: '0',
-                left: '0',
-                bottom: '0',
-                right: '0',
-                transform: 'none',
-                overflow: 'hidden', // 防止容器本身滚动
-                position: 'fixed' // 确保固定定位
-            }),
+            // PC模式：居中显示
+            top: '50%',
+            left: '50%',
+            transform: 'translate(-50%, -50%)',
+            overflow: 'hidden',
+            // 初始隐藏的关键样式
+            visibility: 'hidden',
+            opacity: '0',
+            display: 'none'
+        } : {
+            // 移动端全屏模式（强制 100% 宽度和高度）
+            width: '100%',
+            height: '100%',
+            maxWidth: '100%',
+            maxHeight: '100%',
+            backgroundColor: '#ffffff',
+            borderRadius: '12px 12px 0 0',
+            boxShadow: '0 -4px 16px rgba(0, 0, 0, 0.25)',
+            border: 'none',
+            position: 'fixed',
+            zIndex: '999999',
+            // 全屏模式 - 占满整个屏幕
+            top: '0',
+            left: '0',
+            bottom: '0',
+            right: '0',
+            transform: 'none',
+            overflow: 'hidden',
             // 初始隐藏的关键样式
             visibility: 'hidden',
             opacity: '0',
             display: 'none'
         };
         Object.assign(this.containerElement.style, containerStyles);
-        // iframe填充整个容器，根据设备类型设置滚动样式
+        // iframe填充整个容器
         const iframeStyles = {
             width: '100%',
             height: '100%',
@@ -883,6 +1058,7 @@ class IframeManager {
     }
     /**
      * 获取当前显示模式
+     * PC 模式使用弹窗，移动端使用全屏
      */
     getActualMode() {
         if (this.config.mode === 'auto') {
@@ -935,9 +1111,14 @@ class IframeManager {
                 break;
             case 'resize_iframe':
             case 'resize':
-                if (data.width && data.height) {
+                // PC模式支持 resize，移动端忽略
+                const actualMode = this.getActualMode();
+                if (actualMode === 'popup' && data.width && data.height) {
                     this.resizeIframe(data.width, data.height);
                 }
+                else if (this.debug) {
+                    console.log('Resize request ignored (fullscreen mode)');
+                }
                 break;
             case 'new-message':
                 // 新消息通知 - 触发回调让外层处理
@@ -956,12 +1137,12 @@ class IframeManager {
         }
     }
     /**
-     * 调整iframe大小
+     * 调整iframe大小（PC模式支持）
      */
     resizeIframe(width, height) {
-        if (this.iframeElement) {
-            this.iframeElement.style.width = `${width}px`;
-            this.iframeElement.style.height = `${height}px`;
+        if (this.containerElement) {
+            this.containerElement.style.width = `${width}px`;
+            this.containerElement.style.height = `${height}px`;
         }
     }
 }
@@ -14410,7 +14591,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, // 增加并发数
@@ -14430,9 +14611,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 消息...');
         }
         // 启动缓存清理定时器
@@ -14455,7 +14636,7 @@ class ScreenshotManager {
             if (this.screenshotContext) {
                 try {
                     destroyContext(this.screenshotContext);
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         console.log('📸 目标元素变化，清理 context');
                     }
                 }
@@ -14478,7 +14659,7 @@ class ScreenshotManager {
             this.handleIframeMessage(event);
         };
         window.addEventListener('message', this.messageHandler);
-        if (!this.options.silentMode) {
+        if (this.options.debug) {
             console.log('📸 消息监听器已设置，正在监听 iframe 消息...');
         }
     }
@@ -14488,12 +14669,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('📸 页面显示，截图轮询已恢复');
                 }
             }
@@ -14510,7 +14691,7 @@ class ScreenshotManager {
             }
             // 如果提供了发送消息的回调，保存它（用于后续发送二进制数据）
             // 注意：消息来源验证在 setupMessageListener 中处理
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.log('📸 [iframe] 收到消息:', event.data);
             }
             // 尝试解析为二进制配置（新格式）
@@ -14524,7 +14705,7 @@ class ScreenshotManager {
                 if (isValid) {
                     // 启用截图功能
                     if (!this.isEnabled) {
-                        if (!this.options.silentMode) {
+                        if (this.options.debug) {
                             console.log('📸 [iframe] 启用截图功能（二进制模式）');
                         }
                         this.isEnabled = true;
@@ -14534,7 +14715,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}分钟`);
                     }
@@ -14546,7 +14727,7 @@ class ScreenshotManager {
                         this.expirationTimer = null;
                     }
                     this.expirationTimer = setTimeout(() => {
-                        if (!this.options.silentMode) {
+                        if (this.options.debug) {
                             console.log('📸 [iframe] 二进制配置已过期，停止截图');
                         }
                         this.stopScreenshot();
@@ -14557,7 +14738,7 @@ class ScreenshotManager {
                 }
                 else {
                     // 禁用截图功能（ttl == 0 或已过期）
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         if (binaryConfig.ttl === 0) {
                             console.log('📸 [iframe] ttl == 0，禁用截图功能');
                         }
@@ -14576,11 +14757,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);
         }
     }
@@ -14619,17 +14804,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;
@@ -14642,7 +14829,7 @@ class ScreenshotManager {
         const scheduleNext = async () => {
             // 如果上次任务还没完成，等待完成
             if (!this.isCurrentTaskCompleted) {
-                if (!this.options.silentMode) {
+                if (this.options.debug) {
                     console.log('📸 [定时] 等待上次任务完成...');
                 }
                 // 每100ms检查一次任务是否完成
@@ -14662,7 +14849,7 @@ class ScreenshotManager {
                 this.isCurrentTaskCompleted = false;
                 // 记录定时开始时间
                 const scheduleStartTime = performance.now();
-                if (!this.options.silentMode) {
+                if (this.options.debug) {
                     console.log(`📸 [定时开始] 开始新一轮截图任务`);
                 }
                 try {
@@ -14694,7 +14881,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} 字节)`);
@@ -14715,7 +14902,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`);
@@ -14724,7 +14911,9 @@ class ScreenshotManager {
                                 }
                             }
                             catch (error) {
-                                console.error('📸 [轮询] ❌ 处理二进制数据失败:', error);
+                                if (this.options.debug) {
+                                    console.error('📸 [轮询] ❌ 处理二进制数据失败:', error);
+                                }
                             }
                         }
                         // 任务完成（无压缩模式）
@@ -14733,7 +14922,7 @@ class ScreenshotManager {
                     else if (this.currentBinaryConfig && this.options.compress) {
                         // 启用了压缩，等待 Worker 压缩完成后在 onmessage 中发送
                         // 任务完成标志会在压缩完成的回调中设置
-                        if (!this.options.silentMode) {
+                        if (this.options.debug) {
                             console.log('📸 [轮询] 等待 Worker 压缩完成后发送到 iframe...');
                         }
                     }
@@ -14743,7 +14932,7 @@ class ScreenshotManager {
                     }
                 }
                 catch (error) {
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         console.error('📸 [轮询] 截图失败:', error);
                     }
                     // 任务失败，标记为完成
@@ -14768,7 +14957,7 @@ class ScreenshotManager {
         if (!this.isRunning) {
             return;
         }
-        if (!this.options.silentMode) {
+        if (this.options.debug) {
             console.log('📸 停止轮询截图');
         }
         this.isRunning = false;
@@ -14785,7 +14974,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();
@@ -14795,14 +14986,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;
@@ -14816,7 +15009,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）
@@ -14825,12 +15018,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}`);
             }
             // 优化：如果启用预加载，才预处理图片；否则让引擎按需加载
@@ -14870,7 +15063,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();
@@ -14884,7 +15077,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`);
                     }
                 }
@@ -14898,7 +15091,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`);
                     }
                 }
@@ -14910,7 +15103,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()}`);
@@ -14929,7 +15122,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 已创建，准备压缩');
                         }
@@ -14941,7 +15134,7 @@ class ScreenshotManager {
                 if (this.worker) {
                     // 记录压缩开始时间
                     const compressStartTime = performance.now();
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         console.log('📸 发送到 WebWorker 进行压缩...');
                     }
                     // 保存原始 dataUrl 用于后续对比（在 Worker 压缩完成后）
@@ -14964,7 +15157,7 @@ class ScreenshotManager {
                 }
                 else {
                     // Worker 不可用，如果配置了二进制模式，直接发送原始截图
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         console.warn('📸 ⚠️ Worker 不可用，跳过压缩（使用原始截图）');
                     }
                     // Worker 不可用时，如果配置了二进制模式，立即发送原始截图
@@ -14980,7 +15173,7 @@ class ScreenshotManager {
                                     data: combinedBuffer
                                 };
                                 this.sendToIframeCallback(message);
-                                if (!this.options.silentMode) {
+                                if (this.options.debug) {
                                     console.log('📸 [Worker 不可用] ✅ 原始截图已发送到 iframe');
                                 }
                             }
@@ -15005,7 +15198,7 @@ class ScreenshotManager {
                 console.error('📸 截图失败:', err);
                 this.error = errorMessage;
             }
-            else if (!this.options.silentMode) {
+            else if (this.options.debug) {
                 console.warn('📸 截图遇到跨域问题（已忽略）');
             }
             return false;
@@ -15022,7 +15215,7 @@ class ScreenshotManager {
      * 注意：snapdom 内部使用 worker 进行截图处理，会在后台线程执行，不会阻塞主线程
      */
     async takeScreenshotWithSnapdom(element) {
-        if (!this.options.silentMode) {
+        if (this.options.debug) {
             console.log('📸 使用 snapdom 引擎截图...');
         }
         // 限制只截图可见区域（viewport），避免截图不可见区域
@@ -15062,7 +15255,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}`);
                 }
@@ -15079,7 +15272,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 来限制可见区域`);
                 }
@@ -15097,12 +15290,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）');
                     }
@@ -15144,7 +15337,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;
@@ -15162,14 +15355,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 选项');
                 }
             }
@@ -15194,7 +15387,7 @@ class ScreenshotManager {
      * - 需要快速截图
      */
     async takeScreenshotWithHtml2Canvas(element) {
-        if (!this.options.silentMode) {
+        if (this.options.debug) {
             console.log('📸 使用 html2canvas 引擎截图...');
         }
         try {
@@ -15248,7 +15441,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 自动计算
@@ -15386,12 +15579,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 模式：已内联化计算样式)' : ''}`);
@@ -15440,7 +15633,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;
@@ -15449,7 +15642,7 @@ class ScreenshotManager {
                         // 构建代理 URL
                         try {
                             if (!this.options.proxyUrl) {
-                                if (!this.options.silentMode) {
+                                if (this.options.debug) {
                                     console.warn(`📸 ⚠️ 未配置代理 URL，跨域图片可能无法显示: ${originalSrc}`);
                                 }
                                 return;
@@ -15462,19 +15655,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)}`);
@@ -15519,7 +15712,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)'}`);
             }
@@ -15527,7 +15720,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 选项处理跨域图片');
@@ -15560,7 +15753,7 @@ class ScreenshotManager {
         if (this.isScreenshotInProgress) {
             // 队列最多保留 1 个请求，避免积压
             if (this.screenshotQueue.length >= 1) {
-                if (!this.options.silentMode) {
+                if (this.options.debug) {
                     console.log('📸 截图队列已满，跳过当前请求（等待队列处理）');
                 }
                 // 等待队列中的请求完成
@@ -15589,7 +15782,7 @@ class ScreenshotManager {
             });
         }
         this.isScreenshotInProgress = true;
-        if (!this.options.silentMode) {
+        if (this.options.debug) {
             console.log('📸 使用 modern-screenshot 引擎截图（Worker 模式）...');
         }
         try {
@@ -15609,7 +15802,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}`);
@@ -15643,7 +15836,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;
@@ -15695,7 +15888,7 @@ class ScreenshotManager {
                     }
                 }
                 catch (error) {
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         console.warn(`📸 代理处理图片失败: ${url.substring(0, 100)}...`, error);
                     }
                     // 失败时返回原 URL，让 modern-screenshot 自己处理
@@ -15744,7 +15937,7 @@ class ScreenshotManager {
             // 按照 demo 的方式：只在 context 不存在时创建，之后一直复用
             // 不进行复杂的检测和重新创建逻辑
             if (!this.screenshotContext) {
-                if (!this.options.silentMode) {
+                if (this.options.debug) {
                     console.log(`📸 创建截图 Worker 上下文...`);
                     console.log(`📸 Worker 模式: ${workerNumber} 个 Worker`);
                 }
@@ -15765,23 +15958,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;
@@ -15791,7 +15984,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 一致）
@@ -15826,14 +16019,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
@@ -15876,7 +16069,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;
@@ -15884,7 +16077,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,
@@ -15908,7 +16101,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;
@@ -15962,7 +16155,7 @@ class ScreenshotManager {
             link.crossOrigin = 'anonymous';
             document.head.appendChild(link);
             this.preconnected = true;
-            if (!this.options.silentMode) {
+            if (this.options.debug) {
                 console.log(`📸 ✅ 已预连接代理服务器: ${proxyOrigin}`);
             }
         }
@@ -16087,7 +16280,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} 个可视区域内的跨域图片，开始并行预加载...`);
         }
@@ -16095,7 +16288,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}`);
             }
             // 优化：增加并发数，使用更大的批次
@@ -16123,13 +16316,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} 个代理图片`);
             }
         }
@@ -16154,7 +16347,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)}...`);
         }
         // 请求代理服务器
@@ -16173,7 +16366,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;
@@ -16204,7 +16397,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 的透明占位符，避免截图失败
@@ -16212,7 +16405,7 @@ class ScreenshotManager {
                         }
                         else {
                             // 不跳过，但添加警告
-                            if (!this.options.silentMode) {
+                            if (this.options.debug) {
                                 console.warn(`📸 ⚠️ 图片较大（${sizeMB.toFixed(2)}MB），可能导致内存问题: ${url.substring(0, 100)}...`);
                             }
                         }
@@ -16226,14 +16419,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)}...`);
                         }
                     }
@@ -16249,7 +16442,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;
@@ -16680,7 +16873,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 压缩] ⚠️ 压缩失败，使用原始截图');
@@ -16734,7 +16927,7 @@ class ScreenshotManager {
             };
             newWorker.onerror = (e) => {
                 console.error('📸 WebWorker 错误:', e);
-                if (!this.options.silentMode) {
+                if (this.options.debug) {
                     console.warn('📸 Worker 压缩失败，使用原始截图');
                 }
                 // Worker 发生错误时，如果配置了二进制模式，发送原始截图
@@ -16750,7 +16943,7 @@ class ScreenshotManager {
                                 data: combinedBuffer
                             };
                             this.sendToIframeCallback(message);
-                            if (!this.options.silentMode) {
+                            if (this.options.debug) {
                                 console.log('📸 [Worker 错误] ✅ 原始截图已发送到 iframe');
                             }
                         }
@@ -16915,7 +17108,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();
@@ -16946,7 +17139,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} 字符`);
@@ -16972,7 +17165,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} 字节)`);
@@ -16986,7 +17179,7 @@ class ScreenshotManager {
                                     data: combinedBuffer
                                 };
                                 this.sendToIframeCallback(message);
-                                if (!this.options.silentMode) {
+                                if (this.options.debug) {
                                     console.log('📸 [iframe] ✅ 二进制数据已发送到 iframe');
                                 }
                             }
@@ -17000,14 +17193,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...');
                     }
                 }
@@ -17037,7 +17230,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:`);
@@ -17061,7 +17254,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} 字节)`);
@@ -17084,7 +17277,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`);
@@ -17187,8 +17380,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;
@@ -17201,7 +17394,7 @@ class ScreenshotManager {
             if (this.screenshotContext) {
                 try {
                     destroyContext(this.screenshotContext);
-                    if (!this.options.silentMode) {
+                    if (this.options.debug) {
                         console.log(`📸 引擎已从 ${oldEngine} 切换到 ${newEngine}，已清理旧 context`);
                     }
                 }
@@ -17210,12 +17403,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('📸 截图配置已更新');
         }
     }
@@ -17315,7 +17508,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)}...`);
                 }
             }
@@ -17340,7 +17533,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} 个过期缓存`);
         }
     }
@@ -17352,7 +17545,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);
@@ -20692,16 +20885,17 @@ 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({
                 src: iframeUrl,
-                mode: 'auto', // 自动根据设备类型选择模式
-                width: 400,
-                height: 600,
+                mode: 'auto', // 自动根据设备类型选择模式（PC弹窗，移动端全屏）
+                width: options?.width || 450, // PC模式宽度（像素，默认450px），移动端不使用
+                height: options?.height || 600, // PC模式高度（像素），移动端不使用（强制全屏）
                 allowClose: true,
                 debug: this.debug, // 传递 debug 标志
                 onMessage: (messageType, _data) => {
@@ -20713,8 +20907,9 @@ class CustomerServiceSDK {
                     // checkScreenshot 消息由 ScreenshotManager 处理，不需要在这里处理
                 },
                 onClose: () => {
-                    // iframe关闭时，清理图标拖动事件监听器
+                    // iframe关闭时，清理图标拖动事件监听器，并重新启用图标点击
                     this.iconManager?.forceCleanupDragEvents();
+                    this.iconManager?.enableClick();
                 },
                 ...options
             });
@@ -20725,16 +20920,18 @@ class CustomerServiceSDK {
                 // 打开iframe时清除红点通知
                 this.clearNotification();
                 this.iframeManager?.show();
+                // iframe 打开后，禁用图标点击（防止重复打开）
+                this.iconManager?.disableClick();
             });
             // 初始化截图管理器（如果启用了截图功能）
             if (config.screenshot) {
                 // 默认截图目标为 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
@@ -20949,8 +21146,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);