为什么GEO报表里的 unknown 不能写成 0？

先按指标判定证据是否够用

同一份回答可以让一个指标可判定，让另一个指标保持未知。冻结问题没有提示品牌，入口和会话符合协议，完整正文也已保存：正文未出现品牌，就可以把自然提及记为0。来源面板没有保存，并不会抹掉这项正文证据；但需要来源片段核对的引用支撑仍应记为unknown。若正文截断或被挑战拦截，则不能判断完整回答是否提及品牌。

同理，公开搜索未观察到某个URL，需要先确认查询成功且结果可判读。网络错误不是0条，User-Agent没有出现也不能反推搜索引擎从未发现页面。建议将“观测质量”和“业务结果”拆成两个字段，而不是用一个数字兼任。

四个状态解决四种不同问题

失败也不总等于0。发布接口明确拒绝稿件是执行失败；平台显示文章已公开但阅读量明确为0，才是数值0。not_applicable则用于协议主动排除的项目，避免它长期伪装成待补数据。

有效样本描述不等于冻结批次结论

假设计划5格，2格提及、1格未提及、2格受阻。可以报告“已完成3/5格；可判定样本中2/3提及；另有2格受阻”，但2/3只是当前可观测子集的描述，不能替代原定五格的终局验收。若协议要求完整冻结矩阵，批次仍未完成，不能通过删除受阻格改变验收分母。

分母由指标合同预先决定。观测完成率以计划格数为分母，受阻格仍在其中；自然提及的已观测描述则用可判定格数。未知不能伪造为未提及，也不能借排除未知美化通过率。建议接口同时返回observedCount、plannedCount及每格状态，并说明各百分比的分母。前端和导出不得把空值默认填成0。

用三个反例验收报表

• 正常样本：完整回答没有品牌，应稳定显示0并进入有效分母。
• 负向输入：伪造完成标记但缺原始回答，应拒绝聚合。
• 边界样本：来源标题可见但URL缺失，应保留“来源可见、URL未知”两个字段。
• 状态恢复：blocked后重测成功，只追加新观测，不改写旧证据。
• 空批次：计划已建立但尚未运行，显示待观测，不显示0%。

未知边界是：unknown本身不说明结果更好或更差，只说明证据不足。补测应由协议、时间窗和阻断原因决定，不能为了得到好看的百分比临时重问。

上线前怎样检查空值没有被悄悄补零

现场可以准备五条固定记录：明确命中、明确未命中、采集超时、验证码阻断和协议不适用。依次核对数据库枚举、API JSON、后台卡片、CSV导出与latest报告，确认五个消费面没有使用默认值把后三类变成0。再加入“正文完整、来源缺失”的边界样本，检查自然提及与引用支撑是否分开判定。

例如接口返回null，前端显示“0次”，即使总计暂时相同也属于口径错误。停止规则是未知被改成负结果、分母偏离冻结合同，或不完整批次被宣布通过。修复后应再用空批次和blocked转为observed的追加样本回归，证明旧证据没有被覆盖。