pi-patch-keeper 1.2.8 → 1.2.9

package/README.md

@@ -48,6 +48,8 @@ pi install npm:pi-patch-keeper
 - 写盘用临时文件 + rename；修复前备份。
 
 
+## 原理（专业）
+
 ```mermaid
 flowchart TD
     A[factory] --> B[读 settings.json 建指纹]
@@ -60,6 +62,22 @@ flowchart TD
     H -->|不一致| I[通知 + nextTurn 尾部消息<br/>以磁盘为准]
 ```
 
+## 原理（小白）
+
+像出门前的门卫，检查三件事：开关是否一致、排队顺序对不对、手里的说明书是不是最新版；能顺手修的直接修，修不了就提醒你。
+
+```mermaid
+flowchart LR
+    A[启动] --> B[门卫检查三件事]
+    B --> C{开关一致?}
+    B --> D{排队顺序对?}
+    B --> E{说明书最新?}
+    C -->|否| F[提醒]
+    D -->|否| G[直接调好]
+    E -->|否| H[提醒：以手上那份为准]
+```
+
+
 ## License
 
 MIT
@@ -111,7 +129,33 @@ No config file (only reads `settings.json` and `APPEND_SYSTEM.md`); no environme
 - Writes are atomic (temp file + rename); a backup precedes any repair.
 
 
+## How it works (technical)
+
+```mermaid
+flowchart TD
+    A[factory] --> B[read settings.json, build fingerprint]
+    B --> C[session_start]
+    C --> D{fingerprint changed?}
+    D -->|yes| E[notify: manuals may be stale]
+    C --> F{force order wrong?}
+    F -->|yes| G[backup + reorder packages]
+    C --> H[before_agent_start<br/>compare injected manual vs disk]
+    H -->|mismatch| I[notify + nextTurn message<br/>trust disk]
+
+## How it works (plain words)
+
+Like a doorman before you leave: checks three things — switches agree, queue order is right, the manual in hand is the latest version; fixes what it can and tells you the rest.
+
 ```mermaid
+flowchart LR
+    A[startup] --> B[doorman checks three things]
+    B --> C{switches agree?}
+    B --> D{queue order right?}
+    B --> E{manual up to date?}
+    C -->|no| F[notify]
+    D -->|no| G[fix it directly]
+    E -->|no| H[notify: trust the copy in hand]
+```
 flowchart TD
     A[factory] --> B[read settings.json, build fingerprint]
     B --> C[session_start]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-patch-keeper",
-  "version": "1.2.8",
+  "version": "1.2.9",
   "description": "pi config guards: codemode single-source check, force-order guard (auto-fix), settings fingerprint drift, injected-manual alignment. (PiDeck / third-party source patches are a local-only module, not bundled.)",
   "type": "module",
   "license": "MIT",