3x-ui/web/controller/setting.go
Aung Ye Zaw 1d2a6d8305 feat: Add Gemini AI integration for intelligent Telegram bot
PRODUCTION-READY IMPLEMENTATION

Features:
- Natural language processing for Telegram bot commands
- Gemini AI-powered intent detection and parameter extraction
- Smart fallback to traditional commands on AI failure
- Rate limiting (20 req/min per user) and response caching (5 min)
- Admin-only access with comprehensive security measures

New Components:
- AIService: Core AI service layer with Gemini SDK integration
- Enhanced Tgbot: AI message handling and action execution
- API Endpoints: /api/setting/ai/update and /api/setting/ai/status
- Database Settings: aiEnabled, aiApiKey, aiMaxTokens, aiTemperature

Files Created (5):
- web/service/ai_service.go (420 lines)
- docs/AI_INTEGRATION.md (comprehensive documentation)
- docs/AI_QUICKSTART.md (5-minute setup guide)
- docs/AI_MIGRATION.md (migration guide)
- docs/IMPLEMENTATION_SUMMARY.md (technical details)

Files Modified (6):
- web/service/tgbot.go: Added AI service integration
- web/service/setting.go: Added AI settings management
- web/controller/setting.go: Added AI configuration endpoints
- web/translation/translate.en_US.toml: Added AI messages
- go.mod: Added Gemini SDK dependencies
- README.md: Added AI feature announcement

Usage Examples:
Instead of: /status
Now works: "show me server status", "what's the CPU?", "check health"

Instead of: /usage user@example.com
Now works: "how much traffic has user@example.com used?"

Setup:
1. Get API key from https://makersuite.google.com/app/apikey
2. Enable in Settings > Telegram Bot > AI Integration
3. Paste API key and save
4. Restart bot
5. Chat naturally!

Technical Details:
- Model: gemini-1.5-flash (fast, cost-effective)
- Architecture: Service layer with dependency injection
- Concurrency: Worker pool (max 10 concurrent)
- Error Handling: Comprehensive with graceful degradation
- Security: Admin-only, rate limited, API key encrypted
- Cost: FREE for typical usage (15 req/min free tier)

Testing:
- No compilation errors
- Backward compatible (no breaking changes)
- Fallback mechanism tested
- Documentation comprehensive

Status: Production Ready
2026-02-02 23:40:45 +06:30

185 lines
5.7 KiB
Go

package controller
import (
"errors"
"fmt"
"time"
"github.com/mhsanaei/3x-ui/v2/util/crypto"
"github.com/mhsanaei/3x-ui/v2/web/entity"
"github.com/mhsanaei/3x-ui/v2/web/service"
"github.com/mhsanaei/3x-ui/v2/web/session"
"github.com/gin-gonic/gin"
)
// updateUserForm represents the form for updating user credentials.
type updateUserForm struct {
OldUsername string `json:"oldUsername" form:"oldUsername"`
OldPassword string `json:"oldPassword" form:"oldPassword"`
NewUsername string `json:"newUsername" form:"newUsername"`
NewPassword string `json:"newPassword" form:"newPassword"`
}
// SettingController handles settings and user management operations.
type SettingController struct {
settingService service.SettingService
userService service.UserService
panelService service.PanelService
}
// NewSettingController creates a new SettingController and initializes its routes.
func NewSettingController(g *gin.RouterGroup) *SettingController {
a := &SettingController{}
a.initRouter(g)
return a
}
// initRouter sets up the routes for settings management.
func (a *SettingController) initRouter(g *gin.RouterGroup) {
g = g.Group("/setting")
g.POST("/all", a.getAllSetting)
g.POST("/defaultSettings", a.getDefaultSettings)
g.POST("/update", a.updateSetting)
g.POST("/updateUser", a.updateUser)
g.POST("/restartPanel", a.restartPanel)
g.GET("/getDefaultJsonConfig", a.getDefaultXrayConfig)
g.POST("/ai/update", a.updateAISetting)
g.GET("/ai/status", a.getAIStatus)
}
// getAllSetting retrieves all current settings.
func (a *SettingController) getAllSetting(c *gin.Context) {
allSetting, err := a.settingService.GetAllSetting()
if err != nil {
jsonMsg(c, I18nWeb(c, "pages.settings.toasts.getSettings"), err)
return
}
jsonObj(c, allSetting, nil)
}
// getDefaultSettings retrieves the default settings based on the host.
func (a *SettingController) getDefaultSettings(c *gin.Context) {
result, err := a.settingService.GetDefaultSettings(c.Request.Host)
if err != nil {
jsonMsg(c, I18nWeb(c, "pages.settings.toasts.getSettings"), err)
return
}
jsonObj(c, result, nil)
}
// updateSetting updates all settings with the provided data.
func (a *SettingController) updateSetting(c *gin.Context) {
allSetting := &entity.AllSetting{}
err := c.ShouldBind(allSetting)
if err != nil {
jsonMsg(c, I18nWeb(c, "pages.settings.toasts.modifySettings"), err)
return
}
err = a.settingService.UpdateAllSetting(allSetting)
jsonMsg(c, I18nWeb(c, "pages.settings.toasts.modifySettings"), err)
}
// updateUser updates the current user's username and password.
func (a *SettingController) updateUser(c *gin.Context) {
form := &updateUserForm{}
err := c.ShouldBind(form)
if err != nil {
jsonMsg(c, I18nWeb(c, "pages.settings.toasts.modifySettings"), err)
return
}
user := session.GetLoginUser(c)
if user.Username != form.OldUsername || !crypto.CheckPasswordHash(user.Password, form.OldPassword) {
jsonMsg(c, I18nWeb(c, "pages.settings.toasts.modifyUserError"), errors.New(I18nWeb(c, "pages.settings.toasts.originalUserPassIncorrect")))
return
}
if form.NewUsername == "" || form.NewPassword == "" {
jsonMsg(c, I18nWeb(c, "pages.settings.toasts.modifyUserError"), errors.New(I18nWeb(c, "pages.settings.toasts.userPassMustBeNotEmpty")))
return
}
err = a.userService.UpdateUser(user.Id, form.NewUsername, form.NewPassword)
if err == nil {
user.Username = form.NewUsername
user.Password, _ = crypto.HashPasswordAsBcrypt(form.NewPassword)
session.SetLoginUser(c, user)
}
jsonMsg(c, I18nWeb(c, "pages.settings.toasts.modifyUser"), err)
}
// restartPanel restarts the panel service after a delay.
func (a *SettingController) restartPanel(c *gin.Context) {
err := a.panelService.RestartPanel(time.Second * 3)
jsonMsg(c, I18nWeb(c, "pages.settings.restartPanelSuccess"), err)
}
// getDefaultXrayConfig retrieves the default Xray configuration.
func (a *SettingController) getDefaultXrayConfig(c *gin.Context) {
defaultJsonConfig, err := a.settingService.GetDefaultXrayConfig()
if err != nil {
jsonMsg(c, I18nWeb(c, "pages.settings.toasts.getSettings"), err)
return
}
jsonObj(c, defaultJsonConfig, nil)
}
// updateAISetting updates AI configuration settings
func (a *SettingController) updateAISetting(c *gin.Context) {
var req struct {
Enabled bool `json:"enabled"`
ApiKey string `json:"apiKey"`
MaxTokens int `json:"maxTokens"`
Temperature float64 `json:"temperature"`
}
if err := c.ShouldBindJSON(&req); err != nil {
jsonMsg(c, I18nWeb(c, "pages.settings.toasts.updateSettings"), err)
return
}
// Update settings
if err := a.settingService.SetAIEnabled(req.Enabled); err != nil {
jsonMsg(c, I18nWeb(c, "pages.settings.toasts.updateSettings"), err)
return
}
if req.ApiKey != "" {
if err := a.settingService.SetAIApiKey(req.ApiKey); err != nil {
jsonMsg(c, I18nWeb(c, "pages.settings.toasts.updateSettings"), err)
return
}
}
if req.MaxTokens > 0 {
if err := a.settingService.SetAIMaxTokens(req.MaxTokens); err != nil {
jsonMsg(c, I18nWeb(c, "pages.settings.toasts.updateSettings"), err)
return
}
}
if req.Temperature > 0 {
tempStr := fmt.Sprintf("%.1f", req.Temperature)
if err := a.settingService.SetAISetting("aiTemperature", tempStr); err != nil {
jsonMsg(c, I18nWeb(c, "pages.settings.toasts.updateSettings"), err)
return
}
}
jsonMsg(c, I18nWeb(c, "pages.settings.toasts.updateSettings"), nil)
}
// getAIStatus returns the current AI service status
func (a *SettingController) getAIStatus(c *gin.Context) {
enabled, _ := a.settingService.GetAIEnabled()
hasApiKey := false
if apiKey, err := a.settingService.GetAIApiKey(); err == nil && apiKey != "" {
hasApiKey = true
}
jsonObj(c, gin.H{
"enabled": enabled,
"hasApiKey": hasApiKey,
"ready": enabled && hasApiKey,
}, nil)
}