Stream App 使用說明
Stream 是什麼？
Stream 是一款專為 NAS 用戶設計的個人相片管理工具。它只是一個管理介面，不會儲存您的相片資料，因此使用 Stream 不會影響您的原始資料。您可以隨時停止使用 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 合併並顯示來自不同媒體來源的相片。當您對合併後的相片執行 Private、Archive 或 Delete 等操作時，實際上是對原始媒體來源執行批次操作。
相片如何合併？
預設情況下，Stream 根據檔案名稱、拍攝時間和檔案解析度等基本資訊，使用簡單規則匹配來合併相片。您也可以啟用雜湊值比對以提高合併準確度。但請注意，啟用雜湊值比對會增加合併操作的時間和電量消耗。
什麼是用戶標記數據？User Marks Data
用戶標記數據代表您與相片的互動，例如收藏、封存、私密標記以及相簿資料。
標記數據的重點：
- 與相片分開儲存
- 遺失後無法恢復
- 在系統間遷移時，您需要同時擁有相片和標記數據
大多數相片 App 將此資料鎖定在其平台內。Stream 認為這些資料屬於您，應該可以輕鬆遷移和管理。
Stream 如何處理用戶標記數據？
媒體來源有不同的功能（本機相片無法封存，Immich 不支援私密），但 Stream 透過在內部管理這些不支援的功能來填補這些空缺。
相簿
Immich、Photoprism 和本機相片支援相簿同步，包括：
- 遠端 → 本地：自動從遠端來源拉取相簿清單和成員
- 本地 → 遠端：將相簿和成員推送至選定的媒體來源
- 依名稱比對：相簿以名稱為唯一識別跨來源合併（不區分大小寫），本地與遠端皆以名稱比對
僅在 App 內新建相簿，或手動同步單一相簿至遠端時，才會於遠端自動建立相簿；其他操作若遠端無同名相簿則略過。
WebDAV、S3 和 FTP 來源不支援遠端相簿同步，但您仍可在 App 內建立和管理相簿——資料透過 CloudKit 同步至其他裝置。
- iCloud 同步目前支援單一相簿最多 5000 張照片。
- 若本機資料與 iCloud 備份不一致，可嘗試先關閉再重新開啟 iCloud 同步，這會觸發一次完整同步。
tvOS 限制
受系統限制，tvOS 暫不支援：
- WebDAV / S3 / FTP 媒體來源
- 搜尋
- 批次工具
如何使用向量搜尋？
使用指南
- 在設定中啟用「向量搜尋」。注意，這需要啟用「縮圖自動下載」，且可能消耗更多電量。
- 下載兩個 AI 模型：
image encoder和text encoder。 - 模型準備好後，點擊「執行任務」開始建立索引。
- 每次 App 冷啟動時，索引器會在幾秒後自動執行。
搜尋技巧
向量搜尋功能根據圖片內容的相似性進行匹配。請確保輸入與圖片內容盡可能相關的描述。
例如：
- 如果您在搜尋書籍封面，可以輸入
book with a blue cover - 如果您在尋找特定品種的狗，描述可以是
fluffy golden retriever
請記住，輸入越詳細準確，搜尋結果越好。
模型比較
| 模型 | 索引速度（張/分鐘） | 大小（MB） | 支援語言 |
|---|---|---|---|
| clip | ~5300 | ~280 | 英文 |
| mobileClipS0 | ~6500 | ~100 | 英文 |
| uform | ~1200 | ~180 | 阿拉伯文、亞美尼亞文、中文、英文、法文、德文、希伯來文、印地文、印尼文、義大利文、日文、韓文、波斯文、波蘭文、葡萄牙文、俄文、西班牙文、泰文、土耳其文、烏克蘭文、越南文（共 21 種語言） |
- AI 模型準確度因情況而異，請試用並比較以選擇最適合您的模型
- 索引速度在 iPhone 15 上使用本地縮圖快取測試，不含下載時間
- 詳細比較資料，請參閱 uform3-image-text-multilingual-base