ErisPulse 2.5.0.dev0__tar.gz → 2.5.0.dev1__tar.gz

{erispulse-2.5.0.dev0 → erispulse-2.5.0.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 2.5.0.dev0
+Version: 2.5.0.dev1
 Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
 Author-email: ErisDev <erisdev@88.com>
 Maintainer-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>
@@ -48,8 +48,9 @@ Requires-Dist: packaging>=25.0
 Requires-Dist: pip>=23.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: toml>=0.10.2
-Requires-Dist: uvicorn[standard]>=0.30.0
+Requires-Dist: uvicorn>=0.30.0
 Requires-Dist: watchdog>=4.0.0
+Requires-Dist: websockets>=12.0
 Provides-Extra: dev
 Requires-Dist: httpx>=0.24.0; extra == 'dev'
 Requires-Dist: pyclean>=3.6.0; extra == 'dev'
@@ -79,7 +80,9 @@ Description-Content-Type: text/markdown
 </td>
 <td valign="middle">
 
-[English](README.en.md) | **简体中文** | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [Русский](README.ru.md)
+> [English](README.en.md) | **简体中文** | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [Русский](README.ru.md)
+
+> 🎉 **v2.5.0-dev.1 现已支持多语言！** 框架核心及 CLI 界面已内置中文（简/繁）、英文、日文、俄文支持，会自动检测您的系统语言切换！
 
 # ErisPulse
 

{erispulse-2.5.0.dev0 → erispulse-2.5.0.dev1}/README.md

@@ -7,7 +7,9 @@
 </td>
 <td valign="middle">
 
-[English](README.en.md) | **简体中文** | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [Русский](README.ru.md)
+> [English](README.en.md) | **简体中文** | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [Русский](README.ru.md)
+
+> 🎉 **v2.5.0-dev.1 现已支持多语言！** 框架核心及 CLI 界面已内置中文（简/繁）、英文、日文、俄文支持，会自动检测您的系统语言切换！
 
 # ErisPulse
 

{erispulse-2.5.0.dev0 → erispulse-2.5.0.dev1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ErisPulse"
-version = "2.5.0-dev.0"
+version = "2.5.0-dev.1"
 description = "ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -65,7 +65,8 @@ dependencies = [
     "watchdog>=4.0.0",
     "toml>=0.10.2",
     "fastapi>=0.116.1",
-    "uvicorn[standard]>=0.30.0",
+    "uvicorn>=0.30.0",
+    "websockets>=12.0",
     "packaging>=25.0",
 ]
 

erispulse-2.5.0.dev1/src/ErisPulse/CLI/__init__.py

@@ -0,0 +1,17 @@
+"""
+CLI 模块
+
+ErisPulse 命令行接口
+
+{!--< internal-use >!--}
+CLI 拥有独立的国际化模块 (CLI.i18n)，与 Core.i18n 完全解耦。
+此模块仅供内部使用，外部模块不应直接依赖 CLI.i18n。
+{!--< /internal-use >!--}
+"""
+
+from .cli import CLI
+from .i18n import i18n as _cli_i18n
+
+__all__ = [
+    "CLI",
+]

erispulse-2.5.0.dev1/src/ErisPulse/CLI/__init__.pyi

@@ -0,0 +1,19 @@
+# type: ignore
+#
+# Auto-generated type stub for __init__.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+CLI 模块
+
+ErisPulse 命令行接口
+
+{!--< internal-use >!--}
+CLI 拥有独立的国际化模块 (CLI.i18n)，与 Core.i18n 完全解耦。
+此模块仅供内部使用，外部模块不应直接依赖 CLI.i18n。
+{!--< /internal-use >!--}
+"""
+
+from .cli import CLI
+from .i18n import i18n as _cli_i18n

{erispulse-2.5.0.dev0 → erispulse-2.5.0.dev1}/src/ErisPulse/CLI/cli.py

@@ -4,18 +4,19 @@
 ErisPulse 命令行接口主入口
 """
 
-import sys
 import importlib
-import traceback
 import pkgutil
+import sys
+import traceback
 from argparse import ArgumentParser, RawDescriptionHelpFormatter
 
 from rich.panel import Panel
 from rich.text import Text
 
+from .base import Command
 from .console import console, print_banner
+from .i18n import i18n
 from .registry import CommandRegistry
-from .base import Command
 
 
 class CLI:
@@ -40,24 +41,31 @@ class CLI:
         parser = ArgumentParser(
             prog="epsdk",
             formatter_class=RawDescriptionHelpFormatter,
-            description="ErisPulse SDK 命令行工具",
+            description=i18n.t("cli.parser.description"),
         )
         parser._positionals.title = "命令"
         parser._optionals.title = "选项"
 
         # 全局选项
-        parser.add_argument("--version", "-V", action="store_true", help="显示版本信息")
+        parser.add_argument(
+            "--version",
+            "-V",
+            action="store_true",
+            help=i18n.t("cli.parser.version_help"),
+        )
         parser.add_argument(
             "--verbose",
             "-v",
             action="count",
             default=0,
-            help="增加输出详细程度 (-v, -vv, -vvv)",
+            help=i18n.t("cli.parser.verbose_help"),
         )
 
         # 子命令
         subparsers = parser.add_subparsers(
-            dest="command", metavar="<命令>", help="要执行的操作"
+            dest="command",
+            metavar=i18n.t("cli.parser.command_meta"),
+            help=i18n.t("cli.parser.command_help"),
         )
 
         self.subparsers = subparsers
@@ -103,14 +111,18 @@ class CLI:
                                 self.registry.register(command_instance)
                             except Exception as e:
                                 console.print(
-                                    f"[warning]实例化命令 {attr_name} 失败: {e}[/]"
+                                    f"[warning]{i18n.t('cli.discover.instantiate_failed', name=attr_name, error=e)}[/]"
                                 )
 
                 except Exception as e:
-                    console.print(f"[warning]加载命令模块 {module_name} 失败: {e}[/]")
+                    console.print(
+                        f"[warning]{i18n.t('cli.discover.load_failed', name=module_name, error=e)}[/]"
+                    )
 
         except ImportError as e:
-            console.print(f"[warning]无法导入 commands 包: {e}[/]")
+            console.print(
+                f"[warning]{i18n.t('cli.discover.import_failed', error=e)}[/]"
+            )
 
     def _register_builtin_commands(self):
         """注册所有内置命令（通过自动发现）"""
@@ -131,7 +143,7 @@ class CLI:
 
         console.print(
             Panel(
-                f"[title]ErisPulse SDK[/] 版本: [bold]{__version__}[/]",
+                f"[title]{i18n.t('cli.run.version_text', version=__version__)}[/]",
                 subtitle=f"Python {sys.version.split()[0]}",
                 style="title",
             )
@@ -157,7 +169,9 @@ class CLI:
         # 没有指定命令时显示帮助
         if not args.command:
             if unknown:
-                console.print(f"[warning]未识别的参数: {' '.join(unknown)}[/]")
+                console.print(
+                    f"[warning]{i18n.t('cli.run.unknown_args', args=' '.join(unknown))}[/]"
+                )
             self.parser.print_help()
             return
 
@@ -165,7 +179,9 @@ class CLI:
         canonical = self.registry.resolve(args.command) or args.command
 
         if unknown and canonical not in ("install", "create"):
-            console.print(f"[warning]未识别的参数: {' '.join(unknown)}[/]")
+            console.print(
+                f"[warning]{i18n.t('cli.run.unknown_args', args=' '.join(unknown))}[/]"
+            )
 
         try:
             # 执行命令
@@ -180,15 +196,17 @@ class CLI:
                 console.print()
                 command.execute(args)
             else:
-                console.print(f"[error]未知命令: {args.command}[/]")
+                console.print(
+                    f"[error]{i18n.t('cli.run.unknown_command', command=args.command)}[/]"
+                )
                 self.parser.print_help()
                 sys.exit(1)
 
         except KeyboardInterrupt:
-            console.print("\n[warning]操作被用户中断[/]")
+            console.print(f"\n[warning]{i18n.t('cli.run.user_interrupted')}[/]")
             sys.exit(1)
         except Exception as e:
-            console.print(f"[error]执行命令时出错: {e}[/]")
+            console.print(f"[error]{i18n.t('cli.run.exec_error', error=e)}[/]")
             if args.verbose >= 1:
                 console.print(traceback.format_exc())
             sys.exit(1)

{erispulse-2.5.0.dev0 → erispulse-2.5.0.dev1}/src/ErisPulse/CLI/cli.pyi

@@ -10,16 +10,17 @@
 ErisPulse 命令行接口主入口
 """
 
-import sys
 import importlib
-import traceback
 import pkgutil
+import sys
+import traceback
 from argparse import ArgumentParser, RawDescriptionHelpFormatter
 from rich.panel import Panel
 from rich.text import Text
+from .base import Command
 from .console import console, print_banner
+from .i18n import i18n
 from .registry import CommandRegistry
-from .base import Command
 
 class CLI:
     """

{erispulse-2.5.0.dev0 → erispulse-2.5.0.dev1}/src/ErisPulse/CLI/commands/create.py

@@ -4,18 +4,18 @@ Create 命令实现
 脚手架工具，快速创建 Module / Adapter 项目模板
 """
 
-import sys
 import datetime
+import sys
 from argparse import ArgumentParser
 from pathlib import Path
 
-from rich.prompt import Prompt, IntPrompt
+from rich.prompt import IntPrompt, Prompt
 from rich.text import Text
 
-from ..console import console
 from ..base import Command
-from ..utils.display import section_header, prompt_validated
-
+from ..console import console
+from ..i18n import i18n
+from ..utils.display import prompt_validated, section_header
 
 _LICENSE_TEMPLATE = """MIT License
 
@@ -521,7 +521,7 @@ class CreateCommand(Command):
     """
 
     name = "create"
-    description = "创建 Module / Adapter 项目脚手架"
+    description = i18n.t("cli.create.description")
     aliases = ["c", "new"]
 
     def add_arguments(self, parser: ArgumentParser):
@@ -529,18 +529,26 @@ class CreateCommand(Command):
             "create_type",
             nargs="?",
             choices=["module", "adapter"],
-            help="创建类型: module 或 adapter",
+            help=i18n.t("cli.create.type_help"),
+        )
+        parser.add_argument("--name", "-n", help=i18n.t("cli.create.name_help"))
+        parser.add_argument(
+            "--description", "-d", help=i18n.t("cli.create.desc_help"), default=""
         )
-        parser.add_argument("--name", "-n", help="项目/模块/适配器名称 (PascalCase)")
-        parser.add_argument("--description", "-d", help="项目描述", default="")
-        parser.add_argument("--author", "-a", help="作者名称", default="")
-        parser.add_argument("--email", "-e", help="作者邮箱", default="")
-        parser.add_argument("--homepage", help="项目主页 URL", default="")
         parser.add_argument(
-            "--output", "-o", help="输出目录 (默认当前目录)", default="."
+            "--author", "-a", help=i18n.t("cli.create.author_help"), default=""
         )
         parser.add_argument(
-            "--force", "-f", action="store_true", help="强制覆盖已存在的目录"
+            "--email", "-e", help=i18n.t("cli.create.email_help"), default=""
+        )
+        parser.add_argument(
+            "--homepage", help=i18n.t("cli.create.homepage_help"), default=""
+        )
+        parser.add_argument(
+            "--output", "-o", help=i18n.t("cli.create.output_help"), default="."
+        )
+        parser.add_argument(
+            "--force", "-f", action="store_true", help=i18n.t("cli.create.force_help")
         )
 
     def execute(self, args):
@@ -553,10 +561,10 @@ class CreateCommand(Command):
         # 名称校验：非法时保留输入并重新提示，而非直接退出
         if not (name and _validate_name(name)):
             name = prompt_validated(
-                "  名称 (PascalCase)",
+                i18n.t("cli.create.name_prompt"),
                 default=name or default_name,
                 validate=_validate_name,
-                error_msg="名称必须以字母开头，只能包含字母、数字和下划线",
+                error_msg=i18n.t("cli.create.name_error"),
             )
 
         if create_type == "module":
@@ -570,11 +578,17 @@ class CreateCommand(Command):
 
         :return: [str] 返回 "module" 或 "adapter"
         """
-        section_header("选择创建类型")
-        console.print("    [bold]1.[/] Module   [dim]— 自定义功能模块[/]")
-        console.print("    [bold]2.[/] Adapter  [dim]— 平台适配器[/]")
+        section_header(i18n.t("cli.create.select_type_title"))
+        console.print(
+            f"    [bold]1.[/] Module   [dim]{i18n.t('cli.create.select_type_module')}[/]"
+        )
+        console.print(
+            f"    [bold]2.[/] Adapter  [dim]{i18n.t('cli.create.select_type_adapter')}[/]"
+        )
         console.print()
-        choice = IntPrompt.ask("  请选择", default=1, choices=["1", "2"])
+        choice = IntPrompt.ask(
+            i18n.t("cli.create.select_prompt"), default=1, choices=["1", "2"]
+        )
         console.print()
         return "module" if choice == 1 else "adapter"
 
@@ -604,19 +618,31 @@ class CreateCommand(Command):
         :return: [None] 无返回值
         """
         description = self._ask_missing(
-            args, "description", "模块描述", f"一个非常哇塞的{name}模块"
+            args,
+            "description",
+            i18n.t("cli.create.module_desc_prompt"),
+            i18n.t("cli.create.module_desc_placeholder", name=name),
+        )
+        author = self._ask_missing(
+            args, "author", i18n.t("cli.create.author_prompt"), "yourname"
+        )
+        email = self._ask_missing(
+            args, "email", i18n.t("cli.create.email_prompt"), "your@mail.com"
         )
-        author = self._ask_missing(args, "author", "作者名称", "yourname")
-        email = self._ask_missing(args, "email", "作者邮箱", "your@mail.com")
         homepage = self._ask_missing(
-            args, "homepage", "项目主页", f"https://github.com/{author}/{name}"
+            args,
+            "homepage",
+            i18n.t("cli.create.homepage_prompt"),
+            f"https://github.com/{author}/{name}",
         )
 
         output = Path(args.output)
         project_dir = output / name
 
         if project_dir.exists() and not args.force:
-            console.print(f"[error]  目录 {project_dir} 已存在，使用 --force 覆盖")
+            console.print(
+                f"[error]  {i18n.t('cli.create.dir_exists', dir=str(project_dir))}"
+            )
             sys.exit(1)
 
         try:
@@ -650,9 +676,11 @@ class CreateCommand(Command):
             )
 
             console.print()
-            console.print(f"[success]  Module 项目 [{name}] 创建成功[/]")
+            console.print(
+                f"[success]  {i18n.t('cli.create.module_created', name=name)}[/]"
+            )
             console.print()
-            console.print(Text("  项目结构:", style="bold"))
+            console.print(Text(i18n.t("cli.create.project_structure"), style="bold"))
             console.print(f"    {name}/")
             console.print("    ├── pyproject.toml")
             console.print("    ├── LICENSE")
@@ -661,14 +689,16 @@ class CreateCommand(Command):
             console.print("        ├── __init__.py")
             console.print("        └── Core.py")
             console.print()
-            console.print(Text("  接下来:", style="bold"))
-            console.print(f"    · cd {name}")
-            console.print(f"    · 编辑 {name}/Core.py 实现模块逻辑")
-            console.print("    · pip install -e .  (开发模式安装)")
-            console.print("    · epsdk run  (运行测试)")
+            console.print(Text(i18n.t("cli.create.next_steps"), style="bold"))
+            console.print(f"    · {i18n.t('cli.create.cd_to', dir=name)}")
+            console.print(
+                f"    · {i18n.t('cli.create.edit_module', file=name + '/Core.py')}"
+            )
+            console.print(f"    · {i18n.t('cli.create.install_dev')}")
+            console.print(f"    · {i18n.t('cli.create.run_test')}")
 
         except Exception as e:
-            console.print(f"[error]  创建失败: {e}")
+            console.print(f"[error]  {i18n.t('cli.create.failed', error=e)}")
             sys.exit(1)
 
     def _create_adapter(self, args, name: str):
@@ -680,12 +710,22 @@ class CreateCommand(Command):
         :return: [None] 无返回值
         """
         description = self._ask_missing(
-            args, "description", "适配器描述", f"{name}平台适配器"
+            args,
+            "description",
+            i18n.t("cli.create.adapter_desc_prompt"),
+            i18n.t("cli.create.adapter_desc_placeholder", name=name),
+        )
+        author = self._ask_missing(
+            args, "author", i18n.t("cli.create.author_prompt"), "yourname"
+        )
+        email = self._ask_missing(
+            args, "email", i18n.t("cli.create.email_prompt"), "your@mail.com"
         )
-        author = self._ask_missing(args, "author", "作者名称", "yourname")
-        email = self._ask_missing(args, "email", "作者邮箱", "your@mail.com")
         homepage = self._ask_missing(
-            args, "homepage", "项目主页", f"https://github.com/{author}/{name}"
+            args,
+            "homepage",
+            i18n.t("cli.create.homepage_prompt"),
+            f"https://github.com/{author}/{name}",
         )
 
         converter_name = _to_converter_name(name)
@@ -694,7 +734,9 @@ class CreateCommand(Command):
         project_dir = output / name
 
         if project_dir.exists() and not args.force:
-            console.print(f"[error]  目录 {project_dir} 已存在，使用 --force 覆盖")
+            console.print(
+                f"[error]  {i18n.t('cli.create.dir_exists', dir=str(project_dir))}"
+            )
             sys.exit(1)
 
         try:
@@ -743,9 +785,11 @@ class CreateCommand(Command):
             )
 
             console.print()
-            console.print(f"[success]  Adapter 项目 [{name}] 创建成功[/]")
+            console.print(
+                f"[success]  {i18n.t('cli.create.adapter_created', name=name)}[/]"
+            )
             console.print()
-            console.print(Text("  项目结构:", style="bold"))
+            console.print(Text(i18n.t("cli.create.project_structure"), style="bold"))
             console.print(f"    {name}/")
             console.print("    ├── pyproject.toml")
             console.print("    ├── LICENSE")
@@ -755,13 +799,17 @@ class CreateCommand(Command):
             console.print("        ├── Core.py")
             console.print("        └── Converter.py")
             console.print()
-            console.print(Text("  接下来:", style="bold"))
-            console.print(f"    · cd {name}")
-            console.print(f"    · 编辑 {name}/Core.py 实现适配器逻辑")
-            console.print(f"    · 编辑 {name}/Converter.py 实现消息格式转换")
-            console.print("    · pip install -e .  (开发模式安装)")
-            console.print("    · epsdk run  (运行测试)")
+            console.print(Text(i18n.t("cli.create.next_steps"), style="bold"))
+            console.print(f"    · {i18n.t('cli.create.cd_to', dir=name)}")
+            console.print(
+                f"    · {i18n.t('cli.create.edit_adapter', file=name + '/Core.py')}"
+            )
+            console.print(
+                f"    · {i18n.t('cli.create.edit_converter', file=name + '/Converter.py')}"
+            )
+            console.print(f"    · {i18n.t('cli.create.install_dev')}")
+            console.print(f"    · {i18n.t('cli.create.run_test')}")
 
         except Exception as e:
-            console.print(f"[error]  创建失败: {e}")
+            console.print(f"[error]  {i18n.t('cli.create.failed', error=e)}")
             sys.exit(1)

{erispulse-2.5.0.dev0 → erispulse-2.5.0.dev1}/src/ErisPulse/CLI/commands/create.pyi

@@ -10,15 +10,16 @@ Create 命令实现
 脚手架工具，快速创建 Module / Adapter 项目模板
 """
 
-import sys
 import datetime
+import sys
 from argparse import ArgumentParser
 from pathlib import Path
-from rich.prompt import Prompt, IntPrompt
+from rich.prompt import IntPrompt, Prompt
 from rich.text import Text
-from ..console import console
 from ..base import Command
-from ..utils.display import section_header, prompt_validated
+from ..console import console
+from ..i18n import i18n
+from ..utils.display import prompt_validated, section_header
 
 def _camel_to_snake(name: str) -> str:
     """