> ## Documentation Index
> Fetch the complete documentation index at: https://www.worldmonitor.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 修订与更正日志

> 已发布的方法修订，以及规划中的 Energy Atlas 自动资产变更日志。

<Note>
  本公开日志记录 WorldMonitor 数据集和方法的重要修订。
  Energy Atlas 自动资产变更写入器仍在规划中。
  当前 Energy Atlas 上线的内容包括每个
  RPC 响应（`ListPipelines`、`ListStorageFacilities`、
  `ListFuelShortages`、`ListEnergyDisruptions`）内的证据包，以及说明
  公开徽标如何从这些证据包推导而来的方法论页面。在资产变更写入器上线前：
  `GetPipelineDetail.revisions` 和 `GetStorageFacilityDetail.revisions`
  返回空数组，且不存在自动化的纠错提交流程。
</Note>

## 已发布的修订

| 生效日期 | 产品 | 修订 | 发布影响 |
| - | - | - | - |
| 2026-09-05 | 国家页面 / 国家简报 | **撤回单一来源的简报；更正简报文本与依据。** 生成的国家简报现在仅在其依据标题来自至少两家不同发布者时才会发布；基于单一媒体合成的 24/48/72 小时展望将被撤回，页面保留带日期的标题。此前用于选取依据标题的国家匹配器会将 ISO 双字母代码当作单词匹配，导致少数简报基于其他国家的新闻生成（例如澳大利亚页面上出现了"非洲联盟（AU）"的报道）；现在页面、仪表板与 MCP 工具共用同一个匹配器。此外，简报曾直接渲染原始 markdown 标记，且对一线表之外的国家，"这对……意味着什么"标题中显示的是 ISO 代码而非国家名称。 | 适用于每个已索引的国家页面、其数据集下载以及每周冻结快照。在 2026-09-04 快照中，40 篇已发布简报中的 18 篇被撤回（含错误国家的简报，以及一篇仅基于同一家媒体三篇文章的简报），其余 22 篇以结构化文本呈现并在标题中使用国家名称。自此次更改后的首次刷新起，新简报的依据与命名均正确。参见 [PR #7762](https://github.com/koala73/worldmonitor/pull/7762)，对应 [issue #7748](https://github.com/koala73/worldmonitor/issues/7748) 与 [issue #7738](https://github.com/koala73/worldmonitor/issues/7738)。 |
| 2026-09-02 | 咽喉要道状态 | **分离各数据源的可用性。** NGA 航行警告、AIS 快照、中继通行量与 PortWatch 变动现为四个独立的可用性域，因此某一数据源缺失不再隐藏另一数据源的有效数值，不可用的读数也绝不会显示为实测零值或平静水平。合并的警告行拆分为航行警告与 AIS 中断，拥堵项标注为 AIS 拥堵。 | 适用于全部 13 个咽喉要道页面、仪表板面板、冻结快照、OpenAPI 客户端和公开 agent skill。早于新数据源标志的缓存负载与冻结快照按失败关闭处理，因此警告、AIS 中断和 AIS 拥堵在新捕获替换之前保持撤回。参见 [PR #7535](https://github.com/koala73/worldmonitor/pull/7535)，对应 [issue #7529](https://github.com/koala73/worldmonitor/issues/7529)。 |
| 2026-09-01 | 咽喉要道状态 | **缺少通行量时撤回派生指标。** 即使当日通行量不可用，页面仍会发布周环比变动、航行警告数量和基于 AIS 的拥堵水平，这与页面自身的通行量免责声明相矛盾。现由共享的覆盖率规则撤回所有依赖缺失通行量的指标。 | 适用于全部 13 个咽喉要道页面及浏览器实时刷新路径。被撤回的数值显示为破折号或隐藏；通行量覆盖完整时的输出不变。参见 [PR #7515](https://github.com/koala73/worldmonitor/pull/7515)，对应 [issue #7503](https://github.com/koala73/worldmonitor/issues/7503)。 |
| 2026-06-01 | 国家韧性指数 | **P1-1 支柱聚合更正。** 支柱分数现在在支柱聚合中应用每个领域的设计权重。2026-05-28 快照使用了较早的仅覆盖率成员聚合，并保留为已标记的历史捕获。 | 实时分数、排名、历史和区间缓存代次同时更改。2026-08-29 全范围捕获是此次更正后的首个已发布国家快照。参见 [PR #4021](https://github.com/koala73/worldmonitor/pull/4021)。 |

可抓取的 CRI 快照工作流按计划在每月第一天运行（UTC `17 5 1 * *`）。它捕获经过凭据验证的全范围排名，重新构建可抓取内容和站点地图，然后打开拉取请求供审核。方法更正需要新的全范围产物时，也会发布计划外捕获。当前已发布的快照是 `resilience-ranking-2026-08-29.json`（捕获于 2026-08-29，在 P1-1 支柱聚合更正之后），并非月初定时运行的产物。

## Energy Atlas 自动修订日志（规划中）

WorldMonitor 的 Energy Atlas 发布的是证据包 — 而非观点 —
涵盖管道、储存设施、燃料短缺和中断事件。一个确定性的、带版本号的分类器将这些证据包转换为
公开徽标（资产为 `flowing` / `reduced` / `offline` / `disputed`；
短缺为 `confirmed` / `watch`）。

当分类器上线后，每次更改公开字段时 —
无论是因为证据更新、因为陈旧度衰减了徽标、因为
新版本分类器重新推导了旧资产，还是因为应用了
运营方/监管方提交的更正 — 都会在此写入一条
仅追加的条目。

这是设计好的审计界面。证据注册表本身
是前瞻性快照；而此日志一旦上线，将成为每个状态
如何演变至今的历史记录。

## 规划中的数据结构

每条条目计划为包含以下字段的行：

```ts theme={null}
{
  date: string,                 // ISO8601 — when the change was written
  assetOrEventId: string,       // matches an id in the pipeline / storage / shortage / disruption registry
  fieldChanged: string,         // e.g. 'publicBadge', 'physicalState', 'severity', 'evidence.sanctionRefs'
  previousValue: unknown,       // value before the change
  newValue: unknown,            // value after the change
  trigger: 'classifier' | 'source' | 'decay' | 'override',
  sourcesUsed: string[],        // URLs cited by the classifier for this change
  classifierVersion: string,    // version that produced newValue (e.g. 'badge-deriver-v1')
}
```

对应的 proto 接口位于
`GetPipelineDetail.revisions` 和 `GetStorageFacilityDetail.revisions`。
两者目前按设计返回空数组 — 处理器在代码注释中记录了
"修订日志将在发布后的版本中上线"，
而不是假装该接口已上线。

### 规划中的触发器词汇表

* **`classifier`** — 例行分类器运行从当前证据包
  重新推导该字段。预计上线后将是最常见的
  触发器。
* **`source`** — 新的证据源到达（监管方备案、
  运营方新闻稿、制裁名单更新），分类器
  相应地重新推导。
* **`decay`** — 证据超出陈旧时间窗口
  （注册表字段为 14 天，短缺证据为 30 天），分类器
  将非正向徽标降级为 `disputed` 或 `watch`。
* **`override`** — 应用了紧急手动覆盖。保留给
  读者标记的明显错误的分类器输出。
  覆盖条目将遵循与分类器条目相同的 `sourcesUsed` 规范。

## 当前已上线的内容

* **已发布的方法修订。** 本页表格记录影响公开数据集及其解释的变更。
* **每个资产上的证据包。** 点击 [Energy Atlas](https://energy.worldmonitor.app/dashboard) 上的任何管道、储存
  设施或短缺标记，即可查看其完整证据包：物理状态、商业
  状态、运营方声明（含 URL 和日期）、制裁引用
  （含授权方 + 名单 ID + URL）、分类器版本和置信度，
  以及最近一次证据更新的时间戳。这是当前
  主要的审计界面。
* **公开的方法论页面。** 推导规则、陈旧度
  窗口和证据阈值规范均已公开记录：
  * [管道注册表](/docs/zh/methodology/pipelines)
  * [储存设施](/docs/zh/methodology/storage)
  * [燃料短缺](/docs/zh/methodology/shortages)
  * [中断事件日志](/docs/zh/methodology/disruptions)
  * [咽喉要道](/docs/zh/methodology/chokepoints)
* **带版本号的分类器输出。** 每个 RPC 响应都携带
  `classifier_version` 字段。即使修订日志的版本历史
  界面尚未发布，读者今天就可以
  将预期锁定到某个版本。

## 当前尚未上线的内容

* 自动 Energy Atlas 资产级条目。分类器上线后，本页面将列出这些行。
* 自动化的纠错提交流水线。如果您发现
  错误，请使用
  [worldmonitor.app](https://www.worldmonitor.app) 上的反馈渠道，或在
  [公开仓库](https://github.com/koala73/worldmonitor/issues) 中提交 GitHub issue。
  更正目前尚未进入分类器的处理路径 — 如今它们
  是手动处理的。
* `override` 触发器的条目写入器。同样的依赖：
  随分类器一同上线。

## 今天如何验证徽标（分类器上线前）

在修订日志上线之前，Energy Atlas 上任何状态的
审计路径为：

1. 打开资产抽屉（点击管道 / 储存点 / 短缺
   标记）。
2. 阅读证据包 — 每个来源都附有发布
   日期和授权方（`regulator` / `operator` / `press` /
   `satellite`）的链接。
3. 查看该资产类别对应的方法论页面 — 推导
   规则是确定性的且带版本号的。
4. 如果所有证据都是最新的，且在走完规则后
   公开徽标仍然看起来有误，请在公开仓库
   提交一个 issue，附上资产 ID、当前证据包和您的
   推理。修订日志上线后，手动审核路径
   将生成 `override` 条目。

## 为什么在上线前记录此界面

在写入器落地之前发布规范有两个原因：

1. **契约稳定性。** `GetPipelineDetail.revisions` /
   `GetStorageFacilityDetail.revisions`
   中 `revisions` 的结构是 Agent 和 MCP 客户端消费的
   RPC 契约的一部分。现在记录它意味着下游消费者可以在
   实时数据到达之前就针对稳定结构编写代码。
2. **策略信号。** 证据优先的分类只有在
   审计轨迹被公开承诺的情况下才有效，而不能
   被当作内部实现细节。在写入器之前发布规划的结构和
   提交策略就是这种承诺。

这两个原因都不能成为夸大当前状态的理由。自动资产级条目开始出现后，
本页面会将状态提示替换为最后更新时间。