系统安装与初始化 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 能力必须在界面或文档中标记实现阶段，不误导为已完整可用。