《福福算力》SEO 热更新文件说明

一、文件用途

本目录中的 seo_*.txt 文件用于集中维护《福福算力》公开页面的搜索引擎优化文案。热更新程序可定期从 Git 仓库 docs 分支读取对应文件，将文件内容应用到网站的标题、页面摘要、关键词和首屏文案中。

每个 TXT 文件只存放一项最终内容，不包含字段名、引号、Markdown 标记、HTML 标签或其他说明文字。程序读取后应去除文件首尾空白和换行，再写入对应页面位置。

二、文件与页面位置对应关系

三、读取地址

程序应读取 docs 分支的原始文件内容，不应读取 Git 网页渲染后的 HTML。原始文件地址格式如下：

http://git.northwith.com/gaotong/new-api/raw/branch/docs/文件名

例如首页标题的读取地址为：

http://git.northwith.com/gaotong/new-api/raw/branch/docs/seo_home_title.txt

如仓库需要身份认证，生产程序应使用只具备该仓库读取权限的部署令牌或专用只读凭据，不应在代码中保存个人账号密码。如生产环境不适合直接访问 Git 服务，可由部署系统拉取 docs 分支后从本地文件读取，字段对应关系保持不变。

四、程序接入要求

1. 文件编码统一使用 UTF-8，读取后应执行首尾空白清理，不应修改正文内部的中文标点和空格。
2. 单个文件读取成功且通过校验后再替换对应字段，避免部分内容下载失败导致页面标题为空。
3. 远端请求失败、返回非成功状态、文件为空或内容未通过校验时，应继续使用最近一次成功内容或程序内置默认值。
4. 建议使用 ETag、If-None-Match 或 If-Modified-Since 检查文件是否发生变化，未变化时不重复更新页面缓存。
5. 多个字段需要同时更新时，应在全部新内容读取和校验完成后一次性切换，避免同一页面短时间出现新旧文案混用。
6. 输出到 HTML 属性或标签时，应由程序进行必要的 HTML 转义，禁止把文件内容作为未经处理的脚本或 HTML 执行。
7. 热更新成功后应刷新服务端渲染、静态页面或页面缓存，确保搜索引擎抓取源代码时能够直接看到更新后的标题和摘要。
8. 建议记录更新时间、来源提交版本、更新字段和执行结果，便于发生异常时回溯或恢复上一版本。

五、页面实现要求

1. 首页应同时应用 seo_home_title.txt、seo_home_description.txt、seo_home_keywords.txt、seo_home_h1.txt 和 seo_home_subtitle.txt。
2. 每个公开页面只设置一个可见的 <h1>。首页 H1 应与标题和摘要描述同一业务，不应通过隐藏文字重复堆砌关键词。
3. 模型与价格、API 文档、联系我们页面应分别使用各自的标题和摘要，避免所有页面共用首页内容而形成重复页面。
4. 页面 <title> 和 <meta name="description"> 应出现在搜索引擎能够直接读取的初始 HTML 中。若网站为单页应用，建议使用服务端渲染、预渲染或可靠的动态元数据方案。
5. 页面应设置指向正式 HTTPS 地址的 canonical 链接，避免带查询参数、不同入口地址或重复路由被搜索引擎识别为不同页面。
6. 首页、模型与价格页、API 文档入口页和联系我们页面适合公开收录；登录、注册、找回密码、用户控制台、充值、订单、API Key、个人中心和管理后台应设置 noindex，并避免进入站点地图。
7. 应生成并持续更新 sitemap.xml，在搜索引擎站长平台提交；同时通过 robots.txt 允许抓取公开页面并限制无搜索价值的账户和后台路径。
8. 搜索摘要可能由搜索引擎根据用户查询重新生成，TXT 文案用于提供清晰、准确的默认语义，但不能保证搜索结果始终逐字展示。

六、内容策略说明

本批文案采用“产品名称、核心服务、用户需求、页面意图”的组合方式：

• 品牌统一使用《福福算力》，增强不同页面之间的品牌关联；
• 核心业务词围绕“国产大模型 API”“大模型 API 接口”“API 中转”“AI 算力服务”“统一模型接口”和“按量计费”展开；
• 模型名称仅用于说明可识别或可接入的模型家族，不表示《福福算力》是相关模型厂商的官方渠道、代理商或关联方；
• 首页覆盖产品认知和业务能力，模型页承接模型选择与价格查询，文档页承接开发接入需求，联系页承接技术支持和服务咨询；
• 文案避免使用“官方接口”“永久稳定”“绝对安全”“最低价格”“无限并发”等难以持续证明或可能引起误解的表述；
• 搜索排名还取决于页面可抓取性、加载速度、内容质量、站点地图、内外链、域名信誉和持续更新，不能仅依赖关键词文件。

七、更新规范

1. 修改 SEO 内容时，应直接修改对应 TXT 文件，不得在文件中附加版本号、日期或修改说明。
2. 产品名称统一写作《福福算力》，公司主体需要出现时统一写作“成都一路向北科技有限公司”。
3. 标题应准确概括页面内容，并将重要业务词放在较靠前位置；同一标题不应机械重复关键词。
4. 摘要应使用完整自然语句说明服务对象、主要能力和页面价值，不应简单罗列关键词。
5. 关键词文件使用英文半角逗号分隔；新增关键词前应确认网站确实提供相关服务，避免引入不相关流量。
6. 新增公开页面时，建议继续采用 seo_页面_位置.txt 的命名规则，并同步更新本说明文档中的对应关系。
7. 每次调整后应检查页面源代码、移动端展示、搜索引擎抓取状态和实际点击表现，再根据真实数据迭代文案。