# 工作区模块

## 覆盖范围

- 项目工作区内的会话与文件流
- Design Files 上传、删除、标签持久化
- 上传图片在 HTML artifact 中的解析与非 HTML 源码预览
- Quick switcher 键盘行为
- 聊天面板宽度持久化
- 手动编辑模式回归

## 对应测试文件

- `e2e/ui/app.test.ts`
- `e2e/ui/app-design-files.test.ts`
- `e2e/ui/app-manual-edit.test.ts`
- `e2e/ui/app-restoration.test.ts`
- `e2e/ui/workspace-keyboard-flows.test.ts`

## 已自动化

### 资源驱动工作区场景

| ID | 场景 | 来源 |
| --- | --- | --- |
| WS-001 | 会话历史在刷新和线程切换后仍能保留 | `app.test.ts` via `conversation-persistence` |
| WS-002 | 上传文件后可以在聊天中通过 mention 再次引用发送给 agent | `app.test.ts` via `file-mention` |
| WS-003 | 通过文件深链接进入项目时，可以恢复到正确的预览标签 | `app.test.ts` via `deep-link-preview` |
| WS-004 | 通过 composer 文件选择器上传文件，并随 prompt 一起发送 | `app.test.ts` via `file-upload-send` |
| WS-005 | Design Files 上传图片后，会在工作区打开并可预览 | `app-design-files.test.ts` via `design-files-upload` |
| WS-006 | Design Files 删除上传文件后，列表和打开标签都会清理 | `app-design-files.test.ts` via `design-files-delete` |
| WS-007 | 已打开的文件标签在刷新后仍会恢复，并保持正确激活项 | `app-design-files.test.ts` via `design-files-tab-persistence` |
| WS-008 | 删除当前活跃会话后，界面会自动回退到剩余线程 | `app.test.ts` via `conversation-delete-recovery` |
| WS-009 | Question form 的视觉风格题使用 radio 语义；选择新方向会替换旧方向，并始终只保留一个选项 | `app.test.ts` via `question-form-single-selection` |
| WS-010 | Question form 的回答会写入聊天历史，提交后显示 `question-form-summary`，刷新后恢复摘要而不是旧锁定表单 | `app.test.ts` via `question-form-submit-persistence` |
| WS-011 | 在没有新 prompt 的情况下，刷新或空闲不会额外生成新文件 | `app.test.ts` via `generation-does-not-create-extra-file` |
| WS-012 | 预览评论可以附加到聊天中，并以结构化上下文发送 | `app.test.ts` via `comment-attachment-flow` |
| WS-013 | daemon 发送失败后，错误详情在跨文件切换、返回项目及后续失败之间仍然可见，便于重试和排查 | `app-restoration.test.ts` |
| WS-014 | 手动编辑 inspector 可预览并持久化页面与选中元素样式，编辑后预览操作仍保持可用 | `app-manual-edit.test.ts` |
| WS-015 | deck 形态 HTML 在手动编辑模式下仍保留 deck 导航能力 | `app-manual-edit.test.ts` |
| WS-016 | Python 文件可以在工作区打开为可读的内联源码预览 | `app-design-files.test.ts` via `python-source-preview` |
| WS-017 | 上传的图片能通过 artifact 内的相对路径在生成 HTML 预览中正确加载 | `app-design-files.test.ts` via `uploaded-image-renders-in-preview` |
| WS-018 | 主动停止运行会只发送一次 cancel 请求，持久化 assistant 的 canceled 状态，并且不留下 artifact 文件 | `app-restoration.test.ts` |

### 键盘优先工作区流

| ID | 场景 | 来源 |
| --- | --- | --- |
| WS-101 | Quick switcher 可通过键盘打开，并激活目标文件 | `workspace-keyboard-flows.test.ts` |
| WS-102 | Quick switcher 搜索无匹配时，不会改变当前文件 | `workspace-keyboard-flows.test.ts` |
| WS-103 | Quick switcher 支持方向键移动选择后再打开文件 | `workspace-keyboard-flows.test.ts` |
| WS-104 | 通过键盘调整聊天面板宽度后，刷新仍会保持 | `workspace-keyboard-flows.test.ts` |

## 自动化候选

| ID | 场景 | 原因 |
| --- | --- | --- |
| WS-C02 | 工作区侧栏的更完整纯键盘导航 | 自动化价值高，但需要先明确产品侧快捷键与焦点规则 |
| WS-C03 | 多会话的重命名、归档或恢复流 | 值得自动化，但前提是这些能力在产品层正式稳定 |

## 手工保留

| ID | 场景 | 原因 |
| --- | --- | --- |
| WS-M01 | 生成结果在预览里的“设计质量”是否达标 | 依赖主观内容质量判断，不适合用稳定断言衡量 |
| WS-M02 | 手动编辑后的视觉细节是否足够精致 | 更适合设计/QA 人工验收 |

## 说明

- `app.test.ts` 同时包含资源驱动场景和少量集中式回归，这里按用户行为分组，而不是按 helper 或实现结构分组。
- 资源驱动类场景来源于 `e2e/resources/playwright.ts`。