diff --git a/docs/maintenance/ADVERTISING.md b/docs/maintenance/ADVERTISING.md index cb1ffc5c..482d64a5 100644 --- a/docs/maintenance/ADVERTISING.md +++ b/docs/maintenance/ADVERTISING.md @@ -4,7 +4,7 @@ ## 当前实现 2026-10-31按用户新要求新增统一机场推荐表/手机卡片,本地覆盖资源正文旧福云推荐区及所有教程末尾。价格、网址、优惠码的唯一配置与验收见[统一机场推荐](AIRPORT_RECOMMENDATIONS.md)。未部署线上;下列整图广告保持原行为。 -2026-10-31按用户要求更新HN整图为 `hn-ad-refined-20261031.png`:删除底部绿字,白字改为“硬核架构,品质专线,全球网络畅通无阻”,品牌和文案两行重新居中并调整比例;侧栏旧福云广告组件 `banners.blade.php` 已停止输出,首页/文章/列表共用调用保留空组件。HN仍在文章正文后、标签前,满行2.45:1、无扫光,正式跳转hardnerd.net。DPL/FUC新版整图仍未发布。Git提交、服务器验收和回退以[HN正式发布记录](HN_AD_RELEASE_2026-10-30.md)为准。以下历史段落中的“未部署”仅描述原日期状态。 +2026-10-31当前正式广告区已改为单张随机展示:DPL、HN、福云三张每次打开/刷新独立等概率选一张,允许连续重复。保留HN新版白字、旧福云侧栏撤除和TG图标。页面缓存保持原逻辑,随机在浏览器执行,不新增接口请求;三张候选存放原生template中,仅选中图片进入活动DOM并加载。详情及回退见本文“单张随机广告”。此前“DPL/FUC未发布”和多图堆叠仅描述历史状态。 2026-10-28新增FUC(福云)整图广告,顺序DPL→HN→FUC,三张上下各占一整行。FUC参考当前新版 `fuc-new.loc` 的静态源码:HomeController→index.tpl访客转auth/login;登录和用户区使用 `public/fucai192.png` 渐变紫色福字、Cool/Vuexy浅色界面及 `#7367f0` 紫色按钮。旧营销模板仅作“全球网络中继服务,随时随处尽情使用”文案来源。自动审批依据FUC AGENTS禁止运行真实配置Web入口而拒绝直接打开首页,本次未运行该入口或访问FUC线上;实际设计依据为只读模板/CSS/原始Logo。 @@ -104,3 +104,15 @@ ## 资源正文引导与TG入口(2026-10-31) 导航使用 `components.telegram-link`:桌面右侧GitHub前增加纸飞机SVG,手机右上角同样提供入口,36px点击区、20px图标、说明标签和新窗口安全属性;不加载远程图标。链接沿用当前文章已有的 `https://t.me/clashfreenode`,配置 `community.telegram_url` / `COMMUNITY_TELEGRAM_URL`。不点击频道,不发送消息。原GitHub导航入口保留。 生产模板由现场版本定点修改,本地额外的机场推荐功能未随任务发布。应用提交 `de6b931823b3fe49811d1026393c38f073480054`,分支 `codex/tg-header-20261031`,恢复点 VPS-003 `/root/backups/cfn-tg-header-20261031`。回滚只撤销本次五个应用文件增量,保留其他聊天后续提交。单测2项4断言通过,32项服务器HTML/配置检查通过、0失败,覆盖两个栏目的最新/最早文章及首页/列表/教程。已完成服务器侧验收,未做线上页面验收;回执见 `output/tg-header-20261031/verification.json`;文档同步提交仅改本专题。 + +## 单张随机广告(2026-10-31) + +用户确认每次打开只随机展示三张之一,并要求不影响页面渲染/速度。组件 `components.article-ads` 使用配置启用、URL存在、素材存在的候选;正式补齐DPL/FUC配置及对应网站风格素材,HN使用已发布refined版。JS在浏览器独立抽样,页面HTML缓存不固定选择;返回/前进命中bfcache时通过pageshow.persisted重新抽取,无定时轮播和接口请求。不保证每次不同。 + +所有图片候选放在原生template内,未选中图片不进入活动DOM、不请求;仅克隆一个链接+图片。脚本源 `public/js/random-article-ad.js` 不到1KB,内联进已有缓存HTML,不额外发起JS请求。独立CSS `public/css/random-article-ad.css` 替代旧HN广告CSS,总体仍为单个广告样式请求,2.45:1比例和圆角保留。关闭JavaScript时noscript展示首个有效候选;全部停用或缺图时无广告。不做访问统计或追踪。 + +配置沿用 `advertising.{dpl,hn,fuc}.enabled/url`;生产三者链接分别dp-link.net、hardnerd.net、福云123.com。DPL_AD_ENABLED / HN_AD_ENABLED / FUC_AD_ENABLED 可独立停用。线上文章模板定点切换为汇总组件,没有发布本地额外机场推荐逻辑。未改数据库、响应缓存策略或Vite构建。 + +应用提交 `cb8cd8467a8a61ef09deaa9a24c78e4c4dbed3f4` 已Git推送 `codex/random-ad-20261031` 并正式检出;恢复点 VPS-003 `/root/backups/cfn-random-ad-20261031`。回滚只撤本批增量,可先将show模板切回独立HN组件;不得整库/整站回退覆盖并行更新。 + +本地真实Blade组件隔离页已在浏览器验收:桌面760×310、390视口342×140,无横向溢出;活动DOM始终单图,观察到HN→福云变化,CDP网络仅一次选中福云图片请求。3项脚本测试通过,覆盖三个抽样区间、bfcache恢复、单个/零候选。截图与证据见 `output/random-ad-20261031/`。56项生产服务器HTML/资源检查全部通过,回执 `verification.json`;已完成服务器侧验收,未做线上页面验收。文档后续部署不改变应用文件。