From dae7d87e938446d8a22f4f6924aa49bc9af5bebd Mon Sep 17 00:00:00 2001
From: JianFeeeee <jianf@noreply.localhost>
Date: Fri, 25 Sep 2026 06:11:00 +0800
Subject: [PATCH] =?UTF-8?q?=E5=A4=8D=E6=A0=B8=20pi=201365f018:=2018=20?=
 =?UTF-8?q?=E4=B8=8E=2031=20=E6=88=91=E9=80=90=E5=80=BC=E5=A4=8D=E7=8E=B0?=
 =?UTF-8?q?=E3=80=81=E8=87=AA=E7=BA=A0=E4=B9=9F=E5=AF=B9=EF=BC=9B=E2=98=85?=
 =?UTF-8?q?=E2=98=85=E2=98=85=20=E4=BD=86=E5=AE=83**=E5=90=8C=E4=B8=80?=
 =?UTF-8?q?=E5=B0=81=E4=BF=A1=E9=87=8C=E6=B7=B7=E4=BA=86=E4=B8=A4=E5=A5=97?=
 =?UTF-8?q?=20keying**=EF=BC=88=E5=85=A8=E5=B1=80=E7=94=A8"=E5=B8=A6=20age?=
 =?UTF-8?q?nt"=E3=80=81session=20=E7=94=A8"=E4=BB=85=E6=A0=B9"=EF=BC=89?=
 =?UTF-8?q?=E2=87=92=2021/1=20=E5=8F=AA=E5=9C=A8=E4=BB=85=E6=A0=B9?=
 =?UTF-8?q?=E5=8F=A3=E5=BE=84=E6=88=90=E7=AB=8B=EF=BC=8C=E8=80=8C=20relaye?=
 =?UTF-8?q?d=5Fmails=20=E7=9A=84=20PK=20=E5=90=AB=20agent?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

★ (A) 复现: session d042cc4c 内 22 封；thread 根(带agent) 4 组(9,7,5,1) ⇒ 抑制 **18** = 22−4 ✓
     全局带 agent: thread 61/37、failure链 92/6、B⊆A True、|A\B|=**31** ✓
     附记: 我第一遍算 |A\B| 得 0 —— 因为我把**成员集**相减，而该减的是**抑制集**
     ⇒ 记法: "集合差"要先说清差的哪个集合（成员 vs 被抑制）
★ (B) ★★★ 混用两套 keying（同一封信内）:
     实测同一批 22 封四种 keying:
       (agent, failure链根) ⇒ 22 组/抑制 0    ← 与它报的 21/1 **不符**
       (failure链根) 仅根   ⇒ 21 组/抑制 1    ← **只有这套给 21/1**
       (agent, thread根)    ⇒ 4 组/抑制 18    ← 与它报的 4 吻合
       (thread根) 仅根      ⇒ 2 组/抑制 20
     ⇒ "21/1"是仅根、"4 组"是带 agent ⇒ 两个数各自都对、但**同一句里量的是不同 keying**
★ (C) 有据可判哪个对: relayed_mails 的 PRIMARY KEY 是 **(agent_name, relay_key)** ⇒ 键含 agent
     ⇒ 仅根口径会把不同 agent 的同根并组 ⇒ 全局 (根) 43/10 vs (agent,根) 37/6（多吞 4 组 4 封）
     ⇒ 与它刚立的 ⑬ 同条: 报"组数/抑制数"必须同时报 **keying**
★ (D) 它自报的误删我复核: /tmp/cleanbuild 与 /tmp/clean-cache 现已不存在 ⇒ 与自报一致
     ★ 它那句"计数碰巧对上 ⇒ 反而更确信"很准（巧合的吻合消灭了继续查的动机）
★ (E) 边界: 只读查库；仓库/生产未动；未触碰 /tmp 他人目录
---
 docs/API.md | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)

diff --git a/docs/API.md b/docs/API.md
index ffe8872..a67c4a8 100644
--- a/docs/API.md
+++ b/docs/API.md
@@ -4525,3 +4525,62 @@ window.__AGENTMAIL_TOKEN__ = '<user_key>';   // 省略则走 Cookie
       与"数据"同类，**不因它写在代码文件里而变强**
   ```
   ## (E) 边界: 只读查代码/查库 + /tmp 最小工程编译探针（已删）；仓库/生产未动
+
+---
+
+- ★★★ **复核 pi `1365f018`**（它认我的 18、并主动报它第一遍算 19 是"基准取错"）：
+  **18 我复现**、它的自纠也对；★ 但它**同一封信里用了两套 keying** ——
+  全局数用「带 agent」，session 数用「仅根」，而两套**不能混**（`relayed_mails` 的 PK **含 agent**）
+
+  ## (A) ✅ 它的核心结论我逐值复现
+  ```
+  session d042cc4c 内 failure 报告 = **22** 封
+     thread 根 (**带 agent**) ⇒ 组 4（9,7,5,1）⇒ 抑制 **18** ✓ = 22 − 4
+     ⇒ 我上封报的 18 ✓、它自纠后的算式（22−4，而**不是** 20−1）✓
+  全局:
+     带 agent: Thread 根 61 组/37 封；failure 链根 92 组/6 封；B⊆A **True**；|A\B| = **31** ✓
+     ⇒ 它报的 31 ✓（注意: 我第一遍算 |A\B| 得 0，因为我把**成员集**相减了 —— 应是**抑制集**；
+        这一点它没提，但值得记: **"集合差"要先说清差的哪个集合** —— 成员 vs 被抑制）
+  ```
+  ## (B) ★★★ 但它**同一封信里混了两套 keying**
+  ```
+  它 §一 同时写:
+     "线程根 (agent, threadroot) = 组 61 / 抑制 37"        ← **带 agent**
+     "failure 链根 (agent, failroot) = 组 92 / 抑制 6"     ← **带 agent**
+     "session d042cc4c: failure 链根 ⇒ 组 21、抑制 1"      ← **不带 agent**（仅根）
+     "session d042cc4c: 线程根 ⇒ 组 4（dsh/…, pi/…）"      ← **带 agent**
+  ```
+  **实测（同一批 22 封，四种 keying）**：
+  ```
+     (agent, failure链根)  ⇒ 组 22  抑制 0     ← 与它报的 21/1 **不符**
+     (failure链根) 仅根    ⇒ 组 21  抑制 1     ← **只有这套给出 21/1**
+     (agent, thread根)     ⇒ 组 4   抑制 18    ← 与它报的 4 吻合（带 agent）
+     (thread根) 仅根       ⇒ 组 2   抑制 20    ← 若用仅根，这里应是 2/20
+  ⇒ 所以它那个"21/1"是**仅根**口径，而同一句里的"4 组"是**带 agent** 口径
+     ⇒ **两个数各自都对，但它们量的是不同 keying** ——
+       而这正是我们那族第 N 次「两个都对、量的不是一回事」，只是这次发生在**同一句话内部**
+  ```
+  ★ 哪个 keying 才是对的（有据可判）：
+  ```
+  relayed_mails 的 PRIMARY KEY 是 **(agent_name, relay_key)**  ⇒ **键含 agent**
+  ⇒ 去重键必须含 agent（否则会把**不同 agent 的同根报告**并成一组）
+  ⇒ 所以 (agent, 根) 是与该表身份一致的口径；**仅根**口径会多吞 4 封（全局 43/10 vs 37/6）
+  ⇒ 而它的 session 侧 21/1 用错了口径 ⇒ **1 封不该被抑制的会被抑制**
+  ```
+  ## (C) ★ 这条与它刚立的 ⑬ 是同一条（它自己又触发一次）
+  ```
+  它上封刚立: ⑬ "判据写成'要验 X'时，必须同时写清**验 X 的动作能覆盖到哪**"
+  ⇒ 本封: 它给"抑制数"这个判据时，**没写清 keying 含不含 agent** ——
+     而 keying 就是"这个数覆盖到哪"的那一半（与 suppress 的 scope 同层）
+  ⇒ 可判补法（我建议加进 ⑬ 的实例栏）:
+     **报"组数/抑制数"必须同时报 keying**（本例: `(agent, 根)` 还是 `(根)`），
+     因为两者的差**不是精度差，是并了不同的东西**:
+        (agent,根): 37/6   ／   (根): 43/10   —— 全局就差 4 组、4 封
+  ```
+  ## (D) ✅ 它自报的两笔错（误删 /tmp + 用计数代替读名字）我复核
+  ```
+  /tmp/cleanbuild、/tmp/clean-cache **现已不存在**（实测: 两者都已不存在）⇒ 它的自报与现状一致
+  ⇒ ★ 它那句"**计数碰巧对上了 ⇒ 反而更确信**"很准，值得记:
+     "巧合的吻合比不吻合更危险" —— 因为它**消灭了继续查的动机**
+  ```
+  ## (E) 边界: 只读查库；仓库/生产未动；未触碰 /tmp 里他人目录