ErisPulse 2.7.0.dev5__tar.gz → 2.7.1__tar.gz

{erispulse-2.7.0.dev5 → erispulse-2.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: ErisPulse
-Version: 2.7.0.dev5
+Version: 2.7.1
 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

{erispulse-2.7.0.dev5 → erispulse-2.7.1}/pyproject.toml

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

{erispulse-2.7.0.dev5 → erispulse-2.7.1}/src/ErisPulse/CLI/commands/create.py

@@ -462,33 +462,50 @@ class {converter_name}(BaseConverter):
         return None
 """
 
-_README_MODULE = """# {name}
+_README_MODULE = """<div align="center">
 
-{description}
+<img src="https://raw.githubusercontent.com/ErisPulse/ErisPulse/main/.github/assets/ErisPulseLogo.png" width="180" alt="{name}" />
+
+# {name}
+
+**{description}**
+
+<p>
+  <a href="https://pypi.org/project/ErisPulse-{name}/"><img src="https://img.shields.io/pypi/v/ErisPulse-{name}?style=for-the-badge&logo=pypi&logoColor=white" alt="PyPI"></a>
+  <a href="https://pypi.org/project/ErisPulse-{name}/"><img src="https://img.shields.io/badge/Python-3.10+-FFD43B?style=for-the-badge&logo=python&logoColor=blue" alt="Python"></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue?style=for-the-badge" alt="License"></a>
+  <a href="https://github.com/ErisPulse/ErisPulse"><img src="https://img.shields.io/badge/Powered_by-ErisPulse-FF6B9D?style=for-the-badge&logo=bookstack&logoColor=white" alt="ErisPulse"></a>
+</p>
+
+</div>
+
+---
 
 ## 安装
 
 ```bash
 epsdk install ErisPulse-{name}
 ```
+"""
 
-## 使用
+_README_ADAPTER = """<div align="center">
 
-模块会自动加载，你也可以通过 `sdk.{name}` 访问模块实例。
+<img src="https://raw.githubusercontent.com/ErisPulse/ErisPulse/main/.github/assets/ErisPulseLogo.png" width="180" alt="{name}" />
 
-## 配置
+# {name}
 
-在 `config.toml` 中添加:
+**{description}**
 
-```toml
-[{name}]
-enabled = true
-```
-"""
+<p>
+  <a href="https://pypi.org/project/ErisPulse-{name}/"><img src="https://img.shields.io/pypi/v/ErisPulse-{name}?style=for-the-badge&logo=pypi&logoColor=white" alt="PyPI"></a>
+  <a href="https://pypi.org/project/ErisPulse-{name}/"><img src="https://img.shields.io/badge/Python-3.10+-FFD43B?style=for-the-badge&logo=python&logoColor=blue" alt="Python"></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue?style=for-the-badge" alt="License"></a>
+  <a href="https://github.com/ErisPulse/ErisPulse"><img src="https://img.shields.io/badge/Powered_by-ErisPulse-FF6B9D?style=for-the-badge&logo=bookstack&logoColor=white" alt="ErisPulse"></a>
+</p>
 
-_README_ADAPTER = """# {name}
+</div>
 
-{description}
+---
 
 ## 安装
 
@@ -561,6 +578,22 @@ def _validate_name(name: str) -> bool:
     return all(c.isalnum() or c == "_" for c in name)
 
 
+def _copy_erispulse_logo(project_dir: Path) -> None:
+    """
+    将 ErisPulseLogo.png 拷贝到项目的 .github/assets/ 目录
+
+    :param project_dir: [Path] 项目根目录
+    """
+    import shutil
+
+    logo_src = Path(__file__).parent.parent / "assets" / "ErisPulseLogo.png"
+    if not logo_src.exists():
+        return
+    dest = project_dir / ".github" / "assets" / "ErisPulseLogo.png"
+    dest.parent.mkdir(parents=True, exist_ok=True)
+    shutil.copy2(logo_src, dest)
+
+
 def _scaffold_text(name: str) -> dict:
     """
     构建当前语言的脚手架文案映射，并预填充 {name} 占位符

{erispulse-2.7.0.dev5 → erispulse-2.7.1}/src/ErisPulse/CLI/commands/doctor.py

@@ -43,13 +43,14 @@ class DoctorCommand(Command):
 
     def execute(self, args):
         pm = self.package_manager
-        rows: list[tuple[str, str]] = []
+        rows: list[tuple[str, str, str]] = []
         failed = False
 
         # 1. Python 解释器
         py_ok = sys.version_info >= (3, 10)
         rows.append(
             (
+                self._status(py_ok),
                 i18n.t("cli.doctor.python"),
                 f"{platform.python_version()} ({sys.executable})",
             )
@@ -60,27 +61,43 @@ class DoctorCommand(Command):
         # 2. 安装后端（uv / pip）
         uv_cmd = pm._get_uv_command()
         if uv_cmd:
-            rows.append((i18n.t("cli.doctor.backend"), f"uv ({uv_cmd[0]})"))
+            rows.append(
+                (self._status(True), i18n.t("cli.doctor.backend"), f"uv ({uv_cmd[0]})")
+            )
         else:
-            rows.append((i18n.t("cli.doctor.backend"), i18n.t("cli.doctor.backend_pip")))
+            rows.append(
+                (
+                    self._status(True),
+                    i18n.t("cli.doctor.backend"),
+                    i18n.t("cli.doctor.backend_pip"),
+                )
+            )
 
         # 3. 目标解释器（安装目标环境）
         target_python = pm._get_target_python()
-        rows.append((i18n.t("cli.doctor.target_python"), target_python))
+        rows.append(
+            (self._status(True), i18n.t("cli.doctor.target_python"), target_python)
+        )
 
         # 4. 配置文件
         config_path = Path("config") / "config.toml"
         if config_path.exists():
             rows.append(
-                (i18n.t("cli.doctor.config"), str(config_path.resolve()))
+                (
+                    self._status(True),
+                    i18n.t("cli.doctor.config"),
+                    str(config_path.resolve()),
+                )
             )
         else:
             rows.append(
                 (
+                    self._status(False),
                     i18n.t("cli.doctor.config"),
                     f"{i18n.t('cli.doctor.config_missing')} ({config_path})",
                 )
             )
+            failed = True
 
         # 5. PyPI 连通性
         try:
@@ -90,21 +107,40 @@ class DoctorCommand(Command):
             )
             rows.append(
                 (
+                    self._status(True),
                     i18n.t("cli.doctor.pypi"),
                     i18n.t("cli.doctor.pypi_ok", count=pkg_count),
                 )
             )
         except Exception:
             failed = True
-            rows.append((i18n.t("cli.doctor.pypi"), i18n.t("cli.doctor.pypi_fail")))
+            rows.append(
+                (
+                    self._status(False),
+                    i18n.t("cli.doctor.pypi"),
+                    i18n.t("cli.doctor.pypi_fail"),
+                )
+            )
 
         # 6. 代理
         proxy = pm._get_system_proxy()
         if proxy:
             https_proxy = proxy.get("https") or proxy.get("http", "")
-            rows.append((i18n.t("cli.doctor.proxy"), https_proxy))
+            rows.append(
+                (
+                    self._status(True),
+                    i18n.t("cli.doctor.proxy"),
+                    https_proxy,
+                )
+            )
         else:
-            rows.append((i18n.t("cli.doctor.proxy"), i18n.t("cli.doctor.proxy_none")))
+            rows.append(
+                (
+                    self._status(True),
+                    i18n.t("cli.doctor.proxy"),
+                    i18n.t("cli.doctor.proxy_none"),
+                )
+            )
 
         # 输出诊断报告
         table = Table(
@@ -113,15 +149,36 @@ class DoctorCommand(Command):
             pad_edge=False,
             expand=True,
         )
-        for label, detail in rows:
-            table.add_row(f"[info]{label}[/]", detail)
+        for status, label, detail in rows:
+            table.add_row(status, f"[info]{label}[/]", detail)
 
         console.print(table)
 
         if failed:
             console.print(f"[error]{i18n.t('cli.doctor.failed')}[/]")
+            for status, label, _ in rows:
+                if status != self._status(True):
+                    console.print(
+                        f"  [error]-[/] [info]{label}[/]"
+                    )
         else:
             console.print(f"[success]{i18n.t('cli.doctor.all_ok')}[/]")
 
+    @staticmethod
+    def _status(ok: bool) -> str:
+        """
+        生成诊断项的状态标记文本（OK / FAIL，不使用 emoji）
+
+        :param ok: bool 诊断项是否正常
+        :return: str 带样式的状态标记文本
+        """
+        from ..i18n import i18n
+
+        return (
+            f"[success]{i18n.t('cli.doctor.status_ok')}[/]"
+            if ok
+            else f"[error]{i18n.t('cli.doctor.status_fail')}[/]"
+        )
+
 
 __all__ = ["DoctorCommand"]

{erispulse-2.7.0.dev5 → erispulse-2.7.1}/src/ErisPulse/CLI/commands/list.py

@@ -121,6 +121,7 @@ class ListCommand(Command):
                 self._print_package_scripts(installed["modules"])
             else:
                 console.print(f"[dim]  {i18n.t('cli.list.no_modules')}[/]")
+                console.print(f"[dim]  {i18n.t('cli.list.empty_hint')}[/]")
 
         elif pkg_type == "adapters" and installed["adapters"]:
             table = Table(
@@ -154,11 +155,13 @@ class ListCommand(Command):
                 )
             else:
                 console.print(f"[dim]  {i18n.t('cli.list.no_adapters')}[/]")
+                console.print(f"[dim]  {i18n.t('cli.list.empty_hint')}[/]")
 
         elif not installed.get(pkg_type, {}):
             console.print(
                 f"[dim]  {i18n.t('cli.list.no_packages', pkg_type=pkg_type)}[/]"
             )
+            console.print(f"[dim]  {i18n.t('cli.list.empty_hint')}[/]")
 
     def _is_package_outdated(
         self,

{erispulse-2.7.0.dev5 → erispulse-2.7.1}/src/ErisPulse/CLI/commands/run.py

@@ -183,6 +183,7 @@ class RunCommand(Command):
         ]
 
         crash_count = 0
+        process = None
         try:
             while True:
                 process = subprocess.Popen(cmd)
@@ -208,6 +209,17 @@ class RunCommand(Command):
                 # 继续循环，重新启动子进程
         except KeyboardInterrupt:
             pass
+        finally:
+            # 运行器退出（Ctrl+C 等）前必须终止子进程，否则孤儿进程会继续持有
+            # 端口等资源，导致下次启动时端口被占用（如监听 8000 的残留进程）。
+            if process is not None and process.poll() is None:
+                console.print(f"[info]{i18n.t('cli.run.terminating_child')}[/]")
+                process.terminate()
+                try:
+                    process.wait(timeout=5)
+                except subprocess.TimeoutExpired:
+                    process.kill()
+                    process.wait()
 
     def _run_script(self, script_path: str, reload_mode: bool):
         """

{erispulse-2.7.0.dev5 → erispulse-2.7.1}/src/ErisPulse/CLI/i18n/locales/en.py

@@ -205,6 +205,7 @@ TRANSLATIONS = {
     "cli.list.count_adapters": "{count} adapter(s)",
     "cli.list.no_adapters": "No matching adapters",
     "cli.list.no_packages": "No {pkg_type}",
+    "cli.list.empty_hint": "Run 'epsdk install' to browse and install components, or 'epsdk init' to create a project",
     # ==================== list-remote command ====================
     "cli.list_remote.description": "List remote available components",
     "cli.list_remote.type_help": "List type (default: all)",
@@ -276,6 +277,7 @@ TRANSLATIONS = {
     "cli.run.process_exited": "Process exited normally, waiting for file changes to restart",
     "cli.run.process_crashed": "Process crashed (exit code {code}), fix and save to restart",
     "cli.run.subprocess_crashed_retry": "Subprocess crashed, will auto-retry in {seconds}s...",
+    "cli.run.terminating_child": "Terminating the bot subprocess to release ports and resources...",
     # ==================== uninstall command ====================
     "cli.uninstall.description": "Uninstall module/adapter packages",
     "cli.uninstall.package_help": "Package name(s) to uninstall (multiple allowed)",
@@ -416,6 +418,8 @@ TRANSLATIONS = {
     "cli.doctor.proxy_none": "none detected",
     "cli.doctor.failed": "[done] Issues found, see output above",
     "cli.doctor.all_ok": "[done] Environment is healthy",
+    "cli.doctor.status_ok": "OK",
+    "cli.doctor.status_fail": "FAIL",
     # ==================== types command ====================
     "cli.types.description": "Generate type stub file to enable IDE completion",
     "cli.types.output_help": "Output file path (default: ./_ep_types.py)",

{erispulse-2.7.0.dev5 → erispulse-2.7.1}/src/ErisPulse/CLI/i18n/locales/ja.py

@@ -205,6 +205,7 @@ TRANSLATIONS = {
     "cli.list.count_adapters": "{count} 個のアダプター",
     "cli.list.no_adapters": "該当するアダプターはありません",
     "cli.list.no_packages": "{pkg_type} はありません",
+    "cli.list.empty_hint": "'epsdk install' でコンポーネントを閲覧・インストールするか、'epsdk init' でプロジェクトを作成できます",
     # ==================== list-remote コマンド ====================
     "cli.list_remote.description": "リモートで利用可能なコンポーネントを一覧表示",
     "cli.list_remote.type_help": "一覧タイプ (デフォルト: all)",
@@ -276,6 +277,7 @@ TRANSLATIONS = {
     "cli.run.process_exited": "プロセスが正常に終了しました。ファイルの変更を待機して再起動",
     "cli.run.process_crashed": "プロセスが異常終了しました（終了コード {code}）。修正して保存すると自動再起動",
     "cli.run.subprocess_crashed_retry": "サブプロセスが異常終了しました。{seconds} 秒後に自動再試行します...",
+    "cli.run.terminating_child": "ポートなどのリソースを解放するため、ボットの子プロセスを終了しています...",
     # ==================== uninstall コマンド ====================
     "cli.uninstall.description": "モジュール/アダプターパッケージをアンインストール",
     "cli.uninstall.package_help": "アンインストールするパッケージ名（複数指定可）",
@@ -416,6 +418,8 @@ TRANSLATIONS = {
     "cli.doctor.proxy_none": "検出されません",
     "cli.doctor.failed": "[完了] 対応が必要な問題があります。上記を確認してください",
     "cli.doctor.all_ok": "[完了] 環境は正常です",
+    "cli.doctor.status_ok": "OK",
+    "cli.doctor.status_fail": "NG",
     # ==================== types コマンド ====================
     "cli.types.description": "型スタブファイルを生成して IDE 補完を有効化",
     "cli.types.output_help": "出力ファイルパス（デフォルト: ./_ep_types.py）",

{erispulse-2.7.0.dev5 → erispulse-2.7.1}/src/ErisPulse/CLI/i18n/locales/ru.py

@@ -205,6 +205,7 @@ TRANSLATIONS = {
     "cli.list.count_adapters": "{count} адаптера(ов)",
     "cli.list.no_adapters": "Нет подходящих адаптеров",
     "cli.list.no_packages": "Нет {pkg_type}",
+    "cli.list.empty_hint": "Выполните 'epsdk install' для просмотра и установки компонентов, или 'epsdk init' для создания проекта",
     # ==================== команда list-remote ====================
     "cli.list_remote.description": "Список удаленно доступных компонентов",
     "cli.list_remote.type_help": "Тип списка (по умолчанию: all)",
@@ -276,6 +277,7 @@ TRANSLATIONS = {
     "cli.run.process_exited": "Процесс завершен нормально, ожидание изменений файлов для перезапуска",
     "cli.run.process_crashed": "Процесс аварийно завершен (код {code}), исправьте и сохраните для перезапуска",
     "cli.run.subprocess_crashed_retry": "Подпроцесс аварийно завершен, автоматическая перезагрузка через {seconds}с...",
+    "cli.run.terminating_child": "Завершение дочернего процесса бота для освобождения портов и ресурсов...",
     # ==================== команда uninstall ====================
     "cli.uninstall.description": "Удалить пакеты модулей/адаптеров",
     "cli.uninstall.package_help": "Имя(ена) пакета(ов) для удаления (можно указать несколько)",
@@ -416,6 +418,8 @@ TRANSLATIONS = {
     "cli.doctor.proxy_none": "не обнаружен",
     "cli.doctor.failed": "[готово] Есть проблемы, см. вывод выше",
     "cli.doctor.all_ok": "[готово] Окружение в порядке",
+    "cli.doctor.status_ok": "OK",
+    "cli.doctor.status_fail": "FAIL",
     # ==================== команда types ====================
     "cli.types.description": "Сгенерировать файл заглушек типов для автодополнения IDE",
     "cli.types.output_help": "Путь вывода (по умолчанию: ./_ep_types.py)",

{erispulse-2.7.0.dev5 → erispulse-2.7.1}/src/ErisPulse/CLI/i18n/locales/zh_cn.py

@@ -205,6 +205,7 @@ TRANSLATIONS = {
     "cli.list.count_adapters": "{count} 个适配器",
     "cli.list.no_adapters": "没有符合条件的适配器",
     "cli.list.no_packages": "没有{pkg_type}",
+    "cli.list.empty_hint": "可运行 'epsdk install' 浏览并安装组件，或运行 'epsdk init' 创建项目",
     # ==================== list-remote 命令 ====================
     "cli.list_remote.description": "列出远程可用的组件",
     "cli.list_remote.type_help": "列出类型 (默认: all)",
@@ -276,6 +277,7 @@ TRANSLATIONS = {
     "cli.run.process_exited": "进程已正常退出，等待文件变更后重启",
     "cli.run.process_crashed": "进程异常退出（退出码 {code}），修复后保存文件将自动重启",
     "cli.run.subprocess_crashed_retry": "子进程异常终止，将在 {seconds} 秒后自动重试...",
+    "cli.run.terminating_child": "正在终止机器人子进程，释放端口等资源...",
     # ==================== uninstall 命令 ====================
     "cli.uninstall.description": "卸载模块/适配器包",
     "cli.uninstall.package_help": "要卸载的包名（可指定多个）",
@@ -416,6 +418,8 @@ TRANSLATIONS = {
     "cli.doctor.proxy_none": "未检测到",
     "cli.doctor.failed": "[诊断完成] 存在需要处理的问题，请参考上方输出",
     "cli.doctor.all_ok": "[诊断完成] 环境正常",
+    "cli.doctor.status_ok": "正常",
+    "cli.doctor.status_fail": "异常",
     # ==================== types 命令 ====================
     "cli.types.description": "生成类型存根文件，启用 IDE 补全",
     "cli.types.output_help": "输出文件路径（默认: ./_ep_types.py）",

{erispulse-2.7.0.dev5 → erispulse-2.7.1}/src/ErisPulse/CLI/i18n/locales/zh_tw.py

@@ -205,6 +205,7 @@ TRANSLATIONS = {
     "cli.list.count_adapters": "{count} 個適配器",
     "cli.list.no_adapters": "沒有符合條件的適配器",
     "cli.list.no_packages": "沒有{pkg_type}",
+    "cli.list.empty_hint": "可執行 'epsdk install' 瀏覽並安裝元件，或執行 'epsdk init' 建立專案",
     # ==================== list-remote 命令 ====================
     "cli.list_remote.description": "列出遠端可用的元件",
     "cli.list_remote.type_help": "列出型別 (預設: all)",
@@ -276,6 +277,7 @@ TRANSLATIONS = {
     "cli.run.process_exited": "程式已正常退出，等待檔案變更後重啟",
     "cli.run.process_crashed": "程式異常退出（退出碼 {code}），修復後儲存檔案將自動重啟",
     "cli.run.subprocess_crashed_retry": "子程序異常終止，將在 {seconds} 秒後自動重試...",
+    "cli.run.terminating_child": "正在終止機器人子程序，釋放連接埠等資源...",
     # ==================== uninstall 命令 ====================
     "cli.uninstall.description": "解除安裝模組/適配器包",
     "cli.uninstall.package_help": "要解除安裝的包名（可指定多個）",
@@ -416,6 +418,8 @@ TRANSLATIONS = {
     "cli.doctor.proxy_none": "未偵測到",
     "cli.doctor.failed": "[診斷完成] 存在需要處理的問題，請參考上方輸出",
     "cli.doctor.all_ok": "[診斷完成] 環境正常",
+    "cli.doctor.status_ok": "正常",
+    "cli.doctor.status_fail": "異常",
     # ==================== types 命令 ====================
     "cli.types.description": "生成類型存根檔案，啟用 IDE 補全",
     "cli.types.output_help": "輸出檔案路徑（預設: ./_ep_types.py）",

{erispulse-2.7.0.dev5 → erispulse-2.7.1}/src/ErisPulse/CLI/utils/display.py

@@ -9,6 +9,7 @@ from collections.abc import Callable
 from typing import Any
 
 from rich.box import SIMPLE
+from rich.markup import escape
 from rich.prompt import Prompt
 from rich.table import Table
 from rich.text import Text
@@ -45,7 +46,9 @@ def _input(prompt_label: str = ">") -> str:
     :param prompt_label: [str] 提示标签 (默认: ">")
     :return: [str] 用户输入内容（已去除首尾空白）
     """
-    console.print(f"  [dim]{prompt_label}[/] ", end="")
+    # 转义富文本标记
+    escaped = escape(prompt_label)
+    console.print(f"  [dim]{escaped}[/] ", end="")
     try:
         return input().strip()
     except (EOFError, KeyboardInterrupt):