Stream App 帮助
Stream app 是什么？
Stream 是一款为 NAS 用户设计的个人照片管理工具。它只是一个管理端，不会存储你的照片数据，因此使用 Stream 不会对原始数据产生影响。你可以随时停止使用 Stream 而不会丢失任何数据。
支持哪些媒体源？
目前支持以下媒体源：
| 媒体源 | 已测试版本 |
|---|---|
| Immich | v1.118.2 |
| Photoprism | Build 240915-e1280b2fb |
| 本地相册 | iOS 18 |
| WebDAV | — |
| S3 | — |
| FTP | — |
WebDAV、S3、FTP 属于基于文件系统的媒体源。这类媒体源产生的用户标记数据（包括管理操作和相册数据）仅存储在 App 内，建议开启 iCloud 同步或手动备份以防丢失。
由于资源有限，我们仅能测试有限的版本。如遇到媒体源支持问题，请在 App 设置页面发起反馈
支持哪些操作？
目前支持收藏（Favorite）、存档（Archive）、恢复（Restore）、私密（Private）、取消私密（Unprivate）、删除（Delete）、审核通过（Approve）。下表列出了这些操作在不同类型媒体源中的对应关系：
| Stream | Photoprism | Immich | 本地相册 |
|---|---|---|---|
| Favorite | Favorite | Favorite | Favorite |
| Archive / Restore | Archive / Restore | Archive / Unarchive | (不支持*)1 |
| Private / Unprivate | Private / Unprivate | (不支持*)1 | Hide |
| Delete | Delete 2 | Delete 2 | Delete |
| Approve | Approve 3 | (不支持) | (不支持) |
如何同时管理多个媒体源？
Stream 会将不同媒体源中相同的照片合并展示。当你对合并后的照片执行私密、存档、删除等操作时，实际上是在原始媒体源上进行批量操作。
照片是如何合并的？
默认情况下，Stream 根据文件名、拍摄时间、文件分辨率等基础信息进行简单的规则匹配合并。你也可以启用哈希功能以提高合并准确性。不过要注意，启用哈希功能会增加合并操作的时间并消耗更多电量。
什么是用户标记数据？
用户标记数据代表您与照片的互动，包括收藏、归档、私密标记，以及相册数据。
关于标记数据的要点：
- 与照片分开存储
- 一旦丢失无法恢复
- 在系统之间迁移时，您需要同时拥有照片和标记数据
大多数照片应用将这些数据锁定在其平台内。Stream认为这些数据属于您，应该能够轻松迁移和管理。
Stream如何处理用户标记数据？
不同的媒体源具有不同的功能（本地照片不能归档，Immich不支持私密标记），但Stream通过内部管理这些不受支持的功能来填补这些空缺。
相册功能
Immich、Photoprism、本地相册三种媒体源支持相册同步，具体包括：
- 远端 → 本地：自动拉取远端相册列表及成员，在 App 内统一展示
- 本地 → 远端：将 App 内的相册及成员推送到指定媒体源
- 按名称匹配：相册以名称为唯一标识跨媒体源合并（大小写不敏感），本地与远端均按名称匹配
仅在 App 内新建相册，或手动同步单个相册到远端时，才会在远端自动创建相册；其他操作若远端无同名相册则跳过。
WebDAV、S3、FTP 媒体源不支持远端相册同步，但你仍可在 App 内创建和管理相册，数据通过 CloudKit 同步到其他设备。
- iCloud 同步目前支持单个相册最多 5000 张照片。
- 如果本地数据与 iCloud 备份不一致，可尝试关闭后重新打开 iCloud 同步按钮，这会触发一次全量同步。
tvOS 限制
受系统限制，tvOS 暂不支持：
- WebDAV / S3 / FTP 媒体源
- 搜索
- 批量工具
如何使用向量搜索？
指南
- 在设置中启用
向量搜索。请注意，这需要启用缩略图自动下载，并且可能会消耗更多电池电量。 - 下载两个AI模型：
图像编码器和文本编码器。 - 一旦模型准备好了，点击
运行任务开始创建索引。 - 每次应用冷启动后，索引器会在几秒钟后自动运行。
搜索技巧
向量搜索功能通过比较图像内容的相似性进行匹配。确保尽可能输入与图像内容相关的描述。
例如：
- 如果你正在寻找一本书的封面，你可能会输入
蓝色封面的书 - 如果你正在寻找一种特定类型的狗，你的描述可能是
毛茸茸的金毛狗
记住，你的输入越详细准确，你的搜索结果就会越好。
搜索索引部分重置搜索索引。模型对比
| 模型 | 索引速度（照片/分钟） | 模型大小 (MB) | 支持的语言 |
|---|---|---|---|
| clip | ~5300 | ~280 | 英语 |
| mobileClipS0 | ~6500 | ~100 | 英语 |
| uform | ~1200 | ~180 | 阿拉伯语、亚美尼亚语、中文、英语、法语、德语、希伯来语、印地语、印尼语、意大利语、日语、韩语、波斯语、波兰语、葡萄牙语、俄语、西班牙语、泰语、土耳其语、乌克兰语、越南语（共21种语言） |
- AI模型的准确性各异，请尝试和比较以选择最适合您的
- 索引速度是在 iPhone 15 上测试的，使用了本地缩略图缓存，不包括下载时间
- 详细比较数据请参见 uform3-image-text-multilingual-base