# NAS一键备份功能产品需求文档

## 1. 产品概述

### 1.1 产品背景

WOL NAS设备配置有【一键拷贝】物理按键，用户在NAS机身连接USB可移动存储设备或SD卡后，可通过该物理按键，按照用户预设的规则，一键将文件拷贝至NAS设定的目录中。

### 1.2 产品目标

- 提供简单、快速的本地数据备份解决方案
- 降低用户数据备份的操作门槛
- 支持多种存储设备和文件类型的灵活备份
- 通过物理按键和LED指示灯提供直观的操作反馈

### 1.3 目标用户

- 家庭用户：需要备份手机、相机照片视频的普通用户
- 小型办公用户：需要快速备份工作文件的用户
- 摄影爱好者：需要备份大量照片和视频素材的用户

## 2. 功能需求

### 2.1 总开关控制

**功能描述：**
提供一键备份功能的总开关，用户可选择启用或关闭该功能。

**需求细节：**
- 开关类型： toggle switch
- 默认状态：开启
- 关闭后：物理按键失效，插入存储设备不会触发任何操作
- 配置位置：NAS管理后台 > 存储管理 > 一键备份设置

### 2.2 文件类型筛选

**功能描述：**
允许用户选择需要备份的文件类型，过滤不需要的文件。

**需求细节：**
- 可选项：
  - 所有文件（默认）
  - 图片文件（jpg, jpeg, png, gif, raw, cr2, nef等）
  - 视频文件（mp4, mov, avi, mkv, mts, m2ts等）
  - 音乐文件（mp3, flac, wav, aac, m4a等）
  - 文档文件（pdf, doc, docx, xls, xlsx, ppt, pptx, txt等）
- 支持多选，当选择"所有文件"时自动取消其他选项
- 文件类型识别：基于文件扩展名识别

### 2.3 备份源选择

**功能描述：**
设置默认的备份接口，确定从哪个存储设备读取文件。

**需求细节：**
- 可选项：
  - 最后插入的USB设备（默认）
  - SD卡接口
  - 前面板USB接口
  - 后面板USB接口1
  - 后面板USB接口2
- 规则说明：
  - "最后插入的USB设备"：优先使用最近插入的USB存储设备
  - 指定接口：只从选定的物理接口读取数据
- 多设备处理：当多个设备同时插入时，按优先级选择

### 2.4 存储目的地设置

**功能描述：**
设置备份文件在NAS中的存储位置。

**需求细节：**
- 默认路径：`/volume1/USBcopy`
- 用户可自定义选择NAS中的任意文件夹
- 存储结构：
  - 在目标文件夹中按任务创建时间新建子文件夹
  - 命名格式：`YYYYMMDD_HHMMSS`（例如：20251028_145322）
  - 完整路径示例：`/volume1/USBcopy/20251028_145322/`
- 权限设置：自动继承父文件夹权限，支持后续手动调整

### 2.5 物理按键功能

**功能描述：**
NAS机身上的物理按键触发备份操作。

**需求细节：**
- 按键位置：NAS机身前面板
- 按键类型：轻触式按键
- 操作方式：短按（< 2秒）触发备份
- 防误触：连续按压需间隔3秒以上
- 状态联动：按键功能与系统设置实时同步

## 3. 用户交互流程

### 3.1 备份任务流程

```
用户插入移动存储设备 → 系统检测设备 → 判断任务就绪状态 → 指示灯状态更新 →
用户按下拷贝键 → 系统执行备份 → 指示灯状态更新 → 备份完成 → 指示灯状态更新
```

**流程说明：**

1. **设备插入阶段**
   - 用户将USB设备或SD卡插入NAS指定接口
   - 系统识别存储设备并读取基本信息
   - 验证设备格式（支持FAT32, exFAT, NTFS, ext4等常见格式）

2. **任务就绪判断**
   - 检查设备是否识别成功
   - 检查是否有正在进行的备份任务
   - 检查存储空间是否充足
   - 验证用户配置规则是否匹配

3. **按键触发阶段**
   - 用户在指示灯提示就绪后按下物理按键
   - 系统再次验证任务状态
   - 开始执行文件拷贝操作

4. **备份执行阶段**
   - 按照文件类型筛选规则扫描源设备
   - 在目标位置创建时间戳文件夹
   - 执行文件复制操作
   - 实时更新备份进度（通过指示灯闪烁频率）

5. **任务完成阶段**
   - 所有文件复制完成
   - 执行数据完整性校验（可选）
   - 更新指示灯状态
   - 记录备份日志

### 3.2 指示灯状态说明

| 状态 | 颜色 | 模式 | 含义 |
|------|------|------|------|
| 状态1 | - | 熄灭 | 未检测到存储设备 |
| 状态2 | 绿色 | 常亮 | 拷贝就绪，可以开始备份 |
| 状态3 | 绿色 | 闪烁 | 拷贝进行中，闪烁频率表示活动状态 |
| 状态4 | 白色 | 常亮 | 拷贝完成，任务成功结束 |

**指示灯技术要求：**
- LED类型：双色LED（绿色/白色）
- 闪烁频率：正常状态1Hz，高速传输时2Hz
- 亮度：支持夜间模式自动调暗

## 4. 技术需求

### 4.1 性能指标

- **设备识别时间**：≤ 5秒（从插入到指示灯亮起）
- **备份启动时间**：≤ 2秒（从按键到开始复制）
- **文件传输速度**：≥ 80% 接口理论带宽
- **任务完成响应**：≤ 1秒（复制完成到指示灯状态更新）

### 4.2 兼容性要求

- **存储设备**：支持USB 2.0/3.0/3.1/3.2，SD/SDHC/SDXC
- **文件系统**：FAT16, FAT32, exFAT, NTFS, ext2/3/4, HFS+
- **文件大小**：支持单个文件最大16TB
- **文件数量**：单次任务支持最多100万个文件

### 4.3 可靠性要求

- **数据完整性**：支持复制后校验（可选）
- **错误处理**：网络中断、设备移除等异常情况处理
- **日志记录**：记录每次备份任务的详细信息
- **断电保护**：异常断电后任务状态恢复

### 4.4 资源占用

- **CPU占用**：备份任务期间≤ 30%
- **内存占用**：≤ 500MB
- **磁盘I/O**：支持后台运行，不影响其他服务

## 5. 界面设计需求

### 5.1 管理后台界面

**配置页面结构：**
```
一键备份设置
├── 功能开关（toggle）
├── 文件类型选择（多选框组）
├── 备份源选择（下拉菜单）
├── 存储目的地（路径选择器）
└── 高级设置（折叠面板）
    ├── 复制后校验（checkbox）
    ├── 自动删除源文件（checkbox）
    └── 备份完成后弹出设备（checkbox）
```

### 5.2 状态显示

- **设备状态**：显示当前连接的存储设备信息
- **任务进度**：Web界面实时显示备份进度
- **历史记录**：提供最近备份任务的历史记录查询
- **存储统计**：显示备份数据量、文件数量统计

### 5.3 通知提醒

- **任务开始**：可选择发送系统通知
- **任务完成**：发送完成通知，包含备份摘要
- **错误提醒**：设备移除、空间不足等异常提醒
- **指示灯说明**：界面提供指示灯状态说明

## 6. 安全需求

### 6.1 数据安全

- **权限控制**：备份文件继承NAS文件夹权限
- **加密传输**：支持加密存储设备的数据读取
- **病毒扫描**：可选的病毒扫描集成
- **隐私保护**：敏感文件类型识别和提醒

### 6.2 系统安全

- **输入验证**：验证存储设备格式和文件类型
- **资源限制**：限制单次任务的最大文件数量
- **访问控制**：管理后台需身份验证
- **日志审计**：记录所有配置变更和操作

## 7. 测试需求

### 7.1 功能测试

- [ ] 开关功能验证
- [ ] 文件类型筛选准确性
- [ ] 备份源选择正确性
- [ ] 存储路径创建和写入
- [ ] 物理按键响应
- [ ] 指示灯状态转换

### 7.2 性能测试

- [ ] 大文件传输速度测试
- [ ] 大量小文件处理性能
- [ ] 多任务并发处理
- [ ] 长时间运行稳定性

### 7.3 兼容性测试

- [ ] 不同品牌USB设备
- [ ] 不同容量存储卡
- [ ] 不同文件系统格式
- [ ] 不同文件类型混合

### 7.4 异常测试

- [ ] 设备中途移除
- [ ] 存储空间不足
- [ ] 文件权限问题
- [ ] 网络中断（如适用）
- [ ] 断电恢复

## 8. 部署需求

### 8.1 系统要求

- **固件版本**：WOL NAS OS v3.0及以上
- **存储空间**：至少10GB可用空间
- **内存要求**：至少2GB RAM

### 8.2 升级策略

- **新设备**：默认启用该功能
- **现有设备**：通过固件升级获得功能
- **配置迁移**：升级后保留用户已有配置

## 9. 未来扩展

### 9.1 功能扩展

- 支持更多文件类型自定义
- 增加备份规则编辑器（按日期、大小筛选）
- 支持多目标备份
- 增加数据去重功能

### 9.2 智能功能

- AI识别重要文件优先备份
- 智能分类和标签
- 重复文件检测
- 备份习惯学习

## 10. 附录

### 10.1 术语表

- **WOL**：Wake On LAN，网络唤醒
- **NAS**：Network Attached Storage，网络附加存储
- **USB**：Universal Serial Bus，通用串行总线
- **SD卡**：Secure Digital Card，安全数字存储卡
- **LED**：Light Emitting Diode，发光二极管

### 10.2 参考文档

- WOL NAS硬件规格说明书
- WOL NAS OS开发文档
- USB 3.2规范
- SD卡协会规范

---

**文档变更记录**

| 版本 | 日期 | 变更内容 | 作者 |
|------|------|----------|------|
| 1.0.0 | 2026-03-05 | 初始版本 | 产品团队 |


NAS一键备份功能产品需求文档

NAS存储管理模块技术架构文档

NAS一键备份功能产品需求文档

1. 产品概述

1.1 产品背景

NAS存储管理模块技术架构文档

📋 文档信息