用途：Immich 为自托管照片与视频管理服务，本技能用于在用户提到 Immich、想浏览照片库、搜索照片、查找某次旅行或某日期范围的图片、列出相册等场景下，直接通过其 REST API（挂在 /api 路径下）与之交互。
主要能力：可调用健康检查、版本查询、服务器信息与统计、当前用户信息、按元数据搜索资产、获取单个资产、列出相册、获取相册内资产等接口。完整 API 参考为 OpenAPI 文档 https://api.immich.app/；搜索接口 /api/search/metadata 的请求体支持完整的 Immich 搜索过滤器，如相册、人物、类型、日期范围等。
使用方式：先读取生成的插件配置，迁移期回退到 ~/.lab/.env： set -a source "${XDG_CONFIG_HOME:-$HOME/.config}/lab-immich/config.env" 2>/dev/null || source ~/.lab/.env set +a IMMICH_URL="${IMMICH_URL:-http://100.120.242.29:2283}" 认证方式为每个请求带 x-api-key: <key> 请求头，不要回显密钥。IMMICH_API_KEY 为必填；若 IMMICH_URL 未设置，本 homelab 的直接后端为 http://100.120.242.29:2283，公开路由为 https://immich.tootie.tv 与 https://photos.tootie.tv。
配置会经插件 userConfig 写入 ${XDG_CONFIG_HOME:-~/.config}/lab-immich/config.env（权限 600），~/.lab/.env 仍作为回退。可用如下命令验证连通性： curl -sS -H "x-api-key: $IMMICH_API_KEY" "$IMMICH_URL/api/server/ping" -w '\nHTTP %{http_code}\n'
限制：不要用于询问其他 homelab 服务，应改用对应服务的技能；如需批量上传或同步照片，应使用官方 immich CLI，而非临时 curl。其它细节资料暂未提供。