trailsnap-cli

通过 trailsnap CLI 与 TrailSnap 后端交互，查询照片、相册、标签等信息。

通过命令行与 TrailSnap 后端交互，按条件查询照片列表、相册、标签、位置和人物（人脸）信息，方便快速检索照片元数据或做排查。首次使用需要配置 API 地址和 Token，常见操作（列表、详情、按标签过滤）都已封装，适合脚本化或自动化地处理大量照片数据。

# TrailSnap CLI 技能

此技能允许使用 `trailsnap`工具 与 TrailSnap 后端 API 进行交互。

## 功能
1. 根据指定条件（可选过滤参数）查询照片列表。
2. 查询分类标签、相册、位置和人物（面部）信息。
3. 查询某张照片的详细信息。

## 安装

使用以下命令检查是否安装了 `trailsnap` 工具，如果没有安装则可以参考[install.md](install.md)文档进行安装。

```bash
trailsnap -v
```

## 初始配置

首次使用该工具时，需要配置 API 地址和 Token。你可以使用以下命令来判断是否需要配置 API 地址和 Token：

```bash
trailsnap photos list --limit 1
```

如果你收到错误信息，说明你需要配置 API 地址和 Token。可以询问用户这两个信息，然后通过以下命令进行配置：
```bash
trailsnap config set --url <API_BASE_URL> --token <YOUR_API_TOKEN>
```

## 使用方法

使用前可以通过 `trailsnap <command> -h` 或 `trailsnap <command> <subcommand> -h` 查看每个命令的详细帮助信息。通常情况下，你需要先根据用户的问题逐步筛选出检索条件（一个简单的[示例](examples/simple.md)），然后查询符合条件的照片列表。

- `locations timeline` 命令能够