tuner-testkit 6.0.0__tar.gz → 6.2.0__tar.gz

{tuner_testkit-6.0.0/tuner_testkit.egg-info → tuner_testkit-6.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tuner-testkit
-Version: 6.0.0
+Version: 6.2.0
 Summary: Shared test runtime, recorders, and DNA overlay for SUT test repos
 Author: tuner-testkit contributors
 License-Expression: MIT
@@ -69,12 +69,18 @@ uv tool install tuner-testkit
 ### 2. 初始化测试仓
 
 ```bash
-tuner-init scaffold ../my-sut-tests
-cd ../my-sut-tests
+tuner-init scaffold ../balance
+cd ../balance
 uv sync
 ```
 
-`scaffold` 会铺六层目录、写入依赖 `tuner-testkit[db,api]` 的 `pyproject.toml`，并执行一次 `tuner-dna sync`（把 `.cursor/`、`docs/spec/`、`tools/git-hooks/` 放进**项目树**）。可在任意目录运行，不必先有测试仓。不要用 `tuner-testkit init repo`。
+`scaffold` 会铺六层目录、写入依赖 `tuner-testkit[db,api]>=<当前 kit 版本>` 的 `pyproject.toml`，并执行一次 `tuner-dna sync`（把 `.cursor/`、`docs/spec/`、`tools/git-hooks/` 放进**项目树**）。可在任意目录运行，不必先有测试仓。不要用 `tuner-testkit init repo`。
+
+生成的文件夹名就是 `target` 路径的最后一段。`pyproject.toml` 里的项目名默认取这个文件夹名（`Balance` 会写成 `balance`）。需要另起项目名时加 `--name`：
+
+```bash
+tuner-init scaffold ../clients/acme --name acme-billing
+```
 
 `uv sync` 把 **db / api 装进业务仓 `.venv`**，不是 tool 域。已有项目仓则在该仓根目录：
 
@@ -221,4 +227,4 @@ uv sync --extra all
 （被测系统 = 平台本身，uv workspace 成员，共用 `.venv`）：路线图在 `dogfood/assets/domain-notes/platform/roadmap.md`，
 验收活文档在 `dogfood/tests/features/`。见 [`dogfood/README.md`](dogfood/README.md)。
 
-6.0.0 发行说明（一条用例一个文件）见 [`docs/changelog/TEMPLATE-6.0.0.md`](docs/changelog/TEMPLATE-6.0.0.md)；5.3.1 发行说明（已回答提问归档）见 [`docs/changelog/TEMPLATE-5.3.1.md`](docs/changelog/TEMPLATE-5.3.1.md)；5.3.0 发行说明（功能用例集 `assets/testcases/`）见 [`docs/changelog/TEMPLATE-5.3.0.md`](docs/changelog/TEMPLATE-5.3.0.md)；5.2.0 发行说明（work task / 测试设计 / 证据附件）见 [`docs/changelog/TEMPLATE-5.2.0.md`](docs/changelog/TEMPLATE-5.2.0.md)；5.1.0 发行说明（工作台 / meta stamp / `--json`）见 [`docs/changelog/TEMPLATE-5.1.0.md`](docs/changelog/TEMPLATE-5.1.0.md)；5.0.0（Plane Job 协议退场、`tuner-workspace`）见 [`TEMPLATE-5.0.0.md`](docs/changelog/TEMPLATE-5.0.0.md)；4.3.0 见 [`TEMPLATE-4.3.0.md`](docs/changelog/TEMPLATE-4.3.0.md)；3.x → 4.x 迁移见 [`TEMPLATE-4.0.0.md`](docs/changelog/TEMPLATE-4.0.0.md)。平台能力地图见 [`INDEX.md`](INDEX.md)。
+6.2.0 发行说明（测试单）见 [`docs/changelog/TEMPLATE-6.2.0.md`](docs/changelog/TEMPLATE-6.2.0.md)；6.1.0 发行说明（scaffold 项目名）见 [`docs/changelog/TEMPLATE-6.1.0.md`](docs/changelog/TEMPLATE-6.1.0.md)；6.0.0 发行说明（一条用例一个文件）见 [`docs/changelog/TEMPLATE-6.0.0.md`](docs/changelog/TEMPLATE-6.0.0.md)；5.3.1 发行说明（已回答提问归档）见 [`docs/changelog/TEMPLATE-5.3.1.md`](docs/changelog/TEMPLATE-5.3.1.md)；5.3.0 发行说明（功能用例集 `assets/testcases/`）见 [`docs/changelog/TEMPLATE-5.3.0.md`](docs/changelog/TEMPLATE-5.3.0.md)；5.2.0 发行说明（work task / 测试设计 / 证据附件）见 [`docs/changelog/TEMPLATE-5.2.0.md`](docs/changelog/TEMPLATE-5.2.0.md)；5.1.0 发行说明（工作台 / meta stamp / `--json`）见 [`docs/changelog/TEMPLATE-5.1.0.md`](docs/changelog/TEMPLATE-5.1.0.md)；5.0.0（Plane Job 协议退场、`tuner-workspace`）见 [`TEMPLATE-5.0.0.md`](docs/changelog/TEMPLATE-5.0.0.md)；4.3.0 见 [`TEMPLATE-4.3.0.md`](docs/changelog/TEMPLATE-4.3.0.md)；3.x → 4.x 迁移见 [`TEMPLATE-4.0.0.md`](docs/changelog/TEMPLATE-4.0.0.md)。平台能力地图见 [`INDEX.md`](INDEX.md)。

{tuner_testkit-6.0.0 → tuner_testkit-6.2.0}/README.md

@@ -21,12 +21,18 @@ uv tool install tuner-testkit
 ### 2. 初始化测试仓
 
 ```bash
-tuner-init scaffold ../my-sut-tests
-cd ../my-sut-tests
+tuner-init scaffold ../balance
+cd ../balance
 uv sync
 ```
 
-`scaffold` 会铺六层目录、写入依赖 `tuner-testkit[db,api]` 的 `pyproject.toml`，并执行一次 `tuner-dna sync`（把 `.cursor/`、`docs/spec/`、`tools/git-hooks/` 放进**项目树**）。可在任意目录运行，不必先有测试仓。不要用 `tuner-testkit init repo`。
+`scaffold` 会铺六层目录、写入依赖 `tuner-testkit[db,api]>=<当前 kit 版本>` 的 `pyproject.toml`，并执行一次 `tuner-dna sync`（把 `.cursor/`、`docs/spec/`、`tools/git-hooks/` 放进**项目树**）。可在任意目录运行，不必先有测试仓。不要用 `tuner-testkit init repo`。
+
+生成的文件夹名就是 `target` 路径的最后一段。`pyproject.toml` 里的项目名默认取这个文件夹名（`Balance` 会写成 `balance`）。需要另起项目名时加 `--name`：
+
+```bash
+tuner-init scaffold ../clients/acme --name acme-billing
+```
 
 `uv sync` 把 **db / api 装进业务仓 `.venv`**，不是 tool 域。已有项目仓则在该仓根目录：
 
@@ -173,4 +179,4 @@ uv sync --extra all
 （被测系统 = 平台本身，uv workspace 成员，共用 `.venv`）：路线图在 `dogfood/assets/domain-notes/platform/roadmap.md`，
 验收活文档在 `dogfood/tests/features/`。见 [`dogfood/README.md`](dogfood/README.md)。
 
-6.0.0 发行说明（一条用例一个文件）见 [`docs/changelog/TEMPLATE-6.0.0.md`](docs/changelog/TEMPLATE-6.0.0.md)；5.3.1 发行说明（已回答提问归档）见 [`docs/changelog/TEMPLATE-5.3.1.md`](docs/changelog/TEMPLATE-5.3.1.md)；5.3.0 发行说明（功能用例集 `assets/testcases/`）见 [`docs/changelog/TEMPLATE-5.3.0.md`](docs/changelog/TEMPLATE-5.3.0.md)；5.2.0 发行说明（work task / 测试设计 / 证据附件）见 [`docs/changelog/TEMPLATE-5.2.0.md`](docs/changelog/TEMPLATE-5.2.0.md)；5.1.0 发行说明（工作台 / meta stamp / `--json`）见 [`docs/changelog/TEMPLATE-5.1.0.md`](docs/changelog/TEMPLATE-5.1.0.md)；5.0.0（Plane Job 协议退场、`tuner-workspace`）见 [`TEMPLATE-5.0.0.md`](docs/changelog/TEMPLATE-5.0.0.md)；4.3.0 见 [`TEMPLATE-4.3.0.md`](docs/changelog/TEMPLATE-4.3.0.md)；3.x → 4.x 迁移见 [`TEMPLATE-4.0.0.md`](docs/changelog/TEMPLATE-4.0.0.md)。平台能力地图见 [`INDEX.md`](INDEX.md)。
+6.2.0 发行说明（测试单）见 [`docs/changelog/TEMPLATE-6.2.0.md`](docs/changelog/TEMPLATE-6.2.0.md)；6.1.0 发行说明（scaffold 项目名）见 [`docs/changelog/TEMPLATE-6.1.0.md`](docs/changelog/TEMPLATE-6.1.0.md)；6.0.0 发行说明（一条用例一个文件）见 [`docs/changelog/TEMPLATE-6.0.0.md`](docs/changelog/TEMPLATE-6.0.0.md)；5.3.1 发行说明（已回答提问归档）见 [`docs/changelog/TEMPLATE-5.3.1.md`](docs/changelog/TEMPLATE-5.3.1.md)；5.3.0 发行说明（功能用例集 `assets/testcases/`）见 [`docs/changelog/TEMPLATE-5.3.0.md`](docs/changelog/TEMPLATE-5.3.0.md)；5.2.0 发行说明（work task / 测试设计 / 证据附件）见 [`docs/changelog/TEMPLATE-5.2.0.md`](docs/changelog/TEMPLATE-5.2.0.md)；5.1.0 发行说明（工作台 / meta stamp / `--json`）见 [`docs/changelog/TEMPLATE-5.1.0.md`](docs/changelog/TEMPLATE-5.1.0.md)；5.0.0（Plane Job 协议退场、`tuner-workspace`）见 [`TEMPLATE-5.0.0.md`](docs/changelog/TEMPLATE-5.0.0.md)；4.3.0 见 [`TEMPLATE-4.3.0.md`](docs/changelog/TEMPLATE-4.3.0.md)；3.x → 4.x 迁移见 [`TEMPLATE-4.0.0.md`](docs/changelog/TEMPLATE-4.0.0.md)。平台能力地图见 [`INDEX.md`](INDEX.md)。

{tuner_testkit-6.0.0 → tuner_testkit-6.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tuner-testkit"
-version = "6.0.0"
+version = "6.2.0"
 description = "Shared test runtime, recorders, and DNA overlay for SUT test repos"
 readme = "README.md"
 license = "MIT"

{tuner_testkit-6.0.0 → tuner_testkit-6.2.0}/tuner_testkit/__init__.py

@@ -2,4 +2,4 @@
 
 from __future__ import annotations
 
-__version__ = "6.0.0"
+__version__ = "6.2.0"

{tuner_testkit-6.0.0 → tuner_testkit-6.2.0}/tuner_testkit/apps/dna/dna_payload/.cursor/rules/assets-knowledge.mdc

@@ -2,7 +2,7 @@
 description: assets/ is the knowledge base for humans and the LLM; enforce provenance metadata, raw-vs-curated boundaries, and grounding (consult INDEX before generating)
 globs: assets/**
 alwaysApply: false
-version: 1.2.1
+version: 1.2.2
 ---
 
 # assets — 知识层硬约束
@@ -26,10 +26,11 @@ SUT 自学习见 `docs/spec/sut-self-learning.md`；design schema 见
 
 - 目录分类固定：`ddl/<datasource>/`、`sql/`、`usecases/<domain>/`、
   `domain-notes/<domain>/`、`explore/<app>/`、`design/<app>/`、`testdesign/`、
-  `testcases/<模块>/<套件>/`、`testreport/`
+  `testcases/<模块>/<套件>/`、`testsheet/<轮次>/`、`testreport/`
   （新增类别前先改 spec，再改本 rule）。功能用例集见 `docs/spec/testcase-syntax.md`。
+  测试单见 skill `maintain-testsheet`：`testsheet.md` 不写 YAML 头；`testcase/` 是当次从用例库复制的步骤。
 - 人工/半自动区文件头必须带元数据：`domain / source / date / version / confidence`
-  （Markdown 用 YAML front-matter，SQL 用顶部 `--` 注释）。
+  （Markdown 用 YAML front-matter，SQL 用顶部 `--` 注释）。`testsheet.md` 除外。
 - `explore/` 与 `design/` 还应填 `evidence`（run_id 列表）。
 - `confidence: high` 表示人工核实过——LLM 应优先采信。
 

{tuner_testkit-6.0.0 → tuner_testkit-6.2.0}/tuner_testkit/apps/dna/dna_payload/.cursor/skills/maintain-testcases/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: maintain-testcases
-version: 1.3.0
-description: Creates and updates functional testcases so each case is its own Markdown file under assets/testcases/<module>/<suite>/<Case-ID>.md, with suite notes in that folder's README. Uses a TestLink-style template (summary, preconditions, numbered steps, expected results, status). Use when the user asks to 编写/生成/维护测试用例, add a module or suite, or mentions assets/testcases or a case ID. Do not use for testdesign click-paths or behave .feature files.
+version: 1.5.0
+description: Creates and updates functional testcases so each case is its own Markdown file under assets/testcases/<module>/<suite>/<Case-ID>.md, with suite notes in that folder's README. Uses a TestLink-style template (summary, preconditions, numbered steps, expected results, status). One maintain-testcases session is one git commit; the body lists each case as 首次创建 or 变更原因 so the IDE Timeline on that file shows the changelog. Use when the user asks to 编写/生成/维护测试用例, add a module or suite, or mentions assets/testcases or a case ID. Do not use for testdesign click-paths or behave .feature files.
 ---
 
 # Maintain testcases
@@ -156,6 +156,54 @@ confidence: high
 - 删除：删掉该 `<用例ID>.md`，并从套件用例表去掉这一行。不改其他用例的 ID。
 - 废弃：`status` 改为 `废弃`，在备注写原因。不删除文件，不把 ID 让给新用例，标题不加 `（废弃）`。
 - 拆套件或改套件名：用例带着原 ID 搬家，并改两边 README 的链接。每条用例的 `suite` 改成新目录名。
+- 上面每一种落盘（新建、修改、废弃、删除、搬家）都记在同一次维护的那一个提交里。文件变更日志以 git 为准，不要另写变更日志。
+
+## Commit
+
+同一次 `maintain-testcases` 工作只做 **一个** commit。目的是让每个被改到的用例文件，在 IDE 的 Timeline 里都能看到这次变更日志。用户没有再说「提交」也要做。不要 push。不要改 git config，不要 `--no-verify`。不要按用例拆成多次提交。
+
+校验前的来回修改并进这一个提交。没有文件变化就不提交。
+
+这次提交只暂存本次维护动过的路径：
+
+- 新建或修改的 `<用例ID>.md`（含删除）
+- 因此改动的套件 `README.md`、模块 `README.md`、`assets/testcases/README.md`
+- 因此在 `INDEX.project.md` 新增或修改的行
+
+工作区里其他改动不要放进来。
+
+提交信息遵循 `docs/spec/commit-convention.md`。`scope` 必须盖住暂存路径：只有 `assets/testcases/**` 时用 `assets`；同一次还改了 `INDEX.project.md` 时用 `assets,index`。subject 概括这一次（套件或模块，加上新建或更新）。全是新建用 `feat`；只改正错误的操作或预期用 `fix`；只做废弃、删除、搬家或索引调整用 `chore`；几种混在一起用 `feat`。
+
+正文每个用例文件一段，打开该文件的 Timeline 时能对上自己的那一段。原词不要改：
+
+- 新文件：`<用例ID>：首次创建。<一句测试点>`。换 slug 的新文件在这句里写 `曾用：<旧 ID>`。
+- 已有文件：`<用例ID>：变更原因：<改了什么、为什么>`。
+- 只改了套件详情或索引、没有动用例正文：`<套件名>：变更原因：<改了什么、为什么>`。
+
+```bash
+git add -- <本次维护相关路径>
+git commit -m "<type>(<scope>): <subject>" -m "<用例ID>：首次创建。<测试点>" -m "<用例ID>：变更原因：<改了什么、为什么>"
+```
+
+多个用例就多个 `-m`，一段一个文件。只有一条时保留一段即可。
+
+例子：
+
+```text
+feat(assets): 新增用户登录用例 2 条
+
+User-Login-valid-credentials：首次创建。已注册账号与正确密码可以登录。
+
+User-Login-wrong-password：首次创建。错误密码不能登录。
+```
+
+```text
+fix(assets): 更新 User-Login-valid-credentials 正确账号密码
+
+User-Login-valid-credentials：变更原因：登录成功后的预期由首页改为个人中心。
+```
+
+提交前看 `git status` 和 `git diff --cached`，确认暂存只有这次维护的文件。`commit-msg` 失败就改正后再提交一次，不要 amend 那次失败的提交。说明里不写密码、token、Cookie。
 
 ## Finish
 
@@ -164,4 +212,4 @@ python -m tuner_testkit.testcases assets/testcases
 uv run tuner-workspace meta stamp <改过的.md> --kind <testcase|testcase-suite|testcase-module|testcase-index>
 ```
 
-校验失败就改文件再跑，通过后再停。有 `INDEX.project.md` 时在其知识表登记新套件 README 的路径（只读 front-matter）；平台仓没有业务用例时不要往根 `INDEX.md` 填模块明细。
+校验失败就改文件再跑。本次要写的用例都通过后，按 Commit 做这一个提交，然后停。有 `INDEX.project.md` 时在其知识表登记新套件 README 的路径（只读 front-matter），放进同一次提交；平台仓没有业务用例时不要往根 `INDEX.md` 填模块明细。

tuner_testkit-6.2.0/tuner_testkit/apps/dna/dna_payload/.cursor/skills/maintain-testsheet/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: maintain-testsheet
+version: 1.0.0
+description: Builds and updates a test sheet under assets/testsheet/<round>/testsheet.md, copying the selected ready cases from assets/testcases into that round's testcase/ folder and linking only those copies. Use when the user asks to 生成测试单, 维护测试单, 测试单, or mentions assets/testsheet or testsheet.md. Do not use to edit the case library, write a testdesign, or curate assets/testreport.
+---
+
+# Maintain testsheet
+
+## Scope
+
+- **Write**: `assets/testsheet/<轮次>/testsheet.md`，以及同目录 `testcase/` 里的用例副本。
+- **Read**: `assets/testcases/`。有 `INDEX.project.md` 时先读，只采用已有事实。
+- **Out of scope**: 改 `assets/testcases/`（用 `maintain-testcases`）、写 `assets/testdesign/`、写 `assets/testreport/`（用 `generate-test-report`）。已有的 `assets/testreports/**/测试单.md` 不搬，除非用户明确要求迁移。
+
+## Layout
+
+```text
+assets/testsheet/<轮次>/
+  testsheet.md
+  testcase/<模块>/README.md
+  testcase/<模块>/<套件>/README.md
+  testcase/<模块>/<套件>/<用例ID>.md
+  evidence/
+```
+
+`<轮次>` 用用户给的目录名。没给就用 `yyMMdd` 加模块名，例如 `261015预入库管控`。一轮一个目录。
+
+## Generate
+
+1. 读模块 README 和相关套件 README。范围按用户点名的模块、套件或用例 ID。没点名到单条时，纳入该范围内 `status: 就绪` 的用例。`status: 废弃` 不复制、不进表，在测试单开头点名。
+2. 用文件复制，不要重写正文。用例文件、该模块 README、被选中套件的 README 都复制到上面的 `testcase/` 路径。复制后不再从用例库刷新，除非用户要求重新提取。
+3. 写 `testsheet.md`。不写 YAML 头。用例列只链副本：
+
+```text
+[Admin-View-columns-shown](testcase/预入库管控/管控情况查看/Admin-View-columns-shown.md)
+```
+
+不要链 `assets/testcases/` 或 `../../testcases/`。
+
+从副本填列，不要另编业务规则：
+
+| 列 | 来源 |
+| --- | --- |
+| 用例 | 副本文件名，链到副本 |
+| 测试点 | `<type>-<title>`，如 `正向-清单展示约定列` |
+| 数据 | `## 测试数据` 的第一句。没有则用 `## 前置条件` 的第一句 |
+| 预期要点 | 第一步 `预期` 收成一句 |
+| 结果 | `未执行` |
+| 实测记录 | 空 |
+
+分组：模块 README 的 `## 范围` 已有编号块时，用那些块做 `##`。块内按套件 README 的顺序各做一个 `###` 和一张表。没有范围编号时，一个套件一个 `##`。不要把一个套件拆进两张表，除非用户要求。
+
+## Sheet
+
+```markdown
+# <主题>测试单
+
+共 N 条。步骤在本目录 `testcase/`。`<废弃ID>` 已废弃，不在本单。
+
+依据：<用户给出的需求或来源路径>。
+
+## 怎么填
+
+- 「结果」只写：通过、失败、部分通过、未执行、阻塞。
+- 「实测记录」写看到的文案、单号、库存状态。不写密码、token、Cookie。账号只写 `account_id` 或登录名。
+- 截图放本目录，文件名用用例 ID。
+
+## 本轮信息
+
+| 项 | 填写 |
+| --- | --- |
+| 测试人 | |
+| 日期 | |
+| 环境 | |
+| 证据 | 本目录 `evidence/` |
+| 通过 | 0 |
+| 失败 | 0 |
+| 部分通过 | 0 |
+| 未执行 | N |
+| 阻塞 | 0 |
+
+## 测的时候先记住
+
+- <会改变通过或失败判定的规则。来自套件 README 的「详情」，或用户本轮原话。没有就写「无」。>
+
+## 1. <范围块>
+
+### 1.1 <套件名>
+
+| 用例 | 测试点 | 数据 | 预期要点 | 结果 | 实测记录 |
+| --- | --- | --- | --- | --- | --- |
+| [<用例ID>](testcase/<模块>/<套件>/<用例ID>.md) | 正向-<title> | <数据> | <预期要点> | 未执行 | |
+
+## 缺陷
+
+| 编号 | 用例 | 现象 | 是否阻塞后续 |
+| --- | --- | --- | --- |
+| 无 | | | |
+```
+
+五个计数之和等于表内行数。新建时未执行等于 N，其余为 0。
+
+## Update
+
+- 回写时只改 `testsheet.md` 的结果、实测记录、计数和缺陷。结果只用那五个词。
+- 增删一行后立刻重算「共 N 条」和五个计数。
+- 从本单移除一条：删表行，删 `testcase/` 里对应副本。开头写明 ID 和原因。菜单权限这类配置问题、以及改由别的页面跟踪的条目，是移除，不记失败，也不进缺陷表。
+- 缺陷只记产品行为。
+- 本轮步骤缺前置或判定规则：改 `testcase/` 里的副本。要沉淀回用例库时另走 `maintain-testcases`，改完不要把测试单的链接改回用例库。
+- 截图放本目录，文件名用用例 ID。一组结果的图放在对应小节下，写成 `![](文件名.png)`。接口 JSON 放 `evidence/`。造数写 `packages/action_words/db_seed/`，不在 `assets/testsheet/` 里放可执行脚本。
+
+## Hard rules
+
+- 不写密码、token、Cookie。
+- 不编用例库和套件详情里没有、用户本轮也没说的业务规则。
+- 测试单生成后，步骤以副本为准。

{tuner_testkit-6.0.0 → tuner_testkit-6.2.0}/tuner_testkit/apps/dna/dna_payload/AGENTS.md

@@ -1,4 +1,4 @@
-<!-- version: 1.7.1 -->
+<!-- version: 1.7.2 -->
 # AGENTS — 平台总入口（轻量 DM）
 
 > 本文件是"repo as a platform"的**稳定世界观**：只写不常变的分层结构与角色。
@@ -13,7 +13,7 @@
 
 | 层 | 目录 | 职责 | 谁运行 |
 | --- | --- | --- | --- |
-| 知识层 | `assets/` | 给人和 LLM 阅读、生成测试代码的基础知识（ddl / sql / usecases / domain-notes / explore / design / testdesign / testcases / testreport）。见 `docs/spec/assets-knowledge-syntax.md`。 | 只读引用 |
+| 知识层 | `assets/` | 给人和 LLM 阅读、生成测试代码的基础知识（ddl / sql / usecases / domain-notes / explore / design / testdesign / testcases / testsheet / testreport）。见 `docs/spec/assets-knowledge-syntax.md`。 | 只读引用 |
 | 运行库 | `tuner_testkit/`（PyPI：`tuner-testkit`） | 公共运行时与 CLI（db / logging / api_test / page_test / fake / recorders / dna）。SUT 用 `uv` 锁版本。 | `import tuner_testkit`；`tuner-recorder` 等 scripts |
 | 组件层 | `packages/` | **本仓业务资产**（api_objects / page_objects / action_words），不是 kit 运行库。 | 被 import |
 | 工具层 | `apps/` | **本仓私有**工具。公共工具在 `tuner_testkit.apps`。见 `docs/spec/apps-authoring-syntax.md`。 | `python -m apps.<name>`（仅项目工具） |
@@ -52,6 +52,7 @@ flowchart TD
   Q -->|"读/策展/索引知识"| Idx["查 INDEX.md + maintain-index skill"]
   Q -->|"发布任务 / 测试设计 / 端到端执行"| Task["work/tasks + tuner-task\ndocs/spec/work-task.md"]
   Q -->|"生成或维护功能测试用例"| Cases["maintain-testcases skill\ndocs/spec/testcase-syntax.md"]
+  Q -->|"生成或维护测试单"| Sheet["maintain-testsheet skill\nassets/testsheet/"]
 ```
 
 - **学习被测系统** → `.cursor/agents/sut-self-learning.md`（编排 explore → freeze → design；规格 `docs/spec/sut-self-learning.md`；任务 log 见 `docs/spec/agent-task-log.md`）。
@@ -63,6 +64,7 @@ flowchart TD
 - **读/索引知识** → 先查 `INDEX.md`；若存在 `INDEX.project.md` 则一并查。索引维护用 `maintain-index` skill。
 - **发布任务** → `tuner-task create` 写入 `work/tasks/`。测试设计走 `derive-test-design`；端到端点击报告走 `run-test-execution`。缺人才能决定的通道（如后端日志）用 `tuner-task ask`，不要猜。
 - **功能测试用例** → skill `maintain-testcases`，落在 `assets/testcases/<模块>/<套件>/<用例ID>.md`（规格 `docs/spec/testcase-syntax.md`）。这不是测试设计，也不直接产出 `.feature`。
+- **测试单** → skill `maintain-testsheet`，落在 `assets/testsheet/<轮次>/`。步骤用该目录 `testcase/` 里的用例副本，不链回 `assets/testcases/`。
 
 ## 5. 全程硬约束（跨分支）
 

{tuner_testkit-6.0.0 → tuner_testkit-6.2.0}/tuner_testkit/apps/dna/dna_payload/MANIFEST.txt

@@ -1,5 +1,5 @@
 {
-  "files": 65,
+  "files": 66,
   "paths": [
     ".cursor/rules",
     ".cursor/skills",

{tuner_testkit-6.0.0 → tuner_testkit-6.2.0}/tuner_testkit/apps/dna/dna_payload/docs/spec/assets-knowledge-syntax.md

@@ -21,13 +21,16 @@ assets/
 ├── testcases/<模块>/README.md                  # 模块范围与套件清单
 ├── testcases/<模块>/<套件>/README.md           # 套件说明与用例索引
 ├── testcases/<模块>/<套件>/<用例ID>.md         # 一条用例一个文件
+├── testsheet/<轮次>/testsheet.md              # 一次测试单。步骤链接本目录副本
+├── testsheet/<轮次>/testcase/<模块>/<套件>/<用例ID>.md  # 从用例库复制的本次步骤
 ├── testreport/<name>.md           # 测试报告类原始资产
 └── CHANGELOG.md                   # 自动区变更流水(供 maintain-index 读取 delta)
 ```
 
 - **自动区**（工具产出，可被覆盖重写）：`ddl/`、以及每次生成会追加 `CHANGELOG.md`。
   人不手改这些文件的内容语义；要更新就重跑工具。
-- **人工/半自动区**：`sql/`、`usecases/`、`domain-notes/`、`explore/`、`design/`、`testdesign/`、`testcases/`、`testreport/`。
+- **人工/半自动区**：`sql/`、`usecases/`、`domain-notes/`、`explore/`、`design/`、`testdesign/`、`testcases/`、`testsheet/`、`testreport/`。
+- `testsheet/<轮次>/testsheet.md` 不写 YAML 头，正文按测试单格式。同目录 `testcase/` 是用例库的原样副本，保留复制时的文件头。维护方式见 skill `maintain-testsheet`。
 - `apidoc/` **不单列**：人工导入的接口说明放 `domain-notes/` 或 `usecases/`；
   运行时冻结的契约在 `packages/api_objects/`。是否再拆目录留给下游实践决定。
 

{tuner_testkit-6.0.0 → tuner_testkit-6.2.0}/tuner_testkit/apps/init_repo/__main__.py

@@ -1,6 +1,6 @@
 """CLI for init_repo: scaffold a new repo or manage the release manifest.
 
-    python -m tuner_testkit.apps.init_repo scaffold <target> [--no-ai] [--overwrite]
+    python -m tuner_testkit.apps.init_repo scaffold <target> [--name NAME] [--no-ai] [--overwrite]
     python -m tuner_testkit.apps.init_repo manifest --write [--version X.Y.Z]
     python -m tuner_testkit.apps.init_repo manifest --check
 """
@@ -15,11 +15,16 @@ from tuner_testkit.apps.init_repo import scaffold as sc
 
 
 def _cmd_scaffold(args: argparse.Namespace) -> int:
-    actions = sc.scaffold(
-        pathlib.Path(args.target),
-        with_ai=not args.no_ai,
-        overwrite=args.overwrite,
-    )
+    try:
+        actions = sc.scaffold(
+            pathlib.Path(args.target),
+            with_ai=not args.no_ai,
+            overwrite=args.overwrite,
+            project_name=args.name,
+        )
+    except ValueError as exc:
+        print(str(exc), file=sys.stderr)
+        return 2
     for line in actions:
         print(line)
     print(f"\nScaffolded {len(actions)} entries into {args.target}")
@@ -68,7 +73,15 @@ def main(argv: list[str] | None = None) -> int:
     sub = parser.add_subparsers(dest="cmd", required=True)
 
     p_sc = sub.add_parser("scaffold", help="create six-layer skeleton (+ platform DNA)")
-    p_sc.add_argument("target", help="target directory for the new project repo")
+    p_sc.add_argument(
+        "target",
+        help="directory to create; its name is the generated folder name and the default project name",
+    )
+    p_sc.add_argument(
+        "--name",
+        default=None,
+        help="pyproject project name (default: normalized target folder name, e.g. Balance -> balance)",
+    )
     p_sc.add_argument("--no-ai", action="store_true", help="do not copy .cursor/docs-spec/packages DNA")
     p_sc.add_argument("--overwrite", action="store_true", help="overwrite existing files when copying DNA")
     p_sc.set_defaults(func=_cmd_scaffold)

{tuner_testkit-6.0.0 → tuner_testkit-6.2.0}/tuner_testkit/apps/init_repo/scaffold.py

@@ -2,6 +2,7 @@
 from __future__ import annotations
 
 import pathlib
+import re
 import shutil
 import textwrap
 
@@ -14,6 +15,7 @@ SKELETON_DIRS: tuple[str, ...] = (
     "assets/design",
     "assets/testreport",
     "assets/testcases",
+    "assets/testsheet",
     "packages/action_words/db_seed",
     "packages/action_words/db_assert",
     "packages/action_words/api_request",
@@ -88,6 +90,39 @@ def _stub_root() -> pathlib.Path | None:
     return None
 
 
+# PEP 503 / 426 name: start and end with an alphanumeric; dots, underscores, hyphens inside.
+_PROJECT_NAME_RE = re.compile(r"^[A-Za-z0-9](?:[A-Za-z0-9._-]*[A-Za-z0-9])?$")
+
+
+def project_name_from_directory(directory_name: str) -> str:
+    """Turn a generated folder name into a ``pyproject.toml`` project name.
+
+    ``Balance`` becomes ``balance``. Characters outside the project-name
+    alphabet become hyphens. Pass ``--name`` when the folder name cannot
+    produce a valid name.
+    """
+    slug = directory_name.strip().lower()
+    slug = re.sub(r"[^a-z0-9._-]+", "-", slug)
+    slug = re.sub(r"[-_.]{2,}", "-", slug).strip("-._")
+    if not slug:
+        raise ValueError(
+            f"cannot derive a project name from directory {directory_name!r}; pass --name"
+        )
+    return normalize_project_name(slug)
+
+
+def normalize_project_name(raw: str) -> str:
+    """Accept an explicit ``--name`` or raise ``ValueError``."""
+    name = raw.strip()
+    if not _PROJECT_NAME_RE.fullmatch(name):
+        raise ValueError(
+            "invalid project name "
+            f"{raw!r}: use letters, digits, '.', '_' or '-', "
+            "and do not start or end with punctuation"
+        )
+    return name
+
+
 def _copy_file(src: pathlib.Path, dst: pathlib.Path, *, overwrite: bool) -> bool:
     if dst.exists() and not overwrite:
         return False
@@ -96,20 +131,26 @@ def _copy_file(src: pathlib.Path, dst: pathlib.Path, *, overwrite: bool) -> bool
     return True
 
 
-def _write_pyproject(target: pathlib.Path, *, overwrite: bool) -> bool:
+def _write_pyproject(
+    target: pathlib.Path,
+    *,
+    overwrite: bool,
+    project_name: str,
+    kit_version: str,
+) -> bool:
     dest = target / "pyproject.toml"
     if dest.exists() and not overwrite:
         return False
     dest.write_text(
         textwrap.dedent(
-            """\
+            f"""\
             [project]
-            name = "sut-test-repo"
+            name = "{project_name}"
             version = "0.1.0"
             description = "Test repo created from tuner-testkit"
             requires-python = ">=3.12,<3.14"
             dependencies = [
-                "tuner-testkit[db,api]>=4.3.0",
+                "tuner-testkit[db,api]>={kit_version}",
             ]
 
             [project.optional-dependencies]
@@ -139,9 +180,29 @@ def _write_pyproject(target: pathlib.Path, *, overwrite: bool) -> bool:
     return True
 
 
-def scaffold(target: pathlib.Path, *, with_ai: bool = True, overwrite: bool = False) -> list[str]:
+def scaffold(
+    target: pathlib.Path,
+    *,
+    with_ai: bool = True,
+    overwrite: bool = False,
+    project_name: str | None = None,
+) -> list[str]:
+    """Create a SUT test repo at ``target``.
+
+    The directory's own name is the generated folder name. ``project_name``
+    (CLI ``--name``) is the ``[project] name`` written into ``pyproject.toml``.
+    When omitted, that name is derived from the folder name.
+    """
     actions: list[str] = []
     target = target.resolve()
+    explicit = (project_name or "").strip()
+    resolved_name = (
+        normalize_project_name(explicit)
+        if explicit
+        else project_name_from_directory(target.name)
+    )
+    from tuner_testkit import __version__
+
     target.mkdir(parents=True, exist_ok=True)
     src_root = _stub_root()
 
@@ -153,8 +214,13 @@ def scaffold(target: pathlib.Path, *, with_ai: bool = True, overwrite: bool = Fa
             keep.write_text("", encoding="utf-8")
         actions.append(f"dir  {rel}")
 
-    if _write_pyproject(target, overwrite=overwrite):
-        actions.append("write pyproject.toml")
+    if _write_pyproject(
+        target,
+        overwrite=overwrite,
+        project_name=resolved_name,
+        kit_version=__version__,
+    ):
+        actions.append(f"write pyproject.toml ({resolved_name})")
     else:
         actions.append("skip pyproject.toml (exists)")
 

{tuner_testkit-6.0.0 → tuner_testkit-6.2.0}/tuner_testkit/apps/init_repo/tests/test_scaffold.py

@@ -4,6 +4,10 @@ from __future__ import annotations
 
 from pathlib import Path
 
+import pytest
+
+from tuner_testkit import __version__
+from tuner_testkit.apps.init_repo.__main__ import main
 from tuner_testkit.apps.init_repo.scaffold import scaffold
 
 _REPO_ROOT = Path(__file__).resolve().parents[4]
@@ -21,7 +25,10 @@ def test_scaffold_from_non_project_cwd(tmp_path: Path, monkeypatch):
     actions = scaffold(dest, with_ai=True, overwrite=False)
     assert dest.is_dir()
     assert (dest / "pyproject.toml").is_file()
-    assert "[tool.tuner-testkit]" in (dest / "pyproject.toml").read_text(encoding="utf-8")
+    pyproject = (dest / "pyproject.toml").read_text(encoding="utf-8")
+    assert 'name = "new-sut"' in pyproject
+    assert f'"tuner-testkit[db,api]>={__version__}"' in pyproject
+    assert "[tool.tuner-testkit]" in pyproject
     assert 'requires-python = ">=3.12,<3.14"' in (dest / "pyproject.toml").read_text(encoding="utf-8")
     assert (dest / ".python-version").read_text(encoding="utf-8") == "3.12\n"
     assert (dest / "config" / "env.py").is_file()
@@ -47,6 +54,46 @@ def test_scaffold_from_non_project_cwd(tmp_path: Path, monkeypatch):
     assert any(line.startswith("write .cursor/REGISTRY.md") for line in actions)
 
 
+def test_scaffold_project_name_follows_folder(tmp_path: Path):
+    dest = tmp_path / "Balance"
+    actions = scaffold(dest, with_ai=False)
+    text = (dest / "pyproject.toml").read_text(encoding="utf-8")
+    assert 'name = "balance"' in text
+    assert any(line == "write pyproject.toml (balance)" for line in actions)
+
+
+def test_scaffold_name_override(tmp_path: Path):
+    dest = tmp_path / "clients"
+    scaffold(dest, with_ai=False, project_name="Hospital-Billing")
+    text = (dest / "pyproject.toml").read_text(encoding="utf-8")
+    assert 'name = "Hospital-Billing"' in text
+
+
+def test_scaffold_rejects_invalid_name_before_creating_the_folder(tmp_path: Path):
+    dest = tmp_path / "balance"
+    with pytest.raises(ValueError, match="invalid project name"):
+        scaffold(dest, with_ai=False, project_name="bad name")
+    assert not dest.exists()
+
+
+def test_cli_name_flag(tmp_path: Path, capsys: pytest.CaptureFixture[str]):
+    dest = tmp_path / "Balance"
+    code = main(["scaffold", str(dest), "--name", "balance", "--no-ai"])
+    captured = capsys.readouterr()
+    assert code == 0
+    assert "write pyproject.toml (balance)" in captured.out
+    assert 'name = "balance"' in (dest / "pyproject.toml").read_text(encoding="utf-8")
+
+
+def test_cli_rejects_invalid_name(tmp_path: Path, capsys: pytest.CaptureFixture[str]):
+    dest = tmp_path / "balance"
+    code = main(["scaffold", str(dest), "--name", "bad name", "--no-ai"])
+    captured = capsys.readouterr()
+    assert code == 2
+    assert "invalid project name" in captured.err
+    assert not dest.exists()
+
+
 def test_scaffold_uses_packaged_stubs_when_not_editable(tmp_path: Path, monkeypatch):
     """Simulate `uv tool install` (no template checkout beside site-packages)."""
     monkeypatch.chdir(tmp_path)

{tuner_testkit-6.0.0 → tuner_testkit-6.2.0/tuner_testkit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tuner-testkit
-Version: 6.0.0
+Version: 6.2.0
 Summary: Shared test runtime, recorders, and DNA overlay for SUT test repos
 Author: tuner-testkit contributors
 License-Expression: MIT
@@ -69,12 +69,18 @@ uv tool install tuner-testkit
 ### 2. 初始化测试仓
 
 ```bash
-tuner-init scaffold ../my-sut-tests
-cd ../my-sut-tests
+tuner-init scaffold ../balance
+cd ../balance
 uv sync
 ```
 
-`scaffold` 会铺六层目录、写入依赖 `tuner-testkit[db,api]` 的 `pyproject.toml`，并执行一次 `tuner-dna sync`（把 `.cursor/`、`docs/spec/`、`tools/git-hooks/` 放进**项目树**）。可在任意目录运行，不必先有测试仓。不要用 `tuner-testkit init repo`。
+`scaffold` 会铺六层目录、写入依赖 `tuner-testkit[db,api]>=<当前 kit 版本>` 的 `pyproject.toml`，并执行一次 `tuner-dna sync`（把 `.cursor/`、`docs/spec/`、`tools/git-hooks/` 放进**项目树**）。可在任意目录运行，不必先有测试仓。不要用 `tuner-testkit init repo`。
+
+生成的文件夹名就是 `target` 路径的最后一段。`pyproject.toml` 里的项目名默认取这个文件夹名（`Balance` 会写成 `balance`）。需要另起项目名时加 `--name`：
+
+```bash
+tuner-init scaffold ../clients/acme --name acme-billing
+```
 
 `uv sync` 把 **db / api 装进业务仓 `.venv`**，不是 tool 域。已有项目仓则在该仓根目录：
 
@@ -221,4 +227,4 @@ uv sync --extra all
 （被测系统 = 平台本身，uv workspace 成员，共用 `.venv`）：路线图在 `dogfood/assets/domain-notes/platform/roadmap.md`，
 验收活文档在 `dogfood/tests/features/`。见 [`dogfood/README.md`](dogfood/README.md)。
 
-6.0.0 发行说明（一条用例一个文件）见 [`docs/changelog/TEMPLATE-6.0.0.md`](docs/changelog/TEMPLATE-6.0.0.md)；5.3.1 发行说明（已回答提问归档）见 [`docs/changelog/TEMPLATE-5.3.1.md`](docs/changelog/TEMPLATE-5.3.1.md)；5.3.0 发行说明（功能用例集 `assets/testcases/`）见 [`docs/changelog/TEMPLATE-5.3.0.md`](docs/changelog/TEMPLATE-5.3.0.md)；5.2.0 发行说明（work task / 测试设计 / 证据附件）见 [`docs/changelog/TEMPLATE-5.2.0.md`](docs/changelog/TEMPLATE-5.2.0.md)；5.1.0 发行说明（工作台 / meta stamp / `--json`）见 [`docs/changelog/TEMPLATE-5.1.0.md`](docs/changelog/TEMPLATE-5.1.0.md)；5.0.0（Plane Job 协议退场、`tuner-workspace`）见 [`TEMPLATE-5.0.0.md`](docs/changelog/TEMPLATE-5.0.0.md)；4.3.0 见 [`TEMPLATE-4.3.0.md`](docs/changelog/TEMPLATE-4.3.0.md)；3.x → 4.x 迁移见 [`TEMPLATE-4.0.0.md`](docs/changelog/TEMPLATE-4.0.0.md)。平台能力地图见 [`INDEX.md`](INDEX.md)。
+6.2.0 发行说明（测试单）见 [`docs/changelog/TEMPLATE-6.2.0.md`](docs/changelog/TEMPLATE-6.2.0.md)；6.1.0 发行说明（scaffold 项目名）见 [`docs/changelog/TEMPLATE-6.1.0.md`](docs/changelog/TEMPLATE-6.1.0.md)；6.0.0 发行说明（一条用例一个文件）见 [`docs/changelog/TEMPLATE-6.0.0.md`](docs/changelog/TEMPLATE-6.0.0.md)；5.3.1 发行说明（已回答提问归档）见 [`docs/changelog/TEMPLATE-5.3.1.md`](docs/changelog/TEMPLATE-5.3.1.md)；5.3.0 发行说明（功能用例集 `assets/testcases/`）见 [`docs/changelog/TEMPLATE-5.3.0.md`](docs/changelog/TEMPLATE-5.3.0.md)；5.2.0 发行说明（work task / 测试设计 / 证据附件）见 [`docs/changelog/TEMPLATE-5.2.0.md`](docs/changelog/TEMPLATE-5.2.0.md)；5.1.0 发行说明（工作台 / meta stamp / `--json`）见 [`docs/changelog/TEMPLATE-5.1.0.md`](docs/changelog/TEMPLATE-5.1.0.md)；5.0.0（Plane Job 协议退场、`tuner-workspace`）见 [`TEMPLATE-5.0.0.md`](docs/changelog/TEMPLATE-5.0.0.md)；4.3.0 见 [`TEMPLATE-4.3.0.md`](docs/changelog/TEMPLATE-4.3.0.md)；3.x → 4.x 迁移见 [`TEMPLATE-4.0.0.md`](docs/changelog/TEMPLATE-4.0.0.md)。平台能力地图见 [`INDEX.md`](INDEX.md)。