# 文件服务与文件管理 PRD

## 1. 背景与目标

文件服务与文件管理是用户最常使用的 NAS 能力。ALLinONE OS 需要同时满足局域网共享、跨平台访问、Web 文件管理、个人空间、共享空间、网络硬盘挂载和云存储挂载。

本模块目标是提供统一的文件访问体验，让用户可以通过 Web 界面和常见协议访问个人与共享数据。

## 2. 目标用户与核心场景

| 用户类型 | 核心场景 | 关键诉求 |
|---|---|---|
| 家庭用户 | 管理照片、视频、文档和共享文件夹 | 简单易用，跨设备访问 |
| 技术爱好者 | 使用 SMB/NFS/WebDAV 等协议 | 协议完整，可配置 |
| 小型团队/SOHO | 多人共享资料和项目文件 | 权限清晰，空间隔离 |
| 云盘用户 | 挂载外部云盘和远程共享 | 统一入口管理多来源文件 |

## 3. 功能范围

### 3.1 范围内

- SMB/CIFS、NFS、FTP、SFTP、WebDAV 文件服务。
- 个人空间管理。
- 共享空间查看和访问。
- 基础文件操作：浏览、上传、下载、新建文件夹、重命名、移动、复制、删除。
- 网络硬盘挂载：SMB、NFS、WebDAV。
- 云存储挂载：OneDrive、Dropbox、Google Drive。

### 3.2 范围外

- 用户和权限模型由《用户与权限管理 PRD》定义。
- 底层存储池创建由《存储管理 PRD》定义。
- 高级协作能力、在线文档编辑、版本管理、全文搜索暂不纳入 MVP。
- 外部云盘授权细节需按各云服务 API 技术验证。

## 4. 用户流程

### 4.1 Web 文件管理

```text
登录系统 -> 进入文件管理 -> 选择个人空间或共享空间 -> 浏览目录 -> 执行上传/下载/新建/移动/删除等操作
```

### 4.2 启用文件协议

```text
管理员进入文件服务 -> 选择协议 -> 配置服务参数 -> 选择共享目录和授权用户 -> 启用服务 -> 客户端连接访问
```

### 4.3 挂载网络硬盘

```text
进入挂载管理 -> 选择 SMB/NFS/WebDAV -> 填写地址和认证信息 -> 测试连接 -> 保存挂载 -> 文件管理中展示
```

### 4.4 挂载云存储

```text
进入云存储挂载 -> 选择云服务 -> 完成授权 -> 选择挂载位置 -> 文件管理中展示云存储入口
```

## 5. 功能需求

### 5.1 文件服务协议

- 支持 SMB/CIFS，用于 Windows 和主流局域网文件共享。
- 支持 NFS，用于 Linux、Unix 和虚拟化场景。
- 支持 FTP，用于兼容传统文件传输场景。
- 支持 SFTP，基于 SSH 提供安全文件传输。
- 支持 WebDAV，用于 HTTP 文件访问和跨网络客户端。
- 管理员可以按协议启用或停用服务。
- 每个协议必须能够绑定可访问目录和授权用户或用户组。
- 协议启用状态、端口和访问地址需要在界面展示。

### 5.2 个人空间

- 每个用户拥有独立个人空间。
- 用户登录文件管理后默认进入个人空间。
- 个人空间仅用户本人、Owner 和具备授权的管理员可访问。
- 若存储池未创建，个人空间入口展示不可用原因和创建引导。

### 5.3 共享空间

- 管理员和 Owner 可以创建共享空间。
- 用户只能查看被授权的共享空间。
- 共享空间至少支持只读、读写两种访问级别。
- 文件管理界面需要明确区分个人空间和共享空间。

### 5.4 基础文件操作

- 支持浏览目录和文件列表。
- 支持上传文件和文件夹。
- 支持下载单个文件；批量下载可在 P1 支持。
- 支持新建文件夹、重命名、移动、复制、删除。
- 删除操作必须提示风险；是否进入回收站由后续策略决定，MVP 可直接删除但需二次确认。
- 操作失败时必须展示可理解的失败原因。

### 5.5 网络硬盘挂载

- 支持挂载 SMB、NFS、WebDAV 远程共享。
- 挂载配置至少包括协议、地址、路径、认证信息、显示名称。
- 保存前支持连接测试。
- 挂载成功后在文件管理中以独立入口展示。
- 挂载失败不影响本地文件空间使用。

### 5.6 云存储挂载

- 支持 OneDrive、Dropbox、Google Drive 等主流云盘挂载。
- 云盘授权过程必须提示第三方服务依赖。
- 授权成功后，云盘入口展示在文件管理中。
- 云盘挂载能力列为 P2，MVP 不强制实现。

## 6. 权限与状态规则

- 普通用户只能访问个人空间和被授权共享空间。
- 管理员可以管理共享空间和文件服务协议。
- Owner 拥有所有文件空间和服务配置的最高管理权限。
- 文件协议访问必须遵循同一套用户与共享空间权限模型。
- 网络硬盘和云存储挂载的可见性需要绑定创建者或管理员配置。

## 7. 异常与边界场景

| 场景 | 产品处理 |
|---|---|
| 未创建存储池 | 文件管理展示初始化引导 |
| 协议端口冲突 | 阻止启用并提示冲突原因 |
| 上传空间不足 | 中止上传并提示释放空间 |
| 用户无权限访问目录 | 隐藏目录或展示无权限提示 |
| 网络硬盘连接失败 | 保存前测试失败，不创建挂载 |
| 云盘授权过期 | 展示重新授权入口 |
| 文件操作中断 | 保留失败状态，避免显示为成功 |

## 8. MVP / P1 / P2 分期

| 阶段 | 范围 |
|---|---|
| MVP | Web 文件管理、个人空间、共享空间查看、SMB/NFS/WebDAV 基础服务、基础文件操作 |
| P1 | FTP/SFTP、共享空间管理、批量下载、网络硬盘挂载、文件操作体验完善 |
| P2 | OneDrive/Dropbox/Google Drive 云存储挂载、跨来源统一管理、高级分享能力 |

## 9. 验收标准

- 用户登录后可以进入个人空间并执行基础文件操作。
- 管理员可以启用至少一种文件服务协议，并通过客户端访问授权目录。
- 普通用户无法访问未授权共享空间。
- 未创建存储池时，文件管理不会假装可用，必须展示引导。
- 网络硬盘挂载流程包含连接测试。
- 云存储挂载作为 P2 能力明确标记，不影响 MVP 验收。


文件服务与文件管理 PRD

# 存储管理 PRD

## 1. 背景与目标

存储管理是 ALLinONE OS 的核心 NAS 能力。用户需要将多块硬盘组织为稳定、可理解、可维护的存储空间，并在容量、性能和安全之间做出选择。

本模块目标是支持磁盘识别、存储池创建、常见 RAID/JBOD/单盘模式、文件系统选择、存储状态监控，以及群晖数据硬盘无损迁移能力。

## 2. 目标用户与核心场景

| 用户类型 | 核心场景 | 关键诉求 |
|---|---|---|
| 家庭用户 | 建立照片、视频、资料存储空间 | 安全可靠，配置简单 |
| 技术爱好者 | 自定义 RAID 和文件系统 | 可控、透明、能看到风险 |
| 群晖迁移用户 | 将已有群晖硬盘迁移到新系统 | 尽量不丢数据，降低迁移成本 |
| 小型团队/SOHO | 构建共享资料池 | 多用户共享，状态可监控 |

## 3. 功能范围

### 3.1 范围内

- 磁盘识别与状态展示。
- 存储池创建、查看和基础管理。
- 支持单盘、JBOD、RAID 0、RAID 1、RAID 3、RAID 5、RAID 6、RAID 10。
- 支持 ext4、Btrfs、ZFS 文件系统。
- 存储容量、健康状态、阵列状态展示。
- 群晖数据硬盘无损迁移流程。

### 3.2 范围外

- 文件协议共享由《文件服务与文件管理 PRD》定义。
- 用户目录权限由《用户与权限管理 PRD》定义。
- 底层 RAID、ZFS、Btrfs 的具体实现方案需技术验证。
- 跨设备备份、快照策略、灾备策略暂不作为 MVP 强制范围。

## 4. 用户流程

### 4.1 创建存储池

```text
进入存储管理 -> 查看可用磁盘 -> 选择存储池模式 -> 选择文件系统 -> 查看容量与风险说明 -> 确认创建 -> 创建完成
```

### 4.2 查看存储状态

```text
进入存储管理 -> 查看存储池列表 -> 进入详情 -> 查看容量、磁盘、阵列、文件系统、健康状态
```

### 4.3 群晖硬盘迁移

```text
插入群晖数据硬盘 -> 系统识别迁移来源 -> 展示可迁移数据和风险 -> 用户确认 -> 转换为本系统支持格式 -> 校验并挂载
```

## 5. 功能需求

### 5.1 磁盘识别

- 系统必须展示所有已识别磁盘。
- 磁盘信息至少包括名称、容量、接口类型、序列号、健康状态、使用状态。
- 系统盘必须与数据盘明确区分。
- 已被存储池占用的磁盘不可直接用于创建新存储池。
- 疑似包含数据的磁盘在格式化或组池前必须提示风险。

### 5.2 存储池创建

- 用户可以选择一块或多块磁盘创建存储池。
- 系统必须根据磁盘数量限制可选模式。
- 单盘模式允许一块磁盘。
- JBOD 允许多块磁盘组合为一个逻辑空间，无冗余。
- RAID 0 允许条带化，提示无冗余风险。
- RAID 1 允许镜像，提示容量利用率约为 50%。
- RAID 3、RAID 5、RAID 6、RAID 10 的磁盘数量门槛必须在界面展示。
- 创建前必须展示预计可用容量、冗余能力、性能倾向和数据清除风险。

### 5.3 文件系统选择

- 支持 ext4、Btrfs、ZFS 三种文件系统选项。
- ext4 作为成熟稳定选项。
- Btrfs 标记支持快照、压缩、校验等 NAS 友好能力。
- ZFS 标记为企业级数据完整性选项，并提示资源占用和技术要求。
- 文件系统能力的实际支持程度需与底层技术实现保持一致，未实现能力不得在界面承诺。

### 5.4 存储状态

- 存储池列表展示名称、模式、文件系统、总容量、已用容量、健康状态。
- 存储池详情展示成员磁盘、阵列状态、容量使用、错误或降级提示。
- 存储池异常时，桌面系统和仪表盘需要能读取并展示告警摘要。
- MVP 阶段至少支持查看状态，不强制支持在线扩容和修复流程。

### 5.5 群晖数据迁移

- 系统应识别插入磁盘是否疑似来自 Synology/群晖。
- 迁移目标是将群晖数据硬盘转化为本系统支持的存储格式，并尽量保持数据不丢失。
- 迁移前必须展示风险说明，并建议用户先备份重要数据。
- 迁移过程必须提供进度、当前阶段和失败提示。
- 迁移完成后，用户应能在文件管理中访问迁移后的数据。
- 该能力是核心差异化卖点，但底层可行性需技术验证；PRD 中必须标记为 P1 重点能力。

## 6. 权限与状态规则

- Owner 和管理员可以创建、查看和管理存储池。
- 普通用户只能通过文件管理访问被授权的数据空间，不能管理存储池。
- 未创建存储池时，文件服务和个人空间处于不可用或待初始化状态。
- 存储池降级或异常时，不应自动隐藏数据入口，但必须展示风险状态。
- 对数据有破坏风险的操作必须二次确认。

## 7. 异常与边界场景

| 场景 | 产品处理 |
|---|---|
| 磁盘数量不足 | 禁用不满足条件的 RAID 模式并说明原因 |
| 磁盘健康异常 | 允许查看但不推荐用于新存储池 |
| 创建过程中失败 | 展示失败原因，保留日志入口 |
| 存储池降级 | 标记为异常，提示尽快处理 |
| 文件系统能力未完整支持 | 不展示未实现能力，或明确标记为待支持 |
| 群晖迁移识别失败 | 允许用户取消，不进行破坏性转换 |
| 用户误选数据盘 | 创建前二次确认并明确数据风险 |

## 8. MVP / P1 / P2 分期

| 阶段 | 范围 |
|---|---|
| MVP | 磁盘识别、单盘/JBOD/RAID 0/1/5 基础创建、ext4/Btrfs 基础支持、存储状态展示 |
| P1 | RAID 6/10、ZFS 支持、群晖数据迁移、异常告警完善 |
| P2 | RAID 3、在线扩容、修复流程、快照/压缩/校验策略、迁移体验增强 |

## 9. 验收标准

- 系统能列出所有数据磁盘并区分系统盘。
- 用户能创建至少一种可用存储池并在文件管理中使用。
- 不满足磁盘数量的 RAID 模式不可被选择。
- 创建存储池前必须展示容量、冗余和数据风险。
- Owner/管理员可管理存储，普通用户不可管理存储池。
- 群晖迁移能力有完整流程定义和技术待验证标记。


存储管理 PRD

# 桌面系统 PRD

## 1. 背景与目标

ALLinONE OS 不只是传统 NAS 管理后台，还需要提供面向不同用户习惯的首页与桌面体验。桌面系统承担系统入口、状态感知、应用启动和 HDMI 本地输出体验。

本模块目标是提供三种可切换首页模式：Windows 桌面模式、仪表盘模式、云盘模式，并支持 HDMI 接入后的本地桌面输出。

## 2. 目标用户与核心场景

| 用户类型 | 核心场景 | 关键诉求 |
|---|---|---|
| 家庭用户 | 像使用电脑一样打开文件、应用和设置 | 操作直观，学习成本低 |
| 技术爱好者 | 关注系统状态和运维控制 | 信息密度高，模块入口清晰 |
| 轻度文件用户 | 主要进行文件浏览、上传、下载和分享 | 首页即文件管理，界面简洁 |

## 3. 功能范围

### 3.1 范围内

- Windows 桌面模式：任务栏、系统托盘、桌面区域、应用图标。
- 仪表盘模式：导航任务栏、系统状态卡片。
- 云盘模式：以文件管理为中心的首页。
- 首页模式选择和切换。
- HDMI 接入后的桌面输出体验。
- 桌面应用入口：文件管理、存储管理、用户管理、路由管理、系统设置。

### 3.2 范围外

- 文件管理具体能力由《文件服务与文件管理 PRD》定义。
- 存储状态计算和告警由《存储管理 PRD》定义。
- 路由状态和网络诊断由《路由与网络管理 PRD》定义。
- 第三方应用商店和插件市场不纳入本阶段。

## 4. 用户流程

### 4.1 首次选择首页模式

```text
初始化流程 -> 选择 Windows 桌面/仪表盘/云盘模式 -> 进入对应首页 -> 后续登录默认进入该模式
```

### 4.2 切换首页模式

```text
进入系统设置 -> 打开桌面与首页设置 -> 选择新模式 -> 保存 -> 当前会话刷新或下次登录生效
```

### 4.3 HDMI 输出

```text
接入 HDMI 显示器 -> 系统识别显示输出 -> 展示登录/桌面界面 -> 用户使用键鼠完成本地操作
```

## 5. 功能需求

### 5.1 Windows 桌面模式

- 默认首页模式为 Windows 桌面模式。
- 底部固定任务栏，展示运行中的应用、常用入口和系统托盘。
- 系统托盘至少展示网络状态、存储状态、通知入口和用户菜单。
- 桌面区域支持放置应用快捷方式和文件夹入口。
- 应用图标支持单击选中、双击打开；触控或移动端访问时可使用单击打开。
- MVP 默认应用入口包括文件管理、存储管理、路由管理、用户管理、系统设置。

### 5.2 仪表盘模式

- 首页以系统状态和管理入口为核心。
- 必须展示 CPU、内存、存储、网络的摘要状态。
- 提供顶部或侧边导航，用于切换核心模块。
- 状态卡片点击后进入对应管理页面。
- 存储或网络异常时，卡片需要突出风险状态。

### 5.3 云盘模式

- 首页以文件管理为核心，默认展示用户个人空间。
- 用户可切换查看已授权共享空间。
- 支持从首页进入上传、下载、新建文件夹、分享等文件操作入口。
- 当用户没有可用存储池时，展示创建存储池引导。
- 普通用户登录时默认不展示无权限的系统管理入口。

### 5.4 模式切换

- Owner 和管理员可以设置设备默认首页模式。
- 用户可以在个人偏好中设置自己的默认首页模式；个人偏好优先于设备默认。
- 若用户无权限访问某模式中的部分模块，界面应隐藏或置灰对应入口。
- 切换模式不应影响后台服务运行状态。

### 5.5 HDMI 桌面输出

- 系统支持 HDMI 接入后输出桌面界面。
- HDMI 模式下应支持键盘和鼠标操作。
- HDMI 输出与 Web 管理界面共享同一套权限模型。
- 若未登录，HDMI 输出应展示登录界面或初始化界面。
- HDMI 输出分辨率适配策略需技术验证，MVP 至少支持常见 1080p 显示。

## 6. 权限与状态规则

- 未登录用户不可进入桌面首页。
- 普通用户可进入云盘模式和被授权的应用入口。
- 管理员可进入全部管理模块，除 Owner 专属安全操作外。
- Owner 可管理设备默认首页、用户权限和系统级设置。
- 当存储池未创建时，文件相关入口仍可展示，但必须引导创建存储池或说明不可用原因。

## 7. 异常与边界场景

| 场景 | 产品处理 |
|---|---|
| 用户选择无权限模块 | 提示无权限，并提供返回入口 |
| 系统状态数据获取失败 | 卡片展示未知状态，不阻塞首页使用 |
| HDMI 未识别显示器 | 不影响 Web 访问，系统日志记录异常 |
| 移动端访问 Windows 桌面模式 | 自动适配为触控可用布局 |
| 存储池未创建 | 云盘模式展示创建存储池引导 |
| 网络异常 | 系统托盘和仪表盘卡片展示异常状态 |

## 8. MVP / P1 / P2 分期

| 阶段 | 范围 |
|---|---|
| MVP | 三种首页模式基础框架、Windows 桌面默认首页、核心模块入口、基础状态展示 |
| P1 | 首页偏好、仪表盘状态卡片完善、云盘模式文件操作入口、移动端适配 |
| P2 | HDMI 本地桌面输出增强、小组件、桌面快捷方式自定义、多窗口体验 |

## 9. 验收标准

- 初始化时用户可以选择三种首页模式之一。
- 默认首页为 Windows 桌面模式。
- 三种模式均能进入文件、存储、用户、路由、系统设置等核心模块。
- 普通用户看不到未授权的管理入口，或访问时得到明确无权限提示。
- 仪表盘能展示 CPU、内存、存储、网络摘要。
- 云盘模式能以个人空间为主要入口。
- HDMI 接入场景有明确产品行为和技术待验证项。


桌面系统 PRD

# 系统安装与初始化 PRD

## 1. 背景与目标

ALLinONE OS 面向个人、家庭、技术爱好者和小型团队，系统首次接触体验决定用户能否顺利完成从裸机到可用 NAS/软路由/桌面的转化。

本模块目标是提供稳定、低门槛的安装与首次初始化流程，让用户可以通过 ISO 镜像完成系统部署，并在首次启动后完成管理员账号、基础网络、存储池入口、桌面模式和连接方式配置。

## 2. 目标用户与核心场景

| 用户类型 | 核心场景 | 关键诉求 |
|---|---|---|
| 家庭用户 | 首次安装家用 ALLinONE 设备 | 少配置、少术语、能快速进入系统 |
| 技术爱好者 | 自定义网口、磁盘和桌面模式 | 安装过程可控，默认值透明 |
| 小型团队/SOHO | 快速部署共享设备 | 可重复安装，便于后续批量部署 |

## 3. 功能范围

### 3.1 范围内

- ISO 镜像安装入口。
- 可视化安装：选择安装目标磁盘、配置 WAN/LAN 网口。
- 自动安装：默认安装到磁盘 1，默认 `eth0` 为 WAN，其他网口为 LAN。
- 首次启动初始化：创建设备 Owner 管理员账号、创建存储池入口、选择默认桌面模式。
- 设备连接：手动输入 IP、WebFind 局域网发现、Tailscale 远程访问入口。
- 登录方式：账号密码登录、扫码登录、保持登录状态。

### 3.2 范围外

- 具体存储池创建策略由《存储管理 PRD》定义。
- 用户角色、权限模型由《用户与权限管理 PRD》定义。
- Tailscale 底层账号绑定、网络穿透实现需技术验证，本 PRD 只定义产品流程和入口。
- 硬件兼容认证体系暂不纳入本阶段。

## 4. 用户流程

### 4.1 可视化安装流程

```text
启动安装介质 -> 选择语言/地区 -> 选择安装目标磁盘 -> 配置 WAN/LAN 网口 -> 确认风险 -> 写入系统 -> 重启进入初始化
```

### 4.2 自动安装流程

```text
启动安装介质 -> 选择自动安装 -> 展示默认安装规则 -> 用户确认 -> 自动写入系统 -> 重启进入初始化
```

### 4.3 首次初始化流程

```text
系统启动 -> 创建 Owner 账号 -> 进入存储池创建入口 -> 选择默认桌面模式 -> 展示连接方式 -> 进入系统首页
```

### 4.4 登录流程

```text
访问 Web 管理界面 -> 选择账号密码或扫码登录 -> 校验身份 -> 可选保持登录状态 -> 进入默认首页
```

## 5. 功能需求

### 5.1 ISO 安装入口

- 系统必须以 ISO 镜像形式提供安装介质。
- 安装启动页必须提供“可视化安装”和“自动安装”两个入口。
- 安装前必须提示目标磁盘会被写入系统，涉及数据清除时必须二次确认。

### 5.2 可视化安装

- 用户必须能够选择系统安装目标磁盘。
- 磁盘列表需要展示磁盘名称、容量、接口类型和当前是否可能包含数据。
- 用户必须能够配置 WAN/LAN 口分配。
- 网口列表需要展示网口名称、连接状态、速率和 MAC 地址。
- 若设备只有一个网口，系统允许该网口作为默认管理网口，并提示路由能力受限。

### 5.3 自动安装

- 自动安装默认选择第一块可安装磁盘作为系统盘。
- 自动安装默认将 `eth0` 设为 WAN，其余网口设为 LAN。
- 自动安装前必须展示默认规则和目标磁盘，用户确认后才能执行。
- 若不存在可安装磁盘或无法识别 `eth0`，自动安装必须中止并提示用户改用可视化安装。

### 5.4 首次初始化

- 首次启动必须强制创建设备 Owner 账号。
- Owner 账号至少包含用户名和密码。
- 密码必须进行强度校验，弱密码允许继续与否由安全策略决定，MVP 阶段至少需要明确提示。
- 创建 Owner 后，引导用户进入存储池创建入口；用户可跳过，但系统需提示未创建存储池会影响文件服务。
- 用户必须选择默认首页模式：Windows 桌面模式、仪表盘模式、云盘模式。
- 默认推荐 Windows 桌面模式。

### 5.5 设备连接

- 支持通过浏览器手动输入设备 IP 访问管理界面。
- 支持 WebFind 在局域网内发现 ALLinONE OS 设备。
- 设备发现结果至少展示设备名、IP、连接状态和初始化状态。
- 支持 Tailscale 远程访问入口，允许用户在初始化后绑定或稍后配置。

### 5.6 登录方式

- 支持账号密码登录。
- 支持扫码登录，扫码登录依赖移动端或可信设备能力，MVP 可作为预留入口。
- 支持“保持登录状态”。
- 保持登录状态必须允许用户在账号安全设置中主动撤销。

## 6. 权限与状态规则

- 未创建 Owner 前，系统处于“待初始化”状态，只允许访问初始化流程。
- Owner 是设备最高权限拥有者，创建后不可为空。
- 管理员和普通用户不能执行系统安装流程，只能在已安装系统内使用授权功能。
- 未登录用户只能访问登录页、设备发现响应和必要的初始化入口。
- 初始化完成后再次访问设备，应进入登录页或已选择的默认首页。

## 7. 异常与边界场景

| 场景 | 产品处理 |
|---|---|
| 未识别到磁盘 | 阻止安装，提示检查硬件连接 |
| 用户选择疑似数据盘作为系统盘 | 展示高风险提示并二次确认 |
| 网口数量不足 | 允许继续安装，但提示路由功能受限 |
| 自动安装默认规则无法应用 | 中止自动安装，引导用户使用可视化安装 |
| 初始化中断 | 下次启动继续停留在未完成步骤 |
| 忘记 Owner 密码 | MVP 阶段标记为待设计，需后续定义安全恢复流程 |
| WebFind 未发现设备 | 提供手动 IP 访问说明 |
| Tailscale 未配置 | 不影响局域网访问和本地管理 |

## 8. MVP / P1 / P2 分期

| 阶段 | 范围 |
|---|---|
| MVP | ISO 安装、可视化安装、自动安装、Owner 创建、桌面模式选择、账号密码登录、手动 IP 访问 |
| P1 | WebFind 局域网发现、Tailscale 远程访问入口、保持登录状态、安全提示完善 |
| P2 | 扫码登录、批量部署参数化、安装过程硬件兼容检测、远程访问体验优化 |

## 9. 验收标准

- 用户可以从 ISO 启动并完成可视化安装。
- 用户可以选择自动安装，并按默认规则完成部署。
- 首次启动后，未创建 Owner 前不能进入系统首页。
- 用户创建 Owner 后可以选择默认首页模式。
- 用户可以通过设备 IP 访问 Web 管理界面并登录。
- 未创建存储池时，系统能明确提示相关功能不可用。
- Tailscale、扫码登录等非 MVP 能力必须在界面或文档中标记实现阶段，不误导为已完整可用。


系统安装与初始化 PRD

# ALLinONE OS 产品规划文档

> **一句话定位**：ALLinONE OS 是一款面向个人和家庭用户的全能 NAS 操作系统，融合存储管理、路由网络、桌面办公和应用生态于一体，一台设备解决所有需求。

---

## 1. 产品概述

### 1.1 产品愿景

打造一台设备、一个系统覆盖 NAS 存储、软路由、桌面办公三大核心场景的全能操作系统，降低用户在多设备间的管理成本，实现"ALL in ONE"的极致体验。

### 1.2 目标用户

| 用户类型 | 核心需求 |
|---------|---------|
| 家庭用户 | 统一存储 + 路由 + 轻量桌面，一机搞定 |
| 技术爱好者 | 希望在一台设备上整合 NAS + OpenWrt + 桌面环境 |
| 小型团队/SOHO | 共享存储 + 多用户管理 + 远程访问 |

### 1.3 核心特性概览

| 能力域 | 关键特性 |
|-------|---------|
| 存储管理 | 组阵列、存储池、文件服务（SMB/NFS/FTP/WebDAV）、文件备份与管理 |
| 路由系统 | 网口管理、WiFi、路由管理、防火墙、DHCP |
| 应用生态 | 兼容安装 OpenWrt 插件 |
| 桌面输出 | 支持 HDMI 接入后以桌面模式输出 |

---

## 2. 技术架构

### 2.1 平台与底层

| 项目 | 选型 |
|-----|------|
| 适配平台 | **X86** |
| 底层系统 | **Debian**（待定） |
| 安装介质 | ISO 镜像文件 |

### 2.2 架构设计思路

```
┌─────────────────────────────────────────────────┐
│              ALLinONE OS 上层应用                  │
│  ┌──────────┐  ┌──────────┐  ┌───────────────┐  │
│  │ 桌面环境  │  │ 文件管理  │  │  路由管理面板  │  │
│  └──────────┘  └──────────┘  └───────────────┘  │
│  ┌──────────┐  ┌──────────┐  ┌───────────────┐  │
│  │ 存储管理  │  │ 用户鉴权  │  │  插件/扩展    │  │
│  └──────────┘  └──────────┘  └───────────────┘  │
├─────────────────────────────────────────────────┤
│              Debian 基础系统层                     │
│   内核 | 驱动 | 网络栈 | 文件系统 | 容器运行时      │
├─────────────────────────────────────────────────┤
│              X86 硬件平台                         │
│   CPU | 内存 | 磁盘阵列 | 网口 | HDMI | WiFi      │
└─────────────────────────────────────────────────┘
```

---

## 3. 系统安装

### 3.1 安装方式

提供两种安装模式，覆盖不同场景：

#### 可视化界面安装

适用于首次部署或需要自定义配置的场景：

1. **选择安装位置** — 指定系统安装的目标磁盘
2. **配置网口** — 设置 WAN/LAN 口分配及网络参数

#### 自动安装（无人值守）

适用于批量部署或快速上手场景：

| 配置项 | 默认值 |
|-------|-------|
| 安装目标 | 磁盘 1（第一块磁盘） |
| WAN 口 | eth0 |
| LAN 口 | eth0 以外的所有网口 |

---

## 4. 设备初始化与连接

### 4.1 初始化流程

系统首次启动后，引导用户完成以下初始化步骤：

```
启动 → 创建管理员账号 → 创建存储池 → 选择桌面模式 → 进入系统
```

| 步骤 | 说明 |
|-----|------|
| 创建管理员账号 | 设置设备 Owner 的用户名与密码 |
| 创建存储池 | 根据磁盘情况初始化存储池（详见存储管理章节） |
| 选择桌面模式 | 从三种桌面模式中选择默认首页 |

### 4.2 设备连接方式

| 连接方式 | 说明 |
|---------|------|
| 手动输入 IP | 直接在浏览器输入设备 IP 地址访问管理界面 |
| WebFind 局域网发现 | 自动扫描局域网内匹配的 ALLinONE OS 设备 |
| 远程访问 | 内嵌 **Tailscale**，支持异地远程访问，无需公网 IP |

### 4.3 登录方式

| 登录方式 | 说明 |
|---------|------|
| 账号密码登录 | 传统用户名 + 密码方式 |
| 扫码登录 | 移动端扫码快速登录 Web 管理界面 |
| 保持登录状态 | 支持"记住我"，减少重复登录 |

---

## 5. 桌面系统

ALLinONE OS 提供三种可切换的首页模式，满足不同用户的使用偏好。

### 5.1 Windows 桌面模式（默认）

经典 Windows 风格桌面布局：

- **任务栏** — 底部固定，显示运行中的应用与系统托盘
- **系统托盘** — 显示网络、存储、通知等状态
- **桌面区域** — 可放置应用快捷方式、文件夹、小组件
- **桌面应用图标** — 双击打开应用或管理面板

> 适合习惯传统桌面操作的用户，降低学习成本。

### 5.2 仪表盘模式

类似 Unraid / TrueNAS 的管理首页：

- **导航任务栏** — 顶部或侧边导航，快速切换功能模块
- **桌面卡片** — 以卡片形式展示系统状态（CPU、内存、存储、网络等）

> 适合偏重系统监控和运维管理的用户。

### 5.3 云盘模式

类似阿里云盘、Google Drive 的文件管理界面：

- 以文件管理为核心，专注于文件浏览、上传、下载和分享
- 简洁清爽的 UI，适合轻度使用场景

> 适合以文件存储和共享为主要需求的用户。

---

## 6. 存储管理

### 6.1 存储池模式

| 模式 | 说明 |
|-----|------|
| **单盘** | 单块硬盘独立使用，无冗余 |
| **JBOD** | 多块硬盘串联为一个大容量卷，无冗余 |
| **RAID 0** | 条带化，提升读写性能，无冗余 |
| **RAID 1** | 镜像，数据安全性高，容量利用率 50% |
| **RAID 3** | 专用奇偶校验盘，适用于大文件顺序读写 |
| **RAID 5** | 分布式奇偶校验，兼顾性能与冗余（最少 3 盘） |
| **RAID 6** | 双重奇偶校验，允许同时坏 2 块盘（最少 4 盘） |
| **RAID 10** | 镜像 + 条带，兼顾高性能与高冗余（最少 4 盘） |

### 6.2 文件系统支持

| 文件系统 | 特点 |
|---------|------|
| **ext4** | 成熟稳定，Linux 默认文件系统 |
| **Btrfs** | 支持快照、压缩、校验，适合 NAS 场景 |
| **ZFS** | 企业级数据完整性保护，支持去重、压缩、快照 |

### 6.3 数据迁移

> **亮点特性**：支持直接将群晖（Synology）数据硬盘转化为本系统支持的存储格式，**不丢失数据**。

降低用户从群晖迁移至 ALLinONE OS 的门槛，是竞品差异化的核心卖点之一。

---

## 7. 文件服务

### 7.1 支持的协议

| 协议 | 说明 |
|-----|------|
| **SMB/CIFS** | Windows 原生共享协议，局域网文件共享首选 |
| **NFS** | Unix/Linux 共享协议，适合 Linux 客户端和虚拟化场景 |
| **FTP** | 经典文件传输协议，兼容性广 |
| **SFTP** | 基于 SSH 的安全文件传输 |
| **WebDAV** | 基于 HTTP 的文件管理协议，支持跨网络访问 |

### 7.2 文件管理功能

| 功能 | 说明 |
|-----|------|
| 个人空间管理 | 每个用户拥有独立的个人文件空间 |
| 共享空间查看 | 查看和访问设备上的公共共享文件夹 |
| 挂载网络硬盘 | 支持 SMB / NFS / WebDAV 协议挂载远程共享 |
| 挂载云存储 | 支持 OneDrive / Dropbox / Google Drive 等主流云盘挂载 |

---

## 8. 用户与权限管理

### 8.1 用户体系

支持多用户体系，满足家庭和小型团队的使用场景。

### 8.2 角色权限

| 角色 | 权限说明 |
|-----|---------|
| **设备 Owner** | 设备的最高权限拥有者，可管理所有设置、用户和数据 |
| **管理员** | 拥有大部分管理权限，可管理用户和系统配置 |
| **普通用户** | 使用个人空间和被授权的共享空间 |

- 支持设置**多个管理员**，分担运维职责

### 8.3 数据隔离

- 每个用户拥有**个人目录**
- 个人目录实行**权限隔离**，仅目录所有者可见和访问
- 共享空间需由管理员或 Owner 主动授权

---

## 9. 路由管理

ALLinONE OS 内置软路由能力，可替代独立路由器/软路由设备。

### 9.1 核心功能

| 功能 | 说明 |
|-----|------|
| **网口管理** | 配置 WAN/LAN 口、VLAN、链路聚合等 |
| **DHCP** | 内置 DHCP 服务器，自动分配局域网 IP |
| **WiFi** | 支持无线网卡作为 AP 热点（需硬件支持） |
| **路由管理** | 静态路由、策略路由、端口转发等 |
| **防火墙** | 入站/出站规则、端口过滤、访问控制 |

### 9.2 网络诊断

内置网络诊断工具，支持：

- Ping / Traceroute
- DNS 查询测试
- 端口检测
- 网络连通性可视化

### 9.3 OpenWrt 插件兼容

> **亮点特性**：兼容安装 OpenWrt 插件生态，可直接使用社区丰富的路由插件（如广告过滤、科学上网、多拨等）。

---

## 10. 产品路线图（建议）

| 阶段 | 目标 | 关键里程碑 |
|-----|------|-----------|
| **P0 — MVP** | 核心 NAS + 路由 + 桌面 | 系统安装、存储管理、文件服务、基础路由、桌面模式 |
| **P1 — 体验优化** | 用户体验完善 | 群晖数据迁移、Tailscale 远程访问、扫码登录 |
| **P2 — 生态扩展** | 插件与云存储 | OpenWrt 插件兼容、云存储挂载、HDMI 桌面输出 |
| **P3 — 增长** | 社区与市场 | 社区建设、插件市场、硬件适配扩展 |

---

## 11. 竞品对标分析

| 特性 | ALLinONE OS | 群晖 DSM | TrueNAS | Unraid |
|-----|------------|---------|---------|--------|
| 存储管理 | ✅ | ✅ | ✅ | ✅ |
| 软路由 | ✅ 内置 | ❌ | ❌ | ❌ |
| OpenWrt 兼容 | ✅ | ❌ | ❌ | ❌ |
| 桌面模式 | ✅ 三种可选 | ❌ | ❌ | ❌ |
| HDMI 输出 | ✅ | ❌ | ❌ | ❌ |
| 群晖数据迁移 | ✅ 无损 | — | ❌ | ❌ |
| 远程访问 | ✅ Tailscale | QuickConnect | 需自建 | 需自建 |
| 云存储挂载 | ✅ | ✅ | ❌ | ✅ (插件) |

---

## 12. 总结

ALLinONE OS 的核心竞争力在于**"一机多用"**：

1. **NAS 存储** — 完整的存储管理、文件服务、数据备份能力
2. **软路由** — 内置路由系统 + OpenWrt 插件兼容，替代独立软路由设备
3. **桌面办公** — HDMI 桌面输出 + 三种桌面模式，兼顾管理与日常使用
4. **无缝迁移** — 支持群晖硬盘无损迁移，降低用户切换成本
5. **灵活访问** — WebFind 局域网发现 + Tailscale 远程访问，随时随地管理

> 一个系统，一台设备，ALL in ONE。

---

*文档版本：v1.0 ｜ 最后更新：2026-05-15*
