Photoprism项目新增相册下载配置功能解析

Photoprism作为一款开源的图片管理工具，近日在其最新版本中新增了相册下载配置功能，这一改进让用户能够更灵活地控制相册内容的下载行为。本文将深入解析这一新功能的技术实现和使用方法。

功能概述

相册下载配置功能允许用户通过修改settings.yml配置文件来自定义相册下载的多个参数。这一功能与现有的文件下载配置类似，但专门针对相册下载场景进行了优化。

配置参数详解

在settings.yml文件中，新增的Albums配置段包含以下可调参数：

1. Order配置：控制不同类型相册的排序方式

   • Album：相册排序（oldest/newest）
   • Folder：文件夹排序（added）
   • Moment：时刻排序（oldest/newest）
   • State：状态排序（newest）
   • Month：月份排序（oldest/newest）

2. Download配置：控制下载行为

   • Name：文件名格式（file/original/share）
   • Disabled：是否禁用下载功能
   • Originals：是否包含原始文件
   • MediaRaw：是否包含RAW媒体文件
   • MediaSidecar：是否包含媒体附属文件

技术实现原理

在底层实现上，Photoprism通过修改内部api/download_album.go文件中的逻辑，将原本硬编码的共享文件名生成方式改为可配置的。系统现在会根据settings.yml中的Name参数值，决定使用file.ShareBase()、file.OriginalBase()还是其他文件名生成方式。

使用建议

对于需要批量下载相册内容的用户，特别是那些使用自定义命名规则（如yymmdd-eventname-0001.jpg格式）的专业用户，建议将Name参数设置为"file"或"original"，以保持文件名的一致性。

未来展望

虽然目前这一功能需要通过手动编辑配置文件来使用，但开发团队表示将在后续版本中为其添加图形界面支持。此外，团队也在考虑改进ZIP压缩包的命名规则，使其更加用户友好。

这一功能的加入显著提升了Photoprism在专业摄影工作流中的实用性，特别是对于需要频繁分享原始素材的摄影师和团队来说，能够更好地控制输出文件的命名和组织方式。