mcpField
T
trip-map-builder

trip-map-builder

github.com/hiyeshu生产力249330 次安装16 周前更新
代码仓库

关于 trip-map-builder

trip-map-builder 是通过规划、调研和构建三个阶段制作行程参考文档与地图页面的技能,适用于旅行规划。它结合地点安排、餐饮调研和地图标注,并将行程视为可随实际情况调整的参考。

主要功能

  1. 01按规划、调研、构建分阶段处理
  2. 02根据约束安排每日行程
  3. 03用大众点评和小红书调研餐饮
  4. 04生成含地点信息的地图页面
  5. 05记录可长期使用的旅行偏好

适用场景

  1. 01按日期和航班约束规划旅行
  2. 02结合点评与近期分享筛选餐馆
  3. 03把每日安排整理为交互地图页面

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/hiyeshu/trip-map-builder --skill trip-map-builder

安装后在 Claude Code 中输入/trip-map-builder确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

CLAUDE.md
README.md
assets/
template.html
references/
dianping-research.md
CLAUDE.md
xhs-research.md
trip-planning.md

详细介绍

Trip Map Builder

三阶段流程:规划 → 调研 → 构建。

输出的是参考行程,而不是旅行者必须遵守的脚本。 旅行期间,天气、当前位置、疲劳程度和饥饿感都可能优先于 原计划。

共享记忆

规划或构建之前,如果 ~/.trip-map-builder/MEMORY.md 存在,请先阅读。 仅将其用于记录旅行者的长期背景信息:

  • 行程节奏偏好
  • 餐饮和饮品偏好
  • 预算习惯
  • 支付和导航偏好
  • 之前生成的旅行输出
  • 反复出现的限制条件和未解决的后续事项

如果文件不存在,照常继续。不要因设置记忆而阻塞流程。

不要存储原始截图、护照数据、预订代码、完整聊天记录或 其他敏感/私人资料。

每次完成行程规划、调研阶段或地图构建后,只将长期有效的信息 更新到 ~/.trip-map-builder/MEMORY.md:

# Trip Map Builder Memory

## Traveler Defaults
- Departure city:
- Pace:
- Food preferences:
- Budget habits:
- Payment preference:
- Navigation preference:
- Language preference:

## Past Trips
| Trip | Dates | Destination | Output | Notes |
|------|-------|-------------|--------|-------|

## Reusable Preferences
-

## Open Threads
-

阶段 1:规划行程

阅读 references/trip-planning.md,了解完整方法。

核心流程:

  1. 提取硬性限制——日期、航班时间、航站楼、酒店位置
  2. 整理用户的愿望清单——市区方便到达/需要预约/远郊/顺路经过
  3. 优先删减高风险项目——距离太远、节假日拥挤、受天气影响。说明删掉了什么以及原因。
  4. 按区域安排——每天一个主要区域,第一天轻松安排,最后一天安排在机场附近
  5. 安排用餐——先考虑每日所在区域的候选地点,其次参考大众点评 + 小红书信号,最后才考虑名气。
  6. 添加门票和交通——仅添加关键项目(博物馆门票、机场接送)
  7. 撰写参考文档——先写结论,再写每日计划、受天气影响的地点、用餐区域和删减项目

核心原则:

  • 用户列出的项目不一定都能安排进去。替他们做删减。
  • 每天一个区域。每天最多安排一个需要预约的地点。
  • 行程应顺畅,而不是塞得满满当当。
  • 计划提供坐标,便于之后调整;不要假装现实会按时间表发展。
  • 所有面向用户的问题都遵循四步格式:重新确认背景 → 简化问题 → 给出建议 → 提供选项。示例和反模式见 references/trip-planning.md § 用户交互。

阶段 2:通过大众点评 + 小红书调研

阅读 references/dianping-research.md,了解大众点评 OpenCLI 工作流。 阅读 references/xhs-research.md,了解小红书 OpenCLI + CDP 工作流。

餐厅调研中,以大众点评作为判断口味、排队风险、性价比和明显陷阱的主要中文餐饮信息来源。用小红书补充氛围、近期体验、是否值得拍照以及软性提醒。除非名店本来就在路线沿途,否则不要围绕一家名店安排整天行程。

小红书核心流程:

  1. 使用 --remote-debugging-port=9223 启动 Chrome
  2. 通过 OpenCLI 的 CDPBridge 连接
  3. 前往 xiaohongshu.com/search_result?keyword=<encoded>(不要模拟输入搜索框)
  4. 拦截 POST /api/sns/web/v1/search/notes 响应
  5. 按相关性选出排名靠前的 2-3 篇笔记,并打开详情页
  6. 通过 DOM 提取:#detail-title、#detail-desc、.author-container .username
  7. 将每家店的调研压缩成一句有助于决策的话,并写回本地 .md

筛选规则:

  • 保留:具体店名、地址、菜品、个人体验、重复出现的关键词
  • 删除:泛泛的区域盘点、转发内容、纯情绪表达、“氛围很好” x3
  • 输出:店名 + 一个代表性链接 + 2-3 句结论

阶段 3:构建地图页面

  1. 复制 assets/template.html → index.html
  2. 使用阶段 1+2 的结构化数据填充 HOTEL 对象和 DAYS 数组
  3. 每个地点需要包含:名称、lat/lng、类型、时间、描述;可选:预算、详情、支付方式、小红书链接、预订信息、gmap
  4. 在 overviewContent() 中填写旅行摘要和支付提醒
  5. 应用设计系统——默认模板使用 Apple 风格,但也可以切换为 awesome-design-md 中的任意风格

地点类型:food | spot | drink | hotel | transport

支付标记取值:1 = 确认支持(绿色),0.5 = 可能支持(橙色),省略 = 不显示

设计系统(可选)

默认模板使用 Apple 设计系统(SF Pro、浅色主题、磨砂玻璃效果)。

如需使用其他样式,请从 awesome-design-md 获取 DESIGN.md:

# Browse available design systems
# Apple, Vercel, Linear, Stripe, Notion, Airbnb, Nike, Spotify, etc.
curl -O https://raw.githubusercontent.com/VoltAgent/awesome-design-md/main/design-md/<brand>/DESIGN.md

然后调整 template.html 中的 :root CSS 变量(颜色、字体、间距、圆角),使其与所选 DESIGN.md 令牌匹配。

部署(可选)
git init && git add . && git commit -m "trip map"
gh repo create REPO --public --source=. --push
# Import from vercel.com/new — auto-deploys on push

依赖项

工具用途安装
OpenCLI大众点评适配器 + 小红书调研npm install -g @jackwener/opencli
Chrome/Chromium浏览器 + 远程调试已有
Leaflet.js地图渲染(通过 CDN 引入,无需安装)template.html 内置
gh CLI创建 GitHub 仓库(可选)brew install gh

资源

  • references/trip-planning.md — 行程规划方法、输入/输出模板、筛选原则、常见问题
  • references/dianping-research.md — 大众点评 OpenCLI 搜索/店铺工作流、用餐决策信号、回写格式
  • references/xhs-research.md — OpenCLI 安装、Chrome CDP 配置、小红书搜索工作流、API 详情、筛选标准
  • assets/template.html — 单文件 HTML 地图模板(Leaflet + Apple 设计系统)
  • awesome-design-md — 60+ 种品牌设计系统(Apple、Vercel、Stripe、Linear 等),可供选择其他样式

评论

支持 Markdown