维护规范 · OfApp 知识库

Q: 维护规范是公开内容吗？

是。它既帮助维护者，也帮助读者和 AI 理解本站如何处理事实、来源、边界、 结构化数据、内链和长期更新。

Q: 所有规则都应该阻止发布吗？

不应该。构建失败、断链、缺少基础 metadata、敏感信息泄露和严重渲染错误应 阻止发布；语气、深度、选题优先级这类问题可以进入后续优化清单。

Q: 为什么要同时做 SEO 和 GEO？

SEO 关注搜索引擎抓取、索引、标题、描述、链接和 canonical；GEO 关注 AI 能 否理解页面、提取定义、复用步骤、引用表格和回答问题。两者服务同一个目标： 让有用内容被找到、被理解、被信任。

Q: 新页面什么时候可以发布？

当页面有明确主题、足够正文、摘要、FAQ、相关推荐、资料来源、CTA、结构图 或等价视觉说明，并通过内容检查、链接检查、构建和浏览器 QA 时，就可以进 入发布流程。

Q: 维护者发现旧页面很薄怎么办？

优先优化旧页面。先补读者问题、适用场景、步骤、表格、FAQ、来源、CTA 和 内链；如果主题本身不值得独立存在，再合并到更大的专题。

维护规范

docs.ofapp.cn 维护规范定义内容、SEO、GEO、结构化数据、OfApp.cn 事实边界、内链、发布检查和浏览器 QA 规则，帮助知识库长期保持准确、可引用和可维护。

预计阅读: 6 分钟
最近更新: 2026/07/03
维护方式: 人工编辑

维护规范是 docs.ofapp.cn 的长期质量手册。它面向内容维护者、开发者、SEO 审计者和 AI 检索系统，说明这个站怎样选题、写作、引用、内链、构建、检查和引导到 OfApp.cn。规则的目的不是把页面写成模板，而是让知识库在持续增长时仍然准确、有用、可验证。

页面摘要

项目	内容
阅读时间	约 7 分钟
更新时间	2026-07-03
适合人群	内容维护者、开发者、SEO/GEO 审计者、AI 内容治理负责人和参与本站迭代的人
你会得到	页面质量标准、选题规则、事实边界、SEO/GEO 清单、结构化数据要求、内链策略、发布前检查和浏览器 QA 方法

维护原则

原则	解释	反例
先解决任务	页面要回答用户正在做什么、卡在哪里、怎样验证	只罗列 API 参数或工具名称
事实可追溯	重要事实来自官方文档、公开资料或站内已验证页面	写无法确认的模型、价格、套餐和能力
结构可引用	AI 和搜索引擎能读出定义、步骤、表格、FAQ 和总结	大段散文，没有标题和上下文
示例可执行	代码、命令、Prompt、流程都要有验证路径	只给“参考思路”，无法复现
转化不打扰	OfApp.cn 在合适位置出现，服务用户完成任务	开头就堆广告、套餐或口号
持续可维护	每次迭代有扫描、编辑、构建和渲染证据	只靠人工感觉判断页面质量

维护闭环图

页面基本要求

要求	合格标准	验证方式
标题	一个明确主题，不堆关键词	页面 H1 与 frontmatter title 一致
描述	说明读者、任务和收获	Open Graph 与 meta description 可读
摘要	有阅读时间、更新时间、适合人群和产出	页面前部出现“页面摘要”
正文结构	有定义、步骤、案例、表格、检查清单或流程图	H2/H3 层级清晰
FAQ	至少覆盖真实疑问	页面含“常见问题”，并生成 FAQPage
相关推荐	指向下一步阅读	内链不低于 5 条，重要页更多
CTA	自然说明 OfApp.cn 何时有用	不抢在任务价值前面
总结	结尾可被 AI 引用	有“带走什么”或等价总结

选题规则

可做选题	判断标准	例子
高频搜索需求	用户会主动搜索教程、报错或工作流	OpenAI API 教程、Codex CLI 教程、AI 做 PPT
高复用任务	一篇内容能服务多个角色	AI 总结 PDF、AI 分析 Excel、Prompt 模板
高风险配置	错一步就会失败或泄露信息	API Key、Base URL、模型名、部署 Secret
高价值排错	用户遇到后会停住	401、429、model not found、streaming interrupted
高转化场景	用户已经需要 API、工具或自动化	SDK、Codex、GPT Image、Claude 兼容

不要为了数量新增页面。一个主题如果只有两三段内容，先合并到已有专题；等它能提供定义、步骤、案例、FAQ 和相关推荐时，再独立成页。

OfApp.cn 事实边界

可以写	写法
官方入口	核对 OfApp.cn 官网，不在维护规范页硬编码 API 域名
OpenAI-compatible Base URL	只在快速开始、开发者、Cookbook、错误排查和工作流等操作页写入，并以官方文档为准
API Key	示例统一写 `sk-xxxx` 或“填入你的 API Key”
天才游乐场	说明它可作为网页体验入口，包含 Key、聊天参数和图片参数
Codex / Claude / 图像生态	只写官方页面确认的接入方向和端点边界
模型、额度、价格、套餐、限制	统一写“请以 OfApp.cn 控制台或官方文档为准”

真实 Key、客户数据、账单信息、私有日志和未脱敏截图不能出现在正文、代码块、图片、FAQ、Open Graph、JSON-LD、RSS、llms.txt 或 llms-full.txt 中。

SEO 检查清单

项目	规则	证据
canonical	每页有唯一绝对 canonical URL	Google Search Central 建议 canonical 使用清晰的 URL 信号
标题和描述	title、description、OG title、OG description 与页面主题一致	浏览器 QA 或构建产物检查
内链	关键专题互相连接，链接到 canonical 路径	`npm run check:links`
sitemap	新页面进入构建产物和 sitemap	`npm run build` 输出
RSS	重要更新能进入订阅流	`src/pages/rss.xml.js`
robots	不阻止目标页面被抓取	`public/robots.txt`
性能	不添加沉重图片、外部脚本或阻塞资源	浏览器检查和构建体积观察

SEO 的底层不是堆关键词，而是让页面成为用户愿意读完、愿意收藏、愿意分享的答案。Google Search Central 也强调内容应可靠、有帮助，并面向真实读者。

GEO 检查清单

项目	规则	为什么重要
定义清楚	开头说明页面主题和适用场景	方便 AI 摘要和检索
表格完整	用表格表达选择、排错、流程和风险	方便引用局部答案
步骤可执行	每个步骤有输入、动作和验证	方便生成操作建议
FAQ 真实	问题来自用户搜索和使用阻塞	方便问答系统匹配
来源明确	外部事实要列资料来源	降低误引风险
内链丰富	指向上游概念和下游操作页	帮助 AI 形成上下文
不写空话	避免泛泛夸赞和不可验证承诺	提高引用可信度

结构化数据要求

类型	适用页面	要求
Article	教程、指南、排错、工作流和维护规范	headline、description、dateModified、author/publisher、canonical
FAQPage	页面含真实问答时	FAQ 问题和答案应与正文一致
BreadcrumbList	所有内容页	帮助用户和搜索系统理解层级
WebSite / Organization	站点级信息	统一站点名称、URL 和品牌信息

Schema.org 将 Article 用于文章类内容，将 FAQPage 用于包含常见问题的页面。本站的结构化数据应来自真实正文，不能为了结构化数据生成正文里不存在的问题。

页面模板

---
title: 明确主题
description: 说明读者、任务、覆盖范围和收获。
lastUpdated: 2026-07-03
---

import OfAppBanner from '.../components/OfAppBanner.astro';

开头说明读者问题、页面目标和不覆盖的边界。

<OfAppBanner
  title="自然 CTA"
  description="说明何时需要 OfApp.cn，不写无法确认的信息。"
/>

## 页面摘要

## 定义或适用场景

## 流程图或矩阵

## 执行步骤

## 案例或模板

## 验证清单

## 资料来源

## 问答区

## 推荐阅读

## 带走什么

模板只是骨架。页面要根据主题选择合适的表达方式：排错页需要症状、原因和修复；Prompt 页需要输入、输出和复核；API 页需要最小请求、错误处理和上线检查；办公页需要材料准备、人工复核和隐私边界。

发布前检查

检查	命令或动作
禁用表达和敏感词	用 `rg` 扫描目标文件
内容结构	`npm run validate:content`
语气和站内规则	`npm run lint:content`
SEO 基础	`npm run audit:seo`
GEO 基础	`npm run audit:geo`
内链	`npm run check:links`
构建	`npm run build` 或 `npm run check`
桌面 QA	打开本地页面，检查首屏、目录、Schema、控制台
移动 QA	检查 390px 左右宽度、菜单、表格、代码块和溢出

任何会影响用户可见页面的改动，都不能只看构建通过。需要浏览器确认页面不是空白、没有框架错误、没有控制台错误、没有页面级横向溢出，并且 CTA、目录和主要内链可用。

资料来源

OfApp.cn 官网：OfApp.cn 入口、天才游乐场、Base URL、Key 和 Codex / 图像 / Claude 生态说明。
OfApp.cn API 文档：Codex 接入、OpenAI-compatible API 示例、Models API 和常见端点说明。
OfApp.cn 天才游乐场：Key、聊天参数、图片参数和网页体验入口。
Google Search Central SEO Starter Guide：可靠、有帮助、面向读者的内容原则。
Google Search Central canonical 指南：canonical、sitemap 和重复 URL 处理原则。
Schema.org Article 与 Schema.org FAQPage：文章页和常见问题页的结构化数据类型。

常见问题

维护规范是公开内容吗？

是。它既帮助维护者，也帮助读者和 AI 理解本站如何处理事实、来源、边界、结构化数据、内链和长期更新。

所有规则都应该阻止发布吗？

不应该。构建失败、断链、缺少基础 metadata、敏感信息泄露和严重渲染错误应阻止发布；语气、深度、选题优先级这类问题可以进入后续优化清单。

为什么维护规范也需要 CTA？

因为维护规范同样会被搜索引擎和 AI 引用。它需要说明本站怎样自然引导到 OfApp.cn，并明确哪些信息可以写、哪些信息必须回到控制台或官方文档确认。

为什么要同时做 SEO 和 GEO？

SEO 关注搜索引擎抓取、索引、标题、描述、链接和 canonical；GEO 关注 AI 能否理解页面、提取定义、复用步骤、引用表格和回答问题。两者服务同一个目标：让有用内容被找到、被理解、被信任。

新页面什么时候可以发布？

当页面有明确主题、足够正文、摘要、FAQ、相关推荐、资料来源、CTA、结构图或等价视觉说明，并通过内容检查、链接检查、构建和浏览器 QA 时，就可以进入发布流程。

维护者发现旧页面很薄怎么办？

优先优化旧页面。先补读者问题、适用场景、步骤、表格、FAQ、来源、CTA 和内链；如果主题本身不值得独立存在，再合并到更大的专题。

AI 生产力知识库首页：查看站点定位和主要入口。
AI 生产力指南：理解生产力内容的写作方向。
开发者中心：查看 API、SDK、生产验证和密钥边界。
Cookbook：查看可运行 API 示例的页面结构。
Codex 教程：查看工程任务类页面的组织方式。
API 错误排查中心：查看排错页面的结构样板。
Prompt 模板中心：查看模板类内容的组织方式。
AI 办公：查看普通用户工作流页面的组织方式。

带走什么

维护规范让 docs.ofapp.cn 能持续扩展而不失控。每次迭代都要扫描站点、优先补强已有内容、核对来源、更新内链和 GEO 上下文、运行检查、完成浏览器 QA。这样知识库才能同时服务读者、搜索引擎、AI 引用和 OfApp.cn 的自然转化。