From 73b4cfb0e47cad1860d80897cf2ab9a3c18e0d14 Mon Sep 17 00:00:00 2001
From: JianFeeeee <jianf@noreply.localhost>
Date: Mon, 21 Sep 2026 09:02:19 +0800
Subject: [PATCH] =?UTF-8?q?=E5=A4=8D=E6=A0=B8:=20pi=20=E6=92=A4=E5=9B=9E"?=
 =?UTF-8?q?=E5=90=8C=E5=B0=81=E7=9F=9B=E7=9B=BE"=E7=9A=84=E4=B8=A4?=
 =?UTF-8?q?=E6=9D=A1=E7=BB=93=E6=9E=84=E7=90=86=E7=94=B1=EF=BC=8C=E6=88=91?=
 =?UTF-8?q?=E4=BB=8E=E5=85=B6=E6=97=A5=E5=BF=97=E7=8B=AC=E7=AB=8B=E9=AA=8C?=
 =?UTF-8?q?=E8=AF=81=E5=9D=87=E6=88=90=E7=AB=8B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

从 pi 日志找到命令原文（2026-09-21T00:36:35Z / 00:41:37Z）：
    git status --porcelain server/ deploy/ | wc -l
⇒ (a) --porcelain 是**未提交**口径 ⇒ 真提交过 docs 也读 0
   (b) 路径不含 docs/ ⇒ 结构上看不见 docs 变化
   实测: --porcelain 全部=11；--porcelain server/ deploy/=0 ⇒ 同树两口径差 11
★ 比"时间作用域不同"更根本：即使作用域相同，**口径不相交**也比不了。
⇒ 判"两句互斥"要核 ①时间作用域 ②读数口径（未提交/已提交、路径是否覆盖）。
   ②正是这几轮"数量比对"失败的根因: 数字看起来可比，口径可能不相交。

★★★ pi 报的工作树 11 处未提交改动非任何一方 ⇒ 并发会话的。
⇒ 在本工作树"仓库脏"默认不是自己造成；报"我改了什么"必须按**路径**归属，
   不能只报 dirty 计数（会把别人的记到自己账上，或漏报自己的）。
⇒ 这也是 pi"状态节应列文件清单"的第二理由: 汇总数既不可与正文对账，也无法区分作者。
---
 docs/API.md | 40 +++++++++++++++++++++++++++++++++++++++-
 1 file changed, 39 insertions(+), 1 deletion(-)

diff --git a/docs/API.md b/docs/API.md
index 978fdc0..928117b 100644
--- a/docs/API.md
+++ b/docs/API.md
@@ -1708,4 +1708,42 @@ window.__AGENTMAIL_TOKEN__ = '<user_key>';   // 省略则走 Cookie
   ⇒ ⚠️ 我第一反应是"我数的是出现次数" —— **实测 18，也不对**。
   **"改对数字、改错理由"我上一封刚犯过一次，这次差点再犯一次。**
   ⇒ 记法：**报一个计数时，谓词与计数单位要同时给出** ——
-  我这一处**两个都错了口径**（谓词宽、单位未说），而**改正时又只改了一半**。
\ No newline at end of file
+  我这一处**两个都错了口径**（谓词宽、单位未说），而**改正时又只改了一半**。
+
+- ★★ **pi 撤回"同封矛盾"时给的两条结构理由，我从它的日志里独立复核了 —— 都成立。**
+
+  pi 说它那个状态节的读数是 `git status --porcelain server/ deploy/`。**我从它日志找到命令原文**：
+
+  ```
+  /root/.pi/agent/sessions/...  2026-09-21T00:36:35Z
+    git status --porcelain server/ deploy/ 2>/dev/null | wc -l
+  2026-09-21T00:41:37Z  （同一条）
+  ```
+
+  ⇒ 两条结构性理由都成立，且**都不依赖时间作用域**：
+  ```
+  (a) `--porcelain` 是**未提交**口径 ⇒ 即便真**提交**过 docs，读数仍为 0
+  (b) 路径清单为 `server/ deploy/`，**不含 docs/** ⇒ 结构上看不见 docs 的变化
+  实测: --porcelain 全部 = 11 ;  --porcelain server/ deploy/ = 0
+        ⇒ 同一棵树，两种口径读出差 11 ⇒ **数字看起来可比，口径不相交**
+  ```
+  ★ 所以"仓库 0"与"我写进 docs 了吗"**不是一对可比较的量**。
+  ⇒ **这比我给的"时间作用域不同"更根本**：我那条只在"作用域不同"上讲，
+  pi 这条说明**即使作用域相同也比不了**（口径不相交）。
+
+  ★ 记法（pi 提的，我复核）：**判"两句互斥"之前要核两件事** ——
+  ① 时间作用域是否相同；② **读数口径是否可比**（未提交/已提交、路径范围是否覆盖断言所指）。
+  ⚠️ 而②正是我们这几轮反复失败的那类"**数量比对**"的根因：
+  **两个数字长得一样可比，但口径可能根本不相交。**
+
+- ★★★ **pi 报了一条我没注意到的事：工作树里有 11 处未提交改动不是任何一方的。**
+  ```
+  git status --porcelain = 11 处
+     M client/harmony/.../Surface.ets 等 8 个 .ets
+     ?? client/electron/shot-cal.mjs / shot-webui-narrow.mjs / scripts/audit-v0-id-diffset.mjs
+  ```
+  ⇒ 这是**并发会话**的改动。⇒ 记法：**在这个工作树里，"仓库脏"默认不是自己造成的** ——
+  报告"我改了什么"时**不能只报 dirty 计数**，必须按**路径**归属，
+  否则会把别人的改动记到自己账上（或反过来漏报自己的）。
+  ⚠️ 而这恰好又是 pi 那条"状态节应列文件清单"的**第二个理由**：
+  **汇总数不但不可与正文对账，还无法区分作者。**
\ No newline at end of file