fnOS 首页自定义快捷链接功能需求文档
版本：v1.1.19
提交日期：2026-02-11
需求状态：需求评审阶段
1. 需求背景 (Background)
当前 fnOS 首页作为用户进入系统的第一触点，仅展示系统默认模块（文件管理、应用中心、系统设置等）。随着用户深度使用，系统内沉淀了大量高频访问目标：
- Docker 应用：用户部署的 5-15 个容器化服务（如 Plex、Home Assistant、qBittorrent）
- 常用文件夹：工作目录、影视库、下载文件夹等
- 外部链接：NAS 管理后台、路由器管理页、外部网盘等
用户当前需通过「应用中心 → Docker → 选择容器 → 点击访问」或「文件管理 → 逐级目录进入」的多步路径才能到达目标，操作路径冗长，效率低下。因此需要在首页提供个性化快捷入口，让用户自主定义高频访问目标。
2. 目标 (Objectives)
- 缩短访问路径：将高频目标的访问步骤从平均 3-4 步降至 1 步（点击直达）
- 提升首页价值：将首页从「功能导航页」升级为「个人工作驾驶舱」
- 增强用户粘性：通过个性化配置提升用户对系统的归属感和依赖度
- 保持系统轻量：不增加后台复杂度，前端配置层实现，不影响核心系统性能
3. 用户画像 (User Personas)
| 用户类型 |
特征描述 |
典型场景 |
核心诉求 |
| 家庭媒体管理员(Home Media Admin) |
30-45岁，NAS 家庭用户，部署了 Plex/Jellyfin 等媒体服务 |
每天多次进入媒体库或播放管理页 |
直达媒体服务，无需先开 Docker 列表 |
| 开发/运维人员(DevOps User) |
技术背景，运行多个开发环境容器和数据库 |
频繁访问 Portainer、数据库管理面板、代码仓库 |
自定义图标区分不同服务，支持外部 URL |
| 多项目管理者(Multi-project User) |
小型工作室或自由职业者，NAS 存放多个客户项目 |
需要在不同项目文件夹间快速切换 |
拖拽排序，文件夹直达，图标自定义 |
| 非技术家庭成员(Family Member) |
其他家庭成员，技术能力有限 |
只需访问相册、影视、音乐等特定应用 |
管理员预设快捷方式，零学习成本使用 |
4. 功能范围 (Scope)
4.1 In Scope（本期实现）
- 目标类型支持：
- Docker 应用（自动识别已部署容器）
- 本地文件夹（支持共享文件夹、子目录）
- 外部 URL（任意 HTTP/HTTPS 链接，支持新开标签页/当前页）
- 交互配置：
- 首页空白处右键或「编辑模式」添加快捷方式
- 拖拽排序（Drag & Drop）
- 自定义名称、图标（支持 Emoji 或上传 SVG/PNG）
- 分组/文件夹归类（可选，如「媒体」「工作」「系统」）
- 视觉展示：
- 网格/列表双视图切换
- 图标尺寸调节（大/中/小）
- 悬停显示完整名称（解决长文本截断）
4.2 Out of Scope（后续版本）
- 动态小组件（如显示 Docker 状态、文件夹容量）
- 基于使用频率的智能推荐
- 快捷方式的多端同步（手机端/桌面端分离配置）
5. 验收标准 (Acceptance Criteria)
6. 风险与约束 (Risks)
- 性能风险：大量外部 URL 预览（如抓取 favicon）可能拖慢首页加载 → 对策：懒加载图标，使用本地缓存
- 安全风险：外部链接可能存在钓鱼风险 → 对策：外部链接添加前提示确认，新开标签页时显示安全提示条
- 误操作风险：误删快捷方式 → 对策：删除二次确认，支持「最近删除」恢复（7天内）
2026-2-11 21:59:17
