度量文档长期不更新，先要把“长期”定义成可计算的时间窗，再确定纳入统计的文档范围，然后计算超期未更新文档占比，并用更新覆盖率、访问后未更新率、失效反馈率等指标交叉验证。这样得到的是一份可复算的文档盘点结果，能定位问题集中的文档类型和责任人。在知识库日常管理中，文档的最后更新时间、评审状态和反馈记录可以衔接ONES的文档管理动作，让度量结果直接进入处理流程。
要点总览（TL;DR）
- 度量文档长期不更新，先把“长期”定义成可计算的时间窗（如90/180/365天），再确定纳入统计的文档范围，然后计算超期未更新文档占比。
- 主指标用“超期未更新文档数÷纳入统计文档总数”，辅助指标用更新覆盖率、访问后未更新率、失效反馈率和平均未更新时长交叉验证。
- 口径要写清分母、时间窗、更新判定（实质修改与格式微调的区别）、单位和缺失值处理；新建未满时间窗的文档从分母排除，分母为零时写“本期无纳入统计的文档”。
- 计算后按文档类型、责任人、业务域拆解，把主指标与辅助指标指向重合的文档列为优先处理项，形成待评审清单。
- 未更新不等于内容失效，指标只标出需要重新检查的范围；时间窗调整会显著改变结果，跨期比较须保持口径一致。
度量目标：先明确要回答什么问题
文档长期不更新的度量，第一步是写清这份数据要支持哪个决策。目标不同，指标选择、时间窗和拆解维度都会变化。常见目标有三类：盘点有多少文档已经超期，用于制定清理计划；评估某类文档的健康状况，用于判断维护投入是否足够；跟踪改进效果，用于验证上一轮更新动作是否生效。
把目标写成一句话，包含使用者、对象和用途。例如：“知识库负责人每季度盘点产品类文档，识别超过180天未实质更新的文档，形成待评审清单。”这句话已经隐含了分母（产品类文档）、时间窗（180天）和产出物（待评审清单），后续口径围绕它展开即可。
需要区分两类判断。“识别长期未更新文档”是清单式判断，输出的是具体文档列表，指标服务于排序和筛选；“评估文档健康度”是整体判断，输出的是比例和趋势，指标需要覆盖多个维度。前者适合用主指标加简单拆解，后者需要辅助指标交叉验证。两类目标可以同时存在，但应分别设定口径，避免用一套数字回答两个问题。
度量边界也要提前说明。本文讨论的是知识文档在生命周期中的更新时效，研发资产基线与配置管理、内容审核与发布流程属于其他管理环节，不在度量范围内。度量结果指向“哪些文档需要被重新检查”，不直接判定文档内容对错。
指标与范围：主指标与辅助指标怎么选
主指标选“超期未更新文档占比”，它直接回答“有多少文档超过了设定的更新时限”。公式为：超期未更新文档数 ÷ 纳入统计的文档总数 × 100%。这个指标适合盘点和管理汇报，口径简单，便于按类型、责任人、业务域拆解。
主指标单独使用会遗漏两类情况：文档刚过期限但无人访问，和文档被频繁访问却始终未更新。辅助指标用来补上这些信息。
| 指标 | 回答的问题 | 适用场景 |
|---|---|---|
| 超期未更新文档占比（主指标） | 有多大比例的文档超过更新时限 | 整体盘点、季度汇报、按维度拆解 |
| 更新覆盖率 | 统计周期内发生过实质更新的文档占应更新文档的比例 | 跟踪改进动作是否覆盖目标文档 |
| 访问后未更新率 | 被访问过的超期文档中，访问后仍未更新的比例 | 识别“有人用但没人维护”的文档 |
| 失效反馈率 | 收到失效或过期反馈的文档占纳入统计文档的比例 | 用读者反馈验证未更新是否已造成实际影响 |
| 平均未更新时长 | 超期文档距最后实质更新的平均天数 | 判断问题是普遍轻微超期还是少数严重陈旧 |
指标要与文档类型对应。操作手册、接口说明、流程规范对时效敏感，适合较短时间窗；制度类、背景介绍类文档内容相对稳定，时间窗可以放长。把不同稳定性的文档放进同一个分母，会稀释问题或放大问题。建议按文档类型分组计算，再汇总整体比例。
纳入范围要明确写出。通常纳入处于“生效”或“使用中”状态的正式文档；临时会议记录、一次性通知、已归档文档可以排除，排除规则要固定并随结果一起说明。归档文档如果仍可被检索和访问，可以单独统计，不计入主指标分母。
数据口径：分母、时间窗与更新判定
口径决定结果能否复算。每个指标至少写清分子、分母、时间窗、单位和缺失值处理五项。
| 项目 | 口径说明 |
|---|---|
| 分母 | 统计截止日处于生效状态、属于指定文档类型的文档数；排除临时文档、已归档文档和统计期内新建未满一个时间窗的文档 |
| 时间窗 | 90天、180天或365天，按文档类型的时效敏感度选择；同一份报告内保持一致，跨期比较时不变更 |
| 更新判定 | 以内容实质修改为准，包括正文段落增删改、步骤或参数变更；纯格式调整、标签修改、元数据变更不计入 |
| 单位 | 占比类指标用百分比，保留一位小数；时长类指标用天 |
| 缺失值 | 无最后更新时间的文档单独列出，不默认计入超期，也不从分母中静默删除 |
时间窗的选择依据是文档的失效速度，而非统一标准。接口文档变更频繁，90天未更新就值得检查；年度制度文档用365天更合理。同一指标在不同时间窗下的数值不可直接比较，报告中应标注所用时间窗。需要观察趋势时，固定时间窗按季度复算。
更新判定是最容易产生争议的部分。建议在统计前约定一份判定规则：正文内容变化计入更新；调整标题层级、修正错别字、更换封面不计入；仅修改负责人或分类标签不计入。规则确定后，取数时按规则过滤，避免把格式维护算成内容维护。对于自动记录的最后编辑时间，需要确认它反映的是内容修改还是任意保存动作。
新建文档的处理要单独说明。统计期内新建且尚未满一个时间窗的文档，不满足“长期未更新”的前提，应从主指标分母中排除，或单独统计。分母为零时，结果写“本期无纳入统计的文档”，不写0%，避免把“没有数据”误读为“问题为零”。
计算与评估步骤：从取数到结论
计算流程分为五步，每步都有明确的输入和产出。
- 取数。导出纳入范围的文档清单，字段包括文档标识、文档类型、责任人、业务域、创建时间、最后实质更新时间、统计期内的访问次数、收到的失效反馈记录。取数截止日统一，避免不同来源时间不一致。
- 按口径计算。对每份文档判断是否超过时间窗，得到超期标记；汇总计算主指标和各项辅助指标。计算时保留分子分母原始数值，便于复核。
- 按维度拆解。至少按文档类型、责任人、业务域三个维度分组计算主指标。拆解的目的是定位集中区，例如某类接口文档超期比例明显高于其他类型，或某个业务域的文档普遍长期未更新。
- 交叉验证。检查主指标标出的超期文档，与访问后未更新率、失效反馈率指向的文档是否重合。重合部分优先级最高；只有主指标标出、无访问也无反馈的文档，可以降低处理优先级；有失效反馈但未超期的文档，说明时间窗可能偏长，需要复核。
- 形成问题清单。把文档按“超期且被访问”“超期且有失效反馈”“仅超期”分组排序，标注责任人，给出建议动作：重新评审、更新内容、归档或合并。清单是度量的最终交付物，比例数字用于说明规模，清单用于推动处理。
在知识库管理中，这套流程可以衔接ONES的文档状态与评审动作：文档的最后更新时间、评审记录和读者反馈作为取数来源，超期清单可以直接转为待评审的文档任务，更新完成后状态变更又成为下一期复算的数据。度量与处理在同一个流程里闭环，避免统计结果停留在报表上。
算例：一组文档的完整计算示例
以下为演示情景，数据为假设值。某产品团队统计产品类文档，时间窗设为180天，统计截止日为6月30日。纳入统计的生效文档共120份，其中统计期内新建未满180天的文档8份，从分母中排除，实际分母为112份。
按最后实质更新时间判断，超过180天未更新的文档为35份。主指标：35 ÷ 112 × 100% ≈ 31.3%。
辅助指标计算如下：
- 更新覆盖率：统计期内发生实质更新的文档为28份，应更新文档按上期超期数加本期到期数计为52份，28 ÷ 52 × 100% ≈ 53.8%。
- 访问后未更新率：35份超期文档中，统计期内被访问过的有20份，访问后仍未更新的有17份，17 ÷ 20 × 100% = 85.0%。
- 失效反馈率：112份文档中收到失效反馈的有9份，9 ÷ 112 × 100% ≈ 8.0%。
- 平均未更新时长：35份超期文档距最后实质更新的天数合计为9,450天，平均270天。
交叉验证发现，9份有失效反馈的文档中有7份同时属于超期且被访问的文档，这批文档优先处理。另有3份文档未超期但收到失效反馈，说明其内容可能因外部变化而失效，时间窗对该类文档偏长，下一期可将该类文档时间窗调整为90天。最终形成待处理清单：优先处理7份，常规评审13份，其余15份超期文档结合访问情况安排归档或合并。
解读与限制：指标能说明什么、不能说明什么
超期未更新占比说明的是文档在时间维度上的维护状态，不能直接等同于内容错误或质量差。稳定类文档长期不修改仍可能准确有效，例如基础概念说明、长期有效的制度条款。指标标出的是“需要重新检查”的范围，检查结论要由责任人评审给出。
指标与团队绩效的关系需要谨慎处理。把超期比例直接作为考核项，容易促使责任人做形式化更新，例如只改日期或调整格式，反而破坏更新判定的可信度。更合适的用法是把超期清单作为维护计划的输入，考核更新动作的完成情况，而非单纯压低比例。
时间窗调整会显著改变结果。同一批文档在90天和365天口径下，超期比例可能相差数倍。跨期比较、跨团队比较时必须确认时间窗和分母一致，否则数字不可比。报告里应同时写明时间窗、分母和排除规则，让读者能自行复算。
单一指标不足以支撑结论，建议结合访问数据和反馈数据做二次判断：被频繁访问且收到失效反馈的超期文档，问题最明确；无访问、无反馈的超期文档，可能只是使用场景消失，处理方式以归档为主。持续跟踪时，固定统计周期和口径，按季度复算主指标与辅助指标，观察超期清单是否缩小、优先处理项是否完成，用连续几期的结果判断改进是否有效。
常见问题
时间窗到底该选90天、180天还是365天？
时间窗依据文档的失效速度来定，不设统一标准。接口说明、操作手册这类变更频繁的文档，90天未更新就值得检查；年度制度、基础概念说明内容相对稳定，用365天更合理。同一份报告内时间窗保持一致，跨期比较时不要变更。如果某类文档频繁收到失效反馈却未超期，说明当前时间窗对该类文档偏长，可以单独调短，并在报告中标注。
文档只改了错别字或调整了格式，算不算更新？
按内容实质修改判定，不算更新。正文段落增删改、步骤或参数变更计入更新；调整标题层级、修正错别字、更换封面、修改负责人或分类标签不计入。建议统计前先约定这份判定规则，取数时按规则过滤。另外要确认系统记录的最后编辑时间反映的是内容修改还是任意保存动作，否则容易把格式维护算成内容维护，虚高更新覆盖率。
统计期内新建的文档要不要放进分母？
新建且尚未满一个时间窗的文档，不满足“长期未更新”的前提，应从主指标分母中排除，或单独统计。否则新文档会拉低超期比例，掩盖老文档的问题。排除规则要固定，并随结果一起说明。没有最后更新时间的文档单独列出，不默认计入超期，也不从分母中静默删除。
超期比例算出来以后，怎么判断哪些文档先处理？
用辅助指标交叉验证。超期且被频繁访问、同时收到失效反馈的文档，问题最明确，优先处理；只有超期、无访问也无反馈的文档，可能只是使用场景消失，以归档或合并为主；未超期但收到失效反馈的文档，说明时间窗对该类文档偏长，需要复核。最终交付物是分组的待处理清单，比例数字用于说明规模，清单用于推动评审和更新。
能不能把超期未更新占比直接作为团队考核指标？
需要谨慎。把比例直接作为考核项，容易促使责任人做形式化更新，比如只改日期或调整格式，反而破坏更新判定的可信度。更合适的用法是把超期清单作为维护计划的输入，考核更新动作的完成情况，而非单纯压低比例。持续跟踪时固定统计周期和口径，按季度复算，用连续几期的结果判断改进是否有效。
