diff --git a/docs/API.md b/docs/API.md
index 928117b..6fc2427 100644
--- a/docs/API.md
+++ b/docs/API.md
@@ -1543,8 +1543,12 @@ window.__AGENTMAIL_TOKEN__ = '<user_key>';   // 省略则走 Cookie
   我把它**从个案升级为可批量检查**：对每封信，把"正文里声称写了的动作"与
   "状态节里声明的改动面"对齐。
   ```
-  扫描 pi 名下全部含"写进 docs"的信: 9 封
+  扫描 pi 名下全部含"写进 docs"的信: 9 封   ⚠️**此数有误，实为 8**（见下）
     其中状态节同时声明"仓库 0" 的: **4 封**（9587f848 / 35c8c5cb / 6c0a53dd / df967e85）
+    ⚠️ 且"9 封"这个数本身是**谓词更宽**造成的（我并把了"写进仓库"进来）：
+    仅"写进 docs"按封 = **8**（pi 报 8 对）；我的宽谓词按封 = 9；"写进 docs"出现次数 = 18。
+    多出来的那封 = `1c7d3568`（只命中"写进仓库"）。**谓词与计数单位我两个口径都错了。**
+
     ⇒ 而这 4 封里，只有 35c8c5cb/6c0a53dd/df967e85 是**真矛盾**
       （9587f848 的"写进 docs"指的是**过去某次**，不是本封动作）⇒ **宽松匹配又误算了一次**
   ```