研发知识库工具的推广效果，建议分两层度量：一层看推广是否真的被用起来，关注活跃贡献者、团队覆盖、检索与文档更新等使用行为；另一层看知识是否沉淀得住，关注复用、过期比例、评审通过和问题自助解决等质量结果。两层指标都要写清分子、分母、时间窗和取数来源，先定基线再定目标，用趋势和对照团队判断效果，避免把单一指标当作推广成功的全部证据。
要点总览（TL;DR）
- 推广效果分两层度量：使用行为层看目标团队是否接入、成员是否持续贡献和检索；知识质量层看文档是否被复用、是否准确、能否减少重复提问。
- 核心指标包括活跃贡献者占比、目标团队覆盖率、检索次数、文档创建与更新量、文档复用率、过期文档比例、评审通过率和问题自助解决率，每个指标都要写清分子、分母、时间窗、单位和取数来源。
- 取数来源覆盖访问日志、文档元数据、检索日志和工单问答记录；缺失数据要标注并写明排除规则，跨团队比较用占比或人均值做归一化。
- 评估按五步执行：定基线与观察期、按公式计算并保留分子分母、与基线或对照团队比较、用定性证据解释变化、形成结论与下一步动作。
- 指标上升不等于推广成功，需排除文档自然增长、迁移导入等因素；样本小或观察期短时看多周期趋势，指标用于团队级复盘而非直接绑定个人绩效。
推广效果要回答哪两个问题
推广知识库时，最容易出现的误判是“访问量涨了，就说明推广成功”。访问量只能说明有人打开页面，无法说明内容是否被采用、是否仍然准确。把评估拆成两层，可以让每个指标对应一个明确的决策问题，避免指标堆在一起却无法指导下一步动作。
第一层是使用行为层，回答“推广是否触达了目标人群，他们是否形成了使用习惯”。这一层关心谁在贡献、哪些团队接入了、检索和浏览是否发生在真实工作任务中、文档是否持续更新。它对应的决策是：继续扩大推广范围，还是调整推广方式，例如补充培训、优化入口或改变激励方式。
第二层是知识质量层，回答“沉淀下来的内容是否可复用、可信、能解决问题”。这一层关心文档被引用的比例、过期内容是否得到清理、评审是否真正发生、重复问题是否减少。它对应的决策是：是否需要补内容治理规则、安排评审资源或清理历史文档。
| 层级 | 要回答的问题 | 对应决策 |
|---|---|---|
| 使用行为层 | 目标团队是否接入，成员是否持续贡献和检索 | 继续推广、调整推广方式、补充培训或入口 |
| 知识质量层 | 文档是否被复用、是否准确、能否减少重复提问 | 补内容治理、安排评审、清理过期文档 |
评估周期可以和推广节奏对齐。推广启动后的前四到六周，建议按周观察使用行为，及时发现问题；进入稳定期后，按月或按季度观察质量指标和趋势。责任角色上，推广负责人对触达和活动负责，知识库管理员对内容结构和评审机制负责，团队负责人对本团队的使用习惯负责。三方共同看同一套口径，结论才容易对齐。
指标清单与统计范围怎么定
指标定义要写到可以直接复算的程度：指标名、公式、分子、分母、时间窗、单位和数据来源缺一不可。下面这组指标覆盖两层目标，数量和口径都可以按团队实际情况调整，但调整后要保持前后一致。
| 指标 | 公式 | 分子 | 分母 | 时间窗 | 单位 | 数据来源 |
|---|---|---|---|---|---|---|
| 活跃贡献者占比 | 活跃贡献者数 ÷ 目标团队在册成员数 | 时间窗内创建或更新过至少一篇文档的人数 | 目标团队在册成员数 | 近30天 | 百分比 | 文档元数据、成员名单 |
| 目标团队覆盖率 | 已接入团队数 ÷ 计划推广团队数 | 时间窗内至少有一名成员产生有效使用的团队数 | 推广计划中列明的团队数 | 推广周期内累计 | 百分比 | 访问日志、团队清单 |
| 检索次数 | 检索会话数 | 时间窗内发起的检索会话数 | 不适用，直接计数 | 近7天或近30天 | 次 | 检索日志 |
| 文档创建与更新量 | 新建文档数 + 有效更新文档数 | 时间窗内新建和发生实质内容更新的文档数 | 不适用，直接计数 | 近30天 | 篇 | 文档元数据、版本记录 |
| 文档复用率 | 被引用文档数 ÷ 活跃文档总数 | 时间窗内被其他文档、任务或工单引用过的文档数 | 时间窗内有访问记录的文档数 | 近30天 | 百分比 | 文档引用关系、访问日志 |
| 过期文档比例 | 过期文档数 ÷ 活跃文档总数 | 超过约定复核周期未更新且仍被访问的文档数 | 活跃文档总数 | 月末快照 | 百分比 | 文档元数据、复核记录 |
| 评审通过率 | 评审通过文档数 ÷ 提交评审文档数 | 时间窗内一次或多次评审后通过的文档数 | 时间窗内提交评审的文档数 | 近30天 | 百分比 | 评审记录 |
| 问题自助解决率 | 未转人工即关闭的咨询数 ÷ 知识库相关咨询总数 | 通过知识库内容解决、未升级为人工处理的咨询数 | 同期知识库相关咨询总数 | 近30天 | 百分比 | 工单、问答记录 |
统计对象要提前约定。活跃贡献者按人去重，同一人多次编辑只计一次；目标团队覆盖率按团队计，团队内只有一人使用也算接入，但可以另设“有效使用团队”门槛，例如至少三人产生检索或贡献行为。检索次数按会话计，同一会话内的多次关键词调整不重复计数。文档创建与更新量要排除格式调整、批量迁移等非实质更新，否则数字会虚高。
分母为零或团队尚未接入时，不要用零除或直接填零。建议在报表中标注“不适用”，并记录原因，例如“该团队尚未接入，覆盖率不计入本期”。如果某个指标连续多个周期分母为零，应检查推广范围是否遗漏，而不是把它当作表现良好。
数据从哪里取、怎么保证可比
推广效果的数据通常分散在几个地方：平台访问日志提供浏览和检索行为，文档元数据提供创建、更新、引用和版本信息，检索日志提供查询词和结果点击，工单或问答记录提供问题是否被知识库解决的证据。评估前先列一张取数清单，写明每个指标对应哪个系统、由谁导出、导出频率和字段含义，避免不同人算出不同结果。
缺失数据要标注而不是猜测。常见情况包括：成员名单与平台账号未完全对应、检索日志只保留短期、工单系统没有记录解决来源。处理规则可以统一为：缺失比例低于约定阈值的，按已匹配样本计算并在报表中注明覆盖率；缺失比例较高的，该指标本期只做趋势参考，不进入结论。排除规则也要写清楚，例如排除测试账号、机器人账号和批量导入产生的记录。
跨团队比较时，团队规模和文档基数不同会直接影响绝对数。十人团队和五十人团队的文档创建量不能直接比，建议统一使用占比类指标，或在比较绝对数时同时列出人均值、每百篇文档的复用次数等归一化口径。对照团队的选择也要有依据，优先选择业务性质、研发节奏相近且尚未推广或推广节奏不同的团队，而不是随意挑一个数字好看的团队。
定性证据同样需要记录方式。访谈可以围绕“最近一次通过知识库解决问题是什么时候”“哪些内容你反复查但找不到”设计问题，每次访谈保留时间、对象、角色和原话摘要。问卷适合收集满意度和查找难度，但要注明样本量和回收率。典型使用案例记录背景、使用动作和结果，避免只写“效果很好”这类无法核验的描述。
在取数与统计环节，如果团队使用 ONES Wiki 承载研发文档，页面组可关联项目，需求与文档互相对应，文档还能嵌入任务进度和报表，文档版本和页面访问记录也为更新量、复用关系提供了可追溯的基础。检索方面，ONES Wiki 支持多种类型搜索，附件内容也能被检索到，便于把检索日志和实际内容对应起来分析。需要说明的是，推广效果指标的具体报表口径仍需结合团队实际配置和导出方式确认。
计算与评估步骤
评估流程要保证别人拿到同样的数据能算出同样的结果。建议按以下五步执行，每一步都留下产出物。
- 确定基线期与观察期。基线期选推广启动前一个完整周期，观察期选推广启动后相同长度的周期，例如各取30天。产出物是一页评估计划，写明起止日期、涉及团队和指标清单。
- 按公式计算各指标，记录分子分母。每个指标保留原始分子、分母和计算结果，不要只留百分比。产出物是指标计算表，附数据导出时间和导出人。
- 与基线、对照团队或目标值比较。优先看趋势，再看与对照团队的差异，最后看是否接近事先设定的目标值。目标值应基于基线设定，没有历史数据时先设观察性目标，例如“活跃贡献者占比提升到基线的一倍”，而不是拍一个通用达标线。
- 结合定性证据解释变化原因。把指标变化与同期发生的推广动作对应起来，例如培训、入口调整、模板上线。访谈和案例用来解释“为什么涨”或“为什么没涨”，而不是用来替代数字。
- 形成结论与下一步动作。结论要区分“已观察到”“尚需验证”和“未发现变化”。下一步动作落到具体责任人和时间，例如补充某类文档模板、对低活跃团队做定向培训、清理一批过期文档。
五步走完后，评估报告不必很长，但应包含基线、观察期、指标表、对照说明、定性证据摘要和下一步动作。报告的价值在于支持下一次推广决策，而不是证明推广本身正确。
一个可复算的例子
以下为演示情景，数字用于说明计算方法，不代表任何真实团队的表现。假设某研发组织计划推广知识库，目标团队共4个，在册成员合计80人。基线期为推广前30天，观察期为推广后30天。
观察期内，有24人在知识库中创建或更新过文档，活跃贡献者占比为24 ÷ 80 = 30%。基线期同一口径为12人，占比15%，观察期是基线的两倍。4个目标团队中有3个至少一名成员产生有效使用，目标团队覆盖率为3 ÷ 4 = 75%；若按“至少三人使用”的有效团队门槛，则只有2个团队达标，有效覆盖率为50%。两个口径同时列出，可以避免把“一人接入”当成团队推广完成。
观察期内活跃文档总数为200篇，其中被其他文档、任务或工单引用过的有60篇，文档复用率为60 ÷ 200 = 30%。基线期活跃文档为160篇，被引用48篇，复用率同样为30%。复用率没有变化，说明文档数量增长的同时引用关系没有同步扩大，需要进一步查看新增文档是否集中在少数类型。
月末快照中，超过约定复核周期未更新且仍被访问的文档有30篇，过期文档比例为30 ÷ 200 = 15%。基线期为20 ÷ 160 = 12.5%，过期比例上升，可能与推广期文档快速增加、复核节奏未跟上有关。这个变化不能直接归因于推广动作，需要结合复核记录和文档类型分布进一步验证。
从这组数字可以得到的解读是：触达和贡献行为有明显提升，覆盖率按团队计较好、按有效使用计一般；复用率持平，说明知识被“写进来”但尚未充分“用起来”；过期比例上升提示内容治理需要补位。哪些变化可归因于推广动作，还需要对照未推广团队或查看同期培训、模板上线等记录，不能仅凭观察期数字下结论。
结果怎么解读、有哪些限制
指标上升不等于推广成功。文档创建量增加可能来自项目自然增长、迁移导入或考核压力，检索次数增加也可能因为内容难找、反复搜索。解读时要先排除这些替代解释，再看行为是否发生在真实工作任务中，例如文档是否被任务或工单引用、检索后是否打开了结果并停留。
样本小、观察期短时，结论要谨慎。四个团队、八十人的样本，单个团队的波动就可能改变整体百分比；三十天的观察期也可能刚好覆盖一个版本发布周期。这种情况下，建议看连续多个周期的趋势，并明确写出“当前证据不足以判断长期效果”。
指标应服务于改进推广方式，不宜直接绑定个人绩效。一旦文档数量与个人考核挂钩，容易出现拆分文档、重复创建、只写不评等现象，反而降低知识质量。更合适的做法是把指标用于团队级复盘，讨论入口是否好找、模板是否够用、评审是否占用了过多时间。
出现以下情况时，需要补充定性评估：使用行为指标上升但复用率没有变化；过期文档比例持续上升；问题自助解决率与工单量变化方向不一致；团队之间差异很大且无法用规模解释。此时通过访谈、观察典型工作流和抽查文档质量，往往比继续增加定量指标更能说明问题。
常见问题
推广刚开始，还没有历史数据，基线怎么定？
没有历史数据时，可以把推广启动前一个完整周期作为基线期，哪怕这个周期内使用量很低，它也是真实的起点。如果连平台访问记录都不完整，退一步用可获得的替代基线，例如推广前最后一次团队调研中的查找耗时、重复提问次数，或对照团队同期的使用数据。
基线期和观察期长度保持一致，例如各取30天，避免周期长短不同造成比较失真。基线确定后写进评估计划，中途不随意更换，否则后续趋势无法对齐。
文档复用率一直上不去，应该先查什么？
复用率持平或偏低，通常先查三件事：一是文档是否按任务场景组织，读者在解决问题时能否快速定位；二是文档是否被任务、工单或其他文档引用，缺少引用入口时内容容易被绕过；三是新增文档是否集中在少数类型，例如会议记录多、方案和排障记录少。
可以抽查一批高频检索词，看检索结果是否指向可用文档，再结合访谈确认成员是找不到还是找到了不用。复用率反映的是内容被采用的程度，单靠增加文档数量通常难以改善。
不同团队规模差异很大，指标还能横向比较吗？
绝对数不适合直接比较，十人团队和五十人团队的文档创建量本身没有可比性。建议统一使用占比类指标，例如活跃贡献者占比、文档复用率、过期文档比例；需要比较绝对数时，同时列出人均值或每百篇文档的引用次数等归一化口径。
对照团队的选择也要有依据，优先选业务性质、研发节奏相近的团队。团队规模差异过大时，可以只做趋势对比，不做排名式比较。
评估结果要不要和团队或个人绩效挂钩？
不建议直接挂钩。文档数量一旦进入个人考核，容易出现拆分文档、重复创建、只写不评等情况，指标会失真，知识质量反而下降。
更合适的做法是把指标用于团队级复盘，讨论入口是否好找、模板是否够用、评审是否占用过多时间，把结论转化为具体的推广方式调整。确需与考核关联时，优先选择质量类指标并设置复核机制，同时保留定性评估作为补充。
用 ONES Wiki 承载研发文档时，推广效果的数据从哪里来？
ONES Wiki 的页面组可关联项目，需求与文档互相对应，文档支持嵌入任务进度和报表，文档版本和页面访问记录为更新量、复用关系提供了可追溯的基础；搜索支持多种类型，附件内容也能被检索到，便于把检索行为与实际内容对应起来分析。
活跃贡献者、文档复用率、检索次数等指标的具体统计口径和导出方式，仍需结合团队实际配置确认，评估前先列清每个指标对应哪个系统、由谁导出。
