mofox-plugin-dev-toolkit 0.4.8__tar.gz → 0.4.10__tar.gz

{mofox_plugin_dev_toolkit-0.4.8/mofox_plugin_dev_toolkit.egg-info → mofox_plugin_dev_toolkit-0.4.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mofox-plugin-dev-toolkit
-Version: 0.4.8
+Version: 0.4.10
 Summary: 开发工具集，用于快速创建、开发和测试 MoFox-Bot 插件
 Author-email: MoFox-Studio <wwwww95915@qq.com>
 License: GPL-3.0-or-later

{mofox_plugin_dev_toolkit-0.4.8 → mofox_plugin_dev_toolkit-0.4.10/mofox_plugin_dev_toolkit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mofox-plugin-dev-toolkit
-Version: 0.4.8
+Version: 0.4.10
 Summary: 开发工具集，用于快速创建、开发和测试 MoFox-Bot 插件
 Author-email: MoFox-Studio <wwwww95915@qq.com>
 License: GPL-3.0-or-later

{mofox_plugin_dev_toolkit-0.4.8 → mofox_plugin_dev_toolkit-0.4.10}/mpdt/__init__.py

@@ -4,7 +4,7 @@ MoFox Plugin Dev Toolkit
 一个用于 MoFox-Bot 插件开发的工具集
 """
 
-__version__ = "0.4.7"
+__version__ = "0.4.9"
 __author__ = "MoFox-Studio"
 __license__ = "GPL-3.0-or-later"
 

{mofox_plugin_dev_toolkit-0.4.8 → mofox_plugin_dev_toolkit-0.4.10}/mpdt/cli.py

@@ -36,7 +36,7 @@ def cli(ctx: click.Context, verbose: bool, no_color: bool) -> None:
 
 @cli.command()
 @click.argument("plugin_name", required=False)
-@click.option("--template", "-t", type=click.Choice(["basic", "action", "tool", "plus_command", "full", "adapter"]),
+@click.option("--template", "-t", type=click.Choice(["basic", "action", "tool", "collection", "router", "plus_command", "event_handler", "full", "adapter", "chatter"]),
               default="basic", help="插件模板类型")
 @click.option("--author", "-a", help="作者名称")
 @click.option("--email", "-e", help="作者电子邮箱")
@@ -69,14 +69,15 @@ def init(ctx: click.Context, plugin_name: str | None, template: str,email: str|
 
 
 @cli.command()
-@click.argument("component_type", type=click.Choice(["action", "tool", "event", "adapter", "plus-command", "router", "chatter", "service", "config"]), required=False)
+@click.argument("component_type", type=click.Choice(["action", "tool", "collection", "event", "adapter", "plus-command", "router", "chatter", "service", "config"]), required=False)
 @click.argument("component_name", required=False)
 @click.option("--description", "-d", help="组件描述")
-@click.option("--output", "-o", type=click.Path(), help="输出目录")
+@click.option("--output", "-o", type=click.Path(), help="插件根目录路径（默认为当前目录）")
 @click.option("--force", "-f", is_flag=True, help="覆盖已存在的文件")
+@click.option("--root", is_flag=True, help="在插件根目录生成组件文件，而不是 components/ 文件夹")
 @click.pass_context
 def generate(ctx: click.Context, component_type: str | None, component_name: str | None, description: str | None,
-             output: str | None, force: bool) -> None:
+             output: str | None, force: bool, root: bool) -> None:
     """生成插件组件(始终生成异步方法)
 
     如果不提供参数，将进入交互式问答模式
@@ -90,6 +91,7 @@ def generate(ctx: click.Context, component_type: str | None, component_name: str
             description=description,
             output_dir=output,
             force=force,
+            use_components_folder=not root,
             verbose=ctx.obj["verbose"],
         )
     except Exception as e:

{mofox_plugin_dev_toolkit-0.4.8 → mofox_plugin_dev_toolkit-0.4.10}/mpdt/commands/build.py

@@ -178,6 +178,7 @@ def build_plugin(
         with_docs:   是否将文档文件打入包中
         fmt:         输出格式，"mfp"（推荐） 或 "zip"
         bump:        自动升级版本，"major" / "minor" / "patch" / None
+                     （升级后会立即写回 manifest.json，打包时使用新版本号）
         verbose:     是否显示详细信息
     """
     plugin_dir = Path(plugin_path).resolve()
@@ -205,7 +206,7 @@ def build_plugin(
     plugin_name: str = manifest["name"]
     plugin_version: str = manifest["version"]
 
-    # ── 2. 版本升级 ──────────────────────────────────────────────────────────
+    # ── 2. 版本升级（先写回文件，再使用新版本号进行打包） ────────────────────
     if bump:
         try:
             new_version = _bump_version(plugin_version, bump)
@@ -214,7 +215,8 @@ def build_plugin(
             return
         print_step(f"版本升级: [yellow]{plugin_version}[/yellow] → [green]{new_version}[/green]")
         manifest["version"] = new_version
-        _save_manifest(plugin_dir, manifest)
+        # 立即写回 manifest.json，确保后续打包使用新版本
+        _save_manifest(plugin_dir, manifest)        
         plugin_version = new_version
 
     # ── 3. 验证入口文件 ───────────────────────────────────────────────────────

{mofox_plugin_dev_toolkit-0.4.8 → mofox_plugin_dev_toolkit-0.4.10}/mpdt/commands/generate.py

@@ -68,6 +68,7 @@ def generate_component(
     description: str | None = None,
     output_dir: str | None = None,
     force: bool = False,
+    use_components_folder: bool = True,
     verbose: bool = False,
 ) -> None:
     """
@@ -79,6 +80,7 @@ def generate_component(
         description: 组件描述
         output_dir: 输出目录
         force: 是否覆盖
+        use_components_folder: 是否在 components/ 文件夹中生成（False 则在根目录生成）
         verbose: 详细输出
     """
     # 确定工作目录
@@ -98,7 +100,6 @@ def generate_component(
         console.print(f"[dim]检测到插件: {plugin_name}[/dim]")
 
     # 交互式获取组件信息
-    use_components_folder = True  # 默认使用 components 文件夹
     if not component_type or not component_name:
         component_info = _interactive_generate()
         component_type = component_info["component_type"]

{mofox_plugin_dev_toolkit-0.4.8 → mofox_plugin_dev_toolkit-0.4.10}/mpdt/dev/bridge_plugin/cleanup_handler.py

@@ -5,13 +5,18 @@ DevBridge 清理事件处理器
 
 import shutil
 from pathlib import Path
+from typing import TYPE_CHECKING, Any
 
 from src.core.components.base.event_handler import BaseEventHandler
 from src.core.components.types import EventType
+from src.kernel.event import EventDecision
 from src.kernel.logger import get_logger
 
 from .dev_config import TARGET_PLUGIN_NAME, TARGET_PLUGIN_PATH
 
+if TYPE_CHECKING:
+    from .plugin import DevBridgePlugin
+
 logger = get_logger("dev_bridge_cleanup")
 
 
@@ -19,22 +24,45 @@ class CleanupHandler(BaseEventHandler):
     """清理事件处理器 - 在程序停止时清理插件文件"""
 
     handler_name = "dev_bridge_cleanup"
-    handler_description = "DevBridge 清理处理器"
-    weight = 100  # 负权重，确保最后执行
+    handler_description = "DevBridge 清理处理器，在系统停止时移除临时插件文件"
+    weight = -100  # 负权重，确保最后执行
+    intercept_message = False
     init_subscribe: list[EventType | str] = [EventType.ON_STOP]
 
-    def __init__(self, plugin=None):
+    def __init__(self, plugin: "DevBridgePlugin") -> None:
+        """初始化清理处理器
+        
+        Args:
+            plugin: DevBridge 插件实例
+        """
         super().__init__(plugin)
         self._target_plugin_name = TARGET_PLUGIN_NAME
         self._target_plugin_path = TARGET_PLUGIN_PATH
 
-    async def execute(self, kwargs: dict | None) -> tuple[bool, bool, str | None]:
-        """程序停止时执行清理（同步删除）"""
+    async def execute(
+        self,
+        event_name: str,
+        params: dict[str, Any],
+    ) -> tuple[EventDecision, dict[str, Any]]:
+        """程序停止时执行清理（同步删除）
+        
+        Args:
+            event_name: 事件名称（ON_STOP）
+            params: 事件参数
+            
+        Returns:
+            事件决策和更新后的参数
+        """
         logger.info("🛑 收到停止事件，准备清理 DevBridge...")
 
-        self._delete_plugins()
+        try:
+            self._delete_plugins()
+            logger.info("✅ DevBridge 清理完成")
+        except Exception as e:
+            logger.error(f"❌ DevBridge 清理失败: {e}", exc_info=True)
 
-        return True, True, None
+        # 返回 SUCCESS，继续执行后续清理处理器
+        return EventDecision.SUCCESS, params
 
     def _delete_plugins(self):
         """同步删除插件目录"""

mofox_plugin_dev_toolkit-0.4.10/mpdt/templates/event_template.py

@@ -0,0 +1,125 @@
+"""
+Event Handler 组件模板（Neo-MoFox 架构）
+"""
+
+EVENT_HANDLER_TEMPLATE = '''"""
+{description}
+
+Created by: {author}
+Created at: {date}
+"""
+
+from typing import Any
+
+from src.app.plugin_system.api.log_api import get_logger
+from src.core.components.base import BaseEventHandler
+from src.core.components.types import EventType
+from src.kernel.event import EventDecision
+
+logger = get_logger(__name__)
+
+
+class {class_name}(BaseEventHandler):
+    """
+    {description}
+
+    Event Handler 组件用于处理系统事件。
+
+    使用场景：
+    - 监听消息事件
+    - 监听系统事件
+    - 实现事件驱动逻辑
+    - 在特定事件发生时执行操作
+    """
+
+    handler_name = "{component_name}"
+    handler_description = "{description}"
+    weight = 10  # 权重：数值越大优先级越高
+    intercept_message = False  # 是否拦截消息（拦截后消息不再传递给后续处理器）
+    init_subscribe = [EventType.ON_MESSAGE_RECEIVED]  # 初始订阅的事件类型列表
+
+    async def execute(
+        self, event_name: str, params: dict[str, Any]
+    ) -> tuple[EventDecision, dict[str, Any]]:
+        """
+        执行事件处理的主要逻辑。
+
+        与 kernel EventBus 订阅者协议保持一致：接受事件名称和参数字典，
+        返回决策枚举与（可能已修改的）参数字典。
+
+        Args:
+            event_name: 触发本处理器的事件名称（由 EventBus 传入）
+            params: 事件参数字典（即 EventBus publish 时的 params，可就地修改）
+
+        Returns:
+            tuple[EventDecision, dict[str, Any]]:
+                - ``EventDecision.SUCCESS`` — 执行完成，继续后续处理器
+                - ``EventDecision.STOP``    — 拦截，阻止后续处理器执行
+                - ``EventDecision.PASS``    — 跳过本处理器，不传播参数变更
+        """
+        try:
+            logger.info(f"处理事件: {{event_name}}")
+            logger.debug(f"事件参数: {{params}}")
+
+            # 检查是否应该处理此事件
+            if not self._should_handle(event_name, params):
+                logger.debug("跳过此事件")
+                return EventDecision.PASS, params
+
+            # TODO: 实现事件处理逻辑
+            await self._process_event(event_name, params)
+
+            logger.info("事件处理完成")
+            # 正常处理，继续后续处理器
+            return EventDecision.SUCCESS, params
+
+        except Exception as e:
+            logger.error(f"事件处理失败: {{e}}", exc_info=True)
+            # 发生错误时跳过，不影响其他处理器
+            return EventDecision.PASS, params
+
+    def _should_handle(self, event_name: str, params: dict[str, Any]) -> bool:
+        """
+        判断是否应该处理该事件
+
+        Args:
+            event_name: 事件名称
+            params: 事件参数
+
+        Returns:
+            是否处理
+        """
+        # TODO: 实现判断逻辑
+        # 示例: 检查事件类型、来源、条件等
+        # if event_name == EventType.ON_MESSAGE_RECEIVED:
+        #     message = params.get("message")
+        #     if message and "关键词" in message:
+        #         return True
+        return True
+
+    async def _process_event(self, event_name: str, params: dict[str, Any]) -> None:
+        """
+        处理事件的核心逻辑
+
+        Args:
+            event_name: 事件名称
+            params: 事件参数（可就地修改）
+        """
+        # TODO: 实现处理逻辑
+        # 示例：修改参数
+        # params["processed"] = True
+        # params["handler_name"] = self.handler_name
+
+        # 示例：根据事件类型执行不同逻辑
+        # if event_name == EventType.ON_MESSAGE_RECEIVED:
+        #     await self._handle_message(params)
+        # elif event_name == EventType.ON_START:
+        #     await self._handle_bot_start(params)
+
+        logger.info(f"事件 {{event_name}} 处理完成")
+'''
+
+
+def get_event_handler_template() -> str:
+    """获取 Event Handler 组件模板"""
+    return EVENT_HANDLER_TEMPLATE

{mofox_plugin_dev_toolkit-0.4.8 → mofox_plugin_dev_toolkit-0.4.10}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mofox-plugin-dev-toolkit"
-version = "0.4.8"
+version = "0.4.10"
 description = "开发工具集，用于快速创建、开发和测试 MoFox-Bot 插件"
 authors = [
     {name = "MoFox-Studio", email = "wwwww95915@qq.com"}

mofox_plugin_dev_toolkit-0.4.8/mpdt/templates/event_template.py

@@ -1,101 +0,0 @@
-"""
-Event Handler 组件模板（Neo-MoFox 架构）
-"""
-
-EVENT_HANDLER_TEMPLATE = '''"""
-{description}
-
-Created by: {author}
-Created at: {date}
-"""
-
-from src.app.plugin_system.api.log_api import get_logger
-from src.core.components.base import BaseEventHandler
-from src.core.components.types import EventType
-
-logger = get_logger(__name__)
-
-
-class {class_name}(BaseEventHandler):
-    """
-    {description}
-
-    Event Handler 组件用于处理系统事件。
-
-    使用场景：
-    - 监听消息事件
-    - 监听系统事件
-    - 实现事件驱动逻辑
-    - 在特定事件发生时执行操作
-    """
-
-    handler_name = "{component_name}"
-    handler_description = "{description}"
-    weight = 10  # 权重：数值越大优先级越高
-    intercept_message = False  # 是否拦截消息（拦截后消息不再传递给后续处理器）
-    init_subscribe = [EventType.ON_MESSAGE_RECEIVED]  # 初始订阅的事件类型列表
-
-    async def execute(self, kwargs: dict | None) -> tuple[bool, bool, str | None]:
-        """
-        处理事件
-
-        Args:
-            kwargs: 事件参数字典，包含事件相关的所有信息
-
-        Returns:
-            tuple[bool, bool, str | None]: (success, intercept, message)
-                - success: 是否成功
-                - intercept: 是否拦截（True 则阻止后续处理器执行）
-                - message: 返回消息（可选）
-        """
-        try:
-            logger.info(f"处理事件: {{self.handler_name}}")
-            logger.debug(f"事件参数: {{kwargs}}")
-
-            # 检查是否应该处理此事件
-            if not self._should_handle(kwargs):
-                logger.debug("跳过此事件")
-                return True, False, None
-
-            # TODO: 实现事件处理逻辑
-            result = await self._process_event(kwargs)
-
-            logger.info("事件处理完成")
-            return True, False, result
-
-        except Exception as e:
-            logger.error(f"事件处理失败: {{e}}")
-            return False, False, str(e)
-
-    def _should_handle(self, kwargs: dict | None) -> bool:
-        """
-        判断是否应该处理该事件
-
-        Args:
-            kwargs: 事件参数
-
-        Returns:
-            是否处理
-        """
-        # TODO: 实现判断逻辑
-        # 示例: 检查事件类型、来源、条件等
-        return True
-
-    async def _process_event(self, kwargs: dict | None) -> str:
-        """
-        处理事件的核心逻辑
-
-        Args:
-            kwargs: 事件参数
-
-        Returns:
-            处理结果消息
-        """
-        # TODO: 实现处理逻辑
-        return "事件处理成功"
-'''
-
-
-def get_event_handler_template() -> str:
-    """获取 Event Handler 组件模板"""
-    return EVENT_HANDLER_TEMPLATE