ErisPulse 2.7.1.dev4__tar.gz → 2.8.0.dev1__tar.gz

{erispulse-2.7.1.dev4 → erispulse-2.8.0.dev1}/.gitignore

@@ -1,6 +1,7 @@
 # dev gnore ignore file for Python projects
 devs/videos
 main.py
+plugins/
 venvs
 config.toml
 uv.lock

{erispulse-2.7.1.dev4 → erispulse-2.8.0.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: ErisPulse
-Version: 2.7.1.dev4
+Version: 2.8.0.dev1
 Summary: Event-driven modular async bot framework — write once, deploy to any platform | 事件驱动的模块化异步机器人框架，一次编写，多平台部署
 Project-URL: Homepage, https://github.com/ErisPulse/ErisPulse
 Project-URL: Documentation, https://www.erisdev.com#docs
@@ -10,27 +10,7 @@ Project-URL: Bug Tracker, https://github.com/ErisPulse/ErisPulse/blob/main/docs/
 Project-URL: Changelog, https://github.com/ErisPulse/ErisPulse/blob/main/CHANGELOG.md
 Author: ErisDev
 Maintainer-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>
-License: MIT License
-        
-        Copyright (c) 2025-2026 ErisPulse
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy
-        of this software and associated documentation files (the "Software"), to deal
-        in the Software without restriction, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all
-        copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
+License-Expression: MIT
 License-File: LICENSE
 Keywords: async,asyncio,bot,bot-framework,chatbot,email,extensible,framework,instant-messaging,kook,matrix,modular,multi-platform,onebot,onebot12,qq,robot,sdk,telegram,yunhu
 Classifier: Development Status :: 4 - Beta
@@ -54,11 +34,6 @@ Requires-Dist: rich>=13.0.0
 Requires-Dist: toml>=0.10.2
 Requires-Dist: uvicorn>=0.30.0
 Requires-Dist: websockets>=12.0
-Provides-Extra: dev
-Requires-Dist: basedpyright>=1.20.0; extra == 'dev'
-Requires-Dist: pyclean>=3.6.0; extra == 'dev'
-Requires-Dist: ruff>=0.1.7; extra == 'dev'
-Requires-Dist: typing-extensions>=4.7.0; (python_version < '3.11') and extra == 'dev'
 Provides-Extra: test
 Requires-Dist: httpx>=0.24.0; extra == 'test'
 Requires-Dist: pytest-asyncio>=0.21.0; extra == 'test'
@@ -99,7 +74,9 @@ It ships with a flexible plugin system, hot reload, a visual Dashboard, an AI Bu
 - **Event-driven architecture** — Clear event model based on OneBot12, making message handling intuitive and consistent across platforms.
 - **Cross-platform compatibility** — Write handlers once, deploy to 15+ platforms without rewriting business logic.
 - **Modular design** — Flexible plugin system with hot-plug module management and per-module configuration.
-- **Hot reload** — Iterate on code during development without restarting the bot process.
+- **Hot reload** — Local plugins reload on save; any module (including PyPI-installed ones) hot-reloads via a single `sdk.reload_module()` call — no process restart, even after pip upgrades.
+- **Unified Event Overrides** — Override message triggers, command params and user permissions for *every* event type with a single config — no module code changes, takes effect instantly.
+- **Scope Control** — Three-dimensional scope (module availability / event admission / outbound limits) with runtime-adjustable fine-grained control.
 - **Chainable SendDSL** — Express `@mention`, reply, retry, timeout, progress hook and bulk send as a single fluent chain.
 - **Complete toolchain** — `epsdk` CLI, visual Dashboard, AI Builder and Module Market included out of the box.
 

{erispulse-2.7.1.dev4 → erispulse-2.8.0.dev1}/README.pypi.md

@@ -28,7 +28,9 @@ It ships with a flexible plugin system, hot reload, a visual Dashboard, an AI Bu
 - **Event-driven architecture** — Clear event model based on OneBot12, making message handling intuitive and consistent across platforms.
 - **Cross-platform compatibility** — Write handlers once, deploy to 15+ platforms without rewriting business logic.
 - **Modular design** — Flexible plugin system with hot-plug module management and per-module configuration.
-- **Hot reload** — Iterate on code during development without restarting the bot process.
+- **Hot reload** — Local plugins reload on save; any module (including PyPI-installed ones) hot-reloads via a single `sdk.reload_module()` call — no process restart, even after pip upgrades.
+- **Unified Event Overrides** — Override message triggers, command params and user permissions for *every* event type with a single config — no module code changes, takes effect instantly.
+- **Scope Control** — Three-dimensional scope (module availability / event admission / outbound limits) with runtime-adjustable fine-grained control.
 - **Chainable SendDSL** — Express `@mention`, reply, retry, timeout, progress hook and bulk send as a single fluent chain.
 - **Complete toolchain** — `epsdk` CLI, visual Dashboard, AI Builder and Module Market included out of the box.
 

{erispulse-2.7.1.dev4 → erispulse-2.8.0.dev1}/pyproject.toml

@@ -1,14 +1,15 @@
 [build-system]
-requires = ["hatchling"]
+requires = ["hatchling>=1.26"]
 build-backend = "hatchling.build"
 
 [project]
 name = "ErisPulse"
-version = "2.7.1-dev.4"
+version = "2.8.0-dev.1"
 description = "Event-driven modular async bot framework — write once, deploy to any platform | 事件驱动的模块化异步机器人框架，一次编写，多平台部署"
 readme = "README.pypi.md"
 requires-python = ">=3.10"
-license = { file = "LICENSE" }
+license = "MIT"
+license-files = ["LICENSE"]
 
 authors = [
     { name = "ErisDev" }
@@ -87,11 +88,14 @@ test = [
     "pytest-benchmark>=4.0.0",
     "httpx>=0.24.0",
 ]
+
+[dependency-groups]
 dev = [
     "pyclean>=3.6.0",
     "ruff>=0.1.7",
     "basedpyright>=1.20.0",
-    "typing_extensions>=4.7.0; python_version < '3.11'"]
+    "typing_extensions>=4.7.0; python_version < '3.11'",
+]
 
 [project.scripts]
 ep-init = "ErisPulse.__init__:init_sync"
@@ -118,7 +122,7 @@ include = [
 target-version = "py310"
 line-length = 120
 
-include = ["src/**/*.py"]
+include = ["src/**/*.py", "tests/**/*.py"]
 
 extend-exclude = [
     "__pycache__",
@@ -161,6 +165,7 @@ ignore = [
     "PLR0912",  # too-many-branches
     "PLR0913",  # too-many-arguments
     "PLR0915",  # too-many-statements
+    "PLR0917",  # too-many-positional-arguments —— 同 PLR0913，既有公共 API 签名不可破坏
     "PLR2004",  # magic-value-comparison —— 数值阈值判定过于严格
     "PLR1714",  # repeated-equality-comparison
     "PLW0602",  # global-variable-not-assigned
@@ -169,6 +174,7 @@ ignore = [
     "PERF203",  # try-except-in-loop —— 异步轮询/重试场景的常见且必要写法，性能影响极小
     "RUF012",   # mutable-class-default —— 类属性容器（handlers/事件表）是项目既有 API
     "RUF005",   # collection-literal-concatenation —— `list + list` 有时比 unpack 更清晰
+    "RUF022",   # unsorted-dunder-all —— __all__ 常按语义分组并附加注释，强制排序破坏可读性
     "RET504",   # unnecessary-assign —— “先 assign 再 return”有时更易调试
 
     # 风格偏好（不强加于现有代码）
@@ -194,7 +200,15 @@ ignore = [
 
 [tool.ruff.lint.per-file-ignores]
 "__init__.py" = ["F401", "PLC0415", "I001"]  # 导出式 __init__ 经常按需导入
-"tests/**/*.py" = ["S101", "PLR2004", "SLF001", "ARG", "ANN", "PTH"]
+"tests/**/*.py" = [
+    # 断言/夹具相关（测试代码天然模式）
+    "S101", "PLR2004", "SLF001", "ARG", "ANN", "PTH",
+    "E712", "B011", "B017", "B018", "RUF043",
+    # 测试内常见的宽松写法
+    "E702", "E402", "F841", "RUF059", "PLW0108",
+    "UP031", "N814", "PERF401", "PLR0917", "RUF015",
+    "B007", "PIE810", "PLR0124", "PLW1510", "SIM118",
+]
 
 [tool.ruff.lint.pep8-naming]
 # 装饰器方法、classmethod 的首参数名允许保留

erispulse-2.8.0.dev1/src/ErisPulse/CLI/commands/config.py

@@ -0,0 +1,208 @@
+"""
+Config 命令实现
+
+交互式配置适配器/模块（schema 驱动向导，含适配器多账户管理）
+"""
+
+import json
+from argparse import ArgumentParser
+
+from rich.box import SIMPLE
+from rich.prompt import Prompt
+from rich.table import Table
+
+from ..base import Command
+from ..console import console
+from ..i18n import i18n
+from ..utils import config_wizard
+from ..utils.config_wizard import (
+    STATUS_INCOMPLETE,
+    STATUS_NONE,
+    STATUS_OK,
+    STATUS_UNCONFIGURED,
+)
+from ..utils.display import section_header
+
+
+class ConfigCommand(Command):
+    """
+    config 命令
+
+    交互式配置适配器/模块；适配器支持多账户（bot 账户）管理
+    """
+
+    name = "config"
+    description = i18n.t("cli.config.description")
+    aliases = ["cfg", "conf"]
+
+    def add_arguments(self, parser: ArgumentParser):
+        parser.add_argument(
+            "name",
+            nargs="?",
+            help=i18n.t("cli.config.name_help"),
+        )
+        parser.add_argument(
+            "--list",
+            "-l",
+            action="store_true",
+            help=i18n.t("cli.config.list_help"),
+        )
+        parser.add_argument(
+            "--json",
+            action="store_true",
+            help=i18n.t("cli.config.json_help"),
+        )
+
+    def execute(self, args):
+        from ErisPulse import config
+
+        targets = config_wizard.load_config_targets()
+        if not targets:
+            console.print(f"[dim]  {i18n.t('cli.config.no_targets')}[/]")
+            console.print(f"[dim]  {i18n.t('cli.config.install_hint')}[/]")
+            return
+
+        if getattr(args, "json", False):
+            self._print_status_json(targets, config)
+            return
+
+        if args.name:
+            self._run_named(targets, args.name, config)
+            return
+
+        self._print_status_table(targets, config)
+
+        if args.list:
+            return
+
+        if not config_wizard.is_interactive():
+            console.print(f"[dim]  {i18n.t('cli.config.non_interactive_hint')}[/]")
+            return
+
+        self._interactive_select(targets, config)
+
+    def _print_status_json(self, targets, config):
+        """
+        以 JSON 输出全部目标及其配置状态（供 CI / 脚本消费）
+
+        :param targets: ConfigTarget 列表
+        :param config: ConfigManager 实例
+        """
+        result = {}
+        for target in sorted(targets, key=lambda t: (t.kind != "adapter", t.name.lower())):
+            status, errors = config_wizard.get_target_status(target, config)
+            result[target.name] = {
+                "kind": target.kind,
+                "config_key": target.config_key,
+                "status": status,
+                "errors": errors,
+            }
+        console.print_json(json.dumps(result, ensure_ascii=False, indent=2))
+
+    def _run_named(self, targets, name: str, config):
+        """
+        按名称定位目标并直接进入向导
+
+        :param targets: ConfigTarget 列表
+        :param name: 目标名（适配器平台名/模块名，或适配器配置键）
+        :param config: ConfigManager 实例
+        """
+        for target in targets:
+            if target.name == name or target.config_key == name:
+                if not target.configurable:
+                    console.print(f"[warning]  {i18n.t('cli.config.no_declaration', name=target.name)}[/]")
+                    return
+                config_wizard.run_wizard(target, config)
+                return
+        console.print(f"[error]  {i18n.t('cli.config.not_found', name=name)}[/]")
+
+    def _status_text(self, status: str) -> str:
+        """
+        将状态常量渲染为带颜色的显示文本
+
+        :param status: get_target_status 返回的状态常量
+        :return: rich 标记的状态文本
+        """
+        mapping = {
+            STATUS_OK: ("cli.config.status_ok", "green"),
+            STATUS_INCOMPLETE: ("cli.config.status_incomplete", "yellow"),
+            STATUS_UNCONFIGURED: ("cli.config.status_unconfigured", "cyan"),
+            STATUS_NONE: ("cli.config.status_none", "dim"),
+        }
+        key, style = mapping.get(status, ("cli.config.status_none", "dim"))
+        return f"[{style}]{i18n.t(key)}[/]"
+
+    def _print_status_table(self, targets, config):
+        """
+        打印全部目标及其配置状态表
+
+        :param targets: ConfigTarget 列表
+        :param config: ConfigManager 实例
+        """
+        table = Table(box=SIMPLE, show_lines=False, header_style="bold", pad_edge=False)
+        table.add_column(i18n.t("cli.config.header_kind"), width=8)
+        table.add_column(i18n.t("cli.config.header_name"), min_width=12)
+        table.add_column(i18n.t("cli.config.header_status"), width=10)
+        table.add_column(i18n.t("cli.config.header_detail"))
+
+        for target in sorted(targets, key=lambda t: (t.kind != "adapter", t.name.lower())):
+            status, errors = config_wizard.get_target_status(target, config)
+            detail = "；".join(errors[:3])
+            if len(errors) > 3:
+                detail += f" (+{len(errors) - 3})"
+            kind_style = "adapter" if target.kind == "adapter" else "module"
+            table.add_row(
+                f"[{kind_style}]{target.kind_label}[/]",
+                target.name,
+                self._status_text(status),
+                detail,
+            )
+
+        console.print(table)
+
+    def _interactive_select(self, targets, config):
+        """
+        交互式选择目标并进入向导（可连续配置多个）
+
+        :param targets: ConfigTarget 列表
+        :param config: ConfigManager 实例
+        """
+        selectable = [t for t in targets if t.configurable]
+        if not selectable:
+            console.print(f"[dim]  {i18n.t('cli.config.no_configurable')}[/]")
+            return
+
+        selectable.sort(key=lambda t: (t.kind != "adapter", t.name.lower()))
+
+        while True:
+            section_header(i18n.t("cli.config.select_section"))
+            for idx, target in enumerate(selectable, 1):
+                status, _ = config_wizard.get_target_status(target, config)
+                kind_style = "adapter" if target.kind == "adapter" else "module"
+                console.print(f"    [bold]{idx}.[/] [{kind_style}]{target.name}[/]  {self._status_text(status)}")
+
+            try:
+                raw = Prompt.ask(
+                    f"  {i18n.t('cli.config.select_prompt')}",
+                    default="",
+                    show_default=False,
+                )
+            except (EOFError, KeyboardInterrupt):
+                break
+
+            raw = raw.strip()
+            if not raw:
+                break
+
+            try:
+                idx = int(raw)
+            except ValueError:
+                console.print(f"[warning]  {i18n.t('cli.config.invalid_index', idx=raw)}[/]")
+                continue
+
+            if not 1 <= idx <= len(selectable):
+                console.print(f"[warning]  {i18n.t('cli.config.invalid_index', idx=idx)}[/]")
+                continue
+
+            config_wizard.run_wizard(selectable[idx - 1], config)
+            # 向导结束后回到选择菜单（状态重新刷新），支持连续配置多个目标

{erispulse-2.7.1.dev4 → erispulse-2.8.0.dev1}/src/ErisPulse/CLI/commands/create.py

@@ -58,14 +58,23 @@ dependencies = [
 
 [project.entry-points]
 "erispulse.module" = {{ "{name}" = "{name}:Main" }}
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["{name}"]
 """
 
 _MODULE_INIT = """from .Core import Main
 """
 
 _MODULE_CORE = """from dataclasses import dataclass, field
-from ErisPulse.Core.Bases import BaseConfig, BaseI18n, BaseModule, I18nKey
-from ErisPulse.Core.Event import command, message, notice
+
+from ErisPulse import SDK
+from ErisPulse.Core.Bases import BaseConfig, BaseI18n, BaseModule, I18nKey, ModuleMeta
+from ErisPulse.Core.Event import Event, command, message, notice
 from ErisPulse.Core.i18n import i18n
 
 
@@ -90,6 +99,15 @@ class Main(BaseModule):
     class I18nClass(BaseI18n):
         \"\"\"{name} translation keys\"\"\"
 
+        meta_description: I18nKey = I18nKey(
+            key=\"module.{name}.meta.description\",
+            default=\"{name} module\",
+            zh_CN=\"{name} 模块\",
+            en=\"{name} module\",
+            ja=\"{name} モジュール\",
+            ru=\"Модуль {name}\",
+            zh_TW=\"{name} 模組\",
+        )
         enabled: I18nKey = I18nKey(
             key=\"module.{name}.enabled\",
             default=\"Enable module\",
@@ -118,22 +136,40 @@ class Main(BaseModule):
             zh_TW=\"來自 {name} 的問候！\",
         )
 
-    def __init__(self, sdk=None):
-        from ErisPulse import sdk as _sdk
-        self.sdk = _sdk if sdk is None else sdk
+    def __init__(self, sdk: SDK = None):
+        # sdk 由框架在实例化时自动注入（无需手动导入兜底）
+        self.sdk = sdk
         self.logger = self.sdk.logger.get_child(\"{name}\")
         self.storage = self.sdk.storage
         self.adapter = self.sdk.adapter
         self.client = self.sdk.client
 
-        self.logger.info((\"{text[module.log.init_done]}\").format(name=\"{name}\"))
+        self.logger.info(\"{text[module.log.init_done]}\")
+
+    @staticmethod
+    def get_meta() -> ModuleMeta:
+        \"\"\"
+        {text[module.meta_doc]}
+        \"\"\"
+        return ModuleMeta(
+            name=\"{name}\",
+            # description 支持 i18n 字典（key 由 I18nClass 注册），也可用纯字符串
+            description={{\"i18n\": \"module.{name}.meta.description\", \"default\": \"{name} module\"}},
+            version=\"0.1.0\",
+            author=\"ErisDev\",
+            group=\"default\",
+            tags=[\"{name}\"],
+        )
 
     @staticmethod
     def get_load_strategy():
         from ErisPulse.loaders import ModuleLoadStrategy
         return ModuleLoadStrategy(
             lazy_load=False,
-            priority=100
+            priority=100,
+            # 依赖声明（可选）：缺失依赖的模块会被跳过加载；
+            # 被依赖模块卸载/热重载时，本模块将级联卸载/重载
+            # depends=[],
         )
 
     async def on_load(self, event: dict) -> bool:
@@ -163,21 +199,32 @@ class Main(BaseModule):
         self.logger.info(\"{text[module.log.config_updated]}\")
 
     async def _register_commands(self):
+        # 命令权限（可选）：permission 为调用函数，返回 True 才执行命令；
+        # master=True 限定框架主人（仅开发者默认值，用户可在统一覆写系统
+        # ErisPulse.event.overrides.command.<module>.<cmd>.master = true/false 覆写收紧或放开）；
+        # 跨命令的用户黑白名单用覆写系统 ACL
+        # （ErisPulse.event.overrides.acl 或 overrides.acl.set(name, allow/deny)，命令名支持 glob）；
+        # 模块级可用性 / 事件准入 / 出站限制由作用域 scope 管理（用户可控）
         @command(\"hello\", help=i18n.t(\"module.{name}.command.hello.help\"))
-        async def hello_command(event):
+        async def hello_command(event: Event):
             await event.reply(i18n.t(\"module.{name}.command.hello.reply\"))
 
     async def _register_message_handlers(self):
         @message.on_private_message()
-        async def private_message_handler(event):
+        async def private_message_handler(event: Event):
             self.logger.info((\"{text[module.log.private_message]}\").format(content=event.get_text()))
 
         @message.on_group_message()
-        async def group_message_handler(event):
+        async def group_message_handler(event: Event):
             pass
 
+        # 消息装饰器支持 pattern（glob 通配符）/ regex（正则），不匹配则不触发
+        @message.on_message(pattern=\"签到*\")
+        async def signin_handler(event: Event):
+            await event.reply(\"签到成功\")
+
         @notice.on_friend_add()
-        async def friend_add_handler(event):
+        async def friend_add_handler(event: Event):
             self.logger.info((\"{text[module.log.friend_add]}\").format(nickname=event.get_user_nickname()))
 """
 
@@ -198,6 +245,13 @@ dependencies = [
 
 [project.entry-points]
 "erispulse.adapter" = {{ "{entry_key}" = "{name}:{name}" }}
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["{name}"]
 """
 
 _ADAPTER_INIT = """from .Core import {name}
@@ -212,6 +266,7 @@ __all__ = [
 _ADAPTER_CORE = """import asyncio
 import json
 from dataclasses import dataclass, field
+from typing import ClassVar
 from ErisPulse.Core import BaseAdapter
 from ErisPulse.Core.Bases import BaseConfig, BaseI18n, I18nKey
 from ErisPulse.Core import router
@@ -223,6 +278,13 @@ class {name}(BaseAdapter):
     {text[adapter.doc]}
     \"\"\"
 
+    # 依赖声明（可选，ErisPulse 2.8.0+）：
+    # depends = {{"adapters": [], "modules": []}}   # 硬依赖：缺失时跳过启动
+    # optional_modules = []                          # 软依赖：就绪/丢失时收到
+    #                                               # on_dependency_ready/lost 回调
+    depends: ClassVar[dict] = {{}}
+    optional_modules: ClassVar[list] = []
+
     # {text[adapter.config_hint]}
     @dataclass
     class ConfigClass(BaseConfig):
@@ -645,6 +707,12 @@ class CreateCommand(Command):
         parser.add_argument(
             "--force", "-f", action="store_true", help=i18n.t("cli.create.force_help")
         )
+        parser.add_argument(
+            "--local",
+            action="store_true",
+            default=False,
+            help=i18n.t("cli.create.local_module_help"),
+        )
 
     def execute(self, args):
         create_type = getattr(args, "create_type", None)
@@ -712,6 +780,11 @@ class CreateCommand(Command):
         :param name: [str] 模块名称
         :return: [None] 无返回值
         """
+        # --local：创建本地插件（plugins/ 目录结构，免打包安装）
+        if getattr(args, "local", False):
+            self._create_module_local(args, name)
+            return
+
         description = self._ask_missing(
             args,
             "description",
@@ -797,6 +870,55 @@ class CreateCommand(Command):
             console.print(f"[error]  {i18n.t('cli.create.failed', error=e)}")
             sys.exit(1)
 
+    def _create_module_local(self, args, name: str):
+        """
+        创建本地插件（--local）：生成 plugins/ 目录结构，免打包安装
+
+        :param args: [Any] 解析后的命令参数对象
+        :param name: [str] 模块名称
+        :return: [None] 无返回值
+        """
+        output = Path(args.output)
+        plugins_dir = output / "plugins"
+        plugin_dir = plugins_dir / name
+
+        if plugin_dir.exists() and not args.force:
+            console.print(
+                f"[error]  {i18n.t('cli.create.dir_exists', dir=str(plugin_dir))}"
+            )
+            sys.exit(1)
+
+        try:
+            plugin_dir.mkdir(parents=True, exist_ok=True)
+
+            (plugin_dir / "__init__.py").write_text(_MODULE_INIT, encoding="utf-8")
+            (plugin_dir / "Core.py").write_text(
+                _MODULE_CORE.format(name=name, text=_scaffold_text(name)),
+                encoding="utf-8",
+            )
+
+            console.print()
+            console.print(
+                f"[success]  {i18n.t('cli.create.module_created', name=name)}[/]"
+            )
+            console.print()
+            console.print(Text(i18n.t("cli.create.local_structure"), style="bold"))
+            console.print("    plugins/")
+            console.print(f"    └── {name}/")
+            console.print("        ├── __init__.py")
+            console.print("        └── Core.py")
+            console.print()
+            console.print(Text(i18n.t("cli.create.next_steps"), style="bold"))
+            console.print(f"    · {i18n.t('cli.create.cd_to', dir=str(plugin_dir))}")
+            console.print(
+                f"    · {i18n.t('cli.create.edit_module', file=str(plugin_dir) + '/Core.py')}"
+            )
+            console.print(f"    · {i18n.t('cli.create.local_tip')}")
+
+        except Exception as e:
+            console.print(f"[error]  {i18n.t('cli.create.failed', error=e)}")
+            sys.exit(1)
+
     def _create_adapter(self, args, name: str):
         """
         创建 Adapter 项目脚手架