qb-pc-sdk 1.2.8 → 1.3.0

package/README.md

@@ -4,7 +4,6 @@ pc广告 SDK 封装器 - PC端广告接入工具
 
 > ✅ **系统兼容性**：SDK 会自动检测运行环境，仅在 Windows 系统下加载广告。在 Mac、Linux、移动端等非 Windows 环境下会静默处理，不会报错，页面可正常使用。
 
-
 ## 适用场景
 
 ### ✅ 支持的场景
@@ -12,6 +11,7 @@ pc广告 SDK 封装器 - PC端广告接入工具
 #### 1. PC 端网页（浏览器环境）
 
 **完全支持，推荐使用：**
+
 - ✅ **Windows 系统下的所有浏览器**
   - Chrome、Edge、Firefox、360 浏览器、QQ 浏览器、搜狗浏览器等
   - 支持所有现代浏览器（IE 11+）
@@ -41,12 +41,13 @@ pc广告 SDK 封装器 - PC端广告接入工具
 - ⚠️ **注意事项**
   - 确保 WebView 运行在 Windows 系统上（Mac/Linux 上运行会静默处理）
   - 确保网络连接正常（需要加载 CDN 资源）
-  - 如果应用有 CSP（内容安全策略）限制，需要允许 `file.qubiankeji.com` 域名
+  - 如果应用有 CSP（内容安全策略）限制，需要允许域名
 
 **接入示例（Electron）：**
+
 ```javascript
 // main.js
-const { app, BrowserWindow } = require('electron');
+const { app, BrowserWindow } = require("electron");
 
 function createWindow() {
   const win = new BrowserWindow({
@@ -54,12 +55,12 @@ function createWindow() {
     height: 800,
     webPreferences: {
       nodeIntegration: false,
-      contextIsolation: true
-    }
+      contextIsolation: true,
+    },
   });
-  
+
   // 加载包含广告的网页
-  win.loadURL('https://your-website.com');
+  win.loadURL("https://your-website.com");
 }
 
 app.whenReady().then(createWindow);
@@ -67,20 +68,23 @@ app.whenReady().then(createWindow);
 
 ```html
 <!-- 在您的网页中正常使用 SDK（内联版本，容灾100%达成） -->
-<ins class="qb-adsbyqubian"
-     style="display:block; width:400px; height:220px;"
-     data-app-id="your-app-id"
-     data-placement-id="your-placement-id">
+<ins
+  class="qb-adsbyqubian"
+  style="display:block; width:400px; height:220px;"
+  data-app-id="your-app-id"
+  data-placement-id="your-placement-id"
+>
 </ins>
+<script src="https://unpkg.com/qb-pc-sdk@latest/core.min.js"></script>
 <script>
-(function(g){"use strict";var w=g&&g.window?g.window:(typeof window!=="undefined"?window:g),d=w.document;if(!d||w._qbPcSdkLoading||w.AdSDK)return;var ua=(w.navigator&&w.navigator.userAgent)||"",p=w.navigator.platform||"";if(/Android|iPhone|iPad|iPod|Mac|webOS|BlackBerry|IEMobile|Opera Mini/i.test(ua)||!/Win|Windows/i.test(ua+p))return;w._qbPcSdkLoading=true;var pr="https://unpkg.com/qb-pc-sdk@latest/core.min.js",fb="https://file.qubiankeji.com/qb-pc-sdk/core.min.js";var c=function(){if(w.GDTAdSDK&&w.AdSDK){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{AdSDK:w.AdSDK,GDTAdSDK:w.GDTAdSDK}}));}else{setTimeout(function(){if(w.GDTAdSDK&&w.AdSDK){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{AdSDK:w.AdSDK,GDTAdSDK:w.GDTAdSDK}}));}else{w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK初始化失败"),AdSDK:null,GDTAdSDK:null}}));}},100);}};var l=function(p,f){if(d.querySelector('script[src="'+p+'"]')||(f&&d.querySelector('script[src="'+f+'"]'))){c();return;}var loaded=false;var timeoutId=setTimeout(function(){if(!loaded&&f&&!d.querySelector('script[src="'+f+'"]')){loaded=true;var fs=d.createElement("script");fs.src=f;fs.async=true;fs.onload=c;fs.onerror=function(){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));};d.head.appendChild(fs);}},2000);var s=d.createElement("script");s.src=p;s.async=true;s.onload=function(){if(!loaded){loaded=true;clearTimeout(timeoutId);c();}};s.onerror=function(){if(!loaded){loaded=true;clearTimeout(timeoutId);if(f&&!d.querySelector('script[src="'+f+'"]')){var fs=d.createElement("script");fs.src=f;fs.async=true;fs.onload=c;fs.onerror=function(){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));};d.head.appendChild(fs);}else{w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));}}};d.head.appendChild(s);};l(pr,fb);})(typeof window!=="undefined"?window:(typeof global!=="undefined"?global:this));
+  (window.qbAds = window.qbAds || []).push({});
 </script>
-<script>(window.qbAds = window.qbAds || []).push({});</script>
 ```
 
 #### 3. 第三方建站平台
 
 **完全支持，推荐使用即插即用模式：**
+
 - ✅ WordPress、Discuz!、Drupal、Joomla 等 CMS
 - ✅ 凡科建站、建站之星等可视化建站工具
 - ✅ 有赞、微盟等电商平台
@@ -97,165 +101,190 @@ app.whenReady().then(createWindow);
 ### 🔍 环境检测机制
 
 SDK 会自动检测运行环境：
+
 - **Windows 系统**：✅ 正常加载和显示广告
 - **非 Windows 系统**：✅ 静默处理，不发起广告请求，页面正常运行，不会报错
 
 **检测逻辑：**
+
 - 通过 `navigator.platform` 和 `navigator.userAgent` 检测操作系统
 - 仅在检测到 Windows 系统时加载广告
 - 其他环境（Mac、Linux、移动端）自动跳过，不报错，不影响页面正常使用
 
 ## 安装
 
-### ⭐ CDN 内联代码模式（强烈推荐）
+### ⭐ CDN 模式
 
-**推荐所有客户使用 CDN 内联代码模式对接**，这是最简单、最可靠、容灾效果最好的接入方式。
+<script src="https://unpkg.com/qb-pc-sdk@latest/core.min.js" defer></script>
 
-#### ⭐ 内联版本（最推荐，容灾100%达成）
+````
+### NPM 方式（模块化项目推荐）
 
-**为什么推荐内联模式？**
-- ✅ **容灾100%达成**：即使主 CDN 域名挂了，内联代码依然会运行并自动切换到备用 CDN
-- ✅ **2秒超时保护**：如果主 CDN 2秒内没有响应，自动切换到备用 CDN，避免长时间等待
-- ✅ **极简内联代码**：内联代码只负责容灾和异步加载，代码极小（约 0.4KB），几乎不阻塞页面
-- ✅ **无需维护外部文件**：逻辑直接内联在 HTML 中，不依赖外部文件，部署简单
-- ✅ **自动版本更新**：使用 `@latest` 自动获取最新版本，无需手动更新代码
-- ✅ **环境检测自动更新**：Windows/Mac 环境检测逻辑在 `loader.min.js` 中，未来支持 Mac 时客户无需修改内联代码
-- ✅ **一次接入，永久有效**：客户只需复制粘贴一次内联代码，后续所有功能更新（包括环境检测逻辑）自动生效
-- ✅ **完全异步加载**：使用 `async` 属性，不阻塞页面渲染
+适用于 Vue、React、Webpack、Vite 等模块化打包项目。**仅需安装 `qb-pc-sdk`，无需单独安装或引入 `qb-pc-ad-sdk-origin`**（底层 SDK 已作为依赖自动集成）。
 
-**推荐所有客户使用此方式对接！**
+```bash
+npm install qb-pc-sdk
+````
 
-**使用方法：**
+**注意：** 对于静态 HTML 网站或建站平台，**强烈推荐使用 CDN 模式**，而不是 NPM 方式。
 
-```html
-    <script>
-(function(g){"use strict";var w=g&&g.window?g.window:(typeof window!=="undefined"?window:g),d=w.document;if(!d||w._qbPcSdkLoading||w.AdSDK)return;var pr="https://unpkg.com/qb-pc-sdk@latest/loader.min.js",fb="https://file.qubiankeji.com/qb-pc-sdk/loader.min.js";var loaded=false;var timeoutId=setTimeout(function(){if(!loaded&&fb&&!d.querySelector('script[src="'+fb+'"]')){loaded=true;var fs=d.createElement("script");fs.src=fb;fs.async=true;fs.onerror=function(){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));};d.head.appendChild(fs);}},2000);var s=d.createElement("script");s.src=pr;s.async=true;s.onload=function(){if(!loaded){loaded=true;clearTimeout(timeoutId);}};s.onerror=function(){if(!loaded){loaded=true;clearTimeout(timeoutId);if(fb&&!d.querySelector('script[src="'+fb+'"]')){var fs=d.createElement("script");fs.src=fb;fs.async=true;fs.onerror=function(){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));};d.head.appendChild(fs);}else{w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));}}};d.head.appendChild(s);})(typeof window!=="undefined"?window:(typeof global!=="undefined"?global:this));
-</script>
-```
+### 方式一：NPM 接入（模块化项目）
 
-**架构说明：**
-- **内联代码**（客户复制粘贴）：
-  - 只负责容灾判断（2秒超时）和异步加载 `loader.min.js`
-  - 代码极小（约 0.4KB），执行时间 < 1ms，几乎不阻塞页面
-  - **客户只需复制粘贴一次，永久有效**
-- **loader.min.js**（从CDN自动加载，约 2.3KB）：
-  - 包含 Windows/Mac 环境检测逻辑
-  - 包含加载 `core.min.js` 的完整逻辑和2秒超时机制
-  - 主 CDN：`https://unpkg.com/qb-pc-sdk@latest/loader.min.js`
-  - 备用 CDN：`https://file.qubiankeji.com/qb-pc-sdk/loader.min.js`
-  - **自动热更新**：使用 `@latest` 自动获取最新版本，包含最新的环境检测逻辑
-- **core.min.js**（从CDN自动加载，约 300KB）：
-  - SDK核心功能
-  - 主 CDN：`https://unpkg.com/qb-pc-sdk@latest/core.min.js`
-  - 备用 CDN：`https://file.qubiankeji.com/qb-pc-sdk/core.min.js`
-  - **自动热更新**：使用 `@latest` 自动获取最新版本
-
-**核心优势：**
-- ✅ **一次接入，永久有效**：客户只需复制粘贴一次内联代码，后续所有功能更新（包括环境检测逻辑、SDK功能）自动生效
-- ✅ **未来扩展无需修改**：如果未来支持 Mac 端展示广告，只需更新 `loader.min.js`，客户无需修改任何内联代码
-- ✅ **完全异步加载**：不阻塞页面渲染，不影响首屏加载速度
-- ✅ **推荐用于所有生产环境**
+适用于 Vue、React、Webpack、Vite 等模块化打包项目。**只需引入 `qb-pc-sdk`，无需再 `import qb-pc-ad-sdk-origin`**，底层 SDK 已内置在包内并自动挂载。
 
-### NPM 方式（模块化项目推荐）
+#### 1. 基本用法（ES6 模块）
 
-适用于 Vue、React、Webpack、Vite 等模块化打包项目。
+```javascript
+import AdSDK from "qb-pc-sdk";
 
-```bash
-npm install qb-pc-sdk
+const adSDK = new AdSDK({
+  appId: "your-app-id", // 必填，替换为平台申请的应用 ID
+  placementId: "your-placement-id", // 必填，替换为平台申请的广告位 ID
+  container: "#ad-container", // 必填，广告挂载的容器：CSS 选择器或 DOM 元素
+  onAdLoaded: (ad) => {
+    console.log("✅ 广告加载成功", ad);
+    const size = adSDK.getAdSize(); // 可获取当前广告尺寸
+  },
+  onAdError: (error, message) => {
+    console.error("❌ 广告加载失败", message);
+  },
+  onAdExpose: () => console.log("👀 广告已曝光"),
+  onAdClick: () => console.log("🖱️ 用户点击了广告"),
+});
+
+// 页面卸载或组件销毁时调用，避免内存泄漏
+// adSDK.destroy();
 ```
 
-**注意：** 对于静态 HTML 网站或建站平台，**强烈推荐使用 CDN 内联代码模式**，而不是 NPM 方式。
+**⚠️ 重要：容器必须在实例化时已存在于 DOM 中。**  
+若传入的是选择器（如 `#ad-container`），则创建 `new AdSDK(...)` 时，该元素必须已经被渲染；否则 SDK 不会发起广告请求，广告不会展示。在 Vue/React 等框架中请务必在**容器已挂载后再创建实例**（见下方 Vue2/Vue3 示例）。
 
-### 异步加载说明
+#### 2. Vue 2 项目接入
 
-**内联引导器已完全支持异步加载：**
+在 Vue 2 中，请使用 **ref** 获取容器 DOM，并在 **mounted + $nextTick** 之后再创建 AdSDK，确保容器已渲染。
 
-1. **内联代码本身**：代码极小（约 0.5KB），执行时间 < 1ms，几乎不阻塞页面
-2. **loader.min.js 加载**：使用 `async = true` 异步加载，不阻塞页面渲染
-3. **core.min.js 加载**：由 loader.min.js 异步加载，不阻塞页面渲染
-4. **2秒超时保护**：如果主 CDN 2秒内没有响应，自动切换到备用 CDN，避免长时间等待
+**示例：单文件组件**
 
-**推荐放置位置：**
-- ✅ **最佳**：放在 `</body>` 标签之前，页面内容先渲染
-- ✅ **也可以**：放在 `<head>` 中，由于代码极小且异步，影响很小
+```vue
+<template>
+  <div class="ad-page">
+    <!-- 广告容器：必须设置 ref，并保证有宽高 -->
+    <div ref="adContainer" class="ad-container"></div>
+  </div>
+</template>
 
-**示例（推荐放在页面底部）：**
+<script>
+import AdSDK from "qb-pc-sdk";
+
+export default {
+  name: "AdPage",
+  data() {
+    return {
+      adSDK: null,
+    };
+  },
+  mounted() {
+    this.$nextTick(() => {
+      // 必须在 nextTick 后执行，确保 ref 已指向真实 DOM
+      const container = this.$refs.adContainer;
+      if (!container) return;
+
+      this.adSDK = new AdSDK({
+        appId: "your-app-id",
+        placementId: "your-placement-id",
+        container: container, // 推荐传 DOM 元素，避免选择器在 SPA 中拿不到
+        onAdLoaded: (ad) => {
+          console.log("✅ 广告加载成功", ad);
+        },
+        onAdError: (error, message) => {
+          console.error("❌ 广告加载失败", message);
+        },
+      });
+    });
+  },
+  beforeDestroy() {
+    if (this.adSDK && typeof this.adSDK.destroy === "function") {
+      this.adSDK.destroy();
+    }
+  },
+};
+</script>
 
-```html
-<!DOCTYPE html>
-<html>
-<head>
-    <meta charset="UTF-8">
-    <title>页面标题</title>
-</head>
-<body>
-    <!-- 页面内容 -->
-    
-    <!-- 内联代码放在 </body> 之前（推荐） -->
-    <script>
-    (function(g){"use strict";...})();
-    </script>
-</body>
-</html>
+<style scoped>
+.ad-container {
+  width: 400px;
+  height: 220px;
+  margin: 0 auto;
+}
+</style>
 ```
 
-## 使用方法
+#### 3. Vue 3 项目接入（Composition API）
 
-### 方式一：NPM 接入（模块化项目）
+在 Vue 3 中同样需要等容器挂载后再创建实例，使用 **ref + onMounted + nextTick**。
 
-适用于 Vue、React、Webpack、Vite 等模块化打包项目。
+**示例：`<script setup>`**
 
-#### ES6 模块导入
+```vue
+<template>
+  <div class="ad-page">
+    <div ref="adContainerRef" class="ad-container"></div>
+  </div>
+</template>
 
-```javascript
-import AdSDK from 'qb-pc-sdk';
+<script setup>
+import { ref, onMounted, onBeforeUnmount, nextTick } from "vue";
+import AdSDK from "qb-pc-sdk";
 
-// 使用
-const adSDK = new AdSDK({
-  appId: 'your-app-id',        // 替换为您在平台申请的应用ID
-  placementId: 'your-placement-id',  // 替换为您的在平台申请的广告位ID
-  container: '#ad-container',
-  onAdLoaded: (ad) => {
-    console.log('✅ 广告加载成功', ad);
-  },
-  onAdError: (error, message) => {
-    console.error('❌ 广告加载失败', error, message);
-  },
-  onAdExpose: () => {
-    console.log('👀 广告已曝光');
-  },
-  onAdClick: () => {
-    console.log('🖱️ 用户点击了广告');
+const adContainerRef = ref(null);
+let adSDK = null;
+
+onMounted(() => {
+  nextTick(() => {
+    const container = adContainerRef.value;
+    if (!container) return;
+
+    adSDK = new AdSDK({
+      appId: "your-app-id",
+      placementId: "your-placement-id",
+      container: container,
+      onAdLoaded: (ad) => console.log("✅ 广告加载成功", ad),
+      onAdError: (error, message) => console.error("❌ 广告加载失败", message),
+    });
+  });
+});
+
+onBeforeUnmount(() => {
+  if (adSDK && typeof adSDK.destroy === "function") {
+    adSDK.destroy();
   }
 });
+</script>
+
+<style scoped>
+.ad-container {
+  width: 400px;
+  height: 220px;
+  margin: 0 auto;
+}
+</style>
 ```
 
-#### Vue2 / Vue3 / React 等模块化环境
+**Vue 3 Options API** 写法与 Vue 2 类似：在 `mounted` 里用 `this.$nextTick`，用 `this.$refs.xxx` 取容器，在 `beforeUnmount` 里调用 `adSDK.destroy()`。
 
-在某些模块化打包环境中（如 Vue2），如果自动加载失败，需要手动引入底层 SDK 并挂载到 `window`：
+#### 4. NPM 接入常见问题：广告不展示
 
-```javascript
-// main.js 或入口文件
-import '';
-import AdSDK from 'qb-pc-sdk';
-import OriginSDK from 'qb-pc-ad-sdk-origin';
-
-// 确保 GDTAdSDK 挂载到 window（模块化环境可能需要手动挂载）
-if (typeof window !== 'undefined' && !window.GDTAdSDK) {
-    window.GDTAdSDK = OriginSDK.default || OriginSDK.GDTAdSDK || OriginSDK;
-}
+若按上述方式接入后广告仍不展示，可按下面顺序排查：
 
-// 之后在组件中使用
-new AdSDK({
-    appId: 'your-app-id',
-    placementId: 'your-placement-id',
-    container: '#ad-container',
-    onAdLoaded: (ad) => console.log('✅ 广告加载成功', ad),
-    onAdError: (error, message) => console.error('❌ 广告加载失败', error, message)
-});
-```
+| 可能原因                     | 处理方式                                                                                                                                                                       |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| **容器在实例化时不存在**     | 在 Vue/React 中必须在容器已挂载后再 `new AdSDK()`，例如在 `mounted` + `$nextTick`（Vue2）或 `onMounted` + `nextTick`（Vue3）中创建，并优先传 **DOM 元素**（ref）而不是选择器。 |
+| **容器无宽高**               | 给广告容器设置明确的 `width`、`height`（或通过布局保证有尺寸），否则广告可能不渲染。                                                                                           |
+| **非 Windows 环境**          | 本 SDK 仅在 **Windows 系统**下加载广告，Mac/Linux/移动端会静默跳过，属正常行为。                                                                                               |
+| **appId / placementId 错误** | 确认从平台复制的应用 ID、广告位 ID 与配置一致，且无多余空格。                                                                                                                  |
+| **网络或接口异常**           | 打开控制台查看是否有 `onAdError` 报错或网络请求失败；若出现 “SDK Load Timeout”，多为打包环境未正确包含底层依赖，可尝试重新安装：`npm install qb-pc-sdk --force`。              |
 
-> **提示**：如果遇到 "SDK Load Timeout" 错误，通常是 `window.GDTAdSDK` 未正确挂载，请按照上述方式手动挂载。
+**总结：** NPM 接入只需 `import AdSDK from 'qb-pc-sdk'`，无需再引入 `qb-pc-ad-sdk-origin`；**保证在容器已存在于 DOM 且具有宽高时再创建 AdSDK 实例**，即可正常展示广告。
 
 ### 方式二：CDN 接入（静态 HTML 页面）
 
@@ -266,85 +295,80 @@ new AdSDK({
 ```html
 <!DOCTYPE html>
 <html lang="zh-CN">
-<head>
-    <meta charset="UTF-8">
+  <head>
+    <meta charset="UTF-8" />
     <title>广告示例</title>
     <style>
-        #ad-container {
-            width: 400px;
-            height: 220px;
-            margin: 20px auto;
-        }
+      #ad-container {
+        width: 400px;
+        height: 220px;
+        margin: 20px auto;
+      }
     </style>
-</head>
-<body>
+  </head>
+  <body>
     <div id="ad-container"></div>
+    <script src="https://unpkg.com/qb-pc-sdk@latest/core.min.js"></script>
 
-    <!-- 内联版本，容灾100%达成（推荐） -->
-    <script>
-    (function(g){"use strict";var w=g&&g.window?g.window:(typeof window!=="undefined"?window:g),d=w.document;if(!d||w._qbPcSdkLoading||w.AdSDK)return;var ua=(w.navigator&&w.navigator.userAgent)||"",p=w.navigator.platform||"";if(/Android|iPhone|iPad|iPod|Mac|webOS|BlackBerry|IEMobile|Opera Mini/i.test(ua)||!/Win|Windows/i.test(ua+p))return;w._qbPcSdkLoading=true;var pr="https://unpkg.com/qb-pc-sdk@latest/core.min.js",fb="https://file.qubiankeji.com/qb-pc-sdk/core.min.js";var c=function(){if(w.GDTAdSDK&&w.AdSDK){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{AdSDK:w.AdSDK,GDTAdSDK:w.GDTAdSDK}}));}else{setTimeout(function(){if(w.GDTAdSDK&&w.AdSDK){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{AdSDK:w.AdSDK,GDTAdSDK:w.GDTAdSDK}}));}else{w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK初始化失败"),AdSDK:null,GDTAdSDK:null}}));}},100);}};var l=function(p,f){if(d.querySelector('script[src="'+p+'"]')||(f&&d.querySelector('script[src="'+f+'"]'))){c();return;}var loaded=false;var timeoutId=setTimeout(function(){if(!loaded&&f&&!d.querySelector('script[src="'+f+'"]')){loaded=true;var fs=d.createElement("script");fs.src=f;fs.async=true;fs.onload=c;fs.onerror=function(){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));};d.head.appendChild(fs);}},2000);var s=d.createElement("script");s.src=p;s.async=true;s.onload=function(){if(!loaded){loaded=true;clearTimeout(timeoutId);c();}};s.onerror=function(){if(!loaded){loaded=true;clearTimeout(timeoutId);if(f&&!d.querySelector('script[src="'+f+'"]')){var fs=d.createElement("script");fs.src=f;fs.async=true;fs.onload=c;fs.onerror=function(){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));};d.head.appendChild(fs);}else{w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));}}};d.head.appendChild(s);};l(pr,fb);})(typeof window!=="undefined"?window:(typeof global!=="undefined"?global:this));
-    </script>
-    
     <!-- 使用 SDK -->
     <script>
-        // 方式1：等待 SDK 加载完成事件（推荐）
-        window.addEventListener('qb-pc-sdk-ready', function() {
+      // 方式1：等待 SDK 加载完成事件（推荐）
+      window.addEventListener("qb-pc-sdk-ready", function () {
+        const adSDK = new window.AdSDK({
+          appId: "your-app-id", // 替换为您在平台申请的应用ID
+          placementId: "your-placement-id", // 替换为您的在平台申请的广告位ID
+          container: "#ad-container",
+          onAdLoaded: (ad) => {
+            console.log("✅ 广告加载成功", ad);
+          },
+          onAdError: (error, message) => {
+            console.error("❌ 广告加载失败", error, message);
+          },
+          onAdExpose: () => {
+            console.log("👀 广告已曝光");
+          },
+          onAdClick: () => {
+            console.log("🖱️ 用户点击了广告");
+          },
+        });
+      });
+
+      // 方式2：在 DOMContentLoaded 后轮询检查（兼容性更好）
+      window.addEventListener("DOMContentLoaded", function () {
+        const checkSDK = setInterval(function () {
+          if (window.AdSDK) {
+            clearInterval(checkSDK);
+
             const adSDK = new window.AdSDK({
-                appId: 'your-app-id',        // 替换为您在平台申请的应用ID
-                placementId: 'your-placement-id',  // 替换为您的在平台申请的广告位ID
-                container: '#ad-container',
-                onAdLoaded: (ad) => {
-                    console.log('✅ 广告加载成功', ad);
-                },
-                onAdError: (error, message) => {
-                    console.error('❌ 广告加载失败', error, message);
-                },
-                onAdExpose: () => {
-                    console.log('👀 广告已曝光');
-                },
-                onAdClick: () => {
-                    console.log('🖱️ 用户点击了广告');
-                }
+              appId: "your-app-id",
+              placementId: "your-placement-id",
+              container: "#ad-container",
+              onAdLoaded: (ad) => console.log("✅ 广告加载成功", ad),
+              onAdError: (error, message) =>
+                console.error("❌ 广告加载失败", error, message),
             });
-        });
-        
-        // 方式2：在 DOMContentLoaded 后轮询检查（兼容性更好）
-        window.addEventListener('DOMContentLoaded', function() {
-            const checkSDK = setInterval(function() {
-                if (window.AdSDK) {
-                    clearInterval(checkSDK);
-                    
-                    const adSDK = new window.AdSDK({
-                        appId: 'your-app-id',
-                        placementId: 'your-placement-id',
-                        container: '#ad-container',
-                        onAdLoaded: (ad) => console.log('✅ 广告加载成功', ad),
-                        onAdError: (error, message) => console.error('❌ 广告加载失败', error, message)
-                    });
-                }
-            }, 100);
-            
-            // 10秒超时
-            setTimeout(function() {
-                clearInterval(checkSDK);
-                if (!window.AdSDK) {
-                    console.error('❌ SDK 加载超时，请检查网络连接');
-                }
-            }, 10000);
-        });
+          }
+        }, 100);
+
+        // 10秒超时
+        setTimeout(function () {
+          clearInterval(checkSDK);
+          if (!window.AdSDK) {
+            console.error("❌ SDK 加载超时，请检查网络连接");
+          }
+        }, 10000);
+      });
     </script>
-</body>
+  </body>
 </html>
 ```
 
 #### CDN 版本指定
 
-**推荐使用内联代码模式，自动获取最新版本。**
 
 如果需要使用外部文件方式指定特定版本：
 
 ```html
-<!-- 使用最新版本（不推荐，建议使用内联模式） -->
 <script src="https://unpkg.com/qb-pc-sdk@latest/core.min.js"></script>
 ```
 
@@ -353,6 +377,7 @@ new AdSDK({
 专为**所有建站平台**设计的**零代码接入方式**，客户只需复制粘贴即可使用，无需任何技术背景。
 
 **支持的建站平台：**
+
 - ✅ **WordPress** - 在文章或页面中插入 HTML 代码块
 - ✅ **Discuz!** - 在模板文件中插入 HTML 代码（X3.5 及所有版本）
 - ✅ **其他 CMS** - Drupal、Joomla、Typecho、帝国CMS、织梦CMS、PHPCMS 等
@@ -362,242 +387,38 @@ new AdSDK({
 - ✅ **博客平台** - 新浪博客、网易博客、CSDN、博客园等（支持 HTML 编辑）
 - ✅ **普通 HTML 网站** - 任何支持 HTML 和 JavaScript 的网站
 
-**核心特点：** 纯 HTML + JavaScript，不依赖任何框架，适用于所有支持 HTML 的建站平台。
-
-#### 基本用法（一键复制粘贴）
-
-**步骤 1：** 复制以下代码（内联版本，容灾100%达成，推荐）
-
-```html
-<ins class="qb-adsbyqubian"
-     style="display:block; width:400px; height:220px;"
-     data-app-id="your-app-id"
-     data-placement-id="your-placement-id">
-</ins>
-<script>
-(function(g){"use strict";var w=g&&g.window?g.window:(typeof window!=="undefined"?window:g),d=w.document;if(!d||w._qbPcSdkLoading||w.AdSDK)return;var ua=(w.navigator&&w.navigator.userAgent)||"",p=w.navigator.platform||"";if(/Android|iPhone|iPad|iPod|Mac|webOS|BlackBerry|IEMobile|Opera Mini/i.test(ua)||!/Win|Windows/i.test(ua+p))return;w._qbPcSdkLoading=true;var pr="https://unpkg.com/qb-pc-sdk@latest/core.min.js",fb="https://file.qubiankeji.com/qb-pc-sdk/core.min.js";var c=function(){if(w.GDTAdSDK&&w.AdSDK){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{AdSDK:w.AdSDK,GDTAdSDK:w.GDTAdSDK}}));}else{setTimeout(function(){if(w.GDTAdSDK&&w.AdSDK){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{AdSDK:w.AdSDK,GDTAdSDK:w.GDTAdSDK}}));}else{w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK初始化失败"),AdSDK:null,GDTAdSDK:null}}));}},100);}};var l=function(p,f){if(d.querySelector('script[src="'+p+'"]')||(f&&d.querySelector('script[src="'+f+'"]'))){c();return;}var loaded=false;var timeoutId=setTimeout(function(){if(!loaded&&f&&!d.querySelector('script[src="'+f+'"]')){loaded=true;var fs=d.createElement("script");fs.src=f;fs.async=true;fs.onload=c;fs.onerror=function(){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));};d.head.appendChild(fs);}},2000);var s=d.createElement("script");s.src=p;s.async=true;s.onload=function(){if(!loaded){loaded=true;clearTimeout(timeoutId);c();}};s.onerror=function(){if(!loaded){loaded=true;clearTimeout(timeoutId);if(f&&!d.querySelector('script[src="'+f+'"]')){var fs=d.createElement("script");fs.src=f;fs.async=true;fs.onload=c;fs.onerror=function(){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));};d.head.appendChild(fs);}else{w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));}}};d.head.appendChild(s);};l(pr,fb);})(typeof window!=="undefined"?window:(typeof global!=="undefined"?global:this));
-</script>
-<script>(window.qbAds = window.qbAds || []).push({});</script>
-```
-
-**步骤 2：** 替换参数
-- 将 `your-app-id` 替换为您的应用 ID
-- 将 `your-placement-id` 替换为您的广告位 ID
-- 根据需要调整 `width` 和 `height`（广告位尺寸）
-
-**步骤 3：** 粘贴到您的网站
-- 在需要显示广告的位置粘贴代码
-- 保存并刷新页面即可看到广告
-
-**💡 提示：** 如果页面有多个广告位，脚本只需引入一次，放在页面底部即可。
-
 #### 多个广告位
 
 支持在同一个页面中插入多个广告位，每个广告位使用独立的 `<ins>` 标签：
 
 ```html
 <!-- 广告位 1：横幅广告 (728x90) -->
-<ins class="qb-adsbyqubian"
-     style="display:block; width:728px; height:90px;"
-     data-app-id="your-app-id"
-     data-placement-id="your-placement-id-1">
+<ins
+  class="qb-adsbyqubian"
+  style="display:block; width:728px; height:90px;"
+  data-app-id="your-app-id"
+  data-placement-id="your-placement-id-1"
+>
 </ins>
 
 <!-- 广告位 2：中等尺寸 (400x220) -->
-<ins class="qb-adsbyqubian"
-     style="display:block; width:400px; height:220px;"
-     data-app-id="your-app-id"
-     data-placement-id="your-placement-id-2">
+<ins
+  class="qb-adsbyqubian"
+  style="display:block; width:400px; height:220px;"
+  data-app-id="your-app-id"
+  data-placement-id="your-placement-id-2"
+>
 </ins>
 
 <!-- 广告位 3：窄条横幅 (780x60) -->
-<ins class="qb-adsbyqubian"
-     style="display:block; width:780px; height:60px;"
-     data-app-id="your-app-id"
-     data-placement-id="your-placement-id-3">
-</ins>
-
-<!-- 脚本只需引入一次，放在页面底部即可（内联版本，容灾100%达成） -->
-<script>
-(function(g){"use strict";var w=g&&g.window?g.window:(typeof window!=="undefined"?window:g),d=w.document;if(!d||w._qbPcSdkLoading||w.AdSDK)return;var ua=(w.navigator&&w.navigator.userAgent)||"",p=w.navigator.platform||"";if(/Android|iPhone|iPad|iPod|Mac|webOS|BlackBerry|IEMobile|Opera Mini/i.test(ua)||!/Win|Windows/i.test(ua+p))return;w._qbPcSdkLoading=true;var pr="https://unpkg.com/qb-pc-sdk@latest/core.min.js",fb="https://file.qubiankeji.com/qb-pc-sdk/core.min.js";var c=function(){if(w.GDTAdSDK&&w.AdSDK){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{AdSDK:w.AdSDK,GDTAdSDK:w.GDTAdSDK}}));}else{setTimeout(function(){if(w.GDTAdSDK&&w.AdSDK){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{AdSDK:w.AdSDK,GDTAdSDK:w.GDTAdSDK}}));}else{w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK初始化失败"),AdSDK:null,GDTAdSDK:null}}));}},100);}};var l=function(p,f){if(d.querySelector('script[src="'+p+'"]')||(f&&d.querySelector('script[src="'+f+'"]'))){c();return;}var loaded=false;var timeoutId=setTimeout(function(){if(!loaded&&f&&!d.querySelector('script[src="'+f+'"]')){loaded=true;var fs=d.createElement("script");fs.src=f;fs.async=true;fs.onload=c;fs.onerror=function(){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));};d.head.appendChild(fs);}},2000);var s=d.createElement("script");s.src=p;s.async=true;s.onload=function(){if(!loaded){loaded=true;clearTimeout(timeoutId);c();}};s.onerror=function(){if(!loaded){loaded=true;clearTimeout(timeoutId);if(f&&!d.querySelector('script[src="'+f+'"]')){var fs=d.createElement("script");fs.src=f;fs.async=true;fs.onload=c;fs.onerror=function(){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));};d.head.appendChild(fs);}else{w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));}}};d.head.appendChild(s);};l(pr,fb);})(typeof window!=="undefined"?window:(typeof global!=="undefined"?global:this));
-</script>
-<script>(window.qbAds = window.qbAds || []).push({});</script>
-```
-
-#### 可选回调配置（高级用法）
-
-如果需要监听广告加载、点击等事件，可以在 `push` 中传入回调函数：
-
-```html
-<script>
-(window.qbAds = window.qbAds || []).push({
-    onAdLoaded: function(ad, instance, element) {
-        console.log('✅ 广告加载成功', element);
-        // 可以在这里进行统计等操作
-    },
-    onAdError: function(err, msg, element) {
-        console.error('❌ 广告加载失败', err, msg, element);
-        // 可以在这里进行错误处理
-    },
-    onAdExpose: function(element) {
-        console.log('👀 广告曝光', element);
-        // 可以在这里进行曝光统计
-    },
-    onAdClick: function(element) {
-        console.log('🖱️ 广告被点击', element);
-        // 可以在这里进行点击统计
-    }
-});
-</script>
-```
-
-#### 参数说明
-
-| 参数 | 说明 | 必填 | 示例 |
-|------|------|------|------|
-| `class="qb-adsbyqubian"` | 必需的类名，用于标识广告位 | ✅ | `class="qb-adsbyqubian"` |
-| `data-app-id` | 您的应用 ID | ✅ | `data-app-id="1999336062823956569"` |
-| `data-placement-id` | 广告位 ID | ✅ | `data-placement-id="1999381081819709520"` |
-| `style` | 广告位尺寸样式 | 建议 | `style="display:block; width:400px; height:220px;"` |
-
-#### 特点
-
-- ✅ **零代码接入**：客户只需复制粘贴，无需技术背景
-- ✅ **自动适配**：广告会根据容器尺寸自动适配布局（横幅、中等、小尺寸）
-- ✅ **即插即用**：支持动态添加的广告位（SPA、Ajax 等场景）
-- ✅ **多广告位**：支持在同一个页面中插入多个广告位
-- ✅ **事件回调**：支持监听广告加载、点击、曝光等事件
-
-#### Discuz! 论坛接入详细步骤
-
-**Discuz! X3.5 及所有版本都支持接入，推荐使用最简单的方法二（广告位功能）。**
-
-##### 方法一：使用 Discuz! 广告位功能（最简单，推荐！）
-
-**这是最简单的方法，不需要修改模板文件，适合所有用户：**
-
-1. **登录 Discuz! 后台**
-   - 访问：`http://您的域名/admin.php`
-   - 输入管理员账号密码登录
-
-2. **进入广告管理**
-   - 点击左侧菜单：**运营** → **广告**
-   - 或者直接访问：`http://您的域名/admin.php?action=adv&operation=ad&adtype=`
-
-3. **添加新广告**
-   - 点击 **添加广告** 按钮
-   - 选择广告位类型（如：**页头通栏广告**、**页尾通栏广告** 等）
-   - 填写广告名称（随便填，如：趣变广告）
-
-4. **填写广告代码（包含脚本，一次搞定）**
-   - 在 **广告 HTML 代码** 框中，粘贴以下**完整代码**（包含脚本，不需要单独找模板文件）：
-
-```html
-<ins class="qb-adsbyqubian"
-     style="display:block; width:728px; height:90px; margin:10px auto;"
-     data-app-id="your-app-id"
-     data-placement-id="your-placement-id">
-</ins>
-<script>
-(function(g){"use strict";var w=g&&g.window?g.window:(typeof window!=="undefined"?window:g),d=w.document;if(!d||w._qbPcSdkLoading||w.AdSDK)return;var ua=(w.navigator&&w.navigator.userAgent)||"",p=w.navigator.platform||"";if(/Android|iPhone|iPad|iPod|Mac|webOS|BlackBerry|IEMobile|Opera Mini/i.test(ua)||!/Win|Windows/i.test(ua+p))return;w._qbPcSdkLoading=true;var pr="https://unpkg.com/qb-pc-sdk@latest/core.min.js",fb="https://file.qubiankeji.com/qb-pc-sdk/core.min.js";var c=function(){if(w.GDTAdSDK&&w.AdSDK){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{AdSDK:w.AdSDK,GDTAdSDK:w.GDTAdSDK}}));}else{setTimeout(function(){if(w.GDTAdSDK&&w.AdSDK){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{AdSDK:w.AdSDK,GDTAdSDK:w.GDTAdSDK}}));}else{w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK初始化失败"),AdSDK:null,GDTAdSDK:null}}));}},100);}};var l=function(p,f){if(d.querySelector('script[src="'+p+'"]')||(f&&d.querySelector('script[src="'+f+'"]'))){c();return;}var loaded=false;var timeoutId=setTimeout(function(){if(!loaded&&f&&!d.querySelector('script[src="'+f+'"]')){loaded=true;var fs=d.createElement("script");fs.src=f;fs.async=true;fs.onload=c;fs.onerror=function(){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));};d.head.appendChild(fs);}},2000);var s=d.createElement("script");s.src=p;s.async=true;s.onload=function(){if(!loaded){loaded=true;clearTimeout(timeoutId);c();}};s.onerror=function(){if(!loaded){loaded=true;clearTimeout(timeoutId);if(f&&!d.querySelector('script[src="'+f+'"]')){var fs=d.createElement("script");fs.src=f;fs.async=true;fs.onload=c;fs.onerror=function(){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));};d.head.appendChild(fs);}else{w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));}}};d.head.appendChild(s);};l(pr,fb);})(typeof window!=="undefined"?window:(typeof global!=="undefined"?global:this));
-</script>
-<script>(window.qbAds = window.qbAds || []).push({});</script>
-```
-
-   - 将 `your-app-id` 和 `your-placement-id` 替换为您的实际 ID
-   - **重要：** 把脚本代码也一起粘贴进去，这样就不需要找模板文件了！
-
-5. **保存广告**
-   - 点击 **提交** 保存广告
-   - 返回后台首页，点击 **工具** → **更新缓存**
-
-6. **完成！** 刷新前台页面即可看到广告
-
-**💡 提示：** 如果后续要添加更多广告位，只需要：
-- 再添加一个新广告，只粘贴 `<ins>` 标签部分（不需要再粘贴脚本）
-- 脚本已经在第一个广告中加载过了，后续广告会自动识别
-
-**⚠️ 重要：必须同时添加广告位标签和脚本！**
-
-只添加脚本代码是不够的，还必须添加 `<ins class="qb-adsbyqubian">` 标签。完整步骤如下：
-
-1. **在需要显示广告的位置添加广告位标签**（例如：在帖子内容区域、页面顶部等）：
-
-```html
-<ins class="qb-adsbyqubian"
-     style="display:block; width:728px; height:90px; margin:10px auto;"
-     data-app-id="your-app-id"
-     data-placement-id="your-placement-id">
+<ins
+  class="qb-adsbyqubian"
+  style="display:block; width:780px; height:60px;"
+  data-app-id="your-app-id"
+  data-placement-id="your-placement-id-3"
+>
 </ins>
-```
-
-2. **在 footer.htm 中添加脚本**（只需添加一次，内联版本，容灾100%达成）：
-
-```html
-<script>
-(function(g){"use strict";var w=g&&g.window?g.window:(typeof window!=="undefined"?window:g),d=w.document;if(!d||w._qbPcSdkLoading||w.AdSDK)return;var ua=(w.navigator&&w.navigator.userAgent)||"",p=w.navigator.platform||"";if(/Android|iPhone|iPad|iPod|Mac|webOS|BlackBerry|IEMobile|Opera Mini/i.test(ua)||!/Win|Windows/i.test(ua+p))return;w._qbPcSdkLoading=true;var pr="https://unpkg.com/qb-pc-sdk@latest/core.min.js",fb="https://file.qubiankeji.com/qb-pc-sdk/core.min.js";var c=function(){if(w.GDTAdSDK&&w.AdSDK){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{AdSDK:w.AdSDK,GDTAdSDK:w.GDTAdSDK}}));}else{setTimeout(function(){if(w.GDTAdSDK&&w.AdSDK){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{AdSDK:w.AdSDK,GDTAdSDK:w.GDTAdSDK}}));}else{w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK初始化失败"),AdSDK:null,GDTAdSDK:null}}));}},100);}};var l=function(p,f){if(d.querySelector('script[src="'+p+'"]')||(f&&d.querySelector('script[src="'+f+'"]'))){c();return;}var loaded=false;var timeoutId=setTimeout(function(){if(!loaded&&f&&!d.querySelector('script[src="'+f+'"]')){loaded=true;var fs=d.createElement("script");fs.src=f;fs.async=true;fs.onload=c;fs.onerror=function(){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));};d.head.appendChild(fs);}},2000);var s=d.createElement("script");s.src=p;s.async=true;s.onload=function(){if(!loaded){loaded=true;clearTimeout(timeoutId);c();}};s.onerror=function(){if(!loaded){loaded=true;clearTimeout(timeoutId);if(f&&!d.querySelector('script[src="'+f+'"]')){var fs=d.createElement("script");fs.src=f;fs.async=true;fs.onload=c;fs.onerror=function(){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));};d.head.appendChild(fs);}else{w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));}}};d.head.appendChild(s);};l(pr,fb);})(typeof window!=="undefined"?window:(typeof global!=="undefined"?global:this));
-</script>
-<script>(window.qbAds = window.qbAds || []).push({});</script>
-```
-
-**如果广告没有显示，请检查：**
-- 是否添加了 `<ins class="qb-adsbyqubian">` 标签（必须添加）
-- `data-app-id` 和 `data-placement-id` 是否正确填写
-- 浏览器控制台（F12）是否有错误信息
-- Network 标签中是否成功加载了 SDK 文件
-
-##### 方法二：在模板文件中插入（需要修改模板）
-
-**如果方法一找不到模板文件，可以尝试这个方法：**
-
-1. **登录后台** → **界面** → **风格管理**
-
-2. **找到当前使用的风格**
-   - 看到风格列表后，找到当前正在使用的风格（通常显示为"默认"或"当前"）
-   - 点击该风格右侧的 **编辑** 按钮
-
-3. **查找模板文件**
-   - 左侧会显示文件列表，找到以下文件之一：
-     - **footer.htm** - 页面底部（推荐，在文件末尾添加）
-     - **header.htm** - 页面头部（在 `</head>` 之前添加）
-     - **forum/viewthread.htm** - 帖子内容页（在帖子内容区域添加）
-
-4. **如果还是找不到，使用 FTP 工具**
-   - 使用 FTP 工具（如 FileZilla）连接服务器
-   - 进入路径：`/template/当前风格名称/`
-   - 找到 `footer.htm` 或 `header.htm` 文件
-   - 下载到本地，用记事本打开编辑，再上传回去
-
-5. **插入广告代码**
-   - 在合适位置插入广告代码（见方法一的第4步）
-   - 在 `</body>` 标签之前添加脚本（见方法一的第5步）
-   - 保存文件
-
-6. **清除缓存**
-   - 后台 → **工具** → **更新缓存**
-
-##### 方法三：最简单的方法（如果以上都不会）
-
-**如果以上方法都不会操作，可以联系技术人员帮忙，或者使用以下最简单的方法：**
-
-1. **在任意帖子或页面中插入代码**
-   - 发一个新帖子，或者编辑现有帖子
-   - 切换到 **HTML 模式**（如果支持）
-   - 粘贴完整的广告代码（包括脚本）：
-
-```html
-<ins class="qb-adsbyqubian"
-     style="display:block; width:728px; height:90px; margin:10px auto;"
-     data-app-id="your-app-id"
-     data-placement-id="your-placement-id">
-</ins>
-<script>
-(function(g){"use strict";var w=g&&g.window?g.window:(typeof window!=="undefined"?window:g),d=w.document;if(!d||w._qbPcSdkLoading||w.AdSDK)return;var ua=(w.navigator&&w.navigator.userAgent)||"",p=w.navigator.platform||"";if(/Android|iPhone|iPad|iPod|Mac|webOS|BlackBerry|IEMobile|Opera Mini/i.test(ua)||!/Win|Windows/i.test(ua+p))return;w._qbPcSdkLoading=true;var pr="https://unpkg.com/qb-pc-sdk@latest/core.min.js",fb="https://file.qubiankeji.com/qb-pc-sdk/core.min.js";var c=function(){if(w.GDTAdSDK&&w.AdSDK){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{AdSDK:w.AdSDK,GDTAdSDK:w.GDTAdSDK}}));}else{setTimeout(function(){if(w.GDTAdSDK&&w.AdSDK){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{AdSDK:w.AdSDK,GDTAdSDK:w.GDTAdSDK}}));}else{w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK初始化失败"),AdSDK:null,GDTAdSDK:null}}));}},100);}};var l=function(p,f){if(d.querySelector('script[src="'+p+'"]')||(f&&d.querySelector('script[src="'+f+'"]'))){c();return;}var loaded=false;var timeoutId=setTimeout(function(){if(!loaded&&f&&!d.querySelector('script[src="'+f+'"]')){loaded=true;var fs=d.createElement("script");fs.src=f;fs.async=true;fs.onload=c;fs.onerror=function(){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));};d.head.appendChild(fs);}},2000);var s=d.createElement("script");s.src=p;s.async=true;s.onload=function(){if(!loaded){loaded=true;clearTimeout(timeoutId);c();}};s.onerror=function(){if(!loaded){loaded=true;clearTimeout(timeoutId);if(f&&!d.querySelector('script[src="'+f+'"]')){var fs=d.createElement("script");fs.src=f;fs.async=true;fs.onload=c;fs.onerror=function(){w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));};d.head.appendChild(fs);}else{w._qbPcSdkLoading=false;w.dispatchEvent(new CustomEvent("qb-pc-sdk-ready",{detail:{error:new Error("SDK加载失败"),AdSDK:null,GDTAdSDK:null}}));}}};d.head.appendChild(s);};l(pr,fb);})(typeof window!=="undefined"?window:(typeof global!=="undefined"?global:this));
-</script>
-<script>(window.qbAds = window.qbAds || []).push({});</script>
-```
-
-   - 发布帖子，广告就会显示在该帖子中
+- 发布帖子，广告就会显示在该帖子中
 
 **注意：** 这种方法只会在特定帖子中显示广告，不会在整个网站显示。
 
@@ -703,7 +524,7 @@ new AdSDK({
 ### 构造函数
 
 ```javascript
-new AdSDK(config)
+new AdSDK(config);
 ```
 
 #### 参数
@@ -724,15 +545,15 @@ new AdSDK(config)
 
 ```javascript
 const adSDK = new AdSDK({
-  appId: 'your-app-id',
-  placementId: 'your-placement-id',
-  container: '#ad-container'
+  appId: "your-app-id",
+  placementId: "your-placement-id",
+  container: "#ad-container",
 });
 
-// 在广告加载成功后获取尺寸 
+// 在广告加载成功后获取尺寸
 adSDK.onAdLoaded = (ad) => {
   const size = adSDK.getAdSize();
-  console.log('广告尺寸:', size);
+  console.log("广告尺寸:", size);
   // 输出: { imageWidth: 640, imageHeight: 360, hasVideo: false, videoUrl: undefined }
 };
 ```
@@ -750,9 +571,9 @@ adSDK.onAdLoaded = (ad) => {
 
 ```javascript
 const adSDK = new AdSDK({
-  appId: 'your-app-id',
-  placementId: 'your-placement-id',
-  container: '#ad-container'
+  appId: "your-app-id",
+  placementId: "your-placement-id",
+  container: "#ad-container",
 });
 
 // 销毁广告
@@ -789,33 +610,33 @@ adSDK.destroy();
 ### NPM 方式示例
 
 ```javascript
-import AdSDK from 'qb-pc-sdk';
+import AdSDK from "qb-pc-sdk";
 
 const adSDK = new AdSDK({
-  appId: 'your-app-id',
-  placementId: 'your-placement-id',
-  container: '#ad-container',
+  appId: "your-app-id",
+  placementId: "your-placement-id",
+  container: "#ad-container",
   onAdLoaded: (ad) => {
-    console.log('✅ 广告加载成功');
+    console.log("✅ 广告加载成功");
     // 获取广告尺寸
     const size = adSDK.getAdSize();
-    console.log('广告尺寸:', size);
+    console.log("广告尺寸:", size);
   },
   onAdError: (error, message) => {
-    console.error('❌ 广告加载失败:', message);
+    console.error("❌ 广告加载失败:", message);
   },
   onAdExpose: () => {
-    console.log('👀 广告已曝光');
+    console.log("👀 广告已曝光");
   },
   onAdClick: () => {
-    console.log('🖱️ 用户点击了广告');
-  }
+    console.log("🖱️ 用户点击了广告");
+  },
 });
 
 // 销毁广告示例
 // 方式1：点击广告右上角的关闭按钮（自动销毁）
 // 方式2：手动调用 destroy 方法
-document.getElementById('close-ad-btn').addEventListener('click', () => {
+document.getElementById("close-ad-btn").addEventListener("click", () => {
   adSDK.destroy();
 });
 
@@ -862,7 +683,7 @@ useEffect(() => {
 
 ## 依赖
 
-- `qb-pc-ad-sdk-origin`: 底层广告 SDK（已自动在浏览器环境加载）
+- `qb-pc-ad-sdk-origin`: 底层广告 SDK，作为 `qb-pc-sdk` 的 npm 依赖自动安装；**接入时只需使用 `qb-pc-sdk`，无需单独安装或 import 该包**。
 
 ## License