ErisPulse 2.9.0.dev2__tar.gz → 2.10.0.dev0__tar.gz

{erispulse-2.9.0.dev2 → erispulse-2.10.0.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ErisPulse
-Version: 2.9.0-dev.2
+Version: 2.10.0-dev.0
 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
@@ -95,6 +95,8 @@ It ships with a flexible plugin system, hot reload, a visual Dashboard, an AI Bu
 pip install ErisPulse
 ```
 
+For a global `epsdk` CLI without any virtual environment, use `uv tool install ErisPulse` instead.
+
 ### Option 2 — Docker (recommended for production)
 
 ```bash

{erispulse-2.9.0.dev2 → erispulse-2.10.0.dev0}/README.pypi.md

@@ -42,6 +42,8 @@ It ships with a flexible plugin system, hot reload, a visual Dashboard, an AI Bu
 pip install ErisPulse
 ```
 
+For a global `epsdk` CLI without any virtual environment, use `uv tool install ErisPulse` instead.
+
 ### Option 2 — Docker (recommended for production)
 
 ```bash

{erispulse-2.9.0.dev2 → erispulse-2.10.0.dev0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ErisPulse"
-version = "2.9.0-dev.2"
+version = "2.10.0-dev.0"
 description = "Event-driven modular async bot framework — write once, deploy to any platform | 事件驱动的模块化异步机器人框架，一次编写，多平台部署"
 readme = "README.pypi.md"
 requires-python = ">=3.10"

{erispulse-2.9.0.dev2 → erispulse-2.10.0.dev0}/src/ErisPulse/CLI/commands/create.py

@@ -41,6 +41,12 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 """
 
+# 生成模块/适配器模板的最低 SDK 地板（写入模板 min_sdk_version 字段）。
+# 模板示例使用 args=/options=（2.9 特性）；pip 默认不解析预发布版本，
+# 该地板不得高于已发布的正式版本，否则生成的组件会因依赖装不上或
+# 加载器按 PEP 440 拒载（与 CLI/constants.py 的 INIT_ERISPULSE_DEPENDENCY 同步升版）。
+_TEMPLATE_MIN_SDK_VERSION = "2.9.0"
+
 _MODULE_PYPROJECT = """[project]
 name = "ErisPulse-{name}"
 version = "1.0.0"
@@ -72,10 +78,19 @@ _MODULE_INIT = """from .Core import Main
 
 _MODULE_CORE = """from dataclasses import dataclass, field
 
-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
+from ErisPulse import (
+    SDK,
+    BaseConfig,
+    BaseI18n,
+    BaseModule,
+    Event,
+    I18nKey,
+    ModuleMeta,
+    command,
+    i18n,
+    message,
+    notice,
+)
 
 
 class Main(BaseModule):
@@ -144,6 +159,42 @@ class Main(BaseModule):
             ru=\"Привет от {name}!\",
             zh_TW=\"來自 {name} 的問候！\",
         )
+        roll_help: I18nKey = I18nKey(
+            key=\"module.{name}.command.roll.help\",
+            default=\"Roll dice: count [sides]\",
+            zh_CN=\"掷骰子：次数 [面数]\",
+            en=\"Roll dice: count [sides]\",
+            ja=\"サイコロを振る: 回数 [面数]\",
+            ru=\"Бросить кости: количество [граней]\",
+            zh_TW=\"擲骰子：次數 [面數]\",
+        )
+        roll_reply: I18nKey = I18nKey(
+            key=\"module.{name}.command.roll.reply\",
+            default=\"Rolled {{count}}d{{sides}}, total: {{total}}{{detail}}\",
+            zh_CN=\"掷了 {{count}} 次 {{sides}} 面骰，总点数：{{total}}{{detail}}\",
+            en=\"Rolled {{count}}d{{sides}}, total: {{total}}{{detail}}\",
+            ja=\"{{sides}}面ダイスを {{count}} 回振った合計: {{total}}{{detail}}\",
+            ru=\"Бросков {{count}}d{{sides}}, сумма: {{total}}{{detail}}\",
+            zh_TW=\"擲了 {{count}} 次 {{sides}} 面骰，總點數：{{total}}{{detail}}\",
+        )
+        roll_detail: I18nKey = I18nKey(
+            key=\"module.{name}.command.roll.detail\",
+            default=\" (verbose: {{count}} rolls of {{sides}}-sided dice)\",
+            zh_CN=\"（详细模式：{{count}} 次 {{sides}} 面骰）\",
+            en=\" (verbose: {{count}} rolls of {{sides}}-sided dice)\",
+            ja=\"（詳細モード: {{sides}}面ダイスを {{count}} 回）\",
+            ru=\" (подробно: {{count}} бросков {{sides}}-гранного кубика)\",
+            zh_TW=\"（詳細模式：{{count}} 次 {{sides}} 面骰）\",
+        )
+        signin_reply: I18nKey = I18nKey(
+            key=\"module.{name}.command.signin.reply\",
+            default=\"Signed in!\",
+            zh_CN=\"签到成功\",
+            en=\"Signed in!\",
+            ja=\"チェックイン完了！\",
+            ru=\"Готово, вы отмечены!\",
+            zh_TW=\"簽到成功\",
+        )
 
     def __init__(self, sdk: SDK = None):
         # sdk 由框架在实例化时自动注入（无需手动导入兜底）
@@ -167,7 +218,7 @@ class Main(BaseModule):
             version=\"0.1.0\",
             author=\"ErisDev\",
             # 最低 SDK 版本（可选）：不满足时框架在加载期明确报错并跳过本模块
-            min_sdk_version=\"2.8.0\",
+            min_sdk_version=\"{min_sdk}\",
             group=\"default\",
             tags=[\"{name}\"],
             # 对外服务白名单（可选）：声明后其他模块可经 sdk.module.call() 调用这些方法；
@@ -225,6 +276,20 @@ class Main(BaseModule):
         async def hello_command(event: Event):
             await event.reply(i18n.t(\"module.{name}.command.hello.reply\"))
 
+        # {text[module.roll_hint]}
+        @command(
+            \"roll\",
+            args=\"<count:int> [sides:int=6]\",
+            options={{\"verbose\": \"-v/--verbose\"}},
+            help=i18n.t(\"module.{name}.command.roll.help\"),
+        )
+        async def roll_command(event: Event, count: int, sides: int = 6, verbose: bool = False):
+            import random
+
+            total = sum(random.randint(1, sides) for _ in range(count))
+            detail = i18n.t(\"module.{name}.command.roll.detail\", count=count, sides=sides) if verbose else \"\"
+            await event.reply(i18n.t(\"module.{name}.command.roll.reply\", count=count, sides=sides, total=total, detail=detail))
+
     async def _register_message_handlers(self):
         @message.on_private_message()
         async def private_message_handler(event: Event):
@@ -235,9 +300,9 @@ class Main(BaseModule):
             pass
 
         # 消息装饰器支持 pattern（glob 通配符）/ regex（正则），不匹配则不触发
-        @message.on_message(pattern=\"签到*\")
+        @message.on_message(pattern=\"{text[module.signin_pattern]}\")
         async def signin_handler(event: Event):
-            await event.reply(\"签到成功\")
+            await event.reply(i18n.t(\"module.{name}.command.signin.reply\"))
 
         @notice.on_friend_add()
         async def friend_add_handler(event: Event):
@@ -283,10 +348,7 @@ _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
-from ErisPulse.Core.i18n import i18n
+from ErisPulse import BaseAdapter, BaseConfig, BaseI18n, I18nKey, router, i18n
 
 
 class {name}(BaseAdapter):
@@ -294,7 +356,7 @@ class {name}(BaseAdapter):
     {text[adapter.doc]}
     \"\"\"
 
-    # 依赖声明（可选，ErisPulse 2.8.0+）：
+    # 依赖声明（可选，ErisPulse 2.9.0+）：
     # depends = {{"adapters": [], "modules": []}}   # 硬依赖：缺失时跳过启动
     # optional_modules = []                          # 软依赖：就绪/丢失时收到
     #                                               # on_dependency_ready/lost 回调
@@ -302,7 +364,7 @@ class {name}(BaseAdapter):
     optional_modules: ClassVar[list] = []
 
     # 声明所需最低 SDK 版本：不满足时框架在加载期明确报错并跳过本适配器（可选）
-    min_sdk_version = "2.8.0"
+    min_sdk_version = "{min_sdk}"
 
     # {text[adapter.config_hint]}
     @dataclass
@@ -461,6 +523,11 @@ class {name}(BaseAdapter):
     async def _ws_handler(self, websocket):
         bot_id = self._get_bot_id()
 
+        # 连接已由框架自动登记进连接池（ErisPulse.connections）：
+        # meta 供跨模块查看，join_group 后可被 connections.broadcast 定向推送
+        websocket.meta["bot_id"] = bot_id
+        websocket.join_group(f"bot:{{bot_id}}")
+
         await self.emit_meta("connect", bot_id, user_name="{name}")
         self.logger.info("{text[adapter.log.bot_connected]}")
 
@@ -484,7 +551,7 @@ class {name}(BaseAdapter):
 
     async def call_api(self, endpoint: str, **params):
         \"\"\"Call platform API\"\"\"
-        from ErisPulse.Core import client
+        from ErisPulse import client
 
         cfg = self.cfg
         headers = {{"Authorization": "Bearer " + cfg.token}}
@@ -848,7 +915,7 @@ class CreateCommand(Command):
 
             (pkg_dir / "__init__.py").write_text(_MODULE_INIT, encoding="utf-8")
             (pkg_dir / "Core.py").write_text(
-                _MODULE_CORE.format(name=name, text=_scaffold_text(name)),
+                _MODULE_CORE.format(name=name, text=_scaffold_text(name), min_sdk=_TEMPLATE_MIN_SDK_VERSION),
                 encoding="utf-8",
             )
             (project_dir / "pyproject.toml").write_text(
@@ -921,7 +988,7 @@ class CreateCommand(Command):
 
             (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)),
+                _MODULE_CORE.format(name=name, text=_scaffold_text(name), min_sdk=_TEMPLATE_MIN_SDK_VERSION),
                 encoding="utf-8",
             )
 
@@ -1000,6 +1067,7 @@ class CreateCommand(Command):
                     converter_name=converter_name,
                     entry_key=entry_key,
                     text=_scaffold_text(name),
+                    min_sdk=_TEMPLATE_MIN_SDK_VERSION,
                 ),
                 encoding="utf-8",
             )

{erispulse-2.9.0.dev2 → erispulse-2.10.0.dev0}/src/ErisPulse/CLI/commands/init.py

@@ -15,6 +15,7 @@ from rich.text import Text
 
 from ..base import Command
 from ..console import console
+from ..constants import INIT_ERISPULSE_DEPENDENCY
 from ..i18n import i18n
 from ..utils import PackageManager
 from ..utils.display import _input, prompt_validated, section_header
@@ -26,6 +27,7 @@ from ..utils.package_manager import (
     uv_add,
     warn_if_uv_isolated,
 )
+from ..utils.scaffold_text import ScaffoldText
 
 
 def _validate_project_name(name: str) -> bool:
@@ -192,6 +194,9 @@ class InitCommand(Command):
                 console.print(f"[success]  {i18n.t('cli.init.created_dir', name=project_name)}[/]")
 
         try:
+            # 生成物文案（config 注释 / main docstring / .gitignore 分节 /
+            # README）跟随 CLI 语言；缺失键回退英文
+            st = ScaffoldText()
             for dir_name in ["config", "logs"]:
                 (project_path / dir_name).mkdir(exist_ok=True)
             # SSL 证书默认目录：跟随项目运行目录走，配置里用相对路径引用
@@ -201,15 +206,14 @@ class InitCommand(Command):
                 ssl_file = ssl_dir / ssl_name
                 if not ssl_file.exists():
                     ssl_file.write_text(
-                        "# 将你的证书/密钥 PEM 内容粘贴到本文件，或在配置中改用 ssl_cert/ssl_key 内联填写\n",
+                        st.t("init.ssl_placeholder") + "\n",
                         encoding="utf-8",
                     )
 
             config_file = project_path / "config" / "config.toml"
             if not config_file.exists():
                 with config_file.open("w", encoding="utf-8") as f:
-                    f.write("# ErisPulse 配置文件\n")
-                    f.write("# 完整配置示例请参考 config.full.example\n\n")
+                    f.write(st.t("init.config_toml_header") + "\n\n")
                     f.write("[ErisPulse.server]\n")
                     f.write('host = "0.0.0.0"\n')
                     f.write("port = 8000\n\n")
@@ -224,9 +228,7 @@ class InitCommand(Command):
             main_file = project_path / "main.py"
             if not main_file.exists():
                 with main_file.open("w", encoding="utf-8") as f:
-                    f.write(f'"""\n{display_name} 主程序\n\n')
-                    f.write("这是 ErisPulse 自动生成的主程序文件\n")
-                    f.write('"""\n\n')
+                    f.write(st.t("init.main_docstring", display_name=display_name) + "\n")
                     f.write("import asyncio\n")
                     f.write("from ErisPulse import sdk\n\n")
                     f.write("async def main():\n")
@@ -245,7 +247,7 @@ class InitCommand(Command):
                     f.write('description = "ErisPulse project"\n')
                     f.write('requires-python = ">=3.10"\n')
                     f.write("dependencies = [\n")
-                    f.write('    "erispulse>=2.8.3",\n')
+                    f.write(f'    "{INIT_ERISPULSE_DEPENDENCY}",\n')
                     for adapter in adapter_list or []:
                         f.write(f'    "{adapter}",\n')
                     f.write("]\n")
@@ -265,13 +267,13 @@ class InitCommand(Command):
                         "*.egg-info/\n"
                         ".eggs/\n"
                         "\n"
-                        "# 虚拟环境与本地环境\n"
+                        f"{st.t('init.gitignore_section_venv')}\n"
                         ".venv/\n"
                         "venv/\n"
                         "env/\n"
                         ".env\n"
                         "\n"
-                        "# 工具缓存\n"
+                        f"{st.t('init.gitignore_section_cache')}\n"
                         ".pytest_cache/\n"
                         ".mypy_cache/\n"
                         ".ruff_cache/\n"
@@ -279,11 +281,11 @@ class InitCommand(Command):
                         "coverage.xml\n"
                         "htmlcov/\n"
                         "\n"
-                        "# ErisPulse 运行时数据（配置与日志含敏感信息，不入库）\n"
+                        f"{st.t('init.gitignore_section_runtime')}\n"
                         "config/\n"
                         "logs/\n"
                         "\n"
-                        "# 编辑器与系统文件\n"
+                        f"{st.t('init.gitignore_section_editor')}\n"
                         ".idea/\n"
                         ".vscode/\n"
                         "*.swp\n"
@@ -295,14 +297,14 @@ class InitCommand(Command):
             readme_file = project_path / "README.md"
             if not readme_file.exists():
                 with readme_file.open("w", encoding="utf-8") as f:
-                    f.write(f"# {display_name}\n\nErisPulse 项目。\n\n```bash\nepsdk run\n```\n")
+                    f.write(st.t("init.readme_body", display_name=display_name))
                 console.print(f"[success]  {i18n.t('cli.init.readme_created')}[/]")
 
             # ---- 虚拟环境与依赖安装 ----
             if create_venv:
                 console.print(f"[info]  {i18n.t('cli.init.venv_creating')}[/]")
                 venv_python = None
-                if uv_add(project_path, ["erispulse>=2.8.3"]):
+                if uv_add(project_path, [INIT_ERISPULSE_DEPENDENCY]):
                     # uv add 自动创建 .venv、安装依赖并写入 pyproject 依赖清单
                     venv_python = resolve_target_python(project_path)[0]
                     console.print(f"[success]  {i18n.t('cli.init.venv_created')}[/]")
@@ -312,8 +314,8 @@ class InitCommand(Command):
                     if venv_python:
                         console.print(f"[success]  {i18n.t('cli.init.venv_created')}[/]")
                         pm = PackageManager(python_executable=venv_python)
-                        if pm.install_package(["erispulse>=2.8.3"]):
-                            append_pyproject_dependencies(project_path, ["erispulse>=2.8.3"])
+                        if pm.install_package([INIT_ERISPULSE_DEPENDENCY]):
+                            append_pyproject_dependencies(project_path, [INIT_ERISPULSE_DEPENDENCY])
                             console.print(f"[success]  {i18n.t('cli.init.deps_installed')}[/]")
                         else:
                             console.print(

{erispulse-2.9.0.dev2 → erispulse-2.10.0.dev0}/src/ErisPulse/CLI/commands/types.py

@@ -26,32 +26,31 @@ from ..i18n import i18n
 # 生成文件名（带前导下划线，避免与用户业务模块冲突）
 STUB_FILENAME = "_ep_types.py"
 
-# 存根文件头部说明
-_STUB_HEADER = '''"""
-ErisPulse 类型存根（自动生成，请勿手动编辑）
-
-由 `epsdk types` 命令根据已安装的模块/适配器生成。
-仅导出类型供用户代码作为变量标注使用，**不提供任何运行时实例**。
-所有导入都在 ``TYPE_CHECKING`` 下，运行时零开销、零行为改变。
-
-使用方式：
-    from _ep_types import MyModule, Yunhu
-    from ErisPulse import sdk
-
-    # 用导入的类型标注变量，即可获得 IDE 补全
-    my_mod: MyModule = sdk.module.get("MyModule")
-    my_mod.hello()                       # ← IDE 能补全 hello
-
-    my_adapter: Yunhu = sdk.adapter.get("yunhu")
-    await my_adapter.Send.To("group", "123").Board(...)  # ← 补全平台特有方法
-
-说明：
-    - 类型名采用 entry-point 名的 PascalCase 形式（如 ``yunhu`` → ``Yunhu``），
-      与传入 ``sdk.adapter.get()`` / ``sdk.module.get()`` 的名称对应
-    - 存根仅用于静态类型检查，不含运行时实现
-    - 安装/卸载模块/适配器后请重新生成：``epsdk types``
-"""
-'''
+def _stub_header() -> str:
+    """{!--< internal-use >!--} 渲染存根文件头部说明（当前语言）"""
+    return (
+        '"""\n'
+        f"{i18n.t('cli.types.stub_title')}\n"
+        "\n"
+        f"{i18n.t('cli.types.stub_intro')}\n"
+        "\n"
+        f"{i18n.t('cli.types.stub_usage_title')}:\n"
+        "    from _ep_types import MyModule, Yunhu\n"
+        "    from ErisPulse import sdk\n"
+        "\n"
+        f"    {i18n.t('cli.types.stub_usage_comment')}\n"
+        '    my_mod: MyModule = sdk.module.get("MyModule")\n'
+        f"    my_mod.hello()                       {i18n.t('cli.types.stub_usage_module_hint')}\n"
+        "\n"
+        '    my_adapter: Yunhu = sdk.adapter.get("yunhu")\n'
+        f"    await my_adapter.Send.To(\"group\", \"123\").Board(...)  {i18n.t('cli.types.stub_usage_adapter_hint')}\n"
+        "\n"
+        f"{i18n.t('cli.types.stub_notes_title')}:\n"
+        f"    - {i18n.t('cli.types.stub_note_naming')}\n"
+        f"    - {i18n.t('cli.types.stub_note_static_only')}\n"
+        f"    - {i18n.t('cli.types.stub_note_regen')}\n"
+        '"""\n'
+    )
 
 # 排除内省的方法名（来自基类、Python 内置、下划线开头）
 _EXCLUDE_METHOD_NAMES = frozenset({
@@ -491,14 +490,11 @@ class TypesCommand(Command):
         :param modules_info: 模块信息
         :return: 存根文件内容
         """
-        lines = [_STUB_HEADER.rstrip(), ""]
+        lines = [_stub_header().rstrip(), ""]
         lines.append("from typing import TYPE_CHECKING")
         lines.append("")
         lines.append("if TYPE_CHECKING:")
-        lines.append("    # 以下类型导入仅在 IDE / 类型检查器中生效，不会被运行时执行。")
-        lines.append("    # 在用户代码中通过 ``from _ep_types import XxxModule`` 获取类型，")
-        lines.append("    # 配合 ``my_mod: XxxModule = sdk.module.get('XxxModule')`` 获得补全。")
-        lines.append("")
+        lines.append(f"    # {i18n.t('cli.types.stub_typing_comment')}")
 
         export_names: list[str] = []
         seen_imports: set[str] = set()  # 去重完全相同的导入语句

{erispulse-2.9.0.dev2 → erispulse-2.10.0.dev0}/src/ErisPulse/CLI/constants.py

@@ -55,8 +55,16 @@ RUN_RESTART_PAUSE_SECS: float = 0.5
 # 修改影响: 数值越小越早提示，越大越保守（0/负数禁用提示）。
 RUN_PERSISTENT_CRASH_HINT_THRESHOLD: int = 3
 
+# init 生成项目对框架本体的依赖下限（pip 依赖声明，非 SDK 加载期检查）。
+# 使用位置: CLI/commands/init.py -> pyproject.toml 生成 / uv_add / pm.install_package /
+#           append_pyproject_dependencies 四处。
+# 修改影响: 真实 pip 依赖——pip 默认不解析预发布版本，该下限不得高于已发布的
+#           正式版本（与 create.py 的 _TEMPLATE_MIN_SDK_VERSION 同步升版）。
+INIT_ERISPULSE_DEPENDENCY: str = "erispulse>=2.9.0"
+
 __all__ = [
     "ADAPTER_ENTRY_POINT_GROUP",
+    "INIT_ERISPULSE_DEPENDENCY",
     "RUN_CRASH_BACKOFF_MAX_SECS",
     "RUN_CRASH_BACKOFF_PER_CRASH_SECS",
     "RUN_RESTART_PAUSE_SECS",

{erispulse-2.9.0.dev2 → erispulse-2.10.0.dev0}/src/ErisPulse/CLI/i18n/locales/en.py

@@ -426,6 +426,9 @@ TRANSLATIONS = {
     "cli.display.enter_number": "Please enter a number",
     # ==================== package_manager utils ====================
     "cli.package.ssl_error": "SSL verification failed: {error}",
+    "cli.package.uv_venv_failed": "uv venv failed: {error}",
+    "cli.package.python_venv_failed": "python -m venv failed: {error}",
+    "cli.package.pyproject_writeback_failed": "Failed to write dependencies back to pyproject.toml: {error}",
     "cli.package.ssl_error_proxy_hint": "  Proxy detected, please ensure the proxy is configured correctly or try setting the HTTPS_PROXY environment variable",
     "cli.package.fetch_remote_failed": "Failed to fetch remote package list, please check your network connection or proxy settings",
     "cli.package.proxy_detected": "  Proxy detected: {proxy}",
@@ -549,4 +552,15 @@ TRANSLATIONS = {
     "cli.types.usage_hint": "Import types in your code and use them as variable annotations for IDE completion:",
     "cli.types.usage_example": "from _ep_types import MyModule  # then: my_mod: MyModule = sdk.module.get('MyModule')",
     "cli.types.introspect_failed": "Failed to introspect target environment: {error}",
+    "cli.types.stub_title": "ErisPulse type stub (auto-generated, do not edit manually)",
+    "cli.types.stub_intro": "Generated by the `epsdk types` command from installed modules/adapters.\nExports types only, for variable annotations in user code — **provides no runtime instances**.\nAll imports are under ``TYPE_CHECKING``: zero runtime cost, zero behavior change.",
+    "cli.types.stub_usage_title": "Usage",
+    "cli.types.stub_usage_comment": "# annotate variables with the imported types to get IDE completion",
+    "cli.types.stub_usage_module_hint": "# ← IDE completes hello",
+    "cli.types.stub_usage_adapter_hint": "# ← completes platform-specific methods",
+    "cli.types.stub_notes_title": "Notes",
+    "cli.types.stub_note_naming": "Type names are the PascalCase form of entry-point names (e.g. ``yunhu`` → ``Yunhu``), matching the names passed to ``sdk.adapter.get()`` / ``sdk.module.get()``",
+    "cli.types.stub_note_static_only": "The stub is for static type checking only and contains no runtime implementation",
+    "cli.types.stub_note_regen": "Regenerate after installing/uninstalling modules or adapters: ``epsdk types``",
+    "cli.types.stub_typing_comment": "The type imports below only take effect in IDEs / type checkers and are never executed at runtime; in user code, get types via ``from _ep_types import XxxModule`` and use them as variable annotations for completion",
 }

{erispulse-2.9.0.dev2 → erispulse-2.10.0.dev0}/src/ErisPulse/CLI/i18n/locales/ja.py

@@ -426,6 +426,9 @@ TRANSLATIONS = {
     "cli.display.enter_number": "数字を入力してください",
     # ==================== package_manager ユーティリティ ====================
     "cli.package.ssl_error": "SSL 検証失敗: {error}",
+    "cli.package.uv_venv_failed": "uv venv に失敗しました: {error}",
+    "cli.package.python_venv_failed": "python -m venv に失敗しました: {error}",
+    "cli.package.pyproject_writeback_failed": "pyproject.toml への依存関係の書き戻しに失敗しました: {error}",
     "cli.package.ssl_error_proxy_hint": "  プロキシが検出されました。プロキシ設定が正しいことを確認するか、HTTPS_PROXY 環境変数を設定してください",
     "cli.package.fetch_remote_failed": "リモートパッケージリストを取得できませんでした。ネットワーク接続またはプロキシ設定を確認してください",
     "cli.package.proxy_detected": "  プロキシを検出: {proxy}",
@@ -549,4 +552,15 @@ TRANSLATIONS = {
     "cli.types.usage_hint": "コードに型をインポートして変数アノテーションとして使用すると、IDE 補完が利用できます：",
     "cli.types.usage_example": "from _ep_types import MyModule  # 次に: my_mod: MyModule = sdk.module.get('MyModule')",
     "cli.types.introspect_failed": "対象環境のイントロスペクションに失敗: {error}",
+    "cli.types.stub_title": "ErisPulse 型スタブ（自動生成、手動編集禁止）",
+    "cli.types.stub_intro": "インストール済みのモジュール/アダプタから `epsdk types` コマンドにより生成されました。\nユーザーコードの変数アノテーション用に型のみをエクスポートし、**実行時インスタンスは提供しません**。\nすべてのインポートは ``TYPE_CHECKING`` 配下にあり、実行時のオーバーヘッドと動作変更はゼロです。",
+    "cli.types.stub_usage_title": "使用方法",
+    "cli.types.stub_usage_comment": "# インポートした型で変数をアノテートすると IDE 補全が効きます",
+    "cli.types.stub_usage_module_hint": "# ← IDE が hello を補完します",
+    "cli.types.stub_usage_adapter_hint": "# ← プラットフォーム固有メソッドを補完します",
+    "cli.types.stub_notes_title": "説明",
+    "cli.types.stub_note_naming": "型名は entry-point 名の PascalCase 形式（例: ``yunhu`` → ``Yunhu``）で、``sdk.adapter.get()`` / ``sdk.module.get()`` に渡す名前に対応します",
+    "cli.types.stub_note_static_only": "スタブは静的型検査専用で、実行時実装を含みません",
+    "cli.types.stub_note_regen": "モジュール/アダプタのインストール/アンインストール後は再生成してください: ``epsdk types``",
+    "cli.types.stub_typing_comment": "以下の型インポートは IDE / 型チェッカーでのみ有効で、実行時には実行されません。ユーザーコードでは ``from _ep_types import XxxModule`` で型を取得し変数アノテーションに使うと補完が効きます",
 }

{erispulse-2.9.0.dev2 → erispulse-2.10.0.dev0}/src/ErisPulse/CLI/i18n/locales/ru.py

@@ -426,6 +426,9 @@ TRANSLATIONS = {
     "cli.display.enter_number": "Пожалуйста, введите номер",
     # ==================== утилиты package_manager ====================
     "cli.package.ssl_error": "Ошибка проверки SSL: {error}",
+    "cli.package.uv_venv_failed": "Сбой uv venv: {error}",
+    "cli.package.python_venv_failed": "Сбой python -m venv: {error}",
+    "cli.package.pyproject_writeback_failed": "Не удалось записать зависимости обратно в pyproject.toml: {error}",
     "cli.package.ssl_error_proxy_hint": "  Обнаружен прокси. Убедитесь, что прокси настроен правильно, или попробуйте задать переменную окружения HTTPS_PROXY",
     "cli.package.fetch_remote_failed": "Не удалось получить список удалённых пакетов. Проверьте сетевое подключение или настройки прокси",
     "cli.package.proxy_detected": "  Обнаружен прокси: {proxy}",
@@ -549,4 +552,15 @@ TRANSLATIONS = {
     "cli.types.usage_hint": "Импортируйте типы в коде и используйте как аннотации переменных для автодополнения IDE:",
     "cli.types.usage_example": "from _ep_types import MyModule  # затем: my_mod: MyModule = sdk.module.get('MyModule')",
     "cli.types.introspect_failed": "Ошибка интроспекции целевой среды: {error}",
+    "cli.types.stub_title": "Заглушка типов ErisPulse (сгенерирована автоматически, вручную не редактировать)",
+    "cli.types.stub_intro": "Сгенерирована командой `epsdk types` по установленным модулям/адаптерам.\nЭкспортирует только типы для аннотаций переменных в коде пользователя — **экземпляры времени выполнения не предоставляет**.\nВсе импорты находятся под ``TYPE_CHECKING``: нулевые накладные расходы и нулевое изменение поведения во время выполнения.",
+    "cli.types.stub_usage_title": "Использование",
+    "cli.types.stub_usage_comment": "# аннотируйте переменные импортированными типами, чтобы получить автодополнение в IDE",
+    "cli.types.stub_usage_module_hint": "# ← IDE дополнит hello",
+    "cli.types.stub_usage_adapter_hint": "# ← дополнит методы, специфичные для платформы",
+    "cli.types.stub_notes_title": "Примечания",
+    "cli.types.stub_note_naming": "Имена типов — форма PascalCase имён entry-point (например, ``yunhu`` → ``Yunhu``) и соответствуют именам, передаваемым в ``sdk.adapter.get()`` / ``sdk.module.get()``",
+    "cli.types.stub_note_static_only": "Заглушка предназначена только для статической проверки типов и не содержит реализации времени выполнения",
+    "cli.types.stub_note_regen": "После установки/удаления модулей или адаптеров перегенерируйте: ``epsdk types``",
+    "cli.types.stub_typing_comment": "Импорты типов ниже действуют только в IDE / проверщиках типов и никогда не выполняются во время выполнения; в коде пользователя получайте типы через ``from _ep_types import XxxModule`` и используйте их в аннотациях переменных для автодополнения",
 }

{erispulse-2.9.0.dev2 → erispulse-2.10.0.dev0}/src/ErisPulse/CLI/i18n/locales/zh_cn.py

@@ -426,6 +426,9 @@ TRANSLATIONS = {
     "cli.display.enter_number": "请输入数字序号",
     # ==================== package_manager 工具 ====================
     "cli.package.ssl_error": "SSL 验证失败: {error}",
+    "cli.package.uv_venv_failed": "uv venv 失败：{error}",
+    "cli.package.python_venv_failed": "python -m venv 失败：{error}",
+    "cli.package.pyproject_writeback_failed": "pyproject.toml 依赖回写失败：{error}",
     "cli.package.ssl_error_proxy_hint": "  检测到代理，请确保代理配置正确或尝试设置 HTTPS_PROXY 环境变量",
     "cli.package.fetch_remote_failed": "无法获取远程包列表，请检查网络连接或代理设置",
     "cli.package.proxy_detected": "  检测到代理: {proxy}",
@@ -549,4 +552,15 @@ TRANSLATIONS = {
     "cli.types.usage_hint": "在代码中导入类型并作为变量标注，即可获得 IDE 补全：",
     "cli.types.usage_example": "from _ep_types import MyModule  # 然后写 my_mod: MyModule = sdk.module.get('MyModule')",
     "cli.types.introspect_failed": "内省目标环境失败: {error}",
+    "cli.types.stub_title": "ErisPulse 类型存根（自动生成，请勿手动编辑）",
+    "cli.types.stub_intro": "由 `epsdk types` 命令根据已安装的模块/适配器生成。\n仅导出类型供用户代码作为变量标注使用，**不提供任何运行时实例**。\n所有导入都在 ``TYPE_CHECKING`` 下，运行时零开销、零行为改变。",
+    "cli.types.stub_usage_title": "使用方式",
+    "cli.types.stub_usage_comment": "# 用导入的类型标注变量，即可获得 IDE 补全",
+    "cli.types.stub_usage_module_hint": "# ← IDE 能补全 hello",
+    "cli.types.stub_usage_adapter_hint": "# ← 补全平台特有方法",
+    "cli.types.stub_notes_title": "说明",
+    "cli.types.stub_note_naming": "类型名采用 entry-point 名的 PascalCase 形式（如 ``yunhu`` → ``Yunhu``），与传入 ``sdk.adapter.get()`` / ``sdk.module.get()`` 的名称对应",
+    "cli.types.stub_note_static_only": "存根仅用于静态类型检查，不含运行时实现",
+    "cli.types.stub_note_regen": "安装/卸载模块/适配器后请重新生成：``epsdk types``",
+    "cli.types.stub_typing_comment": "以下类型导入仅在 IDE / 类型检查器中生效，不会被运行时执行；用户代码中经 ``from _ep_types import XxxModule`` 获取类型并用于变量标注即可获得补全",
 }

{erispulse-2.9.0.dev2 → erispulse-2.10.0.dev0}/src/ErisPulse/CLI/i18n/locales/zh_tw.py

@@ -426,6 +426,9 @@ TRANSLATIONS = {
     "cli.display.enter_number": "請輸入數字序號",
     # ==================== package_manager 工具 ====================
     "cli.package.ssl_error": "SSL 驗證失敗: {error}",
+    "cli.package.uv_venv_failed": "uv venv 失敗：{error}",
+    "cli.package.python_venv_failed": "python -m venv 失敗：{error}",
+    "cli.package.pyproject_writeback_failed": "pyproject.toml 依賴回寫失敗：{error}",
     "cli.package.ssl_error_proxy_hint": "  偵測到代理，請確保代理設定正確或嘗試設定 HTTPS_PROXY 環境變數",
     "cli.package.fetch_remote_failed": "無法取得遠端包列表，請檢查網路連線或代理設定",
     "cli.package.proxy_detected": "  偵測到代理: {proxy}",
@@ -549,4 +552,15 @@ TRANSLATIONS = {
     "cli.types.usage_hint": "在程式碼中匯入型別並作為變數標注，即可獲得 IDE 補全：",
     "cli.types.usage_example": "from _ep_types import MyModule  # 然後寫 my_mod: MyModule = sdk.module.get('MyModule')",
     "cli.types.introspect_failed": "內省目標環境失敗: {error}",
+    "cli.types.stub_title": "ErisPulse 類型存根（自動產生，請勿手動編輯）",
+    "cli.types.stub_intro": "由 `epsdk types` 命令根據已安裝的模組/適配器產生。\n僅匯出類型供使用者程式碼作為變數標註使用，**不提供任何執行時實例**。\n所有匯入都在 ``TYPE_CHECKING`` 下，執行時零開銷、零行為改變。",
+    "cli.types.stub_usage_title": "使用方式",
+    "cli.types.stub_usage_comment": "# 用匯入的類型標註變數，即可獲得 IDE 補全",
+    "cli.types.stub_usage_module_hint": "# ← IDE 能補全 hello",
+    "cli.types.stub_usage_adapter_hint": "# ← 補全平台特有方法",
+    "cli.types.stub_notes_title": "說明",
+    "cli.types.stub_note_naming": "類型名採用 entry-point 名的 PascalCase 形式（如 ``yunhu`` → ``Yunhu``），與傳入 ``sdk.adapter.get()`` / ``sdk.module.get()`` 的名稱對應",
+    "cli.types.stub_note_static_only": "存根僅用於靜態類型檢查，不含執行時實作",
+    "cli.types.stub_note_regen": "安裝/卸載模組/適配器後請重新產生：``epsdk types``",
+    "cli.types.stub_typing_comment": "以下類型匯入僅在 IDE / 類型檢查器中生效，不會被執行時執行；使用者程式碼中經 ``from _ep_types import XxxModule`` 取得類型並用於變數標註即可獲得補全",
 }

{erispulse-2.9.0.dev2 → erispulse-2.10.0.dev0}/src/ErisPulse/CLI/utils/package_manager.py

@@ -1657,7 +1657,9 @@ def create_project_venv(project_dir: Path) -> "str | None":
             check=False,
         )
         if result.returncode != 0:
-            console.print(f"[warning]  uv venv 失败：{result.stderr.strip()[:200]}[/]")
+            console.print(
+                f"[warning]  {i18n.t('cli.package.uv_venv_failed', error=result.stderr.strip()[:200])}[/]"
+            )
     else:
         result = subprocess.run(
             [sys.executable, "-m", "venv", str(venv_dir)],
@@ -1667,7 +1669,9 @@ def create_project_venv(project_dir: Path) -> "str | None":
             check=False,
         )
         if result.returncode != 0:
-            console.print(f"[warning]  python -m venv 失败：{result.stderr.strip()[:200]}[/]")
+            console.print(
+                f"[warning]  {i18n.t('cli.package.python_venv_failed', error=result.stderr.strip()[:200])}[/]"
+            )
 
     if sys.platform == "win32":
         py = venv_dir / "Scripts" / "python.exe"
@@ -1737,7 +1741,7 @@ def append_pyproject_dependencies(project_dir: Path, packages: "list[str]") -> b
         pyproject.write_text(tomlkit.dumps(doc_kit), encoding="utf-8")
         return True
     except Exception as e:
-        console.print(f"[warning]  pyproject.toml 依赖回写失败：{e}[/]")
+        console.print(f"[warning]  {i18n.t('cli.package.pyproject_writeback_failed', error=e)}[/]")
         return False