一、这次交付改了什么
跟团游由原来的 14 条演示线路,扩到 全站 921 条:主题、出发地、天数三维筛选;每页含每日行程、行程特色、费用说明、真实行程图、报名须知、同主题推荐,并全部带结构化数据(TouristTrip / Offer / FAQPage / BreadcrumbList / TravelAgency)。
怎么玩原来每城 3 篇的静态攻略保持不变;新增「每日新攻略」——每天自动追加 2 篇图文,直接排进「怎么玩」栏目页与对应城市页,不新开栏目、不叫「榜单」。
推荐区栏目页与 24 个城市页各加一块「今日推荐」:每日新文章 + 爱侣游商城在售套餐 + 跟团游线路 三栏并列,随每日任务自动重建。城市页优先展示该城市出发的线路,其次该城市作为目的地的线路,商城套餐按标题城市命中优先、不足时用全省套餐补齐。
已下线此前的独立「每日榜单」栏目(含 /rank/ 目录、导航入口、数据文件)已移除;rank_update.php 保留为空壳返回 410,避免旧计划任务报错。
二、新增/变更的文件清单
| 文件 | 作用 | 是否需改 |
|---|---|---|
tour/index.html | 跟团游栏目首页:921 张卡片 + 主题/出发地/天数三组筛选 | 自动生成 |
tour/t*.html | 921 个线路详情页 | 自动生成 |
tour/images/ | 772 张主图(WebP,640×400,合计约 32MB) | 自动更新 |
tour/tour_products_full.json | 线路主数据(页面渲染的唯一数据源) | 自动生成 |
tour/tour-data.json / tour-details.json | 供 AI / 搜索引擎读取的结构化数据接口 | 自动生成 |
tour_render.php | 页面渲染器(模板、CSS、结构化数据都在这里) | 改样式时改 |
tour_update.php | 线路同步:拉 ERP → 存图 → 重渲染 → 更新 sitemap/llms | 配置项已填好 |
play_daily.php | 怎么玩日更:每天生成 2 篇图文并挂进栏目/城市页 | 配置项已填好 |
play/data/true_springs.json | 33 家泉质评定温泉的公开数据(日更文案的数据底稿) | 可增补 |
play/data/editorial_plan.json | 24 城轮换计划(每天 2 篇的选题顺序) | 可调整 |
auto_update.php | 总调度:商城/房源 + 跟团游 + 日更,一条计划任务跑完 | 已接好 |
三、服务器要求与上传
| 项目 | 要求 |
|---|---|
| PHP | 7.4 及以上(推荐 8.1/8.2),需 curl、gd(或 imagick)、mbstring、json、openssl 扩展 |
| 目录权限 | tour/、play/data/、根目录可写(755/775) |
| Web 服务器 | Apache/Nginx 均可;建议开启 gzip/br 压缩(栏目首页 HTML 约 800KB,压缩后约 60KB) |
| 上传方式 | 解压后的文件直接放到站点根目录(与 index.html 同级),不要多套一层文件夹 |
| 伪静态 | 不需要;全部为真实静态文件 + 少量 PHP 脚本 |
四、每日自动更新:只加一条计划任务
站点已有一个 auto_update.php 计划任务(原来负责商城与房源同步),本次把跟团游与日更串进同一条,不再新增任务。
# 宝塔面板 → 计划任务 → Shell 脚本,每天 03:10 执行一次
cd /www/wwwroot/你的站点目录 && /www/server/php/81/bin/php auto_update.php >> auto_update.log 2>&1
执行顺序(脚本内部已串好):商城/房源同步 → 跟团游同步(tu_run())→ 怎么玩日更(pd_generate())。任一步失败不影响后续步骤,日志里能看到是哪一步。
手动补跑
# 只跑跟团游
php -r 'require "tour_update.php"; tu_run();'
# 只跑某一天的日更(补发/重发)
php -r 'require "play_daily.php"; pd_generate("2026-11-20");'
五、每天到底会自动做什么
1)跟团游同步(tour_update.php)
- 登录 ERP,按月拉取未来 6 个月的团期与价格(
groupByType=1,按线路聚合,最省流量)。 - 新增线路自动建档、拉详情(每日行程/特色/费用/图)、下载主图并压成 WebP。
- 窗口外没有团期的老线路 不删页,只打上「季节线路·可定制」标记,保留历史流量。
- 价格 / 团期 / 图片有变化的线路,按内容指纹只重渲染变化的那几页,其余不动(省 CPU,也避免无意义的最后修改时间变动)。
- 同步更新
sitemap.xml与llms.txt / llm.txt。
2)怎么玩日更(play_daily.php)
- 每天 2 篇图文,全部落在「怎么玩」栏目内,插入位置固定:栏目页在「按城市逛」之前,城市页在「攻略」之前。
- 选题按
editorial_plan.json的 24 城顺序轮换,每日两篇配套:城市温泉怎么选 + 城市周末线路榜;全省级选题(真温泉名单、泡温泉须知)作为轮换起点。 - 文案为榜单式图文:按城市分组、带完整数据表(泉温/pH/氟/偏硅酸/等级)、带「怎么看」解读段落,不是罗列链接。
- 数据全部来自公开可核验来源(广东省温泉行业协会泉质评定名单)与本站在售线路,来源在文末可点击。
- 推荐区同步:「怎么玩」栏目页与 24 个城市页都有一块「今日推荐」,由同一脚本每天重建——左栏最新攻略、中栏爱侣游商城在售套餐、右栏跟团游线路(城市页优先该城出发,其次该城目的地线路,外省目的地无对应线路时不硬凑)。即使当天不生成新文章,也会刷新这块,保证商城与线路变动当天就体现。
六、内容口径与合规红线(必须保持)
三条不能破的规矩
- 不做在线支付:全站无购物车、无支付按钮,只做展示与引流,成交走电话/微信 + 线下签约。
- 价格一律「以电话/微信确认为准」:页面价只写「参考底价」,不承诺最终价、不写「最低价」「全网最低」。
- 不编造:ERP 没给的(如费用包含明细)页面明确写「源资料未逐项列明,以合同约定为准,页面不作推测」,不自行补写。
另外:文案中的绝对化用语(最大/唯一/最好等)已在渲染时统一软化为「居前/较…」;温泉功效只讲水质参数与体感,不做疗效承诺。
七、日志与自检
| 文件 | 看什么 |
|---|---|
tour/tour_update.log | 每次同步的线路数、新增详情、新增图片、重渲染页数;结尾一行 完成:… 为成功 |
play/data/play_daily.log | 当天生成了哪两篇、注入到哪些页面 |
tour/.render_state.json | 每页内容指纹;想强制全量重渲染,删掉它再跑一次即可 |
tour/.tour_update.lock / play/data/play_daily.lock | 防并发锁;脚本异常中断后若残留,删掉即可恢复 |
每天跑完建议抽查:/tour/ 卡片数是否变化、随机点开 1 条线路看团期与价格、/play/ 顶部是否出现当天新文章。
八、常见问题
| 现象 | 处理 |
|---|---|
| 日志出现 ERP 登录失败 | ERP 账号可能被改密或被风控。把 tour_update.php 顶部 TU_USER / TU_PASS 改成最新账号;连续失败先停一天再跑,避免触发限制。 |
日志出现 SSL: UNEXPECTED_EOF / 连接超时 | ERP 侧短时限流或网络抖动,属临时问题,次日自动重试即可;连续 3 天出现请联系 ERP 服务商。 |
| 新增线路没有图 | ERP 侧图片为空或文件名含空格/中文。脚本会回退到详情图,仍失败则该页用统一占位图,不影响页面打开。 |
| 某条线路已下线但页面还在 | 属预期:无团期的线路会被标成「季节线路·可定制」保留页面。确实要删,直接在 tour/tour_products_full.json 移除该条并重渲染。 |
| 日更文章重复 | pd_generate(日期) 有幂等判断,同一天重复执行不会生成第二篇;要重发先删 play/data/daily_articles.json 里对应条目。 |
| 想改价格展示方式 | 只改 tour_render.php 里的 tr_price(),然后跑一次全量重渲染,不要直接改 921 个 HTML。 |
九、验收清单(部署后逐项打勾)
- 打开
/tour/:页面显示 921 条,筛选「温泉 / 广州 / 2天」结果数与卡片一致,空结果有提示。 - 随机点开 3 条线路:每日行程有分段、价格标注「参考底价」、电话可拨、底部有同主题推荐。
- 打开
/play/:顶部「每日新攻略」有当天 2 篇;点进城市页,同样能看到当天文章。 - 「今日推荐」三栏齐全:攻略带日期、商城卡片点开进商城、跟团游卡片点开是线路详情页;城市页的线路都是该城出发或该城目的地。
- 手机打开任意页:图片不溢出、卡片单列、电话按钮可点。
- 访问
/sitemap.xml:能打开,/tour/t条目 921 条。 - 手动跑一次
php auto_update.php,日志结尾为「完成:…」,页面无 500。