LaLaWatch
AWOL智能相册产品需求文档-优化版
编辑
2026-08-19
undefined
00

目录

1. 文档信息
1.1 更新日志
1.2 名词解释
1.3 适用范围
2. 需求概述
2.1 产品背景
2.2 产品目标与价值
3. 竞品分析
3.1 竞品概况
3.2 功能覆盖对比
图库功能
相册功能
智能聚类
4. 功能清单
4.1 照片浏览
4.2 智能分类
4.3 查看与播放
4.4 内容操作
4.5 工具
4.6 搜索
4.7 设置
4.8 优先级定义
5. 技术架构
5.1 服务端设计
5.1.1 Immich移植
5.1.2 用户与权限设计
5.2 支持的文件格式
5.2.1 基础图片格式
5.2.2 RAW格式（相机原始文件）
5.2.3 特殊格式
5.2.4 视频格式
5.3 图库数量限制
6. WEB/PC端功能设计 (V0.1)
6.1 整体说明
6.2 导航菜单适配
6.3 搜索功能设计
6.3.1 AI智能搜索
6.3.2 普通搜索
6.3.3 搜索结果
6.3.4 空态页
6.3.5 历史记录
6.4 全局功能
6.4.1 快捷添加
6.4.2 主题切换
6.4.3 相册通知
6.4.4 相册设置
6.5 照片相关功能
6.5.1 照片模块
6.5.2 文件夹模块
6.5.3 地图模块
6.5.4 最近添加
6.6 图库相关功能
6.6.1 我的收藏
6.6.2 相册
6.6.3 人物
6.6.4 地点
6.6.5 标签
6.6.6 类型
6.6.7 智能分类
7. 移动端设计 (V0.1)
7.1 整体说明
7.2 核心功能
8. 非功能需求
8.1 性能需求
8.2 安全需求
8.3 兼容性需求
9. 附录
9.1 原型链接
9.2 参考文档

1. 文档信息

1.1 更新日志

时间版本号变更人主要变更内容
2025/10/3V1.0欧阳鹏昊文档新建

1.2 名词解释

术语/缩略词说明
EXIF可交换图像文件格式，包含照片拍摄参数、地理位置等元数据
AI智能搜索基于CLIP模型的以文搜图功能
OCR光学字符识别，用于识别图片中的文字内容
NAS网络附加存储，提供数据存储和访问服务
RAW相机原始图像文件，未经压缩处理

1.3 适用范围

  • NAS OS 内部产品、设计、研发、测试人员
  • OS 合作伙伴

2. 需求概述

2.1 产品背景

AWOL智能相册是基于开源Immich相册进行深度定制开发的NAS相册应用，旨在为ZIMAOS用户提供专业、智能的照片管理解决方案。产品定位为NAS直连竞品，满足用户照片备份、整理、智能分类和分享的核心需求。

2.2 产品目标与价值

维度描述
核心目标提供稳定、高效的照片存储与管理平台，支持海量照片的智能组织与检索
用户价值简化照片管理流程，通过AI能力实现自动分类、智能搜索，提升用户查找照片效率
技术价值基于Immich成熟架构，结合NAS本地AI能力，实现隐私优先的本地智能处理

3. 竞品分析

3.1 竞品概况

竞品目标用户核心优势主要不足借鉴点
绿联相册喜欢拍照收藏的NAS用户用户量大，功能成熟-宝宝相册、条件相册、自定义学习、照片收集
极相册喜欢拍照收藏的用户AI能力较强-智能分类、宠物品种识别
飞牛相册喜欢拍照收藏的用户界面简洁-用户体验设计
Immich技术用户、隐私敏感用户开源、功能全面、持续更新界面不够本土化技术架构、功能完整性

3.2 功能覆盖对比

注：✅ 支持 ❌ 不支持

图库功能

功能点绿联相册极相册飞牛相册Immich
手动上传✅✅✅✅
读取关联文件夹✅✅✅✅
按时间轴查看✅✅✅✅
按文件夹展示✅✅✅✅
视图大小切换✅✅❌❌
筛选✅✅❌❌
收藏的照片❌✅✅✅
地图✅✅✅✅

相册功能

功能点绿联相册极相册飞牛相册Immich
允许自建相册✅✅✅✅
个人相册✅✅✅✅
共享相册管理✅✅✅✅
条件相册✅❌✅❌
宝宝相册✅✅✅❌
地点相册✅✅✅✅

智能聚类

功能点绿联相册极相册飞牛相册Immich
人物聚类✅✅✅✅
证件照✅❌✅❌
动物✅✅✅❌
风景❌✅✅❌
宠物品种识别❌✅❌❌

4. 功能清单

4.1 照片浏览

功能模块功能点功能描述优先级备注
照片浏览时间轴视图以时间轴视图浏览照片P0基础能力
照片浏览文件夹浏览按用户规整的文件夹维度查看照片P1-
照片浏览地图浏览以世界地图的方式查看照片，展现用户足迹P1-
照片管理照片上传将本地/NAS中的图片手动上传到相册应用P0基础能力
照片管理关联文件夹关联NAS文件夹中的图片，监测文件夹变动实时更新P0基础能力
照片管理最近添加按时间顺序，最近加入到照片库中的100张图片P1-
照片管理我的收藏汇总展示用户收藏照片P1-

4.2 智能分类

功能模块功能点功能描述优先级备注
人物人物聚类通过AI识别照片中的人脸，自动聚合成人脸相册P0-
地点地点聚合识别照片中的地理位置信息，按地级市维度聚合成相册P0-
类型媒体类型分类按图片、动图、视频将照片分类展示P1-
标签标签聚合读取照片info中的标签信息，按标签聚合P1-
智能分类AI识别聚类使用AI识别聚类，包括【猫】【狗】【证件】【动物】P0-

4.3 查看与播放

功能模块功能点功能描述优先级备注
图片查看上一张/下一张切换查看的图片P0基础能力
图片查看放大/缩小放大/缩小图片P0基础能力
图片查看实况/动态图浏览点击播放实况图P1-
视频播放播放控制播放/暂停、上一个/下一个、seek、音量调节P0基础能力
视频播放全屏全屏播放P0基础能力
视频播放倍速在0.5~2.0区间内倍速播放P0基础能力

4.4 内容操作

功能模块功能点功能描述优先级备注
选择多选/快捷键多选选择多条内容，支持Shift快捷多选P0-
分享分享功能分享照片/相册P0-
管理归档将选中的图片在照片时间轴/相册中设置为隐藏P1-
管理收藏将图片添加到收藏P1-
管理下载将图片下载到本地P1-
编辑编辑图片信息编辑图片EXIF等信息P1-
编辑OCR识别图片中的文字信息P1-
编辑设置标签为图片添加标签P1-
编辑添加到相册将图片添加到个人相册P0基础功能
编辑删除删除该图片P0基础功能

4.5 工具

功能模块功能点功能描述优先级备注
共享管理共享管理管理已共享的相册、链接以及收到的共享P1-
归档管理归档管理归档隐藏的图片P1-
实用工具检查重复项检查图库中的重复内容P1-
实用工具查看大文件检索并列出图库中大于50M的图片及大于1GB的视频P1-
回收站回收站管理用户在相册应用中临时删除的图片，30天后自动清空P1-

4.6 搜索

功能模块功能点功能描述优先级备注
AI搜索以文搜图通过描述搜索对应的图片，使用CLIP模型P0-
普通搜索关键词搜索按人名、地点名、文件名、OCR识别的照片文字关键词进行搜索P0-
文本搜索文本识别搜索通过识别图片中的具体文字搜索P1-

4.7 设置

功能模块功能点功能描述优先级备注
用户账户信息显示用户头像、用户名，需接入NAS账户体系P0基础功能
设置文件夹管理设置个人图库关联的文件夹，可添加多个，自动同步P0基础功能
设置AI模型管理设置人脸、Intel CLIP、OCR模型是否启用P0AI基础能力
相册备份备份设置选择需要备份的照片文件夹、备份目的地、备份逻辑P1-

4.8 优先级定义

优先级定义
P0基石功能，无该功能则无法使用；主卖点相关的功能；硬件已规划选型，软件必须配合适配的功能
P1用户需求量大，可以提升用户体验，且大部分竞品都有但没有也不会影响用户主要场景使用的功能
P2产品评估未来可作为差异点的功能；用户痒点功能

5. 技术架构

5.1 服务端设计

5.1.1 Immich移植

移植Immich应用重新打包为可原生运行在ZIMAOS的安装包方式。基于Immich成熟的开源架构，确保功能稳定性和持续更新能力。

5.1.2 用户与权限设计

  1. 相册用户与NAS用户一致，打开相册时带入当前登录用户
  2. 每个用户都能创建自己的图库和相册，在【相册】应用中，用户的数据独立
  3. 用户登录后，自动检索用户目录/photos下的图片，用户在相册中上传的图片也将保存在该目录
  4. 用户可以以自己的方式将自己的相册共享给系统中的其他用户，也可接受其他用户共享的相册
  5. 用户在相册中操作删除照片后会临时删除到相册回收站中，此时实际文件未被删除，回收站中的图片清理后才真实删除

5.2 支持的文件格式

5.2.1 基础图片格式

格式扩展名说明
JPEG.jpg, .jpeg最常用的照片格式
PNG.png支持透明度的无损格式
GIF.gif动图和静态图
WebP.webpGoogle开发的现代格式
HEIF/HEIC.heic, .heif苹果设备常用，高效压缩

5.2.2 RAW格式（相机原始文件）

品牌主要格式其他格式
Canon.cr2, .cr3.crw
Nikon.nef, .nrw.raw
Sony.arw, .sr2.srf, .srw
Fujifilm.raf-
Olympus.orf-
Panasonic.rw2, .raw-
Leica.rwl, .raw-
Pentax.pef, .ptx.raw
Sigma.x3f-
Hasselblad.3fr-
Phase One.iiq-
DNG（通用）.dngAdobe数字负片格式

5.2.3 特殊格式

格式扩展名说明
TIFF.tif, .tiff高质量无损格式
BMP.bmpWindows位图
ICO.ico图标格式
SVG.svg矢量图形（需要配置）
PPM/PGM/PBM.ppm, .pgm, .pbm无损位图格式

5.2.4 视频格式

  • MP4 (.mp4, .m4v)
  • MOV (.mov) - 苹果设备常用
  • AVI (.avi)
  • WebM (.webm)
  • MKV (.mkv)
  • WMV (.wmv)
  • 3GP (.3gp)
  • QuickTime (.qt)
  • FLV (.flv)

5.3 图库数量限制

限制项说明
照片数量单用户可上传照片数量最大限制为10万张，超出提示：相册照片数量已达上限，请删除部分照片
相册数量单个用户可创建的相册数量约束为1万个，超出提示：创建的相册数量已达上限，请删除部分相册

6. WEB/PC端功能设计 (V0.1)

6.1 整体说明

相册WEB V0.1版本将基于开源Immich相册进行改造适配，保持核心功能稳定的同时，针对ZIMAOS用户需求进行定制化优化。

6.2 导航菜单适配

AWOL相册Immich对应备注
照片照片-
文件夹文件夹-
地图地图-
最近添加-新增，最近3个月加入的照片
我的收藏收藏夹-
相册相册导航栏不做相册折叠
人物人物-
地点探索-地点复用探索模块中的地点
标签标签-
类型-新增，按图片、动图、视频分类
智能分类-新增，包含证件、动物等
共享管理共享整合共享链接管理
检查重复项实用工具-检查重复项-
查看大文件实用工具-查看大文件-
归档归档-
回收站回收站-
-锁定文件夹无需该功能
-存储空间无需该功能
-服务器状态无需该功能

6.3 搜索功能设计

6.3.1 AI智能搜索

  • 功能：使用CLIP模型，以文搜图（描述场景来搜索图片）
  • 默认开启，提示文案：请描述你想搜索的图片，如：海边夕阳
  • 支持语言：英文、中文、德语、法语、意大利语、西班牙语
  • 输入限制：最长字符数50字符，超长提示"请精简您的内容，控制在50字符内"

6.3.2 普通搜索

  • 功能：按人名、地点名、文件名、OCR识别的照片文字关键词进行搜索
  • 触发方式：关闭【智能搜索】后切换到该模式
  • 输入提示语：请输入照片人名、地点、文件名、照片内文字进行搜索

6.3.3 搜索结果

  • 提供搜索结果页展示结果
  • 搜索词保留在输入框中
  • 结果按匹配度由大到小排列
  • 搜索结果提示：已根据相关性将搜索结果列出
  • 结果展示最大数量：保持和Immich逻辑

6.3.4 空态页

页面提示：无搜索结果，尝试使用同义词或更通用的关键词

6.3.5 历史记录

  • 按时间由近到远列出最近搜索的关键词
  • 最大记录最新的5条
  • 端侧记录，相册页面关闭重新打开后清除
  • 用户手动输入关键词后收起下拉
  • 选择关键词后填入信息进行搜索

6.4 全局功能

6.4.1 快捷添加

  • 点击【添加】按钮呼出菜单，包含"上传照片""创建相册"
  • 点击"上传照片"呼出PC文件选择器，限定格式与Immich保持一致
  • 点击"创建相册"进入相册创建页

6.4.2 主题切换

  • 点击切换相册页面深色/浅色模式
  • 默认【浅色】模式

6.4.3 相册通知

Immich相册自带【通知】功能，但是通知内容未做用户可读性处理，后续规划将相册通知接入到OS系统通知中，故移除Immich相册自带的【通知功能】。

6.4.4 相册设置

配置关联的文件夹：

  • 文件夹图标、文件夹路径、可用空间、照片数量、视频数量
  • 默认关联的文件夹展示"默认"标签
  • 用户使用系统账号登录后，系统自动关联"用户目录/用户名/Photos"至相册
  • 如登录时系统无该目录，将自动生成，并赋权至对应用户
  • 关联后立即自动执行扫描任务

添加关联的文件夹：

  • 点击拉起【文件夹选择器】，使用ZIMA OS现有的单选文件夹选择器
  • 可选文件夹范围根据用户权限列出
  • 只允许选择文件夹
  • 当前仅支持单选（V0.1）

移除关联的文件夹：

  • 点击【移除】按钮可操作移除已添加到图库的文件夹
  • 移除需二次确认：此操作仅将文件夹从应用中移除，内容文件将不会受到影响
  • 默认添加的Photos文件夹不可被移除

扫描文件夹：

  • 单个扫描：点击文件夹旁的【扫描】按钮可发起扫描
    • 需要展示扫描状态：图片扫描中、已扫描文件数/文件总数
    • 扫描中，可操作停止扫描
    • 扫描任务按【增量扫描】执行
  • 全部扫描：点击右上角【扫描全部】发起，所有文件夹进入扫描中状态

AI模型管理：

  • 智能搜索模型任务：连接至Intel CLIP模型，提供识别全部和识别缺失功能
  • 人脸检测/识别：连接至【人脸模型】，功能和逻辑与Immich保持一致
  • 文本识别：连接至【OCR模型】，功能和逻辑与Immich保持一致
  • 重复项检测：连接至【Intel CLIP模型】，功能和逻辑与Immich保持一致

6.5 照片相关功能

6.5.1 照片模块

【照片】模块基于Immich【照片】做裁剪，主要改动点：

改动点说明
【上传】替换为【添加】按钮全局功能中提供了上传图片
去掉选择状态下的【全选】按钮Immich全选功能在图片过多的情况下有性能问题
去掉CTRL+A快捷全选功能性能优化
去掉【移动到锁定文件夹】功能我方相册应用去掉了【锁定文件夹】功能

6.5.2 文件夹模块

【文件夹】模块相较于Immich需要将功能区嵌入到内容区中，其他功能和交互与Immich【文件夹】完全一致。

6.5.3 地图模块

【地图】功能交互与Immich【地图】完全一致。

6.5.4 最近添加

按最近加入到图库的时间顺序以时间轴的方式列出最近3个月的照片，其他逻辑与【照片】模块一致。

6.6 图库相关功能

6.6.1 我的收藏

根据Immich【收藏夹】模块改造，去掉选择状态下的【全选】按钮以及CTRL+A快捷全选功能。

6.6.2 相册

相册列表： V0.1版本与Immich保持一致

相册内容页改动点：

改动点说明
排序功能提出到右上角可切换按拍摄时间排序，排序项有【最新的优先】【最旧的优先】，默认最新的优先
共享用户添加一直在内容页展示，当前用户默认展示在该处
去掉【更多】中的【选项】排序、添加用户已提到外面，评论、点赞功能不需要

6.6.3 人物

与Immich【人物】模块保持一致。

6.6.4 地点

V0.1版本复用Immich中的【探索-地点】模块。

6.6.5 标签

复用Immich【标签】功能。

6.6.6 类型

类型分组Immich无该功能，需自行构建。按图片、动图、视频分类聚合展示。

6.6.7 智能分类

V0.1版本AI智能分类包括：

  • 证件
  • 动物（猫、狗等）

7. 移动端设计 (V0.1)

7.1 整体说明

移动端V0.1版本基于Immich App + WebView混合方案，在保持核心体验的同时，快速实现NAS相册的移动端访问能力。

7.2 核心功能

功能模块说明
照片浏览时间轴浏览、文件夹浏览、地图浏览
相册管理个人相册、共享相册、人物相册、地点相册
照片上传手机照片备份到NAS相册
搜索AI智能搜索、普通关键词搜索
设置文件夹管理、AI模型管理、备份设置

8. 非功能需求

8.1 性能需求

指标要求
页面加载首屏加载时间 < 3秒，图片缩略图懒加载
图片加载缩略图生成时间 < 1秒，大图渐进式加载
搜索响应普通搜索 < 2秒，AI搜索 < 5秒
并发支持支持10个用户同时访问，单用户1000张/分钟上传

8.2 安全需求

  • 用户数据隔离：每个用户只能访问自己的照片和共享给自己的相册
  • 传输加密：所有数据传输使用HTTPS加密
  • 本地AI处理：人脸识别、OCR等AI功能在本地执行，不上传云端
  • 敏感内容：支持敏感图片模糊处理

8.3 兼容性需求

  • 浏览器：Chrome 90+、Firefox 88+、Safari 14+、Edge 90+
  • 移动端：iOS 14+、Android 10+
  • 响应式：支持1920x1080、1366x768、768x1024等常见分辨率

9. 附录

9.1 原型链接

9.2 参考文档

本文作者:oyph

本文链接:

版权声明:本博客所有文章除特别声明外，均采用 BY-NC-SA 许可协议。转载请注明出处！