关键词密度计算，产品文档改版后旧文章哪些引用需要更新
📱 CCBot/2.0 (https://commoncrawl.org/faq/)
🔗 /ebc73d142c26.html
📄
关键词密度计算，产品文档改版后旧文章哪些引用需要更新
先给结论：改版后要更新的不是所有带旧术语的句子，而是那些会让读者按旧结构操作、或让计算示例得出不同结果的引用。判断依据不是旧词出现几次，而是这段引用是否承担了“可执行指令”或“数值前提”的角色。如果它只是叙述背景，通常可以保留；如果它指向按钮名称、字段顺序、默认值或公式变量，就必须逐条核对。
一个矛盾现象：样本文章改对了，批量替换后反而更乱
假设你抽查了五篇旧文章，把“关键词密度计算”统一改成新文档里的“关键词出现频率”，这五篇读起来确实通顺。于是你决定全站替换，结果发现部分文章里的示例数字对不上了：旧公式按“关键词次数÷总词数”计算，新文档改成了“关键词次数÷有效词数”，分母口径变了。此时术语虽然统一，读者照着旧例子算出来的结果却和新文档不一致。
这个现象说明，改版影响的不是词，而是词背后的计算前提和操作路径。密度这个词本身没有变，变的是它在新文档体系里挂靠的公式、字段和页面位置。只做术语替换，等于把旧结论套在新前提上。
两种解释，对应两类完全不同的更新范围
解释一：只是命名调整，计算逻辑没动
如果改版只是把“密度”改叫“频率”，公式、分母、示例数值、页面入口都没变，那么需要更新的引用仅限于直接引述旧名称的句子。判断证据是：拿新旧文档各跑一遍同一组示例数据，结果完全一致；旧文章里的操作步骤在新界面上仍能走通。这种情况下，批量替换术语加上人工抽查引用上下文即可，不必重写示例段落。
解释二：计算口径或操作入口变了
如果新文档调整了统计范围、默认排除项或结果展示位置，那么旧文章里所有依赖旧口径的示例、结论和操作步骤都会失效。判断证据是：同一组数据在新旧口径下结果不同，或者旧文章描述的入口在新文档中已经不存在。此时需要更新的不只是术语，还包括公式说明、示例数字、以及“先做什么再做什么”的顺序描述。
能区分两种解释的证据，来自三个可核对点
- 公式变量是否一致。把新旧文档的计算公式并排写出来，看分子分母的定义是否相同。如果分母从总词数变成有效词数，所有示例都要重算。
- 示例数据能否复现。用旧文章给出的数字，按新公式算一遍，看结果是否与文中结论一致。不一致的段落属于必须更新。
- 操作路径是否仍然可达。旧文章说“在某某面板查看密度”，如果新文档已经把这个指标移到其他位置或改为导出后计算，那么这句引用就是失效指令，需要改写或删除。
这三个点里，只要有一个不成立，就不能把该文章归入“只改词”的类别。反过来，三个点都成立时，强行重写反而增加出错概率。
一个注明假设的短例子：如何决定改哪几句
假设某篇旧文章写道：“把关键词密度控制在百分之二左右，先统计总词数，再除以关键词出现次数。”改版后新文档的定义变成“关键词出现次数除以有效词数，且代码块和表格不计入”。此时需要更新的引用有两处：一是公式方向写反了，二是分母口径变了。动作是重新计算该段示例，并把“总词数”改为“有效词数”。结果是读者按新例子能得到与新文档一致的结果，下一步才能安全地保留这段作为教学示例。
如果同一篇文章还有一句“密度只是参考，不必刻意凑数”，而新文档并未否定这个态度，那么这句可以不动。它的作用是提醒判断边界，不承担计算或操作功能。这个对比说明：更新范围由引用功能决定，不由关键词出现位置决定。
规模化处理时的取舍：先标记功能，再决定动作
面对大量旧文章，可以按引用功能分三类处理，而不是按关键词密度计算这个短语的出现次数排序：
- 指令型引用：告诉读者点哪里、填什么、按什么顺序操作。这类必须对照新文档逐条验证，失效的改写，仍有效的保留。
- 数值型引用：给出公式、示例数字或阈值。这类要用新口径重算，算完再决定是改数字还是改整段结论。
- 背景型引用：解释概念、说明用途或提醒注意事项。这类只要不与新文档冲突，通常不必因改版而重写。
执行顺序建议从指令型开始，因为它的失效最容易被读者直接感知；数值型次之，因为错误结果会误导判断；背景型最后处理，避免把大量时间花在低风险句子上。每完成一类，记录哪些文章已核对、哪些仍依赖旧口径，这样下一步排查时不会重复劳动。
需要提醒的是，旧文章访问量下降、旧页面抓取减少或某术语搜索结果变化，都不能单独证明这批引用已经处理正确。它们可能来自改版之外的多种原因。真正能说明处理有效的，是你抽查的指令型引用在新文档下都能走通，数值型引用按新公式都能复现。
