45 lines
2.7 KiB
Markdown
45 lines
2.7 KiB
Markdown
# 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.
|
||
|
||
|
||
## 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 仅作为只读照片来源，
|
||
不出现在可保存目的地标签栏，不显示尚未实现的上传入口。
|