注意：如果使用的是懒猫微服里的Immich，需要先用端口转发工具转发Immich PostgreSQL的端口，然后再对应填写配置向导，只需填写IP地址，其余默认即可，见附图。 ## 功能特性 - Immich 数据库直连处理：读取 Immich PostgreSQL 中已有经纬度的照片资产，并把解析后的 `city`、`state`、`country` 写回 `asset_exif`。 - 批量反向地理编码：自动查找尚未处理的照片，按批次处理，支持延迟和并行度调节，适合大照片库逐步修正。 - Overture Maps 行政区解析：内置国家级数据，并按需下载国家级细分缓存，用于提升国家、州省和城市匹配效果。 - 机场和交通枢纽增强：内置机场基础数据，可在机场范围内优先给出更符合照片场景的位置名称。 - Lookup 试算页面：输入坐标后预览国家、行政区、城市候选和诊断信息，便于先验证再批量写库。 - City Resolver 调优：支持调整城市候选类型优先级、按国家覆盖默认规则，并在 Lookup 中验证结果。 - 可选 GADM 行政区数据：在需要时下载 GADM 国家缓存，作为 Overture 的补充或优先行政区来源。 - 数据管理与重跑：可查看已下载的地理数据缓存，删除或重新下载缓存，也可以按范围清空 Immich 中已有反向地理字段后重新处理。 - 计划任务和日志：支持自动定时处理、手动触发处理、查看运行日志和排查处理状态。 ### 首次使用流程 1. 安装时填写 Immich PostgreSQL 连接信息：`DB_HOST`、`DB_PORT`、`DB_USERNAME`、`DB_PASSWORD`、`DB_DATABASE_NAME`。 2. 打开应用地址，等待服务启动完成。 3. 先进入 Settings 页面，确认数据库连接信息是否正确，并检查自动处理计划、批次大小、处理延迟和并行度。 4. 在 Immich 中关闭内置反向地理编码，避免 Immich 和 Immich ReverseGeo 同时写同一组位置字段。 5. 先在 Immich 里确认你准备用来测试的照片满足下面的“照片要求”，否则 Dashboard 可能会显示 `nothing to process`。 6. 使用 Lookup 页面输入一组照片坐标，确认解析出的国家、州省和城市符合预期。 7. 建议先备份 Immich PostgreSQL，再从 Dashboard 手动触发一次小规模处理（可选）。 ### Immich 里照片的要求 1. 照片必须已经写入 GPS 坐标，也就是 `latitude` 和 `longitude` 不能是空值；没有坐标的照片不会进入处理队列。 2. 应用默认只会抓取 `city IS NULL` 且 `country IS NULL` 的资产；如果照片在 Immich 里已经有城市或国家值，Dashboard 不会把它算进待处理数量。 3. 如果你想重跑一张已经写过位置数据的照片，需要先到 Data 页面清空该照片的 `city`、`state`、`country`，或者按城市 / 国家范围重置后再运行。 4. 处于已删除状态的资产不会被处理。 5. 应用写回时需要拿到可用的国家和城市结果；如果某张照片只能识别到国家、但拿不到城市，当前版本会跳过写入，后续运行仍会继续重试这张照片。 6. 最适合做首轮验证的测试照片，是一张在 Immich 中能看到 GPS 坐标、且 `city`、`country` 为空的普通照片。 ### 日常使用方式 1. 在 Dashboard 查看待处理照片数量、最近处理状态和运行进度。 2. 需要验证单个坐标时，进入 Lookup 页面输入经纬度，查看 Overture、机场匹配和可选 GADM 的候选结果；当前懒猫包已预置中国 Overture 行政缓存，中国坐标通常可以直接返回结果。 3. 需要调整城市名称选择时，进入 City Resolver 页面修改全局或国家级规则，再回到 Lookup 页面复测。 4. 需要批量重算时，进入 Data 页面按资产 GUID、城市、州省、国家或全库范围清空已写入的反向地理字段，再重新运行处理。 5. 需要节省空间或刷新地理数据时，在 Geo Boundaries 页面删除指定国家的 Overture 或 GADM 缓存，下一次使用时会重新下载。 6. 定期查看 Logs 页面，确认下载缓存、数据库写入和定时任务没有异常。