df-test-framework 4.7.0__tar.gz → 4.7.2__tar.gz

{df_test_framework-4.7.0 → df_test_framework-4.7.2}/AGENTS.md

@@ -8,8 +8,8 @@ This file provides guidance to Codex (Codex.ai/code) when working with code in t
 
 **DF Test Framework** - 现代化 Python 测试自动化框架
 
-- **版本**: v4.1.2
-- **更新时间**: 2026-03-16
+- **版本**: v4.7.2
+- **更新时间**: 2026-05-26
 - **Python**: 3.12+
 - **核心技术栈**: pytest + httpx + Playwright + Pydantic v2 + SQLAlchemy 2.0 + Pluggy
 - **架构**: 五层架构 + 横切关注点（能力层驱动设计）
@@ -80,6 +80,17 @@ Layer 0 ─── core/                       # 核心层：纯抽象（无依
 | **目录** | `apis/` | `actions/` |
 | **默认 scope** | `session` | `function` |
 
+### 显式多客户端模型 (v4.2.0 / v4.5.0)
+
+当测试项目需要同时对接多个独立服务（不同 base_url、不同认证方式）时使用：
+
+| 装饰器 | 适用场景 | 基类要求 |
+|--------|----------|---------|
+| `@service_client()` | 独立 HTTP 服务客户端（如第三方接口、内部微服务） | 无要求，自动注入 `base_url` |
+| `@ui_client()` | 独立前端（B 端后台、H5、WebView 等不同 base_url） | 无要求，自动生成独立 page/context fixtures |
+
+与 `@api_class` 的区别：`@api_class` 面向共享同一 `http_client` 的 admin 后台；`@service_client` 面向完全独立的服务客户端。
+
 ### 脚手架项目类型
 
 ```bash
@@ -93,6 +104,10 @@ df-test init my-project --type full  # 完整项目：apis/ + actions/ + pages/
 - **中间件系统**: 洋葱模型，SignatureMiddleware、BearerTokenMiddleware、RetryMiddleware
 - **EventBus**: 事件驱动，HTTP/UI 事件自动发布，Allure 自动记录
 - **配置系统**: YAML 分层配置 + 环境变量，WebConfig/HTTPConfig/DatabaseConfig
+- **SanitizeService**: 统一脱敏服务，HTTP/UI/DB 日志中敏感字段自动遮盖（v3.40.x）
+- **HttpRequestRecorder**: 测试失败时自动将完整 HTTP 现场注入 Allure 报告（v4.4.1）
+- **测试数据管线**: `CaseContext[T]` + `case_dataset` fixture，YAML 文件驱动参数化（v4.6.0）
+- **RuntimeContext.metadata**: 跨 scope 携带平台业务上下文键值（tenant_id 等），通过 `with_metadata()` 派生（v4.7.0）
 
 ---
 
@@ -127,15 +142,47 @@ def test_login(self): ...
 
 ## 版本发布
 
+### 版本号选择规则（语义化版本）
+
+**完整规范**: `docs/development/VERSION_CONTROL_RULES.md`
+
+**MAJOR / MINOR / PATCH 决策三问**（在改 `pyproject.toml` 前先回答）：
+
+1. 这是**独立的功能模块**吗？（不是现有功能的延续/增强）
+2. 值得**单独写一篇发布文档**吗？
+3. 用户会**专门为它升级**吗？
+
+- 三个都是 YES → **MINOR +1**（如新增 GraphQL 客户端、新增分布式追踪）
+- 否则 → **PATCH +1**（bug 修复、性能优化、内部统一、辅助方法、现有主题的延续补强）
+- 不兼容变更 / 移除 API / 升级最低 Python 版本 → **MAJOR +1**
+
+**核心原则**：MINOR 要克制，相关功能合并发布；PATCH 要积极，bug 立即修。
+
+### 发布步骤
+
 发布新版本时，严格按以下顺序执行：
 
 ### Step 1: 更新文件
 
-1. `pyproject.toml` + `src/df_test_framework/__init__.py` 版本号
-2. `CHANGELOG.md` - 简洁摘要
-3. `docs/releases/vX.X.X.md` - 详细发布说明
-4. `docs/guides/xxx.md` - 功能使用指南（如有新功能）
-5. `cli/templates/` - 脚手架模板（如有影响）
+**版本号（每次必改）**：
+1. `pyproject.toml` — `version = "X.X.X"`
+2. `src/df_test_framework/__init__.py` — `__version__ = "X.X.X"`
+
+**版本标注（每次必改，共 6 处）**：
+3. `README.md` — 顶部 `版本` + `更新时间`
+4. `CLAUDE.md` — 顶部 `版本` + `更新时间`
+5. `AGENTS.md` — 顶部 `版本` + `更新时间`
+6. `docs/README.md` — 顶部 `版本` + `更新时间`
+7. `docs/ESSENTIAL_DOCS.md` — 顶部 `框架版本` + `更新日期`
+8. `docs/releases/README.md` — 当前版本行
+
+**发布内容（每次必加）**：
+9. `CHANGELOG.md` — 简洁摘要
+10. `docs/releases/vX.X.X.md` — 详细发布说明
+
+**按需更新**：
+11. `docs/guides/xxx.md` — 有新功能或行为变更时才改，仅更新涉及的指南
+12. `cli/templates/` — 脚手架模板有影响时才改
 
 ### Step 2: 代码质量检查（必须全部通过）
 
@@ -165,17 +212,26 @@ git push origin master
 
 ```
 src/df_test_framework/
-├── core/                # Layer 0: middleware/context/events/protocols
+├── core/                # Layer 0: middleware/context/events/protocols（无任何依赖）
 ├── infrastructure/      # Layer 1: config/logging/telemetry/events/plugins
+│   ├── sanitize/        #   SanitizeService 统一脱敏
+│   ├── tracing/         #   OpenTelemetry 链路追踪（可选依赖）
+│   └── metrics/         #   Prometheus 指标（可选依赖）
 ├── capabilities/        # Layer 2: clients/drivers/databases/messengers/storages
-│   ├── clients/         #   HTTP + GraphQL + gRPC
+│   ├── clients/         #   HTTP（httpx）+ GraphQL + gRPC
 │   ├── drivers/         #   Playwright (Web UI)
-│   ├── databases/       #   MySQL + Redis + Repository + UoW
-│   ├── messengers/      #   Kafka + RabbitMQ + RocketMQ
-│   └── storages/        #   LocalFile + S3 + OSS
+│   ├── databases/       #   MySQL + Redis + Repository + UoW，async/sync 双模式
+│   ├── messengers/      #   queue/kafka + queue/rabbitmq + queue/rocketmq
+│   ├── storages/        #   file/local + object/s3 + object/oss
+│   └── engines/         #   目录骨架预留（batch/spark, stream/flink, olap），暂未实现
 ├── testing/             # Layer 3: fixtures/decorators/data/debugging
+│   ├── fixtures/        #   core/allure/ui/cleanup/http_recorder/metrics/monitoring
+│   ├── decorators/      #   @api_class/@actions_class/@service_client/@ui_client
+│   ├── data/            #   generators/loaders/builders/pipeline(CaseContext/case_dataset)
+│   ├── assertions/      #   response/matchers/json_schema 断言辅助
+│   └── mocking/         #   http_mock/database_mock/redis_mock/time_mock
 ├── cli/                 # Layer 3: commands + templates
-├── bootstrap/           # Layer 4: Bootstrap + Providers + Runtime
+├── bootstrap/           # Layer 4: Bootstrap + Providers + RuntimeContext
 └── plugins/             # 横切: MonitoringPlugin + AllurePlugin
 
 cli/templates/
@@ -188,7 +244,7 @@ cli/templates/
 ## 重要提示
 
 - `tests/test_messengers/` 需要外部服务（Kafka/RabbitMQ/RocketMQ），CI 中跳过
-- `engines/` 目录预留，暂未实现
+- `capabilities/engines/` 仅有目录骨架（batch/spark, stream/flink, olap），暂未实现功能
 - Windows 平台使用 `start` 而非 `open` 打开报告
 
 ---

{df_test_framework-4.7.0 → df_test_framework-4.7.2}/CHANGELOG.md

@@ -5,6 +5,25 @@
 格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/),
 版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [Unreleased]
+
+## [4.7.2] - 2026-05-26
+
+### ✨ 新增
+
+- **脚手架 `flows/` 目录**：`df-test init` 默认生成 `src/{project}/flows/__init__.py`，作为项目侧 API/E2E 业务链路编排目录；该目录不参与框架自动注册，区别于 UI `actions/` 和前置造数 `fixtures/*_chain.py`。
+
+### 📝 文档
+
+- **脚手架结构说明同步**：更新生成项目 README、脚手架指南和 fixture chain 指南，明确 `flows/`、`models/cases/`、`tests/data/fixtures/`、`tests/data/files/` 的生成与职责边界。
+- **pytest 默认参数说明**：脚手架 `pyproject.toml` 模板默认 `addopts` 不再包含 `-v`；文档保留手动命令示例中的 `-v`，并补充常用命令参数作用说明。
+
+## [4.7.1] - 2026-05-22
+
+### 🐛 修复
+
+- **Allure 报告重复记录**（`testing/fixtures/allure.py`）：`_auto_allure_observer` autouse fixture 在每次测试结束后未取消 EventBus 订阅，导致 handler 随测试数量线性累积，后续测试的每个 HTTP/DB 事件被 N 个遗留 observer 重复写入报告。现改为在 `finally` 块中逐一 unsubscribe，彻底消除重复。
+
 ## [4.7.0] - 2026-05-19
 
 ### ✨ 新增

{df_test_framework-4.7.0 → df_test_framework-4.7.2}/CLAUDE.md

@@ -8,8 +8,8 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 **DF Test Framework** - 现代化 Python 测试自动化框架
 
-- **版本**: v4.7.0
-- **更新时间**: 2026-05-19
+- **版本**: v4.7.2
+- **更新时间**: 2026-05-26
 - **Python**: 3.12+
 - **核心技术栈**: pytest + httpx + Playwright + Pydantic v2 + SQLAlchemy 2.0 + Pluggy
 - **架构**: 五层架构 + 横切关注点（能力层驱动设计）
@@ -80,6 +80,17 @@ Layer 0 ─── core/                       # 核心层：纯抽象（无依
 | **目录** | `apis/` | `actions/` |
 | **默认 scope** | `session` | `function` |
 
+### 显式多客户端模型 (v4.2.0 / v4.5.0)
+
+当测试项目需要同时对接多个独立服务（不同 base_url、不同认证方式）时使用：
+
+| 装饰器 | 适用场景 | 基类要求 |
+|--------|----------|---------|
+| `@service_client()` | 独立 HTTP 服务客户端（如第三方接口、内部微服务） | 无要求，自动注入 `base_url` |
+| `@ui_client()` | 独立前端（B 端后台、H5、WebView 等不同 base_url） | 无要求，自动生成独立 page/context fixtures |
+
+与 `@api_class` 的区别：`@api_class` 面向共享同一 `http_client` 的 admin 后台；`@service_client` 面向完全独立的服务客户端。
+
 ### 脚手架项目类型
 
 ```bash
@@ -93,6 +104,10 @@ df-test init my-project --type full  # 完整项目：apis/ + actions/ + pages/
 - **中间件系统**: 洋葱模型，SignatureMiddleware、BearerTokenMiddleware、RetryMiddleware
 - **EventBus**: 事件驱动，HTTP/UI 事件自动发布，Allure 自动记录
 - **配置系统**: YAML 分层配置 + 环境变量，WebConfig/HTTPConfig/DatabaseConfig
+- **SanitizeService**: 统一脱敏服务，HTTP/UI/DB 日志中敏感字段自动遮盖（v3.40.x）
+- **HttpRequestRecorder**: 测试失败时自动将完整 HTTP 现场注入 Allure 报告（v4.4.1）
+- **测试数据管线**: `CaseContext[T]` + `case_dataset` fixture，YAML 文件驱动参数化（v4.6.0）
+- **RuntimeContext.metadata**: 跨 scope 携带平台业务上下文键值（tenant_id 等），通过 `with_metadata()` 派生（v4.7.0）
 
 ---
 
@@ -149,11 +164,25 @@ def test_login(self): ...
 
 ### Step 1: 更新文件
 
-1. `pyproject.toml` + `src/df_test_framework/__init__.py` 版本号
-2. `CHANGELOG.md` - 简洁摘要
-3. `docs/releases/vX.X.X.md` - 详细发布说明
-4. `docs/guides/xxx.md` - 功能使用指南（如有新功能）
-5. `cli/templates/` - 脚手架模板（如有影响）
+**版本号（每次必改）**：
+1. `pyproject.toml` — `version = "X.X.X"`
+2. `src/df_test_framework/__init__.py` — `__version__ = "X.X.X"`
+
+**版本标注（每次必改，共 6 处）**：
+3. `README.md` — 顶部 `版本` + `更新时间`
+4. `CLAUDE.md` — 顶部 `版本` + `更新时间`
+5. `AGENTS.md` — 顶部 `版本` + `更新时间`
+6. `docs/README.md` — 顶部 `版本` + `更新时间`
+7. `docs/ESSENTIAL_DOCS.md` — 顶部 `框架版本` + `更新日期`
+8. `docs/releases/README.md` — 当前版本行
+
+**发布内容（每次必加）**：
+9. `CHANGELOG.md` — 简洁摘要
+10. `docs/releases/vX.X.X.md` — 详细发布说明
+
+**按需更新**：
+11. `docs/guides/xxx.md` — 有新功能或行为变更时才改，仅更新涉及的指南
+12. `cli/templates/` — 脚手架模板有影响时才改
 
 ### Step 2: 代码质量检查（必须全部通过）
 
@@ -183,17 +212,26 @@ git push origin master
 
 ```
 src/df_test_framework/
-├── core/                # Layer 0: middleware/context/events/protocols
+├── core/                # Layer 0: middleware/context/events/protocols（无任何依赖）
 ├── infrastructure/      # Layer 1: config/logging/telemetry/events/plugins
+│   ├── sanitize/        #   SanitizeService 统一脱敏
+│   ├── tracing/         #   OpenTelemetry 链路追踪（可选依赖）
+│   └── metrics/         #   Prometheus 指标（可选依赖）
 ├── capabilities/        # Layer 2: clients/drivers/databases/messengers/storages
-│   ├── clients/         #   HTTP + GraphQL + gRPC
+│   ├── clients/         #   HTTP（httpx）+ GraphQL + gRPC
 │   ├── drivers/         #   Playwright (Web UI)
-│   ├── databases/       #   MySQL + Redis + Repository + UoW
-│   ├── messengers/      #   Kafka + RabbitMQ + RocketMQ
-│   └── storages/        #   LocalFile + S3 + OSS
+│   ├── databases/       #   MySQL + Redis + Repository + UoW，async/sync 双模式
+│   ├── messengers/      #   queue/kafka + queue/rabbitmq + queue/rocketmq
+│   ├── storages/        #   file/local + object/s3 + object/oss
+│   └── engines/         #   目录骨架预留（batch/spark, stream/flink, olap），暂未实现
 ├── testing/             # Layer 3: fixtures/decorators/data/debugging
+│   ├── fixtures/        #   core/allure/ui/cleanup/http_recorder/metrics/monitoring
+│   ├── decorators/      #   @api_class/@actions_class/@service_client/@ui_client
+│   ├── data/            #   generators/loaders/builders/pipeline(CaseContext/case_dataset)
+│   ├── assertions/      #   response/matchers/json_schema 断言辅助
+│   └── mocking/         #   http_mock/database_mock/redis_mock/time_mock
 ├── cli/                 # Layer 3: commands + templates
-├── bootstrap/           # Layer 4: Bootstrap + Providers + Runtime
+├── bootstrap/           # Layer 4: Bootstrap + Providers + RuntimeContext
 └── plugins/             # 横切: MonitoringPlugin + AllurePlugin
 
 cli/templates/
@@ -206,7 +244,7 @@ cli/templates/
 ## 重要提示
 
 - `tests/test_messengers/` 需要外部服务（Kafka/RabbitMQ/RocketMQ），CI 中跳过
-- `engines/` 目录预留，暂未实现
+- `capabilities/engines/` 仅有目录骨架（batch/spark, stream/flink, olap），暂未实现功能
 - Windows 平台使用 `start` 而非 `open` 打开报告
 
 ---

{df_test_framework-4.7.0 → df_test_framework-4.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: df-test-framework
-Version: 4.7.0
+Version: 4.7.2
 Summary: 基于交互模式的现代化测试自动化框架，支持多种测试场景
 Project-URL: Homepage, https://github.com/yourorg/df-test-framework
 Project-URL: Repository, https://github.com/yourorg/df-test-framework
@@ -111,88 +111,84 @@ Description-Content-Type: text/markdown
 
 # DF Test Framework
 
-> 简单、强大、可扩展的现代化 Python 测试自动化框架
+> 企业级 Python 测试自动化框架，支持 HTTP/UI/数据库/消息队列多场景测试
 
 [![PyPI version](https://img.shields.io/pypi/v/df-test-framework.svg)](https://pypi.org/project/df-test-framework/)
 [![Python](https://img.shields.io/badge/python-3.12+-green.svg)](https://www.python.org/)
-[![License](https://img.shields.io/badge/license-MIT-orange.svg)](https://github.com/yourorg/test-framework/blob/master/LICENSE)
+[![License](https://img.shields.io/badge/license-MIT-orange.svg)](https://github.com/yourorg/df-test-framework/blob/master/LICENSE)
 
 ---
 
 ## 核心特性
 
-### v4.0.0 全面异步化 - 性能飞跃 🚀
-
-- **AsyncHttpClient** - 异步 HTTP 客户端，并发性能提升 **10-30 倍**
-- **AsyncDatabase** - 异步数据库客户端，基于 SQLAlchemy 2.0 AsyncEngine
-- **AsyncRedis** - 异步 Redis 客户端，缓存操作提升 **5-10 倍**
-- **AsyncAppActions** - 异步 UI 测试，Playwright 异步 API，性能提升 **2-3 倍**
-- **完全向后兼容** - 同步 API 完整保留，升级路径平滑
-
-### 完整功能
-
-- **HTTP 客户端** - 同步/异步，拦截器链，自动重试
-- **GraphQL/gRPC 客户端** - 完整协议支持
-- **数据库访问** - SQLAlchemy 2.0，Repository + UnitOfWork 模式
-- **消息队列** - Kafka/RabbitMQ/RocketMQ 统一接口
-- **存储客户端** - LocalFile/S3/阿里云 OSS
-- **可观测性** - OpenTelemetry 追踪 + Prometheus 监控
-- **测试工具** - Fixtures、数据构建器、Mock 工具、Allure 集成
+- **多协议客户端** — HTTP/GraphQL/gRPC，同步/异步双模式，中间件拦截器链（重试、签名、Bearer Token）
+- **异步高性能** — `AsyncHttpClient` 并发性能提升 10-30 倍，`AsyncDatabase`/`AsyncRedis` 完整异步支持
+- **UI 自动化** — Playwright，同步/异步，浏览器会话复用，失败自动截图与诊断
+- **数据库访问** — SQLAlchemy 2.0，多方言（MySQL/PostgreSQL/SQLite/MSSQL），Repository + Unit of Work 模式
+- **测试数据管线** — `CaseContext[T]` + YAML 驱动参数化，支持 skip/xfail/seed/tags，CLI 精准过滤复现
+- **多客户端模型** — `@service_client` / `@ui_client`，多服务/多前端场景下独立管理各自的连接与配置
+- **CLI 脚手架** — `df-test init` 一键生成 api/ui/full 项目，内置 Allure + 自动回滚等即用能力
+- **可观测性** — OpenTelemetry 链路追踪 + Prometheus 监控 + Allure 报告自动集成
+- **消息队列** — Kafka/RabbitMQ/RocketMQ 统一接口
+- **存储客户端** — 本地文件 / AWS S3 / 阿里云 OSS
+- **脱敏服务** — HTTP/UI/DB 日志中敏感字段自动遮盖，集中配置
+- **Mock 工具** — HTTP/数据库/Redis/时间 Mock，开箱即用
 
 ---
 
 ## 安装
 
 ```bash
-# 使用 uv（推荐 - 更快更可靠）
+# 使用 uv（推荐）
 uv add df-test-framework
 
 # 使用 pip
 pip install df-test-framework
-
-# 可选依赖
-uv add "df-test-framework[ui]"            # UI 测试（Playwright）
-uv add "df-test-framework[mq]"            # 消息队列
-uv add "df-test-framework[observability]" # 可观测性
-uv add "df-test-framework[storage]"       # 存储客户端
-uv add "df-test-framework[all]"           # 所有功能
 ```
 
+**可选依赖**（按需安装，核心功能无需额外依赖）：
+
+| 依赖组 | 功能 | 安装命令 |
+|--------|------|---------|
+| `ui` | Playwright UI 测试 | `uv add "df-test-framework[ui]"` |
+| `database-async` | 异步数据库驱动（MySQL/PG/SQLite） | `uv add "df-test-framework[database-async]"` |
+| `database-mssql` | MSSQL 驱动 | `uv add "df-test-framework[database-mssql]"` |
+| `mq` | 消息队列（Kafka + RabbitMQ + RocketMQ） | `uv add "df-test-framework[mq]"` |
+| `observability` | OpenTelemetry + Prometheus | `uv add "df-test-framework[observability]"` |
+| `storage` | 对象存储（S3 + 阿里云 OSS） | `uv add "df-test-framework[storage]"` |
+| `crypto` | AES/DES 加解密 | `uv add "df-test-framework[crypto]"` |
+| `all` | 所有可选功能 | `uv add "df-test-framework[all]"` |
+
 ---
 
 ## 快速开始
 
-### 脚手架创建项目
+### 脚手架建项目（推荐）
 
 ```bash
-df-test init my-test-project
-cd my-test-project
-cp .env.example .env
-pytest -v
+df-test init my-project              # API 测试项目
+df-test init my-project --type ui    # UI 测试项目
+df-test init my-project --type full  # API + UI 混合
+
+cd my-project && pytest -v
 ```
 
-### 手动使用
+### API 测试
 
 ```python
-from df_test_framework import Bootstrap, FrameworkSettings
-from pydantic import Field
-
-class DemoSettings(FrameworkSettings):
-    api_base_url: str = Field(default="https://api.example.com")
-
-runtime = (
-    Bootstrap()
-    .with_settings(DemoSettings)
-    .build()
-    .run()
-)
-
-http = runtime.http_client()
-response = http.get("/users/1")
-assert response.status_code == 200
+from df_test_framework import api_class, BaseAPI
+
+@api_class()
+class UserAPI(BaseAPI):
+    def get_user(self, user_id: int):
+        return self.get(f"/users/{user_id}")
+
+def test_get_user(user_api: UserAPI):   # fixture 由 @api_class 自动注册
+    response = user_api.get_user(1)
+    assert response.status_code == 200
 ```
 
-### 异步高性能模式
+### 异步并发测试
 
 ```python
 import asyncio
@@ -202,9 +198,36 @@ async def test_concurrent():
     async with AsyncHttpClient("https://api.example.com") as client:
         tasks = [client.get(f"/users/{i}") for i in range(100)]
         responses = await asyncio.gather(*tasks)
-        assert len(responses) == 100
+        assert all(r.status_code == 200 for r in responses)
+```
+
+### YAML 驱动参数化
+
+```yaml
+# tests/data/login.yaml
+tests:
+  valid_user:
+    title: "正常登录"
+    marks: [smoke]
+    data:
+      username: admin
+      password: secret
+  locked_user:
+    title: "锁定账号登录失败"
+    xfail: "已知 Bug #123"
+    data:
+      username: locked
+      password: secret
+```
+
+```python
+import pytest
+from df_test_framework.testing.data.pipeline import case_dataset, CaseContext
 
-asyncio.run(test_concurrent())
+@pytest.mark.parametrize("ctx", case_dataset("tests/data/login.yaml"))
+def test_login(ctx: CaseContext, login_api):
+    response = login_api.login(ctx.data["username"], ctx.data["password"])
+    assert response.status_code == 200
 ```
 
 ---
@@ -212,24 +235,24 @@ asyncio.run(test_concurrent())
 ## 架构
 
 ```
-Layer 4 ─── bootstrap/          # 引导层：Bootstrap、Providers、Runtime
-Layer 3 ─── testing/ + cli/     # 门面层：Fixtures、CLI 工具、脚手架
+Layer 4 ─── bootstrap/          # 引导层：Bootstrap、Providers、RuntimeContext
+Layer 3 ─── testing/ + cli/     # 门面层：pytest Fixtures、CLI 脚手架
 Layer 2 ─── capabilities/       # 能力层：HTTP/UI/DB/MQ/Storage
 Layer 1 ─── infrastructure/     # 基础设施：config/logging/events/plugins
-Layer 0 ─── core/               # 核心层：纯抽象（无依赖）
-横切 ───── plugins/             # 插件：MonitoringPlugin、AllurePlugin
+Layer 0 ─── core/               # 核心层：纯抽象（无第三方依赖）
+横切  ───── plugins/             # 插件：MonitoringPlugin、AllurePlugin
 ```
 
 ---
 
 ## 文档
 
-完整文档请访问 [GitHub 仓库](https://github.com/yourorg/test-framework)：
+完整文档见项目 GitHub 仓库：
 
-- [快速开始指南](https://github.com/yourorg/test-framework/blob/master/docs/user-guide/QUICK_START.md)
-- [完整用户手册](https://github.com/yourorg/test-framework/blob/master/docs/user-guide/USER_MANUAL.md)
-- [API 参考](https://github.com/yourorg/test-framework/tree/master/docs/api-reference)
-- [版本发布说明](https://github.com/yourorg/test-framework/tree/master/docs/releases)
+- [快速开始](https://github.com/yourorg/df-test-framework/blob/master/docs/user-guide/QUICK_START.md)
+- [用户手册](https://github.com/yourorg/df-test-framework/blob/master/docs/user-guide/USER_MANUAL.md)
+- [发布说明](https://github.com/yourorg/df-test-framework/blob/master/docs/releases/)
+- [更新日志](https://github.com/yourorg/df-test-framework/blob/master/CHANGELOG.md)
 
 ---