关键词密度优化：产品文档改版后旧文章哪些引用需要更新
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /89abe5874322.html
📄
关键词密度优化：产品文档改版后旧文章哪些引用需要更新
结论先说：改版后要更新的不是所有含旧术语的句子，而是那些会让读者据此做出错误动作的引用——指向已删除章节的链接、引用已变更参数值的表述、以及依赖旧版界面的操作步骤。如果旧文章只是顺带提到产品名，且上下文仍然成立，可以不动。
先分清三类引用，再决定改还是留
把旧文章里的引用逐条过一遍，按影响面分三类：
- 会误导操作的引用：步骤里写的菜单路径、字段名、默认值，改版后已经变了。读者照着做会卡住，必须改。
- 会误导判断的引用：正文里引用了某个参数范围、限制条件或计费口径，改版后数值或规则变了。这类不改会让读者做出错误的方案选择。
- 仅作背景的引用：提到产品名、模块名或历史版本，但不承载操作和判断。改版不影响它成立，可以保留。
判断顺序建议从第二类开始，因为它最容易被忽略：操作步骤错了读者会自己发现，但一个过期的参数范围会被当成事实直接采信。
链接指向已下线页面时，先看它承担什么角色
旧文章里的内链如果指向改版后已删除或合并的页面，处理方式取决于这个链接在文中的作用。如果它是读者完成当前步骤的必经入口，比如“在XX页面配置”，那么必须换成新入口或删掉这一步。如果它只是延伸阅读，可以改为指向新的对应页面，或者直接去掉链接、保留文字描述。
这里有个容易踩的坑：把死链统一改成首页。读者点进去发现不是他要的内容，比看到一个明确的“此页已迁移”更糟。假设某篇旧教程里有五个内链指向已合并的文档，其中两个是操作入口、三个是参考阅读，合理做法是只修那两个入口，另外三个改成新文档的对应锚点或删除。
术语和参数变了，改文字比改链接更关键
产品改版常伴随术语替换，比如某个功能从“策略”改叫“规则”。如果旧文章里这个词出现在操作路径中，必须同步替换，否则读者在界面里找不到。如果它只出现在叙述性描述里，且新旧叫法读者都能理解，可以保留旧称并加一句说明。
参数值的变化更需要警惕。旧文章写“超时时间默认30秒”，改版后默认值变成60秒，这句话不改就是错误信息。处理时不要只改数字，要确认这个数字在文中是否被后续推理依赖——如果后面有一句“因此建议把批量任务控制在30秒内”，那整段逻辑都要重新检查。
一个反例：什么情况下“全都更新”反而有害
如果旧文章的核心价值在于记录某个历史版本的行为，比如迁移指南、版本对比或已废弃接口的说明，那么把里面的旧术语和旧参数全部替换成新版，会破坏文章本身的用途。读者来看的就是“旧版是怎么做的”。这种情况下应该保留旧表述，在文首加一句适用范围说明，而不是逐句改写。
判断依据是：这篇文章的读者是来完成当前操作，还是来理解历史差异。前者要更新，后者要标注。
下一步动作：先跑一遍影响清单，再决定改多少
具体做法是，从改版说明里拉出变更点清单——删了哪些页面、改了哪些术语、调了哪些默认值——然后拿这份清单去比对旧文章。比对时只标记“读者会因此做错”的位置，不标记“用词不一致”的位置。标记完成后按影响面排序，先改操作入口和参数值，再处理延伸链接，背景性引用留到最后或不动。
这个顺序的作用是：你可以在时间有限时先修掉真正会造成错误的部分，而不必为了统一措辞把有价值的旧内容改得面目全非。改完后，把每篇文章的处理结论记下来——改了哪几处、为什么留了哪几处——下次改版时这份记录能直接复用。
