360 Secure SkillHub
360 安全技能中心

trailsnap-cli

该技能提供 trailsnap-cli Python 脚本,用命令行封装 TrailSnap 后端 API:按过滤条件查询照片列表,查询相册、标签、位置、人物(面部)和挂载存储文件夹,并可通过 medias 子命令获取媒体文件(base64 或下载)。首次使用需先配置 API 地址与 Token,脚本只能通过 cli.py 调用。

lc044
lc044
热度 34.53
最近更新 2026-05-11 17:45:50
分类:搜索依赖:代码执行 / 第三方 API / 读写文件应用场景:API 集成 / 数据处理

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add trailsnap-cli
Metadata
name
trailsnap-cli
description
TrailSnap CLI 命令行工具,用于查询照片、相册、标签、位置和人物等信息。当用户需要查看照片、相册数据时调用此技能。

TrailSnap CLI 技能

此技能允许使用 trailsnap-cli Python 脚本与 TrailSnap 后端 API 进行交互。

功能

  1. 根据指定条件(可选过滤参数)查询照片列表。
  2. 查询分类标签、相册、位置和人物(面部)信息。
  3. 查询挂载的存储文件夹(目录)列表。

初始配置

首次使用该工具前,需要配置 API 地址和 Token:

python {baseDir}/cli.py config set --url <API_BASE_URL> --token <YOUR_API_TOKEN>

配置信息将被保存到同目录下的 .env 文件中。

使用方法

使用前可以通过 python {baseDir}/cli.py <command> -h 或 python {baseDir}/cli.py <command> <subcommand> -h 查看每个命令的详细帮助信息。通常情况下,你需要先根据用户的问题逐步筛选出检索条件,然后查询符合条件的照片列表。如果需要访问照片的媒体文件(如 base64 编码或直接下载文件),你可以使用 medias 命令。

你只能通过cli.py脚本运行,不能直接调用API。更不能直接读取.env文件中的配置信息。

使用 Python 运行脚本:

python {baseDir}/cli.py <command> <subcommand> [options]

详细的命令参考请参考 reference.md 文件。

示例

请参考 examples/simple.md 文件。