{"id":"8c1bf49a-027c-40c5-b685-723e43b46431","shortId":"VFKUJd","kind":"skill","title":"trailsnap-cli","tagline":"TrailSnap CLI 命令行工具，用于查询照片、相册、标签、位置和人物等信息。当用户需要查看照片、相册数据时调用此技能。","description":"# TrailSnap CLI 技能\n\n此技能允许使用 `trailsnap`工具 与 TrailSnap 后端 API 进行交互。\n\n## 功能\n1. 根据指定条件（可选过滤参数）查询照片列表。\n2. 查询分类标签、相册、位置和人物（面部）信息。\n3. 查询某张照片的详细信息。\n\n## 安装\n\n使用以下命令检查是否安装了 `trailsnap` 工具，如果没有安装则可以参考[install.md](install.md)文档进行安装。\n\n```bash\ntrailsnap -v\n```\n\n## 初始配置\n\n首次使用该工具时，需要配置 API 地址和 Token。你可以使用以下命令来判断是否需要配置 API 地址和 Token：\n\n```bash\ntrailsnap photos list --limit 1\n```\n\n如果你收到错误信息，说明你需要配置 API 地址和 Token。可以询问用户这两个信息，然后通过以下命令进行配置：\n```bash\ntrailsnap config set --url <API_BASE_URL> --token <YOUR_API_TOKEN>\n```\n\n## 使用方法\n\n使用前可以通过 `trailsnap <command> -h` 或 `trailsnap <command> <subcommand> -h` 查看每个命令的详细帮助信息。通常情况下，你需要先根据用户的问题逐步筛选出检索条件（一个简单的[示例](examples/simple.md)），然后查询符合条件的照片列表。\n\n- `locations timeline` 命令能够查到时间和空间上的信息，是一个很好的工具，返回一个足迹时间轴（某一段时间去了那个地方）。\n- 除非用户不需要显示照片，否则都要以合适的格式展示照片，如果需要显示某张照片，你可以使用 `medias` 命令获取其URL地址或者照片文件。\n- 在使用之前你需要阅读 [reference.md](reference.md) 文件，了解每个命令的详细参数和选项。\n- 如果需要的话，可以参考 [examples/simple.md](examples/simple.md) 文件，了解如何使用该工具。\n\n使用 Python 运行脚本：\n\n```bash\ntrailsnap <command> <subcommand> [options]\n```\n\n## 生成的 HTML 页面规范\n\n- 整体风格：极简轻复古治愈手账风，低饱和莫兰迪配色，奶白米杏主色调，柔和浅阴影、统一大圆角；\n- 布局：响应式卡片布局，时间倒序展示；\n- 单卡片结构：日期头部→相册图片区→日记正文→轻量化标签；\n- 视觉：无高饱和颜色、无复杂动效、无冗余组件，字体舒适留白充足；\n- 功能：支持单图/多图相册展示、标签分类、图片点击放大；\n- 产出要求：纯轻量化HTML，结构整洁，适配本地静态浏览，对接相册图片url地址直接预览，文案温柔生活化。","tags":["trailsnap","cli","lc044","agent","agent-skills","album","clip","photo","skill-md","skills","yolo"],"capabilities":["skill","source-lc044","skill-trailsnap-cli","topic-agent","topic-agent-skills","topic-album","topic-clip","topic-photo","topic-skill-md","topic-skills","topic-yolo"],"categories":["TrailSnap"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/LC044/TrailSnap/trailsnap-cli","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add LC044/TrailSnap","source_repo":"https://github.com/LC044/TrailSnap","install_from":"skills.sh"}},"qualityScore":"0.672","qualityRationale":"deterministic score 0.67 from registry signals: · indexed on github topic:agent-skills · 444 github stars · SKILL.md body (1,258 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:54:09.563Z","embedding":null,"createdAt":"2026-05-05T06:53:46.289Z","updatedAt":"2026-05-18T18:54:09.563Z","lastSeenAt":"2026-05-18T18:54:09.563Z","tsv":"'1':25,63 '2':29 '3':35 'api':22,51,55,66 'bash':45,58,71,117 'cli':3,5,14 'config':73 'examples/simple.md':89,110,111 'h':80,83 'html':121 'install.md':42,43 'limit':62 'list':61 'locat':91 'media':101 'option':119 'photo':60 'python':115 'reference.md':104,105 'set':74 'skill' 'skill-trailsnap-cli' 'source-lc044' 'timelin':92 'token':53,57,68,76 'topic-agent' 'topic-agent-skills' 'topic-album' 'topic-clip' 'topic-photo' 'topic-skill-md' 'topic-skills' 'topic-yolo' 'trailsnap':2,4,13,17,20,39,46,59,72,79,82,118 'trailsnap-c':1 'url':75 'v':47 '一个简单的':87 '与':19 '了解如何使用该工具':113 '了解每个命令的详细参数和选项':107 '产出要求':147 '位置和人物':32 '位置和人物等信息':10 '低饱和莫兰迪配色':125 '你可以使用':100 '你可以使用以下命令来判断是否需要配置':54 '你需要先根据用户的问题逐步筛选出检索条件':86 '使用':114 '使用以下命令检查是否安装了':38 '使用前可以通过':78 '使用方法':77 '信息':34 '初始配置':48 '功能':24,142 '单卡片结构':132 '可以参考':109 '可以询问用户这两个信息':69 '可选过滤参数':27 '后端':21 '否则都要以合适的格式展示照片':98 '命令能够查到时间和空间上的信息':93 '命令获取其url地址或者照片文件':102 '命令行工具':6 '响应式卡片布局':130 '图片点击放大':146 '在使用之前你需要阅读':103 '地址和':52,56,67 '多图相册展示':144 '奶白米杏主色调':126 '如果你收到错误信息':64 '如果没有安装则可以参考':41 '如果需要显示某张照片':99 '如果需要的话':108 '字体舒适留白充足':141 '安装':37 '对接相册图片url地址直接预览':151 '工具':18,40 '布局':129 '当用户需要查看照片':11 '或':81 '技能':15 '支持单图':143 '整体风格':123 '文件':106,112 '文案温柔生活化':152 '文档进行安装':44 '无冗余组件':140 '无复杂动效':139 '无高饱和颜色':138 '日期头部':133 '日记正文':135 '时间倒序展示':131 '是一个很好的工具':94 '极简轻复古治愈手账风':124 '某一段时间去了那个地方':96 '柔和浅阴影':127 '查看每个命令的详细帮助信息':84 '查询分类标签':30 '查询某张照片的详细信息':36 '查询照片列表':28 '标签':9 '标签分类':145 '根据指定条件':26 '此技能允许使用':16 '然后查询符合条件的照片列表':90 '然后通过以下命令进行配置':70 '生成的':120 '用于查询照片':7 '相册':8,31 '相册图片区':134 '相册数据时调用此技能':12 '示例':88 '纯轻量化html':148 '结构整洁':149 '统一大圆角':128 '视觉':137 '说明你需要配置':65 '轻量化标签':136 '运行脚本':116 '返回一个足迹时间轴':95 '进行交互':23 '适配本地静态浏览':150 '通常情况下':85 '除非用户不需要显示照片':97 '需要配置':50 '面部':33 '页面规范':122 '首次使用该工具时':49","prices":[{"id":"06739709-3de0-45e0-8547-9dc69d612cfe","listingId":"8c1bf49a-027c-40c5-b685-723e43b46431","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"LC044","category":"TrailSnap","install_from":"skills.sh"},"createdAt":"2026-05-05T06:53:46.289Z"}],"sources":[{"listingId":"8c1bf49a-027c-40c5-b685-723e43b46431","source":"github","sourceId":"LC044/TrailSnap/trailsnap-cli","sourceUrl":"https://github.com/LC044/TrailSnap/tree/master/skills/trailsnap-cli","isPrimary":false,"firstSeenAt":"2026-05-05T06:53:46.289Z","lastSeenAt":"2026-05-18T18:54:09.563Z"}],"details":{"listingId":"8c1bf49a-027c-40c5-b685-723e43b46431","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"LC044","slug":"trailsnap-cli","github":{"repo":"LC044/TrailSnap","stars":444,"topics":["agent","agent-skills","ai","album","clip","photo","skill-md","skills","yolo"],"license":"agpl-3.0","html_url":"https://github.com/LC044/TrailSnap","pushed_at":"2026-05-18T12:38:06Z","description":"TrailSnap (行影集) | AI-Powered open-source photo album for travel & life memories.（AI赋能的开源相册工具，珍藏旅行与生活点滴）","skill_md_sha":"e123a83f2d6c661e71304eac73140a00f8da5456","skill_md_path":"skills/trailsnap-cli/SKILL.md","default_branch":"master","skill_tree_url":"https://github.com/LC044/TrailSnap/tree/master/skills/trailsnap-cli"},"layout":"multi","source":"github","category":"TrailSnap","frontmatter":{"name":"trailsnap-cli","description":"TrailSnap CLI 命令行工具，用于查询照片、相册、标签、位置和人物等信息。当用户需要查看照片、相册数据时调用此技能。"},"skills_sh_url":"https://skills.sh/LC044/TrailSnap/trailsnap-cli"},"updatedAt":"2026-05-18T18:54:09.563Z"}}