Immich-go v0.26.0版本发布：优化上传流程与服务器交互

Immich-go是一个用于与Immich照片管理平台交互的命令行工具，它能够帮助用户批量上传、管理照片和视频。Immich是一个自托管的照片备份解决方案，旨在为用户提供类似Google Photos的体验，同时保持数据的完全控制权。

版本核心改进

最新发布的v0.26.0版本主要解决了上传过程中与Immich服务器交互的关键问题。在过去几个月里，用户在使用immich-go上传文件时经常会遇到内部服务器错误(500)，特别是在文件元数据更新与后台处理任务同时发生时。

技术实现细节

后台任务暂停机制

开发团队引入了一个创新的解决方案：在上传过程中自动暂停Immich的后台任务。这一功能通过新增的--pause-immich-jobs选项控制，默认情况下为启用状态。这种设计确保了在上传过程中服务器资源能够专注于接收文件，避免了处理冲突。

管理员API密钥支持

为了实现后台任务的暂停与恢复操作，新版本要求提供Immich管理员API密钥。用户现在需要同时提供常规用户API密钥和管理员API密钥（通过--admin-api-key选项）来完成上传操作。这种双重认证机制既保证了安全性，又实现了必要的权限控制。

性能优化措施

1. 连接超时设置：HTTP客户端增加了连接超时和keep-alive设置，提高了网络稳定性
2. 默认超时延长：将默认客户端超时时间延长至20分钟，适应大文件上传需求
3. 错误处理改进：增强了PingServer的错误消息，便于问题诊断

使用建议

对于系统管理员和高级用户，建议：

• 在上传大量媒体文件时保持默认的暂停后台任务设置
• 确保同时提供用户和管理员API密钥以获得最佳上传体验
• 监控服务器资源使用情况，特别是在处理大型媒体库时

这一版本的改进显著提升了immich-go与Immich服务器的协同工作效率，为用户提供了更稳定、更可靠的文件上传体验。开发团队特别感谢贡献者@ivaninkv对这一版本的宝贵贡献。