pi-webdav-backup 1.3.1 → 1.3.3

package/README.md

@@ -120,14 +120,17 @@ node ~/.pi/agent/extensions/webdav-backup/cli.mjs detect-legacy --json
 
 | 语法 | 说明 | 适用 |
 |---|---|---|
-| `dpapi:名称` | **推荐**。Windows DPAPI 用户级加密存入 `secrets.dpapi.json`，本机本用户可解，**无需主密码** | Windows |
-| `$ENV_VAR` / `${ENV_VAR}` | 环境变量（也支持 `$A-$B` 拼接，`$$` 转义） | 跨平台 |
-| `file:路径` | 从文件读取（自动去换行；相对路径基于 `~/.pi/agent`） | 跨平台 |
-| `!命令` | 执行命令取 stdout（可对接密码管理器 CLI） | 跨平台 |
+| `dpapi:名称` | Windows DPAPI 用户级加密存入 `secrets.dpapi.json`，本机本用户可解，**无需主密码** | 仅 Windows |
+| `$ENV_VAR` / `${ENV_VAR}` | 环境变量（也支持 `$A-$B` 拼接，`$$` 转义） | **跨平台** |
+| `file:路径` | 从文件读取（自动去换行；相对路径基于 `~/.pi/agent`） | **跨平台** |
+| `!命令` | 执行命令取 stdout（可对接密码管理器 CLI） | **跨平台** |
 | `plain:值` | 显式声明明文（会告警，仅调试用） | — |
 | 其他值 | 视为明文（**会告警**） | — |
 
 > 该语法与 pi 自身的 `resolve-config-value` 约定一致，`auth.json` 的 `key` 字段也支持 `$ENV_VAR` 与 `!命令`。
+>
+> ⚠️ **要跨 Windows / Linux / macOS 多机同步，用 `file:` 或 `$ENV`，不要用 `dpapi:`**——同 DPAPI 密文只能在本机本用户解密。
+> 详见下文「跨平台密钥（多机同步）」。
 
 ### 推荐做法
 
@@ -183,6 +186,46 @@ setx PI_WEBDAV_BACKUP_PASSWORD "你的应用密码"
 setx PI_WEBDAV_BACKUP_KEY "你的加密口令"
 ```
 
+### 跨平台密钥（多机同步）
+
+`dpapi:` 只能在 Windows 本机本用户解密，**同一份配置在 Linux 上会解析失败**。要在 Windows/Linux/macOS 多机共用一套配置，改用 `file:`（推荐，无需改 shell）或 `$ENV`。
+
+**方案：`file:` 相对引用**（配置里写相对 `agentDir` 的路径，各平台写法一致）
+
+```jsonc
+{
+  "remote": { "password": "file:secrets/webdav-password.txt" },
+  "encrypt": true,
+  "encryptKey": "file:secrets/backup-key.txt"
+}
+```
+
+每台机器各创建一次密钥文件（内容相同）：
+
+```bash
+mkdir -p ~/.pi/agent/secrets
+printf '%s' '你的加密口令'   > ~/.pi/agent/secrets/backup-key.txt
+printf '%s' '你的应用密码'   > ~/.pi/agent/secrets/webdav-password.txt
+chmod 600 ~/.pi/agent/secrets/*.txt      # Windows 可忽略
+```
+
+> `secrets/**` 默认被排除，**密钥不会随备份上传**。所以新机器必须手动做一次这步（这是唯一的手动环节）。
+> 读取时会自动去掉行尾换行，`echo`/`printf` 都可以。
+
+**方案：`$ENV`**
+
+配置里写 `"encryptKey": "$PI_WEBDAV_BACKUP_KEY"`，然后各机器设同名环境变量（值相同）：
+
+```bash
+# Linux / macOS：~/.bashrc 或 ~/.zshrc
+export PI_WEBDAV_BACKUP_KEY="你的加密口令"
+
+# Windows PowerShell（需新开终端生效）
+setx PI_WEBDAV_BACKUP_KEY "你的加密口令"
+```
+
+从现有 `dpapi:` 迁移：`node cli.mjs migrate --method file`（写入 `secrets/`）或 `--method env`（写入用户环境变量）。
+
 ---
 
 ## 备份什么
@@ -294,7 +337,7 @@ setx PI_WEBDAV_BACKUP_KEY "你的加密口令"
   "snapshot": false,               // 见下文「两种模式」
 
   "encrypt": false,                // AES-256-GCM 加密
-  "encryptKey": "dpapi:backup-key",  // 密钥引用（≥16 位），或 $PI_WEBDAV_BACKUP_KEY
+  "encryptKey": "dpapi:backup-key",  // 密钥引用（≥16 位）：dpapi:名称 / $ENV_VAR / file:路径；见上文「密钥」
 
   "backupOnExit": true,            // 退出 pi 时自动备份
   "backupOnExitMinIntervalMinutes": 30,   // 两次自动备份最小间隔
@@ -315,10 +358,10 @@ setx PI_WEBDAV_BACKUP_KEY "你的加密口令"
 | **群晖 WebDAV** | `https://NAS地址:5006/<共享文件夹>` | DSM 账号 | DSM 密码 |
 | **自建 rclone serve** | `http://主机:端口/` | `--user` 指定的值 | `--pass` 指定的值 |
 
-> ⚠️ 密码建议用 `dpapi:` 引用而非明文，见下方「密钥不明文落盘」：
+> ⚠️ 密码建议用引用而非明文（**多机同步请用 `file:` / `$ENV`，不要用 `dpapi:`**）：
 > ```
-> /backup keys set webdav-password
-> # 然后在配置里写 "password": "dpapi:webdav-password"
+> /backup keys set webdav-password          # Windows DPAPI
+> # 跨平台："password": "file:secrets/webdav-password.txt"
 > ```
 > 也可用环境变量：`setx PI_WEBDAV_BACKUP_PASSWORD "你的应用密码"`
 
@@ -399,10 +442,13 @@ node "$env:USERPROFILE\.pi\agent\extensions\webdav-backup\cli.mjs" install-cron
 新电脑往往已经装过一些插件——可能和备份里同名但版本不同，也可能多装了备份里没有的。
 直接覆盖会**把同名插件降级、把本机多装的声明抹掉、留下版本混合的“缝合”目录**。所以写回有两种模式：
 
-| 模式 | settings.json 的 packages | 本机已装的插件实现 | 本机多装的插件 |
-|---|---|---|---|
-| **合并**（默认，推荐） | 本机声明优先，追加备份里本机没有的 | **保留本机版本**，不覆盖 | 保留（声明与代码都留） |
-| 替换（旧机原样） | 完全用备份版 | 被备份覆盖（同名降级） | 声明被移除（代码不删） |
+| 模式 | settings.json 的 packages | npm/package.json 的 dependencies | 本机已装的插件实现 | 本机多装的插件 |
+|---|---|---|---|---|
+| **合并**（默认，推荐） | 本机声明优先，追加备份里本机没有的 | 本机依赖优先，追加备份里本机没有的 | **保留本机版本**，不覆盖 | 保留（声明与代码都留） |
+| 替换（旧机原样） | 完全用备份版 | 完全用备份版 | 被备份覆盖（同名降级） | 声明被移除（代码不删） |
+
+> **为何要合并 `npm/package.json`**：pi 启动时会拿它与 `node_modules` 做协调（npm install）。
+> 若直接覆盖成备份版，本机独有的插件会被 npm 当成多余包【卸载】。所以合并模式会保留本机已有依赖。
 
 - 交互式 `/backup restore`：本机有插件声明时会先让你选（默认合并）
 - 命令行：`--mode merge`（默认）/ `--mode replace`
@@ -470,6 +516,90 @@ node cli.mjs repair-plugins --dir D:\pi-restore
 
 ---
 
+## 多机同步（Windows ↔ Linux）
+
+⚠️ 先认清本质：**这是"备份/恢复"，不是实时双向同步。**
+
+| 命令 | 方向 |
+|---|---|
+| `/backup` | 本机 → 云端（上传） |
+| `/backup restore` | 云端 → 本机（下载，默认合并） |
+
+两台机器各自 `/backup` 会互相覆盖，建议**以一台为主机**，其他机器只做 `/backup restore`。
+
+### 一、旧机（主机）：先备份
+
+```
+/backup dry        # 确认扫描结果（开了 includePlugins 会含几百 MB 插件代码）
+/backup            # 正式备份
+```
+
+### 二、新机：安装 + 恢复
+
+```bash
+# 1. 装插件（GitHub / npm 二选一）
+pi install git:github.com/ddldxiacan/pi-webdav-backup@v1
+# 然后重启 pi
+
+# 2. 创建密钥文件（内容与旧机一致；secrets/ 不入备份，故需手动一次）
+mkdir -p ~/.pi/agent/secrets
+printf '%s' '你的加密口令' > ~/.pi/agent/secrets/backup-key.txt
+printf '%s' '你的应用密码' > ~/.pi/agent/secrets/webdav-password.txt
+chmod 600 ~/.pi/agent/secrets/*.txt
+
+# 3. 写配置 ~/.pi/agent/webdav-backup.json（与旧机相同，密钥用 file:）
+```
+
+配置文件模板（Windows/Linux 通用）：
+
+```jsonc
+{
+  "enabled": true,
+  "remote": {
+    "url": "https://你的.webdav/dav",
+    "username": "you@example.com",
+    "password": "file:secrets/webdav-password.txt",
+    "remoteDir": "pi-backup",
+    "remoteName": "pi"
+  },
+  "scope": ["."],
+  "includePlugins": true,
+  "extraScope": ["~/.pi/settings.json"],
+  "encrypt": true,
+  "encryptKey": "file:secrets/backup-key.txt",
+  "includeSessions": false
+}
+```
+
+```
+# 4. 测连接 + 恢复
+/backup check
+/backup restore -y     # 选备份 → 解密解压 → 选合并/替换 → 写回 → 归位 extra → 完成
+/reload
+```
+
+### 三、关键约束
+
+| 项 | 要求 |
+|---|---|
+| `encryptKey` | **两台机器值必须一致**，否则解不开加密备份 |
+| 密钥引用 | 多机一律用 `file:` 或 `$ENV`，**不要用 `dpapi:`**（只能本机解密） |
+| `remote.url` / `remoteDir` / `remoteName` | 两台机器必须完全一致，否则找不到备份 |
+| 插件还原 | 旧机需开 `includePlugins: true`；否则新机恢复后要联网 `/backup repair-plugins` |
+| 合并/替换 | 新机已装插件时，默认"合并"（保留本机已装的，只补缺失） |
+
+### 四、常见坑
+
+| 症状 | 处理 |
+|---|---|
+| 新机报"加密密钥解析失败" | 用了 `dpapi:` 但非 Windows；改用 `file:` / `$ENV` |
+| 解密失败 | `backup-key` 与旧机不一致（或旧备份用了更早的口令） |
+| 恢复后插件不生效 | 旧机未开 `includePlugins` → `/backup repair-plugins` 联网补装 |
+| 恢复后缺插件声明 | 插件声明在 `~/.pi/settings.json`（非 agent）→ 加入 `extraScope` |
+| 连接 401 | WebDAV 密码错（坚果云要用**应用密码**） |
+
+---
+
 ## 测试
 
 ```bash
@@ -506,6 +636,9 @@ node extensions/webdav-backup/verify-load.mjs
 
 | 版本 | 内容 |
 |---|---|
+| **v1.3.3** | **修复合并模式会卸载本机插件**：`restore-apply` 合并模式此前只合并 `settings.json`，却用备份版**覆盖** `npm/package.json`——pi 下次启动的 npm 协调会把本机独有插件当成多余包卸载（实测于 Windows→Linux 同步）。现改为同时合并 `npm/package.json` 的 `dependencies`（本机优先），结果里标 `npm-dependencies`。另：文档补充「多机同步」与「跨平台密钥」流程 |
+| **v1.3.2** | **跨平台多机同步**：依赖体检修正（npm 提升到父级的依赖不再误报为缺失，按 Node 模块解析算法沿祖先 `node_modules` 查找）；文档新增「跨平台密钥（多机同步）」与「多机同步（Windows ↔ Linux）」流程，明确多机用 `file:` / `$ENV` 而非 `dpapi:`，并给出常见坑 |
+| **v1.3.1** | 依赖体检误报修正（npm 提升的依赖被当成缺失） |
 | **v1.3.0** | **换机一键还原**：新增 `includePlugins`（把插件实现 `node_modules` 一并备份，重机恢复即可直接用，无需联网重装）；新增 `restore-apply` / `/backup restore-apply`（把恢复结果写回当前 `~/.pi/agent`，覆盖前备份、幂等、防止 `__REDACTED__` 覆盖真值）；**写回默认【合并模式】**：本机已装插件保留不被覆盖、`settings.json` 只合并 `packages`（避免删掉/降级本机插件），可选 `--mode replace` 完全还原；`/backup restore` 默认询问是否写回当前 pi，已含插件时不再提示联网补装；`/backup-setup` 向导新增插件代码选项；脱敏审计跳过第三方插件代码（避免误报）；排除规则重构（`includePlugins` 开关控制 node_modules） |
 | **v1.2.0** | **插件数据跨机同步补齐**：新增 `extraScope`（备份 `agentDir` 之外的路径，如 `~/.pi/settings.json`、`~/.config/rpiv-*`，归档内放 `extra/` 前缀）；归档写入 `extra-manifest.json`，按 `home`/`config`(XDG)/`appdata` 锚点记录归属，恢复时按当前机器重算目标（换用户名/盘符/平台均可）；`/backup apply-extras` 归位（幂等、覆盖前备份、防止 `__REDACTED__` 覆盖真密钥、支持 `--force`、未映射路径单独提醒）；新增 `detect-legacy` 探测遗留配置；`/backup-setup` 引导纳入；默认排除新增 `bin/**`；README 澄清加密备份同样会脱敏 |
 | **v1.1.0** | **插件备份/恢复修好**：恢复后自动体检「恢复出来的目录」并补装（此前看错目录，补装提示永不出现）；`plugins`/`repair-plugins` 新增 `--dir`；git 来源解析与 pi 完全对齐（`.git` 后缀、ref 含 `/`、`https://`/scp 形式）；commit SHA ref 自动回退为完整 clone + checkout；缺依赖逐个检测；安装参数对齐 pi（`--legacy-peer-deps` / `--omit=dev`）；Windows 路径含空格不再报错。另含 v1.0.2 之后的修复：恢复遇 302 重定向到对象存储自动跟随（不外泄凭据）、完成通知拿不到汇总的回归 |

package/extensions/webdav-backup/apply.mjs

@@ -64,6 +64,11 @@ export function isPluginImplementationPath(rel) {
   return r.startsWith("git/") || r.includes("/node_modules/");
 }
 
+/** agentDir 下的 npm 包清单（决定 pi 启动时 npm 装/卸哪些插件） */
+export function isNpmManifestPath(rel) {
+  return String(rel).replace(/\\/g, "/") === "npm/package.json";
+}
+
 /**
  * 求一个插件实现文件所属的「插件根目录」相对路径，用于判定本机是否已装该插件：
  *   npm/node_modules/foo/lib/x.js       → npm/node_modules/foo
@@ -145,6 +150,46 @@ export function mergeSettingsPackages(backupText, localText) {
   return JSON.stringify({ ...backup, packages: [...localPkgs, ...extra] }, null, 2);
 }
 
+/**
+ * 合并 npm/package.json 的 dependencies：本机已有优先（保留版本），追加备份里本机没有的。
+ *
+ * 为何必须合并：pi 启动时会拿 npm/package.json 与 node_modules 做协调（npm install）。
+ * 若 merge 写回时用备份版直接覆盖，本机独有的插件会被 npm 当成多余包【卸载】。
+ * 返回合并后的 JSON 文本；无可合并时返回 null（调用方按普通逻辑处理）。
+ */
+export function mergeNpmDependencies(backupText, localText) {
+  let backup;
+  let local;
+  try {
+    backup = JSON.parse(String(backupText).replace(/^\uFEFF/, ""));
+  } catch {
+    return null;
+  }
+  try {
+    local = JSON.parse(String(localText).replace(/^\uFEFF/, ""));
+  } catch {
+    return null;
+  }
+  if (!backup || typeof backup !== "object") return null;
+
+  const backupDeps = backup.dependencies && typeof backup.dependencies === "object" ? backup.dependencies : {};
+  const localDeps = local?.dependencies && typeof local.dependencies === "object" ? local.dependencies : {};
+  if (Object.keys(localDeps).length === 0) return null;
+
+  // 本机已声明的依赖保留本机版本；备份独有的追加进来
+  const merged = { ...localDeps };
+  let added = 0;
+  for (const [name, range] of Object.entries(backupDeps)) {
+    if (!(name in merged)) {
+      merged[name] = range;
+      added++;
+    }
+  }
+  // 本机声明已包含备份全部依赖且无新增 → 无需改写
+  if (added === 0 && Object.keys(merged).length === Object.keys(localDeps).length) return null;
+  return JSON.stringify({ ...backup, dependencies: merged }, null, 2);
+}
+
 /** 递归列出恢复目录下、应写回 agentDir 的文件（跳过 extra/ 与元数据） */
 export function listRestoredFiles(restoredDir, { extraPrefix = "extra/" } = {}) {
   const root = resolve(restoredDir);
@@ -224,6 +269,21 @@ export function applyRestoredFiles(restoredDir, agentDir, opts = {}) {
       }
     }
 
+    // merge：npm/package.json 只合并 dependencies，保留本机独有插件。
+    // 否则覆盖后，pi 下次启动的 npm 协调会把本机独有的包当成多余包卸载。
+    let mergedNpm = false;
+    if (merge && isNpmManifestPath(f.rel) && existsSync(target)) {
+      try {
+        const mergedText = mergeNpmDependencies(srcBuf.toString("utf8"), readFileSync(target, "utf8"));
+        if (mergedText !== null) {
+          srcBuf = Buffer.from(mergedText, "utf8");
+          mergedNpm = true;
+        }
+      } catch {
+        /* 合并失败则退回普通处理 */
+      }
+    }
+
     // merge：本机已装该插件（插件根目录已存在）→ 跳过整个插件，避免降级与版本混合。
     // 但若该文件与本地完全一致，则归为 unchanged（保证重复写回幂等）。
     if (merge) {
@@ -281,11 +341,13 @@ export function applyRestoredFiles(restoredDir, agentDir, opts = {}) {
       let backup = null;
       if (existsSync(target)) backup = backupExisting(target, "apply");
       writeFileSync(target, srcBuf);
-      applied.push({ rel: f.rel, target, backup, merged: mergedSettings });
-      if (mergedSettings) merged.push({ rel: f.rel, target });
+      applied.push({ rel: f.rel, target, backup, merged: mergedSettings || mergedNpm });
+      if (mergedSettings) merged.push({ rel: f.rel, target, kind: "settings-packages" });
+      if (mergedNpm) merged.push({ rel: f.rel, target, kind: "npm-dependencies" });
       log(
         `  ${backup ? "已覆盖" : "已写入"} ${f.rel} → ${target}` +
           (mergedSettings ? "（已合并 packages，保留本机插件声明）" : "") +
+          (mergedNpm ? "（已合并 dependencies，保留本机插件依赖）" : "") +
           (backup ? `（原文件备份为 ${backup}）` : ""),
       );
     } catch (e) {

package/extensions/webdav-backup/cli.mjs

@@ -246,7 +246,11 @@ async function main() {
       if (!has("--dry-run")) {
         logTo(`已写回 agent 目录：${agentDir}（${mergeMode ? "合并模式" : "替换模式"}）`);
         logTo(`  写入/覆盖 ${r.applied.length} 个，内容一致 ${r.unchanged.length} 个，失败 ${r.failed.length} 个`);
-        if (r.merged?.length) logTo(`  🔀 settings.json 已合并 packages，保留本机已有插件声明`);
+        if (r.merged?.length) {
+          const kinds = r.merged.map((m) => m.kind).filter(Boolean);
+          if (kinds.includes("settings-packages")) logTo(`  🔀 settings.json 已合并 packages，保留本机已有插件声明`);
+          if (kinds.includes("npm-dependencies")) logTo(`  🔀 npm/package.json 已合并 dependencies，保留本机独有插件依赖`);
+        }
         for (const x of r.skipped) logTo(`  ➖ ${x.rel}（${x.reason}）`);
         for (const x of r.failed) logTo(`  ❌ ${x.rel} — ${x.error}`);
         if (pluginReady) logTo("插件实现代码已随备份恢复，无需联网重装。");

package/extensions/webdav-backup/test-apply.mjs

@@ -298,7 +298,7 @@ async function main() {
     rmSync(live2, { recursive: true, force: true });
   }
 
-  // ── 8. mergeSettingsPackages：本机无声明时返回 null（用备份原样）
+  // 8. mergeSettingsPackages：本机无声明时返回 null（用备份原样）
   {
     check("本机无 packages 声明时不合并", mergeSettingsPackages('{"packages":["npm:A"]}', '{"theme":"x"}') === null);
     const m = mergeSettingsPackages('{"packages":["npm:A","npm:B"],"theme":"light"}', '{"packages":["npm:B@2"],"theme":"dark"}');
@@ -306,6 +306,50 @@ async function main() {
     check("合并保留本机声明优先、追加备份独有", JSON.stringify(o.packages) === JSON.stringify(["npm:B@2", "npm:A"]) && o.theme === "light", String(m));
   }
 
+  // ── 9. 回归：npm/package.json 必须合并 dependencies（否则 pi 会卸载本机独有插件）
+  {
+    // 备份来源（Windows）：只依赖 A、B
+    const backup = mkdtempSync(join(tmpdir(), "pi-npm-merge-bk-"));
+    mkdirSync(join(backup, "npm"), { recursive: true });
+    writeFileSync(join(backup, "settings.json"), JSON.stringify({ packages: ["npm:A", "npm:B"] }));
+    writeFileSync(
+      join(backup, "npm", "package.json"),
+      JSON.stringify({ name: "pi-extensions", private: true, dependencies: { A: "^1.0.0", B: "^2.0.0" } }),
+    );
+
+    // 目标机器（Linux）：已装 A（本机版本）+ 本机独有的 Z
+    const live = mkdtempSync(join(tmpdir(), "pi-npm-merge-live-"));
+    mkdirSync(join(live, "npm"), { recursive: true });
+    writeFileSync(join(live, "settings.json"), JSON.stringify({ packages: ["npm:A@9", "npm:Z"] }));
+    writeFileSync(
+      join(live, "npm", "package.json"),
+      JSON.stringify({ name: "pi-extensions", private: true, dependencies: { A: "^9.0.0", Z: "^0.1.0" } }),
+    );
+
+    const r = applyRestoredFiles(backup, live, { merge: true });
+    const deps = JSON.parse(readFileSync(join(live, "npm", "package.json"), "utf8")).dependencies;
+    check("merge 后 npm 依赖保留本机 A@9", deps.A === "^9.0.0", JSON.stringify(deps));
+    check("merge 后 npm 依赖保留本机独有 Z", deps.Z === "^0.1.0", JSON.stringify(deps));
+    check("merge 后 npm 依赖追加备份独有的 B", deps.B === "^2.0.0", JSON.stringify(deps));
+    check("merged 列表标出 npm-dependencies", r.merged?.some((m) => m.kind === "npm-dependencies"), JSON.stringify(r.merged));
+
+    // replace：完全用备份版（Z 会从 package.json 消失，由 pi 下次启动自行卸载）
+    const live2 = mkdtempSync(join(tmpdir(), "pi-npm-merge-live2-"));
+    mkdirSync(join(live2, "npm"), { recursive: true });
+    writeFileSync(join(live2, "settings.json"), JSON.stringify({ packages: ["npm:A@9", "npm:Z"] }));
+    writeFileSync(
+      join(live2, "npm", "package.json"),
+      JSON.stringify({ name: "pi-extensions", private: true, dependencies: { A: "^9.0.0", Z: "^0.1.0" } }),
+    );
+    applyRestoredFiles(backup, live2, { merge: false });
+    const deps2 = JSON.parse(readFileSync(join(live2, "npm", "package.json"), "utf8")).dependencies;
+    check("replace 后 npm 依赖完全变回备份版", JSON.stringify(deps2) === JSON.stringify({ A: "^1.0.0", B: "^2.0.0" }), JSON.stringify(deps2));
+
+    rmSync(backup, { recursive: true, force: true });
+    rmSync(live, { recursive: true, force: true });
+    rmSync(live2, { recursive: true, force: true });
+  }
+
   console.log(lines.join("\n"));
   console.log(`\n结果：${pass} 通过，${fail} 失败`);
   process.exit(fail === 0 ? 0 : 1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-webdav-backup",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "description": "pi 配置与插件数据自动备份到 WebDAV（坚果云 / Nextcloud / 群晖 / 自建）：归档与快照两种模式、AES-256-GCM 加密、DPAPI 密钥管理、敏感字段脱敏、agentDir 之外的额外数据（extraScope）、插件实现代码随备份（includePlugins）实现换机一键还原、退出自动备份与每日定时备份。",
   "keywords": [
     "pi-package",