tom/fn_b
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Record approved cfn production release and verification

Browse Source
This commit is contained in:
Codex 2026-10-29 20:34:06 +08:00
parent 76141453bb
commit cbb847aed8
29 changed files with 6658 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

157
docs/content/WRITING.md Normal file
View File

@ -0,0 +1,157 @@
# AI 写作与文章关联索引
适用项目：FNA_V3。用户于2026-10-27指定本聊天持续为该项目写文章，并要求各 AI 写作时形成相关内容之间的跳转。**每次选题、撰写、重写、改名、移动、合并或撤下文章前，先读本文。** 本规则适用于项目中的后续 AI，不依赖某一聊天的上下文；不表示后台自动写作或自动发布。
发布已采用本站[独立文章 API](../maintenance/EDITORIAL_API.md)，不经过ATOM。AI保留项目正文源，通过API保存冻结草稿、取得签名预览、发布确认的hash并核对回执；本索引仍由写作AI同任务维护，API不会自动改写它。
本文是写作流程、文章用途及文章关系的唯一维护入口。文章正文保存在各自源文件，数据库是页面实际读取的内容；栏目实现、渲染与备份方法见[教程维护](../maintenance/TUTORIALS.md)，SEO项目状态见[SEO清单](../maintenance/SEO_PLAN.md)。不要在这些文档中再复制一份持续更新的文章关系表。
## 1 写作前先确定读者要完成的任务
- 入门教程：以第一次使用为前提，讲准备、下载、安装、配置、使用和基本排错。不要把客户端迁移作为普通入门教程的主线。
- 下载与选型：讲适用平台、版本/架构、官方来源和选哪个安装包；引用官方发布入口，不把未经验证的第三方包当官方下载。
- 综合教程（栏目原名“进阶教程”，URL仍为`/advanced`）：讲具体机制、配置取舍、迁移或专项排错，并链接读者需要的基础操作。
- 资源与时效内容：区分长期说明和当天资源状态。长期教程优先链接稳定说明/栏目，不依赖会过期的某一天资源页。
先查询下表和当前数据库，再决定重写已有文章还是新增。主题相同优先完善唯一正文；不同平台可以分别写，但需要实际的平台差异。标题、开头、步骤和关联链接都应服务于同一个任务。
本站是公开分享免费节点的站点。入门教程优先按“从本站获取适用格式的免费订阅→导入→选择节点→验证”的实际过程组织；公开分享的订阅与私人账户订阅需要区分，不把私人账户保密提醒套进免费资源步骤。相关说明和内链自然放在读者需要的位置，避免堆叠与场景无关的提示框。
正文直接进入引言，不再添加“入门教程 · Android · 更新于……”这类顶部信息行；分类、平台和日期不要在正文开头重复网站信息栏。必要的官方参考链接可保留在文末，内部核验过程另存维护记录。
**禁止在公开文章中写内部核验与验收说明。** 用户于2026-10-27明确要求：以后文章里不再出现“本文的核对范围”“已核对官方文档”“未实测”“未进行真机联网测试”“未修改本机网络”等内容，也不换成同义的提示框、脚注或免责声明。核验范围、设备测试情况、开发验收过程及本地/上线状态只写入项目维护记录，不进入正文、摘要、图注或封面。
公开内容保留对读者有用的操作步骤、版本兼容条件、配置限制和参考来源；不得编造实测结论。发布前检查全文，发现上述内部说明必须删除或移入维护记录，不能指望上线流程自动去掉。“本页旧文”“沿用原地址更新内容”“核对本文时”等编辑历史和核验口吻同样移入维护记录；版本信息直接写适用版本、系统要求或示例版本。参考链接优先选读者实际需要的下载、配置与使用文档，不堆放仅用于编辑取证的界面实现源码。
自然、准确地表达；必要时用真实操作图、流程图、配置示例。软件版本、下载入口与兼容要求使用当次核对的官方来源；来源核验、页面检查和设备实测分别记录，未做实测不写“实测”。
### AI 新文章的点赞参数（2026-10-29）
后续AI通过本站独立文章API**新建文章**时使用以下默认设置，由API在保存草稿时为每篇独立取值并冻结；相同请求重试、查询预览及发布不重新抽取。重写、接管、回退已有文章不重置原参数、点赞数或已完成进度，不自动给现有文章批量补额度。
| 设置 | 默认值 | 含义 |
| --- | --- | --- |
| `i7like`，API `like_settings.seven_day` | 随机整数5～35，含端点 | 原有短期待增加额度，随原任务逐次扣减 |
| `i365like`，API `like_settings.yearly` | 固定50 | 保留原持续年度随机机制：每天以50/365概率加1，长期平均每年约50赞，并非每年保证恰好50，不随一年结束停止 |
| `iYearLikeTarget`，API `like_settings.one_year` | 随机整数100～500，含端点 | 新增一次性年度额度；设200表示独立累计自动增加200赞，不是总点赞数封顶200 |
一次性年度额度从正式发布时开始，按实际经过时间在一个日历年内分散增加，`iYearLikeAdded`记录已增加数量，`sYearLikeStartedAt`记录开始时间；满额后该项停止，`i365like`持续增长和真实点赞继续独立计算。任务停机造成的欠额在恢复后补至应有进度；满一年后首次恢复会补完余额，不能在调度停机时凭空执行。
新文章可省略`like_settings`使用上述默认值，也可在创建草稿时显式提交`{"seven_day":12,"yearly":50,"one_year":200}`；0表示关闭对应机制。保存后检查草稿响应的`like_settings`，发布后从鉴权的`source-articles/{id}`响应`like_growth`回读确认。旧文章编辑不传此对象；API拒绝通过普通改稿重置额度。设置与进度只属于内部发布数据，不写进公开正文、摘要、图注或封面。
具体字段、迁移、任务、测试与回退见[文章自动点赞维护](../maintenance/ARTICLE_LIKES.md)。这些默认值已落到本地代码及迁移，不代表已启用本机调度或已部署线上。
## 2 当前文章登记
核对日期：2026-10-28；证据为本机 `fna_v3` 数据库及已有正文源。表中 `iStatus=1` 只代表本地应用可显示，**不代表已经发布到生产**。十篇长期教程均已新建或重写并在本地确认；原七篇旧教程已处理完毕，仍不据此判断生产站现状。
ID用于核对本地行，站内链接使用已确认路径。跨环境迁移后重新核对ID，不能假定生产ID相同。
| 内容键 | 本地ID / 栏目 | 标题 | 实际路径 | 正文源 / 编辑状态 | 用途与引用边界 |
| --- | --- | --- | --- | --- | --- |
| verge-windows-start | 362 / Windows（入门） | Clash Verge Rev 使用教程：从安装到第一次连接（Windows） | `/a/clash-verge-rev-windows.html` | [windows.md](tutorials/windows.md)；本地API版本4 | Windows新用户操作入口；下载段落锚点为 `#install` |
| cfw-to-verge | 212 / 综合教程 | 从 Clash for Windows 迁移到 Clash Verge Rev | `/a/m167.html` | [migration.md](tutorials/migration.md)；本地API版本5 | 保留旧配置并更换客户端；不作为纯入门入口 |
| mihomo-dns | 361 / 综合教程 | Clash 进阶：DNS 防泄漏配置与验证 | `/a/mihomo-dns-leak.html` | [dns.md](tutorials/dns.md)；本地API版本6 | Mihomo桌面DNS专题，含配置片段与验证方法 |
| cfa-android-legacy | 206 / Android（数据库名Andorid） | Clash Meta for Android 使用教程：导入订阅、选择节点与连接 | `/a/m169.html` | [clash-meta-android.md](tutorials/clash-meta-android.md)；本地API版本6 | Android Clash配置入门；`#install` 安装、`#import` 导入；按MetaCubeX v2.11.36核对，保留原键和URL |
| quantumult-ios-legacy | 207 / iOS（数据库名Ios） | Quantumult X 使用教程：iOS 安装、订阅导入与连接 | `/a/m170.html` | [quantumult-x-ios.md](tutorials/quantumult-x-ios.md)；本地API版本5 | iPhone/iPad入门；区分原生资源与本站通用订阅，#parser 解释第三方资源解析器，#import 导入；无真机实测 |
| v2rayng-android-legacy | 208 / Android（数据库名Andorid） | v2rayNG 使用教程：Android 安装、导入订阅与连接 | `/a/m171.html` | [v2rayng-android.md](tutorials/v2rayng-android.md)；本地API版本7 | Android入门；`#install` 下载、`#import` 订阅导入；保留既有内容键和URL |
| clashx-mac-legacy | 209 / Mac | Mac 代理客户端下载指南：ClashX 与 Clash Verge Rev 怎么选 | `/a/m172.html` | [mac-client-guide.md](tutorials/mac-client-guide.md)；本地API版本5 | Mac选型与官方下载；#download 核对系统与芯片，链接实际安装教程；旧ClashX原入口不可核验不等于所有分支失效 |
| cfw-mac-legacy | 210 / Mac | Clash Verge Rev 使用教程：Mac 安装、订阅与系统代理 | `/a/m173.html` | [verge-mac.md](tutorials/verge-mac.md)；本地API版本2 | Mac操作入口；#install DMG安装，#import 订阅，系统代理与退出排错；无设备联网实测 |
| cfw-linux-legacy | 211 / Linux | Clash Verge Rev 使用教程：Linux 安装、订阅与代理设置 | `/a/m174.html` | [verge-linux.md](tutorials/verge-linux.md)；本地API版本5 | Linux桌面入门；#install 包格式与架构，#import 订阅，#terminal 单条curl代理验证；不适用于无桌面的服务器 |
| system-proxy-vs-tun | 365 / 综合教程 | 系统代理和 TUN 有什么区别？接管范围、使用选择与排错 | `/a/system-proxy-vs-tun.html` | [system-proxy-tun.md](tutorials/system-proxy-tun.md)；本地API版本1 | 桌面代理接管与出口选择；`#choose` 场景选择、`#switch` 切换检查、`#troubleshoot` 排错；三张流程图 |
这里只登记长期编辑内容及值得复用的稳定资源说明，不逐条收录日更节点或账号文章。稳定入口为 `/freenode`（公开免费节点）、`/client`（入门）、`/advanced`（综合教程）；平台入口和名称修改另按项目路由核对，不从名称自行拼接。
2026-10-29部署边界更新：上表10篇已通过本站API迁移到独立test并经用户确认后切到正式cfn，旧URL保留；生产发布以预览实际正文冻结再发布，未用test整库覆盖。test和生产的临时编辑密钥均在迁移后删除，接口默认关闭；后续本地写作继续使用本地API，正式编辑按明确任务与生产绑定启用。实际部署及验收统一见[发布记录](../maintenance/RELEASE_PREFLIGHT_2026-10-28.md#正式切换2026-10-29)，上表ID仍为本地ID。
## 3 已有文章关系
以下为2026-10-28从本地数据库正文提取并核对源文件的**实际内链**，不是建议列表。箭头表示正文中有从来源到目标的链接；入向关系从本表反查，不另存一份容易失步的反向清单。
| 来源内容键 | 目标内容键 | 读者为什么跳转 / 放置位置 | 状态 |
| --- | --- | --- | --- |
| verge-windows-start | 栏目 `/freenode` | 导入前获取Clash订阅，以及节点失效后查看较新的分享 | 已在本地正文实现 |
| verge-windows-start | mihomo-dns | 入门完成后学习DNS路径；文末“下一步” | 已在本地正文实现 |
| mihomo-dns | verge-windows-start | 尚未安装客户端的读者回到Windows入门；文末说明 | 已在本地正文实现 |
| cfw-to-verge | 栏目 `/freenode` | 迁移时获取Clash/Mihomo免费订阅；保留旧订阅重新导入的选项 | 已在本地正文实现 |
| cfw-to-verge | mihomo-dns | 完成迁移后检查DNS路径；文末“下一步” | 已在本地正文实现 |
| v2rayng-android-legacy | 栏目 `/freenode` | 获取v2ray订阅、整批失效后寻找较新分享 | 已在本地正文实现 |
| v2rayng-android-legacy | verge-windows-start `#install` | 日常使用段落后，供同时需要Windows客户端的读者继续 | 已在本地正文实现 |
| v2rayng-android-legacy | cfa-android-legacy `#import` | 获取订阅段落说明Clash格式的Android导入入口 | 已在本地正文实现 |
| cfa-android-legacy | v2rayng-android-legacy `#import` | 导入前说明v2ray订阅和单节点分享链接的另一客户端用法 | 已在本地正文实现 |
| cfa-android-legacy | 栏目 `/freenode` | 获取Clash订阅，旧批次失效后寻找较新分享 | 已在本地正文实现 |
| cfa-android-legacy | verge-windows-start `#install` | 日常使用末尾提供Windows客户端安装入口 | 已在本地正文实现 |
| quantumult-ios-legacy | 栏目 `/freenode` | 选择较新的免费订阅；明确本站通用订阅需要格式适配 | 已在本地正文实现 |
| quantumult-ios-legacy | clashx-mac-legacy `#download` | 日常使用后提供Mac客户端选择入口，说明配置不可直接通用 | 已在本地正文实现 |
| clashx-mac-legacy | cfw-mac-legacy `#install` / `#import` | 选好客户端下载后进入Mac安装和连接步骤 | 已在本地正文实现 |
| clashx-mac-legacy | 栏目 `/freenode` | 选定客户端后获取Clash/Mihomo订阅 | 已在本地正文实现 |
| clashx-mac-legacy | verge-windows-start | 同时使用Windows时转到对应平台教程 | 已在本地正文实现 |
| clashx-mac-legacy | cfw-linux-legacy | 同时使用Linux桌面时转到对应平台教程 | 已在本地正文实现 |
| cfw-mac-legacy | clashx-mac-legacy `#download` | 安装前核对Mac系统和CPU架构 | 已在本地正文实现 |
| cfw-mac-legacy | 栏目 `/freenode` | 导入前选择Clash/Mihomo免费订阅 | 已在本地正文实现 |
| cfw-mac-legacy | mihomo-dns | 基本连接完成后深入检查DNS路径 | 已在本地正文实现 |
| cfw-linux-legacy | 栏目 `/freenode` | 导入Clash/Mihomo订阅和更新失效批次 | 已在本地正文实现 |
| cfw-linux-legacy | mihomo-dns | Linux基本连接后继续学习DNS与TUN验证 | 已在本地正文实现 |
| cfw-linux-legacy | clashx-mac-legacy `#download` | 需要Mac客户端时进入对应下载指南 | 已在本地正文实现 |
| verge-windows-start | system-proxy-vs-tun `#choose` | “需要一开始就开 TUN 吗”后提供接管方式选择入口 | 已在本地正文实现 |
| mihomo-dns | system-proxy-vs-tun `#tun` | TUN/DNS 配置片段前解释接管机制 | 已在本地正文实现 |
| system-proxy-vs-tun | verge-windows-start `#enable` | 切换前完成 Windows 基本连接 | 已在本地正文实现 |
| system-proxy-vs-tun | cfw-mac-legacy `#enable` | 切换前完成 Mac 基本连接 | 已在本地正文实现 |
| system-proxy-vs-tun | cfw-linux-legacy `#connect` / `#terminal` | Linux 基础连接及单条命令显式代理 | 已在本地正文实现 |
| system-proxy-vs-tun | mihomo-dns `#dns-2` | 继续检查 DNS 接管、加密和出口 | 已在本地正文实现 |
两篇Android教程通过订阅格式段落互链；Mac下载指南与操作教程互链，Linux从下载指南和真实Linux栏目获得入口，iOS沿用真实iOS栏目入口。系统代理与TUN专题由Windows和DNS正文提供入口，并指向三平台的基础操作及DNS专题。目录、标签、导航和热门榜不算正文关联；正文内链及锚点已经本地HTTP验证。
## 4 怎样安排链接
| 关系 | 典型写法与放置位置 | 目标选择 |
| --- | --- | --- |
| 前置准备 | “尚未安装客户端，先完成……”放在需要操作之前 | 对应平台的安装/下载/入门文章 |
| 具体操作 | “订阅导入步骤见……”放在提到该操作的位置 | 对应教程的具体段落锚点 |
| 解释概念 | “关于系统代理与TUN的区别……”放在需要解释处 | 已完成、平台适用的专题文章 |
| 解决故障 | 在具体错误或现象后提供排查入口 | 对应问题的排错文章 |
| 继续学习 | 完成当前任务后的下一步，放在文末 | 与当前任务相邻的进阶内容 |
| 返回基础 | 进阶内容给尚未具备前置条件的读者一个入口 | 基础教程；不强迫已经会用的读者重复阅读 |
### 下载文章的具体例子
**Mac已建立独立选型与下载指南**，可链接 `/a/m172.html#download`，其中也提供Mac安装与导入教程的入口。Windows当前可用目标仍是入门教程中的下载段落：
```html
<a href="/a/clash-verge-rev-windows.html#install">Clash Verge Rev Windows 下载与安装步骤</a>
```
例如，后续撰写某篇进阶配置教程，读者需要先安装该客户端，就可在前置准备处使用这个入口。如果以后建立其他平台的独立下载文章：先创建并验证真实URL，登记用途与状态，再把适用教程中的下载链接改到新文；同时在下载文章中提供“下载后如何使用”的入门链接。不要提前创造一个不存在的下载URL，也不要把本段示例当作当前正文已经增加的链接。
### 链接质量约束
- 按读者需要建立方向，不要求任意两篇都互链。新增文章应检查“从哪里能找到它”，在确有相关性的旧文中补入口；若没有合适旧文，明确使用真实栏目入口并记录原因，不硬塞链接。
- 使用描述目标任务的锚文本，例如“Windows 订阅导入步骤”；少用无意义的“点击这里”，不重复堆砌关键词，不设固定链接数量指标。
- 站内文章使用根相对路径 `/a/实际slug.html`，不要写本机 `.loc` 或未经确认的生产域名。锚点必须真实存在；平台不适用时说清范围，不把Windows教程当作所有平台通用操作。
- 正文相关位置优先，文末“下一步”只保留有用内容，不把每篇文章都变成全站链接目录。
- 待写、撤下、未核验或已过时的文章不能包装成可靠的当前操作入口。需要引用历史内容时，明确历史用途和限制。
- 改名或移动分类优先保留原slug。确需改URL/合并/撤下时，先查本表入向关系及源文件/数据库中的实际链接，再处理所有受影响正文和已授权范围内的重定向；只改索引不算修复完成。
- 不把“未来关联”记为“已实现”。对公开文章，不发布指向仅本地存在页面的内链；上线时核对目标与来源是否一同部署。
## 5 每次写作的固定流程
1. **查现状。** 读AGENTS和本文，按主题/平台搜索登记表，再查当前数据库标题、slug、栏目、发布状态和正文。阅读拟链接文章，不能只凭标题判断合适。
2. **确定位置。** 明确本文解决什么、读者需要什么前置知识、完成后下一步是什么。挑选现有有效目标；缺少的内容登记为待办，不自动扩大成一批新文章。
3. **写正文。** 遵守第1节公开内容要求，禁止写核对范围、未实测等内部说明；发布前检查正文、摘要、图注和封面。在合适段落放入自然的站内链接，并保留必要官方来源。新文确定slug前查重。首次重写仅在数据库中的旧文时，先备份，再建立项目正文源。
4. **补相关旧文。** 在本次获准写作范围内，同步维护直接相关的少量链接，保留无关正文和并行修改；不借机全站重写、修改资源数据或上线。新文只有草稿时先登记计划，等目标可用后再启用链接。
5. **保存与同步。** 按[独立文章API](../maintenance/EDITORIAL_API.md)提交完整草稿批次，预览确认后发布指定hash并查询回执；不手工绕过版本控制更新文章表。首次接管旧文显式绑定准确ID。项目正文源与本文的文章行、实际关系行同任务维护；草稿、公开正文、搜索同步和生产部署分别确认，避免源文件有链接而网页没有。
6. **验收链接。** 检查来源正文是否实际含链接、目标标题/栏目/平台是否匹配、HTTP是否成功及锚点是否存在；不能只看200（项目路由可能接受错误前缀）。检查移动排版和配图；访问线上仍按项目授权边界，不能以验链接为由越界。
7. **收尾说明。** 报告改了哪些文章、增加/修复了哪些关联、哪些仅在本地生效、是否同步搜索及是否发布。未完成的关系保留明确原因与下一步。备份和操作过程留维护记录，不向本索引堆聊天流水。
## 6 登记规则与待补内容
新增登记项使用稳定内容键，字段沿用第2节：本地ID、栏目、准确标题、真实路径、正文源、编辑/环境状态、读者任务与适用限制。标题变化不必更换内容键。关系沿用第3节：来源键、目标键、理由/位置、实际状态；有段落链接时同时记录锚点。填写核对日期和证据范围，禁止把“已有记录”写成“刚刚实测”。
当前待补（选题储备，**尚未创建文章，也不自动授权逐篇执行**）：
| 主题 | 当前可用替代入口 | 处理条件 |
| --- | --- | --- |
| 其他平台独立下载/选型文章 | Mac已有 `/a/m172.html#download`；Windows入门 `#install` | 下载信息确有独立维护需要时再建立；与入门教程互相提供自然入口 |
| 订阅导入失败排查 | Windows入门的导入与常见问题段落 | 积累明确错误场景后再拆专题，避免重复原文 |
本次建立的是AI协作约定和已核实的关联索引，不是自动推荐程序、链接注入脚本或定时任务。正文关系变动时由执行写作的AI同任务更新本文。

1
docs/content/tutorials/clash-meta-android.html Normal file
View File

File diff suppressed because one or more lines are too long

103
docs/content/tutorials/clash-meta-android.md Normal file
View File

@ -0,0 +1,103 @@
在 Android 手机上使用本站的 Clash 订阅，可以通过 **Clash Meta for Android** 完成。它会读取订阅中的节点和分流规则，让你在手机上选择线路、更新配置，并决定哪些连接通过代理。
以下使用 MetaCubeX 项目发布的 Clash Meta for Android，依次完成安装、订阅导入和首次连接。
<figure class="guide-diagram"><div class="diagram-label">先分清三个对象</div><div class="guide-flow"><div><b>配置</b><small>整份节点和规则清单</small></div><span>→</span><div><b>代理组</b><small>决定某类连接怎么走</small></div><span>→</span><div><b>节点</b><small>实际连接的一条线路</small></div></div><figcaption>图 1 · 一份配置可以包含多个代理组，每个组又可以选择节点或其他策略。导入配置后，还要检查组内选择。</figcaption></figure>
<nav class="guide-toc" aria-label="文章目录"><strong>阅读路线</strong><a href="#install">安装客户端</a><a href="#import">导入配置</a><a href="#start">启动服务</a><a href="#proxy">选择节点</a><a href="#check">检查连接</a><a href="#daily">日常使用</a><a href="#faq">常见问题</a></nav>
<h2 id="install">01　从官方发行页下载安装</h2>
打开 [Clash Meta for Android 官方发行页](https://github.com/MetaCubeX/ClashMetaForAndroid/releases/latest)，展开 **Assets**，选择适合手机的 `.apk` 安装包。初次使用选择正式发行版；后续升级也可使用这个官方入口。
| 设备情况 | 安装包文件名中的架构 |
|---|---|
| 近几年常见的 Android 手机 | `arm64-v8a` |
| 不确定设备架构 | `universal`，通用包体积较大 |
| 已确认是 32 位 ARM 的旧设备 | `armeabi-v7a` |
| x86 架构设备或模拟器 | 按实际架构选择 `x86` / `x86_64` |
例如，v2.11.36 的常见手机安装包为 `cmfa-2.11.36-meta-arm64-v8a-release.apk`。以后版本号会变化，不必为了和示例一致而寻找旧版。
下载完成后打开 APK，按系统提示安装。如果手机要求允许浏览器或文件管理器安装应用，按提示为本次安装授权。官方项目说明最低要求 Android 5.0，推荐 Android 7.0 及以上；具体设备能否正常使用，还要看系统与安装包是否兼容。
<h2 id="import">02　导入本站的 Clash / Mihomo 订阅</h2>
进入本站[免费节点页面](/freenode)，打开较新的一篇分享，复制标明 **Clash / Mihomo** 的订阅链接。这里需要的是能返回配置的地址，不是那篇文章的网页地址。
如果手里拿到的是 v2ray 订阅，或 `vmess://`、`vless://` 等单独节点链接，可以按 [v2rayNG 的导入步骤](/a/m171.html#import)使用；本篇直接使用本站提供的 Clash / Mihomo 配置。
1. 打开 Clash Meta for Android，进入 **配置**。
2. 点击添加按钮，选择 **从 URL 导入**。
3. 填写配置名称，例如“本站免费节点”，再把订阅链接粘贴到 **URL**。
4. 点击保存，等待配置下载和校验完成。
5. 返回配置列表，点选刚保存的配置，将它设为当前配置。
6. 回到首页，确认“配置”一栏显示的是刚才填写的名称。
这里的“保存”会尝试获取配置内容。如果下载或校验报错，要先解决这一步；只填写了名称和地址、随后返回列表，并不代表已经导入成功。
<figure class="guide-diagram"><div class="diagram-label">配置出现了，为什么还不能连接？</div><div class="guide-flow"><div><b>保存成功</b><small>已下载并读取配置</small></div><span>→</span><div><b>选为当前配置</b><small>告诉客户端使用哪一份</small></div><span>→</span><div><b>启动并选线路</b><small>让实际访问通过节点</small></div></div><figcaption>图 2 · 操作阶段示意，并非软件截图。“保存”“选中”“启动”分别完成不同的事情。</figcaption></figure>
如果你已经下载了完整的 Clash YAML 配置文件，也可以在添加配置时选择 **从文件导入**。本地文件适合手动导入；需要定期获取分享更新时，URL 订阅更方便。
<h2 id="start">03　回到首页，启动代理服务</h2>
确认当前配置已选中后，点击首页的 **点此启动**。首次运行通常会出现 Android 的 VPN 连接请求，确认应用名称后允许。
客户端利用 Android VPN 接口接管流量，通常不需要 Root。启动后，首页会显示运行状态；系统也可能显示 VPN 标识或常驻通知。
如果 v2rayNG、其他 VPN 或使用本地 VPN 的过滤工具正在运行，先停止它们，再启动 Clash Meta。同一个 Android 用户空间只能有一个活动 VPN 服务，两个应用轮流启动会相互影响。
先保持默认网络设置完成首次连接。桌面教程中的“系统代理开关”不能直接照搬到这里，Android 的主要入口是当前客户端的 VPN 服务。
<h2 id="proxy">04　选择规则模式，再选一条节点</h2>
进入 **代理** 页面，找到模式选项，先使用 **规则模式**。然后找到负责普通代理流量的代理组，在可以手动选择的组里点选一个节点。
代理组名称由订阅决定，可能叫“节点选择”“代理”“Proxy”，也可能使用其他名称。遇到一组套着另一组的情况，可以沿当前选项继续查看，直到确认实际使用的是哪条节点或策略。
| 选项 | 对连接的影响 |
|---|---|
| 规则模式 | 按当前配置的规则分流，适合先完成日常连接 |
| 全局模式 | 通常将进入内核的业务连接交给全局策略组；仍需检查该组选项 |
| 直连模式 / DIRECT | 直接连接目标，不经过代理节点 |
| 手动选择组 | 由你指定组内的一项，适合初次确认线路 |
| 自动选择组 | 由配置的测试和选择策略决定线路，不一定允许手动指定 |
如果页面提供延迟测试，可以先运行一次，避开一直超时的节点。低延迟只代表对测试目标的结果，最终仍以你要访问的网站是否可用为准。
规则模式不等于“所有网站都走代理”。国内网站或局域网地址按规则直连是常见配置，具体行为取决于你导入的规则。
<h2 id="check">05　用实际访问检查连接</h2>
保持服务运行，打开浏览器访问你需要使用的网站，再试一下对应应用。首次验证时，重新加载网页，避免把缓存中的旧页面当成连接成功。
如果无法打开，按顺序检查：**首页是否在运行 → 当前配置是否正确 → 模式是否合适 → 代理组是否选到可用节点。** 都确认后，再更换一条节点重试。
VPN 标识表示接管服务已经建立，不保证远端节点可用；延迟测试成功也不代表所有服务都能访问。先完成一个实际使用场景，比一开始调整大量高级参数更容易定位问题。
<h2 id="daily">06　更新配置、换节点和停止使用</h2>
**更新节点列表：** 在“配置”中找到这份 URL 配置，使用其更新操作；需要同时刷新多份配置时，可以使用“更新全部”。更新之后再到代理页检查当前选项，因为新配置可能调整节点或组名。
**旧地址里已经没有可用节点：** 回到[免费节点页面](/freenode)查看较新的分享。本站不同日期可能使用不同订阅地址，更新旧 URL 不会自动寻找下一期；需要时编辑配置中的 URL，换成新地址并保存，再确认它仍是当前配置。
**切换节点：** 在代理页调整对应手动选择组，再重新发起网页或应用请求。已经建立的长连接可能继续使用原线路，验证时可以重新连接该应用。
**暂停使用：** 在首页点击运行状态区域停止服务，并确认运行状态结束。仅返回桌面并不等于停止代理。
如果还要在电脑上使用本站的 Clash 订阅，可以继续阅读 [Clash Verge Rev Windows 入门教程](/a/clash-verge-rev-windows.html#install)。订阅格式相近，但安装方式和系统接管入口不同，按对应平台操作即可。
<h2 id="faq">07　常见问题</h2>
**提示“没有选择配置文件”。** 返回配置列表，确认配置已经保存成功，再点选它。查看首页显示的配置名称，避免只完成添加却没有启用。
**保存时报下载失败或解析失败。** 先核对 URL 是否完整、是否复制成文章地址，以及格式是否为 Clash / Mihomo。链接失效、返回网页而非配置，或者网络无法访问该地址，都可能导致导入失败；先尝试较新的适用订阅，不必急着重装软件。
**配置导入成功，代理页却没有预期节点。** 先核对首页当前配置；若配置引用了外部节点资源，还要检查那些资源是否下载成功。列表名称和分组由配置决定，换了订阅后未必与教程示例一致。
**延迟正常，但某个应用无法连接。** 如果修改过访问控制，检查该应用是否在预期接管范围内；再检查它可能匹配的代理组，并尝试另一条节点。只测试一个地址，无法判断所有应用的访问情况。
**锁屏后过一会儿断开。** 先观察客户端服务是否已被系统结束。如果确实被结束，再到手机的电池或后台应用管理中允许它后台运行。若服务仍在，优先检查网络变化和节点可用性。
<div class="guide-footnote">参考资料：<a href="https://github.com/MetaCubeX/ClashMetaForAndroid/releases/tag/v2.11.36">官方 v2.11.36 发行页</a>、<a href="https://github.com/MetaCubeX/ClashMetaForAndroid/blob/v2.11.36/README.md">项目说明</a>、<a href="https://developer.android.com/develop/connectivity/vpn">Android 官方文档</a>。</div>

1
docs/content/tutorials/dns.html Normal file
View File

File diff suppressed because one or more lines are too long

143
docs/content/tutorials/dns.md Normal file
View File

@ -0,0 +1,143 @@
使用 Clash 时，代理连接正常、出口 IP 符合预期，只能说明部分网络请求已经经过代理。DNS 查询是否沿着预期路径发送，还需要单独确认。
这也是 DNS 防泄漏配置的重点：明确哪些查询由客户端处理，哪些交给远端节点解析，以及查询经过什么连接抵达解析服务。
本文面向采用 **Mihomo 内核的桌面客户端**，从解析路径出发，介绍一套可检查、可验证的配置方法。使用配置示例前，先确认客户端所用内核支持相应字段。
<nav class="guide-toc" aria-label="文章目录"><strong>阅读路线</strong><a href="#dns-1">识别两条不同的路径</a><a href="#dns-2">接管、加密和出口分别负责什么</a><a href="#dns-3">建立可检查的解析路径</a><a href="#dns-4">检查最终生效配置</a><a href="#dns-5">检查浏览器独立 DNS</a><a href="#dns-6">分三层验证</a><a href="#dns-7">补齐 IPv6 与故障验证</a></nav>
<h2 id="dns-1">01　识别两条不同的路径</h2>
DNS 泄漏通常发生在流量路径分离的地方。 应用访问网站前，可能先通过系统 DNS 查询域名。如果网页连接进入代理，而查询仍发送给本地路由器或运营商，两类请求就走了不同的路径。
<figure class="guide-diagram"><div class="diagram-label">图 1 · 网页走代理，查询可能走另一条路</div><div class="guide-flow"><div><b>应用</b><small>发起请求</small></div><span aria-hidden="true">→</span><div><b>Mihomo</b><small>接管网页连接</small></div><span aria-hidden="true">→</span><div><b>代理节点</b><small>连接目标网站</small></div></div><div class="guide-branch">另一路：应用 → 系统 DNS → 路由器 / 运营商</div><figcaption>如果 DNS 查询没有按预期接管，网页出口正常仍可能伴随解析绕行。</figcaption></figure>
普通 DNS 查询通常以明文传输，沿途网络可以观察其中的域名。这类查询主要暴露“访问了哪个域名”，通常不包含 HTTPS 网页的完整路径和正文。[Cloudflare：DNS 加密说明](https://developers.cloudflare.com/1.1.1.1/encryption/)
是否构成泄漏，还取决于预期策略。例如，明确安排公司内网域名由内部 DNS 解析，是正常的分流设计；要求经过代理的查询意外发送给运营商，才是需要处理的问题。
<h2 id="dns-2">02　接管、加密和出口分别负责什么</h2>
完整的 DNS 策略需要同时考虑接管、加密和出口。
| 配置层面 | 需要解决的问题 |
|---|---|
| DNS 接管 | 应用发出的查询是否进入 Mihomo |
| 查询加密 | Mihomo 与上游 DNS 之间是否使用 DoH 或 DoT |
| 出口选择 | 上游 DNS 连接通过代理还是直接连接 |
只填写 `1.1.1.1` 这样的地址，通常只是更换 DNS 服务商。使用 DoH 或 DoT 才涉及传输加密，而加密连接本身仍有直连和代理两种路径。[Cloudflare：加密 DNS](https://developers.cloudflare.com/1.1.1.1/encryption/)
因此，配置时应当明确指定解析服务和出口，并检查应用有没有绕过这套设置。
<h2 id="dns-3">03　建立可检查的解析路径</h2>
可以先建立一条简单、明确的解析路径，再逐步增加分流。 以下示例使用 TUN 接管流量，将普通 DNS 查询交给 Mihomo，并让本机需要发出的上游查询经过指定代理组。
代理节点自身的域名使用独立解析服务处理。这样，在代理尚未建立时，客户端就能取得节点地址，避免解析过程反过来依赖尚未连通的代理。
<figure class="guide-diagram"><div class="diagram-label">图 2 · 查询与引导解析分开处理</div><div class="guide-flow"><div><b>应用查询</b><small>系统 DNS / TUN</small></div><span aria-hidden="true">→</span><div><b>Mihomo DNS</b><small>需要真实地址时</small></div><span aria-hidden="true">→</span><div><b>代理组</b><small>必须选中代理</small></div><span aria-hidden="true">→</span><div><b>加密 DNS</b><small>处理本机上游查询</small></div></div><div class="guide-branch">独立引导：节点域名 → 引导 DNS（直连）→ 节点 IP → 建立代理</div><figcaption>图示为本机上游查询路径；部分连接会将域名交由远端节点解析。</figcaption></figure>
如果还不清楚 TUN 与系统代理分别接管什么，可以先看[系统代理与 TUN 的区别](/a/system-proxy-vs-tun.html#tun)，再调整下面的配置。
实际操作前，先备份当前配置。下面只包含 TUN 与 DNS 部分，需要通过客户端提供的配置编辑或覆写功能整合到现有配置中。
<div class="guide-note"><strong>这是合并片段，不是完整配置</strong><p>先备份，确认内核支持字段及代理组名称，再使用客户端的覆写或合并功能。不要覆盖节点和分流规则。</p></div>
```yaml
tun:
enable: true
auto-route: true
auto-detect-interface: true
# 需要支持该字段的近期 Mihomo 内核
dns-mode: native
dns-hijack:
- any:53
- tcp://any:53
strict-route: true
dns:
enable: true
listen: 127.0.0.1:1053
enhanced-mode: fake-ip
# 解析 DNS 服务自身的域名
default-nameserver:
- tls://223.5.5.5
# 独立解析代理节点域名
proxy-server-nameserver:
- "tls://223.5.5.5#DIRECT"
# 替换为配置中真实存在的代理组名称
nameserver:
- "https://cloudflare-dns.com/dns-query#节点选择"
```
示例中的 `#节点选择` 指定上游 DNS 连接使用该代理组。应用前，需要将它替换成实际名称，并确认该组最终选中代理节点，也不会在失败时回退到 `DIRECT`。Mihomo 支持在 DNS 地址后指定代理或接口；通过代理查询时，应同时配置独立的节点域名解析服务。[Mihomo DNS 配置](https://wiki.metacubex.one/config/dns/)
这里选用阿里 DNS 的 DoT 地址作为引导解析示例，该地址也出现在 Mihomo 的官方配置中。它是否适合当前网络，仍需实际验证。[Mihomo 配置示例](https://wiki.metacubex.one/example/conf/)
引导解析直接连接指定服务，意味着该服务可以看到节点域名等引导查询。这是一项明确的信任选择，应当与网站域名的解析路径分别理解。
`dns-mode: native` 用于将系统 DNS 指向 TUN；`dns-hijack` 则将匹配的 DNS 连接导入内置解析模块。系统 DNS 仍指向局域网路由器时，单靠劫持配置存在平台限制。如果内核不支持 `dns-mode`，应先核对客户端对应的系统 DNS 接管功能。[Mihomo TUN 配置](https://wiki.metacubex.one/config/inbound/tun/)
<h2 id="dns-4">04　检查最终生效配置</h2>
配置合并之后，还需要检查最终生效的内容。 订阅原有的 `nameserver-policy`、`fallback` 和 `direct-nameserver` 都可能影响解析路径。新增一个 `nameserver`，并不会自动清除已有策略。
初次排查时，保持路径简单更容易定位问题。公司内网、NAS 或自定义局域网域名，则应按需保留专门的解析规则；公共 DNS 通常无法解析这些内部名称。
<h2 id="dns-5">05　检查浏览器独立 DNS</h2>
浏览器的安全 DNS 会增加一条需要检查的路径。 Chrome 等浏览器可以自行使用 DoH，此时查询可能绕过 Mihomo 的 DNS 模块，但 DoH 连接仍可能经过 TUN 和代理。
排查时，可以记录浏览器原设置，临时关闭其独立的安全 DNS，让查询先统一进入系统解析路径。确认接管正常后，再决定是否恢复独立解析，并验证对应连接的出口。
Chrome 的自动模式在安全查询失败时可能使用未加密查询；选择自定义提供商时，回退行为有所不同。因此，验证时也应记录浏览器采用了哪一种模式。[Chrome 官方说明](https://support.google.com/chrome/answer/10468685?hl=en&co=GENIE.Platform%3DDesktop)
<h2 id="dns-6">06　分三层验证</h2>
验证应同时观察解析结果和传输路径。 DNS 检测网站适合发现异常，但无法独自覆盖整台设备的所有流量。
<figure class="guide-diagram"><div class="diagram-label">图 3 · 从结果检查到路径证据</div><div class="guide-flow"><div><b>检测网站</b><small>观察解析服务商</small></div><span aria-hidden="true">→</span><div><b>生效配置</b><small>核对上游和出口</small></div><span aria-hidden="true">→</span><div><b>物理网卡</b><small>检查绕行查询</small></div></div><div class="guide-branch">每一层都需要结合预期策略：没有异常记录 ≠ 所有场景都不会泄漏</div><figcaption>测试应记录客户端与内核版本、网络环境以及观察范围。</figcaption></figure>
可以先访问 [DNSLeakTest](https://www.dnsleaktest.com/)，执行 Extended test。测试会让浏览器查询一组域名，再观察哪些 DNS 服务器参与解析。同一家服务商可能使用多个服务器，所以结果中的 IP 数量不能直接作为泄漏数量。[DNSLeakTest 测试原理](https://www.dnsleaktest.com/what-is-the-difference.html)
阅读结果时，可以参考下面的判断方式：
| 检测结果 | 如何理解 |
|---|---|
| 出现预期的解析服务商 | 与策略相符，继续确认连接出口 |
| 出现未预期的本地运营商 | 检查系统 DNS、浏览器设置及接管范围 |
| DNS 所在国家与节点不同 | 地理位置差异本身不足以判定泄漏 |
| 出现远端节点使用的解析服务 | 核对是否由节点完成域名解析 |
这里需要特别注意 Fake-IP 模式。Mihomo 可以将目标域名交给远端代理，由远端完成解析。因此，即使本机配置了 Cloudflare，检测结果也未必只出现 Cloudflare；本机 `nameserver` 无法统一规定远端节点的解析服务。[Mihomo 解析流程](https://wiki.metacubex.one/config/dns/diagram/)
接着检查客户端的生效配置、代理组选择和可用的连接记录。缓存、日志级别及客户端展示方式都会影响观察结果，缺少某条日志只能说明当前没有看到相应记录。
如果需要更直接的证据，可以使用 Wireshark 抓取当前联网的 Wi-Fi 或以太网接口，并输入显示过滤器：
```text
udp.port == 53 || tcp.port == 53
```
随后重新运行 DNS 检测，观察是否有测试域名的查询发往路由器或其他非预期服务器。该表达式用于筛选 TCP、UDP 的 53 端口流量。[Wireshark 过滤器说明](https://sharkfest.wireshark.org/retrospective/sfeu/presentations24eu/03.pdf)
抓包位置会影响结论。在 TUN 或回环接口中看到应用向 Mihomo 提交 DNS，可能属于正常接管过程；检查查询有没有离开预期路径，应重点观察实际联网的物理接口。
同时，53 端口没有查询，也只能说明这次观察中未发现相应流量。DoH 通常使用 443，DoT 通常使用 853，还需要结合目的地址和连接路径判断。[Cloudflare：加密协议与端口](https://developers.cloudflare.com/1.1.1.1/encryption/)
<h2 id="dns-7">07　补齐 IPv6 与故障验证</h2>
IPv6 和故障状态需要分别检查。 `dns.ipv6: false` 控制 Mihomo DNS 对 AAAA 查询的响应，并没有关闭整台设备的 IPv6。如果当前网络支持 IPv6，应确认这部分流量同样符合接管和出口策略。[Mihomo IPv6 DNS 设置](https://wiki.metacubex.one/config/dns/#ipv6)
`strict-route` 不是独立的断线保护开关。它的作用也与平台相关。例如，Windows 下会通过防火墙规则处理多网卡 DNS 泄漏问题。对于客户端退出、内核崩溃、休眠恢复等情况，是否仍能阻止意外直连，需要另行验证断线保护机制。[Mihomo 严格路由说明](https://wiki.metacubex.one/config/inbound/tun/#strict-route)
完成配置后，建议保留一份简短记录：客户端和内核版本、测试网络、预期 DNS 路径，以及实际观察结果。更换订阅、更新客户端或切换网络后，按照同样的方法复查，才能持续确认这套策略仍然有效。
尚未安装客户端，可先阅读[Windows 入门教程](/a/clash-verge-rev-windows.html)。

1
docs/content/tutorials/mac-client-guide.html Normal file
View File

File diff suppressed because one or more lines are too long

57
docs/content/tutorials/mac-client-guide.md Normal file
View File

@ -0,0 +1,57 @@
在 Mac 上使用免费节点，先要选对客户端和安装包，再找与它匹配的订阅格式。软件名字里有“Clash”，并不意味着所有版本的系统要求、协议支持和下载来源都相同。
这篇文章帮助你完成下载前的选择；确定使用 Clash Verge Rev 后，可以直接进入[Mac 安装与连接教程](/a/m173.html#install)。
<figure class="guide-diagram"><div class="diagram-label">下载前先确认三件事</div><div class="guide-flow"><div><b>系统与芯片</b><small>macOS 版本、Apple 芯片或 Intel</small></div><span>→</span><div><b>官方安装包</b><small>找到对应架构的 DMG</small></div><span>→</span><div><b>订阅格式</b><small>使用 Clash / Mihomo 配置</small></div></div><figcaption>图 1 · 先匹配运行环境，再导入资源，可以少走很多安装和格式排错的弯路。</figcaption></figure>
<nav class="guide-toc" aria-label="文章目录"><strong>阅读路线</strong><a href="#clashx">关于旧 ClashX</a><a href="#choose">选择当前客户端</a><a href="#download">下载哪个安装包</a><a href="#subscription">选择订阅</a><a href="#next">开始连接</a></nav>
<h2 id="clashx">01　搜索到 ClashX 时，先核对下载来源</h2>
ClashX 曾是 Mac 上常见的菜单栏代理客户端。下载时先确认项目维护者、系统要求和正式发行入口；原项目入口无法访问时，不要随意用同名下载站的安装包替代。
网上仍能看到名字相似的下载站、镜像或分支。它们需要分别核实维护者和来源，不能只凭“ClashX 官网”几个字就认定与原项目相同。已经安装旧版的用户，可以先保留自己的配置；准备新安装时，优先从能核对项目和发行记录的入口开始。
这也不等于“旧版一定不能运行”。能否打开、能否读取当前订阅、能否连接其中的节点，是三个不同的问题。某份新订阅使用了旧内核不支持的配置时，反复换下载站通常解决不了兼容性问题。
<h2 id="choose">02　本站 Mac 入门以 Clash Verge Rev 为例</h2>
[Clash Verge Rev 项目](https://github.com/clash-verge-rev/clash-verge-rev)提供 macOS 版本，包含订阅管理、代理组选择和连接查看等功能。安装后可按[Mac 使用教程](/a/m173.html#install)完成订阅导入和连接。
它与旧版 ClashX 是不同客户端。即使都能使用某些 Clash 配置，也应按各自界面操作，不要在安装 Verge 后继续寻找 ClashX 菜单里的同名入口。
| 你的情况 | 下一步 |
|---|---|
| 第一次在 Mac 上使用节点 | 先核对系统要求，再安装 Clash Verge Rev |
| 只想让浏览器访问所需网站 | 先走规则模式与系统代理的基本流程 |
| 浏览器正常，某个应用不走代理 | 完成基本验证后，再检查该应用代理设置或 TUN 接管 |
| 老系统无法满足当前版本要求 | 先核对系统升级可行性；不能靠换 CPU 架构包解决系统版本限制 |
<h2 id="download">03　区分 Apple 芯片和 Intel 安装包</h2>
在苹果菜单中打开“关于本机”，查看 macOS 版本，以及“芯片”或“处理器”一栏。官方安装文档当前要求 **macOS 12 及以上**。
| 关于本机显示的硬件 | 官方 DMG 的架构标记 |
|---|---|
| Apple M 系列芯片 | `aarch64` |
| Intel 处理器 | `x64` |
从[官方发行页](https://github.com/clash-verge-rev/clash-verge-rev/releases/latest)下载对应 `.dmg`。以 v2.5.8 为例，`Source code` 是源码，其他平台的 `.exe`、`.deb`、`.rpm` 也不是 Mac 安装包。
后续更新也可从官方发行页选择适合自己电脑的安装包。安装遇到系统确认或启动异常时，按[Mac 教程的安装与排错步骤](/a/m173.html#install)处理。
<h2 id="subscription">04　客户端和订阅要配套</h2>
本站[免费节点页面](/freenode)中的分享通常会列出不同格式。使用 Clash Verge Rev 时，选择 **Clash / Mihomo** 订阅；它包含客户端要读取的配置内容。
v2ray、sing-box 和 Clash 配置的写法不同，文件名或链接都是一串地址，并不能说明内容可以互换。复制时同时看格式名称，避免把文章网址当成订阅链接。
<figure class="guide-diagram"><div class="diagram-label">三个名字，分别解决三个问题</div><div class="guide-flow"><div><b>客户端</b><small>在电脑上运行和管理连接</small></div><span>→</span><div><b>订阅</b><small>提供节点、代理组和规则</small></div><span>→</span><div><b>节点</b><small>承担实际的远端连接</small></div></div><figcaption>图 2 · 换客户端、更新订阅和切换节点是不同操作。节点失效时，通常先换线路或更新资源。</figcaption></figure>
<h2 id="next">05　选好之后，按平台完成连接</h2>
安装包和订阅准备好后，继续阅读 [Clash Verge Rev Mac 使用教程](/a/m173.html#import)，完成导入、选择节点、系统代理和实际访问检查。
同样的订阅也可能用于其他平台，但接管流量的方法不同：Windows 用户看 [Windows 入门](/a/clash-verge-rev-windows.html)，Linux 桌面用户看 [Linux 入门](/a/m174.html)。不要把 Mac 的系统设置路径照搬到其他系统。
<div class="guide-footnote">参考资料：<a href="https://github.com/clash-verge-rev/clash-verge-rev/releases/tag/v2.5.8">Clash Verge Rev v2.5.8 发行页</a>、<a href="https://www.clashverge.dev/install.html">官方安装文档</a>。</div>

1
docs/content/tutorials/migration.html Normal file
View File

File diff suppressed because one or more lines are too long

78
docs/content/tutorials/migration.md Normal file
View File

@ -0,0 +1,78 @@
从旧版 Clash for Windows 迁移时，最重要的是把订阅和自定义规则保留下来，再确认新客户端真正接管了需要代理的连接。本文使用 **Clash Verge Rev**，完成从下载安装到连接验证的整个过程。
<nav class="guide-toc" aria-label="文章目录"><strong>阅读路线</strong><a href="#prepare">迁移准备</a><a href="#install">下载安装</a><a href="#import">导入订阅</a><a href="#mode">选择模式</a><a href="#verify">确认连接</a><a href="#trouble">常见问题</a></nav>
<h2 id="prepare">01　先保存旧配置，再切换客户端</h2>
保留原订阅链接，以及自己添加的规则、代理组和覆写文件，方便在新客户端中重新导入。
可以先安装新客户端；准备启用它时，再关闭旧客户端的系统代理和 TUN，并退出旧程序。两个客户端同时接管网络，容易出现端口、系统代理或路由冲突。确认新客户端可用后，再决定是否卸载旧版。
旧配置并不一定需要整份搬过去。只有常规订阅时，重新导入通常更清楚；有自定义配置时，先用原订阅建立可用连接，再逐项迁移并检查。
<h2 id="install">02　从官方发行页下载安装</h2>
打开 [Clash Verge Rev 官方下载页](https://github.com/clash-verge-rev/clash-verge-rev/releases/latest)，在 Windows 安装包中选择与电脑架构相符的版本。安装包按电脑架构选择，版本以官方发行页为准。
| 你的电脑 | 选择方式 |
|---|---|
| 常见 Intel / AMD 处理器电脑 | Windows x64 安装包 |
| Windows on ARM 设备 | Windows ARM64 安装包 |
| 不确定架构 | 在 Windows“设置 → 系统 → 系统信息”中查看系统类型 |
本文适用于 Windows 10 / 11。不要给 Windows 7 强装新版本。优先使用普通安装包；如果缺少 WebView2 导致窗口无法显示，再按官方说明安装运行环境，或选择发行页提供的内置 WebView2 版本。具体兼容要求见[官方安装说明](https://www.clashverge.dev/install.html)。
<h2 id="import">03　导入并启用一份订阅</h2>
1. 在本站[免费节点页面](/freenode)中复制适用于 **Clash / Mihomo** 的订阅地址；仍在使用的旧订阅也可以重新导入。不要把文章网页地址当成订阅。
2. 打开 Clash Verge Rev 的“订阅”页面，粘贴链接并导入。
3. 确认出现订阅卡片，并将它设为当前使用的配置。仅有卡片不代表已经启用。
4. 进入“代理”页面，确认能看到节点或代理组。
<figure class="guide-figure"><a href="/images/tutorials/verge-import.png" target="_blank" rel="noopener"><img src="/images/tutorials/verge-import.png" width="2006" height="950" loading="lazy" alt="官方导入订阅示例：在订阅页面粘贴订阅链接并点击导入"></a><figcaption>图 1 · 官方文档中的订阅导入示例。窗口样式仅作定位参考，可点击查看大图。<a href="https://www.clashverge.dev/guide/quickstart.html">图片来源</a></figcaption></figure>
如果拿到的是本地 YAML 文件，可使用客户端的本地配置导入功能。远程订阅可以刷新获取更新，本地文件导入则不会自动变成远程订阅。详细方式见[官方订阅管理说明](https://www.clashverge.dev/guide/profile.html)。
导入时报错，先核对链接是否完整、订阅是否有效，以及返回的是否为兼容配置。出现证书错误应检查系统时间、链接域名与服务商状态，不要通过关闭证书验证来掩盖问题。
<h2 id="mode">04　分别选择“如何接管”和“如何分流”</h2>
这两组设置解决不同问题。**系统代理、TUN 决定流量怎样进入客户端；规则、全局、直连决定进入后的流量怎样出去。**
<figure class="guide-diagram"><div class="diagram-label">图 2 · 两个独立的选择</div><div class="guide-flow"><div><b>应用</b><small>浏览器、下载器等</small></div><span>→</span><div><b>接管方式</b><small>系统代理 / TUN</small></div><span>→</span><div><b>分流模式</b><small>规则 / 全局 / 直连</small></div><span>→</span><div><b>实际出口</b><small>代理节点或直接连接</small></div></div><figcaption>切换到“全局”不会自动接管所有应用；应用请求仍需先进入客户端。</figcaption></figure>
第一次使用，建议先启用 **系统代理 + 规则模式**。在需要代理的策略组里选一个可用节点，注意不要误选 `DIRECT`。规则模式按当前配置决定流量去向，并不天然保证“国内全部直连、国外全部代理”。
| 模式 | 适合怎样使用 |
|---|---|
| 规则 | 日常使用；根据订阅中的规则选择出口 |
| 全局 | 临时排查分流问题；进入内核的普通业务连接使用全局策略组 |
| 直连 | 让内核直接连接目标；不等于退出客户端或恢复系统设置 |
如果浏览器可用、某个应用仍无法连接，先确认该应用是否遵循系统代理。确有需要时，再按客户端提示安装或启用所需服务，并开启 TUN。TUN 的接管范围仍受平台、路由与排除规则影响。相关操作见[官方快速入门](https://www.clashverge.dev/guide/quickstart.html)。
<h2 id="verify">05　用一次真实请求确认连接</h2>
不要只看开关颜色或节点延迟。按下面顺序检查，更容易发现问题：
1. **配置已生效。** 当前订阅已启用，代理组最终选中的是预期节点。
2. **请求被接管。** 访问一个你明确希望走代理的网站，在客户端连接记录中找到它，并查看匹配规则和出口链路。
3. **结果符合策略。** 页面正常响应；如用 IP 查询网站辅助验证，要先确认该查询请求本身走了代理。规则模式下，某个 IP 查询网站直连并不证明其他网站也直连。
延迟测试只能说明节点对测试目标的连通情况，不能代替网页、下载或实际业务的测试。完成这些检查后，再逐项恢复自定义规则。
<h2 id="trouble">06　按故障出现的位置排查</h2>
| 现象 | 优先检查 |
|---|---|
| 安装包无法运行 | 系统版本、x64 / ARM64 架构是否匹配 |
| 只有托盘图标、主窗口打不开 | WebView2 是否正常，参考官方 Windows FAQ |
| 订阅导入失败 | 链接完整性、有效期、配置格式与错误信息 |
| 节点列表正常，网页仍打不开 | 当前配置、策略组选择、系统代理状态与连接记录 |
| 浏览器可用，其他应用不可用 | 应用是否遵循系统代理；是否需要 TUN |
| 开启 TUN 后局域网或其他 VPN 异常 | 先恢复原接管方式，再检查路由冲突和排除项 |
| 退出客户端后仍无法访问网络 | 是否留下指向本机已停止端口的系统代理 |
最后一种情况，可查看 Windows“设置 → 网络和 Internet → 代理”。确认是旧客户端留下的本机手动代理后再关闭；工作单位管理的代理设置应按其管理要求处理。更多环境问题见[官方 Windows 常见问题](https://www.clashverge.dev/faq/windows.html)。
<div class="guide-note"><strong>下一步：检查 DNS 的实际路径</strong><p>客户端能够联网之后，还可以单独核对 DNS 接管、加密解析和出口。继续阅读：<a href="/a/mihomo-dns-leak.html">Clash 进阶：DNS 防泄漏配置与验证</a>。</p></div>

1
docs/content/tutorials/quantumult-x-ios.html Normal file
View File

File diff suppressed because one or more lines are too long

99
docs/content/tutorials/quantumult-x-ios.md Normal file
View File

@ -0,0 +1,99 @@
Quantumult X 可以在 iPhone、iPad 上管理代理节点、选择策略并接管连接。第一次使用时，关键是把订阅变成客户端能读取的节点，再确认流量确实使用了选中的线路。
本文只讲 **Quantumult X**。Quantumult 是另一个应用，两者的界面和配置不能混用。这里也不涉及重写脚本、广告过滤或 HTTPS 解密，先完成基本连接即可。
<figure class="guide-diagram"><div class="diagram-label">从免费订阅到第一次连接</div><div class="guide-flow"><div><b>安装 Quantumult X</b><small>核对开发者与系统要求</small></div><span>→</span><div><b>导入节点资源</b><small>必要时使用资源解析器</small></div><span>→</span><div><b>选择节点与策略</b><small>确认请求的去向</small></div><span>→</span><div><b>开启连接</b><small>允许VPN配置并实际访问</small></div></div><figcaption>图 1 · 订阅导入、策略选择和VPN开关分别对应不同环节，缺少其中一步都可能无法使用。</figcaption></figure>
<nav class="guide-toc" aria-label="文章目录"><strong>阅读路线</strong><a href="#install">下载应用</a><a href="#format">选择订阅格式</a><a href="#parser">资源解析器</a><a href="#import">导入节点</a><a href="#connect">连接与验证</a><a href="#daily">日常使用</a><a href="#faq">常见问题</a></nav>
<h2 id="install">01　从 App Store 获取 Quantumult X</h2>
打开[Quantumult X 的 App Store 页面](https://apps.apple.com/us/app/quantumult-x/id1443988620)，核对应用名和开发者 **Cross Utility Ltd**。这是付费应用，实际价格与是否可购买，以你使用的商店地区为准。
以 **1.8.1** 为例，系统要求为 **iOS 15.0 / iPadOS 15.0 或更高版本**。若当前商店搜索不到，不要把名字相近的应用当成同一个客户端；先核对商店是否提供该应用。
安装后先打开应用查看初始界面。不同版本的“节点资源”“策略”和连接开关位置可能略有变化，可按功能名称查找。
<h2 id="format">02　先看订阅是什么格式</h2>
在本站[免费节点页面](/freenode)中打开较新的分享。页面会提供不同格式的资源，但**目前不能把本站通用订阅直接视为 Quantumult X 原生订阅**。
| 手里的内容 | 如何处理 |
|---|---|
| 明确标注为Quantumult X节点资源 | 可按原生节点资源导入 |
| 本站v2ray订阅 | 需要能识别其内容的资源解析器，再导入节点 |
| Clash / Mihomo或sing-box完整配置 | 不要当成Quantumult X完整配置直接覆盖 |
| 普通文章网址 | 先进入文章，复制里面真正的订阅地址 |
“资源解析”主要解决格式转换，不会让失效节点恢复，也不能保证任意协议和参数都能转换。第一批导入失败时，先确认格式与解析器，不必立刻重装应用。
<h2 id="parser">03　通用订阅需要先配置资源解析器</h2>
通用订阅可通过 [KOP-XIAO 资源解析器](https://github.com/KOP-XIAO/QuantumultX)转换为 Quantumult X 能读取的节点资源。它是**第三方脚本**，并非 Quantumult X 内置功能。可以先在作者仓库查看说明和脚本内容，再决定使用。
在应用设置中找到当前配置的编辑入口。在已有的 `[general]` 区域内加入或修改这一项，保存配置：
```ini
[general]
resource_parser_url = https://raw.githubusercontent.com/KOP-XIAO/QuantumultX/master/Scripts/resource-parser.js
```
这里展示了节名，方便定位；已有 `[general]` 时，只放入其中的 `resource_parser_url` 这一行，不要重复建立整段，也不要把当前配置全部替换成这两行。若原来已经指定了其他解析器，先保留原配置副本，再决定是否更换。
解析器由客户端下载并在本地解析资源内容。这个路径仍需要设备能够访问；下载失败时先核对脚本地址和连接条件，不能把“已填入地址”当成“脚本已加载成功”。使用上面给出的解析器地址，避免误填其他示例脚本。
<figure class="guide-diagram"><div class="diagram-label">资源解析器做了什么</div><div class="guide-flow"><div><b>下载订阅内容</b><small>取得分享链接或节点列表</small></div><span>→</span><div><b>客户端运行解析器</b><small>转换支持的格式与参数</small></div><span>→</span><div><b>生成可用节点条目</b><small>随后再测试连接</small></div></div><figcaption>图 2 · 转换成功只表示客户端能读取节点。协议兼容性、节点是否在线和实际访问仍需分别检查。</figcaption></figure>
<h2 id="import">04　添加节点资源，并确认列表出现</h2>
复制本站较新分享中的 **v2ray 订阅地址**，进入 Quantumult X 设置中的节点资源或节点引用管理，添加远程资源：
1. 为资源填写一个容易辨认的名称，例如“本站免费节点”。
2. 粘贴实际订阅地址，启用该资源。
3. 对需要转换的通用订阅开启资源解析选项，再保存并更新。
4. 返回节点列表，确认出现了实际节点，而不是只有资源名称或错误提示。
如果当前版本界面入口不易辨认，也可以按开发者配置格式，在已有的 `[server_remote]` 区域加入资源行：
```ini
[server_remote]
https://example.invalid/subscription, tag=本站免费节点, opt-parser=true, enabled=true
```
**上面的地址是占位示例，必须换成从本站复制的真实订阅链接。** 已有节名时只加入资源行，保留原来的其他配置；不要同时在界面和配置中重复添加同一份资源。`opt-parser=true` 表示对这份资源调用解析器，`enabled=true` 表示启用资源。
原生 Quantumult X 节点资源通常不需要这个转换步骤。导入结果少于原订阅节点数时，可能存在解析器或客户端不支持的参数，应检查资源更新提示，不把条目数量当成连接质量。
<h2 id="connect">05　选择策略，再开启 VPN 连接</h2>
有了节点后，先选一条线路作为当前代理使用的节点。Quantumult X 的策略组负责选择节点，分流规则负责选择策略；具体名称取决于当前配置，导入一份节点资源不会自动生成你想要的全部分流规则。
首次排查可以暂时使用应用的**全局代理模式**，并确认其当前策略选中了实际节点，而不是 `direct` / 直连；先减少规则差异，确认这一条线路能够工作。完成验证后再切回规则分流，检查常用服务是否按预期选择策略。全局代理模式也不等于已经完成所有泄漏检查。
开启应用连接开关。首次连接时，iOS 会询问是否允许添加 VPN 配置，按系统提示允许并完成设备验证。基础代理使用不需要安装用于 HTTPS 解密的根证书。
连接后打开 Safari，访问实际需要的网页；再查看应用中的请求记录，确认目标域名、命中策略和节点。看到系统VPN标记只说明VPN配置在运行，并不能单独证明节点可达或目标服务可用。
<h2 id="daily">06　日常更新与停止使用</h2>
| 要做的事 | 建议操作 |
|---|---|
| 当前节点不通 | 在当前策略中换其他节点，再重新请求 |
| 订阅节点需要刷新 | 在节点资源管理中更新对应资源 |
| 旧批次普遍失效 | 回本站免费节点页面查看较新的分享，按需要更新资源地址 |
| 停止代理 | 关闭应用连接开关，并确认VPN已断开 |
| 启动后又自动连接 | 检查是否启用了按需连接及其他相关自动化设置 |
如果同时使用 Mac，可以继续看[Mac 客户端下载指南](/a/m172.html#download)。Mac 上的 Clash Verge Rev 需要对应的 Clash / Mihomo 订阅，不能把这篇教程的 Quantumult X 配置直接搬过去。
<h2 id="faq">07　常见问题</h2>
**订阅更新成功，为什么没有节点？** 核对导入的是节点资源而非文章页；对通用订阅，检查解析器是否成功下载，以及该资源是否开启解析。再看资源是否启用、内容是否为空或包含不支持的格式。
**节点有延迟，网页还是打不开。** 延迟检查只是一次特定请求；目标网站、出口策略或当前线路仍可能失败。查看实际请求记录，再尝试其他节点或另一个目标，分开判断节点和网站的问题。
**VPN已连接，但走的是直连。** 检查运行模式、命中规则与策略组选择。只更新订阅不会自动把现有的直连策略改为某个节点。
**别的教程让我导入完整配置。** 完整配置可能同时改变节点资源、规则、DNS、脚本和重写设置。本文只需要完成节点连接，导入前先看清它会覆盖哪些部分，保留自己的原配置。
<div class="guide-footnote">参考资料：<a href="https://github.com/crossutility/Quantumult-X/blob/master/sample.conf">开发者示例配置</a>、<a href="https://github.com/KOP-XIAO/QuantumultX/blob/master/Scripts/resource-parser.js">解析器作者源码</a>。</div>

1
docs/content/tutorials/system-proxy-tun.html Normal file
View File

File diff suppressed because one or more lines are too long

103
docs/content/tutorials/system-proxy-tun.md Normal file
View File

@ -0,0 +1,103 @@
浏览器能打开网页，终端却一直超时；已经切到“全局”，游戏还是连不上；打开 TUN 后能用了，又担心所有网站都被送到国外。遇到这些情况，先分清两件事：**流量有没有进入代理客户端，以及进入以后走哪个出口。**
系统代理和 TUN 主要解决第一件事，规则、全局和直连模式主要解决第二件事。本文以 Clash Verge Rev 和 Mihomo 桌面客户端为例，说明它们的区别、适用场景和检查方法。
<nav class="guide-toc" aria-label="文章目录"><strong>阅读路线</strong><a href="#system-proxy">系统代理接管什么</a><a href="#tun">TUN 改变了什么</a><a href="#routing">为什么全局不等于全部</a><a href="#choose">应该用哪一种</a><a href="#switch">怎样切换和检查</a><a href="#troubleshoot">按现象排错</a><a href="#dns">DNS 还要单独看</a></nav>
<h2 id="system-proxy">01　系统代理：让应用按设置转交请求</h2>
打开 Clash Verge Rev 的“系统代理”，客户端会修改操作系统的代理设置，把代理地址指向本机正在监听的端口。愿意读取并遵循这项设置的应用，就会把相应请求交给客户端处理。浏览器通常可以通过这种方式使用代理。[官方快速入门](https://www.clashverge.dev/guide/quickstart.html)
这里的关键是“应用遵循设置”。有的软件读取系统设置，有的软件使用自己的代理配置，还有的软件直接建立连接。同一台电脑上，浏览器正常、另一个应用不走代理，并不矛盾。
<figure class="guide-diagram"><div class="diagram-label">图 1 · 系统代理依赖应用配合</div><div class="guide-flow"><div><b>应用读取设置</b><small>使用系统指定的代理</small></div><span aria-hidden="true">→</span><div><b>本机代理端口</b><small>请求进入 Mihomo</small></div><span aria-hidden="true">→</span><div><b>匹配出口</b><small>直连或代理节点</small></div></div><div class="guide-branch">不遵循系统代理的应用：仍按自己的网络设置连接，不会仅因这个开关而进入 Mihomo。</div><figcaption>这也解释了为什么“浏览器能用”不能代表电脑上每个应用都已经走代理。</figcaption></figure>
如果应用提供 HTTP 或 SOCKS 代理选项，可以单独指向客户端的本机端口。地址通常是 <code>127.0.0.1</code>，端口应查看客户端当前设置，不要照抄别人的数字；HTTP、SOCKS 和混合端口也要对应正确。
终端工具同样需要看各自支持什么。以 Linux 上的 curl 为例，可以先用[单条命令指定代理的方法](/a/m174.html#terminal)检查，不必为了一个工具马上接管整台电脑。
<h2 id="tun">02　TUN：通过虚拟网卡接收流量</h2>
TUN 会创建虚拟网络接口，并通过路由把符合接管条件的 IP 流量交给内核。应用不必先学会使用 HTTP 或 SOCKS 代理，因此它常用于系统代理无法覆盖的程序。Mihomo 可以处理通过 TUN 进入的 TCP、UDP 流量，但最终能否完成连接，还取决于配置、节点和目标服务。[官方名词解释](https://www.clashverge.dev/guide/term.html)
<figure class="guide-diagram"><div class="diagram-label">图 2 · TUN 在网络路由这一层接管</div><div class="guide-flow"><div><b>应用发起连接</b><small>无需读取系统代理</small></div><span aria-hidden="true">→</span><div><b>系统路由 → TUN</b><small>进入虚拟网卡</small></div><span aria-hidden="true">→</span><div><b>Mihomo 处理</b><small>再决定实际出口</small></div></div><div class="guide-branch">被排除的地址、接口或其他未进入 TUN 的连接，仍可能走原来的网络路径。</div><figcaption>TUN 扩大了接管范围，但开关亮着不等于每一条连接都已被接管。</figcaption></figure>
TUN 也有接管范围。自动路由、排除网段、IPv6 设置及其他 VPN 的路由，都可能影响实际路径。例如，把某个局域网网段排除在 TUN 之外，就是让它绕过这层接管；这与连接进入 Mihomo 后命中 <code>DIRECT</code> 规则不同。[Mihomo TUN 配置](https://wiki.metacubex.one/config/inbound/tun/)、[代理绕过说明](https://www.clashverge.dev/guide/bypass.html)
日常使用图形客户端时，优先使用它提供的 TUN 设置。建立网卡和修改路由需要相应权限；Clash Verge Rev 的服务模式可让具有权限的后台服务启动内核，不代表必须一直以管理员身份运行整个界面。[服务模式说明](https://www.clashverge.dev/guide/term.html)
<h2 id="routing">03　“全局”和 TUN 不是同一个维度</h2>
把“规则”改成“全局”，改变的是进入内核后的出口选择。一个完全没有进入客户端的应用，不会因为切到全局就自动被接管。
反过来，开启 TUN 也不要求使用全局模式。**TUN + 规则模式**可以接管更多应用，同时继续按规则让部分连接直连、部分连接使用节点。[规则与全局模式说明](https://www.clashverge.dev/guide/term.html)
<figure class="guide-diagram"><div class="diagram-label">图 3 · 先进入客户端，再决定去哪里</div><div class="guide-flow"><div><b>第一步：接管</b><small>系统代理 / 应用代理 / TUN</small></div><span aria-hidden="true">→</span><div><b>第二步：选择出口</b><small>规则 / 全局 / 直连</small></div><span aria-hidden="true">→</span><div><b>第三步：建立连接</b><small>本地网络或所选节点</small></div></div><figcaption>排错也按这个顺序进行：先找有没有进入，再看实际出口，最后判断线路是否可用。</figcaption></figure>
| 常见组合 | 实际含义 |
|---|---|
| 系统代理 + 规则 | 遵循系统代理的请求进入客户端，再按当前配置分流 |
| 系统代理 + 全局 | 进入内核的普通业务连接使用全局策略；未被接管的应用仍可能绕过 |
| TUN + 规则 | 被 TUN 接管的连接按规则选择出口，并非全部使用代理节点 |
| TUN + 全局 | 被接管的普通业务连接使用全局策略；仍需查看所选策略是否为可用节点 |
一个具体例子：浏览器和下载工具访问同一域名，浏览器连接记录里显示了节点，下载工具却没有记录。此时应优先检查下载工具的代理设置或接管方式；反复切换全局，通常没有解决前面的缺口。
<h2 id="choose">04　按应用需求选择，不必一开始全部打开</h2>
| 你要完成的事 | 可以先这样做 |
|---|---|
| 主要浏览网页，常用软件已经正常 | 使用系统代理 + 规则模式 |
| 只有一个应用不跟随系统设置，且自带代理选项 | 给该应用配置正确的本机代理端口 |
| 多个应用不支持代理设置，希望统一处理 | 考虑 TUN + 规则模式，再逐个检查所需应用 |
| 游戏或语音涉及 UDP | 检查 TUN 接管，同时确认所选节点支持所需 UDP 转发 |
| 需要同时访问公司 VPN、NAS 或局域网设备 | 先明确这些连接的路径，再设置绕过或直连，避免盲目全局接管 |
**TUN 不是加速档位。** 游戏登录网页能打开，不代表游戏数据传输已经正常；节点对网页可用，也不代表它能承载所需的 UDP。选择方式要看应用连接是否按预期工作，而不是哪个开关听起来更强。
系统代理和 TUN 可以同时存在，但两个开关都开不代表效果翻倍。应用主动交给本机端口的请求，本来就已进入客户端；其他连接可能由 TUN 接管。排错时，先明确正在验证哪条路径，比同时改动多个设置更容易找到原因。
<h2 id="switch">05　从系统代理切到 TUN，怎样确认有效</h2>
先确保客户端已经导入配置、选中可用节点，并完成基本连接。尚未完成这一步，可以按对应平台的教程操作：[Windows](/a/clash-verge-rev-windows.html#enable)、[Mac](/a/m173.html#enable)、[Linux](/a/m174.html#connect)。
1. **记录原来的设置。** 包括系统代理、TUN 开关和当前代理组。保持订阅、节点和规则模式不变，便于对比。
2. **按客户端提示启用服务和 TUN。** 若开关自动关闭或提示权限错误，先处理服务状态与具体错误，不要继续叠加 DNS、协议栈等改动。
3. **排除其他入口的干扰。** 若要确认某个应用是否由 TUN 接管，暂时关闭本客户端的系统代理，并检查该应用是否另设了代理；有的话记录原值，再临时停用。只关闭系统代理，不能排除应用自己的代理设置。
4. **让目标应用发起新连接。** 重连应用或重新打开目标内容，避免只观察缓存页面和原有长连接。
5. **查看连接记录。** 按域名、目标 IP 或可用的进程信息定位请求，查看匹配规则、出口策略，以及界面或日志提供的入站信息。应走节点的请求如果显示 DIRECT，需要回到分流规则检查。
6. **检查日常需要的本地服务。** 包括局域网设备、公司内网等；确认没有因路由变化失去访问能力，再保留这套设置。
关掉系统代理后应用仍能联网，只能说明它不依赖刚才关闭的那项设置。还要结合新连接记录和实际出口，才能判断 TUN 是否按预期接管；应用本来就能直连时，单凭“能打开”尤其容易误判。
如果切换后异常，先关闭 TUN，恢复刚才记录的系统代理和应用设置，让连接回到原先可用的状态，再按下一节定位。
<h2 id="troubleshoot">06　按现象定位，少做无关改动</h2>
### 浏览器能用，终端或另一个应用不能用
先检查该应用是否跟随系统代理，或者是否需要独立配置。观察它发起新请求时，客户端有没有相应连接记录。记录里没有出现时，先清除列表筛选、重试并查看日志，排查接管问题；已经出现时，再看命中的规则和实际出口。
### 开了 TUN，流量仍显示 DIRECT
DIRECT 表示这条连接由客户端直连，并不等于 TUN 没有工作。检查它是否命中了局域网、国内地址等直连规则，或代理组本身选中了 DIRECT。需要改变的是对应出口策略，而不是反复重启虚拟网卡。
### 网页正常，游戏或语音仍然失败
把登录请求和实时数据连接分开看。后者可能使用不同的地址、端口和 UDP。确认目标连接已进入客户端，再检查节点是否支持相关转发；网页测试成功不能代替这项检查。
### 一开 TUN，局域网、公司 VPN 或整个网络就异常
先恢复原先可用的方式，再检查路由重叠、网段冲突和客户端日志。系统代理绕过、TUN 路由排除与内核 DIRECT 规则各自发生在不同位置，不应混为一谈。不要把删除网卡或关闭全部防火墙作为第一步。[代理绕过说明](https://www.clashverge.dev/guide/bypass.html)、[Windows TUN 常见问题](https://www.clashverge.dev/faq/windows.html)
### 关闭系统代理，连接却还在走节点
检查 TUN 是否仍开启，以及应用自己的代理设置是否仍生效。想停用本客户端的接管，应同时处理实际启用的入口，并重新建立连接。关闭窗口可能只是把客户端收进托盘，也不等于退出。
<h2 id="dns">07　TUN 能接管流量，DNS 仍要单独检查</h2>
访问网站的连接和解析域名的查询，可能走不同路径。TUN 已经开启，并不能直接推出“DNS 一定经过节点”。普通 DNS 是否被接管、应用是否使用独立的加密 DNS，以及解析服务连接走直连还是代理，都需要分别看。
例如，浏览器使用 DoH 时，查询本身是加密的 HTTPS 连接。它可能经 TUN 进入内核，但不会仅因一条针对 53 端口的 DNS 劫持设置，就自动变成 Mihomo 内置 DNS 处理的查询。相关字段和平台差异见[Mihomo TUN 配置](https://wiki.metacubex.one/config/inbound/tun/)。
想继续检查解析路径，可以阅读[DNS 防泄漏配置与验证](/a/mihomo-dns-leak.html#dns-2)。日常排查时，先确认应用连接进入了哪里，再看它选了什么出口，最后补上 DNS 这条路径，通常比不断切换“系统代理、TUN、全局”更有效。

1
docs/content/tutorials/v2rayng-android.html Normal file
View File

File diff suppressed because one or more lines are too long

98
docs/content/tutorials/v2rayng-android.md Normal file
View File

@ -0,0 +1,98 @@
在 Android 手机上使用本站的免费节点，可以先把 v2ray 订阅导入 v2rayNG，再选择一个节点连接。订阅负责提供节点列表，客户端负责建立连接；以后节点变化时，通常刷新订阅就能重新获取列表。
这篇教程从安装开始，带你完成第一次连接，再讲怎样更新订阅、换节点，以及连接失败时先检查哪里。
<figure class="guide-diagram"><div class="diagram-label">从安装到第一次连接</div><div class="guide-flow"><div><b>安装 v2rayNG</b><small>选择适合手机的 APK</small></div><span>→</span><div><b>添加订阅</b><small>保存地址，再更新列表</small></div><span>→</span><div><b>选择节点</b><small>点选一条线路</small></div><span>→</span><div><b>启动并验证</b><small>允许 VPN，打开网页</small></div></div><figcaption>图 1 · 操作流程示意。出现节点列表后，还需要启动连接。</figcaption></figure>
<nav class="guide-toc" aria-label="文章目录"><strong>阅读路线</strong><a href="#install">下载安装</a><a href="#subscription">获取订阅</a><a href="#import">导入节点</a><a href="#connect">启动连接</a><a href="#check">确认可用</a><a href="#daily">更新与切换</a><a href="#faq">常见问题</a></nav>
<h2 id="install">01　下载并安装 v2rayNG</h2>
打开 [v2rayNG 官方发行页](https://github.com/2dust/v2rayNG/releases/latest)，展开 **Assets**，下载以 `.apk` 结尾的安装包。安装包架构按下表选择；后续更新也可使用这个官方入口。
| 手机或设备类型 | 选择哪个包 |
|---|---|
| 近几年的常见 Android 手机 | 文件名含 `arm64-v8a` 的标准版 |
| 不确定处理器架构 | 文件名含 `universal` 的通用版，体积较大 |
| 已确认是 32 位 ARM 的旧设备 | 文件名含 `armeabi-v7a` 的版本 |
| x86 架构设备或模拟器 | 按实际架构选择 `x86` / `x86_64`，或通用版 |
完整的包名说明见[官方发布文件介绍](https://github.com/2dust/v2rayNG/wiki/Release-files-introduction-for-Android)。`Source code` 是源码，`.sig` 是签名文件，都不是用来直接安装的 APK。
下载后打开 APK，按手机提示完成安装。若系统要求允许当前浏览器或文件管理器“安装未知应用”，按提示为本次安装开启该权限即可。v2rayNG 2.3.11 的最低系统要求为 **Android 7.0**；通用包只能解决架构选择问题，不能让过旧的系统满足版本要求。
<h2 id="subscription">02　从本站取得适用的订阅</h2>
进入本站[免费节点页面](/freenode)，打开较新的一篇分享，找到标有 **v2ray / shadowrocket / 小火箭** 的订阅地址。v2rayNG 使用其中的 v2ray 订阅；同一篇文章里的 Clash / Mihomo 配置可按 [Clash Meta for Android 教程](/a/m169.html#import)导入；sing-box 配置也有对应客户端，导入时要认准格式。
复制的是订阅链接本身，不是免费节点文章的网址。文章网址用于阅读说明，订阅链接才是客户端获取节点列表的入口。
免费节点的可用性会变化，较新的分享也不保证每个节点都能连接。先导入并尝试几条线路，后面再按实际使用情况保留合适的节点。
<h2 id="import">03　添加订阅，再更新出节点列表</h2>
打开 v2rayNG，按下面的顺序操作。以下步骤以 2.3.11 为例；其他版本可按同名选项操作。
1. 打开左上角导航菜单，进入 **订阅分组**。
2. 点击添加按钮，在“备注”中填写一个容易辨认的名字，例如“本站免费节点”。
3. 在 **URL** 一栏粘贴刚才复制的订阅地址，保持“启用更新”打开，保存。
4. 回到订阅分组列表，点击顶部的 **更新订阅** 按钮。
5. 若出现更新选项，勾选“更新订阅”并确认；首次导入先完成这一项即可。
6. 等待更新完成，回到主界面并查看对应分组，确认节点列表已经出现。
<figure class="guide-diagram"><div class="diagram-label">订阅导入的关键是两步</div><div class="guide-flow"><div><b>保存订阅地址</b><small>告诉软件“去哪里获取”</small></div><span>→</span><div><b>执行更新订阅</b><small>下载并读取节点信息</small></div><span>→</span><div><b>主界面出现节点</b><small>现在才可以选择线路</small></div></div><figcaption>图 2 · 功能关系示意，并非软件截图。只保存分组、没有更新，是列表为空时首先要检查的地方。</figcaption></figure>
添加订阅时，“URL”虽然标为可选，但本教程需要通过网络获取节点，因此这里要填写地址。其他高级字段保持原样，不必填写请求头、过滤表达式或代理链。
如果拿到的是一条 `vmess://`、`vless://`、`trojan://` 等节点分享链接，可以复制后使用主界面的 **添加配置 → 从剪贴板导入**。这会添加单独的节点；想随分享更新一整组节点，仍应使用前面的订阅方式。
<h2 id="connect">04　选择节点，启动连接</h2>
在主界面点选一个节点，确认它已处于选中状态，再点击右下方的启动按钮。2.3.11 使用播放形状的启动图标，运行后会切换为停止图标。
首次启动时，Android 通常会弹出 VPN 连接请求，确认应用名称为 v2rayNG 后允许。这里的 VPN 权限用于让客户端接管手机流量，不需要为此给手机 Root。
如果另一个代理或使用本地 VPN 的过滤工具正在运行，先停止它再连接 v2rayNG。同一个 Android 用户空间通常只能有一个活动 VPN 服务，后来启动的应用可能把前一个断开。
首次连接先保持应用默认设置，暂时不用修改 DNS、路由或分应用名单。等基础连接成功后，再按需要调整流量范围。
<h2 id="check">05　确认节点真的能用</h2>
看到 VPN 标识，说明手机已经建立了本地接管通道；节点是否能访问外网，还要继续检查。
先在客户端使用 **测试真连接延迟**，或者点击底部的连接测试区域检查当前节点。然后打开浏览器，访问一个你实际需要使用的网站，再尝试相应的应用。
| 看到的结果 | 可以说明什么 |
|---|---|
| 节点列表已经出现 | 订阅已成功读取，尚不能说明节点可用 |
| VPN 标识或停止按钮出现 | 客户端服务正在运行 |
| 真连接测试返回延迟 | 对测试目标的连接成功 |
| 实际网页或应用正常使用 | 本次需要的访问已完成 |
测试地址和你要访问的服务可能不同，因此延迟数字只作参考。如果某个节点一直超时，先换另一条，再重复测试和网页访问。不要只看最低延迟就认定它适合所有网站。
<h2 id="daily">06　平时怎样更新、换节点和断开</h2>
**更新列表：** 回到“订阅分组”执行更新。本站分享可能使用按日期变化的订阅地址；刷新旧地址只会重新读取旧地址里的内容，不会自动切换到新一期。如果这一批节点都失效了，回到[免费节点页面](/freenode)查看较新的分享，在原分组中替换 URL、保存后再次更新。
**更换节点：** 在主界面选中另一条节点。如果不确定当前连接是否已经切换，可以先停止，再选节点并重新启动，然后重新打开网页验证。
**暂停使用：** 点击停止按钮，确认服务结束。返回桌面或关闭主窗口并不等于断开连接。
如果你也需要在 Windows 电脑上使用本站节点，可以接着看 [Clash Verge Rev 入门教程](/a/clash-verge-rev-windows.html#install)；电脑端按那篇文章选取 Clash / Mihomo 格式的订阅。
<h2 id="faq">07　遇到问题，从出现问题的那一步查起</h2>
**安装包无法安装。** 先核对系统版本和 APK 架构，确认下载已经完成。如果是覆盖安装时提示签名不一致，不要直接卸载：先保存已有配置，再确认新旧安装包是否来自同一发布渠道。
**保存了订阅，主界面仍然是空的。** 检查 URL 是否确实填入、分组是否启用更新，然后手动执行一次更新。更新后也要查看正确的分组，避免搜索或筛选条件隐藏了节点。
**更新失败，或者提示没有可导入的配置。** 检查是否误复制了文章网址、遗漏链接字符，或选择了 Clash / sing-box 格式。地址正确但仍失败时，确认手机本身能上网，再尝试本站较新的 v2ray 订阅。
**已经启动，但所有节点都超时。** 先停止 v2rayNG，确认普通网络可用；再换节点重连。如果只有某一批节点不可用，优先更换订阅来源或分享批次，不必反复重装软件。
**浏览器正常，某个应用不正常。** 若之前启用了分应用代理，检查那个应用是否在预期接管范围内；若没有开启，再换节点测试该服务，区分应用问题和节点对特定服务不可用。
**锁屏一段时间后断开。** 先观察 v2rayNG 服务是否仍在运行。如果是被系统结束，再到手机的应用电池管理中允许它后台运行；菜单名称因手机厂商而异。
<div class="guide-footnote">参考资料：<a href="https://github.com/2dust/v2rayNG/releases/tag/2.3.11">官方 2.3.11 发行页</a>、<a href="https://developer.android.com/develop/connectivity/vpn">Android 官方文档</a>。</div>

1
docs/content/tutorials/verge-linux.html Normal file
View File

File diff suppressed because one or more lines are too long

101
docs/content/tutorials/verge-linux.md Normal file
View File

@ -0,0 +1,101 @@
这篇教程适用于带桌面环境的 Linux 电脑，以 Ubuntu / Debian 和 Fedora 为例，完成 Clash Verge Rev 安装、订阅导入与第一次连接。只有 SSH 终端的服务器不属于这里的使用场景：Clash Verge Rev 是图形客户端，需要桌面环境。
<figure class="guide-diagram"><div class="diagram-label">Linux 安装前的三个条件</div><div class="guide-flow"><div><b>有桌面环境</b><small>能够打开图形应用</small></div><span>→</span><div><b>选对包格式</b><small>Debian 系用 DEB，Fedora 用 RPM</small></div><span>→</span><div><b>匹配 CPU 架构</b><small>x86_64 或 ARM 等</small></div></div><figcaption>图 1 · 包格式和 CPU 架构是两回事；安装失败时，先核对这两项。</figcaption></figure>
<nav class="guide-toc" aria-label="文章目录"><strong>阅读路线</strong><a href="#install">下载安装</a><a href="#import">导入订阅</a><a href="#connect">浏览器连接</a><a href="#terminal">终端代理</a><a href="#daily">日常使用</a><a href="#faq">常见问题</a></nav>
<h2 id="install">01　找到适合发行版和架构的安装包</h2>
从[Clash Verge Rev 官方发行页](https://github.com/clash-verge-rev/clash-verge-rev/releases/latest)下载正式版。在终端执行下面的只读命令，确认机器架构：
```sh
uname -m
```
| 输出 / 系统 | 下载时的选择 |
|---|---|
| `x86_64`，Ubuntu / Debian | `amd64.deb` |
| `aarch64`，Ubuntu / Debian | `arm64.deb` |
| `x86_64`，Fedora | `x86_64.rpm` |
| `aarch64`，Fedora | `aarch64.rpm` |
`amd64` 也适用于使用同一架构的 Intel 处理器，不是“只能在 AMD 电脑上安装”。其他架构需要单独核对发行文件，不能只把下载文件改名。
以下以 **v2.5.8、x86_64 电脑**为例。在文件管理器中打开下载文件所在目录，再在该目录打开终端。使用较新版本时，将文件名换成实际下载的名字。
Ubuntu / Debian：
```sh
sudo apt install ./Clash.Verge_2.5.8_amd64.deb
```
Fedora：
```sh
sudo dnf install ./Clash.Verge-2.5.8-1.x86_64.rpm
```
只执行适合自己发行版的一条命令。前面的 `./` 表示安装当前目录里的文件；包管理器会尝试处理依赖，确认安装计划后再继续。完成后从应用菜单启动 Clash Verge Rev，正常使用时不必用 `sudo` 启动整个图形程序。
旧系统遇到 WebKit 等依赖缺失时，先查[官方 Linux FAQ](https://www.clashverge.dev/faq/linux.html)和发行版支持情况。官方文档特别指出 Ubuntu 20.04 的依赖问题，并建议使用较新的系统；不要强行混入其他发行版的软件源来凑依赖。
<h2 id="import">02　导入 Clash / Mihomo 免费订阅</h2>
在本站[免费节点页面](/freenode)打开较新的分享，复制其中的 **Clash / Mihomo** 订阅地址。回到客户端：
1. 进入“订阅”，粘贴链接并导入。
2. 等待配置下载完成，选中这张订阅卡片。
3. 进入“代理”，确认已出现代理组和节点。
4. 使用规则模式，在处理代理流量的组内手动选择一条节点。
订阅卡片已保存，不代表它已经成为当前配置。看不到节点时，先检查是否选中卡片、链接格式是否正确；普通文章网址、v2ray 订阅与 sing-box 配置不能直接当成 Clash 配置。
免费节点可能随时失效。延迟测试可帮助排除超时线路，但最终仍要打开实际需要的网站验证。
<h2 id="connect">03　先让浏览器通过系统代理连接</h2>
在客户端设置中开启 **系统代理**，先保持 TUN 关闭，然后重新发起浏览器访问。系统代理是否被应用采用，取决于桌面环境和应用本身；Firefox 等浏览器也可能设置了自己的代理选项，需要确认其使用系统代理或正确的手动代理。
同时打开客户端“连接”页面，观察刚才请求的域名、匹配规则与出口。规则模式可能让部分网站走 `DIRECT`，所以“网页打开了”不一定证明它经过了远端节点。
<figure class="guide-diagram"><div class="diagram-label">浏览器能用，不代表终端自动跟随</div><div class="guide-flow"><div><b>桌面应用</b><small>是否读取桌面代理设置？</small></div><span>→</span><div><b>客户端本机端口</b><small>接收连接并按规则分流</small></div><span>→</span><div><b>远端节点或直连</b><small>在连接记录中核对</small></div></div><div class="guide-branch">命令行工具通常需要自己的代理参数或环境变量；TUN 则是另一种接管方式。</div><figcaption>图 2 · 系统代理、命令行代理和 TUN 是不同的流量入口，不能只看一个开关判断全部程序。</figcaption></figure>
<h2 id="terminal">04　需要终端访问时，先做一次单独验证</h2>
在客户端设置中查看实际的 **混合端口或 SOCKS 端口**。以下命令只给这一条 curl 请求指定代理，不会替你修改终端启动文件或全局网络设置。
把命令里的 `PORT` 替换成刚才看到的数字，再运行：
```sh
curl --noproxy "" --proxy socks5h://127.0.0.1:PORT https://example.com/
```
`127.0.0.1` 指当前电脑；`socks5h` 让 curl 把目标域名交给 SOCKS 代理处理；`--noproxy ""` 避免已有的绕过列表让这次请求跳过指定代理。客户端仍会根据自己的规则决定最终走节点还是直连。
成功返回示例网页，说明这一条请求能通过该本机代理入口完成。它不证明所有终端程序已经使用代理，也不证明所有 DNS 查询都被接管。验证需要的真实服务时，再替换目标网址，并结合客户端连接记录判断。
常用工具如 Git、包管理器和下载器各有自己的代理设置。只有确认需要长期使用后，再按对应工具文档配置；不要为了临时试一次，就把一组不明代理变量永久写入 shell 配置。
<h2 id="daily">05　更新节点与停止使用</h2>
| 情况 | 操作 |
|---|---|
| 某一条节点超时 | 换其他节点，重新发起访问 |
| 一批节点都失效 | 刷新订阅，并回本站查看较新的免费资源 |
| 浏览器正常，某应用不通 | 检查该应用的代理设置，再判断是否需要TUN |
| 暂时停用 | 关闭系统代理；已开启TUN时也关闭它，再退出客户端 |
| 退出后仍有应用报代理连接失败 | 检查该应用、桌面设置或shell环境是否残留已停止的本机代理地址 |
<h2 id="faq">06　按故障所在的环节排查</h2>
**安装时找不到文件。** 核对终端当前目录和完整文件名，尤其是版本号、大小写及 `.deb` / `.rpm` 后缀。不要把网页上的示例文件名直接套到不同版本。
**应用打不开、白屏或报 WebKit / GBM 错误。** 先记录完整错误、发行版版本、显卡和 Wayland / X11 会话类型，再对照[官方 Linux FAQ](https://www.clashverge.dev/faq/linux.html)。显示渲染错误与节点连接错误是不同问题，不需要通过反复换订阅处理。
**系统代理开启后，终端还是直连。** 先用上一节的单条 curl 请求验证端口，再检查具体工具是否有自己的代理选项。桌面开关通常不会自动给所有 shell 进程设置代理变量。
**需要接管更多应用或检查 DNS。** 完成基本连接后，再按客户端要求配置服务模式与TUN权限，并验证实际效果。DNS路径可继续看[DNS 防泄漏配置与验证](/a/mihomo-dns-leak.html)，其中的片段需要结合Linux实际网络环境调整。
如果同样要在 Mac 上使用，可先看[Mac 客户端下载指南](/a/m172.html#download)，再按对应平台步骤操作。
<div class="guide-footnote">参考资料：<a href="https://www.clashverge.dev/install.html">安装文档</a>、<a href="https://www.clashverge.dev/guide/quickstart.html">快速入门</a>、<a href="https://curl.se/docs/manpage.html">curl官方手册</a>。</div>

1
docs/content/tutorials/verge-mac.html Normal file
View File

File diff suppressed because one or more lines are too long

80
docs/content/tutorials/verge-mac.md Normal file
View File

@ -0,0 +1,80 @@
这篇教程带你在 Mac 上安装 Clash Verge Rev，导入本站的 Clash / Mihomo 免费订阅，再通过浏览器完成第一次连接。整个过程先使用规则模式和系统代理，不需要一开始就修改 DNS 或编写分流规则。
如果还没确定安装包架构，先看[Mac 客户端选择与下载指南](/a/m172.html#download)。
<figure class="guide-diagram"><div class="diagram-label">Mac 首次连接路线</div><div class="guide-flow"><div><b>安装到应用程序</b><small>选对 Apple 芯片 / Intel 包</small></div><span>→</span><div><b>导入并启用订阅</b><small>取得节点与规则</small></div><span>→</span><div><b>选择线路</b><small>规则模式与可用节点</small></div><span>→</span><div><b>开启系统代理</b><small>打开网页验证</small></div></div><figcaption>图 1 · 完成安装只是第一步，客户端还需要配置和流量入口。</figcaption></figure>
<nav class="guide-toc" aria-label="文章目录"><strong>阅读路线</strong><a href="#install">下载安装</a><a href="#import">导入订阅</a><a href="#proxy">选择节点</a><a href="#enable">开启系统代理</a><a href="#check">确认连接</a><a href="#daily">日常使用</a><a href="#faq">常见问题</a></nav>
<h2 id="install">01　下载 DMG，并安装到“应用程序”</h2>
打开[官方发行页](https://github.com/clash-verge-rev/clash-verge-rev/releases/latest)，选择正式版的 macOS `.dmg`。Apple M 系列芯片选择 `aarch64`，Intel Mac 选择 `x64`。当前官方安装要求为 macOS 12 及以上。
1. 打开下载完成的 DMG。
2. 将 Clash Verge 应用拖入“应用程序”文件夹。
3. 等待复制完成，再从“应用程序”打开它。
4. 若系统询问是否打开从互联网下载的应用，核对名称和来源后确认。
后续从“应用程序”启动即可，不必每次重新打开 DMG。升级已有安装时，先通过菜单栏菜单退出旧程序，再替换应用，避免仍运行旧版本。
如果 macOS 因开发者验证问题阻止打开，先确认安装包来自项目官方发行页，再按 [Apple 的应用打开说明](https://support.apple.com/en-gb/102445)查看“系统设置 → 隐私与安全性”中针对该应用的提示。提示应用会损害电脑时，应停止并核查来源；不用关闭整个系统的安全检查来完成普通安装。
<h2 id="import">02　导入本站订阅并选为当前配置</h2>
打开本站[免费节点页面](/freenode)，选择较新的一篇分享，复制 **Clash / Mihomo** 订阅地址。复制后回到 Clash Verge Rev：
1. 进入“订阅”页面。
2. 在订阅地址输入框中粘贴链接，点击导入。
3. 等待订阅卡片出现，选择它作为当前配置。
4. 进入“代理”页面，确认已经出现代理组和节点。
<figure class="guide-figure"><img src="/images/tutorials/verge-import.png" width="2006" height="950" loading="lazy" alt="Clash Verge Rev 订阅导入界面示例"><figcaption>图 2 · 官方文档中的订阅导入示例，展示输入框和配置卡片的关系；界面可能因版本而异。来源：<a href="https://www.clashverge.dev/guide/quickstart.html">官方快速入门</a>。</figcaption></figure>
如果保存了订阅却没有节点，先检查卡片是否已启用，再检查地址是否返回 Clash 配置。文章网页、v2ray 订阅和 sing-box 配置不能仅通过改文件后缀变成 Clash 配置。
<h2 id="proxy">03　选规则模式和一个手动节点</h2>
在代理页使用 **规则模式**，找到处理普通代理流量的代理组，手动选一条节点。组名来自订阅，可能是“节点选择”“代理”或其他名称。
初次使用先手动选，方便知道当前线路是哪一条。若提供延迟测试，可以用它筛掉持续超时的节点，但仍要用实际访问验证。`DIRECT` 表示直连，选择它不会通过代理节点。
规则模式会依据配置决定哪些连接走节点、哪些直连；全局模式则使用全局策略组。切换全局并不能自动接管所有应用，它与下一步的系统代理解决的是不同问题。
<h2 id="enable">04　开启系统代理</h2>
在客户端设置中找到 **系统代理** 并开启。若 macOS 为修改网络设置弹出授权提示，确认是本次客户端操作后按系统要求处理。首次连接可先保持 TUN 关闭。
<figure class="guide-diagram"><div class="diagram-label">系统代理能处理哪些连接？</div><div class="guide-flow"><div><b>遵循系统代理的应用</b><small>将请求交给本机代理端口</small></div><span>→</span><div><b>Clash Verge Rev</b><small>按规则选择直连或节点</small></div><span>→</span><div><b>目标网站</b><small>实际访问确认结果</small></div></div><div class="guide-branch">未使用系统代理的应用，需要检查自身代理设置；有进一步接管需求时，再了解 TUN。</div><figcaption>图 3 · 规则决定“交进来的连接怎么走”，系统代理决定哪些应用会把连接交进来。</figcaption></figure>
如果电脑上还有其他代理客户端，先关闭它们的系统代理和 TUN，避免多个程序反复修改同一套网络设置。
<h2 id="check">05　通过网页和连接记录确认</h2>
保持软件运行，重新打开一个希望通过节点访问的网站，再尝试实际需要的服务。可以同时查看客户端“连接”页面，找到刚才请求的域名，观察匹配规则和出口。
浏览器已能正常使用、某个应用仍不能连接时，先检查该应用是否遵循系统代理。不要一看到单个应用失败就认定整份订阅无效。
需要进一步了解 DNS 查询路径时，可以继续阅读 [DNS 防泄漏配置与验证](/a/mihomo-dns-leak.html)。其中的配置片段需要按当前客户端与平台调整，不是完成首次连接的必选步骤。
<h2 id="daily">06　更新、暂停和退出</h2>
| 想做的事 | 操作 |
|---|---|
| 换一条线路 | 在当前代理组中选其他节点，再重新发起访问 |
| 更新节点列表 | 刷新订阅；若旧批次已失效，回本站查看较新的订阅地址 |
| 暂停代理 | 关闭系统代理；如果另行启用了TUN，也关闭它 |
| 完全退出 | 通过菜单栏图标的退出选项结束程序 |
Mac 窗口左上角的红色关闭按钮可能只关闭窗口，后台进程仍在。判断是否断开时看代理开关和运行状态，不只看窗口是否消失。
<h2 id="faq">07　常见问题</h2>
**系统代理开关开了，浏览器仍不通。** 先确认当前订阅和组内节点，再检查 macOS 当前网络服务的代理设置是否确实发生变化。权限提示未完成、其他客户端覆盖设置，都可能影响结果。
**找不到窗口。** 先从菜单栏图标恢复主窗口；如果之前使用过外接显示器，窗口可能保留了旧位置，可参考[官方 macOS FAQ](https://www.clashverge.dev/faq/macos.html)调整显示器布局后再打开。
**退出以后普通网页也打不开。** 到“系统设置 → 网络”中打开当前 Wi-Fi 或以太网的详情，检查“代理”是否残留指向本机已停止端口的手动设置。确认属于该客户端后再清理；如果使用过TUN，也先确认已关闭。
**一定要开 TUN 吗？** 浏览器通过系统代理能满足当前需求时，可以先这样使用。有应用接管需求再配置TUN，并留意它在macOS上可能调整系统DNS；不要把开关名称当成已经完成DNS泄漏验证。
<div class="guide-footnote">参考资料：<a href="https://www.clashverge.dev/install.html">安装文档</a>、<a href="https://www.clashverge.dev/guide/profile.html">订阅说明</a>。</div>

1
docs/content/tutorials/windows.html Normal file
View File

File diff suppressed because one or more lines are too long

93
docs/content/tutorials/windows.md Normal file
View File

@ -0,0 +1,93 @@
本站分享的免费节点，可以通过订阅导入 Clash Verge Rev 使用。软件负责读取节点、选择线路和转发连接；安装好软件后，再把订阅加进去，就能开始配置。
这篇教程以 Windows 为例，从下载安装到导入本站的 Clash 订阅，再完成节点选择和连接验证。
<figure class="guide-diagram"><div class="diagram-label">先看完整流程</div><div class="guide-flow"><div><b>安装软件</b><small>从官方发行页下载</small></div><span>→</span><div><b>导入订阅</b><small>取得节点与规则</small></div><span>→</span><div><b>选择节点</b><small>先用规则模式</small></div><span>→</span><div><b>开启代理</b><small>打开网页验证</small></div></div></figure>
<nav class="guide-toc" aria-label="文章目录"><strong>阅读路线</strong><a href="#install">下载安装</a><a href="#import">导入订阅</a><a href="#node">选择节点</a><a href="#enable">开启代理</a><a href="#check">检查连接</a><a href="#daily">日常使用</a><a href="#faq">常见问题</a></nav>
<h2 id="install">01　下载并安装 Clash Verge Rev</h2>
进入 [Clash Verge Rev 官方发行页](https://github.com/clash-verge-rev/clash-verge-rev/releases/latest)，找到 Windows 安装包，根据电脑架构选择版本。
| 电脑类型 | 应选版本 |
|---|---|
| 常见 Intel / AMD 处理器的 Windows 电脑 | x64 |
| Windows on ARM 设备 | ARM64 |
| 不确定自己是哪一种 | 打开 Windows“设置 → 系统 → 系统信息”，查看系统类型 |
下载后运行安装程序，按提示完成安装并打开软件。本文适用于 Windows 10 / 11；其他系统的安装要求见[官方安装文档](https://www.clashverge.dev/install.html)。
如果安装完成却打不开主窗口，可能缺少 WebView2 运行环境。可按官方文档补装，或选择官方发行页提供的内置 WebView2 版本。
<h2 id="import">02　导入订阅，让软件显示节点</h2>
先打开本站的[免费节点页面](/freenode)，进入较新的一篇分享，找到标明 **Clash / Mihomo** 格式的订阅。复制的是订阅地址，不是当前文章的网页地址；客户端会通过它取得节点配置。
1. 在免费节点文章中复制 **Clash / Mihomo** 订阅链接。
2. 回到 Clash Verge Rev，进入“订阅”页面。
3. 把链接粘贴进订阅地址输入框，点击“导入”。
4. 等待订阅卡片出现，再选择这张卡片作为当前配置。
5. 进入“代理”页面，确认已经出现节点或代理组。
<figure class="guide-figure"><a href="/images/tutorials/verge-import.png" target="_blank" rel="noopener"><img src="/images/tutorials/verge-import.png" width="2006" height="950" loading="lazy" alt="Clash Verge Rev 官方示例：进入订阅页，粘贴订阅链接，然后导入"></a><figcaption>图 1 · 在订阅页面粘贴链接并导入。图片来自<a href="https://www.clashverge.dev/guide/quickstart.html">官方快速入门文档</a>，窗口样式可能与当前版本不同；点击可查看大图。</figcaption></figure>
如果你拿到的是 YAML 配置文件，可以使用本地配置导入功能，具体入口见[官方订阅管理说明](https://www.clashverge.dev/guide/profile.html)。
<h2 id="node">03　选择规则模式和一个可用节点</h2>
在“代理”页面，先将模式设为 **规则**。然后找到负责普通代理流量的代理组，选择一个节点。不同订阅的组名不一样，可能叫“节点选择”“代理”或其他名称。
代理组相当于一组选项：可以手动选择某个节点，也可能提供自动选择。第一次使用时，先手动选一个容易辨认的节点，便于确认当前使用的是谁。
如果客户端提供延迟测试，可以先运行一次。显示延迟数值通常说明对测试地址可达；持续显示超时的节点可以先换一个。**延迟越低不代表所有网站都越快**，最后仍要打开实际网页确认。
| 选项 | 含义 | 入门时怎么选 |
|---|---|---|
| 规则 | 按订阅中的规则决定直连还是代理 | 日常使用先选它 |
| 全局 | 进入内核的普通业务连接使用全局策略组 | 遇到分流问题时再用于排查 |
| 直连 / DIRECT | 直接连接目标，不通过代理节点 | 想使用节点时不要误选 |
“规则模式”采用的是当前订阅的规则，具体哪些网站走代理，要以这份配置为准。
<h2 id="enable">04　开启系统代理</h2>
节点选好后，进入设置，找到 **系统代理** 并开启。它会让遵循系统代理设置的应用把请求交给 Clash Verge Rev。浏览器通常可以先用这种方式连接。
<figure class="guide-figure"><a href="/images/tutorials/verge-system-proxy.png" target="_blank" rel="noopener"><img src="/images/tutorials/verge-system-proxy.png" width="2006" height="974" loading="lazy" alt="官方设置页面示例，箭头指出系统代理开关的位置"></a><figcaption>图 2 · 开启系统代理。图片来自<a href="https://www.clashverge.dev/guide/quickstart.html">官方快速入门文档</a>；请按选项名称寻找，具体布局可能不同。</figcaption></figure>
第一次使用，先把 **规则模式 + 系统代理** 这条流程走通。此时可以暂时保持 TUN 关闭，也不需要修改 DNS 或编写分流规则。
部分应用不遵循系统代理。如果浏览器已经正常、某个应用仍然无法连接，再检查该应用的代理设置，或了解客户端的 TUN 功能。切换到“全局”不会自动让这类应用进入代理。
<h2 id="check">05　打开网页，确认能够使用</h2>
保持客户端运行，打开一个你希望通过代理访问的网站。如果页面正常加载，再试一下你实际需要使用的服务。
想进一步确认，可以在客户端的“连接”页面找到刚才访问的域名，查看它匹配的规则和实际出口。有些网站按规则直连是正常现象，判断时应当看这次请求是否符合预期。
如果页面打不开，先按顺序检查三件事：**订阅是否启用、代理组是否选中可用节点、系统代理是否开启。** 都确认后，再换一个节点重试。
<h2 id="daily">06　平时怎样切换、更新和关闭</h2>
| 想做的事 | 操作方法 |
|---|---|
| 更换节点 | 到“代理”页面，切换当前使用的代理组中的节点，然后重新发起请求 |
| 更新节点列表 | 先在“订阅”页面刷新；若仍无可用节点，再查看本站较新的分享是否提供了新的订阅地址 |
| 暂停使用 | 关闭系统代理；如果另外开启过 TUN，也一并关闭 |
| 完全退出 | 使用托盘菜单中的退出选项；关闭主窗口可能只是隐藏到托盘 |
| 开机后自动运行 | 确认日常使用正常后，再按需要开启开机启动；启动程序和启用代理是两件事 |
切换节点后，已有长连接可能仍沿用原连接。验证新节点时，重新打开页面或重连应用，比只看已经打开的页面更准确。
<h2 id="faq">07　几个常见问题</h2>
**导入成功，为什么还是没有节点？** 先确认这份订阅已被选为当前配置。如果启用后仍为空，再核对订阅是否有效、格式是否适用于 Clash / Mihomo。
**节点显示超时怎么办？** 先确认电脑本身能正常上网，再尝试其他节点。免费节点的可用性会变化，如果这一批都无法连接，可以回到本站的[免费节点页面](/freenode)，查看较新的分享，重新导入可用的 Clash 订阅。
**退出软件后反而无法上网怎么办？** 检查 Windows“设置 → 网络和 Internet → 代理”，是否仍保留指向本机已停止端口的手动代理。确认是该客户端留下的设置后再关闭；受单位管理的代理按其管理要求处理。
**需要一开始就开 TUN 吗？** 不需要。先用系统代理完成浏览器连接；确有应用不能被接管时，再阅读[系统代理与 TUN 的区别及选择方法](/a/system-proxy-vs-tun.html#choose)。安装、窗口显示等问题可查[官方 Windows FAQ](https://www.clashverge.dev/faq/windows.html)。
<div class="guide-note"><strong>完成入门后的下一步</strong><p>能稳定连接后，可以继续阅读<a href="/a/mihomo-dns-leak.html">DNS 防泄漏配置与验证</a>，了解域名查询由谁处理、从哪里发出。</p></div>

161
docs/maintenance/EDITORIAL_API.md Normal file
View File

@ -0,0 +1,161 @@
# FNA_V3 独立文章 API
状态：2026-10-27本地实施并联调；2026-10-29已随独立test预览提交、推送和部署，10篇教程真实API迁移通过后，test编辑接口已关闭且临时密钥移除。正式站现已切换，正式10篇教程亦通过同一API迁移；生产临时密钥用后删除，编辑接口默认关闭，后续明确写作/发布任务再按绑定环境启用并完成后关闭。test执行和回执沿[发布记录](RELEASE_PREFLIGHT_2026-10-28.md#当前门槛先test预览确认后再切正式2026-10-29)，日常本地调用不受影响。用户明确采用本站独立接收 API，不经过 ATOM；不新增 ATOM 依赖。入口为 `http://fna-v3.loc/api/editorial/v1`，生产地址尚未指定。
## 职责与数据
AI负责选题、正文、图解、官方资料核对与自然内链；本站负责保存草稿、生成实际模板预览、按冻结版本发布、记录结果和回退。文章目录和关联登记仍以[写作索引](../content/WRITING.md)为准；API不自动改写该Markdown，也不自动创造反向链接。将相关旧文的修改显式放进同一批次，预览后原子发布。
项目正文源保留可编辑稿；`editorial_drafts`保存收到并渲染后的冻结版本，发布读取该快照，不临时重新读取文件。`articles`为公开显示数据，草稿不写入它。`editorial_documents`按稳定`content_key`绑定本站文章；`editorial_versions`保留已发布版本和首次接管旧文的基线版本0；`editorial_publications`保存独立发布回执及后续处理状态。图片元信息在`editorial_assets`。
新API不调用旧接收器，不发送旧Telegram通知、IndexNow提交或ATOM请求。旧资源接收接口继续沿用原流程，不在本次改造范围；普通编辑API拒绝免费节点与小火箭ID两个自动资源栏目。旧接口/人工直接编辑同一文章会造成草稿基线变化，新API发布时返回409，不能静默覆盖并行修改。
## 凭据与环境
配置：`config/editorial.php`。
- 本地默认启用，但必须先有有效凭据。生产默认关闭，需部署时明确设置`EDITORIAL_API_ENABLED`、`EDITORIAL_BASE_URL`和独立搜索索引；本次没有生产凭据或上线操作。
- 本地安装命令`php artisan editorial:setup`仅允许本机`fna_v3`，已存在凭据不覆盖。凭据在`storage/app/private/editorial/credential.json`（目录700、文件600，Git忽略），结构使用`gemdocs.credential.v1`及`fields.api_key`，绑定项目、环境和base_url。程序在内存中读取，禁止打印、复制进正文、提交Git或放到命令参数。
- 认证为`Authorization: Bearer <专用密钥>`。应用提供下述CLI代为读取和发送，不需要AI将密钥带入工具输出。
- 所有编辑接口拒绝整页缓存；预览和私有图片使用30分钟签名地址，返回`noindex, nofollow`、`private, no-store`。持有签名链接的人在有效期内可预览，链接不应公开转载；失效后通过查询草稿重新取得链接。
- 发布接口按分钟限流；API错误不输出SQL、凭据或请求头。生产认证、HTTPS与访问路线仍按项目部署约束核实，不能因代码已存在就认为生产已可调用。
## 调用方式
以下命令调用当前环境绑定的API，`path`相对于`/api/editorial/v1/`，输出JSON结构为`http_status`与`data`。
```sh
php artisan editorial:request GET catalog
php artisan editorial:request GET source-articles/362
php artisan editorial:request POST assets --image=/绝对路径/操作图.png
php artisan editorial:request POST drafts --payload=/绝对路径/draft.json
php artisan editorial:request GET drafts/草稿UUID
php artisan editorial:request POST drafts/草稿UUID/publish --payload=/绝对路径/publish.json
php artisan editorial:request GET publications/发布请求UUID
```
示例中的中文路径和UUID均需替换。请求正文放文件，不把多行正文或密钥拼接进shell。CLI关闭HTTP代理和重定向，本地模式拒绝非本地目标；外部环境的调用仍需既有访问授权。
### 1 保存草稿
`POST /drafts`：
```json
{
"request_id": "29e2f78a-7adc-4bf6-9eef-1c5f4a586b13",
"articles": [
{
"content_key": "verge-windows-start",
"expected_revision": 0,
"adopt_article_id": 362,
"slug": "clash-verge-rev-windows",
"title": "Clash Verge Rev 使用教程：从安装到第一次连接（Windows）",
"summary": "下载安装、导入订阅、选择节点和开启系统代理。",
"category_slug": "windows",
"format": "markdown",
"body": "<h2 id=\"install\">下载与安装</h2>\n\n此处为实际正文。",
"cover": null,
"show_cover": false
}
]
}
```
这是结构示例，不可拿占位正文覆盖现有教程。完整正文应来自项目源文件或已核对的接收端原文。
- `request_id`为本次保存动作的新UUID；同UUID同正文重试返回同草稿，不递增版本；同UUID改正文返回409。每批最多10篇，单篇正文最多500000字符。
- `content_key`为写作索引中的稳定键。首次为0，后续`expected_revision`必须等于`GET /articles/{key}`返回的`latest_revision`，成功后递增。新草稿会使同文章的旧草稿失去发布资格，但不会改变线上已有正文。
- 新文章省略`adopt_article_id`。接管现有文章必须显式指定准确ID并沿用原slug；不因标题相似自动绑定。首次接管仅建立映射和旧版快照，不改公开正文。不能把已有键转绑另一篇文章，也不能改已绑定文章URL。
- `category_slug`必须为本站已启用的编辑栏目。`tag_ids`可选，必须是已有标签ID；省略时保留旧文标签，新文默认为空，不自动创建标签。
- `format`为`markdown`（默认）或`html`。Markdown支持基础HTML图解，但过滤危险链接、脚本等；富文本不接受任意脚本、事件属性或内联样式。段落锚点使用显式`id`。
- `cover`支持已存在的本站`/images/...`路径，或上传后的`asset:SHA256`；显式null可清除旧封面，省略时保留。`show_cover`控制正文头图，省略时保留旧值，新文默认不展示头图。
- 站内文章链接为`/a/slug.html#anchor`。本站完整域名链接不作为站内链接接受；引用公共官方资料可用外部HTTPS链接。文章目标必须已发布或在同批草稿内，锚点必须存在。分类链接校验真实父子关系，避免宽松路由把错误URL也返回200。
返回`draft_id`、`hash`、`status`及每篇文章的版本、预期路径和`preview_url`。查询草稿会生成新的短期预览链接；草稿内容不变。预览复用本站文章模板，关闭统计、点赞和热门列表；同批次文章之间的链接改为签名预览，避免跳到不存在的正式页。
### 新文章点赞设置
2026-10-29起，创建新文时支持可选`like_settings`，例如：
```json
"like_settings": {"seven_day": 12, "yearly": 50, "one_year": 200}
```
省略时采用[AI写作规范的默认参数](../content/WRITING.md#ai-新文章的点赞参数2026-10-29)，在草稿保存时随机取值并冻结；草稿响应`articles[].like_settings`返回确认值。旧文改稿、接管及内容回退保留原点赞参数/进度，普通改稿显式传入此对象返回422；0可在新建时关闭对应项。旧冻结草稿不追加新默认值。
发布后鉴权`GET source-articles/{id}`的`like_growth`可核对剩余额度、持续年度参数及一次性年度目标、已支付量和开始时间。年度额度按发布时间计时，累计增加该额度后停止，与真实点赞和持续年度随机增长独立。迁移、调度、字段范围与回退见[文章自动点赞维护](ARTICLE_LIKES.md)；先执行指定新增迁移，再使用新代码。
### 2 图片
`POST /assets`使用multipart的`image`字段。支持PNG/JPEG/WebP/GIF，最多8MB，并限制宽高和像素数；不接收SVG/HTML上传，不主动抓取远端图片URL。返回SHA256、尺寸和`asset:SHA256`引用：
```markdown
![导入订阅操作图](asset:实际返回的64位SHA256)
```
原图先在私有存储，不生成公开地址。签名预览通过临时图片路由读取；正式发布时校验哈希并生成本站`/images/editorial/SHA256.ext`地址，正文替换为此路径。上传文件无同名覆盖问题；失败批次可能留下已准备但未引用的内容寻址图片，不自动删除可能仍被其他版本使用的素材。
### 3 发布确认过的版本
`POST /drafts/{draft_id}/publish`：
```json
{
"request_id": "0cf94c73-bafb-4a6c-9cef-39d72e5bc24e",
"expected_hash": "替换成保存草稿返回的64位hash"
}
```
发布UUID与草稿UUID分开。确认所看版本后使用它的hash；不要重建另一份正文来发布。发布前再次检查最新版本、现有文章基线、栏目/标签、图片、目标链接及受影响旧文的入向锚点。批次中任一篇冲突或失效，整批文章与版本/回执事务回滚。
成功后按稳定映射创建/更新文章，保留已有URL、创建时间、计数、置顶和身份。批次里的所有正文修改同时提交；冻结发布回执与内容写入在同一数据库事务中。重复提交同一发布UUID返回原回执；同UUID换目标/版本返回409。同一草稿换一个发布UUID重试也只返回已有回执，不重复创建文章。
响应包含：
- `status: published`：本次内容已写入本站公开文章表；这是所调用环境的状态，本地成功不代表生产成功。
- `articles`：各文章的`content_key`、`article_id`、`revision`和URL。
- `effects.cache/search/sitemap`：各后续处理的独立结果。搜索暂时失败不撤销已提交正文，返回`pending`，不能重发正文来弥补搜索失败。
后续处理为刷新本站响应缓存与热门数据缓存、同步本站搜索，以及使用数据库驱动的sitemap。缓存未刷新时sitemap也标记pending。不调用搜索引擎主动提交。
### 4 查询、重试与回退
| 方法与路径 | 作用 |
| --- | --- |
| `GET /catalog` | 当前可用编辑栏目与文章元信息，含已接管键和版本 |
| `GET /source-articles/{id}` | 接管旧文前读取实际HTML、封面、标签、栏目与管理状态 |
| `GET /articles/{key}` | 最新草稿版本、已发布版本、稳定ID/路径、已发布历史列表 |
| `GET /articles/{key}/versions/{revision}` | 读取某个已发布版本的冻结内容；旧文接管基线为0 |
| `GET /drafts/{id}` | 查询保存结果，刷新预览地址 |
| `GET /publications/{id}` | 查询发布UUID的原回执和当前后续处理状态 |
| `POST /publications/{id}/synchronize` | 只重试未完成的缓存/搜索处理，不重写文章；搜索读取当前公开版本，避免旧重试覆盖新索引 |
| `POST /articles/{key}/rollback` | 从指定历史版本建立新草稿，供预览后另行发布 |
回退请求同样包含新`request_id`，并给出当前`expected_revision`和历史`target_revision`。它不会马上覆盖当前文章；返回新草稿后，沿同一预览/发布步骤恢复，版本继续递增、URL不变。若旧版锚点不能满足现有入向链接，需要将关联文的修正一起组批，不能强制制造断链。
HTTP401认证失败，403签名无效/过期，404对象不存在，409幂等/版本/所有权冲突，422格式或链接不满足条件，503功能关闭或凭据绑定无效。网络结果未知时，先按原UUID查询，不盲目生成新UUID重发。
## 搜索隔离
`Articles::searchableAs()`优先使用`editorial.search_index`。本地为独立`fna_v3_articles`，已把169篇现有公开文章初始化到新索引，未改原继承的`articles`索引。正常站内搜索和新API写入使用同一索引。`editorial:reindex`用于初始化/补全；后续每次发布只更新本批当前文章。
本地仅允许回环Meilisearch和`fna_v3_`前缀。生产必须明确专属索引及服务地址，不能沿用未知共享索引。集合/数据库搜索直接读取当前文章；未支持或未配置的驱动返回pending。Meilisearch任务等待成功后才报告done。
## 安装、验收与恢复
追加迁移：`database/migrations/2026_10_27_190000_create_editorial_tables.php`。执行时只指定此迁移，不使用`migrate:fresh`或批量重置现有数据库。后续代码部署遵守Git发布流程；本次本地安装不授权生产部署。
```sh
php artisan migrate --path=database/migrations/2026_10_27_190000_create_editorial_tables.php --force
php artisan editorial:setup
php artisan editorial:reindex
```
本地已完成：
- SQLite内存隔离功能测试：认证/环境绑定、缓存隔离、草稿私有、签名到期、幂等、版本冲突、原子发布、显式接管、并行修改保护、入向锚点、图片和代码换行、回退与搜索重试；结果见`output/editorial-api/tests.xml`。
- 真实本地HTTP：无认证401、图片上传与草稿预览、两文章互链整批发布、同UUID重试、新版、回退、正式HTTP200、真实站内搜索和sitemap；见`output/editorial-api/http-verification.json`。
- 1360/390预览截图：签名图片、同批跳转、无点赞、noindex、无横向溢出；浏览器只允许本地来源，未发线上请求。见`output/editorial-api/browser-verification.json`和同目录PNG。
- 临时文章2篇及本次测试版本/回执/图片已清理，原169篇文章完整行哈希一致。安装验收结束时接收表为空，后续正常稿件会保留版本和回执；凭据留在私有存储。
恢复时先关闭`EDITORIAL_API_ENABLED`，保留5张接收表、版本和回执及图片。已发布正文仍在`articles`可正常显示；撤销某次文章更新优先走历史版本回退。代码回退不得顺带drop表或清理可能被正式文章引用的图片。若撤回本地搜索切换，应在核对原索引后调整`EDITORIAL_SEARCH_INDEX`与模型配置，不删除未知共享索引。

65
docs/maintenance/ILLUSTRATIONS.md Normal file
View File

@ -0,0 +1,65 @@
# 本地插画资源与配图
2026-10-27修正此前错误的本地配图实现。当前状态（2026-10-29）：本地、独立test与正式cfn均已接入；正式资源为https://resource-v2.gemcook.net，22猫/15狗，84/90篇固定分配与test逐项一致。正式消费者仅fna-v3项目read/write，test仍独立只读。部署、备份、权限与323项服务器验收统一见[正式切换](RELEASE_PREFLIGHT_2026-10-28.md#正式切换2026-10-29)。下文“仅本地/正式未切换”为此前历史状态。
素材及图池事实由 [Resource V2 插画集合说明](/Users/hellcat/Documents/GemCodes/resource.loc/v2/docs/CFN_ILLUSTRATIONS.md) 维护，本页维护FNA_V3消费方式。仅本地，未提交、推送或部署。此前“只用12张猫图替换显示”没有完成原图池扩充；旧哈希算法也没有避免连续重复，相关旧验收不足以证明需求已完成。
## 当前规则
免费节点当前22张猫图（含乔治此前2张猫图，已排除毛线球旧试画）；免费苹果ID（原免费小火箭ID，分类9、shadowrocketids）当前15张狗图。2026-10-28本批追加12张狗图，猫图去重保留。图池与每篇文章的固定分配都保存在本地Resource V2的项目引用中。首次按文章创建时间从旧到新通过HTTP批量分配；每次依次轮换一张图，一轮用完后再循环。重复发送同一文章键复用原图，不推进游标；之后扩充图池也不重新洗牌已有文章。
`config/illustrations.php`只维护分类1→freenode、分类9→shadowrocketids，以及V2基址和私有凭据文件路径，不保存图片URL清单。`app/Services/IllustrationPool.php`通过鉴权HTTP接口读取图池与分配；`app/Models/Articles.php`的sThumb读取器统一用于列表、侧栏、详情和OG。快照在file cache缓存60秒，最近成功快照另保留供短暂故障使用。没有成功快照时回退原字段；故障期间不创建新配图，不自动调用旧线上接口。
`ArticlesController`的免费节点、免费苹果ID接收方法，以及通用receive针对这两个分类，均在启用本地V2时走同一分配接口。调用失败中止配图阶段，不伪造成功。其他分类不变；非local或关闭开关时保留既有逻辑，未迁移生产调用方。
## 接口与凭据
环境绑定已扩展：local只接受`http://resource.loc:8612`，staging只接受`https://test.clashfreenode.com/resource-v2`，production只接受`https://resource-v2.gemcook.net`；均需显式启用且凭据project/base_url匹配。正式cfn已切换，其他同代码实例尚未自动迁移。开关RESOURCE_V2_ILLUSTRATIONS_ENABLED兼容旧LOCAL_ILLUSTRATIONS_ENABLED。FNA_V3专用客户端项目为fna-v3，作用域read/write；私有JSON由RESOURCE_V2_CREDENTIAL_FILE指定，位于resource/v2/.local/clients，不进入浏览器或Git。新图片导入用一次性所有者凭据，完成后已撤销。真实接口：
- GET `/api/v2/pools/{pool}`：取回有序成员和已分配文章。
- POST `/api/v2/pools/{pool}/selections`：JSON keys数组，首次分配/重复交付均幂等。
- 图片浏览器仍读取V2返回的 `/media/{publication}`，不带Bearer。
API契约、上限、项目隔离和图池维护见[Resource V2 API](/Users/hellcat/Documents/GemCodes/resource.loc/v2/docs/API.md)。新增素材先在V2上传、发布、授权消费者，再用pool引用扩充成员，不在FNA_V3写死图片地址。原160篇文章数据库sThumb未改写；本地原稿与生产旧文件均保留。未来上线另核对生产素材和服务配置，不能直接发布本地URL。
## 本地运行
固定入口 `http://fna-v3.loc/`；栏目为 `/freenode` 与 `/shadowrocketids`。本机 hosts 指向127.0.0.1，前端 Nginx 配置 `/usr/local/etc/nginx/servers/fna-v3.loc.conf` 仅监听回环80端口；转发至 GemCodesAccess 后端18882，PHP FPM9000，根目录为本项目 public。后端虚拟主机位于 GemCodesAccess 的 `service.conf`，由 `BEGIN/END FNA_V3 local virtual host` 标记界定。
Resource V2 开发服务监听127.0.0.1:8612。FNA_V3 使用 Vite dev，当前内部端口5187，启动命令 `npm run dev -- --port 5187 --host 127.0.0.1 --strictPort`；未执行发布构建。应用URL为固定域名，内部端口不替代日常入口。服务重启后按各项目运维说明恢复开发进程。
## 2026-10-27 旧版细节补齐
V2现会跳过缺失/损坏/符号链接/未发布等不可用候选；同一文章原图因物理故障不可用时，GET以unavailable标记，FNA_V3调用分配接口修复并保持其他文章分配不动。全池坏时该图留空，不用数据库旧URL伪装恢复。明确撤回发布/权限或资产停用则停止展示，不自动替换或重新公开。图池读取支持next游标，消费者读完所有页，60秒缓存/最近成功快照保留。
调用方本轮故障测试使用独立内存cache与fake HTTP，不污染真实缓存或文章；服务端真实HTTP测试使用一次性隔离实例，未触碰本地猫狗素材。完整接口和旧版对应关系以[Resource V2核对正文](/Users/hellcat/Documents/GemCodes/resource.loc/v2/docs/LEGACY_PARITY.md)为准。本地21猫/3狗、160篇文章配图保留，未上线。
## 验收与回退
2026-10-28用户明确不要早期试画 `freenode-cat-yarn-20261023`（粉底薄荷绿小猫玩毛线球）。通过本地V2 API移除消费者fna-v3的`pool:freenode:009`，并为fn20260808、fn20260903、fn20260925、fn20261016四篇替换固定配图，避开各自相邻文章；其他固定分配逐项对照未变。图池现场原有23项（含后续新增图），移除后22项。已刷新配图快照和页面缓存；源文件、私有归档与其他使用方未删除，生产未改。该图片不再纳入本地FNA_V3图池；不要根据历史导入清单重新加回。可恢复回执：`/private/tmp/fna-remove-yarn-receipt.json`。
2026-10-27：真实鉴权HTTP导入9张旧猫图、授权及创建图池、为78篇免费节点和82篇免费小火箭ID建立固定分配。160篇按当前栏目排序逐条检查：21张猫图/3张狗图均被使用，相邻配图重复为0。数据库原配图字段、其他7篇文章均未改变；重复投递、关闭开关、production保护、服务503保留最近配图与拒绝新分配均通过。
Resource V2隔离测试19项/154断言通过，包含轮换、项目隔离、只读凭据拒绝写、非法键、已撤回图片和失败保护。两栏目、两篇详情在1280/390宽度下图片加载、无相邻重复、无横向溢出；测试只放行本地来源。没有执行包含通知/索引外发的完整文章接收请求，接收方法的配图路径用相同服务方法真实HTTP重试验证。
证据位于 `/Users/hellcat/Documents/Codex/2026-10-23/cfn/outputs/fna-v3-pool-fix-verification.json`、`fna-v3-fixed-page-verification.json` 和 `fna-v3-fixed-*.png`。旧版截图和报告只作历史，不作为修正后验收。
回退展示：本地.env设置LOCAL_ILLUSTRATIONS_ENABLED=false，执行本项目 `php artisan config:clear` 与 `php artisan responsecache:clear`。原字段重新显示，不恢复整库、不删除resource引用/图池/素材。仅回退页面不撤销已被其他方使用的发布。代码备份和9张旧图SSH来源清单在工作目录work/illustration-fix；域名回退只移除独立server块及hosts条目，不覆盖其他聊天配置。
## 2026-10-28 两张插画追加
用户指定「蓝椅上的橘白猫」「窗台与蓝花」加入免费节点。原PNG及完整提示词已并入Resource V2原集合清单，WebP88展示图经真实本地HTTP上传、发布、授权并追加两个pool引用。FNA_V3实际IllustrationPool回读23张且包含两张新图，原78篇免费节点文章及其他消费者引用、游标均逐项保持不变；扩池供后续新文章轮换使用，不重分配旧文章。栏目本地HTTP200；未做本轮浏览器页面验收，未提交、推送或部署。
证据：`/Users/hellcat/Documents/Codex/2026-10-28/new-chat/outputs/fna-v3-two-cats-integration-20261028.json`；素材、备份与撤销凭据见Resource V2集合说明。本次没有修改FNA_V3代码或文章数据库字段。
## 栏目显示名称（2026-10-28）
用户要求将“免费小火箭ID”改为“免费苹果ID”。本地fna_v3.categories仅更新ID9的sName；sSlug仍为shadowrocketids，URL、文章归属、正文和狗图池不变。直接限定字段更新，未触发分类模型关联文章touch；清除global_nav_tree和页面响应缓存后，浏览器回读四个导航/栏目链接均为新名，列表卡片分类同步显示新名。原值备份 `codex/output/category-apple-id-rename-before-20261028.json`，截图 `codex/output/category-apple-id-rename-preview-20261028.png`。未发布生产；后续上线须将该栏目名作为定点数据变更处理，不以整库覆盖迁移。历史验收段中的旧名保留其原时点含义。
## 2026-10-28 本聊天剩余素材入池
用户指定猫→免费节点、狗→免费小火箭ID，并明确第一张截图排除整组三猫三狗，另三张截图分别排除早期光滑蓝椅猫、黄月黑猫、浅蓝背景坐猫；共9张排除，不导入且不删除原文件。剩余两张猫此前已入池，去重保留；新导入12张狗图（两组各5张，加闻雏菊史宾格、编号001叼拖鞋梗犬）。
Resource V2原图、完整提示词私有归档及WebP88公开展示/授权/池引用追加均通过真实本地HTTP完成。FNA_V3实际服务回读猫22/狗15，78+82篇原固定配图及游标逐项未变，新素材供后续文章轮换。先前明确移除的毛线球猫未恢复。两栏目本地HTTP200，未做本轮浏览器页面验收，未提交、推送或部署。
证据：`/Users/hellcat/Documents/Codex/2026-10-28/new-chat/outputs/fna-v3-remaining-art-integration-20261028.json`；每项排除hash、素材清单、备份与临时客户端撤销见资源集合正文及回执。本次未修改文章数据库字段或网站代码。

1561
docs/maintenance/PREVIEW_VERIFICATION_2026-10-29.json Normal file
View File

File diff suppressed because it is too large Load Diff

1721
docs/maintenance/PRODUCTION_VERIFICATION_2026-10-29.json Normal file
View File

File diff suppressed because it is too large Load Diff

124
docs/maintenance/RELEASE_PREFLIGHT_2026-10-28.md Normal file
View File

@ -0,0 +1,124 @@
# FNA_V3 发布前核对 · 2026-10-28
状态：2026-10-29用户确认test“没问题，切到正式”，现已完成正式切换及323项服务器侧验收，0失败。正式入口https://clashfreenode.com/；test仍独立保留并禁止索引。新增广告未发布。以下test与准备段落保留其历史时点含义。
## 正式切换（2026-10-29）
用户已在test页面确认后明确授权切正式。本次复用原生产目录、数据库、域名及Nginx块，不将test数据库、会话或密钥替代生产；其他同代码正式实例不在范围。
- cfn：/www/wwwroot/clashfreenode-new.com，检出已推送且经过test确认的76141453bbdbd14b13c69647c14226bae7250afc，功能代码固定为此提交，后续仅AGENTS/docs维护提交可推进部署HEAD，不改变已验收应用代码。现有生产仓库为tom/fn_b.git，发布分支codex/fna-v3-release-20261029；本地复制历史不直接推送。Resource V2：/www/wwwroot/resource-v2/app，检出0d9e71a0cdbf9b6e298dc28b28ccc38879a5808e。两者沿先前codex/fna-v3-release-20261029推送提交发布，不通过源码包覆盖。原generated-tags-cloud未提交模板逐字保留；既有cron没有Git自动更新命令，未改计划。
- 已在原库上追加指定5张editorial表，限定更新client/advanced/shadowrocketids元数据。10篇教程从用户确认的test实际公开正文冻结，经生产临时凭据完成草稿→逐篇签名预览→同hash发布→回执核对；原7篇ID/slug/创建时间保留，新增3篇。当前184篇文章、9分类；原181篇全部保留，174篇非本次编辑文章的标题/摘要/正文/原始封面字段/分类/状态/日期全部逐项不变，原账号行一致。
- 原生产APP_ENV=local、DEBUG开启，现限定修正production/DEBUG=false；原DB、APP_KEY、会话、通知和其他配置保留。资源绑定https://resource-v2.gemcook.net，搜索改用专属cfn_articles_v3并完整初始化，原articles索引不删除。正式站原统计恢复，首页index/follow、正式canonical/robots/sitemap均通过；没有将test的全站noindex、API封闭或独立会话配置复制到正式。
- Resource仅追加已验证的图池代码/表，37张审核展示图按API上传/发布/授权；从test已确认状态恢复213条池/固定选择/游标引用，22猫/15狗，84篇免费节点/90篇免费苹果ID。所有已确认固定配图按SHA逐项保留；毛线球猫继续排除。原Resource的5个资产及20个历史客户端记录全部不变。
- Resource临时图片所有者21（read/write/publish/share）已在同操作finally撤销并删除密钥文件；仅正式fna-v3消费者22保持read/write，用于日更接收时创建持久配图，不含publish/share/delete。密钥只在服务器私有客户端文件及主站storage/app/private/illustrations.json，0600，不复制测试凭据。真实旧文章重复分配返回原图且不推进cursor，消费者发布权限403。
- 生产编辑临时密钥迁移后已删除，EDITORIAL_API_ENABLED=false，未留下可调用的无授权编辑接口；后续明确写作/发布任务按EDITORIAL_API.md流程临时启用并关闭。本次没有执行真实日更接收、Telegram通知或IndexNow；只核对原3条POST接收路由保留，并对相同图池服务的既有文章键做幂等验收。
- 新增DPL/HN/FUC广告组件/配置/CSS/图片仍排除，保留生产原有广告。主站及Resource原Nginx配置逐字未变，未改正式DNS或证书；test继续独立noindex。软件资源服务与其他正式实例未动。
### 备份、验收与恢复
切换前私有恢复点为VPS-003:/root/backups/cfn-fna-v3-20261029/production/（700/600）：两个Git基线bundle、原.env、两个Nginx文件、原生成模板、生产代码/构建归档、18表/181篇一致性数据库快照、state-before.json；无生产秘密导出本机。Resource原生一致性备份为/www/wwwroot/resource-v2/app/storage/app/private/backups/20261029-113946-ee837e82-40f5-4085-8641-2c06c72c3e3c，含SQLite及资产哈希清单。
生产resource-receipt.json、cutover-receipt.json、editorial-operation.json记录各步骤/草稿与发布UUID；未知结果先查原UUID，不盲目重复发布。2026-10-29 11:50:13 UTC服务器侧323项检查全部通过，含59个页面引用资源和37张公开图片hash；非秘密结果见[正式验收JSON](PRODUCTION_VERIFICATION_2026-10-29.json)。test此前292项验收另留原件。用户已确认test页面，AI未做正式线上页面验收，不能把服务器侧验收写成正式页面验收。
回退必须先识别回退范围和上线后新增数据，不自动执行：保留现有184篇及后续文章；代码可固定回0792297bb8164fd2929b939d8d1206bc77b4ee81，但先保留已发布教程CSS/图片、恢复原构建清单所需文件，避免回退Git时删除仍被文章引用的资源。Resource服务与已发布media地址继续保留；不要drop新增表、撤回被文章引用图片或整库覆盖上线后的新数据。若仅关闭图池，设置RESOURCE_V2_ILLUSTRATIONS_ENABLED=false并清配置/响应缓存，恢复原字段展示。正文恢复走本站版本回退API，原7篇基线版本0已保存；新增文章不做无授权删除。APP_ENV=production/DEBUG=false维持，不能为代码回退重新开放调试。
## 当前门槛：先test预览，确认后再切正式（2026-10-29）
本节为此前test部署记录；用户现已确认，正式切换结果以上节为准。
用户最新要求先部署test子域名，确认无误后才切正式；此前正式发布授权按这个新顺序执行，当前不得切换正式站。本次新增广告继续排除。
已完成：
- Cloudflare ACC-001界面确认clashfreenode.com区域归属，zone ID为e3145aaaca4ca16b96855abc80e3e92f；仅新增test A→45.153.247.44，DNS-only、自动TTL。原主域名/www和邮件记录未修改。配置截图为/private/tmp/fna-release-20261029/test-dns.png。
- 在VPS-003生产历史的隔离分支codex/fna-v3-release-20261029构造提交并真实推送：cfn为76141453bbdbd14b13c69647c14226bae7250afc，Resource V2为0d9e71a0cdbf9b6e298dc28b28ccc38879a5808e。仓库沿目标服务器原origin，仅推送新分支，未修改正式分支或正式checkout。
- 新目录/www/wwwroot/fna-v3-test与/www/wwwroot/fna-v3-test-resource分别检出上述SHA；现已启用各自运行.env、独立数据库/存储及test HTTPS虚拟主机。代码暂存传输用于构造Git提交，实际预览目录由Git检出，未以源码归档覆盖正式站。
- cfn提交排除新增广告组件/配置/CSS/图片，保留生产既有侧栏广告位置；带首页、教程、独立编辑API、插画消费者及构建产物。Resource提交只增加图池控制器、图片健康检查、关联表迁移及两条图池路由，不包含软件下载业务。
- staging图片来源只接受https://test.clashfreenode.com/resource-v2，production仍只接受原Resource V2生产地址；staging模板noindex/nofollow并关闭正式站统计脚本。21项测试157断言通过。
- 本地私有暂存已选出10篇教程、栏目元数据，以及当前37张公开展示图片和199个pool/selection/cursor引用；未传送线上数据到本机，未恢复已排除毛线球猫。
用户在逐项范围说明后明确回复“继续啊”，已按批准范围完成：
1. 创建独立fna_v3_test库，只复制181篇公开文章、8个启用分类、25个标签及1409个关联，不复制用户、密码、会话、队列或点赞IP/指纹。为既有ORM查询建立空users和article_likes结构，users实际0行，无管理账号或会话。指定editorial五表在test安装。
2. 独立数据库账号仅SELECT/INSERT/UPDATE/DELETE，限定fna_v3_test；没有其他库或DDL权限，现场查询验证通过。应用以staging运行，主PHP-FPM实际账号为nginx（现场核实），test.env为root:nginx 0640，私有消费者凭据0600；独立资源服务使用resourcev2账号。
3. 测试Resource使用独立SQLite、存储、37张审核通过的展示图；不导入原PNG、提示词或其他资源。通过API恢复37条pool、160条selection及2条原cursor引用，再为生产快照多出的14篇资源文章配图；现84篇免费节点、90篇免费苹果ID。原197条pool/selection逐项按图片SHA验证不变，cursor只随新增文章正常推进。猫22/狗15，毛线球猫未恢复。临时所有者客户端1和写消费者2在同一次操作finally中撤销并移除凭据文件，只保留本测试SQLite的fna-v3只读客户端3；真实写分配请求403。
4. 栏目定点迁移client/advanced/shadowrocketids，10篇教程经临时编辑密钥完成草稿→逐篇签名预览→同hash发布→回执核对，保留7个旧slug、追加3篇。完成后test共184篇、9分类。搜索独立fna_v3_test_articles已重建，真实/search/Clash返回教程。临时编辑密钥已移除，EDITORIAL_API_ENABLED=false；所有/api/应用旧接口在test Nginx统一404，resource-v2独立API仅受限鉴权使用。未启动队列、定时任务、通知或IndexNow。
5. 独立/etc/nginx/conf.d/test.clashfreenode.com.conf启用HTTP→HTTPS，证书由Let’s Encrypt签发，至2027-01-27，沿现有Certbot续期；保留ACME webroot。整站X-Robots-Tag:noindex,nofollow，HTML同样noindex，robots禁止抓取；关闭正式Umami统计，独立缓存/会话，保留已有公开GitHub链接。Nginx配置校验通过后reload，未修改正式站server块、代码、数据库或证书。
验收：2026-10-29 11:15:36 UTC，292项通过、0失败；包含首页最新fn20261029及不高亮菜单、4栏目、10教程、真实搜索、55个引用资源、37张图片完整哈希、历史固定配图、API隔离、权限撤销及正式两个Git HEAD未变。公开预览为https://test.clashfreenode.com/。已完成服务器侧验收，未做线上页面验收，等待用户自行确认后才可切正式。非秘密结果见[验收JSON](PREVIEW_VERIFICATION_2026-10-29.json)，服务器私有导入回执和验收原件在/root/backups/cfn-fna-v3-20261029/，不包含在公开站点根目录。
此前自动审批拒绝完整Nginx输出、整库复制及不在同命令撤销的临时凭据方案；已分别改为字段白名单、公开内容最小快照及同操作try/finally创建/使用/撤销，用户明确继续后执行。Git认证仅在内存中经私有Unix socket一次性传递，未保存Git密码文件。这些阻塞在test部署时解除；随后用户确认并授权切正式，执行结果见上方正式切换。
回退范围：仅撤销本次test DNS记录、test虚拟主机及其独立运行资源；保留私有回执和Git提交供恢复，不能恢复整库覆盖正式站。正式切换必须等用户确认本次预览后再执行。
## 本次更新
| 范围 | 当前本地结果 | 发布时需要携带 |
| --- | --- | --- |
| 首页 | 展示日期最新的已发布免费节点文章全文，不限当天，排除未来文章；首页不高亮免费节点菜单；免费节点页保留历史列表 | 控制器、服务、路由、菜单及首页缓存策略 |
| 教程栏目 | 客户端改为入门教程，新增综合教程；栏目横幅沿用原样式，修正全栏目计数 | 分类数据、模板及CSS |
| 教程正文 | 共10篇长期文章：原7篇重写/重分类，新增Windows纯入门、DNS防泄漏、系统代理与TUN；加入图解、封面及真实内链，清除内部验收口吻 | 正文源、公开文章数据、分类、资源和编辑版本，不是仅上传Markdown |
| 广告 | DPL与Hardnerd广告；HN当前为首字母大写、纯黑背景静态横幅，扫光已撤回 | 广告组件、CSS、实际引用图及生产链接配置 |
| 插画 | 本地Resource V2图池与文章固定配图，免费节点用猫、小火箭ID用狗；已去除用户拒绝的粉底毛线球猫，4篇定点换图 | 生产素材、授权、图池、固定分配及可用于production的消费者 |
| 独立文章API | 本站草稿、签名预览、按hash发布、显式旧文接管、版本/回执、回退、图片与内链校验；不经过ATOM | 新增迁移、独立生产密钥、基址与搜索配置、生产内容迁移流程 |
| 搜索 | 本地独立fna_v3_articles，编辑API具有缓存/搜索/sitemap后续处理回执 | 明确生产索引和初始化，不能直接复制本地索引名或未知共享索引 |
| SEO | 完成建议清单，首页和部分教程改造已实施 | 不能将36项SEO清单整体标为完成 |
当前本地数据库170篇文章，其中160篇自动资源文章、10篇长期教程，分类9个。十篇教程实际路径：m169、m170、m171、m172、m173、m174、m167、mihomo-dns-leak、clash-verge-rev-windows、system-proxy-vs-tun（均在/a/下，以.html结尾）。稳定关系以[写作索引](../content/WRITING.md)为准。
## 本次重新验证
- `vendor/bin/phpunit --process-isolation tests/Feature/LatestFreeNodeHomeTest.php tests/Feature/EditorialApiTest.php`：19项测试、149条断言通过。
- `npm run build`：成功，137个模块；manifest及CSS/JS构建产物已生成。构建后恢复原public/hot，保留本地5187开发预览。
- 关键新增PHP语法及本次代码diff空白检查通过。这些结果不等于全部业务、生产API或生产图片已验收。
- 首页noindex已于2026-10-28修复：按首页路由独立返回`index, follow`，无额外X-Robots-Tag；旧文章详情仍按原规则noindex，栏目仍index，三条本地HTTP实测通过。签名预览仍优先noindex,nofollow。
- 候选文件清单及SHA256：`output/release-preflight-20261028/candidate-manifest.json`，当前76个候选文件。它不是最终提交白名单，其中含需进一步筛选的历史广告/素材；不含私密环境文件。
## 线上只读现场
2026-10-28通过本机SSH→白色机→VPS-003，只读核对登记目录及数据库；无线上HTTP请求，无服务器配置或业务写入。
- cfn目录：`/www/wwwroot/clashfreenode-new.com`，展示域名clashfreenode.com。
- 当前Git HEAD：`0792297bb8164fd2929b939d8d1206bc77b4ee81`。线上不存在本地基线4778ca17，不能按两者共用历史直接pull/覆盖。
- 线上有未提交的`resources/views/components/generated-tags-cloud.blade.php`，发布前保留并识别生成方式。
- 线上PHP CLI 8.5.2，public/build/manifest.json存在；FPM与队列/调度配置本次未重新核实。
- 线上178篇文章，最新为ssi20261028；分类仍为8个、client名称为客户端，尚无advanced；editorial_documents表不存在。
- 本地仅170篇且自动资源快照更旧，绝对不能用本地整库覆盖线上178篇。必须保留生产新增节点、小火箭ID、点赞等数据，只定点迁移教程/分类/编辑表。
## 发布前必须解决
1. **发布仓库及生产差异。** 本地HEAD4778ca17，唯一remote为复制来的FN_B仓库；线上历史独立。需先取得生产文件差异并明确本项目发布仓库/分支，再生成只包含本次范围的提交。未经确认不向旧FN_B remote推送。
2. **提交卫生。** 当前仓库已跟踪8588个vendor文件、10046个node_modules文件及`_env/.env`。不将本地私密配置、缓存、旧环境文件、输出截图、临时回执或整个依赖目录混入本次发布；不能靠新增.gitignore自动清除历史跟踪。若建立新仓库，使用清洁发布树而非复制原Git历史。
3. **图片生产接入。** IllustrationPool明确只允许local且基址为resource.loc:8612。直接部署会继续使用旧图，不能兑现本地视觉。生产Resource V2已有独立服务登记，但图池接口/素材、消费者授权和生产兼容未在本次部署；须单独准备并验收。不能把.loc地址写入生产。
4. **教程及分类定点迁移。** 需按旧slug比对并显式接管7篇，新增3篇，创建/映射综合教程分类；迁移关联、封面和图片。生产ID由现场分配，不使用本地ID硬覆盖。先保存生产基线并生成可审核差异，普通编辑正文通过本站API的草稿→预览→hash发布完成。
5. **文章API生产配置。** 仅追加指定editorial表迁移；默认生产关闭。setup命令仅支持本地，须另行准备生产专用凭据，绑定真实环境和base_url，并确定生产搜索服务/独立索引。不复制本地密钥，不执行migrate:fresh。
6. **首页索引策略。** 首页继承老文章7天noindex的问题已本地修复并验收；该阻塞解除。首页与日更详情的canonical关系仍属于SEO-004/018剩余规则，本次未改。
7. **HN广告地址。** 生产未配置HN_AD_URL时HN不展示；本地默认hn.loc不能作为线上目标。上线配置必须给出已登记真实地址，不能猜域名。
8. **正式备份与回滚。** 上线动作前备份目标代码提交/未提交文件、生产数据库和站点配置；保存只读核对结果。代码与资源分别按明确Git提交部署，正文更新保存API基线版本。回滚代码不drop新增编辑表；内容按版本回退，不恢复整库覆盖上线后的新文章。
## 执行顺序
先完成生产差异清单和发布仓库选择，再处理图片/首页SEO/环境配置，完成隔离验收与定点数据预演；之后生成可审阅提交、备份清单和回滚命令。正式发布按提交→推送→目标服务器更新到该提交→指定迁移→API定点内容发布→服务器侧验收执行。当前未开始后半段操作。
线上页面验收未做；此次为准备工作，不将未发布状态写成服务器侧业务验收通过。用户若要求线上页面验收，仍须按Windows入口访问审批执行。
## 2026-10-29 继续发布：早期准备记录（已由上方test部署状态更新）
用户已授权继续发布全部关联更新，但本次排除广告；不发布DPL/HN/FUC新增组件、图片、CSS或链接，保留生产现有广告。这个范围不要求从本地删除广告实现。
已在VPS-003创建/root/backups/cfn-fna-v3-20261029/，生产代码备份code-before.tar.gz和Git基线baseline.bundle已确认完成；生产HEAD仍为0792297bb8164fd2929b939d8d1206bc77b4ee81，运行分支master，只有原generated-tags-cloud模板未提交修改。没有提交、推送、切换版本或迁移生产数据。
自动审批拒绝把完整生产Git基线导出本机；该路线已停止，后续改为服务器隔离工作区构造提交、推送后目标站点按明确SHA更新，不需要导出完整生产仓库。随后白色机104.168.30.40:22连续在SSH密钥交换前关闭连接，未进入密码认证。数据库备份和隔离工作区创建命令均未执行成功，不能视为已有完整回滚条件；恢复连接后先核对备份和现场状态再继续，不能跳过数据库备份。
关联Resource V2线上仍为77d4bb2b1737e668e28eb83699549b63c56b42d4，尚无PoolController、ImageHealth、CatalogController及其新增迁移；本次必须通过Git补发图池相关功能，不能只复制素材或假设生产已有池API。软件资源独立实例不在本次更新范围。
FNA_V3已本地准备图片消费者生产适配：仅local精确允许http://resource.loc:8612、production精确允许https://resource-v2.gemcook.net；其余环境/来源禁用。新增RESOURCE_V2_ILLUSTRATIONS_ENABLED开关，生产需显式配置和独立凭据；本次尚未启用生产服务。实现未触碰本地现有配图和文章数据。回归19项/149断言通过；环境边界另有IllustrationEnvironmentTest专项验证。
后续：补做数据库/Resource V2备份→服务器隔离工作区合并并排除广告→测试与Git提交/推送→Resource V2图池增量部署/素材迁移→cfn代码部署与指定表迁移→教程API定点发布→服务器侧验收。未绕过白色机直连。
### 白色机连接复核（2026-10-29 10:12 UTC）
按用户要求只读排查：本机到白色机经utun6/Clash TUN，运行时为global、当前GLOBAL选择日本JP-07；这是当前链路证据，不能单凭它认定代理故障。随后已收到正常OpenSSH横幅，真实登录白色机成功，并通过登记跳转真实登录VPS-003成功。
白色机ssh服务active，ActiveEnterTimestamp为2026-10-15，NRestarts=0；MaxStartups=10:30:100。近期服务日志未找到MaxStartups丢弃/限流记录。此前失败发生在认证前，目前仅能定性为间歇断连，具体根因未定位，不能归因于密码错误、服务器封禁或代理节点。全程没有切换节点、关闭TUN、重启SSH或修改防火墙。连接阻塞已解除；本次连接诊断没有执行新的发布或数据库写入，完整发布仍未完成。

986
docs/maintenance/SEO_BASELINE_2026-10-22.json Normal file
View File

@ -0,0 +1,986 @@
{
"schema": "fna-v3.seo-audit.v1",
"audit_date": "2026-10-22",
"timezone": "Asia/Shanghai",
"data_captured_utc": "2026-10-22T05:10:40+00:00",
"scope": "Local read-only audit; project online requests blocked; no ranking or indexing claims",
"git_head": "4778ca17d1a722f375d15219cff13cea8946ab26",
"source_hashes": {
"routes/web.php": "55f0e86fbf572be3688e680b5acf3b2a6140f3b30d76e92fb3b07d5446a00f02",
"app/Services/ArticlesService.php": "f811dc93f106cddd4172bd6b10378f61c9906459e81dce42704a94b69e548a81",
"app/Http/Controllers/Web/ArticlesController.php": "687fdf307930403392e3b28846f3af88a7a7e2a09dd456f32682fae7fe425f69",
"resources/views/components/app-layout.blade.php": "e38d8008e2082d4c47fa62831efb83ed10b407e71026af25ee27b85c6da3303c",
"resources/views/pages/articles/default/index.blade.php": "d2b94473c307d418e24761b3ef9a1b641c7260388b1ce7654e9a3a2ede4c494e",
"resources/views/pages/articles/default/show.blade.php": "f0dea8dca71bdae27fe4a5fdb1bbcb9a44f483839dd456deffd82b6c2faedd18",
"resources/js/app.js": "eb3e861c110249a7b30d798597c94c398953b5ff9cd878b1e88f50834139fac7",
"app/Http/Controllers/SitemapController.php": "4274dcbb483097a3392c96fda375301026829bde88360472a5697bcfe4446a18",
"app/Http/Controllers/RobotsController.php": "f18e708dd3fb5ed12460bf383e008057858f5dd3c46839e8b52b63d1e54788bb",
"app/Models/Articles.php": "60ea10d16fc3b086f40fce907056918cbf310f4d04e675917a033e7152d2bb03",
"app/Console/Commands/ClearDb.php": "c962d3a8a54344930781d990f7d1a7031c9b795e6cf3a6afe58d95c942ce35f1",
"resources/views/components/dpl-article-ad.blade.php": "0957c68b8735726a3dfff07f67755ef79c8b2f19784f01cf6e3f890edc665698"
},
"article_count": 167,
"categories": [
{
"id": 1,
"iParentId": 0,
"sName": "免费节点",
"sSlug": "freenode",
"iStatus": 1,
"iShowChildren": 0,
"options": {
"noindexday": "7"
},
"articles": 78,
"expired": 72
},
{
"id": 2,
"iParentId": 0,
"sName": "客户端",
"sSlug": "client",
"iStatus": 1,
"iShowChildren": 1,
"options": null,
"articles": 0,
"expired": 0
},
{
"id": 3,
"iParentId": 2,
"sName": "Windows",
"sSlug": "windows",
"iStatus": 1,
"iShowChildren": 0,
"options": null,
"articles": 1,
"expired": 0
},
{
"id": 4,
"iParentId": 2,
"sName": "Andorid",
"sSlug": "andorid",
"iStatus": 1,
"iShowChildren": 0,
"options": null,
"articles": 2,
"expired": 0
},
{
"id": 6,
"iParentId": 2,
"sName": "Ios",
"sSlug": "ios",
"iStatus": 1,
"iShowChildren": 0,
"options": null,
"articles": 1,
"expired": 0
},
{
"id": 7,
"iParentId": 2,
"sName": "Linux",
"sSlug": "linux",
"iStatus": 1,
"iShowChildren": 0,
"options": null,
"articles": 1,
"expired": 0
},
{
"id": 8,
"iParentId": 2,
"sName": "Mac",
"sSlug": "mac",
"iStatus": 1,
"iShowChildren": 0,
"options": null,
"articles": 2,
"expired": 0
},
{
"id": 9,
"iParentId": 0,
"sName": "免费小火箭ID",
"sSlug": "shadowrocketids",
"iStatus": 1,
"iShowChildren": 0,
"options": {
"noindexday": "7"
},
"articles": 82,
"expired": 76
}
],
"tags": [
{
"id": 5,
"sName": "Shadowrocket",
"sSlug": "shadowrocket-7vf7o",
"count": 160
},
{
"id": 7,
"sName": "Clash",
"sSlug": "clash-wd81q",
"count": 83
},
{
"id": 19,
"sName": "Ios",
"sSlug": "ios-nmR1P",
"count": 83
},
{
"id": 29,
"sName": "免费苹果账号",
"sSlug": "mian-fei-ping-guo-zhang-hao-rlB6M",
"count": 82
},
{
"id": 26,
"sName": "小火箭",
"sSlug": "xiao-huo-jian-2WpM6",
"count": 82
},
{
"id": 28,
"sName": "shadowrocket id",
"sSlug": "shadowrocket-id-ds9Uw",
"count": 82
},
{
"id": 27,
"sName": "小火箭账号",
"sSlug": "xiao-huo-jian-zhang-hao-5QgoQ",
"count": 82
},
{
"id": 12,
"sName": "v2ray",
"sSlug": "v2ray-Pd4HR",
"count": 79
},
{
"id": 6,
"sName": "Quantumult",
"sSlug": "quantumult-Ggc90",
"count": 79
},
{
"id": 8,
"sName": "SSR",
"sSlug": "ssr-BjeEq",
"count": 79
},
{
"id": 10,
"sName": "订阅链接",
"sSlug": "ding-yue-lian-jie-ruNF0",
"count": 78
},
{
"id": 15,
"sName": "Hiddify",
"sSlug": "hiddify-ryEsf",
"count": 78
},
{
"id": 9,
"sName": "节点",
"sSlug": "jie-dian-yIt5z",
"count": 78
},
{
"id": 11,
"sName": "免费节点",
"sSlug": "mian-fei-jie-dian-hOpYo",
"count": 78
},
{
"id": 16,
"sName": "SingBox",
"sSlug": "singbox-A2Zpo",
"count": 78
},
{
"id": 13,
"sName": "客户端",
"sSlug": "ke-hu-duan-oAK85",
"count": 5
},
{
"id": 18,
"sName": "安卓",
"sSlug": "an-zhuo-2MYr2",
"count": 5
},
{
"id": 17,
"sName": "Android",
"sSlug": "android-xSKGC",
"count": 2
},
{
"id": 24,
"sName": "mac",
"sSlug": "mac-FWuEm",
"count": 2
},
{
"id": 21,
"sName": "iPhone",
"sSlug": "iphone-CZDcr",
"count": 1
},
{
"id": 23,
"sName": "苹果",
"sSlug": "ping-guo-5a23n",
"count": 1
},
{
"id": 20,
"sName": "iPad",
"sSlug": "ipad-FJbiU",
"count": 1
},
{
"id": 25,
"sName": "linux",
"sSlug": "linux-U82BL",
"count": 1
},
{
"id": 14,
"sName": "windows",
"sSlug": "windows-Z3oeN",
"count": 1
},
{
"id": 22,
"sName": "Quantumult X",
"sSlug": "quantumult-x-ub5dy",
"count": 1
}
],
"database_clock": {
"db_now": "2026-10-22 13:10:40",
"db_utc": "2026-10-22 05:10:40",
"db_timezone": "SYSTEM"
},
"config": {
"page_limit": 2,
"response_cache_enabled": false,
"response_cache_seconds": 604800,
"app_url_origin": "fn-b.loc",
"scout_driver": "meilisearch",
"scout_prefix": "",
"search_host": "127.0.0.1"
},
"http_summary": {
"requests": 230,
"status": {
"200": 227,
"404": 3
},
"article_robots": {
"noindex, follow": 148,
"index, follow": 19
},
"sitemap_urls": 20,
"sitemap_noindex_conflicts": [],
"html_graph_reachable_articles": 12,
"html_graph_unreached_articles": 155,
"html_graph_unreached_indexable_articles": [
"/a/fn20261016.html",
"/a/fn20261017.html",
"/a/fn20261018.html",
"/a/ssi20261016.html",
"/a/ssi20261017.html",
"/a/ssi20261018.html",
"/a/ssi20261019.html"
],
"max_observed_graph_depth": 3,
"list_titles_distinct": 1
},
"http_examples": [
{
"path": "/",
"status": 200,
"title": "Clash免费节点，支持Clash/V2ray/Singbox/小火箭/Hiddify，每天更新。 - v2rayfreenode",
"robots": "index, follow",
"canonical": [
"http://127.0.0.1:8103"
],
"h1": [],
"cards": [
"/a/fn20261021.html",
"/a/fn20261020.html"
],
"pagination_links": [],
"breadcrumbs": [],
"image_count": 3,
"images_missing_dimensions": 2,
"images_missing_alt": 0
},
{
"path": "/?page=1",
"status": 200,
"title": "Clash免费节点，支持Clash/V2ray/Singbox/小火箭/Hiddify，每天更新。 - v2rayfreenode",
"robots": "index, follow",
"canonical": [
"http://127.0.0.1:8103"
],
"h1": [],
"cards": [
"/a/fn20261021.html",
"/a/fn20261020.html"
],
"pagination_links": [],
"breadcrumbs": [],
"image_count": 3,
"images_missing_dimensions": 2,
"images_missing_alt": 0
},
{
"path": "/?page=2",
"status": 200,
"title": "Clash免费节点，支持Clash/V2ray/Singbox/小火箭/Hiddify，每天更新。 - v2rayfreenode",
"robots": "index, follow",
"canonical": [
"http://127.0.0.1:8103"
],
"h1": [],
"cards": [
"/a/fn20261019.html",
"/a/fn20261018.html"
],
"pagination_links": [],
"breadcrumbs": [],
"image_count": 3,
"images_missing_dimensions": 2,
"images_missing_alt": 0
},
{
"path": "/?page=0",
"status": 200,
"title": "Clash免费节点，支持Clash/V2ray/Singbox/小火箭/Hiddify，每天更新。 - v2rayfreenode",
"robots": "index, follow",
"canonical": [
"http://127.0.0.1:8103"
],
"h1": [],
"cards": [
"/a/fn20261021.html",
"/a/fn20261020.html"
],
"pagination_links": [],
"breadcrumbs": [],
"image_count": 3,
"images_missing_dimensions": 2,
"images_missing_alt": 0
},
{
"path": "/?page=-1",
"status": 200,
"title": "Clash免费节点，支持Clash/V2ray/Singbox/小火箭/Hiddify，每天更新。 - v2rayfreenode",
"robots": "index, follow",
"canonical": [
"http://127.0.0.1:8103"
],
"h1": [],
"cards": [
"/a/fn20261021.html",
"/a/fn20261020.html"
],
"pagination_links": [],
"breadcrumbs": [],
"image_count": 3,
"images_missing_dimensions": 2,
"images_missing_alt": 0
},
{
"path": "/?page=abc",
"status": 200,
"title": "Clash免费节点，支持Clash/V2ray/Singbox/小火箭/Hiddify，每天更新。 - v2rayfreenode",
"robots": "index, follow",
"canonical": [
"http://127.0.0.1:8103"
],
"h1": [],
"cards": [
"/a/fn20261021.html",
"/a/fn20261020.html"
],
"pagination_links": [],
"breadcrumbs": [],
"image_count": 3,
"images_missing_dimensions": 2,
"images_missing_alt": 0
},
{
"path": "/?page=39",
"status": 200,
"title": "Clash免费节点，支持Clash/V2ray/Singbox/小火箭/Hiddify，每天更新。 - v2rayfreenode",
"robots": "index, follow",
"canonical": [
"http://127.0.0.1:8103"
],
"h1": [],
"cards": [
"/a/fn20260731.html",
"/a/fn20260730.html"
],
"pagination_links": [],
"breadcrumbs": [],
"image_count": 3,
"images_missing_dimensions": 2,
"images_missing_alt": 0
},
{
"path": "/?page=40",
"status": 200,
"title": "Clash免费节点，支持Clash/V2ray/Singbox/小火箭/Hiddify，每天更新。 - v2rayfreenode",
"robots": "index, follow",
"canonical": [
"http://127.0.0.1:8103"
],
"h1": [],
"cards": [],
"pagination_links": [],
"breadcrumbs": [],
"image_count": 3,
"images_missing_dimensions": 2,
"images_missing_alt": 0
},
{
"path": "/?page=99",
"status": 200,
"title": "Clash免费节点，支持Clash/V2ray/Singbox/小火箭/Hiddify，每天更新。 - v2rayfreenode",
"robots": "index, follow",
"canonical": [
"http://127.0.0.1:8103"
],
"h1": [],
"cards": [],
"pagination_links": [],
"breadcrumbs": [],
"image_count": 3,
"images_missing_dimensions": 2,
"images_missing_alt": 0
},
{
"path": "/freenode",
"status": 200,
"title": "Clash免费节点，支持Clash/V2ray/Singbox/小火箭/Hiddify，每天更新。 - v2rayfreenode",
"robots": "index, follow",
"canonical": [
"http://127.0.0.1:8103/freenode"
],
"h1": [],
"cards": [
"/a/fn20261021.html",
"/a/fn20261020.html"
],
"pagination_links": [],
"breadcrumbs": [],
"image_count": 3,
"images_missing_dimensions": 2,
"images_missing_alt": 0
},
{
"path": "/wrong/freenode",
"status": 200,
"title": "Clash免费节点，支持Clash/V2ray/Singbox/小火箭/Hiddify，每天更新。 - v2rayfreenode",
"robots": "index, follow",
"canonical": [
"http://127.0.0.1:8103/wrong/freenode"
],
"h1": [],
"cards": [
"/a/fn20261021.html",
"/a/fn20261020.html"
],
"pagination_links": [],
"breadcrumbs": [],
"image_count": 3,
"images_missing_dimensions": 2,
"images_missing_alt": 0
},
{
"path": "/client",
"status": 200,
"title": "Clash免费节点，支持Clash/V2ray/Singbox/小火箭/Hiddify，每天更新。 - v2rayfreenode",
"robots": "index, follow",
"canonical": [
"http://127.0.0.1:8103/client"
],
"h1": [],
"cards": [
"/a/m167.html",
"/a/m174.html"
],
"pagination_links": [],
"breadcrumbs": [],
"image_count": 3,
"images_missing_dimensions": 2,
"images_missing_alt": 0
},
{
"path": "/client/windows",
"status": 200,
"title": "Clash免费节点，支持Clash/V2ray/Singbox/小火箭/Hiddify，每天更新。 - v2rayfreenode",
"robots": "index, follow",
"canonical": [
"http://127.0.0.1:8103/client/windows"
],
"h1": [
"windows1"
],
"cards": [
"/a/m167.html"
],
"pagination_links": [],
"breadcrumbs": [],
"image_count": 3,
"images_missing_dimensions": 2,
"images_missing_alt": 0
},
{
"path": "/windows",
"status": 200,
"title": "Clash免费节点，支持Clash/V2ray/Singbox/小火箭/Hiddify，每天更新。 - v2rayfreenode",
"robots": "index, follow",
"canonical": [
"http://127.0.0.1:8103/windows"
],
"h1": [
"windows1"
],
"cards": [
"/a/m167.html"
],
"pagination_links": [],
"breadcrumbs": [],
"image_count": 3,
"images_missing_dimensions": 2,
"images_missing_alt": 0
},
{
"path": "/wrong/windows",
"status": 200,
"title": "Clash免费节点，支持Clash/V2ray/Singbox/小火箭/Hiddify，每天更新。 - v2rayfreenode",
"robots": "index, follow",
"canonical": [
"http://127.0.0.1:8103/wrong/windows"
],
"h1": [
"windows1"
],
"cards": [
"/a/m167.html"
],
"pagination_links": [],
"breadcrumbs": [],
"image_count": 3,
"images_missing_dimensions": 2,
"images_missing_alt": 0
},
{
"path": "/a/client",
"status": 200,
"title": "Clash免费节点，支持Clash/V2ray/Singbox/小火箭/Hiddify，每天更新。 - v2rayfreenode",
"robots": "index, follow",
"canonical": [
"http://127.0.0.1:8103/a/client"
],
"h1": [],
"cards": [
"/a/m167.html",
"/a/m174.html"
],
"pagination_links": [],
"breadcrumbs": [],
"image_count": 3,
"images_missing_dimensions": 2,
"images_missing_alt": 0
},
{
"path": "/search/Clash",
"status": 200,
"title": "Clash免费节点，支持Clash/V2ray/Singbox/小火箭/Hiddify，每天更新。 - v2rayfreenode",
"robots": "index, follow",
"canonical": [
"http://127.0.0.1:8103/search/Clash"
],
"h1": [],
"cards": [],
"pagination_links": [],
"breadcrumbs": [],
"image_count": 3,
"images_missing_dimensions": 2,
"images_missing_alt": 0
},
{
"path": "/robots.txt",
"status": 200,
"rules": [
"User-agent: *",
"Allow: /",
"Disallow: /admin/",
"Disallow: /api/",
"Disallow: /storage/",
"Disallow: /vendor/",
"Disallow: /test/",
"Disallow: /*?*",
"",
"Sitemap: http://127.0.0.1:8103/sitemap.xml"
]
},
{
"path": "/sitemap.xml",
"status": 200
},
{
"path": "/a/fn20261021.html",
"status": 200,
"title": "「10月21日」2026年最新高速SSR/V2ray/Clash/Shadowrocket免费节点订阅链接 - 免费节点",
"robots": "index, follow",
"canonical": [
"http://127.0.0.1:8103/a/fn20261021.html"
],
"h1": [
"「10月21日」2026年最新高速SSR/V2ray/Clash/Shadowrocket免费节点订阅链接"
],
"cards": [],
"pagination_links": [],
"breadcrumbs": [
{
"href": "/",
"resolved": "/"
},
{
"href": "freenode",
"resolved": "/a/freenode"
}
],
"image_count": 4,
"images_missing_dimensions": 2,
"images_missing_alt": 0
},
{
"path": "/a/fn20260910.html",
"status": 200,
"title": "「9月10日」2026年最新高速SSR/V2ray/Clash/Shadowrocket免费节点订阅链接 - 免费节点",
"robots": "noindex, follow",
"canonical": [
"http://127.0.0.1:8103/a/fn20260910.html"
],
"h1": [
"「9月10日」2026年最新高速SSR/V2ray/Clash/Shadowrocket免费节点订阅链接"
],
"cards": [],
"pagination_links": [],
"breadcrumbs": [
{
"href": "/",
"resolved": "/"
},
{
"href": "freenode",
"resolved": "/a/freenode"
}
],
"image_count": 4,
"images_missing_dimensions": 2,
"images_missing_alt": 0
},
{
"path": "/a/m167.html",
"status": 200,
"title": "「Clash for Windows」Windows、Mac、Linux，桌面系统全支持 - Windows",
"robots": "index, follow",
"canonical": [
"http://127.0.0.1:8103/a/m167.html"
],
"h1": [
"「Clash for Windows」Windows、Mac、Linux，桌面系统全支持"
],
"cards": [],
"pagination_links": [],
"breadcrumbs": [
{
"href": "/",
"resolved": "/"
},
{
"href": "client",
"resolved": "/a/client"
},
{
"href": "windows",
"resolved": "/a/windows"
}
],
"image_count": 4,
"images_missing_dimensions": 2,
"images_missing_alt": 0
}
],
"sitemap_paths": [
"/",
"/a/fn20261021.html",
"/a/ssi20261021.html",
"/a/fn20261020.html",
"/a/ssi20261020.html",
"/a/fn20261019.html",
"/a/ssi20261019.html",
"/a/fn20261018.html",
"/a/ssi20261018.html",
"/a/fn20261017.html",
"/a/ssi20261017.html",
"/a/fn20261016.html",
"/a/ssi20261016.html",
"/a/m167.html",
"/a/m174.html",
"/a/m173.html",
"/a/m172.html",
"/a/m171.html",
"/a/m170.html",
"/a/m169.html"
],
"html_exact_duplicate_groups": [
[
"ssi20260922",
"ssi20260907",
"ssi20260906"
],
[
"ssi20260909",
"ssi20260908"
],
[
"ssi20260827",
"ssi20260826",
"ssi20260825",
"ssi20260824"
],
[
"ssi20260823",
"ssi20260822"
],
[
"m174",
"m173"
]
],
"content_metrics": {
"descriptions_with_html": 78,
"zero_node_description_count": 4,
"indexable_zero_node_slugs": [
"fn20261021",
"fn20261020",
"fn20261019"
],
"guides": [
{
"slug": "m167",
"content_chars": 170
},
{
"slug": "m174",
"content_chars": 176
},
{
"slug": "m173",
"content_chars": 176
},
{
"slug": "m172",
"content_chars": 227
},
{
"slug": "m171",
"content_chars": 138
},
{
"slug": "m170",
"content_chars": 258
},
{
"slug": "m169",
"content_chars": 355
}
],
"body_promotional_links_without_rel": 160,
"articles_pending_automatic_likes": 7
},
"search_status": [
{
"path": "/health",
"status": 200,
"health": "available",
"documents": null,
"isIndexing": null,
"estimatedTotalHits": null,
"error_code": null
},
{
"path": "/indexes/articles/stats",
"status": 200,
"health": null,
"documents": 40,
"isIndexing": false,
"estimatedTotalHits": null,
"error_code": null
},
{
"path": "/indexes/articles/search?q=Clash&limit=0",
"status": 200,
"health": null,
"documents": null,
"isIndexing": null,
"estimatedTotalHits": 7,
"error_code": null
},
{
"path": "/indexes/articles/search?q=Clash&limit=0&sort=iIsTop:desc",
"status": 200,
"health": null,
"documents": null,
"isIndexing": null,
"estimatedTotalHits": 7,
"error_code": null
}
],
"search_id_match": {
"status": 200,
"returned_hits": 7,
"ids_present_in_fna": 0,
"same_id_and_slug": 0
},
"browser_checks": [
{
"path": "/",
"javascript": true,
"width": 390,
"status": 200,
"overflow": false,
"page_errors": [],
"initial_cards": [
"/a/fn20261021.html",
"/a/fn20261020.html"
],
"after_load": null,
"blocked_hosts": [
"umami.gemcook.net",
"resource.gemcook.net"
]
},
{
"path": "/?page=2",
"javascript": true,
"width": 1280,
"status": 200,
"overflow": false,
"page_errors": [],
"initial_cards": [
"/a/fn20261019.html",
"/a/fn20261018.html"
],
"after_load": {
"cards": [
"/a/fn20261019.html",
"/a/fn20261018.html",
"/a/fn20261019.html",
"/a/fn20261018.html"
],
"loadCount": 1
},
"blocked_hosts": [
"umami.gemcook.net",
"resource.gemcook.net"
]
},
{
"path": "/client/windows",
"javascript": true,
"width": 390,
"status": 200,
"overflow": false,
"page_errors": [],
"initial_cards": [
"/a/m167.html"
],
"after_load": null,
"blocked_hosts": [
"umami.gemcook.net",
"resource.gemcook.net"
]
},
{
"path": "/a/m167.html",
"javascript": true,
"width": 390,
"status": 200,
"overflow": false,
"page_errors": [],
"initial_cards": [],
"after_load": null,
"blocked_hosts": [
"umami.gemcook.net"
]
},
{
"path": "/",
"javascript": false,
"width": 390,
"status": 200,
"overflow": false,
"page_errors": [],
"initial_cards": [
"/a/fn20261021.html",
"/a/fn20261020.html"
],
"after_load": null,
"blocked_hosts": [
"resource.gemcook.net"
]
}
],
"mobile_320_checks": [
{
"path": "/",
"overflow": false,
"menu": {
"left": 0,
"right": 256,
"links": 8
}
},
{
"path": "/client/windows",
"overflow": false
},
{
"path": "/a/m167.html",
"overflow": false
}
],
"delivery_verification": {
"implementation_items": 36,
"acceptance_scenarios": 20,
"website_source_asset_environment_files_unchanged": 195,
"article_category_tag_audit_fields_unchanged": true,
"local_document_links_valid": true,
"gemdocs_check": "PASS",
"code_modified": false,
"business_data_modified": false,
"committed": false,
"pushed": false,
"deployed": false
}
}

734
docs/maintenance/SEO_PLAN.md Normal file
View File

@ -0,0 +1,734 @@
# FNA_V3 SEO 优化建议与执行清单
评估日期：2026-10-22，Asia/Shanghai。状态：**分析与建议文档已完成；SEO-001 的部署定位已由用户确认，配置改造尚未实施；SEO-020 于2026-10-27完成本地教程正文更新，设备实测及生产验收未做，D02首页最新免费节点全文展示于2026-10-27本地完成，其余项目尚未实施**。本文件是后续 SEO 工作的唯一执行清单；按 `SEO-001` 至 `SEO-036` 跟踪，实施后在本文件更新结果，不另建重复的“最新版计划”。
本轮依据当前代码、当前本地数据库、重新取得的 HTTP 响应及受限浏览器检查形成结论。网站源码、样式和业务数据未作修改。当前三款 DPL 广告属于已存在的实现，纳入分析基准并保留。网站仍在独立本地副本中开发；用户随后确认未来替换现有 cfn，并支持同一套代码部署多个同类站点，ClashFreeNode 为主力站，尚未实际部署或迁移。
**最优先的工作是让有价值的内容拥有唯一、稳定、可发现的地址，并让页面真实兑现搜索结果中的承诺。** 当前主要问题集中于重复 URL、分页发现路径、内容生命周期和资源质量；仅增加标题、关键词或结构化数据不能解决这些问题。现有 Laravel Blade 已能在首次 HTML 响应中输出文章正文，没有证据表明必须改用另一套框架或全面重写网站。
## 1 如何阅读和执行
- 先看第 2 节的结论与证据，再确定第 3 节的产品决策。
- 第 4 节定义目标 URL 和索引规则；这是实现之间保持一致的依据。
- 第 5 节是总清单，第 6 节给出每一项的具体范围和验收条件。
- 第 7 节规定实施批次，第 8 节是验收矩阵，第 9 节规定发布后的效果观察方法。
- 每项实现都要记录：实际改动、代码验证、本地页面验证、是否发布、线上验证范围。不能把“代码完成”写成“Google 已收录”。
优先级含义：
| 级别 | 含义 |
| --- | --- |
| P0 | 基础规则冲突，或公开发布前必须解决的风险。标注“发布前”的项目不意味着本地正在发生线上事故 |
| P1 | 影响主题识别、内容价值、内链、索引一致性或长期维护的主要优化 |
| P2 | 在基础和内容就绪后改善展示、体验、效率及分发 |
证据等级：**已确认**指本轮代码、数据或响应直接支持；**条件性风险**指相关代码存在，但触发条件或生产影响未确认；**策略建议**指需要结合业务取舍决定；**待线上验证**指必须有实际生产环境或搜索平台数据才能判断。
本报告以 Google 的技术要求为主要参照；通用的 URL、HTTP、内容与内链原则也有助于其他搜索引擎。Bing、百度等渠道的具体投入，应由目标用户和后续数据决定，不能假定它们完全采用相同的收录规则。
## 2 当前状态和核心判断
### 2.1 检查范围
| 项目 | 本轮范围与结果 |
| --- | --- |
| 代码 | 当前工作目录 `/Users/hellcat/Documents/GemCodes/FNA_V3`，包含原有并行修改及广告实现 |
| 数据 | 本机 `fna_v3`，167 篇文章、8 个分类、25 个标签；业务数据只读 |
| HTTP | 230 个不同的本地地址，覆盖全部文章、全部标签、分类和代表性异常参数；227 个 200、3 个预期 404 |
| 文章索引声明 | 19 篇 `index, follow`，148 篇 `noindex, follow`；这是页面声明，**不是 Google 实际收录数量** |
| Sitemap | 20 个 URL：主页加 19 篇文章；本轮与文章 noindex 声明无冲突，未包含分类或标签 |
| 浏览器 | 5 组桌面／手机／禁用 JS 检查，另补 3 组 320px 检查；所有非本地网络请求被阻止 |
| 资源和搜索 | 本地 Meilisearch 的只读状态和 ID 对照；未下载在线订阅、未检测节点、未请求线上图片或统计脚本 |
| 线上证据 | 未读取 Search Console、线上抓取日志、真实访问指标、外链或关键词排名，不能据此给出排名或流量损失数值 |
数据采样时应用使用 UTC，数据库 `NOW()` 使用 UTC+8：分别约为 `2026-10-22 05:10 UTC` 和 `2026-10-22 13:10`。计数受时间及后续数据变化影响；实施时应重新计算，不把 19 或 20 写死为测试长期期望值。
### 2.2 当前值得保留的基础
1. **首次响应已有内容。** 禁用 JavaScript 后，首页的首批文章仍能显示；文章标题与正文由服务端输出。应在现有渲染方式上补足链接和元数据。
2. **真正不存在的对象返回 404。** 本轮不存在的文章、分类和标签均返回 404；问题主要是合法分类的错误前缀、分页和搜索边界。
3. **文章页有明确 H1，基础语言与 viewport 已设置。** 不需要把全部页面基础能力推倒重做。
4. **已有 robots、canonical、sitemap 和按内容年龄控制索引的机制。** 重点是修正它们之间的规则，不是简单从零叠加另一套。
5. **DPL 广告已有可见“广告”标识，链接带 `sponsored noopener noreferrer`。** 装饰性标志使用空 alt，且已指定宽高，这是合理做法。
6. **本轮受限检查中 320px／390px 代表页面无横向溢出，手机菜单动画完成后正常展开。** 这只是本地样本验收，不能替代线上性能、完整无障碍或所有设备验证。
### 2.3 主要证据
| 证据 | 本轮发现 | 意义及边界 | 对应项目 |
| --- | --- | --- | --- |
| E01 | `/`、`/freenode`、`/wrong/freenode` 返回相同列表，各自声明 canonical；`/windows`、`/client/windows`、`/wrong/windows` 也重复 | 路由没有验证父分类。错误路径可扩张出大量有效副本；不能据此声称已遭搜索处罚 | 004、009 |
| E02 | 所有检查到的列表均无普通分页 `<a href>`；robots 屏蔽所有带 `?` 的 URL；第 2 页 canonical 指向第一页 | 内容发现链路与规范化信号同时有缺口 | 005、006 |
| E03 | 从首页沿本轮页面中的实际 HTML 站内链接遍历，只能到达 12 篇文章；19 篇允许索引的文章中有 7 篇未能沿该图到达 | 未把 sitemap、JS 滚动或外链算作 HTML 内链。不是断言搜索引擎绝不可能发现它们 | 005、014 |
| E04 | 浏览器直接进入 `/?page=2` 后加载下一批，重复追加了第 2 页两篇文章 | JS 以 `loadCount + 2` 计算页号，没有从当前 URL 初始化 | 005 |
| E05 | `/?page=40`、`/?page=99` 空列表仍为 200/index；`page=0`、负数、字符串回到首页内容 | 无效分页和空结果的响应策略需明确。合法空搜索并不必须返回 404 | 007 |
| E06 | 首页、各分类、标签、搜索均使用同一站点标题和简介；主页、父分类、标签、搜索缺少内容 H1；Windows 分类 H1 为 `windows1` | 不同搜索意图没有得到清楚描述；单独缺 H1 不等于排名惩罚 | 010、011 |
| E07 | 78 篇文章副标题含 HTML；公共布局在所有 meta description 前附加请求当天日期 | 老文章被描述成“今天”的内容，HTML 标签成为摘要字符串的一部分 | 011、012 |
| E08 | 文章面包屑相对链接 `client` 在文章地址下解析为 `/a/client`；该地址又被宽松分类路由接受 | 错误内链进一步制造副本 | 009 |
| E09 | 167 篇文章全部发布；分类列表缺少文章状态过滤，文章详情缺少分类状态过滤 | 当前没有草稿，因此未证实已有草稿泄露；未来发布控制边界不一致 | 008 |
| E10 | 78 篇节点文章、82 篇账号文章使用 7 天 noindex；清理命令还定义了 180 天删除 | 这是产品策略，不能直接判错；需要按长期价值与资源有效期决定 | 003、018 |
| E11 | 原始正文 HTML 完全相同的 5 组共 13 篇，包括两个客户端页面；7 篇客户端正文可见文本约 138–355 字 | 重复已经确认；字数只用于描述内容规模，没有最低字数达标线 | 019、020 |
| E12 | 最新连续三篇 `fn20261019`、`fn20261020`、`fn20261021` 的正文及副标题均为 0 个可用节点，标题仍称最新高速免费节点；全库共有 4 篇零节点记录 | 无法仅凭文章判断远端订阅此刻是否真为空；已确认的是发布内容与承诺需要复核 | 017、018 |
| E13 | 本地 `articles` 搜索索引仅 40 条；Clash 命中 7 条，其 ID 在当前 167 篇文章中全部不存在；页面显示空结果 | 当前应用与搜索索引不匹配。索引实际归属未进一步调查，不得直接清空这个共享名称的索引 | 016 |
| E14 | `updated_at` 被点赞增减和分类关联更新使用，sitemap 却把它作为 lastmod；存在自动注入点赞逻辑，7 篇还有待注入计数 | 内容日期与互动数据耦合；未启动本地调度，也未确认线上任务当前是否运行 | 012、022、029 |
| E15 | 全部文章未输出 JSON-LD；当前响应中的图片均有 alt 属性，两个导航 logo 未带宽高；列表封面使用 CSS 背景 | 结构化数据是后续增强；不能把装饰图空 alt 当缺陷，也不能把缺宽高直接等同实测 CLS 不合格 | 024、026 |
| E16 | 文章“复制链接”模板写入站点首页；页面品牌文本为 `v2rayfreenode`，样式／标志使用 cfn／Clash；通用 OG 图为相对地址 | 分享链接存在功能错误；站点身份需统一，但 FNA_V3 内部代号不必作为公开品牌 | 001、025 |
| E17 | 新 DPL 组件链接已带 sponsored；160 篇资源正文中的 `fuuu.cloud` 链接未带 rel 属性 | 原有正文推广和新广告组件需要分别治理；不能把新广告已经正确理解为所有推广均处理完毕 | 023 |
| E18 | 当前整页缓存关闭；默认配置若启用会缓存 7 天，文章事件仅尝试失效首页 | 当前不是“正在缓存错误内容”的故障；启用前存在过期、撤稿及多入口失效风险 | 029 |
| E19 | 三个文章接收接口在运行时路由表中只有 web 中间件，`api/*` 排除 CSRF；接收逻辑自动发布并可能调用推送、通知和资源服务 | 应用层缺少已挂载的入站认证，是公开部署前风险。未发送写入请求，未核实生产边缘访问控制 | 030、032 |
### 2.4 关键因果关系
当前链路是：
```text
内容按天生成 → 标题与正文高度模板化 → 新文章仅有短暂索引窗口
↓
每页只展示 2 条 → 后续页依赖滚动 → 普通链接难以到达较深文章
↓
分页被 robots 屏蔽，canonical 又指回第一页
↓
发现与积累主要依赖 sitemap 和每日新 URL，长期内容资产较弱
```
这里的判断是技术与内容策略推断，不是对线上 Google 抓取行为的实测描述。167 篇的规模本身不值得优先做复杂“抓取预算”工程；应先消除无限别名、无效分页和低价值重复。
## 3 实施前需要确定的产品决策
D01、D02 已由用户确认；其余条目仍是建议，未因这些确认而自动获批。
| 决策 | 方案与确认状态 | 为什么 | 影响范围 |
| --- | --- | --- | --- |
| D01 上线身份 | 用户已确认：未来替换现有 cfn；同一套代码支持多个同类站点；ClashFreeNode 是主力站，本地继续独立 | 代码共用，实例身份分别配置；主力站升级需要保护现有有效地址，其他站点不能误用其域名和统计 | 001、021、031、032、036 |
| D02 首页和免费节点页 | 2026-10-27用户明确：首页直接展示日期最新的一篇免费节点文章全文；`/freenode` 保留历史列表。本地已实施，不要求文章必须是当天 | 首页与栏目承担不同展示职能；首页和对应详情的规范地址、索引策略仍在004/018中处理，不把本次功能修改视作SEO全项完成 | 004、010、018 |
| D03 日更文章的角色 | 稳定资源入口承接“当前可用”的需求；有独立记录价值的日更页保留，重复或失败记录不争取搜索曝光 | 用户需要可用资源，日期变动本身不是新价值 | 003、017、018 |
| D04 历史内容 | 先按有效性、独立信息、已有流量／外链分类，再决定 index、noindex、合并或删除 | 不批量把 148 篇开放收录，也不机械全删／全跳首页 | 003、018、036 |
| D05 标签 | 只培养有独立意图、有可维护内容的标签页；其余可保留浏览功能并 noindex | 25 个标签中存在同义名称和高度重叠文章集合 | 015 |
| D06 渠道和目标 | 首先定义有效自然访问和实际使用完成率，Google 为初始技术基线；其他渠道按目标市场补充 | 没有搜索量和 Search Console 数据时不能编造关键词机会或流量预测 | 002、035 |
| D07 样式边界 | 保持既有视觉语言和已批准广告方案；标题语义、链接、数据真实性先行；新增可见信息或调整广告占比单独评审 | SEO 改动不默认授权重设计整站或移除已批准广告 | 010、023、027 |
D01 的部署角色已明确。具体生产映射、新增实例清单以及多站相同内容的收录归属仍需在相应实施项确定；不阻塞本地分页、URL 规则和元数据开发。用户尚未授权本次上线或修改现有 cfn。
## 4 建议采用的 URL 与索引规则
### 4.1 页面行为矩阵
下表为建议合同，实施前与 D02–D05 一起确认。
| 页面类型 | 建议 HTTP | 抓取与索引 | Canonical | Sitemap |
| --- | --- | --- | --- | --- |
| 正式首页／稳定资源入口 | 200 | 可抓取，内容有效时 index | 唯一正式地址 | 是 |
| 有独立价值的分类首页 | 200 | 可抓取，index | 当前规范地址 | 是 |
| 合法第 2 页及以后 | 200 | 可抓取，默认可 index | 含正确 `page=N` 的本页地址 | 一般依赖顺序内链，不强求列入 |
| `page=1` | 301 | 收敛到无 page 的第一页 | 目标页输出 | 否 |
| 已知历史分类别名 | 301 | 一跳到等价目标，保留有效页码 | 目标页输出 | 否 |
| 错误父分类、未知 slug | 404 | 不提供可索引替代正文 | 不指向无关首页 | 否 |
| 页码越界／格式无效 | 404，或对明确等价输入做受控 301 | 不返回通用首页 200 | 不伪称与首页等价 | 否 |
| 完整、已发布文章 | 200 | 按内容策略 index | 自身稳定 URL | index 时加入 |
| 有保留价值但不面向搜索的旧记录 | 200 | 可抓取，noindex | 自身地址；不同时强行指定另一 canonical 来表达不同目的 | 否 |
| 已合并且目标真正等价的旧文章 | 301 | 到已选定的主文章 | 目标页输出 | 否 |
| 已删除且无替代内容 | 404 或明确 410 | 不索引 | 不批量跳首页 | 否 |
| 有实际主题价值的标签 | 200 | 可抓取，index | 自身规范地址 | 按维护策略加入 |
| 普通低价值标签／站内搜索 | 200 | 可抓取，noindex | 自身干净地址或不输出，保持统一规则 | 否 |
| 有效搜索词但无匹配 | 200 | noindex，显示真实无结果状态 | 同上 | 否 |
| 搜索服务故障 | 合适的 5xx 或明确降级状态 | 不伪装成“没有内容” | 不作为正常搜索页参与索引 | 否 |
| 草稿／未到发布时间／不可公开对象 | 匿名 404 或访问受控 | 不进入公开列表、搜索和 sitemap | 不公开输出 | 否 |
| 运维、API、测试、点赞等接口 | 按接口协议 | 不作为内容页面发现和索引；访问控制另行实现 | 不输出文章 canonical | 否 |
`robots.txt` 控制抓取，`noindex` 控制索引，canonical 表达代表性 URL，这三者各有用途。需要让搜索引擎读取 noindex 时，不能同时以 robots 禁止其访问该页面。[Google noindex 说明](https://developers.google.com/search/docs/crawling-indexing/block-indexing)
### 4.2 参数和路径规则
- `page` 是会改变内容的参数，应保留在分页 canonical 中；`utm_*` 等跟踪参数通常不改变正文，应从 canonical 去掉。
- 查询参数要按明确白名单处理。不要为了排除跟踪参数而一并删除页码，也不要放任任意参数生成自指 canonical。
- 分类 URL 由真实分类关系生成；不能只取路径最后一段就当有效分类。
- 文章继续保留 `/a/{slug}.html`，没有必要为“URL 看起来更 SEO”大规模更换。标签的随机后缀也不是必须去掉的错误。
- `Andorid` 应纠正可见名称。若同时把现有 `andorid` slug 改成 `android`，必须安排旧地址映射；名称修正和 URL 迁移应分开验收。
- 全站使用同一个 URL 生成入口，供导航、文章卡片、面包屑、canonical、OG、sitemap 和推送共同使用。
重定向、canonical 和 sitemap 应指向同一主地址；canonical 是规范化信号，不是保证搜索引擎一定采纳的命令。[Google 规范化说明](https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls)
### 4.3 内容模型的最小改造方向
不需要先建一套大型 CMS。先区分下列概念，能用明确的服务或计算属性表达的，不必全部新增数据库字段：
| 概念 | 作用 | 当前对应及缺口 |
| --- | --- | --- |
| 可公开访问 | 发布状态、分类状态、发布时间共同决定 | 当前各查询判断不一致 |
| 可索引 | 在可公开基础上，再考虑质量、过期、重复、明确编辑选择 | 当前主要依赖分类 noindexday |
| 规范 URL | 每个实体唯一地址和有限历史别名 | 当前多处拼接，未验证父路径 |
| 首次发布时间 | 表达首次公开时间 | 不直接把导入时间当原创发布时间 |
| 实质内容更新时间 | 影响可见更新日期、schema、sitemap | 不能继续无条件使用互动也会修改的 updated_at |
| 最后验证时间与状态 | 描述资源／教程的最近实际核验 | 与发布时间、修改时间分开；未知状态不假装已验证 |
| SEO 标题与简介 | 允许重要页面有编辑覆盖，缺省时从内容生成 | 当前列表全局模板，文章副标题混有展示 HTML |
| 来源和内容类型 | 区分资源快照、长期教程、分发内容、原创评测 | 为索引策略和内容模板提供依据 |
“公开”“索引”“资源有效”是三种不同状态。noindex 不能代替权限控制；资源失败也不应自动等同于整篇教程应被删除。
## 5 执行总表
所有项目当前均未实施。依赖列用于确定顺序，不是要求一次性同时完成全部项目。
| 完成 | 编号 | 项目 | 优先级 | 主要依赖 | 当前性质 |
| --- | --- | --- | --- | --- | --- |
| [ ] | SEO-001 | 明确公开身份、主域名和环境边界 | P0 发布前 | D01 | 部署定位已确认，配置待实施 |
| [ ] | SEO-002 | 确定搜索意图、目标用户和效果基线 | P1 | D06 | 待决策／待数据 |
| [ ] | SEO-003 | 确定内容生命周期与索引资格 | P0 策略 | D03、D04 | 待决策 |
| [ ] | SEO-004 | 统一规范 URL 和历史别名 | P0 | D02 | 已确认 |
| [ ] | SEO-005 | 修复分页发现与滚动加载 | P0 | 004 | 已确认 |
| [ ] | SEO-006 | 协调 robots、参数和 noindex | P0 | 003、005 | 已确认 |
| [ ] | SEO-007 | 修复无效分页、空结果与错误状态 | P0 | 004、005 | 已确认 |
| [ ] | SEO-008 | 统一公开可见性与发布时间判断 | P0 发布前 | 003 | 条件性风险 |
| [ ] | SEO-009 | 修复面包屑和全站内链地址 | P1 | 004 | 已确认 |
| [ ] | SEO-010 | 分类、标签、搜索的标题与语义层级 | P1 | 001、004 | 已确认 |
| [ ] | SEO-011 | 生成真实、干净的页面简介 | P1 | 010 | 已确认 |
| [ ] | SEO-012 | 分离真实内容日期并统一时间基准 | P1 | 003 | 已确认／条件性风险 |
| [ ] | SEO-013 | 统一 sitemap 的集合和 lastmod | P1 | 003、004、008、012 | 已确认 |
| [ ] | SEO-014 | 建立长期内链和内容导航 | P1 | 005、009、018 | 已确认／策略建议 |
| [ ] | SEO-015 | 整理标签与重复主题页 | P1 | 002、003 | 策略建议 |
| [ ] | SEO-016 | 隔离并同步本站搜索索引 | P1 | 008、032 | 已确认 |
| [ ] | SEO-017 | 建立空资源与检测失败的发布门槛 | P0 内容 | 003 | 已确认／待上游核实 |
| [ ] | SEO-018 | 建立稳定资源入口和日更归档策略 | P1 | 002、003、004、017 | 策略建议 |
| [~] | SEO-019 | 处理真实重复文章与跨平台内容（本地Mac/Linux教程已区分） | P1 | 003、004 | 已确认 |
| [~] | SEO-020 | 提升客户端教程的任务完成能力（本地全栏目正文完成，实机/生产未验收） | P1 | 002、019 | 已确认／内容建议 |
| [ ] | SEO-021 | 明确来源、验证和跨站内容差异 | P1 | 017、020 | 策略建议 |
| [ ] | SEO-022 | 作者、编辑责任与真实互动数据 | P1 | 001、012 | 已确认／策略建议 |
| [ ] | SEO-023 | 推广链接、广告与正文体验 | P1 | D07 | 部分已具备，仍有缺口 |
| [ ] | SEO-024 | 添加匹配真实内容的结构化数据 | P2 | 009、010、012、022 | 增强项 |
| [ ] | SEO-025 | 修复分享地址和社交预览信息 | P2 | 001、004、011 | 已确认 |
| [ ] | SEO-026 | 图片语义、尺寸和加载方式 | P2 | 020、028 | 已确认／待测量 |
| [ ] | SEO-027 | 手机端与无障碍完整验收 | P2 | 005、010 | 部分样本通过 |
| [ ] | SEO-028 | 建立正式构建性能基线并按瓶颈优化 | P2 | 026、027 | 待测量 |
| [ ] | SEO-029 | 缓存与发布、撤稿、到期一致性 | P1 启用前 | 003、008、012 | 条件性风险 |
| [ ] | SEO-030 | 文章接收、更新与删除的发布合同 | P0 发布前 | 003、008、017、029 | 已确认／条件性风险 |
| [ ] | SEO-031 | 正式主机、HTTPS 与 HTTP 服务质量 | P0 发布前 | 001、004 | 待部署验证 |
| [ ] | SEO-032 | 本地、预发布和生产资源隔离 | P0 发布前 | 001 | 已确认／条件性风险 |
| [ ] | SEO-033 | 规范 IndexNow 及搜索提交 | P2 | 003、004、030、032 | 已确认／待部署验证 |
| [ ] | SEO-034 | SEO 自动回归与数据样例 | P1 | 跟随各批次 | 当前测试缺口 |
| [ ] | SEO-035 | 搜索平台与业务效果监测 | P1 上线后 | 001、002、036 | 待线上数据 |
| [ ] | SEO-036 | 发布、迁移、回滚与复核 | P0 发布时 | 前述必需项 | 待发布授权 |
## 6 各项优化的实施说明
### SEO-001 明确公开身份、主域名和环境边界
**优先级：P0，正式发布前。** 当前 FNA_V3 是内部项目名，界面标志体现 Clash FreeNode，`app.name` 却是 `v2rayfreenode`，底层站点代码为 cfn。根环境文件保留 `fn-b.loc`，本轮 PHP 服务用启动参数将实际 APP_URL 设为本地 8103，因此本轮页面并没有错误指向旧域名。
建议明确公开品牌、正式主机、是否接替 cfn，以及各环境允许生成的 URL。品牌名称、首页标题、logo alt、作者／发布者、WebSite 数据、分享卡片与统计应使用一致配置。不要把“FNA_V3”自动展示成用户品牌，也不要仅因本地克隆而对原站做跨域 canonical。
**实施范围：** 站点配置、公共布局、环境部署检查；生产域名最终确定后再完成真实映射。
**验收：** 本地只生成本地内容 URL；预发布具有明确防索引措施；生产只生成获准主域 URL；页面身份不再同时混用互不一致的站名。替站或新站的决定记录在 D01。
**用户已确认的方向：** FNA_V3 以后替换现有 cfn；同一套代码可能部署多个同类网站；ClashFreeNode 是主力站。FNA_V3 继续作为内部项目名，不据此更改其他网站的公开品牌。
**据此收敛的实施方案：** 共用代码，以每个部署实例的配置提供站点标识、公开名称、主域、标题与简介、logo、发布者、统计和搜索提交身份；不要把 ClashFreeNode 的域名和品牌写死到所有部署。各实例的数据、搜索、缓存、会话及外部发送边界在 SEO-032 核实。ClashFreeNode 的有效旧文章地址优先保留，真正需要变更的地址才建立逐条迁移映射。
多个站点的内容相同与否、是否各自争取独立收录，以及是否有副本归集到主力站，在 SEO-021 明确；“主力站”不自动授权把所有副站 canonical 指向它，也不代表复制内容的各站一定能获得独立搜索曝光。
**当前状态：部署定位与主力品牌已确认，配置统一和环境验收尚未实施；未修改代码，未部署。**
### SEO-002 确定搜索意图、目标用户和效果基线
**优先级：P1。** 当前站点混合“今天找可用资源”“选择客户端”“查安装使用方法”“获取账号资源”四类需求。它们不应都用一段“免费节点每天更新”的文案承接。
先建立意图到页面的映射：即时资源由稳定入口承接，软件选型由客户端分类承接，具体操作由教程承接，日更历史由归档承接。关键词应从真实用户用语、站内搜索和获得授权后的搜索平台数据提炼，不预设“某词一定有高搜索量”。中文简体是当前内容语言；没有多语言版本时不添加虚假的 hreflang。
**实施范围：** 内容规划、指标定义，后续关联 SEO-035。
**验收：** 每类目标页面能回答“谁搜什么、进来要完成什么、本站有什么独立帮助”。指标至少包含非品牌自然点击、合格页面收录状况，以及不含秘密的实际资源使用事件。没有流量数据的字段保持待采集。
### SEO-003 确定内容生命周期与索引资格
**优先级：P0 策略前置。** 160 篇资源类文章采用 7 天 noindex，另有 180 天删除命令；这些规则与长期教程应分开。当前 148 篇不索引并不能证明策略错误，也不能证明其余 19 篇都是值得排名的页面。
建议将“可公开”“可索引”“已验证可用”“仅供历史记录”拆开判断。资源检测失败、真实检测为零、已过期、正文重复、仍有独立知识价值，应有不同处理。生命周期规则由一个入口计算，供详情、列表、搜索、sitemap、缓存与推送共同调用。
**实施范围：** 内容策略与发布资格服务；只有确认缺少必要信息时再增字段。
**验收：** 对新发布、过期、失败、永久教程、隐藏分类、未来发布和合并内容各有明确行为。时间边界冻结测试覆盖到期前后。先记录策略理由，再处理历史数据；不因想增加 URL 数量而批量解除 noindex。
### SEO-004 统一规范 URL 和历史别名
**优先级：P0。证据：E01。** 当前控制器只取第二段或第一段 slug，未核实路径关系，导致 `/wrong/windows` 也能成为 Windows 分类页。布局再用 `url()->current()` 为每个副本生成 canonical。
建立唯一 URL 生成方法和受控别名表。正式分类路径要么统一平级，要么统一真实父子路径；本项目导航已经使用 `/client/windows`，因此建议沿用该层级，并将真正已使用的平级旧入口映射过去。错误任意前缀返回 404。主页与 freenode 根据 D02 选择，避免循环跳转。不要为无效前缀批量建立重定向规则。
**实施范围：** 路由、Web 控制器、URL 生成方法、布局及后续调用方。
**验收：** `/wrong/windows`、`/wrong/freenode` 为 404；已认可别名一跳到唯一 200 目标；所有内链与 canonical 一致；跟踪参数不产生新主地址；必要分页参数在跳转后仍指向对应内容。旧文章 `/a/...html` 保持稳定。
### SEO-005 修复分页发现与滚动加载
**优先级：P0。证据：E02–E04。** 当前每页 2 条，78 篇节点文章形成 39 页；HTML 中没有下一页链接。直接进入第 2 页再加载，当前浏览器已复现重复内容。
保留滚动加载作为交互增强，同时服务端输出普通的下一页、上一页及适当的分页导航。第 N 页必须可独立打开，canonical 保留正确页码。JS 从当前页或服务端下一页链接初始化，最后一页明确停止；验证置顶和相同创建时间下的排序稳定性，必要时追加 id 排序。数据不断新增时也要定义跨页重复的容忍或去重规则。
每页条数建议先以 **10–20 条作为项目试验区间**，结合页面重量和可读性决定；这不是搜索引擎规定的数值。可以保持现有卡片视觉样式。
**实施范围：** 文章查询、列表模板、分页组件、滚动 JS。
**验收：** 无 JS 时可从首页沿链接到达所有应公开浏览的记录；第 2 页继续加载取得第 3 页；末页停止；刷新与后退后内容页码一致；所有有效分页自指 canonical。
Google 明确建议顺序可抓取链接、独立分页 URL 和分页自身 canonical；同一分页序列允许使用相同标题与简介，不必为此制造不同文案。[Google 分页指南](https://developers.google.com/search/docs/specialty/ecommerce/pagination-and-incremental-page-loading)
### SEO-006 协调 robots、参数和 noindex
**优先级：P0。证据：E02。** `Disallow: /*?*` 同时拦住有效分页和跟踪参数。只改 canonical 或只加分页按钮都会留下规则冲突。
按参数语义制定策略：合法 page 可抓取；跟踪参数归一；不需要搜索曝光的站内搜索及低价值集合用 noindex。保留真实私有／非内容路径的抓取限制，但不能把 robots 当认证。`/storage/` 是否可屏蔽，应先核实是否承载公开文章图片；当前外部资源主机的 robots 需要在部署阶段分别核实。
**实施范围：** RobotsController、页面索引策略、参数规范化。
**验收：** 测试 `?page=2`、`?page=2&utm_source=x`、搜索地址、静态 CSS/JS/图片和非内容接口；确认 crawler 能读取需要生效的 noindex，且关键渲染资产不被误封。与 SEO-005 同一批验收，不留下临时相互冲突状态。
### SEO-007 修复无效分页、空结果与错误状态
**优先级：P0。证据：E05。** 当前超出末页仍给出“没有任何东西”的 200 页面，容易形成低信息量 URL 和 soft 404 风险；是否已被 Google 判为 soft 404 未知。
明确：超界页码应返回 404；非法数字格式使用严格校验；`page=1` 可规范跳转至第一页。合法的站内搜索无结果应保持正常搜索语义和 noindex，而非一律 404。分类真的为空时，依据其是否提供独立介绍决定保留有价值的 200 页还是停止公开。服务故障不能伪装成成功空列表。
**验收：** `page=0/-1/abc/极大值` 有确定行为；正常末页仍 200；下一页明确结束；三个不存在对象继续 404；错误模板不包含会误导搜索引擎的正文 canonical。临时维护采用合适的 503，而非把维护提示返回 200。[Google HTTP 状态说明](https://developers.google.com/crawling/docs/troubleshooting/http-status-codes)
### SEO-008 统一公开可见性与发布时间判断
**优先级：P0，公开发布前。证据：E09。** 分类列表没有筛选 `iStatus=1`；标签筛选文章状态但未完整检查分类；详情也未排除不可公开分类。当前样本没有草稿，不应报告成已发生泄露。
建立统一公开查询条件：文章已发布、达到公开时间、所属分类及必要父分类可见。详情、分类、标签、搜索、推荐、sitemap 都复用。索引资格在公开资格之上计算；noindex 内容仍可在业务允许的公开列表中浏览，不要误当隐藏。
**实施范围：** 文章查询 scope／策略、搜索索引筛选、推荐集合。
**验收：** 在独立测试数据库放置发布、草稿、未来文章、隐藏子分类、隐藏父分类五类数据；逐个入口验证。不能通过向当前线上导入库插入测试草稿来验收。
### SEO-009 修复面包屑和全站内链地址
**优先级：P1。证据：E08。** 文章中的 `href="client"`、`href="windows"` 解析为 `/a/client`、`/a/windows`；文章卡片分类地址又与导航的层级地址不同。
面包屑、卡片分类、导航、标签与推荐链接统一调用 SEO-004 的生成方法，使用可解析的根路径或完整绝对 URL。保留清楚的锚文本；修正 `rel"rag"` 的 HTML 拼写，避免把它当成具有 SEO 含义的属性。手机端如继续隐藏视觉面包屑，正文内仍应有可用的所属主题入口。
**验收：** 从文章页、分页、标签页打开所有内部导航不再产生 `/a/分类` 或未经认可的父路径；链接不经多跳；锚文本与目标内容一致。后续 BreadcrumbList 使用同一份面包屑数据。
### SEO-010 分类、标签、搜索的标题与语义层级
**优先级：P1。证据：E06。** 不同类型页面共用站级标题，分类名称和标签主题没有进入页面元信息；Windows 的 H1 用 slug 和当前页数量拼成 `windows1`。
建立页面类型模板，同时允许关键页面人工覆盖。建议示意：
| 页面 | 标题示例，品牌待 D01 确定 | H1 内容 |
| --- | --- | --- |
| 稳定节点入口 | 当前免费节点与订阅使用说明 · 品牌 | 当前免费节点与使用说明 |
| 客户端父分类 | 代理客户端选择与使用指南 · 品牌 | 客户端选择与使用指南 |
| Windows 分类 | Windows 代理客户端与安装指南 · 品牌 | Windows 客户端 |
| 有价值的标签专题 | Clash 使用与订阅排错 · 品牌 | Clash 使用与订阅排错 |
| 搜索 | “Clash”的站内搜索结果 · 品牌 | 搜索结果：Clash |
| 文章 | 准确的文章主题 · 品牌，按需加入有意义的分类 | 文章主题 |
这些示例是方向，不应在内容尚未具备时直接承诺有完整指南。列表卡片的 `.h5` 类不会自动形成标题语义，可以在保留样式的同时使用合理的 H2/H3。每页推荐一个主要 H1；不把 H1 数量当机械排名公式，也不为不同日期堆砌同一串软件名称。
**验收：** 首页、每个分类、标签和搜索各自反映主题；HTML 标题正确转义；页面可见主标题和标题标签一致；没有空标题、调试计数或 slug 代替正式名称。Google 会自行生成展示标题，不能保证逐字采用。[Google 标题说明](https://developers.google.com/search/docs/appearance/title-link)
### SEO-011 生成真实、干净的页面简介
**优先级：P1。证据：E07。** 页面简介和展示副标题应分开：展示文本可以包含强调样式，meta description 应为清洗后的纯文本。当前 78 篇副标题带 HTML，直接进入 description。
移除无条件“今天”前缀；按页面主题生成自然摘要，解码实体、去标签、规范空白、正确转义。重要文章允许编辑覆盖，其他页面采用可靠的内容摘要。正文资源数为零或未知时，简介不能继续暗示已提供一批可用资源。搜索页可显示搜索词和结果范围，但仍 noindex。
**验收：** 抽查新旧资源、教程、分类和含引号／实体的内容；简介不含 `<b>`、换行碎片或错误日期，与实际内容一致。Google 可能改用正文片段，且没有保证展示完整内容的固定字符上限；不以“必须 160 字符”等规则作为硬验收。[Google 摘要说明](https://developers.google.com/search/docs/appearance/snippet)
### SEO-012 分离真实内容日期并统一时间基准
**优先级：P1。证据：E07、E14。** 当前更新时间混有点赞和分类关联变化；公共模板把当天日期加到老文章摘要；可见相对日期和 sitemap 日期也没有统一的编辑语义。
区分首次公开、实质内容更新、最近资源验证和互动变化。先核对导入历史时间的真实时区语义，再确定存储、应用、数据库及展示约定；不能直接把所有历史时间统一加减八小时。索引截止时间应由应用计算后传入查询，或确保数据库与应用同一时基，避免 PHP `now()` 和 SQL `NOW()` 使用不同基准。建议以不可变日期对象计算到期时间。
**实施范围：** 日期字段／服务、详情与列表 `<time datetime>`、sitemap、后续 schema。旧数据没有可靠编辑时间时可保留未知或暂不输出 lastmod，不伪造。
**验收：** 用户点赞不改变内容修改日期；实质编辑后可见日期、schema 和 sitemap 一致；新建、导入、跨日、到期边界和夏令时／时区转换有可复现测试。当前样本 sitemap 与 noindex 恰好一致，不能因此忽略八小时时基差异的边界风险。[Google 日期说明](https://developers.google.com/search/docs/appearance/publication-dates)
### SEO-013 统一 sitemap 的集合和 lastmod
**优先级：P1。证据：E10、E14。** 目前 XML 可解析，且本次 20 个地址均与当前文章索引声明匹配；缺口是有价值的分类页未列入，以及 lastmod 语义不可靠。
从统一公开与索引策略生成 sitemap，只包含规范、200、可索引的内容 URL。加入确定要培养的分类和标签专题，排除搜索、别名、过期 noindex、草稿及错误页。lastmod 只在可证明的实质变化后更新；必要时暂不输出。167 篇规模不必急着拆多级 sitemap，达到数量或管理需求再扩展。
**验收：** XML 解析、URL 编码、正式 host、状态、canonical、robots、noindex 做交叉校验；新增／撤稿／到期后集合及时变化；集合差异有可解释原因。Google 忽略 priority 与 changefreq，不应将调大这些数字作为优化工作。[Google sitemap 指南](https://developers.google.com/search/docs/crawling-indexing/sitemaps/build-sitemap)
### SEO-014 建立长期内链和内容导航
**优先级：P1。证据：E03。** 当前资源发现主要依赖列表首屏和“点赞活跃”；动态热门榜并不保证重要教程或可索引资源长期获得入口。
先修复分页，再给重要教程、平台分类及稳定资源页设置持久入口。文章结尾优先提供真正相关的“下一步”：导入订阅、选择客户端、连接失败排查，避免只推荐同一天的相似文章。资源归档应按有用的时间或主题导航，不要为每一天、每个软件、每个地区组合自动扩张空薄页面。
**验收：** 从首页的实际 `<a href>` 图可到达全部计划索引页面；关键长期页面以项目目标控制在约 3 次点击内，较深历史归档通过顺序分页可达。此深度是维护目标而非 Google 强制阈值。允许索引页面没有仅靠 sitemap 存在的孤立记录。[Google 链接建议](https://developers.google.com/search/docs/crawling-indexing/links-crawlable)
### SEO-015 整理标签与重复主题页
**优先级：P1。** 当前 25 个标签全部有文章，但“有文章”并不等于值得成为独立搜索落地页。例如“免费苹果账号”“小火箭”“shadowrocket id”“小火箭账号”等各有 82 篇记录；需要比较真实文章集合与意图，不能只按名称合并。
将标签分为有独立主题的编辑专题、站内浏览标签、应合并的同义标签。有价值的专题应有清楚简介和精选内容；仅重复列出相同文章的浏览标签可 noindex。对已有流量／外链的标签保留映射。标签后缀随机并不构成必须迁移的 SEO 问题。
**验收：** 有一份标签去留决策，记录合并理由和目标地址；站内浏览功能可用；规范化、索引规则与 sitemap 一致；不自动生成大量“客户端 × 日期 × 地区”的近似专题。
### SEO-016 隔离并同步本站搜索索引
**优先级：P1。证据：E13。** 本轮已核实 Meilisearch 可用，问题并非“服务一定没启动”：索引含 40 条文档，Clash 命中 7 条，但这些 ID 不存在于本库。当前 `Articles::searchableAs()` 固定返回 `articles`，只改数据库名称或仅设置一个未被该方法采用的前缀，不足以保证隔离。
给 FNA_V3 分配专属索引名或专属实例，按本站公开资格导入；清理只作用于本站索引。校验排序、可过滤字段、同步时机以及更新／撤稿／分类隐藏后索引变化。索引命中应结合当前数据库权限重新确认。搜索入口应有服务端 GET 表单处理；目前无 JS 时 `/?s=Clash` 仍显示首页。
**验收：** 新索引所有 ID 与本站一致；Clash 和中文节点词能返回真实匹配；无匹配、后端故障和权限变化各有正确状态；FN_B 或其他索引未变化。当前通用 `articles` 索引不得未经归属核实直接删除或重建。
### SEO-017 建立空资源与检测失败的发布门槛
**优先级：P0 内容。证据：E12。** 连续三篇最新文章显示 0 个可用节点，却仍沿用“最新高速”标题。问题并非必须禁止所有零结果页面，而是发布内容必须准确反映实际检查结果，且不能把系统故障包装成有效更新。
接收结构化的 `检查状态、检查时间、有效数量、失败原因类别、资源版本`，不要只解析标题字符串决定是否发布。明确区分：没有执行检查、检查失败、检查完成且为零、检查完成且有有效资源。失败时保留上次有效记录并标明时效，或提供真实的状态说明；不生成伪装成成功的新索引页面。对旧资源做可用性提醒，不能保证“永久高速”“全地区可用”。
**实施范围：** FNA_V3 接收端的校验和发布策略；上游 NodeHub／SubCheck 的字段或检测变更要在对应项目单独授权和验收，本计划不自动修改它们。
**验收：** 用无真实订阅的固定样例覆盖四种状态；页面标题、数量、可见说明、索引资格和 sitemap 一致。真实检查数据缺失时展示未知，不把 0 和未知混为一谈。先核实本轮零记录成因，再决定是否处理历史文章。
### SEO-018 建立稳定资源入口和日更归档策略
**优先级：P1。** 建议为“现在能用什么、如何使用”提供一个稳定且持续维护的地址，将日期快照作为支持信息。稳定入口显示最近有效结果、验证时间、适用客户端、导入说明和常见失败处理；用户不必每天重新找到另一个日期 URL。
日更页分三类处理：有独立验证记录或重要变化的可以保留索引；仅重复模板、没有新信息的保留浏览但不争取索引；已经失效且没有历史价值的按策略退出。七天窗口可以作为资源风险管理的一部分，但不应无差别决定所有内容的长期价值。180 天清理也需服从保存、合并、删除合同。
**实施范围：** 稳定资源页内容、日更模板和归档策略；尽量复用现有视觉组件。禁止把所有历史日期页统一跳转到今天而忽略是否等价。
**验收：** 稳定入口即使某天检查失败仍能如实解释状态；日更页有明确的历史身份并能返回当前资源入口；长期教程不因资源窗口到期被误关索引；历史页去留有理由和恢复记录。
### SEO-019 处理真实重复文章与跨平台内容
**实施进展（2026-10-27）：** 原重复组5的`m173`、`m174`已保留URL并分别重写为Mac与Linux桌面教程，平台安装和排错步骤不同，本地API版本1。原重复组1—4未处理；下表保留审计时的证据，不代表当前仍有五组重复。
**优先级：P1。证据：E11。** 本轮发现 5 组原始正文 HTML 完全相同，合计 13 篇：
| 重复组 | 文章 slug |
| --- | --- |
| 1 | `ssi20260922`、`ssi20260907`、`ssi20260906` |
| 2 | `ssi20260909`、`ssi20260908` |
| 3 | `ssi20260827`、`ssi20260826`、`ssi20260825`、`ssi20260824` |
| 4 | `ssi20260823`、`ssi20260822` |
| 5 | `m174`、`m173` |
重复正文不代表整个页面完全相同：标题、日期、分类等仍可能不同。`m167` 与 `m173/m174` 标题也相同，但正文并非全部逐字相同。应检查任务意图：如果是同一份跨平台说明，选一个主文，其他真正等价页面合并；若 Windows、macOS、Linux 各有独立安装、权限和排错步骤，则补成不同页面。
**验收：** 每个重复组有“保留独立／合并／历史 noindex”的理由；已认可合并使用一跳映射、更新内链和 sitemap；不能仅根据哈希自动删除。主文选择要考虑现有 URL 和后续获得的流量／外链证据，不能只认数字最小的一篇。
### SEO-020 提升客户端教程的任务完成能力
**实施状态（2026-10-27）：本地正文更新完成，设备实测及生产验收未做。** “客户端”已改为“入门教程”并保留`/client`，迁移文m167归入进阶，与DNS专题并列。原七篇旧教程全部处理，另有Windows纯入门和DNS新文，共九篇；Android分别为v2rayNG和Clash Meta，iOS聚焦Quantumult X，Mac拆为选型下载与操作，Linux按桌面发行版和终端代理单独组织。四篇最后更新均经本地API版本1发布，当前完整版本与实际关联以[写作索引](../content/WRITING.md)为准。来源、图解、目录、内链锚点、1360/390页面及栏目已核对；未做平台客户端真机联网测试、提交或生产发布。因此保持部分验收状态，不把文章页面检查写成设备操作成功。内容源、证据与回退见[教程栏目维护](TUTORIALS.md)。
**优先级：P1。** 2026-10-22审计时，7 篇客户端正文约 138–355 字，多为简短介绍和项目／下载链接。字数本身不是问题；从实际内容看，很多安装、导入和排错步骤仍需要用户到别处寻找。
逐篇按用户任务补充：支持的平台与当前核实版本、官方项目与下载来源、安装前提、订阅导入步骤、正常工作的可见验证方式、常见错误与处理、维护状态、最后核验时间和必要截图。只有确实执行过才写“实测”；未核实的软件更新状态和下载安全性应明确待核实，不能根据旧文章继续承诺兼容性。
优先完善已存在的少数教程，再考虑新增。避免为了覆盖关键词而自动生成一套只有平台名称不同的文章；也不使用目标字数或重复问答堆篇幅。
**验收：** 一位目标平台新用户可按文档完成指定任务；链接来源、版本和步骤有核验记录；每篇明确自己解决的问题；内容与标题、摘要、schema 一致。Google 对有帮助内容强调实质价值和真实经验，而不是固定篇幅。[Google 内容质量指南](https://developers.google.com/search/docs/fundamentals/creating-helpful-content)
### SEO-021 明确来源、验证和跨站内容差异
**优先级：P1。** 代码和项目关系显示文章可由上游分发。分发本身不等于垃圾内容，但如果多个站点只更换域名、日期或少量词语而重复发布，会缺乏独立价值。
记录资源来源类型、验证方法和时间、本站新增的信息。长期教程优先增加真实操作、限制条件和本地用户的具体问题；引用第三方内容时核实出处和使用许可。避免把免费资源数量、覆盖地区或速度当成未经测试的质量承诺。新站是否与原站同时提供相同完整内容，应随 D01 明确，不能默认复制站自然拥有独立排名价值。
**验收：** 每种内容模板能说明本站贡献；核心承诺能追溯到证据；发布失败不会换个日期再次生成看似新内容。Google 针对的是以操纵排名为目的、大规模产生低价值内容的行为，不能仅因自动化就认定违规，也不能声称本站已受处罚。[Google 垃圾内容政策](https://developers.google.com/search/docs/essentials/spam-policies)
### SEO-022 作者、编辑责任与真实互动数据
**优先级：P1。证据：E14、E16。** 当前作者位置显示站点名并链接首页，未见独立的作者／编辑说明入口；代码还有自动注入点赞的功能，不能将这些计数当成真实用户评价或用于评分标记。
根据实际运营情况提供关于本站、联系／反馈、编辑与验证方法、推广关系说明。可以使用真实的团队或组织身份，不必虚构专家、头像、资历或个人作者。对于非真实点赞，建议停止将其表示为真实用户反馈，或明确改为站内推荐分；最终方案作为业务决策，不在本轮擅自清空计数或停任务。
**验收：** 作者／发布者可辨认且有有效说明入口；相关主张真实；“最近更新”不由互动驱动；没有把自动点赞包装为 AggregateRating 或用户评论。关于页是信任信息的一部分，不是添加后就获得某个 E-E-A-T 分数的按钮。
### SEO-023 推广链接、广告与正文体验
**优先级：P1。证据：E17。** 新 DPL 组件已有广告标识和 sponsored，应保留。仍需核实 160 篇正文中旧 `fuuu.cloud` 链接的商业性质：属于推广／付费推荐的应正确标记；一般编辑引用无需一律 nofollow。
检查广告不会伪装成下载按钮，不遮挡主要内容，不导致布局突然移动。当前 390px 样本中首页首批文章约在 y=438px，Windows 分类第一张文章卡片约在 y=695px；这表明分类页广告加大图占用了较多首屏，但不是已确认的搜索处罚。先观察真实使用任务和性能，再决定是否在保持品牌样式下调整间距、信息密度或顺序；三款已批准广告不因这份建议自动撤掉。
**验收：** 组件广告与正文推广分开检查；需要 sponsored 的链接全部正确；主任务可识别、可完成；手机无误触和遮挡；广告尺寸预留稳定。Google 建议用 sponsored 标记广告或付费链接。[Google 外链属性说明](https://developers.google.com/search/docs/crawling-indexing/qualify-outbound-links)
### SEO-024 添加匹配真实内容的结构化数据
**优先级：P2。证据：E15。** 当前没有 JSON-LD，已有面包屑 itemprop 又缺少完整的结构。建议基础规则和日期修正后再添加：
- 首页：真实的 WebSite 名称和 URL；组织资料真实、完整时再加入 Organization。
- 正文：适合文章内容的 Article 或 BlogPosting，包含准确主题、规范 URL、真实作者／团队、相关图片、首次发布和实质更新时间。
- 内容层级：BreadcrumbList，采用与可见面包屑一致的名称和 URL。
- 普通分类可以使用语义合适的 CollectionPage／ItemList，但不把它们宣传为必然出现的 Google 富结果功能。
**验收：** JSON 可解析且正确转义；数据与用户可见内容一致；URL、日期、作者、图片能验证。Article 与 Breadcrumb 使用支持的富结果验证方式；WebSite 站点名称使用 schema 验证及后续搜索平台检查，不能要求 Rich Results Test 必须展示一个它不支持的站点名称结果。禁止虚构评分、作者或把资源页假装成新闻／商品。
这些标记能帮助理解及获得适用展示资格，但不保证富结果或排名改善。[Article](https://developers.google.com/search/docs/appearance/structured-data/article)、[Breadcrumb](https://developers.google.com/search/docs/appearance/structured-data/breadcrumb)、[站点名称](https://developers.google.com/search/docs/appearance/site-names)、[结构化数据质量规则](https://developers.google.com/search/docs/appearance/structured-data/sd-policies)
### SEO-025 修复分享地址和社交预览信息
**优先级：P2。证据：E16。** 当前文章复制按钮输出首页地址，用户分享后无法直接到达原文。通用 OG 图片为相对地址，文章 OG 图片则依赖外部资源。
复制当前文章规范链接；OG URL 与 canonical 共用生成规则；图片使用环境正确的绝对 URL，校验实际存在、类型、尺寸与内容相关性；按目标分享平台需要补充卡片字段。favicon 与公开品牌一致。不要为满足社交卡片而新增与正文无关的图片承诺。
**验收：** 从两篇不同文章复制分别得到对应 URL；带跟踪参数的访问复制后得到干净主地址；预览图片与标题正确，真实线上爬虫取图在部署阶段验证。OG 本身不是 Google 排名提升保证，但分享错误是明确的产品缺陷。
### SEO-026 图片语义、尺寸和加载方式
**优先级：P2。证据：E15。** 当前卡片封面使用 CSS background，Google 的图片发现无法按普通 img 处理；当前 HTTP 样本没有缺 alt 属性的图片，DPL 装饰性 logo 空 alt 合理。导航两个 logo 缺少 HTML 宽高，不代表已经实测产生 CLS。
有内容意义的封面使用可保持原样式的 `img/picture`，提供真实相关的 alt、尺寸和合适的响应式资源；装饰图保持空 alt。按实际 LCP 元素决定加载优先级，首屏关键图不要统一 lazy，屏外内容再延迟加载。先核实资源大小、缓存与图片用途，再决定 WebP/AVIF、srcset、预连接等；不要为未知外站盲目添加 preconnect。
**验收：** 原视觉布局保持；有意义的图片可被 HTML 发现；装饰图不过度描述；图片加载前后布局稳定；不同视口不下载明显过大的资源；404、重定向及跨域资源响应在授权的部署验收中确认。[Google 图片指南](https://developers.google.com/search/docs/appearance/google-images)
### SEO-027 手机端与无障碍完整验收
**优先级：P2。** 本轮 320px／390px 样本没有横向溢出，320px 菜单展开后位于 x=0–256，含 8 个链接；不需要无依据重做响应式布局。仍应核查完整功能，而非只看截图。
修复只有图标的菜单／搜索按钮可访问名称，验证键盘焦点、菜单开关、返回、搜索、加载更多、分享及错误提示。禁用 JS 或脚本失败时，正文、主要导航和分页仍应可用；搜索应有服务端表单后备。移动端隐藏了部分摘要、日期、侧栏和面包屑，重要解释和必要入口应在主内容中仍可找到。
**验收：** 320、390、768、1280px 代表性页面；正文不截断关键步骤；键盘可完成主要操作；字体可读；不以隐藏给搜索引擎的额外文本弥补信息缺失。Google 主要依据移动版本内容处理索引和排名。[Google 移动索引指南](https://developers.google.com/search/docs/crawling-indexing/mobile/mobile-sites-mobile-first-indexing)
### SEO-028 建立正式构建性能基线并按瓶颈优化
**优先级：P2。** 当前是 Vite dev 模式；外部图片和统计被测试浏览器阻止。这样的环境不适合宣布线上 Lighthouse 得分或 Core Web Vitals 已通过。
已确认公共 JS 引入 Bootstrap、jQuery、InfiniteScroll、Clipboard，主 JS 源码约 34KB，基础主题 CSS 源文件约 578KB，并包含滚动日志和多种旧交互逻辑。它们是检查方向，不是实际传输量或慢站结论；也不能仅因使用 jQuery 就要求重写。
后续在获准的构建验证阶段记录正式资源的压缩后体积、未使用代码、长任务、字体、LCP 资源、图片重量及 TTFB。先按可测瓶颈优化：删除无用代码、按需加载、减少滚动布局计算、合适字体策略、压缩和长期缓存静态哈希文件。数据库索引只在 EXPLAIN 或慢查询证明需要时调整；167 篇规模不预设数据库是瓶颈。
**验收：** 有同一设备／网络条件的改前改后对照，功能无回归。上线后以真实用户第 75 百分位为主要口径，目标 LCP ≤2.5s、INP ≤200ms、CLS ≤0.1；实验室结果用于定位问题，不替代真实用户分布。[Google CWV 指南](https://developers.google.com/search/docs/appearance/core-web-vitals)、[web.dev 阈值与分位定义](https://web.dev/articles/defining-core-web-vitals-thresholds)
### SEO-029 缓存与发布、撤稿、到期一致性
**优先级：P1，开启整页缓存前完成。证据：E18。** 当前整页缓存关闭，不应把默认 7 天 TTL 说成现有线上缓存故障。模型 saved/deleted 只尝试失效首页，分类、标签、详情、sitemap 及年龄变化缺少完整安排。
设计缓存键和失效范围，确保主域、路径、有效分页参数和必要响应差异被正确区分。新增文章影响列表和 sitemap；正文更新影响详情及摘要；撤稿／隐藏分类影响全部公开入口；到期即使没有数据库写入也会改变 noindex 与 sitemap。对点赞状态、会话、CSRF 等个性化内容核实整页缓存适用性。静态资源缓存和 HTML 缓存分别配置。
**验收：** 分页缓存互不串页；两个匿名会话不混淆状态；新增／撤稿／隐藏／到期后在明确时限内一致；不靠“全站清缓存”掩盖缺少失效合同；缓存关闭与开启均通过关键 SEO 用例。
### SEO-030 文章接收、更新与删除的发布合同
**优先级：P0，公开部署前。证据：E19。** 运行时路由表显示文章接收接口只挂 web 中间件，且 API 路径跳过 CSRF。接收逻辑直接设为发布并会触发资源读取、搜索同步、IndexNow 或通知。尚未确认生产是否另有边缘保护，本轮没有发送接收请求。
上线前为调用方建立明确认证、请求结构校验、允许字段、幂等标识和发布门槛；内容 HTML 采用与可信来源匹配的清洗策略，避免未知内容注入公开页面。编辑字段与上游覆盖字段分开，避免手工优化的标题／简介下一次分发就被覆盖。内容成功保存、标签同步、缓存失效、搜索更新和外部通知应有可追踪的顺序与失败恢复。
删除规则同样重要：当前批量删除不一定触发逐模型事件，不能假设缓存／搜索／推送会自动同步。无替代内容正确退出；有真正等价替代才重定向。点赞类写入也应使用合适的写请求，避免 GET 改业务状态，本轮未调用该接口。
**验收：** 未授权请求不能发布；同一消息重放不产生重复页；零资源／失败数据按策略处理；撤稿和批量清理后所有公开入口一致；外部服务失败不造成“页面显示发布成功但实际丢失”。测试使用独立数据库和外部服务替身，不触发真实推送或通知。
### SEO-031 正式主机、HTTPS 与 HTTP 服务质量
**优先级：P0，部署时。** 当前本地回环 HTTP 不是 HTTPS 问题的证据。生产上线后需要单独验证服务器、代理和 CDN 实际行为。
确定唯一主机与 HTTPS；已存在的 www／非 www、HTTP／HTTPS 别名使用明确一跳规则。框架正确识别代理协议和主机，避免生成 HTTP canonical 或错误域名。机器人不应遭遇无必要的登录、验证码、WAF 挑战或长期 5xx；同时不靠伪造 User-Agent 放宽安全策略。页面、XML、robots、静态资源返回合适状态及 MIME 类型，错误页和维护页不返回成功正文。
**验收：** 使用获准服务器侧链路检查正式 host、重定向链、robots、sitemap、文章和资产；记录证书、HTTP 状态及代理识别结果。完整线上页面交互若需要，仍按项目网站访问规则执行。本地通过不能代替此项。
### SEO-032 本地、预发布和生产资源隔离
**优先级：P0，公开部署前。** 独立数据库不代表所有资源已隔离。当前副本保留原站配置与 Git 元数据，搜索索引名称固定，布局按 cfn 加载线上 Umami 脚本，还存在共享资源链接。
为各环境核对：数据库、搜索索引、缓存命名、会话、统计站点 ID、图片依赖、外部通知、IndexNow、后台任务、公开品牌、主域、站点验证文件及 Git 远端。非生产环境默认不向真实搜索平台提交 URL，不向生产统计混入测试访问。公开预发布优先访问控制并配合 noindex；单独 robots 禁抓取不是可靠的防收录方案。当前 127.0.0.1 仅本机可达，不应因此判断已被公开索引。
**验收：** 本地业务测试不会写入 FN_B 数据或索引，不会触发外部通知与生产统计；生产部署不带 dev hot 标记、调试输出、私密配置或本地 URL；站点验证文件匹配实际站点所有权；发布前已核实 Git 推送目标，避免把副本改动推回源项目。
### SEO-033 规范 IndexNow 及搜索提交
**优先级：P2。** 当前发布接收逻辑会调用 IndexNow，服务先 GET 检查 URL，只接受成功响应。这能避免部分无效新增，却不能完整表达删除通知；200 页面也可能是 noindex 或错误副本。
按正式环境、规范 URL、内容状态和变更类型决定是否提交；支持新增、实质更新和删除各自的处理。避免推送本地地址、预发布地址、未发布或无价值的失败快照；主域与 keyLocation 必须属于当前站点。提交过程要能失败重试、去重并记录状态，不能把接口接收成功等同收录成功。
**验收：** 本地使用替身验证，不实际发送；正式获准后单条核验目标主机、验证文件和返回结果；删除事件不因目标已 404 而被本地逻辑永远过滤掉。IndexNow 表示通知采用该协议的搜索引擎，不能当成 Google 通用收录接口。Google Indexing API 仅支持其指定的招聘及直播事件页面，不适用于普通节点文章。[IndexNow 协议](https://www.indexnow.org/documentation)、[Google Indexing API 适用范围](https://developers.google.com/search/apis/indexing-api/v3/using-api)
### SEO-034 SEO 自动回归与数据样例
**优先级：P1，随每批实现。** 当前仓库测试只有首页 200 示例和恒真示例，不能防止 URL、索引和发布规则回退。本轮未执行这些与审计目标无关的示例测试，也没有新增业务测试或修改代码。
未来围绕外部行为建立测试：规范地址与别名、合法分页和越界、状态与索引资格、日期边界、sitemap 集合、公开入口、结构化数据转义、资源失败和撤稿一致性。使用固定时钟、隔离数据库和外部服务替身。避免只照抄内部实现断言，或把当前 167 篇和日期写死。
**验收：** 变更相应行为会让测试真正失败；每个已完成项目对应验收证据；本地浏览器补验 JS 和无 JS 路径；核心样式、三种广告和正常 API 合同没有无关回归。测试通过、页面验收、上线和真实搜索效果分别记录。
### SEO-035 搜索平台与业务效果监测
**优先级：P1，上线后。** 本轮没有生产搜索数据，不能确认哪些页面已经收录、用户通过哪些查询进入、Google 选择了哪个 canonical，也不能证明某项缺陷已造成多少损失。
获准后配置或核实实际站点的 Search Console；按目标渠道需要补 Bing 等平台。记录 sitemap 处理、页面索引原因、选定 canonical、查询与页面表现、地区／设备、人工处置及安全问题。服务器日志用于区分真实机器人抓取和普通流量；访客分析用于衡量实际使用，不记录订阅密钥、账号或敏感正文。
**验收：** 有可回溯的发布前基线或新站起始基线；页面类型与业务目标能分组分析；出现错误有明确负责人和处理方式。监测频率和通知自动化另行授权，本报告不创建定时任务。[Search Console 能提供的数据](https://developers.google.com/search/docs/monitor-debug/search-console-start)
### SEO-036 发布、迁移、回滚与复核
**优先级：P0，实际发布时。** 如果 FNA_V3 替换原站，应尽量保留已有有效 URL；如果成为独立新站，应按新站处理品牌与内容差异，不能默认沿用旧站身份及所有权验证。
发布前保存代码、数据和相关配置恢复点；确认 Git 远端，提交并推送本任务范围，再让目标服务器更新到明确提交。对确需改动的 URL 建立逐条映射，避免批量跳首页、循环和链式跳转。按批次发布规则改动，保留对比和回滚依据；不要同时更换域名、技术栈、URL、内容和视觉而失去定位能力。
**验收：** 代码、数据库、配置和链接映射均有恢复办法；发布后完成授权范围内服务器侧检查；迁移前后有效页面数与 URL 集合差异可解释；真实页面验证按访问规则记录。若跨域迁移，采用当前搜索平台认可流程，持续保留必要的旧地址映射。[Google 迁移指南](https://developers.google.com/search/docs/crawling-indexing/site-move-with-url-changes)
## 7 建议实施顺序与批次交付
编号是稳定引用，不表示必须机械按数字逐个开发。以下批次避免先加展示功能、后反复改底层规则。
| 批次 | 范围 | 本批应交付的可检查结果 | 进入下一批的条件 |
| --- | --- | --- | --- |
| A 方向与合同 | 001–003，明确 D02–D05；启动 034 的测试方案 | 品牌／上线角色、页面类型、URL 与索引矩阵；确认历史内容处理原则 | 关键策略明确，仍未知的生产域名可延后到发布前 |
| B 地址与发现路径 | 004–009、014 的基础内链；配套 034 | 唯一 URL、合法分页、错误状态、robots 协调、统一公开查询、正确面包屑 | 无 JS 可遍历；分页、别名、状态和索引矩阵一致 |
| C 页面信息与索引集合 | 010–013、015、016；配套 034 | 区分主题的标题／简介，真实日期，统一 sitemap，独立且正确的搜索索引 | 样本与全量机器检查通过；没有污染其他项目索引 |
| D 内容价值与发布质量 | 017–023，以及 030 的质量门槛 | 零结果／失败处理、稳定资源入口、重复内容决策、可完成任务的教程、真实来源和推广说明 | 内容承诺可证明；每日自动发布不会撤销人工优化 |
| E 展示与体验 | 024–028，以及 029 的缓存设计 | 合适的结构化数据、正确分享、图片加载、手机功能和构建性能对比 | 功能、视觉与性能有证据，非只看审计工具分数 |
| F 上线准备 | 029–033、036，补齐 034 | 环境隔离、发布认证、主域与 HTTPS、缓存一致性、迁移和回滚方案 | 所有 P0 发布条件满足，获得实际发布授权 |
| G 线上观察 | 035；按结果回到内容与性能项目 | 抓取、索引、点击及使用完成的对照记录 | 按真实数据持续迭代，不保证固定天数见效 |
SEO-017 的问题会影响当前内容承诺，可在批次 A 确认政策后尽早处理，不必等待所有标题优化完成。SEO-030、032 在任何对外暴露或真实导入测试之前先完成必要隔离。批次之间可以独立验收；本地实现完成不自动授权部署。
### 单项完成记录格式
以后在对应项目末尾增加短记录，保留最初问题与最新状态，避免把建议列表误读成已经实施。
```text
项目编号：SEO-xxx
状态：待决策／待实施／进行中／本地验收通过／已发布／观察中／已关闭
实际范围：
关键取舍：
验证证据：
样式和数据影响：
提交及发布状态：
剩余问题或下一步：
```
“本地验收通过”必须包含本地证据；“已发布”必须有明确环境与提交；“已关闭”指该项目约定目标达成，不代表整站 SEO 达到某个永久最高分。
## 8 验收矩阵与完成标准
### 8.1 最小功能和索引样例
| 编号 | 验收场景 | 核心检查 |
| --- | --- | --- |
| T01 | 首页和认可的免费节点别名 | 唯一主 URL；别名一跳；标题与职能一致 |
| T02 | 正确／错误父分类路径 | 正确 200，错误 404；导航不产生错误路径 |
| T03 | 第 1、2、中间、最后一页 | 内容不同且顺序稳定；分页 href；正确自指 canonical |
| T04 | 页码 0、负数、字符串、超界、重复参数 | 明确规范化或 404；没有空薄的任意 200 页面 |
| T05 | 分页叠加跟踪参数 | 保留页码，去掉非内容参数；robots 允许必要抓取 |
| T06 | 当前文章、过期历史文章、永久教程 | 公开状态与 index/noindex 符合内容合同 |
| T07 | 草稿、未来文章、隐藏分类及父分类 | 在详情、列表、标签、搜索、推荐、sitemap 中一致 |
| T08 | 索引到期临界时刻 | 固定时钟下详情和 sitemap 同步切换，不受八小时差异影响 |
| T09 | 更新正文与仅点赞 | 仅前者改变内容修改日期；schema／sitemap／页面一致 |
| T10 | 资源成功、真零、未知、检查失败 | 标题、状态说明、资源数和索引政策一致 |
| T11 | 有搜索结果、无结果、服务故障 | 结果来自本库；无结果正常 noindex；故障不伪装无结果 |
| T12 | 已合并、已删除、从未存在的文章 | 映射与 HTTP 状态正确；搜索和 sitemap 不残留 |
| T13 | 有引号、实体、长文本的标题与简介 | HTML／JSON 正确转义，简介纯文本，无虚假日期 |
| T14 | 一篇普通教程、一篇资源页、一页分类 | 按内容类型选择结构化数据，字段与正文一致 |
| T15 | 无 JS、JS 失败、直接进入分页后滚动 | 主内容可读；分页可走；不重复加载当前页 |
| T16 | 手机与桌面 | 主要内容和必要入口可用，菜单／搜索／分享可操作 |
| T17 | 缓存关闭与开启 | 不串页、不串会话；新增、撤稿、隐藏、到期及时一致 |
| T18 | 本地、预发布、生产环境 | URL、统计、搜索、缓存、外部发送和验证文件隔离 |
| T19 | 接收接口拒绝与幂等 | 未授权不能发布；重放不产生重复；失败可恢复 |
| T20 | 发布前后全量 URL 集合 | 200／301／404／noindex 变化有清单，关键旧链接可恢复 |
### 8.2 技术完成标准
- 所有计划索引的页面均有可访问的规范 URL，返回有效 200，未被 robots、错误 noindex 或错误 canonical 排除。
- 别名、分页、参数、内链、sitemap、OG 和推送使用同一套 URL 与资格规则。
- 所有计划索引的页面能从公开 HTML 内链到达；不存在只靠滚动事件才能发现的必要下一页。
- 不能公开的对象在所有入口一致隐藏；合法无结果与运行故障被区别处理。
- 标题、简介和日期真实，重要主题彼此可区分；schema 与正文一致。
- 内容发布能验证资源状态、处理失败、保护人工编辑，并完整同步缓存、搜索与索引集合。
- 网站原有功能和已批准视觉方案无无关回退；构建和线上检查分开记录。
这些标准可由工程验收保证；实际收录率、展示形式和排名需要搜索引擎处理，不能作为“代码测试通过”的同义词。
## 9 上线后的效果判断
### 9.1 指标应分层
| 层次 | 应观察什么 | 如何解读 |
| --- | --- | --- |
| 技术健康 | 有效 URL、错误重定向、意外 noindex、sitemap 冲突、5xx | 先排除明显工程回退 |
| 发现和索引 | 抓取记录、索引原因、Google 选择 canonical、计划索引页面的状态 | 不要求每个无价值归档都进入索引；分母是计划索引集合 |
| 搜索表现 | 按主题／页面类型的曝光、点击、CTR、查询和地区／设备 | 同类页面比较；平均排名和 CTR 受查询组合影响 |
| 内容贡献 | 长期教程自然流量、稳定资源页回访、相关下一步使用 | 关注持续价值，不只看每日新页面数量 |
| 实际任务 | 订阅使用入口、教程完成反馈、搜索成功率、故障反馈 | 事件仅记录必要状态，不收集订阅秘密或共享账号正文 |
| 体验 | 真实用户 CWV、失败率、手机交互和资源加载 | 实验室改善不等于真实用户已全面改善 |
### 9.2 建议观察窗口
- **发布当天：** 验证服务、URL、索引规则、主要页面及外部发送配置，没有重大回退。
- **首周：** 观察新 URL 的发现、sitemap 处理、异常状态、搜索和关键功能；不足以据此宣布排名稳定。
- **后续 2–4 周：** 对照页面组观察收录原因、查询与点击变化，结合抓取情况判断是否需调整。
- **后续 4–8 周及更长：** 评估长期内容、稳定入口和归档策略；新站、低抓取频率或迁移可能需要更长时间。
这些是建议的复核节奏，不是收录时限或增长保证。比较相似星期和页面组，标记节假日、内容更新与其他外部变化；不要一次搜索、一次 Lighthouse 分数或一次流量波动就反转策略。
## 10 暂不优先做的工作
1. **不因 SEO 全面更换框架。** 当前首次 HTML 已有内容，先修路由、分页和质量规则。
2. **不把关键词 meta、固定字数、标题字符数当主要目标。** 对 Google，meta keywords 不影响索引和排名；标题和摘要应清楚且符合实际内容。[Google 支持的 meta 标签](https://developers.google.com/search/docs/crawling-indexing/special-tags)
3. **不把所有分页 canonical 指向第一页，也不默认全部分页 noindex。** 它们展示不同文章，应按真实内容处理。
4. **不把所有旧页面跳首页。** 只有内容等价或真正迁移时采用对应重定向。
5. **不把全部标签和全部历史文章一次性开放索引。** 先判断独立意图、质量和保留价值。
6. **不通过每日刷新日期、生成空薄文章、虚构作者或点赞制造“新鲜”和“权威”。** 应改善真实内容和发布流程。
7. **不为凑富结果给所有页面添加 FAQ、评分、商品或新闻标记。** 页面类型和真实内容必须适合；有效 schema 也不保证展示。
8. **不在没有需要时建设多语言、AMP、庞大 sitemap 分片或独立抓取预算系统。** 当前规模与问题不支持优先投入。
9. **不将 dev 模式跑出的分数当线上 SEO 成绩。** 正式构建、外部资源和真实访客条件不同。
10. **不为 Google AI 搜索另造一套“专用 SEO”。** 官方仍要求可发现、可索引、有价值的内容，并没有额外必需的专用标记；应优先完成本清单基础项。[Google AI 搜索功能说明](https://developers.google.com/search/docs/appearance/ai-features)
## 11 证据入口与复核方法
### 11.1 主要代码入口
以下行号是 2026-10-22 本轮基准，后续修改可能变化；路径链接是持续入口。
| 检查内容 | 文件及本轮关键位置 |
| --- | --- |
| 页面路由、宽松分类与接收接口 | [routes/web.php](../../routes/web.php)，首页／分类和 api/article 路由 |
| 分类解析 | [Web ArticlesController](../../app/Http/Controllers/Web/ArticlesController.php)，50–54 行 |
| 列表、搜索、标签、详情查询 | [ArticlesService](../../app/Services/ArticlesService.php)，146–280 行 |
| 全局标题、日期、canonical、OG、统计 | [app-layout](../../resources/views/components/app-layout.blade.php)，1–52 行 |
| 列表标题和缺少分页链接 | [列表模板](../../resources/views/pages/articles/default/index.blade.php)，1–68 行 |
| noindex、面包屑、日期、分享 | [详情模板](../../resources/views/pages/articles/default/show.blade.php)，1–4、24–62、95–103 行 |
| 卡片语义、封面和分类链接 | [article-item](../../resources/views/components/article-item.blade.php)，3–25 行 |
| 搜索表单与导航 | [nav-bar](../../resources/views/components/nav-bar.blade.php)，27–46、105–113 行 |
| 滚动页码和搜索 JS | [app.js](../../resources/js/app.js)，47–76、140–148 行 |
| robots | [RobotsController](../../app/Http/Controllers/RobotsController.php)，11–19 行 |
| sitemap 集合及时间 | [SitemapController](../../app/Http/Controllers/SitemapController.php)，12–25 行；[XML 模板](../../resources/views/sitemap.blade.php)，11–16 行 |
| 搜索索引、日期、缓存事件 | [Articles 模型](../../app/Models/Articles.php)，52–76、84–113 行 |
| 分类关联和状态 | [Categories 模型](../../app/Models/Categories.php)，20、46–52 行 |
| 点赞与内容时间耦合 | [SyncArticleLikes](../../app/Console/Commands/SyncArticleLikes.php)，21–55、72–80 行 |
| 180 天删除及调度定义 | [ClearDb](../../app/Console/Commands/ClearDb.php)，26–37 行；[调度入口](../../routes/console.php) |
| 发布与上游数据覆盖 | [API ArticlesController](../../app/Http/Controllers/Api/v1/ArticlesController.php)，35–90、96–239 行 |
| 外部搜索通知 | [IndexNowService](../../app/Services/IndexNowService.php)，25–170、182–220 行 |
| 中间件与 CSRF 排除 | [bootstrap/app.php](../../bootstrap/app.php)，14–25 行 |
| 新广告范围和保留要求 | [广告维护说明](ADVERTISING.md)及[广告组件](../../resources/views/components/dpl-article-ad.blade.php) |
### 11.2 本轮证据保存
[审计基线数据](SEO_BASELINE_2026-10-22.json)仅保存脱敏后的计数、代表性本地响应、内容重复组、搜索匹配计数和相关源码哈希，便于以后对照。本文件承载解释与任务状态，JSON 不另行维护一份优化计划。
临时细节与受限浏览器截图位于 `/private/tmp/fna-v3-seo-20261022/`。临时目录可能被清理，不作为后续唯一证据；正文中的关键事实和项目内基线已经固化。没有把数据库导出、账号信息、凭据、订阅内容或完整文章正文写入本次文档产物。
复核时按以下方法重新取得现场证据：
1. 读取当前项目资料、并行修改和服务状态，再记录待检查源码哈希。
2. 以本地只读数据库事务统计文章／分类／标签，记录应用和数据库时基。
3. 限定回环地址，不跟随外部重定向，不自动点击／请求点赞、API 或测试路由。
4. 检查首页、真实分类路径、标签、全部文章、分页边界、robots 与 sitemap；解析标题、canonical、robots 和实际 href。
5. 链接图从首页开始，沿实际 HTML 链接计算，不把手工塞入的文章地址冒充站内发现。
6. 浏览器拦截全部非本地网络和有副作用请求，分别测试有 JS、无 JS、直接进入分页及手机宽度。对被拦截的线上图片不判断其真实可用性。
7. 核实源码和业务数据差异，更新该基线或创建下一次有日期的证据快照；优化决策继续更新本文件。
### 11.3 本轮交付状态
- 已完成独立重新分析、230 个本地地址检查、当前数据库统计、搜索索引对照和受限浏览器复核。
- 已完成本建议文档与基线保存；清单项目尚未实施。
- 交付核对通过：36 个项目编号与总表一一对应，20 个验收场景，文内本地链接有效；195 个网站源码、资源及环境基准文件哈希未变化，文章／分类／标签已采集业务字段前后相同。GemDocs 离线文档检查通过。
- 网站源码、样式和本地私密环境配置保持本轮基准；未改业务数据，未执行调度器、队列、发布接收或外部推送。
- 为检查恢复了原本停止的本地 PHP 8103 与 Vite 5173 开发预览。框架正常请求产生的会话／缓存及 Vite 运行产物不属于业务优化修改。
- 未提交、推送、部署；未访问项目线上网站，未验收线上收录、排名或真实用户性能。
## 首页展示调整（2026-10-27）
按用户更正后的要求，`/`直接复用文章详情展示日期最新的一篇已发布免费节点文章，不限定当天。通过分类slug筛选，按created_at、id倒序选择，忽略置顶排序并排除未来时间；`/freenode`继续保留历史列表。首页绕过整页响应缓存，新的文章发布后下一次访问即可选取；未改全局时区、业务数据或其他栏目查询。无可用文章时使用现有空态。
验证：3项独立SQLite内存库测试、6项断言通过，覆盖旧日期文章、置顶、其他栏目、草稿、未来文章、同日期排序、空池和缓存边界。本地首页与免费节点列表HTTP 200，首页最新正文为fn20261021。未提交、推送或部署；首页与文章详情的canonical及noindex继承行为仍需在SEO-004/018中单独处理。
### 首页独立索引规则（2026-10-28）
按用户要求修复首页继承过期文章noindex：详情模板以articles.home路由识别首页，首页固定index, follow；其他文章详情继续按分类过期规则，编辑签名预览仍优先noindex, nofollow。日期计算使用created_at副本，避免渲染过程中修改模型日期。实测首页、fn20261021详情、freenode栏目均200，分别index/noindex/index；首页无额外X-Robots-Tag。仅本地，未提交/推送/部署；canonical规则与生产配置不属于此次已完成范围。

184
docs/maintenance/TUTORIALS.md Normal file
View File

@ -0,0 +1,184 @@
# 教程栏目与内容维护
状态：2026-10-27 本地内容更新；未提交、推送或发布。当前任务由“先重写一篇客户端文章”扩展为栏目改名及加入此前 DNS 进阶文章；随后按用户要求完成Android、iOS、Mac和Linux旧教程重写；当前文章与版本以写作索引为准。
## 栏目与文章入口
| 对象 | 本地数据库身份 | URL | 本次状态 |
| --- | --- | --- | --- |
| 入门教程 | categories.id=2，原客户端 | `/client` | 仅更名和更新简介，原平台子分类及 URL 保留 |
| 综合教程 | categories.id=10，根分类，排序1 | `/advanced` | 原进阶教程更名，地址和文章归属保留；无资源文章的时效 noindex 策略 |
文章标题、ID、稳定URL、源文件和正文关联统一维护在[AI写作与文章关联索引](../content/WRITING.md)，本页只保留实现、验收与回退资料。
本地预览根为 `http://fna-v3.loc`。分类名称由数据库驱动，桌面和移动菜单共用 `global_nav_tree` 文件缓存；本次仅清除此键。没有改栏目路由、已有平台名或文章分发入口。
## 当前发布方式
2026-10-27起普通编辑文章使用[本站独立文章API](EDITORIAL_API.md)，不经过ATOM；本文下方源文件/HTML/数据库的说明保留当前素材及历史实施证据，新稿由API完成渲染、版本和公开正文同步，不再以临时SQL脚本发布。Windows入门文章362已在免费订阅文案修正时显式接管为`verge-windows-start`，本地已发布API版本1；迁移和DNS两篇随后在移除顶部重复信息时通过API显式绑定原ID；当前版本以写作索引为准。
## 正文与排版
- 可编辑正文源：`docs/content/tutorials/windows.md`（纯入门）、`migration.md`（原迁移文章）、`dns.md`、`v2rayng-android.md`、`clash-meta-android.md`。
- 同目录 HTML 为 CommonMark 生成结果，实际运行正文存于本地数据库。改 Markdown 后需要重新渲染和定点更新数据库，不能把仅修改源文件当成页面已变。
- 当前文章模板对正文执行 `nl2br`。入库前先把 `<pre>` 内换行编码成 `&#10;`，其余 HTML 换行去除；避免代码块重复换行或样式结构损坏。
- 公共教程样式：`public/css/tutorials.css`，限定 `.tutorial-body` / `.tutorial-category`；未改站点全局样式或广告。
- 技术封面：`public/images/tutorials/windows-cover.svg`、`migration-cover.svg`、`dns-cover.svg`，为文字与路径图，不涉及既有 CFN 品牌插画池。
- Windows 导入示例：`public/images/tutorials/verge-import.png`。来源为 Clash Verge Rev 官方快速入门 https://www.clashverge.dev/guide/quickstart.html ，原图 https://www.clashverge.dev/assets/guide/quickstart/verge_import.png 。图片旁保留来源及“界面可能与当前版本不同”，未声称是 v2.5.8 Windows 实机截图。
- 入门教程第二张操作图：`public/images/tutorials/verge-system-proxy.png`，来自官方 quickstart 的 `https://www.clashverge.dev/assets/guide/quickstart/verge_enable_sysproxy.png`，图注保留来源与版本边界。
- 列表模板仅为 `/client` 和 `/advanced` 增加栏目标题、简介和页面title/description。文章模板修正了原本相对路径的分类面包屑为站点绝对 URL。
## 内容核验与边界
2026-10-27 核对官方安装/发行资料，Clash Verge Rev 最新发行页指向 v2.5.8（2026-10-09）。文章对照官方 quickstart、profile、Windows FAQ；兼容性按安装文档，不承诺未经测试的连接速度。
DNS 原稿的关键字段再次对照 Mihomo 官方 DNS、TUN 文档：dns-mode native、dns-hijack、节点域名独立解析、代理组后缀与 strict-route 的平台限制。文章明确区分 DNS 接管、加密和连接出口；保留浏览器独立 DNS、远端解析、IPv6 及故障状态验证限制。
这是教程内容及网站页面验收；没有安装 Windows 客户端、导入真实订阅、切换用户代理或执行设备 DNS 泄漏测试。
使用 Query Builder 事务定点更新，校验目标仅为本机 `fna_v3`、已备份行与当前行一致，并确认其他六篇未变化；未触发 Eloquent 保存事件、推送或 Scout 索引同步。现有搜索索引的环境隔离尚未在本任务确认，因此本地搜索结果未同步，不把栏目/详情验收写成搜索验收。
## 页面验收
两栏目及三文章分别在 1360px、390px 检查 HTTP 200、标题、导航、面包屑、教程图片、代码换行与横向溢出；另检查移动导航可展开并包含两教程入口。DNS 3幅图解、入门教程1幅流程图和2张官方操作图、迁移文的原有图文均可显示。入门正文不包含迁移内容；迁移文已从入门移至进阶，DNS末尾入门链接已指向新文章。
所有浏览器请求按来源白名单，仅允许 FNA_V3、其 Vite dev 和本地 Resource V2；线上统计和历史文章的线上图片请求在发出前被拦截。没有项目线上访问或线上页面验收。
证据：`/Users/hellcat/Documents/Codex/2026-10-22/fq/outputs/verge-beginner-verification.json` 与同目录桌面、手机截图。此处验收结果以最终回读为准。
## 本次更正的回退
2026-10-27用户明确入门只讲软件使用，将迁移文章移到进阶。更正前源码与两篇受影响数据库行保存在 `/Users/hellcat/Documents/Codex/2026-10-22/fq/work/verge-beginner/`，`applied.json`记录新入门ID362及更新后行。若撤回本次更正，先核对当前行未被后续修改，再恢复212和361，检查362无后续依赖后移除，并恢复相应正文源和维护说明；不要误用前一轮备份撤销栏目改名。其余文章本次事务前后哈希内容一致。
## 首轮回退与后续
本次工作和备份根：`/Users/hellcat/Documents/Codex/2026-10-22/fq/work/client-rewrite/`。
- `clients-before.json` / `categories-before.json`：修改前7篇文章和8个分类。
- `applied.json`：本次旧行、新行、实际新增ID及写入时间，权限0600。
- `index.before.blade.php` / `show.before.blade.php`：基于已有并行修改保存的模板；`*.after.blade.php` 用于核对本次差异。
- 回退先比较数据库当前行和回执中的已应用行；有后续修改或关联数据时先合并，不直接覆盖。恢复212及分类2原值，确认新增361/10未被后续使用后移除，并仅刷新导航缓存。模板按本次差异撤回，不能整份覆盖后续修改。删除新素材前检查是否被其他文章引用。
- Markdown和生成HTML已随项目保存；数据库内容不是Git文件，上线前仍需单独设计并审核生产迁移，本次不构成部署。
当前原七篇旧教程均已处理，另有Windows纯入门和DNS进阶文章，共九篇长期内容。iOS m170、Mac m172/m173、Linux m174的批量重写见下文；Mac/Linux原重复正文已按各自任务分开。本地内容完成不代表客户端真机联网或生产部署验收。
## 免费节点场景文案修正（2026-10-27）
删除Windows入门中不适用于本站公开免费订阅的“不要公开分享”提醒框；导入步骤指向`/freenode`的较新分享，节点失效时自然引导回免费节点页面。通过独立API显式接管362，保留原URL、标题、标签及创建时间，发布版本1；原正文保存在基线版本0，可按API流程回退。原始稿、请求和回执在`output/free-tutorial-fix/`，正文源及生成HTML已同步。接收器补齐既有图解使用的安全`small`标签，隔离测试19项149断言通过。公开页面桌面/手机核对见`output/free-tutorial-fix/article-verification.json`；未部署线上。
本轮全库`check_docs.py`检查发现2项无关账号资源的生成视图过期；本次未修改那些资源，也未越范围重建。项目文章源、内链及本地页面验收已通过，相关维护引用逐项存在。
## v2rayNG Android 入门重写（2026-10-27）
按用户“再来一章”定点重写原文章208（m171），使用原稳定内容键`v2rayng-android-legacy`显式接管，保留地址、栏目及标签；本地API版本1，基线0保留旧文。移除“稳定性极佳”的泛化承诺与1.7.3第三方安装包链接，换为官方发行入口、架构选择、本站v2ray订阅、订阅分组更新、VPN授权、连接检查和日常排错。2幅HTML/CSS流程图明确标为示意；列表封面换为本地`public/images/tutorials/v2rayng-cover.svg`，不请求旧线上封面。教程有序列表补`list-style-type:decimal`，恢复被站点reset隐藏的步骤编号。
依据为官方2.3.11发行页、发布文件Wiki、该tag的界面/中文资源/构建配置及Android VPN官方文档；源码取证在`output/v2rayng-rewrite/upstream/`。已核对本站本地资源页实际提供v2ray格式入口，没有请求其线上订阅文件。未安装Android客户端、未导入真实订阅、未做节点或真机联网实测。
源文件、API草稿、发布回执和原文备份见`docs/content/tutorials/v2rayng-android.md/.html`与`output/v2rayng-rewrite/`。缓存、独立搜索索引和sitemap回执均done；签名预览及公开页1360/390排版、两幅图解、目录和内链检查见该目录`preview-verification.json`和`public-verification.json`。浏览器仅允许登记本地来源；未提交、推送或部署生产。回退使用API历史版本0生成新草稿后预览发布，不直接覆盖数据库；正文源与关系索引同任务同步。
## Clash Meta for Android 入门重写（2026-10-27）
原Clash for Android文章206（m169）改为Clash Meta for Android的完整使用教程，保留原ID、内容键`cfa-android-legacy`、URL、栏目和标签。官方发行页当时为v2.11.36；下载架构、系统要求、配置保存/激活、首页启动和代理模式按该tag的README、中文资源与界面源码核对，证据在`output/clash-android-rewrite/upstream/`。正文以本站Clash/Mihomo免费订阅为主线，包含2幅HTML/CSS图解、本地技术封面和基本排错；不采用旧CFA的下载入口，不声称真机连接已实测。
v2rayNG文章208只在订阅格式说明处增加指向m169#import的链接；206同时指向m171#import。两篇由API同批发布，分别为版本1和2；原文备份、请求、回执、预览与公开页1360/390验收见`output/clash-android-rewrite/`。缓存、搜索、sitemap均done；保留原文章身份，两个Markdown和HTML源及关系索引已同步。浏览器只允许本地来源，未访问线上站点、未安装手机客户端或测试真实订阅，未提交、推送、部署。206基线0保留旧文；回退时需同时处理208新增的#import入向链接，不能只恢复206造成断链。
## 日期标注（2026-10-27）
用户指出文章头部2026-08-04与正文“更新于2026-10-27”容易混淆。核实206/208的created_at均为2026-08-04，原发布时间随旧文保留；正文日期是此次教程更新时间。共享详情模板在原日期前补“发布于”，与正文“更新于”区分，不伪改原发布日期，也不直接把数据库updated_at当作内容更新时间。仅本地页面模板和响应缓存更新，文章正文/版本不变。桌面与手机验证见`output/tutorial-date-label/verification.json`，未上线。
## 去除正文顶部重复信息（2026-10-27）
用户澄清要删除正文开头整行“入门教程 · Android · 更新于……”；上一节的日期语义说明并非用户所指。现已从五篇已整理教程中移除guide-meta整行，保留网站标题信息栏及文末资料核对，其他正文文字与标题、摘要、标签、封面、栏目均回读一致。正文源和HTML同步，写作规范明确后续不再加这类顶部行。通过API同批完成，迁移212与DNS361首次显式接管并保留基线0；当前版本见写作索引。请求、原文、回执和页面验证见`output/tutorial-meta-removal/`；缓存、搜索和sitemap均done，仅本地生效。
## 剩余四篇平台教程批量重写（2026-10-27）
用户授权“剩下的一起处理了”。原207/m170改为Quantumult X iOS安装、资源解析和连接；209/m172改为Mac客户端选择与官方下载；210/m173改为Clash Verge Rev Mac安装、订阅、系统代理；211/m174改为Linux桌面安装、订阅与终端代理验证。两篇旧CFW跨平台重复文现在按DMG、DEB/RPM、权限、桌面和终端代理的实际差异组织，保留各自URL，不合并或重定向。iOS区分Quantumult与Quantumult X，并说明本站通用订阅需要兼容的第三方资源解析器；不承诺任意节点兼容或真实可用。
依据为Clash Verge Rev v2.5.8发行与官方文档、Apple应用打开说明、Quantumult X App Store 1.8.1与开发者配置、KOP-XIAO解析器作者源码和curl手册。原ClashX仓库本次404只用于说明旧入口无法核验。源材料在`output/remaining-tutorials/upstream/`；未安装客户端、未修改本机网络、未访问线上订阅或进行设备/节点实测。
正文源为`docs/content/tutorials/quantumult-x-ios.md`、`mac-client-guide.md`、`verge-mac.md`、`verge-linux.md`及同名生成HTML。每篇2幅HTML/CSS图解，Mac操作文另含现有官方订阅截图并注明示例范围；4张本地技术封面替换不可直接继承的线上图片。正文不添加顶部重复信息行。
通过本地独立文章API同批显式接管原ID，四篇均发布版本1，基线0保留旧文。草稿`ad7be55b-be07-4509-ab19-c50856c21bc4`，发布回执`34a14f98-58b5-4e3f-bc3c-7563a28755b7`；缓存、独立搜索与sitemap均done。原ID、slug、栏目、标签和头图开关回读一致，文章总数不因本批增加。备份、请求、回执、页面截图和验证在`output/remaining-tutorials/`。预览及公开页1360/390排版、图解、图片、目录与实际链接锚点通过；平台栏目标题与URL另行核验。浏览器仅放行登记本地来源，未提交、推送或部署生产。
关系维护在写作索引唯一正文。回退使用API基线0生成新草稿，再预览发布；Mac下载指南、Mac操作、Linux和iOS间已有锚点依赖，回退某篇时须同步处理相应入向链接，不单独恢复缺少锚点的旧文造成断链。
## 安卓缩略图单张试样（2026-10-27）
用户要求去掉缩略图顶部英文、加入相关应用图标，先改一张。仅修改`public/images/tutorials/clash-meta-android-cover.svg`：移除“ANDROID · GET STARTED”，保留Clash Meta专名与中文入门标题；以官方v2.11.36启动图标的原始矢量路径制作蓝色M与橙色猫须图标。没有使用仓库中保留的旧ic_launcher-web.png猫图。
原图、官方素材出处与回退备份在`output/tutorial-cover-sample/`，恢复同目录`clash-meta-android-cover.before.svg`即可回退。原文章封面URL不变，未修改文章正文、版本、其他封面或插画图池。安卓栏目桌面与手机实际裁切预览见`card-1360.png`、`card-390.png`及`verification.json`。仅本地样稿，待用户评价，不自动扩展到全部封面；未提交或上线。
2026-10-27用户要求撤回上述单张缩略图试样：已使用`output/tutorial-cover-sample/clash-meta-android-cover.before.svg`原样恢复Clash Meta封面，字节比对一致。原顶部“ANDROID · GET STARTED”、文字和线条布局恢复；其他封面未改。图标试样仅保留在output作为历史，不再用于页面。仅本地文件恢复，未上线。
2026-10-27按用户指定，将Windows、v2rayNG和Clash Meta三张技术封面的“GET STARTED”统一替换为“开始使用”，保留其他文案与布局；仅本地SVG文件修改，XML解析通过，未上线。后续同类封面沿用中文“开始使用”。
2026-10-27补齐进阶栏目两张封面的中文标签：DNS封面ADVANCED改为“进阶教程”，迁移封面MIGRATION改为“迁移指南”。已检查全部9张教程SVG，无GET STARTED、ADVANCED、MIGRATION遗留；应用名、平台名与技术格式名保留，布局不变。仅本地素材更新，未上线。
## 入门父级banner与综合教程更名（2026-10-27）
按用户确认，`/client`改用与Windows子栏目相同的既有图片banner，复用其aBanner配置；标题为真实HTML H1“入门教程”，简介为HTML段落，置于图片下部的深色半透明区域。移除该页原先重复的白底标题区，空栏目和无banner时保留文字回退。图片保持固定比例，桌面banner位于文章列表列内，与子栏目一致；没有更改Windows子栏目或其他平台banner。
同时categories.id=10的名称由“进阶教程”改为“综合教程”，保留sSlug=advanced、排序、简介、文章归属和URL。导航、栏目标题及文章分类名称由数据库生成；未改文章标题“Clash 进阶”这一主题描述。清除global_nav_tree和响应缓存；本次为栏目配置，未改文章版本。
代码与栏目数据原始备份、精确改动和回读在`output/tutorial-category-banner/`。仅本地变更，未提交、推送或上线。回退时先核对无并行变化，仅恢复栏目2的aBanner、栏目10的sName与本次模板/CSS差异，不覆盖整个数据库或其他修改；随后清导航与响应缓存。
验收完成：`/client`、`/advanced`、Windows子栏目及迁移文章在1360/390宽度均HTTP200、单一H1、无横向溢出；父级标题简介完整落在banner内，子栏目保持原样。导航、栏目页title与文章分类已显示“综合教程”，DNS缩略图的栏目标签同步更名。证据为该输出目录verification.json和截图。
## 公开正文清理与父栏目banner统一更正（2026-10-27）
用户指出“本文的核对范围”出现在公开文章中。该内容属于已入库正文，上线不会自动删除；现已通过独立文章API同批清理九篇教程。删除迁移文顶部核对框，以及文末“未进行真机实测/未修改本机网络”等内部过程说明，保留官方参考链接、实用兼容限制、配置注意事项和内链；不因此新增实测宣称。完整原文与核验范围仍在历史API版本、`output/tutorial-editorial-cleanup/*before*`及本文先前记录中。写作索引已加入公开正文不放内部验收记录的规则。
清理稿预览通过后按hash发布，缓存、独立搜索和sitemap均done；HTML源已从API回读，标题、摘要、ID、slug、栏目、标签和封面保持一致。各文章最新版本见写作索引，备份、草稿、回执和公开页验证见`output/tutorial-editorial-cleanup/`。仅本地更新，未部署生产。回退时按对应前一API版本生成草稿预览发布，不直接恢复整个数据库。
用户进一步明确父级banner必须与子级完全同款。因此撤销父级专用小字简介和深色蒙层CSS：入门与综合栏目均使用同一list-cover结构、字号、间距、背景蒙层，显示中文栏目名与上标文章数量；综合栏目复用Windows现有图片banner配置。简介保留在meta description中，banner不再显示。栏目数量按同一分类查询范围的总行数计算，避免simplePaginate当前页仅两篇造成数字错误；入门含子栏目共7篇、综合2篇、Windows1篇，翻页总数不变。没有改文章列表筛选或分页行为。
本次更正备份与数据操作位于`output/tutorial-category-banner/`，`categories.before-align.json`及`index-with-description.before.blade.php`保留更正前状态；`ArticlesService.before-count.php`保留计数变更前代码。桌面/手机计算样式对比、真实总数、无副标题与公开页面截图见aligned-verification.json及aligned-*.png。两项均仅本地完成，无提交、推送、上线。
## 全部教程读者内容复查（2026-10-28）
按用户要求，复查现有九篇教程的正文、摘要、图注及封面。七篇定点清理，Windows纯入门和Mac操作文未发现同类残留、保持原样。删除或改写“本页旧文”“页面原先介绍”“这次沿用原地址”“核对本文时”等内部编辑历史和核验过程；版本信息保留为明确的适用/示例版本，系统要求和配置限制保留。Android两篇文末移除仅用于编辑取证的界面实现/构建源码链接，保留官方下载、项目和实用参考；Mac下载指南摘要改为读者的选型任务。迁移文同时去除不适用于本站公开免费订阅的账户保密提醒，导入入口增加/freenode，旧订阅和自定义配置的迁移步骤保留。DNS中的“独立验收项”改为读者实际检查步骤。
全部九篇摘要、封面文字和图注已核对；没有删除占位地址替换、平台兼容、节点有效性、DNS路径验证或配置合并等实用限制。未引入新的版本现状结论，未进行额外线上访问或设备联网测试。内部事实及完整修改前源保留在本文历史和output/tutorial-reader-audit-20261028/；不再发布到读者正文。
七篇通过本站独立API原子更新；曾有两轮未发布草稿，最终发布冻结草稿以该目录draft-result.json为准，原始公开版本在before-*.json。请求、发布回执、逐项修改审计、正文回读及页面检查分别见audit.json、publish-result.json、source-verification.json、preview-verification.json和public-verification.json。缓存、独立搜索与sitemap均done。Markdown、HTML与写作关系索引同步，保留ID、slug、栏目、标题、标签和封面；仅Mac下载指南摘要作上述定点调整。文章最新API版本以写作索引为准，回退通过API历史版本重新建立草稿后发布，不直接恢复整库。
预览最初因原有Vite本地开发服务未运行而缺少站点样式；已在原登记127.0.0.1:5187恢复dev服务后重新检查。没有执行生产构建、提交、推送或上线。浏览器只放行已登记本地来源，未访问生产站点或节点订阅。
## 系统代理与 TUN 综合教程（2026-10-28）
新增《系统代理和 TUN 有什么区别？接管范围、使用选择与排错》，稳定键/slug为`system-proxy-vs-tun`，本地ID365，归属综合教程。源文件为`docs/content/tutorials/system-proxy-tun.md`及API回读的同名HTML；封面为`public/images/tutorials/system-proxy-tun-cover.svg`，沿用现有文字与线条风格，标签使用“代理设置 · 综合教程”。正文以桌面客户端为范围，包含系统代理、TUN和接管/出口两阶段三张HTML流程图，以及组合说明、场景选择、切换检查和按现象排错。没有复制DNS配置片段，DNS专项操作链接既有正文。
资料依据为Clash Verge Rev官方快速入门、名词解释、绕过说明、Windows FAQ，以及Mihomo TUN配置文档；准确URL与编辑取舍见`output/system-proxy-tun-20261028/research.json`。不同文档的默认协议栈描述有版本差异，正文未写固定默认值；没有把TUN描述为所有连接必经、必然防DNS泄漏或游戏加速。核验范围为官方资料与本地渲染/链接检查，未执行设备联网测试，未修改本机代理、DNS或路由；这些内部信息只保留在维护记录。
Windows入门的TUN问答增加`#choose`入口；DNS教程配置片段前增加`#tun`入口，两篇其余内容和文章元数据保留。新文链接Windows、Mac和Linux实际连接章节，Linux终端显式代理章节及DNS接管/加密/出口章节。写作索引同步新增登记、实际关系与版本，移除已完成的TUN待写选题。
独立API冻结草稿`06276f75-22f0-448d-b3b7-050662f1abc3`经预览后发布，回执`dc549d99-b9b4-40f6-b15d-0618c31bc1e6`；新文版本1、Windows版本4、DNS版本6。缓存、独立搜索、sitemap全部done。完整修改前正文、请求、回执、源文件回读与检查结果保存在`output/system-proxy-tun-20261028/`。
1360和390宽度的三篇签名预览与正式页面均HTTP200，无横向溢出；目录与正文内链目标、锚点均通过，三张图已查看截图。综合教程栏目包含新文，banner总数为3，封面沿用现有样式。浏览器仅放行登记的本地来源。仅本地完成，未提交、推送或生产部署；旧文回退通过API历史版本生成草稿，不覆盖整库；新文如需撤下先处理上述入向链接。
## 文章样式试改已撤回（2026-10-28）
按用户“改回去先”的要求，已从`output/tutorial-style-20261028/tutorials.before.css`完整恢复`public/css/tutorials.css`，撤回本次主题样式设计，并删除写作规范中随之新增的“文章组件与排版”段落。文章正文、数据库与版本未变。试改截图和检查记录保留在输出目录，仅作历史记录，不代表当前样式。仅本地恢复，未上线。
## 小标题蓝线定点调整（2026-10-28）
用户在撤回整套样式后，明确只处理突兀蓝线。现仅向`public/css/tutorials.css`追加标题覆盖：`.post-content .tutorial-body h3::before`不再生成原蓝色渐变装饰，小标题使用左侧3px主题色竖线、适当左内边距与行高；h2/h3恢复block，修复全局inline造成相邻标题连行。主题色使用站点`--color-primary`，当前为#A758A5。其他目录、图解、表格、链接、字号和正文内容保持原样，没有重新引入已撤回的整体设计或对应写作规范。
修改前样式与本地1360/390亮色、深色检查记录在`output/tutorial-heading-20261028/`。四种显示状态均无页面横向溢出、标题与后续元素无重叠，旧伪元素消失，竖线读取当前主题色；桌面和手机截图已查看。仅本地生效，无文章数据修改、提交、推送或上线。
## 本地样式服务恢复（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进程，不代表已配置登录自启或已核实此前进程退出原因。