实时会话、表情 / 图片 / 视频 / 文件、商品卡片一键推送、消息撤回、自定义访客备注名——零核心代码改动，一个 zip 导入即用，替代官方 ¥1600 元的付费客服应用。
从实时会话到富媒体消息，从商品推送到客户备忘——按真实商城客服场景打磨每一个细节。
访客进店自动建档，消息按 ID 游标增量拉取，未读角标、标题闪烁、新消息提示一应俱全；架构上预留 SSE / Workerman 升级位。
微信同款表情面板；图片支持上传与截图直接粘贴，发送前确认防误触；图片点击在窗口内浮动看大图。
视频在会话中直接播放；Office / WPS / PDF / TXT / ZIP / RAR 以文件卡片发送，点击即开。危险格式一律拒绝。
客服按关键词搜索商品，或直接粘贴商品链接 / 输入 ID 发送；访客在商品页打开会话时自动带上当前商品上下文。
发送后 60 秒内可撤回本人消息，服务端二次校验时限与归属，历史记录保留仅标记状态，双方同步显示「撤回了一条消息」。
给访客改个备忘名（如「张三-售后问题」），仅后台可见；支持按昵称或备注名搜索，客户跟进不再对不上人。
后台一键设置主题色（默认 ShopXO 橙），前台悬浮窗即时焕新；访客 / 客服默认头像可自行替换，打造品牌一致体验。
本人气泡微信绿、URL 自动识别可点、历史浏览不被轮询拽到底部、翻记录时有「↓ 有新消息」提示，访客列表未读角标闪烁。
纯标准插件体系：Hook 注入 + 独立数据表，不动 ShopXO 核心代码，升级不冲突；上传目录独立、文件类型白名单、防伪装文件名。
访客端悬浮窗与后台客服工作台，均按真实实现 1:1 还原——微信式气泡、商品卡片、文件卡片、未读角标，一个不少。
遵循 ShopXO 官方插件规范：Hook 注入 + 独立控制器 + 独立数据表。ShopXO 升级不影响插件，插件卸载不留残留。
widget.js 原生 JS 实现，3 秒短轮询按消息 ID 游标增量拉取，乐观上屏 + 幂等去重。
→ViewFetchEnd 钩子把悬浮窗 HTML / 配置注入每个页面输出，无需改模板文件。
→访客端 Api 与后台工作台 Index 控制器，只做参数校验与调度，业务全部下沉 Service。
→OnlineService 统一业务层：会话、消息、话术、客服状态，游标分页与撤回校验都在这里。
全部基于 ShopXO 既有技术体系，不引入任何陌生依赖——你的团队看得懂、改得动、接得住。
PHP 8+ 严格类型与异常体系，PSR-4 自动加载
ShopXO 6.9.2 同款框架，门面 / Db / 插件体系
零框架零构建，ES5 兼容写法，任何浏览器直接跑
4 张独立表 + 游标索引，读写高效易维护
不需要改代码、不需要配环境。导入、清缓存、刷新页面——客服入口已经出现在你的商城上。
后台「应用管理 → 导入应用」上传 onlineservice.zip，系统自动建表（老版本会自动补充新增字段，数据不丢）。
进入「在线客服 → 设置」配置主题色等选项；随后清除 ShopXO 后台缓存，让钩子配置生效。
前台每个页面右侧出现客服悬浮球；后台「客服工作台」实时收到访客消息，点击即会话。
不修改 ShopXO 任何核心文件，官方升级后插件照常工作；卸载时数据表一并清理。
上传目录独立于插件静态目录，覆盖升级不丢文件；文件类型白名单 + 伪装文件名拦截。
service_id 与客服状态表，多客服自动分配（按在线状态 / 负载）已做好数据准备，可按需升级。localStorage 生成临时标识关联会话，刷新、返回页面不丢失；登录用户则自动关联商城账号，客服在信息栏可直接看到用户身份。upload_max_filesize 与 post_max_size ≥ 20MB。