mirror of
https://github.com/zhenxun-org/zhenxun_bot.git
synced 2026-09-29 00:32:06 +08:00
0f91ce03e4
* ♻️ refactor(plugin_switch): 重构功能开关与帮助系统并优化 UI 报表渲染 - 引入策略模式 (Strategy Pattern) 统一插件与被动任务的开关逻辑 - 新增超级用户强制管控功能，支持系统级禁用且群管无法自行开启 - 新增全服群组活跃状态报表与功能全局覆盖率可视化统计图表 - 优化指令解析系统，支持多功能批量开关及更智能的快捷词映射 - 重构帮助系统，支持在帮助页区分展示管理员与超级用户指令 - 细化插件列表状态显示，区分群控、系统管控与全局禁用状态 - UI 组件 UserInfoBlock 新增 extra 扩展插槽支持 - 更新 resources.spec 资源版本要求至 1.1.1 * 🚨 auto fix by pre-commit hooks --------- Co-authored-by: webjoin111 <455457521@qq.com> Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
134 lines
4.2 KiB
Python
134 lines
4.2 KiB
Python
from nonebot.adapters import Bot
|
|
from nonebot.plugin import PluginMetadata
|
|
from nonebot.rule import to_me
|
|
from nonebot_plugin_alconna import (
|
|
Alconna,
|
|
AlconnaQuery,
|
|
Args,
|
|
Match,
|
|
Option,
|
|
Query,
|
|
on_alconna,
|
|
store_true,
|
|
)
|
|
from nonebot_plugin_uninfo import Uninfo
|
|
|
|
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_llm_help, get_plugin_help
|
|
|
|
__plugin_meta__ = PluginMetadata(
|
|
name="帮助",
|
|
description="帮助",
|
|
usage="",
|
|
extra=PluginExtraData(
|
|
author="HibiKier",
|
|
version="0.1",
|
|
plugin_type=PluginType.DEPENDANT,
|
|
is_show=False,
|
|
configs=[
|
|
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,
|
|
),
|
|
RegisterConfig(
|
|
key="HELP_STYLE",
|
|
value="default",
|
|
help="帮助页面的显示样式 (可选值: 'default', 'simple')",
|
|
default_value="default",
|
|
type=str,
|
|
),
|
|
],
|
|
).to_dict(),
|
|
)
|
|
|
|
|
|
_matcher = on_alconna(
|
|
Alconna(
|
|
"功能",
|
|
Args["name?", str],
|
|
Option("-d|--detail", action=store_true, help_text="详细帮助"),
|
|
),
|
|
aliases={"help", "帮助", "菜单"},
|
|
rule=to_me(),
|
|
priority=1,
|
|
block=True,
|
|
)
|
|
|
|
|
|
_matcher.shortcut(
|
|
r"详细帮助",
|
|
command="功能",
|
|
arguments=["--detail"],
|
|
prefix=True,
|
|
)
|
|
|
|
|
|
@_matcher.handle()
|
|
async def _(
|
|
bot: Bot,
|
|
name: Match[str],
|
|
session: Uninfo,
|
|
is_detail: Query[bool] = AlconnaQuery("detail.value", False),
|
|
):
|
|
_is_superuser = session.user.id in bot.config.superusers
|
|
|
|
if name.available:
|
|
help_style = Config.get_config("help", "HELP_STYLE")
|
|
variant = help_style if help_style != "default" else None
|
|
|
|
traditional_help_result = await get_plugin_help(
|
|
session.user.id, name.result, _is_superuser, variant=variant
|
|
)
|
|
|
|
if traditional_help_result is not None:
|
|
await MessageUtils.build_message(traditional_help_result).send(
|
|
reply_to=True
|
|
)
|
|
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("没有查找到这个功能噢...").send(
|
|
reply_to=True
|
|
)
|
|
logger.info(
|
|
f"查看帮助详情失败，未找到: {name.result}", "帮助", session=session
|
|
)
|
|
elif session.group and (gid := session.group.id):
|
|
image_bytes = await create_help_img(session, gid, is_detail.result)
|
|
await MessageUtils.build_message(image_bytes).finish()
|
|
else:
|
|
image_bytes = await create_help_img(session, None, is_detail.result)
|
|
await MessageUtils.build_message(image_bytes).finish()
|