wehub-resource-sync
070959e133
landing-page-staging / Deploy landing page to staging (push) Has been skipped
landing-page-ci / Validate landing page (push) Failing after 4s
visual-baseline / Capture visual baselines (push) Has been cancelled
bake-plugin-previews / Bake plugin previews (push) Has been cancelled
66 lines
3.7 KiB
Markdown
66 lines
3.7 KiB
Markdown
# 工作区模块
|
|
|
|
## 覆盖范围
|
|
|
|
- 项目工作区内的会话与文件流
|
|
- Design Files 上传、删除、标签持久化
|
|
- Quick switcher 键盘行为
|
|
- 聊天面板宽度持久化
|
|
- 手动编辑模式回归
|
|
|
|
## 对应测试文件
|
|
|
|
- `e2e/ui/app.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.test.ts` via `design-files-upload` |
|
|
| WS-006 | Design Files 删除上传文件后，列表和打开标签都会清理 | `app.test.ts` via `design-files-delete` |
|
|
| WS-007 | 已打开的文件标签在刷新后仍会恢复，并保持正确激活项 | `app.test.ts` via `design-files-tab-persistence` |
|
|
| WS-008 | 删除当前活跃会话后，界面会自动回退到剩余线程 | `app.test.ts` via `conversation-delete-recovery` |
|
|
| WS-009 | Question form 的多选题会正确限制最大选择数量 | `app.test.ts` via `question-form-selection-limit` |
|
|
| WS-010 | Question form 的回答会进入聊天历史，并在刷新后保持锁定态 | `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.test.ts` direct test |
|
|
| WS-014 | 手动编辑模式支持内容、样式、源码 patch，以及 undo/redo | `app.test.ts` direct test |
|
|
| WS-015 | deck 形态 HTML 在手动编辑模式下仍保留 deck 导航能力 | `app.test.ts` direct test |
|
|
|
|
### 键盘优先工作区流
|
|
|
|
| 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-C01 | Python 等非 HTML 文件的源码预览 | 很适合回归自动化，但当前仍属于待补 viewer 能力覆盖 |
|
|
| WS-C02 | 工作区侧栏的更完整纯键盘导航 | 自动化价值高，但需要先明确产品侧快捷键与焦点规则 |
|
|
| WS-C03 | 多会话的重命名、归档或恢复流 | 值得自动化，但前提是这些能力在产品层正式稳定 |
|
|
|
|
## 手工保留
|
|
|
|
| ID | 场景 | 原因 |
|
|
| --- | --- | --- |
|
|
| WS-M01 | 生成结果在预览里的“设计质量”是否达标 | 依赖主观内容质量判断，不适合用稳定断言衡量 |
|
|
| WS-M02 | 手动编辑后的视觉细节是否足够精致 | 更适合设计/QA 人工验收 |
|
|
|
|
## 说明
|
|
|
|
- `app.test.ts` 同时包含资源驱动场景和少量集中式回归，这里按用户行为分组，而不是按 helper 或实现结构分组。
|
|
- 资源驱动类场景来源于 `e2e/resources/playwright.ts`。
|