generate-sketch-map

根据一组有序的地点列表，渲染一张手绘风格的中国路线图（PNG 格式）。地图包含以下图层：省级区域填色、流经所访问城市的河流、高亮显示的城市多边形、带方向箭头的路线、带编号的标记点、指南针，以及可选标题。视觉样式为固定设计。

适用场景

当用户需要以下任意一种输出时，可使用该技能：

• 一次中国旅行的手绘 / 草图风格地图
• 用于可视化中国城市序列的旅行路线图 / 行程图 / 路线图 / 旅行地图

覆盖范围仅限于中国大陆地区（WGS84 坐标系经纬度）。境外地点无法匹配省级或市级行政边界，在输出摘要中将归入 unmatchedLocations 字段。

初始化设置（每台机器仅需执行一次）

在本技能目录下，一次性安装 CLI 所需依赖：

pnpm --dir scripts install

需使用 Node 20+ 版本。

使用方法

在本技能目录下运行 CLI 工具（读取路线 JSON 输入，生成 PNG 输出；摘要信息输出至 stdout）：

cat input-route.json | pnpm --dir scripts exec tsx render-sketch-map.ts --output /tmp/route.png

安装说明：将此文件夹复制或创建符号链接至你的编程智能体（coding agent）的技能路径中（例如：/.cursor/skills/generate-sketch-map/，具体路径请参考你所用工具的文档说明）。地理数据已内置于 sketch-map-sdk 中；常规使用无需单独复制 geo/*.json 类型的地理数据文件。

输入 JSON 格式规范

{
  "title": "可选字段，最多 60 个字符；省略则不显示标题",
  "locations": [
    { "name": "武汉", "lat": 30.5928, "lng": 114.3055 },
    { "name": "青岛", "lat": 36.0671, "lng": 120.3826 }
  ],
  "width": 800,
  "height": 600
}

PNG 图像以 SVG viewBox 尺寸的 2 倍分辨率进行光栅化。

stdout 摘要输出

完成渲染后，标准输出（stdout）将返回一个 JSON 对象，可用于后续逻辑处理：

{
  "output": "/abs/path/route.png",
  "status": "ok",
  "message": "Rendered 5 locations to png.",
  "locationCount": 5,
  "unmatchedLocations": []
}

检查 unmatchedLocations 字段，可识别坐标异常问题（常见原因包括：坐标拼写错误、非中国大陆位置、或经纬度顺序颠倒）。

工作流程

1. 从用户处获取行程访问顺序。每个站点需提供 name、lat、lng（WGS84 坐标）。
2. 若用户仅提供了城市名称，请先进行地理编码（geocode）——可选用任何用户信任的数据源；本技能自身不提供地理编码能力。
3. 将路线 JSON 写入临时文件，或通过 stdin 管道传入。
4. 运行 CLI 工具，并捕获 stdout 输出的摘要信息。
5. 若 unmatchedLocations 非空，请核实对应坐标的准确性并重新运行。
6. 向用户展示生成的 PNG 图像（其绝对路径位于摘要中的 output 字段）。

示例

随包附带的 references/sample-route.json 描述了一条从 故宫 → 兵马俑 → 外滩 → 西湖 → 黄山 的路线。在本技能目录下执行：

pnpm --dir scripts install
pnpm --dir scripts run render --input ../references/sample-route.json --output /tmp/sample.png

故障排查

• unmatchedLocations 非空 —— 坐标落在中国大陆行政边界之外（常见原因为 lat/lng 顺序颠倒）。请修正输入后重试。