pi-patch-keeper 1.3.7 → 1.3.9

package/README.md

@@ -27,7 +27,7 @@ pi install npm:pi-patch-keeper
 
 ## 配置
 
-配置文件 `~/.pi/patch-keeper.json`（可省略）；无环境变量。
+配置文件 `~/.pi/patch-keeper.json`（可省略）；无环境变量。**只支持 `forceTail` 一个键**——旧版遗留的 `packages` / `defaultTools` / `enabledModels` 等字段无代码消费，改它们不生效；启动时若检测到未知键会明确告知（2026-10-18 起）。
 
 | 键 | 类型 | 默认 | 说明 |
 | --- | --- | --- | --- |
@@ -123,7 +123,7 @@ pi install npm:pi-patch-keeper
 
 ## Configuration
 
-Config file `~/.pi/patch-keeper.json` (optional); no environment variables.
+Config file `~/.pi/patch-keeper.json` (optional); no environment variables. **Only `forceTail` is read** — legacy keys such as `packages` / `defaultTools` / `enabledModels` have no consumer, so editing them does nothing; unknown keys are reported at startup.
 
 | Key | Type | Default | Description |
 | --- | --- | --- | --- |

package/index.ts

@@ -150,6 +150,15 @@ export function loadConfig(): PkConfig {
   try { const j = JSON.parse(raw) as PkConfig; return j && typeof j === "object" ? j : {}; } catch { return {}; }
 }
 /** force 型包列表（配置优先，缺省用内置两项）。 */
+/** 配置里无代码消费的字段（2026-10-18：旧版遗留的 packages/defaultTools/enabledModels 等，改它们不生效——必须显式告知，否则用户以为在配置）。 */
+export function unknownConfigKeys(cfg?: Record<string, unknown>): string[] {
+  try {
+    const known = new Set(["forceTail"]);
+    const obj = cfg ?? (loadConfig() as Record<string, unknown>);
+    return Object.keys(obj).filter((k) => !known.has(k));
+  } catch { return []; }
+}
+
 export function forceTail(): string[] {
   const c = loadConfig();
   const list = Array.isArray(c.forceTail) ? c.forceTail.filter((x): x is string => typeof x === "string" && x.length > 0) : [];
@@ -285,6 +294,8 @@ export default function (pi: ExtensionAPI) {
       if (drift.length) msgs.push("patch-keeper: 环境指纹已变（" + drift.join("；") + "）—— 手册 / 上轮验证结论可能过期，按 08-台账核对纪律逐项重验");
       const md = manualDrift();
       if (md) msgs.push("patch-keeper: " + md);
+      const unk = unknownConfigKeys();
+      if (unk.length) msgs.push("patch-keeper: ~/.pi/patch-keeper.json 含无代码消费的字段（" + unk.join(", ") + "）—— 仅 forceTail 生效，其余可删（2026-10-18 起显式提示）");
       for (const m of msgs) ctx.ui.notify(m, "warning");
     } catch { /* 静默：检测不该影响会话 */ }
   });

package/package.json

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