pi-patch-keeper 1.1.0 → 1.1.1

package/README.md

@@ -8,7 +8,7 @@ npm 发布版：`pi install npm:pi-patch-keeper`
 
 安装后 `/reload` 或重启会话生效（扩展源码改动需重启）。
 
-**是什么**：把「对别人的东西」的改动（**12 个面**：PiDeck builtin ×5 双份 · npm 包 ×4 · app.asar ×3）从「升级后手工重跑」变成**启动自愈 + 明确报告**——外置、模块化、抗上游升级。全量清单见 `~/Desktop/pi-env-snapshot/05-脚本补丁/PATCH-REGISTRY.md`（唯一权威源）。
+**是什么**：把「对别人的东西」的改动（**12 个面**：PiDeck builtin ×5 双份 · npm 包 ×4 · app.asar ×3）从「升级后手工重跑」变成**启动自愈 + 明确报告**——外置、模块化、抗上游升级。全量清单由本机补丁登记表维护（PATCH-REGISTRY，随快照包分发）。
 
 ## 来源与借鉴
 

package/index.ts

@@ -20,7 +20,7 @@
  * - 任何失败都只 notify，不抛错、不影响会话（纪律：不合法就跳过 + 记日志，绝不崩溃）。
  */
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { existsSync, readFileSync, writeFileSync, copyFileSync, readdirSync } from "node:fs";
+import { existsSync, readFileSync, writeFileSync, copyFileSync, readdirSync, renameSync } from "node:fs";
 import { createHash } from "node:crypto";
 import * as os from "node:os";
 import * as path from "node:path";
@@ -140,7 +140,7 @@ function healPiMemory(): Result {
     const stamp = new Date().toISOString().slice(0, 10).replace(/-/g, "");
     const bak = `${PI_MEMORY}.bak-exitsummary-${stamp}`;
     if (!existsSync(bak)) copyFileSync(PI_MEMORY, bak);
-    writeFileSync(PI_MEMORY, next, "utf8");
+    writeAtomic(PI_MEMORY, next);
   } catch (e) { return { ok: false, detail: `写入失败：${(e as Error).message}` }; }
   return { ok: true, detail: "已自动修补（exit summary 空行规范化）—— 本轮即生效" };
 }
@@ -157,7 +157,7 @@ function healMemorySection(): Result {
     const stamp = new Date().toISOString().slice(0, 10).replace(/-/g, "");
     const bak = `${PI_MEMORY}.bak-memsec-${stamp}`;
     if (!existsSync(bak)) copyFileSync(PI_MEMORY, bak);
-    writeFileSync(PI_MEMORY, next, "utf8");
+    writeAtomic(PI_MEMORY, next);
   } catch (e) { return { ok: false, detail: `写入失败：${(e as Error).message}` }; }
   return { ok: true, detail: "已自动修补（memory 段改 section）—— 重启后生效" };
 }
@@ -174,7 +174,7 @@ function healTactician(): Result {
     const stamp = new Date().toISOString().slice(0, 10).replace(/-/g, "");
     const bak = `${TACT}.bak-tactician-${stamp}`;
     if (!existsSync(bak)) copyFileSync(TACT, bak);
-    writeFileSync(TACT, next, "utf8");
+    writeAtomic(TACT, next);
   } catch (e) { return { ok: false, detail: `写入失败：${(e as Error).message}` }; }
   return { ok: true, detail: "已自动修补（tactician 改 section）—— 重启后生效" };
 }
@@ -192,6 +192,13 @@ function safeRead(p: string): string | null {
   try { return readFileSync(p, "utf8"); } catch { return null; }
 }
 
+/** 原子写：临时文件 + rename（崩溃/被杀不留半写文件）。 */
+function writeAtomic(file: string, data: string | Buffer): void {
+  const tmp = file + ".tmp-" + process.pid;
+  writeFileSync(tmp, data);
+  renameSync(tmp, file);
+}
+
 /** 统计 needle 在原串里的出现次数。 */
 function count(hay: string, needle: string): number {
   let n = 0, i = 0;
@@ -230,7 +237,7 @@ function healPiLens(): Result {
     const stamp = new Date().toISOString().slice(0, 10).replace(/-/g, "");
     const bak = `${PI_LENS}.bak-wordindex-${stamp}`;
     if (!existsSync(bak)) copyFileSync(PI_LENS, bak);
-    writeFileSync(PI_LENS, next, "utf8");
+    writeAtomic(PI_LENS, next);
   } catch (e) { return { ok: false, detail: `写入失败：${(e as Error).message}` }; }
   return { ok: true, detail: state === "upstream" ? `上游已修复 #4583 —— 跳过 A，仅补 B${a1 ? "（A 残留，建议 npm 重装清除）" : ""}` : `已自动修补（原状态 ${state}）—— 本轮即生效` };
 }
@@ -265,7 +272,7 @@ function healMemoryFormat(): Result {
         const txt = safeRead(p);
         if (txt === null) continue;
         const norm = normMd(txt);
-        if (norm !== txt) { try { writeFileSync(p, norm, "utf8"); fixed += 1; } catch { /* 静默 */ } }
+        if (norm !== txt) { try { writeAtomic(p, norm); fixed += 1; } catch { /* 静默 */ } }
       }
     };
     walk(dir);
@@ -320,7 +327,7 @@ function fingerprintDrift(): string[] {
   let prev: Record<string, string[]> | null = null;
   const prevRaw = safeRead(FINGERPRINT);
   if (prevRaw) { try { prev = JSON.parse(prevRaw) as Record<string, string[]>; } catch { prev = null; } }
-  try { writeFileSync(FINGERPRINT, JSON.stringify(cur, null, 1), "utf8"); } catch { /* 静默 */ }
+  try { writeAtomic(FINGERPRINT, JSON.stringify(cur, null, 1)); } catch { /* 静默 */ }
   if (prev === null) return [];
   const out: string[] = [];
   for (const k of ["packages", "defaultTools", "enabledModels", "extensions", "codemode"] as const) {
@@ -371,7 +378,7 @@ function manualDrift(): string | null {
   let prev: { ver?: string; sig?: string } | null = null;
   const raw = safeRead(MANUAL_STATE);
   if (raw) { try { prev = JSON.parse(raw); } catch { prev = null; } }
-  try { writeFileSync(MANUAL_STATE, JSON.stringify({ ver, sig })); } catch { /* ignore */ }
+  try { writeAtomic(MANUAL_STATE, JSON.stringify({ ver, sig })); } catch { /* ignore */ }
   if (prev && prev.ver === ver && prev.sig !== sig) return `手册内容已变但版本号未升（${ver}）—— bump-manual 或撤销未登记改动`;
   return null;
 }
@@ -411,7 +418,7 @@ function fixForceOrder(): string | null {
   try {
     copyFileSync(SETTINGS, `${SETTINGS}.bak-force-order-${Date.now()}`);
     s.packages = next;
-    writeFileSync(SETTINGS, JSON.stringify(s, null, 2), "utf8");
+    writeAtomic(SETTINGS, JSON.stringify(s, null, 2));
   } catch (e) { return `force 顺序自动修复失败：${(e as Error).message}`; }
   return `force 顺序已自动修复：${FORCE_TAIL.filter((n) => next.includes(n)).join(" / ")} 移到 packages 末尾`;
 }
@@ -472,7 +479,7 @@ function healSelfExtension(): Result {
     const stamp = new Date().toISOString().slice(0, 10).replace(/-/g, "");
     const bak = `${SELF_EXT}.bak-overwrite-${stamp}`;
     if (!existsSync(bak)) copyFileSync(SELF_EXT, bak);
-    writeFileSync(SELF_EXT, snap, "utf8");
+    writeAtomic(SELF_EXT, snap);
   } catch (e) { return { ok: false, detail: `恢复失败：${(e as Error).message}` }; }
   return { ok: true, detail: "疑似被发布精简版覆盖 —— 已从快照恢复（重启后生效）" };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-patch-keeper",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Startup self-healing for pi/pi-lens/pi-memory/PiDeck patches, plus force-typed extension order guard and status report.",
   "type": "module",
   "license": "MIT",