移动端文件管理器交互稿说明

用途：补充到 Figma 原型画框旁，作为可交付给 UI、开发、测试的产品交互稿。说明卡片不覆盖原型本身，统一放在对应画框右侧。

1. 标注规则

类型	前缀	含义
点击	T	用户点击、选择、返回、确认等行为
状态	S	loading、空态、选中态、成功态
接口	API	页面进入或操作提交时的接口调用
异常	E	失败、无权限、冲突、不可用

2. 全局交互规则

首页是文件管理入口，点击存储空间、挂载位置、收藏文件夹进入目录列表。
点击首页搜索框进入搜索页；搜索结果点击文件夹进入目录，点击文件进入预览或不支持格式页。
目录列表点击文件夹进入下级目录，点击文件按格式打开。
顶部返回按进入路径返回：预览返回来源目录或搜索结果，子目录返回上级，根目录返回首页。
底部弹窗、操作面板、确认弹窗均支持取消关闭；关闭不改变原页面数据。
所有高风险操作必须二次确认，尤其是删除。
所有接口请求必须有 loading、成功、失败、空态或无权限反馈。
文件名过长时列表单行省略，详情面板展示完整名称。
文件大小用 B、KB、MB、GB 展示，时间格式统一为客户端规范。
文件夹默认优先于文件展示。

3. 画框交互说明

A01 文件管理-首页

页面目标：展示搜索入口、文件任务、存储空间、挂载位置和我的收藏。

交互点

T01 点击搜索框：进入 A03 搜索输入页。
T02 点击存储空间/挂载入口：进入 A06 二级列表页，路径为对应根目录。
T03 点击收藏文件夹：进入该收藏目录。
T04 点击文件任务区域：查看任务详情；如暂无任务可不响应或进入空任务页。
API01 页面进入：请求 GET /storages，并请求文件任务、收藏列表接口。
S01 存储、挂载、收藏为空时展示对应空态。
E01 接口失败：展示失败提示和重试入口。

A02 文件管理-首页-文件任务

页面目标：在首页反馈下载/上传任务进度。

交互点

S01 进行中任务展示任务名称、百分比、速度。
S02 完成任务展示 100% 或完成态。
T01 点击任务项：进入任务详情或保留当前页，具体入口待定。
E01 任务失败：展示失败状态并支持重试。

A03 文件管理-搜索-输入

页面目标：输入关键词并展示搜索中状态。

交互点

T01 输入关键词：触发搜索，建议 300ms 防抖。
T02 点击取消：返回 A01 首页。
T03 点击类型 Tab：切换搜索范围，保留关键词。
API01 搜索：建议 GET /file/search。
S01 搜索中展示 loading 和“搜索中”。
E01 搜索失败：展示失败提示和重试。

A04 文件管理-搜索-结果

页面目标：展示搜索结果和类型筛选。

交互点

T01 点击“全部/文件夹/文档/视频/图片”：切换结果分类。
T02 点击文件夹结果：进入 A06 对应目录。
T03 点击文件结果：根据格式进入 A18/A19/A20/A21。
T04 点击取消：返回首页。
S01 Tab 数量跟随接口结果更新，如“全部（112）”。
E01 文件不存在：提示后刷新搜索结果。

A05 文件管理-搜索-结果-空态

页面目标：搜索无结果时给出明确反馈。

交互点

S01 无结果展示“无搜索结果”。
T01 修改关键词后重新搜索。
T02 点击取消返回首页。
E01 搜索接口失败时不展示空态，展示失败态和重试。

A06 文件管理-二级列表页-列表视图

页面目标：按目录层级展示文件夹与文件。

交互点

T01 点击文件夹行：进入下一级目录，刷新列表。
T02 点击文件行：按格式进入预览或不支持格式页。
T03 点击更多按钮：文件夹进入 A12，文件进入 A22。
T04 点击“多选”：进入选择态；批量能力待确认。
T05 点击“视图”：切换到 A10 宫格视图。
T06 点击“筛选/排序/Most Recent”：打开 A09 排序面板。
API01 页面进入或路径变化：请求 GET /file。
S01 当前目录为空：展示空目录，并提供新增入口。
E01 加载失败：展示失败提示和重试。

A07 文件管理-二级列表页-新增

页面目标：展示新增内容入口。

交互点

T01 点击新增按钮：打开底部面板。
T02 点击“新建文件夹”：进入 A08 新建文件夹输入面板。
T03 点击“上传本机文件”：调起系统文件选择器。
T04 点击遮罩或返回：关闭面板。
API01 上传：选择文件后调用 POST /file/upload (v2)。
S01 上传成功：刷新当前目录并加入文件任务。
E01 上传失败：展示失败原因，支持重试。

A08 文件管理-二级列表页-新建文件夹

页面目标：在当前目录创建文件夹。

交互点

T01 输入文件夹名称。
T02 点击取消：关闭面板，不创建。
T03 点击确认：提交创建。
API01 创建：新建文件夹接口待确认，建议 POST /file/folder。
S01 名称为空时确认不可用或提示“文件夹名称不能为空”。
S02 创建成功：关闭面板并刷新 A06 当前目录。
E01 同名、非法字符、无权限：在面板内提示，保留输入。

A09 文件管理-二级列表页-排序

页面目标：选择目录排序方式。

交互点

T01 点击“按文件名”：按 A-Z/Z-A 排序，再次点击切换方向。
T02 点击“按文件类型”：按类型排序。
T03 点击“按文件大小”：按大小排序，文件夹大小未知时置后。
T04 点击“按修改时间”：按新到旧或旧到新排序。
T05 点击遮罩或返回：关闭面板。
S01 当前排序项展示选中态和方向图标。

A10 文件管理-二级列表页-宫格视图

页面目标：以宫格展示文件夹或文件缩略信息。

交互点

T01 点击宫格项：文件夹进入下级目录，文件进入预览。
T02 点击“视图”：切回 A06 列表视图。
T03 点击排序/筛选入口：打开 A09。
S01 视图切换保留当前目录、排序和筛选条件。
E01 缩略图加载失败：展示默认文件类型图标。

A11 文件管理-二级列表页-列表视图-筛选态

页面目标：承接原型中的重复列表画框，可作为筛选/列表刷新态说明。

交互点

T01 筛选条件变化后刷新当前列表。
S01 过滤后无结果展示当前目录无匹配文件。
E01 筛选失败保留原列表并提示。

A12 文件管理-二级列表页-文件夹更多操作

页面目标：展示文件夹操作项。

交互点

T01 点击重命名：进入 A13。
T02 点击添加到收藏：进入 A14 成功提示。
T03 点击下载：进入 A15 下载任务提示；文件夹下载能力待确认。
T04 点击详情：进入 A16。
T05 点击删除：进入 A17 删除二次确认。
T06 点击遮罩或返回：关闭操作面板。

A13 文件管理-二级列表页-操作-重命名

页面目标：重命名文件夹。

交互点

T01 编辑原文件夹名。
T02 点击取消：关闭面板，不保存。
T03 点击确认：提交重命名。
API01 重命名接口待确认，建议 PATCH /file。
S01 成功后刷新当前目录。
E01 名称为空、非法字符、同名冲突：面板内提示并保留输入。

A14 文件管理-二级列表页-操作-添加到收藏

页面目标：反馈文件夹收藏成功。

交互点

S01 添加成功展示 Toast：“收藏成功”。
API01 收藏接口待确认，建议 POST /file/favorites。
S02 首页“我的收藏”刷新后出现该文件夹。
E01 已收藏：提示已在收藏中或切换为取消收藏。

A15 文件管理-二级列表页-操作-下载

页面目标：提示下载任务已加入文件任务。

交互点

T01 点击“我知道了”：关闭提示，返回当前目录。
API01 调用 GET /file/download 或创建下载任务接口。
S01 成功提示“已添加到文件任务，请在文件管理首页查看”。
E01 文件夹下载未支持：提示暂不支持文件夹下载。
E02 下载失败：展示失败原因，支持重试。

A16 文件管理-二级列表页-操作-详情

页面目标：查看文件夹详情。

交互点

S01 展示名称、路径、创建时间、最后修改时间、大小等字段。
T01 点击遮罩或返回关闭详情面板。
API01 详情字段可由 /file 返回，或请求单独详情接口。
E01 字段缺失展示“-”。

A17 文件管理-二级列表页-操作-永久删除二次确认

页面目标：防止误删文件夹。

交互点

T01 点击取消：关闭弹窗，不删除。
T02 点击确认：调用删除接口。
API01 DELETE /file。
S01 删除成功：刷新当前目录。
E01 删除失败：展示原因，不改变当前列表。
E02 非空文件夹删除策略待确认，未确认前需提示风险或禁止。

A18 文件管理-文档查看

页面目标：只读预览文本/文档内容。

交互点

T01 点击返回：返回来源目录或搜索结果。
T02 点击重命名：进入 A23 文件重命名。
T03 点击下载：进入 A24 下载提示。
T04 点击文件信息：进入 A26 详情。
T05 点击删除：进入 A25 删除确认。
S01 文档加载中展示 loading。
E01 文档加载失败：提示并支持重试。

A19 文件管理-图片查看

页面目标：预览图片。

交互点

T01 点击返回：返回来源目录或搜索结果。
T02 点击重命名、下载、详情、删除分别进入对应文件操作。
S01 图片加载中展示 loading。
E01 图片加载失败：提示“图片加载失败，请重试”。

A20 文件管理-视频播放

页面目标：播放视频文件。

交互点

T01 页面进入后调用视频播放器。
T02 点击返回：回到来源目录或搜索结果。
S01 播放器支持播放/暂停、进度、全屏能力，按客户端播放器规范实现。
E01 视频加载失败：提示并支持重试。

A21 文件管理-不支持的文件格式

页面目标：不支持预览时给出下载引导。

交互点

S01 展示提示：“暂不支持打开当前格式文件，请下载后尝试使用其他应用打开”。
T01 点击下载：进入 A24。
T02 点击文件信息：进入 A26。
T03 点击删除：进入 A25。
T04 点击返回：回到来源目录或搜索结果。

A22 文件管理-文件操作-操作项

页面目标：展示文件操作项。

交互点

T01 点击重命名：进入 A23。
T02 点击下载：进入 A24。
T03 点击文件信息/详情：进入 A26。
T04 点击删除：进入 A25。
T05 点击遮罩或返回：关闭操作面板。

A23 文件管理-文件操作-重命名

页面目标：重命名文件。

交互点

T01 编辑原文件名。
T02 点击取消：关闭面板，不保存。
T03 点击确认：提交重命名。
API01 重命名接口待确认，建议 PATCH /file。
S01 成功后刷新列表和预览页标题。
E01 名称为空、非法字符、同名冲突：面板内提示。

A24 文件管理-文件操作-下载

页面目标：文件下载加入任务并反馈。

交互点

T01 点击“我知道了”：关闭提示。
API01 GET /file/download。
S01 下载任务加入首页文件任务。
E01 文件不存在、无权限、本地空间不足：提示原因并支持重试。

A25 文件管理-文件操作-删除

页面目标：删除文件二次确认。

交互点

T01 点击取消：关闭弹窗。
T02 点击确认：调用 DELETE /file。
S01 删除成功：如果在预览页，返回来源目录并刷新；如果在列表页，停留列表并移除该文件。
E01 删除失败：展示失败原因，不改变当前页面数据。

A26 文件管理-文件操作-详情

页面目标：查看文件详情。

交互点

S01 展示名称、文件大小、格式、创建时间、最后修改时间。
T01 点击遮罩或返回关闭详情。
E01 字段缺失展示“-”。

4. 开发与测试补充

UI 需保证说明卡片不进入手机画框内部，不影响原型视觉验收。
开发需优先确认待定接口：搜索、新建文件夹、重命名、收藏、文件任务、详情。
测试需覆盖首页、搜索、目录、预览、操作面板、异常状态和返回路径。
对文件操作需重点测试：同名、非法字符、无权限、文件不存在、网络中断、本地空间不足。
多选、移动、复制、文件夹打包下载如首期不做，需在 UI 和接口层明确置灰或隐藏策略。