tuner-testkit 5.3.0__tar.gz → 5.3.1__tar.gz

{tuner_testkit-5.3.0/tuner_testkit.egg-info → tuner_testkit-5.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tuner-testkit
-Version: 5.3.0
+Version: 5.3.1
 Summary: Shared test runtime, recorders, and DNA overlay for SUT test repos
 Author: tuner-testkit contributors
 License-Expression: MIT
@@ -221,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.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)。
+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-5.3.0 → tuner_testkit-5.3.1}/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.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)。
+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-5.3.0 → tuner_testkit-5.3.1}/pyproject.toml

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

{tuner_testkit-5.3.0 → tuner_testkit-5.3.1}/tuner_testkit/__init__.py

@@ -2,4 +2,4 @@
 
 from __future__ import annotations
 
-__version__ = "5.3.0"
+__version__ = "5.3.1"

{tuner_testkit-5.3.0 → tuner_testkit-5.3.1}/tuner_testkit/apps/dna/dna_payload/.cursor/rules/work-task.mdc

@@ -1,7 +1,7 @@
 ---
 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
+version: 1.1.0
 ---
 
 # 工作任务与人类提问
@@ -15,7 +15,7 @@ version: 1.0.0
 - 端到端点击用 `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`。
+- 提问写入 `artifacts/inbox/questions/` 后停止这一支，把任务保持在 `blocked`，直到 `tuner-task answer`。回答后的问题文件在 `artifacts/inbox/archived-question/`。
 
 ## Must not
 

{tuner_testkit-5.3.0 → tuner_testkit-5.3.1}/tuner_testkit/apps/dna/dna_payload/AGENTS.md

@@ -1,4 +1,4 @@
-<!-- version: 1.7.0 -->
+<!-- version: 1.7.1 -->
 # AGENTS — 平台总入口（轻量 DM）
 
 > 本文件是"repo as a platform"的**稳定世界观**：只写不常变的分层结构与角色。
@@ -21,7 +21,7 @@
 | 测试层 | `tests/` | 自动化测试代码（behave `features/` + `pytest/`）。 | behave / pytest |
 | 文档层 | `docs/` | 仓库使用说明与规范（`docs/spec/**`）。 | 只读 |
 
-配套：`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）。
+配套：`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/inbox/archived-question/`；工具运行落 `artifacts/runs/<run_id>/`；回归报告落 `artifacts/reports/<run_id>/`，每个 run 目录带 `manifest.json`）。SUT 登录本机文件：`data/sut-accounts.local.yaml`（gitignore）。
 
 ## 2. 三角色
 

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

@@ -72,7 +72,7 @@ evidence:
 artifacts/inbox/questions/Q-<YYYYMMDD>-<nnn>.md
 ```
 
-字段与命令见 `docs/spec/work-task.md`。提问后把对应 `work/tasks` 标为 `blocked`。回答写入任务的 `## Decisions`；可复用的通道说明策展到 `assets/domain-notes/`。
+回答后同一文件移到 `artifacts/inbox/archived-question/`。字段与命令见 `docs/spec/work-task.md`。提问后把对应 `work/tasks` 标为 `blocked`。回答写入任务的 `## Decisions`；可复用的通道说明策展到 `assets/domain-notes/`。
 
 ## 5. 密钥
 

{tuner_testkit-5.3.0 → tuner_testkit-5.3.1}/tuner_testkit/apps/dna/dna_payload/docs/spec/artifacts-layout.md

@@ -16,7 +16,8 @@ description: 交付物目录 artifacts/ 的子目录职责、run 级 manifest.js
 artifacts/
 ├── evidence/<run_id>/     # Playwright MCP / 网络 dump（tuner-evidence persist）；脱敏；gitignore
 ├── inbox/<utc>-<agent>-<slice>.md   # agent 任务记录（agent-task-log.md）；gitignore
-├── inbox/questions/Q-<YYYYMMDD>-<nnn>.md # 阻塞式人类提问（work-task.md）；gitignore
+├── inbox/questions/Q-<YYYYMMDD>-<nnn>.md # 未回答的人类提问（work-task.md）；gitignore
+├── inbox/archived-question/Q-<YYYYMMDD>-<nnn>.md # 已回答的提问；gitignore
 ├── runs/<run_id>/         # 工具 / 动作词的一次运行（tuner-workspace run、工作台）；gitignore
 ├── reports/<run_id>/      # 一次回归（behave / pytest）的报告与摘要；gitignore
 ├── catalogs/workspace.json          # tuner-workspace catalog 产物；gitignore
@@ -68,7 +69,7 @@ artifacts/
 | behave（`*_environment.py` 钩子） | `reports/<run_id>/` | `summary.json`（feature/scenario 状态）、`manifest.json`；`-f html-pretty -o $TUNER_REPORT_DIR/report.html` 时 html 同目录 |
 | pytest | `reports/<run_id>/` | `pytest --junitxml artifacts/reports/<run_id>/junit.xml`，再 `tuner_testkit.artifacts.finish_run` 写 manifest |
 | `tuner-evidence persist` / `attach` | `evidence/<run_id>/` | `network.jsonl` / `actions.jsonl` / `run_summary.md` / `screenshots/` / `logs/` / `api/`；`manifest.params.task_id` 指向 `work/tasks` |
-| agent（编排） | `inbox/` | 会话流水见 `agent-task-log.md`；人类提问见 `inbox/questions/` 与 `work-task.md` |
+| agent（编排） | `inbox/` | 会话流水见 `agent-task-log.md`；未回答提问见 `inbox/questions/`，已回答见 `inbox/archived-question/` |
 | `tuner-workspace catalog` | `catalogs/workspace.json` | 见 `tuner_testkit/workspace/README.md` |
 
 环境变量 `TUNER_REPORT_DIR` 指定本次回归的 run 目录（不设则钩子自动生成 `reports/<run_id>/`）；

{tuner_testkit-5.3.0 → tuner_testkit-5.3.1}/tuner_testkit/apps/dna/dna_payload/docs/spec/metadata-conventions.md

@@ -54,7 +54,7 @@ catalog 同时用 `git log --diff-filter=A --format=%ae -- <path>` 算首次提
 ### 任务与测试设计
 
 - `kind: task` 落在 `work/tasks/TASK-*.md`，字段见 `docs/spec/work-task.md`。
-- `kind: question` 落在 `artifacts/inbox/questions/Q-*.md`（不入库）。
+- `kind: question` 未回答落在 `artifacts/inbox/questions/Q-*.md`，回答后移到 `artifacts/inbox/archived-question/`（不入库）。
 - `kind: testdesign` 落在 `assets/testdesign/<sut>/<slug>.md`，字段见 `docs/spec/test-design-syntax.md`。
 - `kind: testcase` 落在 `assets/testcases/<模块>/<功能>.md`；模块说明是 `testcase-module`，总索引是 `testcase-index`。字段见 `docs/spec/testcase-syntax.md`。
 

{tuner_testkit-5.3.0 → tuner_testkit-5.3.1}/tuner_testkit/apps/dna/dna_payload/docs/spec/work-task.md

@@ -14,7 +14,8 @@ description: 入库任务 work/tasks、阻塞式人类提问，以及和测试
 
 ```text
 work/tasks/TASK-<YYYYMMDD>-<nnn>.md          # 入库
-artifacts/inbox/questions/Q-<YYYYMMDD>-<nnn>.md   # gitignore，本机异步信箱
+artifacts/inbox/questions/Q-<YYYYMMDD>-<nnn>.md        # 未回答；gitignore
+artifacts/inbox/archived-question/Q-<YYYYMMDD>-<nnn>.md # 已回答；gitignore
 ```
 
 `work/**` 的提交 scope 是 `work`。问题文件不入库；人答完后的结论写回任务的 `## Decisions`，需要留下的通道说明再策展到 `assets/domain-notes/`。
@@ -73,6 +74,7 @@ tuner-task answer Q-20260924-001 --option rancher-api \
 ```
 
 - 提问立刻落盘，并把任务标为 `blocked`。只挡住依赖该答案的回写；不依赖日志的点击可以先做完，但在回答前不要编写取日志实现，也不要选定通道。
+- `tuner-task answer` 把问题文件从 `questions/` 移到 `archived-question/`，未回答的问题仍只留在 `questions/`。同一天的新问题编号会计入归档，避免复用已回答的 ID。
 - `--note` 只留可入库的指向。CLI 拒绝 `password=` / `token:` / `Bearer …` 这类赋值。
 - `skip` 表示报告里日志证据写「无」，设计上的日志断言保持未验证。
 - `tuner-task finish` 在仍有 `status: open` 且 `blocking: true` 的问题时失败。

{tuner_testkit-5.3.0 → tuner_testkit-5.3.1}/tuner_testkit/apps/task/store.py

@@ -49,6 +49,10 @@ def questions_dir(root: Path) -> Path:
     return root / "artifacts" / "inbox" / "questions"
 
 
+def archived_questions_dir(root: Path) -> Path:
+    return root / "artifacts" / "inbox" / "archived-question"
+
+
 def _utc_day() -> str:
     return datetime.now(timezone.utc).strftime("%Y%m%d")
 
@@ -57,6 +61,19 @@ def _today() -> str:
     return datetime.now(timezone.utc).strftime("%Y-%m-%d")
 
 
+def _next_question_id(repo: Path) -> str:
+    """Next Q-id for today, counting both the open inbox and the archive."""
+    day = _utc_day()
+    pat = re.compile(rf"^Q-{day}-(\d+)$")
+    nums: list[int] = []
+    for directory in (questions_dir(repo), archived_questions_dir(repo)):
+        if not directory.is_dir():
+            continue
+        nums.extend(int(m.group(1)) for path in directory.glob(f"Q-{day}-*.md") if (m := pat.match(path.stem)))
+    questions_dir(repo).mkdir(parents=True, exist_ok=True)
+    return f"Q-{day}-{max(nums, default=0) + 1:03d}"
+
+
 def _next_seq(directory: Path, prefix: str, day: str) -> str:
     directory.mkdir(parents=True, exist_ok=True)
     pat = re.compile(rf"^{re.escape(prefix)}-{day}-(\d+)$")
@@ -300,7 +317,7 @@ def ask_question(
     ids = [item["id"] for item in chosen]
     if len(ids) != len(set(ids)):
         raise ValueError("option ids must be unique")
-    question_id = _next_seq(questions_dir(repo), "Q", _utc_day())
+    question_id = _next_question_id(repo)
     prompt_one = " ".join(prompt.split())
     meta: dict[str, Any] = {
         "kind": "question",
@@ -347,25 +364,31 @@ def ask_question(
 
 def list_questions(*, root: Path | None = None, status: str | None = "open") -> list[dict[str, Any]]:
     repo = Path(root) if root is not None else project_root()
-    directory = questions_dir(repo)
-    if not directory.is_dir():
-        return []
+    if status == "answered":
+        directories = [archived_questions_dir(repo)]
+    elif status == "open":
+        directories = [questions_dir(repo)]
+    else:
+        directories = [questions_dir(repo), archived_questions_dir(repo)]
     rows = []
-    for path in sorted(directory.glob("Q-*.md")):
-        meta, _ = _read(path)
-        if status and meta.get("status") != status:
+    for directory in directories:
+        if not directory.is_dir():
             continue
-        rows.append(
-            {
-                "id": meta.get("id"),
-                "task_id": meta.get("task_id"),
-                "topic": meta.get("topic"),
-                "status": meta.get("status"),
-                "blocking": meta.get("blocking"),
-                "prompt": meta.get("prompt"),
-                "path": path.relative_to(repo).as_posix(),
-            }
-        )
+        for path in sorted(directory.glob("Q-*.md")):
+            meta, _ = _read(path)
+            if status and meta.get("status") != status:
+                continue
+            rows.append(
+                {
+                    "id": meta.get("id"),
+                    "task_id": meta.get("task_id"),
+                    "topic": meta.get("topic"),
+                    "status": meta.get("status"),
+                    "blocking": meta.get("blocking"),
+                    "prompt": meta.get("prompt"),
+                    "path": path.relative_to(repo).as_posix(),
+                }
+            )
     return rows
 
 
@@ -432,6 +455,10 @@ def answer_question(
         "answered": datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"),
     }
     _write(path, meta, text)
+    dest = archived_questions_dir(repo) / path.name
+    dest.parent.mkdir(parents=True, exist_ok=True)
+    path.replace(dest)
+    path = dest
     task_id = str(meta.get("task_id") or "")
     task_path = _task_path(repo, task_id)
     task_meta, task_text = _read(task_path)
@@ -454,6 +481,7 @@ def answer_question(
         "id": question_id,
         "status": "answered",
         "option": option,
+        "path": path.relative_to(repo).as_posix(),
         "task_id": task_id,
         "task_status": task_meta.get("status"),
         "curated": curated or None,

{tuner_testkit-5.3.0 → tuner_testkit-5.3.1}/tuner_testkit/apps/task/tests/test_store.py

@@ -51,6 +51,10 @@ def test_ask_blocks_until_answer_then_curates(tmp_path: Path):
         root=tmp_path,
     )
     assert answered["task_status"] == "in_progress"
+    assert answered["path"].startswith("artifacts/inbox/archived-question/")
+    assert not (tmp_path / "artifacts" / "inbox" / "questions" / f"{asked['id']}.md").is_file()
+    archived = tmp_path / answered["path"]
+    assert "status: answered" in archived.read_text(encoding="utf-8")
     note = (tmp_path / answered["curated"]).read_text(encoding="utf-8")
     assert "rancher-api" in note
     assert parse_front_matter(note)["kind"] == "domain-note"
@@ -97,6 +101,25 @@ def test_bind_appends_output(tmp_path: Path):
     assert shown["evidence"] == ["artifacts/evidence/20260924T000000Z-home"]
 
 
+def test_answer_archives_question_and_keeps_id(tmp_path: Path):
+    created = create_task(task_type="explore", title="看日志", root=tmp_path, author="qa@example.com")
+    first = ask_question(
+        task_id=created["id"],
+        topic="sut-log-source",
+        prompt="日志从哪取",
+        root=tmp_path,
+    )
+    answer_question(first["id"], option="skip", root=tmp_path)
+    second = ask_question(
+        task_id=created["id"],
+        topic="sut-log-source",
+        prompt="再确认一次通道",
+        root=tmp_path,
+    )
+    assert second["id"] != first["id"]
+    assert int(second["id"].rsplit("-", 1)[-1]) == int(first["id"].rsplit("-", 1)[-1]) + 1
+
+
 def test_finish_refuses_open_question(tmp_path: Path):
     created = create_task(task_type="explore", title="摸页面", root=tmp_path, author="qa@example.com")
     ask_question(

{tuner_testkit-5.3.0 → tuner_testkit-5.3.1/tuner_testkit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tuner-testkit
-Version: 5.3.0
+Version: 5.3.1
 Summary: Shared test runtime, recorders, and DNA overlay for SUT test repos
 Author: tuner-testkit contributors
 License-Expression: MIT
@@ -221,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.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)。
+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)。