如果不把 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
访问 https://127.0.0.1:8080 就能用,端口可以在 Caddyfile 里改。Docker 容器内启动也是一条命令的事:
php -S 0.0.0.0:8488 -t public
安装向导直接访问 https://localhost:8000/ 就行。安装完成进入后台的路径是 https://localhost:8000/manage/。
正式部署要点
从测试环境切换到正式环境,有几个关键配置必须注意:Web 根目录要指向 public 目录;配置标准的 PHP 重写规则;在后台 “系统 -> 计划管理” 里添加一个 “AI Scheduler”;然后使用守护进程常驻运行调度器:
php dux scheduler:run
更完整的部署文档建议查看文档站中的“系统部署”章节。
文档导航
目前的文档分为三大部分:使用层面,覆盖服务商、模型、智能体、机器人、知识库、工作流的配置;开发层面,涉及服务调用、能力扩展、驱动注册、工作流开发;API 层面,提供对外聊天接口与后台管理接口的说明。对大多数团队来说,先看使用部分就够了,用到自定义能力时再翻开发文档。
相关项目与演示
Dux AI 的文档和源码都可以在 GitHub 上找到,相关的还有 Dux PHP Admin、Dux Lite、DVHA 等项目。官方演示地址也对外开放,可以直接上手体验。
