travel-vlog

# 旅行 vlog travel-vlog 一组旅行照片 + 一张本人照片 → 30–90 秒竖屏手账风 vlog： | 段落 | 画面 | 声音 | |---|---|---| | 开场 | 地球俯冲到第一个机位，落点出标题和日期 | BGM 尤克里里前奏 | | 全程预览 | 拉远看所有机位，标题「今天去哪了 · N 个机位」 | | | 每一站 | 卡通小人沿真实路线走（一颠一颠、左右晃、身后扬尘、转向自动翻面），左上「A → B」，右上里程滚动 | 每半拍一声脚步 | | 到站 | 小人落地小跳 →（叮）→ 换举相机姿势，「咔嚓!」+ 星芒闪光 → 照片啵地弹出：地名 +「第 N 站 · 已走 X km」 | 叮、快门、啵，都在拍点上 | | 片尾 | 拉回全程，照片一张张掉进照片墙，「N 个机位 · 共走 X km」，小人举相机摇摆 | 每张一声啵，最后叮 | 渲染引擎是 map-motion（`trip` 镜头的 vlog 模式 + `wall` 片尾 + `audio.py` 配乐音效）。本 skill 管流程：照片 → 机位 → 形象 → 检查 → 出片。 ## 准备 - map-motion 引擎（同一仓库根目录 `scripts/`）、uv、ffmpeg、高德 key（路线规划、地名）。 - 形象生成：LabNana 图像接口的 key（`LABNANA_API_KEY` 环境变量，或 `travel-vlog/.labnana.env`，或沿用 person-image-studio 的 `.labnana.env`）。没有 key / 积分不足就用内置小人。 - `V=~/.claude/skills/travel-vlog/scripts/vlog.sh` ## 流程 ### 1. 收照片，建项目 ```sh mkdir -p ~/Documents/map-motion/<项目名>/src && cp 照片… ~/Documents/map-motion/<项目名>/src/ ``` **要原图**：聊天里粘贴的、截图、微信传过的照片没有 GPS。iPhone：照片 App → 选中 → 分享 →「选项」打开「位置」，或「导出未修改的原件」（HEIC 也能用）。 ### 2. 照片 → 机位 → spec ```sh cd ~/Documents/map-motion/<项目名> && $V plan src/* -o vlog.json --title "西湖散步" ``` - 按拍摄时间排序；相距 < 120 m（`--merge`）的照片算同一个机位（每站最多 2 张） - 每个机位用高德逆地理取最近的景点名（打印出来，**逐行核对**，名字不对直接改 spec 里的 `name`，`photos` 的键要跟着改） - 直线合计 < 12 km 用步行路线，否则驾车（`--mode` 指定） - 照片统一转成 `photos/01_1.jpg`…（长边 1600） - 没 GPS 的照片会列出来：问用户在哪拍的，手写进 `stops`（`{"name", "at": "地名"}` 或坐标） ### 3. 卡通形象 ```sh $V avatar --photo 本人.jpg -o avatar # AI 按本人照片生成：走路 + 拍照两个姿势，抠成白边贴纸 $V avatar --describe "短发、圆框眼镜、黄色卫衣" -o avatar # 不传照片，只按文字 $V avatar --builtin "hair=#333,top=#ff8fb1,pants=#5b7bd5" -o avatar # 内置小人，零成本 ``` - **传人像前告诉用户：照片会发给外部 AI 图像服务（LabNana，gpt-image-2）**。用户没同意就用 `--describe` 或 `--builtin`。 - 生成后读 `avatar/preview.png` 看一眼：两个姿势是不是同一个人、朝右、没被裁、白边干净。不行就重跑（每次约 4 积分）或换 `--model gemini-3-pro-image`。 - 也可以用用户自己的卡通图：透明背景 PNG、人物朝右，命名 `walk.png` / `snap.png` 放进 `avatar/`（只有一张就两个都用它）。 ### 4. 检查（必做） ```sh $V check vlog.json ``` 每一站「咔嚓」那一刻、照片弹出后、走到一半，以及片尾各抽一帧，**自动质检**（出画、文字互压、文字压照片），出拼图。 - 「质检：通过」→ 只为看整体观感读一次拼图 - 有问题按时刻改：地名太长就改短；照片挡住小人可以接受（照片只停 2 秒左右） ### 5. 出片（后台） ```sh $V make vlog.json 名字.mp4 # 同时出 名字.gif；2D 渲染快：60 秒片子约 3–5 分钟 ``` BGM 和音效自动合成进音轨（原创，无版权问题）。 ### 6. 交付 说清：文件位置、时长、几个机位、总里程（高德步行/驾车路线距离，不是 GPS 轨迹）；哪些机位是推测/手填的；形象是 AI 生成还是内置；BGM 是程序合成的原创曲。 ## spec 里能改的 | 位置 | 字段 | 说明 | |---|---|---| | 顶层 | `style` | 缺省 `amap-journal`（高德街道底图 + 纸纹 + 手写字）；也可 `amap`、`amap-sepia`、`satellite` | | 顶层 | `music` | `{"bpm": 120, "seed": 1}` 合成 BGM（换 `seed` 换旋律和和弦走向，bpm 100–132 都欢快）；`{"file": "歌.mp3", "bpm": 118}` 用自己的歌（有 bpm 才踩拍点）；`"volume"` 音量 | | trip | `stops` / `photos` | 机位和每站照片（`{"image", "caption"}`，caption 缺省是地名） | | trip | `avatar` | `{"walk": "avatar/walk.png", "snap": "avatar/snap.png"}`；去掉就退回普通圆点 | | trip | `mode` | `walking` / `driving` / `bicycling` | | trip | `stay` | 每站停留秒数（缺省 3.4，按拍子取整） | | trip | `drive` | 每段走路的秒数（缺省按距离 2.6+1.6√km，最长 7 秒） | | trip | `overview` | 先拉远看全程（机位 > 2 时缺省开） | | wall | `text` / `sub` | 片尾大字（缺省「N 个机位 · 共走 X km」）和小字 | ## 踩过的坑 - 粘贴/微信传过的照片没 GPS → plan 会列出来，问用户。 - 高德地理编码对景点常解析到市中心（「杭州平湖秋月」→ 浙江省杭州市）：plan 用的是逆地理（坐标 → 名字），不受影响；手填地名时核对打印的解析结果。 - 手账矢量样式（`journal`）只能推到 8 级，城市步行要街道级 → vlog 用 `amap-journal`（瓦片）。 - LabNana 返回 `26004 Insufficient credits` ＝积分不足：让用户充值，或先用 `--builtin`。 - 照片有人像时提醒用户这是要公开发布的内容；别把用户照片和形象提交进公开仓库。