pytrunner 1.0.0__tar.gz

pytrunner-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 siwpan
+
+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.

pytrunner-1.0.0/MANIFEST.in

@@ -0,0 +1,10 @@
+prune .venv
+prune dist
+prune build
+prune release
+prune __pycache__
+prune logs
+prune docs
+global-exclude *.pyc
+global-exclude *.json
+global-exclude *.log

pytrunner-1.0.0/PKG-INFO

@@ -0,0 +1,96 @@
+Metadata-Version: 2.4
+Name: pytrunner
+Version: 1.0.0
+Summary: Python 项目全覆盖测试框架：静态扫描 / 架构检测 / 动态运行
+Author: siwpan
+License-Expression: MIT
+Project-URL: Homepage, https://gitee.com/siwpan/py_test_runner
+Project-URL: Repository, https://gitee.com/siwpan/py_test_runner
+Project-URL: Changelog, https://gitee.com/siwpan/py_test_runner/blob/master/CHANGELOG.md
+Keywords: test,testing,static-analysis,architecture,qa
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# py_test_runner — Python 项目全覆盖测试框架
+
+> 仓库：<https://gitee.com/siwpan/py_test_runner> ｜ 许可：MIT（见 [LICENSE](LICENSE)）
+> 注：文中 <PATH> 为路径占位符，请替换为你本机实际的目录 / 可执行文件路径。
+
+> 多功能 Python 测试框架，支持静态扫描、架构检测、动态运行三大类测试。
+> 由全哥创建，用于 G 盘项目（10,700+ Python 文件）的日常质量保障。
+
+---
+
+## 快速开始
+
+```bash
+cd <PATH>
+
+python main.py -c                # 控制台模式（最常用）
+python main.py --smoke -c        # 探针冒烟测试
+python main.py --allin -c         # 全项目扫描（P1 快速）
+python main.py --arch -c          # 架构模式检测
+python main.py --dynamic -c       # 动态测试（尝试运行）
+python main.py --simple -c        # 简单测试：编译 + JSON 校验
+python main.py --simple -c --simple-target <PATH>
+```
+
+---
+
+## 功能模式一览
+
+| 模式 | 命令 | 说明 |
+|------|------|------|
+| 控制台模式 | `python main.py -c` | 运行内置测试用例 |
+| GUI 模式 | `python main.py` | Tkinter Canvas 可视化界面 |
+| 探针模式 | `python main.py --smoke -c` | 冒烟测试（P1 关键探针） |
+| OK 库扫描 | `python main.py --ok -c` | 扫描 `not/OK` 下所有项目 |
+| draw 项目 | `python main.py --draw -c` | 深度扫描 ECS 架构项目 |
+| 全项目扫描 | `python main.py --allin -c` | 递归扫描 `<PATH>` 全部目录 |
+| 架构检测 | `python main.py --arch -c` | 识别 13 种架构模式 |
+| 动态测试 | `python main.py --dynamic -c` | 尝试导入并运行 Python 文件 |
+
+---
+
+## 文档
+
+| 文档 | 说明 |
+|------|------|
+| [docs/user_manual.md](docs/user_manual.md) | 完整使用手册（全参数说明、各模式详解、常见工作流、故障排查） |
+| [docs/architecture_patterns.md](docs/architecture_patterns.md) | 架构模式详解（13 种模式原理、适用场景、检测依据） |
+
+---
+
+## 项目结构
+
+```
+py_testrunner/
+├── main.py              # 入口
+├── README.md            # 本文件
+├── requirements.txt
+├── core/               # 核心引擎（日志、错误类型、测试运行器、探针系统）
+├── gui/                # Tkinter Canvas 图形界面
+├── console/            # 控制台界面
+├── logs/               # 日志 & 测试报告输出
+├── scanners/           # 扫描器（全项目、架构检测、动态测试）
+├── probes/             # 探针定义（通用、OK 库、draw 项目）
+├── reports/            # 报告生成器（HTML/JSON、coverage）
+├── tests/              # 测试脚本（自用）
+└── docs/               # 文档（使用手册、架构模式详解）
+```
+
+---
+
+## 依赖
+
+**必需（标准库）**：`tkinter` · `ast` · `subprocess` · `dataclasses`
+
+> ⚠️ `tkinter` 在 WorkBuddy managed Python 中不含，动态测试会自动回退到系统 Python。
+
+**可选**：`coverage`（覆盖率）、`matplotlib`（图表）
+
+---
+
+*内部项目，全哥创建。*

pytrunner-1.0.0/README.md

@@ -0,0 +1,81 @@
+# py_test_runner — Python 项目全覆盖测试框架
+
+> 仓库：<https://gitee.com/siwpan/py_test_runner> ｜ 许可：MIT（见 [LICENSE](LICENSE)）
+> 注：文中 <PATH> 为路径占位符，请替换为你本机实际的目录 / 可执行文件路径。
+
+> 多功能 Python 测试框架，支持静态扫描、架构检测、动态运行三大类测试。
+> 由全哥创建，用于 G 盘项目（10,700+ Python 文件）的日常质量保障。
+
+---
+
+## 快速开始
+
+```bash
+cd <PATH>
+
+python main.py -c                # 控制台模式（最常用）
+python main.py --smoke -c        # 探针冒烟测试
+python main.py --allin -c         # 全项目扫描（P1 快速）
+python main.py --arch -c          # 架构模式检测
+python main.py --dynamic -c       # 动态测试（尝试运行）
+python main.py --simple -c        # 简单测试：编译 + JSON 校验
+python main.py --simple -c --simple-target <PATH>
+```
+
+---
+
+## 功能模式一览
+
+| 模式 | 命令 | 说明 |
+|------|------|------|
+| 控制台模式 | `python main.py -c` | 运行内置测试用例 |
+| GUI 模式 | `python main.py` | Tkinter Canvas 可视化界面 |
+| 探针模式 | `python main.py --smoke -c` | 冒烟测试（P1 关键探针） |
+| OK 库扫描 | `python main.py --ok -c` | 扫描 `not/OK` 下所有项目 |
+| draw 项目 | `python main.py --draw -c` | 深度扫描 ECS 架构项目 |
+| 全项目扫描 | `python main.py --allin -c` | 递归扫描 `<PATH>` 全部目录 |
+| 架构检测 | `python main.py --arch -c` | 识别 13 种架构模式 |
+| 动态测试 | `python main.py --dynamic -c` | 尝试导入并运行 Python 文件 |
+
+---
+
+## 文档
+
+| 文档 | 说明 |
+|------|------|
+| [docs/user_manual.md](docs/user_manual.md) | 完整使用手册（全参数说明、各模式详解、常见工作流、故障排查） |
+| [docs/architecture_patterns.md](docs/architecture_patterns.md) | 架构模式详解（13 种模式原理、适用场景、检测依据） |
+
+---
+
+## 项目结构
+
+```
+py_testrunner/
+├── main.py              # 入口
+├── README.md            # 本文件
+├── requirements.txt
+├── core/               # 核心引擎（日志、错误类型、测试运行器、探针系统）
+├── gui/                # Tkinter Canvas 图形界面
+├── console/            # 控制台界面
+├── logs/               # 日志 & 测试报告输出
+├── scanners/           # 扫描器（全项目、架构检测、动态测试）
+├── probes/             # 探针定义（通用、OK 库、draw 项目）
+├── reports/            # 报告生成器（HTML/JSON、coverage）
+├── tests/              # 测试脚本（自用）
+└── docs/               # 文档（使用手册、架构模式详解）
+```
+
+---
+
+## 依赖
+
+**必需（标准库）**：`tkinter` · `ast` · `subprocess` · `dataclasses`
+
+> ⚠️ `tkinter` 在 WorkBuddy managed Python 中不含，动态测试会自动回退到系统 Python。
+
+**可选**：`coverage`（覆盖率）、`matplotlib`（图表）
+
+---
+
+*内部项目，全哥创建。*

pytrunner-1.0.0/__init__.py

@@ -0,0 +1,21 @@
+"""pytrunner —— Python 项目全覆盖测试框架（命名空间根包）。"""
+
+import sys
+
+# 兼容仓库「脚本模式」（根目录在 sys.path 上时 `from core.x` / `from tests.x` 等可用）。
+# 打包为命名空间包后顶层不再有这些子包，这里把别名指回本包子模块，
+# 使既有绝对导入在包模式下仍能解析。若已有同名顶层包则不动（setdefault）。
+for _alias, _sub in (
+    ("core", "pytrunner.core"),
+    ("console", "pytrunner.console"),
+    ("gui", "pytrunner.gui"),
+    ("tests", "pytrunner.tests"),
+    ("probes", "pytrunner.probes"),
+    ("scanners", "pytrunner.scanners"),
+):
+    try:
+        __import__(_sub)
+        sys.modules.setdefault(_alias, sys.modules[_sub])
+    except ImportError:
+        pass
+del _alias, _sub

pytrunner-1.0.0/console/__init__.py

@@ -0,0 +1 @@
+# console — 控制台模式界面

pytrunner-1.0.0/console/console_ui.py

@@ -0,0 +1,67 @@
+"""
+控制台测试界面 — 纯终端交互模式。
+
+适用场景：
+    - CI/CD 流水线
+    - 无 GUI 环境
+    - 脚本自动化
+"""
+
+import sys
+import os
+from typing import List, Callable
+
+# 强制 stdout 使用 UTF-8，避免 emoji 等字符在 GBK 下报错
+sys.stdout.reconfigure(encoding='utf-8', errors='replace')
+
+from core.log_manager import LogManager
+from core.test_runner import TestRunner
+from core.error_types import ErrorCode
+
+
+class ConsoleUI:
+    """控制台测试界面"""
+
+    def __init__(self, log_manager: LogManager):
+        self.log = log_manager
+        self.runner = TestRunner(log_manager)
+
+    def print_banner(self):
+        """打印启动横幅"""
+        banner = r"""
+   ╔══════════════════════════════════════════════════╗
+   ║            🧪  测试框架  v1.0                     ║
+   ║            Console Mode                         ║
+   ╚══════════════════════════════════════════════════╝
+        """
+        self.log.print_colored(banner, bold=True)
+
+    def run(self, test_fns: List[Callable], timeout: float = 30.0):
+        """执行测试套件"""
+        self.print_banner()
+        self.runner.timeout = timeout
+
+        try:
+            results = self.runner.run_tests(test_fns)
+            self.log.print_summary()
+
+            # 返回退出码
+            has_failure = any(
+                r.error_code.category.value in ("失败", "错误")
+                for r in results
+            )
+            if has_failure:
+                self.log.print_colored("⚠️  有测试未通过！", bold=True)
+                return 1
+            else:
+                self.log.print_colored("✅ 全部测试通过！", bold=True)
+                return 0
+
+        except KeyboardInterrupt:
+            self.log.print_colored("\n⚠️  测试被用户中断", bold=True)
+            return 2
+        except Exception as e:
+            self.log.print_colored(f"\n💥 测试框架崩溃: {e}", bold=True)
+            import traceback
+            traceback.print_exc()
+            return 3

pytrunner-1.0.0/core/__init__.py

@@ -0,0 +1 @@
+# core — 测试框架核心引擎

pytrunner-1.0.0/core/error_types.py

@@ -0,0 +1,149 @@
+"""
+错误类型定义 — 明确分类测试中可能出现的所有错误。
+
+设计原则：
+    每种错误类型都有唯一的 name/code/emoji，方便日志筛选和 GUI 渲染。
+"""
+
+from enum import Enum
+from dataclasses import dataclass, field
+from datetime import datetime
+from typing import Optional
+
+
+class ErrorCategory(Enum):
+    """错误大类"""
+    PASS = "通过"
+    FAIL = "失败"
+    ERROR = "错误"
+    SKIP = "跳过"
+
+
+class ErrorCode(Enum):
+    """错误细类 — 每种错误有唯一标识码"""
+
+    # ── 通过 ──
+    TEST_PASS = ("PASS-000", "测试通过", ErrorCategory.PASS, "✅")
+
+    # ── 断言失败 ──
+    ASSERT_EQUAL = ("FAIL-001", "断言相等失败：期望值与实际值不符", ErrorCategory.FAIL, "❌")
+    ASSERT_TRUE = ("FAIL-002", "断言为真失败：表达式求值为 False", ErrorCategory.FAIL, "❌")
+    ASSERT_FALSE = ("FAIL-003", "断言为假失败：表达式求值为 True", ErrorCategory.FAIL, "❌")
+    ASSERT_IN = ("FAIL-004", "断言包含失败：值不在集合中", ErrorCategory.FAIL, "❌")
+    ASSERT_RAISES = ("FAIL-005", "断言异常失败：未抛出预期异常", ErrorCategory.FAIL, "❌")
+    UNEXPECTED_RESULT = ("FAIL-006", "意外结果：返回值与预期不符", ErrorCategory.FAIL, "❌")
+
+    # ── 运行时错误 ──
+    RUNTIME_ERROR = ("ERR-001", "运行时错误", ErrorCategory.ERROR, "💥")
+    ATTRIBUTE_ERROR = ("ERR-002", "属性错误：对象没有该属性或方法", ErrorCategory.ERROR, "💥")
+    TYPE_ERROR = ("ERR-003", "类型错误：操作数类型不匹配", ErrorCategory.ERROR, "💥")
+    VALUE_ERROR = ("ERR-004", "值错误：参数值不合法", ErrorCategory.ERROR, "💥")
+    KEY_ERROR = ("ERR-005", "键错误：字典中不存在该键", ErrorCategory.ERROR, "💥")
+    INDEX_ERROR = ("ERR-006", "索引错误：序列索引越界", ErrorCategory.ERROR, "💥")
+    ZERO_DIVISION = ("ERR-007", "零除错误：除数为零", ErrorCategory.ERROR, "💥")
+    NAME_ERROR = ("ERR-008", "名称错误：变量未定义", ErrorCategory.ERROR, "💥")
+    OS_ERROR = ("ERR-009", "系统错误：操作系统相关异常", ErrorCategory.ERROR, "💥")
+    IO_ERROR = ("ERR-010", "IO 错误：文件读写失败", ErrorCategory.ERROR, "💥")
+    RECURSION_ERROR = ("ERR-011", "递归错误：递归深度超限", ErrorCategory.ERROR, "💥")
+    MEMORY_ERROR = ("ERR-012", "内存错误：内存不足", ErrorCategory.ERROR, "💥")
+
+    # ── 语法/导入错误 ──
+    SYNTAX_ERROR = ("ERR-101", "语法错误：代码无法解析", ErrorCategory.ERROR, "📝")
+    IMPORT_ERROR = ("ERR-102", "导入错误：模块不存在或无法加载", ErrorCategory.ERROR, "📝")
+    INDENTATION_ERROR = ("ERR-103", "缩进错误：代码缩进不正确", ErrorCategory.ERROR, "📝")
+    MODULE_NOT_FOUND = ("ERR-104", "模块未找到：依赖缺失", ErrorCategory.ERROR, "📝")
+
+    # ── 超时错误 ──
+    TIMEOUT_ERROR = ("ERR-201", "超时错误：执行超过时间限制", ErrorCategory.ERROR, "⏱️")
+
+    # ── 测试框架错误 ──
+    SETUP_ERROR = ("ERR-301", "准备阶段错误：setUp 方法异常", ErrorCategory.ERROR, "🔧")
+    TEARDOWN_ERROR = ("ERR-302", "清理阶段错误：tearDown 方法异常", ErrorCategory.ERROR, "🔧")
+    FIXTURE_ERROR = ("ERR-303", "夹具错误：测试数据准备失败", ErrorCategory.ERROR, "🔧")
+
+    # ── 跳过 ──
+    TEST_SKIP = ("SKIP-000", "测试跳过", ErrorCategory.SKIP, "⏭️")
+    SKIP_CONDITION = ("SKIP-001", "条件跳过：前置条件不满足", ErrorCategory.SKIP, "⏭️")
+    SKIP_PLATFORM = ("SKIP-002", "平台跳过：当前平台不支持", ErrorCategory.SKIP, "⏭️")
+
+    # ── 测试探针 ──（快速冒烟检测）
+    PROBE_PASS = ("PROBE-PASS", "探针通过：检测点正常", ErrorCategory.PASS, "📍")
+    PROBE_FAIL = ("PROBE-FAIL", "探针失败：检测点异常", ErrorCategory.FAIL, "📍")
+    PROBE_SKIP = ("PROBE-SKIP", "探针跳过：条件不满足", ErrorCategory.SKIP, "📍")
+
+    # ── 未知 ──
+    UNKNOWN_ERROR = ("ERR-999", "未知错误：无法归类的异常", ErrorCategory.ERROR, "❓")
+
+    @classmethod
+    def from_exception(cls, exc: Exception) -> "ErrorCode":
+        """根据异常类型自动匹配 ErrorCode"""
+        mapping = {
+            AssertionError: cls.ASSERT_EQUAL,
+            AttributeError: cls.ATTRIBUTE_ERROR,
+            TypeError: cls.TYPE_ERROR,
+            ValueError: cls.VALUE_ERROR,
+            KeyError: cls.KEY_ERROR,
+            IndexError: cls.INDEX_ERROR,
+            ZeroDivisionError: cls.ZERO_DIVISION,
+            NameError: cls.NAME_ERROR,
+            OSError: cls.OS_ERROR,
+            IOError: cls.IO_ERROR,
+            RecursionError: cls.RECURSION_ERROR,
+            MemoryError: cls.MEMORY_ERROR,
+            SyntaxError: cls.SYNTAX_ERROR,
+            ImportError: cls.IMPORT_ERROR,
+            IndentationError: cls.INDENTATION_ERROR,
+            ModuleNotFoundError: cls.MODULE_NOT_FOUND,
+            TimeoutError: cls.TIMEOUT_ERROR,
+        }
+        return mapping.get(type(exc), cls.UNKNOWN_ERROR)
+
+    @property
+    def code(self) -> str:
+        return self.value[0]
+
+    @property
+    def description(self) -> str:
+        return self.value[1]
+
+    @property
+    def category(self) -> ErrorCategory:
+        return self.value[2]
+
+    @property
+    def emoji(self) -> str:
+        return self.value[3]
+
+
+@dataclass
+class TestError:
+    """单条测试错误记录"""
+    error_code: ErrorCode
+    message: str
+    timestamp: datetime = field(default_factory=datetime.now)
+    traceback: Optional[str] = None
+    test_name: str = ""
+    file_path: str = ""
+    line_number: int = 0
+
+    def brief(self) -> str:
+        """一行摘要"""
+        loc = f"{self.file_path}:{self.line_number}" if self.file_path else ""
+        return f"[{self.error_code.code}] {self.error_code.emoji} {self.message}  {loc}"
+
+    def detail(self) -> str:
+        """完整详情"""
+        lines = [
+            f"{'='*60}",
+            f"  错误码 : {self.error_code.code}",
+            f"  类型   : {self.error_code.description}",
+            f"  时间   : {self.timestamp.strftime('%Y-%m-%d %H:%M:%S')}",
+            f"  测试   : {self.test_name}",
+        ]
+        if self.file_path:
+            lines.append(f"  位置   : {self.file_path}:{self.line_number}")
+        lines.append(f"  消息   : {self.message}")
+        if self.traceback:
+            lines.append(f"  堆栈   :\n{self.traceback}")
+        lines.append(f"{'='*60}")
+        return "\n".join(lines)

pytrunner-1.0.0/core/log_manager.py

@@ -0,0 +1,177 @@
+"""
+日志管理器 — 统一管理控制台输出、GUI 回调和文件写入。
+
+功能：
+    - 同时输出到多个目标（控制台/GUI 回调/文件）
+    - 按错误级别自动着色
+    - 自动创建带时间戳的日志文件
+    - 线程安全
+"""
+
+import threading
+from datetime import datetime
+from typing import Optional, Callable, List
+from pathlib import Path
+
+from .error_types import ErrorCode, TestError, ErrorCategory
+
+
+class LogManager:
+    """多路日志管理器"""
+
+    # 控制台颜色（Windows 10+ 支持 ANSI）
+    COLORS = {
+        ErrorCategory.PASS: "\033[32m",
+        ErrorCategory.FAIL: "\033[31m",
+        ErrorCategory.ERROR: "\033[35m",
+        ErrorCategory.SKIP: "\033[33m",
+        "reset": "\033[0m",
+        "bold": "\033[1m",
+        "dim": "\033[2m",
+        "header": "\033[1;36m",
+    }
+
+    def __init__(self, log_dir: str = "logs", use_color: bool = True):
+        self.log_dir = Path(log_dir)
+        self.log_dir.mkdir(parents=True, exist_ok=True)
+
+        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+        self.log_path = self.log_dir / f"test_run_{timestamp}.log"
+        self.error_path = self.log_dir / f"test_errors_{timestamp}.log"
+
+        self._lock = threading.RLock()
+        self._gui_callbacks: List[Callable[[str], None]] = []
+        self._error_callbacks: List[Callable[[TestError], None]] = []
+        self._errors: List[TestError] = []
+        self._log_entries: List[str] = []
+        self._use_color = use_color
+
+        self._write_to_file(self.log_path, f"=== 测试日志 === 开始时间: {datetime.now()}\n", mode='w')
+        self._write_to_file(self.error_path, f"=== 错误日志 === 开始时间: {datetime.now()}\n\n", mode='w')
+
+    # ── 回调注册 ──
+    def on_log(self, callback: Callable[[str], None]):
+        self._gui_callbacks.append(callback)
+
+    def on_error(self, callback: Callable[[TestError], None]):
+        self._error_callbacks.append(callback)
+
+    # ── 写入 ──
+    def _write_to_file(self, path: Path, text: str, mode: str = 'a'):
+        try:
+            with open(path, mode, encoding='utf-8') as f:
+                f.write(text)
+        except OSError:
+            pass
+
+    def _notify_gui(self, line: str):
+        for cb in self._gui_callbacks:
+            try:
+                cb(line)
+            except Exception:
+                pass
+
+    def _notify_error(self, error: TestError):
+        for cb in self._error_callbacks:
+            try:
+                cb(error)
+            except Exception:
+                pass
+
+    # ── 日志方法 ──
+    def log(self, msg: str, level: str = "INFO"):
+        timestamp = datetime.now().strftime("%H:%M:%S")
+        line = f"[{timestamp}] [{level}] {msg}"
+        with self._lock:
+            self._log_entries.append(line)
+            self._write_to_file(self.log_path, line + "\n")
+            self._notify_gui(line)
+
+    def info(self, msg: str):
+        self.log(msg, "INFO")
+
+    def warning(self, msg: str):
+        self.log(msg, "WARN")
+
+    def debug(self, msg: str):
+        self.log(msg, "DEBUG")
+
+    def error(self, test_error: TestError):
+        """记录结构化错误"""
+        with self._lock:
+            self._errors.append(test_error)
+            self._write_to_file(self.error_path, test_error.detail() + "\n")
+            line = f"[{datetime.now().strftime('%H:%M:%S')}] [ERROR] {test_error.brief()}"
+            self._log_entries.append(line)
+            self._write_to_file(self.log_path, line + "\n")
+            self._notify_gui(line)
+            self._notify_error(test_error)
+
+    def section(self, title: str):
+        """打印分隔标题"""
+        line = f"\n{'━'*50}\n  {title}\n{'━'*50}"
+        with self._lock:
+            self._log_entries.append(line)
+            self._write_to_file(self.log_path, line + "\n")
+            self._notify_gui(line)
+
+    # ── 控制台输出 ──
+    def print_colored(self, msg: str, category: Optional[ErrorCategory] = None, bold: bool = False):
+        """带颜色的控制台输出"""
+        if self._use_color:
+            color = self.COLORS.get(category, "")
+            style = self.COLORS["bold"] if bold else ""
+            reset = self.COLORS["reset"]
+            print(f"{style}{color}{msg}{reset}", flush=True)
+        else:
+            print(msg, flush=True)
+
+    def print_result(self, error_code: ErrorCode, test_name: str, duration: float = 0):
+        """打印单条测试结果"""
+        emoji = error_code.emoji
+        duration_str = f"({duration:.3f}s)" if duration > 0 else ""
+        msg = f"  {emoji} {test_name:<40} {error_code.code:<10} {duration_str}"
+        self.print_colored(msg, category=error_code.category)
+
+    # ── 汇总报告 ──
+    def print_summary(self):
+        """控制台打印汇总报告"""
+        total = len(self._errors)
+        passed = sum(1 for e in self._errors if e.error_code.category == ErrorCategory.PASS)
+        failed = sum(1 for e in self._errors if e.error_code.category == ErrorCategory.FAIL)
+        errored = sum(1 for e in self._errors if e.error_code.category == ErrorCategory.ERROR)
+        skipped = sum(1 for e in self._errors if e.error_code.category == ErrorCategory.SKIP)
+
+        self.section("测试汇总")
+        print()
+        self.print_colored(f"  总计  : {total}  个测试", bold=True)
+        self.print_colored(f"  通过  : {passed} ✅", ErrorCategory.PASS)
+        self.print_colored(f"  失败  : {failed} ❌", ErrorCategory.FAIL)
+        self.print_colored(f"  错误  : {errored} 💥", ErrorCategory.ERROR)
+        self.print_colored(f"  跳过  : {skipped} ⏭️", ErrorCategory.SKIP)
+        print()
+        self.print_colored(f"  日志文件: {self.log_path}", bold=False)
+        self.print_colored(f"  错误文件: {self.error_path}", bold=False)
+        print()
+
+        error_list = [e for e in self._errors if e.error_code.category != ErrorCategory.PASS]
+        if error_list:
+            self.print_colored("失败/错误详情:", ErrorCategory.ERROR, bold=True)
+            for e in error_list:
+                self.print_colored(f"    {e.brief()}", e.error_code.category)
+            print()
+
+    def get_summary(self) -> dict:
+        """返回汇总数据（GUI 用）"""
+        total = len(self._errors)
+        return {
+            "total": total,
+            "passed": sum(1 for e in self._errors if e.error_code.category == ErrorCategory.PASS),
+            "failed": sum(1 for e in self._errors if e.error_code.category == ErrorCategory.FAIL),
+            "errored": sum(1 for e in self._errors if e.error_code.category == ErrorCategory.ERROR),
+            "skipped": sum(1 for e in self._errors if e.error_code.category == ErrorCategory.SKIP),
+            "log_path": str(self.log_path),
+            "error_path": str(self.error_path),
+            "errors": self._errors,
+            "entries": self._log_entries,
+        }