版本约定
- 方法版本：
1.0.0 - 输入注册表：
1.0.0 - 存储模式：
1 - 规范快照：
scorecard:five-factor:v1 - 原子读取模型：
scorecard:five-factor:v1:read-model - 种子健康：
seed-meta:scorecard:five-factor
通用评分规则
每个输入按冻结的目标点归一化为绝对 0–100 分，超出范围的值会被截断。评分器计算可用输入权重之和作为inputCoverage，按可用权重重新归一化加权均值，检查覆盖下限与必需组，再把未四舍五入的连续子分数映射为整数档位。不可用输入不会得到中性分，也不会进入均值。
当证据不足时，支柱返回 hasScore=false，而内部值为 score=null 与 subScore=null。公共 proto3 响应会用零占位，所以客户端必须先检查 hasScore。
下限包含在较高档位内。例如，40.0 正好是档位 3。发布的连续子分数保留两位小数，覆盖率保留四位小数。档位始终由未取整的子分数推导，因此四舍五入不会改变档位；但在边界附近两者可能按设计不一致：连续子分数
19.996 会发布为 subScore: 20.00 而 band: 1，并非 band: 2。请直接读取发布的 band，不要用发布的 subScore 重新推导。
不可用原因
封闭原因集合为：source-unavailable、country-unavailable、invalid-value、stale、coverage-below-floor、required-group-missing、missing-population 与 redistribution-blocked。每条可用证据包含输入 ID、数值、年份、单位、来源和来源键。保留的最后成功观测使用 quality=retained。
新鲜度与发布下限
V1 在评分前检查观测年龄。人口、食品平衡、食品库存和年龄结构最多 3 年；一次能源平衡最多 4 年；低碳发电、贸易多样性、劳动力和国防最多 5 年；其他年度输入最多 7 年。边界年份仍可用。来源内容年龄约定过期时，即使 Redis 仍保存数值，证据也返回stale。
新的每日批次只有在至少 180 个国家有一个可评分支柱、至少 150 个国家有可用人口证据，并达到食品 80、能源 120、人口结构 150、科技 120、国防 30 的可评分国家下限时，才替换最后成功批次。健康端点分别报告人口与五个支柱的计数。部分来源故障不会刷新健康状态或覆盖更完整的批次。
五个支柱
食品
来源以千公吨为单位，按千公吨 * kcal/kg / 1,000,000 转换为万亿千卡后再汇总。
覆盖下限为 0.70，生产 / 消费是必需输入。来源包括 USDA PSD、FAOSTAT、世界银行 AQUASTAT 静态证据与 UN Comtrade。集团先汇总生产与消费，再计算比率；库存与总使用也先汇总。水安全和进口多样性按有证据成员的人口加权。
能源
消费来自 OWIDprimary_energy_consumption。生产根据世界银行净能源进口 EG.IMP.CONS.ZS 推导：
覆盖下限为 0.60，生产 / 消费是必需输入。集团先汇总生产与消费 TWh，再评分；其他组成按人口加权。
人口结构
覆盖下限为 0.60。必须至少有一个年龄结构输入，以及一个教育、研究或劳动力输入。集团按人口加权成员未四舍五入的连续子分数，绝不平均整数档位。
科技
覆盖下限为 0.65，必须至少有一个连接性输入和一个创新输入。世界银行原始观测、年份与指标代码保留在证据中。集团按人口加权连续子分数。
国防
覆盖下限为 0.50。必须有一个态势输入（支出或人员）和工业平衡输入。SIPRI 原始转移记录不会存储或返回；在来源政策允许公开使用已推导 HHI 前，供应商多样性明确返回
redistribution-blocked。集团按人口加权连续子分数。
只有出口和进口都是同年、明确且有限的观测值时，工业平衡才可用。缺失的一方不会转换为零；明确观测到的零仍然有效。
集团规则
V1 官方预设为USMCA、EU27、BRICS、GCC、ASEAN 与 NATO。自定义集团接受 2–30 个唯一的大写 ISO-2 代码。一次请求必须选择一个预设或一个自定义列表。
成员资格于 2026-08-29 根据欧盟国家名单、BRICS 成员名单、东盟成员名单和北约成员历史核对。东盟预设包括东帝汶，BRICS 使用官方 11 国名单。成员变化必须记录在方法变更日志中。
变更日志
1.0.0 — 2026-08-29
- 首个五支柱方法版本。
- 冻结绝对档位、目标点、权重、覆盖下限、必需组、汇总规则、不可用原因与四舍五入规则。
- 添加来源安全的证据来源信息，并明确 SIPRI 再分发限制。
- 定义官方预设与自定义集团验证约定。