Trail 地图轨迹技能

功能描述

将文件中的地点信息解析出来，在地图上创建标记点，并按时间顺序连接成路线。

User Input Tools

When this skill prompts the user, follow this tool-selection rule (priority order):

Prefer built-in user-input tools exposed by the current agent runtime — e.g., AskUserQuestion, request_user_input, clarify, ask_user, or any equivalent.
Fallback: if no such tool exists, emit a numbered plain-text message and ask the user to reply with the chosen number/answer for each question.
Batching: if the tool supports multiple questions per call, combine all applicable questions into a single call; if only single-question, ask them one at a time in priority order.

Concrete AskUserQuestion references below are examples — substitute the local equivalent in other runtimes.

Script Directory

Agent Execution: Determine this SKILL.md directory as {baseDir}. Resolve ${BUN_X} runtime: if bun installed → bun; if npx available → npx -y bun; else suggest installing bun. Replace {baseDir} and ${BUN_X} with actual values.

| Script | Purpose | |--------|---------| | scripts/main.ts | Main entry point |

触发条件

当用户提及以下关键词时触发：

trail
地图显示
轨迹
路线
位置

支持的输入类型

单个文件
多个文件
单个目录

处理流程

Step 1: 收集输入

接收文件路径或目录作为输入。

Step 2: 文件分类处理

纯文本类 (txt, html, md)

通过地名词典匹配文本中的地点。纯文本不要求包含时间信息：

如果文本中有时间信息，则使用文本中的时间
如果文本中没有时间信息，则使用文件创建时间作为起点，按地名出现顺序每处递增10分钟分配时间
从文本中提取所有地名，按出现顺序生成路径点位

图片、视频类

读取文件的EXIF GPS信息，如果有GPS坐标，在地图上显示标记点。

Step 3: 点位聚合

当多个点位距离较近时（最大点位差的5%范围内），合并显示为一个标记点。

Step 4: 生成地图HTML

使用 Leaflet + 高德瓦片生成交互式地图，无需 API 密钥。加 --osm 可切换为 OpenStreetMap 瓦片。

点位聚合规则

计算所有点位的最大纬度差和最大经度差
当两点之间的纬度差小于最大纬度差的5%且经度差小于最大经度差的5%时，合并为一个点位
聚合后的点位显示所有合并点位的内容

Usage

${BUN_X} {baseDir}/scripts/main.ts <input> [options]

Options:

| Option | Description | Default | |--------|-------------|---------| | --output <path> | Output HTML file path | trail.html | | --title <text> | Map title | 地图轨迹 | | --osm | Use OpenStreetMap tiles (default: Amap tiles) | Amap | | --cluster-threshold <percent> | Cluster threshold percentage | 5 | | --nogroup | Disable point clustering, show all markers | false |

Examples:

# 处理单个文件（Leaflet + 高德瓦片）
${BUN_X} {baseDir}/scripts/main.ts travel_diary.md

# 处理目录（使用 OpenStreetMap）
${BUN_X} {baseDir}/scripts/main.ts ./photos/ --osm

# 指定输出文件和标题
${BUN_X} {baseDir}/scripts/main.ts ./images/ --output my_trail.html --title "旅行轨迹"

# 显示所有点位，不聚合
${BUN_X} {baseDir}/scripts/main.ts travel_diary.md --nogroup

Output

File location: Current working directory.

JSON output to stdout:

{
  "success": true,
  "message": "地图轨迹已生成",
  "outputPath": "/path/to/trail.html",
  "pointsCount": 15,
  "clustersCount": 8
}