[REQ-094] Session Workbench 统一承载产物与上下文工具

[jinjunnn]

简明目的

在 Session 中提供一个真正可用的侧边工作台，让用户稳定切换产物、文件、变更和检查信息，并在切换会话后恢复到正确位置。

Outcome（专业定义）

Alpha Workbench 在正式 Session Shell 中提供 Artifacts / Files / Changes / Inspector 容器、session-scoped state、run/output discovery、布局与焦点恢复。现有 Viewer 基座视为已交付基础；本需求的剩余结果是 Workbench 产品容器和发现链。Shell mount/lifecycle 归 #203，renderer/HTML 安全实现归 #207/#208。

Complexity

L — 跨 Session UI、产物发现、状态恢复、可调整布局与多个数据 adapter，需多条独立实现和运行时验证。

Context

#186 已完成 Viewer/shell 基础，但 Artifacts/Files/Changes/Inspector 正式容器、timeline/run 发现、session-scoped 恢复和三档布局仍未交付。原正文容易与 #203 的 Session shell 以及 #207/#208 renderer 重叠。

Scope

• 在 [REQ-088] Alpha Session Shell 稳定挂载并管理生命周期 #203 提供的 mount point 中承载四个 Workbench modes。
• 维护 session-scoped 的 mode、选中对象、尺寸、滚动与打开/关闭状态。
• 从 cloud run、automation、tool output 与 timeline artifact card 发现可打开对象。
• 提供 deep link、save-copy、focus preview 和正确的触发焦点恢复。
• 支持三档布局、320–720px 调整及窄窗口降级。
• 通过 descriptor/adapter 调用下游 renderer，不自行读取任意路径。

Non-goals

• 不拥有 Session route、Shell mount/unmount 或全局错误边界；归 [REQ-088] Alpha Session Shell 稳定挂载并管理生命周期 #203。
• 不实现格式路由、PDF/image/SVG 边界或静态 HTML 隔离；归 [REQ-095] 常用本地产物按安全规则稳定预览 #207/[REQ-096] HTML 产物在零桥接隔离宿主中静态预览 #208。
• 不定义 artifact registry/transport/provenance；归 alpha-work#1/#2。
• 不实现 Office validation/conversion；归 alpha-work#3。

Acceptance criteria

AC1. 正式会话页右栏按内容提供产物、文件、审查(改动)面板;无可用能力时不显示误导性空标签。 (2026-09-17 按 owner 裁决改写,原文见编辑历史)
AC2. 从 timeline、cloud run、automation 和 tool output 打开的对象进入同一 Workbench，来源与状态可追溯。
AC3. mode、选择、尺寸、滚动与打开状态按 session 隔离；快速切换 session 不串状态，重启按明确规则恢复。
AC4. Files/Changes/Inspector 与 Artifacts 使用各自 typed adapter，不从 renderer 读取任意本地路径或猜测云端来源。
AC5. deep link、save-copy、focus-preview、close 与返回触发点的焦点行为一致且可键盘操作。
AC6. 右栏宽度可拖动调整且不小于 320px;窄窗口下无内容遮挡或不可达控制。 (2026-09-17 按 owner 裁决改写,原文见编辑历史)
AC7. Viewer/renderer crash 只影响当前内容区域，用户可切 Source/Metadata、重试或关闭，不卸载 Session。
AC8. #203 只挂载/卸载 Workbench；container state、mode 与 discovery 在本需求中有唯一 owner。 —— 2026-09-17 删除(owner 裁决):内部职责划分,不是用户可观察结果;#203 与 REQ-125 均已关,无需也无法独立判定。

Evidence map

AC	Evidence surface
AC1	REQ-125(#538)AC2 + session-rail/{artifacts,files,review,terminal}/;#285 检查器不做
AC2	#287 session-timeline/cards/tool-cards.tsx:990-994
AC3	test-component/session-rail-artifacts.cases.ts:441 + session-workspace/rail-width.ts
AC4	packages/ui-mac/src/main/workspace-file-service.test.ts:104/:122
AC5	test-component/session-rail-artifacts.cases.ts:441-475(REQ-125 形态)
AC6	session-workspace/rail-width.ts:14/:39 + rail-width.test.ts
AC7	session-rail/artifacts/artifacts-panel-view.tsx:577-581 + #292
AC8	已删除(见 AC8)

Acceptance owner

@jinjunnn — 按 AC 逐条验收并手工关闭；PR 不得关闭父需求。

设计要点

• Workbench store 必须由 session ID 分区，不能依赖进程级全局选择。
• discovery 产生规范 descriptor；renderer 不感知本地/云端来源。
• 容器错误与内容 renderer 错误分层，避免整块卸载。
• [REQ-088] Alpha Session Shell 稳定挂载并管理生命周期 #203 与 [REQ-094] Session Workbench 统一承载产物与上下文工具 #206 通过一个窄 mount/open contract 对接，禁止双状态 owner。

潜在问题与风险

• 当前 [REQ-088] Alpha Session Shell 稳定挂载并管理生命周期 #203/[REQ-088][CODE] Open Workbench from timeline artifacts, Files, and Changes #273 与 [REQ-094] Session Workbench 统一承载产物与上下文工具 #206/[REQ-094][CODE] Route cloud, automation, and tool outputs to timeline artifact cards #287/[REQ-094][CODE] Add artifact deep links, save-copy, focus preview, and per-session restoration #288 有职责交叠，易重复实现打开状态。
• Viewer 已存在可能造成“基础完成即需求完成”的误判。
• 全局 store 会在多 Session 快速切换时串选中对象或滚动。
• discovery 若接受未经验证路径/descriptor，会绕过 artifact 安全边界。

过时性与兼容性结论

需求有效，Viewer 基座已完成但 Workbench 产品结果未完成。旧独立 Viewer 状态、旧 Session wrapper 与来源特判不做兼容；保留当前 session 状态恢复、错误恢复和 descriptor 校验正确性。

关联与职责边界

• [REQ-088] Alpha Session Shell 稳定挂载并管理生命周期 #203：Session shell mount/lifecycle；不拥有 Workbench 内部。
• [REQ-095] 常用本地产物按安全规则稳定预览 #207/[REQ-096] HTML 产物在零桥接隔离宿主中静态预览 #208：renderer 与 HTML isolation。
• alpha-work#1/#2：artifact transport/registry；alpha-work#3：Office。
• [REQ-108] 工作区本地文件可在 Session 右栏安全预览 #244：普通工作区本地文件进入右栏的 source adapter，不扩张 Workbench 真相。

Delivery plan / 建议子票

• [REQ-094] Artifact Workbench shell and run discovery #186 — Viewer/Workbench 基础壳。
• [REQ-094][CODE] Host Artifacts, Files, Changes, and Inspector in the release SessionWorkspace #285 — 正式四模式容器。 产物/文件/审查面板由 REQ-125 交付；检查器于 2026-09-17 按 owner 裁决不做关闭。
• [REQ-094][CODE] Preserve session focus and scroll while switching Workbench modes #286 — session focus/scroll state（2026-08-10 普查关闭，现由 REQ-125 session-rail 承担）。
• [REQ-094][CODE] Route cloud, automation, and tool outputs to timeline artifact cards #287 — run/tool/timeline discovery（已交付，已关）。
• [REQ-094][CODE] Add artifact deep links, save-copy, focus preview, and per-session restoration #288 — deep link、save-copy、preview 与恢复（2026-08-10 普查关闭，现由 REQ-125 session-rail 承担）。
• [REQ-094][CODE] Implement three-tier Workbench layout and 320-720 px resizing #289 — 三档布局与 resize（契约被 REQ-125/REQ-140 取代，已关）。
• [REQ-094][CODE] Restore trigger focus after Workbench close #290 — 关闭后焦点恢复（2026-08-10 普查关闭，现由 REQ-125 session-rail 承担）。

Dependencies

• 原生依赖：jinjunnn/alpha-work#2（artifact registry）。
• 与 [REQ-088] Alpha Session Shell 稳定挂载并管理生命周期 #203 并行时必须保持 mount contract 边界，不能双写 Workbench store。

[jinjunnn]

需求收口(REQ-094,S44):唯一实现子项 #186 已交付并关闭(PR #241,证据见该 issue 评论 + docs/audits/2026-07-12-s44-visual/)。残项已在子 issue 逐条登记(不阻断收口,分别归 REQ-088 批次/后续 renderer 扩充/打包发布批次)。按交付标准关闭为 completed。

[jinjunnn]

按 2026-07-14 逐需求独立审计(alpha-work/governance/audits/2026-07-14-s40-s49-per-requirement-audit.md),REQ-094 完整度 = partial,未满足全部原始 AC,故 reopen 并移出 Done。

核心缺口:交付的是全屏 viewer 非 Workbench 容器;Files/Changes/Inspector 不存在

处置(v2 关闭契约):残余工作以本 REQ 身份补窄 [REQ-094][CODE|VERIFY] 子票(待 triage,不换 REQ 编号)。完整 file:line 证据见审计档同名目录 REQ-094.md。父需求在全部 required 子票关闭且每条 AC 有证据 PASS 前保持 open;安全类缺口如已单列 bug 票以其为准。