Zakaria
a46764fb1b
ci / Validate workspace (push) Has been cancelled
landing-page-ci / Validate landing page (push) Has been cancelled
landing-page-deploy / Deploy landing page (push) Has been cancelled
github-metrics / Generate repository metrics SVG (push) Has been cancelled
refresh-contributors-wall / Refresh contributors wall cache bust (push) Waiting to run
122 lines
3.5 KiB
Markdown
122 lines
3.5 KiB
Markdown
# 文件链路
|
||
|
||
这个模块聚焦项目文件相关的主链路：
|
||
|
||
- 文件上传
|
||
- 文件 mention
|
||
- staged attachment
|
||
- 文件路由打开
|
||
- 预览恢复
|
||
|
||
## 当前用例
|
||
|
||
### `file-mention`
|
||
|
||
- 状态：已自动化
|
||
- 对应 flow：`file-mention`
|
||
- 目标：覆盖 `@` mention 选择文件并加入 staged attachment
|
||
- 核心步骤：
|
||
1. 通过项目文件 API 预置 `reference.txt`
|
||
2. 在聊天输入框中输入 `@ref`
|
||
3. 选择 mention popover 里的文件
|
||
4. 校验输入框中插入 `@reference.txt`
|
||
5. 校验 staged attachment 显示正确
|
||
|
||
### `file-upload-send`
|
||
|
||
- 状态：已自动化
|
||
- 对应 flow：`file-upload-send`
|
||
- 目标：覆盖聊天区真实上传文件并发送
|
||
- 核心步骤：
|
||
1. 通过 composer 的隐藏 file input 上传文件
|
||
2. 校验 staged attachment 出现
|
||
3. 发送 prompt
|
||
4. 校验用户消息里带上上传文件
|
||
|
||
### `deep-link-preview`
|
||
|
||
- 状态：已自动化
|
||
- 对应 flow：`deep-link-preview`
|
||
- 目标：覆盖文件路由直达和预览恢复
|
||
- 核心步骤：
|
||
1. 生成 artifact
|
||
2. 校验 URL 进入 `/projects/:id/files/:name`
|
||
3. 离开项目文件路由
|
||
4. 再次通过文件路由进入
|
||
5. 校验预览 iframe 正常恢复
|
||
|
||
### `design-files-upload`
|
||
|
||
- 状态：已自动化
|
||
- 对应 flow：`design-files-upload`
|
||
- 目标：覆盖 Design Files 面板真实上传、预览与打开
|
||
- 核心步骤：
|
||
1. 通过 Design Files 面板的上传入口选择图片
|
||
2. 校验文件行出现在列表中
|
||
3. 校验右侧预览信息出现
|
||
4. 双击文件行
|
||
5. 校验文件以 tab 形式打开
|
||
|
||
### `design-files-delete`
|
||
|
||
- 状态：已自动化
|
||
- 对应 flow：`design-files-delete`
|
||
- 目标：覆盖 Design Files 面板删除文件以及打开 tab 的清理
|
||
- 核心步骤：
|
||
1. 先上传一张图片
|
||
2. 回到 Design Files 面板
|
||
3. 打开文件行菜单并执行删除
|
||
4. 确认文件行从列表中消失
|
||
5. 确认对应文件 tab 也被清理
|
||
|
||
### `design-files-tab-persistence`
|
||
|
||
- 状态：已自动化
|
||
- 对应 flow：`design-files-tab-persistence`
|
||
- 目标：覆盖多个打开文件 tab 在刷新后的恢复
|
||
- 核心步骤：
|
||
1. 先上传两张图片
|
||
2. 确认两张图片都打开为 tab
|
||
3. 切换当前 active tab
|
||
4. 刷新页面
|
||
5. 确认两个 tab 都被恢复
|
||
6. 确认刷新前的 active tab 仍然是 active
|
||
|
||
## 推荐后续补充
|
||
|
||
### `deck-pagination-per-file-isolated`
|
||
|
||
- 状态：待自动化
|
||
- 对应 flow：`deck-pagination-per-file-isolated`
|
||
- 目标：覆盖多个 deck HTML 之间的分页状态隔离
|
||
- 核心步骤：
|
||
1. 打开两个多页 deck 文件
|
||
2. 分别停留在不同页码
|
||
3. 来回切换文件 tab
|
||
4. 校验每个文件维持自己的页码
|
||
|
||
### `uploaded-image-renders-in-preview`
|
||
|
||
- 状态：待自动化
|
||
- 对应 flow：`uploaded-image-renders-in-preview`
|
||
- 目标：覆盖上传图片参与生成后，预览中的图片真实可加载
|
||
- 核心步骤：
|
||
1. 上传图片作为参考素材
|
||
2. 生成引用该图片的 HTML artifact
|
||
3. 进入预览 iframe
|
||
4. 校验对应 `img` 的 `src` 可解析且不是 broken image
|
||
|
||
### `python-source-preview`
|
||
|
||
- 状态：待自动化
|
||
- 对应 flow：`python-source-preview`
|
||
- 目标：覆盖 `.py` 文件在主工作区中的源码预览能力
|
||
- 核心步骤：
|
||
1. 通过项目文件 API 预置一个 `.py` 文件
|
||
2. 在主工作区打开该文件
|
||
3. 校验文件查看器进入源码/文本预览模式
|
||
4. 校验能看到 Python 源码内容，而不是空白或不支持状态
|
||
|
||
- 图片文件上传与缩略图展示
|
||
- 刷新后 staged attachment 清理策略
|