drolosoft/immich-photo-manager

这是什么？

核心功能

• 01基于 CLIP 的自然语言照片搜索，并支持识别图片中的文字（OCR）
• 02结合 GPS、视觉搜索和日期自动生成地理相册与主题相册
• 03利用感知哈希检测跨导入源的重复照片
• 04修复时间戳、时区偏移，并根据邻近照片推断缺失的 GPS
• 05管理人物与人脸，支持合并人物和重新分配人脸
• 06导出 PDF 相册和可交互的 HTML 图库

适用场景

• 通过 AI 助手整理规模较大的自托管 Immich 图库
• 根据 GPS 和日期一次性生成旅行或地点相册
• 从多个服务导入照片后查找并清理重复或低质量的照片
• 借助 LM Studio 中的 Gemma 等模型，在完全本地的环境中操作 Immich

快速上手

1. 1

   克隆仓库

   git clone https://github.com/drolosoft/immich-photo-manager.git
2. 2

   在克隆的目录中安装 Python 依赖

   pip3 install -r src/requirements.txt
3. 3

   从克隆的目录添加插件市场

   claude plugin marketplace add ./
4. 4

   在 Claude Code 中安装插件，然后运行 /setup-immich-photo-manager 连接你的 Immich 服务器

   claude plugin install immich-photo-manager

使用前须知

• !使用前需要一台正在运行的自托管 Immich 服务器和 API 密钥。
• !需要 Python 3.10 或更高版本。
• !助手查看的缩略图会发送给你所用的模型；使用 Claude 时这些图片会离开你的网络。

收录于专题

标签

常见问题

immich-photo-manager 是什么？

让 AI 助手通过 MCP 直接管理自托管 Immich 相册的插件与服务，支持搜索、整理、查重和修复元数据。 immich-photo-manager 是一个 MCP 服务器兼 Claude Code 插件，让 AI 助手通过 Immich 的公开 API 访问自托管的 Immich 照片服务。它提供 94 个工具，涵盖基于 CLIP 和 OCR 的自然语言搜索、按 GPS、视觉相似度和时间生成地理相册、重复照片检测、人物与人脸管理、时间戳和时区等元数据修复，以及回收站操作。

immich-photo-manager 可以免费使用吗？用的什么许可证？

immich-photo-manager 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

immich-photo-manager 还在维护吗？

活跃维护中。immich-photo-manager 最近一次提交是在 2026年11月5日。

immich-photo-manager 适合用来做什么？

通过 AI 助手整理规模较大的自托管 Immich 图库 根据 GPS 和日期一次性生成旅行或地点相册 从多个服务导入照片后查找并清理重复或低质量的照片 借助 LM Studio 中的 Gemma 等模型，在完全本地的环境中操作 Immich

immich-photo-manager 怎么安装和运行？

克隆仓库: git clone https://github.com/drolosoft/immich-photo-manager.git 在克隆的目录中安装 Python 依赖: pip3 install -r src/requirements.txt 从克隆的目录添加插件市场: claude plugin marketplace add ./ 在 Claude Code 中安装插件，然后运行 /setup-immich-photo-manager 连接你的 Immich 服务器: claude plugin install immich-photo-manager

在哪里获取 immich-photo-manager？

源代码和安装说明在 GitHub 上：https://github.com/drolosoft/immich-photo-manager