GPTMap 文章维护指南：半年重测、版本同步与下架

文章上线只是开始。下面是 GPTMap 编辑部对一篇已发布文章的标准维护流程——把单篇文章从一次性产出变成长期可引用的资产。

1. 维护的两种触发

周期触发（半年）

半年是硬性底线。超过 6 个月不重测，文章会进入两种风险：

• 代码示例报错：OpenAI 改了 endpoint、SDK 方法名或参数结构，老示例照抄会失败
• AI 摘要引擎降级：未更新的 softwareVersion / lastTestedAt 让 ChatGPT/Perplexity 把它归为 stale source，引用权重下降

事件触发（不等周期）

三类事件命中任意一条，立刻排期重测：

1. OpenAI 发布新主版本（如 GPT-5.6 这类家族级更新）
2. 文章引用的模型或 API 字段被 deprecate / 下线
3. officialReferences 里的某个链接 404 或大幅改动

事件触发比周期优先。

2. 重测执行步骤

按下面顺序跑一遍，约 1 小时一篇。

2.1 通读 + 列变更清单

读一遍全文，把所有"应该变"的断言记下来：价格、版本号、API 字段名、官方引用源。这一步要带怀疑心——你写的代码 6 个月后不一定还能跑。

2.2 更新 frontmatter 的三个时间字段

如果 OpenAI 模型版本变了，同步改 openaiVersion——这会自动写进 Article schema 的 softwareVersion，AI 摘要引擎据此判断时效。

2.3 更新正文 + 末尾的更新记录

按变更清单改正文。如果变动大，重写一段。末尾的 ## 更新记录 块加一条新行：

## 更新记录

- 2026-08-08：GPT-5.6 家族更新，重测代码示例，bump openaiVersion → gpt-5.6
- 2026-02-12：链接迁移至 developers.openai.com
- 2026-01-05：首次发布

按时间倒序排列，给读者直接的版本信号。

2.4 跑 SEO/GEO 必查清单

按 .agents/skills/add-content step 8 的 grep 脚本：title / description / canonical / robots / hreflang / OG / Twitter / JSON-LD（softwareVersion / applicationCategory / FAQPage / Breadcrumb / Person / Organization / mainEntityOfPage / image / citation / inLanguage / speakable）全部存在；H1 = 1。

pnpm lint && pnpm build 必须通过。

2.5 链接健康度核查

抓页面内所有外链：

# 例：用 curl 检查所有 officialReferences 是否还活着
grep -oE 'https?://[^"]+' apps/web/content/posts/<slug>.zh.md | sort -u | xargs -I {} curl -s -o /dev/null -w "%{http_code} {}\n" {}

4xx / 5xx 修或替换；重定向到错误目标的修。

3. 下架决策

文章不建议直接删——会产生 404。三个选项：

generateStaticParams 默认 false，所以想真删一篇必须显式从代码里的 slug 列表移除。

4. 维护的元数据信号

4.1 Schema.org 的 lastReviewed

GPTMap 的 Article schema 在 frontmatter 有 lastReviewedAt 时会输出 lastReviewed 字段。Google Quality Rater Guidelines 把"最近人工 review 时间"作为 E-E-A-T 的重要信号。

4.2 softwareVersion 自动更新

openaiVersion 字段同时驱动：

• frontmatter 的人工标注（你写）
• Article JSON-LD 的 softwareVersion（schema 自动）

改一次，两边都更新。这就是为什么 SEO/GEO 必查清单里有"渲染 HTML 的 softwareVersion 必须与 frontmatter openaiVersion 字节一致"。

5. 维护节奏建议

6. 常见错误与排查

• 半年不重测、frontmatter 也不动 → AI 摘要引擎判定 stale，引用权重下降
• 更新了正文但忘了 bump 时间字段 → schema 没变，搜索引擎以为你没维护过
• 链接 404 没发现 → 用户点开失败、SEO 评分扣
• 直接删文章产生 404 → 失去外链权重；下次有人引用就死链
• 改了世界线但忘了同步相关文章 → 同一设定在不同文章里不一致，互相打架

7. 下一步

• 《GPTMap 编辑手册：写一篇高质量 OpenAI 文章的 12 步清单》— 写作阶段
• 《OpenAI 模型更新日志（2026 持续更新）》— living changelog 参考
• 《Deep Research 提示词模式与配额策略：让 ChatGPT 跑出高质量调研报告》— 引用核查的标准方法

更新记录

• 2026-08-08：首次发布