基于Dux PHP Admin框架的AI应用平台

如果不把 Dux AI 当作一个简单的 AI 演示页，你会发现它其实是一套真正能落地到业务中的中台系统。它不是一个聊天页面，而是一个面向真实业务场景的 AI 平台。

具体能做什么？说白了就是：一套智能体平台、一套机器人接入平台、一套知识库与文件解析平台、一套工作流与异步任务平台——外加一套能继续开发传统业务模块和 API 的中后台系统。由于它建立在 Dux PHP Admin 体系上，天然就具备模块化扩展能力，后台页面与资源接口也都现成，菜单、权限、存储、调度这些基础设施全都不用从零搭起。最重要的是：你可以在它的基础上继续扩展业务系统，这一点对已有 PHP 后台的团队来说，非常实用。

核心特性

智能体、机器人、知识库、工作流，这些能力第一次被统一到了一个平台里。智能体本身具备持续扩展的能力，支持 HTTP、函数、知识库、MCP，甚至多媒体能力。换句话说，不管你是要做简单的对话回复，还是复杂的图片生成、视频解析、异步任务轮询，它都能处理。

同步与异步任务兼顾——这一点对于实际业务尤其重要。比如你要跑一个图片生成的流程，或者一个需要轮询结果的自动化逻辑，异步支持就是刚需。机器人方面，已经能接入钉钉、飞书、QQ 机器人、企业微信等主流平台，直接跟现有的 IM 系统对接。而且这套平台天生就适合跟 CRM、OA、预约、电商、客服、医院这些业务系统一起建设，同时也能支撑传统 API、多端前端和中后台系统的开发。

适合什么团队

哪些团队能从这套方案里真正获益？很简单：

想给自己做一个 AI 助手的小团队；想把 AI 接进现有业务系统的企业团队；想做知识库问答、机器人服务、工作流自动化的产品团队；以及，想把 AI 能力直接接进现有 PHP 中后台系统的开发团队。话说回来，如果你当前团队完全没有 PHP 技术栈背景，那可能需要再评估一下技术适配成本。

快速开始

先把环境搭起来。你需要 PHP 8.4、MySQL 8.0（推荐）以及 Composer。接下来，直接拉项目代码：

composer create-project duxweb/dux-ai cd dux-ai

启动本地服务可以选几种方式。最省事的是直接用 PHP 自带服务器：

php -S localhost:8000 -t public

如果你想试试 FrankenPHP 的 Worker 模式，也支持：

frankenphp run
# 或者加载配置文件
frankenphp run --config Caddyfile

访问 http://127.0.0.1:8080 就能用，端口可以在 Caddyfile 里改。Docker 容器内启动也是一条命令的事：

php -S 0.0.0.0:8488 -t public

安装向导直接访问 http://localhost:8000/ 就行。安装完成进入后台的路径是 http://localhost:8000/manage/。

正式部署要点

从测试环境切换到正式环境，有几个关键配置必须注意：Web 根目录要指向 public 目录；配置标准的 PHP 重写规则；在后台 “系统 -> 计划管理” 里添加一个 “AI Scheduler”；然后使用守护进程常驻运行调度器：

php dux scheduler:run

更完整的部署文档建议查看文档站中的“系统部署”章节。

文档导航

目前的文档分为三大部分：使用层面，覆盖服务商、模型、智能体、机器人、知识库、工作流的配置；开发层面，涉及服务调用、能力扩展、驱动注册、工作流开发；API 层面，提供对外聊天接口与后台管理接口的说明。对大多数团队来说，先看使用部分就够了，用到自定义能力时再翻开发文档。

相关项目与演示

Dux AI 的文档和源码都可以在 GitHub 上找到，相关的还有 Dux PHP Admin、Dux Lite、DVHA 等项目。官方演示地址也对外开放，可以直接上手体验。