pi-patch-keeper 1.2.8 → 1.2.10

package/README.md

@@ -47,6 +47,7 @@ pi install npm:pi-patch-keeper
 - `before_agent_start`：比对注入手册版本与磁盘版本；不一致时通知并以 `nextTurn` 尾部消息提示模型以磁盘为准；**不返回 `systemPrompt`**。
 - 写盘用临时文件 + rename；修复前备份。
 
+## 原理（专业）
 
 ```mermaid
 flowchart TD
@@ -60,6 +61,21 @@ flowchart TD
     H -->|不一致| I[通知 + nextTurn 尾部消息<br/>以磁盘为准]
 ```
 
+## 原理（小白）
+
+**像出门前的门卫**，检查三件事：开关是否一致、排队顺序对不对、手里的说明书是不是最新版；能顺手修的直接修，修不了就提醒你。
+
+```mermaid
+flowchart TD
+    A[启动] --> B[门卫三项检查]
+    B --> C{开关一致?}
+    B --> D{顺序对不对?}
+    B --> E{说明书最新?}
+    C -->|否| F[提醒]
+    D -->|否| G[直接调好]
+    E -->|否| H[提醒：以手上为准]
+```
+
 ## License
 
 MIT
@@ -110,6 +126,7 @@ No config file (only reads `settings.json` and `APPEND_SYSTEM.md`); no environme
 - `before_agent_start`: compares the injected manual version with disk; on mismatch it notifies and sends a `nextTurn` message telling the model to trust disk; **never returns `systemPrompt`**.
 - Writes are atomic (temp file + rename); a backup precedes any repair.
 
+## How it works (technical)
 
 ```mermaid
 flowchart TD
@@ -121,7 +138,32 @@ flowchart TD
     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 TD
+    A[startup] --> B[doorman: three checks]
+    B --> C{switches agree?}
+    B --> D{order right?}
+    B --> E{manual latest?}
+    C -->|no| F[notify]
+    D -->|no| G[fix directly]
+    E -->|no| H[notify: trust the copy in hand]
 ```
+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]
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-patch-keeper",
-  "version": "1.2.8",
+  "version": "1.2.10",
   "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",