nopj/ai
Composer 安装命令:
composer require nopj/ai
包简介
AI assistant integration for Flarum with multi-turn conversation support.
README 文档
README
Flarum 的 AI 助手集成扩展,支持多轮对话、异步回复和原生回复式提及。
功能特性
- 异步 AI 回复,不会阻塞用户正常发帖
- 使用 Flarum 原生
@"显示名称"#p帖子ID格式渲染回复式提及 - 通过持久化的 AI 会话和消息实现多轮讨论记忆
- 可配置 API 端点、模型、系统提示、上下文深度和温度
- 与 Flarum
flarum/mentions扩展完美兼容
环境要求
- Flarum
^1.8 - PHP 8.x
flarum/mentions- 兼容的 Chat Completions API 端点
安装
使用 Composer 安装:
composer require nopj/ai
然后在 Flarum 管理面板中启用该扩展。
配置
在管理面板中配置以下选项:
- AI 用户
- API 端点
- API 密钥
- 模型
- 系统提示
- 最大令牌数
- 温度
- 上下文帖子数量
- 流式模式
工作原理
- 用户回复 AI 用户,或回复由 AI 用户发布的帖子。
- 插件立即创建一个“正在输入”的占位帖子。
- 实际的 AI 请求异步运行。
- 占位帖子在完成后更新为最终的 AI 回复。
这样可以保持正常发帖的响应性,同时保留原生的 Flarum 提及渲染和通知机制。
注意事项
- 最佳生产环境表现需要搭配真实的异步队列 worker 使用。
- 如果论坛仍在使用 Flarum 的同步队列,扩展会自动回退到响应后后台执行。
- 该扩展目前主要针对回复式帖子提及,而非传统的
@user提及通知。
开发
从扩展目录构建前端资源:
cd js
npm install
npm run build
链接
- 源码:https://github.com/chao2hang/nopj-ai
- 问题反馈:https://github.com/chao2hang/nopj-ai/issues
- Packagist:https://packagist.org/packages/nopj/ai
许可证
MIT
nopj/ai 适用场景与选型建议
nopj/ai 是一款 基于 PHP 开发的 Composer 扩展包,目前已累计 24 次下载、GitHub Stars 达 2, 最近一次更新时间为 2026 年 04 月 14 日, 在 PHP 生态内属于活跃度较高的组件。
它主要适用于以下技术方向: 「async」 「assistant」 「ai」 「mentions」 「flarum」 「flarum-extension」 等业务场景。在实际项目中,围绕这些方向常见需要落地的问题包括:接口对接、性能调优、并发安全、与既有框架(Laravel / ThinkPHP / Yii / Webman 等)的兼容适配,以及生产环境的日志埋点与稳定性保障。
我们在过去多个企业项目中使用过 nopj/ai 或与其功能相近的方案,如果你在选型或落地过程中遇到问题,例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查,欢迎联系我们协助评估。
基于 nopj/ai 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。
线上偶发问题、内存泄漏、慢查询、并发异常等排查修复;针对高流量场景做缓存、队列、索引层面的调优。
承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维;也可按月提供技术保姆服务。
与 nopj/ai 相关的其它包
同方向 / 同关键字的高下载量 PHP Composer 包推荐,方便对比选型:
The bundle for easy using json-rpc api on your project
An async event for hyperf.
Linguist is a PHP library for parsing strings and extracting prefixed words in content ideal for working with @mentions, #topics and custom tags.
Magento MCP AI Assistant - A powerful AI assistant for Magento 2 that helps with store data queries and management
Update to jameslkingsley/laravel-mentions for Laravel 6.
CKEditor 4 mentions plugin
统计信息
- 总下载量: 24
- 月度下载量: 0
- 日度下载量: 0
- 收藏数: 2
- 点击次数: 26
- 依赖项目数: 0
- 推荐数: 0
其他信息
- 授权协议: MIT
- 更新时间: 2026-04-14