fn_b/docs/content/WRITING.md

230 lines
36 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# AI 写作与文章关联索引
适用项目:FNA_V3。用户于2026-10-27指定本聊天持续为该项目写文章,并要求各 AI 写作时形成相关内容之间的跳转。**每次选题、撰写、重写、改名、移动、合并或撤下文章前,先读本文。** 本规则适用于项目中的后续 AI,不依赖某一聊天的上下文;不表示后台自动写作或自动发布。
发布已采用本站[独立文章 API](../maintenance/EDITORIAL_API.md),不经过ATOM。AI保留项目正文源,通过API保存冻结草稿、取得签名预览、发布确认的hash并核对回执;本索引仍由写作AI同任务维护,API不会自动改写它。
2026-10-31用户另行授权综合教程每周随机三篇的周期写作与发布,Codex任务已建立,自2026-11-02当周开始。随机计划、额度、幂等台账与执行状态唯一见[周期写作](../maintenance/WEEKLY_TUTORIALS.md);这一授权不扩大为全站重写或其他实例发布。
本文是写作流程、文章用途及文章关系的唯一维护入口。文章正文保存在各自源文件,数据库是页面实际读取的内容;栏目实现、渲染与备份方法见[教程维护](../maintenance/TUTORIALS.md),SEO项目状态见[SEO清单](../maintenance/SEO_PLAN.md)。不要在这些文档中再复制一份持续更新的文章关系表。
2026-10-31新增[统一机场推荐模块](../maintenance/AIRPORT_RECOMMENDATIONS.md):入门/综合教程自动在末尾展示,综合教程由展示层补入文内跳转;不要在正文源重复维护机场价格、地址和优惠码,也不要创建同名airport-recommendations锚点。已随[界面发布](../maintenance/UI_RELEASE_2026-10-31.md)上线。
## 1 写作前先确定读者要完成的任务
- 新手教程(原“入门教程”,URL仍为`/client`):以第一次使用为前提,讲准备、下载、安装、配置、使用和基本排错。不要把客户端迁移作为普通入门教程的主线。
- 下载与选型:讲适用平台、版本/架构、官方来源和选哪个安装包;引用官方发布入口,不把未经验证的第三方包当官方下载。
- 综合教程(栏目原名“进阶教程”,URL仍为`/advanced`):讲具体机制、配置取舍、迁移或专项排错,并链接读者需要的基础操作。
- 看看资讯(`/news`):独立资讯栏目,2026-11-02本地与正式建立,当前无文章;具体栏目维护见[资讯栏目](../maintenance/NEWS.md)。创建栏目不表示已授权自动采集或写作。
- 资源与时效内容:区分长期说明和当天资源状态。长期教程优先链接稳定说明/栏目,不依赖会过期的某一天资源页。
先查询下表和当前数据库,再决定重写已有文章还是新增。主题相同优先完善唯一正文;不同平台可以分别写,但需要实际的平台差异。标题、开头、步骤和关联链接都应服务于同一个任务。
本站是公开分享免费节点的站点。入门教程优先按“从本站获取适用格式的免费订阅→导入→选择节点→验证”的实际过程组织;公开分享的订阅与私人账户订阅需要区分,不把私人账户保密提醒套进免费资源步骤。相关说明和内链自然放在读者需要的位置,避免堆叠与场景无关的提示框。
正文直接进入引言,不再添加“入门教程 · Android · 更新于……”这类顶部信息行;分类、平台和日期不要在正文开头重复网站信息栏。必要的官方参考链接可保留在文末,内部核验过程另存维护记录。
**禁止在公开文章中写内部核验与验收说明。** 用户于2026-10-27明确要求:以后文章里不再出现“本文的核对范围”“已核对官方文档”“未实测”“未进行真机联网测试”“未修改本机网络”等内容,也不换成同义的提示框、脚注或免责声明。核验范围、设备测试情况、开发验收过程及本地/上线状态只写入项目维护记录,不进入正文、摘要、图注或封面。
公开内容保留对读者有用的操作步骤、版本兼容条件、配置限制和参考来源;不得编造实测结论。发布前检查全文,发现上述内部说明必须删除或移入维护记录,不能指望上线流程自动去掉。“本页旧文”“沿用原地址更新内容”“核对本文时”等编辑历史和核验口吻同样移入维护记录;版本信息直接写适用版本、系统要求或示例版本。参考链接优先选读者实际需要的下载、配置与使用文档,不堆放仅用于编辑取证的界面实现源码。
自然、准确地表达;必要时用真实操作图、流程图、配置示例。软件版本、下载入口与兼容要求使用当次核对的官方来源;来源核验、页面检查和设备实测分别记录,未做实测不写“实测”。
### 文章封面与水印(2026-11-01)
每次新写的每篇文章都须独立设计并生成主题图片;不复用同一底图换标题,不沿用单调的标题横线卡片。根据文章的设备、操作或机制构思不同场景、构图和配色,为文章生成与具体主题相符的封面图,并加上本站网址 **clashfreenode.com** 水印。用户提供的参考图以画面表达主题,角落有低调的站点署名;借鉴这种主题视觉与水印的关系,不照搬其他网站的名称、标志或固定版式。封面应适合本站缩略图裁切,在小尺寸下仍能看清主体和水印;文字优先使用中文,应用名称及品牌名保留原名,水印不遮挡关键信息。生成后检查实际渲染的品牌拼写、可读性和裁切效果,必要时调整;按文章API的图片上传与发布流程交付。
**统一画风,不统一模板(2026-11-01用户确认)**:教程封面采用“纸艺拼贴+微缩立体场景”(tactile papercraft / miniature diorama editorial illustration),保留纸张纤维与折叠、层叠色块、可信的物件体积、柔和定向光和自然投影。认可参考为[客户端下载图](tutorials/assets/newcomer/clients-cover.png)的设备陈列,以及[新手指引图](tutorials/assets/newcomer/start-paper-cover.png)的路线与关卡;二者质感相通,但场景与构图明显不同。每篇按主题重新设计视觉比喻、主体、镜头角度、构图与配色,不固定为设备托盘,不反复使用笔记本、山景屏幕、盆栽或同样的台座布局,不只换设备/标题/颜色。可以使用地图、建筑、机械、航行、城市网络等不同表现;这是举例,不是每篇必须套用的固定清单。既要表达文章主题,也要确保成组浏览时不重复。此规则只适用于教程封面,不改免费节点插画池。
封面图与正文里的操作截图、流程图用途不同,正文需要解释操作或机制时仍应提供对应图解。此要求自后续新文起执行,不自动更换已发布文章的封面。文章专题封面通过文章资产流程处理,不因此改动免费节点插画图池;CFN系独立插画仍遵循项目既有画师分工及交付流程。
### 教程双比例配图(正式规则,2026-11-01)
用户已确认试样并要求其他文章遵循此方式。**后续每篇新手/综合教程必须同时交付两张同主题、分别构图的图片**,不是仅适用于当前聊天或新手指引的临时试验:
- **列表缩略图:3:2。** 上传后写入文章 `cover`,主体和标题在列表小图中清晰;不要把列表图误认为正方形。
- **详情头图:约2.4:1。** 为低矮宽画幅重新安排主体、文字和留白,完整展现主题;不可通过硬裁、拉伸或上下补空白把3:2图凑成横幅。两张图保持同一文章的主题与画风,不必复制物件位置。
- 两图均按上一节的纸艺拼贴+微缩场景风格独立设计,带准确的 `clashfreenode.com` 水印;不同文章的视觉比喻、场景、配色和视角应有变化。正文操作截图及图解另按解释需要提供。
**发布实现必须一致:** `cover` 指向3:2缩略图,`show_cover=false`,详情横幅放在正文 `.tutorial-body` 开头,以唯一的 `figure.guide-figure.tutorial-hero` 包住图片。上传两张图片后使用API返回的实际 `asset:SHA256`,并填写实际宽高和说明性alt;不要把示例占位符直接发布:
```html
<figure class="guide-figure tutorial-hero"><img src="asset:实际横幅SHA256" width="实际宽度" height="实际高度" alt="主题说明" decoding="async"></figure>
```
现有 `tutorials.css` 使横幅占满正文宽度并等比显示。不得再打开默认头图造成重复,也不得给横幅设置固定高度裁切。改旧文时保留原 `cover`、日期、正文和点赞进度,只更新已获授权的图片内容;同步Markdown源、HTML渲染稿和文章版本索引。原图、交付JPG及完整提示词保存在文章资产目录,不依赖聊天临时文件。
发布前逐篇检查:列表仍使用3:2图;详情仅一张约2.4:1头图;桌面和手机无横向溢出;标题、水印、主体完整可读;图片加载成功;实际正文与缩略图分别使用正确资源。缺少任一配图或未完成检查时不能把文章标成全部完成。普通改稿不自动批量重画历史文章;本次已获授权推广的是2026-11-01这批8篇新手教程,回执与回退见[新手教程维护记录](../maintenance/NEWCOMER_TUTORIALS_2026-11-01.md)。
栏目banner与文章配图是不同资产:`/client` 总列表不显示大图;五个平台子栏目显示各自主题banner及动态名称/文章数量。栏目图不替代文章的两张配图,修改入口见[新手教程维护记录](../maintenance/NEWCOMER_TUTORIALS_2026-11-01.md)。
### 周期文章的展示时间(2026-10-31)
用户要求每天北京时间15:00检查周期计划,新文章展示日期从实际发布时间随机向前偏移0~21600秒(含端点)。API在新文草稿中冻结`display_offset_seconds`,首次发布计算独立的`sDisplayPublishedAt`;列表和详情沿原有日期显示样式使用该字段,未设置时使用真实创建时间。实际`created_at`、发布回执及点赞起点不改;重试、旧文编辑和回退不重抽、不改旧文展示时间。`display_time_randomize`只允许新建时设置,默认true,显式false为零偏移。不要把随机时间或内部执行过程写进公开正文。
### AI 新文章的点赞参数(2026-10-29)
后续AI通过本站独立文章API**新建文章**时由API在保存草稿时为每篇独立取默认值并冻结;相同请求重试、查询预览及发布不重新抽取。统一设置入口为[文章自动点赞配置](../../config/article_likes.php),配置文件覆盖上游/API传入的自动点赞数值,0也优先;分类与优先级见[自动点赞维护](../maintenance/ARTICLE_LIKES.md#新文章统一设置2026-11-01本地)。下表是现有默认值的说明,后续以配置文件的实际值为准;本次统一配置已于2026-11-02随Git发布上线。重写、接管、回退已有文章不重置原参数、点赞数或已完成进度,不自动给现有文章批量补额度。
| 设置 | 默认值 | 含义 |
| --- | --- | --- |
| `i7like`,API `like_settings.seven_day` | 新手1~18;综合/其他编辑1~15(含端点) | 原有短期待增加额度,随原任务逐次扣减 |
| `i365like`,API `like_settings.yearly` | 新手50;综合/其他编辑30 | 保留原持续年度随机机制:每天以50/365概率加1,长期平均每年约50赞,并非每年保证恰好50,不随一年结束停止 |
| `iYearLikeTarget`,API `like_settings.one_year` | 新手50~150;综合/其他编辑20~80(含端点) | 新增一次性年度额度;设200表示独立累计自动增加200赞,不是总点赞数封顶200 |
一次性年度额度从正式发布时开始,按实际经过时间在一个日历年内分散增加,`iYearLikeAdded`记录已增加数量,`sYearLikeStartedAt`记录开始时间;满额后该项停止,`i365like`持续增长和真实点赞继续独立计算。任务停机造成的欠额在恢复后补至应有进度;满一年后首次恢复会补完余额,不能在调度停机时凭空执行。
新文章省略`like_settings`,由配置文件决定三个值;为兼容旧调用,接口仍校验该对象,但传入值不会覆盖本地配置。要关闭某项,在配置文件中设为0。保存后检查草稿响应的`like_settings`,发布后从鉴权的`source-articles/{id}`响应`like_growth`回读确认。旧文章编辑不传此对象;API拒绝通过普通改稿重置额度。设置与进度只属于内部发布数据,不写进公开正文、摘要、图注或封面。
具体字段、迁移、任务、测试与回退见[文章自动点赞维护](../maintenance/ARTICLE_LIKES.md)。2026-10-29当时的默认值已部署正式cfn(不是2026-11-01本地的新范围和优先级),原每5分钟点赞任务已接入新增年度额度;本机仍未启动调度。按用户本次明确授权,正式10篇教程已补齐缺项:3篇全0新文补全部默认值,另外7篇仅补一次性年度额度并保留原参数。后续不自动重置已有文章,补配结果见上述维护记录。
## 2 当前文章登记
本地登记更新:2026-11-01。新手栏目现有8篇新文,原7篇平台教程移至综合教程,URL、正文、日期和点赞进度保留。分类与新稿已于2026-11-02通过正式API发布;正式ID、版本及验收见[整批发布记录](../maintenance/FULL_RELEASE_2026-11-02.md)。具体批次与回退见[新手教程调整](../maintenance/NEWCOMER_TUTORIALS_2026-11-01.md)。
ID用于核对本地行,站内链接使用已确认路径。跨环境迁移后重新核对ID,不能假定生产ID相同。
| 内容键 | 本地ID / 栏目 | 标题 | 实际路径 | 正文源 / 编辑状态 | 用途与引用边界 |
| --- | --- | --- | --- | --- | --- |
| verge-windows-start | 362 / 综合教程 | Clash Verge Rev 使用教程:从安装到第一次连接(Windows) | `/a/clash-verge-rev-windows.html` | [windows.md](tutorials/windows.md);本地API版本5 | 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 / 综合教程 | Clash Meta for Android 使用教程:导入订阅、选择节点与连接 | `/a/m169.html` | [clash-meta-android.md](tutorials/clash-meta-android.md);本地API版本7 | Android Clash配置入门;`#install` 安装、`#import` 导入;按MetaCubeX v2.11.36核对,保留原键和URL |
| quantumult-ios-legacy | 207 / 综合教程 | Quantumult X 使用教程:iOS 安装、订阅导入与连接 | `/a/m170.html` | [quantumult-x-ios.md](tutorials/quantumult-x-ios.md);本地API版本6 | iPhone/iPad入门;区分原生资源与本站通用订阅,#parser 解释第三方资源解析器,#import 导入;无真机实测 |
| v2rayng-android-legacy | 208 / 综合教程 | v2rayNG 使用教程:Android 安装、导入订阅与连接 | `/a/m171.html` | [v2rayng-android.md](tutorials/v2rayng-android.md);本地API版本8 | Android入门;`#install` 下载、`#import` 订阅导入;保留既有内容键和URL |
| clashx-mac-legacy | 209 / 综合教程 | Mac 代理客户端下载指南:ClashX 与 Clash Verge Rev 怎么选 | `/a/m172.html` | [mac-client-guide.md](tutorials/mac-client-guide.md);本地API版本6 | Mac选型与官方下载;#download 核对系统与芯片,链接实际安装教程;旧ClashX原入口不可核验不等于所有分支失效 |
| cfw-mac-legacy | 210 / 综合教程 | Clash Verge Rev 使用教程:Mac 安装、订阅与系统代理 | `/a/m173.html` | [verge-mac.md](tutorials/verge-mac.md);本地API版本3 | Mac操作入口;#install DMG安装,#import 订阅,系统代理与退出排错;无设备联网实测 |
| cfw-linux-legacy | 211 / 综合教程 | Clash Verge Rev 使用教程:Linux 安装、订阅与代理设置 | `/a/m174.html` | [verge-linux.md](tutorials/verge-linux.md);本地API版本6 | 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` 排错;三张流程图 |
| clash-routing-modes | 366 / 综合教程 | Clash 规则、全局和直连怎么选?代理组与分流排错教程 | `/a/clash-rule-global-direct.html` | [clash-routing-modes.md](tutorials/clash-routing-modes.md);2026-10-31本地ID366/版本1,正式ID382/版本1已发布 | 模式选择与代理组分流;`#groups` 组内选择、`#custom` 添加规则、`#verify` 验证新连接 |
| newcomer-start | 373 / 新手教程(client) | 新手指引:从免费订阅到第一次连接 | `/a/getting-started.html` | [start.md](tutorials/newcomer/start.md);本地API版本3(双比例配图);2026-11-02正式ID393/版本1已发布 | 先选设备,再下载安装、导入对应格式的免费订阅并连接。Windows、Mac、安卓、iPhone、Linux和路由器的入口都在这里。 |
| newcomer-windows | 374 / 新手教程(windows) | Windows 新手教程:用 Clash Verge Rev 连接免费节点 | `/a/windows-free-nodes.html` | [windows.md](tutorials/newcomer/windows.md);本地API版本3(双比例配图);2026-11-02正式ID394/版本1已发布 | 从选择 Windows 安装包开始,复制本站 Clash 订阅、选中配置与节点,再开启系统代理完成第一次连接。 |
| newcomer-mac | 371 / 新手教程(mac) | Mac 新手教程:安装 Clash Verge Rev 并导入免费订阅 | `/a/mac-free-nodes.html` | [mac.md](tutorials/newcomer/mac.md);本地API版本3(双比例配图);2026-11-02正式ID391/版本1已发布 | 区分 Apple 芯片和 Intel 安装包,将应用放入应用程序,导入 Clash 订阅并开启系统代理。 |
| newcomer-android | 367 / 新手教程(andorid) | Android 新手教程:用 FlClash 导入免费订阅 | `/a/android-flclash.html` | [android.md](tutorials/newcomer/android.md);本地API版本3(双比例配图);2026-11-02正式ID387/版本1已发布 | 在安卓手机安装 FlClash,导入 Clash 格式订阅、选择节点并允许 VPN 连接,附后台断连排查。 |
| newcomer-ios | 369 / 新手教程(ios) | iPhone / iPad 新手教程:用 Hiddify 连接免费节点 | `/a/ios-hiddify.html` | [ios.md](tutorials/newcomer/ios.md);本地API版本3(双比例配图);2026-11-02正式ID389/版本1已发布 | 从 App Store 安装 Hiddify,添加本站订阅、允许 VPN 配置并检查连接,说明订阅更新与节点切换。 |
| newcomer-linux | 370 / 新手教程(linux) | Linux 新手教程:在桌面环境使用 Clash Verge Rev | `/a/linux-free-nodes.html` | [linux.md](tutorials/newcomer/linux.md);本地API版本3(双比例配图);2026-11-02正式ID390/版本1已发布 | 按发行版和 CPU 架构选择安装包,导入免费订阅、开启系统代理,并区分浏览器与终端的连接方式。 |
| newcomer-router | 372 / 新手教程(client) | 路由器新手教程:用 OpenClash 导入免费订阅 | `/a/router-openclash.html` | [router.md](tutorials/newcomer/router.md);本地API版本3(双比例配图);2026-11-02正式ID392/版本1已发布 | 在兼容的 OpenWrt 路由器上安装插件与内核、添加 Clash 订阅、启用配置,再检查设备是否经过这台路由器。 |
| newcomer-clients | 368 / 新手教程(client) | 客户端下载与选择:按设备找到适合的软件 | `/a/proxy-clients.html` | [clients.md](tutorials/newcomer/clients.md);本地API版本2(双比例配图);2026-11-02正式ID388/版本1已发布 | 汇总常用代理客户端的官方入口,说明系统、架构和订阅格式如何匹配,并连接到各平台的新手教程。 |
2026-10-31新教程正式ID382/版本1、本地ID366/版本1已发表;系统代理/TUN正文补入口后两环境均为API版本2(正式ID376、本地ID365)。正式发布时间14:58:28北京时间,IndexNow由VPS-003提交返回200,服务器HTTP与图哈希/锚点验收通过。唯一状态与恢复记录见[规则模式教程发布记录](../maintenance/ROUTING_MODES_2026-10-31.md)。
这里只登记长期编辑内容及值得复用的稳定资源说明,不逐条收录日更节点或账号文章。稳定入口为 `/`(当前免费节点)、`/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。
2026-10-31 SEO发布后,新稿获取当前免费资源优先链接 `/`;需要历史记录时链接 `/freenode`。下表保留旧文实际内链事实,旧栏目仍正常可用,不因入口规则变化虚报旧文正文已改;后续相关编辑时按内容用途维护。
## 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 接管、加密和出口 | 已在本地正文实现 |
| system-proxy-vs-tun | clash-routing-modes `#groups` | 已接管但走错出口时检查规则和代理组;放在场景选择之前 | 2026-10-31本地与正式已发布 |
| clash-routing-modes | verge-windows-start `#enable` / cfw-mac-legacy `#enable` | 尚未完成基本连接时返回对应平台操作 | 2026-10-31本地与正式已发布 |
| clash-routing-modes | system-proxy-vs-tun `#routing` / `#troubleshoot` | 解释接管和分流的区别,以及看不到连接时排错 | 2026-10-31本地与正式已发布 |
| clash-routing-modes | mihomo-dns `#dns-2` | 出口正确但域名解析仍异常时继续查DNS | 2026-10-31本地与正式已发布 |
两篇Android教程通过订阅格式段落互链;Mac下载指南与操作教程互链,Linux从下载指南和真实Linux栏目获得入口,iOS沿用真实iOS栏目入口。系统代理与TUN专题由Windows和DNS正文提供入口,并指向三平台的基础操作及DNS专题。目录、标签、导航和热门榜不算正文关联;正文内链及锚点已经本地HTTP验证。
### 新手教程新增关系(2026-11-01建立,2026-11-02正式发布)
| 来源内容键 | 实际目标 | 用途 / 位置 |
| --- | --- | --- |
| newcomer-start | `/a/windows-free-nodes.html`、`/a/mac-free-nodes.html`、`/a/android-flclash.html`、`/a/ios-hiddify.html`、`/a/linux-free-nodes.html`、`/a/router-openclash.html`、`/a/proxy-clients.html`、`/`、`/a/system-proxy-vs-tun.html#choose`、`/a/clash-rule-global-direct.html`、`/advanced` | 正文中的获取订阅、设备操作、下载、专题与返回指引入口 |
| newcomer-windows | `/a/proxy-clients.html#verge`、`/`、`/a/system-proxy-vs-tun.html#choose`、`/a/clash-verge-rev-windows.html`、`/a/getting-started.html#devices` | 正文中的获取订阅、设备操作、下载、专题与返回指引入口 |
| newcomer-mac | `/a/proxy-clients.html#verge`、`/`、`/a/clash-rule-global-direct.html#groups`、`/a/system-proxy-vs-tun.html#choose`、`/a/m173.html`、`/a/getting-started.html#devices` | 正文中的获取订阅、设备操作、下载、专题与返回指引入口 |
| newcomer-android | `/a/proxy-clients.html#flclash`、`/`、`/a/m171.html#import`、`/a/getting-started.html#devices`、`/a/clash-rule-global-direct.html` | 正文中的获取订阅、设备操作、下载、专题与返回指引入口 |
| newcomer-ios | `/a/proxy-clients.html#ios`、`/`、`/a/getting-started.html#devices`、`/a/m170.html` | 正文中的获取订阅、设备操作、下载、专题与返回指引入口 |
| newcomer-linux | `/a/proxy-clients.html#verge`、`/`、`/a/m174.html#terminal`、`/a/system-proxy-vs-tun.html#choose`、`/a/getting-started.html#devices` | 正文中的获取订阅、设备操作、下载、专题与返回指引入口 |
| newcomer-router | `/a/getting-started.html#devices`、`/`、`/a/getting-started.html`、`/a/clash-rule-global-direct.html` | 正文中的获取订阅、设备操作、下载、专题与返回指引入口 |
| newcomer-clients | `/a/windows-free-nodes.html`、`/a/mac-free-nodes.html`、`/a/android-flclash.html`、`/a/ios-hiddify.html`、`/a/linux-free-nodes.html`、`/a/router-openclash.html`、`/a/m167.html`、`/a/m170.html#import`、`/a/m171.html`、`/a/m169.html`、`/a/getting-started.html#subscription` | 正文中的获取订阅、设备操作、下载、专题与返回指引入口 |
| 免费节点页面展示层 | `/a/getting-started.html` | 获取免费订阅标题下;旧版正文回退页在正文前;仅目标公开可用时显示 |
新手指引置顶于`/client`,六个设备入口与下载总览均为真实已保存页面;原七篇移栏不改正文内链。
## 4 怎样安排链接
| 关系 | 典型写法与放置位置 | 目标选择 |
| --- | --- | --- |
| 前置准备 | “尚未安装客户端,先完成……”放在需要操作之前 | 对应平台的安装/下载/入门文章 |
| 具体操作 | “订阅导入步骤见……”放在提到该操作的位置 | 对应教程的具体段落锚点 |
| 解释概念 | “关于系统代理与TUN的区别……”放在需要解释处 | 已完成、平台适用的专题文章 |
| 解决故障 | 在具体错误或现象后提供排查入口 | 对应问题的排错文章 |
| 继续学习 | 完成当前任务后的下一步,放在文末 | 与当前任务相邻的进阶内容 |
| 返回基础 | 进阶内容给尚未具备前置条件的读者一个入口 | 基础教程;不强迫已经会用的读者重复阅读 |
### 下载文章的具体例子
**跨平台下载入口已建立**:`/a/proxy-clients.html`,汇总六类设备的官方来源和对应新手操作入口;新文章优先引用这一下载入口或设备教程的下载段落。
**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节:来源键、目标键、理由/位置、实际状态;有段落链接时同时记录锚点。填写核对日期和证据范围,禁止把“已有记录”写成“刚刚实测”。
当前待补(选题储备,**尚未创建文章,也不自动授权逐篇执行**):
| 主题 | 当前可用替代入口 | 处理条件 |
| --- | --- | --- |
| 更细的客户端选型专题 | 已有 `/a/proxy-clients.html` 跨平台下载入口 | 存在独立读者任务时再拆分,避免重复总览 |
| 订阅导入失败排查 | Windows入门的导入与常见问题段落 | 积累明确错误场景后再拆专题,避免重复原文 |
本次建立的是AI协作约定和已核实的关联索引,不是自动推荐程序、链接注入脚本或定时任务。正文关系变动时由执行写作的AI同任务更新本文。