diff --git a/src/content/dev/architecture.mdx b/src/content/dev/architecture.mdx
index d1b8647..2bbf524 100644
--- a/src/content/dev/architecture.mdx
+++ b/src/content/dev/architecture.mdx
@@ -156,7 +156,8 @@ POST   /api/db/restore             POST /api/db/vacuum
 同样按分钟成批写入。
 
 `metric` 的一行描述的是它之前的那一分钟，而不是某一时刻：网速由累计值的差算出，其余字段是这一分钟内的
-平均值。
+平均值。同一行另存这一分钟里 agent 报过的最高网速，聚合成宽窗口时取桶内的最大值，所以 7 天窗口里的一次
+测速仍是它当时的速率。
 
 ## 历史查询的两个上限
 
diff --git a/src/content/dev/theme.mdx b/src/content/dev/theme.mdx
index 32fb8ee..82b5257 100644
--- a/src/content/dev/theme.mdx
+++ b/src/content/dev/theme.mdx
@@ -74,6 +74,11 @@ hub 1.3.0 及更早的版本不做这项检查，所以以前装得上的包，
 - `points=W`：图表能画下的点数，60–1440。只会让 hub 抽得更稀，不会更密
 - `series=metrics|ping`：只取要画的那一类，另一类占响应的三分之一到三分之二
 
+`metrics` 的每一行描述一段时间：`net_rx` / `net_tx` 是这段时间的平均网速，画成线时积分等于累计流量；
+`net_rx_max` / `net_tx_max` 是其中最高的网速，按 agent 的一个上报间隔（默认 1 秒）测得，不小于平均值。
+一次 15 秒的测速在一分钟的平均值里只剩四分之一，在 7 天窗口里更低，要画它跑到过多高就读这两个 key。
+hub 1.3.0 及更早没有这两个 key。
+
 延迟监控的名称在响应的 `probes` 里随数据一起返回，匿名可读，画延迟图不需要第二个请求，也不需要登录。
 
 `ping` 里的记录按站长在面板上排的监控顺序逐个排列，同一个监控的记录按时间先后。按 `task_id` 第一次出现的