PyPI - df-test-framework - Versions diffs - 4.10.1__tar.gz → 4.10.3__tar.gz - Mend

df-test-framework 4.10.1tar.gz → 4.10.3tar.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 (1053) hide show

{df_test_framework-4.10.1 → df_test_framework-4.10.3}/.github/workflows/docs.yml RENAMED Viewed

@@ -30,9 +30,12 @@ jobs:
     timeout-minutes: 10
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
-    - uses: astral-sh/setup-uv@v3
+    - uses: astral-sh/setup-uv@v7
+      with:
+        version: "latest"
+        enable-cache: false
     - name: 安装依赖
       run: uv sync

{df_test_framework-4.10.1 → df_test_framework-4.10.3}/.github/workflows/lint.yml RENAMED Viewed

@@ -24,15 +24,18 @@ jobs:
     steps:
     - name: 检出代码
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
     - name: 设置Python 3.12
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: '3.12'
     - name: 安装uv
-      uses: astral-sh/setup-uv@v3
+      uses: astral-sh/setup-uv@v7
+      with:
+        version: "latest"
+        enable-cache: false
     - name: 同步依赖
       run: |

{df_test_framework-4.10.1 → df_test_framework-4.10.3}/.github/workflows/release.yml RENAMED Viewed

@@ -26,10 +26,10 @@ jobs:
     steps:
     - name: 检出代码
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
     - name: 设置Python 3.12
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: '3.12'
@@ -53,10 +53,10 @@ jobs:
     steps:
     - name: 检出代码
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
     - name: 设置Python 3.12
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: '3.12'
@@ -66,7 +66,10 @@ jobs:
         pip install build twine
     - name: 安装uv
-      uses: astral-sh/setup-uv@v3
+      uses: astral-sh/setup-uv@v7
+      with:
+        version: "latest"
+        enable-cache: false
     - name: 安装锁定的检查工具
       run: uv sync --locked
@@ -113,9 +116,10 @@ jobs:
         aes = aes_encrypt("验收", key=key, mode="ECB")
         assert aes_decrypt(aes, key=key, mode="ECB") == "验收"
         PY
+        "$RUNNER_TEMP/release-smoke/bin/python" -I "$GITHUB_WORKSPACE/scripts/smoke_config_release.py" "$EXPECTED"
     - name: 上传构建产物
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v6
       with:
         name: dist-packages
         path: dist/
@@ -140,7 +144,7 @@ jobs:
     steps:
     - name: 下载构建产物
-      uses: actions/download-artifact@v4
+      uses: actions/download-artifact@v7
       with:
         name: dist-packages
         path: dist/
@@ -170,18 +174,18 @@ jobs:
     steps:
     - name: 检出代码
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
       with:
         fetch-depth: 0  # 获取完整历史用于生成changelog
     - name: 下载构建产物
-      uses: actions/download-artifact@v4
+      uses: actions/download-artifact@v7
       with:
         name: dist-packages
         path: dist/
     - name: 设置Python 3.12
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: '3.12'
@@ -194,7 +198,7 @@ jobs:
         python scripts/check_release.py "$VERSION" --notes release_notes.md
     - name: 创建GitHub Release
-      uses: softprops/action-gh-release@v2
+      uses: softprops/action-gh-release@v3
       with:
         name: v${{ steps.changelog.outputs.version }}
         body_path: release_notes.md

{df_test_framework-4.10.1 → df_test_framework-4.10.3}/.github/workflows/scheduled.yml RENAMED Viewed

@@ -13,15 +13,18 @@ jobs:
     steps:
     - name: 检出代码
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
     - name: 设置Python 3.12
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: '3.12'
     - name: 安装uv
-      uses: astral-sh/setup-uv@v3
+      uses: astral-sh/setup-uv@v7
+      with:
+        version: "latest"
+        enable-cache: false
     - name: 同步依赖
       run: |
@@ -99,10 +102,10 @@ jobs:
     steps:
     - name: 检出代码
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
     - name: 设置Python 3.12
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: '3.12'

{df_test_framework-4.10.1 → df_test_framework-4.10.3}/.github/workflows/security.yml RENAMED Viewed

@@ -20,10 +20,10 @@ jobs:
     steps:
       - name: 检出代码
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - name: 设置 Python 环境
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: '3.12'
           cache: 'pip'
@@ -84,7 +84,7 @@ jobs:
           fi
       - name: 上传扫描报告
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v6
         if: always()
         with:
           name: security-reports-${{ github.run_number }}
@@ -166,10 +166,10 @@ jobs:
     steps:
       - name: 检出代码
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - name: 设置 Python 环境
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: '3.12'
           cache: 'pip'
@@ -205,7 +205,7 @@ jobs:
           fi
       - name: 上传质量报告
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v6
         if: always()
         with:
           name: quality-reports-${{ github.run_number }}
@@ -221,7 +221,7 @@ jobs:
     steps:
       - name: 检出代码
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           fetch-depth: 0  # 获取完整历史，检查所有提交
@@ -231,6 +231,6 @@ jobs:
           extra_args: --only-verified
       - name: Gitleaks - 备用密钥扫描
-        uses: gitleaks/gitleaks-action@v2
+        uses: gitleaks/gitleaks-action@v3
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

{df_test_framework-4.10.1 → df_test_framework-4.10.3}/.github/workflows/test.yml RENAMED Viewed

@@ -50,15 +50,18 @@ jobs:
     steps:
     - name: 检出代码
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
     - name: 设置Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: ${{ matrix.python-version }}
     - name: 安装uv
-      uses: astral-sh/setup-uv@v3
+      uses: astral-sh/setup-uv@v7
+      with:
+        version: "latest"
+        enable-cache: false
     - name: 同步依赖（使用 uv sync）
       run: |
@@ -140,15 +143,18 @@ jobs:
     steps:
     - name: 检出代码
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
     - name: 设置Python 3.12
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: '3.12'
     - name: 安装uv
-      uses: astral-sh/setup-uv@v3
+      uses: astral-sh/setup-uv@v7
+      with:
+        version: "latest"
+        enable-cache: false
     - name: 同步依赖
       run: |
@@ -160,7 +166,7 @@ jobs:
         uv run df-test init api-test-project --type api
         test -f api-test-project/pyproject.toml
         test -f api-test-project/config/base.yaml
-        test -f api-test-project/config/secrets/.env.local.example
+        test -f api-test-project/config/secrets/.env.test.example
         # v4.9.5: 最小骨架 + 类型真裁剪
         test -f api-test-project/src/api_test_project/apis/example_api.py
         test -f api-test-project/src/api_test_project/clients/http_clients.py
@@ -178,7 +184,7 @@ jobs:
       run: |
         uv run df-test init ui-test-project --type ui
         test -f ui-test-project/pyproject.toml
-        test -f ui-test-project/config/secrets/.env.local.example
+        test -f ui-test-project/config/secrets/.env.test.example
         # v4.9.5: 最小骨架 + 类型真裁剪
         test -f ui-test-project/src/ui_test_project/actions/example_actions.py
         test -f ui-test-project/src/ui_test_project/pages/example_page.py

{df_test_framework-4.10.1 → df_test_framework-4.10.3}/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.10.1
-- **更新时间**: 2026-09-29
+- **版本**: v4.10.3
+- **更新时间**: 2026-11-04
 - **Python**: 3.12+
 - **核心技术栈**: pytest + httpx + Playwright + Pydantic v2 + SQLAlchemy 2.0 + Pluggy
 - **架构**: 五层架构 + 横切关注点（能力层驱动设计）

{df_test_framework-4.10.1 → df_test_framework-4.10.3}/CHANGELOG.md RENAMED Viewed

@@ -7,6 +7,65 @@
 ## [Unreleased]
+## [4.10.3] - 2026-11-04
+> 含 HTTP 重试参数与请求参数的破坏性变更。维护者指定按 PATCH 发布，依据是消费项目
+> 由内部统一维护并同步迁移；详见 [v4.10.3 发布说明](docs/releases/v4.10.3.md)。
+### HTTP 重试参数统一（破坏性变更）
+- HTTPConfig、HttpClient/AsyncHttpClient、RetryMiddleware 及其配置统一使用 `retries`，
+  表示首次之外的额外次数；默认值为 0。单请求 `retries=N` 覆盖，`None` 继承。
+- 移除 HTTP `max_retries`，环境变量改为 `HTTP__RETRIES`。YAML 中的旧键 `max_retries`
+  不再读取，升级时须改名；工厂、Provider、CLI、生成模板及当前指南同步迁移。
+- 同一客户端只保留一个重试执行器，手动配置替换默认执行器，避免叠加放大发送次数。
+  重试耗尽以最后一次响应或异常为准，显式空状态码/异常列表不回退默认值。
+- 详细迁移见 [HTTP 客户端指南](docs/guides/http_client_guide.md#从旧名称迁移)。
+### HTTP 请求参数显式化（破坏性变更）
+- 同步/异步客户端只接受已支持的请求参数，未识别参数（如拼写错误 `jsoon=`、`timout=`）
+  在发送前报 `TypeError`，不再被静默丢弃。
+- 新增单请求 `follow_redirects`；此前该参数被丢弃，始终按客户端默认跟随重定向。
+- 修复多值查询参数被压掉同名值：`params=[("a","1"),("a","2")]` 此前实际只发送 `?a=2`；
+  现统一规范为字典（多值为列表），支持键值对序列、查询字符串与 `httpx.QueryParams`。
+- 修复 `ApiKeyMiddleware` 查询参数模式在请求未传 `params` 时报 `TypeError`。
+- 新增 [HTTP 客户端接口支持面方案](docs/development/http-client-interface-plan.md)（讨论草案）。
+### 国密导出修复
+- 修复包级 `sm3` 被同名实现子模块遮蔽：先使用 `SM3Hasher` 等后，`crypto.sm3` 变成模块，
+  `sm3()` 与 `digest_sign(algorithm="sm3")` 报 `'module' object is not callable`。
+  实现模块改为私有 `_sm2/_sm3/_sm4/_aes`，公共接口仍从 `infrastructure.crypto` 包导入。
+### 运行依赖修复
+- 补齐同步 HTTP/GraphQL 在运行中事件循环调用所需的 `nest-asyncio` 核心依赖。
+  原安装包在 API 与 Playwright 混合回归的后续前置中可能报缺模块；
+  修复依赖声明及嵌套循环请求回归，不改客户端公开接口或业务项目配置。
+### CI 与脚手架
+- 仓库工作流和 GitHub Actions 脚手架模板升级为 Node.js 24 Action：
+  checkout v5、setup-python v6、setup-uv v7、upload-artifact v6、
+  download-artifact v7、action-gh-release v3、gitleaks-action v3。
+- setup-uv 显式保留安装 latest uv 与关闭缓存的策略，避免升级默认值改变执行行为；
+  模板更新随下一版包交付，已发布版本与标签保持不变。
+## [4.10.2] - 2026-10-10
+### 配置按环境隔离（破坏性配置迁移，维护者指定 PATCH）
+- secrets 改用共享 `.env` 和环境专属 `.env.{env}`；本机 YAML 改为
+  `{env}.local.yaml`，通过 pytest/CLI `--local` 或 API `local=True` 显式启用。
+- 环境名支持受字符约束的自定义名称，显式环境身份不受文件或进程变量再次覆盖；
+  缓存按实际环境与覆盖开关区分，pytest 不再改写进程 ENV。
+- `_extends` 对所有 YAML 层按声明文件目录解析；写坏的 YAML、循环、缺失引用报错，
+  普通可选文件缺省仍可只用 base 或默认值运行。
+- 自定义环境可声明 `production: true`，统一生产守卫；prod/production 不可解除保护。
+- 迁移原 test 调试文件为 `test.local.yaml`、`.env.test`，命令改为
+  `--env=test --local`；无历史文件告警或 doctor 失败规则。模板、指南和来源诊断同步。
 ## [4.10.1] - 2026-09-29
 ### 发布配套

{df_test_framework-4.10.1 → df_test_framework-4.10.3}/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.10.1
-- **更新时间**: 2026-09-29
+- **版本**: v4.10.3
+- **更新时间**: 2026-11-04
 - **Python**: 3.12+
 - **核心技术栈**: pytest + httpx + Playwright + Pydantic v2 + SQLAlchemy 2.0 + Pluggy
 - **架构**: 五层架构 + 横切关注点（能力层驱动设计）

{df_test_framework-4.10.1 → df_test_framework-4.10.3}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: df-test-framework
-Version: 4.10.1
+Version: 4.10.3
 Summary: 基于交互模式的现代化测试自动化框架，支持多种测试场景
 Author-email: DF QA Team <qa@example.com>
 License: MIT
@@ -28,6 +28,7 @@ Requires-Dist: jinja2>=3.1.0
 Requires-Dist: jsonpath-ng>=1.7.0
 Requires-Dist: jsonschema-spec>=0.2.4
 Requires-Dist: jsonschema>=4.25.1
+Requires-Dist: nest-asyncio>=1.6.0
 Requires-Dist: openpyxl>=3.1.0
 Requires-Dist: pluggy>=1.5.0
 Requires-Dist: prance[osv]>=23.6.0

{df_test_framework-4.10.1 → df_test_framework-4.10.3}/README.md RENAMED Viewed

@@ -1,7 +1,7 @@
 # DF Test Framework
-> **版本**: v4.10.1
-> **更新时间**: 2026-09-29
+> **版本**: v4.10.3
+> **更新时间**: 2026-11-04
 > 简单、强大、可扩展的现代化 Python 测试自动化框架
 [![PyPI version](https://img.shields.io/pypi/v/df-test-framework.svg)](https://pypi.org/project/df-test-framework/)

{df_test_framework-4.10.1 → df_test_framework-4.10.3}/docs/ESSENTIAL_DOCS.md RENAMED Viewed

@@ -1,8 +1,8 @@
 # 核心文档导航 - 真正有价值的文档清单
 > **目标读者**: 测试开发人员、框架使用者、新团队成员
-> **更新日期**: 2026-09-29
-> **框架版本**: v4.10.1
+> **更新日期**: 2026-11-04
+> **框架版本**: v4.10.3
 ---

{df_test_framework-4.10.1 → df_test_framework-4.10.3}/docs/FAQ.md RENAMED Viewed

@@ -179,19 +179,19 @@ my-project/
 ├── config/
 │   ├── base.yaml              # 基础配置（所有环境共享）
 │   ├── environments/
-│   │   ├── local.yaml         # 本地开发环境
+│   │   ├── test.local.yaml    # --local 显式启用的本机覆盖
 │   │   ├── dev.yaml           # 开发环境
 │   │   ├── test.yaml          # 测试环境
 │   │   ├── staging.yaml       # 预发布环境
 │   │   └── prod.yaml          # 生产环境
 │   └── secrets/               # 敏感配置（已 .gitignore）
-│       └── .env.local         # 本地敏感配置
+│       └── .env.test          # test 环境敏感配置
 └── tests/
 ```
 **配置优先级**（从高到低）：
 1. 环境变量（最高优先级）
-2. `config/secrets/.env.local`
+2. `config/secrets/.env.test`
 3. `config/environments/{env}.yaml`
 4. `config/base.yaml`
 5. `.env` + `.env.{env}`（回退模式）
@@ -245,7 +245,7 @@ export DB__DATABASE="test_db"
 **敏感信息**（密码）：
 ```bash
-# config/secrets/.env.local
+# config/secrets/.env.test
 DB_PASSWORD=your_secret_password
 ```

{df_test_framework-4.10.1 → df_test_framework-4.10.3}/docs/README.md RENAMED Viewed

@@ -1,6 +1,6 @@
 # DF Test Framework 文档中心
-> 版本：v4.10.1 · 最近更新：2026-09-01
+> 版本：v4.10.3 · 最近更新：2026-09-01
 > 现代化 Python 测试自动化框架的官方知识库。
 ---

{df_test_framework-4.10.1 → df_test_framework-4.10.3}/docs/architecture/CODE_STRUCTURE.md RENAMED Viewed

@@ -281,7 +281,7 @@ infrastructure/plugins/
 infrastructure/helpers/
 ├── __init__.py          # 统一导出
 ├── hash.py              # MD5/SHA256/HMAC-SHA256（基于 stdlib）
-├── crypto.py            # AES 文本门面（实现在 infrastructure/crypto/aes.py，需 crypto extra）
+├── crypto.py            # AES 文本门面（实现在 infrastructure/crypto/_aes.py，需 crypto extra）
 ├── national_crypto.py   # 国密便捷层 SM2Cipher/SM2Signer/SM4Cipher（需 gm extra）
 ├── signature.py         # API 参数签名计算
 └── network.py           # 公网 IP 探测
@@ -289,7 +289,7 @@ infrastructure/helpers/
 **关键函数**：
 - `md5(text)` / `sha256(text)` / `hmac_sha256(text, secret)` - 哈希函数
-- `aes_encrypt()` / `aes_decrypt()` - AES-CBC/ECB 文本门面（字节核心在 `infrastructure/crypto/aes.py`，需 `crypto` 可选依赖）
+- `aes_encrypt()` / `aes_decrypt()` - AES-CBC/ECB 文本门面（字节核心在 `infrastructure/crypto/_aes.py`，需 `crypto` 可选依赖）
 - `compute_sign(params, secret)` - API 参数签名（支持 MD5/SHA256/HMAC-SHA256）
 - `get_public_ip()` - 公网出口 IP 探测

{df_test_framework-4.10.1 → df_test_framework-4.10.3}/docs/architecture/TEST_EXECUTION_LIFECYCLE.md RENAMED Viewed

@@ -60,7 +60,7 @@ Hook 执行顺序由 `@pytest.hookimpl(tryfirst/trylast)` 控制：env_plugin
 ```
 1. 环境变量（OBSERVABILITY__DEBUG_OUTPUT=true，双下划线嵌套）
-2. Secrets 文件（config/secrets/.env.local）
+2. Secrets 文件（config/secrets/.env.test）
 3. 环境 YAML（config/environments/{env}.yaml，支持 _extends 继承链）
 4. 基础 YAML（config/base.yaml）
 5. .env 文件（回退模式）

{df_test_framework-4.10.1 → df_test_framework-4.10.3}/docs/architecture/multi-project-reuse.md RENAMED Viewed

@@ -238,7 +238,7 @@ class MicroserviceConfig(BaseModel):
     name: str
     base_url: str
     timeout: int = 30
-    max_retries: int = 3
+    retries: int = 3
     api_version: str = "v1"
 class AuthConfig(BaseModel):

{df_test_framework-4.10.1 → df_test_framework-4.10.3}/docs/architecture/national-crypto-design.md RENAMED Viewed

@@ -48,7 +48,7 @@ SM3 一次性和增量摘要；HMAC-SM3；SM4-GCM 与 CBC/ECB 协议互操作。
 它是新 API 的便利门面，不是已删除旧接口的兼容包装。
 **结构规则（2026-09-22 评审决定，本批已落实）**：`infrastructure/crypto/` 是所有密码原语的唯一归属，
-helpers 只放文本/编码门面。AES 已同批归位：`crypto/aes.py` 字节核心（pycryptodome，`crypto` extra），
+helpers 只放文本/编码门面。AES 已同批归位：`crypto/_aes.py` 字节核心（pycryptodome，`crypto` extra），
 `helpers/crypto.py` 保留原 `aes_encrypt/aes_decrypt` 签名只做编码转换。`crypto` 包按子模块懒加载，
 导入包不绑定任何 extra，缺哪组依赖只影响对应算法。不得再向 helpers 新增算法实现。
@@ -150,13 +150,15 @@ SM4 nonce/IV 每次调用时传入，不保存在配置对象中。不自动生
 ## 6. 实现地图
 以下路径均相对仓库根目录；公开入口可以从 `df_test_framework` 按需导入。
+`crypto/` 下带下划线前缀的实现模块是私有的，只通过 `infrastructure.crypto` 包导入公共接口，
+避免子模块与同名导出（如 `sm3`）互相遮蔽。
 | 文件 | 实现职责 |
 |---|---|
-| `infrastructure/crypto/sm2.py`（位于 `src/df_test_framework/` 下） | 密钥对象、ASN.1、SM2 消息签名及密文格式 |
-| 同目录 `sm3.py`、`sm4.py`、`_common.py` | 摘要/MAC、模式专用 SM4、字节类型校验 |
+| `infrastructure/crypto/_sm2.py`（位于 `src/df_test_framework/` 下） | 密钥对象、ASN.1、SM2 消息签名及密文格式 |
+| 同目录 `_sm3.py`、`_sm4.py`、`_common.py` | 摘要/MAC、模式专用 SM4、字节类型校验 |
 | `src/df_test_framework/infrastructure/helpers/national_crypto.py` | 文本/编码便捷对象与密钥加载器 |
-| `src/df_test_framework/infrastructure/crypto/aes.py`、`helpers/crypto.py` | AES 字节核心与保留签名的文本门面（`crypto` extra） |
+| `src/df_test_framework/infrastructure/crypto/_aes.py`、`helpers/crypto.py` | AES 字节核心与保留签名的文本门面（`crypto` extra） |
 | `src/df_test_framework/infrastructure/crypto/__init__.py` | 核心导出、缺 extra 的安装提示 |
 | `src/df_test_framework/infrastructure/helpers/__init__.py` | 便捷层懒加载导出 |
 | `src/df_test_framework/__init__.py` | 顶层懒加载及类型检查入口 |

{df_test_framework-4.10.1 → df_test_framework-4.10.3}/docs/architecture/test-type-support.md RENAMED Viewed

@@ -80,7 +80,7 @@ class HttpClient:
     def _execute_with_retry(self, method: str, url: str, **kwargs):
         last_exception = None
-        for attempt in range(self._max_retries + 1):
+        for attempt in range(self._retries + 1):
             try:
                 response = self._client.request(method, url, **kwargs)
@@ -88,17 +88,17 @@ class HttpClient:
                 if response.status_code < 500:
                     return response
-                if attempt < self._max_retries:
+                if attempt < self._retries:
                     self._logger.warning(
                         f"请求失败 ({response.status_code})，"
                         f"将在 {self._retry_delay * (2 ** attempt)}s 后重试..."
                     )
             except (httpx.ConnectError, httpx.TimeoutException) as e:
                 last_exception = e
-                if attempt < self._max_retries:
+                if attempt < self._retries:
                     self._logger.warning(f"连接错误，将重试: {e}")
-            if attempt < self._max_retries:
+            if attempt < self._retries:
                 delay = self._retry_delay * (2 ** attempt)  # 指数退避
                 time.sleep(delay)
@@ -109,7 +109,7 @@ class HttpClient:
 ```python
 class HTTPConfig(BaseModel):
-    max_retries: int = 3        # 最大重试次数
+    retries: int = 3        # 最大重试次数
     retry_delay: float = 1.0    # 初始重试延迟（秒）
     retry_on_status: List[int] = [500, 502, 503, 504]  # 重试的状态码
 ```

{df_test_framework-4.10.1 → df_test_framework-4.10.3}/docs/development/BACKLOG.md RENAMED Viewed

@@ -49,6 +49,8 @@
 | 12 | ✅ 文档大修四篇（2026-08-20 完成：USER_MANUAL 导航型、TEST_EXECUTION_LIFECYCLE 七层模型重写、extension-points 合并 api-reference/extensions、BEST_PRACTICES 吸收 VERIFIED 实战模式并按 v4.9 API 更新；顺带更新 observability-architecture 现状标记） | 完成 | 2026-08-20 整理批次只做了"部分过时"警示头，完整重写待办：USER_MANUAL 瘦身为导航型（停止维护与 guides 重复的示例）、TEST_EXECUTION_LIFECYCLE 按七层模型重写（45KB）、extension-points 与 api-reference/extensions 合并、BEST_PRACTICES 深度合并（吸收 VERIFIED 的实战片段） |
 | ~~14~~ | ~~PageMock 轮换/延迟响应~~（v4.9.23 已完成：route_json_sequence + 全注册方法 delay_ms，双轨镜像+对账） | ~~低~~ | yx-mixue 收敛批（2026-08-21）发现：PageMock 不支持按调用轮换响应与延迟响应，项目留 74 行扩展 tests/ui/page_mock_extensions.py（route_json_sequence/route_delayed_json）——第二个项目需要时下沉框架（双轨镜像 AsyncPageMock） |
 | 13 | 统一推送远端 | **待用户确认** | v4.9.11 起本地累积提交（GitHub Actions 额度约束），一次 push origin master |
+| 15 | [HTTP 接口支持面设计](http-client-interface-plan.md) | 中 | 后续讨论草案，不扩大 v4.10.3 收尾范围。多值查询参数被压成 `?a=2` 的缺陷已于 v4.10.3 修复；后续按 extensions、认证策略与 auth、Cookie 管理、流式接口及其余参数表达能力推进；客户端默认跟随重定向保持不变。详细边界、待定项和验收要求见方案，排期另定 |
+| 16 | 消费项目迁移至 4.10.3 | 高（发布后） | Master/FSC：`max_retries`→`retries`（属性读取、构造参数、`model_copy` 键、测试桩、YAML、`HTTP__MAX_RETRIES` 文档），写接口改按请求声明 `retries=0`；切换前以本地源码跑单元、`--collect-only` 与代表性 API 用例，确认无未知参数 TypeError |
 ## 已决策记录

{df_test_framework-4.10.1 → df_test_framework-4.10.3}/docs/development/RELEASE.md RENAMED Viewed

@@ -34,6 +34,8 @@ uv run --no-sync python scripts/check_release.py X.Y.Z
 本地构建用 `uvx --from build pyproject-build --outdir <本次新建空目录>`，
 再用 `uvx twine check <产物文件>` 检查；不要混入历史 dist。
 独立虚拟环境安装 wheel，从仓库外核验版本、CLI 与受影响公共入口。
+配置与三类脚手架可用该环境的 Python 执行
+`-I <仓库绝对路径>/scripts/smoke_config_release.py X.Y.Z` 验收。
 源码测试通过不代表打包清单或 extras 正确。
 模板变更运行 `tests/cli/test_init_cmd.py`，覆盖三类型结构、AST、导入和生成物 Ruff。

df-test-framework 4.10.1__tar.gz → 4.10.3__tar.gz

df-test-framework 4.10.1tar.gz → 4.10.3tar.gz