✨ feat(help): 引入LLM智能帮助并优化其功能 (#1982)

- 【新功能】引入LLM智能帮助功能，当传统帮助未找到结果时，可自动调用LLM提供智能回复
- 【配置项】新增多项LLM帮助相关配置：
    - `ENABLE_LLM_HELPER`: 控制LLM智能帮助的启用与禁用
    - `DEFAULT_LLM_MODEL`: 配置智能帮助使用的LLM模型
    - `LLM_HELPER_STYLE`: 设置LLM回复的口吻或风格
    - `LLM_HELPER_REPLY_AS_IMAGE_THRESHOLD`: 定义LLM回复字数超过此阈值时转为图片发送
- 【逻辑优化】帮助指令处理流程调整：
    - 优先尝试传统插件帮助查询
    - 若传统查询无结果且LLM智能帮助已启用，则调用LLM进行自然语言回答

Co-authored-by: webjoin111 <455457521@qq.com>
Co-authored-by: HibiKier <45528451+HibiKier@users.noreply.github.com>

zhenxun/builtin_plugins/help/__init__.py

@@ -18,12 +18,13 @@ from zhenxun.builtin_plugins.help._config import (
     SIMPLE_DETAIL_HELP_IMAGE,
     SIMPLE_HELP_IMAGE,
 )
+from zhenxun.configs.config import Config
 from zhenxun.configs.utils import PluginExtraData, RegisterConfig
 from zhenxun.services.log import logger
 from zhenxun.utils.enum import PluginType
 from zhenxun.utils.message import MessageUtils
 
-from ._data_source import create_help_img, get_plugin_help
+from ._data_source import create_help_img, get_llm_help, get_plugin_help
 
 __plugin_meta__ = PluginMetadata(
     name="帮助",
@@ -47,6 +48,34 @@ __plugin_meta__ = PluginMetadata(
                 help="帮助详情图片样式 ['normal', 'zhenxun']",
                 default_value="zhenxun",
             ),
+            RegisterConfig(
+                key="ENABLE_LLM_HELPER",
+                value=False,
+                help="是否开启LLM智能帮助功能",
+                default_value=False,
+                type=bool,
+            ),
+            RegisterConfig(
+                key="DEFAULT_LLM_MODEL",
+                value="Gemini/gemini-2.5-flash-lite-preview-06-17",
+                help="智能帮助功能使用的默认LLM模型",
+                default_value="Gemini/gemini-2.5-flash-lite-preview-06-17",
+                type=str,
+            ),
+            RegisterConfig(
+                key="LLM_HELPER_STYLE",
+                value="绪山真寻",
+                help="设置智能帮助功能的回复口吻或风格",
+                default_value="绪山真寻",
+                type=str,
+            ),
+            RegisterConfig(
+                key="LLM_HELPER_REPLY_AS_IMAGE_THRESHOLD",
+                value=100,
+                help="AI帮助回复超过多少字时转为图片发送",
+                default_value=100,
+                type=int,
+            ),
         ],
     ).to_dict(),
 )
@@ -83,20 +112,36 @@ async def _(
     is_detail: Query[bool] = AlconnaQuery("detail.value", False),
 ):
     _is_superuser = is_superuser.result if is_superuser.available else False
+
     if name.available:
-        if _is_superuser and session.user.id not in bot.config.superusers:
-            _is_superuser = False
-        if result := await get_plugin_help(session.user.id, name.result, _is_superuser):
-            await MessageUtils.build_message(result).send(reply_to=True)
-        else:
-            await MessageUtils.build_message("没有此功能的帮助信息...").send(
+        traditional_help_result = await get_plugin_help(
+            session.user.id, name.result, _is_superuser
+        )
+
+        is_plugin_found = not (
+            isinstance(traditional_help_result, str)
+            and "没有查找到这个功能噢..." in traditional_help_result
+        )
+        if is_plugin_found:
+            await MessageUtils.build_message(traditional_help_result).send(
                 reply_to=True
             )
-        logger.info(f"查看帮助详情: {name.result}", "帮助", session=session)
+            logger.info(f"查看帮助详情: {name.result}", "帮助", session=session)
+        elif Config.get_config("help", "ENABLE_LLM_HELPER"):
+            logger.info(f"智能帮助处理问题: {name.result}", "帮助", session=session)
+            llm_answer = await get_llm_help(name.result, session.user.id)
+            await MessageUtils.build_message(llm_answer).send(reply_to=True)
+        else:
+            await MessageUtils.build_message(traditional_help_result).send(
+                reply_to=True
+            )
+            logger.info(
+                f"查看帮助详情失败，未找到: {name.result}", "帮助", session=session
+            )
     elif session.group and (gid := session.group.id):
         _image_path = GROUP_HELP_PATH / f"{gid}_{is_detail.result}.png"
         if not _image_path.exists():
-            result = await create_help_img(session, gid, is_detail.result)
+            await create_help_img(session, gid, is_detail.result)
         await MessageUtils.build_message(_image_path).finish()
     else:
         if is_detail.result:
@@ -104,5 +149,5 @@ async def _(
         else:
             _image_path = SIMPLE_HELP_IMAGE
         if not _image_path.exists():
-            result = await create_help_img(session, None, is_detail.result)
+            await create_help_img(session, None, is_detail.result)
         await MessageUtils.build_message(_image_path).finish()