hike-planner#

从0开始逐步完善的智能行程规划工具。 需要用户明确提供出行日期、目的地和活动类型 才会开始规划。详细执行规范见 hike-planner-sop.md。

能力#

能力维度说明🚀 便捷输入日期、目的地、活动类型，10 分钟内生成含大交通、酒店、徒步路线、人文介绍、装备清单的完整计划🔍 可靠12306 / flyai 校验机票火车票，两步路 / 小红书查询路线，接受 GPX/KML 轨迹文件补充，高德地图保证里程准确⏱️ 精准锁定大交通时间 + 锁定徒步路线时间为双锚点，按时间顺排倒排，确保节点衔接无冲突🗺️ 可视每日行程自动生成高德地图链接，节点标注 + 交通路线一目了然。GPX/KML 轨迹渲染为交互式地图，支持多路线对比分析📚 有料人文信息按目的地特性自动分类检索，与行程强关联（诗词对应徒步路段，美食定位补给点）

内置能力#

能力说明徒步路线搜索两步路 + 小红书攻略 + B站视频（搜索策略详见 SOP §3.1）行程地图渲染高德地图可视化链接（依赖 amap-lbs-skill）。⚠️ 行程站点名称会通过网络发送给高德地图（Amap）API。人文信息收集Wikipedia + web_search + xiaohongshu行程计划生成按 PLAN_TEMPLATE 标准格式输出行中记录/行后汇总实际 vs 计划对比 + 归档

命令#

命令说明hike [目的地] [活动?]查询目的地介绍+推荐经典徒步路线。不创建行程、不管理状态。示例： hike 四姑娘山``hike-init [日期] [目的地] [活动]启动规划。日期/目的地/活动为必填，直接从参数解析。首次使用将征得您同意确认保存到 outputDir。示例： hike-init 2026-06-01 古蜀道 徒步+文化探访。若未提供完整参数则交互补问缺失项。hike-list列出所有未完成行程； hike-list <tripId> 归档并汇总指定行程hike-config output <路径>设置/切换默认输出目录（持久化到 {skillDir}/planner/config.json）。⚠️ 行程数据（含订单信息、GPS 坐标）将保存到此目录，共享服务器环境下其他用户可能可见。hike-config baseurl <URL>设置 Web 基础 URL（用于轨迹地图链接，默认 http://localhost）。不传参数查看当前值。hike-select <行程名>激活/选择某个行程进行管理。匹配 tripId 或目的地关键词（模糊匹配）。选择后 hike-status/today/log 都作用于该行程。hike-import <GPX/KML文件路径>导入 GPX/KML 轨迹文件到当前行程。自动提取 GPS 坐标、生成轨迹地图 HTML。⚠️ 轨迹坐标将写入本地 HTML 文件，导入前会弹窗确认。hike-status查看当前行程状态与概览（作用于 hike-select 选中的行程）hike-log [内容]记录行程最新信息：🚄 订好车票 / ✈️ 订好机票 / 🏨 订了酒店 / 💰 支出花销。粘贴 12306/航司/酒店 OTA 订单短信自动解析并更新行程。⚠️ 解析前会弹窗确认，仅提取订单关键字段（车次/航班/站点/日期），不保留原始短信全文。hike-today查看今日计划（时间线 + 地图，作用于选中行程）hike-add [dayN] [路线A-B]添加 A-B 行程段到 DayN，后续行程自动推后hike-del [dayN]⚠️ 删除 DayN 整个日程，立即写入磁盘且不可撤销。后续日程自动移前。hike-reorder [dayN] after|before|to [dayM]⚠️ 重排日程顺序，立即写入磁盘。将 DayN 移到 DayM 之后/之前，或让 DayN 成为新的 DayM。todo [N] done✅ 通过编号快速完成待办。示例： todo 1 done、 TODO 3 done。

示例#

text

hike 四姑娘山 徒步

纯查询模式，不创建行程。返回目的地文化介绍（地理/历史/人文/美食等 3-5 个分类）和经典徒步路线详情（路线名/距离/爬升/难度/关键节点/提示）。

text

hike-import ~/downloads/海坨山环线.gpx

导入 GPX/KML 轨迹文件到当前选中行程。自动提取 GPS 坐标、计算距离/爬升/下降统计数据、生成交互式轨迹地图 HTML。导入前需用户确认（轨迹坐标将写入本地文件）。

text

hike-init 2026-06-01 古蜀道 徒步+文化探访

Agent 交互收集需求后，自动执行搜索与生成。以「古蜀道 5/13-5/16」真实输出为例：

总览：

日期星期行程概要出行方式班次/车牌住宿酒店含早天气5/13周三抵达成都，逛宽窄巷子/锦里✈️CA4117 北京→成都维也纳国际酒店(成都东站)否晴5/14周四成都东→剑门关→小娅子徒步→普安镇🚄+🚗+🥾D2008+包车剑阁瑞山酒店是☀️31°C/16°C5/15周五汉阳镇→普安镇徒步10km🥾+🚗包车+徒步剑阁瑞山酒店是多云28°C/18°C5/16周六拦马墙→剑门关→成都→北京🥾+🚄+✈️D1973+CA4117晴29°C/17°C

DAY 3 — 5/16（周六）：拦马墙→返程北京：

时间区间节点详情费用备注07:00起床退房行李寄存前台必须早起07:00-07:30早餐酒店含早07:30-07:40🚗 包车酒店→拦马墙起点¥30-50约10min07:40-10:10🥾 徒步拦马墙→普安镇（折返）7.5km，约2.5h10:10-10:30取行李+简餐普安镇¥1520min10:30-11:00🚗 包车普安镇→剑门关站¥80-10011:00到达剑门关站候车29分钟🟢 刚好11:29-12:56🚄 D1973剑门关→成都东¥104已购票12:56抵达成都东13:00-15:00午餐苏坦土耳其餐厅（玉林店）¥100请上海来的朋友15:00-15:40🚇 地铁东站→双流机场（7号线）¥8-917:00-20:00✈️ CA4117双流→首都T3已购票2h24m

⚠️ 时间紧，务必早起！候车不超过30分钟 🗺️ 查看地图 💰 本日费用：约¥300-400（包车+午餐+地铁）

徒步路线详情 — 路线二：汉阳镇→普安镇：

项目数据距离10.05km爬升286m下降327m预计用时3.5-4小时路线类型古道+乡村公路关键节点汉阳镇体育中心→石洞沟→抄手铺→碑梁村→卧龙社区→普安镇⚠️ 提示石洞沟、抄手铺有补给；抄手铺的钟婆婆抄手售咖啡

外部依赖#

以下 Skill 为可选依赖。hike-init 启动时自动检测，若未安装则提示用户。

依赖用途安装12306-train-assistant火车票余票/价格/时刻查询npx clawhub install 12306-train-assistant``amap-lbs-skill距离/路线/地图npx clawhub install amap-lbs-skill``flyai机票/酒店查询npx clawhub install flyai（安装后需到 open.fly.ai 获取 API Key）xiaohongshu小红书攻略搜索（需先登录）npx clawhub install xiaohongshu

💡 hike-init 时会检测依赖可用性。缺失时提示用户安装或手动输入信息。不可用时的保底策略见 hike-planner-sop.md。

隐私与安全#

⚠️ 数据本地化：行程数据（含订单信息、GPS 坐标、媒体文件）持久化到本地磁盘。在共享服务器环境中，同一服务器的其他用户可能可以查看这些数据。建议使用专用输出目录并设置适当的文件权限。

数据类型存储位置风险提示行程计划outputDir/upcoming/<tripId>/含日期、目的地、交通/酒店订单信息轨迹坐标outputDir/upcoming/<tripId>/gpx/GPX/KML 精确 GPS 坐标写入 HTML 文件媒体文件outputDir/upcoming/<tripId>/media/截图/照片可能含敏感个人信息订单短信解析后仅提取关键字段（车次/航班/站点/日期），不保留原始短信全文外部服务传输数据用途高德地图 API站点名称 / GPS 坐标地理编码、地图链接生成unpkg.com浏览器 IP、轨迹区域Leaflet 库加载（轨迹地图 HTML）高德/OSM 瓦片浏览器 IP、浏览区域地图瓦片加载（轨迹地图 HTML）

安全措施#

• 文件类型白名单：仅允许 .gpx/ .kml（轨迹）和 .png/ .jpg/ .jpeg/ .gif/ .webp/ .bmp/ .svg/ .mp4/ .mov/ .avi/ .webm（媒体）
• 路径范围限制：文件导入仅允许来自行程输出目录、 ~/.openclaw/media/inbound/ 或系统临时目录
• 命令注入防护：外部脚本调用使用 execFileSync（参数数组模式，不经过 shell）
• 操作确认：轨迹导入、媒体导入、短信解析、输出目录切换均需用户确认

不做#

• 🔒 自动订票 / 下单 / 支付

⚠️ 不执行订票、下单、候补、支付等操作，但会保存行程、目的地、出行时间等信息。