关键词频率：产品文档改版后旧文章哪些引用需要更新
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /9e28866c88a7.html
📄
关键词频率：产品文档改版后旧文章哪些引用需要更新
先把结论说清楚：产品文档改版后，旧文章里需要更新的引用，不是所有提到旧术语的句子，而是那些会改变读者下一步动作的引用——包括功能名称、入口位置、参数含义、限制条件和操作顺序。判断依据不是“关键词频率”本身，而是这个引用是否仍然对应改版后的真实产品行为。若只是行文表述变化，可以不动；若读者照做会走错路，就必须改。
一个矛盾现象：术语替换率很高，可读者还是走错
假设某产品文档把“导出任务”统一改名为“生成任务”，同时把入口从设置页移到任务列表页。改版后，旧文章里“导出任务”这个词的出现次数可能下降得很明显，但仍有读者按旧文章操作失败。原因可能是：文章正文里的旧名称被替换了，但截图说明、按钮文案引用、参数单位、前置条件没有同步。
这里要区分两个层次。第一层是语言层引用：旧术语、旧标题、旧描述。第二层是行为层引用：读者据此点击哪里、填什么值、期待什么结果。语言层替换成本低，行为层更新才决定文章是否还能用。关键词频率下降只能说明文本表面变了，不能说明行为层引用已经正确。
两种解释：是术语变了，还是行为变了
旧文章需要更新的引用，通常来自两种不同原因，不能混为一谈。
- 解释一：只换了叫法。功能、入口、参数、限制都没变，只是产品团队统一了术语。此时旧文章仍能引导读者完成操作，只需在首次出现时补一句“现称××”，不必逐段重写。
- 解释二：行为路径变了。入口位置、参数默认值、权限条件、返回结果、操作顺序至少有一项变化。此时旧文章里的步骤、截图描述、注意事项都可能误导读者，必须按新路径核对并替换。
两种解释在表面上很像：旧词都变少了，新词都出现了。区别在于，解释一只影响阅读体验，解释二影响操作结果。把解释二误判成解释一，是改版后旧文章最常见的隐患。
能区分两种解释的证据：做一次动作映射
要判断某条引用属于哪种情况，可以拿旧文章里的每个动作句，对照改版后的产品实际行为做一次映射。动作句指包含“点击、选择、填写、提交、复制、等待、查看”等动词的句子。映射时问三个问题：
- 这个动作的对象名称变了吗？
- 这个动作发生的位置变了吗？
- 这个动作完成后的结果或限制变了吗？
三个问题都答“没变”，属于解释一；任意一个答“变了”，属于解释二。这个判断不依赖关键词频率高低，也不依赖文章字数。它依赖的是引用与产品行为之间是否仍然一一对应。
假设例子：旧文章写“在设置页把导出格式改为 CSV，再点击导出”。改版后入口移到任务列表页，格式选项新增“仅当前筛选结果”。动作对象名称没变，但位置和结果范围变了。按映射判断，这条引用属于解释二，需要更新位置描述，并补充结果范围说明。更新后，读者下一步才不会误以为导出的是全部数据。
更新清单：哪些引用优先改，哪些可以缓
产品文档改版后，旧文章的引用可以按影响程度分三档处理。
- 优先改：入口路径、按钮名称、参数默认值、权限条件、限制说明、操作顺序。这些引用一旦过时，读者会直接失败或得到错误结果。
- 随后改：截图说明、示例数据、术语首次出现处的旧称标注、相关文章链接锚文本。它们影响理解效率，但通常不会让读者立刻走错。
- 可以缓改：纯叙述性同义替换、不影响操作的背景描述、已经明确标注“旧版”的历史说明。这类内容保留旧称反而有助于版本对照。
实际动作上，可以先抽一篇旧文章做映射，把动作句逐条标为“仍对应”或“已偏离”。如果偏离集中在入口和参数，就把这两类引用列为第一批更新对象；如果偏离只在术语，就只加新旧名称对照。这个动作的结果会直接决定下一步：是进入批量核对，还是先停下确认产品行为是否还有未公开的变化。
规模化后的边界：不能把一篇的结论直接套到全部旧文章
个别样本成立，不代表规模化后仍然成立。某篇文章里“旧称加一句现称”就够用，换到另一篇讲权限或计费的文章，可能因为限制条件变化而必须重写整段。判断边界时，至少看两个条件：
- 该文章是否包含可执行步骤。包含步骤的文章，行为层引用权重更高，不能只做术语替换。
- 该文章是否被其他文章引用为前置说明。被引用越多，旧路径的误导会沿着链接扩散，更新优先级越高。
如果这两个条件都不满足，旧文章可以暂缓，等产品行为稳定后再统一处理。反过来，如果文章承担入门或排错职责，即使关键词频率看起来已经很低，也要优先核对行为层引用。频率高低不是更新指令，引用是否仍能带读者走对下一步才是。
