📍 WDQWDWQD987AAAAA:176.9.85.184
📱 Mozilla/5.0 (compatible; QlyzeBot/1.0; +https://app.qlyze.io/bot)
🔗 /d6d25adb7e9a.html
📄

网站内容采集：产品文档改版后旧文章哪些引用需要更新

产品文档改版后，旧文章里的引用不是按“新旧”统一处理，而是按“引用是否仍能独立支撑原结论”来分流。最该先改的不是所有链接，而是那些把旧参数、旧流程、旧接口名当作事实依据的句子；只作为延伸阅读的链接可以后置处理。

矛盾现象：链接还能打开，内容却已对不上

改版后常出现一种情况：旧文章里的链接返回正常，页面标题也还在，但正文里的字段名、步骤顺序或限制条件已经变了。此时如果只看链接状态码，会误判为“无需更新”；如果只看文档版本号，又会把所有旧文一次性重写，成本过高。两种做法都跳过了真正要判断的对象——引用在句子里承担什么作用。

两种解释：引用失效是因为事实变了，还是因为指向变了

第一种解释是事实层变化：旧文章引用的参数值、默认行为、权限要求在新版文档中已不成立，链接只是恰好还能打开。第二种解释是路径层变化：事实本身没变，只是文档拆分、合并或改名，导致锚点和上下文位置移动，读者按引用跳过去后找不到对应段落。

这两种解释对应不同动作。事实层变化需要改句子，甚至删掉依赖旧事实的整段论证；路径层变化通常只需换锚点或补一句定位说明，不必重写结论。

区分两种解释的证据：做一次引用用途标注

把旧文章里所有指向产品文档的引用逐条标出用途，可以分成三类：

• 支撑型引用：句子结论依赖被引段落里的具体值、条件或顺序。这类引用一旦事实变化，必须改正文。
• 定义型引用：只是让读者知道某个术语的出处，结论不依赖细节。路径变化时换锚点即可。
• 延伸型引用：放在文末或段落末尾供进一步阅读，不影响当前段落成立。可以最后批量处理。

区分证据不在链接本身，而在句子去掉引用后是否还成立。把引用暂时拿掉再读一遍，如果结论悬空，它属于支撑型；如果读起来仍然完整，它更可能是定义型或延伸型。

一个假设例子：先改哪三条，结果如何影响下一步

假设某旧文章写“将超时时间设为 30 秒即可避免重试”，并链接到配置文档。改版后文档把默认超时改为 60 秒，且新增了重试上限说明。此时这条引用属于支撑型：句子里的 30 秒和“即可避免”都依赖旧文档事实，必须先改。

同篇文章末尾还有一条“更多配置见文档”的链接，属于延伸型，可以等正文改完再统一检查锚点。先处理支撑型引用的直接结果是：你会得到一份必须改写的句子清单，而不是一份待替换的链接清单；这份清单会决定下一步是重写段落，还是只调整跳转位置。

可执行的分流顺序与适用条件

1. 先筛出支撑型引用，逐句核对新文档中的对应事实是否仍成立。
2. 事实不成立时，改句子或删论证；事实成立但位置变化时，只换锚点。
3. 定义型和延伸型引用放到最后，按新文档结构统一校正。

这套顺序适用于旧文章仍在产生访问、且产品文档是其主要事实来源的情况。如果旧文章已经不再被任何入口引用，或者其结论本来就不依赖产品文档，那么优先处理支撑型引用的收益会明显下降，此时更合理的动作是先决定文章是否保留，而不是逐条修引用。

判断引用是否需要更新，最终看的是它在句子里的角色，而不是它指向的页面是否还能打开。