AI 智能客服（AiCustomerService）

独立 BeikeShop 插件，为商城提供前台 AI 智能客服聊天能力。客户在对话中直接提问，智能客服即可自动完成商品咨询、购物车操作、订单/物流/钱包/优惠券查询、人工转接等任务。

功能范围

• 双前台入口：悬浮气泡窗口（widget）与独立全屏聊天页面，两种形态共用同一套对话逻辑与语言机制。
• 会话语言锁定：语言菜单仅显示系统已启用的语言，默认使用系统默认语言；客户手动切换后，后续回复锁定为所选语言，选择保存在本地并在下次访问时自动恢复。未配置文案的语言自动回退系统默认语言。
• 客户上下文：识别当前登录客户身份，涉及隐私的功能只能查询该客户自己的数据；未登录（匿名）会话自动隐藏这类能力。
• 自动应答：集成大模型智能应答，自动分析客户问题并完成相应操作。
• 人工转移：客户明确要求人工客服时，生成转人工处理记录并可推送给客服人员。
• 推送通知：新会话 / 转人工等事件支持推送通知。
• 后台面板：会话管理、客户问题反馈管理、知识库管理。

后台功能

• 会话管理：查看客户会话列表与聊天记录，可从会话直接给客户回复、人工接管或关闭会话。
• 问题反馈：客户在聊天中对 AI 回复点击「有用 / 没用」后，后台会记录这条反馈（含客户问题与 AI 回答）。客服可在反馈列表中按评价类型、处理状态、关键词筛选查看，并可将满意的问答一键收录进知识库。
• 知识库：客服可自行维护「问题 → 标准答案」的问答条目（支持分类、启停用）。AI 应答时，会按客户当前提问与知识库中的问题做匹配，命中后把对应条目作为参考资料提供给大模型，让回答更贴合客服团队预设的标准答案。
• 配额与风控：提供每日配额限制。
• 飞书通知：关键事件支持飞书机器人通知。

语言机制

• 语言菜单选项来自系统已启用语言，不固定写死，不提供"自动"选项。
• 默认语言等于系统默认语言 locale()，与后台 base.locale 一致。
• 前端本地保存客户选择（localStorage），再次打开自动恢复；未选择或已关闭的语言回退系统默认语言。
• 后端 normalizeLang() 校验语言是否在启用列表内，非法值一律回退系统默认语言，并对大模型下发言语锁定指令，保证回复语言与界面语言一致。

内置功能

客户在对话中直接说出需求即可，智能客服会自动完成任务：

• 购物车：查看购物车商品、把商品加入购物车、修改数量、删除商品。
• 订单：查询自己的订单列表（可按状态筛选）和单个订单的详细信息。
• 商品：按关键词搜索在售商品、查看商品详情（价格、库存、规格）。
• 人工转接：客户明确要求人工客服时，自动转接人工服务。

支持接入的插件

智能客服可与其他插件联动，把各插件的功能变成对话中可用的能力，客服会根据客户的问题自动调用。目前支持接入以下插件：

• WalletPay（余额钱包）：客户可查询钱包余额及余额明细（充值、支付、退款、提现等）。
• Ticket（优惠券）：客户可查看名下优惠券（代金券、折扣券，可按状态筛选）。
• LFullReduction（满减活动）：客户可了解当前生效的满减促销活动（条件、优惠方式、活动时间）。
• ExpressTracking（51Tracking 快递追踪）：客户可查询自己的订单物流轨迹。
• KuaiDi100（快递100）：客户可查询自己的订单物流轨迹。
• LComment（AI 智能商品评价）：客户可查看商品评价或自己的历史评价。
• SalesVolume（商品销量）：客户可查询单个商品销量或销量排行榜。

订阅机制（新消息通知）

客户在全屏聊天页可开启「新消息通知」，当客服 / AI 有新的回复时，即使没有停留在聊天页面也能收到系统推送提醒。

• 基于浏览器标准的 Web Push 推送（需 HTTPS 环境与浏览器通知权限）。
• 无需人工配置，浏览器授权后即可订阅。
• 同一设备重复订阅会先清除旧记录，避免重复收到通知。
• 服务端可向该客户的全部订阅推送消息（标题 + 内容 + 跳转链接，默认打开全屏聊天页），单条推送失败不影响其他订阅。
• 客户在聊天状态下不推送，智能辅助决定是否推送。

前台入口

插件启用并在后台开启"客服开关"后生效：

• 悬浮 widget：全站前台页面右下角。
• 全屏页面：打开后不再重复挂载悬浮 widget。

兼容说明

• 大模型服务通过插件设置配置（API 地址、密钥、模型），兼容 OpenAI 协议接口（如 DeepSeek）。

相关界面截图

前台对话

前台与人工客服对话，绿色点表示人工客服的说话

后台管理界面

后台人工客服界面：