24 KiB
FNA_V3 文章推荐广告
当前正式三张素材已更新：用户要求补齐李响及全部相关改动后，最终compact三图、cover取景及广告标记已随相关补齐发布上线；HN九折配置保留。以下“仅本地/未发布”是原日期实施历史，上一批contain旧图方案已被本次正式版本替代。
当前实现
2026-10-31按用户新要求新增统一机场推荐表/手机卡片，本地覆盖资源正文旧福云推荐区及所有教程末尾。价格、网址、优惠码的唯一配置与验收见统一机场推荐。未部署线上；下列整图广告保持原行为。
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；已完成服务器侧验收，未做线上页面验收。文档后续部署不改变应用文件。
TG图标协调（2026-10-31，仅本地）
用户反馈TG蓝色实心图标突兀，随后明确本次先只改本地。components.telegram-link 去掉固定蓝色、36px自定义尺寸，使用导航现有btn-link/btn-icon/btn-sm继承灰色及深色模式/交互样式；按后续要求使用18px实心纸飞机，包裹与其他按钮相同的居中span。链接与无障碍说明保留。
真实本地导航组件、现有构建CSS隔离验收：TG/GitHub/搜索均为rgb(141,143,150)、32×32，垂直中心35px一致；初版线框截图 output/tg-icon-polish-20261031/local-preview.png，后续实心版截图 output/tg-icon-polish-20261031/solid-local-preview.png。临时验收页用后删除。未提交、推送或部署，本次线上仍保留此前蓝色图标。准备的发布脚本未执行，不把线上只读核对当作发布。
广告高度（2026-10-31，仅本地）
用户要求广告高度调到原来三分之二。最初仅将单张随机广告组件的比例2.45改为3.675、object-fit改为contain。用户随后明确否定直接缩放旧图，要求按矮横幅重新设计；此初版已被下述三张重设计替代。保持原单张抽样、template延迟载入与noscript回退，不改候选、素材、跳转地址或JS。桌面718px宽约195.37px高（原293.06px），手机322px宽约87.62px高（原131.43px），均为66.7%；活动DOM仅1张图。未提交/推送或发布，生产仍沿前述原尺寸。
矮横幅重设计（2026-10-31，仅本地）
用户明确高度为原来三分之二，需重新设计而非等比缩旧图。内置image_gen分别生成DPL/HN/FUC新构图，文件为 public/images/ads/{dpl,hn,fuc}-ad-compact-20261031.png，完整提示词与原始尺寸清单在 output/compact-ads-20261031/。不覆盖旧文件。DPL改为横向三地区卡片与左右分区；HN保留眼镜H、Hardnerd和用户指定白字，重新协调留白；福云改为当前深紫星空/火箭及云形新Logo，撤掉旧浅紫大福字视觉。
FUC参考只读新版HEAD 4eff00023420175662792769d1d2ee1c16d9bb68 的 docs/maintenance/BRANDING.md、官网离线桌面截图 docs/maintenance/evidence/logo-2026-10-30/front-desktop.png 及 public/images/brand/fuc-mark-512.png。未运行真实FUC Web配置或访问FUC线上；未改FUC源码、品牌源文件和业务数据。
实际广告位保持3.675:1，满宽约为原高度66.7%。生成图原始尺寸DPL2169×725、HN2021×778、FUC2142×734保留背景出血，cover仅从上下背景留白取景；字号与主要内容按横向构图重新布局，不再contain缩小整张/补两侧空白。福云取景center40%，保护顶部品牌与底部CTA；固定小“广告”标签保证出血裁切后仍可见。活动组件候选引用、真实图片尺寸与替代文字同步，随机JS、链接、缓存与单图加载机制未变。旧独立广告组件属于保留实现，不是当前随机位消费者。
真实Blade隔离页浏览器验收：桌面三张均718×195.37；390px视口三张均354×96.32，无横向溢出，图文与品牌显示完整。实际随机组件仅1张新版福云图片进入活动DOM并加载。桌面/手机截图与验收摘要见上述输出目录，临时Web验收页用后清理。未提交、推送或部署；线上仍为之前2.45:1旧素材随机位，本次实心TG图标同样仅本地。
2026-10-31用户纠正广告品牌字标为 DP-LINK.NET。内置image_gen定点替换原图左上DPL，现用 public/images/ads/dpl-ad-compact-wordmark-20261031.png，2169×725；原图保留。提示词 output/compact-ads-20261031/dpl-wordmark-prompt.txt。实际随机组件候选及alt同步为DP-LINK.NET，广告位比例、其他两图和链接不变，仅本地未发布。
2026-10-31按用户要求将HN品牌字放大、中文标语缩小并增加两行间距；追加要求首字母小写，最终字标为 hardnerd。内置image_gen定点编辑，当前素材 public/images/ads/hn-ad-compact-lowercase-20261031.png，2021×778；提示词 output/compact-ads-20261031/hn-lowercase-prompt.txt。本地随机组件引用、尺寸及alt同步，保留旧图，不改线上。
2026-10-31按用户指定文案将福云主标题改为“全球网络加速”、副标题改为“五年稳定运营”。内置image_gen只替换两行文字，保留新云形Logo/紫色火箭构图及开始使用按钮；当前素材 public/images/ads/fuc-ad-compact-five-years-20261031.png（2141×734），提示词 output/compact-ads-20261031/fuc-copy-prompt.txt。随机组件引用/尺寸/alt同步，仅本地未发布；文案为用户指定，不将本次设计视作独立运营年限核验。
本任务高度调整正式状态（2026-10-31）
2026-10-31正式发布记录已将正式广告位调整为3.675:1，并对生产原三张素材使用contain完整展示。此为页头/免费节点界面发布中的高度调整；compact重设计及其后续文案、cover取景仍为另一项本地任务，未随本批发布。生产article-ads模板、随机JS、广告配置及三张原图保持基线。各原图路线与本次精确SHA/恢复点以发布记录为准。