# FNA_V3 项目维护入口

项目工作先读 GemDocs AI版项目总览、维护协议及 `/Users/hellcat/Documents/GemDocs/AI版/10-项目/fna_v3.md`。线上事务优先经白色机 SSH；网页与订阅 HTTP 访问须符合 GemDocs 的反代规则。

订阅检测已独立为 SubCheck，入口见 [SubCheck](/Users/hellcat/Documents/GemCodes/subcheck/AGENTS.md)；cfn来源适配与调查见 [CFN.md](/Users/hellcat/Documents/GemCodes/subcheck/docs/CFN.md)。fnb不再保存检测实现。代码、凭据、业务数据及并行修改按当前任务授权处理。

## FNA_V3 本地副本维护

CFN页头SVG猫和两行品牌文字的维护与回退见[品牌标志](docs/maintenance/BRANDING.md)，已于2026-10-31发布，见[界面发布记录](docs/maintenance/UI_RELEASE_2026-10-31.md)。

本目录为独立 FNA_V3 副本，身份与环境以 GemDocs AI版 `10-项目/fna_v3.md` 为准；上述 FN_B 入口保留来源背景，不代表授权修改 FN_B。文章广告实现、配置与验收见 [广告维护说明](docs/maintenance/ADVERTISING.md)。统一机场推荐数据、正文替换和教程末尾展示见[机场推荐维护](docs/maintenance/AIRPORT_RECOMMENDATIONS.md)，已于2026-10-31发布，见[界面发布记录](docs/maintenance/UI_RELEASE_2026-10-31.md)。免费节点详情页的只读结构化渲染、订阅保护与回退见[内容页重设计](docs/maintenance/FREENODE_ARTICLE_LAYOUT.md)。

SEO 的只读审计、优化顺序与逐项验收统一维护在 [SEO 优化建议与执行清单](docs/maintenance/SEO_PLAN.md)，2026-10-22 建立。清单中的建议不代表已实施，后续按用户指定项目推进并更新本文件所链接的唯一正文。

## CFN系绘图接手

2026-10-23用户明确将此前由张天承担的绘图工作交给“画师【CFN系】”（personnel-position:cd029d9db8454ec68172b221ff35e6f6）。FNA_V3主程继续开发工作，后续绘图由该画师岗位承接，避免重复制作。本记录仅转交绘图范围，不改变开发或上线权限；未向原聊天发送消息。

风格已从原聊天最近作品及本地成图核实：现代主义剪纸拼贴、哑光色块、轻微丝网印刷颗粒、成熟动物比例、非对称构图和大块留白。参考文件在本项目output/imagegen/：freenode-dog-dalmatian-20261023.png、freenode-dog-dachshund-20261023.png、freenode-dogs-dance-20261023.png；同名txt保存完整提示词。延续视觉语言，每张更换主题或构图，不照搬布局。

接手首张试画及提示词：/Users/hellcat/Documents/Codex/2026-10-23/cfn/outputs/cfn-tuxedo-cat-20261023.png 和同名txt。用户已认可风格并继续扩充；2026-10-26按授权与后续猫狗作品一起归档到Resource V2，并接入本地FNA_V3，未发布到线上。归档和栏目配图的唯一维护入口见[本地插画资源与配图](docs/maintenance/ILLUSTRATIONS.md)。

教程栏目现为“入门教程”（/client）和“综合教程”（/advanced，原进阶教程）。栏目改名、首篇重写、DNS进阶文章及内容回退见[教程栏目维护](docs/maintenance/TUTORIALS.md)。原七篇旧教程均已处理：迁移文归进阶，其余按Android、iOS、Mac和Linux重写；另有Windows纯入门与DNS进阶文章。正文、图解和关联已本地验收，本地内容不代表线上发布。

## FNA 静态配图副本

2026-10-30起Resource保留原稿、图池和固定分配，FNA保存按内容去重的公开展示副本，由本站Nginx直接提供。同步、创建时校验、撤回、缓存与部署验收唯一正文见[静态配图副本](docs/maintenance/LOCAL_ILLUSTRATIONS.md)。用户访问图片不调用Resource、不执行PHP修复。2026-10-31明确源端删除/停用不影响FNA独立副本或已有文章关联，修复与恢复原图记录见[独立副本保留修复](docs/maintenance/INDEPENDENT_ILLUSTRATIONS_FIX_2026-10-31.md)。

## AI 文章写作（必读）

后续为 FNA_V3 选题、写作、重写、调整分类或撤下文章时，必须先读[AI写作与文章关联索引](docs/content/WRITING.md)。它是文章用途、稳定地址和正文关系的唯一登记入口。公开文章禁止出现“核对范围”“未实测”等内部核验/验收说明，具体禁止项与发布前检查按该写作规范执行；相关事实只留项目维护记录。写作时复用相关的下载、入门、进阶和排错内容，自然设置内链，并检查相关旧文是否需要补入口；完成后同步正文源、运行数据库和该索引，验收真实目标与锚点。未创建的文章不能编造链接，本地生效不能写成已上线；不自动开展全站重写或发布。

## 独立文章发布 API

用户已明确文章直接发布到 FNA_V3，不经过 ATOM。实现、调用契约、凭据边界及验收见[独立文章 API](docs/maintenance/EDITORIAL_API.md)。后续写稿使用本站草稿→签名预览→按hash发布→回执核对流程；相关旧文内链修改可同批提交。不要再用临时SQL脚本发布普通编辑文章。旧文首次接管必须显式指定原文章ID并保留URL；发布结果未知先查原请求UUID。代码已于2026-10-29随正式切换部署，生产临时编辑密钥在教程迁移后删除、接口默认关闭；后续按明确写作/发布任务临时启用并在完成后关闭，不扩大线上访问或发布范围。正式部署、备份、Git SHA及验收统一见[发布记录](docs/maintenance/RELEASE_PREFLIGHT_2026-10-28.md#正式切换2026-10-29)。

插画完成后按[自动交付](docs/maintenance/ILLUSTRATION_DELIVERY.md)提交批准批次；不要再手工上传发布/编辑图池或把保存草稿当作上线完成。

周期文章按[固定发布封装](docs/maintenance/EDITORIAL_RELEASE.md)执行：本机SSH必须经白色机到正式业务服务器，使用服务器进程内API，不临时开放公网接口。每周三篇、每天15:00检查、错过窗口回补及文章随机展示时间见[周期写作](docs/maintenance/WEEKLY_TUTORIALS.md)；这一流程替代周期写作中的手动开关API步骤，不扩大其他实例或全站改版权限。

教程SEO、编辑API的IndexNow结果与重试、栏目sitemap的唯一维护说明见[教程SEO通知](docs/maintenance/EDITORIAL_INDEXNOW.md)。`sitemap: done`不代表搜索引擎已收到通知或已收录。

## SEO统一合同（2026-10-31）

首页、归档、教程、分页、索引、sitemap、内容更新时间和IndexNow统一按[SEO实施维护](docs/maintenance/SEO_IMPLEMENTATION_2026-10-31.md)。禁止恢复全query robots屏蔽、分页canonical第一页、按180天批量删正文、用点赞updated_at作为lastmod，或让源图删除影响本站独立副本。当前状态和未取得的搜索平台证据见该文档；实施不等于收录/排名已验证。


2026-10-31用户纠正：SEO只做内部优化，用户看到的布局、样式、可见标题/说明、图片呈现、导航和广告位置必须保持原界面；不因SEO增加说明块、分页条或改版。后续可见改动须用户另行明确要求。恢复基线与验证见[界面保留修复](docs/maintenance/SEO_UI_RESTORE_2026-10-31.md)。