Earthquake24 不创造灾害事件，也不预测事件。确定性代码验证、标准化、版本化并发布 U.S. Geological Survey 报告的地震和面向美国的火山活动通报。
网站把上游发布内容转换成适合静态前端读取的数据包，同时保留来源身份、时间和状态等关键语义。处理过程可以拒绝无效响应并保留上一份有效资料，但不能改善台网本身尚未获得的观测，也不能把暂未发布的信息提前显示出来。
本方法涵盖什么
生产路径使用 USGS GeoJSON 地震摘要、ComCat 字段与链接、USGS HANS 火山活动通报、每两分钟运行的私有 Worker、R2 内容寻址 JSON 和静态前端。HANS 最多提供 7 天美国观测站通报；它不确认喷发，也不代表全球完整覆盖。GDACS 保持停用。路径不使用运行时 LLM、访客触发的来源请求、D1、KV、搜索历史、自建预测/影响圈、Google News RSS 或 Smithsonian GVP。
这里的“方法”同时涵盖上游测量怎样成为目录记录，以及记录进入网站后的获取、校验、发布和缓存规则。USGS 仍是事件资料的权威来源；Earthquake24 的版本对象只保存一次成功处理所得的展示快照，不取代 ComCat 或 HANS 的原始记录。
从地面运动到地震解
地震仪记录地面运动并产生数字地震图。P 波一般先于 S 波到达。多个台站向速度模型提供到时、振幅和几何信息；环绕震源的良好分布通常能更好约束位置。
持续波形中可能同时包含环境噪声、区域事件和远处事件。自动系统识别可能的震相并把多个台站的相容信号关联为候选事件，随后估计位置和震级。单一台站的振动通常不足以唯一确定震源，台网几何因此是解算的重要组成部分。
地震如何定位
软件比较观测与试验震源预测到时，调整纬度、经度、深度和发震时刻以减少残差。结果仍是估计：地球模型简化、仪器有噪声、震相可能难以识别，深度尤其可能不确定。
定位参数彼此相关：较深但较近的试验震源有时会产生与较浅但较远震源相似的部分到时。更多方位的台站、较清楚的 P 波和 S 波拾取以及适合区域的速度模型可以缩小这种歧义，但目录坐标仍带有测量和模型限制。
自动与审核解
automatic 表示系统在人工核验前发布；reviewed 表示有人查看过，但仍可能继续修订；deleted 表示来源从当前目录撤回。更多台站、重新拾取震相、改善深度或重新分类都可能改变记录。“已审核”不等于最终保证。
状态描述的是来源处理阶段，而不是事件严重程度。自动记录可能很快出现，也可能在审核中被合并、重分类或删除；审核记录仍会因后续分析获得新的首选震级或位置。网站传递当前状态，不自行把自动解提升为审核解。
USGS 发布什么
一小时、一天、七天和 30 天摘要每分钟更新。Earthquake24 用 all_day 在浏览器筛选 1 小时/24 小时，用 2.5_week 展示 7 天，用 2.5_month 展示 30 天；后两者来源下限为 M2.5+，网站初始显示筛选 M4+。
这些摘要是来源在请求时刻给出的当前集合，而非逐条追加日志。相同 ID 的属性可在下一份摘要中改变，来源撤回的记录也可能不再出现。窗口名称、来源最低震级与网站当前界面筛选是三个不同层次，不能由地图上暂时看不到某条记录推断上游没有该事件。
记录可含 ID、坐标、深度、震级/类型、地点、时间、状态、烈度、PAGER、链接和 tsunami 字段。该字段是元数据，不是警报。
GDACS 提供什么
GDACS 依据灾害、暴露、脆弱性和应对能力估计人道影响。其颜色不是震级、VEI 或地方命令。Earthquake24 生产环境不摄取 GDACS；其精确端点、模式、权利和人工审核仍未获批。
火山状态如何收集
USGS HANS 提供美国观测站的火山活动通报。来源最近历史接口允许 1–7 天：live 包采用最近 24 小时子集，week/month 可展示该 7 天来源窗口内仍可用的通报。通报不等于已确认喷发，也不是全球完整火山目录。Volcano Alert Level 与 Aviation Color Code 含义不同；GDACS 仍停用。
通报是观测站发布的文字与状态更新，可能涉及活动变化、例行说明或代码调整。Earthquake24 按通报时间和可用窗口整理这些项目，不把文字中提到的现象转换成独立喷发事件。month 视图名称也不会扩大 HANS 的历史能力：其可显示内容仍受最多 7 天来源窗口限制。
Earthquake24 数据管线
- 每 2 分钟私有 cron。
- 成本模式选择到期来源。
- 向允许的 USGS HTTPS 主机发送条件请求。
- 检查状态、跳转、类型和大小。
- 验证 JSON、模式、坐标、时间和范围。
- 标准化、过滤、稳定排序，并按精确 ID 去重。
- 内容变化时散列并写入不可变 R2 对象。
- 回读对象并校验字节 SHA-256。
- 最后更新指针。
- 浏览器加载并应用筛选。
失败或空来源不会覆盖最后一个有效包。
条件请求允许来源未变化时避免重复传输和写入。只有经过完整验证并产生实质变化的规范化内容才会创建新散列对象；对象回读的字节摘要与预期一致后，活动指针才切换。因此浏览器要么看到先前有效版本，要么看到已经校验的新版本，而不会依赖写入一半的数据。
为何不能承诺零延迟
| 时钟 | 含义 |
|---|---|
| 发震时刻 | 破裂开始 |
| 检测时刻 | 台网获得足够观测 |
| 来源发布 | 首次发布解 |
| 来源更新 | 后续修订 |
| Earthquake24 获取 | Worker 取回资料 |
| Earthquake24 处理 | 验证和发布完成 |
| 查看时刻 | 浏览器加载包 |
正常模式下 live 每 2 分钟、week 每 10 分钟、month 每 30 分钟；成本模式可减慢或暂停。来源检测、发布和缓存还会增加时间，因此显示真实时间戳而不承诺即时。
这些间隔表示各数据包到期后可被 Worker 获取的频率，不是事件从发生到被台网识别的上限。即使任务准时运行，来源尚未发布、条件请求未返回变化或浏览器仍持有短期指针缓存时，页面也可能继续显示上一版本。
字段映射和显示规则
| 字段 | 用途 | 限制 |
|---|---|---|
id | 精确身份 | 来源关联可能变化 |
mag | 显示震级 | 应与类型配对 |
magType | Mw、ML、mb 等 | 不能全部称 Richter |
place | 来源地点描述 | 非核实邮政地址 |
time | 发震时刻 | 非发布时间 |
updated | 来源修订时刻 | 可反复变化 |
| 坐标 0–1 | 震中 | 有位置误差 |
| 坐标 2 | 震源深度 | 可能约束较弱 |
status | 自动/审核 | 审核不等于最终 |
type | 地震等事件类型 | 默认筛选地震 |
mmi | 仪器烈度 | 非震级 |
cdi | 社区烈度 | 依赖提交报告 |
alert | PAGER 颜色 | 估计影响 |
tsunami | 来源标志 | 非海啸警报 |
url | 官方来源页 | 来源记录保持权威 |
修订、去重和删除
Earthquake24 只按精确来源 ID 去重，不按关联 ID、坐标或地点合并。每个 USGS 产品是完整当前快照：下一次成功完整来源中缺失的项目会从当前包消失。旧对象并不构成逐事件审计档案。
精确 ID 规则避免把时间和地点相近却实际不同的事件误合并。若来源为同一现象发布不同身份，网站不会凭相似度猜测关联关系；若同一 ID 的字段改变，则下一份成功快照以来源的新值为准。删除语义因此来自完整来源集合，而非网站的独立判断。
新鲜度与延迟数据
| 状态 | 距最近一次成功 USGS 获取 |
|---|---|
| Fresh | ≤10 分钟 |
| Delayed | >10 至 ≤30 分钟 |
| Critical | >30 分钟 |
来源中断时保留最后有效包，并按真实成功时刻老化状态，而不是清空地图。
新鲜度时钟依据最近一次成功的 USGS 获取，不会因浏览器重新加载或 Worker 仅执行但未成功获取而重置。这样，仍可读取的数据与其已经延迟的事实可以同时呈现，避免把旧包误标成刚更新的数据。
缓存与变更发布
| 对象 | Cache-Control |
|---|---|
| 不可变数据 | public, max-age=31536000, immutable |
| latest 指针 | public, max-age=120, stale-while-revalidate=600, stale-if-error=86400 |
浏览器仅在页面可见且在线时每 120 秒查询指针，复用不可变散列并验证 materialHash，不手动添加 If-None-Match。完整性依赖指针散列、内容和 SHA-256，不依赖 R2 ETag 或 CDN HIT 标签。每天 00:00 UTC 删除超过 48 小时的非活动 live/week/month 对象，同时保护活动指针目标；没有已实现的 30 天每日快照。
内容寻址把对象名称与规范化内容的摘要关联起来，所以相同内容可以复用，变化内容则获得新地址。48 小时保留策略针对已不再由活动指针引用的运行对象；当前 live、week 和 month 指针所指对象受到保护。清理旧版本不改变上游来源记录，也不构成长时期历史产品。
Earthquake24 明确不做什么
不计算影响/安全圈，不把 tsunami 字段变成警报，不改震级类型，不隐藏自动状态，不声称 GDACS 活跃或 HANS 通报确认喷发，不用 AI 生成事件值，不在数据层保存搜索或精确定位，也不预测地震。
隐私、成本与可靠性
页面为静态内容。普通访问不会触发 SSR、D1、KV 或 USGS 请求。条件获取、按变化写入、缓存和 48 小时清理限制操作量，但不构成零成本保证。
访客从已发布对象读取同一份公共数据，不向 USGS 代发逐访客查询。前端筛选在浏览器内完成，数据层不保存筛选文字或精确位置。可靠性来自保留有效包、延迟状态和不可变对象，而不是声称任何单一网络或缓存层永不失败。
已知限制
- 台站覆盖不均。
- 自动事件可能错误、移动或重分类。
- 深度、震级和地点可修订。
- 影响模型有不确定性。
- HANS 仅限美国观测站和最多 7 天，并非全球完整目录。
- 缓存可能短暂显示上一版本。
- 没有标记不证明没有事件。
常见问题
为何震级或位置改变？
更多资料、重新拾取或另一方法改变了来源首选解。
reviewed 是最终结果吗？
不是，后续分析仍可改变记录。
Earthquake24 是预警系统吗？
不是，它在来源发布后显示事件。
AI 会生成事件值吗？
不会，确定性代码处理来源字段。