跟团游全站同步 + 怎么玩日更 · 部署与运营说明

适用版本:爱旅游官网 v12 定稿版(2026-11-19 交付) | 无需数据库、无需第三方依赖

921收录线路(全站 ERP 提取)
342近 6 个月有团期
772本地化主图(WebP,已裁 16:10)
2 篇/天怎么玩新增图文
995sitemap 收录 URL

一、这次交付改了什么

跟团游由原来的 14 条演示线路,扩到 全站 921 条:主题、出发地、天数三维筛选;每页含每日行程、行程特色、费用说明、真实行程图、报名须知、同主题推荐,并全部带结构化数据(TouristTrip / Offer / FAQPage / BreadcrumbList / TravelAgency)。

怎么玩原来每城 3 篇的静态攻略保持不变;新增「每日新攻略」——每天自动追加 2 篇图文,直接排进「怎么玩」栏目页与对应城市页,不新开栏目、不叫「榜单」。

推荐区栏目页与 24 个城市页各加一块「今日推荐」:每日新文章 + 爱侣游商城在售套餐 + 跟团游线路 三栏并列,随每日任务自动重建。城市页优先展示该城市出发的线路,其次该城市作为目的地的线路,商城套餐按标题城市命中优先、不足时用全省套餐补齐。

已下线此前的独立「每日榜单」栏目(含 /rank/ 目录、导航入口、数据文件)已移除;rank_update.php 保留为空壳返回 410,避免旧计划任务报错。

二、新增/变更的文件清单

文件作用是否需改
tour/index.html跟团游栏目首页:921 张卡片 + 主题/出发地/天数三组筛选自动生成
tour/t*.html921 个线路详情页自动生成
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.json33 家泉质评定温泉的公开数据(日更文案的数据底稿)可增补
play/data/editorial_plan.json24 城轮换计划(每天 2 篇的选题顺序)可调整
auto_update.php总调度:商城/房源 + 跟团游 + 日更,一条计划任务跑完已接好

三、服务器要求与上传

项目要求
PHP7.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)

2)怎么玩日更(play_daily.php)

六、内容口径与合规红线(必须保持)

三条不能破的规矩

另外:文案中的绝对化用语(最大/唯一/最好等)已在渲染时统一软化为「居前/较…」;温泉功效只讲水质参数与体感,不做疗效承诺。

七、日志与自检

文件看什么
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。

九、验收清单(部署后逐项打勾)