Photo Spot

找机位 photo-spot

一张照片 → 13–16 秒竖屏视频：

渲染引擎是 map-motion（snap 镜头）。本 skill 管流程：定位置 → 写 spec → 抽帧检查 → 出片。

准备

• 需要已安装 map-motion：~/.claude/skills/map-motion（同一仓库根目录，见仓库 README），以及高德 key、uv、ffmpeg。
• 辅助命令：S=~/.claude/skills/photo-spot/scripts/spot.sh
  • $S exif 照片 读 GPS、朝向、时间、机型、等效焦距（→ 视角 fov）、ISO/快门/光圈
  • $S find 关键字 --city 城市 高德 POI 搜索
  • $S ahead 经度,纬度 方位角 公里 沿朝向推一个点
  • $S sheet 静帧目录 拼图；$S gif 成片.mp4 预览 GIF

流程

1. 拿照片，先读 EXIF

shCopy code
mkdir -p ~/Documents/map-motion/<项目名> && cp 照片 ~/Documents/map-motion/<项目名>/photo.jpg
$S exif ~/Documents/map-motion/<项目名>/photo.jpg

• 有 wgs84：这就是机位（spec 里加 "wgs84": true）。有 direction（iPhone 基本都有）就知道镜头朝哪。exif、fov、date 直接填进 spec。
• 没有 GPS（聊天里粘贴的图、截图、微信传过的图都会被去掉）：看画面猜地点，用 AskUserQuestion 让用户确认（给 3 个最像的候选，第一个放你最有把握的），不要自己拍板就开做。同时告诉用户：原图（照片 App →「导出未修改的原件」）能直接读出位置、朝向和参数。

2. 定机位和被摄地的坐标

• 国内：$S find 搜 POI。景点、山峰、观景台用 POI 搜索，地理编码（geocode）对景点常常报错或解析到同名商户。挑类型是「自然地名;山」「风景名胜」的那条。
• POI 也会错：大山峰的 POI 可能偏好几公里（实测高德「卡瓦格博峰」偏了约 10 km）。主峰、名山用公开资料里的山顶坐标，写 "wgs84": true。
• 境外：高德没数据，直接写坐标（境外 GCJ = WGS，不用转）。
• 被摄地不明确（比如拍的是一片海）：用 $S ahead 机位 朝向 距离 推一个点当 target，标签写看到的东西。
• 两点距离决定画面：几百米到 30 km 都合适；太近（<300 m）扇形会很小，frame 调大；太远（>50 km）落地级别太低，看不清机位环境。

3. 写 spec

复制 examples/ 里最像的一份改：

jsonCopy code
{"size": "portrait", "style": "satellite", "tail": 0.4,
 "shots": [
  {"type": "snap",
   "camera": {"name": "钓鱼翁", "at": [114.290586, 22.292909]},
   "target": {"name": "布袋澳", "at": [114.300485, 22.272561]},
   "camera_label": "钓鱼翁 · 山顶", "target_sub": "西贡 · 渔村",
   "image": "photo.jpg", "live": true,
   "name": "钓鱼翁 · 俯瞰布袋澳", "sub": "香港西贡 · 清水湾半岛",
   "exif": "ISO 64   1/500   f/1.8   24mm",
   "fov": 40, "frame": 0.42, "dur": 6.5, "spin": -110, "focus": 1.6, "hold": 4.2}
 ]}

4. 抽静帧检查（必做）

快门时刻 ts = dur + 1.1 + focus（缺省 9.2s）。

shCopy code
M=~/.claude/skills/map-motion/scripts/make.sh
cd ~/Documents/map-motion/<项目名> && $M snap.json stills/ --stills 5.5,8.6,9.6,10.2,12,14
$S sheet stills          # 质检没报问题时，只为看构图读一次拼图

输出末尾的「质检」会自动查出画、文字互压、文字压照片；它管不到的靠拼图逐项看：

• 8.6s：相机图标和被摄地标签都在画面里、没贴边、没互相压；扇形方向和照片对得上（从机位看过去，照片里的东西确实在那个方向）
• 9.6s：翻折中的相纸是梯形透视（不是平移）
• 10.2s 以后：相纸完整在画面内（竖图已限高），下方文字不出画；背景是照片的虚化
• 卫星底图不是灰底（灰底＝该地没有影像，境外换 satellite-world）

5. 出片

shCopy code
$M snap.json <名字>.mp4 && $S gif <名字>.mp4

快门声（和 Live 原声）自动合成进音轨；要配乐就自己混好，用 --audio 传入（会替换自动音效）。40 秒内的片子约 2–3.5 分钟渲染完。

6. 交付

说清：文件位置和时长；机位/被摄地坐标从哪来（EXIF / 高德 POI / 公开资料 / 推测）；哪些是示意（EXIF 参数、估计的机位）；用的哪家卫星图和署名。估计的机位要明说「城市级准、可能差几公里」，并提示给原图可精确。

踩过的坑

• 粘贴进对话的照片没有 EXIF。不要凭画面硬猜后直接出片——先问。
• 高德 geocode 对「神瀑」「卡瓦格博峰」这类景点直接报 30001 错误；用 POI 搜索（$S find）。
• 高德卫星在日本等境外推到 10 级以上全是灰底 → satellite-world。反过来国内用 Esri 会和高德坐标错位。
• 卫星样式的落针缺省是发光圆点；相机图标要 kind: camera（snap 已处理）。
• 经纬度 35.15° 曾显示成 08′60.0″（浮点进位）——已改成按 0.1″ 整数拆分。
• --from 截段渲染时音轨要同步跳过（已处理），否则快门声错位。
• 照片有人像时，提醒用户这是公开发布的内容；别把用户照片提交进公开仓库。