# 入口模块

## 覆盖范围

- 新建项目入口面板
- 入口侧栏项目类型切换与草稿保持
- Home 左侧导航、最近项目与 starter 入口
- 提示词模板创建路径
- Integrations 连接器入口与连接器 gate
- 资源驱动的项目创建 happy path

## 对应测试文件

- `e2e/ui/entry-configuration-flows.test.ts`
- `e2e/ui/entry-chrome-flows.test.ts`
- `e2e/ui/app.test.ts`
- `e2e/ui/project-management-flows.test.ts`

## 已自动化

### 入口配置流

| ID | 场景 | 来源 |
| --- | --- | --- |
| ENTRY-001 | 提示词模板加载失败后重试，编辑后的模板正文会写入项目 metadata | `entry-configuration-flows.test.ts` |
| ENTRY-002 | live artifact 的空状态连接器 CTA 会跳转到受保护的 connector setup 路径 | `entry-configuration-flows.test.ts` |
| ENTRY-003 | connectors 入口支持搜索、空结果态，以及详情抽屉的键盘关闭 | `entry-configuration-flows.test.ts` |
| ENTRY-004 | 在 Integrations 里保存 Composio key 后，connectors gate 会立即解锁，搜索和卡片可直接使用 | `entry-configuration-flows.test.ts` |
| ENTRY-005 | 创建原型时切换到 `Wireframe` 后，即使先切到其他项目类型再切回，`fidelity` 选择也会保留，并正确写入创建 payload | `NewProjectPanel.test.tsx` |
| ENTRY-006 | 创建原型时在 design system 多选模式下切回 `不指定 — 自由发挥`，会清空主设计体系和 inspiration metadata | `NewProjectPanel.test.tsx` |
| ENTRY-007 | 创建原型时若项目名为空白，会回退到自动生成的默认标题而不是提交空名 | `NewProjectPanel.test.tsx` |
| ENTRY-008 | 创建实时制品时会把 `kind=prototype`、`intent=live-artifact` 和当前 `fidelity` 一并写入创建 payload | `NewProjectPanel.test.tsx` |
| ENTRY-009 | 创建幻灯片时，开启 `Use speaker notes` 会把 `speakerNotes=true` 写入创建 metadata | `NewProjectPanel.test.tsx` |
| ENTRY-010 | 从模板创建在没有用户模板时不会误触发创建；有模板时会带上 `templateId/templateLabel` 正常提交 | `NewProjectPanel.test.tsx` |
| ENTRY-011 | 创建图片项目时，所选 `aspect` 与修剪后的 `style notes` 会正确写入创建 payload | `NewProjectPanel.test.tsx` |
| ENTRY-012 | 创建视频项目时，所选 `aspect` 与 `duration` 会正确写入创建 payload | `NewProjectPanel.test.tsx` |
| ENTRY-013 | 创建音频项目时，所选 `duration` 与修剪后的 `voice` 会正确写入创建 payload | `NewProjectPanel.test.tsx` |
| ENTRY-014 | 入口页不再渲染旧 pet rail，Settings 也不再暴露 pet picker 的显示/隐藏开关 | `entry-chrome-flows.test.ts` |
| ENTRY-015 | 紧凑桌面宽度下，入口页 header 与整页不会出现明显横向溢出 | `entry-chrome-flows.test.ts` |
| ENTRY-016 | 展开的入口导航保持当前 `Home / Community / Design systems / Plugins / Settings` 结构，不再暴露已移除的 Projects / Automations / Integrations rail 入口 | `entry-chrome-flows.test.ts` |

### 资源驱动创建场景

| ID | 场景 | 来源 |
| --- | --- | --- |
| ENTRY-101 | Prototype 项目可以创建并预览生成的 artifact | `app.test.ts` via `prototype-basic` |
| ENTRY-102 | Deck 项目可以创建并预览生成的 deck artifact | `app.test.ts` via `deck-basic` |
| ENTRY-103 | New project 的 design system 多选会把主系统与 inspirations 正确写入创建 payload | `project-management-flows.test.ts` |
| ENTRY-104 | Image 项目通过当前 Media → Image 路径创建，并保存图片项目 metadata | `app.test.ts` via `image-basic` |
| ENTRY-105 | Video 项目通过当前 Media → Video 路径创建，并保存默认模型、画幅与时长 metadata | `app.test.ts` via `video-basic` |
| ENTRY-106 | Audio SFX 项目通过当前 Media → Audio 路径创建，并保存音频类型 metadata | `app.test.ts` via `audio-sfx-basic` |
| ENTRY-107 | Live artifact 项目通过当前独立入口创建，并保存 intent 与高保真 metadata | `app.test.ts` via `live-artifact-basic` |
| ENTRY-108 | HyperFrames 项目通过当前 Media → Video 路径创建，并预览生成的 HTML motion artifact | `app.test.ts` via `hyperframes-basic` |

## 手工保留

| ID | 场景 | 原因 |
| --- | --- | --- |
| ENTRY-M01 | 入口页视觉风格是否符合品牌预期 | 依赖主观视觉判断，不适合做稳定自动化断言 |
| ENTRY-M02 | 入口页动效、过渡、微交互是否自然 | 更适合人工体验验收，自动化收益较低 |

## 说明

- `app.test.ts` 的部分场景来自 `e2e/resources/playwright.ts`。新增资源驱动用例时，需要同时更新资源文件和这份文档。
- 旧 `ExamplesTab` 组件及其组件测试仍在仓库中，但当前 `EntryShell` 不挂载该页面；这些孤立组件测试不计作当前入口用户流覆盖，旧 `example-use-prompt` 资源也不能证明一条可达入口路径。
- 依赖 mocked SSE 的入口流程应尽量保持稳定、可重复、执行快。