df-test-framework 4.10.0__tar.gz → 4.10.2__tar.gz

df_test_framework-4.10.2/.github/workflows/README.md

@@ -0,0 +1,33 @@
+# GitHub Actions 工作流
+
+发布操作、恢复与验收见 [发布流程](../../docs/development/RELEASE.md)。
+本页描述框架仓库 CI，不是测试项目脚手架生成的流水线。
+
+| 文件 | 触发与职责 |
+|---|---|
+| test.yml | 代码 push：Ubuntu/3.12；PR、手动、周一 UTC 00:30：六矩阵；发布调用强制全矩阵，随后验收 CLI |
+| lint.yml | 代码 push/PR 的 Ruff 检查 |
+| docs.yml | 文档 push/PR 或手动，检查死链、导入路径与版本 |
+| release.yml | 标签：验证→完整测试→构建/安装→PyPI→Release；手动输入版本只验证/构建 |
+| security.yml | 周日 UTC 00:00 或手动安全扫描 |
+| scheduled.yml | 历史名称保留，当前仅手动，无每日定时 |
+
+## 发布门禁
+
+- 版本/标签必须匹配包版本，发布材料必须存在。
+- 矩阵通过 UV_PYTHON 覆盖 .python-version，并断言实际解释器。
+- gm/crypto 显式安装；国密互通用 DF_GM_REQUIRED=1，缺依赖不得跳过。
+- 独立 wheel 环境从仓库外验收，PyPI 与 Release 使用同一份产物。
+- 发布队列不取消正在发布的任务；复用测试与发布使用不同并发组，避免互相取消，
+  见 [GitHub 复用限制](https://docs.github.com/en/actions/reference/workflows-and-actions/reusing-workflow-configurations)。
+
+## 配置与排障
+
+release Environment 保存项目范围 PYPI_API_TOKEN，并允许版本标签。
+可选 DINGTALK_WEBHOOK 用于标签发布结果通知，不输出 Secret 排障。
+区分版本错误、依赖缺失、解释器不符、包清单遗漏和重复版本，不以跳过测试、
+移动已发布标签或 skip-existing 解决。
+
+跨系统 CI 与真实服务验收范围不同，mock/离线通过不代表业务环境可用。
+
+更新日期：2026-09-22。

{df_test_framework-4.10.0 → df_test_framework-4.10.2}/.github/workflows/release.yml

@@ -7,16 +7,20 @@ on:
   workflow_dispatch:  # 允许手动触发
     inputs:
       version:
-        description: '发布版本号 (如 2.0.0)'
+        description: '仅验证和构建的版本号（不发布，例如 4.10.1）'
         required: true
         type: string
 
 permissions:
   contents: write  # 允许创建 Release 和上传资源
 
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
 jobs:
-  test:
-    name: 发布前测试
+  validate:
+    name: 校验发布版本与文档
     runs-on: ubuntu-latest
     timeout-minutes: 20
 
@@ -29,24 +33,17 @@ jobs:
       with:
         python-version: '3.12'
 
-    - name: 安装uv
-      uses: astral-sh/setup-uv@v3
-
-    - name: 同步依赖
-      run: |
-        uv sync
-
-    - name: 代码质量检查
-      run: |
-        uv run ruff check src/
-        uv run ruff format src/ --check
+    - name: 版本与发布材料必须匹配
+      env:
+        RELEASE_VERSION: ${{ github.event_name == 'push' && github.ref_name || inputs.version }}
+      run: python scripts/check_release.py "$RELEASE_VERSION"
 
-    - name: CLI功能测试
-      run: |
-        uv run df-test --help
-        uv run df-test init test-release-project --type api
-        test -f test-release-project/pyproject.toml
-        test -d test-release-project/src
+  test:
+    name: 发布前完整测试
+    needs: validate
+    uses: ./.github/workflows/test.yml
+    with:
+      full_matrix: true
 
   build:
     name: 构建分发包
@@ -68,6 +65,17 @@ jobs:
         python -m pip install --upgrade pip
         pip install build twine
 
+    - name: 安装uv
+      uses: astral-sh/setup-uv@v3
+
+    - name: 安装锁定的检查工具
+      run: uv sync --locked
+
+    - name: 代码质量检查（不自动修改发布源码）
+      run: |
+        uv run --no-sync ruff check src/ tests/ scripts/check_release.py
+        uv run --no-sync ruff format src/ tests/ scripts/check_release.py --check
+
     - name: 构建分发包
       run: |
         python -m build
@@ -76,6 +84,37 @@ jobs:
       run: |
         twine check dist/*
 
+    - name: 独立环境验收 wheel 与可选密码入口
+      run: |
+        WHEEL=$(realpath dist/*.whl)
+        EXPECTED=$(python -c 'import tomllib; print(tomllib.load(open("pyproject.toml", "rb"))["project"]["version"])')
+        python -m venv "$RUNNER_TEMP/release-smoke"
+        "$RUNNER_TEMP/release-smoke/bin/python" -m pip install "$WHEEL[gm,crypto]"
+        cd "$RUNNER_TEMP"
+        "$RUNNER_TEMP/release-smoke/bin/df-test" --help
+        "$RUNNER_TEMP/release-smoke/bin/python" -I - "$EXPECTED" <<'PY'
+        import secrets
+        import sys
+        from importlib.metadata import version
+        from df_test_framework import SM2PrivateKey, SM2_DEFAULT_USER_ID
+        from df_test_framework.infrastructure.helpers import (
+            SM2Cipher, SM2Signer, SM4Cipher, aes_encrypt, aes_decrypt,
+        )
+        assert version("df-test-framework") == sys.argv[1]
+        private = SM2PrivateKey.generate()
+        signer = SM2Signer(key=private, user_id=SM2_DEFAULT_USER_ID, signature_format="der")
+        signer.verify_text(signer.sign_text("验收"), "验收")
+        cipher = SM2Cipher(key=private, ciphertext_format="c1c3c2")
+        assert cipher.decrypt_text(cipher.encrypt_text("验收")) == "验收"
+        sm4 = SM4Cipher(key=secrets.token_bytes(16), mode="GCM")
+        nonce = secrets.token_bytes(12)
+        assert sm4.decrypt_text(sm4.encrypt_text("验收", nonce=nonce), nonce=nonce) == "验收"
+        key = secrets.token_bytes(16)
+        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
       with:
@@ -111,7 +150,6 @@ jobs:
       uses: pypa/gh-action-pypi-publish@release/v1
       with:
         password: ${{ secrets.PYPI_API_TOKEN }}
-        skip-existing: true
 
     - name: 发布总结
       run: |
@@ -128,7 +166,7 @@ jobs:
     name: 创建GitHub Release
     runs-on: ubuntu-latest
     timeout-minutes: 20
-    needs: build
+    needs: [build, publish-pypi]
     if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
 
     steps:
@@ -143,24 +181,18 @@ jobs:
         name: dist-packages
         path: dist/
 
+    - name: 设置Python 3.12
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.12'
+
     - name: 生成变更日志
       id: changelog
       run: |
         VERSION=${GITHUB_REF#refs/tags/v}
         echo "version=$VERSION" >> $GITHUB_OUTPUT
 
-        # 提取CHANGELOG.md中的当前版本内容（如果存在）
-        if [ -f CHANGELOG.md ]; then
-          # 提取## [VERSION]到下一个## [之间的内容
-          CHANGES=$(sed -n "/## \[${VERSION}\]/,/## \[/p" CHANGELOG.md | sed '$ d' | tail -n +2)
-          if [ -n "$CHANGES" ]; then
-            echo "$CHANGES" > release_notes.md
-          else
-            echo "查看完整变更日志: [CHANGELOG.md](CHANGELOG.md)" > release_notes.md
-          fi
-        else
-          echo "查看完整变更历史: [Commits](https://github.com/${{ github.repository }}/commits/v${VERSION})" > release_notes.md
-        fi
+        python scripts/check_release.py "$VERSION" --notes release_notes.md
 
     - name: 创建GitHub Release
       uses: softprops/action-gh-release@v2
@@ -185,7 +217,7 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 20
     needs: [publish-pypi, create-release]
-    if: always()
+    if: always() && github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
 
     steps:
     - name: 发送钉钉通知

{df_test_framework-4.10.0 → df_test_framework-4.10.2}/.github/workflows/test.yml

@@ -12,17 +12,24 @@ on:
     - pyproject.toml
     - uv.lock
     - .github/workflows/test.yml
+    - .github/workflows/release.yml
+    - scripts/check_release.py
   pull_request:
     branches: [ main, master, develop ]
     paths: *code_paths
   workflow_dispatch:  # 允许手动触发（跑全矩阵）
+  workflow_call:  # 发布工作流复用，强制全矩阵
+    inputs:
+      full_matrix:
+        type: boolean
+        default: true
   schedule:
     # 每周一 UTC 00:30 全矩阵兜底（直接在 master 开发、无 PR 流的现实下，
     # 这是跨 OS/跨版本差异——如 macOS greenlet 类问题——的唯一稳定执行点）
     - cron: '30 0 * * 1'
 
 concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
+  group: tests-${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
 jobs:
@@ -38,8 +45,8 @@ jobs:
       fail-fast: false
       # push=核心单矩阵（ubuntu+3.12）；PR/手动/每周定时=全矩阵
       matrix:
-        os: ${{ github.event_name == 'push' && fromJSON('["ubuntu-latest"]') || fromJSON('["ubuntu-latest", "windows-latest", "macos-latest"]') }}
-        python-version: ${{ github.event_name == 'push' && fromJSON('["3.12"]') || fromJSON('["3.12", "3.13"]') }}
+        os: ${{ github.event_name == 'push' && !inputs.full_matrix && fromJSON('["ubuntu-latest"]') || fromJSON('["ubuntu-latest", "windows-latest", "macos-latest"]') }}
+        python-version: ${{ github.event_name == 'push' && !inputs.full_matrix && fromJSON('["3.12"]') || fromJSON('["3.12", "3.13"]') }}
 
     steps:
     - name: 检出代码
@@ -56,7 +63,7 @@ jobs:
     - name: 同步依赖（使用 uv sync）
       run: |
         # 安装核心依赖 + dev 依赖 + 可观测性 + 存储 + 代码生成 + 国密依赖
-        uv sync --extra observability --extra storage --extra codegen --extra gm
+        uv sync --locked --extra observability --extra storage --extra codegen --extra gm --extra crypto
 
     - name: 校验实际 Python 版本与矩阵一致
       run: uv run --no-sync python -c "import os, sys; expected = tuple(map(int, os.environ['UV_PYTHON'].split('.'))); print(sys.version); assert sys.version_info[:2] == expected, (sys.version_info[:2], expected)"
@@ -153,7 +160,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
@@ -164,11 +171,14 @@ jobs:
         test ! -d api-test-project/src/api_test_project/actions
         test ! -d api-test-project/src/api_test_project/pages
 
+    - name: 校验三种骨架的默认参数、依赖、CI 模板与离线入口
+      run: uv run --no-sync pytest tests/cli/test_init_cmd.py -q
+
     - name: 测试完整项目初始化（UI）
       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.0 → df_test_framework-4.10.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.10.0
-- **更新时间**: 2026-09-22
+- **版本**: v4.10.2
+- **更新时间**: 2026-10-10
 - **Python**: 3.12+
 - **核心技术栈**: pytest + httpx + Playwright + Pydantic v2 + SQLAlchemy 2.0 + Pluggy
 - **架构**: 五层架构 + 横切关注点（能力层驱动设计）
@@ -120,6 +120,7 @@ df-test init my-project --type full  # 完整项目：API + UI 两侧齐备
 - **DB 事务参与**: CRUD 全系支持 `session=` 参数参与 `transaction()`；SQL 标识符全面校验（表名/列名/条件键/order_by）防注入；`savepoint(session)` 真实部分回滚（v4.9.19~21）
 - **MQ async 化**: `AsyncKafkaClient`/`AsyncRabbitMQClient`（专属单线程 executor 委托）；Kafka 命名对齐 confluent 官方（`produce` 系 + `value` 参数）；双侧 `connect()`/`stop()`/`fetch()`（v4.9.21）
 - **机检体系**: 双轨对账、core 层依赖 AST 检查、文档死链/import 路径/版本一致性、事件 dataclass、golden 快照——规范尽量机检化（DESIGN_STANDARDS R0.1）
+- **密码原语**: `infrastructure/crypto` 统一承载 AES（`crypto` extra）与 SM2/SM3/SM4（`gm` extra）；helpers 提供文本/编码便捷层；设计与使用分别见 `docs/architecture/national-crypto-design.md`、`docs/guides/national-crypto.md`（v4.10.0）。
 
 ---
 
@@ -154,6 +155,10 @@ def test_login(self): ...
 
 ## 版本发布
 
+完整执行与恢复流程见 `docs/development/RELEASE.md`。下面的提交步骤不是发布完成：
+发布还需推送确认的版本标签，通过完整矩阵、构建/独立安装后上传 PyPI；
+已发布版本不覆盖，手动运行 release workflow 仅验证和构建。
+
 ### 版本号选择规则（语义化版本）
 
 **完整规范**: `docs/development/VERSION_CONTROL_RULES.md`

{df_test_framework-4.10.0 → df_test_framework-4.10.2}/CHANGELOG.md

@@ -7,7 +7,38 @@
 
 ## [Unreleased]
 
-（无）
+## [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
+
+### 发布配套
+
+- 补齐脚手架 pytest 默认 Allure 目录、严格 marker 检查、INFO 日志和忽略规则；
+  UI/full 自动声明 ui extra，依赖限制在当前主版本内，CI 不再隐式切换本地源码依赖。
+- CI/CD 模板收敛到锁文件安装、按需浏览器准备、测试与产物归档；定时回归保留
+  example 排除，移除未接线的数据库矩阵、默认通知和报告公开发布。
+- 修正配置优先级说明；生成 README、CLI 帮助及后续包元数据不再展示内部仓库地址。
+
+- 脚手架 README 改为项目使用指南：补齐环境准备、离线首次运行、示例接入、报告与诊断；
+  API/UI 按类型裁剪，CI/CD 说明跟随生成选项，密码能力收敛为扩展入口。
+
+- 补齐国密发布状态、安装入口与脚手架按需使用说明，密码扩展不进入默认项目依赖。
+- CI/CD 模板对齐 Python 3.12/3.13、报告插件和 pyproject/uv.lock；Docker 修正项目路径，
+  GitHub 测试项目发包改为显式开启，避免将默认 package=false 骨架直接送去构建。
+- 发布流程增加版本核验、复用完整测试矩阵、独立 wheel 安装验收，
+  GitHub Release 等待 PyPI 成功后创建，重复版本不再静默跳过。
 
 ## [4.10.0] - 2026-09-22
 

{df_test_framework-4.10.0 → df_test_framework-4.10.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.10.0
-- **更新时间**: 2026-09-22
+- **版本**: v4.10.2
+- **更新时间**: 2026-10-10
 - **Python**: 3.12+
 - **核心技术栈**: pytest + httpx + Playwright + Pydantic v2 + SQLAlchemy 2.0 + Pluggy
 - **架构**: 五层架构 + 横切关注点（能力层驱动设计）
@@ -169,6 +169,10 @@ def test_login(self): ...
 
 ## 版本发布
 
+完整执行与恢复流程见 `docs/development/RELEASE.md`。下面的提交步骤不是发布完成：
+发布还需推送确认的版本标签，通过完整矩阵、构建/独立安装后上传 PyPI；
+已发布版本不覆盖，手动运行 release workflow 仅验证和构建。
+
 ### 版本号选择规则（语义化版本）
 
 **完整规范**: `docs/development/VERSION_CONTROL_RULES.md`

{df_test_framework-4.10.0 → df_test_framework-4.10.2}/PKG-INFO

@@ -1,11 +1,7 @@
 Metadata-Version: 2.5
 Name: df-test-framework
-Version: 4.10.0
+Version: 4.10.2
 Summary: 基于交互模式的现代化测试自动化框架，支持多种测试场景
-Project-URL: Homepage, https://github.com/yourorg/df-test-framework
-Project-URL: Repository, https://github.com/yourorg/df-test-framework
-Project-URL: Documentation, https://github.com/yourorg/df-test-framework#readme
-Project-URL: Bug Tracker, https://github.com/yourorg/df-test-framework/issues
 Author-email: DF QA Team <qa@example.com>
 License: MIT
 Keywords: api,automation,framework,pytest,testing,ui
@@ -124,7 +120,7 @@ Description-Content-Type: text/markdown
 
 [![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/df-test-framework/blob/master/LICENSE)
+![License](https://img.shields.io/badge/license-MIT-orange.svg)
 
 ---
 
@@ -169,7 +165,8 @@ pip install df-test-framework
 | `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]"` |
+| `crypto` | AES 加解密 | `uv add "df-test-framework[crypto]"` |
+| `gm` | SM2 签名/验签与加解密、SM3/HMAC-SM3、SM4 | `uv add "df-test-framework[gm]"` |
 | `all` | 所有可选功能 | `uv add "df-test-framework[all]"` |
 
 ---
@@ -267,12 +264,8 @@ Layer 0 ─── core/               # 核心层：纯抽象（无第三方依
 
 ## 文档
 
-完整文档见项目 GitHub 仓库：
-
-- [快速开始](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 --help` 查看命令入口，初始化项目后参考生成的 README。
+完整使用指南、国密说明及版本发布文档由维护团队提供，暂不公开源码仓库地址。
 
 ---
 

{df_test_framework-4.10.0 → df_test_framework-4.10.2}/README.md

@@ -1,7 +1,7 @@
 # DF Test Framework
 
-> **版本**: v4.10.0
-> **更新时间**: 2026-09-22
+> **版本**: v4.10.2
+> **更新时间**: 2026-10-10
 > 简单、强大、可扩展的现代化 Python 测试自动化框架
 
 [![PyPI version](https://img.shields.io/pypi/v/df-test-framework.svg)](https://pypi.org/project/df-test-framework/)
@@ -116,7 +116,8 @@ uv add "df-test-framework[ui,observability,storage]"
 | `prometheus` | Prometheus 监控 | `uv add "df-test-framework[prometheus]"` |
 | `observability` | 可观测性全套 | `uv add "df-test-framework[observability]"` |
 | `storage` | S3 + OSS 存储 | `uv add "df-test-framework[storage]"` |
-| `crypto` | AES/DES 加解密 | `uv add "df-test-framework[crypto]"` |
+| `crypto` | AES 加解密 | `uv add "df-test-framework[crypto]"` |
+| `gm` | SM2 签名/验签与加解密、SM3/HMAC-SM3、SM4 | `uv add "df-test-framework[gm]"` |
 | `all` | 所有可选功能 | `uv add "df-test-framework[all]"` |
 
 **💡 提示**：
@@ -127,21 +128,21 @@ uv add "df-test-framework[ui,observability,storage]"
 ### 从 Git 仓库安装
 
 ```bash
-# 基础安装（最新版本）
-uv pip install "df-test-framework @ git+https://github.com/yourorg/df-test-framework.git"
+# 基础安装（仓库当前代码，不等于 PyPI 稳定版）
+uv pip install "df-test-framework @ git+https://github.com/Tanyu-y/test-framework.git"
 
 # 安装特定可选依赖
-uv pip install "df-test-framework[observability,storage] @ git+https://github.com/yourorg/df-test-framework.git"
+uv pip install "df-test-framework[observability,storage] @ git+https://github.com/Tanyu-y/test-framework.git"
 
-# 安装指定版本
-uv pip install "df-test-framework @ git+https://github.com/yourorg/df-test-framework.git@v4.9.23"
+# 安装指定标签（将 X.Y.Z 替换为所需的已发布版本）
+uv pip install "df-test-framework @ git+https://github.com/Tanyu-y/test-framework.git@vX.Y.Z"
 ```
 
 ### 本地开发
 
 ```bash
-git clone https://github.com/yourorg/df-test-framework.git
-cd df-test-framework
+git clone https://github.com/Tanyu-y/test-framework.git
+cd test-framework
 
 # 方式1: 使用 uv sync（推荐）
 uv sync --all-extras  # 安装所有依赖（开发 + 可选）

{df_test_framework-4.10.0 → df_test_framework-4.10.2}/README_PYPI.md

@@ -4,7 +4,7 @@
 
 [![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/df-test-framework/blob/master/LICENSE)
+![License](https://img.shields.io/badge/license-MIT-orange.svg)
 
 ---
 
@@ -49,7 +49,8 @@ pip install df-test-framework
 | `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]"` |
+| `crypto` | AES 加解密 | `uv add "df-test-framework[crypto]"` |
+| `gm` | SM2 签名/验签与加解密、SM3/HMAC-SM3、SM4 | `uv add "df-test-framework[gm]"` |
 | `all` | 所有可选功能 | `uv add "df-test-framework[all]"` |
 
 ---
@@ -147,12 +148,8 @@ Layer 0 ─── core/               # 核心层：纯抽象（无第三方依
 
 ## 文档
 
-完整文档见项目 GitHub 仓库：
-
-- [快速开始](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 --help` 查看命令入口，初始化项目后参考生成的 README。
+完整使用指南、国密说明及版本发布文档由维护团队提供，暂不公开源码仓库地址。
 
 ---
 

{df_test_framework-4.10.0 → df_test_framework-4.10.2}/docs/ESSENTIAL_DOCS.md

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

{df_test_framework-4.10.0 → df_test_framework-4.10.2}/docs/FAQ.md

@@ -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.0 → df_test_framework-4.10.2}/docs/README.md

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

{df_test_framework-4.10.0 → df_test_framework-4.10.2}/docs/architecture/README.md

@@ -21,7 +21,7 @@
 | 文档 | 定位 |
 |---|---|
 | [ui-design-principles](./ui-design-principles.md) | UI 层设计原则（改 UI 层必读） |
-| [national-crypto-design](./national-crypto-design.md) | 国密字节核心、便捷层、实现与评审记录（Unreleased） |
+| [national-crypto-design](./national-crypto-design.md) | 国密字节核心、便捷层、实现与评审记录（v4.10.0） |
 | [CODE_STRUCTURE](./CODE_STRUCTURE.md) | 代码地图（按目录找文件；架构概念以五层架构详解为准） |
 | [extension-points](./extension-points.md) | 扩展点（⚠️ 部分过时，以 api-reference/extensions 为准） |
 | [TEST_EXECUTION_LIFECYCLE](./TEST_EXECUTION_LIFECYCLE.md) | 测试执行生命周期（⚠️ EventBus 装配段落已被七层模型取代） |

{df_test_framework-4.10.0 → df_test_framework-4.10.2}/docs/architecture/TEST_EXECUTION_LIFECYCLE.md

@@ -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.0 → df_test_framework-4.10.2}/docs/architecture/national-crypto-design.md

@@ -191,6 +191,10 @@ Windows 使用 Git 附带 OpenSSL；macOS 显式使用 Homebrew OpenSSL，不假
 
 本机验证使用 Windows、Python 3.12、gmalg 1.1.1、cryptography 50.0.0、asn1crypto 1.5.1，
 独立 OpenSSL 3.5.7。本地通过不等于三平台 CI 已跑绿；跨平台结论需读取推送后的 CI。
+发布验收补记：v4.10.0 的 Windows/Linux/macOS × Python 3.12/3.13
+[完整矩阵已通过](https://github.com/Tanyu-y/test-framework/actions/runs/35734893910)，
+[发布工作流已完成](https://github.com/Tanyu-y/test-framework/actions/runs/35735390500)。
+最终本机回归为 3215 passed / 44 skipped（排除 Storage），并完成独立环境的 PyPI 安装冒烟。
 没有执行真实充值/退款等接口，也没有用本批单测宣称生产系统端到端验收。
 
 2026-09-22 本机验收快照（不是未来版本的固定用例数）：
@@ -222,15 +226,16 @@ SM2Cipher，逐请求使用 SM4Cipher；支付信封工具也委托便捷层。
 既有 V2 SM4-ECB/PKCS7、SM2 C1C3C2、Base64 和 SM3 签名源均未改变。
 项目离线测试直接使用字节核心验证报文，不只靠同一便捷对象自加自解。
 
-Master 暂用 uv editable source 指向 `../test-framework`，因为当前 PyPI 版本没有这些 API。
+v4.10.0 已发布至 PyPI；Master 已移除指向 `../test-framework` 的 uv editable source，
+重新锁定并实际安装 PyPI 4.10.0，13 个离线国密测试通过，doctor 健康。
 版本决定（2026-09-22）：按 MINOR 发布为 v4.10.0。移除公开 API 按规则应为 MAJOR，
 维护者以「消费项目全部内部维护、已同步迁移、不需要兼容层」为由豁免，仅限本次。
-Master 依赖范围已改为 `>=4.10.0,<5`，PyPI 发布后移除 `tool.uv.sources` 覆盖并重新锁定。
+Master 依赖范围为 `>=4.10.0,<5`；本次验收不包含真实支付端到端调用。
 techconnect 升级后可消掉 TEST_PLAN「四点五」并落地开放退款与建行受理服务用例。
 
 ## 9. 独立评审清单
 
-- 同时检查两个仓库的工作区 diff 和未跟踪新文件；仅 `git diff` 会漏掉新 crypto 包和测试。
+- 检查目标提交范围与两个仓库的未提交差异、未跟踪文件；不要只看当前工作区判断已提交实现。
 - 重点检查 ASN.1/OID/点验证、C3 和 GCM 认证、消息与预摘要区分、UID 与签名格式。
 - 确认格式支持范围与文档一致；尤其是空 UID、宽松 PEM 的拒绝边界、PKCS#8 子集、未加密私钥导出。
 - 检查便捷层有无隐式降级、忽略参数、nonce/IV 复用诱导，以及异常/日志泄密。