素颜客服网页 + Telegram 群客服系统 1.2可在 宝塔面板 / Nginx / PHP 8.1+ / MySQL 5.7+ 上一键部署;访客首条消息自动建 TG 话题,客服群内回复直达网页,支持自定义头像、拉黑禁言、500MB 分片上传、Web Push 与 PWA,含撤回、引用与操作日志。
一个可直接部署在 宝塔 / Nginx / PHP 8.1+ / MySQL 5.7+ 上的轻量客服系统。
版本与新增文件
- 原始包:
客服系统源码.zip(2026-10-25) - 本包:2026-10-26 线上版本导出
本次线上版本新增了一个文件:
表格
| 文件 | 作用 |
|---|---|
app/format.php |
轻量 Markdown + 白名单 HTML 渲染器(kf_rich_html()),只用于客服发出的内容 |
功能改动
1. 客服头像(后台可上传)
- 入口:后台 → 系统设置 → 基础信息 → 客服头像(选择图片 / 恢复默认)
- 上传后用 GD 居中裁切为 256×256 并重新编码 PNG,存到
/assets/avatar-<随机>.png - 展示位置:访客端顶部头像、客服消息气泡头像、favicon / apple-touch-icon、后台侧栏 logo、登录页 logo
- 配置键:
settings.avatar_url - 接口:
admin/api.php新增save_avatar、reset_avatar(登录 + CSRF 校验) - 上传即换文件名,避免 CDN / 浏览器缓存;旧头像自动清理
2. 访客与会话(Telegram 群工作台)
- 每位访客首次发消息自动创建独立 TG 话题;话题第一条显示 IP、浏览器、系统、设备、来源
- 话题内后续客户消息只显示客户原文,不再重复发送「新消息 / IP / 时间」抬头
- 话题首条信息带「拉黑此访客 / 取消拉黑 / 禁言」按钮;拉黑后访客网页显示会话暂停,无法继续发送
- 客服在话题内直接发消息,或「回复」机器人推送,网页实时收到;也支持
/r 会话号 内容 - 同一个 IP 自动复用同一个会话,消息全部落库;按保留天数自动清理
- 访客浏览器持有随机 token,可在 IPv4 / IPv6 双栈切换时恢复同一会话;换浏览器且换 IP 才会新建
3. 消息与媒体
- 图片、视频、音频、压缩包、文档等任意格式,单文件最大 500MB(分片上传)
- 关键词自动回复、输入框快捷按钮,均可附带媒体
4. 界面与体验
- iOS 风格 UI、深色模式、PWA、移动端安全区
5. 通知与声音
- 首次进入自动弹出通知引导;授权后新消息有系统通知、页面内顶部横幅、提示音
- 支持 Web Push,页面关闭 / 切后台仍可收到系统推送
6. 内置浏览器兼容
- 微信、抖音、QQ 等内置浏览器通常不提供系统通知 / Web Push,页面会提示复制链接到 Chrome / Safari
- 页面内横幅与提示音仍可用
7. 其他优化
- 新增操作日志、撤回信息、引用信息,并修复已知问题、优化细节
部署与访问入口
- 搭建:直接访问域名
/install.php安装即可 - 访客前台:
/kf/ - 管理后台:
/admin/ - 客服工作台:Telegram 群
扩展与二次开发
- 可以让 AI 添加微信公众号对接通知信息,以及 QQ 机器人通知都可以,然后嵌套网页版
- 具体根据自己需求修改即可



