ErisPulse-HelpModule 2.1.2__tar.gz → 2.1.3__tar.gz

{erispulse_helpmodule-2.1.2 → erispulse_helpmodule-2.1.3}/ErisPulse_HelpModule/Core.py

@@ -39,13 +39,15 @@ class HelpModule(BaseModule):
         return module_config
 
     def _get_all_prefixes(self) -> list:
-        """获取所有命令前缀列表"""
-        event_config = config.getConfig("ErisPulse.event", {})
-        command_config = event_config.get("command", {})
-        prefix = command_config.get("prefix", "/")
+        """获取所有命令前缀列表（优先读框架维护的 command.prefix，旧版回退手读配置）"""
+        prefix = getattr(command, "prefix", None)
+        if prefix is None:
+            event_config = config.getConfig("ErisPulse.event", {}) or {}
+            command_config = event_config.get("command", {}) or {}
+            prefix = command_config.get("prefix", "/")
         if isinstance(prefix, list):
             return [str(p) for p in prefix] if prefix else ["/"]
-        return [str(prefix)]
+        return [str(prefix)] if prefix else ["/"]
 
     def _get_command_prefix(self) -> str:
         """获取主显示前缀（第一个）"""
@@ -71,21 +73,47 @@ class HelpModule(BaseModule):
 
         return help_command
 
-    def _build_command_list(self) -> List[Dict]:
+    # ==================== 会话感知查询（旧版框架自动回退） ====================
+
+    @staticmethod
+    def _query_commands(event) -> Dict:
+        """获取命令注册表；新版框架按作用域过滤当前会话不可用模块的命令"""
+        try:
+            return command.get_commands(event=event)
+        except TypeError:
+            return command.get_commands()
+
+    @staticmethod
+    def _query_visible_commands(event) -> Dict:
+        """获取可见命令；新版框架按作用域过滤当前会话不可用模块的命令"""
+        try:
+            return command.get_visible_commands(event=event)
+        except TypeError:
+            return command.get_visible_commands()
+
+    @staticmethod
+    def _query_command(name: str, event) -> Optional[Dict]:
+        """获取生效命令信息；新版框架在会话不可用时返回 None"""
+        try:
+            return command.get_command(name, event=event)
+        except TypeError:
+            return command.get_command(name)
+
+    def _build_command_list(self, event) -> 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()
+            all_commands = self._query_commands(event)
             for cmd_name in all_commands:
-                cmd_info = command.get_command(cmd_name)
+                cmd_info = self._query_command(cmd_name, event)
                 if cmd_info and cmd_name == cmd_info.get("main_name"):
                     self.command_list.append({"name": cmd_name, "info": cmd_info})
         else:
-            visible_commands = command.get_visible_commands()
+            visible_commands = self._query_visible_commands(event)
             for cmd_name in visible_commands:
-                cmd_info = command.get_command(cmd_name)
+                cmd_info = self._query_command(cmd_name, event)
                 if cmd_info and cmd_name == cmd_info.get("main_name"):
                     self.command_list.append({"name": cmd_name, "info": cmd_info})
 
@@ -105,7 +133,7 @@ class HelpModule(BaseModule):
             platform = event.get_platform()
             args = event.get_command_args()
 
-            commands = self._build_command_list()
+            commands = self._build_command_list(event)
             module_config = self._get_config()
 
             prefixes = self._get_all_prefixes()

{erispulse_helpmodule-2.1.2 → erispulse_helpmodule-2.1.3}/ErisPulse_HelpModule.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse-HelpModule
-Version: 2.1.2
+Version: 2.1.3
 Summary: ErisPulse 帮助命令模块，提供自动化的命令帮助系统，支持查看所有可用命令及其用法说明
 Author-email: wsu2059q <wsu2059@qq.com>
 License-Expression: MIT
@@ -13,6 +13,9 @@ Dynamic: license-file
 # ErisPulse-HelpModule
 ErisPulse 帮助命令模块，提供自动化的命令帮助系统，支持查看所有可用命令及其用法说明
 
+> **2.7.0+ 用户推荐使用 [ErisPulse-HelpNext](https://pypi.org/project/ErisPulse-HelpNext/)**（Takumi 图片渲染 / 昼夜主题 / 完整 i18n）。
+> 本模块（HelpModule）继续保留，优先保持**向后兼容性**，适合无法使用 Takumi 图片渲染或停留在旧版本的环境。
+
 ## 功能特性
 提供 Event 子模块中 command 模块中统一的命令帮助功能
 - 自动收集并显示所有已注册的命令
@@ -20,6 +23,7 @@ ErisPulse 帮助命令模块，提供自动化的命令帮助系统，支持查
 - 支持命令分组显示
 - 可配置是否显示隐藏命令
 - 支持命令别名显示
+- 会话感知（ErisPulse 2.8.0+）：被作用域禁用的模块，其命令不在当前会话的帮助中列出；旧版框架自动回退为全量列表，行为不变
 
 ## 使用方法
 
@@ -55,3 +59,14 @@ group_commands = true         # 是否按组显示命令
 ## 依赖
 
 - ErisPulse SDK 2.2.0+
+
+## 升级到 Next
+
+如果你在使用 ErisPulse 2.7.0+ 且需要图片化帮助（Apple 风格卡片、昼夜主题、多语言），请安装 HelpNext：
+
+```bash
+epsdk install HelpNext
+epsdk uninstall HelpModule
+```
+
+> 注意：HelpModule 与 HelpNext 都注册 `/help` 命令，请只启用其中一个。

{erispulse_helpmodule-2.1.2 → erispulse_helpmodule-2.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse-HelpModule
-Version: 2.1.2
+Version: 2.1.3
 Summary: ErisPulse 帮助命令模块，提供自动化的命令帮助系统，支持查看所有可用命令及其用法说明
 Author-email: wsu2059q <wsu2059@qq.com>
 License-Expression: MIT
@@ -13,6 +13,9 @@ Dynamic: license-file
 # ErisPulse-HelpModule
 ErisPulse 帮助命令模块，提供自动化的命令帮助系统，支持查看所有可用命令及其用法说明
 
+> **2.7.0+ 用户推荐使用 [ErisPulse-HelpNext](https://pypi.org/project/ErisPulse-HelpNext/)**（Takumi 图片渲染 / 昼夜主题 / 完整 i18n）。
+> 本模块（HelpModule）继续保留，优先保持**向后兼容性**，适合无法使用 Takumi 图片渲染或停留在旧版本的环境。
+
 ## 功能特性
 提供 Event 子模块中 command 模块中统一的命令帮助功能
 - 自动收集并显示所有已注册的命令
@@ -20,6 +23,7 @@ ErisPulse 帮助命令模块，提供自动化的命令帮助系统，支持查
 - 支持命令分组显示
 - 可配置是否显示隐藏命令
 - 支持命令别名显示
+- 会话感知（ErisPulse 2.8.0+）：被作用域禁用的模块，其命令不在当前会话的帮助中列出；旧版框架自动回退为全量列表，行为不变
 
 ## 使用方法
 
@@ -55,3 +59,14 @@ group_commands = true         # 是否按组显示命令
 ## 依赖
 
 - ErisPulse SDK 2.2.0+
+
+## 升级到 Next
+
+如果你在使用 ErisPulse 2.7.0+ 且需要图片化帮助（Apple 风格卡片、昼夜主题、多语言），请安装 HelpNext：
+
+```bash
+epsdk install HelpNext
+epsdk uninstall HelpModule
+```
+
+> 注意：HelpModule 与 HelpNext 都注册 `/help` 命令，请只启用其中一个。

{erispulse_helpmodule-2.1.2 → erispulse_helpmodule-2.1.3}/README.md

@@ -1,6 +1,9 @@
 # ErisPulse-HelpModule
 ErisPulse 帮助命令模块，提供自动化的命令帮助系统，支持查看所有可用命令及其用法说明
 
+> **2.7.0+ 用户推荐使用 [ErisPulse-HelpNext](https://pypi.org/project/ErisPulse-HelpNext/)**（Takumi 图片渲染 / 昼夜主题 / 完整 i18n）。
+> 本模块（HelpModule）继续保留，优先保持**向后兼容性**，适合无法使用 Takumi 图片渲染或停留在旧版本的环境。
+
 ## 功能特性
 提供 Event 子模块中 command 模块中统一的命令帮助功能
 - 自动收集并显示所有已注册的命令
@@ -8,6 +11,7 @@ ErisPulse 帮助命令模块，提供自动化的命令帮助系统，支持查
 - 支持命令分组显示
 - 可配置是否显示隐藏命令
 - 支持命令别名显示
+- 会话感知（ErisPulse 2.8.0+）：被作用域禁用的模块，其命令不在当前会话的帮助中列出；旧版框架自动回退为全量列表，行为不变
 
 ## 使用方法
 
@@ -43,3 +47,14 @@ group_commands = true         # 是否按组显示命令
 ## 依赖
 
 - ErisPulse SDK 2.2.0+
+
+## 升级到 Next
+
+如果你在使用 ErisPulse 2.7.0+ 且需要图片化帮助（Apple 风格卡片、昼夜主题、多语言），请安装 HelpNext：
+
+```bash
+epsdk install HelpNext
+epsdk uninstall HelpModule
+```
+
+> 注意：HelpModule 与 HelpNext 都注册 `/help` 命令，请只启用其中一个。

{erispulse_helpmodule-2.1.2 → erispulse_helpmodule-2.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ErisPulse-HelpModule"
-version = "2.1.2"
+version = "2.1.3"
 description = "ErisPulse 帮助命令模块，提供自动化的命令帮助系统，支持查看所有可用命令及其用法说明"
 readme = "README.md"
 requires-python = ">=3.10"