# 项目工作台设计与 MVP 边界

![项目工作台外部插件设计稿](workbench-design-v4.png)

## 产品目标

为单机、本地项目开发提供“项目 → 需求组 → 原生会话”的管理方式。一个需求组可以关联多个会话，并维护一份按层读取的简单记忆，减少在新会话中反复说明需求背景。

这不是多人协作系统、看板产品或任务管理工具。原生左侧栏、工作区列表、会话历史与输入框都由宿主保留。

## 页面结构

工作台作为紧贴宿主左侧栏右缘的全高独立列展示，展开时在中间对话列预留同等宽度，折叠时仅预留窄入口。原生左侧栏、工作区和会话列表始终不被遮挡。列头只提供折叠按钮，不提供置顶或关闭按钮。

从上到下依次为：

- 项目选择器；
- 状态总览：进行中、待验证、已完成，可点击筛选需求组；
- 紧凑的“组记忆 · 摘要自动带出”入口；
- 需求组列表：项目可创建多个需求组；点击标题行加号后在工作台内填写名称；每行末尾的编辑图标展开该组的状态选择和归档操作；
- 当前组的原生会话列表；
- 固定在底部的“在当前组中新建对话”操作。

会话始终在宿主的原生对话页面中打开；工作台不复制一份大型聊天页面。

归档某个需求组时，工作台先在当前行内展示影响范围和二次确认，再逐个归档其关联的原生会话，随后将该需求组从默认列表中隐藏。任何一个会话归档失败时，该需求组会保持可见，并在面板内提示用户重试，避免把仍可见的会话误标记为已归档。

## 组记忆与渐进披露

| 层级 | 内容 | 读取时机 |
| --- | --- | --- |
| 摘要 | 需求目标、当前结论、约束 | 组内会话的下一次请求前自动带入；在工作台中可编辑 |
| 改动点 | 已改文件、关键决策、风险 | 用户点击“改动点” |
| 证据 | 对话引用、命令结果、待验证事项 | 需要追溯时 |

需求组和记忆保存到本机 DSH 数据目录，浏览器本地存储仅作为缓存和旧数据迁移来源。宿主端在组内会话的第一步模型请求前，将当前摘要作为带来源标识的上下文消息加入持久会话日志；同一摘要版本不重复加入，摘要更新后在下一次请求带入新版本。改动点和证据不会自动进入请求，仍保持按需读取；插件也不会读取其他需求组的数据。

## 外部插件约束

本插件通过公开的 `shell.overlay` 插槽增加自身 UI，调用公开的会话和工作区能力创建、关联与打开原生会话。它不接管 `sidebar.workspaces` 或 `conversation` 等原生单值插槽。

自动带入通过外部 bundle 的宿主半注册 `agent/pre-step` 监听器实现，并使用标准用户上下文消息进入原生会话日志。它仍不改动原生侧栏、工作区列表或对话页面。