2026-10-10 09:38:27 +08:00
|
|
|
|
# Photo sources and shared connections
|
|
|
|
|
|
|
|
|
|
|
|
Each photo source has a unique ID and independently persisted directory/URL,
|
|
|
|
|
|
orientation, caption, quality, duplicate and person-selection settings. Jobs refer
|
|
|
|
|
|
to the source ID. Updating one source does not change another source.
|
|
|
|
|
|
|
|
|
|
|
|
Local sources read folders under the configured NAS mount. Ordinary file reads
|
|
|
|
|
|
and local Synology thumbnails do not require a Photos login. Person filtering
|
|
|
|
|
|
uses the shared Synology Photos session, intersected with that source's folder
|
|
|
|
|
|
catalog. Shared/personal space and person IDs are saved separately per source.
|
|
|
|
|
|
|
|
|
|
|
|
The current service supports one NAS Photos endpoint and one active account.
|
|
|
|
|
|
Signing in with another account or disconnecting affects every people-filtered
|
|
|
|
|
|
source. Personal-space person IDs may differ between accounts: recheck each
|
|
|
|
|
|
source after an account switch. Multiple independent NAS/account connections
|
|
|
|
|
|
are not supported. Do not interpret multiple folder sources as multiple logins.
|
|
|
|
|
|
|
|
|
|
|
|
WebDAV credentials and native drive credentials belong to their respective
|
|
|
|
|
|
sources and do not use the shared NAS Photos login. Explicitly reusing a WebDAV
|
|
|
|
|
|
credential variable shares that credential, but does not share filter settings.
|
|
|
|
|
|
|
|
|
|
|
|
The UI labels the top card **Shared connection**, displays source IDs and paths
|
|
|
|
|
|
on each source card, and explains each source's connection dependency. Shared
|
|
|
|
|
|
session disconnect is available only in the shared connection card and asks for
|
|
|
|
|
|
confirmation of its impact on all people-filtered sources.
|
2026-10-16 18:58:01 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Gallery destination labels / 图库目的地标签
|
|
|
|
|
|
|
|
|
|
|
|
图库标签描述可保存图片的具体目的地，照片来源连接不自动成为图库目的地。
|
|
|
|
|
|
当前为 `KoKonna 云端图库` 与 `<FRAME_FLOW_STORAGE_NAME> 本地图库`；
|
|
|
|
|
|
NAS 名称通过部署配置设置，空值回退为 NAS，不使用容器 ID 代替 NAS 名称。
|
|
|
|
|
|
英文使用同一实例名称与 cloud gallery / Local gallery。
|
|
|
|
|
|
|
|
|
|
|
|
`GET /api/v1/settings` 的 `gallery_destinations` 提供目的地 ID、适配器、
|
|
|
|
|
|
实例/服务商名称、存储类型、连接状态和保存能力。只有连接有效、明确支持上传且
|
|
|
|
|
|
前端存在对应适配器的目的地才进入标签栏。能力默认关闭；全局写入保护仍单独生效，
|
|
|
|
|
|
目的地的保存能力不等于当前用户获准写入。
|
|
|
|
|
|
|
|
|
|
|
|
后续网盘接入须先实现其读取/保存适配器、校验授权及能力，再注册目的地。
|
|
|
|
|
|
命名规则为“服务商／实例名称 + 云端图库”，例如已实现保存能力后才可展示
|
|
|
|
|
|
“百度网盘·家庭 云端图库”。多个账号/实例必须能从名称区分。
|
|
|
|
|
|
目前 Google Drive、阿里云盘、百度网盘和 WebDAV 仅作为只读照片来源，
|
|
|
|
|
|
不出现在可保存目的地标签栏，不显示尚未实现的上传入口。
|
