旅行照片地图 Vlog 生成器

这是什么

travel-vlog 是一个专为 Claude Code 设计的技能（Skill），它能把一组旅行照片自动制作成竖屏地图 Vlog。你只需提供带有 GPS 信息的原图照片，它就会读取照片的 EXIF 数据，自动识别拍摄地点和时间，规划出一条真实可行的路线，然后生成一个 Q 版卡通形象，沿着地图路线行走，每到一站就停下来“咔嚓”拍照，并弹出照片，同时累计里程，最后以照片墙收尾。

整个视频配有原创的欢快 BGM 和音效，弹照片的动作精准踩在拍点上，视觉效果生动有趣。

适合谁

旅行博主：希望快速将旅行照片转化为有创意的 Vlog 内容，提升视频的趣味性和独特性。
视频创作者：想要尝试新颖的地图动画风格，但不想手动逐帧制作。
Claude Code 用户：熟悉命令行操作，愿意配置本地环境，希望通过 AI 辅助自动化视频制作。

能做什么

自动识别机位：读取照片 EXIF 中的 GPS 和拍摄时间，自动排序，将邻近照片合并为站点，并通过高德逆地理编码获取景点名称。
生成卡通形象：使用本人照片通过 AI 图像接口（如 LabNana 的 gpt-image-2 或 Gemini）生成走路和拍照两个姿势，自动抠图成白边贴纸；如果没有 API Key，也可以使用内置小人，并自定义发色和衣服颜色。
路线动画：卡通小人沿高德真实步行或驾车路线行走，转向时自动翻面，身后扬起尘土，左上角显示站点信息，右上角里程滚动。
原创配乐：程序合成原创 BGM（尤克里里扫弦、钟琴、贝斯、拍手沙锤），无版权问题，也可替换为自己的歌曲，音轨响度归一化到 -16 LUFS。
自动质检：渲染时抽帧检查文字和照片是否出画或互相遮挡，并输出文字结论。

使用前准备

安装 uv 和 ffmpeg。
获取高德地图 Web 服务 API Key（AMAP_KEY），用于路线规划和地图瓦片。
（可选）获取 LabNana API Key，用于生成卡通形象。
准备带有 GPS 信息的原图照片（注意：聊天中粘贴、截图或微信传输的照片通常没有 GPS）。

安装方法

在终端中执行以下命令克隆仓库到 Claude Code 的 skills 目录：

git clone https://github.com/SpaceZephyr/travel-vlog ~/.claude/skills/travel-vlog
uv run --with playwright playwright install chromium     # 首次
export AMAP_KEY=你的高德Web服务key                         # 或写进 ~/.config/map-motion/amap_key
# 可选：AI 形象
echo "LABNANA_API_KEY=…" > ~/.claude/skills/travel-vlog/.labnana.env

使用示例

在 Claude Code 中直接说“把这些旅行照片做成 vlog”即可触发该技能。也可以手动运行脚本：

V=~/.claude/skills/travel-vlog/scripts/vlog.sh
cd ~/Documents/travel-vlog/西湖
$V plan src/*.jpg -o vlog.json --title "西湖散步"      # 照片 → 机位 → spec
$V avatar --photo 我.jpg -o avatar                    # 或 --builtin / --describe "短发、黄色卫衣"
$V check vlog.json                                    # 抽帧 + 自动质检
$V make vlog.json 西湖散步.mp4                         # 成片 + GIF

风险与注意事项

隐私问题：使用本人照片生成卡通形象时，照片会发送给第三方 AI 服务（LabNana），请务必征得本人同意；成片包含人像时，公开传播需注意隐私。
数据准确性：里程数据来自高德路线规划，并非实际 GPS 轨迹，可能略有偏差。
边界数据：中国边界使用阿里云 DataV GeoAtlas（含南海诸岛与九段线），请勿删改，遵守相关数据使用条款。
依赖环境：需要本地安装 uv、ffmpeg 和 Chromium，首次运行会下载浏览器，请确保网络畅通。