安装 先备份网站文件和数据库。 解压后将 CustomerServiceWidget 文件夹放入 BeikeShop 根目录的 plugins/ 目录。 后台进入「系统设置 → 插件列表」，安装并启用插件。 进入插件设置，启用客服悬浮窗，填写联系方式并保存。 技术支持QQ:2651785148 版本兼容说明 目标兼容版本：BeikeShop 1.5、1.6、2.0、3.0。插件使用官方文档所述的通用插件启动类和 Blade Hook 机制；不同版本的插件管理界面、配置保存实现及当前主题实际注册的 Hook 可能存在差异。官方文档明确说明 README.md 在 3.0.0.4 及 2.0.0.27 以上才会显示于插件编辑页，因此 README 展示不是插件运行的前置条件。

重要：目前已按公开开发文档完成代码结构适配和静态检查，但未在四个独立版本的真实站点逐一安装验收，不能把目标兼容范围等同于已完成四版本实机认证。 如果某个版本/主题没有 layout.header.code Hook，需改用该主题实际存在的公共 Blade Hook。

配置读取使用 BeikeShop 常见的 plugin_setting($pluginCode, $key, $default) 帮助函数。若目标安装包的具体小版本未提供该函数，前台会安全地不输出组件，不会改动核心文件；需根据该版本源码提供的设置 API 做适配。

安全建议 自定义图标建议使用站内上传图片。 Live Chat 链接只填写可信的 HTTP/HTTPS 地址。 WhatsApp 号码填写国际区号数字，不带 +；Telegram 填用户名。 上线前请在测试站验证后台保存、前台显示、手机端布局和主题 Hook。