Travel Vlog

Community

SpaceZephyr

travel-vlog

旅行 vlog 地图视频：用户给一组旅行照片（和一张自己的照片），自动按照片 GPS 和拍摄时间找出机位、排好顺序、沿真实步行/驾车路线连起来；用照片生成用户的 Q 版卡通形象，卡通小人沿路线一颠一颠地走，右上角里程累加，走到每个机位停下「咔嚓」拍照、照片啵地弹出（写着第几站、已走多少公里），再走向下一站，最后照片墙 + 总里程收尾；配原创欢快 BGM 和脚步、快门、啵、叮音效，弹照片踩在拍点上。手账风竖屏 MP4。用 map-motion 引擎。当用户说「旅行 vlog」「把旅行照片做成视频」「小人在地图上走」「卡通形象走路线」「打卡路线视频」「citywalk 视频」「一日游路线动画」，或丢来一组带位置的旅行照片要做成视频时使用。单张照片找机位用 photo-spot；3D 山体用 map-3d。

Overview

Publisher	SpaceZephyr
Repository	`map-motion`
Skill name	`travel-vlog`
Stars	100
Forks	9
Bundled files	3
Links	Skill source Repository

Markdown instructions
A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.
Works with any LLM
AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.
3 bundled files
Scripts, templates, and references the model can read while it works. Files are read-only and never executed.
Open source
Published by SpaceZephyr on GitHub. Read the source before you install it.

Installation

Install the Travel Vlog AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

Open the app and go to Plugins → Skills.
Choose "Install from GitHub".
Paste the skill folder URL below and confirm.
https://github.com/SpaceZephyr/map-motion/tree/main/travel-vlog
Enable the skill in any chat where you want it available.

Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills

git clone --depth 1 https://github.com/SpaceZephyr/map-motion.git /tmp/map-motion
mkdir -p .claude/skills
cp -r /tmp/map-motion/travel-vlog .claude/skills/travel-vlog

Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Travel Vlog in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Travel Vlog on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Travel Vlog is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

Loaded only when it is needed
The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.
Switch models mid-chat
Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

旅行 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。
照片有人像时提醒用户这是要公开发布的内容；别把用户照片和形象提交进公开仓库。

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

Frequently asked questions

What does the Travel Vlog AI skill do?

Why use Travel Vlog on TypingMind?

Because you install it once and use it with any model. Travel Vlog is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Travel Vlog in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/SpaceZephyr/map-motion/tree/main/travel-vlog. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Travel Vlog?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Travel Vlog?

As many as you like. As long as a model supports skills, you can use Travel Vlog with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Travel Vlog AI skill free?

It is published on GitHub by SpaceZephyr. Check the repository for licensing terms. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Audio Jingle

nexu-io

OrganizationPopular

Audio generation skill — jingles, beds, voiceover, and sound effects. Routes music requests to Suno V5 / Udio / Lyria, speech to MiniMax TTS / FishAudio / ElevenLabs V3, and SFX to ElevenLabs SFX or…

Proof Video

Add subtitles, captions, narration cues, or zoom to a proof video or PR recording using repo-local capture helpers and a system ffmpeg renderer.

Facetime

Inspect FaceTime internal stages, place an approved call to a configured owner handle, and request hangup through facetime_call.

Camsnap

Capture frames or clips from RTSP/ONVIF cameras and local webcams, including USB pan/tilt/zoom control.

Overview

Installation

Install in TypingMind

Install in another agent

Use it in TypingMind

Works with any AI model

Skill instructions

旅行 vlog travel-vlog

准备

流程

1. 收照片，建项目

2. 照片 → 机位 → spec

3. 卡通形象

4. 检查（必做）

5. 出片（后台）

6. 交付

spec 里能改的

踩过的坑

Bundled files

Frequently asked questions

Related AI Skills

Set up your own AI workspace now