ErisPulse 2.8.0.dev0__tar.gz → 2.8.0.dev1__tar.gz

{erispulse-2.8.0.dev0 → 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.8.0.dev0 → erispulse-2.8.0.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ErisPulse
-Version: 2.8.0.dev0
+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.8.0.dev0 → 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.8.0.dev0 → 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.8.0-dev.0"
+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.8.0.dev0 → erispulse-2.8.0.dev1}/src/ErisPulse/CLI/commands/create.py

@@ -58,6 +58,13 @@ 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
@@ -192,6 +199,12 @@ 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: Event):
             await event.reply(i18n.t(\"module.{name}.command.hello.reply\"))
@@ -205,6 +218,11 @@ class Main(BaseModule):
         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: Event):
             self.logger.info((\"{text[module.log.friend_add]}\").format(nickname=event.get_user_nickname()))
@@ -227,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}

{erispulse-2.8.0.dev0 → erispulse-2.8.0.dev1}/src/ErisPulse/CLI/commands/init.py

@@ -44,20 +44,14 @@ class InitCommand(Command):
 
     def add_arguments(self, parser: ArgumentParser):
         parser.add_argument("--project-name", "-n", help=i18n.t("cli.init.name_help"))
-        parser.add_argument(
-            "--quick", "-q", action="store_true", help=i18n.t("cli.init.quick_help")
-        )
-        parser.add_argument(
-            "--force", "-f", action="store_true", help=i18n.t("cli.init.force_help")
-        )
+        parser.add_argument("--quick", "-q", action="store_true", help=i18n.t("cli.init.quick_help"))
+        parser.add_argument("--force", "-f", action="store_true", help=i18n.t("cli.init.force_help"))
         parser.add_argument(
             "--here",
             action="store_true",
             help=i18n.t("cli.init.here_help"),
         )
-        parser.add_argument(
-            "--no-uv", action="store_true", help=i18n.t("cli.init.nouv_help")
-        )
+        parser.add_argument("--no-uv", action="store_true", help=i18n.t("cli.init.nouv_help"))
 
     def execute(self, args):
         self.no_uv = getattr(args, "no_uv", False)
@@ -107,19 +101,13 @@ class InitCommand(Command):
 
             if project_path.exists():
                 if project_path.is_dir():
-                    console.print(
-                        f"[warning]  {i18n.t('cli.init.dir_exists', name=project_name)}[/]"
-                    )
+                    console.print(f"[warning]  {i18n.t('cli.init.dir_exists', name=project_name)}[/]")
                 else:
-                    console.print(
-                        f"[error]  {i18n.t('cli.init.file_exists_not_dir', name=project_name)}[/]"
-                    )
+                    console.print(f"[error]  {i18n.t('cli.init.file_exists_not_dir', name=project_name)}[/]")
                     return False
             else:
                 project_path.mkdir()
-                console.print(
-                    f"[success]  {i18n.t('cli.init.created_dir', name=project_name)}[/]"
-                )
+                console.print(f"[success]  {i18n.t('cli.init.created_dir', name=project_name)}[/]")
 
         try:
             for dir_name in ["config", "logs"]:
@@ -131,8 +119,7 @@ class InitCommand(Command):
                 ssl_file = ssl_dir / ssl_name
                 if not ssl_file.exists():
                     ssl_file.write_text(
-                        "# 将你的证书/密钥 PEM 内容粘贴到本文件，"
-                        "或在配置中改用 ssl_cert/ssl_key 内联填写\n",
+                        "# 将你的证书/密钥 PEM 内容粘贴到本文件，或在配置中改用 ssl_cert/ssl_key 内联填写\n",
                         encoding="utf-8",
                     )
 
@@ -168,29 +155,19 @@ class InitCommand(Command):
                     f.write('if __name__ == "__main__":\n')
                     f.write("    asyncio.run(main())\n")
 
-            console.print(
-                f"[success]  {i18n.t('cli.init.display_success', name=display_name)}[/]"
-            )
+            console.print(f"[success]  {i18n.t('cli.init.display_success', name=display_name)}[/]")
             console.print()
             console.print(Text(i18n.t("cli.create.next_steps"), style="bold"))
             if in_current_dir:
-                console.print(
-                    f"    · {i18n.t('cli.init.edit_config', path='config/config.toml')}"
-                )
+                console.print(f"    · {i18n.t('cli.init.edit_config', path='config/config.toml')}")
                 console.print(f"    · {i18n.t('cli.init.run_direct')}")
             else:
-                console.print(
-                    f"    · {i18n.t('cli.init.edit_config', path=f'{display_name}/config/config.toml')}"
-                )
-                console.print(
-                    f"    · {i18n.t('cli.init.cd_and_run', dir=display_name)}"
-                )
+                console.print(f"    · {i18n.t('cli.init.edit_config', path=f'{display_name}/config/config.toml')}")
+                console.print(f"    · {i18n.t('cli.init.cd_and_run', dir=display_name)}")
             return True
 
         except Exception as e:
-            console.print(
-                f"[error]  {i18n.t('cli.init.init_project_failed', error=e)}[/]"
-            )
+            console.print(f"[error]  {i18n.t('cli.init.init_project_failed', error=e)}[/]")
             return False
 
     @staticmethod
@@ -335,9 +312,7 @@ class InitCommand(Command):
             if adapters:
                 return adapters
         except Exception as e:
-            console.print(
-                f"[warning]  {i18n.t('cli.init.fetch_remote_failed', error=e)}[/]"
-            )
+            console.print(f"[warning]  {i18n.t('cli.init.fetch_remote_failed', error=e)}[/]")
 
         return {
             "yunhu": i18n.t("cli.init.adapter_desc_yunhu"),
@@ -346,9 +321,7 @@ class InitCommand(Command):
             "email": i18n.t("cli.init.adapter_desc_email"),
         }
 
-    def _interactive_init(
-        self, project_name: str | None = None, force: bool = False, here: bool = False
-    ) -> bool:
+    def _interactive_init(self, project_name: str | None = None, force: bool = False, here: bool = False) -> bool:
         """
         交互式初始化项目，引导用户配置项目位置及基本参数
 
@@ -368,9 +341,7 @@ class InitCommand(Command):
                     f"    [bold]2.[/] {i18n.t('cli.init.location_option_new')}     [dim]— {i18n.t('cli.init.location_desc_new')}[/]"
                 )
                 console.print()
-                location_choice = IntPrompt.ask(
-                    i18n.t("cli.create.select_prompt"), default=2, choices=["1", "2"]
-                )
+                location_choice = IntPrompt.ask(i18n.t("cli.create.select_prompt"), default=2, choices=["1", "2"])
                 console.print()
                 in_current_dir = location_choice == 1
 
@@ -423,26 +394,20 @@ class InitCommand(Command):
                 config.setConfig("ErisPulse.logger.level", new_level.upper())
 
             current_host = config.getConfig("ErisPulse.server.host", "0.0.0.0")
-            console.print(
-                f"  {i18n.t('cli.init.listen_host')} [dim]({current_host})[/]"
-            )
+            console.print(f"  {i18n.t('cli.init.listen_host')} [dim]({current_host})[/]")
             new_host = _input(">")
             if new_host:
                 config.setConfig("ErisPulse.server.host", new_host)
 
             current_port = str(config.getConfig("ErisPulse.server.port", 8000))
-            console.print(
-                f"  {i18n.t('cli.init.listen_port')} [dim]({current_port})[/]"
-            )
+            console.print(f"  {i18n.t('cli.init.listen_port')} [dim]({current_port})[/]")
             new_port = _input(">")
             while new_port:
                 try:
                     config.setConfig("ErisPulse.server.port", int(new_port))
                     break
                 except ValueError:
-                    console.print(
-                        f"[warning]  {i18n.t('cli.init.invalid_port', port=new_port)}[/]"
-                    )
+                    console.print(f"[warning]  {i18n.t('cli.init.invalid_port', port=new_port)}[/]")
                     new_port = _input(">")
 
             if Confirm.ask(
@@ -466,19 +431,13 @@ class InitCommand(Command):
         """
         from ErisPulse import config
 
-        with console.status(
-            f"[bold green]{i18n.t('cli.init.fetching_adapters')}...", spinner="dots"
-        ):
+        with console.status(f"[bold green]{i18n.t('cli.init.fetching_adapters')}...", spinner="dots"):
             try:
                 with concurrent.futures.ThreadPoolExecutor() as executor:
-                    future = executor.submit(
-                        asyncio.run, self._fetch_available_adapters()
-                    )
+                    future = executor.submit(asyncio.run, self._fetch_available_adapters())
                     adapters = future.result(timeout=10)
             except Exception as e:
-                console.print(
-                    f"[error]  {i18n.t('cli.init.fetch_adapters_failed', error=e)}[/]"
-                )
+                console.print(f"[error]  {i18n.t('cli.init.fetch_adapters_failed', error=e)}[/]")
                 return
 
         if not adapters:
@@ -510,30 +469,30 @@ class InitCommand(Command):
                 enabled.append(name)
                 config.setConfig(f"ErisPulse.adapters.status.{name}", True)
             else:
-                console.print(
-                    f"[warning]  {i18n.t('cli.init.invalid_index', idx=idx)}[/]"
-                )
+                console.print(f"[warning]  {i18n.t('cli.init.invalid_index', idx=idx)}[/]")
 
         for name, _ in adapter_list:
             if name not in enabled:
                 config.setConfig(f"ErisPulse.adapters.status.{name}", False)
 
-        console.print(
-            f"[dim]  {i18n.t('cli.init.adapters_enabled', count=len(enabled))}[/]"
-        )
+        console.print(f"[dim]  {i18n.t('cli.init.adapters_enabled', count=len(enabled))}[/]")
 
-        if enabled and Confirm.ask(
-            f"  [cyan]{i18n.t('cli.init.install_selected_prompt')}[/]", default=True
-        ):
+        if enabled and Confirm.ask(f"  [cyan]{i18n.t('cli.init.install_selected_prompt')}[/]", default=True):
             self._install_adapters(enabled, adapters)
 
     def _install_adapters(self, adapter_names, adapters_info):
         """
         安装选中的适配器
 
+        安装成功后衔接交互式配置向导（写入新项目的 config.toml）
+
         :param adapter_names: [list] 适配器简称列表
         :param adapters_info: [dict] 适配器信息
         """
+        from ErisPulse import config
+
+        from ..utils import config_wizard
+
         pkg_manager = PackageManager()
         pkg_manager.no_uv = getattr(self, "no_uv", False)
         for adapter_name in adapter_names:
@@ -542,14 +501,10 @@ class InitCommand(Command):
                 remote_packages = pkg_manager._cache.get("remote_packages", {})
                 if not remote_packages:
                     with concurrent.futures.ThreadPoolExecutor() as executor:
-                        future = executor.submit(
-                            asyncio.run, pkg_manager.get_remote_packages()
-                        )
+                        future = executor.submit(asyncio.run, pkg_manager.get_remote_packages())
                         remote_packages = future.result(timeout=10)
                 if adapter_name in remote_packages.get("adapters", {}):
-                    package_name = remote_packages["adapters"][adapter_name].get(
-                        "package"
-                    )
+                    package_name = remote_packages["adapters"][adapter_name].get("package")
             except Exception:
                 pass
 
@@ -562,6 +517,10 @@ class InitCommand(Command):
             success = pkg_manager.install_package([package_name])
 
             if not success:
-                console.print(
-                    f"[error]  {i18n.t('cli.init.adapter_install_failed', name=adapter_name)}[/]"
-                )
+                console.print(f"[error]  {i18n.t('cli.init.adapter_install_failed', name=adapter_name)}[/]")
+            elif config_wizard.is_interactive():
+                # 安装成功后衔接配置向导，写入已重定向到新项目的 config.toml
+                try:
+                    config_wizard.post_install_configure([package_name], config)
+                except Exception as e:
+                    console.print(f"[warning]  {i18n.t('cli.config.post_install_failed', error=e)}[/]")