PyPI - df-test-framework - Versions diffs - 4.7.1__tar.gz → 4.7.2__tar.gz - Mend

df-test-framework 4.7.1tar.gz → 4.7.2tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (912) hide show

{df_test_framework-4.7.1 → df_test_framework-4.7.2}/AGENTS.md RENAMED Viewed

@@ -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.1 → df_test_framework-4.7.2}/CHANGELOG.md RENAMED Viewed

@@ -5,6 +5,19 @@
 格式基于 [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
 ### 🐛 修复

{df_test_framework-4.7.1 → df_test_framework-4.7.2}/CLAUDE.md RENAMED Viewed

@@ -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.1 → df_test_framework-4.7.2}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: df-test-framework
-Version: 4.7.1
+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)
 ---

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

df-test-framework 4.7.1tar.gz → 4.7.2tar.gz