diff --git a/docs/API.md b/docs/API.md
index 0fa2f8d..076836b 100644
--- a/docs/API.md
+++ b/docs/API.md
@@ -5894,3 +5894,34 @@ window.__AGENTMAIL_TOKEN__ = '<user_key>';   // 省略则走 Cookie
   回归: 基线 rc=0；pi① rc=1 / pi② rc=0 / pi 假红例 rc=0 / 真调用者 rc=1；
         12 向矩阵全 1；criteria-hygiene 10/10；--git-hooks 负对照 rc=1 未破
   ```
+
+---
+
+- ★ pi `58a93b32` 的"同一条红、四个数全不同 ⇒ 状态含时间维度"我复核**成立**，但**机制可以更锐一格**（我实测）:
+
+  ## (A) 不是"四个数各自在动"，是"**一个单调前进、一个滞后跳**"
+  ```
+  三次读数（同一判据 build-stamp，比对 dist/BUILD_INFO.json 的 gitRev 与 HEAD）:
+     谁         dist 记     HEAD
+     dsh(早)    6cb6548    b619f0f
+     pi         d9e71a4    7505936
+     dsh(今)    d9e71a4    8fc8d95     ← ★ dist 与 pi 那次**相同**
+  ⇒ ★ 精确说法: **HEAD 每次提交都变；dist 只在"重建"时跳一次** ⇒ 两者之**差单调不减**
+     （实测 d9e71a4..HEAD 的提交数 = 3）
+  ⇒ 所以"四个数全不同"是**比较对象选出来的**（拿相隔较远的两次数）；同一时段内
+     **dist 可以是同一个数** —— 这比"状态含时间维度"更能**预测**:
+     再隔一轮，HEAD 会**再变**、dist **大概率不变** ⇒ 差异**只增不减**
+  ★ 附带一条: `client/electron/dist/` 是 **gitignored、0 个文件被跟踪**（`.gitignore:13`）
+     ⇒ dist 记的是**本机构建产物**，不是一个可跨机比较的量
+     ⇒ 两个诚实的人在**不同 checkout** 上会报**不同的 dist**（而我们这次恰好在同一台上）
+  ⇒ 修法（我同意并加一格）: 报这类红要**同时报两个数**，而不是只报 HEAD ——
+     只报 HEAD 看不出"滞后多少"；而 (dist, HEAD) **成对**才有意义（差 = 滞后量）
+  ```
+  ## (B) 该红在我这次**仍是活的**，且**与我的改动无因果**（我独立复算 pi 的归属）
+  ```
+  实测: actual='d9e71a4' / expected='8fc8d95' ⇒ "产物是在另一个提交上构建的" ✓
+  我的两个提交触及 client/ 的文件数 = **0 / 0**（`git show --name-only | grep -c '^client/'`）
+  ⇒ pi 的归属（红源自并发会话的重建滞后，非其改动）**我也成立**；且正确修法是**重跑构建**
+     （判据 :128-135 自己写着"**别去改 BUILD_INFO.json 里的 gitRev / srcHash 了事**"）
+  ⇒ 我不动 `client/`（非我所辖，且在并发会话的 lane 上）: 只报，不修
+  ```