跳转到正文

证据政策 ​

本页结论:关键结论按证据等级分级管理;可靠性、事务与故障恢复结论必须有官方来源(E1),可实验的关键路径同时提供仓库内实验输出日志(E2)。

证据等级 ​

等级证据可支持的内容
E1官方规范、官方文档、官方 Release Notes产品语义、配置、支持范围
E2仓库内固定版本可重复实验(demos/<产品>/<实验>/*.out.txt 输出日志)已观察行为、日志与状态变化
E3官方工程博客 / 设计文档设计背景与实践建议,需注明上下文
E4第三方文章或个人经验仅作补充,不支撑关键保证

使用规则 ​

  • 可靠性、事务、数据安全与故障恢复结论必须至少有 E1;可复现的关键路径同时提供 E2。
  • 引用官方资料必须直接指向支撑该结论的页面,并记录核对日期(checkedAt),见官方资料基线。
  • 实验输出日志写入 demos/<产品>/<实验>/<角色>.out.txt,断言结果写入同目录 assert.out.txt(逐条 PASS/FAIL);镜像版本以 .env.versions 锁定为准。
  • 若官方行为与实验不一致:先标记问题与环境信息,不为了让测试通过而改写结论。

内容事实检查清单 ​

写作与评审时逐条核对:

  • [ ] 是否把营销描述改写成可验证的技术边界?
  • [ ] 是否说明版本、配置和前置条件?
  • [ ] 是否区分生产确认、Broker 持久化、消费确认和业务提交?
  • [ ] 是否写明故障发生在哪个时间窗口?
  • [ ] 是否区分原生功能、客户端功能、框架模式和业务代码?
  • [ ] 是否有官方来源?可实验的结论是否有输出日志?
  • [ ] 是否避免跨产品的错误同义词替换?
  • [ ] 是否写明不保证什么?

以统一实验验证消息系统语义边界