Flarum AI Support Widget

The AI Support Widget provides intelligent AI assistant functionality for Flarum forums, helping users quickly get information and support.

AI支持小部件为Flarum论坛提供了智能AI助手功能，可以帮助用户快速获取信息和支持。

Features

• Floating AI chat button
• Support for multiple AI providers (DeepSeek, OpenAI)
• Automatic search of forum content for references
• Intelligent answers to user questions
• Knowledge base management for custom responses
• Multilingual support
• User permission control
• Daily usage limits
• AI usage statistics

功能特点

• 悬浮式AI聊天按钮
• 支持多种AI提供商（DeepSeek, OpenAI）
• 自动搜索论坛内容作为参考
• 智能回答用户问题
• 知识库管理，支持自定义回复
• 支持多语言
• 用户使用权限控制
• 每日使用次数限制
• AI使用情况统计

Installation

Install this extension with Composer:

composer require leot/flarum-ai-support-widget

安装

使用Composer安装此扩展：

composer require leot/flarum-ai-support-widget

Configuration

1. Enable the extension in the Flarum admin panel
2. Configure the following options in the settings:
   • AI provider (DeepSeek or OpenAI)
   • API key
   • Model name
   • Maximum tokens
   • Request timeout
   • Usage limit settings
   • Knowledge base entries

配置

1. 在Flarum管理面板中启用扩展
2. 在设置中配置以下选项：
   • AI服务商（DeepSeek或OpenAI）
   • API密钥
   • 模型名称
   • 最大令牌数
   • 请求超时时间
   • 使用限制设置
   • 知识库条目

Troubleshooting

If you encounter issues:

1. Toolbar or UI elements abnormal: Make sure you are using the latest version that has fixed UI conflict issues
2. Unable to load AI chat box: Check the browser console for JavaScript errors
3. API request failure: Verify that your API key and network connection are working properly

故障排除

如果遇到问题：

1. 工具栏或UI元素异常：确保您使用的是最新版本，已修复UI冲突问题
2. 无法加载AI聊天框：检查浏览器控制台是否有JavaScript错误
3. API请求失败：验证API密钥和网络连接是否正常

Changelog

1.4.0

• Added AI usage statistics feature
• Optimized code structure and performance

1.3.0

• Added knowledge base feature for custom AI responses
• Fixed dark mode styling issues for chat input area
• Improved CSS variables usage for better theme compatibility
• Enhanced UI responsiveness in different color schemes

1.2.1

• Fixed cache issues where deleted posts were still being recommended
• Enhanced logging for easier debugging
• Improved visibility checks for search results

1.2.0

• Added user usage limitation feature
• Improved Chinese keyword extraction algorithm
• Optimized search result sorting

1.1.0

• Added DeepSeek AI support
• Fixed UI compatibility issues
• Improved error handling

1.0.0

• Initial release

更新日志

1.4.0

• 添加AI使用情况统计功能
• 优化代码结构和性能

1.3.0

• 添加知识库功能，支持自定义AI回复
• 修复深色模式下聊天输入框样式问题
• 改进CSS变量使用，提高主题兼容性
• 增强不同配色方案下的UI响应性

1.2.1

• 修复已删除帖子仍被推荐的缓存问题
• 增强日志记录，便于调试
• 改进搜索结果的可见性检查

1.2.0

• 添加用户使用限制功能
• 改进中文关键词提取算法
• 优化搜索结果排序

1.1.0

• 增加DeepSeek AI支持
• 修复UI兼容性问题
• 改进错误处理

1.0.0

• 初始版本发布

License

This extension is licensed under the MIT License. See the LICENSE file for details.

许可证

本扩展采用MIT许可证。详见LICENSE文件。