内容聚类优化：产品文档改版后旧文章哪些引用需要更新
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /5bd7c046922f.html
📄
内容聚类优化：产品文档改版后旧文章哪些引用需要更新
先给出判断结论：不是所有提到旧版产品文档的句子都要改，只需要处理三类引用——被改版直接推翻的事实、指向已失效锚点或路径的链接、以及依赖旧前提才能成立的解释。其余只是顺带提及的句子，可以保留。下面用两种前提分别说明取舍依据、实施动作和例外。
前提一：改版只调整结构，概念和功能未变
如果这次改版只是把文档重新分组、改标题、换页面路径，产品能力本身没有增减，那么旧文章里需要动的部分集中在链接层，而不是论述层。
判断依据是：旧文章引用的那句话，在新文档里能否找到语义等价的内容。能找到，就只需要换链接目标；找不到，才需要改写句子本身。
实施动作可以按这个顺序做：先导出旧文章中所有指向文档站的内链，再逐一打开，记录三种状态——目标页仍存在且内容等价、目标页被合并到新页、目标页已删除。对第一种只更新锚文本措辞；对第二种改成新页链接并保留原句；对第三种才进入改写队列。做完这一步，改写队列的长度通常远小于链接清单的长度，下一步的编辑工作量就由改写队列决定，而不是由引用总数决定。
例外是那些把旧路径当作步骤说明写进正文的句子，比如“在设置页左侧找到某某分组”。这类句子即使链接能跳转成功，描述也已经和实际界面不符，必须按改版后的结构重写，不能只换链接。
前提二：改版改变了概念命名或功能边界
如果改版同时做了术语统一、功能拆分或能力下线，那么旧文章里凡是把旧术语当作正式名称使用的地方，都要重新评估，而不只是链接。
区分原因的证据有三条。第一，旧术语在新文档中是否还作为正式名称出现；第二，旧文章的解释是否依赖某个已被拆分的功能；第三，旧文章的结论是否建立在某个已下线能力之上。三条中命中任意一条，就属于必须改写的引用；三条都不命中，说明只是措辞差异，可以留到下次例行维护时再处理。
实施动作上，建议先给旧文章打两个标记：术语级和结论级。术语级只替换名称并补一句新旧对应说明；结论级要重读整段逻辑，因为换了概念之后，原来的推理链可能已经不成立。假设某篇旧文章用旧版“项目”概念解释权限继承，而新版把权限拆成了两个独立层级，那么即使把“项目”换成新词，原句的因果关系仍然是错的。这种情况下的动作是重写该段，而不是替换词。这个例子的数字和功能都是假设，只用于说明判断方法。
用引用类型决定处理优先级，而不是用文章新旧
文章发布时间不能作为判断依据。旧文章里可能全是仍然成立的通用说明，新文章里也可能有刚写下就过期的界面描述。更稳的做法是按引用类型排序：
- 步骤型引用：包含点击路径、按钮名称、界面位置，改版后最容易失效，优先处理。
- 定义型引用：给某个概念下定义或划定范围，术语一变就必须改，优先级次之。
- 佐证型引用：只是说“详见文档”而不复述内容，通常只需换链接，优先级最低。
按这个顺序处理，可以在有限编辑时间内先消除会让读者操作失败的引用，再处理表述不一致的问题。处理完步骤型引用后，回头检查定义型引用是否还成立，因为步骤改动有时会暴露定义层面的偏差。
哪些引用可以明确不动
有三类引用不需要因为这次改版而更新。第一类是引用文档中的通用原则，比如命名规范、数据结构说明，这些内容不随界面改版而变化。第二类是历史说明，文章本身就在描述某个旧版本的行为，读者预期看到的是当时的情况。第三类是外部引用，比如指向第三方规范的链接，和本次改版无关。
需要说明的是，抓取量下降、页面点击减少或某条内链的点击归零，都不能单独证明某条引用处理错了。这些现象还可能来自改版后导航变化、页面权重重新分配，或者读者路径整体迁移。要确认引用是否处理正确，应该回到引用本身：目标内容是否还能找到，句子描述是否和当前文档一致。这两个问题有明确答案，统计波动没有。
一次可执行的最小检查流程
如果不想做全量审计，可以只跑一遍最小流程：列出旧文章中所有指向产品文档的链接，逐个打开并记录目标页状态；对状态为“已删除”或“已合并”的链接，回读所在段落，判断该段是步骤型、定义型还是佐证型；按上文的优先级改写步骤型和定义型，佐证型只换链接；改完后重新打开这些段落，确认句子不再依赖旧版界面描述。完成后，把这次用到的判断标准记下来，下次改版时可以直接复用同一套分类，而不必重新讨论哪些引用要动。
