@chenfengwei/floating-promo-bot

原生 JS 悬浮助手，不依赖 Vue / React / Element Plus，Vue2、Vue3、jQuery、纯 HTML 均可接入。

npm：https://www.npmjs.com/package/@chenfengwei/floating-promo-bot

安装

npm install @chenfengwei/floating-promo-bot

方式一：npm 模块（Vue2 / Vue3 / Webpack / Vite 通用）

import { init } from '@chenfengwei/floating-promo-bot'
import '@chenfengwei/floating-promo-bot/style.css'

init({
  token: 'xxx',                      // 自动登录 token
  address: 'https://www.xxx.com',    // 目标站点域名
  source: 'partner_a',               // 来源标识
})

Vue2 项目在 main.js 或 mounted 里调用即可，无需注册组件。

方式二：script 标签（任意 HTML 页面）

<link rel="stylesheet" href="node_modules/@chenfengwei/floating-promo-bot/dist/floating-promo-bot.css">
<script src="node_modules/@chenfengwei/floating-promo-bot/dist/floating-promo-bot.umd.cjs"></script>
<script>
  FloatingPromoBot.init({
    token: 'xxx',
    address: 'https://www.xxx.com',
    source: 'partner_a',
  })
</script>

跳转规则

用户点击气泡/机器人 → 确认后跳转：

{address}/autologin?token={token}&source={source}

文案、图标、关闭选项均为内置，只需传上述 3 个参数。

参数

| 参数 | 说明 | |------|------| | token | 自动登录凭证 | | address | 目标域名，含 https:// | | source | 来源标识 |

常见问题

• 看不到图标：是否引入 CSS；是否曾关闭 → localStorage.removeItem('floating_promo_hidden_until')
• 跳转不对：检查三个参数是否有值