by awangwang123
出行路书工作流 skill:联网实查 + 多源交叉验证,产出可核验、能执行的旅行攻略。覆盖吃住行游拍避全维度,附美食情报卡、基准骨架与校验工具,支持一键部署在线版。
From $49 · 30 days · terms & refunds
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
Automated security scan — not a certification.
# Add to your Claude Code skills
git clone https://github.com/awangwang123/jianhao-travel-plannerGuides for using ai agents skills like jianhao-travel-planner.
公用版说明(2026-09-21 从作者本体 v3.26 派生;v1.2 于 2026-09-29 升级基准骨架——导航双通道/当日定位;v1.3 于 2026-09-30 正文条款对齐作者本体 v3.49 的国内通用部分(必答清单/价格含税总价制/图源三级链等);v1.4 于 2026-10-03 增补本体 v3.50 五条价格纪律;v1.5 于 2026-10-05 增补本体 v3.51-52(机械交付闸门 tools/checklist.py+头部执行速查卡);v1.7 于 2026-10-08 增补本体 v3.55-59 国内通用条款(今日速览标准件/升级体验必答化/冷知识卡与 Plan B 固定件/slot 主次律/机位信息标准/tips 两组兼备/导览图插画化基线/R2 门槛/住宿选房顺位等)+checklist.py v1.2;v1.8 于 2026-10-09 增补本体 v3.62 游客优惠检查工序(票根经济/文旅消费券主动搜寻,知会型呈现);v1.9 于 2026-10-10 增补本体 v3.63-66(移动端表格列宽修复(fixed+colgroup,桌面零变化)/导航当日重复标记废止/大交通实时实查铁律(铁律 8)/天文时刻 API 实查/订房机位距离顺位/OTA 渠道核销窗口);v1.10 于 2026-10-13 tools/checklist.py 同步至 v1.6(形态检查组八项)+内部词中性化收口;v1.11 于 2026-10-13 SKILL.md 瘦身(版本行 42 条迁 HISTORY.md 全档,留最近 3 条+指针);v1.12 于 2026-10-14 增补本体 v3.69(美食清单按天分组式正本形态+密度硬标准四条/铁律 8 补航班聚合口径实证/跨板块归位黑名单);v1.13 于 2026-10-15 开工前置闸(阶段 0 出发地/日期窗/人数与关系禁默认+需求确认单,根治"零提问默认北京出发"实测事故)+SKILL.md 禁止摘要改写条款(93KB 正文被环境改造成附录的实测教训)+导览图双通路定序(手绘 SVG=无网无 key 兜底正路,硬执行禁跳过);v1.14 于 2026-10-19 重大升级:①出境能力包正式收录(作者三册出境实战成熟后解除测试封锁:实查通路三层级/签证体检卡/出入境双清单/双币种预算+含税实付/sos 领保块/装备卡/热门未排取舍说明——见「出境册附加条款」节)②checklist.py 同步 v1.9(24 项机械闸+修复指引映射+四视口,叙事注释已中性化)③新工具随包:assets/basemap_tool.py(真底图导览图工具链,兑现 v1.13 承诺)+tools/prep_fetch.py(日照/汇率/POI 坐标确定性预抓)④增补通用条款:提速五条/导览图六条+bbox 三层+总览比例家族基准/验收规范一页纸/三档位/价格复用边界/城市骨架池/修复熔断纪律/工具信息多处全集同列——见「制作提速·导览图·验收增补」节;v1.16 于 2026-10-24 改进路书检查与默认行程节奏(修复属性化页面时段识别/零时段明确报错/餐段误报收紧;默认 09:30—10:00 开始游玩、起床细节不入册——见 CHANGELOG);v1.17 于 2026-10-24 工具链公开化——tools/ 随包新增生成器/数据校验器/导览图程序化/事实派生等八件与 schema/TEMPLATE/基准骨架/合成样本四套回归,README 新增「工具模式」(不装 skill 按 schema 填数据走机械全链)——见 CHANGELOG;v1.18 于 2026-10-26 修复完整示范配图与检查盲区(demo 七张 1×1 占位换标注「虚构示意·非真实景点」的示意插画/页尾图源改中性缺省可数据侧覆盖/导览图出界检查三态判定并兼容程序化导览图/发布打包防缺件防裹挟——见 CHANGELOG)**;v1.19 于 2026-11-03 新增「中转衔接与廉价航空」条款(中转行李三规则/廉航值机费坑/联程票须全程乘坐/经港过境官方条件)+知识蒸馏核查规则(忠实转述≠事实核查,入条款必附核查状态)+最小流程改造(QUICKSTART/pipeline new·outline/fetch_images/timer)——见 CHANGELOG 本文件是作者自用版 travel-planner 的公用/开源版:方法骨架、产出形态、自查清单与本体一致;按开源前置工序做了 7 项改造—— ① 抓取链切公开源:正餐情报走大众点评/高德地图/小红书等公开平台交叉验证,不再依赖博主作品抓取流水线(不需要任何登录态); ② 配套口径三改:证据分级适配公开源 / 收录门槛 R2 的「穷尽」判定改为「地图 POI+多源交叉穷尽」/ 信源名单由使用者自建(不预置任何博主白名单); ③ 脱敏去个人化:用户档案改填空模板、作者个人设定降级为参考示例、个人文件路径全部清除; ④ 长辈/官方版叠加档完整保留(四件套+决策替做+温馨提示); ⑤ 配图硬规矩保留 + Pexels 免费 key 自注册指引(2 分钟,见「工具与依赖」); ⑥ 工程工具随包附带(
tools/consistency.py骨架校验 +tools/desource.py脱敏),去 AI 味通道二改可选; ⑦ 版本演进记录原样保留——每条规矩后面的"血案"(翻车实录)是这套标准为什么成立的解释,比规矩本身更值得读。记录中的署名(作者与协作者)是真实迭代存档,正文运行区已不含个人依赖。 🏠 本工作流的维护与更新:github.com/awangwang123/jianhao-travel-planner —— 反馈、许愿池与新版本发布均在此仓库。安装:整个目录(SKILL.md + assets/ + tools/)复制到
~/.claude/skills/jianhao-travel-planner/(全局)或项目.claude/skills/jianhao-travel-planner/(单项目)即可被 Claude Code 自动加载。 ⚠️ 与自用版的关系:本文件由作者的自用版本 travel-planner 派生(自用版含作者个人档案、不公开)。公用版技术名jianhao-travel-planner与自用版不同名,二者可在同一台机器共存、互不覆盖。 📜 完整版本演进翻车实录(42 条)见 HISTORY.md;用户视角变更说明见 CHANGELOG.md 版本 v3.54(2026-10-07,「工具缺口改」拍板)|tools/checklist.py 升 v1.1 四项扩容(成品终审实证:机械检查全过但四类问题全漏——检查项必须跟上翻车形态):①图渲染(视觉项内先滚动触发懒加载再逐张查,报 N/N)②badge 在位(每日卡 today-badge 元素逐天查——被「无日期模式」掩盖的潜伏缺陷显性化)③存储键跨成品污染(键前缀→城市映射+标题比对,从别的成品抄脚本没改键即拦)④长【】指引残留(≥15 字【】=骨架填稿指引未删即拦;【估算】【未核实】等短标注不受影响)。顺修 intel 空壳误报(选装区块不装=正常)。毒抓自测+异版回归零误伤。 版本 v3.52(2026-10-05,「制作时没翻条款」根因后的防不读设计)|头部新增「执行速查卡」:SKILL.md 原 50+ 行版本演进史在前、执行条款埋深处——触发加载的 AI 若不深读(实测案例:条款全文在副本里但制作时没翻),关键约束等于不存在——速查卡 5 条(读正本/板块非空/实查时点/交付闸门/修正双写)前置到第一屏,把「先读条款」从自觉变成第一眼可见的机械动作(实测自白「翻条款不存在于我的流程」+「AI 做的时候不读 skill,skill 就是白写的」实证)。 版本 v3.51(2026-10-05,三次同类翻车后的机械交付闸门)|🔴交付前必跑tools/checklist.py(通用机械检查,任意城市路书可跑):11 项=区块完备/区块空壳/每日餐行/author 选装件/JS 拼接/ID 唯一/占位符/骨架指纹/价格切碎/双视口/图渲染——交付前必跑、输出原文贴给用户、任何 FAIL 不许交稿、SKIP 必须声明(fail-closed)。源起:东京 v1/国际三册/山东三城三次同类翻车,条款靠人记三次失效——检查必须机械;首跑即抓自家大岛册餐行缺三处(脚本对自家产品同样不留情)。开源场景意义:外部使用者没有三重外部质检,checklist=使用者侧唯一质检武器。 ①🔴禁止轻餐穿插正餐分段——早/宵/下午茶卡不得混在正餐 ①②③④ 动线分段里(首版广佛补卡曾插在正餐分段内,作者 打回); ②轻餐板块独立置底:分段带「☕ 早餐 / 下午茶 / 宵夜(城市A → 城市B · 全天候)」,放全部正餐卡之后; ③轻餐排序=城市序(先广州后顺德),城内按 早餐 → 下午茶 → 小吃 → 宵夜 排; ④正餐排序=行程动线序(Day1-3 驻地 → 老城 → 转场镇 → 顺路镇),禁抓取序/随机序(首版 26 店即抓取序被 作者 打回「顺序都是乱的」); ⑤侧栏导航两组:「正餐 · 按行程动线 · N 张」+「早 / 下午茶 / 宵夜 · M 张」,锚点与正文卡序一致; ⑥编号:正餐 01-N 连续,轻餐 N+1 起连续(轻餐卡标题带(早餐)(宵夜)(下午茶)(小吃)类型标)。 ①收录优先级:⚡双博主交叉 → 📌作者 指定 → 单博主名店(区聚堆); ②卡片字段:城市·区域|店名|位置(门牌)|评星/人均/营业时间|特色菜/推荐菜|避雷/温馨提示——博主负面评价(两极分化/脾气火爆/上菜慢)写进避雷栏,别只夸不贬; ③介绍不呆:写记忆点(现烤皮脆/双博主同探/晚6点售罄),不能只堆营业时间; ④朋友版情报卡全脱敏:不写博主/赞数/链接/证据块; ⑤🔴离主行程远的店去掉(2026-09-20 作者定,先例:南海友壕气·黄岐离广州/顺德主线远被划掉)。 ⑥(v3.26 增补)情报卡/清单 IA 分层:正餐(动线序)在上 + 早/宵/下午茶(城市序)独立板块在下—— ①🔴禁止轻餐穿插正餐分段——早/宵/下午茶卡不得混在正餐 ①②③④ 动线分段里(首版广佛补卡曾插在正餐分段内,作者 打回); ②轻餐板块独立置底:分段带「☕ 早餐 / 下午茶 / 宵夜(城市A → 城市B · 全天候)」,放全部正餐卡之后; ③轻餐排序=城市序(先广州后顺德),城内按 早餐 → 下午茶 → 小吃 → 宵夜 排; ④正餐排序=行程动线序(Day1-3 驻地 → 老城 → 转场镇 → 顺路镇),禁抓取序/随机序(首版 26 店即抓取序被 作者 打回「顺序都是乱的」); ⑤侧栏导航两组:「正餐 · 按行程动线 · N 张」+「早 / 下午茶 / 宵夜 · M 张」,锚点与正文卡序一致; ⑥编号:正餐 01-N 连续,轻餐 N+1 起连续(轻餐卡标题带(早餐)(宵夜)(下午茶)(小吃)类型标)。 ⑦(v1.12)美食清单按天分组式=正本形态:每天一小节+叙述性标题(如「第 2 天 · 老街糖水与外沙海鲜」)+节内小表(餐段/位置/店/点什么/人均),禁整册一张「D1 晚/D2 晚」顿列大表(对照实证:顿列式读者要自己把行映射回行程,分节式跟着动线走即得);分节式配齐三件:品类级必吃清单(含时令)+找店口诀+收录标准与信源声明尾注。 ⑧(v1.12)美食密度硬标准(可数、防时好时坏):①每册实名店铺 ≥ 天数×2(对应每正餐主选+备选 ≥2 家的去重下限)②正餐主选必须实名店——市场/夜市只作场景背景、不得当正餐答案(无硬线时美食深浅全看当轮执行状态,敷衍必复发)③早/宵「随意」节各 ≥2 实名店 ④人均未实查不写死价格——标【未核实】或给来源。
python tools/checklist.py 路书.html --visual——FAIL 清零才交稿,输出原文贴给用户;SKIP 必声明来源:三本出境路书实战(欧洲双城/北非文化线/南岛自驾)成熟后收录;个人化案例已中性化。
页面抓取被目标站拦截时→搜索层(多源交叉互证)→浏览器页面级实查,逐层穷尽才许标【未核实】;降级必须留「试过哪几层」的证据。判断性数据(美食真伪/门票口径/口碑)永远当次实查;带时戳的历史记录复用时逐项核验(缓存≠免实查)。
五字段:①类型判定(签证类别+主申国规则——多国行程选停留最长国)②费用(签证费+服务费分列,带涨价生效日期)③审理周期(官方上限口径,第三方口径标【未逐字核】)④预约通路(官方门户+备选+🔴防钓鱼:只认官方域名,搜索引擎广告位「代办」多为高仿加价)⑤时间线(今天→约号→递签→出签→出发倒排)。 🔴 办签期间禁止锁定不可退改的大额订单——机票酒店用可免费取消的预订单,出签后再出票换正式订单。护照体检:有效期从回程日倒算≥6 个月+空白页≥2 页(航司值机就卡)。
出境链五环节:①签证三查(类型/材料/周期)②时间轴倒排(电子入境卡=独立待办项,别漏)③订单策略(先办签后出票)④边检海关红线(药品/食品/现金申报限额实查)⑤过境必查过境签——分段购票经第三国中转可能触发过境签,漏查=滞留中转机场。
中转衔接与廉价航空(v1.19 增补,实战+公开旅行知识蒸馏并经核查):
汇率:文首声明汇率表(rate+checked_at+来源),全文双币种(当地币+人民币锚);含税实付口径——部分国家标价=净价,服务费+VAT 层层叠加(实证口径:净价+12% 服务费+14% VAT≈实付+26%),住宿/预算按实付写,禁按广告净价。
目的地报警/急救电话+外交部全球领保热线 +86-10-12308+「领事服务网实查:无生效提醒」(带实查日期)+出发前 7 天复核一次。
转换头(插头制式实查:欧标 C/F 圆孔/英标三孔等,「国标扁插插不进」类结论必带实查日期)/离线包(地图+翻译离线包,出境册默认必做)/现金依赖标记(cash-heavy 目的地:取现手续费+小费文化+建议现金占比)。
时差=行程节奏变量:写明与出发地时差+夏令时切换日(切换卡在行程中段时,当天及之后所有衔接按新时区重算——日落提前 1 小时,户外安排整体前移)。
因定位/天数未安排的热门目的地(国家名片级,如北非文化线不排红海、南岛自驾不排北岛),总览必须给取舍段:本册为何不含(定位/天数)+延几天怎么去——防读者「这么热门怎么没有」的疑惑;取舍段=给选择权,不是道歉。
tools/prep_fetch.py「城市 lat,lon 出发日」一次出 JSON):日照逐日/汇率/POI 坐标制作时零等待;天气/门票/美食=判断性数据仍当次实查assets/机位话术语料库.md):「0.5x 广角蹲低仰拍」「夜景模式 3 秒手肘夹紧靠栏杆」类掏出就能照做的句式;禁「竖构图收 XX」类摄影评论腔assets/basemap_tool.py——兑现 v1.13「工具链随后续版本发布」)六条:①bbox 按实查坐标划(禁估计值——估出来的框会把点划出去)②渲染后逐点核对底图地名标注③长条长途底图禁画短线动线(返程日短线换当日细节底图)④base64 嵌入前查是否含检查器敏感词序列(含则转 JPEG 逐档重试)⑤无 key 时两点示意虚线兜底+图注「实际以导航为准」⑥页内显示 max-height 520px 封顶居中,禁 width:100% 占满列宽(竖图占满=滚三屏+缩放后线细如发)。 bbox 三层完整:实查坐标划框→覆盖路径全程(端点在框内≠路径在框内,出界点=0 靠数学断言不靠目测)→行程最小覆盖(禁装全程地理——总览装整个半岛、行程只占 30%=「无关内容过多」打回)。 总览图比例以家族为基准:路径占画面 40-50% 带宽+沿途语境一眼可读;「砍无关内容」砍的是视野外的绑架元素(端点外的全域/无关灰点),不是把走廊怼脸(怼脸版=路径占 80% 无边距无语境,必被打回)。
快速(核心信息+骨架,核验不降级)/标准(默认全量)/精装(视觉加工+增量内容);档位差异在内容广度与视觉加工,关键核验全档不降级。
同会话+同日期+同票种+同人群的带时戳记录可复用;跨会话/超 24h/日期变更/来源冲突/出发前 7 天=强制重查;余票/天气/营业状态永远当次查。
FAIL 输出尾附「🛠 修哪」映射:乱序=调换 slot 顺序;重复餐段=改其中一行餐段词或合并——只动涉及行,禁推倒重来;同 FAIL 连续 3 轮未消=熔断停手,如实向用户声明降级,禁静默硬修。 工具信息多处全集同列:打车 APP/购票入口/通讯方案等工具类信息在头部指引/APP 清单/行程正文/防骗区≥2 处出现时,必须同一口径全集同列(或一处详列+他处回指「见出发前清单」),禁「前面写两个、后面写四个」。
默认档案(作者):武汉出发;典型时间窗=周五晚~周一上午;内容必出(小红书+抖音);玩法=深度体验;人数结构以一人行为常态(西北行15天一人实证)、朋友局为辅
B 案激活流程(主案执行不了、切备胎时):
¥350(2026-09-21 13:00 查·长隆官方公众号)——查的时刻与来源写死在路书里 ④查不到官方源的处置(作者 原话口径):如实写「官方渠道未查到,请自行比价」并给出比价指引——官方公众号/小程序/大众点评/高德/抖音直播间搜寻门票,看哪个优惠更多,🔴 但要比对好日期别搞混(不同渠道挂的可能是不同日期档的票——平日票/周末票/指定日票价格不同,直播间优惠常限特定日期)。网页价与官方价不一致的并列写出,不擅自取其一;高热度需预约景点一律按「提前 5 天」倒排预约节点(放票日即设提醒,如陕历博/省博/莫高窟类);多档价格先拆清结构再算账——单票/联票/含车票并列时逐档核对官方在售商品名(联票含不含景交/观光车),防重复计价;老人/儿童优惠票同口径写明含不含车(2026-09-13 丽水仙都实证:联票 90 已含景交,另算景交 20×4 重复报 80 元,预算虚高 50 元).tb{table-layout:fixed}+断词兜底,成品按列型给 colgroup 定列宽百分比(如 景点|门票|备注=26/22/52、餐段|位置|店|点什么|人均=13/17/24/28/18;列宽要按最长单元格值校准),@media (min-width:901px){.tb col{width:auto!important}} 还原桌面自动布局——桌面排版零变化;基准骨架已含修复,旧派生成品按此补丁迁移文件命名:路书_<目的地>_v1.md,存项目目录。结构:
玩法模式切换(深度体验 ↔ 特种兵暴走):路书六维度按玩法取向切换侧重点,其余铁律(实查/预算诚实/安全第一位/自查9项)两种模式通用。
人数结构模式切换·六模式矩阵(v3.24 作者拍板重写):人员结构 × 玩法取向(深度/特种兵)× 体力结构(常规/省力慢游)三轴正交、任意叠加——如「闺蜜局+特种兵」=一天八机位换装打卡(真实存在需求)、「兄弟局+省力慢游」=长辈随行的家族旅行。
| 模式 | 核心突出点 | 住 | 吃 | 拍 | 节奏 |
|---|---|---|---|---|---|
| 兄弟局 | 玩得爽+性价比 | 电竞房/标间拼房 | 大排档/烧烤/夜宵,酒水放开 | 随手拍,打卡照为主 | 可叠加特种兵,深夜局常态化 |
| 闺蜜局 | 出片+氛围(提案待实测) | 双床房/民宿美学房(分开睡但要好看) | 下午茶/网红店/甜品权重高;拍照好看的店 ≥ 好吃的店 | 互拍是核心需求,机位密度加倍,穿搭×场景搭配建议 | 慢节奏,预留购物时间 |
| 情侣 | 两人时光(提案待实测) | 大床/景观房/温泉房是加分项(住宿体验本身是行程的一部分) | 氛围餐厅权重高,人均档可上调 | 互拍+合照;日落/夜景/蓝调时段优先 | 浪漫时段 > 打卡数量,不赶场 |
| 家庭带娃 | 娃的体验决定行程成败 | 家庭房/亲子酒店 | 儿童餐/软食友好 | 娃的状态抓拍 | 午睡刚需,就低不就高(省力慢游既有条款保留) |
| 家庭带长辈 | 省力+舒适 | 电梯房低楼层+含早 | 就近清淡 | 观景台机位优先 | 叠加省力慢游轴(既有条款保留) |
| 一人行 | 独立自主+安全(既有细则全保留,见下) | 青旅/安全连锁 | 一人食友好 | 三脚架/延时自拍 | 自设疲劳红线 |
一人行既有细则(实战验证,原样保留):
体力结构模式切换(常规 ↔ 省力慢游):省力慢游与玩法取向、人数结构均正交,可叠加(如"家庭+深度体验+省力慢游")。触发条件=同行者档案中有体力一般/长辈/腿脚不便/带娃成员。六维度切换侧重点:
交付前自查清单(逐项打勾才可交付):①信息全文一致(无已取消项残留)②天气已分时段③门票放票时间+预约截止已标④店铺有地址+营业状态已核⑤动线无回头路⑥预算闭合且隐藏成本有行⑦避雷全是"真实场景+应对"⑧应急 Plan B 覆盖关键环节⑨版本号/日期已更新⑩随行两件套已出(当日模式页/特产三问,见阶段3.5)⑪页面/HTML 类产物已渲染截图亲验(真机视口桌面+手机各至少一张,防自嗨式设计缺陷——2026-09-10 镇江 HTML 手机工具条遮挡实证;Playwright 可 channel='msedge' 驱动系统 Edge 零下载)⑫文案去 AI 味复核(v3.1 作者定;v3.25 升级为双通道):通道一 grep 高频词(进行/值得注意/本质/仿佛/映入/众所/首先其次/综上/绝绝子/震撼/为您/不仅…而且/此外/标志着)+ 通读标题与各板块——称谓口语化(长辈/娃,不用祖辈老人家)、无 ≥3 句书面排比、无"不像人话"的句子;出境版加一道翻译润色(v3.41):英文专名首次出现用中文+括注英文(恐龙湾 Hanauma Bay)、后文统一中文称,禁英文专名连排成句、禁括号注套括号注——机翻味主源就是专名堆叠与直译语序(国际版三册 作者 实证);通道二 humanizer-zh skill 全文过一道(协作环境已装则用,未装则跳过通道二)——重点是破折号滥用/粗体堆砌/三段式排比/通用积极结尾这类 grep 抓不到的结构性问题;🔴 路书是给普通人执行用的,不是给读者欣赏的——像朋友交代攻略的口吻,不是旅游杂志文案;方法源自 jhjs-script 去AI味禁忌表,适用于路书全部文案(含 HTML 版全部可见文本) ⑬HTML 入场动效两态实测——动效禁裸 opacity:0(必须 html.js 门控+兜底脚本),门控规则与 .in 显示规则配对同前缀(防 CSS 特异性倒挂);自查时 JS 禁用/启用两态都实测、内容两态全可见(2026-09-13 丽水实证:裸 opacity:0 依赖 IntersectionObserver,JS 挂→83% 内容不可见;首轮修复门控特异性反压 .in 规则致正常态不可见,两态实测才抓出) ⑭六维度板块齐全——吃/玩/住/行/拍/避雷逐项问"呈现在哪":允许融合呈现(避雷→温馨提示)、不允许无板块(吃→日程卡零散带过=漏维度,2026-09-13 丽水实证) ⑮景区示意图(大园区必出时):信息层六要素齐+表现层插画化过一遍(地标图标/地形渲染/胶囊标签/动线序号/图例)+手机视口截图亲验缩放可读 ⑯作息锚点——出发日与游玩日主线都取**「10 点前后」的软目标**(9 点多~10 点半都算达标,别卡死),硬时间项目不入主线(入早起包/夜游包/备选);有老人/早起者时每天有「🌅 早起包」条(2026-09-13 丽水 6:30 出发+8:00 坐船被朋友吐槽实证);(v1.16:默认 09:30—10:00 开始游玩,路书不写起床细节) ⑰博主店用透自查——命中博主探过的每家店,吃饭清单或备选池里必须有它自己的行(进不了动线的也要带店名+必点+人均/未核实标注入备选池),禁止只躺在情报档里(2026-09-15 广州顺德再犯 v3.9 半条固化) ⑱🔴每日配图齐全(HTML 交付)——数 <figure> 个数 ≥ 行程天数(每日张数=2 或 4,禁 3 张——.photos 是 2 列网格,3 张=2+1 不对称,作者 2026-09-30 定规);每张 base64 内嵌、亲验真渲染(naturalWidth>0 && rect.width>50)、四档视口(320/390/768/1280)无横向溢出;非本趟实拍的已标「(示意)」且页脚写明"实景/示意 + 图源"。这一项必须出数字,不许凭印象说"有图"(2026-09-13 丽水立规 → 2026-09-15 广州首版 0 张又漏,连漏两次;.photos 的 CSS 一直在一所以看 CSS、跑⑪⑬都发现不了) ⑲停车信息已查(自驾/租车时)——每天卡片底部 🅿️ 专条齐:停车场位置/收费/是否需换乘景交/旺季几点前有位,查不到标"以现场为准"不许留空 ⑳同一决策点全文同步——动一个时间/场次/价格/店名之前,先 grep 出该决策点在全文的所有落位(准备清单·速览·时段卡·示意图 SVG·门票表·tips/避雷·预算表·应急),一处改就全部改,判据=旧值在「活条款」里归零;判「行程外景点」必须 grep 槽位完整正文——截断窗口(只取前 30 字)本身就是误报源(汉阳造误删实证)****(⚠️例外:版本史/备注里对旧写法的引用要保留——2026-09-15 实测:把「是否 ≥ 10:00」改掉后全文仍命中 1 次,就是版本史引用了旧写法,属正当保留、别删;所以断言要锚到活条款原句,别拿裸值/裸词当判据,同踩坑 14);另加一条作息复核:把每天第一个非交通时段打出来看一眼——落在 9 点多~10 点半之间即达标,不卡分钟;只有出现「6-8 点档起床赶路」才算没过(2026-09-15 广州实证:马戏 16:30 场散在 6 处,改 5 处漏 1 处即前后矛盾) ㉑特殊时段玩法已主动提出(v3.15 作者定)——过一遍特殊时段清单(夜爬/拍星空/日出日落/晨雾/夜景亮灯/灯光秀/早市/赶海/夜市),凡命中就必须在路书里显式交代「项目+为什么非得那个点+作息代价+归入早起包/夜游包+不去拿什么补」,不许因默认晚起而静默砍掉;家庭游/自由行若确实要排早,必须写明代价并征得点头,不许默默排 ㉒家族对齐 diff(产物类交付前置闸门,v3.27 立)——交付前把家族中最接近的成品全文逐段 diff(Playwright 抽 innerText 或直接读文本对照区块措辞表),措辞/结构/文案逐项对齐,diff 出的差异逐条修或注明不修理由,报告随交付;🔴数指标(几个区块几张图)不算对比(2026-09-25 象山版实证:指标全对齐仍漏页脚/表头/措辞等 7+ 处) ㉓fail-closed 终审(v3.35,GitHub 拆解反哺,条款原创):「未核实 = 失败,不是通过」——检查项查不到结果就标 FAIL/未核实,禁止当 PASS 放行;「无法执行的检查必须声明未执行」,禁止报 0 假装通过;grep 命中的「异常」必须看上下文结构再定性(东京实证:正文无一处 480,8 处命中全在 base64 图片数据里——命中≠异常,看命中落在什么结构里) ㉔跨集群折返检查(v3.35)——每日动线对照动线图读一遍:同一天内不得跨地理集群往返;相邻两天禁同一主区域重复覆盖(对齐 v3.29「相邻两天禁同一主景点」的区域版) ㉖SVG 数量检查(v3.35)——≥3 天行程 svg 总数 ≥ 天数+1(总览+每日动线),每张六要素齐(指北针/地标胶囊/动线序号/图例/非等比标注/文字不压线);🔴(v1.13)导览图双通路定序——①手绘 SVG=兜底正路:零外部依赖(无网无 key 也能画),任何环境必须完成,禁止因"没工具"整册跳过(2026-10 实测:无网络环境下 AI 一张导览图都没出);②真底图动线图(地图瓦片底图+真实路径线)=进阶通路,工具链随后续版本发布,落地前一律以手绘为准 ㉘信息归位与作者资格(v3.37)——①抽 2-3 个高频信息(防晒/门票/预约类)grep 全文落区数:同一信息在 ≥2 个叙事区整句重复=打回归位;②成稿若含 author/推荐区块:核对作者对该目的地确有推荐资历,无资历=删区块+删导航项(资格制见阶段 3) ㉙价格类全落位扫描(v3.50)——改任何价格(门票/活动/餐饮/住宿),先 grep 该价格在 prepCard/正文 slot/门票表/预算表的全部落位逐处同步(大岛册观星团价散 4 处改一漏三、cost 表漏网被终验 gate 拦下实证) ㉚机械交付闸门(v3.51)——交付前必跑 tools/checklist.py <路书.html> --visual,输出原文贴给使用者;FAIL 不许交、SKIP 必声明
路书之外必附的两个"旅行中真正会打开"的随行件,与路书同文件或独立 HTML 均可:
9999-12-31 占位即可让「今天」判定永不命中、倒计时区常亮为默认态——零 JS 改动,档期确定后只改这两个值TRIP.start 日期自动算今天:今天高亮、已过天变灰;用户说「今天去哪」直接切当日视图,不再翻全篇路书实现参考:
作者留存的去野工作台成品(当日模式+特产三问已实装的单文件 HTML,深色 Linear 风格,含导出 JSON/当日自动对齐)。开源准备:模板_v3_build.py与数据 TRIP 对象分离,换行程只改数据重新合成。
长辈/官方 HTML 分发版四件套(2026-09-10 镇江定稿,双 AI 窗口复盘共识;面向老年人/官方群体的 HTML 路书必带)
作者留存的镇江扬州长辈版成品(CODEX 风格全令牌+功能双清单;风格产物规则=风格令牌+功能清单全带,禁止只抄视觉皮)🔴 每日配图 —— HTML 交付必带(2026-09-13 丽水约定 → 2026-09-15 广州又漏,连漏两次)
<figure> 放在 .day 里、.day-head 之后,外层 <div class="photos">(双列)或 <div class="photos single">(单列)——家族 CSS 本来就带 .photos 全套 8 条规则。https://api.pexels.com/v1/search?query=<词>&per_page=4&orientation=landscape(带 Authorization: <key>;沙箱内可达,实测 200)。Pexels 免费可商用。document.querySelectorAll('.photos img') 逐张查 naturalWidth>0 && rect.width>50 才算真渲染;再跑四档视口(320/390/768/1280)确认 scrollWidth-clientWidth==0(base64 大图最容易在窄屏撑破)。.photos 的 CSS 一直在,只是生成脚本从没产出 <figure>,于是「骨架在、内容缺」,看 CSS 或跑原四检都发现不了。→ 交付前直接数 <figure> 个数 ≥ 行程天数(进自查清单)。地名 + 核心机位/拍什么 + 预计停留分钟数;按动线顺序排列(不按类别),总行数=本趟计划打卡点总数(数量本身就是特种兵的爽点,要显性给数字:如「本趟打卡 23 个点」);复刻「集齐感」设计:预留勾选框(HTML 版可点,与勾选记忆同机制);收官行给「已完成 ___ / 计划 ___」计数位ov/cd/trip)。根因:骨架从来没写进过 skill——旅行 skill 里 id="overview"/区块/IA/侧栏 的出现次数全是 0,只有「六维度」内容要求。于是每趟要么"抄上一份"(越抄越漂:镇江差 56 字符、广州无版本标识版差 641 字符),要么从零做(直接另起模板)。<style> 里的变体钩子(<html data-variant="elder|kid|solo"> + 覆盖既有 token,不新增第二块样式表)。区块可按内容裁剪(不自驾无 #drive、无加餐玩法无 #boost),但 id 必须取自同一命名表、顺序仍按基准、导航仍由同一份 JS 生成——「少几个区块」≠「另起一套」。判据:<style> 指纹 == 基准指纹(或仅已知钩子的增量),且区块 id 是基准命名表的子集、顺序单调。 ⚠️ 现存反例:镇江扬州长辈版 3e4de99923/11319 字符、IA overview day1-5 food cost tips sos pack(多了 food/pack、缺 drive/boost/ticket/eat/gift)——属待收编对象。assets/路书_基准骨架.html(约 18KB,无 base64)。判据是「新路书 CSS 指纹 == 基准文件指纹」,不是「等于某个固定常量」——指纹随基准改动而变,基准指纹记录在该文件的 <meta name="generator"> 里。overview 总览 | drive 行·路程与停车 | day1~dayN 逐日 | boost 备选/加餐 | ticket 门票预约 | tips 提示避雷 | stay 住宿 | cost 预算 | sos 应急 | eat 美食清单 | gift 特产。intel 探店情报原档只加在自用版(追加在 gift 之后、自带第 2 块 <style>),朋友版一律没有。id="author"、置 eat 之后,遵同一命名表。行程(overview · drive · day1..N · boost)+ 备忘(ticket · tips · stay · cost · eat · sos · gift [· intel]),用 .nav-group / .nav-group--chips。<section id="drive">,但侧栏里没有它的入口——读者根本点不到「行 / 路程」那一节。骨架已补 <a href="#drive">行 · 路程与停车</a>,新路书必须带;老路书重做时一并补上。#F7F5F0 / 面 #FCFBF7 / 主字 #1C1B17 / 次 #5C594E / 弱 #8A8677 / 线 #E3DFD3 / 主色 #2F5D43 / 警示 #8A6D1F;字体栈 "PingFang SC","Hiragino Sans GB","Microsoft YaHei",system-ui,sans-serif。<script>:head 门控 + 主逻辑 + 兜底):①当日模式——TRIP 日期→dayN 映射,今天那天高亮 + 平滑滚过去(导航指示=纯文字「· 今天」,裸点已废止 v3.43),未出发给 #prepCard 加描边 ②字号三档(17/19/21px,存 <城市码>_font)③打印(#printBtn → window.print())④勾选清单记忆(.check li input,存 <城市码>_chk_<id>,点了 reload 还在)⑤滚动监听(IntersectionObserver 加 .in + 侧栏 .on 高亮,rootMargin:-30% 0 -55%)⑥返回顶部(#backtop,scrollY>600 显形)。位置契约(v3.38):head 只放门控块,主逻辑+兜底必须在 </body> 前——国际版三册曾把整套 JS 拼进 head 门控位:脚本在 body 元素生成前运行,按钮绑定全部空指针、addEventListener 静默报错,滚动高亮/当日模式全灭而页面表面正常(极难察觉,靠 Playwright pageerror 才抓到)。TRIP 日期映射 / <城市码>_font / <城市码>_chk_ / 侧栏 + 页脚 + <title> 的目的地段文字(骨架里已留 【目的地】/【当日主题】/【日期区间】/【人数结构】 占位符,漏改会在交付物里留下方括号)。城市码按城市拼音短码取,各城市必须不同(防 file:// 下 localStorage 互相污染)。#sos 区块只收跨天全局兜底(恶劣天气/突发疾病/计划全乱)——两处禁重复,措辞分工=tips 事前防坑、Plan B 事发处置、sos 全局兜底。信息归位一处(v3.37,作者定):跨区块禁整句复制——日卡只写「当时当地的行动指令」(细节多时改指针「详见提示区/门票表」)、tips 收通用防坑、门票表收价格与预约口径;同一信息出现在 ≥2 个叙事区即违规,归位=保留最合适一处、其余删或改指针(檀香山防晒 3 处/珍珠港门票 3 处实证)。跨板块归位黑名单(v1.12):门票表只收门票与园内花销(🔴禁混入大交通行——车次/航班归路程板块);应急板块只留处置方向(🔴禁塞交通衔接细节——归路程板块);每日行程卡🔴禁塞住宿信息(归住宿板块)——三犯实证:内容写进错的板块,用时两个板块都对不上。drive=每段开多久 | ticket=进门花多少 | tips=真实场景 · 提前知道(长辈/官方版用「温馨提示 N 条」)| cost=心里有数 | sos=应急 | eat=照着吃就行 | gift=回来带点啥 | boost=可选 · 更从容(写具体替代案名)。表头族:路程表=路段/里程/正常耗时/说明(含路线走向:走哪条高速哪个口下);门票表=景点/全价/长辈/小孩/关键时间;美食清单(按天分节式 · v1.12)=餐段/位置/店/点什么/人均(每节=一天,节标题=「第 N 天 · 主题」);特产三问卡=特产/是什么/哪里买/好不好带。Day 标题族:day-idx=「DAY N · M/D 周X(·节日)」,nav 链接用极简动宾(到石浦/玩海边/回家)。导航族(09-25 定):导航顺序必须=内容区块顺序(骨架 nav 曾 eat/sos 倒挂被全家族继承,已修);标签=内容标题的两字短名(总览/路程/备选|门票/提示/住宿/预算/应急/美食/特产),同字数不穿插。lead 句克制:非必要不加(住宿/美食/特产的 lead 已裁——多一句解释就多一分啰嗦)。美食清单每餐 ≥2 家可选(主推+备选,只给 1 家=偏少,09-25 作者 打回)。roadbook-double-track/scripts/consistency.py(对基准文件跑,退出码 0 才算过:CSS 指纹一致 / IA 与导航齐全 / token 齐 / 命名合规 / 无残留 【】 占位符与城市名)。日期 | 项目 | 金额 | 分类 | 备注,每晚合计当日总花费;记不清的标「待核」不硬凑;费用归位:跨城交通归目的地段、当天往返支线归主基地、返程单列;预付票按使用日记账(作者 习惯:13 号买的海昏侯票 14 号用记 14 号);支持直接解析微信/支付宝导出的 xlsx 账单(py+openpyxl,注意 UTF-8 编码防乱码)2026-08 南昌:①酒店选地铁沿线→"进城不开车"铁律 ②电竞房=雨天完美室内备胎+内容素材 ③夜景优先可成设计思路(八一馆外观/滕王阁北园全免费)④"48小时数字游民"=朋友局内容包装概念 ⑤计划变更必须全文自查("万寿宫小吃"残留教训)⑥返程勿凌晨硬开(去程已熬夜时)⑦作者 反馈:吃要给"知名店+本地宝藏苍蝇馆子"两层,只给必吃榜不够⑧作者 反馈:拍要给"机位+拍法+特殊场景参数(雨/日出/夕阳/星空)",只给机位不够⑨作者 澄清:吃的两层不是二选一而是全给(知名+宝藏都要,选择池越大越好),别理解过度砍知名店⑩作者 反馈:住要先选"住宿形态"再选区域——朋友局电竞房3人一间(能玩能睡能工作=数字游民场景实测)/特色民宿(体验+出片),别只推连锁酒店⑪作者 反馈:找店加抖音探店信源——搜"目的地+专业背书博主"(特厨隋卞→南昌毛毛饭店,实测"挺好挺推荐"),纯流量网红店要交叉验证防充值⑫行程完成度=全队最低意愿者——同行者档案必含兴趣类型(自然/人文/美食/拍照);队友两人不愿出门时一人行方案也执行不动;网图滤镜重的景点(如八一广场)先做期望值管理⑬共享单车/电动车用前先查运营区(一城一策,非统一标准)——实测对比:西安次卡全城随便骑,南昌红谷滩↔老城区过江即超区收¥10调度费、电动车断电;做路书"行"维度时把「查该品牌运营区范围」列为实查动作,跨江/跨区动线默认地铁/打车
2026-07 西北行(15天5城,长途多城模式):
①极端天气只做风险提示,不当规律套用(西北行各段倒数第二天连遇雷暴/沙尘暴属偶然巧合,非必然)→ 作者定调:核心是盯紧实查预警、恶劣天气不硬玩、安全游玩第一位;天气依赖型项目(日落/露天景区)预留室内备选或可改期空间即可
②费用归位原则:以住宿地为中心分段记账;跨城交通归"目的地段";当天往返的支线(中卫/阿拉善)归主基地段;返程独立单列 → 长途路书预算表按此结构估算,复盘时直接对位
③热门场馆三层兜底:正规替代(陕历博→西安博物院/小雁塔)+ 捡漏(退票刷新、当天临时放票)+ 替补清单(敦煌艺术馆等);莫高窟 A 类抢不到→B 类应急票 → 预约状态表必须附"约满怎么办"列
④下午场/末场票捡漏:兵马俑上午场没去成,当天 13:38 买到 17:01 末场(下午场有余票不用抢);七彩丹霞买日场末班票(19:00 前检票)守 20:30 日落时间完全够,不必买更贵的夜场联票
⑤中转联程一次取两程登机牌:非同航司也行(华夏+东航实测),行李主动问"代转运/直挂"→ 中转机场无需二次值机;路书写中转行程时必提醒
⑥景区散场打车难预案:鸣沙山散场 30 分钟无网约车 → 免费巴士/¥6 大客车回城;戈壁/远郊景区路书必须预埋"散场交通备选"
⑦酒店多晚拆单比价:敦煌同一酒店分三单订共 ¥1206,其中一单立减 ¥71 → 订 2 晚以上时拆单+不同日期组合比价
⑧极端天气备选库三标准:半室内/不依赖天气(落日、能见度)/仍出片 —— 风沙天砍雅丹西线改光电博览园(¥60 半天、含讲解、镜阵震撼)是教科书案例
⑨季节敏感景观用近期实拍视频验证:草原雪山线靠近一周实拍视频发现"雪山很远、雪不多"后果断取消整段 → 雪山/花海/红叶/草原类项目出发前必验,不符预期果断砍,沉没成本不追
⑩星空计划必查月相:盈凸月 75-80% 过亮,连排三晚全废 → 排星空机位时先查月相+月落时间,满月前后一周直接不排
⑪长途多城节奏:15天 = 3-4 晚深度段(张掖3/敦煌4)+ 1-2 晚过渡段(兰州2)+ 每段留缓冲日;交通日不排重项目
⑫平原古城共享单车次卡:西安非机动车道宽,3天5次卡 ¥4.9 覆盖洒金桥/城墙/博物院,市内交通最优解之一
⑬戈壁补水:酒店免费水带走 + 蜜雪冰城无糖柠檬水;峡谷徒步"该补充能量就补充",别硬扛
⑭离城日动线:最后一个景点排在车站方向、行李随身玩完直接送站(岩画→银川站),省一趟折返;低价值经停点果断跳过改直达(跳嘉峪关),把时间让给深度段
⑮远观型景点路边机位替代入园(西夏王陵远拍双陵省¥75);日落+夜景类串成一条傍晚动线(中山桥日落→步行过桥→白塔山→蓝调夜景,与南昌"三夜景连打"同一思路)
⑯高温城市正午不排户外(西安38℃时酒店休整到19:30后出门);纯日落依赖型景点阴天直接取消、改晴好傍晚补拍(览山公园),别硬去
⑰订票冷知识:「停止检票」≠闭园(丹霞19:00停检,入园后可待到日落乘末班车出园);多日多次入园票性价比高(鸣沙山3天票¥110刷脸无限次);热门入口卖完找冷门替代入口(文昌门替代永宁门);新开通高铁线路有时间红利(西十高铁开通武汉→西安省2h,出发前查最新开通线路);支线高铁"一日一图"以12306当日查询为准
⑱住宿选址=动线锚点:多景区分散的段选高铁站/交通枢纽旁(张掖西站店去丹霞/平山湖/赴敦煌三方向都顺)——与南昌"地铁沿线"同一原则
⑲拍摄增量:地标免费机位找对面商场高层观景台(开元商城5楼拍钟鼓楼同框,视野远好于地面);灯光类景点先查亮灯时间再逛
⑳找店增量四招:本地人美食街替代游客街(洒金桥>回民街);问正在吃的店主推荐下一家(肥肠店老板推荐有奴思烤肉,实测靠谱);锁定一家"安全店"复购保底(美云串炸三刷);早餐型地方美食赶早(牛肉面下午关门);机场/景区的异地名店分店普遍缩水(中川机场张记不如西安本店)
㉑记账校验法:以每日费用表为锚,分类汇总表按每日合计反推、加总闭合校验(张掖/敦煌两处账单勘误均靠此法);零星未记账支出标"待核"留口,不硬凑数
㉒装备与应急:大景区日中午易错过饭点,必备干粮+大水(五湖/丹霞/平山湖三天都中招);高空风敏感项目(索道/滑索)下午风大可能停运,优先上午玩;雷暴天网约车排队→扬招出租车走高速是有效备选;野导游搭讪带去假景点(兵马俑《梦回大秦》),认准官方讲解服务中心
㉓口径变更重扫:口径/标准/红线升级后,此前基于旧口径的通过项全部失效重扫——复核批准是相对于口径基线的(2026-09-26 武汉素材稿真名×20 漏抓实证:口径升级后未重扫第一轮放行区)
㉔对外稿脱敏归零:对外稿(HTML/发布版)渲染后 grep「作者|内部代号|博主个人消费账单」必须 0——信源列删或转图标(🎬探店实拍),他人消费隐私细节一律不留
㉕餐行机械钩(v3.29):交付前逐日数早/午/晚行并报数(v3.22 三犯:广州/宁波/武汉 5 天全漏)
㉖派生首检(v3.29):指纹核对+title 即改(武汉 title=「基准骨架」直接成稿实证)+ navLock 存在性(v3.37)——派生出的稿 JS 必含 navLock(导航双通道为 2026-09-27 起骨架标配,缺失=从旧骨架派生,立即换 assets/路书_基准骨架.html 重派;国际版三册旧导航实证)
㉗点名店核销(v3.29):逐家勾销、交付报 N/N(武汉来菜丢失实证)
㉘相对时间禁令(v3.29):成稿 grep「现在|今天|明天」必须 0,一律改绝对日期
模式通用·特种兵暴走(v2.2 并入,非行程经验=模式知识):①第一杠杆是省掉住宿——夜车过夜(硬座/动车卧铺)把房费压到 0,确需落脚选青旅/钟点房/24h 快餐店休整②学生证半价必查(景区门票+车票常有,逐点核实)③免费点密度优先选城——免费机位+免费馆+citywalk 串联,预算大头压到吃和交通④时间极压缩:周五晚出发周一早八回,日行 3 万步+晚睡 3h 是常态,但雷暴/高温红色预警仍砍户外(安全铁律不豁免)⑤夜车防睡过站:设多个闹钟+邻座互叫+到站前 30 分钟醒⑥凌晨到站城市安全:选亮灯便利店/24h 快餐店休整,不深夜独行偏僻处⑦赶场误车风险:跨城车次留 ≥1h 缓冲、末班车前 1h 必须到站台⑧打卡照重「证明来过」与集齐感,器材轻、合照为主⑨周末错峰消费对半打折⑩预算诚实铁律仍适用——夜车省下的住宿如实记为 0 而非估算,隐藏成本(饮水/防暑药/充电)照单列⑪体力红线(v3.24 作者定):日行 3 万步是参照不是承诺;连走 2 天第 3 天排半天缓冲
模式通用·一人行独行(v2.2 并入,非行程经验=模式知识):①拍照没人帮拍是核心痛点——三脚架+延时/自拍杆/八爪鱼支架刚需,合照请路人前给清构图与焦点②一人点菜难→小吃/快餐/商场食阁/一人食友好店(吧台半份)③住选有前台+电梯监控的安全连锁或青旅,不订偏僻无前台民宿④夜归只走亮灯主干道/24h店,只叫平台车不路边黑车⑤行李寄存(车站/商场)解放双手冲景点⑥自设疲劳红线(日行步数上限+最晚回程),无人踩刹车防透支⑦报平安节奏固定(到点发定位给家人)⑧常用药+旅行险必备,一人不适无人照顾⑨独行可叠加深度/特种兵任一玩法,机位与避雷按叠加模式取并集
模式通用·省力慢游(v2.3 新增,非行程经验=模式知识):①代步工具(缆车/索道/观光车/接驳车/电梯)是刚需预算不是可省项——逐景点实查票价+末班+排队时长+是否直达核心观景②经典路线给"省力版":车直上→核心观景→车下或缓坡下,下楼梯伤膝盖宁可都坐车③节奏=半天一个点+午休刚需,日行步数按其上限 70% 排留余量④台阶数提前查(搜"景点+台阶"近期游记),台阶多直接换替代点不硬爬⑤门口到门口交通优先(打车/自驾),地铁换乘 ≤1 次⑥住=电梯房/低楼层+近交通点+含早⑦吃就近优先,名店排队久站=换备选池近店⑧无座椅长排队/台阶陡坡/厕所远/正午无遮挡=隐藏雷区逐一排查⑨慢病成员的高海拔/高温/久站项目先过健康红线(安全第一位铁律不豁免)⑩同行者状态每天一问、动态砍项不硬撑——行程完成度=全队最低体力者(与"最低意愿者"并列,南昌脚伤队友实证)
Last scanned: 9/27/2026
{
"issues": [
{
"file": "SKILL.md",
"line": 18,
"type": "dangerous-command",
"message": "Dangerous command (writes to Claude config): \"> **安装**:整个目录(SKILL.md + assets/ + tools/)复制到 `~/.claude/\"",
"severity": "medium"
}
],
"status": "PASSED",
"scannedAt": "2026-09-27T09:51:25.319Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}See how jianhao-travel-planner compares with popular alternatives.
让 AI 按统一流程查资料、排行程,制作可在手机和电脑查看的旅行路书。
English: README.en.md — what this is, what you get, and how to install it in any AI agent.
📖 开始使用 · 🖼 看成品示例 · ⬇️ 下载稳定版 · ❓ 遇到问题 · 零基础教程
开源技能包,需配合 AI 助手使用 · 统一模板 · 事实核查流程 · 机械检查工具 · MIT
一套「出行路书」工作流:你说"想出去玩",它按固定流程采集需求 → 联网实查 → 产出路书(md 事实源 + 单文件 HTML 双版本:本地完整版断网可开 + 瘦身在线版一键部署)+ 美食情报卡(按城市持续追加的数据资产)。
[!TIP] SKILL.md 的版本史是精华——每条规矩背后都是一次真实翻车(图注落位对 ≠ 图内容对、数指标不算对比、价钱是挂牌价不是实付价……),建议通读,比规矩本身更值钱。
tools/checklist.py 机械检查清单(随版本演进,以工具输出为准),AI 交稿前必跑——你也能一键验收 AI 有没有偷懒。注意:机械检查通过 ≠ 关键事实(交通/票务/价格)已核验,出行前请按路书内的核实状态标注复核| 板块 | 内容 |
|---|---|
| 总览 | 一句话行程 + 天气 + 出发前倒计时(勾选式)+ 装备清单 + 总览导览图 |
| 路程 | 交通方式怎么选 + 路程总表(里程/时长)+ 支付提示 |
| 每日行程 | 半小时级时段卡 + 实拍图 + 当日导览图 + 交通/机位/雨天方案 |
| 门票预约 | 多档价格 + 预约与放票口径 |
| 温馨提示 | 真实场景 + 应对,不写正确的废话 |
| 住宿 | 选点逻辑 + 退房时间 + 订房三问 |
| 预算 | 三档概览 + 逐项明细 + 隐藏成本 |
| 应急 | 全局兜底 + 紧急电话与领事保护 |
| 美食清单 | 按天按顿给店 + 必点 + 人均 |
| 特产 | 带什么 + 在哪买 |

海岛型目的地的路程板块——租车 / 公交 / 打车分层给方案,行程要素按目的地自动换挡

埃及 7 天文化线·出境四件样张:热门未排目的地的取舍说明 / 出入境与支付分层 / 双币种预算(含税实付口径)/ 应急领保——行程与个人信息已脱敏,完整条款见 SKILL.md「出境册附加条款」
安装后,跟 AI 说这些话会自动触发本 Skill:
去哪玩 / 旅行攻略 / 周末去哪 / 做攻略 / 行程规划 / 自驾方案 / 当日行程 / 今天去哪 / 特产推荐
🐣 完全没接触过 Claude Code? 直接看 零基础跑通指南 TUTORIAL.md——从装 AI 助手到拿到第一份路书,每一步带自检。
解压后你会得到一个 jianhao-travel-planner 文件夹(别改名),把它整个放进 skills 目录:
~/.claude/skills/(Windows 即 C:\Users\<用户名>\.claude\skills\)<项目>\.claude\skills\git config core.hooksPath tools/githooks——之后任何 push 前自动核对文件清单,白名单外会被硬拦截。装好后的路径应该是 …/skills/jianhao-travel-planner/SKILL.md。放对之后,跟 AI 说"周末想去 XX 玩"就会被自动触发。
这个技能包本质是一个文件夹 + 一份工作流文档,不绑定任何特定 AI。其他 AI 助手(任何能读文件、能联网的 Agent 环境)通用安装法:
jianhao-travel-planner 文件夹原样放进 AI 的工作区(或直接把文件夹拖给它)「这是一个旅行规划技能包。先完整阅读 SKILL.md 全文再动手,禁止把它改写成摘要或精简入口文件——工作流全文就是执行正文。然后按阶段 0 先向我提问(出发地/日期/人数与关系),确认需求后再开始。」
assets/(基准骨架)和 tools/(检查脚本)保持原目录结构,AI 制作路书时会用到⚠️ 为什么不许摘要改写:实测有 AI 环境把 93KB 工作流正文塞进附录、自写了个摘要入口——阶段 0 提问条款、交付自查清单全被埋掉,做出的路书出发地默认错误、零提问直接开工。全文在,条款才在。
💡 如果 AI 没问你就开始做路书,把这句发给它:「按 SKILL.md 阶段 0 先向我提问(出发地/日期/人数与关系),确认后动工——你的开工前置闸漏执行了。」
📝 需求一次说全体验最好:出发地 + 日期窗口 + 几个人什么关系 + 有无特殊成员。说"我要去山东玩 5 天"它也会追问,但一次说全省一轮。
目录结构(缺一不可):
jianhao-travel-planner/
├── SKILL.md ← 工作流正本
├── assets/ ← 路书+情报卡两份 HTML 基准骨架
└── tools/ ← consistency.py(骨架校验)+ desource.py(脱敏)
⚠️ 已有同名包? 如果 skills 目录里已存在
jianhao-travel-planner文件夹,本包拷入会覆盖它(作者的自用版叫travel-planner,不同名、不受影响)。
路书要求"每天都有图"——不配图过不了交付自查清单第⑱项;但配图渠道完全可选,任选其一即可满足:
.env(PEXELS_API_KEY=你的key)或环境变量,适合氛围空镜——key 只是图源之一的选择项,没有它走默认图源即可非实拍图标注「(示意)」、页脚写明来源即可。
不想折腾安装?Releases 页提供打包好的稳定版 zip(含技能规范与全部工具);主分支为最新开发态,两者可能不同步——使用以 Releases 为准。
v1.17 起随包提供完整生成工具链——不想让 AI 走整套技能流程的话,也可以按 schema.md 填写 trip_data.json(可交给任意 AI 按 schema 代填)。推荐用随包统一入口一条链跑完(数据校验 → 生成 → 导览图注入 → 最终成品检查,自动按序执行并计时);带 --visual 连视觉验收(桌面/手机双视口 + 图渲染逐张确认)一起跑:
py tools/pipeline.py full fixtures/demo/demo_full.json 我的示范册.html --visual
也可分步执行(顺序重要——导览图注入后必须再做最终成品检查):
py tools/validate_trip_data.py 你的trip_data.json # ① 数据闸(V01-V22:引用/枚举/日期对齐/费用三态/时刻单源等)
py tools/gen_roadbook.py 你的trip_data.json 路书.html # ② 生成(骨架指纹校验,天数自适应)
py tools/apply_routes.py 你的trip_data.json 路书.html # ③ 导览图注入(有 routes 时执行;无 routes 自动跳过)
py tools/checklist.py 路书.html --visual # ④ 最终成品检查(注入后的最终页面,FAIL 清零才交付)
| 样本 | 用途 | 成品检查预期 |
|---|---|---|
fixtures/demo/demo_full.json |
完整示范:第一次跑通用它——虚构 3 天册,含导览图、7 张虚构示意配图与全部板块 | 四步(含 --visual)跑完 FAIL 0,7/7 配图真渲染 |
fixtures/synth/book3/8/10.json |
最小合成样本:只用于测试链路(内容空壳/配图不足属预期) | 内容类 FAIL 属预期,非上手示范 |
fixtures/good_full.json |
校验演示:演示数据规则(不可渲染生成) | 仅数据闸 |
fixtures/synth_abroad_sample.json |
出境格式样本(跨日红眼/时区/双币种) | 配合 test_abroad 使用 |
py tools/test_synth_regression.py;出境格式:py tools/test_abroad.pyfixtures/synth_abroad_sample.json(跨日红眼/时区/双币种)checklist.py --visual 的视觉检查可选装 Playwright(缺失自动 SKIP 声明)打开 SKILL.md 末尾的「用户档案(填空模板)」,复制填写你自己的偏好(出发地/口味/作息/同行者常态),填完这套 skill 就"认识"你了。信源名单不用预置——它会用大众点评+高德+小红书交叉验证,你在旅途中刷到靠谱探店内容可以补进自己的名单。


开源次日的抖音介绍视频:12.6 万播放 · 2889 收藏(数据截至 2026-09-30)
当前 v1.19(2026-11-03)。最近两版要点:
QUICKSTART.md 一页纸入口、标准模板、pipeline new/outline、fetch_imagesv1.0 起的逐版记录在 CHANGELOG.md。稳定包以 Releases 为准,主分支是开发态。
jianhao-travel-planner is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by awangwang123. 出行路书工作流 skill:联网实查 + 多源交叉验证,产出可核验、能执行的旅行攻略。覆盖吃住行游拍避全维度,附美食情报卡、基准骨架与校验工具,支持一键部署在线版。. It has 439 GitHub stars.
Yes. jianhao-travel-planner passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/awangwang123/jianhao-travel-planner" and add it to your Claude Code skills directory (see the Installation section above). jianhao-travel-planner ships a SKILL.md manifest, so compatible agents can discover and load it automatically.
jianhao-travel-planner is primarily written in Python. It is open-source under awangwang123 on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh jianhao-travel-planner against similar tools.
No comments yet. Be the first to share your thoughts!