fn_b/docs/content/WRITING.md

158 lines
21 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不会自动改写它。
本文是写作流程、文章用途及文章关系的唯一维护入口。文章正文保存在各自源文件,数据库是页面实际读取的内容;栏目实现、渲染与备份方法见[教程维护](../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)。这些默认值已于2026-10-29部署正式cfn,原每5分钟点赞任务已接入新增年度额度;本机仍未启动调度。按用户本次明确授权,正式10篇教程已补齐缺项:3篇全0新文补全部默认值,另外7篇仅补一次性年度额度并保留原参数。后续不自动重置已有文章,补配结果见上述维护记录。
## 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同任务更新本文。