tuner-testkit 5.0.0__tar.gz → 5.2.0__tar.gz

{tuner_testkit-5.0.0/tuner_testkit.egg-info → tuner_testkit-5.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tuner-testkit
-Version: 5.0.0
+Version: 5.2.0
 Summary: Shared test runtime, recorders, and DNA overlay for SUT test repos
 Author: tuner-testkit contributors
 License-Expression: MIT
@@ -26,6 +26,9 @@ Provides-Extra: mock
 Requires-Dist: fastapi>=0.115.0; extra == "mock"
 Requires-Dist: uvicorn[standard]>=0.32.0; extra == "mock"
 Requires-Dist: httpx>=0.28.0; extra == "mock"
+Provides-Extra: workbench
+Requires-Dist: tuner-testkit[mock]; extra == "workbench"
+Requires-Dist: jinja2>=3.1.0; extra == "workbench"
 Provides-Extra: recorder
 Requires-Dist: playwright>=1.54.0; extra == "recorder"
 Requires-Dist: mitmproxy>=11.1.3; extra == "recorder"
@@ -38,7 +41,7 @@ Requires-Dist: behave>=1.2.6; extra == "bdd"
 Requires-Dist: playwright>=1.54.0; extra == "bdd"
 Requires-Dist: behave-html-pretty-formatter>=1.16.1; extra == "bdd"
 Provides-Extra: all
-Requires-Dist: tuner-testkit[api,bdd,db,excel,fake,mock,phone-ui,recorder,test,web-ui]; extra == "all"
+Requires-Dist: tuner-testkit[api,bdd,db,excel,fake,mock,phone-ui,recorder,test,web-ui,workbench]; extra == "all"
 Provides-Extra: dev
 Requires-Dist: tuner-testkit[all]; extra == "dev"
 Dynamic: license-file
@@ -218,4 +221,4 @@ uv sync --extra all
 （被测系统 = 平台本身，uv workspace 成员，共用 `.venv`）：路线图在 `dogfood/assets/domain-notes/platform/roadmap.md`，
 验收活文档在 `dogfood/tests/features/`。见 [`dogfood/README.md`](dogfood/README.md)。
 
-5.0.0 发行说明（Plane Job 协议退场、`tuner-workspace`）见 [`docs/changelog/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)。
+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-5.0.0 → tuner_testkit-5.2.0}/README.md

@@ -173,4 +173,4 @@ uv sync --extra all
 （被测系统 = 平台本身，uv workspace 成员，共用 `.venv`）：路线图在 `dogfood/assets/domain-notes/platform/roadmap.md`，
 验收活文档在 `dogfood/tests/features/`。见 [`dogfood/README.md`](dogfood/README.md)。
 
-5.0.0 发行说明（Plane Job 协议退场、`tuner-workspace`）见 [`docs/changelog/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)。
+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-5.0.0 → tuner_testkit-5.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tuner-testkit"
-version = "5.0.0"
+version = "5.2.0"
 description = "Shared test runtime, recorders, and DNA overlay for SUT test repos"
 readme = "README.md"
 license = "MIT"
@@ -37,6 +37,10 @@ mock = [
     "uvicorn[standard]>=0.32.0",
     "httpx>=0.28.0",
 ]
+workbench = [
+    "tuner-testkit[mock]",
+    "jinja2>=3.1.0",
+]
 recorder = [
     "playwright>=1.54.0",
     "mitmproxy>=11.1.3",
@@ -53,7 +57,7 @@ bdd = [
 ]
 # Union of capability extras (excludes `dev` to avoid a cycle).
 all = [
-    "tuner-testkit[db,api,web-ui,phone-ui,excel,fake,mock,recorder,test,bdd]",
+    "tuner-testkit[db,api,web-ui,phone-ui,excel,fake,mock,recorder,test,bdd,workbench]",
 ]
 dev = [
     "tuner-testkit[all]",
@@ -74,6 +78,8 @@ tuner-fake = "tuner_testkit.fake.cli:main"
 tuner-page-test = "tuner_testkit.page_test.__main__:main"
 tuner-action-words = "tuner_testkit.action_words.__main__:main"
 tuner-evidence = "tuner_testkit.apps.evidence.cli:main"
+tuner-task = "tuner_testkit.apps.task.cli:main"
+tuner-workbench = "tuner_testkit.workbench.cli:main"
 
 [build-system]
 requires = ["setuptools>=77", "wheel"]
@@ -85,6 +91,7 @@ include = ["tuner_testkit*"]
 [tool.setuptools.package-data]
 "tuner_testkit.apps.dna" = ["dna_payload/**/*"]
 "tuner_testkit.apps.init_repo" = ["stubs/**/*"]
+"tuner_testkit.workbench" = ["templates/**/*", "static/**/*"]
 
 [tool.setuptools.cmdclass]
 build_py = "tuner_testkit.apps.dna.build.BuildPyWithDna"

{tuner_testkit-5.0.0 → tuner_testkit-5.2.0}/tuner_testkit/__init__.py

@@ -2,4 +2,4 @@
 
 from __future__ import annotations
 
-__version__ = "4.4.0"
+__version__ = "5.2.0"

{tuner_testkit-5.0.0 → tuner_testkit-5.2.0}/tuner_testkit/action_words/base.py

@@ -79,6 +79,8 @@ class ActionWord(ABC):
     datasource: ClassVar[str] = DEFAULT_ALIAS
     #: 可直接运行的入参样例（必须能通过 Params 校验）
     example_params: ClassVar[dict[str, Any]] = {}
+    #: 工作台 / catalog 目录可见性。``local`` 不进工作台列表。
+    visibility: ClassVar[str] = "workbench"
 
     class Params(BaseModel):
         """入参契约；子类内嵌覆盖。未知键一律拒绝，避免拼写错误静默生效。"""
@@ -127,5 +129,6 @@ class ActionWord(ABC):
             "datasource": cls.datasource,
             "doc": (cls.__doc__ or "").strip(),
             "params_schema": cls.params_schema(),
-            "example_params": cls.example_params,
+            "example_params": dict(cls.example_params or {}),
+            "visibility": getattr(cls, "visibility", "workbench") or "workbench",
         }

{tuner_testkit-5.0.0 → tuner_testkit-5.2.0}/tuner_testkit/action_words/registry.py

@@ -36,6 +36,9 @@ def register(cls: type[ActionWord]) -> type[ActionWord]:
         raise ValueError(f"{word_id}: 必须有业务 docstring")
     if not word_id.startswith(f"{cls.category}."):
         raise ValueError(f"{word_id}: word_id 须以类别前缀开头，如 '{cls.category}.xxx'")
+    visibility = getattr(cls, "visibility", "workbench") or "workbench"
+    if visibility not in {"workbench", "local"}:
+        raise ValueError(f"{word_id}: visibility 须是 'workbench' 或 'local'")
     existing = _REGISTRY.get(word_id)
     if existing is not None and existing is not cls:
         raise ValueError(f"word_id 重复注册: {word_id} ({existing.__name__} vs {cls.__name__})")
@@ -64,8 +67,22 @@ def iter_ids() -> Iterable[str]:
 _discovered = False
 
 
+def _import_word_package(pkg: Any) -> None:
+    """递归导入类别子包（含 ``db_seed/audit`` 这类业务子目录）。跳过 ``_`` 前缀。"""
+    paths = getattr(pkg, "__path__", None)
+    if not paths:
+        return
+    for mod_info in pkgutil.iter_modules(paths, prefix=f"{pkg.__name__}."):
+        short = mod_info.name.rsplit(".", 1)[-1]
+        if short.startswith("_"):
+            continue
+        module = importlib.import_module(mod_info.name)
+        if mod_info.ispkg:
+            _import_word_package(module)
+
+
 def discover() -> None:
-    """导入全部类别子包下的模块，触发 ``@register`` 副作用。幂等。"""
+    """导入全部类别子包下的模块（含子目录），触发 ``@register`` 副作用。幂等。"""
     global _discovered
     if _discovered:
         return
@@ -80,8 +97,7 @@ def discover() -> None:
             pkg = importlib.import_module(f"{root_pkg.__name__}.{sub}")
         except ModuleNotFoundError:
             continue  # 预留类别（如 ui_action）尚未建目录
-        for mod_info in pkgutil.iter_modules(pkg.__path__):
-            importlib.import_module(f"{pkg.__name__}.{mod_info.name}")
+        _import_word_package(pkg)
 
 
 def export_catalog() -> list[dict[str, Any]]:

{tuner_testkit-5.0.0 → tuner_testkit-5.2.0}/tuner_testkit/apps/dna/dna_payload/.cursor/rules/apps-authoring.mdc

@@ -2,7 +2,7 @@
 description: SUT apps/ and kit tuner_testkit.apps tools must be standalone-runnable and reuse tuner_testkit plus this repo's packages business assets; no reinventing wheels, no secrets, not imported by tests
 globs: apps/**,tuner_testkit/apps/**
 alwaysApply: false
-version: 2.0.0
+version: 2.0.1
 ---
 
 # apps — 创建期约束
@@ -43,6 +43,7 @@ version: 2.0.0
   不写 `tool.py`，或写了但 `visibility="local"`。
 - 发现器只 import `apps/*/tool.py` 与 kit 的 `tuner_testkit/apps/*/tool.py`；`cli.py` 可以较重，
   但 `tool.py` 及其 import 的模块禁止顶层 import DB 驱动 / Playwright / mitmproxy。
+  没有 `apps/<name>/tool.py` = 工作台当它不存在。
 - 需要机器可读输出时用 `--json` envelope（`status / outputs[] / artifacts[] / log_path`），见规范 §7。
 
 ## 相关

{tuner_testkit-5.0.0 → tuner_testkit-5.2.0}/tuner_testkit/apps/dna/dna_payload/.cursor/rules/commit-convention.mdc

@@ -1,7 +1,7 @@
 ---
 description: Commits must follow Conventional Commits with a layer-aligned scope; the declared scope must cover the layers actually changed. Single source of truth is docs/spec/commit-convention.md.
 alwaysApply: true
-version: 1.1.0
+version: 1.2.0
 ---
 
 # 提交规范（Conventional Commits + 六层 scope）
@@ -12,8 +12,8 @@ version: 1.1.0
 - `type` ∈ `feat|fix|refactor|docs|test|perf|chore|build|ci|style|revert`。
 - `scope` 用**对齐六层/资产类别**的值：`assets / apps / packages / api_objects /
   page_objects / action_words / tests / docs / rules / skills / agents / hooks /
-  init_repo / index / dogfood`（多层用逗号分隔，如 `feat(apps,packages): ...`；
-  `dogfood/**` 一律用 `dogfood`）。
+  init_repo / index / dogfood / work`（多层用逗号分隔，如 `feat(apps,packages): ...`；
+  `dogfood/**` 一律用 `dogfood`；`work/tasks` 用 `work`）。
 - **scope 必须覆盖本次真实改动涉及的层**（`packages` 是三个子资产层的上位 scope）。
 
 一眼可读优先：让人从提交信息就看出"更新了 assets、新增了 apps、录制了新的 api_objects"等。

tuner_testkit-5.2.0/tuner_testkit/apps/dna/dna_payload/.cursor/rules/work-task.mdc

@@ -0,0 +1,24 @@
+---
+description: Work tasks live in work/tasks. When a human must choose a missing evidence channel, write an inbox question and block the task instead of inventing the channel.
+alwaysApply: true
+version: 1.0.0
+---
+
+# 工作任务与人类提问
+
+细则见 `docs/spec/work-task.md`、`docs/spec/test-design-syntax.md`。
+
+## Must
+
+- 人发布的任务用 `tuner-task create` 写入 `work/tasks/TASK-*.md`，不要只留在聊天里。
+- 测试设计写入 `assets/testdesign/`，并用 `tuner-task validate` 检查八个章节。
+- 端到端点击用 `type: test-execution`，`design` 指向已有测试设计；报告写入 `assets/testreport/`，证据用 `tuner-evidence persist` 或 `attach` 挂上 `task_id`、截图、脱敏日志、接口 JSON。
+- 执行结束后把结果写入该测试设计的「执行反馈」，只引用证据路径。
+- 仓库没有写明的证据通道（典型是后端日志：SSH 目录、日志接口、Rancher API）立刻 `tuner-task ask`。日志主题用 `sut-log-source`。
+- 提问写入 `artifacts/inbox/questions/` 后停止这一支，把任务保持在 `blocked`，直到 `tuner-task answer`。
+
+## Must not
+
+- 在人回答前选定日志通道，或编写对应的 SSH / HTTP / Rancher 取数实现。
+- 把密码、token、Cookie 写进任务、问题、`--note` 或 domain-notes。用 `account_id`、环境变量名或 `config/env_local.py` 指向。
+- 用 `artifacts/inbox/` 的会话流水代替 `work/tasks`。会话流水仍然要写，见 `agent-task-log`。

{tuner_testkit-5.0.0 → tuner_testkit-5.2.0}/tuner_testkit/apps/dna/dna_payload/.cursor/skills/create-action-word/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: create-action-word
-version: 1.1.2
+version: 1.1.4
 description: Creates or updates action words under packages/action_words/ following action-words-syntax.md. Use when adding DB seed/assert, API request/assert, or UI action/assert business actions, or when migrating ad-hoc test logic (SQL scripts, step bodies) into reusable action words.
 ---
 
@@ -39,7 +39,7 @@ description: Creates or updates action words under packages/action_words/ follow
 
 - 类与模块 docstring 描述业务/前置条件/副作用（非一行占位）；
 - `word_id` / `name`（中文业务名）/ `category` 必填，word_id 前缀与 category 一致；
-- `Params`：pydantic v2，`extra="forbid"`，**每个字段**带类型 + `Field(description=中文)`；
+- `Params`：pydantic v2，`extra="forbid"`，**每个字段**带类型 + `Field(description=中文)`（工作台表单 label）；
 - `Result` 继承 `ActionResult`，业务字段同样带 description；
 - `example_params` 非空且能通过 `Params.model_validate`；
 - `run(params)` 带完整类型标注；
@@ -48,6 +48,12 @@ description: Creates or updates action words under packages/action_words/ follow
 - 资源一律经 `self.ctx`（DB 用 `self.db`，即
   `ctx.get_db(cls.datasource)`；API 用 `ctx.api_token`），不自建连接；
 - 源码 / example / 日志中不得出现真实 token、密码、Cookie。
+- 工作台只扫 `packages/action_words/{db_seed,db_assert,api_request,api_assert,ui_action,ui_assert}/`
+  （含子目录 `*.py`）上的 `@register`；没有入口文件 = 工作台当它不存在。
+  **必须用 kit 的 register**：`from packages.action_words import register`，且
+  `__init__.py` re-export `tuner_testkit.action_words.register`（或本仓 register 双写 kit）。
+  本仓自建 registry、不接到 kit 的 `@register` **不会**进工作台。
+  默认 `visibility = "workbench"`，`local` 不进目录。模块顶层不得连库 / 读 `env_local`。
 
 ## Recommended structure (db_seed)
 

{tuner_testkit-5.0.0 → tuner_testkit-5.2.0}/tuner_testkit/apps/dna/dna_payload/.cursor/skills/create-app/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: create-app
 description: Scaffolds a new standalone SUT-private tool under apps/ that reuses tuner_testkit plus this repo's packages business assets, following apps-authoring-syntax.md. Use when the engineer needs an on-demand test tool (data generator, checker, exporter, capture/enrichment). Do not scaffold into tuner_testkit/apps/.
-version: 1.1.0
+version: 1.2.1
 ---
 
 # Create App — 按需开发一个独立工具
@@ -28,9 +28,10 @@ version: 1.1.0
 apps/<name>/
 ├── __init__.py
 ├── __main__.py        # from .cli import main; raise SystemExit(main())
-├── cli.py             # argparse 入口，调用核心逻辑
+├── cli.py             # argparse：build_parser() + main()；每个参数有 help；带 --json
+├── tool.py            # import-safe：用 @tool 装饰 build_parser（工作台 / catalog）
 ├── <core>.py          # 纯逻辑，尽量可离线单测
-├── README.md          # 交接文档(见下)
+├── README.md          # 交接文档 + metadata-conventions front-matter
 └── tests/             # 离线单测
 ```
 
@@ -43,7 +44,11 @@ apps/<name>/
   + 环境变量取；**禁止** `print`、直连驱动、硬编码 DSN、SQL 拼接、自建日志文件。
 - 覆盖式生成 `assets/**` / `packages/api_objects/**` / `packages/page_objects/**` 的工具，运行结束必须
   `tuner_testkit.apps._shared.changelog.append_entry(...)` 追加对应区 `CHANGELOG.md`。
-- 不得被 `tests/` import；不得写入 token/cookie/密码等敏感值；破坏性操作默认 dry-run/只读。
+- 不得被 `tests/` import；不得写入 token/cookie/密码等敏感值；破坏性操作默认 dry-run/只读，`@tool(..., destructive=True)`。
+- `tool.py` 及其 import **禁止**顶层 import DB / Playwright / mitmproxy。
+  没有 `apps/<name>/tool.py` + `@tool` = 工作台当它不存在。
+- `--json` 时 stdout 打印 envelope：`status / outputs[] / artifacts[] / log_path`（见 apps-authoring-syntax §7）。
+- README 写完后立刻 `uv run tuner-workspace meta stamp apps/<name>/README.md --kind app`（不要手填邮箱）。
 
 ## 交接文档（完成期必产出）
 
@@ -53,8 +58,9 @@ apps/<name>/
 ## Verify
 
 1. `python -m apps.<name> --help` 正常输出用法。
-2. 离线单测 `uv run pytest apps/<name>/tests -q`（若有）。
-3. 有环境时跑一条示例命令，确认产出位置与 `CHANGELOG` 追加正确。
+2. `tuner-workspace catalog` 的 `tools[]` 出现该 `tool_id`，且 `params_schema.properties` 每项有 `description`。
+3. 离线单测 `uv run pytest apps/<name>/tests -q`（若有）。
+4. 有环境时跑一条示例命令，确认产出位置与 `CHANGELOG` 追加正确。
 
 ## Output checklist
 

tuner_testkit-5.2.0/tuner_testkit/apps/dna/dna_payload/.cursor/skills/derive-test-design/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: derive-test-design
+version: 1.0.0
+description: Write assets/testdesign/<sut>/<slug>.md from a work task plus usecases, domain-notes, explore, or design notes. Use when the task type is test-design or the user asks for a test design. Do not invent click paths that are not in evidence or a cited source.
+---
+
+# Derive test design
+
+## Scope
+
+- **Write**: `assets/testdesign/<sut>/<slug>.md`，并让任务的 `outputs` 指向它。
+- **Read**: `work/tasks/<id>.md`、`assets/usecases`、`assets/domain-notes`、`assets/explore`、`assets/design`、`INDEX.md`（及 `INDEX.project.md`）。
+- **Must follow**: `docs/spec/test-design-syntax.md`、`docs/spec/work-task.md`。
+
+## Steps
+
+1. 若还没有任务：`tuner-task create --type test-design --title … --input <已有知识路径>`。
+2. 只根据 inputs 里点名的知识写范围、不测、风险、策略、点击路径、用例大纲。没有页面流或证据支撑的点击行不要编。
+3. 「执行反馈」写「无」。
+4. front-matter：`kind: testdesign`，`task_id` 指向任务，`source` 或 `evidence` 至少一项。
+5. 校验并署名：
+
+```bash
+uv run tuner-task validate assets/testdesign/<sut>/<slug>.md
+uv run tuner-workspace meta stamp assets/testdesign/<sut>/<slug>.md --kind testdesign
+```
+
+6. 把该路径挂到任务上：`uv run tuner-task bind <TASK> --output assets/testdesign/<sut>/<slug>.md`。
+
+## Template
+
+```markdown
+---
+kind: testdesign
+id: <slug>
+title: <一句话>
+sut: <sut>
+task_id: TASK-YYYYMMDD-nnn
+source: <assets/...>
+version: 1.0.0
+confidence: high
+evidence: []
+---
+
+# <title>
+
+## 范围
+
+## 不测
+
+## 风险
+
+## 策略
+
+## 点击路径
+
+| id | 页面流 | 操作 | 期望 |
+| --- | --- | --- | --- |
+
+## 用例大纲
+
+## 执行反馈
+
+| run_id | task_id | 结果 | 要回写的结论 |
+| --- | --- | --- | --- |
+
+## 证据与来源
+```
+
+## Hard rules
+
+- 缺日志来源时 `tuner-task ask --topic sut-log-source`，不要写死 SSH、日志接口或 Rancher。
+- 不把响应体、截图、密钥抄进设计。

tuner_testkit-5.2.0/tuner_testkit/apps/dna/dna_payload/.cursor/skills/generate-test-report/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: generate-test-report
+description: Turn a regression run under artifacts/reports/<run_id>/ (plus inbox and optional design notes) into a curated Markdown test report at assets/testreport/<sut>/<yyyy-mm>/<slug>.md with metadata-conventions front-matter. Use when the user asks to 生成测试报告 / write a test report / 汇总回归结果.
+version: 1.1.0
+---
+
+# Generate Test Report
+
+## Scope
+
+- **Write**: `assets/testreport/<sut>/<yyyy-mm>/<slug>.md` only（策展知识，不是原始报告）。
+- **Read**: `artifacts/reports/<run_id>/manifest.json` + `summary.json`；可选 `artifacts/inbox/`、`assets/design/**`、`INDEX.project.md`。
+- **Must follow**: `docs/spec/metadata-conventions.md`、`docs/spec/artifacts-layout.md`、`docs/spec/assets-knowledge-syntax.md`。
+
+## Steps
+
+1. 选定 `run_id`（用户给出，或取 `artifacts/reports/` 最新一份 `manifest.json`）。
+2. 读 manifest / summary，**不要编造**未出现的失败数或缺陷。
+3. 定 `<sut>`（`INDEX.project.md` 或用户指定，默认 `platform`）与 `<slug>`（短横线，如 `qa-daily-offline`）。
+4. 写文件，front-matter：
+
+```markdown
+---
+kind: testreport
+id: <slug>
+title: <一句话>
+author: ""
+created:
+updated:
+version: 1.0.0
+sut: <sut>
+env: <命名环境或 unknown>
+run_id: <run_id>
+period: <YYYY-MM>
+result: {total: 0, passed: 0, failed: 0}
+evidence: []
+features: []
+task_id:          # 有 work task 时填写
+design:           # test-execution 指向 assets/testdesign/...
+confidence: high
+source: artifacts/reports/<run_id>
+---
+```
+
+5. 正文固定六个二级标题，缺信息写「无」而不是省略：
+
+```markdown
+## 范围
+## 环境
+## 结果
+## 缺陷
+## 风险
+## 证据链接
+```
+
+6. 立刻运行（不要手填邮箱）：
+
+```bash
+uv run tuner-workspace meta stamp assets/testreport/<sut>/<yyyy-mm>/<slug>.md --kind testreport
+```
+
+7. 如有 `INDEX.project.md` 的 testreport 自动区，跑 `tuner-workspace index render`；否则用 `maintain-index` 在人工区加一行。
+
+## Hard rules
+
+- 不得把 token / cookie / 密码写进报告。
+- 不得把 `artifacts/evidence/` 原文贴进仓库；只写相对路径链接。
+- `assets/testreport` 是策展知识；原始 html/junit 留在 `artifacts/reports/`。
+
+## Verify
+
+1. front-matter 含 `kind: testreport`、`run_id`、`result`。
+2. `tuner-workspace meta stamp` 后 `author` 非空（本机有 git email）。
+3. 六个章节都在。

tuner_testkit-5.2.0/tuner_testkit/apps/dna/dna_payload/.cursor/skills/run-test-execution/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: run-test-execution
+version: 1.0.0
+description: Run the click paths in a test design, attach screenshots and sanitized API or log evidence, and write a curated test report that links back to the design. Use when the task type is test-execution or the user asks for an end-to-end click report.
+---
+
+# Run test execution
+
+## Scope
+
+- **Read**: 任务的 `design`（`assets/testdesign/**`）及其「点击路径」。
+- **Write**: `assets/testreport/<sut>/<yyyy-mm>/<slug>.md`，回写设计的「执行反馈」，必要时 `tuner-evidence attach`。
+- **Must follow**: `docs/spec/work-task.md`、`docs/spec/test-design-syntax.md`、`generate-test-report` skill。
+
+## Steps
+
+1. `tuner-task create --type test-execution --title … --design assets/testdesign/<sut>/<slug>.md`，或继续已有任务。然后 `tuner-task start <id>`。
+2. 按「点击路径」每一行执行 `python -m tuner_testkit.page_test run <page_id> --flow <flow>`，或对应的 behave UI 场景。失败步使用 page_test 已有的整页截图路径。
+3. 把当次网络、截图、接口 JSON、日志片段放进同一次 evidence run，并带上任务号：
+
+```bash
+uv run tuner-evidence persist --run-id <run_id> --scenario explore:<slug> --network captures.jsonl --task-id <TASK> --screenshot <png> --api <response.json>
+uv run tuner-evidence attach --run-id <run_id> --task-id <TASK> --log <excerpt.log> --screenshot <png>
+```
+
+4. 设计要求日志证据，但仓库没有 log provider（domain-notes 或 `apps/` 里没有）时，立刻：
+
+```bash
+uv run tuner-task ask --task <TASK> --topic sut-log-source --prompt "仓库没有写明后端日志从哪取"
+```
+
+然后停止依赖日志的回写。不要选择 SSH、日志接口或 Rancher，也不要开始写 fetcher。人回答后再按 `create-app` 做对应工具。人选择 `skip` 时，报告里日志写「无」。
+
+5. 用 `generate-test-report` 写报告。front-matter 额外加上 `task_id` 与 `design`。结果表每一行带证据相对路径（截图、`api/*.json`、`logs/*.log`）。
+6. 在测试设计「执行反馈」追加一行：`run_id`、`task_id`、通过或失败、要回写的结论。不改「范围」，除非人确认。
+7. `uv run tuner-task bind <id> --output assets/testreport/<sut>/<yyyy-mm>/<slug>.md --evidence artifacts/evidence/<run_id>/`，然后 `tuner-task finish <id>`。仍有未答问题时 CLI 会失败。
+
+## Hard rules
+
+- 报告和设计只链到 `artifacts/evidence/<run_id>/`，不入库截图或响应原文。
+- 不编造未出现在 summary 或证据里的失败数。
+- 点出的新副作用策展到 `assets/design/`，并在设计的风险里加一行指向同一 `run_id`。

{tuner_testkit-5.0.0 → tuner_testkit-5.2.0}/tuner_testkit/apps/dna/dna_payload/AGENTS.md

@@ -1,4 +1,4 @@
-<!-- version: 1.5.0 -->
+<!-- version: 1.6.0 -->
 # AGENTS — 平台总入口（轻量 DM）
 
 > 本文件是"repo as a platform"的**稳定世界观**：只写不常变的分层结构与角色。
@@ -13,7 +13,7 @@
 
 | 层 | 目录 | 职责 | 谁运行 |
 | --- | --- | --- | --- |
-| 知识层 | `assets/` | 给人和 LLM 阅读、生成测试代码的基础知识（ddl / sql / usecases / domain-notes / explore / design / testreport）。见 `docs/spec/assets-knowledge-syntax.md`。 | 只读引用 |
+| 知识层 | `assets/` | 给人和 LLM 阅读、生成测试代码的基础知识（ddl / sql / usecases / domain-notes / explore / design / testdesign / 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>`（仅项目工具） |
@@ -21,7 +21,7 @@
 | 测试层 | `tests/` | 自动化测试代码（behave `features/` + `pytest/`）。 | behave / pytest |
 | 文档层 | `docs/` | 仓库使用说明与规范（`docs/spec/**`）。 | 只读 |
 
-配套：`config/`（环境/数据源）、`.cursor/`（AI 组件，见下）、`artifacts/`·`logs/`（运行产出，规范 `docs/spec/artifacts-layout.md`：MCP evidence 落 `artifacts/evidence/<run_id>/`；agent 任务记录落 `artifacts/inbox/`；工具运行落 `artifacts/runs/<run_id>/`；回归报告落 `artifacts/reports/<run_id>/`，每个 run 目录带 `manifest.json`）。SUT 登录本机文件：`data/sut-accounts.local.yaml`（gitignore）。
+配套：`config/`（环境/数据源）、`.cursor/`（AI 组件，见下）、`work/tasks/`（入库的任务上下文，规范 `docs/spec/work-task.md`）、`artifacts/`·`logs/`（运行产出，规范 `docs/spec/artifacts-layout.md`：MCP evidence 落 `artifacts/evidence/<run_id>/`；agent 任务记录落 `artifacts/inbox/`；阻塞式人类提问落 `artifacts/inbox/questions/`；工具运行落 `artifacts/runs/<run_id>/`；回归报告落 `artifacts/reports/<run_id>/`，每个 run 目录带 `manifest.json`）。SUT 登录本机文件：`data/sut-accounts.local.yaml`（gitignore）。
 
 ## 2. 三角色
 
@@ -50,6 +50,7 @@ flowchart TD
   Q -->|"缺少知识(ddl/api/用例)"| Know["先跑 kit CLI 回填 assets\n再走生成"]
   Q -->|"新建/更新项目仓"| Init["tuner-init / tuner-dna / release-template"]
   Q -->|"读/策展/索引知识"| Idx["查 INDEX.md + maintain-index skill"]
+  Q -->|"发布任务 / 测试设计 / 端到端执行"| Task["work/tasks + tuner-task\ndocs/spec/work-task.md"]
 ```
 
 - **学习被测系统** → `.cursor/agents/sut-self-learning.md`（编排 explore → freeze → design；规格 `docs/spec/sut-self-learning.md`；任务 log 见 `docs/spec/agent-task-log.md`）。
@@ -59,6 +60,7 @@ flowchart TD
 - **补知识** → 用 `tuner-dump-ddl`、Playwright MCP 探索（落盘 `artifacts/evidence/`）、`tuner-recorder` / `tuner-api-recorder` / `tuner-page-recorder` 等回填，再进入生成。
 - **仓库初始化/发布** → `tuner-init scaffold`（骨架 + 依赖 `tuner-testkit` + 一次 `tuner-dna sync`）+ `release-template` skill。下游升 kit：`uv add tuner-testkit==x.y.z` 然后 `tuner-dna sync`，再提交。
 - **读/索引知识** → 先查 `INDEX.md`；若存在 `INDEX.project.md` 则一并查。索引维护用 `maintain-index` skill。
+- **发布任务** → `tuner-task create` 写入 `work/tasks/`。测试设计走 `derive-test-design`；端到端点击报告走 `run-test-execution`。缺人才能决定的通道（如后端日志）用 `tuner-task ask`，不要猜。
 
 ## 5. 全程硬约束（跨分支）
 

{tuner_testkit-5.0.0 → tuner_testkit-5.2.0}/tuner_testkit/apps/dna/dna_payload/MANIFEST.txt

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

{tuner_testkit-5.0.0 → tuner_testkit-5.2.0}/tuner_testkit/apps/dna/dna_payload/docs/spec/action-words-syntax.md

@@ -45,6 +45,12 @@ packages/action_words/
   （如 `create_invoice_relation` 与 `link_invoice_to_uninvoiced`）可同模块。
 - 新增类别子包后无需注册：`registry.discover()` 会自动扫描
   `_WORD_SUBPACKAGES` 中列出的子包。
+- **工作台入口**：发现器只扫
+  `packages/action_words/{db_seed,db_assert,api_request,api_assert,ui_action,ui_assert}/`
+  下的模块（允许业务子目录，如 `db_seed/audit/*.py`）。
+  `_internal/`、`models.py`、类别目录之外的路径不会出现在工作台。没有入口文件 = 工作台当它不存在。
+  `@register` 必须落到 **kit** registry（`packages.action_words` re-export
+  `tuner_testkit.action_words.register`，或本仓装饰器双写 kit）。本仓自建表不算登记。
 
 ## 类模板（强制）
 
@@ -65,7 +71,8 @@ class CreateInOut(ActionWord):
     tags = ("发票审计", "出入库")             # 业务域标签，便于目录过滤
     requires = frozenset({"db"})            # 依赖资源："db" / "api"
     datasource = "main"                     # 目标数据源别名（config/env.py DATABASES 键）
-    example_params = {...}                  # 必须能通过 Params 校验
+    example_params = {...}                  # 必须能通过 Params 校验；特化表单预填
+    visibility = "workbench"                # 可选；"local" 不进工作台目录
 
     Params = InOutParams                    # pydantic BaseModel，见下
 
@@ -130,7 +137,8 @@ uv run python -m tuner_testkit.action_words catalog [-o out.json] # 全量目录
 - `run` 输出 `Result` 的 JSON（含 cleanup 登记），退出码 0/1 对应成功/失败；
 - 手工造数后需要清理时，按输出的 cleanup 逐表 `DELETE ... WHERE id IN (...)`。
 - `catalog` 供本机调用 `export_catalog()`；`tuner-workspace catalog` 把**全部** `@register` 的词条（含 `params_schema`、
-  `destructive` 推断）写入 `artifacts/catalogs/workspace.json` 的 `action_words[]`，工作台据此渲染表单。
+  `destructive` 推断、`visibility`）写入 `artifacts/catalogs/workspace.json` 的 `action_words[]`。
+  工作台列表/搜索**不**读这份全量 JSON，只扫本节登记的入口（见下）。
 
 ## 与 BDD / pytest 的集成
 
@@ -144,12 +152,15 @@ uv run python -m tuner_testkit.action_words catalog [-o out.json] # 全量目录
 
 ## 与本地工作台（workbench）
 
-- `@register` 即可见：工作台从 `tuner-workspace catalog` 的 `action_words[]` 读取词条，不需要额外装饰器。
+- `@register` 即工作台登记，不需要第二套装饰器。类属性 `visibility` 默认 `"workbench"`；`"local"` 的词不进目录切片，仍可 CLI 运行。
+- 扫描只认类别目录下的模块：`packages/action_words/<category>/*.py`。模块必须 **import-safe**：顶层不得连库、不得读 `env_local`、不得启动浏览器。
+- `Params` 每字段 `Field(description=...)`、`example_params` 非空——特化表单依赖这两项。
 - 运行：工作台经 `tuner-workspace run <word_id> --params JSON` 调用
   `python -m tuner_testkit.action_words run <word_id> --params JSON`；只暴露 `word_id` 与 `--params`，
   不暴露 `--username` / `--password` / `--params-file`（凭据来自本机 `config/env_local.py`）。
 - `db_seed` / `api_request` / `ui_action` 三类按类别推断为 **destructive**：工作台要求勾选确认，未确认拒绝运行。
-- 每个 `Params` 字段的 `Field(description=...)` 就是表单 label；缺 description 会被模板测试拦截。
+- `db_seed` 有特化页（`/words/db_seed/<word_id>`）：预填 `example_params`、`dry_run` 缺省 True、结果强调 `cleanup[]`。
+  其它类别先走通用词页，kit 加类别时在 `tuner_testkit/workbench/kinds/` 加模块即可。
 
 
 ## 敏感信息
@@ -169,4 +180,5 @@ uv run python -m tuner_testkit.action_words catalog [-o out.json] # 全量目录
 5. `uv run pytest packages/tests/test_action_word_template.py` 通过；
 6. `python -m tuner_testkit.action_words run <word_id> --example` 冒烟（需要环境时）；
 7. 若供 behave 使用，在步骤层接线并跑 `behave --stage api --dry-run`。
-8. `tuner-workspace catalog` 后确认词条出现在 `action_words[]`（工作台随即可见）。
+8. `tuner-workspace catalog` 后确认词条出现在 `action_words[]`；工作台热路径读目录切片，
+   没有类别目录下的入口文件 = 工作台当它不存在。

{tuner_testkit-5.0.0 → tuner_testkit-5.2.0}/tuner_testkit/apps/dna/dna_payload/docs/spec/agent-task-log.md

@@ -64,7 +64,17 @@ evidence:
 
 对照两轮 dogfood 时，另写 `## Loop delta`：相对上一份 inbox，少了哪些手工步骤、多了哪些平台能力。
 
-## 4. 密钥
+## 4. 人类提问（阻塞）
+
+必须由人选择的缺口（仓库没写明的后端日志来源等）不写进会话流水，立刻另存：
+
+```text
+artifacts/inbox/questions/Q-<YYYYMMDD>-<nnn>.md
+```
+
+字段与命令见 `docs/spec/work-task.md`。提问后把对应 `work/tasks` 标为 `blocked`。回答写入任务的 `## Decisions`；可复用的通道说明策展到 `assets/domain-notes/`。
+
+## 5. 密钥
 
 - 可用 `account_id` 指向 `data/sut-accounts.local.yaml` 的条目。
 - 禁止密码、token、Cookie、Authorization 原文。