核心用法
Immich API Bridge 是面向自托管 Immich 照片管理系统的 REST API 封装技能，允许通过命令行或脚本与私有 Immich 实例交互。核心功能覆盖八大场景：照片与资产管理、相册创建与维护、批量上传下载、用户管理、智能搜索、外部库同步以及后台任务调度。
配置方式灵活，支持环境变量（IMMICH_URL、IMMICH_API_KEY）和 CLI 参数两种模式。认证采用简单的 Header Token 机制，通过 x-api-key 传递。内置脚本库（upload_photos.py、download_album.py、sync_library.py）可处理批量操作，降低直接使用 curl 的复杂度。
显著优点
1. 完全私有：数据存储于自托管服务器，规避公有云隐私风险
2. 功能完整：覆盖 Immich 官方 API 的全部核心端点，包括缩略图生成、人脸识别、元数据索引等高级特性
3. 自动化友好：支持批量上传、增量同步、定时任务，适合 NAS 或家庭服务器场景
4. 零前端依赖：纯命令行操作，便于集成至 CI/CD 或家庭自动化工作流
潜在局限
- 自托管门槛：需自行部署 Immich 服务，对服务器配置、反向代理、SSL 证书有一定要求
- 无图形界面：非技术用户可能需要学习曲线
- API 兼容性：Immich 版本迭代较快，存在接口变更风险
- 错误处理：curl 示例未展示重试、断点续传等健壮性机制
适合人群
- 拥有 NAS 或私有服务器的家庭用户
- 注重数据主权、希望替代 Google Photos/iCloud 的隐私敏感用户
- 需要将照片管理集成至自动化流程的开发者/运维人员
常规风险
- 密钥泄露：API Key 以明文存储于环境变量，多用户系统需加强权限管控
- 未加密传输：若未配置 HTTPS，存在中间人攻击风险
- 版本锁定：建议锁定 Immich 版本并测试后再升级，避免 API 不兼容