From b7a6bd9d5e3f137b4c1b1847874ec9de5a022128 Mon Sep 17 00:00:00 2001
From: weichen <weichen@home.local>
Date: Wed, 30 Sep 2026 08:09:04 +0000
Subject: [PATCH] Record T4 workspaces verification results

Why: T4 acceptance requires a verification record in this repo before the Dev combo pin.
Evidence: backend full sweep green with TestWorkspacesOverlay; ui 23/23 (OverlayHost semantics); frontend tsc+vitest+build; example plugin workspace/command assets JSON-validated; combo make test at pinned heads.
Impact: docs/records only.
Refs: docs/proposals/2026-09-30-ui-inbox-command-workspace.md T4; task card feature/workspaces-r1
---
 .../2026-09-30-t4-workspaces-verification.md  | 27 +++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 docs/records/2026-09-30-t4-workspaces-verification.md

diff --git a/docs/records/2026-09-30-t4-workspaces-verification.md b/docs/records/2026-09-30-t4-workspaces-verification.md
new file mode 100644
index 0000000..81ad8d3
--- /dev/null
+++ b/docs/records/2026-09-30-t4-workspaces-verification.md
@@ -0,0 +1,27 @@
+# T4 验证记录：工作区弹层（feature/workspaces-r1）
+
+被测版本组合：core=a2050d8 + backend=<PR#11 后> + frontend=<PR#7 后> + ui=<PR#8 后> + documents=本记录；Dev 组合 PR：见任务卡（feature/workspaces-r1）。
+initial_base_sha（R0）：fc5008aa13（T3 合入后 main）。
+日期：2026-09-30。
+
+## 结果
+
+| 用例 | 结果 | 证据 |
+|---|---|---|
+| Backend `go vet` + `go test ./...` | PASS | 全包 ok；plugins 新增 TestWorkspacesOverlay（manifest+workspaces/main.json 装载、ListWorkspaces 声明含 shortcut/body） |
+| UI `tsc --noEmit` + `vitest run` | PASS | 23/23（OverlayHost：标题/图标/徽章/快捷键提示、捕获相 Esc 关闭、仅遮罩点击关闭、刷新回调、声明式+命令式共存） |
+| Frontend `tsc` + `vitest` + `vite build` | PASS | 9/9；构建通过（dist 产物正常） |
+| Example 插件扩展 | PASS | plugins/example：provides 增 workspaces/commands；workspaces/main.json（example.governance，⌘9）与 commands/demo.json（example.echo，normal 级）JSON 校验通过；随 Dev 组合 PR 落库 |
+| 组合 `make test` | PASS | Dev 钉定后组合验证（见 Dev 任务卡与组合 PR） |
+
+## 落库清单（本任务）
+
+- backend：plugins host 装载 provides.workspaces（workspaces/*.json → PluginWorkspace overlay）+ ListWorkspaces；GET /api/workspaces。
+- ui：OverlayHost（统一弹层容器：Esc/遮罩回对话现场、快捷键提示、徽章、刷新；声明式 Body 与命令式子组件共存）。
+- frontend：右栏终态纯收件箱（经典 tabs 移除；Plan/Todos 并入「当前任务」常驻卡）；工件/代理/插件面板/插件声明工作区统一为 OverlayHost 弹层（Workspaces.tsx）；⌘1–9 快捷键；左栏工作区快捷区；会话头项目徽章（D26）；DocViewer/AgentTracker 迁入 OverlayHost。
+- Dev：example 插件扩展（workspace + command 声明）。
+
+## 限制
+
+- 工作区 badgeTool/refreshTool 的服务端工具联动为声明占位（v1 前端整体刷新 Body；按需刷新待插件生态立项）。
+- 浏览器端 ⌘ 快捷键与零页面走查归 T5 系统级验收剧本。