SuperAPI AI 工具集

widget-studio

前端与建站

查看项目

更新于 10-15 19:57

技能介绍

用途:该技能用于在网页项目中集成 Widget Studio SDK。开始前必须先向用户询问 Site Key,该公开密钥形如 site_01702db01234588145cb48be580d575。

主要能力:根据项目文件自动识别项目类型并给出对应集成方式。Next.js 通过 next.config.js、next.config.ts 或 next.config.mjs 判断;React 通过 package.json 中的 react 依赖(且非 Next.js)判断;WordPress 通过 functions.php 或 wp-content 目录判断;Shopify 通过 theme.liquid 或 .shopify 目录判断;HTML 通过存在 .html 且无框架特征判断。

使用方式:所有项目均加载 SDK 脚本 https://widget-studio.weez.boo/sdk/index.global.js。HTML 在 </body> 前引入脚本并调用 WidgetX.init({ siteKey: 'YOUR_SITE_KEY' })。React 在 App 组件中用 useEffect 动态创建 async script,onload 后调用 window.WidgetX?.init,并在清理函数中移除脚本;TypeScript 需补充 Window.WidgetX 的全局类型声明。Next.js App Router 在 app/layout.tsx 使用 next/script 的 afterInteractive 策略加载,文件须为客户端组件。Pages Router 在 pages/_app.tsx 同样使用 next/script。Shopify 在 theme.liquid 的 </body> 前加入脚本,并使用 __widgetx_inited 标志与 setTimeout(init, 50) 轮询防止重复初始化。WordPress 通过 functions.php 的 wp_enqueue_scripts 钩子以 wp_enqueue_script 加载,再用 wp_add_inline_script 注入同样的防重复初始化逻辑。

限制与注意:不要把代码片段简化或改写,必须完整保留结构、变量名与初始化模式,仅将 YOUR_SITE_KEY 替换为真实密钥;Shopify/WordPress 的双重初始化防护用于避免主题重载导致的问题,不可省略;React 的清理函数、TypeScript 类型声明与轮询逻辑不可删除;脚本尽可能带 async;SDK 地址固定为上述 URL。资料未提供收费、价格与更多功能细节。