SpaceZephyr/map-motion

也有独立仓库 [SpaceZephyr/travel-vlog](https://github.com/SpaceZephyr/travel-vlog)（自带引擎，单独安装即可用）。

git clone https://github.com/SpaceZephyr/map-motion ~/.claude/skills/map-motion

依赖：[uv](https://docs.astral.sh/uv/)、ffmpeg。

**Skill** - [huashu-art-motion](https://github.com/alchaincyf/huashu-art-motion)（花叔）：借鉴了它的工作方法——风格先在同一帧上出多个方向让人挑、所有渲染确定性可复现、交付前抽静帧逐帧检查、派独立 agent 只看成片审片、把踩过的坑写回 skill（本 skill 的 SKILL.md 末尾也保留了「踩过的坑」）。

- [huashu-art-motion](https://github.com/alchaincyf/huashu-art-motion)（花叔）：借鉴了它的工作方法——风格先在同一帧上出多个方向让人挑、所有渲染确定性可复现、交付前抽静帧逐帧检查、派独立 agent 只看成片审片、把踩过的坑写回 skill（本 skill 的 SKILL.md 末尾也保留了「踩过的坑」）。

- [Anthropic skill-creator](https://github.com/anthropics/skills)：skill 的组织方式——SKILL.md 只放流程和选择指南，参数细节放 references/，可执行部分放 scripts/，按需加载。

**产品与灵感** - [Mult.dev](https://mult.dev)、[TravelAnimator](https://travelanimator.com)：旅行地图视频的常见镜头（航线、自驾、照片插入）。

- [Mult.dev](https://mult.dev)、[TravelAnimator](https://travelanimator.com)：旅行地图视频的常见镜头（航线、自驾、照片插入）。

**数据** - [高德开放平台](https://lbs.amap.com) Web 服务 API（地理编码、路径规划、行政区）与地图瓦片

- [高德开放平台](https://lbs.amap.com) Web 服务 API（地理编码、路径规划、行政区）与地图瓦片

- [阿里云 DataV GeoAtlas](https://datav.aliyun.com/portal/school/atlas/area_selector)：中国省级边界（含南海诸岛与九段线）

- [Natural Earth](https://www.naturalearthdata.com) / [world-atlas](https://github.com/topojson/world-atlas)：世界陆地轮廓

- [OpenStreetMap](https://www.openstreetmap.org)（Overpass API）：公园、景区等地块轮廓 © OpenStreetMap contributors，ODbL

- [OpenTopoData](https://www.opentopodata.org)：SRTM 30m 海拔

- [AWS Terrain Tiles](https://registry.opendata.aws/terrain-tiles/)（Mapzen Terrarium 编码）：3D 地形与 3D 片的海拔/爬升，© Mapzen 及各数据源（SRTM、GMTED、ETOPO1 等）

- [MapLibre GL JS](https://maplibre.org) 5.24（BSD-3）：3D 片的渲染，运行时从 unpkg 下载并缓存

- [Esri World Imagery](https://www.arcgis.com/home/item.html?id=10df2279f9684e4a9f6a7f08febac2a9)：境外卫星影像（`satellite-world`）和 3D 片的全部卫星影像，© Esri, Maxar, Earthstar Geographics

- 太阳位置：NOAA Solar Calculator 算法（scripts/sun.py，自写实现） - 卡通形象：[LabNana](https://labnana.com) 图像接口（gpt-image-2 / Gemini）按用户照片生成，需用户自己的 key；内置小人由代码绘制 - 配乐与音效：scripts/audio.py 程序合成（Karplus-Strong 拨弦、正弦钟琴等），原创，无第三方版权

- 卡通形象：[LabNana](https://labnana.com) 图像接口（gpt-image-2 / Gemini）按用户照片生成，需用户自己的 key；内置小人由代码绘制

[Credential-related source omitted]

This Font Software is licensed under the SIL Open Font License, Version 1.1. This license is copied below, and is also available with a FAQ at: http://scripts.sil.org/OFL

http://scripts.sil.org/OFL

Executable file

#!/bin/zsh

Executable file

#!/bin/zsh

[Credential-related source omitted]

Executable file

[Credential-related source omitted]

[Credential-related source omitted]

f = CACHE / f"{h}.json"     if f.exists(): return json.loads(f.read_text())     url = f"https://restapi.amap.com{path}?" + urllib.parse.urlencode({**q, "key": key()})

if f.exists(): return json.loads(f.read_text())     url = f"https://restapi.amap.com{path}?" + urllib.parse.urlencode({**q, "key": key()})     for attempt in range(6):                                    # 免费 key 约 3 次/秒：间隔＋被限流退避

url = f"https://restapi.amap.com{path}?" + urllib.parse.urlencode({**q, "key": key()})

for attempt in range(6):                                    # 免费 key 约 3 次/秒：间隔＋被限流退避         time.sleep(0.35 * (attempt + 1))         d = json.load(urllib.request.urlopen(url, timeout=30, context=_ctx()))

time.sleep(0.35 * (attempt + 1))         d = json.load(urllib.request.urlopen(url, timeout=30, context=_ctx()))         ok = d.get("status") == "1" or d.get("errcode") == 0

d = json.load(urllib.request.urlopen(url, timeout=30, context=_ctx()))

Executable file

Executable file

Executable file

Executable file

URL = "https://s3.amazonaws.com/elevation-tiles-prod/terrarium/{z}/{x}/{y}.png"

URL = "https://s3.amazonaws.com/elevation-tiles-prod/terrarium/{z}/{x}/{y}.png"

for i in range(3):             try:                 data = urllib.request.urlopen(URL.format(z=z, x=x, y=y), timeout=30, context=amap._ctx()).read(); break

for i in range(3):             try:                 data = urllib.request.urlopen(URL.format(z=z, x=x, y=y), timeout=30, context=amap._ctx()).read(); break

try:                 data = urllib.request.urlopen(URL.format(z=z, x=x, y=y), timeout=30, context=amap._ctx()).read(); break             except Exception as e:

try:                 data = urllib.request.urlopen(URL.format(z=z, x=x, y=y), timeout=30, context=amap._ctx()).read(); break             except Exception as e:

data = urllib.request.urlopen(URL.format(z=z, x=x, y=y), timeout=30, context=amap._ctx()).read(); break

data = urllib.request.urlopen(URL.format(z=z, x=x, y=y), timeout=30, context=amap._ctx()).read(); break

Executable file

CACHE = Path.home() / ".cache/map-motion/elev" API = "https://api.opentopodata.org/v1/srtm30m?locations="

API = "https://api.opentopodata.org/v1/srtm30m?locations="

try:                 time.sleep(1.1)                 d = json.load(urllib.request.urlopen(API + q, timeout=40, context=amap._ctx()))

time.sleep(1.1)                 d = json.load(urllib.request.urlopen(API + q, timeout=40, context=amap._ctx()))                 if d.get("status") == "OK": break

d = json.load(urllib.request.urlopen(API + q, timeout=40, context=amap._ctx()))

Executable file

Executable file

#!/bin/zsh

#!/bin/zsh

Executable file

CACHE = Path.home() / ".cache/map-motion/osm" MIRRORS = ["https://overpass-api.de/api/interpreter", "https://maps.mail.ru/osm/tools/overpass/api/interpreter", "https://overpass.kumi.systems/api/interpreter"]

MIRRORS = ["https://overpass-api.de/api/interpreter", "https://maps.mail.ru/osm/tools/overpass/api/interpreter", "https://overpass.kumi.systems/api/interpreter"]

for u in MIRRORS:                                            # 主站常 504，轮流试镜像         try:             req = urllib.request.Request(u, data=urllib.parse.urlencode({"data": q}).encode(), headers={"User-Agent": "map-motion/1.0 (video tool)"})

try:             req = urllib.request.Request(u, data=urllib.parse.urlencode({"data": q}).encode(), headers={"User-Agent": "map-motion/1.0 (video tool)"})             d = json.load(urllib.request.urlopen(req, timeout=90, context=amap._ctx()

req = urllib.request.Request(u, data=urllib.parse.urlencode({"data": q}).encode(), headers={"User-Agent": "map-motion/1.0 (video tool)"})

d = json.load(urllib.request.urlopen(req, timeout=90, context=amap._ctx()))

Executable file

Executable file

TCACHE = Path.home() / ".cache/map-motion/tiles" SRC = {   # 高德瓦片（GCJ-02 墨卡托）：amap＝标准路网 512px，sat＝卫星 256px，lbl＝卫星上的路名地名叠加 512px     "amap": "https://wprd0{s}.is.autonavi.com/appmaptile?x={x}&y={y}&z={z}&lang=zh_cn&size=1&scl=2&style=7",

SRC = {   # 高德瓦片（GCJ-02 墨卡托）：amap＝标准路网 512px，sat＝卫星 256px，lbl＝卫星上的路名地名叠加 512px     "amap": "https://wprd0{s}.is.autonavi.com/appmaptile?x={x}&y={y}&z={z}&lang=zh_cn&size=1&scl=2&style=7",     "sat": "https://webst0{s}.is.autonavi.com/appmap

"amap": "https://wprd0{s}.is.autonavi.com/appmaptile?x={x}&y={y}&z={z}&lang=zh_cn&size=1&scl=2&style=7",

"sat": "https://webst0{s}.is.autonavi.com/appmaptile?style=6&x={x}&y={y}&z={z}",

"lbl": "https://wprd0{s}.is.autonavi.com/appmaptile?x={x}&y={y}&z={z}&lang=zh_cn&size=1&scl=2&style=8&ltype=4",

"esri": "https://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer/tile/{z}/{y}/{x}",   # 境外卫星（WGS-84 墨卡托，全球高清）；高德卫星境外只有城市级

"dem": "https://s3.amazonaws.com/elevation-tiles-prod/terrarium/{z}/{x}/{y}.png",   # 3D 地形：AWS Terrain Tiles（Terrarium 编码高程）

} VENDOR = {"maplibre-gl.js": "https://unpkg.com/maplibre-gl@5.24.0/dist/maplibre-gl.js"}   # 3D 运行时用，首次下载后缓存 VCACHE = Path.home() / ".cache/map-motion/vendor"

VENDOR = {"maplibre-gl.js": "https://unpkg.com/maplibre-gl@5.24.0/dist/maplibre-gl.js"}   # 3D 运行时用，首次下载后缓存

for k in range(3):         try:             data = urllib.request.urlopen(urllib.request.Request(url, headers={"User-Agent": "Mozilla/5.0", "Referer": "https://www.amap.com/"}), timeout=20, context=CTX).read()

try:             data = urllib.request.urlopen(urllib.request.Request(url, headers={"User-Agent": "Mozilla/5.0", "Referer": "https://www.amap.com/"}), timeout=20, context=CTX).read()             f.parent.mkdir(parents=True, exist_ok=True); 

data = urllib.request.urlopen(urllib.request.Request(url, headers={"User-Agent": "Mozilla/5.0", "Referer": "https://www.amap.com/"}), timeout=20, context=CTX).read()

f = VCACHE / VENDOR[p[8:]].split("/")[3] / p[8:]             if not f.exists():                 f.parent.mkdir(parents=True, exist_ok=True); f.write_bytes(urllib.request.urlopen(VENDOR[p[8:]], timeout=60, context=CTX).read())

if not f.exists():                 f.parent.mkdir(parents=True, exist_ok=True); f.write_bytes(urllib.request.urlopen(VENDOR[p[8:]], timeout=60, context=CTX).read())             return self._send(f.read_bytes(), "text/javascript")

f.parent.mkdir(parents=True, exist_ok=True); f.write_bytes(urllib.request.urlopen(VENDOR[p[8:]], timeout=60, context=CTX).read())

pg.on("pageerror", lambda e: (A.verbose and print("[pageerror]", e), errors.append(str(e))))     pg.add_init_script("window.MM_TIMELINE = " + json.dumps(TL, ensure_ascii=False) + ";")     pg.goto(f"http://127.0.0.1:{port}/{RT}.html")

pg.add_init_script("window.MM_TIMELINE = " + json.dumps(TL, ensure_ascii=False) + ";")     pg.goto(f"http://127.0.0.1:{port}/{RT}.html")     pg.wait_for_function("window.__ready === true || !!window.__bootFailed", timeout=120000)

pg.goto(f"http://127.0.0.1:{port}/{RT}.html")

(out / f"t{float(s):06.2f}.png").write_bytes(base64.b64decode(png))

ff.stdin.write(base64.b64decode(png))

Executable file

Executable file

Executable file

const fonts = [['MM-Bold', 'NotoSansSC-700'], ['MM-Black', 'NotoSansSC-900'], ['MM-Hand', 'LXGWWenKai-500'], ['MM-Num', 'Anton-400']];   for (const [fam, f] of fonts) { const ff = new FontFace(fam, `url(/asset/fonts/${f}.woff)`); await ff.l

for (const [fam, f] of fonts) { const ff = new FontFace(fam, `url(/asset/fonts/${f}.woff)`); await ff.load(); document.fonts.add(ff); }   ASSET.land = await (await fetch('/asset/land.json')).json();   ASSET.china = await (await fetch('/asse

ASSET.land = await (await fetch('/asset/land.json')).json();

ASSET.china = await (await fetch('/asset/china.json')).json();

const tx = x0 + 40 * U; c.textAlign = 'left'; c.fillStyle = S.chipText;   c.font = `${24 * U}px "MM-Num"`; c.letterSpacing = `${5 * U}px`; c.globalAlpha *= 0.65; c.fillText(L.kicker || 'YOU ARE HERE', tx, y0 + 52 * U); c.letterSpacing = '0p

c.font = `${24 * U}px "MM-Num"`; c.letterSpacing = `${5 * U}px`; c.globalAlpha *= 0.65; c.fillText(L.kicker || 'YOU ARE HERE', tx, y0 + 52 * U); c.letterSpacing = '0px'; c.globalAlpha = e * (1 - out);   const name = L.name || ''; const nc =

const name = L.name || ''; const nc = Math.ceil(clamp((lt - 0.15) / 0.6) * [...name].length);

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

[Credential-related source omitted]

Executable file

def labnana_key():     k = os.environ.get("LABNANA_API_KEY")     if k: return k, os.environ.get("LABNANA_API_URL", "https://api.labnana.com")

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

if f.exists():             kv = dict(l.strip().split("=", 1) for l in f.read_text().splitlines() if "=" in l and not l.startswith("#"))             if kv.get("LABNANA_API_KEY"): return kv["LABNANA_API_KEY"], kv.get("LABNANA_API_URL", "https

kv = dict(l.strip().split("=", 1) for l in f.read_text().splitlines() if "=" in l and not l.startswith("#"))             if kv.get("LABNANA_API_KEY"): return kv["LABNANA_API_KEY"], kv.get("LABNANA_API_URL", "https://api.labnana.com")     ra

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

body = {"provider": prov, "model": model, "prompt": prompt, "imageConfig": {"aspectRatio": "1:1", "imageSize": "1K"},             "referenceImages": [{"inlineData": {"data": base64.b64encode(r).decode(), "mimeType": "image/jpeg"}} for r in 

"referenceImages": [{"inlineData": {"data": base64.b64encode(r).decode(), "mimeType": "image/jpeg"}} for r in refs]}     req = urllib.request.Request(f"{url}/openapi/v1/images/generation", data=json.dumps(body).encode(), method="POST",     

req = urllib.request.Request(f"{url}/openapi/v1/images/generation", data=json.dumps(body).encode(), method="POST",

ctx = ssl.create_default_context()     try:         res = json.loads(urllib.request.urlopen(req, timeout=300, context=ctx).read())

try:         res = json.loads(urllib.request.urlopen(req, timeout=300, context=ctx).read())     except urllib.error.HTTPError as e:

res = json.loads(urllib.request.urlopen(req, timeout=300, context=ctx).read())

Path(out).write_bytes(base64.b64decode(part["inlineData"]["data"])); return out

#!/bin/zsh