@whispering233/ai-editor-server 0.0.53 → 0.0.54

package/client-dist/index.html

@@ -13,8 +13,8 @@
         // localStorage 不可用（隐私模式等）时静默跳过，默认浅色
       }
     </script>
-    <script type="module" crossorigin src="/assets/index-DnBMudDZ.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-DBshOA8W.css">
+    <script type="module" crossorigin src="/assets/index-Bgk8dcAm.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-B2op0r9o.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/backup.d.ts

@@ -3,24 +3,16 @@ import type { ProjectContext } from "./middleware/project.js";
 /** 备份目录名（项目目录内 .backups/，随书籍移动自然携带） */
 export declare const BACKUPS_DIR_NAME = ".backups";
 /**
- * 随备份 zip 整体打包的目录（目录名已登记在 `docs/api/20-api-backup.md`）：
- * 只一个 —— `sessions/`（会话 JSONL）。语义：白名单前缀 + 递归打包 + 参与变更判定 + 恢复时整体覆盖。
- * `SESSIONS_DIR_NAME` 取自 agent 包的 pi 运行时（会话目录的唯一事实来源；pi 的 session 文件落在此目录）。
- * （卡 12.7b：原 `references/` 随包目录已退役——参考资料正文在 `data.db` 的 `document_records` 里。）
+ * **遗留白名单**（2026-09 会话移出备份后只剩这一条）：`sessions/` 曾是随包目录，现在是
+ * **纯本地目录**（不进任何 zip）。本清单只服务「接受旧包」——`isAllowedBackupEntry` /
+ * `validateBackupPackage` 放行 `sessions/**` 条目（存量旧包继续可导入），条目内容**一律忽略**
+ * （恢复/导入/云拉取都不写不删本机会话）。
+ * `SESSIONS_DIR_NAME` 取自 agent 包的 pi 运行时（会话目录的唯一事实来源）。
  */
-export declare const PACKED_DIR_NAMES: readonly string[];
-/** 备份包条目白名单判定（三文件 + 打包目录前缀——逐名比对天然防 zip 路径穿越；
+export declare const LEGACY_PACKED_DIR_NAMES: readonly string[];
+/** 备份包条目白名单判定（三文件 + 遗留目录前缀——逐名比对天然防 zip 路径穿越；
  * 目录子路径拒绝含 `..` 的条目防相对路径逃逸） */
 export declare function isAllowedBackupEntry(name: string): boolean;
-/** 并集合并计数（`POST /cloud/pull` 响应的 `merged`；见 `docs/design/40-cloud-sync.md` §4） */
-export interface MergeCounts {
-    /** 本机独有（云端没有、基线也没有）→ 保留 */
-    kept: number;
-    /** 云端新增（本机没有、基线也没有）→ 写入 */
-    written: number;
-    /** 云端删除（本机有、基线有、云端没有）→ 删本机 */
-    removed: number;
-}
 /** 备份文件信息（GET /backups 列表项与 POST /backup 响应） */
 export interface BackupFileInfo {
     fileName: string;
@@ -38,8 +30,9 @@ export interface BackupFileInfo {
 /**
  * 打包当前项目为 zip（export 同款管道）：
  * wal_checkpoint(TRUNCATE) 把 WAL 合并回主文件（zip 内 data.db 为完整快照，
- * 无需附带 -wal/-shm）→ zipSync 打包（键序稳定：project.json → outline.json → data.db
- * → sessions/**——正文与参考资料在 data.db 内，不再有其他目录条目）。
+ * 无需附带 -wal/-shm）→ zipSync 打包（键序稳定：project.json → outline.json → data.db）。
+ * **条目恰好三文件**——`sessions/` 是纯本地目录，不进任何 zip（备份/导出/云端）；
+ * 正文与参考资料在 data.db 内。
  * 三文件缺失任一 → 抛错（打开的项目三文件必然齐全，缺失即损坏，不导出半成品包）。
  */
 export declare function createBackupZip(project: ProjectContext): Uint8Array<ArrayBuffer>;
@@ -61,6 +54,18 @@ export declare function writeBackup(project: ProjectContext, opts?: {
     name?: string;
     kind?: BackupKind;
 }): BackupFileInfo;
+/**
+ * 把一份**原始字节**的备份落进某项目目录的 `.backups/`（不重新打包、不改名、不参与保留策略）：
+ * 云端导入路径专用（`POST /cloud/import-book`）——把刚下载的那份 zip 原样落进新书，让新机器立刻有
+ * 一份「最新本地备份」（本地备份链从这份开始，否则 `backupStale` 等本地语义会立刻报「还没备份」，
+ * 见 `docs/design/40-cloud-sync.md` §10 为什么 3）。
+ *
+ * 文件名走备份命名白名单（与 rename/restore 同一道 `assertBackupFileNameFormat`，防路径穿越；
+ * 非法 → 400）；同名文件已存在 → 保留原有那份（不覆盖）；写入走原子写。
+ *
+ * @param projectDir 项目目录（不必是已打开的项目——云端导入的书写入时不带连接）
+ */
+export declare function writeRawBackupFile(projectDir: string, fileName: string, bytes: Uint8Array): void;
 /**
  * 升级兜底（卡 A）：`.backups/` 里**有文件但没有任何一份可解析**（旧命名残留形态）→
  * 立即 `writeBackup(project, { kind: "auto" })` 生成一份新格式备份并返回 true；
@@ -111,7 +116,8 @@ export declare function listBackups(project: ProjectContext): BackupFileInfo[];
  * 备份包完整校验（自 import 校验顺序 3-7 提取，restore 与 import 共用）：
  *
  * 1. zip 解析（流式 + 解压总字节预算 200MB，zip 炸弹防御；失败 400「不是有效的项目备份包」）
- * 2. 条目白名单（只接受 PROJECT_EXPORT_FILE_NAMES 三文件名 + sessions/ 目录条目；
+ * 2. 条目白名单（只接受 PROJECT_EXPORT_FILE_NAMES 三文件名 + 遗留的 sessions/ 目录条目——
+ * 存量旧包含 `sessions/**`，接受但**内容一律忽略**；新包不会再含它。
  * 逐名比对天然防 zip 路径穿越；**目录条目为非必需**——旧备份包无 sessions/ 仍可导入）
  * 3. 三文件齐全
  * 4. 临时目录写入 → project.json / outline.json 顶层（JSON 损坏 / 不符 → 400）
@@ -134,15 +140,12 @@ export declare function validateBackupPackage(zipData: Uint8Array): {
     projectName: string;
 };
 /**
- * 三文件 + `data.db-wal` 伴生文件 + 随包目录（`sessions/`）是否在 since 之后有变更
- *（「任一 mtime 晚于上次备份时刻」）：
+ * 三文件 + `data.db-wal` 伴生文件是否在 since 之后有变更（「任一 mtime 晚于上次备份时刻」）：
  * - 三文件：任一 mtime > since + 容差 → 有变更；**主文件缺失 → 视为有变更**（防御：不静默
  *   跳过，让备份管道报错暴露损坏）
  * - `data.db-wal`（F2）：普通写事务只追加 `-wal`、主文件 mtime 不变；**wal 缺失 ≠ 变更**
  *   （无未 checkpoint 的写，属正常状态，否则每次 tick 都误备份）
- * - `sessions/`：目录内**任一文件** mtime 命中，或**目录自身** mtime 命中
- *   （F3：删除文件不刷新任何剩余文件的 mtime，只看文件会漏检删除）；目录缺失（ENOENT）
- *   = 无文件、不算变更；其余错误防御视为有变更
+ * `sessions/` **不参与**（纯本地目录：不进包 ⇒ 写会话不该触发备份，见 `docs/design/40-cloud-sync.md` §3）。
  * mtime 判定容差见 BACKUP_CHANGE_TOLERANCE_MS 注释。
  */
 export declare function hasFileChangesSince(project: ProjectContext, since: Date): boolean;
@@ -150,21 +153,21 @@ export declare function hasFileChangesSince(project: ProjectContext, since: Date
  * 「本机创作数据自 since 后有改动」判定（**云端三态专用**，与备份定时器的 `hasFileChangesSince`
  * 口径刻意不同——见 `docs/design/40-cloud-sync.md` §3）：
  *
- * - `project.json` / `outline.json` / `sessions/`（含目录自身 mtime）：
+ * - `project.json` / `outline.json`：
  *   **严格** `mtime > since`。这些文件不会被备份/同步管道写入，容差在这里只有代价：
  *   `lastSyncAt` 是**不推进的固定基准**（只在下一次同步时前移），容差会把 `[since, since+1s]`
  *   内的本机改动**永久漏判**（状态误报「已同步」，用户可能因此拉取覆盖它）。
  * - `data.db` / `data.db-wal`：保留 `BACKUP_CHANGE_TOLERANCE_MS` 容差——备份/推送管道内的
  *   `wal_checkpoint` 会把 `data.db` mtime 刷到同步时刻，严格比较会自激误判「永远有改动」。
+ * - `sessions/` **不参与**（纯本地目录，不进包 ⇒ 纯聊天不产生「有东西待推」）。
  */
 export declare function hasLocalEditsSince(project: ProjectContext, since: Date): boolean;
 /**
  * 「本机**创作数据**自 since 后有改动」判定（**自动推送专用**，卡 7；`docs/design/40-cloud-sync.md` §5）：
- * 与 `hasLocalEditsSince` 同一套 mtime 口径，但 `sessions/` **不参与**（会话是聊天产物，纯聊天时段
- * 不该单独烧一次云盘配额——聊天记录会随下一次创作变更的 zip 一起上云，zip 永远含 `sessions/`），
- * 并**纳入 `AGENTS.md`**（项目规则也是创作数据，改规则值得推一次）。
+ * 与 `hasLocalEditsSince` 同一套 mtime 口径（两者都不含 `sessions/`——会话是纯本地目录、不进包），
+ * 但**额外纳入 `AGENTS.md`**（项目规则也是创作数据，改规则值得推一次）。
  *
- * 创作数据本体 = 三文件（正文/参考资料在 `data.db` 内，卡 12.7b 后已无随包目录参与本档）。
+ * 创作数据本体 = 三文件（正文/参考资料在 `data.db` 内）。
  */
 export declare function hasAuthoringChangesSince(project: ProjectContext, since: Date): boolean;
 /**
@@ -174,7 +177,7 @@ export declare function hasAuthoringChangesSince(project: ProjectContext, since:
 export declare function latestParseableBackupTime(project: ProjectContext): Date | null;
 /**
  * 「本机有改动未进最新备份」（卡 B，`GET /cloud/status` 的 `local.backupStale`）：
- * 最新一份本地备份的时间早于最新创作改动（三文件 + `sessions/`，口径同 `hasLocalEditsSince`，
+ * 最新一份本地备份的时间早于最新创作改动（三文件口径同 `hasLocalEditsSince`，
  * `data.db`/`-wal` 带 1s 容差）。**没有任何可解析备份 → true**
  *（那时推送会 404「没有可推送的备份」，语义上也是「还没有能代表当前的档」）。
  *
@@ -230,17 +233,15 @@ export declare function stopAutoBackup(): void;
  * （与 db 包 writeJsonAtomic 同款格式惯例）
  * - outline.json / data.db：原样字节原子写
  *
+ * **`sessions/` 一律不碰**（不写不删）：它是纯本地目录，包内的存量 `sessions/**` 条目接受但忽略。
+ *
  * 注意：本函数只管文件层，不含 data.db 连接管理（重连见 overwriteProjectFiles）。
  */
 export declare function writeProjectFilesFromBackup(dir: string, entries: Record<string, Uint8Array>, opts?: {
     keepId?: string;
     name?: string;
     snapshotFileName?: string;
-    /** 随包目录走**并集合并**（云拉取语义）；缺省 = 整体覆盖（本地 restore / import 语义不变） */
-    mergePackedDirs?: {
-        baseEntries: readonly string[];
-    };
-}): MergeCounts | undefined;
+}): void;
 /**
  * 自动迁移：project.json 存在非空 `prompt` 且项目目录无 →
  * 将 prompt 内容**原样**写入 （原子写，同款），一次性——
@@ -279,10 +280,7 @@ export declare function migratePromptToAgents(project: ProjectContext): void;
 export declare function overwriteProjectFiles(project: ProjectContext, entries: Record<string, Uint8Array>, opts?: {
     name?: string;
     snapshotFileName?: string;
-    mergePackedDirs?: {
-        baseEntries: readonly string[];
-    };
-}): MergeCounts | undefined;
+}): void;
 /**
  * 为**未打开的书**生成覆盖前快照（import 覆盖书架其他书场景，「覆盖前自动快照」）：
  * 临时打开 data.db 连接走备份管道（wal_checkpoint 保证快照完整性），完成后关闭连接。
@@ -308,12 +306,7 @@ export declare function snapshotBookDir(dir: string): BackupFileInfo;
  *
  * @throws HttpError 400（文件名非法/坏包）、404（备份不存在）、409 SCHEMA_VERSION_MISMATCH
  */
-export declare function restoreBackup(project: ProjectContext, fileName: string, options?: {
-    mergePackedDirs?: {
-        baseEntries: readonly string[];
-    };
-}): {
+export declare function restoreBackup(project: ProjectContext, fileName: string): {
     snapshot: Pick<BackupFileInfo, "fileName" | "createdAt">;
-    merged?: MergeCounts;
 };
 //# sourceMappingURL=backup.d.ts.map

package/dist/backup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../src/backup.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../src/backup.ts"],"names":[],"mappings":"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"}

package/dist/backup.js

@@ -33,18 +33,19 @@ import { HttpError } from "./middleware/error.js";
 /** 备份目录名（项目目录内 .backups/，随书籍移动自然携带） */
 export const BACKUPS_DIR_NAME = ".backups";
 /**
- * 随备份 zip 整体打包的目录（目录名已登记在 `docs/api/20-api-backup.md`）：
- * 只一个 —— `sessions/`（会话 JSONL）。语义：白名单前缀 + 递归打包 + 参与变更判定 + 恢复时整体覆盖。
- * `SESSIONS_DIR_NAME` 取自 agent 包的 pi 运行时（会话目录的唯一事实来源；pi 的 session 文件落在此目录）。
- * （卡 12.7b：原 `references/` 随包目录已退役——参考资料正文在 `data.db` 的 `document_records` 里。）
+ * **遗留白名单**（2026-09 会话移出备份后只剩这一条）：`sessions/` 曾是随包目录，现在是
+ * **纯本地目录**（不进任何 zip）。本清单只服务「接受旧包」——`isAllowedBackupEntry` /
+ * `validateBackupPackage` 放行 `sessions/**` 条目（存量旧包继续可导入），条目内容**一律忽略**
+ * （恢复/导入/云拉取都不写不删本机会话）。
+ * `SESSIONS_DIR_NAME` 取自 agent 包的 pi 运行时（会话目录的唯一事实来源）。
  */
-export const PACKED_DIR_NAMES = [SESSIONS_DIR_NAME];
-/** 备份包条目白名单判定（三文件 + 打包目录前缀——逐名比对天然防 zip 路径穿越；
+export const LEGACY_PACKED_DIR_NAMES = [SESSIONS_DIR_NAME];
+/** 备份包条目白名单判定（三文件 + 遗留目录前缀——逐名比对天然防 zip 路径穿越；
  * 目录子路径拒绝含 `..` 的条目防相对路径逃逸） */
 export function isAllowedBackupEntry(name) {
     if (PROJECT_EXPORT_FILE_NAMES.includes(name))
         return true;
-    return PACKED_DIR_NAMES.some((d) => name.startsWith(`${d}/`)) && !name.split("/").includes("..");
+    return LEGACY_PACKED_DIR_NAMES.some((d) => name.startsWith(`${d}/`)) && !name.split("/").includes("..");
 }
 /**
  * 备份标签（名称段）不得等于 WebDAV 应用密码：标签会进 `.backups/` 文件名并随备份上传到云盘，
@@ -58,101 +59,6 @@ function assertNotCredential(label) {
         return;
     throw new HttpError(400, "VALIDATION_ERROR", "备份名称不能与 WebDAV 应用密码相同（它会写进备份文件名并上传到云盘）");
 }
-/** 项目目录内某子目录的全部文件（递归，含 .trash/）相对路径（`/` 分隔）；目录缺失 → [] */
-function listDirFiles(root, dirName) {
-    const base = join(root, dirName);
-    if (!existsSync(base))
-        return [];
-    const out = [];
-    const walk = (dir, prefix) => {
-        for (const e of readdirSync(dir, { withFileTypes: true })) {
-            const rel = prefix === "" ? e.name : `${prefix}/${e.name}`;
-            const full = join(dir, e.name);
-            if (e.isDirectory())
-                walk(full, rel);
-            else
-                out.push(rel);
-        }
-    };
-    walk(base, "");
-    return out;
-}
-/**
- * 用备份条目**整体覆盖**项目目录内的打包目录（恢复/导入语义：目录以备份内容为准，
- * 本地残留不混入）。目录不存在则创建；`..` 条目跳过（白名单已校验，双保险）。
- */
-function overwriteDirFromEntries(dir, dirName, entries) {
-    const baseDir = join(dir, dirName);
-    if (existsSync(baseDir))
-        rmSync(baseDir, { recursive: true, force: true });
-    for (const key of Object.keys(entries)) {
-        if (!key.startsWith(`${dirName}/`))
-            continue;
-        const rel = key.slice(dirName.length + 1);
-        if (rel === "" || rel.split("/").includes(".."))
-            continue;
-        const target = join(baseDir, ...rel.split("/"));
-        mkdirSync(dirname(target), { recursive: true });
-        writeFileAtomic(target, entries[key]);
-    }
-}
-/**
- * 用备份条目与本机现有文件做**并集合并**（云拉取语义；本地 restore 不走这里）：
- * 逐文件三方比较（本机 / 云端那份 / 基线 `baseEntries`）——
- *
- * | 本机 | 云端 | 基线 | 动作 |
- * | 有 | 有 | — | 写云端那份（同名 = 同一资产） |
- * | 有 | 无 | ✔ | 删本机（云端删除传播） |
- * | 有 | 无 | ✘ | 保留本机（本机新增） |
- * | 无 | 有 | ✔ | **不写回**（本机删除优先，不被复活） |
- * | 无 | 有 | ✘ | 写进来（云端新增） |
- *
- * 基线由 `cloud.json` 的 `books[<id>].baseEntries`（= 最近一次推送/拉取包的条目）提供。
- */
-function mergeDirFromEntries(dir, dirName, entries, baseEntries) {
-    const baseDir = join(dir, dirName);
-    const rel = (key) => key.slice(dirName.length + 1);
-    const localSet = new Set(listDirFiles(dir, dirName));
-    const cloudKeys = Object.keys(entries).filter((k) => k.startsWith(`${dirName}/`) && rel(k) !== "");
-    const cloudSet = new Set(cloudKeys.map(rel));
-    const baseSet = new Set(baseEntries.filter((e) => e.startsWith(`${dirName}/`) && rel(e) !== "").map(rel));
-    const counts = { kept: 0, written: 0, removed: 0 };
-    const safeSegments = (path) => {
-        const segments = path.split("/");
-        return segments.includes("..") ? null : segments; // 白名单已校验，双保险
-    };
-    // 本机侧：云端没有的份，按基线判「云端删了它」还是「本机新增」
-    for (const path of localSet) {
-        if (cloudSet.has(path))
-            continue; // 两边都有 → 由云端侧写云端那份
-        const segments = safeSegments(path);
-        if (segments === null)
-            continue;
-        if (baseSet.has(path)) {
-            rmSync(join(baseDir, ...segments), { force: true });
-            counts.removed += 1;
-        }
-        else {
-            counts.kept += 1;
-        }
-    }
-    // 云端侧：本机没有的份，按基线判「本机删了它」（不复活）还是「云端新增」
-    for (const key of cloudKeys) {
-        const path = rel(key);
-        const segments = safeSegments(path);
-        if (segments === null)
-            continue;
-        const isLocalNew = !localSet.has(path);
-        if (isLocalNew && baseSet.has(path))
-            continue; // 本机删除优先
-        const target = join(baseDir, ...segments);
-        mkdirSync(dirname(target), { recursive: true });
-        writeFileAtomic(target, entries[key]);
-        if (isLocalNew)
-            counts.written += 1;
-    }
-    return counts;
-}
 /** 解压总字节预算（200MB，zip 炸弹防御——与 import 同款，restore 复用） */
 const MAX_UNZIP_BUDGET = 200 * 1024 * 1024;
 /**
@@ -182,8 +88,9 @@ function assertBackupFileNameFormat(fileName) {
 /**
  * 打包当前项目为 zip（export 同款管道）：
  * wal_checkpoint(TRUNCATE) 把 WAL 合并回主文件（zip 内 data.db 为完整快照，
- * 无需附带 -wal/-shm）→ zipSync 打包（键序稳定：project.json → outline.json → data.db
- * → sessions/**——正文与参考资料在 data.db 内，不再有其他目录条目）。
+ * 无需附带 -wal/-shm）→ zipSync 打包（键序稳定：project.json → outline.json → data.db）。
+ * **条目恰好三文件**——`sessions/` 是纯本地目录，不进任何 zip（备份/导出/云端）；
+ * 正文与参考资料在 data.db 内。
  * 三文件缺失任一 → 抛错（打开的项目三文件必然齐全，缺失即损坏，不导出半成品包）。
  */
 export function createBackupZip(project) {
@@ -194,12 +101,6 @@ export function createBackupZip(project) {
         [OUTLINE_FILE_NAME]: readFileSync(join(dir, OUTLINE_FILE_NAME)),
         [DATA_DB_FILE_NAME]: readFileSync(join(dir, DATA_DB_FILE_NAME)),
     };
-    // 打包目录随包（存在则递归打包；不存在跳过——旧项目无目录不报错）
-    for (const dirName of PACKED_DIR_NAMES) {
-        for (const rel of listDirFiles(dir, dirName)) {
-            zipEntries[`${dirName}/${rel}`] = readFileSync(join(dir, dirName, rel));
-        }
-    }
     return zipSync(zipEntries, { level: 6 });
 }
 /**
@@ -264,6 +165,25 @@ export function writeBackup(project, opts) {
         stats,
     };
 }
+/**
+ * 把一份**原始字节**的备份落进某项目目录的 `.backups/`（不重新打包、不改名、不参与保留策略）：
+ * 云端导入路径专用（`POST /cloud/import-book`）——把刚下载的那份 zip 原样落进新书，让新机器立刻有
+ * 一份「最新本地备份」（本地备份链从这份开始，否则 `backupStale` 等本地语义会立刻报「还没备份」，
+ * 见 `docs/design/40-cloud-sync.md` §10 为什么 3）。
+ *
+ * 文件名走备份命名白名单（与 rename/restore 同一道 `assertBackupFileNameFormat`，防路径穿越；
+ * 非法 → 400）；同名文件已存在 → 保留原有那份（不覆盖）；写入走原子写。
+ *
+ * @param projectDir 项目目录（不必是已打开的项目——云端导入的书写入时不带连接）
+ */
+export function writeRawBackupFile(projectDir, fileName, bytes) {
+    assertBackupFileNameFormat(fileName);
+    const backupsDir = join(projectDir, BACKUPS_DIR_NAME);
+    mkdirSync(backupsDir, { recursive: true });
+    const path = join(backupsDir, fileName);
+    if (!existsSync(path))
+        writeFileAtomic(path, bytes);
+}
 /**
  * 升级兜底（卡 A）：`.backups/` 里**有文件但没有任何一份可解析**（旧命名残留形态）→
  * 立即 `writeBackup(project, { kind: "auto" })` 生成一份新格式备份并返回 true；
@@ -484,7 +404,7 @@ function unzipWithBudget(zipData, budget) {
     const unzipper = new Unzip((file) => {
         names.push(file.name);
         if (!isAllowedBackupEntry(file.name))
-            return; // 未知条目不解压（白名单 = 三文件 + sessions/）
+            return; // 未知条目不解压（白名单 = 三文件 + 遗留 sessions/）
         const chunks = [];
         let size = 0;
         file.ondata = (err, chunk, final) => {
@@ -531,7 +451,8 @@ function isValidOutlineFile(parsed) {
  * 备份包完整校验（自 import 校验顺序 3-7 提取，restore 与 import 共用）：
  *
  * 1. zip 解析（流式 + 解压总字节预算 200MB，zip 炸弹防御；失败 400「不是有效的项目备份包」）
- * 2. 条目白名单（只接受 PROJECT_EXPORT_FILE_NAMES 三文件名 + sessions/ 目录条目；
+ * 2. 条目白名单（只接受 PROJECT_EXPORT_FILE_NAMES 三文件名 + 遗留的 sessions/ 目录条目——
+ * 存量旧包含 `sessions/**`，接受但**内容一律忽略**；新包不会再含它。
  * 逐名比对天然防 zip 路径穿越；**目录条目为非必需**——旧备份包无 sessions/ 仍可导入）
  * 3. 三文件齐全
  * 4. 临时目录写入 → project.json / outline.json 顶层（JSON 损坏 / 不符 → 400）
@@ -548,7 +469,7 @@ function isValidOutlineFile(parsed) {
  * @throws HttpError 400（坏包/缺文件/未知条目/不符）/ 409 SCHEMA_VERSION_MISMATCH
  */
 export function validateBackupPackage(zipData) {
-    // 1/2. 解压 + 白名单（严格拒绝）：三数据文件名 + sessions/ 前缀
+    // 1/2. 解压 + 白名单（严格拒绝）：三数据文件名 + 遗留的 sessions/ 前缀
     let entries;
     let entryNames;
     try {
@@ -563,7 +484,7 @@ export function validateBackupPackage(zipData) {
     }
     const unknown = entryNames.filter((k) => !isAllowedBackupEntry(k));
     if (unknown.length > 0) {
-        throw new HttpError(400, "VALIDATION_ERROR", `备份包含未知条目: ${unknown.join(", ")}（只接受 ${PROJECT_EXPORT_FILE_NAMES.join("/")} 与 ${PACKED_DIR_NAMES.map((d) => `${d}/`).join("/")}）`);
+        throw new HttpError(400, "VALIDATION_ERROR", `备份包含未知条目: ${unknown.join(", ")}（只接受 ${PROJECT_EXPORT_FILE_NAMES.join("/")}；存量旧包另可含 ${LEGACY_PACKED_DIR_NAMES.map((d) => `${d}/`).join("/")}，其内容被忽略）`);
     }
     const missing = PROJECT_EXPORT_FILE_NAMES.filter((f) => !(f in entries));
     if (missing.length > 0) {
@@ -662,15 +583,12 @@ function latestBackupTime(backupsDir) {
     return latest;
 }
 /**
- * 三文件 + `data.db-wal` 伴生文件 + 随包目录（`sessions/`）是否在 since 之后有变更
- *（「任一 mtime 晚于上次备份时刻」）：
+ * 三文件 + `data.db-wal` 伴生文件是否在 since 之后有变更（「任一 mtime 晚于上次备份时刻」）：
  * - 三文件：任一 mtime > since + 容差 → 有变更；**主文件缺失 → 视为有变更**（防御：不静默
  *   跳过，让备份管道报错暴露损坏）
  * - `data.db-wal`（F2）：普通写事务只追加 `-wal`、主文件 mtime 不变；**wal 缺失 ≠ 变更**
  *   （无未 checkpoint 的写，属正常状态，否则每次 tick 都误备份）
- * - `sessions/`：目录内**任一文件** mtime 命中，或**目录自身** mtime 命中
- *   （F3：删除文件不刷新任何剩余文件的 mtime，只看文件会漏检删除）；目录缺失（ENOENT）
- *   = 无文件、不算变更；其余错误防御视为有变更
+ * `sessions/` **不参与**（纯本地目录：不进包 ⇒ 写会话不该触发备份，见 `docs/design/40-cloud-sync.md` §3）。
  * mtime 判定容差见 BACKUP_CHANGE_TOLERANCE_MS 注释。
  */
 export function hasFileChangesSince(project, since) {
@@ -696,36 +614,13 @@ export function hasFileChangesSince(project, since) {
         if (err.code !== "ENOENT")
             return true;
     }
-    // 随包目录（sessions/）：目录自身或其内任一文件 mtime 晚于 limit → 有变更——
-    // 新增聊天会话、**删除文件**同样触发自动备份；
-    // 遍历竞态（读取中删除）→ 防御视为无变更（下一 tick 重检）
-    try {
-        for (const dirName of PACKED_DIR_NAMES) {
-            try {
-                if (statSync(join(project.root, dirName)).mtimeMs > limit)
-                    return true;
-            }
-            catch (err) {
-                if (err.code !== "ENOENT")
-                    return true;
-            }
-            for (const rel of listDirFiles(project.root, dirName)) {
-                if (statSync(join(project.root, dirName, rel)).mtimeMs > limit)
-                    return true;
-            }
-        }
-    }
-    catch {
-        // 忽略（下一 tick 重检）
-    }
+    // sessions/ 不参与变更判定（纯本地目录）
     return false;
 }
 /**
  * mtime 变更判定内核（`hasLocalEditsSince` 与 `hasAuthoringChangesSince` 共用，避免两份漂移）：
  * 三文件（`data.db`/`-wal` 带 `BACKUP_CHANGE_TOLERANCE_MS` 容差，其余**严格** `>`）→ 额外单文件
- * （`scope.extraFiles`，严格；ENOENT = 该可选文件不存在，不算变更）→ `scope.dirs` 各目录
- * （**目录自身**与其内任一文件 mtime 命中即算「有改动」——删除文件不刷新剩余文件 mtime，
- * 只看文件会漏检删除；目录缺失 = 无文件，不算变更）。
+ * （`scope.extraFiles`，严格；ENOENT = 该可选文件不存在，不算变更）。
  *
  * 容差只给 `data.db` 与 `-wal` 的原因：备份/推送管道内的 `wal_checkpoint` 会把其 mtime 刷到
  * 同步时刻，严格比较会自激误判「永远有改动」；其余文件不会被管道写入，给容差反而会让
@@ -769,48 +664,29 @@ function hasChangesSince(project, since, scope) {
                 return true;
         }
     }
-    try {
-        for (const dirName of scope.dirs ?? []) {
-            try {
-                if (statSync(join(project.root, dirName)).mtimeMs > strictLimit)
-                    return true;
-            }
-            catch (err) {
-                if (err.code !== "ENOENT")
-                    return true;
-            }
-            for (const rel of listDirFiles(project.root, dirName)) {
-                if (statSync(join(project.root, dirName, rel)).mtimeMs > strictLimit)
-                    return true;
-            }
-        }
-    }
-    catch {
-        // 遍历竞态（读取中删除）：下一次状态检查重检
-    }
     return false;
 }
 /**
  * 「本机创作数据自 since 后有改动」判定（**云端三态专用**，与备份定时器的 `hasFileChangesSince`
  * 口径刻意不同——见 `docs/design/40-cloud-sync.md` §3）：
  *
- * - `project.json` / `outline.json` / `sessions/`（含目录自身 mtime）：
+ * - `project.json` / `outline.json`：
  *   **严格** `mtime > since`。这些文件不会被备份/同步管道写入，容差在这里只有代价：
  *   `lastSyncAt` 是**不推进的固定基准**（只在下一次同步时前移），容差会把 `[since, since+1s]`
  *   内的本机改动**永久漏判**（状态误报「已同步」，用户可能因此拉取覆盖它）。
  * - `data.db` / `data.db-wal`：保留 `BACKUP_CHANGE_TOLERANCE_MS` 容差——备份/推送管道内的
  *   `wal_checkpoint` 会把 `data.db` mtime 刷到同步时刻，严格比较会自激误判「永远有改动」。
+ * - `sessions/` **不参与**（纯本地目录，不进包 ⇒ 纯聊天不产生「有东西待推」）。
  */
 export function hasLocalEditsSince(project, since) {
-    return hasChangesSince(project, since, { dirs: PACKED_DIR_NAMES });
+    return hasChangesSince(project, since, {});
 }
 /**
  * 「本机**创作数据**自 since 后有改动」判定（**自动推送专用**，卡 7；`docs/design/40-cloud-sync.md` §5）：
- * 与 `hasLocalEditsSince` 同一套 mtime 口径，但 `sessions/` **不参与**（会话是聊天产物，纯聊天时段
- * 不该单独烧一次云盘配额——聊天记录会随下一次创作变更的 zip 一起上云，zip 永远含 `sessions/`），
- * 并**纳入 `AGENTS.md`**（项目规则也是创作数据，改规则值得推一次）。
+ * 与 `hasLocalEditsSince` 同一套 mtime 口径（两者都不含 `sessions/`——会话是纯本地目录、不进包），
+ * 但**额外纳入 `AGENTS.md`**（项目规则也是创作数据，改规则值得推一次）。
  *
- * 创作数据本体 = 三文件（正文/参考资料在 `data.db` 内，卡 12.7b 后已无随包目录参与本档）。
+ * 创作数据本体 = 三文件（正文/参考资料在 `data.db` 内）。
  */
 export function hasAuthoringChangesSince(project, since) {
     return hasChangesSince(project, since, { extraFiles: [AGENTS_FILE_NAME] });
@@ -824,7 +700,7 @@ export function latestParseableBackupTime(project) {
 }
 /**
  * 「本机有改动未进最新备份」（卡 B，`GET /cloud/status` 的 `local.backupStale`）：
- * 最新一份本地备份的时间早于最新创作改动（三文件 + `sessions/`，口径同 `hasLocalEditsSince`，
+ * 最新一份本地备份的时间早于最新创作改动（三文件口径同 `hasLocalEditsSince`，
  * `data.db`/`-wal` 带 1s 容差）。**没有任何可解析备份 → true**
  *（那时推送会 404「没有可推送的备份」，语义上也是「还没有能代表当前的档」）。
  *
@@ -929,14 +805,15 @@ function scheduleNext(project) {
  * （与 db 包 writeJsonAtomic 同款格式惯例）
  * - outline.json / data.db：原样字节原子写
  *
+ * **`sessions/` 一律不碰**（不写不删）：它是纯本地目录，包内的存量 `sessions/**` 条目接受但忽略。
+ *
  * 注意：本函数只管文件层，不含 data.db 连接管理（重连见 overwriteProjectFiles）。
  */
 export function writeProjectFilesFromBackup(dir, entries, opts = {}) {
-    // 替换顺序：JSON 两文件在前，data.db 最后，sessions/ 收尾——db 替换失败时其余已替换
+    // 替换顺序：JSON 两文件在前，data.db 最后——db 替换失败时其余已替换
     // （校验已通过，文件内容本身有效，部分替换可经重新恢复修复）；replaced 清单供失败日志使用（P1-2）
     const targetNames = [PROJECT_FILE_NAME, OUTLINE_FILE_NAME, DATA_DB_FILE_NAME];
     const replaced = [];
-    let merged;
     try {
         const parsedProject = JSON.parse(new TextDecoder().decode(entries[PROJECT_FILE_NAME]));
         const nextProject = {
@@ -950,21 +827,6 @@ export function writeProjectFilesFromBackup(dir, entries, opts = {}) {
         replaced.push(OUTLINE_FILE_NAME);
         writeFileAtomic(join(dir, DATA_DB_FILE_NAME), entries[DATA_DB_FILE_NAME]);
         replaced.push(DATA_DB_FILE_NAME);
-        // 随包目录（sessions/ 会话 JSONL）：
-        // - 默认「整体覆盖」——恢复/导入是「整体还原」语义，目录以备份内容为准，本地残留不混入
-        // - `mergePackedDirs`（云拉取）= 与基线做三方比较的**并集合并**（删除优先，本机新增保留）
-        for (const dirName of PACKED_DIR_NAMES) {
-            if (opts.mergePackedDirs === undefined) {
-                overwriteDirFromEntries(dir, dirName, entries);
-            }
-            else {
-                const counts = mergeDirFromEntries(dir, dirName, entries, opts.mergePackedDirs.baseEntries);
-                merged = merged ?? { kept: 0, written: 0, removed: 0 };
-                merged.kept += counts.kept;
-                merged.written += counts.written;
-                merged.removed += counts.removed;
-            }
-        }
     }
     catch (err) {
         // P1-2：失败路径日志（对齐「记日志暴露部分替换」承诺）——已替换/未替换文件清单 + 覆盖前快照名
@@ -972,7 +834,6 @@ export function writeProjectFilesFromBackup(dir, entries, opts = {}) {
         console.error(`[backup] 覆盖文件替换失败（已替换: ${replaced.join(", ") || "无"}；未替换: ${notReplaced.join(", ") || "无"}${opts.snapshotFileName !== undefined ? `；覆盖前快照: ${opts.snapshotFileName}` : ""}）`, err);
         throw err;
     }
-    return merged;
 }
 /**
  * 自动迁移：project.json 存在非空 `prompt` 且项目目录无 →
@@ -1025,7 +886,6 @@ export function migratePromptToAgents(project) {
 export function overwriteProjectFiles(project, entries, opts = {}) {
     const dbPath = join(project.root, DATA_DB_FILE_NAME);
     closeDatabase(project.db); // 释放当前连接（替换 data.db 前必须；替换失败恢复见 catch）
-    let merged;
     try {
         // 清理陈旧 WAL/SHM 残留（正常关闭通常已清理；防御：替换后新库不得复用旧 WAL）
         for (const suffix of ["-wal", "-shm"]) {
@@ -1037,11 +897,10 @@ export function overwriteProjectFiles(project, entries, opts = {}) {
                     throw err;
             }
         }
-        merged = writeProjectFilesFromBackup(project.root, entries, {
+        writeProjectFilesFromBackup(project.root, entries, {
             keepId: project.config.id,
             ...(opts.name !== undefined ? { name: opts.name } : {}),
             ...(opts.snapshotFileName !== undefined ? { snapshotFileName: opts.snapshotFileName } : {}),
-            ...(opts.mergePackedDirs !== undefined ? { mergePackedDirs: opts.mergePackedDirs } : {}),
         });
         // 重连 + 版本对齐
         let active = openDatabase(dbPath);
@@ -1075,7 +934,6 @@ export function overwriteProjectFiles(project, entries, opts = {}) {
         throw err;
     }
     startAutoBackup(project); // 重启定时器（覆盖包内频率可能不同）
-    return merged;
 }
 /**
  * 为**未打开的书**生成覆盖前快照（import 覆盖书架其他书场景，「覆盖前自动快照」）：
@@ -1150,7 +1008,7 @@ function writeFileAtomic(filePath, data) {
  *
  * @throws HttpError 400（文件名非法/坏包）、404（备份不存在）、409 SCHEMA_VERSION_MISMATCH
  */
-export function restoreBackup(project, fileName, options = {}) {
+export function restoreBackup(project, fileName) {
     // 1. 白名单校验（assertBackupFileNameFormat：parseBackupFileName 全格式校验，防路径穿越；
     // 旧命名不可解析 ⇒ 一并被拒）
     assertBackupFileNameFormat(fileName);
@@ -1167,19 +1025,15 @@ export function restoreBackup(project, fileName, options = {}) {
     // 重连 data.db + 同步 config + 重启定时器。
     // name 归一为当前目录名（审核裁决：与 import 覆盖一致，维持「目录名 = 书名」
     // 不变式——id 是身份、name 是展示名；改名需求走 /project/rename）
-    const merged = overwriteProjectFiles(project, entries, {
+    overwriteProjectFiles(project, entries, {
         name: basename(project.root),
         snapshotFileName: snapshot.fileName,
-        ...(options.mergePackedDirs !== undefined ? { mergePackedDirs: options.mergePackedDirs } : {}),
     });
-    // 5. 会话无归属迁移：对话历史已出库为项目目录内 `sessions/*.jsonl`（迁移 006），归属由
-    // 目录表达，不再依赖 data.db 的 project_id——恢复只需覆盖三文件
-    // （`sessions/` 的入包与覆盖语义由备份管道承担，见 createBackupZip / writeProjectFilesFromBackup）。
-    //：snapshot 仅含 fileName/createdAt（size 属内部信息不暴露）
-    // snapshot 仅含 fileName/createdAt（size 属内部信息不暴露）；merged 仅在并集合并模式下有值
+    // 5. `sessions/` 不碰：对话历史是纯本地目录（不进任何 zip）——本机会话在恢复里不写不删；
+    // 存量旧包内的 `sessions/**` 条目接受但忽略（见 writeProjectFilesFromBackup）。
+    // snapshot 仅含 fileName/createdAt（size 属内部信息不暴露）
     return {
         snapshot: { fileName: snapshot.fileName, createdAt: snapshot.createdAt },
-        ...(merged !== undefined ? { merged } : {}),
     };
 }
 //# sourceMappingURL=backup.js.map