关键词选择策略：产品文档改版后旧文章哪些引用需要更新
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /75dfa04fa0db.html
📄
关键词选择策略：产品文档改版后旧文章哪些引用需要更新
结论先给：产品文档改版后，旧文章里需要更新的引用不是全部，而是那些把读者引向已改名、已迁移、语义已变或已下线的文档位置，并且这些引用在旧文中承担了解释、验证或下一步动作的功能。缺少完整数据和权限时，最小动作是先用站内搜索和链接检查列出候选，再按引用类型分级，而不是逐篇重写。关键词选择策略在这里的作用是判断旧文被搜索时读者带着什么意图，以及旧引用是否还满足这个意图。
先按引用类型分级，而不是按文章新旧排序
把旧文章中的文档引用分成四类，处理优先级不同。第一类是硬引用：链接指向具体文档页面、锚文本含旧功能名或旧版本号，读者点击后要完成配置、排错或下载。这类引用一旦失效，直接打断任务，应优先更新。第二类是软引用：正文提到“参见某文档”但没有链接，或链接指向文档首页，读者仍可自行找到新位置，可批量处理。第三类是语义引用：链接还能打开，但文档内容已改，旧文描述的行为与新文档不一致，这类最容易被忽略，却会让读者按错步骤操作。第四类是装饰引用：仅用于补充背景、不影响当前操作，可延后甚至保留。
分级依据是引用在旧文中的功能，而不是文章发布时间。一篇三年前的排错文，如果其中的硬引用仍指向有效文档，就不必因为“旧”而改；一篇上个月的介绍文，如果引用的文档在改版中换了名称，也需要更新。
缺少数据和权限时，先做能验证的最小动作
没有全站爬虫、没有编辑后台、也看不到访问日志时，仍可以做三件事。第一，用站内搜索旧功能名和旧文档标题，得到候选旧文列表，这一步只依赖公开搜索。第二，逐篇检查正文中的链接和提及，记录三项：链接是否可打开、锚文本是否含旧名称、上下文是否要求读者据此执行动作。第三，对无法打开或名称不符的引用，标注“待确认新位置”，不要凭猜测替换成相似文档。
这个动作的结果会直接影响下一步：如果候选集中在少数几篇高意图排错文，就优先人工核对这几篇；如果候选分散在大量介绍文，就先处理硬引用，软引用和装饰引用留到有权限批量替换时再动。不能从“链接可打开”推出“引用正确”，也不能从“搜索不到旧文档名”推出“旧文没有引用它”，因为文档可能已改名、页面可能未被索引、或搜索范围不完整。
一个反例：链接有效但语义已变，更新反而可能更糟
假设旧文写“在设置页开启同步后，文档会自动保存”，并链接到一篇名为“同步设置”的文档。改版后该文档仍在，链接有效，但新文档说明同步改为手动触发。此时如果只检查链接状态，会判定无需更新；如果直接把锚文本改成新文档标题，却不改正文描述，读者仍会按旧行为操作。正确的更新是同时修正正文句子和引用位置，而不是只换链接。
这个反例说明：链接检查只能筛出硬失效，不能替代语义核对。当旧文的核心结论依赖被改文档的行为时，引用更新必须连同结论一起改；如果只改引用，反而会让错误描述看起来更可信。
用关键词选择策略判断哪些旧文值得先改
关键词选择策略不是重新选词，而是判断旧文当前被搜索时的意图是否仍与文档改版后的现实一致。具体做法是：对每篇候选旧文，写出它主要回答的一个问题，再对照新文档是否仍支持这个答案。若旧文回答“如何开启某功能”，而新文档已改为“如何手动触发”，则该文属于必须更新；若旧文只是顺带提到该功能，可只改引用。
判断时避免两个误区。一是不要用关键词密度或字数阈值决定改哪篇，没有适用于所有网站的统一阈值。二是不要把旧功能名机械替换成新名称就当作更新，同义词换写不产生新价值，读者仍可能找不到对应步骤。可以假设一个比较方法：把旧文按“引用是否影响操作”和“文档是否已变”两个维度分成四组，优先处理同时满足“影响操作”和“已变”的那组；其他组按可获得的权限分批处理。
下一步动作与不能推出的结论
下一步是建立一张最小更新表，包含旧文地址、引用类型、当前状态、待确认的新文档位置、是否影响操作。每处理一条，就回填状态并决定是否继续检查同篇其他引用。这样做的结果是，你可以在没有完整数据的情况下先消除最可能打断读者的引用，而不是等待全量审计。
不能推出的结论包括：链接全部可打开不代表引用无需更新；某篇旧文没有出现在搜索结果中不代表它没有引用旧文档；引用更新完成不代表旧文排序或收录会变化。这些现象可能由索引、权限、页面结构或搜索意图等多种原因造成，不能单独归因于引用处理。把引用更新当作内容维护的一部分，而不是排名手段，才能让关键词选择策略回到服务读者意图的位置。
