119 lines
19 KiB
Markdown
119 lines
19 KiB
Markdown
# FNA_V3 文章推荐广告
|
||
|
||
## 当前实现
|
||
|
||
2026-10-31按用户新要求新增统一机场推荐表/手机卡片，本地覆盖资源正文旧福云推荐区及所有教程末尾。价格、网址、优惠码的唯一配置与验收见[统一机场推荐](AIRPORT_RECOMMENDATIONS.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。
|
||
|
||
图片 `public/images/ads/fuc-ad-site-style-20261028.png`（1962×801），内置image_gen生成；提示词 `codex/output/fuc-ad-site-style-20261028-prompt.txt`，Logo参考归档 `codex/output/fuc-logo-reference-20261028.png`。新增组件 `fuc-article-ad.blade.php`，汇总组件增加FUC显示判断；配置 `advertising.fuc.enabled/url`，支持 `FUC_AD_URL` 覆盖，默认采用GemDocs当前主站 `https://xn--123-9i9dj97q.com/`（福云123.com），不使用旧fuuu.cloud。无外部资源加载、无扫光，整图链接带sponsored/noopener/noreferrer和键盘焦点轮廓。
|
||
|
||
FNA_V3本地页面已验收三图加载、顺序和href；桌面各624×255、390px视口各322×131，无横向溢出。截图 `codex/output/fuc-site-style-preview-20261028.png`。未点击落地页，未改文章内旧福云文字、FUC源码/业务数据或线上配置，未提交、推送或部署。
|
||
|
||
2026-10-28用户认可DPL网站风格版，并要求HN同样参考网站重设计。本次只读查看 `http://hn.loc/` 当前EZ首页：深炭灰背景、柔和绿紫光晕、渐变品牌字及简洁居中构图。新版 `public/images/ads/hn-ad-site-style-20261028.png`（1962×802）通过内置image_gen参考首页截图和原广告图生成，保留无方框的眼镜H图形及Hardnerd首字母大写，采用首页文案“探索全球网络无限可能”和“了解 HN”。提示词 `codex/output/hn-ad-site-style-20261028-prompt.txt`，参考截图 `codex/output/hn-site-style-reference-20261028.png`；旧纯黑图保留供回退。当前先接入本地供用户看效果；本地实测两图均624×255、加载成功且无横向溢出，页面截图 `codex/output/hn-site-style-preview-20261028.png`；广告位、链接配置与无扫光行为不变，DPL已认可版不变。GemDocs当前HN档案已登记2026-10-27独立上线，旧文“域名停放”属于历史状态；本任务未访问生产，也未将本地广告默认链接改到线上。未提交、推送或部署。
|
||
|
||
2026-10-28当前DPL广告按用户要求参考DPL网站重新设计，替换不获认可的蓝白玻璃版。已现场只读查看 `http://dpl.loc/`，并核对 `xb/stellar/src/views/Landing.vue` 与 `landing.css`：深蓝黑底、蓝紫渐变标题、细网格、轨道与悬浮线路卡片。当前图片 `public/images/ads/dpl-ad-site-style-20261028.png`（1962×801），由内置image_gen以首页截图及正确Logo为参考生成；文案“畅连全球网络”“日常访问 · 远程办公 · 在线娱乐”“查看套餐”，线路卡仅显示地区与装饰信号，不带延迟/速度/在线率数字。完整提示词 `codex/output/dpl-ad-site-style-20261028-prompt.txt`，风格参考截图 `codex/output/dpl-site-style-reference-20261028.png`。原蓝白版保留但不再引用。整图链接、焦点轮廓及无扫光行为保留，DPL与HN继续上下满行2.45:1；本地624×255加载回读通过。效果截图 `codex/output/dpl-site-style-preview-20261028.png`。HN未改，DPL源站代码未改，未提交、推送或部署。
|
||
|
||
2026-10-27按用户最新要求，仅在文章正文（含免费订阅和使用提示）之后、标签之前保留场景推荐广告区；同日按后续要求增加 HN，与 DPL 共同展示。首页/列表顶部横幅和文章文末轻卡已移除，组件中不再保留这两种分支，样式同步精简。
|
||
|
||
当前首页控制器直接展示最新免费节点文章，因此首页也只在同一文章内位置展示该推荐区，不另设顶部广告；分类列表 `/freenode` 无广告组件。
|
||
|
||
保留的白色推荐卡缩小内边距、品牌标志、标题和按钮间距；标题取消强制换行，精简说明文字，移除“另一种连接选择”独立小标题。用户最终要求增加卡片高度而恢复之前字号：桌面标题20px、正文与按钮13px、品牌14px，手机标题18px；保留增加后的纵向留白，桌面内边距24px、品牌与标题间距22px、底部区域上间距24px/内边距18px。桌面实测高度约255px，无横向溢出。
|
||
|
||
- 模板：`resources/views/components/dpl-article-ad.blade.php`，由 `components/article-ads.blade.php` 汇总 DPL 与 HN，`resources/views/pages/articles/default/show.blade.php` 在正文后引入；同页 CSS 只加载一次。
|
||
- 样式：`public/css/dpl-article-ad.css`，通过 Blade styles 栈加载，链接带文件修改时间版本以避免旧样式缓存；使用独立类名，适配现有 `nice-dark-mode`。
|
||
- 品牌素材：`public/images/ads/dpl-logo.svg`，2026-10-27已更正为 DPL 当前源文件 `/Users/hellcat/Documents/GemCodes/xb/stellar/public/favicon.svg`（带三条信号线），与 DPL 前台/邮件使用的视觉一致。原广告误用了旧聊天输出 `2026-10-07/dp-link-net-logo-var-www/outputs/dpl-logo-approved-b-layer-echo/dpl-logo.svg` 中的历史候选，不能作为当前品牌来源；旧广告与该候选的 SHA-256 均为 `fba12420cb7eb84d49a0035a830bf8c3428c6c96908ba6b2e85f929107ae93cd`。现用源文件哈希 `2f94a1311ae15ec9a41681ff288411d9b3f67bbba54f26e5fd8b5c78026c1bff`，图片URL带修改时间，避免缓存旧图。以后从 DPL 品牌维护入口取图，不从旧设计输出取图。
|
||
- 配置：`config/advertising.php`，`dpl.enabled` 控制显示，`dpl.url` 为 `https://dp-link.net/`。
|
||
- 点击新窗口打开，链接带 `sponsored noopener noreferrer`。组件没有预加载、远程图片、统计脚本或价格/速度承诺。
|
||
|
||
## 本次验证
|
||
|
||
当前固定入口为 `http://fna-v3.loc/`。2026-10-27在文章 `/a/fn20261021.html` 回读确认推荐区有 DPL、HN 各一张广告，桌面与390px手机视口无溢出，当前截图在 `codex/output/dpl-original-fonts-taller-card.png`。刷新时临时阻止外部线上资源请求，验证后恢复浏览器原设置。原2026-10-21三款广告验收属于历史状态，不能当作当前投放。
|
||
|
||
未提交、推送或部署。未改 FN_B、NodeHub 或 DPL 代码及数据库。其他聊天已有修改保持原样。
|
||
|
||
## 调整与回退
|
||
|
||
停用可将 `config/advertising.php` 的 `dpl.enabled` 设为 `false`；如启用了配置缓存，按本地运行方式刷新对应缓存。完全撤回时只移除文章正文后 `components.dpl-article-ad` 的 include，再删除本广告专属模板、配置、CSS及素材；勿回滚其他并行修改。
|
||
|
||
## HN 接入（2026-10-27）
|
||
|
||
- HN模板：`resources/views/components/hn-article-ad.blade.php`；Logo复制自HN当前配置指向的 `public/brand/hn/logo.svg`（独立工作树 `/Users/hellcat/Documents/Codex/2026-10-12/ji-cha/work/dpl-hn`），绿色眼镜H标志，不复用DPL或旧tpl-a设计素材。
|
||
- 配置：`advertising.hn.enabled`、`advertising.hn.url`；本地环境默认 `http://hn.loc/`，可通过 `HN_AD_URL` 显式设置。生产未配置地址则不展示HN卡片：hardnerd.net只核实到停放状态，未把它当作已上线落地页。
|
||
- 用户最新确认改为所有屏幕上下排列，DPL、HN各占一整行；不再使用桌面双列。原并排验收为历史记录：1280px视口实测两列343px、两卡等高约283px；390px手机视口单列322px，两卡均无溢出。Logo实际加载成功，DPL链接与HN本地链接分别回读正确。未打开落地页、未写HN数据、未发布。
|
||
- 当前截图：`codex/output/dpl-hn-ads.png`。仅在原有文章推荐区增加HN，不恢复顶部横幅、侧栏或文末投放。
|
||
|
||
## HN整图广告（2026-10-27）
|
||
|
||
用户要求HN改为整张图片，保持原广告位尺寸。当前 `hn-article-ad.blade.php` 使用整图链接，文字、Logo及按钮全部在图片内，不再叠加HTML标题/按钮。图片为 `public/images/ads/hn-ad-20261027.png`，由内置 image_gen 生成，使用当前HN Logo为参考；完整提示词在 `codex/output/hn-ad-20261027-prompt.txt`。画面为黑色/荧光绿网络路径主题，文案“探索全球网络”“hardnerd · 网络服务”“了解 HN ↗”，无价格或速度承诺。
|
||
|
||
桌面1280px实测HN与DPL均343×283px（四舍五入），390px手机视口HN为322×248px，与此前HN卡片接近。整图使用 contain 保证图内文字不被裁切，空余部分延续黑底。链接仍为HN本地预览入口。加载及无溢出已确认；预览截图 `codex/output/hn-full-image-ad-preview.png`。DPL模板未改。
|
||
|
||
验证期间本机Vite5187进程已停止，已按现有固定入口配置恢复原回环监听；未新增登录项或扩大监听。未提交、推送、部署。
|
||
|
||
2026-10-27最终布局：DPL和HN上下各占一整行；HN后续已重新生成为2.45:1横版，铺满行宽，手机按图片比例缩放，不再保留旧版黑边。
|
||
|
||
## HN横版满幅更新（2026-10-27，当前）
|
||
|
||
按用户要求重新设计横版，非拉伸旧图。内置 image_gen 以原整图为参考生成1962×801px图片，当前文件 `public/images/ads/hn-ad-wide-20261027.png`；完整最终提示词在 `codex/output/hn-ad-wide-20261027-prompt.txt`。旧接近方形图保留为历史产物，不再在页面引用。
|
||
|
||
广告位宽高比2.45:1，图片cover铺满，去掉contain及固定手机高度，不再出现左右补黑。实测当前桌面624×255px，与原行高一致；390px手机视口322×131px，按相同比例展示，无溢出。当前页面截图 `codex/output/hn-wide-ad-preview.png`。DPL广告未变，HN仍使用原本地链接；未发布。
|
||
|
||
## HN突出Logo版本（2026-10-27，当前引用）
|
||
|
||
用户认可眼镜H标志并要求突出Logo，再次使用内置 image_gen 以官方Logo为参考制作。当前整图 `public/images/ads/hn-ad-logo-hero-20261027.png`（1959×803），大Logo占左侧主要面积，右侧hardnerd品牌字与“以硬核，连接世界”，弱化背景纹理，保留黑绿配色与整图链接。最终提示词 `codex/output/hn-ad-logo-hero-20261027-prompt.txt`，页面效果 `codex/output/hn-logo-hero-preview.png`。
|
||
|
||
广告位保持原横版2.45:1，当前本地实测624×255px，新图片加载成功且铺满。旧网络路径横幅仅保留作历史产物，页面不再引用。DPL与原有广告位置、链接配置均未改，未发布。
|
||
|
||
## HN纯黑独立图形版（2026-10-27，当前）
|
||
|
||
按用户纠正去掉Logo的圆角方块，只使用白色H与绿色眼镜图形，整张纯黑背景，取消光晕、纹理、几何背景和按钮底块。当前整图 `public/images/ads/hn-ad-pure-black-20261027.png`（1962×801），通过内置 image_gen 参照官方Logo重新设计；完整提示词 `codex/output/hn-ad-pure-black-20261027-prompt.txt`。旧版只作历史产物，不再引用。
|
||
|
||
已本地页面验证新图加载、624×255px原横幅尺寸、广告位背景为rgb(0,0,0)；当前截图 `codex/output/hn-pure-black-preview.png`。Logo SVG原始文件未改，仅广告图去掉图标容器。DPL未变，未提交、推送或部署。
|
||
|
||
## HN协调构图版（2026-10-27，当前）
|
||
|
||
用户指出此前把“大Logo、纯黑”执行得过于绝对，要求重新设计而非机械照搬。当前通过内置 image_gen 重新构图：适中独立眼镜H标志与hardnerd品牌字组合，柔和深墨绿背景，低对比弧线与留白，主文案“以硬核，连接世界”，右下角小按钮。无圆角Logo容器，不再使用巨型图标或空白纯黑背景。
|
||
|
||
当前图片 `public/images/ads/hn-ad-balanced-20261027.png`（1962×801）；完整提示词 `codex/output/hn-ad-balanced-20261027-prompt.txt`；当前页面效果 `codex/output/hn-balanced-preview.png`。本地已回读新图加载成功，广告位维持624×255px，DPL与链接未变。旧版保留作历史产物、不再引用。未部署。
|
||
|
||
## 当前选用版本
|
||
|
||
2026-10-27用户最终选择“纯黑背景版本”，当前页面重新引用 `public/images/ads/hn-ad-pure-black-20261027.png`，即独立H/眼镜图形、无Logo方框的纯黑横幅。协调构图版保留为候选，不再引用。尺寸、位置和链接不变，未部署。
|
||
|
||
## HN纯黑精简排版（2026-10-27，当前）
|
||
|
||
按用户要求同时缩小Logo和文字，调整字号层级与行距，品牌字改用较轻字重，整体居中组合、文案左对齐，增加留白，保持纯黑背景、无Logo容器和2.45:1横幅。最终图片 `public/images/ads/hn-ad-refined-black-v2-20261027.png`，通过内置 image_gen 以原纯黑版为参考制作，并作一次组合占比校准；完整两阶段提示词 `codex/output/hn-ad-refined-black-20261027-prompt.txt`。当前页面截图 `codex/output/hn-refined-black-preview.png`，DPL及链接不变，未部署。
|
||
|
||
2026-10-27用户要求品牌名全大写：通过内置image_gen仅替换图内wordmark为HARDNERD，当前文件 `public/images/ads/hn-ad-uppercase-20261027.png`，提示词 `codex/output/hn-ad-uppercase-20261027-prompt.txt`；布局、独立图形、文案与纯黑背景保留。同步图片替代文字，未部署。
|
||
|
||
2026-10-27用户将品牌名改为首字母大写Hardnerd，并要求重新协调字体、字号和间距。当前图片 `public/images/ads/hn-ad-titlecase-20261027.png`：品牌字/灰色中文副标题/绿色CTA分层，重新对齐组合，保留纯黑背景及无框眼镜H标志；由内置image_gen参照大写版重新排版，完整提示词 `codex/output/hn-ad-titlecase-20261027-prompt.txt`，效果截图 `codex/output/hn-titlecase-preview.png`。仍为本地接入，未部署。
|
||
|
||
2026-10-27HN广告增加与网站文章缩略图一致的鼠标扫光：沿用core-ui.css的shine关键帧、0.85秒时长、白色20%透明渐变、-25度斜角，伪元素不接收点击。不额外引入JS或改动其他图片；键盘焦点同样触发，减少动态效果偏好下禁用。浏览器实测hover为true、animationName为shine、duration为0.85s、pointer-events为none；图片为Hardnerd首字母大写新版。未部署。
|
||
|
||
2026-10-27用户反馈HN横幅扫光过快，仅该广告的时长从0.85秒改为1.6秒，使用ease-in-out缓动；网站其他图片不变。
|
||
|
||
2026-10-27用户最终要求去掉HN广告扫光，已移除扫光伪元素、hover/focus动画及对应减少动态效果规则，仅保留静态整图链接和键盘焦点轮廓。网站其他图片扫光不变。
|
||
|
||
## 资源正文引导与TG入口（2026-10-31）
|
||
|
||
按用户要求将免费节点（freenode）和免费苹果ID（shadowrocketids）正文中“点击加入我们的tg频道…”与“点击关注我们的github仓库…”两段移除展示，连带其后的空段。`ResourceArticlePresentation::body` 仅在这两个栏目匹配已知引导文案；不改文章存储、订阅字段、苹果ID内容、其他栏目或正常教程链接，所以后续日更同样生效。
|
||
|
||
导航使用 `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`；已完成服务器侧验收，未做线上页面验收。文档后续部署不改变应用文件。
|