feat: update help texts

krau · Jan 27, 2025 · 283a038 · 283a038
1 parent 728d309
commit 283a038
Show file tree

Hide file tree

Showing 9 changed files with 71 additions and 13 deletions.
diff --git a/telegram/handlers/admin_debug.go b/telegram/handlers/admin_debug.go
@@ -25,14 +25,20 @@ func DumpArtworkInfo(ctx context.Context, bot *telego.Bot, message telego.Messag
 		utils.ReplyMessage(bot, message, "你没有权限执行此操作")
 		return
 	}
+	helpText := fmt.Sprintf(`
+[管理员] <b>使用 /dump 命令回复一条包含作品链接的消息, 将获取作品信息并以JSON格式回复</b>
+	
+命令语法: %s
 
+若不提供参数, 默认获取所有信息
+			`, common.EscapeHTML("/dump [tags] [artist] [pictures]"))
 	if message.ReplyToMessage == nil {
-		utils.ReplyMessage(bot, message, "请回复一条包含作品链接的消息")
+		utils.ReplyMessageWithHTML(bot, message, helpText)
 		return
 	}
 	sourceURL := utils.FindSourceURLForMessage(message.ReplyToMessage)
 	if sourceURL == "" {
-		utils.ReplyMessage(bot, message, "回复的消息中没有支持的链接")
+		utils.ReplyMessageWithHTML(bot, message, "回复的消息中没有支持的链接, 命令帮助:\n"+helpText)
 		return
 	}
 	_, _, args := telegoutil.ParseCommand(message.Text)

diff --git a/telegram/handlers/admin_delete_artwork.go b/telegram/handlers/admin_delete_artwork.go
@@ -30,8 +30,13 @@ func DeleteArtwork(ctx context.Context, bot *telego.Bot, message telego.Message)
 	} else {
 		sourceURL = sources.FindSourceURL(message.Text)
 	}
+	helpText := fmt.Sprintf(`
+[管理员] <b>使用 /delete 命令回复一条包含作品链接的消息, 或在参数中提供作品链接, 将删除该作品</b>
+
+命令语法: %s
+`, common.EscapeHTML("/delete [作品链接]"))
 	if sourceURL == "" {
-		utils.ReplyMessage(bot, message, "请回复一条消息, 或者指定作品链接")
+		utils.ReplyMessageWithHTML(bot, message, helpText)
 		return
 	}
 	artwork, err := service.GetArtworkByURL(ctx, sourceURL)
@@ -56,7 +61,7 @@ func DeleteArtwork(ctx context.Context, bot *telego.Bot, message telego.Message)
 	}
 
 	if len(args) == 0 {
-		utils.ReplyMessage(bot, message, "请提供要删除的图片需要 (从1开始)")
+		utils.ReplyMessage(bot, message, "请提供要删除的图片序号 (从1开始)")
 		return
 	}
 

diff --git a/telegram/handlers/admin_edit_artwork.go b/telegram/handlers/admin_edit_artwork.go
@@ -33,7 +33,12 @@ func ToggleArtworkR18(ctx context.Context, bot *telego.Bot, message telego.Messa
 		sourceURL = sources.FindSourceURL(message.Text)
 	}
 	if sourceURL == "" {
-		utils.ReplyMessage(bot, message, "请回复一条消息, 或者指定作品链接")
+		helpText := `
+[管理员] <b>使用 /r18 命令回复一条包含作品链接的消息, 或在参数中提供作品链接, 将切换该作品的 R18 值</b>
+
+命令语法: /r18 [作品链接]
+`
+		utils.ReplyMessageWithHTML(bot, message, helpText)
 		return
 	}
 
@@ -346,7 +351,14 @@ func AutoTaggingArtwork(ctx context.Context, bot *telego.Bot, message telego.Mes
 		findUrlInArgs = true
 	}
 	if sourceURL == "" {
-		utils.ReplyMessage(bot, message, "请回复一条消息, 或者指定作品链接")
+		helpText := `
+[管理员] <b>使用 /autotag 命令回复一条包含作品链接的消息, 或在参数中提供作品链接, 将基于AI自动为该作品添加标签</b>
+
+命令语法: /autotag [作品链接] [图片序号]
+
+若不提供参数, 默认选择所有图片
+`
+		utils.ReplyMessageWithHTML(bot, message, helpText)
 		return
 	}
 

diff --git a/telegram/handlers/get_artwork_info.go b/telegram/handlers/get_artwork_info.go
@@ -57,7 +57,12 @@ func GetArtworkInfoCommand(ctx context.Context, bot *telego.Bot, message telego.
 		sourceURL = utils.FindSourceURLForMessage(message.ReplyToMessage)
 	}
 	if sourceURL == "" {
-		utils.ReplyMessage(bot, message, "命令参数或回复的消息中没有找到支持的链接")
+		helpText := `
+<b>使用 /info 命令并在参数中提供作品链接, 或使用该命令回复一条包含支持的链接的消息, 将获取作品信息并发送全部图片</b>
+
+命令语法: /info [作品链接]
+`
+		utils.ReplyMessageWithHTML(bot, message, helpText)
 		return
 	}
 	if err := utils.SendFullArtworkInfo(ctx, bot, message, sourceURL); err != nil {

diff --git a/telegram/handlers/get_file.go b/telegram/handlers/get_file.go
@@ -56,7 +56,12 @@ func GetPictureFile(ctx context.Context, bot *telego.Bot, message telego.Message
 		}
 		picture := getPictureByHash()
 		if picture == nil {
-			utils.ReplyMessage(bot, message, "请回复一条频道的图片消息")
+			helpText := fmt.Sprintf(`
+<b>使用 /files 命令回复一条含有图片或支持的链接的消息, 或在参数中提供作品链接, 将发送作品全部原图文件</b>
+
+命令语法: %s
+`, common.EscapeHTML("/files [作品链接]"))
+			utils.ReplyMessageWithHTML(bot, message, helpText)
 			return
 		}
 		if !multiple {

diff --git a/telegram/handlers/hash.go b/telegram/handlers/hash.go
@@ -14,7 +14,10 @@ import (
 
 func CalculatePicture(ctx context.Context, bot *telego.Bot, message telego.Message) {
 	if message.ReplyToMessage == nil {
-		utils.ReplyMessage(bot, message, "请使用该命令回复一条图片消息")
+		helpText := `
+<b>使用 /hash 命令回复一条图片消息, 将计算图片信息</b>
+		`
+		utils.ReplyMessageWithHTML(bot, message, helpText)
 		return
 	}
 	var waitMessageID int

diff --git a/telegram/handlers/inline_query.go b/telegram/handlers/inline_query.go
@@ -52,7 +52,10 @@ func InlineQuery(ctx context.Context, bot *telego.Bot, query telego.InlineQuery)
 	artworks, err := service.QueryArtworksByTexts(ctx, texts, types.R18TypeAll, 48, adapter.OnlyLoadPicture())
 	if err != nil || len(artworks) == 0 {
 		common.Logger.Errorf("获取图片失败: %s", err)
-		bot.AnswerInlineQuery(telegoutil.InlineQuery(query.ID, telegoutil.ResultArticle(uuid.NewString(), "未找到相关图片", telegoutil.TextMessage("/setu"))))
+		bot.AnswerInlineQuery(telegoutil.InlineQuery(query.ID, telegoutil.ResultArticle(uuid.NewString(), "未找到相关图片", telegoutil.TextMessage(fmt.Sprintf(`
+未找到相关图片 (搜索: %s)
+
+<b>在任意聊天框中输入 @%s [关键词参数] 来查找相关图片</b>`, common.EscapeHTML(queryText), common.EscapeHTML(BotUsername))).WithParseMode(telego.ModeHTML))))
 		return
 	}
 	results := make([]telego.InlineQueryResult, 0, len(artworks))

diff --git a/telegram/handlers/query_artwork.go b/telegram/handlers/query_artwork.go
@@ -85,7 +85,16 @@ func HybridSearchArtworks(ctx context.Context, bot *telego.Bot, message telego.M
 	}
 	_, _, args := telegoutil.ParseCommand(message.Text)
 	if len(args) == 0 {
-		utils.ReplyMessage(bot, message, "使用方法: /hybrid <搜索内容> [语义比例]\n语义比例为0-1的浮点数, 应位于参数列表最后, 越大越趋向于基于语义搜索, 若不提供, 使用默认值0.8")
+		helpText := fmt.Sprintf(`
+<b>使用 /hybrid 命令并提供查询参数, 将使用混合搜索引擎搜索相关图片</b>
+
+命令语法: %s
+
+语义比例为0-1的浮点数, 应位于参数列表最后, 越大越趋向于基于语义搜索, 若不提供, 使用默认值0.8
+
+<i>Tips: 该命令将基于文本语义进行搜索, 而非关键词匹配</i>
+`, common.EscapeHTML("/hybrid <搜索内容> [语义比例]"))
+		utils.ReplyMessageWithHTML(bot, message, helpText)
 		return
 	}
 	var hybridSemanticRatio float64
@@ -124,7 +133,14 @@ func SearchSimilarArtworks(ctx context.Context, bot *telego.Bot, message telego.
 		return
 	}
 	if message.ReplyToMessage == nil {
-		utils.ReplyMessage(bot, message, "请回复一条包含图片或作品链接的消息")
+		helpText := `
+<b>使用 /similar 命令回复一条包含图片或作品链接的消息, 将搜索与该图片相关的作品</b>
+
+命令语法: /similar [偏移量] [限制数量]
+
+若回复的消息中未找到支持的链接, 将尝试识别图片内容并搜索相关作品
+`
+		utils.ReplyMessageWithHTML(bot, message, helpText)
 		return
 	}
 	var sourceURL string

diff --git a/telegram/handlers/search_picture.go b/telegram/handlers/search_picture.go
@@ -22,7 +22,10 @@ import (
 
 func SearchPicture(ctx context.Context, bot *telego.Bot, message telego.Message) {
 	if message.ReplyToMessage == nil {
-		utils.ReplyMessage(bot, message, "请使用该命令回复一条图片消息")
+		helpText := `
+<b>使用 /search 命令回复一条图片消息, 将搜索图片来源</b>
+`
+		utils.ReplyMessageWithHTML(bot, message, helpText)
 		return
 	}
 	msg, err := utils.ReplyMessage(bot, message, "少女祈祷中...")