# Travel Story

从照片时间线、地点、票据与代表照片生成结构化旅行日志和个性化 HTML 页面。

- Repository: https://github.com/LC044/TrailSnap (860 stars)
- Category: Engineering
- License: AGPL-3.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add LC044/TrailSnap --skill travel-story -g -a claude-code -y`
Codex: `npx skills add LC044/TrailSnap --skill travel-story -g -a codex -y`
Cursor: `npx skills add LC044/TrailSnap --skill travel-story -g -a cursor -y`
Gemini CLI: `npx skills add LC044/TrailSnap --skill travel-story -g -a gemini-cli -y`

## Description

从照片时间线、地点、票据与代表照片生成结构化旅行日志和个性化 HTML 页面。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 旅行日志

1. 先用 `get_travel_timeline` 确认日期、地点段和票据；不确定范围时向用户确认。
2. 用 `select_representative_photos` 选 6, 12 张代表照片，再用 `get_photo_context` 获取证据。
3. 标题、摘要、章节和图注必须对应真实照片/票据信息，不臆造同行人或事件。
4. 调用 `create_artifact_draft` 保存结构化草稿。内容结构应包含 `summary`、`sections`；每个 section 包含 `heading`、`body`、`photo_ids`。
5. 使用工具返回的 artifact id 调用 `save_artifact_html_page`，生成完整 HTML 文档。若用户要求为已有作品生成或重新设计页面，先调用 `get_artifact_context`。遵循用户选择的预设或自定义风格；使用响应式布局，兼顾手机与桌面。主要正文、章节和照片必须直接预渲染在 DOM 中，不得依赖 JavaScript 生成；JavaScript 只做渐进增强。
6. HTML 中的照片必须使用 `/api/medias/{user_id}/{photo_id}/thumbnail?size=medium` 真实地址。允许动态数据时只使用 `TrailSnap.request('/api/...')`，可用路径包括 `/api/stats/timeline?years=2026`、`/api/stats/dashboard`、`/api/albums`、`/api/photos`；不得嵌入登录令牌、密码、外部追踪或占位图片。
7. 默认不开放 Server API；只有用户明确开启时才把 `server_api_access` 设为 true。告知用户结构化内容和 HTML 页面都可继续编辑，并附作品卡片。