Record CFN UI release, acceptance and recovery boundaries

docs/maintenance/ADVERTISING.md

@@ -116,3 +116,33 @@ ## 单张随机广告（2026-10-31）
 应用提交 `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正式发布记录](UI_RELEASE_2026-10-31.md)已将正式广告位调整为3.675:1，并对生产原三张素材使用contain完整展示。此为页头/免费节点界面发布中的高度调整；compact重设计及其后续文案、cover取景仍为另一项本地任务，未随本批发布。生产article-ads模板、随机JS、广告配置及三张原图保持基线。各原图路线与本次精确SHA/恢复点以发布记录为准。

docs/maintenance/AIRPORT_RECOMMENDATIONS.md

@@ -0,0 +1,35 @@
+# 统一机场推荐模块
+
+**已正式发布**：[2026-10-31正式发布记录](UI_RELEASE_2026-10-31.md)。以下为最初本地实施记录，当前正式数据保护及189篇覆盖验收以发布记录为准。
+
+2026-10-31用户确认截图方案并要求“弄，先在本地”。仅FNA_V3本地生效，没有提交/推送、线上访问或生产部署。原整图广告区保留，本模块替换资源正文内旧福云文字推荐并补充教程末尾，不改变其他广告配置。
+
+## 唯一资料入口
+
+`config/airport_recommendations.php`集中维护开关、顺序、品牌名、地址、起售价/单位、解锁文案、场景说明、优惠码及折扣。初始三家与价格/优惠文案按用户截图：福云18元/月、DP-LINK.NET26元/月、hardnerd28元/月；前两家clashfreenode.com九折，HN无优惠码。该价格和营销说明为用户指定文案，不表示本次完成网络或套餐实测。
+
+地址沿已登记/既有配置：FUC免翻墙入口`https://xn--123-9i9dj97q.com/`，DPL `https://dp-link.net/`，HN `https://hardnerd.net/`；未点击或访问落地页。可通过AIRPORT_FUC_URL、AIRPORT_DPL_URL、AIRPORT_HN_URL覆盖。使用独立展示配置避免本地HN广告使用hn.loc时污染公开推荐网址。未新建后台、数据库、DomainHub调用或TeleHub汇报；无新增公共服务需求，当前统一配置足够维护三个固定条目，后续后台接入另按明确需求设计。
+
+修改资料后运行`php artisan config:clear`与`php artisan responsecache:clear`即可全站更新，无需逐篇改稿。禁用单家用enabled=false，排序用order；总开关AIRPORT_RECOMMENDATIONS_ENABLED=false。无可用条目时不插入推荐或跳转，旧正文原样显示。
+
+## 渲染与边界
+
+- `ArticleRecommendations::prepare`仅处理展示副本，不更新文章数据库、编辑版本、正文源、收录日期或点赞设置。
+- freenode、shadowrocketids：识别旧“机场推荐 - 福云”标题及其同段“机场官网：福云”链接，在原位置替换共享组件。匹配不跨下一个标题；未匹配时保留正文并在末尾追加，不猜测删除范围。订阅/账号/复制数据原字节保留。
+- client及其子栏目、advanced：正文后追加同一个模块。advanced在首个涉及订阅/节点/线路的段落后插入一次自然文案与文末锚点，无匹配时文末加入；已有该锚点链接不重复插入。
+- 首页复用最新文章详情，自然包含一处推荐；栏目列表不增加模块，其他栏目不展示。
+- 服务端输出table，桌面五列、767.98px及以下为三张纵向卡片。稳定锚点`#airport-recommendations`，不得在正文另建同名ID。CSS/JS独立同源静态文件，@once单次加载；不依赖JS获取推荐数据。
+- 外链为sponsored/nofollow/noopener/noreferrer，新窗口访问；可复制优惠码并以状态文字反馈，HTTP本地使用用户点击触发的复制兼容路径，失败则选中文字供手动复制。不会读取用户原剪贴板。
+- 不向正文源和AI写作稿重复写入价格/优惠码。本站文章API及其hash校验未改，不用SQL改文章；此模块与冻结的正文数据分离。
+
+## 本地验收
+
+5项专项测试/40断言通过：旧区替换与订阅/账号保留、未识别结构保护、入门子栏目/综合跳转、总开关与其他栏目、统一资料修改/单家关闭/推广链接。因项目既有CLI命令重复类，测试沿原约定使用`--process-isolation`，未改无关CLI代码。
+
+全量只读遍历本地171篇公开目标文章：160篇资源文章均替换旧区，11篇教程统一追加，4篇综合教程含锚点跳转，171篇data-clipboard-text载荷完全一致，未识别旧推荐为0。数据库正文未写入。
+
+本地浏览器1280px桌面表格、390px手机卡片无横向溢出；每页模块1处，文内链接实际滚动至距离顶部100px，复制优惠码显示“优惠码已复制”。图片、CSS/JS与原广告加载正常；没有点击服务商落地页。截图：[桌面](../../output/recommendations/desktop.png)、[手机](../../output/recommendations/mobile.png)。开发模式沿用，未运行build。完成检查后恢复浏览器默认视口。
+
+本地预览：`http://fna-v3.loc/a/fn20261021.html#airport-recommendations`；入门`/a/clash-verge-rev-windows.html#airport-recommendations`；综合`/a/mihomo-dns-leak.html`可点击文内“机场推荐”跳转。
+
+2026-10-31后续免费节点详情重设计仅将freenode页推荐区移至订阅及使用说明之后，仍使用本组件/配置；苹果ID维持原位置替换、教程文末维持不变。结构与验收见[免费节点内容页](FREENODE_ARTICLE_LAYOUT.md)，均仅本地。

docs/maintenance/BRANDING.md

@@ -0,0 +1,37 @@
+# CFN页头品牌标志（2026-10-31）
+
+**已随[2026-10-31正式发布记录](UI_RELEASE_2026-10-31.md)上线**。以下标注“仅本地”的段落为当时实施历史；当前正式品牌、窄屏居中及侧栏TG/GitHub均已发布。
+
+**当前字标已恢复文字**：用户试看风格化图片后要求改回ClashFreeNode文字。当前为统一深灰色的HTML字标，猫仍是独立SVG，下方文案保留；图片生成记录仅作历史。
+
+用户要求尝试将现有猫转SVG，右侧显示clashfreenode，下行显示“每天分享免费节点”。已在FNA_V3本地接入，未提交/推送/部署；旧PNG与其他实例标志保留。
+
+- SVG：`public/sites/cfn/images/logo/cat.svg`，从现有logo.png猫的紫色轮廓提取并简化为二次贝塞尔曲线，5个轮廓包含双眼与独立腿部，原色#764679。只有矢量path，不嵌入PNG、脚本、字体或外部资源；透明背景。
+- 复现脚本：`output/branding/vectorize-cat.py`，使用桌面已带的Pillow/NumPy，无项目新增依赖；读取原PNG、不修改原图。svg约7.6KB。
+- 文字：`components/cfn-brand.blade.php`使用可读HTML文字，避免把字做进图片；CSS位于`public/css/cfn-brand.css`，app-layout在cfn环境单次加载。品牌名保持用户要求的小写，文案“每天分享免费节点”。
+- 接入：nav-bar仅对site_code_short=cfn使用新组件，其他实例沿原PNG轻/深色分支。菜单顺序、菜单当前状态、TG/GitHub/搜索功能未改。
+- 适配：桌面猫44×44、品牌文字23px；手机猫38×38/21px；小于360px猫32×32/18px。深色文字有主题分支，不引入远程字体或JS。
+
+本地1280、390及320视口检查：SVG正常加载、两行文案正确，无导航横向溢出；320px品牌块约158px宽。截图：[页头](../../output/branding/header-logo.png)。本地HTTP/SVG XML检查通过；未点击线上落地页，未build。
+
+回退：cfn导航切回原logo.png，移除app-layout的cfn-brand.css引用；不用删原PNG或修改其他实例。保持其他并行导航改动。
+
+2026-10-31用户将字标明确为ClashFreeNode并要求设计，已本地改为CamelCase：Clash深灰、FreeNode呼应猫的紫色；字重700/650、字距-.65px，微调图文和两行间距，下方文案不变。保留真实文字及原SVG，无新字体请求，桌面/手机复验后仅本地。
+
+## 风格化图片字标（2026-10-31）
+
+原稿`output/branding/wordmark/clashfreenode-generated.png`，2172×724真实透明通道；完整提示词见[生成提示词](../../output/branding/wordmark/prompt.txt)，由内置image_gen生成，无CLI/API密钥。交付文件`public/sites/cfn/images/logo/wordmark-stylized.webp`约83KB，只做网页格式编码，不重画或合成；原PNG完整保留。CSS透明画布窗口去掉上下空白，不拉伸字形。
+
+`cfn-brand.blade.php`已将普通字替换为带alt=ClashFreeNode的img，保留独立SVG猫与“每天分享免费节点”。桌面字标视窗182×25，手机160×22，320px小屏134×19；活动品牌块在320px宽约172px，无横向溢出、文字识别清楚。预览见[图片字标效果](../../output/branding/header-wordmark-image.png)。本次未改广告尺寸、正文、导航链接或其他实例标志，未build、提交/推送或上线。
+
+2026-10-31按用户最新要求，已将图片字标恢复为文字ClashFreeNode及先前字重/配色/响应字号，页头不再请求wordmark-stylized.webp；图片及提示词保留归档。SVG猫、下方文案与广告高度不变，仍仅本地。
+
+2026-10-31用户要求颜色与此前一致，已将ClashFreeNode字标统一为原PNG字标深灰#555555，取消FreeNode的紫色强调；猫的原紫色不变，深色模式字标统一继承浅色。仅本地。
+
+## 窄屏导航对齐与GitHub（2026-10-31，仅本地）
+
+用户反馈Logo位置不对并要求窄屏不隐藏GitHub。已为SVG品牌补回6px左侧视觉留白，菜单/Logo/Telegram/GitHub/搜索垂直中心保持一致。移动导航增设使用原config(path.url_github_href)的GitHub链接，沿用原灰色32px按钮与新窗口属性；桌面保留原GitHub，不重复显示。320px下将字标微调17px并禁止导航换行，5项中心均35px，搜索不掉到第二行，未溢出；390/499px也检查通过，最终恢复默认视口。页头预览见[窄屏导航](../../output/branding/mobile-nav-github.png)。不改变文字/猫颜色、落地页地址或菜单逻辑，未上线。
+
+2026-10-31用户澄清原要求为“窄屏整个Logo居中”，上次补左侧留白的理解已纠正。现窄屏品牌相对导航容器绝对居中，不受左菜单/右侧三个按钮宽度差影响；按390/375/320宽度协调品牌及按钮尺寸，全部图标保留。390px品牌中心195px，320px中心160px，与视口中心一致，且不重叠；桌面品牌位置不改。仅本地。
+
+2026-10-31按用户最新要求，窄屏Telegram和GitHub从顶部移到移动侧栏的栏目菜单下方，用分隔线与菜单区分；顶部保留左侧菜单、居中品牌和右侧搜索。桌面TG/GitHub/搜索保持原位，链接配置保持原样。窄屏品牌恢复38px猫/21px文字，无需此前为右侧三图标设置的小屏压缩规则；本地检查侧栏开关与品牌中心，未上线。

docs/maintenance/FREENODE_ARTICLE_LAYOUT.md

@@ -0,0 +1,61 @@
+# 免费节点内容页重设计（2026-10-31）
+
+**已正式发布**：[2026-10-31正式发布记录](UI_RELEASE_2026-10-31.md)，应用7d564df7；原业务正文不变。以下本地实施历史中的“未上线”表示该步骤当时状态，最终版本已包含提示框移除。
+
+用户要求重新设计“免费节点”内容页，沿当前任务仅本地实施。未提交、推送、部署或访问线上，免费苹果ID、教程和列表页不变。首页继续复用最新免费节点详情，因此自然采用同一新版布局；没有另建首页数据源或改菜单选中规则。
+
+## 结构
+
+- 顶部：简洁H1“月日免费节点订阅”、客户端提示与该文章已有猫图。原title/description/canonical等SEO元信息保持；不改数据库标题或URL。
+- 概览：从原正文提取本篇节点数、原速度文字、地区；只对重复地区去重，不重估节点可用性、不换算速度单位。0节点如实显示，并给最新更新入口，不捏造数值。
+- 页内导航：获取订阅、使用说明、机场推荐。各锚点scroll-margin防导航遮挡。
+- 订阅区：Clash/Mihomo、V2ray/Shadowrocket、Sing-box/Hiddify按已有格式显示卡片，桌面与手机都明确显示原地址和复制按钮。早期只有两种格式就只显示两张，不添加推测URL。
+- 使用说明：增加简短三步说明，保留订阅下载补充说明；原三段使用提示框按用户最终要求不再展示，附已有Windows、Android、入门栏目内链。
+- 机场推荐：复用[统一推荐](AIRPORT_RECOMMENDATIONS.md)，仅免费节点页移到订阅/使用说明之后，仍每页一处；其他栏目沿原维护规则。更新频道和仓库链接从正文读取后归并到末尾，未访问目标。
+- 正文后既有整图广告、标签、点赞和分享保持。未创建或修改图片，顶部展示文章已有本地缩略图，保留文章原图片关联。
+
+## 实现与保护
+
+`app/Services/FreeNodeArticleLayout.php`只读解析已经过ArticleRecommendations处理的展示副本；没有更新文章数据库、编辑版本、正文源、创建时间、访问地址或点赞设置。新模板为`resources/views/pages/articles/freenode/header.blade.php`与`content.blade.php`，仅default/show中的freenode条件分支接入。样式`public/css/freenode-article.css`只在新版页面加载并以free-node-page/fn类限定，不影响其他页面。
+
+原日更HTML含不规范的p/a嵌套，使用本地DOM解析属性和正文。识别明确的订阅区、提示区与已知URL格式，HTML实体还原后交给Blade重新转义；不请求订阅服务器，不验证节点。未知URL格式、重复格式、未知文章结构或解析失败时回退原内容页，避免静默遗漏内容。额外编辑说明和普通补充链接保留。
+
+复制复用现有ClipboardJS的copy-permalink/data-clipboard-text机制，沿原成功反馈；不新增复制库、读取用户剪贴板或访问资源链接。侧栏保持原点赞活跃模块，只协调圆角和对齐。
+
+## 本地验收
+
+- 全量只读遍历78篇公开免费节点：78篇识别成功，订阅地址与原data-clipboard-text逐项一致；早期两格式和后期三格式均覆盖。
+- 12项测试/61断言通过：非规范HTML、URL查询串与实体、0数值、去重地区、未知格式安全回退、两格式不补造、保留额外说明/链接，以及已有推荐和首页选择回归。
+- HTTP核对首页、当前三格式、早期两格式、苹果ID、入门教程、免费节点列表均200；新版只出现在首页/免费节点详情，推荐模块仍单处，列表不出现。
+- 浏览器1280桌面、390及320手机无横向溢出；逐个核对复制按钮边界在卡片内，没有被父级overflow遮住。真实复制显示“复制成功”，使用既有ClipboardJS。URL始终为原有值，未访问订阅/服务商/TG/GitHub落地页。
+- dev模式沿用，未build。截图：[桌面](../../output/freenode-redesign/desktop.png)、[手机](../../output/freenode-redesign/mobile.png)。浏览器最终恢复默认视口。
+
+预览：`http://fna-v3.loc/a/fn20261018.html`；最新首页`http://fna-v3.loc/`。本地最新10月21日及前两天原始记录为0，本次没有改成非零或制造线上新数据。
+
+回退只移除show.blade.php的freeNodeLayout分支并恢复原共用渲染；无需回灌数据库、替换素材或修改推荐配置。保留其他本地/并行代码，本次没有执行Git清理或全量覆盖。
+
+2026-10-31用户要求移除装饰性小字，已本地移除SUBSCRIPTIONS、QUICK START及共享推荐区“网络服务推荐”，保留中文主标题和功能，未上线。
+
+2026-10-31用户进一步明确删除卡片内“免费节点 / 日期”小字，已移除fn-eyebrow整行，卡片外面包屑及日期主标题保留，仍仅本地。
+
+2026-10-31按用户要求简化订阅卡片：移除C/V/S字母图标、客户端说明小字和格式小标签，主标题统一为“适用于：客户端名”；订阅原值及复制功能保留，仅本地。
+
+2026-10-31按用户反馈同步收紧删字后的留白：标题行高1.3、说明上间距6px，桌面插画120×96、标题区下间距16px；手机插画68×76，说明间距6px；纯标题订阅卡头部下间距9px。不保留已删除眉题/图标的占位，仍仅本地。
+
+2026-10-31按用户截图将标题下方两行说明合并为“支持 Clash / V2ray / Shadowrocket / Singbox / Hiddify”，移除原第二行，手机按宽度自然换行，仅本地。
+
+2026-10-31按用户要求移除“按客户端选择格式”辅助文字，保留“获取免费订阅”标题及订阅卡片，仅本地。
+
+2026-10-31对照用户指定clash-rule-global-direct教程的浏览器实际样式，修正免费节点页过小字号：桌面H1 32px/正文16px/二级标题22.72px，手机H1 26px/正文15px/二级标题19.5px，与参考页一致；卡片标题约18/17px、按钮14px、地址13/12px，概览/导航/步骤与辅助说明同步放大至可读层级。推荐表的字号覆盖限定free-node-page，参考教程和其他页面不改。清理已移除图标/装饰文字的孤立CSS，标题分组换行以防手机末尾孤字；390/320检查复制按钮边界、正文和推荐布局，默认视口恢复。本地生效，未上线。截图[字号对齐](../../output/freenode-redesign/typography.png)。
+
+2026-10-31按用户截图仅缩小订阅地址与原使用提示：桌面地址12px、提示14px/1.8；手机地址11px、提示13px/1.8。正文主层级与标题保持，仅本地。
+
+2026-10-31用户澄清使用提示框须恢复统一字号调整之前的版本，已仅恢复该框桌面/手机均11px、行高1.9、原文字色#786c84，原边框/背景/内边距不变；其他正文、标题和订阅地址保持，不是只缩小一档。仅本地。
+
+2026-10-31用户随后要求提示框字号稍大，已仅将该框从11px调为12px（桌面/手机一致），行高、颜色和内边距保留，仅本地。
+
+2026-10-31按用户最新截图要求，移除免费节点新布局里的整块原使用提示框（免费节点稳定性、DNS和全局模式三段说明）。不再渲染该容器，因此不保留空白占位；三步使用说明和教程入口保留。原文章正文及解析数据不改，仅本地展示调整，未上线。
+
+2026-10-31用户反馈外层卡片圆角与其他页不一致，经浏览器核对参考教程正文/侧栏桌面与手机均4px，已移除免费节点正文卡片14px/手机10px及侧栏10px局部覆盖，沿网站共用4px圆角。仅本地。
+
+2026-10-31用户再次反馈标题区留白不均，已将桌面标题/插画改为顶部对齐，标题行高1.3、说明上间距8px/行高1.6，插画112×80、概览前间距20px；手机沿其原独立尺寸和顶部对齐，不变更字号或文字。仅本地。

docs/maintenance/TUTORIALS.md

@@ -182,3 +182,9 @@ ## 小标题蓝线定点调整（2026-10-28）
 ## 本地样式服务恢复（2026-10-28）
 
 用户反馈/advanced排版再次错乱。现场确认public/hot仍指向127.0.0.1:5187，但该端口无监听，导致Vite样式/脚本不可用，页面退化为原始HTML（双Logo及展开导航）。已按原配置恢复npm run dev，仅监听127.0.0.1:5187，Vite7.3.1启动成功；刷新后浏览器截图确认Logo、导航、栏目banner与文章卡片恢复，无横向溢出。未修改教程正文、数据库、模板、全局字号或生产环境。截图codex/output/advanced-styles-restored-20261028.png。恢复的是当前本地dev进程，不代表已配置登录自启或已核实此前进程退出原因。
+
+## 综合教程列表移除图片横幅（2026-10-31，仅本地）
+
+按用户要求，`/advanced`不再渲染列表顶部的猫图横幅及叠加数量；用户随后明确标题介绍卡也不要，现与免费节点列表一样直接显示文章列表。页面title与meta description仍保留栏目名称和简介。仅调整列表模板的展示条件，栏目配置和文章内容未改；入门教程与平台子栏目仍按原配置显示横幅。未上线。
+
+2026-10-31综合教程列表去除横幅及介绍卡已随[2026-10-31正式发布记录](UI_RELEASE_2026-10-31.md)上线，入门和平台子栏目横幅保留；本次不发布新的教程正文。

docs/maintenance/UI_RELEASE_2026-10-31.md

@@ -0,0 +1,31 @@
+# CFN界面与推荐模块发布（2026-10-31）
+
+已正式发布到 `https://clashfreenode.com/`。应用提交 `7d564df7e9509cbf58d6096cfbe55ae339ee15dc`，分支 `codex/cfn-ui-20261031`，目标 VPS-003 `/www/wwwroot/clashfreenode-new.com`。本机经白色机SSH执行；没有本机访问线上网站、重新开设test入口或整库迁移。
+
+## 本次范围
+
+- [统一机场推荐](AIRPORT_RECOMMENDATIONS.md)：集中配置福云、DP-LINK.NET、hardnerd，资源正文替换旧推荐，教程文末追加，综合教程增加文内锚点入口。价格和优惠由共享配置维护，不改文章正文源。
+- [免费节点内容页](FREENODE_ARTICLE_LAYOUT.md)：首页与免费节点详情复用新版标题、概览、订阅卡片、复制按钮及三步使用说明；按用户最终要求删除装饰小字、卡内栏目日期、图标与描述、原使用提示框，统一字号、圆角和间距。其他栏目不套此布局。
+- [页头品牌](BRANDING.md)：原紫色猫轮廓SVG、深灰ClashFreeNode文字、每天分享免费节点；窄屏品牌居中，TG与GitHub移入侧栏，顶部保留菜单和搜索。
+- [综合教程列表](TUTORIALS.md#综合教程列表移除图片横幅2026-10-31仅本地)：去掉大图及标题介绍卡，直接显示列表；入门教程及平台子栏目的横幅保留。title和meta description不变。
+- 随机广告高度比例从2.45调整为3.675，即同宽高度为此前三分之二；沿本任务旧图方案使用contain完整展示。保留生产现有三张广告素材、候选/随机脚本、跳转配置和noscript回退。本地另一个任务制作的compact广告新图及其文案/裁切规则未发布，不能把本地当前广告候选当作本次正式候选。
+
+基于现场正式HEAD `a7adfac04108c68b58bd02c550fe98fd80b2feeb` 创建隔离Git工作树，审核并提交20个文件，Git推送并核对远端SHA后正式检出。生产空侧栏广告组件的原include保留，未携带本地无关删除；未覆盖现有生成标签模板的并行修改、data.ms、public/images/editorial、私密.env、数据库、静态配图及定时任务。未更改Vite源或重建前端包，新增CSS/JS为同源公开文件并按filemtime刷新版本。
+
+## 验收
+
+- 本地12项测试、61条断言通过，覆盖推荐替换、未知结构回退、原复制值、两/三格式、零节点和首页选择；新增JS语法检查通过。桌面及320/390窄屏界面、菜单开关、复制反馈已在本地检查。
+- 发布前在服务器只读事务遍历189篇目标文章，86篇免费节点全部识别；替换178篇旧推荐，原data-clipboard-text值逐项一致，0丢失、0回退。不请求节点订阅服务器。
+- 正式切换后183项服务器侧检查全部通过、0失败：覆盖首页、最新及最早免费节点详情、苹果ID详情、Windows与TUN教程、三个栏目；原title/canonical/robots/description及复制值保留，推荐单次输出和作用范围、导航结构、综合教程移除横幅及介绍、入门横幅保留正确。
+- 所有20个文件部署哈希一致，6个公开CSS/JS/SVG资源HTTPS完整SHA一致；nginx及PHP-FPM在运行。189篇文章完整原始行与分类行SHA与发布前一致，.env及并行生成标签模板SHA一致。随机广告模板/脚本/配置相对基线无差异。
+- 已清理nginx身份的Blade及响应缓存。未做线上浏览器页面验收，没有点击服务商/TG/GitHub落地页或触发真实订阅/通知/文章发布。
+
+回执和已审核候选：`output/ui-release-20261031/`，含preflight、prepared、manifest、只读audit-before、http-before、release及verification.json。它们不含真实凭据或业务正文导出。应用文件的完整权威哈希以manifest/verification为准。
+
+## 恢复
+
+VPS-003恢复点 `/root/backups/cfn-ui-20261031`（0700），保留原HEAD/status、Git bundle、tracked-before.patch、候选工作树/补丁、逐文件manifest及验收回执。因为本次无业务数据迁移，回退不需要恢复数据库；不得回灌本地库。
+
+没有后续生产变更时，可经白色机将正式目录检回发布前 `a7adfac04108c68b58bd02c550fe98fd80b2feeb`，再以nginx身份清理 `view:clear` 和 `responsecache:clear` 并做服务器冒烟核验。有后续发布时，在其当前HEAD上只撤销本次应用增量，提交推送后再切换，不覆盖后续功能或并行未提交文件。保留原PNG、图片资产及Resource关联。
+
+后续文档同步提交仅更新维护记录；应用差异、远端分支SHA与正式最终HEAD由同目录docs-release.json核实。