pytest-testkit 1.0.1__tar.gz → 1.0.2__tar.gz

{pytest_testkit-1.0.1/pytest_testkit.egg-info → pytest_testkit-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pytest_testkit
-Version: 1.0.1
+Version: 1.0.2
 Summary: Pytest plugin for Infra logging framework and environment management
 Author: Huawei
 License: MIT License
@@ -43,7 +43,7 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.6
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: pytest==8.3.2
+Requires-Dist: pytest>=8.3.2
 Requires-Dist: requests
 Requires-Dist: paramiko
 Requires-Dist: xlrd>=2.0.0
@@ -135,7 +135,7 @@ from pytest_testkit.lib.common.log import logger
 使用 logger 记录日志：
 
 ```python
-logger.info(f"[Device._login] Successfully connected to device")
+logger.info("Successfully connected to device")
 ```
 
 #### 日志目录结构
@@ -152,12 +152,28 @@ logs/
 
 **目录结构说明**：
 - **TestCases**: 测试用例日志根目录
-- **日期目录**: 按执行日期组织（格式：`YYYY-MM-DD`）
-- **用例子目录**: 按用例名和执行时间命名（格式：`用例名_HH-MM-SS`）
+- **日期目录**: 按执行日期组织（格式：`YYYY-MM-DD`，使用本机时区）
+- **用例子目录**: 按用例名和执行时间命名（格式：`用例名_HH-MM-SS`，使用本机时区）
 - **HTML 文件**: 插件生成的测试报告，文件名与用例名一致
 
 通过 `logger.path` 属性可以获取当前用例的日志归档目录路径，方便在测试用例中创建自定义文件。
 
+#### HTML 报告渲染
+
+测试用例的 HTML 日志报告支持以下渲染特性：
+
+- **op_type 标签**: 命令与连接日志通过 `logging` 的 `extra={"op_type": ...}` 标记操作类型，HTML 报告 Location 列显示该标签（未标记记录回退为 `文件名:行号`）。内置标签包括：
+  - `sendcmd[<设备短名>]`: 发送命令，消息带最近 shell 提示符前缀（如 `root@host:~#ls -la`），设置 `cwd` 时追加 `(cwd: ...)`
+  - `recvcmd[<设备短名>]`: 命令文本回显（stdout+stderr 合并，不打印 dict），末尾带最新提示符；无输出时显示 `(empty)`
+  - `login[<设备短名>]` / `loginresult[<设备短名>]`: 登录开始与结果（登录失败为 ERROR 级别）
+  - `loginecho[<设备短名>]`: 登录 banner（交互 channel 首次创建时吸收，在第一条 sendcmd 之前打印）
+  - `disconnect[<设备短名>]`: 连接关闭
+  - `<设备短名>` 取设备名最后一段（按 `-` 或 `/` 分割），如 `rack1/node_3` → `node_3`
+- **ANSI 颜色渲染**: 报告自动把 ANSI 前景色码（30-37、90-97）转换为带颜色的 `<span>` 标签。例如命令日志中的蓝色码（`\x1b[34m`）渲染为蓝色（`#2196F3`）
+- **错误词高亮**: `recvcmd` 回显中的常见错误词（error、failed、fatal、panic、traceback、timeout、"No such file or directory" 等）会以粗体红色显示，便于快速定位失败。命令行（sendcmd）与普通日志不高亮，避免误伤命令本身
+- **列宽调整**: Level 列 70px、Thread 列 50px、Location 列 128px，Message 列获得更多空间
+- **本地时间**: 会话目录、日期目录、用例子目录均使用本机时区时间，与报告表内日志时间戳一致
+
 日志级别：
 
 | 级别 | 值 | 方法                      | 说明 |
@@ -411,9 +427,9 @@ def test_environment(logger):
 
 ### quiet_stdout 功能
 
-pytest-testkit 插件支持全局静默 `sendcmd` / `sendcmd_interactive` 的 stdout 输出，避免大量回显淹没日志。
-**开启后，stdout 内容不会出现在日志中，即使调用方显式传 `echo_output=True` 也会被全局压制。**
-exit_code、prompt、stderr 等信息不受影响。
+pytest-testkit 插件支持全局静默 `sendcmd` / `sendcmd_oneshot` / `sendcmd_interactive` 的命令与回显日志，避免大量回显淹没日志。
+**开启后，sendcmd / recvcmd 日志都不会打印，即使调用方显式传 `echo_output=True` 也会被全局压制。**
+命令返回值（stdout / stderr / exit_code 等）不受影响，仅影响日志输出。
 
 **支持CLI 参数 和 ini 配置，默认为禁用**
 
@@ -528,23 +544,27 @@ def test_use_ci_metadata():
 
 - **environment/environments**: 提供单设备/多设备对象
 
-  - **sendcmd(cmd, timeout=None, env_vars=None, cwd=None, ignore_err=False, only_stdout=True)**：执行命令(非交互式)
+  - **sendcmd(cmd, timeout=None, env_vars=None, cwd=None, ignore_err=False, only_stdout=True, echo_output=True)**：在持久化交互 shell channel 上执行命令
     - `cmd`: 要执行的命令字符串
-    - `timeout`: 命令执行超时时间（秒）
-    - `env_vars`: 环境变量字典
+    - `timeout`: 命令执行超时时间（秒），支持 int 或 str，默认 600s
+    - `env_vars`: 环境变量字典，内联为单命令前缀（`VAR=value cmd`），仅对本次命令生效，不污染持久化 shell
     - `cwd`: 工作目录，命令将在该目录下执行（可选）
     - `ignore_err`: 是否忽略命令执行错误，默认 False。设为 True 时即使命令失败 success 也为 True
     - `only_stdout`: 为 True 时只返回 stdout 字符串，为 False 时返回完整字典
+    - `echo_output`: 是否打印 sendcmd/recvcmd 日志，默认 True
+    - 行为说明: 同一线程内 shell 状态（`cd`、`export`）跨调用持久化；PTY 合并 stderr 到 stdout，返回 dict 的 `stderr` 通常为空；退出码通过 `$?` 哨兵尽力捕获。需要独立进程执行时请用 `sendcmd_oneshot`
     - 返回值: 默认返回 stdout 字符串；当 `only_stdout=False` 时返回 `{'success': bool, 'stdout': str, 'stderr': str}`
 
-  - **sendcmd_interactive(cmd, expect_prompt=None, timeout=600, cwd=None, ignore_err=False, only_stdout=True)**：执行命令(交互式)
-    - `cmd`: 要执行的命令字符串
-    - `expect_prompt`: 期望匹配的提示符正则表达式（可选）
-    - `timeout`: 命令执行超时时间（秒）。默认值600s
-    - `cwd`: 工作目录，命令将在该目录下执行（可选）
-    - `ignore_err`: 是否忽略提示符匹配失败，默认 False。设为 True 时即使未匹配到提示符 success 也为 True
-    - `only_stdout`: 为 True 时只返回 stdout 字符串，为 False 时返回完整字典
-    - 返回值: 默认返回 stdout 字符串；当 `only_stdout=False` 时返回 `{'success': bool, 'stdout': str, 'stderr': str}`
+  - **sendcmd_oneshot(cmd, timeout=None, env_vars=None, cwd=None, ignore_err=False, only_stdout=True, echo_output=True)**：独立进程执行命令（原 sendcmd 行为）
+    - 每次调用启动独立的 `exec_command` / `subprocess.run` 进程，无持久 shell 状态，与交互 channel 互相独立
+    - SSH 路径: 以 `bash -l -c` 包装执行，原生环境变量支持，退出码为 channel 权威退出状态，stderr 为独立流
+    - `local_exec` 路径: 通过 `subprocess.run` 执行
+    - 参数与返回值与 `sendcmd` 一致（`env_vars` 通过原生环境注入而非内联前缀）
+
+  - **sendcmd_interactive(cmd, expect_prompt=None, timeout=600, cwd=None, ignore_err=False, only_stdout=True)**：等同于 `sendcmd`（保留向后兼容）
+    - 现直接代理给 `sendcmd`，在持久化交互 shell channel 上执行
+    - `expect_prompt`: 保留签名兼容但不再生效（被忽略）
+    - 参数与返回值与 `sendcmd` 一致
     - **输出清理**: 返回的 stdout 会自动清理以下内容，便于用户直接使用：
       - CSI 控制序列（如 `\x1b[32m` 颜色代码、`\x1b[?2004h` bracketed paste mode 等）
       - OSC 控制序列（如 `\x1b]0;title\x07` 窗口标题设置等）
@@ -608,8 +628,10 @@ def test_use_ci_metadata():
 - **DockerProxy 容器代理对象**：通过 `environment["container_name"]` 获取
   - 代理对象提供与 Device 一致的接口，自动包装 `docker exec` 命令
 
-  - **sendcmd(cmd, timeout=None, ignore_err=False, only_stdout=True)**：非交互式命令
-    - 每次独立执行 `docker exec {docker_name} {cmd}`
+  - **sendcmd(cmd, timeout=None, ignore_err=False, only_stdout=True)**：非交互式命令（docker session 感知）
+    - 已在该容器交互式 session 中: 直接在当前 session 执行命令
+    - 其他容器持有交互式 session: 直接返回失败（提示"请退出上一个交互对话"）
+    - 否则: 包装为 `docker exec {docker_name} {cmd}` 执行（不创建持久 session）
     - 返回值: stdout 字符串或完整字典
 
   - **sendcmd_interactive(cmd, expect_prompt=None, timeout=600, cwd=None, ignore_err=False, only_stdout=True)**：交互式命令

{pytest_testkit-1.0.1 → pytest_testkit-1.0.2}/README.md

@@ -77,7 +77,7 @@ from pytest_testkit.lib.common.log import logger
 使用 logger 记录日志：
 
 ```python
-logger.info(f"[Device._login] Successfully connected to device")
+logger.info("Successfully connected to device")
 ```
 
 #### 日志目录结构
@@ -94,12 +94,28 @@ logs/
 
 **目录结构说明**：
 - **TestCases**: 测试用例日志根目录
-- **日期目录**: 按执行日期组织（格式：`YYYY-MM-DD`）
-- **用例子目录**: 按用例名和执行时间命名（格式：`用例名_HH-MM-SS`）
+- **日期目录**: 按执行日期组织（格式：`YYYY-MM-DD`，使用本机时区）
+- **用例子目录**: 按用例名和执行时间命名（格式：`用例名_HH-MM-SS`，使用本机时区）
 - **HTML 文件**: 插件生成的测试报告，文件名与用例名一致
 
 通过 `logger.path` 属性可以获取当前用例的日志归档目录路径，方便在测试用例中创建自定义文件。
 
+#### HTML 报告渲染
+
+测试用例的 HTML 日志报告支持以下渲染特性：
+
+- **op_type 标签**: 命令与连接日志通过 `logging` 的 `extra={"op_type": ...}` 标记操作类型，HTML 报告 Location 列显示该标签（未标记记录回退为 `文件名:行号`）。内置标签包括：
+  - `sendcmd[<设备短名>]`: 发送命令，消息带最近 shell 提示符前缀（如 `root@host:~#ls -la`），设置 `cwd` 时追加 `(cwd: ...)`
+  - `recvcmd[<设备短名>]`: 命令文本回显（stdout+stderr 合并，不打印 dict），末尾带最新提示符；无输出时显示 `(empty)`
+  - `login[<设备短名>]` / `loginresult[<设备短名>]`: 登录开始与结果（登录失败为 ERROR 级别）
+  - `loginecho[<设备短名>]`: 登录 banner（交互 channel 首次创建时吸收，在第一条 sendcmd 之前打印）
+  - `disconnect[<设备短名>]`: 连接关闭
+  - `<设备短名>` 取设备名最后一段（按 `-` 或 `/` 分割），如 `rack1/node_3` → `node_3`
+- **ANSI 颜色渲染**: 报告自动把 ANSI 前景色码（30-37、90-97）转换为带颜色的 `<span>` 标签。例如命令日志中的蓝色码（`\x1b[34m`）渲染为蓝色（`#2196F3`）
+- **错误词高亮**: `recvcmd` 回显中的常见错误词（error、failed、fatal、panic、traceback、timeout、"No such file or directory" 等）会以粗体红色显示，便于快速定位失败。命令行（sendcmd）与普通日志不高亮，避免误伤命令本身
+- **列宽调整**: Level 列 70px、Thread 列 50px、Location 列 128px，Message 列获得更多空间
+- **本地时间**: 会话目录、日期目录、用例子目录均使用本机时区时间，与报告表内日志时间戳一致
+
 日志级别：
 
 | 级别 | 值 | 方法                      | 说明 |
@@ -353,9 +369,9 @@ def test_environment(logger):
 
 ### quiet_stdout 功能
 
-pytest-testkit 插件支持全局静默 `sendcmd` / `sendcmd_interactive` 的 stdout 输出，避免大量回显淹没日志。
-**开启后，stdout 内容不会出现在日志中，即使调用方显式传 `echo_output=True` 也会被全局压制。**
-exit_code、prompt、stderr 等信息不受影响。
+pytest-testkit 插件支持全局静默 `sendcmd` / `sendcmd_oneshot` / `sendcmd_interactive` 的命令与回显日志，避免大量回显淹没日志。
+**开启后，sendcmd / recvcmd 日志都不会打印，即使调用方显式传 `echo_output=True` 也会被全局压制。**
+命令返回值（stdout / stderr / exit_code 等）不受影响，仅影响日志输出。
 
 **支持CLI 参数 和 ini 配置，默认为禁用**
 
@@ -470,23 +486,27 @@ def test_use_ci_metadata():
 
 - **environment/environments**: 提供单设备/多设备对象
 
-  - **sendcmd(cmd, timeout=None, env_vars=None, cwd=None, ignore_err=False, only_stdout=True)**：执行命令(非交互式)
+  - **sendcmd(cmd, timeout=None, env_vars=None, cwd=None, ignore_err=False, only_stdout=True, echo_output=True)**：在持久化交互 shell channel 上执行命令
     - `cmd`: 要执行的命令字符串
-    - `timeout`: 命令执行超时时间（秒）
-    - `env_vars`: 环境变量字典
+    - `timeout`: 命令执行超时时间（秒），支持 int 或 str，默认 600s
+    - `env_vars`: 环境变量字典，内联为单命令前缀（`VAR=value cmd`），仅对本次命令生效，不污染持久化 shell
     - `cwd`: 工作目录，命令将在该目录下执行（可选）
     - `ignore_err`: 是否忽略命令执行错误，默认 False。设为 True 时即使命令失败 success 也为 True
     - `only_stdout`: 为 True 时只返回 stdout 字符串，为 False 时返回完整字典
+    - `echo_output`: 是否打印 sendcmd/recvcmd 日志，默认 True
+    - 行为说明: 同一线程内 shell 状态（`cd`、`export`）跨调用持久化；PTY 合并 stderr 到 stdout，返回 dict 的 `stderr` 通常为空；退出码通过 `$?` 哨兵尽力捕获。需要独立进程执行时请用 `sendcmd_oneshot`
     - 返回值: 默认返回 stdout 字符串；当 `only_stdout=False` 时返回 `{'success': bool, 'stdout': str, 'stderr': str}`
 
-  - **sendcmd_interactive(cmd, expect_prompt=None, timeout=600, cwd=None, ignore_err=False, only_stdout=True)**：执行命令(交互式)
-    - `cmd`: 要执行的命令字符串
-    - `expect_prompt`: 期望匹配的提示符正则表达式（可选）
-    - `timeout`: 命令执行超时时间（秒）。默认值600s
-    - `cwd`: 工作目录，命令将在该目录下执行（可选）
-    - `ignore_err`: 是否忽略提示符匹配失败，默认 False。设为 True 时即使未匹配到提示符 success 也为 True
-    - `only_stdout`: 为 True 时只返回 stdout 字符串，为 False 时返回完整字典
-    - 返回值: 默认返回 stdout 字符串；当 `only_stdout=False` 时返回 `{'success': bool, 'stdout': str, 'stderr': str}`
+  - **sendcmd_oneshot(cmd, timeout=None, env_vars=None, cwd=None, ignore_err=False, only_stdout=True, echo_output=True)**：独立进程执行命令（原 sendcmd 行为）
+    - 每次调用启动独立的 `exec_command` / `subprocess.run` 进程，无持久 shell 状态，与交互 channel 互相独立
+    - SSH 路径: 以 `bash -l -c` 包装执行，原生环境变量支持，退出码为 channel 权威退出状态，stderr 为独立流
+    - `local_exec` 路径: 通过 `subprocess.run` 执行
+    - 参数与返回值与 `sendcmd` 一致（`env_vars` 通过原生环境注入而非内联前缀）
+
+  - **sendcmd_interactive(cmd, expect_prompt=None, timeout=600, cwd=None, ignore_err=False, only_stdout=True)**：等同于 `sendcmd`（保留向后兼容）
+    - 现直接代理给 `sendcmd`，在持久化交互 shell channel 上执行
+    - `expect_prompt`: 保留签名兼容但不再生效（被忽略）
+    - 参数与返回值与 `sendcmd` 一致
     - **输出清理**: 返回的 stdout 会自动清理以下内容，便于用户直接使用：
       - CSI 控制序列（如 `\x1b[32m` 颜色代码、`\x1b[?2004h` bracketed paste mode 等）
       - OSC 控制序列（如 `\x1b]0;title\x07` 窗口标题设置等）
@@ -550,8 +570,10 @@ def test_use_ci_metadata():
 - **DockerProxy 容器代理对象**：通过 `environment["container_name"]` 获取
   - 代理对象提供与 Device 一致的接口，自动包装 `docker exec` 命令
 
-  - **sendcmd(cmd, timeout=None, ignore_err=False, only_stdout=True)**：非交互式命令
-    - 每次独立执行 `docker exec {docker_name} {cmd}`
+  - **sendcmd(cmd, timeout=None, ignore_err=False, only_stdout=True)**：非交互式命令（docker session 感知）
+    - 已在该容器交互式 session 中: 直接在当前 session 执行命令
+    - 其他容器持有交互式 session: 直接返回失败（提示"请退出上一个交互对话"）
+    - 否则: 包装为 `docker exec {docker_name} {cmd}` 执行（不创建持久 session）
     - 返回值: stdout 字符串或完整字典
 
   - **sendcmd_interactive(cmd, expect_prompt=None, timeout=600, cwd=None, ignore_err=False, only_stdout=True)**：交互式命令

{pytest_testkit-1.0.1 → pytest_testkit-1.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pytest_testkit"
-version = "1.0.1"
+version = "1.0.2"
 description = "Pytest plugin for Infra logging framework and environment management"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -30,7 +30,7 @@ classifiers = [
 ]
 keywords = ["pytest", "plugin", "logging", "html", "infra", "test", "automation"]
 dependencies = [
-    "pytest==8.3.2",
+    "pytest>=8.3.2",
     "requests",
     "paramiko",
     "xlrd>=2.0.0",

{pytest_testkit-1.0.1 → pytest_testkit-1.0.2}/pytest_testkit/lib/base/ssh.py

@@ -69,6 +69,8 @@ class Ssh:
 
         self.recv_timeout = False  # 上一次recv操作是否超时
         self.send_only = False  # 是否发送过sendonly命令
+        self.login_echo = ""  # 首次交互 channel 登录时的 banner 回显
+        self.last_prompt = ""  # 最近一次从输出中识别到的 shell 提示符
         self.client = None
         self.jump_client = None
         self.target_client = None
@@ -169,7 +171,30 @@ class Ssh:
         return "\n".join(cleaned_lines)
 
     @staticmethod
-    def _clean_interactive_output(raw_output: str, cmd: str) -> str:
+    def _extract_last_prompt(raw_output: str) -> str:
+        """从交互输出中提取最后一次出现的 shell 提示符。
+
+        用于在日志中还原真实终端效果: 发送命令时带上下文提示符。
+
+        Args:
+            raw_output: 原始的终端输出(已去除 ANSI)
+
+        Returns:
+            str: 识别到的提示符, 未识别返回空串
+        """
+        prompt_regex = re.compile(
+            r"^\s*((?:\([^)]+\)\s*)*(?:\[.+@.+\s+.+\]|[^@\s]+@[^:\s]+:[^\s]*|"
+            r"bash-[0-9.]+|sh-[0-9.]+)[#$]|[$#%>])\s*$",
+            re.MULTILINE,
+        )
+        last = ""
+        for line in raw_output.splitlines():
+            m = prompt_regex.match(line)
+            if m:
+                last = m.group(1)
+        return last
+
+    def _clean_interactive_output(self, raw_output: str, cmd: str) -> str:
         """清理交互式命令输出中的多余信息。
 
         Args:
@@ -182,6 +207,11 @@ class Ssh:
         # Step 1: 移除 ANSI 转义序列
         output = Ssh._remove_ansi_escapes(raw_output)
 
+        # 记录输出中最后一次出现的提示符, 供日志还原终端上下文
+        prompt = Ssh._extract_last_prompt(output)
+        if prompt:
+            self.last_prompt = prompt
+
         # Step 2: 移除命令回显
         output = Ssh.remove_command_echo(output, cmd)
 
@@ -213,7 +243,6 @@ class Ssh:
             )
             return False
 
-        self.logger.info("[Ssh.login] Starting login to target ip")
         try:
             self.target_client = paramiko.SSHClient()
             self.target_client.set_missing_host_key_policy(paramiko.AutoAddPolicy())
@@ -227,7 +256,6 @@ class Ssh:
                 timeout=10,
             )
             self.target_client.get_transport().set_keepalive(keepalive)
-            self.logger.info("[Ssh.login] connect to target ip success")
         except Exception as e:
             self.logger.error(
                 f"[Ssh.login] target exception details: {traceback.format_exc()}"
@@ -251,8 +279,6 @@ class Ssh:
         self.logger.debug(
             f"[Ssh._jump_exec_command] executed: {cmd}, exit_code={exit_code}"
         )
-        if exit_code != 0:
-            self.logger.warning(f"[Ssh._jump_exec_command] error: {stderr_content}")
         if exit_code == 0:
             success = True
         elif param.ignore_err:
@@ -309,6 +335,90 @@ class Ssh:
             return self._jump_exec_command(param)
         return self._build_result(False, "No client", "", param.only_stdout)
 
+    def _drain_login_banner(self, channel):
+        """首次创建交互 channel 后发送一个空命令, 吸收登录 banner/欢迎信息。
+
+        发送的空命令不打印日志; 收到的回显保存到 self.login_echo,
+        可作为 login 的回显查看。这样后续真正执行的命令输出不受 banner 干扰。
+
+        Args:
+            channel: 交互式 shell channel
+
+        Returns:
+            str: 吸收到的登录 banner + 空命令回显
+        """
+        banner = b""
+        # 先等一小段时间让 banner 输出
+        banner_start = time.time()
+        while time.time() - banner_start < 2:
+            if channel.recv_ready():
+                while channel.recv_ready():
+                    chunk = channel.recv(4096)
+                    if not chunk:
+                        break
+                    banner += chunk
+            else:
+                time.sleep(0.05)
+            # 已经能看到提示符就不再等满 2 秒
+            if self._build_prompt_regex().search(
+                banner.decode("utf-8", errors="replace")
+            ):
+                break
+
+        # 发送空命令(单个换行), 触发一次新提示符
+        channel.send("\n")
+        # 注意: 只检查 send 之后的增量数据, 而非累计 banner。
+        # 阶段1 的宽松正则可能被 banner 里的伪提示符($ % > 结尾行)误匹配,
+        # 若此处仍检查累计 banner, 会立即 break 而等不到真实新提示符,
+        # 导致 last_prompt 为空、第一条 sendcmd 日志无提示符前缀
+        echo_new = b""
+        echo_start = time.time()
+        while time.time() - echo_start < 3:
+            if channel.recv_ready():
+                while channel.recv_ready():
+                    chunk = channel.recv(4096)
+                    if not chunk:
+                        break
+                    banner += chunk
+                    echo_new += chunk
+            else:
+                time.sleep(0.05)
+            if echo_new and self._build_prompt_regex().search(
+                echo_new.decode("utf-8", errors="replace")
+            ):
+                break
+
+        self.login_echo = banner.decode("utf-8", errors="replace")
+        # banner 末尾的提示符同时记录到 last_prompt,
+        # 使第一条 sendcmd 日志即带提示符前缀
+        prompt = self._extract_last_prompt(self._remove_ansi_escapes(self.login_echo))
+        if prompt:
+            self.last_prompt = prompt
+        return self.login_echo
+
+    def prepare_interactive_channel(self):
+        """预创建交互 shell channel 并吸收登录 banner。
+
+        在登录后立即调用, 使 banner 回显(login_echo)在第一条命令之前就绪。
+        幂等: channel 已存在时不做任何事。
+
+        Returns:
+            str: 吸收到的 banner 回显 (存入 self.login_echo)
+        """
+        if self.client:
+            if not self.channel or not self.channel.active:
+                self.channel = self.client.invoke_shell()
+                self.channel.resize_pty(width=1000, height=5000)
+                self._drain_login_banner(self.channel)
+            return self.login_echo
+        if self.target_client:
+            if not self.target_channel or not self.target_channel.active:
+                self.target_channel = self.target_client.invoke_shell()
+                self.target_channel.resize_pty(width=1000, height=5000)
+                self._drain_login_banner(self.target_channel)
+            return self.login_echo
+        return ""
+
     def ssh_cmd_interactive(self, param: SshCmdInteractiveParam):
         """Execute interactive command on SSH server.
 
@@ -329,11 +439,13 @@ class Ssh:
             if not self.channel or not self.channel.active:
                 self.channel = self.client.invoke_shell()
                 self.channel.resize_pty(width=1000, height=5000)
+                self._drain_login_banner(self.channel)
             return self._direct_exec_cmd_interactive(param)
         if self.target_client:
             if not self.target_channel or not self.target_channel.active:
                 self.target_channel = self.target_client.invoke_shell()
                 self.target_channel.resize_pty(width=1000, height=5000)
+                self._drain_login_banner(self.target_channel)
             return self._jump_exec_cmd_interactive(param)
         return self._build_result(False, "No client", "", param.only_stdout)
 
@@ -465,12 +577,10 @@ class Ssh:
         self.client = paramiko.SSHClient()
         self.client.set_missing_host_key_policy(paramiko.AutoAddPolicy())
         try:
-            self.logger.info("[Ssh.login] Starting login process...")
             self.client.connect(
                 self.target_ip, self.target_port, self.target_user, self.target_pwd
             )
             self.client.get_transport().set_keepalive(keepalive)
-            self.logger.info("[Ssh.login] Finish connect()...")
             return True
         except Exception as e:
             self.logger.error(
@@ -511,8 +621,6 @@ class Ssh:
         self.logger.debug(
             f"[Ssh._direct_exec_cmd] executed: {cmd}, exit_code={exit_code}"
         )
-        if exit_code != 0:
-            self.logger.warning(f"[Ssh._direct_exec_cmd] error: {stderr_content}")
         if exit_code == 0:
             success = True
         elif param.ignore_err:
@@ -531,9 +639,6 @@ class Ssh:
         try:
             with SCPClient(self.client.get_transport()) as scp:
                 scp.put(local_path, remote_path, recursive=True)
-            self.logger.info(
-                f"[Ssh._direct_put_file] Uploaded {local_path} to {remote_path} via SCP"
-            )
             return True
         except Exception as e:
             self.logger.error(
@@ -545,10 +650,6 @@ class Ssh:
         try:
             with SCPClient(self.client.get_transport()) as scp:
                 scp.get(remote_path, local_path, recursive=True)
-            self.logger.info(
-                f"[Ssh._direct_get_file] Downloaded {remote_path}"
-                f" to {local_path} via SCP"
-            )
             return True
         except Exception as e:
             self.logger.error(
@@ -560,10 +661,6 @@ class Ssh:
         try:
             with SCPClient(self.target_client.get_transport()) as scp:
                 scp.put(local_path, remote_path, recursive=True)
-            self.logger.info(
-                f"[Ssh._jump_put_file] Uploaded {local_path} to "
-                f"{remote_path} via SCP through jump server"
-            )
             return True
         except Exception as e:
             self.logger.error(
@@ -575,10 +672,6 @@ class Ssh:
         try:
             with SCPClient(self.target_client.get_transport()) as scp:
                 scp.get(remote_path, local_path, recursive=True)
-            self.logger.info(
-                f"[Ssh._jump_get_file] Downloaded {remote_path} to "
-                f"{local_path} via SCP through jump server"
-            )
             return True
         except Exception as e:
             self.logger.error(