# NAS任务中心产品竞品分析（群晖 / 威联通 / 飞牛 / 绿联）

- 研究日期：2026-04-08
- 研究范围：**任务中心/传输任务中心**，聚焦文件上传、下载、复制/移动、BT/HTTP 等下载任务管理；**不包含**系统任务管理器、资源监控中心。
- 研究依据：
  - 本地参考截图：[[我的笔记/NAS需求文档/任务中心/参考/screenshot-20260408-175453.png]]、[[我的笔记/NAS需求文档/任务中心/参考/screenshot-20260408-175549.png]]、[[我的笔记/NAS需求文档/任务中心/参考/screenshot-20260408-175602.png]]、[[我的笔记/NAS需求文档/任务中心/参考/screenshot-20260408-175611.png]]
  - 各厂商官方帮助文档/教程（见文末链接）

---

## 一、结论先行

### 1. 四家产品大致分成两种路线

**路线 A：专业下载中心 + 文件管理后台任务分离**
- 代表：**群晖、威联通**
- 特征：
  - 文件管理中的上传/复制/移动有独立后台任务入口
  - BT/HTTP/FTP/NZB/磁力/RSS 等下载由独立“Download Station/下载中心”承接
  - 下载能力深、自动化强，但入口分散，学习成本更高

**路线 B：统一任务中心聚合传输任务**
- 代表：**飞牛、绿联**
- 特征：
  - 在桌面顶部/任务栏集中展示上传、下载及部分文件任务
  - 更强调“当前发生了什么”，上手轻、反馈直观
  - 但高级下载能力、筛选能力、自动化能力通常弱于群晖/威联通

### 2. 从任务中心产品体验看，最值得借鉴的不是单点功能，而是组合方式

如果目标是做面向大众用户的 NAS 任务中心，最佳方案不是简单抄某一家，而是：

- **用飞牛/绿联的统一任务中心做主入口**
- **用群晖/威联通的下载中心深能力做专业模式/二级页**

也就是：
> **前台统一感知，后台分层承载复杂度。**

---

## 二、参考截图梳理

> 基于截图内容判断，这 4 张图呈现的是一套**统一任务中心方案**，大概率更接近飞牛/绿联这类消费级 NAS 的任务中心设计。下面只做界面层观察，不强行认定具体厂商。

### 截图可见信息

1. 顶层采用 **4 个任务分类 Tab**：
   - 上传
   - 下载
   - 文件任务
   - 其它任务

2. 顶部提供 **批量操作按钮**：
   - 全部暂停
   - 全部开始
   - 清除已完成
   - 全部删除

3. 列表核心字段较克制：
   - 文件名
   - 进度
   - 状态

4. 单任务支持右侧更多操作：
   - 删除
   - 目标位置

5. 上传/下载中会显示：
   - 百分比进度
   - 分片/数量进度（如 41/427、188/427）
   - 实时速度（如 3.6MB/s、70.0MB/s、11.4MB/s）

6. 已完成任务页强调“结果确认”，进行中任务页强调“速度 + 剩余进度”。

### 从截图可推断的产品思路

- 目标用户偏大众，不希望理解复杂下载协议或过多参数
- 把“传输反馈”放到统一窗口，而不是拆成多个应用
- 把高频动作收敛到极少按钮：开始/暂停/清除/删除/打开目标位置
- 任务中心更像**结果与状态控制台**，而不是复杂调度器

### 截图方案的优点

- 学习成本低
- 任务状态清楚
- 适合文件管理、照片备份、浏览器上传等高频轻任务
- “目标位置”操作非常实用，降低用户找文件成本

### 截图方案的短板

- 暂未体现搜索、筛选、排序、错误原因聚合
- 暂未体现队列优先级、重试策略、并发数控制
- 暂未体现“来源应用”字段（文件管理/相册/同步/下载中心）
- 暂未体现失败任务诊断与批量恢复能力

---

## 三、分厂商分析

## 3.1 群晖 Synology

### 产品结构
群晖实际是“**双体系**”：

1. **File Station 上传队列**
   - 上传文件时，DSM 任务栏会出现上传图标
   - 可查看上传进度与速度
   - 更偏轻量传输反馈

2. **Download Station 下载任务管理**
   - 专门处理 BT / HTTP / FTP / NZB / RSS 等下载任务
   - 属于专业下载应用，而非统一任务中心

### 能力特点

**上传侧（File Station）**
- 支持右键上传、拖拽上传
- 支持冲突处理策略（跳过/覆盖）
- 支持查看上传队列
- 上传队列容量较大（官方文档提到最多可加入 1000 个文件）

**下载侧（Download Station）**
- 支持：torrent、NZB、URL 文件、HTTP/FTP URL 输入
- 支持：BT 搜索、RSS 自动订阅下载
- 支持：选择下载文件、指定目标目录、自动解压密码
- 支持的任务视图较完整：
  - All Downloads
  - Downloading
  - Completed
  - Active Downloads
  - Inactive Downloads
  - Stopped
- 支持任务操作：
  - Pause / Resume / Remove
  - 结束异常任务
  - 编辑单任务参数
  - 清除已完成任务
- 支持任务详情页签：
  - General
  - Tracker
  - Peers
  - File
  - Log（NZB）

### 优势

- 下载任务能力最成熟之一
- 自动化能力强（RSS、BT 搜索、文件选择、tracker/peer）
- 适合重度下载用户、PT/BT 用户、精细管理用户

### 问题

- 任务入口分散：上传在 File Station/DSM 任务栏，下载在 Download Station
- 对普通用户而言，“任务中心”概念不统一
- 文件上传下载与下载器任务之间缺少一个统一聚合视图

### 结论
群晖不是“统一任务中心”做得最好，而是“**专业下载任务系统**”做得最强。

---

## 3.2 威联通 QNAP

### 产品结构
威联通同样是“**文件后台任务 + Download Station**”双轨结构，但它在 File Station 内对后台任务的定义更广。

1. **File Station Background Task**
   - 覆盖挂载、文件、文件夹操作
   - 不仅是上传下载，也包括更多后台文件任务

2. **Download Station**
   - 承担 URL、磁力、Torrent、RSS 等下载任务

### 能力特点

**文件管理后台任务**
- File Station 顶部有 **Background Task** 入口
- 上传文件/文件夹时会自动弹出后台任务窗口
- 支持重名策略：
  - Rename duplicate files
  - Skip duplicate files
  - Overwrite duplicate files
- 后台任务页区分：
  - Task tab：显示所有任务
  - Upload tab：只显示上传任务
- 支持批量清理：
  - Delete All
  - Remove All Complete Tasks（上传页）

**下载中心**
- 支持 URL 创建任务
- 支持多 URL 批量粘贴
- 支持 HTTP / FTP / Magnet / FlashGet / Thunder / QQDL
- 支持拖入 BT 文件创建任务
- 支持 Search
- 支持 RSS
- 支持全局上下行限速
- 支持下载时间表（Schedule）
- 支持邮件通知

### 优势

- File Station 后台任务覆盖范围比群晖更广
- 下载协议支持丰富，兼顾国内下载习惯（如 Thunder/QQDL）
- “后台任务”概念比群晖更系统化

### 问题

- 仍然是双入口结构，普通用户要理解 File Station 与 Download Station 的边界
- 后台任务更偏“系统执行过程”，不够像一个面向用户的统一任务中心
- 视觉与信息架构偏工具化，亲和度不如飞牛/绿联

### 结论
威联通比群晖更接近“统一后台任务”的思路，但对终端用户而言，仍不是一个真正一体化的任务中心。

---

## 3.3 飞牛 fnOS

### 产品结构
飞牛更接近“**统一任务中心**”路线。从本地截图以及官方帮助信息看，飞牛会把上传、下载、文件任务等集中在一个任务中心中展示。

### 能力特点

**从截图可见的任务中心能力**
- 统一入口
- 分 Tab 管理：上传 / 下载 / 文件任务 / 其它任务
- 支持批量操作：全部暂停、全部开始、清除已完成、全部删除
- 任务行支持：
  - 进度条
  - 完成百分比
  - 实时速度
  - 更多操作（删除、目标位置）

**从官方帮助可见的补充能力**
- 相册备份任务会显示状态：
  - 扫描中
  - 正在备份
  - 备份成功
  - 备份暂停或失败
- 若部分失败，可跳转到“**任务传输**”查看详细错误信息
- 备份关闭时，会取消正在备份以及未备份的队列任务

### 优势

- 统一任务心智明显，用户容易理解
- 更适合承接文件上传、照片备份、同步等多来源轻中度任务
- 把“状态反馈 + 快捷处置”放在一个页面里，效率高
- “目标位置”这类动作非常贴近用户实际诉求

### 问题

- 从公开资料看，高级下载能力不如群晖/威联通系统化
- 截图中缺少更强的筛选、搜索、排序、错误诊断、重试和优先级机制
- 若未来任务来源增多（同步、备份、离线下载、转码、解压、索引），Tab 结构可能膨胀

### 结论
飞牛的方向非常适合作为 NAS 的默认任务中心形态：**统一、直接、轻学习成本**。但如果要承载重度下载或更复杂的后台作业，还需要进一步做任务分层。

---

## 3.4 绿联 UGOS Pro

### 产品结构
绿联是“**统一任务中心入口 + 独立下载中心深能力**”的折中方案。

1. **文件管理中的任务中心**
   - 文件上传下载后，可在首页任务栏“任务中心”查看进度与传输速度
   - 偏状态总览

2. **下载中心应用**
   - 负责 URL / Torrent / 做种任务等深度下载管理
   - 偏专业任务管理

### 能力特点

**文件管理上传/下载**
- 上传支持三种方式：
  - 右键上传
  - 顶部上传按钮
  - 拖放上传
- 重名处理方式：
  - 覆盖
  - 跳过
  - 保留
- 下载支持单个或批量下载
- 任务中心可查看：
  - 上传/下载进度
  - 传输速度
- 更详细信息建议到日志中心查看

**下载中心**
- 支持从链接新建任务：HTTP / HTTPS / FTP / 磁力链接等
- 支持从 `.torrent` 文件新建任务
- 支持批量粘贴多个链接
- 支持设置下载保存路径
- 支持开始/暂停任务
- 支持查看任务详情：进度、连接状态、下载路径
- 支持批量统一管理
- BT/PT 完成后支持做种管理：
  - 启动/暂停做种
  - 删除任务
  - 从文件管理打开
  - 搜索任务
- 删除下载/做种任务时，不删除已下载文件

### 优势

- 比飞牛更明确地区分“轻任务总览”和“重下载管理”
- 文件管理任务入口对普通用户友好
- 下载中心能力足够满足多数家庭 NAS 的下载诉求
- 做种管理、打开所在目录、搜索等能力比较实用

### 问题

- 任务中心本身更像轻量浮层/入口，不是完整任务工作台
- 深度排障依赖日志中心，任务中心自身闭环较弱
- 文件任务、下载任务、日志信息仍有一定分散

### 结论
绿联的方案非常适合消费级 NAS：**前台轻入口 + 后台独立下载中心**。它比飞牛更有“能力分层”意识，但统一感略弱于飞牛截图方案。

---

## 四、横向对比矩阵

| 维度 | 群晖 | 威联通 | 飞牛 | 绿联 |
|---|---|---|---|---|
| 主入口形态 | File Station 队列 + Download Station | Background Task + Download Station | 统一任务中心 | 任务中心 + 下载中心 |
| 上传任务可视化 | 有，DSM 任务栏队列 | 有，Background Task/Upload Tab | 有，统一任务中心 | 有，任务栏任务中心 |
| 下载任务统一纳管 | 中等，依赖 Download Station | 中等，依赖 Download Station | 较强，统一 Tab 化 | 中等偏强，任务中心总览 + 下载中心细管 |
| 专业下载协议 | 很强 | 很强 | 较弱/待补足 | 中等偏强 |
| RSS/搜索/BT 深度 | 很强 | 很强 | 弱 | 中等 |
| 文件任务聚合 | 弱到中 | 强 | 中 | 中 |
| 批量操作 | 强 | 强 | 强（截图可见） | 强 |
| 错误诊断 | 中 | 中 | 中（可跳任务传输看错误） | 中（依赖日志中心） |
| 对小白友好度 | 中 | 中偏低 | 高 | 高 |
| 对重度下载用户友好度 | 高 | 高 | 中低 | 中 |
| 统一感 | 低 | 中 | 高 | 中高 |

---

## 五、关键设计差异总结

### 1. 任务中心到底是“总览页”还是“专业工作台”？
- **飞牛/绿联任务中心**更像总览页
- **群晖/威联通下载中心**更像专业工作台

### 2. 是否把文件操作任务也纳入同一模型？
- **威联通**做得最系统，Background Task 不止上传下载
- **飞牛**也在往统一任务模型走，但公开能力呈现还偏轻
- **群晖**上传与下载仍明显分离

### 3. 错误处理是“日志式”还是“任务式”？
- **绿联**更偏日志式（详细信息去日志中心）
- **飞牛**开始把错误放回任务链路（任务传输查看错误）
- **群晖/威联通**偏专业任务参数与状态，但对普通用户解释性未必足够

---

## 六、对 NAS 任务中心设计的启示

## 6.1 建议采用“1 个统一中心 + 2 层能力深度”

### 第一层：统一任务中心（所有用户都看得懂）
建议默认展示：
- 上传
- 下载
- 文件任务
- 其它任务

每条任务至少展示：
- 任务名
- 来源应用（文件管理/相册/同步/下载中心）
- 状态
- 进度
- 实时速度
- 剩余时间（若可计算）
- 目标位置
- 错误摘要

支持操作：
- 暂停/继续
- 删除任务
- 清除已完成
- 重试失败任务
- 打开目标位置
- 查看详情

### 第二层：专业任务详情页（重度用户使用）
针对下载类任务补充：
- 协议类型
- 下载来源 URL / magnet / torrent
- peers / tracker / 连接状态
- 限速
- 并发控制
- 自动分类目录
- 做种规则
- 调度策略
- 错误日志

---

## 6.2 应重点补齐的能力

### P0：必须有
1. 统一入口
2. 任务来源分类
3. 失败原因明确化
4. 打开目标位置
5. 批量清理已完成
6. 批量暂停/恢复
7. 重名文件策略统一

### P1：显著提升体验
1. 失败任务重试
2. 搜索/筛选/排序
3. 查看历史任务
4. 区分“当前任务”和“历史任务”
5. 任务完成通知
6. 任务详情中的速度曲线/耗时信息

### P2：专业增强
1. 下载计划与限速
2. RSS/订阅下载
3. BT/PT 做种管理
4. tracker / peers 信息
5. 任务优先级
6. 自动解压/自动归档

---

## 七、最终判断

如果只看“**任务中心体验**”而不是整个下载生态：

- **统一感最好：飞牛**
- **文件后台任务体系最完整：威联通**
- **专业下载能力最强：群晖**
- **消费级平衡性最好：绿联**

如果要做一款更有竞争力的 NAS 任务中心，建议目标不是“做成某一家”，而是形成下面的组合：

> **界面层像飞牛，任务模型像威联通，下载深能力像群晖，产品取舍像绿联。**

---

## 八、参考链接

### 群晖 Synology
- File Station 上传：<https://kb.synology.com/en-global/DSM/help/FileStation/upload?version=7>
- Download Station 创建任务：<https://kb.synology.com/en-global/DSM/help/DownloadStation/download_create?version=7>
- Download Station 管理任务：<https://kb.synology.com/en-global/DSM/help/DownloadStation/download_manage?version=7>

### 威联通 QNAP
- File Station User Interface：<https://docs.qnap.com/operating-system/qts/5.0.x/en-us/file-station-user-interface-BFDF1926.html>
- Uploading Files and Folders：<https://docs.qnap.com/operating-system/qts/5.0.x/en-us/uploading-files-and-folders-1D4742A3.html>
- Removing Background Tasks：<https://docs.qnap.com/operating-system/qts/5.0.x/en-us/removing-background-tasks-0A7F7656.html>
- How to use Download Station：<https://www.qnap.com/en/how-to/tutorial/article/how-to-use-download-station>

### 飞牛 fnOS
- 如何备份手机照片（含任务传输/失败状态说明）：<https://help.fnnas.com/articles/v1/photo/photo-backup.md>
- 飞牛同步功能介绍：<https://help.fnnas.com/articles/v1/sync/how-to-use-fnsync.md>
- 常见使用问题说明：<https://help.fnnas.com/articles/v1/sync/fnsync-faq.md>

### 绿联 UGOS Pro
- 上传和下载文件或文件夹功能介绍：<https://www.ugnas.com/tutorial-detail/id-126.html>
- 下载功能应用指南：<https://www.ugnas.com/tutorial-detail/id-90.html>



NAS任务中心产品竞品分析

NAS任务中心详细需求文档

# NAS任务中心低保真原型说明

## 文档信息

| 项目 | 内容 |
|---|---|
| 文档版本 | v1.0 |
| 创建日期 | 2026-04-10 |
| 更新日期 | 2026-04-10 |
| 关联文档 | [[我的笔记/NAS需求文档/任务中心/NAS任务中心详细需求文档]]、[[我的笔记/NAS需求文档/任务中心/软件需求规划]] |
| 适用范围 | PC 端 / 移动端 |
| 目标 | 为交互、视觉、前后端提供任务中心低保真结构参考 |

---

# 一、原型说明目标

本说明用于补充任务中心的页面级低保真原型思路，重点回答以下问题：

1. 任务中心页面长什么样。  
2. PC 端和移动端分别如何组织信息。  
3. 文件任务与备份任务如何在统一界面中展示。  
4. 失败任务、空状态、批量操作在不同端如何落位。  
5. 不做下载器的前提下，如何保持“任务中心”轻量易懂。

---

# 二、原型设计原则

1. **统一入口**：任务中心要作为系统级可达入口。  
2. **结果优先**：用户最关心“有没有完成、失败没、文件在哪”。  
3. **状态清晰**：进行中、已完成、失败、部分完成必须一眼识别。  
4. **操作克制**：首期只放通用操作，不放复杂调度能力。  
5. **双端一致，布局分化**：信息含义一致，但 PC 端更适合列表和抽屉，移动端更适合卡片和详情页。

---

# 三、原型范围

## 3.1 本次覆盖页面
- 任务中心首页
- 任务详情
- 失败/空状态
- 批量操作状态

## 3.2 本次不覆盖
- 高保真视觉稿
- 动效细节
- 下载中心页面
- 深度筛选、失败重试、复杂历史归档（V1.1+）

---

# 四、PC 端低保真原型说明

## 4.1 PC 端信息结构

```mermaid
flowchart TD
    A[PC任务中心] --> B[顶部工具栏]
    A --> C[任务分类标签]
    A --> D[任务列表]
    A --> E[任务详情抽屉]
    A --> F[空状态/异常状态]

    B --> B1[标题]
    B --> B2[任务统计]
    B --> B3[清理已完成]
    B --> B4[批量删除]

    C --> C1[全部]
    C --> C2[文件任务]
    C --> C3[备份任务]
    C --> C4[进行中]
    C --> C5[已完成]
    C --> C6[失败]
```

## 4.2 PC 端页面 1：任务中心首页

### 4.2.1 页面目标
- 承接桌面顶部/任务栏进入
- 快速总览任务状态
- 提供首期高频操作：查看、清理、删除、打开目标位置

### 4.2.2 低保真布局草图

```text
┌──────────────────────────────────────────────────────────────────────────────┐
│ 任务中心                                            总任务 12 进行中 3 [清理已完成] [批量删除] │
├──────────────────────────────────────────────────────────────────────────────┤
│ [全部] [文件任务] [备份任务] [进行中] [已完成] [失败]                         │
├──────────────────────────────────────────────────────────────────────────────┤
│ □ 任务名称              来源应用      进度             状态      速度    更新时间   更多 │
├──────────────────────────────────────────────────────────────────────────────┤
│ □ 假期照片上传           文件管理      [==== 45% ]     进行中    12MB/s  10:21    ⋯   │
│ □ 家庭视频整理_复制       文件管理      [=========90%]  进行中    88MB/s  10:19    ⋯   │
│ □ 手机相册备份           相册备份      扫描中 320/1200  扫描中    -       10:18    ⋯   │
│ □ SD卡导入               一键备份      [========100%]  已完成    -       10:10    ⋯   │
│ □ 设计稿归档             文件管理      3/20失败         部分完成   -       09:58    ⋯   │
├──────────────────────────────────────────────────────────────────────────────┤
│ 底部说明：已完成/失败任务仅删除记录，不删除文件结果                           │
└──────────────────────────────────────────────────────────────────────────────┘
```

### 4.2.3 页面说明

| 区域 | 说明 |
|---|---|
| 顶部工具栏 | 展示标题、统计信息、批量操作 |
| 分类标签 | 快速切换任务维度，减少首期筛选复杂度 |
| 任务列表 | 采用表格形态，适合 PC 端查看批量任务 |
| 底部说明 | 强化“删除记录≠删除文件”的认知 |

### 4.2.4 行交互说明

| 交互 | 结果 |
|---|---|
| 点击任务名称 | 打开右侧详情抽屉（V1.1）或跳详情页 |
| 点击更多操作 | 展开操作菜单 |
| 勾选多条任务 | 顶部进入批量操作态 |
| 点击标签 | 切换列表内容 |

---

## 4.3 PC 端页面 2：任务行更多操作菜单

### 4.3.1 低保真草图

```text
        ┌──────────────┐
        │ 打开目标位置 │
        │ 暂停任务     │
        │ 继续任务     │
        │ 删除记录     │
        └──────────────┘
```

### 4.3.2 规则说明
- 进行中任务：显示“暂停任务”
- 已暂停任务：显示“继续任务”
- 已完成任务：优先显示“打开目标位置”
- 不支持控制的任务：隐藏暂停/继续

---

## 4.4 PC 端页面 3：任务详情抽屉

### 4.4.1 页面目标
- 不离开任务列表即可查看完整上下文
- 帮助用户快速理解来源、目标和失败原因

### 4.4.2 低保真布局草图

```text
┌────────────────────── 任务详情 ──────────────────────┐
│ 任务名称：手机相册备份                                  │
│ 状态：进行中 / 扫描中                                   │
│------------------------------------------------------│
│ 来源应用：相册备份                                     │
│ 来源对象：iPhone 16 Pro / 最近项目                      │
│ 目标位置：/Photos/2026/04                              │
│ 创建时间：2026-04-10 10:02                             │
│ 更新时间：2026-04-10 10:21                             │
│------------------------------------------------------│
│ 进度：[======= 62% ]                                   │
│ 数量：742 / 1200                                       │
│ 速度：8.2 MB/s                                         │
│------------------------------------------------------│
│ 状态时间线                                             │
│ 已创建 -> 扫描中 -> 备份中                              │
│------------------------------------------------------│
│ 失败摘要（如有）                                       │
│ 3 个文件失败：空间不足                                  │
│------------------------------------------------------│
│ [打开目标位置] [暂停/继续] [删除记录]                  │
└──────────────────────────────────────────────────────┘
```

### 4.4.3 信息层级
1. 先看任务名和状态  
2. 再看来源与目标  
3. 再看进度与时间  
4. 最后看失败信息和操作按钮

---

## 4.5 PC 端页面 4：空状态

### 4.5.1 低保真草图

```text
┌──────────────────────────────────────────┐
│                  暂无任务                  │
│ 当前没有进行中的文件任务或备份任务         │
│ 你可以前往文件管理、相册备份或一键备份发起任务 │
└──────────────────────────────────────────┘
```

### 4.5.2 空状态文案方向
- 强调“当前没有任务”
- 说明任务从哪里来
- 不做复杂 CTA，避免打断系统级页面定位

---

## 4.6 PC 端页面 5：失败状态行表现

### 4.6.1 低保真示意

```text
│ □ 素材归档_复制      文件管理      17/20完成   部分完成   -   09:58   ⋯ │
│    错误摘要：3 个文件失败，目标目录空间不足                           │
```

### 4.6.2 说明
- 首行放核心字段
- 第二行用浅提示展示失败摘要
- 避免强迫用户进入详情才能理解错误

---

## 4.7 PC 端页面 6：批量选择态

### 4.7.1 低保真草图

```text
┌─────────────────────────────────────────────────────────────────────┐
│ 已选择 4 项                                       [批量删除] [取消选择] │
├─────────────────────────────────────────────────────────────────────┤
│ 列表进入多选态                                                   │
└─────────────────────────────────────────────────────────────────────┘
```

### 4.7.2 规则
- 首期默认批量操作仅保留：批量删除、清理已完成
- 若底层能力成熟，可扩展批量暂停/继续

---

# 五、移动端低保真原型说明

## 5.1 移动端信息结构

```mermaid
flowchart TD
    A[移动端任务中心] --> B[顶部导航]
    A --> C[分类切换]
    A --> D[任务卡片列表]
    A --> E[详情页]
    A --> F[底部操作菜单]
```

## 5.2 移动端页面 1：任务中心首页

### 5.2.1 页面目标
- 适配窄屏场景下的任务快速浏览
- 优先展示任务状态和结果操作
- 保证单手操作可达性

### 5.2.2 低保真布局草图

```text
┌──────────────────────┐
│ ← 任务中心      清理已完成 │
├──────────────────────┤
│ [全部][文件][备份][失败] │
├──────────────────────┤
│ 假期照片上传           ⋯ │
│ 文件管理                │
│ [===== 45% ] 进行中     │
│ 12MB/s · 10:21更新      │
├──────────────────────┤
│ 手机相册备份           ⋯ │
│ 相册备份                │
│ 扫描中 320/1200         │
│ 10:18更新               │
├──────────────────────┤
│ SD卡导入               ⋯ │
│ 一键备份                │
│ 已完成                  │
│ 目标位置 >              │
└──────────────────────┘
```

### 5.2.3 页面说明

| 区域 | 说明 |
|---|---|
| 顶部导航 | 返回、标题、清理已完成 |
| 分类切换 | 建议 4 个以内，避免横向过长 |
| 任务卡片 | 一张卡片表达一条任务，适合移动端浏览 |
| 更多菜单 | 用底部 Action Sheet 承接操作 |

---

## 5.3 移动端页面 2：任务卡片结构

### 5.3.1 卡片低保真拆解

```text
┌──────────────────────┐
│ 任务名             ⋯ │
│ 来源应用             │
│ 进度/阶段信息         │
│ 状态 + 速度/时间      │
│ 失败摘要或目标位置入口 │
└──────────────────────┘
```

### 5.3.2 卡片字段优先级
1. 任务名  
2. 来源应用  
3. 当前状态/阶段  
4. 进度  
5. 速度或更新时间  
6. 失败摘要/目标位置入口

---

## 5.4 移动端页面 3：任务详情页

### 5.4.1 页面目标
- 移动端不适合抽屉，建议进入独立详情页
- 便于展示较长信息和状态时间线

### 5.4.2 低保真布局草图

```text
┌──────────────────────┐
│ ← 任务详情            │
├──────────────────────┤
│ 手机相册备份          │
│ 进行中 / 扫描中        │
├──────────────────────┤
│ 来源应用：相册备份      │
│ 来源对象：最近项目      │
│ 目标位置：/Photos/...  │
├──────────────────────┤
│ 进度 62%              │
│ 742 / 1200            │
│ 8.2MB/s               │
├──────────────────────┤
│ 状态时间线             │
│ 已创建                │
│ 扫描中                │
│ 备份中                │
├──────────────────────┤
│ 失败摘要（如有）       │
│ 3 个文件失败：空间不足  │
├──────────────────────┤
│ [打开目标位置]         │
│ [暂停任务]             │
│ [删除记录]             │
└──────────────────────┘
```

### 5.4.3 交互说明
- 点击卡片进入详情页
- 底部按钮使用纵向堆叠，适合单手点击
- 失败任务优先露出失败原因模块

---

## 5.5 移动端页面 4：更多操作 Action Sheet

### 5.5.1 低保真草图

```text
┌──────────────────────┐
│ 打开目标位置          │
│ 暂停任务              │
│ 继续任务              │
│ 删除记录              │
│ 取消                  │
└──────────────────────┘
```

### 5.5.2 规则
- 用底部弹层承接更多操作，减少误触
- 删除记录放在危险操作区，视觉弱化但明确可达

---

## 5.6 移动端页面 5：空状态

### 5.6.1 低保真草图

```text
┌──────────────────────┐
│        暂无任务        │
│ 当前没有需要处理的任务  │
│ 文件管理/备份任务会显示在这里 │
└──────────────────────┘
```

---

## 5.7 移动端页面 6：失败卡片表现

### 5.7.1 低保真示意

```text
┌──────────────────────┐
│ 素材归档_复制       ⋯ │
│ 文件管理              │
│ 部分完成              │
│ 3 个文件失败：空间不足 │
│ 查看详情 >            │
└──────────────────────┘
```

### 5.7.2 说明
- 移动端空间有限，失败摘要只保留一行
- 更完整内容进入详情页

---

# 六、PC 与移动端差异说明

| 维度 | PC 端 | 移动端 |
|---|---|---|
| 主要容器 | 表格列表 | 卡片列表 |
| 详情承载 | 右侧抽屉/侧栏 | 独立详情页 |
| 批量操作 | 顶部批量栏 | 首期弱化，不主推 |
| 更多操作 | 行内菜单 | Action Sheet |
| 信息密度 | 高 | 中 |
| 浏览方式 | 横向对比多个任务 | 纵向逐卡浏览 |

---

# 七、首期建议出图清单

## 7.1 PC 端
1. 任务中心首页-默认态  
2. 任务中心首页-多任务进行中态  
3. 任务中心首页-失败任务态  
4. 任务详情抽屉  
5. 空状态  
6. 批量选择态

## 7.2 移动端
1. 任务中心首页-默认态  
2. 任务中心首页-失败卡片态  
3. 任务详情页  
4. 更多操作 Action Sheet  
5. 空状态

---

# 八、交互补充建议

## 8.1 首期推荐保留的统一动作
- 打开目标位置
- 删除记录
- 清理已完成
- 暂停/继续（仅在底层支持时展示）

## 8.2 首期不建议进入首页主视图的能力
- 复杂筛选器
- 高级历史查询
- 失败重试入口
- 与下载器混合展示的协议任务

## 8.3 状态颜色建议（给视觉参考）
- 进行中：品牌主色/蓝色
- 已完成：绿色
- 部分完成：橙色
- 失败：红色
- 已暂停：灰色

---

# 九、原型结论

任务中心低保真原型应突出以下核心：

1. **PC 端强调批量查看与效率**：用表格 + 抽屉提高信息密度。  
2. **移动端强调状态浏览与单手操作**：用卡片 + 详情页降低认知负担。  
3. **双端都围绕“状态、结果、失败原因、目标位置”展开**。  
4. **首期必须保持边界清晰，不把下载中心复杂能力混入任务中心界面**。



NAS任务中心低保真原型说明

# 任务中心软件需求规划

# 需求背景

- 为什么要做
    
    当前 NAS 内的文件上传、下载、复制/移动、相册备份、一键备份等任务分散在不同应用和页面中，用户只能在任务发起处局部感知进度，难以在一个统一入口查看任务状态、失败原因和结果位置。结合 [[我的笔记/NAS需求文档/任务中心/NAS任务中心产品竞品分析]]，消费级 NAS 产品更适合提供统一任务中心，降低心智成本。
    
- 解决什么问题
    
    1. 解决“任务发起后看不到后续状态”的问题。  
    2. 解决“文件任务与备份任务分散在不同模块，缺少统一管理入口”的问题。  
    3. 解决“任务失败后原因不清、无法快速重试或打开目标位置”的问题。  
    4. 解决“普通用户不理解专业下载器概念，但需要知道传输是否完成”的问题。
    
- 对业务的价值
    
    1. 提升文件管理、相册备份、一键备份等核心能力的可见性和完成率。  
    2. 降低用户对 NAS 后台任务的理解门槛，提升产品易用性和满意度。  
    3. 为后续同步、导入、索引、媒体处理等后台任务统一接入提供平台基础。  
    4. 将“任务状态反馈”从功能附属能力升级为系统级公共能力，减少重复建设。
    
- 竞品的状态
    
    1. 群晖、威联通：文件后台任务与下载中心分离，专业能力强，但统一感弱。  
    2. 飞牛：统一任务中心方向最清晰，适合消费级 NAS 的默认入口。  
    3. 绿联：任务中心做轻入口，下载中心做深管理，分层更明确。  
    4. 本期规划结论：**任务中心聚焦统一查看和管理文件任务、备份任务；不承接专业【下载中心】协议级管理能力。**

# 用户旅程（用户使用场景/前端页面/不包含判断规则）

```mermaid
flowchart LR
    A[用户在文件管理发起上传/复制/移动/下载] --> B[系统创建文件任务]
    C[用户在相册/一键备份发起备份] --> D[系统创建备份任务]
    B --> E[任务中心聚合展示]
    D --> E
    E --> F[查看进行中/已完成/失败状态]
    F --> G[执行暂停/继续/删除/清理已完成/打开目标位置]
    F --> H[查看失败原因或结果]
    H --> I[返回源应用继续处理]
```

**前端页面建议**
- 页面 1：任务中心首页（默认页）
- 页面 2：任务详情抽屉/侧栏
- 页面 3：失败任务详情页（可选，V1.1）

**本规划明确不包含**
- 专业【下载中心】能力：BT/PT、磁力、Torrent、RSS、Tracker、Peers、协议限速、做种管理、下载计划等
- 专业下载任务的新建、编辑、协议级详情页
- 系统资源中心、任务管理器、存储运维类后台任务

# 场景拆解（包含判断规则&场景说明）

| 流程 | 节点 | 使用场景 | 系统行为 | 判断规则 |
|---|---|---|---|---|
| 文件任务流程 | 节点 1-1 | 用户在文件管理发起上传文件/文件夹 | 创建文件任务并加入任务中心 | 仅对耗时任务创建记录；瞬时完成任务不进入列表 |
| 文件任务流程 | 节点 1-2 | 用户在文件管理发起复制/移动/站内下载 | 按任务类型记录来源、目标、进度、状态 | 必须能识别任务来源应用与目标路径 |
| 文件任务流程 | 节点 1-3 | 任务执行中，用户打开任务中心 | 展示进行中任务、进度、速度、状态 | 若任务支持控制，则展示暂停/继续；否则只展示删除/查看 |
| 文件任务流程 | 节点 1-4 | 文件重名/权限不足/空间不足 | 任务进入失败或部分完成状态 | 必须返回可理解错误文案，不只显示错误码 |
| 文件任务流程 | 节点 1-5 | 用户点击目标位置 | 跳转到文件管理并高亮目标目录/结果文件 | 若结果文件不存在，则提示“文件已不存在/被移动” |
| 备份任务流程 | 节点 2-1 | 用户在相册备份中开启或手动发起备份 | 创建备份任务并进入任务中心 | 备份任务需支持来源设备/备份对象/目标相册或目录 |
| 备份任务流程 | 节点 2-2 | 用户在一键备份中触发本地介质拷贝 | 创建备份任务并记录来源介质与目标目录 | 物理按键触发的任务也必须进入任务中心 |
| 备份任务流程 | 节点 2-3 | 备份进行中出现扫描、上传、校验等阶段 | 以阶段状态展示任务进展 | 状态至少区分：排队中、扫描中、执行中、已暂停、已完成、失败、部分完成 |
| 备份任务流程 | 节点 2-4 | 备份部分成功、部分失败 | 任务展示“部分完成”，可查看失败摘要 | 部分失败不应等同于整体失败 |
| 运维恢复流程 | 节点 3-1 | 用户进入任务中心查看失败任务 | 提供失败原因、发起来源、时间、目标位置 | 首期至少支持查看，不强制支持一键重试 |
| 运维恢复流程 | 节点 3-2 | 用户批量清理已完成任务 | 批量移除任务记录，不删除已生成文件 | “删除任务记录”与“删除文件结果”必须分离 |
| 运维恢复流程 | 节点 3-3 | 用户离开当前应用后再返回 | 任务中心继续保留最近任务状态 | 首期保留当前任务 + 有限历史任务 |

# 需求定义（场景到需求的转化）

| 流程 | 节点 | 需求描述 | 补充说明 | 需求类型 | 优先级 | 实现方式（可选） |
|---|---|---|---|---|---|---|
| 文件任务流程 | 节点 1-1 | 建立统一任务中心入口 | 在桌面顶部/任务栏固定可达 | 功能 | P0 | 新开发 |
| 文件任务流程 | 节点 1-1 | 建立统一任务模型 | 统一字段：任务 ID、任务类型、来源应用、状态、进度、速度、时间、目标位置 | 功能 | P0 | 公共服务 |
| 文件任务流程 | 节点 1-2 | 支持文件上传任务接入 | 包含单文件、多文件、文件夹上传 | 功能 | P0 | 复用文件管理 |
| 文件任务流程 | 节点 1-2 | 支持文件复制/移动任务接入 | 站内文件流转纳入任务中心 | 功能 | P0 | 复用文件管理 |
| 文件任务流程 | 节点 1-2 | 支持普通文件下载任务接入 | 指文件管理内下载到本地/浏览器下载，不含下载中心协议任务 | 功能 | P1 | 复用文件管理 |
| 文件任务流程 | 节点 1-3 | 任务列表展示基础字段 | 任务名、来源、状态、进度、速度、更新时间 | 功能 | P0 | 新开发 |
| 文件任务流程 | 节点 1-3 | 提供任务分类视图 | 首期至少支持：文件任务、备份任务、全部任务 | 功能 | P0 | 新开发 |
| 文件任务流程 | 节点 1-3 | 支持批量操作 | 清理已完成、批量删除任务记录 | 功能 | P0 | 新开发 |
| 文件任务流程 | 节点 1-3 | 支持单任务操作 | 打开目标位置、删除记录；对可控任务支持暂停/继续 | 功能 | P0 | 新开发 |
| 文件任务流程 | 节点 1-4 | 建立统一错误文案规范 | 权限不足、空间不足、网络中断、文件不存在、文件被占用等统一可读文案 | 规则 | P0 | 公共规范 |
| 文件任务流程 | 节点 1-4 | 支持部分完成状态 | 文件批量任务中部分成功需独立标识 | 功能 | P1 | 新开发 |
| 文件任务流程 | 节点 1-5 | 支持打开目标位置 | 跳转至文件管理对应目录 | 功能 | P0 | 页面联动 |
| 备份任务流程 | 节点 2-1 | 支持相册备份任务接入 | 包含自动备份与手动备份 | 功能 | P0 | 复用相册备份 |
| 备份任务流程 | 节点 2-2 | 支持一键备份任务接入 | 包含 USB/SD 卡拷贝任务 | 功能 | P0 | 复用一键备份 |
| 备份任务流程 | 节点 2-3 | 备份任务展示阶段状态 | 排队中、扫描中、备份中、校验中、已暂停、已完成、失败、部分完成 | 功能 | P0 | 新开发 |
| 备份任务流程 | 节点 2-3 | 备份任务展示对象信息 | 来源设备/来源相册、目标目录、当前进度 | 功能 | P0 | 新开发 |
| 备份任务流程 | 节点 2-4 | 失败摘要查看能力 | 首期支持查看失败原因和失败数量 | 功能 | P0 | 新开发 |
| 运维恢复流程 | 节点 3-1 | 任务详情抽屉 | 查看更完整字段：发起时间、结束时间、耗时、错误原因、目标位置 | 功能 | P1 | 新开发 |
| 运维恢复流程 | 节点 3-1 | 失败任务筛选 | 按状态筛选失败/进行中/已完成 | 功能 | P1 | 新开发 |
| 运维恢复流程 | 节点 3-2 | 清理已完成不删除结果文件 | 明确区分数据删除与记录删除 | 规则 | P0 | 公共规范 |
| 运维恢复流程 | 节点 3-2 | 删除进行中任务需二次确认 | 防止误删执行中任务 | 规则 | P0 | 通用交互 |
| 运维恢复流程 | 节点 3-3 | 保留任务历史 | 首期建议保留最近 7~30 天任务记录 | 功能 | P1 | 新开发 |
| 运维恢复流程 | 节点 3-3 | 支持完成通知 | 页面内提醒即可，系统通知后置 | 功能 | P1 | 新开发 |
| 平台边界 | 节点 4-1 | 下载中心任务不纳入首期管理闭环 | 首期不支持新建/暂停/配置 BT、磁力、RSS 等任务 | 边界 | P0 | 产品约束 |
| 平台边界 | 节点 4-2 | 若未来接入下载中心，仅以摘要方式接入 | 仅显示“下载任务进行中/已完成”，点击跳转下载中心 | 规划 | P2 | 预留扩展 |

# 卖点转化

| 卖点 | 需求/功能点 |
|---|---|
| 统一入口，所有传输任务一眼看清 | 统一任务中心入口 |
| 文件任务与备份任务统一管理 | 统一任务模型、分类视图 |
| 任务发起后不失联 | 列表展示基础字段、阶段状态、任务历史 |
| 失败原因明确，用户敢用 | 统一错误文案规范、失败摘要查看 |
| 找结果更快 | 打开目标位置 |
| 批量整理更轻松 | 清理已完成、批量删除任务记录 |
| 面向普通用户，避免复杂下载器概念污染 | 下载中心能力排除在首期范围外 |

# 排期需求

| 功能模块/页面 | 包含内容 | 目标版本 |
|---|---|---|
| 任务中心基础框架 | 统一入口、统一任务模型、任务列表 UI、全部/文件任务/备份任务分类 | V1.0 |
| 文件任务管理 | 上传、复制、移动任务接入；进度/速度/状态展示；打开目标位置；删除记录；清理已完成 | V1.0 |
| 备份任务管理 | 相册备份接入、一键备份接入；阶段状态展示；失败摘要；目标位置 | V1.0 |
| 基础交互规则 | 删除确认、完成记录清理规则、统一错误文案规范 | V1.0 |
| 任务详情能力 | 详情抽屉、更多字段展示、失败详情查看 | V1.1 |
| 列表增强 | 状态筛选、搜索、当前任务/历史任务拆分、任务完成通知 | V1.1 |
| 任务恢复能力 | 失败重试、部分完成补救流程、更多批量操作 | V1.2 |
| 平台化扩展 | 接入同步任务、媒体导入、索引任务等；下载中心摘要接入跳转 | V2.0 |

**版本策略说明**
- **V1.0 首期重点**：只做“文件任务管理 + 备份任务管理”，先把统一入口、统一状态、统一查看能力做完整。  
- **V1.1~V1.2**：补任务详情、筛选、历史、重试，增强可恢复性。  
- **V2.0**：考虑接入更多后台任务类型，但仍不在任务中心内承接专业下载器深能力。

# 需求风险

| 功能模块/功能点 | 风险描述 | 解决方案 |
|---|---|---|
| 统一任务模型 | 各业务模块输出字段不一致，导致无法统一展示 | 制定公共任务字段协议，先覆盖文件管理、相册备份、一键备份三类 |
| 任务状态标准化 | 不同模块对“处理中/失败/暂停”定义不同 | 建立统一状态机与映射表，由任务中心统一转换显示 |
| 打开目标位置 | 部分任务结果文件可能被移动或已删除，导致跳转失败 | 允许跳目录兜底，并提示“结果文件已变更” |
| 文件批量任务 | 大批量文件任务更新频繁，可能造成列表抖动或性能问题 | 增量刷新、合并更新、限制高频 UI 刷新频率 |
| 备份任务接入 | 相册备份和一键备份可能已有自己的状态页，重复建设风险高 | 任务中心只做聚合展示与通用操作，业务详情仍保留在源应用 |
| 用户预期边界 | 用户可能误以为任务中心可管理 BT/磁力下载任务 | 在文案、入口、帮助说明中明确“下载中心任务请前往下载中心管理” |
| 历史任务留存 | 留存过多任务记录会增加存储与检索成本 | 首期限制留存周期与条数，支持定期清理策略 |

# 远期规划

## 阶段 1：统一可见
- 完成文件任务、备份任务接入
- 建立统一状态机、统一列表、统一操作入口
- 把“任务在哪里看”问题彻底解决

## 阶段 2：统一恢复
- 增加失败筛选、失败详情、失败重试
- 增加当前任务/历史任务分层
- 增加通知与任务结果回流能力

## 阶段 3：统一平台
- 接入同步、导入、索引、媒体处理等后台任务
- 形成系统级任务平台与任务接入规范
- 下载中心如需接入，仅显示摘要和跳转，不在任务中心内做协议级管理

# 自我检查

- [x] 是否所有旅程节点都有对应需求？
- [x] 是否有未覆盖到的异常场景？
- [x] 是否可直接开发？
- [x] 是否明确首期范围为文件任务管理、备份任务管理？
- [x] 是否明确排除专业【下载中心】功能？


软件需求规划

# NAS系统 - ZimaOS模块复用（iframe嵌入）产品需求文档

---

## 1. 文档信息

| 项目 | 内容 |
|------|------|
| 文档版本 | v1.0.0 |
| 创建日期 | 2026-03-12 |
| 最后更新 | 2026-03-12 |
| 文档状态 | 草案 |
| 负责团队 | NAS产品团队 |
| 评审人 | 待确认 |

---

## 2. 背景与目标

### 2.1 背景
在NAS系统开发过程中，经过技术评估，决定复用成熟的 **ZimaOS** 能力，通过 iframe 嵌入方式集成以下核心模块：
- 存储管理
- 同步备份
- 应用中心
- 虚拟机

### 2.2 目标
- **降低开发成本**：复用成熟模块，避免重复造轮子
- **缩短交付周期**：快速集成经过验证的功能模块
- **保证功能稳定性**：借助ZimaOS的成熟方案，降低技术风险
- **实现无缝体验**：通过iframe嵌入实现与自有系统的视觉和交互统一

### 2.3 范围界定
| 模块 | 复用方式 | 自有系统职责 |
|------|----------|--------------|
| 存储管理 | iframe嵌入ZimaOS | 入口集成、权限控制、状态同步 |
| 同步备份 | iframe嵌入ZimaOS | 入口集成、任务监控、告警对接 |
| 应用中心 | iframe嵌入ZimaOS | 入口集成、应用市场扩展、计费对接 |
| 虚拟机 | iframe嵌入ZimaOS | 入口集成、资源配额、网络配置 |

---

## 3. 术语定义

| 术语 | 定义 |
|------|------|
| ZimaOS | 第三方NAS操作系统，提供存储、应用、虚拟化等核心能力 |
| iframe嵌入 | 通过HTML iframe标签加载外部页面的技术方案 |
| 主系统 | 自有NAS系统的Web管理界面 |
| 嵌入模块 | 通过iframe加载的ZimaOS功能模块 |
| SSO | Single Sign-On，单点登录 |
| PostMessage | 跨域通信的JavaScript API |

---

## 4. 功能需求

### 4.1 通用需求（所有模块）

#### 4.1.1 嵌入框架
| 需求ID | 需求描述 | 优先级 |
|--------|----------|--------|
| EMB-001 | 提供统一的iframe容器组件，支持自适应布局 | P0 |
| EMB-002 | 支持全屏/退出全屏模式切换 | P1 |
| EMB-003 | 加载状态提示（loading、错误、超时） | P0 |
| EMB-004 | 支持面包屑导航与返回主系统 | P1 |

#### 4.1.2 跨域通信
| 需求ID | 需求描述 | 优先级 |
|--------|----------|--------|
| COM-001 | 建立PostMessage双向通信通道 | P0 |
| COM-002 | 消息格式标准化（JSON Schema） | P0 |
| COM-003 | 消息来源校验（origin白名单） | P0 |
| COM-004 | 通信超时与重试机制 | P1 |
| COM-005 | 心跳检测机制（保持连接状态） | P1 |

#### 4.1.3 单点登录（SSO）
| 需求ID | 需求描述 | 优先级 |
|--------|----------|--------|
| SSO-001 | 主系统登录后自动获取ZimaOS访问令牌 | P0 |
| SSO-002 | Token自动续期机制 | P0 |
| SSO-003 | Token失效时自动跳转重新授权 | P0 |
| SSO-004 | 支持登出同步（主系统登出→ZimaOS登出） | P1 |

#### 4.1.4 视觉统一
| 需求ID | 需求描述 | 优先级 |
|--------|----------|--------|
| UI-001 | iframe加载的页面主题色与主系统一致 | P1 |
| UI-002 | 字体、图标风格协调 | P2 |
| UI-003 | 支持暗黑/明亮模式同步 | P1 |
| UI-004 | 移动端响应式适配 | P2 |

---

### 4.2 存储管理模块

#### 4.2.1 功能范围
复用ZimaOS存储管理全部功能：
- 磁盘管理（查看、格式化、SMART检测）
- 存储池管理（创建、扩展、删除）
- 卷管理（创建、扩容、快照）
- 共享文件夹管理

#### 4.2.2 集成需求
| 需求ID | 需求描述 | 优先级 |
|--------|----------|--------|
| STM-001 | 主系统显示存储概览（容量、健康状态） | P0 |
| STM-002 | 存储告警信息同步至主系统消息中心 | P0 |
| STM-003 | 支持从主系统一键跳转至存储管理详情 | P1 |
| STM-004 | 存储配额信息实时同步至主系统仪表盘 | P1 |

#### 4.2.3 接口需求
```javascript
// 存储状态同步消息
{
  "type": "storage/status",
  "payload": {
    "pools": [...],
    "disks": [...],
    "alerts": [...]
  }
}
```

---

### 4.3 同步备份模块

#### 4.3.1 功能范围
复用ZimaOS同步备份全部功能：
- Rsync同步任务
- Cloud Sync（云存储同步）
- 快照备份与恢复
- 备份计划管理

#### 4.3.2 集成需求
| 需求ID | 需求描述 | 优先级 |
|--------|----------|--------|
| BAK-001 | 主系统显示备份任务概览列表 | P0 |
| BAK-002 | 备份任务状态变更实时通知主系统 | P0 |
| BAK-003 | 备份失败告警对接主系统消息中心 | P0 |
| BAK-004 | 支持在主系统创建/编辑备份任务 | P1 |
| BAK-005 | 备份存储用量统计同步 | P1 |

#### 4.3.3 接口需求
```javascript
// 备份任务状态变更
{
  "type": "backup/task_update",
  "payload": {
    "taskId": "xxx",
    "status": "running|completed|failed",
    "progress": 85,
    "message": "..."
  }
}
```

---

### 4.4 应用中心模块

#### 4.4.1 功能范围
复用ZimaOS应用中心全部功能：
- 应用市场浏览与安装
- 已安装应用管理
- 应用配置与更新
- 容器管理

#### 4.4.2 集成需求
| 需求ID | 需求描述 | 优先级 |
|--------|----------|--------|
| APP-001 | 主系统显示已安装应用快捷入口 | P0 |
| APP-002 | 应用状态（运行/停止/异常）实时同步 | P0 |
| APP-003 | 支持自有应用市场与ZimaOS应用市场融合展示 | P1 |
| APP-004 | 应用安装/卸载事件通知主系统 | P1 |
| APP-005 | 应用资源占用（CPU/内存/网络）数据同步 | P2 |

#### 4.4.3 接口需求
```javascript
// 应用状态同步
{
  "type": "app/status",
  "payload": {
    "apps": [
      {
        "id": "app_xxx",
        "name": "Nextcloud",
        "status": "running",
        "resources": {...}
      }
    ]
  }
}
```

---

### 4.5 虚拟机模块

#### 4.5.1 功能范围
复用ZimaOS虚拟机全部功能：
- 虚拟机创建与配置
- 虚拟机生命周期管理
- 虚拟磁盘管理
- 远程控制台（VNC/SPICE）

#### 4.5.2 集成需求
| 需求ID | 需求描述 | 优先级 |
|--------|----------|--------|
| VM-001 | 主系统显示虚拟机列表与运行状态 | P0 |
| VM-002 | 虚拟机开关机控制可在主系统执行 | P0 |
| VM-003 | 虚拟机资源占用实时监控 | P1 |
| VM-004 | 虚拟机告警（资源不足、故障）同步 | P0 |
| VM-005 | 支持从主系统快速打开虚拟机控制台 | P1 |

#### 4.5.3 接口需求
```javascript
// 虚拟机状态变更
{
  "type": "vm/status_change",
  "payload": {
    "vmId": "vm_xxx",
    "name": "Ubuntu-22.04",
    "state": "running|stopped|paused",
    "resources": {
      "cpu": {...},
      "memory": {...}
    }
  }
}
```

---

## 5. 非功能需求

### 5.1 性能需求
| 需求ID | 需求描述 | 目标值 |
|--------|----------|--------|
| PERF-001 | iframe首次加载时间 | ≤ 3秒 |
| PERF-002 | PostMessage响应延迟 | ≤ 100ms |
| PERF-003 | 状态同步频率 | ≤ 5秒 |
| PERF-004 | 内存占用增长控制 | 每iframe ≤ 50MB |

### 5.2 安全需求
| 需求ID | 需求描述 | 优先级 |
|--------|----------|--------|
| SEC-001 | iframe sandbox属性配置 | P0 |
| SEC-002 | Content-Security-Policy设置 | P0 |
| SEC-003 | 通信消息签名验证 | P1 |
| SEC-004 | Token存储安全（HttpOnly/Secure） | P0 |
| SEC-005 | 操作审计日志记录 | P1 |

### 5.3 兼容性需求
| 需求ID | 需求描述 | 优先级 |
|--------|----------|--------|
| CMP-001 | 支持Chrome/Firefox/Safari/Edge最新2个版本 | P0 |
| CMP-002 | 支持移动端浏览器访问 | P1 |
| CMP-003 | ZimaOS版本兼容（当前及前2个版本） | P0 |

### 5.4 可靠性需求
| 需求ID | 需求描述 | 优先级 |
|--------|----------|--------|
| REL-001 | iframe加载失败自动重试（3次） | P0 |
| REL-002 | ZimaOS服务不可用时优雅降级 | P0 |
| REL-003 | 通信中断自动恢复机制 | P1 |

---

## 6. 技术方案

### 6.1 架构设计

```
┌─────────────────────────────────────────────────────────────┐
│                    NAS主系统 Web UI                          │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
│  │   导航菜单   │  │  仪表盘概览  │  │    iframe容器       │  │
│  │             │  │             │  │  ┌───────────────┐  │  │
│  │ • 存储管理   │  │ • 存储状态   │  │  │  ZimaOS页面   │  │  │
│  │ • 同步备份   │  │ • 备份任务   │  │  │               │  │  │
│  │ • 应用中心   │  │ • 应用列表   │  │  │ • 存储管理    │  │  │
│  │ • 虚拟机    │  │ • 虚拟机状态  │  │  │ • 同步备份    │  │  │
│  └─────────────┘  │             │  │  │ • 应用中心    │  │  │
│                   └─────────────┘  │  │ • 虚拟机      │  │  │
│                                    │  └───────────────┘  │  │
│                                    └─────────────────────┘  │
└─────────────────────────────────────────────────────────────┘
                              │ PostMessage
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                        ZimaOS后端                            │
│              (API Gateway + 各模块服务)                       │
└─────────────────────────────────────────────────────────────┘
```

### 6.2 iframe配置规范

```html
<iframe
  id="zimaos-frame"
  src="https://zimaos.local/{module}?token={jwt}"
  sandbox="allow-scripts allow-same-origin allow-forms allow-popups"
  allow="fullscreen; clipboard-read; clipboard-write"
  referrerpolicy="strict-origin-when-cross-origin"
></iframe>
```

### 6.3 通信协议

#### 消息格式标准
```typescript
interface IFrameMessage {
  // 消息唯一标识
  id: string;
  // 消息类型
  type: string;
  // 消息来源
  source: 'nas-main' | 'zimaos';
  // 时间戳
  timestamp: number;
  // 消息体
  payload: Record<string, any>;
}
```

#### 消息类型清单
| 类型 | 方向 | 说明 |
|------|------|------|
| `auth/token` | 主→ZimaOS | 传递认证令牌 |
| `auth/refresh` | 双向 | Token刷新 |
| `nav/route` | 主→ZimaOS | 页面路由跳转 |
| `nav/close` | ZimaOS→主 | 请求关闭iframe |
| `storage/status` | ZimaOS→主 | 存储状态同步 |
| `backup/task_update` | ZimaOS→主 | 备份任务更新 |
| `app/status` | ZimaOS→主 | 应用状态同步 |
| `vm/status_change` | ZimaOS→主 | 虚拟机状态变更 |
| `theme/mode` | 双向 | 主题模式切换 |
| `system/heartbeat` | 双向 | 心跳检测 |
| `system/error` | 双向 | 错误通知 |

---

## 7. 接口清单

### 7.1 ZimaOS提供接口

| 接口 | 方法 | 说明 |
|------|------|------|
| `/api/v1/auth/sso` | POST | SSO令牌换取 |
| `/api/v1/auth/refresh` | POST | Token刷新 |
| `/api/v1/auth/verify` | GET | Token验证 |
| `/api/v1/storage/overview` | GET | 存储概览 |
| `/api/v1/backup/tasks` | GET | 备份任务列表 |
| `/api/v1/apps/installed` | GET | 已安装应用 |
| `/api/v1/vms/list` | GET | 虚拟机列表 |

### 7.2 主系统需实现接口

| 接口 | 方法 | 说明 |
|------|------|------|
| `/api/v1/zimaos/callback` | POST | ZimaOS回调通知 |
| `/api/v1/zimaos/events` | POST | 事件接收端点 |

---

## 8. 页面设计

### 8.1 嵌入页面布局

```
┌────────────────────────────────────────────────────────────┐
│  NAS Logo    首页    存储    备份    应用    虚拟机   [用户]  │  ← 主导航
├────────────────────────────────────────────────────────────┤
│                                                            │
│  ┌────────────────────────────────────────────────────┐   │
│  │  [面包屑: 首页 > 存储管理]           [全屏] [刷新]   │   │  ← 操作栏
│  ├────────────────────────────────────────────────────┤   │
│  │                                                    │   │
│  │                                                    │   │
│  │              iframe - ZimaOS 存储管理               │   │  ← 嵌入区域
│  │                                                    │   │
│  │                                                    │   │
│  │                                                    │   │
│  └────────────────────────────────────────────────────┘   │
│                                                            │
└────────────────────────────────────────────────────────────┘
```

### 8.2 交互流程

#### 场景1：从主系统进入存储管理
```
用户点击"存储管理"菜单
       │
       ▼
主系统请求SSO Token
       │
       ▼
iframe加载 ZimaOS存储管理页
       │
       ▼
建立PostMessage连接
       │
       ▼
双向状态同步启动
```

#### 场景2：存储告警通知
```
ZimaOS检测到磁盘故障
       │
       ▼
PostMessage发送告警
       │
       ▼
主系统接收并在消息中心显示
       │
       ▼
主系统仪表盘状态更新
```

---

## 9. 验收标准

### 9.1 功能验收

| 验收项 | 验收标准 |
|--------|----------|
| iframe加载 | 4个模块均能正常加载，无跨域错误 |
| SSO登录 | 主系统登录后无需再次登录即可访问ZimaOS功能 |
| 状态同步 | 存储/备份/应用/虚拟机状态5秒内同步到主系统 |
| 主题同步 | 主系统切换主题后，iframe内页面同步切换 |
| 错误处理 | ZimaOS服务异常时显示友好提示，不影响主系统 |

### 9.2 性能验收

| 验收项 | 验收标准 |
|--------|----------|
| 首屏加载 | 各模块首屏加载时间 ≤ 3秒 |
| 内存占用 | 单个iframe内存增长 ≤ 50MB |
| 通信延迟 | PostMessage往返延迟 ≤ 100ms |

### 9.3 安全验收

| 验收项 | 验收标准 |
|--------|----------|
| 跨域安全 | 仅允许指定origin访问，其他来源拒绝 |
| Token安全 | Token通过安全通道传递，支持自动过期 |
| XSS防护 | iframe sandbox配置正确，无XSS漏洞 |

---

## 10. 风险与应对

| 风险 | 影响 | 应对措施 |
|------|------|----------|
| ZimaOS API变更 | 高 | 约定API版本兼容策略，建立变更通知机制 |
| 跨域问题 | 中 | 提前验证CORS配置，准备fallback方案 |
| 性能瓶颈 | 中 | 实施懒加载，优化通信频率 |
| 用户体验割裂 | 中 | 加强视觉统一，减少iframe感知 |
| 安全漏洞 | 高 | 严格sandbox配置，定期安全审计 |

---

## 11. 里程碑规划

| 阶段 | 时间 | 交付物 |
|------|------|--------|
| Phase 1 | 第1-2周 | 基础框架（iframe容器、PostMessage通信、SSO） |
| Phase 2 | 第3-4周 | 存储管理模块集成 |
| Phase 3 | 第5-6周 | 同步备份模块集成 |
| Phase 4 | 第7-8周 | 应用中心模块集成 |
| Phase 5 | 第9-10周 | 虚拟机模块集成 |
| Phase 6 | 第11-12周 | 整体测试、优化、上线 |

---

## 12. 附录

### 12.1 ZimaOS API文档引用
- [ZimaOS API Documentation](https://docs.zimaos.com/api)
- [ZimaOS Embedding Guide](https://docs.zimaos.com/embedding)

### 12.2 参考实现
```javascript
// iframe加载管理器示例
class ZimaOSEmbedManager {
  constructor(containerId, baseUrl) {
    this.container = document.getElementById(containerId);
    this.baseUrl = baseUrl;
    this.frame = null;
    this.messageHandlers = new Map();
  }

  async load(module, token) {
    const url = `${this.baseUrl}/${module}?token=${token}`;
    this.frame = document.createElement('iframe');
    this.frame.src = url;
    this.frame.sandbox = 'allow-scripts allow-same-origin allow-forms';
    this.container.appendChild(this.frame);
    this._setupMessageListener();
  }

  _setupMessageListener() {
    window.addEventListener('message', (event) => {
      if (event.origin !== this.baseUrl) return;
      const { type, payload } = event.data;
      this._handleMessage(type, payload);
    });
  }
}
```

### 12.3 变更记录

| 版本 | 日期 | 变更内容 | 作者 |
|------|------|----------|------|
| v1.0.0 | 2026-03-12 | 初始版本 | - |

---

**文档结束**
