2026-05-08 09:30:16 +08:00
|
|
|
# 工作区模块
|
|
|
|
|
|
|
|
|
|
## 覆盖范围
|
|
|
|
|
|
|
|
|
|
- 项目工作区内的会话与文件流
|
|
|
|
|
- Design Files 上传、删除、标签持久化
|
2026-07-18 11:41:08 +08:00
|
|
|
- 上传图片在 HTML artifact 中的解析与非 HTML 源码预览
|
2026-05-08 09:30:16 +08:00
|
|
|
- Quick switcher 键盘行为
|
|
|
|
|
- 聊天面板宽度持久化
|
|
|
|
|
- 手动编辑模式回归
|
|
|
|
|
|
|
|
|
|
## 对应测试文件
|
|
|
|
|
|
|
|
|
|
- `e2e/ui/app.test.ts`
|
2026-07-18 11:41:08 +08:00
|
|
|
- `e2e/ui/app-design-files.test.ts`
|
|
|
|
|
- `e2e/ui/app-manual-edit.test.ts`
|
|
|
|
|
- `e2e/ui/app-restoration.test.ts`
|
2026-05-08 09:30:16 +08:00
|
|
|
- `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` |
|
2026-07-18 11:41:08 +08:00
|
|
|
| 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` |
|
2026-05-08 09:30:16 +08:00
|
|
|
| WS-008 | 删除当前活跃会话后，界面会自动回退到剩余线程 | `app.test.ts` via `conversation-delete-recovery` |
|
2026-07-18 11:41:08 +08:00
|
|
|
| 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` |
|
2026-05-08 09:30:16 +08:00
|
|
|
| WS-011 | 在没有新 prompt 的情况下，刷新或空闲不会额外生成新文件 | `app.test.ts` via `generation-does-not-create-extra-file` |
|
|
|
|
|
| WS-012 | 预览评论可以附加到聊天中，并以结构化上下文发送 | `app.test.ts` via `comment-attachment-flow` |
|
2026-07-18 11:41:08 +08:00
|
|
|
| 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` |
|
2026-07-30 10:27:41 +08:00
|
|
|
| WS-018 | 主动停止运行会只发送一次 cancel 请求，持久化 assistant 的 canceled 状态，并且不留下 artifact 文件 | `app-restoration.test.ts` |
|
2026-05-08 09:30:16 +08:00
|
|
|
|
|
|
|
|
### 键盘优先工作区流
|
|
|
|
|
|
|
|
|
|
| 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`。
|
