百度凤巢关键词管理：产品文档改版后旧文章哪些引用需要更新
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /d9f02de7d5b8.html
📄
百度凤巢关键词管理：产品文档改版后旧文章哪些引用需要更新
先给结论：决定一条旧引用去留的，不是“它是否提到已改名的字段”，而是它是否承担了让读者完成下一步动作的职责。如果读者照着旧引用操作会卡住、报错或得出相反结论，就必须更新；如果它只是帮助理解概念的背景说明，可以保留并加一句时间标注。产品文档改版后，建议先按“可执行引用”和“解释性引用”分两批处理，而不是把所有出现旧名称的地方一次性替换。
为什么改版后旧文章看起来“全错”，但真正要动的可能不到一半
常见矛盾是：文档改版上线后，搜索后台里带旧字段名的文章仍然有稳定访问，于是团队倾向于全部重写。但打开这些文章会发现，一部分只是用旧叫法解释概念，读者读完并不需要去后台点任何按钮；另一部分则直接教读者“在某个位置填入某个值”，而改版后这个位置已经不存在。
两种解释都成立，取决于文章承担的职责：
- 解释性引用：旧名称只是叙述对象，读者不需要据此操作系统。改版后它仍然成立，最多补充一句“该名称在现版本中已调整”。
- 可执行引用：读者需要按步骤进入后台、选择单元、填写值或判断状态。一旦界面结构或字段归属变了，这类引用会直接导致操作失败。
能区分两者的证据不是访问量，而是读者读完后的动作路径。一个可用的判断动作是：把文章里的每一步操作在改版后的后台里走一遍，记录在哪一步无法继续。走不通的那一步所在的段落，就是必须更新的引用；能走通但名称不同的部分，属于可延后处理。
先锁定三类必须更新的可执行引用
产品文档改版通常改变的是入口位置、字段归属和判断口径，而不是把所有概念推翻。以下三类引用一旦对不上，读者就会卡住，应优先处理：
- 指向具体入口的路径描述。例如旧文写“在计划层级的关键词列表里批量添加”，而改版后关键词管理被收进单元设置，读者按旧路径找不到入口。这类引用要改成新的层级关系，或直接删掉路径、只保留操作目标。
- 依赖字段名称填写或核对的步骤。如果旧文要求读者核对某个字段的取值来判断状态，而该字段已改名或拆成两个，读者会得出错误结论。更新时要写清现版本的对应字段，并说明旧值在新口径下如何理解。
- 以旧界面截图或旧状态描述为依据的判断句。例如“出现某提示即表示添加成功”，改版后提示文案变化，这类判断句会让读者误判结果。应改为描述可观察的结果，而不是复述当时的提示原文。
处理完这三类后，再回头看解释性引用。它们不需要逐条改写，但建议在文章开头或相关段落加一句适用范围说明，避免读者把旧口径当成现版本规则。
假设例子：一篇讲批量添加关键词的旧文该改哪几处
假设有一篇旧文，主题是“如何在关键词管理里批量添加否定词”，结构是：概念解释、入口路径、字段填写、结果核对、常见问题。改版后，关键词列表的入口层级变了，否定词的填写位置从计划层级移到单元层级，结果提示文案也换了。按上面的分类处理：
- 概念解释段保留，因为“否定词的作用”没有随界面变化。
- 入口路径段必须更新，否则读者第一步就找不到位置。
- 字段填写段必须更新，因为层级归属变了，照旧填会填错层级。
- 结果核对段改为描述可观察结果，不再复述旧提示原文。
- 常见问题里如果有一条问“为什么添加后不生效”，要检查它的原因解释是否还成立；如果原因指向已调整的层级逻辑，也要一并更新。
这个例子说明：更新量取决于引用是否可执行，而不是旧名称出现的次数。名称出现十次但都只是解释，改动量可能小于只出现一次却教读者点按钮的段落。
用一次走查结果决定下一步，而不是凭感觉全量重写
实际操作上，可以按下面顺序推进，每一步的结果都会影响下一步的范围：
- 列出改版后受影响的功能点，而不是列出所有旧文章。
- 对每个功能点，挑一篇最典型的旧文，按读者路径走一遍，记录断点位置。
- 如果断点集中在入口和字段，说明这次改版影响的是操作层，优先更新所有含操作步骤的文章；纯概念文章可以暂缓。
- 如果走查发现旧文里的判断口径仍然成立，只是名称不同，那么更新范围可以缩小到加注说明，不必重写正文。
- 更新完成后，再抽查一篇未改动的解释性文章，确认读者不会把它误当成现版本操作指南。
需要说明的是，旧文访问量下降或某些词请求量归零，并不能单独证明某条引用已经失效，它也可能只是搜索需求转移或文章被其他页面替代。反过来，访问量稳定也不代表引用仍然正确，因为读者可能读完就离开了。真正可靠的依据仍然是走查时能否完成操作。把走查记录留成一份清单，后续每次改版都可以复用，比每次重新判断更省力。
