源码系统概览
文章正文
这是一套微信生态的在线客服类 PHP 源码，核心是把微信（企业微信客服 / 公众号）收到的用户消息，转发给大模型 API 自动生成回复。
系统整体采用文件存储，不需要安装 MySQL 等数据库，对话历史和配置都以 JSON 文件形式保存在服务器目录中。
后台入口放在 public 目录下，管理员登录后可管理微信配置、AI 配置、产品知识库、人工客服与提醒策略。
AI 回复部分由 AIService 调用 OpenAI 兼容接口（chat/completions）完成，模型名称、API 地址与密钥都集中在 config 里配置。
对话上下文由 ConversationManager 负责，按用户 ID 维护历史消息，并根据 token 上限自动截断，保证多轮对话连贯且不超模型输入限制。
产品知识库会拼接到系统提示词中，包含公司简介、产品列表、FAQ 与促销活动，让 AI 优先使用业务资料作答。
微信侧由 WeChatService 处理，包含签名校验、消息解析、AES 加密解密，并兼容企业微信与公众号两种推送。
用户发送的图片和视频可由 AI 做内容分析，需要模型支持视觉能力并在配置中开启对应开关。
当命中预设关键词时，系统会自动把会话转接给指定人工客服，并向客服推送提醒，复杂问题不必全程依赖 AI。
后台还提供对话记录查看、用户媒体文件管理与运行日志浏览，方便日常运维与问题排查。
安全方面使用 Session 登录、bcrypt 密码哈希与 CSRF Token，默认账号 admin，密码 admin123，部署后务必修改。
部署时只需把 public 设为网站根目录，并把 config.example.php 复制为 config.php 填写微信与大模型参数即可运行。
整套源码结构清晰、依赖少，适合作为二次开发的基础，按需扩展工单、统计或对接更多大模型。
源码简介
这是一套基于 PHP 的微信在线 AI 客服系统源码，面向需要把微信客服接入大模型自动回复的开发者与中小企业。它对接企业微信客服与微信公众号，将用户消息转发给 OpenAI 兼容的大模型生成回复，并支持产品知识库、图片视频识别、人工转接和咨询提醒。系统采用文件存储，无需数据库，部署成本低。适合电商、企业咨询、技术支持等场景，作为智能客服二次开发的基础框架。
适用场景
- 电商客服：自动回答商品咨询、价格与优惠，复杂问题一键转人工
- 企业咨询：7×24 小时处理常见业务问题，降低人工值守成本
- 技术支持：结合图片 / 截图识别，快速定位并解答用户问题
- 教育培训：自动回复课程咨询与报名流程，提供个性化建议
功能亮点
- AI 自动回复与上下文记忆：AIService::generateReply 调用 OpenAI 兼容接口，ConversationManager 维护多轮对话历史并按 token 上限自动截断
- 产品知识库注入：AIService::buildKnowledgeBase 将公司简介、产品列表、FAQ、促销活动拼入系统提示词，让 AI 优先使用业务资料作答
- 微信双向对接：WeChatService 提供签名校验、消息解析与 AES 加密解密，兼容企业微信客服与公众号两种推送
- 图片与视频识别：WeChatService::getMediaUrl / saveMediaToServer 下载媒体，AIService::analyzeMedia 调用视觉模型分析内容（需开启开关）
- 关键词转人工：api.php 检测 human_keywords 命中后调用 transferServiceState 转接，并向客服推送咨询提醒
- 后台管理与安全：public/admin 提供对话、文件、日志、配置与改密页面；Auth 使用 Session + bcrypt + CSRF Token
技术架构与部署指南
| 维度 | 本套源码 | 同类通用方案 |
|---|---|---|
| 技术栈 | 前端：原生 PHP + HTML/CSS 后台界面（public/admin），无前端框架 后端：PHP（7.4–8.4 |
依具体方案选型，需自行搭建与维护 |
| 部署方式 | 将项目上传到服务器，把网站根目录指向 public/，并确保 logs/、data/、public/media 目录可写 | 多托管于第三方平台或订阅云服务 |
| 功能侧重 | AI 自动回复与上下文记忆：AIService::generateReply 调用 OpenAI 兼容接口，Conver | 功能通用，定制深度有限 |
| 数据归属 | 数据自持，部署在自有服务器，不出站 | 数据通常留存于服务商侧 |
| 成本模式 | 获取后自主部署，无持续授权费用 | 通常按订阅或调用量计费 |
技术栈与运行环境
- 前端：原生 PHP + HTML/CSS 后台界面（public/admin），无前端框架
- 后端：PHP（7.4–8.4），模块化 PHP 类（AIService / WeChatService / ConversationManager）
- 数据库：无数据库，采用文件存储（JSON 对话记录、密码与配置文件）
- 运行环境：PHP + cURL、OpenSSL 扩展；网站根目录指向 public/；logs/、data/、public/media 需写权限
- 其他依赖：OpenAI 兼容大模型 API（api_base / api_key / model 可配置）；企业微信 / 微信公众号接口
安装与部署提示
- 将项目上传到服务器，把网站根目录指向 public/，并确保 logs/、data/、public/media 目录可写。
- 复制 config.example.php 为 config.php，填写微信（Token/AppID/Secret 或企业微信 CorpID/AgentID）与大模型 API（api_base/api_key/model）参数。
- 在微信公众平台或企业微信后台把回调地址指向 public/api.php，浏览器访问后台用默认账号 admin / admin123 登录并修改密码。
- 在后台「产品配置」中录入公司信息、产品与 FAQ，按需开启图片 / 视频分析，测试对话与转人工功能。
截图与演示说明
源码内置后台管理界面，可直接看到以下页面（位于 public/admin/）：
- 登录页 index.php 与后台首页 index.php（系统控制台）
- ai_config.php：AI 模型与提示词配置
- wechat_config.php：微信 / 企业微信参数配置
- products_config.php：公司、产品、FAQ、促销活动知识库配置
- customer_service_config.php：人工客服、转接关键词与提醒设置
- conversations.php：用户对话记录查看与详情
- files.php：用户上传的图片 / 视频媒体管理
- logs.php：系统运行日志浏览
- password.php / author.php：管理员密码修改与授权信息
安全风险提示
特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！
- 默认后台账号 admin / 密码 admin123（Auth.php 默认写入），上线前必须修改，避免被他人登录后台。
- 媒体目录 public/media/.htaccess 设置 Access-Control-Allow-Origin “*” 并允许直接访问上传文件，公网可跨域读取用户上传内容，建议按需收紧。
- config.php 内含原作者的绝对路径（如 /www/wwwroot/www.dkym.com/…）与默认站点信息（刀客源码网 dkewl.com），部署前请改成自己的路径与品牌。
- debug.php 调试工具会输出 PHP 版本与配置状态，生产环境建议删除或限制访问，避免信息泄露。
- 对话媒体以明文保存在服务器，建议对敏感行业做访问限制与定期清理。
下载说明
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。