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

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

## 1. 标注规则

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

## 2. 全局交互规则

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

## 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. 开发与测试补充

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


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

# 移动端文件管理器

|功能点|描述|zima接口依赖|是否具备开发条件|
|---|---|---|---|
|存储空间区分|区分系统存储空间|/storages||
|文件/文件夹列表|按实际层级具体展示文件夹和文件|/file||
|文件/文件夹详情|包含文件/文件夹创建\&amp;修改时间，文件大小信息|||
|打开特定格式的文件|支持打开图片（jpg,png,jpeg,bmp等常见格式），打开文本文件（txt,md,yml,yaml）,视频（MP4,mov,mkv等），不支持的格式提示暂不支持该格式|||
|新建文件夹|在系统中新建文件夹|||
|上传文件|将用户本地文件上传到指定目录|POST: /file/upload \(v2\)||
|下载文件|将NAS文件下载到手机指定目录|GET: /file/download||
|删除文件/文件夹|删除NAS上的文件|DELETE: /file||
|移动文件|将NAS文件从A目录移动到B目录||待定|
|复制文件|将NAS文件从A目录复制到B目录||待定|







移动端文件管理器 1

移动端文件管理器产品需求文档

整体说明：基于冰鲸 zima os 客户端提供的同步&备份能力做视觉和交互优化，实现符合我方整体视觉风格，能从当前设备备份内容到 NAS
适配端侧：PC 端，移动端

客户端同步备份功能入口：桌面提供 AWOL backup 应用


**功能清单**

|功能模块|功能点|是否本期支持|定义|
|---|---|---|---|
|应用入口|AWOL backup 应用入口|是|提供桌面端统一入口进入同步备份功能|
|任务创建|新建备份任务|是|为单个源路径与单个目标路径建立一条备份任务|
|任务配置|源路径配置|是|选择当前设备本地目录作为备份源|
|任务配置|目标路径配置|是|选择 NAS 目录作为备份目标|
|任务配置|排除规则|是|使用多条 glob 规则排除文件或目录|
|任务配置|自动备份|是|应用进程存在时（无论前台后台），检测到文件目标文件夹内内容发生变动，自动触发任务|
|任务管理|查询任务列表|是|查询所有任务的状态、进度、时间信息|
|任务管理|暂停任务|是|对运行中的任务执行暂停|
|任务管理|恢复任务|是|对暂停中的任务恢复执行|
|任务管理|取消任务|是|对当前任务执行取消；取消后的状态枚举待确认|
|任务管理|删除任务|是|删除任务配置；是否删除远端文件待确认|
|执行反馈|进度反馈|是|返回进度百分比、速度、已传输、总量、剩余时间、当前文件|
|执行反馈|完成反馈|是|返回耗时、总文件数、总大小|
|执行反馈|错误反馈|是|返回错误信息和可选错误码|






客户端备份功能615需求说明

# 同步备份功能说明（从 API 文档提取）

> 来源：[[我的笔记/NAS需求文档/同步备份/API_REFERENCE]]
> 提取范围：备份 API 章节及文档中的“文件备份完整流程”示例

## 1. 备份能力概览

根据 API 文档，备份功能采用“**创建任务 + 事件推送 + 任务管理**”的模式实现。

核心能力包括：

1. **创建备份任务**：指定本地源路径、设备目标路径以及备份配置。
2. **实时进度反馈**：主进程持续推送进度、速度、当前文件、剩余时间等信息。
3. **完成结果通知**：备份结束后返回耗时、文件数、总大小。
4. **错误上报**：任务失败时推送错误信息和可选错误码。
5. **任务查询与管理**：支持查看任务列表、暂停、恢复、取消、删除。
6. **定时/增量备份配置**：在创建任务时可指定增量备份、排除规则、定时计划。

---

## 2. 备份功能点明细

### 2.1 创建备份任务 `backup:create`

用于新建一个备份任务。

**调用方式**：`ipcRenderer.invoke('backup:create', payload)`

**参数结构**：

- `source`: 源路径（本地）
- `destination`: 目标路径（设备）
- `config.incremental`: 是否增量备份，默认 `true`
- `config.exclude`: 排除规则，使用 glob 模式
- `config.schedule`: 定时备份计划，使用 cron 表达式

**返回值**：

- `taskId: string`：新建任务 ID

**说明**：

- 文档明确支持**增量备份**。
- 文档明确支持**排除规则**。
- 文档明确支持**定时备份**。
- 任务创建后，后续状态主要通过事件推送获取。

#### 关于 `config.incremental` 增量备份开关的补充说明

API 文档原始定义为：

- `incremental?: boolean`
- 注释：`增量备份（默认 true）`

基于这段定义，**可以明确确认**：

1. `incremental` 是一个**可选布尔字段**，说明它不是固定不可改的系统行为，而是一个可配置项。
2. 注释写明 **默认 `true`**，因此在**不传该字段**时，系统会按增量备份处理。
3. 既然它是布尔开关，那么就存在与默认值相对的配置方式，即可以显式设置为 `false`。

也就是说，从 API 设计上判断：

- **默认行为**：增量备份
- **是否可改**：可以
- **改成全量的方式**：创建任务时显式传 `config.incremental: false`

#### 示例：默认增量备份

如果创建任务时不传 `incremental`：

```typescript
await window.ipcRenderer.invoke('backup:create', {
  source: '/Users/xxx/Documents',
  destination: '/Data/Backup/Documents',
  config: {
    exclude: ['*.tmp']
  }
})
```

按文档定义，这种情况下会走**默认 `true`**，也就是按**增量备份**处理。

#### 示例：改为全量备份

如果希望关闭增量备份，可在创建任务时显式传：

```typescript
await window.ipcRenderer.invoke('backup:create', {
  source: '/Users/xxx/Documents',
  destination: '/Data/Backup/Documents',
  config: {
    incremental: false,
    exclude: ['*.tmp']
  }
})
```

这就是当前 API 文档中能够明确确认的“改为全量”的方式。

#### 当前文档里还没有说明清楚的点

虽然可以确认 `incremental: false` 是关闭增量备份的入口，但 API 文档**没有进一步解释**“全量备份”在实现层面的精确定义，例如：

- 是否表示每次都重新完整复制全部文件
- 是否表示生成一份新的完整快照
- 是否是全量扫描后按覆盖方式同步

因此，按当前文档最稳妥的表述应当是：

> `incremental` 默认值为 `true`，说明系统默认采用增量备份；如需改为非增量模式，可在创建任务时显式传入 `incremental: false`。但“全量”的具体执行语义，API 文档尚未展开。

#### 关于 config.exclude 排除规则的补充说明

API 文档对排除规则的原始说明只有：

- `exclude?: string[]`
- 注释：`排除规则（glob 模式）`
- 示例：`['*.tmp', 'node_modules/**']`

基于这段定义，**可以明确确认**：

1. `exclude` 是**字符串数组**，因此支持**多条规则同时配置**。
2. 排除规则使用 **glob 模式**，不是只能选“文件类型”或只能选“文件夹”二选一。
3. 示例同时出现了：
   - `*.tmp`：表示可按**文件类型/文件名模式**排除
   - `node_modules/**`：表示可按**目录及其全部内容**排除

也就是说，从文档可以推断，排除规则至少支持以下几类用法：

- **排除特定格式文件**
  - `*.tmp`
  - `*.log`
  - `*.zip`

- **排除某个子文件夹及其内容**
  - `node_modules/**`
  - `dist/**`
  - `cache/**`

- **排除某个目录下的某类文件**
  - `temp/**/*.log`

#### 当前文档里还没有说明清楚的点

虽然 `glob` 和示例已经说明能力范围较灵活，但 API 文档**没有明确写清楚**下面这些细节：

- 是否支持更完整的 glob 语法变体
- 是否支持取反规则
- 匹配路径是相对源目录还是绝对路径
- UI 是否会提供复选、多选标签或手工录入方式

因此，按当前文档最稳妥的表述应当是：

> `exclude` 支持通过 **多条 glob 规则** 排除文件或文件夹；可同时配置多个规则。但更细的匹配语法和界面交互方式，API 文档尚未展开。

---

### 2.2 进度推送 `backup:progress`

用于在备份过程中持续反馈执行进度。

**推送字段**：

- `taskId`: 任务 ID
- `percent`: 进度百分比（0-100）
- `speed`: 传输速度（bytes/s）
- `transferred`: 已传输字节数
- `total`: 总字节数
- `eta`: 预计剩余时间（秒）
- `currentFile`: 当前处理文件

**可支撑的前端能力**：

- 进度条展示
- 实时速度展示
- 剩余时间估算
- 当前文件展示

---

### 2.3 完成事件 `backup:completed`

用于在任务成功结束后返回统计结果。

**推送字段**：

- `taskId`: 任务 ID
- `duration`: 总耗时（秒）
- `totalFiles`: 总文件数
- `totalSize`: 总大小（字节）

**可支撑的前端能力**：

- 成功提示
- 备份结果汇总
- 系统通知展示

---

### 2.4 错误事件 `backup:error`

用于在备份失败时返回错误信息。

**推送字段**：

- `taskId`: 任务 ID
- `error`: 错误描述
- `errorCode?`: 可选错误码

**可支撑的前端能力**：

- 错误提示
- 重试引导
- 异常日志记录

---

### 2.5 获取任务列表 `backup:list`

用于查看当前已有的备份任务及其状态。

**返回字段**：

- `id`
- `name`
- `source`
- `destination`
- `status`: `idle | running | paused | completed | error`
- `progress.percent`
- `progress.speed`
- `progress.eta`
- `createdAt`
- `lastRunAt?`
- `nextRunAt?`

**说明**：

- 该接口可用于任务列表页、任务详情页和定时任务看板。
- `lastRunAt` / `nextRunAt` 说明系统支持查看最近执行时间与下次执行时间。

---

### 2.6 任务控制接口

#### `backup:pause`
暂停任务。

#### `backup:resume`
恢复任务。

#### `backup:cancel`
取消任务。

#### `backup:delete`
删除任务。

**说明**：

- 文档给出了“暂停 / 恢复 / 取消 / 删除”能力。
- `backup:list` 的状态枚举里**没有单独列出 `cancelled` 状态**；因此可以确认“支持取消操作”，但取消后的最终状态表现，文档中未进一步展开。

---

## 3. 备份相关辅助接口

虽然不属于“备份 API”主章节，但文档中的完整流程示例表明，备份功能通常还会配合以下接口一起使用：

### 3.1 选择本地源目录 `dialog:selectFolder`

用于让用户选择需要备份的本地文件夹。

### 3.2 浏览设备目录 `zimaos:listFiles`

用于查看设备端路径，确定备份目标位置。

### 3.3 系统通知 `notification:show`

用于在备份完成后弹出系统通知。

### 3.4 打开备份窗口 `window:openBackup`

用于打开备份功能界面。

---

## 4. 备份流程梳理

### 4.1 手动创建并执行备份流程

```text
打开备份界面
  -> 选择本地源文件夹
  -> 选择/确认设备目标目录
  -> 调用 backup:create 创建任务
  -> 监听 backup:progress 更新进度
  -> 成功时接收 backup:completed
  -> 失败时接收 backup:error
  -> 可选：调用 notification:show 发送完成通知
```

### 对应 API 顺序

1. `window:openBackup`（可选）
2. `dialog:selectFolder`
3. `zimaos:listFiles`
4. `backup:create`
5. `backup:progress`（事件监听）
6. `backup:completed` / `backup:error`（事件监听）
7. `notification:show`（可选）

---

### 4.2 定时备份配置流程

```text
用户填写源目录和目标目录
  -> 配置 incremental / exclude / schedule
  -> 调用 backup:create 创建任务
  -> 后续通过 backup:list 查看 nextRunAt / lastRunAt / status
  -> 需要时可 pause / resume / delete
```

### 关键点

- **定时能力入口**在 `backup:create.config.schedule`
- **增量能力入口**在 `backup:create.config.incremental`
- **排除能力入口**在 `backup:create.config.exclude`
- **运行结果查看入口**在 `backup:list`

---

### 4.3 运行中任务控制流程

```text
任务运行中
  -> 可调用 backup:pause 暂停
  -> 可调用 backup:resume 恢复
  -> 可调用 backup:cancel 取消
  -> 不再需要时调用 backup:delete 删除任务
```

---

## 5. 可归纳出的备份状态流转

基于文档中给出的状态枚举和控制接口，可整理出如下状态视图：

```text
idle -> running -> completed
              -> error
              -> paused -> running
```

补充说明：

- 文档明确列出了 `idle / running / paused / completed / error`。
- 文档提供了 `backup:cancel`，但未明确说明取消后在列表中的状态值，因此这里不额外推断取消态名称。

---

## 6. 文档中明确支持的备份功能点汇总

| 功能点     | 是否明确支持 | 依据                        |
| ------- | ------ | ------------------------- |
| 新建备份任务  | 是      | `backup:create`           |
| 增量备份    | 是      | `config.incremental`      |
| 排除规则    | 是      | `config.exclude`          |
| 定时备份    | 是      | `config.schedule`         |
| 查看实时进度  | 是      | `backup:progress`         |
| 查看完成统计  | 是      | `backup:completed`        |
| 错误上报    | 是      | `backup:error`            |
| 查看任务列表  | 是      | `backup:list`             |
| 暂停任务    | 是      | `backup:pause`            |
| 恢复任务    | 是      | `backup:resume`           |
| 取消任务    | 是      | `backup:cancel`           |
| 删除任务    | 是      | `backup:delete`           |
| 完成后系统通知 | 是      | 示例中使用 `notification:show` |

---

## 7. 一句话总结

这套备份 API 的设计重点是：**通过 `backup:create` 定义备份任务，通过事件获取执行结果，通过 `backup:list + pause/resume/cancel/delete` 完成任务生命周期管理，并支持增量、排除和定时备份配置。**






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

移动端文件管理器

移动端文件管理器产品需求文档

1. 文档信息

同步备份功能说明（从 API 文档提取）