diff --git a/admin/dashboard/blueprints/plugin_routes.py b/admin/dashboard/blueprints/plugin_routes.py index 40d3dde..682fceb 100644 --- a/admin/dashboard/blueprints/plugin_routes.py +++ b/admin/dashboard/blueprints/plugin_routes.py @@ -7,42 +7,11 @@ from flask import Blueprint, request, jsonify, render_template, current_app from admin.dashboard.blueprints.auth import login_required from utils.robot_cmd.robot_command import GroupBotManager, PermissionStatus -from plugins.robot_menu.menu_render_tool import RobotMenuRenderTool # 创建蓝图 plugin_routes = Blueprint('plugin_routes', __name__) LOG = logger -# 后台命令索引页只复用“命令目录生成”能力，不需要图片渲染， -# 因此这里固定使用轻量 text 配置创建一个工具实例即可。 -_command_catalog_tool = RobotMenuRenderTool( - output_mode="text", - image_fallback_to_text=True, - image_render_timeout_seconds=30, - image_render_retries=1, - image_template_path="plugins/robot_menu/templates/menu_cards.html", - log=LOG, -) - - -def _build_group_options(server) -> list: - """构建后台命令索引页的群组选项列表。""" - group_ids = sorted(set(GroupBotManager.get_group_list() or [])) - options = [] - for group_id in group_ids: - group_name = "" - try: - group_name = server.contact_manager.get_nickname(group_id) or "" - except Exception: - group_name = "" - options.append( - { - "group_id": group_id, - "group_name": str(group_name or group_id), - } - ) - return options - # 机器人管理页面 @plugin_routes.route('/plugins_manage') @@ -51,13 +20,6 @@ def robot_management(): return render_template('plugins_manage.html') -@plugin_routes.route('/command_catalog') -@login_required -def command_catalog_page(): - """后台命令索引页面。""" - return render_template('command_catalog.html') - - @plugin_routes.route('/api/plugins', methods=['GET']) @login_required def get_plugins(): @@ -75,37 +37,6 @@ def get_plugins(): return jsonify({"success": False, "message": f"获取插件列表失败: {str(e)}"}) -@plugin_routes.route('/api/plugins/command_catalog', methods=['GET']) -@login_required -def get_command_catalog(): - """获取后台命令索引数据。""" - try: - server = current_app.dashboard_server - group_id = str(request.args.get('group_id') or '').strip() - - # 后台命令索引默认站在“管理员”视角， - # 这样既能看到当前可用命令，也能看到未启用能力和管理指令。 - catalog = _command_catalog_tool.build_command_catalog_data( - group_id=group_id, - requester_id="dashboard_admin", - force_admin=True, - ) - data = { - **catalog, - "group_options": _build_group_options(server), - "summary": { - "available_manual_count": len(catalog.get("available_manual", []) or []), - "available_auto_count": len(catalog.get("available_auto", []) or []), - "unavailable_manual_count": len(catalog.get("unavailable_manual", []) or []), - "admin_command_count": len(catalog.get("admin_commands", []) or []), - }, - } - return jsonify({"success": True, "data": data}) - except Exception as e: - LOG.error(f"获取命令索引失败: {str(e)}", exc_info=True) - return jsonify({"success": False, "message": f"获取命令索引失败: {str(e)}"}) - - @plugin_routes.route('/api/plugins/group_status', methods=['GET']) @login_required def get_plugin_group_status(): diff --git a/admin/dashboard/templates/base.html b/admin/dashboard/templates/base.html index 84133bc..eca0f07 100644 --- a/admin/dashboard/templates/base.html +++ b/admin/dashboard/templates/base.html @@ -1012,7 +1012,6 @@ items: [ { label: '插件统计', path: '/plugins' }, { label: '插件管理', path: '/plugins_manage' }, - { label: '命令索引', path: '/command_catalog' }, { label: '插件定时任务', path: '/plugin_schedules' }, { label: '群级插件配置', path: '/group_plugin_config' }, { label: '响应指令管理', path: '/fun_command_rules' }, @@ -1153,7 +1152,6 @@ '12': '/virtual_group', '13': '/api_docs', '14': '/system_status', - '18': '/command_catalog', '17': '/system_llm', '15': '/file_browser', '16': '/message_push' diff --git a/admin/dashboard/templates/command_catalog.html b/admin/dashboard/templates/command_catalog.html deleted file mode 100644 index f00ee7c..0000000 --- a/admin/dashboard/templates/command_catalog.html +++ /dev/null @@ -1,478 +0,0 @@ -{% extends "base.html" %} - -{% block title %}命令索引 - 机器人管理后台{% endblock %} - -{% block content %} -
-
-
-
Command Catalog
-

命令索引

-

集中查看当前插件命令、群可用状态、自动能力与管理员触发示例，减少靠记忆找功能的成本。

-
-
- - - - - - 刷新索引 - -
-
- - - - -
可用手动命令
-
{% raw %}{{ summary.available_manual_count || 0 }}{% endraw %}
-
当前群可以直接触发的消息命令
- - - - -
自动能力
-
{% raw %}{{ summary.available_auto_count || 0 }}{% endraw %}
-
无需手动发送指令的自动/定时能力
- - - - -
未启用命令
-
{% raw %}{{ summary.unavailable_manual_count || 0 }}{% endraw %}
-
管理员视角下可看到但当前群不可用的命令
- - - - -
管理命令
-
{% raw %}{{ summary.admin_command_count || 0 }}{% endraw %}
-
群开关、管理员维护等后台辅助命令
- - - - - -
-
-

筛选条件

-

支持按命令、插件名、描述关键词快速定位。

-
- - - -
- - - -
-
-

当前可用命令

-

这里展示的是当前群在管理员视角下“真实可触发”的命令入口。

-
-
- {% raw %}{{ activeGroupLabel }}{% endraw %} -
-
- - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-

未启用命令

-

这部分只在后台管理员视角展示，便于你知道还有哪些能力没在当前群打开。

-
-
- - - - - - - - - - - - - - - -
-
-

自动/定时能力

-

用于提醒你哪些功能不是靠用户发命令触发，而是自动执行。

-
-
-
-
当前没有已启用的自动能力
-
-
-
{% raw %}{{ item.name }}{% endraw %}
- {% raw %}{{ item.category_label }}{% endraw %} -
-
{% raw %}{{ item.description }}{% endraw %}
-
{% raw %}{{ item.availability_reason || '自动执行' }}{% endraw %}
-
-
- - - - - -
-
-

管理命令示例

-

给管理员的常用操作命令，适合快速开关功能和维护群管理员。

-
-
-
-
当前没有管理命令示例
-
-
-
{% raw %}{{ item.title }}{% endraw %}
-
-
{% raw %}{{ item.example }}{% endraw %}
-
{% raw %}{{ item.description }}{% endraw %}
-
-
- -
-{% endblock %} - -{% block scripts %} - -{% endblock %} - -{% block styles %} - -{% endblock %} diff --git a/docs/工程优化与Feature清单.md b/docs/工程优化与Feature清单.md index 2b20d24..eb10978 100644 --- a/docs/工程优化与Feature清单.md +++ b/docs/工程优化与Feature清单.md @@ -585,8 +585,7 @@ - 第一阶段已完成：`菜单 指令清单 / 功能清单 / 命令清单 / 帮助` 已改为基于运行中插件快照自动生成 - 第一阶段已完成：指令清单已按当前群真实可用状态过滤，管理员可额外看到未启用命令与管理命令 -- 第二阶段已完成：后台已新增“命令索引”页面，可按群查看真实可用命令、未启用命令、自动能力与管理员触发示例 -- 后续可继续补充插件触发示例模板、命令分类标签与更细粒度的使用说明 +- 后续可继续补充后台命令索引页、插件触发示例模板与更细粒度的分类标签 建议内容： diff --git a/plugins/robot_menu/menu_render_tool.py b/plugins/robot_menu/menu_render_tool.py index b6286c6..60bb50e 100644 --- a/plugins/robot_menu/menu_render_tool.py +++ b/plugins/robot_menu/menu_render_tool.py @@ -297,7 +297,7 @@ class RobotMenuRenderTool: "status_label": str(normalized_snapshot.get("status_label") or "").strip(), } - def _collect_command_catalog(self, group_id: str, requester_id: str, force_admin: Optional[bool] = None) -> dict: + def _collect_command_catalog(self, group_id: str, requester_id: str) -> dict: """采集当前群和当前身份视角下的命令清单。 输出结构分三层： @@ -307,10 +307,7 @@ class RobotMenuRenderTool: """ plugin_manager = self._get_plugin_manager() snapshots = plugin_manager.get_plugin_snapshots() - if force_admin is None: - is_admin = bool(GroupBotManager.is_admin_for_group(requester_id, group_id)) if group_id else bool(GroupBotManager.is_admin(requester_id)) - else: - is_admin = bool(force_admin) + is_admin = bool(GroupBotManager.is_admin_for_group(requester_id, group_id)) if group_id else bool(GroupBotManager.is_admin(requester_id)) available_manual = [] available_auto = [] @@ -359,13 +356,9 @@ class RobotMenuRenderTool: "generated_at": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()), } - def build_command_catalog_data(self, group_id: str, requester_id: str, force_admin: Optional[bool] = None) -> dict: - """对外暴露统一的命令目录结构，供机器人菜单和后台页面共同复用。""" - return self._collect_command_catalog(group_id, requester_id, force_admin=force_admin) - def build_command_catalog_text(self, group_id: str, requester_id: str) -> str: """构建适合直接发送给用户的文本版命令清单。""" - catalog = self.build_command_catalog_data(group_id, requester_id) + catalog = self._collect_command_catalog(group_id, requester_id) lines = [ "📚 当前群指令清单", f"群ID：{catalog['group_id'] or '私聊'}", @@ -418,7 +411,7 @@ class RobotMenuRenderTool: def build_command_catalog_markdown(self, group_id: str, requester_id: str) -> str: """构建适合图片渲染的 Markdown 版指令清单。""" - catalog = self.build_command_catalog_data(group_id, requester_id) + catalog = self._collect_command_catalog(group_id, requester_id) lines = [ "# 机器人指令清单", "",