ErisPulse-HelpModule 2.1.0__py3-none-any.whl → 2.1.2__py3-none-any.whl

ErisPulse_HelpModule/Core.py

@@ -1,26 +1,29 @@
+from typing import Dict, List, Optional
+
 from ErisPulse import sdk
-from ErisPulse.Core.Event import command
 from ErisPulse.Core import config
 from ErisPulse.Core.Bases import BaseModule
-from typing import Dict, List, Optional
+from ErisPulse.Core.Event import command
+
 from .templates import HelpTemplates
 
+
 class HelpModule(BaseModule):
     def __init__(self):
         self.sdk = sdk
         self.logger = sdk.logger.get_child("HelpModule")
         self.command_list = []
         self.command_map = {}
-        
+
     @staticmethod
     def should_eager_load():
         return True
-    
+
     async def on_load(self, event):
         self._register_commands()
         self.logger.info("HelpModule 已加载")
         return True
-        
+
     async def on_unload(self, event):
         self._unregister_commands()
         self.logger.info("HelpModule 已卸载")
@@ -29,62 +32,63 @@ class HelpModule(BaseModule):
     def _get_config(self):
         module_config = config.getConfig("HelpModule")
         if not module_config:
-            default_config = {
-                "show_hidden_commands": False,
-                "group_commands": True
-            }
+            default_config = {"show_hidden_commands": False, "group_commands": True}
             config.setConfig("HelpModule", default_config)
             self.logger.warning("未找到HelpModule配置，已创建默认配置")
             return default_config
         return module_config
-    
-    def _get_command_prefix(self) -> str:
+
+    def _get_all_prefixes(self) -> list:
+        """获取所有命令前缀列表"""
         event_config = config.getConfig("ErisPulse.event", {})
         command_config = event_config.get("command", {})
-        return command_config.get("prefix", "/")
-        
+        prefix = command_config.get("prefix", "/")
+        if isinstance(prefix, list):
+            return [str(p) for p in prefix] if prefix else ["/"]
+        return [str(prefix)]
+
+    def _get_command_prefix(self) -> str:
+        """获取主显示前缀（第一个）"""
+        prefixes = self._get_all_prefixes()
+        return prefixes[0] if prefixes else "/"
+
     def _register_commands(self):
         self.help_command_func = self._create_help_command()
         command(
-            "help", 
-            aliases=["h", "帮助"], 
+            "help",
+            aliases=["h", "帮助"],
             help="显示帮助信息",
-            usage="help [序号] - 显示命令列表或查看指定序号的命令详情"
+            usage="help [序号] - 显示命令列表或查看指定序号的命令详情",
         )(self.help_command_func)
 
     def _unregister_commands(self):
-        if hasattr(self, 'help_command_func'):
+        if hasattr(self, "help_command_func"):
             command.unregister(self.help_command_func)
-    
+
     def _create_help_command(self):
         async def help_command(event):
             await self._handle_help_command(event)
+
         return help_command
 
     def _build_command_list(self) -> List[Dict]:
         self.command_list = []
         module_config = self._get_config()
         show_hidden = module_config.get("show_hidden_commands", False)
-        
+
         if show_hidden:
             all_commands = command.get_commands()
             for cmd_name in all_commands:
                 cmd_info = command.get_command(cmd_name)
                 if cmd_info and cmd_name == cmd_info.get("main_name"):
-                    self.command_list.append({
-                        "name": cmd_name,
-                        "info": cmd_info
-                    })
+                    self.command_list.append({"name": cmd_name, "info": cmd_info})
         else:
             visible_commands = command.get_visible_commands()
             for cmd_name in visible_commands:
                 cmd_info = command.get_command(cmd_name)
                 if cmd_info and cmd_name == cmd_info.get("main_name"):
-                    self.command_list.append({
-                        "name": cmd_name,
-                        "info": cmd_info
-                    })
-        
+                    self.command_list.append({"name": cmd_name, "info": cmd_info})
+
         return self.command_list
 
     def _group_commands_by_category(self, commands: List[Dict]) -> Dict[str, List]:
@@ -96,25 +100,16 @@ class HelpModule(BaseModule):
             grouped[group].append(cmd)
         return grouped
 
-    async def _handle_help_command(self, event: Dict) -> None:
+    async def _handle_help_command(self, event) -> None:
         try:
-            platform = event["platform"]
-            if event.get("detail_type") == "group":
-                target_type = "group"
-                target_id = event["group_id"]
-            elif event.get("detail_type") == "private" or event.get("detail_type") == "user":
-                target_type = "user"
-                target_id = event["user_id"]
-            else:
-                target_type = event.get("detail_type")
-                target_id = event.get("target_id")
-                
-            args = event.get("command", {}).get("args", [])
-            adapter = getattr(sdk.adapter, platform)
-            
+            platform = event.get_platform()
+            args = event.get_command_args()
+
             commands = self._build_command_list()
             module_config = self._get_config()
-            
+
+            prefixes = self._get_all_prefixes()
+
             if args:
                 # 显示命令详情
                 try:
@@ -123,48 +118,46 @@ class HelpModule(BaseModule):
                         # 使用模板构建命令详情
                         templates = HelpTemplates.build_command_detail(
                             self.command_map[index],
-                            self._get_command_prefix()
+                            self._get_command_prefix(),
+                            prefixes,
                         )
-                        help_content = self._select_best_format(platform, templates)
                     else:
                         # 使用错误模板
                         templates = HelpTemplates.build_error(
-                            "序号超出范围",
-                            f"请输入 1-{len(commands)} 之间的序号"
+                            "序号超出范围", f"请输入 1-{len(commands)} 之间的序号"
                         )
-                        help_content = self._select_best_format(platform, templates)
                 except ValueError:
                     templates = HelpTemplates.build_error(
-                        "参数错误",
-                        "请输入有效的序号"
+                        "参数错误", "请输入有效的序号"
                     )
-                    help_content = self._select_best_format(platform, templates)
             else:
                 # 显示命令列表
                 templates = HelpTemplates.build_help_list(
                     commands,
                     self.command_map,
                     self._get_command_prefix(),
-                    module_config.get("group_commands", True)
+                    module_config.get("group_commands", True),
+                    prefixes,
                 )
-                help_content = self._select_best_format(platform, templates)
-            
-            # 发送消息
-            await self._send_with_format(adapter, target_type, target_id, help_content)
+
+            # 根据平台能力选择最佳格式，通过 event.reply 发送
+            # event.reply 内部自动解析会话类型（含 channel/guild/thread 等）
+            format_name, content = self._select_best_format(platform, templates)
+            await event.reply(content, method=format_name)
         except Exception as e:
             self.logger.error(f"处理帮助命令时出错: {e}", exc_info=True)
-    
+
     def _select_best_format(self, platform: str, templates: Dict[str, str]) -> tuple:
         """
         根据平台支持的发送方法选择最佳格式
         优先使用 list_sends，不支持时使用 hasattr 兜底
-        
+
         返回: (format_name, content)
         """
         # 首先尝试使用 list_sends（推荐方式）
         try:
             supported_methods = sdk.adapter.list_sends(platform)
-            
+
             # 优先级: Html > Markdown > Text
             if "Html" in supported_methods:
                 return ("Html", templates["html"])
@@ -174,15 +167,15 @@ class HelpModule(BaseModule):
                 return ("Text", templates["text"])
         except Exception as e:
             self.logger.warning(f"list_sends 检测失败: {e}，尝试使用 hasattr 兜底")
-            
+
             # 使用 hasattr 作为兜底方案
             adapter = getattr(sdk.adapter, platform)
             send_obj = adapter.Send if hasattr(adapter, "Send") else None
-            
+
             if send_obj is None:
                 self.logger.warning(f"平台 {platform} 不支持 Send 接口，使用纯文本格式")
                 return ("Text", templates["text"])
-            
+
             # 检查支持的方法
             if hasattr(send_obj, "Html"):
                 return ("Html", templates["html"])
@@ -190,15 +183,3 @@ class HelpModule(BaseModule):
                 return ("Markdown", templates["markdown"])
             else:
                 return ("Text", templates["text"])
-    
-    async def _send_with_format(self, adapter, target_type: str, target_id: str, 
-                                format_content: tuple) -> None:
-        format_name, content = format_content
-        
-        # 根据格式调用对应的发送方法
-        if format_name == "Html":
-            await adapter.Send.To(target_type, target_id).Html(content)
-        elif format_name == "Markdown":
-            await adapter.Send.To(target_type, target_id).Markdown(content)
-        else:  # Text
-            await adapter.Send.To(target_type, target_id).Text(content)

ErisPulse_HelpModule/templates.py

@@ -2,50 +2,95 @@
 帮助模块模板系统
 提供多平台支持的消息模板
 """
+
 from typing import Dict, List, Optional
+
 from ErisPulse.Core.Event import command
 
 
 class HelpTemplates:
     """帮助模块模板类"""
-    
+
     # 配色方案
     PRIMARY_COLOR = "#1565c0"  # 蓝色 - 主标题
     SUCCESS_COLOR = "#2e7d32"  # 绿色 - 成功信息
     WARNING_COLOR = "#e65100"  # 橙色 - 警告信息
-    ERROR_COLOR = "#b71c1c"    # 红色 - 错误信息
-    
+    ERROR_COLOR = "#b71c1c"  # 红色 - 错误信息
+
     # 半透明背景色
     PRIMARY_BG = "rgba(21, 101, 192, 0.05)"
     SUCCESS_BG = "rgba(76, 175, 80, 0.1)"
     WARNING_BG = "rgba(255, 167, 38, 0.15)"
     ERROR_BG = "rgba(183, 28, 28, 0.1)"
-    
+
     @classmethod
     def _get_group_name(cls, group: str) -> str:
         if group == "default":
             return "通用命令"
         return f"{group}命令" if group else "其他"
-    
+
+    @classmethod
+    def _other_prefixes(cls, prefixes: list, display_prefix: str) -> list:
+        """获取除主前缀外的其他前缀"""
+        if not prefixes or len(prefixes) <= 1:
+            return []
+        return [p for p in prefixes if p != display_prefix]
+
+    @classmethod
+    def _prefix_note_html(cls, other_prefixes: list) -> str:
+        if not other_prefixes:
+            return ""
+        note = "、".join(
+            f"<code style='font-size:11px;'>{p}</code>" for p in other_prefixes
+        )
+        return f'<div style="font-size: 11px; color: #999; margin-top: 4px;">其他触发前缀: {note}</div>'
+
+    @classmethod
+    def _prefix_note_text(cls, other_prefixes: list) -> str:
+        if not other_prefixes:
+            return ""
+        note = "、".join(other_prefixes)
+        return f"\n其他触发前缀: {note}"
+
     # ==================== 帮助列表模板 ====================
-    
+
     @classmethod
-    def build_help_list(cls, commands: List[Dict], command_map: Dict[int, Dict], 
-                      prefix: str, group_commands: bool = True) -> Dict[str, str]:
+    def build_help_list(
+        cls,
+        commands: List[Dict],
+        command_map: Dict[int, Dict],
+        prefix: str,
+        group_commands: bool = True,
+        prefixes: Optional[list] = None,
+    ) -> Dict[str, str]:
+        other_prefixes = cls._other_prefixes(prefixes or [prefix], prefix)
+
         # 构建 HTML
-        html = cls._build_help_list_html(commands, command_map, prefix, group_commands)
-        
+        html = cls._build_help_list_html(
+            commands, command_map, prefix, group_commands, other_prefixes
+        )
+
         # 构建 Markdown
-        markdown = cls._build_help_list_markdown(commands, command_map, prefix, group_commands)
-        
+        markdown = cls._build_help_list_markdown(
+            commands, command_map, prefix, group_commands, other_prefixes
+        )
+
         # 构建 Text
-        text = cls._build_help_list_text(commands, command_map, prefix, group_commands)
-        
+        text = cls._build_help_list_text(
+            commands, command_map, prefix, group_commands, other_prefixes
+        )
+
         return {"html": html, "markdown": markdown, "text": text}
-    
+
     @classmethod
-    def _build_help_list_html(cls, commands: List[Dict], command_map: Dict[int, Dict],
-                            prefix: str, group_commands: bool) -> str:
+    def _build_help_list_html(
+        cls,
+        commands: List[Dict],
+        command_map: Dict[int, Dict],
+        prefix: str,
+        group_commands: bool,
+        other_prefixes: Optional[list] = None,
+    ) -> str:
         # 重置命令映射
         grouped = {}
         if group_commands:
@@ -56,27 +101,27 @@ class HelpTemplates:
                 grouped[group].append(cmd)
         else:
             grouped["default"] = commands
-        
+
         # 构建命令列表 HTML（带展开/折叠功能）
         commands_html = ""
         global_idx = 1
-        
+
         for group, cmds in grouped.items():
             group_name = cls._get_group_name(group)
-            
+
             commands_html += f"""
 <div style="font-size:13px; margin-bottom: 8px; font-weight: bold; color: {cls.PRIMARY_COLOR};">{group_name}</div>
 """
-            
+
             for cmd in cmds:
                 name = cmd["name"]
                 info = cmd["info"]
                 help_text = info.get("help", "暂无描述")
                 command_map[global_idx] = cmd
-                
+
                 # 构建命令详情内容
                 detail_content = cls._build_command_detail_inline(name, info, prefix)
-                
+
                 commands_html += f"""<details style="margin-bottom: 8px;">
     <summary style="cursor: pointer; font-size: 13px; padding: 4px; background: rgba(0, 0, 0, 0.02); border-radius: 4px; display: flex; align-items: center;">
         <span style="font-weight: bold; margin-right: 8px;">{global_idx}.</span>
@@ -87,43 +132,45 @@ class HelpTemplates:
         {detail_content}
     </div>
 </details>"""
-                global_idx +=1
-            
+                global_idx += 1
+
             commands_html += "\n"
-        
+
         # 构建完整 HTML
         html = f"""<div style="padding: 12px; border-radius: 8px;">
     <div style="color: {cls.PRIMARY_COLOR}; font-size: 16px; font-weight: bold; margin-bottom: 12px;">
         命令帮助
     </div>
-    
+
     <div style="padding: 8px; background: {cls.PRIMARY_BG}; border-radius: 6px; margin-bottom: 12px;">
         <div style="font-size: 13px;">
             使用 '{prefix}help <序号>' 查看命令详情
         </div>
     </div>
-    
+
     {commands_html}
-    
+
     <div style="font-size: 12px; color: #666; margin-top: 8px;">
         共 {len(commands)} 个可用命令
     </div>
+    {cls._prefix_note_html(other_prefixes or [])}
 </div>"""
-        
+
         return html
-    
+
     @classmethod
-    def _build_help_list_markdown(cls, commands: List[Dict], command_map: Dict[int, Dict],
-                                 prefix: str, group_commands: bool) -> str:
-        lines = [
-            "**命令帮助**",
-            "",
-            f"使用 `{prefix}help <序号>` 查看命令详情",
-            ""
-        ]
-        
+    def _build_help_list_markdown(
+        cls,
+        commands: List[Dict],
+        command_map: Dict[int, Dict],
+        prefix: str,
+        group_commands: bool,
+        other_prefixes: Optional[list] = None,
+    ) -> str:
+        lines = ["**命令帮助**", "", f"使用 `{prefix}help <序号>` 查看命令详情", ""]
+
         global_idx = 1
-        
+
         if group_commands:
             grouped = {}
             for cmd in commands:
@@ -131,19 +178,19 @@ class HelpTemplates:
                 if group not in grouped:
                     grouped[group] = []
                 grouped[group].append(cmd)
-            
+
             for group, cmds in grouped.items():
                 group_name = cls._get_group_name(group)
                 lines.append(f"**{group_name}**")
                 lines.append("")
-                
+
                 for cmd in cmds:
                     name = cmd["name"]
                     help_text = cmd["info"].get("help", "暂无描述")
                     command_map[global_idx] = cmd
                     lines.append(f"{global_idx}. `{prefix}{name}` - {help_text}")
                     global_idx += 1
-                
+
                 lines.append("")
         else:
             lines.append("**所有命令**")
@@ -155,24 +202,33 @@ class HelpTemplates:
                 lines.append(f"{global_idx}. `{prefix}{name}` - {help_text}")
                 global_idx += 1
             lines.append("")
-        
+
         lines.append("---")
         lines.append(f"共 {len(commands)} 个可用命令")
-        
+        if other_prefixes:
+            lines.append("")
+            lines.append(f"其他触发前缀: {'、'.join(other_prefixes)}")
+
         return "\n".join(lines)
-    
+
     @classmethod
-    def _build_help_list_text(cls, commands: List[Dict], command_map: Dict[int, Dict],
-                             prefix: str, group_commands: bool) -> str:
+    def _build_help_list_text(
+        cls,
+        commands: List[Dict],
+        command_map: Dict[int, Dict],
+        prefix: str,
+        group_commands: bool,
+        other_prefixes: Optional[list] = None,
+    ) -> str:
         lines = [
             "命令帮助",
             "----------",
             f"使用 '{prefix}help <序号>' 查看命令详情",
-            ""
+            "",
         ]
-        
+
         global_idx = 1
-        
+
         if group_commands:
             grouped = {}
             for cmd in commands:
@@ -180,19 +236,19 @@ class HelpTemplates:
                 if group not in grouped:
                     grouped[group] = []
                 grouped[group].append(cmd)
-            
+
             for group, cmds in grouped.items():
                 group_name = cls._get_group_name(group)
                 lines.append(f"[{group_name}]")
                 lines.append("")
-                
+
                 for cmd in cmds:
                     name = cmd["name"]
                     help_text = cmd["info"].get("help", "暂无描述")
                     command_map[global_idx] = cmd
                     lines.append(f"{global_idx}. {prefix}{name} - {help_text}")
                     global_idx += 1
-                
+
                 lines.append("")
         else:
             lines.append("[所有命令]")
@@ -204,53 +260,58 @@ class HelpTemplates:
                 lines.append(f"{global_idx}. {prefix}{name} - {help_text}")
                 global_idx += 1
             lines.append("")
-        
+
         lines.append("----------")
         lines.append(f"共 {len(commands)} 个可用命令")
-        
+        if other_prefixes:
+            lines.append("")
+            lines.append(f"其他触发前缀: {'、'.join(other_prefixes)}")
+
         return "\n".join(lines)
-    
+
     @classmethod
     def _build_command_detail_inline(cls, name: str, info: Dict, prefix: str) -> str:
         """
         构建内联命令详情（用于展开区域）
         """
         parts = []
-        
+
         # 描述
         parts.append(f"""<div style="margin-bottom: 8px;">
         <strong style="font-size: 12px; color: {cls.PRIMARY_COLOR};">描述:</strong>
-        <span style="font-size: 12px; margin-left: 8px;">{info.get('help', '暂无描述')}</span>
+        <span style="font-size: 12px; margin-left: 8px;">{info.get("help", "暂无描述")}</span>
     </div>""")
-        
+
         # 别名 - 从全局 command.aliases 获取
-        main_name = info.get('main_name', name)
+        main_name = info.get("main_name", name)
         aliases = []
         for alias, mapped_name in command.aliases.items():
             if mapped_name == main_name and alias != main_name:
                 aliases.append(alias)
-        
+
         if aliases:
-            aliases_text = ", ".join(f"<code style='font-size: 11px;'>{prefix}{a}</code>" for a in aliases)
+            aliases_text = ", ".join(
+                f"<code style='font-size: 11px;'>{prefix}{a}</code>" for a in aliases
+            )
             parts.append(f"""<div style="margin-bottom: 8px;">
         <strong style="font-size: 12px; color: {cls.PRIMARY_COLOR};">别名:</strong>
         <span style="font-size: 12px; margin-left: 8px;">{aliases_text}</span>
     </div>""")
-        
+
         # 用法
         if info.get("usage"):
             parts.append(f"""<div style="margin-bottom: 8px;">
         <strong style="font-size: 12px; color: {cls.PRIMARY_COLOR};">用法:</strong>
-        <span style="font-size: 12px; margin-left: 8px; font-family: monospace; background: rgba(0, 0, 0, 0.03); padding: 2px 6px; border-radius: 3px;">{info['usage'].replace('/', prefix)}</span>
+        <span style="font-size: 12px; margin-left: 8px; font-family: monospace; background: rgba(0, 0, 0, 0.03); padding: 2px 6px; border-radius: 3px;">{info["usage"].replace("/", prefix)}</span>
     </div>""")
-        
+
         # 权限
         if info.get("permission"):
             parts.append(f"""<div style="margin-bottom: 8px;">
         <strong style="font-size: 12px; color: {cls.PRIMARY_COLOR};">权限:</strong>
         <span style="font-size: 12px; margin-left: 8px; color: {cls.WARNING_COLOR};">需要特殊权限</span>
     </div>""")
-        
+
         # 分组
         if info.get("group"):
             group_name = cls._get_group_name(info["group"])
@@ -258,36 +319,42 @@ class HelpTemplates:
         <strong style="font-size: 12px; color: {cls.PRIMARY_COLOR};">分组:</strong>
         <span style="font-size: 12px; margin-left: 8px;">{group_name}</span>
     </div>""")
-        
+
         return "\n".join(parts)
-    
+
     # ==================== 命令详情模板 ====================
-    
+
     @classmethod
-    def build_command_detail(cls, cmd: Dict, prefix: str) -> Dict[str, str]:
+    def build_command_detail(
+        cls, cmd: Dict, prefix: str, prefixes: Optional[list] = None
+    ) -> Dict[str, str]:
+        other_prefixes = cls._other_prefixes(prefixes or [prefix], prefix)
+
         # 构建 HTML
-        html = cls._build_command_detail_html(cmd, prefix)
-        
+        html = cls._build_command_detail_html(cmd, prefix, other_prefixes)
+
         # 构建 Markdown
-        markdown = cls._build_command_detail_markdown(cmd, prefix)
-        
+        markdown = cls._build_command_detail_markdown(cmd, prefix, other_prefixes)
+
         # 构建 Text
-        text = cls._build_command_detail_text(cmd, prefix)
-        
+        text = cls._build_command_detail_text(cmd, prefix, other_prefixes)
+
         return {"html": html, "markdown": markdown, "text": text}
-    
+
     @classmethod
-    def _build_command_detail_html(cls, cmd: Dict, prefix: str) -> str:
+    def _build_command_detail_html(
+        cls, cmd: Dict, prefix: str, other_prefixes: Optional[list] = None
+    ) -> str:
         name = cmd["name"]
         info = cmd["info"]
-        
+
         html_parts = [
             f"""<div style="padding: 12px; border-radius: 8px;">
     <div style="color: {cls.PRIMARY_COLOR}; font-size: 16px; font-weight: bold; margin-bottom: 12px;">
         命令详情: {prefix}{name}
     </div>"""
         ]
-        
+
         # 描述
         html_parts.append(f"""
     <div style="margin-bottom: 12px; border: 1px solid #e0e0e0; padding: 12px; border-radius: 6px;">
@@ -295,17 +362,17 @@ class HelpTemplates:
             <strong style="font-size: 14px;">描述:</strong>
         </div>
         <div style="font-size: 13px;">
-            {info.get('help', '暂无描述')}
+            {info.get("help", "暂无描述")}
         </div>
     </div>""")
-        
+
         # 别名 - 从全局 command.aliases 获取
-        main_name = info.get('main_name', name)
+        main_name = info.get("main_name", name)
         aliases = []
         for alias, mapped_name in command.aliases.items():
             if mapped_name == main_name and alias != main_name:
                 aliases.append(alias)
-        
+
         if aliases:
             aliases_text = ", ".join(f"{prefix}{a}" for a in aliases)
             html_parts.append(f"""
@@ -317,7 +384,7 @@ class HelpTemplates:
             {aliases_text}
         </div>
     </div>""")
-        
+
         # 用法
         if info.get("usage"):
             html_parts.append(f"""
@@ -326,10 +393,10 @@ class HelpTemplates:
             <strong>用法:</strong>
         </div>
         <div style="font-size: 13px; font-family: monospace; background: rgba(0, 0, 0, 0.03); padding: 6px; border-radius: 4px;">
-            {info['usage'].replace('/', prefix)}
+            {info["usage"].replace("/", prefix)}
         </div>
     </div>""")
-        
+
         # 权限
         if info.get("permission"):
             html_parts.append(f"""
@@ -341,7 +408,7 @@ class HelpTemplates:
             需要特殊权限
         </div>
     </div>""")
-        
+
         # 分组
         if info.get("group"):
             group_name = cls._get_group_name(info["group"])
@@ -354,97 +421,111 @@ class HelpTemplates:
             {group_name}
         </div>
     </div>""")
-        
+
+        if other_prefixes:
+            html_parts.append(f"""
+    {cls._prefix_note_html(other_prefixes)}""")
+
         html_parts.append("</div>")
-        
+
         return "\n".join(html_parts)
-    
+
     @classmethod
-    def _build_command_detail_markdown(cls, cmd: Dict, prefix: str) -> str:
+    def _build_command_detail_markdown(
+        cls, cmd: Dict, prefix: str, other_prefixes: Optional[list] = None
+    ) -> str:
         name = cmd["name"]
         info = cmd["info"]
-        
+
         lines = [
             f"**命令详情:** `{prefix}{name}`",
             "",
             f"**描述:** {info.get('help', '暂无描述')}",
-            ""
+            "",
         ]
-        
+
         # 别名 - 从全局 command.aliases 获取
-        main_name = info.get('main_name', name)
+        main_name = info.get("main_name", name)
         aliases = []
         for alias, mapped_name in command.aliases.items():
             if mapped_name == main_name and alias != main_name:
                 aliases.append(alias)
-        
+
         if aliases:
             aliases_text = ", ".join(f"`{prefix}{a}`" for a in aliases)
             lines.append(f"**别名:** {aliases_text}")
             lines.append("")
-        
+
         # 用法
         if info.get("usage"):
             lines.append(f"**用法:** `{info['usage'].replace('/', prefix)}`")
             lines.append("")
-        
+
         # 权限
         if info.get("permission"):
             lines.append("**权限:** 需要特殊权限")
             lines.append("")
-        
+
         # 分组
         if info.get("group"):
             group_name = cls._get_group_name(info["group"])
             lines.append(f"**分组:** {group_name}")
             lines.append("")
-        
+        if other_prefixes:
+            lines.append(f"其他触发前缀: {'、'.join(other_prefixes)}")
+            lines.append("")
+
         return "\n".join(lines)
-    
+
     @classmethod
-    def _build_command_detail_text(cls, cmd: Dict, prefix: str) -> str:
+    def _build_command_detail_text(
+        cls, cmd: Dict, prefix: str, other_prefixes: Optional[list] = None
+    ) -> str:
         name = cmd["name"]
         info = cmd["info"]
-        
+
         lines = [
             f"命令详情: {prefix}{name}",
             "----------",
             f"描述: {info.get('help', '暂无描述')}",
-            ""
+            "",
         ]
-        
+
         # 别名 - 从全局 command.aliases 获取
-        main_name = info.get('main_name', name)
+        main_name = info.get("main_name", name)
         aliases = []
         for alias, mapped_name in command.aliases.items():
             if mapped_name == main_name and alias != main_name:
                 aliases.append(alias)
-        
+
         if aliases:
             aliases_text = ", ".join(f"{prefix}{a}" for a in aliases)
             lines.append(f"别名: {aliases_text}")
             lines.append("")
-        
+
         # 用法
         if info.get("usage"):
             lines.append(f"用法: {info['usage'].replace('/', prefix)}")
             lines.append("")
-        
+
         # 权限
         if info.get("permission"):
             lines.append("权限: 需要特殊权限")
             lines.append("")
-        
+
         # 分组
         if info.get("group"):
             group_name = cls._get_group_name(info["group"])
             lines.append(f"分组: {group_name}")
             lines.append("")
-        
+        if other_prefixes:
+            lines.append(f"其他触发前缀: {'、'.join(other_prefixes)}")
+            lines.append("")
+
         return "\n".join(lines)
-    
+
     # ==================== 错误消息模板 ====================
-    
+
     @classmethod
     def build_error(cls, title: str, message: str) -> Dict[str, str]:
         html = f"""
@@ -452,9 +533,9 @@ class HelpTemplates:
     <div style="color: {cls.ERROR_COLOR}; font-size: 14px; font-weight: bold; margin-bottom: 8px;">{title}</div>
     <div style="font-size: 13px;">{message}</div>
 </div>"""
-        
+
         markdown = f"**{title}**\n\n{message}"
-        
+
         text = f"{title}\n\n{message}"
-        
-        return {"html": html, "markdown": markdown, "text": text}
+
+        return {"html": html, "markdown": markdown, "text": text}

{erispulse_helpmodule-2.1.0.dist-info → erispulse_helpmodule-2.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse-HelpModule
-Version: 2.1.0
+Version: 2.1.2
 Summary: ErisPulse 帮助命令模块，提供自动化的命令帮助系统，支持查看所有可用命令及其用法说明
 Author-email: wsu2059q <wsu2059@qq.com>
 License-Expression: MIT

erispulse_helpmodule-2.1.2.dist-info/RECORD

@@ -0,0 +1,9 @@
+ErisPulse_HelpModule/Core.py,sha256=dV6W1G5RaP3zE-a8TfzK2WCDAe3eTTmnmdaWUNxgOYg,7119
+ErisPulse_HelpModule/__init__.py,sha256=ybEvf416FykwVwiKcGdeQZvrsHWkLkMAlNjqZbhY38k,28
+ErisPulse_HelpModule/templates.py,sha256=NmDx-RgT-9xNn8LfRUGCxShs8v6eq8vryR2Ok_zeum0,18427
+erispulse_helpmodule-2.1.2.dist-info/licenses/LICENSE,sha256=7BKmRD_5YpTGfc12w9L3TIskHF3A_AWDU4xuDQKE92w,1055
+erispulse_helpmodule-2.1.2.dist-info/METADATA,sha256=Ui3oInUYdn-sW6siljmgH9-WCrQsxms_cl3hpwX1g4w,1621
+erispulse_helpmodule-2.1.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+erispulse_helpmodule-2.1.2.dist-info/entry_points.txt,sha256=EBPR47ANi5DAbba7E2r558vfeD2AeR7lYXSt2_NNCwY,64
+erispulse_helpmodule-2.1.2.dist-info/top_level.txt,sha256=BFgAL-qs-KTqA4wuD6XaQhQzPZOmJ0IOqK9vq7Kqdos,21
+erispulse_helpmodule-2.1.2.dist-info/RECORD,,

erispulse_helpmodule-2.1.0.dist-info/RECORD

@@ -1,9 +0,0 @@
-ErisPulse_HelpModule/Core.py,sha256=BEqYIeNyuO-FUu-e5Y5L8EDnuxCDwiSKfXmAhzD_oO4,8250
-ErisPulse_HelpModule/__init__.py,sha256=ybEvf416FykwVwiKcGdeQZvrsHWkLkMAlNjqZbhY38k,28
-ErisPulse_HelpModule/templates.py,sha256=rbkK_lTKMlACz3zgPFVh9cpqljOwoRo4mPsOQ7pk1zc,16762
-erispulse_helpmodule-2.1.0.dist-info/licenses/LICENSE,sha256=7BKmRD_5YpTGfc12w9L3TIskHF3A_AWDU4xuDQKE92w,1055
-erispulse_helpmodule-2.1.0.dist-info/METADATA,sha256=IPW5As1nivchB6LfFZqvzeuZ4YFNj-ACwRWUfN-vxog,1621
-erispulse_helpmodule-2.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-erispulse_helpmodule-2.1.0.dist-info/entry_points.txt,sha256=EBPR47ANi5DAbba7E2r558vfeD2AeR7lYXSt2_NNCwY,64
-erispulse_helpmodule-2.1.0.dist-info/top_level.txt,sha256=BFgAL-qs-KTqA4wuD6XaQhQzPZOmJ0IOqK9vq7Kqdos,21
-erispulse_helpmodule-2.1.0.dist-info/RECORD,,