@musnows/scriverse 0.7.2 → 0.7.4

package/dist/store.js

@@ -1,15 +1,22 @@
 import { DRAFT_SETTING_MODULES } from "./domain.js";
 import { createHash } from "node:crypto";
-import { PLATFORM_AI_WORK_ID } from "./database.js";
+import { ENTITY_VERSION_BASELINE_MIGRATION_VERSION, PLATFORM_AI_WORK_ID } from "./database.js";
 import { exportWorkDocx } from "./docx-export.js";
+import { createEpubArchive } from "./epub-export.js";
 import { AppError, notFound } from "./errors.js";
+import { normalizeWorkSearchQuery } from "./hybrid-search.js";
 import { accountReference, logger } from "./logger.js";
 import { paginated, paginationSql } from "./pagination.js";
 import { currentRequestActor } from "./request-context.js";
 import { canWriteWorkModule, classifyWorkModulePermissions, emptyWorkModulePermissions, fullWorkModulePermissions, storedWorkModulePermissions } from "./work-permissions.js";
-import { countWords, documentShortSearchTerms, id, json, normalizeDocumentSearchText, normalizeParagraphSpacing, now, splitDocumentParagraphs } from "./utils.js";
+import { countWords, documentShortSearchTerms, escapeSqlLikePattern, id, json, normalizeDocumentSearchText, normalizeParagraphSpacing, now, splitDocumentParagraphs } from "./utils.js";
 import { buildWritingCalendar, writingDateKey } from "./writing-progress-time.js";
 import { resolveMaxAgentToolCallLimit } from "./ai-tool-results.js";
+const WORK_LIST_BATCH_SIZE = 500;
+export const RECYCLE_BIN_RETENTION_DAYS = 30;
+function recycleBinExpiresAt(deletedAt) {
+    return new Date(new Date(deletedAt).getTime() + RECYCLE_BIN_RETENTION_DAYS * 24 * 60 * 60_000).toISOString();
+}
 export const attachmentPermissionModules = ["prose", "drafts", "settings", "characters", "races", "organizations"];
 export const WORK_AGENT_TOOL_IDS = [
     "story_index",
@@ -147,6 +154,7 @@ function knowledgeSectionsFromInput(sections, settingsMarkdown, settings, fallba
 function settingsFromKnowledgeSections(sections) {
     return sections.map((section) => section.contentMarkdown).filter((content) => content.trim());
 }
+const CHAPTER_OUTLINE_BOARD_PREVIEW_LENGTH = 600;
 export const versionedEntityTypes = [
     "work",
     "volume",
@@ -160,6 +168,7 @@ export const versionedEntityTypes = [
     "chapter-outline",
     "foreshadow"
 ];
+export const AI_CONVERSATION_STREAM_REQUEST_LEASE_MS = 3 * 60_000;
 export const aiConversationTaskTypes = ["chat", "roleplay", "continue", "polish"];
 export function defaultAiConversationTitle(prompt) {
     const normalized = prompt.replace(/\s+/gu, " ").trim();
@@ -266,7 +275,38 @@ export class Store {
     db;
     constructor(db) {
         this.db = db;
-        this.backfillEntityVersionBaselines();
+        this.migrateEntityVersionBaselines();
+        this.purgeExpiredRecycleBin();
+    }
+    purgeExpiredRecycleBin(referenceTime = new Date()) {
+        const cutoff = new Date(referenceTime.getTime() - RECYCLE_BIN_RETENTION_DAYS * 24 * 60 * 60_000).toISOString();
+        return this.db.transaction(() => {
+            let works = 0;
+            let volumes = 0;
+            let chapters = 0;
+            for (const work of this.db.all("SELECT * FROM works WHERE deleted_at IS NOT NULL AND deleted_at <= ?", cutoff)) {
+                this.permanentlyRemoveWorkRow(work, "retention-expired");
+                works += 1;
+            }
+            for (const volume of this.db.all(`SELECT volume.* FROM volumes volume JOIN works work ON work.id = volume.work_id
+         WHERE work.deleted_at IS NULL AND volume.deleted_at IS NOT NULL AND volume.deleted_at <= ?`, cutoff)) {
+                this.permanentlyRemoveVolumeRow(volume, "retention-expired");
+                volumes += 1;
+            }
+            for (const chapter of this.db.all(`SELECT chapter.* FROM chapters chapter
+         JOIN works work ON work.id = chapter.work_id
+         JOIN volumes volume ON volume.id = chapter.volume_id
+         WHERE work.deleted_at IS NULL AND volume.deleted_at IS NULL
+           AND chapter.deleted_at IS NOT NULL AND chapter.deleted_via_volume_id IS NULL
+           AND chapter.deleted_at <= ?`, cutoff)) {
+                this.permanentlyRemoveChapterRow(chapter, "retention-expired");
+                chapters += 1;
+            }
+            if (works || volumes || chapters) {
+                logger.info("recycle_bin.retention_purged", { works, volumes, chapters, retentionDays: RECYCLE_BIN_RETENTION_DAYS });
+            }
+            return { works, volumes, chapters };
+        });
     }
     currentEntityVersionNo(type, entityId) {
         const row = this.db.get("SELECT MAX(version_no) AS version_no FROM entity_versions WHERE entity_type = ? AND entity_id = ?", type, entityId);
@@ -490,6 +530,26 @@ export class Store {
             }
         });
     }
+    migrateEntityVersionBaselines() {
+        const migrationSql = "SELECT 1 AS present FROM schema_migrations WHERE version = ?";
+        if (this.db.get(migrationSql, ENTITY_VERSION_BASELINE_MIGRATION_VERSION))
+            return;
+        this.db.transaction(() => {
+            if (this.db.get(migrationSql, ENTITY_VERSION_BASELINE_MIGRATION_VERSION))
+                return;
+            if (!this.db.get("SELECT 1 AS present FROM entity_versions LIMIT 1")) {
+                this.backfillEntityVersionBaselines();
+            }
+            const integrity = this.db.all("PRAGMA integrity_check");
+            if (integrity.some((row) => row.integrity_check !== "ok")) {
+                throw new Error(`数据库完整性检查失败：${integrity.map((row) => row.integrity_check).join("；")}`);
+            }
+            const foreignKeys = this.db.all("PRAGMA foreign_key_check");
+            if (foreignKeys.length > 0)
+                throw new Error(`数据库外键检查失败：发现 ${foreignKeys.length} 条异常记录`);
+            this.db.run("INSERT INTO schema_migrations (version, applied_at) VALUES (?, ?)", ENTITY_VERSION_BASELINE_MIGRATION_VERSION, now());
+        });
+    }
     listEntityVersions(type, entityId) {
         const rows = this.db.all(`SELECT version.*, user.display_name AS actor_display_name, user.username AS actor_username
        FROM entity_versions version LEFT JOIN users user ON user.id = version.created_by_user_id
@@ -534,6 +594,9 @@ export class Store {
         })), pagination);
     }
     restoreEntityVersion(type, entityId, versionNo, expectedVersionNo) {
+        if (type === "volume" && this.db.get("SELECT 1 AS present FROM volumes WHERE id = ? AND deleted_at IS NOT NULL", entityId)) {
+            throw new AppError(409, "ENTITY_IN_RECYCLE_BIN", "分卷位于回收站，请先从回收站恢复");
+        }
         const version = this.db.get("SELECT * FROM entity_versions WHERE entity_type = ? AND entity_id = ? AND version_no = ?", type, entityId, versionNo);
         if (!version)
             throw notFound("历史版本");
@@ -662,28 +725,61 @@ export class Store {
     listWorks() {
         const actor = currentRequestActor();
         if (!actor || (actor.role === "admin" && actor.authentication !== "api-key")) {
-            return this.db.all("SELECT * FROM works WHERE COALESCE(is_internal, 0) = 0 ORDER BY updated_at DESC").map((row) => this.mapWork(row));
+            return this.mapWorks(this.db.all("SELECT * FROM works WHERE COALESCE(is_internal, 0) = 0 AND deleted_at IS NULL ORDER BY updated_at DESC"));
         }
-        return this.db.all(`SELECT DISTINCT work.* FROM works work LEFT JOIN work_memberships membership ON membership.work_id = work.id
-       WHERE COALESCE(work.is_internal, 0) = 0 AND (work.owner_user_id = ? OR membership.user_id = ?)
-       ORDER BY work.updated_at DESC`, actor.userId, actor.userId).map((row) => this.mapWork(row));
+        return this.mapWorks(this.db.all(`SELECT DISTINCT work.* FROM works work LEFT JOIN work_memberships membership ON membership.work_id = work.id
+       WHERE COALESCE(work.is_internal, 0) = 0 AND work.deleted_at IS NULL
+         AND (work.owner_user_id = ? OR membership.user_id = ?)
+       ORDER BY work.updated_at DESC`, actor.userId, actor.userId));
     }
     listWorksPage(pagination) {
         const actor = currentRequestActor();
         const page = paginationSql(pagination);
         const rows = !actor || (actor.role === "admin" && actor.authentication !== "api-key")
-            ? this.db.all(`SELECT * FROM works WHERE COALESCE(is_internal, 0) = 0 ORDER BY updated_at DESC${page.sql}`, ...page.params)
+            ? this.db.all(`SELECT * FROM works WHERE COALESCE(is_internal, 0) = 0 AND deleted_at IS NULL ORDER BY updated_at DESC${page.sql}`, ...page.params)
             : this.db.all(`SELECT DISTINCT work.* FROM works work LEFT JOIN work_memberships membership ON membership.work_id = work.id
-         WHERE COALESCE(work.is_internal, 0) = 0 AND (work.owner_user_id = ? OR membership.user_id = ?)
+         WHERE COALESCE(work.is_internal, 0) = 0 AND work.deleted_at IS NULL
+           AND (work.owner_user_id = ? OR membership.user_id = ?)
          ORDER BY work.updated_at DESC${page.sql}`, actor.userId, actor.userId, ...page.params);
-        return paginated(rows.map((row) => this.mapWork(row)), pagination);
+        return paginated(this.mapWorks(rows), pagination);
     }
     getWork(workId) {
-        const row = this.db.get("SELECT * FROM works WHERE id = ?", workId);
+        const row = this.db.get("SELECT * FROM works WHERE id = ? AND deleted_at IS NULL", workId);
         if (!row)
             throw notFound("作品");
         return this.mapWork(row);
     }
+    listDeletedWorks() {
+        const actor = currentRequestActor();
+        const actorRestricted = Boolean(actor && !(actor.role === "admin" && actor.authentication !== "api-key"));
+        const rows = this.db.all(`SELECT work.*,
+        (SELECT COUNT(*) FROM volumes volume WHERE volume.work_id = work.id) AS volume_count,
+        (SELECT COUNT(*) FROM chapters chapter WHERE chapter.work_id = work.id) AS chapter_count,
+        user.display_name AS actor_display_name, user.username AS actor_username
+       FROM works work
+       LEFT JOIN entity_versions version
+         ON version.entity_type = 'work' AND version.entity_id = work.id
+         AND version.version_no = work.version_no AND version.source = 'delete'
+       LEFT JOIN users user ON user.id = version.created_by_user_id
+       WHERE COALESCE(work.is_internal, 0) = 0 AND work.deleted_at IS NOT NULL
+         ${actorRestricted ? "AND work.owner_user_id = ?" : ""}
+       ORDER BY work.deleted_at DESC, work.id DESC`, ...(actorRestricted ? [actor.userId] : []));
+        return rows.map((row) => {
+            const deletedAt = requiredString(row, "deleted_at");
+            return {
+                id: requiredString(row, "id"),
+                title: requiredString(row, "title"),
+                author: requiredString(row, "author"),
+                description: requiredString(row, "description"),
+                versionNo: numberValue(row, "version_no"),
+                volumeCount: numberValue(row, "volume_count"),
+                chapterCount: numberValue(row, "chapter_count"),
+                deletedAt,
+                expiresAt: recycleBinExpiresAt(deletedAt),
+                actor: optionalString(row, "actor_display_name") ?? optionalString(row, "actor_username") ?? "历史数据"
+            };
+        });
+    }
     getPlatformAiSettings() {
         const row = this.db.get("SELECT * FROM platform_ai_settings WHERE id = 1");
         return {
@@ -917,26 +1013,74 @@ export class Store {
         return this.getWork(workId);
     }
     deleteWork(workId, expectedVersionNo) {
-        const work = this.getWork(workId);
-        const storageKeys = this.db.all("SELECT DISTINCT storage_key FROM attachments WHERE work_id = ?", workId)
-            .map((row) => requiredString(row, "storage_key"));
         this.db.transaction(() => {
-            this.db.raw.exec("PRAGMA defer_foreign_keys = ON");
             const current = this.getWork(workId);
             this.assertExpectedVersion("work", workId, expectedVersionNo, "作品", Number(current.versionNo));
-            this.recordEntityVersion("work", workId, "delete", null, "删除作品");
-            this.audit(null, "work.deleted", "work", workId, { title: work.title });
-            this.db.run("DELETE FROM characters WHERE work_id = ?", workId);
-            this.db.run("DELETE FROM organizations WHERE work_id = ?", workId);
-            this.db.run("UPDATE races SET parent_race_id = NULL WHERE work_id = ? AND parent_race_id IS NOT NULL", workId);
-            this.db.run("DELETE FROM races WHERE work_id = ?", workId);
-            this.db.run("DELETE FROM works WHERE id = ?", workId);
-            this.db.run("DELETE FROM relationship_source_index_queue WHERE work_id = ?", workId);
-            for (const storageKey of storageKeys) {
-                if (!this.attachmentStorageKeyInUse(storageKey))
-                    this.enqueueAttachmentCleanup(storageKey);
-            }
+            const timestamp = now();
+            const versionNo = this.recordEntityVersion("work", workId, "delete", null, "删除作品（可恢复）", timestamp);
+            this.db.run("UPDATE works SET version_no = ?, deleted_at = ?, updated_at = ? WHERE id = ?", versionNo, timestamp, timestamp, workId);
+            this.audit(workId, "work.deleted", "work", workId, {
+                title: current.title,
+                versionNo,
+                recoverable: true,
+                expiresAt: recycleBinExpiresAt(timestamp)
+            });
+        });
+        return [];
+    }
+    restoreWork(workId, expectedVersionNo) {
+        const deleted = this.db.get("SELECT * FROM works WHERE id = ? AND deleted_at IS NOT NULL", workId);
+        if (!deleted)
+            throw notFound("回收站作品");
+        this.assertExpectedVersion("work", workId, expectedVersionNo, "作品", numberValue(deleted, "version_no"));
+        this.db.transaction(() => {
+            const locked = this.db.get("SELECT * FROM works WHERE id = ? AND deleted_at IS NOT NULL", workId);
+            if (!locked)
+                throw new AppError(409, "WORK_ALREADY_RESTORED", "作品已经恢复");
+            this.assertExpectedVersion("work", workId, expectedVersionNo, "作品", numberValue(locked, "version_no"));
+            const deletionVersion = this.db.get("SELECT id FROM entity_versions WHERE entity_type = 'work' AND entity_id = ? AND source = 'delete' ORDER BY version_no DESC LIMIT 1", workId);
+            const timestamp = now();
+            this.db.run("UPDATE works SET deleted_at = NULL, updated_at = ? WHERE id = ?", timestamp, workId);
+            const versionNo = this.recordEntityVersion("work", workId, "restore", optionalString(deletionVersion ?? {}, "id"), "从回收站恢复作品", timestamp);
+            this.db.run("UPDATE works SET version_no = ? WHERE id = ?", versionNo, workId);
+            this.audit(workId, "work.restored", "work", workId, { versionNo, fromRecycleBin: true });
         });
+        return this.getWorkDirectory(workId);
+    }
+    permanentlyDeleteWork(workId, expectedVersionNo, reason = "manual") {
+        const deleted = this.db.get("SELECT * FROM works WHERE id = ? AND deleted_at IS NOT NULL", workId);
+        if (!deleted)
+            throw new AppError(409, "WORK_NOT_IN_RECYCLE_BIN", "仅回收站中的作品可以彻底删除");
+        this.assertExpectedVersion("work", workId, expectedVersionNo, "作品", numberValue(deleted, "version_no"));
+        return this.db.transaction(() => {
+            const locked = this.db.get("SELECT * FROM works WHERE id = ? AND deleted_at IS NOT NULL", workId);
+            if (!locked)
+                throw new AppError(409, "WORK_NOT_IN_RECYCLE_BIN", "仅回收站中的作品可以彻底删除");
+            this.assertExpectedVersion("work", workId, expectedVersionNo, "作品", numberValue(locked, "version_no"));
+            return this.permanentlyRemoveWorkRow(locked, reason);
+        });
+    }
+    permanentlyRemoveWorkRow(work, reason) {
+        const workId = requiredString(work, "id");
+        const storageKeys = this.db.all("SELECT DISTINCT storage_key FROM attachments WHERE work_id = ?", workId)
+            .map((row) => requiredString(row, "storage_key"));
+        this.db.raw.exec("PRAGMA defer_foreign_keys = ON");
+        this.audit(null, "work.purged", "work", workId, {
+            title: requiredString(work, "title"),
+            versionNo: numberValue(work, "version_no"),
+            reason,
+            recoverable: false
+        });
+        this.db.run("DELETE FROM characters WHERE work_id = ?", workId);
+        this.db.run("DELETE FROM organizations WHERE work_id = ?", workId);
+        this.db.run("UPDATE races SET parent_race_id = NULL WHERE work_id = ? AND parent_race_id IS NOT NULL", workId);
+        this.db.run("DELETE FROM races WHERE work_id = ?", workId);
+        this.db.run("DELETE FROM works WHERE id = ?", workId);
+        this.db.run("DELETE FROM relationship_source_index_queue WHERE work_id = ?", workId);
+        for (const storageKey of storageKeys) {
+            if (!this.attachmentStorageKeyInUse(storageKey))
+                this.enqueueAttachmentCleanup(storageKey);
+        }
         return storageKeys.filter((storageKey) => !this.attachmentStorageKeyInUse(storageKey));
     }
     setWorkCover(workId, mimeType, content, expectedVersionNo) {
@@ -967,7 +1111,7 @@ export class Store {
         if (!row)
             return null;
         const mimeType = requiredString(row, "mime_type");
-        if (mimeType !== "image/jpeg" && mimeType !== "image/png" && mimeType !== "image/webp") {
+        if (mimeType !== "image/jpeg" && mimeType !== "image/png" && mimeType !== "image/webp" && mimeType !== "image/gif") {
             throw new AppError(500, "INVALID_COVER_MIME", "作品封面类型无效");
         }
         return {
@@ -991,7 +1135,7 @@ export class Store {
     }
     getWorkTree(workId) {
         const work = this.getWork(workId);
-        const volumeRows = this.db.all("SELECT * FROM volumes WHERE work_id = ? ORDER BY sort_order, created_at", workId);
+        const volumeRows = this.db.all("SELECT * FROM volumes WHERE work_id = ? AND deleted_at IS NULL ORDER BY sort_order, created_at", workId);
         const chapterRows = this.db.all("SELECT * FROM chapters WHERE work_id = ? AND deleted_at IS NULL ORDER BY sort_order, created_at", workId);
         const chaptersByVolume = new Map();
         for (const row of chapterRows) {
@@ -1012,7 +1156,7 @@ export class Store {
         const permissions = work.modulePermissions;
         if (permissions.prose === "none")
             return { ...work, volumes: [] };
-        const volumeRows = this.db.all("SELECT * FROM volumes WHERE work_id = ? ORDER BY sort_order, created_at", workId);
+        const volumeRows = this.db.all("SELECT * FROM volumes WHERE work_id = ? AND deleted_at IS NULL ORDER BY sort_order, created_at", workId);
         const chapterRows = this.db.all(`SELECT id, work_id, volume_id, title, chapter_type, sort_order, word_count, version_no,
         analysis_status, excluded_from_analysis, created_at, updated_at
        FROM chapters WHERE work_id = ? AND deleted_at IS NULL ORDER BY sort_order, created_at`, workId);
@@ -1037,7 +1181,7 @@ export class Store {
             return { ...work, volumes: [] };
         const volumeRows = this.db.all(`SELECT volume.*,
         (SELECT COUNT(*) FROM chapters chapter WHERE chapter.volume_id = volume.id AND chapter.deleted_at IS NULL) AS chapter_count
-       FROM volumes volume WHERE volume.work_id = ? ORDER BY volume.sort_order, volume.created_at`, workId);
+       FROM volumes volume WHERE volume.work_id = ? AND volume.deleted_at IS NULL ORDER BY volume.sort_order, volume.created_at`, workId);
         const volumes = volumeRows.map((row) => ({
             ...this.mapVolume(row),
             chapterCount: numberValue(row, "chapter_count"),
@@ -1070,7 +1214,7 @@ export class Store {
         const permissions = work.modulePermissions;
         if (permissions.prose === "none")
             return { ...work, volumes: [], directoryPage: paginated([], pagination) };
-        const volumeRows = this.db.all("SELECT * FROM volumes WHERE work_id = ? ORDER BY sort_order, created_at", workId);
+        const volumeRows = this.db.all("SELECT * FROM volumes WHERE work_id = ? AND deleted_at IS NULL ORDER BY sort_order, created_at", workId);
         const page = paginationSql(pagination);
         const chapterRows = this.db.all(`SELECT id, work_id, volume_id, title, chapter_type, sort_order, word_count, version_no,
         analysis_status, excluded_from_analysis, created_at, updated_at
@@ -1147,11 +1291,13 @@ export class Store {
             const timestamp = now();
             this.db.run(`INSERT INTO file_versions (id, work_id, file_name, file_type, word_count, paragraph_count, warnings_json, snapshot_json, created_at, created_by_user_id)
          VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, restorePointId, workId, `before-restore:${requiredString(version, "file_name")}`, "snapshot", wordCount, paragraphCount, "[]", JSON.stringify(currentTree), timestamp, currentRequestActor()?.userId ?? null);
-            for (const row of this.db.all("SELECT id FROM volumes WHERE work_id = ?", workId)) {
-                this.recordEntityVersion("volume", requiredString(row, "id"), "delete", fileVersionId, "替换作品树前保存分卷历史");
+            const activeVolumeIds = this.db.all("SELECT id FROM volumes WHERE work_id = ? AND deleted_at IS NULL", workId)
+                .map((row) => requiredString(row, "id"));
+            for (const volumeId of activeVolumeIds) {
+                this.recordEntityVersion("volume", volumeId, "delete", fileVersionId, "替换作品树前保存分卷历史");
             }
-            this.clearDraftVolumeBindings(workId, null, fileVersionId, "恢复文件版本时原分卷已被替换");
-            this.db.run("DELETE FROM volumes WHERE work_id = ?", workId);
+            this.clearDraftVolumeBindings(workId, activeVolumeIds, fileVersionId, "恢复文件版本时原分卷已被替换");
+            this.db.run("DELETE FROM volumes WHERE work_id = ? AND deleted_at IS NULL", workId);
             for (const volume of volumes) {
                 const volumeId = id("volume");
                 this.insertVolumeWithId(workId, volumeId, {
@@ -1199,14 +1345,16 @@ export class Store {
        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, fileVersionId, workId, fileName, fileType, parsed.wordCount, parsed.paragraphCount, JSON.stringify(parsed.warnings), JSON.stringify(snapshot), timestamp, currentRequestActor()?.userId ?? null);
         let volumeOrderOffset = 0;
         if (mode === "overwrite") {
-            for (const row of this.db.all("SELECT id FROM volumes WHERE work_id = ?", workId)) {
-                this.recordEntityVersion("volume", requiredString(row, "id"), "delete", fileVersionId, "导入前保存分卷历史");
+            const activeVolumeIds = this.db.all("SELECT id FROM volumes WHERE work_id = ? AND deleted_at IS NULL", workId)
+                .map((row) => requiredString(row, "id"));
+            for (const volumeId of activeVolumeIds) {
+                this.recordEntityVersion("volume", volumeId, "delete", fileVersionId, "导入前保存分卷历史");
             }
-            this.clearDraftVolumeBindings(workId, null, fileVersionId, "覆盖导入时原分卷已被替换");
-            this.db.run("DELETE FROM volumes WHERE work_id = ?", workId);
+            this.clearDraftVolumeBindings(workId, activeVolumeIds, fileVersionId, "覆盖导入时原分卷已被替换");
+            this.db.run("DELETE FROM volumes WHERE work_id = ? AND deleted_at IS NULL", workId);
         }
         else {
-            const lastVolume = this.db.get("SELECT COALESCE(MAX(sort_order), -1) AS value FROM volumes WHERE work_id = ?", workId);
+            const lastVolume = this.db.get("SELECT COALESCE(MAX(sort_order), -1) AS value FROM volumes WHERE work_id = ? AND deleted_at IS NULL", workId);
             volumeOrderOffset = numberValue(lastVolume ?? {}, "value") + 1;
         }
         let firstImportedChapterId = null;
@@ -1248,7 +1396,7 @@ export class Store {
     insertVolumeWithId(workId, volumeId, input, source = "create", sourceRef = null, changeNote = "") {
         this.getWork(workId);
         const timestamp = now();
-        const last = this.db.get("SELECT COALESCE(MAX(sort_order), -1) AS value FROM volumes WHERE work_id = ?", workId);
+        const last = this.db.get("SELECT COALESCE(MAX(sort_order), -1) AS value FROM volumes WHERE work_id = ? AND deleted_at IS NULL", workId);
         this.db.run(`INSERT INTO volumes (id, work_id, title, kind, source, description, keywords_json, sort_order, version_no, created_at, updated_at)
        VALUES (?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?)`, volumeId, workId, input.title, input.kind ?? "main", input.source ?? "manual", input.description?.trim() ?? "", JSON.stringify(this.normalizeVolumeKeywords(input.keywords ?? [])), input.sortOrder ?? numberValue(last ?? {}, "value") + 1, timestamp, timestamp);
         const versionNo = this.recordEntityVersion("volume", volumeId, source, sourceRef, changeNote || "建立分卷", timestamp);
@@ -1258,7 +1406,8 @@ export class Store {
         return this.getVolume(volumeId);
     }
     getVolume(volumeId) {
-        const row = this.db.get("SELECT * FROM volumes WHERE id = ?", volumeId);
+        const row = this.db.get(`SELECT volume.* FROM volumes volume JOIN works work ON work.id = volume.work_id
+       WHERE volume.id = ? AND volume.deleted_at IS NULL AND work.deleted_at IS NULL`, volumeId);
         if (!row)
             throw notFound("卷");
         return this.mapVolume(row);
@@ -1278,20 +1427,109 @@ export class Store {
         this.db.transaction(() => {
             const current = this.getVolume(volumeId);
             this.assertExpectedVersion("volume", volumeId, expectedVersionNo, "分卷", Number(current.versionNo));
-            const counts = this.db.get(`SELECT
-          SUM(CASE WHEN deleted_at IS NULL THEN 1 ELSE 0 END) AS active_count,
-          SUM(CASE WHEN deleted_at IS NOT NULL THEN 1 ELSE 0 END) AS deleted_count
-        FROM chapters WHERE volume_id = ?`, volumeId);
-            if (numberValue(counts ?? {}, "active_count") > 0) {
-                throw new AppError(409, "VOLUME_NOT_EMPTY", "卷内仍有章节，需先移动或删除章节");
+            const timestamp = now();
+            const workId = String(current.workId);
+            const versionNo = this.recordEntityVersion("volume", volumeId, "delete", null, "删除分卷（可恢复）", timestamp);
+            const activeChapters = this.db.all("SELECT id FROM chapters WHERE volume_id = ? AND deleted_at IS NULL", volumeId);
+            this.db.run("UPDATE volumes SET version_no = ?, deleted_at = ?, updated_at = ? WHERE id = ?", versionNo, timestamp, timestamp, volumeId);
+            for (const chapter of activeChapters) {
+                const chapterId = requiredString(chapter, "id");
+                this.db.run("UPDATE chapters SET deleted_at = ?, deleted_via_volume_id = ?, updated_at = ? WHERE id = ?", timestamp, volumeId, timestamp, chapterId);
+                this.db.run("DELETE FROM chapter_paragraph_search WHERE chapter_id = ?", chapterId);
             }
-            if (numberValue(counts ?? {}, "deleted_count") > 0) {
-                throw new AppError(409, "VOLUME_HAS_DELETED_CHAPTERS", "分卷回收站中仍有章节，请先彻底删除或恢复并移动这些章节");
+            this.db.run(`UPDATE analysis_tasks SET status = 'expired', updated_at = ?
+         WHERE work_id = ? AND status IN ('pending', 'running', 'completed', 'partial', 'review')
+           AND (json_extract(scope_json, '$.type') = 'book'
+             OR (json_extract(scope_json, '$.type') = 'volume' AND json_extract(scope_json, '$.volumeId') = ?))`, timestamp, workId, volumeId);
+            this.db.run("UPDATE works SET updated_at = ? WHERE id = ?", timestamp, workId);
+            this.audit(workId, "volume.deleted", "volume", volumeId, {
+                versionNo,
+                chapterCount: activeChapters.length,
+                recoverable: true,
+                expiresAt: recycleBinExpiresAt(timestamp)
+            });
+        });
+    }
+    listDeletedVolumes(workId) {
+        this.getWork(workId);
+        return this.db.all(`SELECT volume.*,
+        (SELECT COUNT(*) FROM chapters chapter WHERE chapter.volume_id = volume.id) AS chapter_count,
+        user.display_name AS actor_display_name, user.username AS actor_username
+       FROM volumes volume
+       LEFT JOIN entity_versions version
+         ON version.entity_type = 'volume' AND version.entity_id = volume.id
+         AND version.version_no = volume.version_no AND version.source = 'delete'
+       LEFT JOIN users user ON user.id = version.created_by_user_id
+       WHERE volume.work_id = ? AND volume.deleted_at IS NOT NULL
+       ORDER BY volume.deleted_at DESC, volume.id DESC`, workId).map((row) => {
+            const deletedAt = requiredString(row, "deleted_at");
+            return {
+                ...this.mapVolume(row),
+                chapterCount: numberValue(row, "chapter_count"),
+                deletedAt,
+                expiresAt: recycleBinExpiresAt(deletedAt),
+                actor: optionalString(row, "actor_display_name") ?? optionalString(row, "actor_username") ?? "历史数据"
+            };
+        });
+    }
+    restoreVolume(volumeId, expectedVersionNo) {
+        const deleted = this.db.get("SELECT * FROM volumes WHERE id = ? AND deleted_at IS NOT NULL", volumeId);
+        if (!deleted)
+            throw notFound("回收站分卷");
+        const workId = requiredString(deleted, "work_id");
+        this.getWork(workId);
+        this.assertExpectedVersion("volume", volumeId, expectedVersionNo, "分卷", numberValue(deleted, "version_no"));
+        this.db.transaction(() => {
+            const locked = this.db.get("SELECT * FROM volumes WHERE id = ? AND deleted_at IS NOT NULL", volumeId);
+            if (!locked)
+                throw new AppError(409, "VOLUME_ALREADY_RESTORED", "分卷已经恢复");
+            this.assertExpectedVersion("volume", volumeId, expectedVersionNo, "分卷", numberValue(locked, "version_no"));
+            const deletionVersion = this.db.get("SELECT id FROM entity_versions WHERE entity_type = 'volume' AND entity_id = ? AND source = 'delete' ORDER BY version_no DESC LIMIT 1", volumeId);
+            const timestamp = now();
+            this.db.run("UPDATE volumes SET deleted_at = NULL, updated_at = ? WHERE id = ?", timestamp, volumeId);
+            const versionNo = this.recordEntityVersion("volume", volumeId, "restore", optionalString(deletionVersion ?? {}, "id"), "从回收站恢复分卷", timestamp);
+            this.db.run("UPDATE volumes SET version_no = ? WHERE id = ?", versionNo, volumeId);
+            const chapters = this.db.all("SELECT id, content, version_no FROM chapters WHERE deleted_via_volume_id = ?", volumeId);
+            for (const chapter of chapters) {
+                const chapterId = requiredString(chapter, "id");
+                this.db.run("UPDATE chapters SET deleted_at = NULL, deleted_via_volume_id = NULL, analysis_status = 'expired', updated_at = ? WHERE id = ?", timestamp, chapterId);
+                this.syncChapterParagraphSearch(workId, chapterId, requiredString(chapter, "content"));
+                this.invalidateChapter(workId, chapterId, numberValue(chapter, "version_no"));
             }
-            this.recordEntityVersion("volume", volumeId, "delete", null, "删除分卷");
-            this.clearDraftVolumeBindings(String(current.workId), [volumeId], null, "绑定的分卷已删除");
-            this.db.run("DELETE FROM volumes WHERE id = ?", volumeId);
-            this.audit(String(current.workId), "volume.deleted", "volume", volumeId, { versionNo: Number(current.versionNo) });
+            this.db.run("UPDATE works SET updated_at = ? WHERE id = ?", timestamp, workId);
+            this.audit(workId, "volume.restored", "volume", volumeId, { versionNo, chapterCount: chapters.length, fromRecycleBin: true });
+        });
+        return this.getVolume(volumeId);
+    }
+    permanentlyDeleteVolume(volumeId, expectedVersionNo, reason = "manual") {
+        const deleted = this.db.get("SELECT * FROM volumes WHERE id = ? AND deleted_at IS NOT NULL", volumeId);
+        if (!deleted)
+            throw new AppError(409, "VOLUME_NOT_IN_RECYCLE_BIN", "仅回收站中的分卷可以彻底删除");
+        this.assertExpectedVersion("volume", volumeId, expectedVersionNo, "分卷", numberValue(deleted, "version_no"));
+        this.db.transaction(() => {
+            const locked = this.db.get("SELECT * FROM volumes WHERE id = ? AND deleted_at IS NOT NULL", volumeId);
+            if (!locked)
+                throw new AppError(409, "VOLUME_NOT_IN_RECYCLE_BIN", "仅回收站中的分卷可以彻底删除");
+            this.assertExpectedVersion("volume", volumeId, expectedVersionNo, "分卷", numberValue(locked, "version_no"));
+            this.permanentlyRemoveVolumeRow(locked, reason);
+        });
+    }
+    permanentlyRemoveVolumeRow(volume, reason) {
+        const volumeId = requiredString(volume, "id");
+        const workId = requiredString(volume, "work_id");
+        const chapters = this.db.all("SELECT * FROM chapters WHERE volume_id = ?", volumeId);
+        for (const chapter of chapters)
+            this.permanentlyRemoveChapterRow(chapter, reason, false);
+        this.clearDraftVolumeBindings(workId, [volumeId], null, "绑定的分卷已彻底删除");
+        this.db.run("DELETE FROM entity_versions WHERE entity_type = 'volume' AND entity_id = ?", volumeId);
+        this.db.run("DELETE FROM volumes WHERE id = ?", volumeId);
+        this.db.run("UPDATE works SET updated_at = ? WHERE id = ?", now(), workId);
+        this.audit(workId, "volume.purged", "volume", volumeId, {
+            title: requiredString(volume, "title"),
+            chapterCount: chapters.length,
+            versionNo: numberValue(volume, "version_no"),
+            reason,
+            recoverable: false
         });
     }
     createChapter(workId, input) {
@@ -1307,7 +1545,11 @@ export class Store {
         });
     }
     getChapter(chapterId) {
-        const row = this.db.get("SELECT * FROM chapters WHERE id = ? AND deleted_at IS NULL", chapterId);
+        const row = this.db.get(`SELECT chapter.* FROM chapters chapter
+       JOIN volumes volume ON volume.id = chapter.volume_id
+       JOIN works work ON work.id = chapter.work_id
+       WHERE chapter.id = ? AND chapter.deleted_at IS NULL
+         AND volume.deleted_at IS NULL AND work.deleted_at IS NULL`, chapterId);
         if (!row)
             throw notFound("章节");
         return this.mapChapter(row);
@@ -1331,9 +1573,11 @@ export class Store {
          ON version.chapter_id = chapter.id AND version.version_no = chapter.version_no AND version.source = 'delete'
        LEFT JOIN users user ON user.id = version.created_by_user_id
        WHERE chapter.work_id = ? AND chapter.deleted_at IS NOT NULL
+         AND chapter.deleted_via_volume_id IS NULL AND volume.deleted_at IS NULL
        ORDER BY chapter.deleted_at DESC, chapter.id DESC${pageSql}`, workId, ...pageParams);
     }
     mapDeletedChapter(row) {
+        const deletedAt = requiredString(row, "deleted_at");
         return {
             id: requiredString(row, "id"),
             workId: requiredString(row, "work_id"),
@@ -1343,10 +1587,18 @@ export class Store {
             contentPreview: requiredString(row, "content").slice(0, 300),
             wordCount: numberValue(row, "word_count"),
             versionNo: numberValue(row, "version_no"),
-            deletedAt: requiredString(row, "deleted_at"),
+            deletedAt,
+            expiresAt: recycleBinExpiresAt(deletedAt),
             actor: optionalString(row, "actor_display_name") ?? optionalString(row, "actor_username") ?? "历史数据"
         };
     }
+    getRecycleBin(workId) {
+        return {
+            retentionDays: RECYCLE_BIN_RETENTION_DAYS,
+            volumes: this.listDeletedVolumes(workId),
+            chapters: this.listDeletedChapters(workId)
+        };
+    }
     findChapterVersionRows(chapterId) {
         return this.db.all(`SELECT version.*, user.display_name AS actor_display_name, user.username AS actor_username
         FROM chapter_versions version LEFT JOIN users user ON user.id = version.created_by_user_id
@@ -1393,7 +1645,7 @@ export class Store {
             this.getChapter(chapterId);
             return paginated([], pagination);
         }
-        return paginated(rows.slice(pagination.offset, pagination.offset + pagination.limit + 1).map((row) => this.mapChapterVersionRow(row)), pagination);
+        return paginated(rows.map((row) => this.mapChapterVersionRow(row)), pagination);
     }
     listChapterInsights(chapterId) {
         this.getChapter(chapterId);
@@ -1646,6 +1898,9 @@ export class Store {
         const deleted = this.db.get("SELECT * FROM chapters WHERE id = ? AND deleted_at IS NOT NULL", chapterId);
         if (!deleted)
             throw notFound("章节");
+        if (optionalString(deleted, "deleted_via_volume_id")) {
+            throw new AppError(409, "CHAPTER_DELETED_WITH_VOLUME", "章节随分卷进入回收站，请先恢复分卷");
+        }
         const currentVersionNo = numberValue(deleted, "version_no");
         this.assertExpectedRevision("chapter", chapterId, expectedVersionNo, "章节", currentVersionNo);
         const workId = requiredString(deleted, "work_id");
@@ -1664,12 +1919,15 @@ export class Store {
         const nextVersionNo = Math.max(currentVersionNo, numberValue(this.db.get("SELECT COALESCE(MAX(version_no), 0) AS version_no FROM chapter_versions WHERE chapter_id = ?", chapterId) ?? {}, "version_no")) + 1;
         const timestamp = now();
         this.db.transaction(() => {
-            const locked = this.db.get("SELECT version_no, deleted_at FROM chapters WHERE id = ?", chapterId);
+            const locked = this.db.get("SELECT version_no, deleted_at, deleted_via_volume_id FROM chapters WHERE id = ?", chapterId);
             if (!locked?.deleted_at)
                 throw new AppError(409, "CHAPTER_ALREADY_RESTORED", "章节已经恢复");
+            if (optionalString(locked, "deleted_via_volume_id")) {
+                throw new AppError(409, "CHAPTER_DELETED_WITH_VOLUME", "章节随分卷进入回收站，请先恢复分卷");
+            }
             this.assertExpectedRevision("chapter", chapterId, expectedVersionNo, "章节", numberValue(locked, "version_no"));
             this.db.run(`UPDATE chapters SET volume_id = ?, title = ?, content = ?, chapter_type = ?, sort_order = ?, word_count = ?,
-          version_no = ?, analysis_status = 'pending', deleted_at = NULL, updated_at = ? WHERE id = ?`, volumeId, title, content, chapterType, sortOrder, countWords(content), nextVersionNo, timestamp, chapterId);
+          version_no = ?, analysis_status = 'pending', deleted_at = NULL, deleted_via_volume_id = NULL, updated_at = ? WHERE id = ?`, volumeId, title, content, chapterType, sortOrder, countWords(content), nextVersionNo, timestamp, chapterId);
             this.syncChapterParagraphSearch(workId, chapterId, content);
             this.insertChapterVersionRow({
                 workId,
@@ -1951,7 +2209,7 @@ export class Store {
                 for (const chapter of currentChapters) {
                     const chapterId = String(chapter.id);
                     const versionNo = Number(chapter.versionNo) + 1;
-                    this.db.run("UPDATE chapters SET version_no = ?, deleted_at = ?, updated_at = ? WHERE id = ?", versionNo, timestamp, timestamp, chapterId);
+                    this.db.run("UPDATE chapters SET version_no = ?, deleted_at = ?, deleted_via_volume_id = NULL, updated_at = ? WHERE id = ?", versionNo, timestamp, timestamp, chapterId);
                     this.insertChapterVersionRow({
                         workId,
                         chapterId,
@@ -1988,7 +2246,7 @@ export class Store {
         this.db.transaction(() => {
             const lockedChapter = this.getChapter(chapterId);
             this.assertExpectedRevision("chapter", chapterId, expectedVersionNo, "章节", Number(lockedChapter.versionNo));
-            this.db.run("UPDATE chapters SET version_no = ?, deleted_at = ?, updated_at = ? WHERE id = ?", versionNo, timestamp, timestamp, chapterId);
+            this.db.run("UPDATE chapters SET version_no = ?, deleted_at = ?, deleted_via_volume_id = NULL, updated_at = ? WHERE id = ?", versionNo, timestamp, timestamp, chapterId);
             this.insertChapterVersionRow({
                 workId: String(chapter.workId),
                 chapterId,
@@ -2014,33 +2272,45 @@ export class Store {
             this.audit(String(chapter.workId), "chapter.deleted", "chapter", chapterId, { versionNo });
         });
     }
-    permanentlyDeleteChapter(chapterId, expectedVersionNo) {
+    permanentlyDeleteChapter(chapterId, expectedVersionNo, reason = "manual") {
         const chapter = this.db.get("SELECT * FROM chapters WHERE id = ?", chapterId);
         if (!chapter)
             throw notFound("章节");
         if (!chapter.deleted_at)
             throw new AppError(409, "CHAPTER_NOT_IN_RECYCLE_BIN", "仅回收站中的章节可以彻底删除");
+        if (optionalString(chapter, "deleted_via_volume_id")) {
+            throw new AppError(409, "CHAPTER_DELETED_WITH_VOLUME", "章节随分卷进入回收站，请在分卷条目上操作");
+        }
         this.assertExpectedRevision("chapter", chapterId, expectedVersionNo, "章节", numberValue(chapter, "version_no"));
-        const workId = requiredString(chapter, "work_id");
-        const timestamp = now();
         this.db.transaction(() => {
             const locked = this.db.get("SELECT * FROM chapters WHERE id = ?", chapterId);
             if (!locked)
                 throw notFound("章节");
             if (!locked.deleted_at)
                 throw new AppError(409, "CHAPTER_NOT_IN_RECYCLE_BIN", "仅回收站中的章节可以彻底删除");
+            if (optionalString(locked, "deleted_via_volume_id")) {
+                throw new AppError(409, "CHAPTER_DELETED_WITH_VOLUME", "章节随分卷进入回收站，请在分卷条目上操作");
+            }
             this.assertExpectedRevision("chapter", chapterId, expectedVersionNo, "章节", numberValue(locked, "version_no"));
-            this.db.run("DELETE FROM chapter_versions WHERE chapter_id = ?", chapterId);
-            this.db.run("DELETE FROM entity_versions WHERE entity_type = 'chapter-outline' AND entity_id = ?", chapterId);
-            this.db.run("DELETE FROM attachment_references WHERE entity_type = 'chapter' AND entity_id = ?", chapterId);
-            this.db.run("DELETE FROM chapters WHERE id = ?", chapterId);
-            this.db.run("UPDATE works SET updated_at = ? WHERE id = ?", timestamp, workId);
-            this.audit(workId, "chapter.purged", "chapter", chapterId, {
-                title: requiredString(locked, "title"),
-                volumeId: requiredString(locked, "volume_id"),
-                versionNo: numberValue(locked, "version_no"),
-                recoverable: false
-            });
+            this.permanentlyRemoveChapterRow(locked, reason);
+        });
+    }
+    permanentlyRemoveChapterRow(chapter, reason, recordAudit = true) {
+        const chapterId = requiredString(chapter, "id");
+        const workId = requiredString(chapter, "work_id");
+        this.db.run("DELETE FROM chapter_versions WHERE chapter_id = ?", chapterId);
+        this.db.run("DELETE FROM entity_versions WHERE entity_type = 'chapter-outline' AND entity_id = ?", chapterId);
+        this.db.run("DELETE FROM attachment_references WHERE entity_type = 'chapter' AND entity_id = ?", chapterId);
+        this.db.run("DELETE FROM chapters WHERE id = ?", chapterId);
+        if (!recordAudit)
+            return;
+        this.db.run("UPDATE works SET updated_at = ? WHERE id = ?", now(), workId);
+        this.audit(workId, "chapter.purged", "chapter", chapterId, {
+            title: requiredString(chapter, "title"),
+            volumeId: requiredString(chapter, "volume_id"),
+            versionNo: numberValue(chapter, "version_no"),
+            reason,
+            recoverable: false
         });
     }
     insertChapter(workId, volumeId, title, content, sortOrder, source, sourceRef, chapterType = "正文") {
@@ -2125,12 +2395,45 @@ export class Store {
         }
         this.notifyAnalysisTaskQueued(workId);
     }
-    mapWork(row) {
+    mapWorks(rows) {
+        if (rows.length === 0)
+            return [];
+        const actor = currentRequestActor();
+        const workIds = [...new Set(rows.map((row) => requiredString(row, "id")))];
+        const batch = {
+            memberships: new Map(),
+            counts: new Map(),
+            covers: new Map()
+        };
+        for (let offset = 0; offset < workIds.length; offset += WORK_LIST_BATCH_SIZE) {
+            const batchIds = workIds.slice(offset, offset + WORK_LIST_BATCH_SIZE);
+            const placeholders = batchIds.map(() => "?").join(", ");
+            if (actor) {
+                const memberships = this.db.all(`SELECT work_id, role, permissions_json FROM work_memberships
+           WHERE user_id = ? AND work_id IN (${placeholders})`, actor.userId, ...batchIds);
+                for (const membership of memberships) {
+                    batch.memberships.set(requiredString(membership, "work_id"), membership);
+                }
+            }
+            const counts = this.db.all(`SELECT work_id, COUNT(*) AS chapter_count, COALESCE(SUM(word_count), 0) AS word_count
+         FROM chapters WHERE work_id IN (${placeholders}) AND deleted_at IS NULL GROUP BY work_id`, ...batchIds);
+            for (const count of counts)
+                batch.counts.set(requiredString(count, "work_id"), count);
+            const covers = this.db.all(`SELECT work_id, updated_at FROM work_covers WHERE work_id IN (${placeholders})`, ...batchIds);
+            for (const cover of covers)
+                batch.covers.set(requiredString(cover, "work_id"), cover);
+        }
+        return rows.map((row) => this.mapWork(row, batch));
+    }
+    mapWork(row, batch) {
         const actor = currentRequestActor();
+        const workId = requiredString(row, "id");
         const ownerUserId = optionalString(row, "owner_user_id");
-        const membership = actor
-            ? this.db.get("SELECT role, permissions_json FROM work_memberships WHERE work_id = ? AND user_id = ?", requiredString(row, "id"), actor.userId)
-            : undefined;
+        const membership = batch
+            ? batch.memberships.get(workId)
+            : actor
+                ? this.db.get("SELECT role, permissions_json FROM work_memberships WHERE work_id = ? AND user_id = ?", workId, actor.userId)
+                : undefined;
         const membershipRole = String(membership?.role ?? "");
         const ownerAccess = ownerUserId === actor?.userId;
         const adminAccess = actor?.role === "admin" && actor.authentication !== "api-key";
@@ -2144,19 +2447,23 @@ export class Store {
             : adminAccess
                 ? "admin"
                 : membershipRole ? classifyWorkModulePermissions(modulePermissions) : null;
-        const count = this.db.get("SELECT COUNT(*) AS chapter_count, COALESCE(SUM(word_count), 0) AS word_count FROM chapters WHERE work_id = ? AND deleted_at IS NULL", requiredString(row, "id"));
-        const cover = this.db.get("SELECT updated_at FROM work_covers WHERE work_id = ?", requiredString(row, "id"));
+        const count = batch
+            ? batch.counts.get(workId)
+            : this.db.get("SELECT COUNT(*) AS chapter_count, COALESCE(SUM(word_count), 0) AS word_count FROM chapters WHERE work_id = ? AND deleted_at IS NULL", workId);
+        const cover = batch
+            ? batch.covers.get(workId)
+            : this.db.get("SELECT updated_at FROM work_covers WHERE work_id = ?", workId);
         return {
-            id: requiredString(row, "id"),
+            id: workId,
             title: requiredString(row, "title"),
             author: requiredString(row, "author"),
             description: requiredString(row, "description"),
             language: requiredString(row, "language"),
             coverUrl: cover
-                ? `/api/works/${encodeURIComponent(requiredString(row, "id"))}/cover?v=${encodeURIComponent(requiredString(cover, "updated_at"))}`
+                ? `/api/works/${encodeURIComponent(workId)}/cover?v=${encodeURIComponent(requiredString(cover, "updated_at"))}`
                 : optionalString(row, "cover_url"),
             tags: json(requiredString(row, "tags_json"), []),
-            versionNo: numberValue(row, "version_no") || this.currentEntityVersionNo("work", requiredString(row, "id")),
+            versionNo: numberValue(row, "version_no") || this.currentEntityVersionNo("work", workId),
             ownerUserId,
             accessRole,
             modulePermissions,
@@ -2213,6 +2520,142 @@ export class Store {
             return null;
         return this.mapChapterOutline(row, chapter);
     }
+    getChapterOutlineBoard(workId) {
+        this.getWork(workId);
+        const previewLength = CHAPTER_OUTLINE_BOARD_PREVIEW_LENGTH;
+        const rows = this.db.all(`SELECT volume.id AS volume_id, volume.title AS volume_title, volume.sort_order AS volume_order,
+       chapter.id AS chapter_id, chapter.title AS chapter_title, chapter.chapter_type,
+       chapter.sort_order AS chapter_order,
+       outline.chapter_id AS outline_chapter_id,
+       substr(outline.goal, 1, ?) AS goal, length(outline.goal) > ? AS goal_truncated,
+       substr(outline.conflict, 1, ?) AS conflict, length(outline.conflict) > ? AS conflict_truncated,
+       substr(outline.turning_point, 1, ?) AS turning_point, length(outline.turning_point) > ? AS turning_point_truncated,
+       substr(outline.notes, 1, ?) AS notes, length(outline.notes) > ? AS notes_truncated,
+       outline.status, outline.updated_at AS outline_updated_at
+       FROM volumes volume
+       LEFT JOIN chapters chapter
+         ON chapter.volume_id = volume.id AND chapter.work_id = volume.work_id AND chapter.deleted_at IS NULL
+       LEFT JOIN chapter_outlines outline ON outline.chapter_id = chapter.id
+       WHERE volume.work_id = ? AND volume.deleted_at IS NULL
+       ORDER BY volume.sort_order, volume.created_at, volume.id,
+         chapter.sort_order, chapter.created_at, chapter.id`, previewLength, previewLength, previewLength, previewLength, previewLength, previewLength, previewLength, previewLength, workId);
+        const volumeById = new Map();
+        const chapterById = new Map();
+        let outlinedChapterCount = 0;
+        for (const row of rows) {
+            const volumeId = requiredString(row, "volume_id");
+            let volume = volumeById.get(volumeId);
+            if (!volume) {
+                volume = {
+                    id: volumeId,
+                    title: requiredString(row, "volume_title"),
+                    sortOrder: numberValue(row, "volume_order"),
+                    chapters: []
+                };
+                volumeById.set(volumeId, volume);
+            }
+            const chapterId = optionalString(row, "chapter_id");
+            if (!chapterId)
+                continue;
+            const hasOutline = optionalString(row, "outline_chapter_id") !== null;
+            if (hasOutline)
+                outlinedChapterCount += 1;
+            const chapter = {
+                id: chapterId,
+                title: requiredString(row, "chapter_title"),
+                chapterType: requiredString(row, "chapter_type") || "正文",
+                sortOrder: numberValue(row, "chapter_order"),
+                outline: hasOutline ? {
+                    goal: optionalString(row, "goal") ?? "",
+                    conflict: optionalString(row, "conflict") ?? "",
+                    turningPoint: optionalString(row, "turning_point") ?? "",
+                    notes: optionalString(row, "notes") ?? "",
+                    status: optionalString(row, "status") ?? "draft",
+                    truncated: ["goal_truncated", "conflict_truncated", "turning_point_truncated", "notes_truncated"]
+                        .some((field) => booleanValue(row, field)),
+                    updatedAt: optionalString(row, "outline_updated_at")
+                } : null,
+                foreshadows: []
+            };
+            volume.chapters.push(chapter);
+            chapterById.set(chapterId, chapter);
+        }
+        const associations = new Map();
+        const associate = (chapterId, source, role, plannedPayoff = false) => {
+            if (!chapterId || !chapterById.has(chapterId))
+                return;
+            const byForeshadow = associations.get(chapterId) ?? new Map();
+            const summary = byForeshadow.get(source.id) ?? {
+                ...source,
+                roles: new Set(),
+                plannedPayoff: false
+            };
+            if (role)
+                summary.roles.add(role);
+            if (plannedPayoff)
+                summary.plannedPayoff = true;
+            byForeshadow.set(source.id, summary);
+            associations.set(chapterId, byForeshadow);
+        };
+        const foreshadowRows = this.db.all(`SELECT foreshadow.id, foreshadow.title, foreshadow.status, foreshadow.importance,
+       occurrence_chapter.id AS occurrence_chapter_id, occurrence_volume.id AS occurrence_volume_id,
+       occurrence.role, payoff_chapter.id AS payoff_chapter_id, payoff_volume.id AS payoff_volume_id
+       FROM foreshadows foreshadow
+       LEFT JOIN foreshadow_occurrences occurrence ON occurrence.foreshadow_id = foreshadow.id
+       LEFT JOIN chapters occurrence_chapter
+         ON occurrence_chapter.id = occurrence.chapter_id
+         AND occurrence_chapter.work_id = foreshadow.work_id
+         AND occurrence_chapter.deleted_at IS NULL
+       LEFT JOIN volumes occurrence_volume
+         ON occurrence_volume.id = occurrence_chapter.volume_id AND occurrence_volume.deleted_at IS NULL
+       LEFT JOIN chapters payoff_chapter
+         ON payoff_chapter.id = foreshadow.planned_payoff_chapter_id
+         AND payoff_chapter.work_id = foreshadow.work_id
+         AND payoff_chapter.deleted_at IS NULL
+       LEFT JOIN volumes payoff_volume
+         ON payoff_volume.id = payoff_chapter.volume_id AND payoff_volume.deleted_at IS NULL
+       WHERE foreshadow.work_id = ?
+       ORDER BY CASE foreshadow.importance WHEN 'high' THEN 0 WHEN 'medium' THEN 1 ELSE 2 END,
+         foreshadow.created_at, foreshadow.id, occurrence.created_at, occurrence.id`, workId);
+        const foreshadowIds = new Set();
+        const unresolvedForeshadowIds = new Set();
+        for (const row of foreshadowRows) {
+            const source = {
+                id: requiredString(row, "id"),
+                title: requiredString(row, "title"),
+                status: requiredString(row, "status"),
+                importance: requiredString(row, "importance")
+            };
+            foreshadowIds.add(source.id);
+            if (source.status === "planned" || source.status === "planted")
+                unresolvedForeshadowIds.add(source.id);
+            const occurrenceChapterId = optionalString(row, "occurrence_volume_id")
+                ? optionalString(row, "occurrence_chapter_id")
+                : null;
+            const role = optionalString(row, "role");
+            associate(occurrenceChapterId, source, role === "setup" || role === "reminder" || role === "payoff" ? role : undefined);
+            associate(optionalString(row, "payoff_volume_id") ? optionalString(row, "payoff_chapter_id") : null, source, undefined, true);
+        }
+        for (const [chapterId, byForeshadow] of associations) {
+            const chapter = chapterById.get(chapterId);
+            if (!chapter)
+                continue;
+            chapter.foreshadows = [...byForeshadow.values()].map((summary) => ({
+                ...summary,
+                roles: [...summary.roles]
+            }));
+        }
+        return {
+            workId,
+            volumes: [...volumeById.values()],
+            stats: {
+                chapterCount: chapterById.size,
+                outlinedChapterCount,
+                foreshadowCount: foreshadowIds.size,
+                unresolvedForeshadowCount: unresolvedForeshadowIds.size
+            }
+        };
+    }
     listChapterOutlines(workId) {
         this.getWork(workId);
         const rows = this.db.all(`SELECT c.id AS chapter_id, c.title AS chapter_title, c.volume_id, c.sort_order AS chapter_order,
@@ -2391,6 +2834,63 @@ export class Store {
        ORDER BY CASE importance WHEN 'high' THEN 0 WHEN 'medium' THEN 1 ELSE 2 END, created_at${page.sql}`, workId, ...page.params);
         return paginated(rows.map((row) => this.getForeshadow(requiredString(row, "id"), currentChapterId)), pagination);
     }
+    listChapterForeshadowReminders(workId, chapterId) {
+        this.getWork(workId);
+        this.assertChapterInWork(chapterId, workId);
+        const seenForeshadowIds = new Set();
+        return this.db.all(`SELECT occurrence.id AS occurrence_id, occurrence.foreshadow_id, occurrence.role, occurrence.note,
+       foreshadow.title, foreshadow.description, foreshadow.status, foreshadow.importance,
+       foreshadow.updated_at,
+       (SELECT MAX(version.version_no) FROM entity_versions version
+        WHERE version.entity_type = 'foreshadow' AND version.entity_id = foreshadow.id) AS version_no
+       FROM foreshadow_occurrences occurrence
+       JOIN foreshadows foreshadow ON foreshadow.id = occurrence.foreshadow_id
+       JOIN chapters chapter ON chapter.id = occurrence.chapter_id
+       WHERE foreshadow.work_id = ? AND chapter.work_id = ? AND occurrence.chapter_id = ?
+         AND foreshadow.status IN ('planned', 'planted')
+         AND occurrence.role IN ('reminder', 'payoff')
+       ORDER BY CASE occurrence.role WHEN 'payoff' THEN 0 ELSE 1 END,
+         CASE foreshadow.importance WHEN 'high' THEN 0 WHEN 'medium' THEN 1 ELSE 2 END,
+         foreshadow.created_at, occurrence.created_at`, workId, workId, chapterId).flatMap((row) => {
+            const foreshadowId = requiredString(row, "foreshadow_id");
+            if (seenForeshadowIds.has(foreshadowId))
+                return [];
+            seenForeshadowIds.add(foreshadowId);
+            return [{
+                    foreshadowId,
+                    occurrenceId: requiredString(row, "occurrence_id"),
+                    title: requiredString(row, "title"),
+                    description: requiredString(row, "description"),
+                    status: requiredString(row, "status"),
+                    importance: requiredString(row, "importance"),
+                    role: requiredString(row, "role"),
+                    note: requiredString(row, "note"),
+                    versionNo: numberValue(row, "version_no"),
+                    updatedAt: requiredString(row, "updated_at")
+                }];
+        });
+    }
+    resolveChapterForeshadowReminder(workId, chapterId, foreshadowId, expectedVersionNo) {
+        this.getWork(workId);
+        this.assertChapterInWork(chapterId, workId);
+        const reminder = this.db.get(`SELECT occurrence.id AS occurrence_id
+       FROM foreshadow_occurrences occurrence
+       JOIN foreshadows foreshadow ON foreshadow.id = occurrence.foreshadow_id
+       WHERE foreshadow.id = ? AND foreshadow.work_id = ? AND occurrence.chapter_id = ?
+         AND foreshadow.status IN ('planned', 'planted')
+         AND occurrence.role IN ('reminder', 'payoff')
+       ORDER BY CASE occurrence.role WHEN 'payoff' THEN 0 ELSE 1 END, occurrence.created_at
+       LIMIT 1`, foreshadowId, workId, chapterId);
+        if (!reminder)
+            throw notFound("伏笔提醒");
+        const updated = this.updateForeshadow(foreshadowId, { status: "resolved" }, "manual", requiredString(reminder, "occurrence_id"), "在编辑器标记伏笔已回收", expectedVersionNo);
+        return {
+            foreshadowId: String(updated.id),
+            status: String(updated.status),
+            versionNo: Number(updated.versionNo),
+            updatedAt: String(updated.updatedAt)
+        };
+    }
     updateForeshadow(foreshadowId, input, source = "manual", sourceRef = null, changeNote = "", expectedVersionNo) {
         const current = this.getForeshadow(foreshadowId);
         const workId = String(current.workId);
@@ -2531,7 +3031,7 @@ export class Store {
         this.getWork(workId);
         const safeLimit = Math.min(30, Math.max(1, Math.trunc(limit)));
         const normalizedQuery = query.normalize("NFKC").trim();
-        const escapedQuery = normalizedQuery.replace(/[\\%_]/gu, "\\$&");
+        const escapedQuery = escapeSqlLikePattern(normalizedQuery);
         const pattern = `%${escapedQuery}%`;
         const rows = normalizedQuery
             ? this.db.all(`SELECT draft.*, volume.title AS volume_title FROM drafts draft
@@ -3215,7 +3715,7 @@ export class Store {
             this.audit(String(current.workId), "character.versioned", "character", characterId, { versionNo, source, sourceRef });
         }
     }
-    createCharacter(workId, input) {
+    createCharacter(workId, input, source = "create", sourceRef = null, changeNote = "建立人物档案") {
         this.getWork(workId);
         const characterId = id("character");
         const timestamp = now();
@@ -3236,8 +3736,8 @@ export class Store {
          VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, characterId, workId, names.name, input.code?.trim() ?? "", JSON.stringify(names.aliases), species, raceId, JSON.stringify(input.attributes ?? {}), JSON.stringify(input.profile ?? {}), JSON.stringify(input.currentState ?? {}), input.isDead ? 1 : 0, JSON.stringify(input.lockedFields ?? []), input.firstChapterId ?? null, timestamp, timestamp);
             this.insertCharacterNames(workId, characterId, names.entries);
             this.replaceCharacterOrganizations(characterId, organizationIds);
-            this.insertCharacterVersion(characterId, 1, "create", null, "建立人物档案", timestamp);
-            this.audit(workId, "character.created", "character", characterId);
+            this.insertCharacterVersion(characterId, 1, source, sourceRef, changeNote, timestamp);
+            this.audit(workId, "character.created", "character", characterId, { source, sourceRef });
         });
         return this.getCharacter(characterId);
     }
@@ -4812,10 +5312,24 @@ export class Store {
         if (!conversation)
             throw notFound("AI 对话");
         const requestId = input.requestId?.trim() || null;
+        const persistInterruption = (message) => {
+            if (input.role !== "assistant" || input.metadata?.interrupted !== true || requiredString(message, "role") !== "assistant") {
+                return message;
+            }
+            const currentMetadata = json(requiredString(message, "metadata_json"), {});
+            const nextMetadata = { ...currentMetadata, ...input.metadata, interrupted: true };
+            if (JSON.stringify(currentMetadata) === JSON.stringify(nextMetadata))
+                return message;
+            this.db.transaction(() => {
+                this.db.run("UPDATE ai_conversation_messages SET metadata_json = ? WHERE id = ?", JSON.stringify(nextMetadata), requiredString(message, "id"));
+                this.db.run("UPDATE ai_conversations SET updated_at = ? WHERE id = ?", now(), conversationId);
+            });
+            return this.db.get("SELECT * FROM ai_conversation_messages WHERE id = ?", requiredString(message, "id")) ?? message;
+        };
         if (requestId) {
             const existing = this.db.get("SELECT * FROM ai_conversation_messages WHERE conversation_id = ? AND request_id = ?", conversationId, requestId);
             if (existing)
-                return this.mapAiConversationMessage(existing);
+                return this.mapAiConversationMessage(persistInterruption(existing));
         }
         const messageId = id("message");
         const timestamp = now();
@@ -4838,18 +5352,156 @@ export class Store {
             : this.db.get("SELECT * FROM ai_conversation_messages WHERE id = ?", messageId);
         if (!message)
             throw notFound("AI 对话消息");
-        return this.mapAiConversationMessage(message);
+        return this.mapAiConversationMessage(persistInterruption(message));
     }
-    forkAiConversation(conversationId, messageId, requestedTitle) {
+    beginAiConversationStreamRequest(input, referenceTime = new Date()) {
+        const timestamp = referenceTime.toISOString();
+        const leaseExpiresAt = new Date(referenceTime.getTime() + AI_CONVERSATION_STREAM_REQUEST_LEASE_MS).toISOString();
+        return this.db.transaction(() => {
+            const conversation = this.db.get("SELECT * FROM ai_conversations WHERE id = ?", input.conversationId);
+            if (!conversation)
+                throw notFound("AI 对话");
+            if (requiredString(conversation, "work_id") !== input.workId) {
+                throw new AppError(400, "CONVERSATION_WORK_MISMATCH", "AI 对话不属于当前作品");
+            }
+            let existing = this.db.get(`SELECT * FROM ai_conversation_stream_requests
+         WHERE actor_scope = ? AND work_id = ? AND idempotency_key = ?`, input.actorScope, input.workId, input.idempotencyKey);
+            if (existing) {
+                if (requiredString(existing, "status") === "in_progress"
+                    && String(existing.lease_expires_at ?? "") <= timestamp) {
+                    this.expireAiConversationStreamLease(input.conversationId, timestamp);
+                    existing = this.db.get("SELECT * FROM ai_conversation_stream_requests WHERE id = ?", requiredString(existing, "id"));
+                    if (!existing)
+                        throw notFound("AI 对话请求");
+                }
+                if (requiredString(existing, "conversation_id") !== input.conversationId
+                    || requiredString(existing, "request_hash") !== input.requestHash) {
+                    throw new AppError(409, "IDEMPOTENCY_KEY_REUSED", "该请求标识已用于另一项 AI 对话请求");
+                }
+                const request = this.mapAiConversationStreamRequest(existing);
+                return {
+                    disposition: request.status === "in_progress" ? "in_progress" : "terminal",
+                    request,
+                    userMessage: this.aiConversationMessageOrNull(request.userMessageId),
+                    assistantMessage: this.aiConversationMessageOrNull(request.assistantMessageId)
+                };
+            }
+            this.expireAiConversationStreamLease(input.conversationId, timestamp);
+            const active = this.db.get("SELECT id FROM ai_conversation_stream_requests WHERE conversation_id = ? AND status = 'in_progress'", input.conversationId);
+            if (active) {
+                throw new AppError(409, "AI_CONVERSATION_RESPONSE_IN_PROGRESS", "当前对话仍在生成回复，请等待完成或取消后再发送");
+            }
+            const requestId = id("chat_request");
+            const existingMessage = input.userMessage.existingMessageId
+                ? this.db.get(`SELECT * FROM ai_conversation_messages
+           WHERE id = ? AND conversation_id = ? AND role = 'user'`, input.userMessage.existingMessageId, input.conversationId)
+                : undefined;
+            if (input.userMessage.existingMessageId && !existingMessage) {
+                throw new AppError(400, "AI_STREAM_USER_MESSAGE_MISMATCH", "当前用户消息不属于目标 AI 对话");
+            }
+            const messageId = existingMessage ? requiredString(existingMessage, "id") : id("message");
+            const previousTitle = requiredString(conversation, "title");
+            const title = !existingMessage && previousTitle === "新对话"
+                ? defaultAiConversationTitle(input.userMessage.content)
+                : previousTitle;
+            this.db.run(`INSERT INTO ai_conversation_stream_requests
+           (id, work_id, conversation_id, actor_scope, idempotency_key, request_hash, status,
+            lease_expires_at, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, 'in_progress', ?, ?, ?)`, requestId, input.workId, input.conversationId, input.actorScope, input.idempotencyKey, input.requestHash, leaseExpiresAt, timestamp, timestamp);
+            if (!existingMessage) {
+                this.db.run(`INSERT INTO ai_conversation_messages
+             (id, conversation_id, role, content, citations_json, metadata_json, request_id, created_at, created_by_user_id)
+           VALUES (?, ?, 'user', ?, ?, ?, ?, ?, ?)`, messageId, input.conversationId, input.userMessage.content, JSON.stringify(input.userMessage.citations ?? []), JSON.stringify(input.userMessage.metadata ?? {}), `stream:${requestId}:user`, timestamp, currentRequestActor()?.userId ?? null);
+            }
+            this.db.run("UPDATE ai_conversation_stream_requests SET user_message_id = ? WHERE id = ?", messageId, requestId);
+            if (!existingMessage) {
+                this.db.run("UPDATE ai_conversations SET title = ?, updated_at = ? WHERE id = ?", title, timestamp, input.conversationId);
+                if (title !== previousTitle)
+                    this.syncAiHistorySearchShortTermsForSource("conversation", input.conversationId);
+                this.syncAiHistorySearchShortTermsForSource("message", messageId);
+            }
+            const created = this.db.get("SELECT * FROM ai_conversation_stream_requests WHERE id = ?", requestId);
+            if (!created)
+                throw notFound("AI 对话请求");
+            return {
+                disposition: "started",
+                request: this.mapAiConversationStreamRequest(created),
+                userMessage: this.aiConversationMessageOrNull(messageId),
+                assistantMessage: null
+            };
+        });
+    }
+    findAiConversationStreamRequest(actorScope, workId, idempotencyKey) {
+        const request = this.db.get(`SELECT * FROM ai_conversation_stream_requests
+       WHERE actor_scope = ? AND work_id = ? AND idempotency_key = ?`, actorScope, workId, idempotencyKey);
+        return request ? this.mapAiConversationStreamRequest(request) : null;
+    }
+    assertAiConversationStreamAvailable(conversationId, referenceTime = new Date()) {
+        const timestamp = referenceTime.toISOString();
+        this.db.transaction(() => {
+            this.expireAiConversationStreamLease(conversationId, timestamp);
+            const active = this.db.get("SELECT id FROM ai_conversation_stream_requests WHERE conversation_id = ? AND status = 'in_progress'", conversationId);
+            if (active) {
+                throw new AppError(409, "AI_CONVERSATION_RESPONSE_IN_PROGRESS", "当前对话仍在生成回复，请等待完成或取消后再发送");
+            }
+        });
+    }
+    touchAiConversationStreamRequest(requestId, referenceTime = new Date()) {
+        const timestamp = referenceTime.toISOString();
+        const leaseExpiresAt = new Date(referenceTime.getTime() + AI_CONVERSATION_STREAM_REQUEST_LEASE_MS).toISOString();
+        return this.db.run(`UPDATE ai_conversation_stream_requests SET lease_expires_at = ?, updated_at = ?
+       WHERE id = ? AND status = 'in_progress'`, leaseExpiresAt, timestamp, requestId).changes === 1;
+    }
+    cancelActiveAiConversationStreamRequests(referenceTime = new Date()) {
+        const timestamp = referenceTime.toISOString();
+        return this.db.run(`UPDATE ai_conversation_stream_requests
+       SET status = 'cancelled', terminal_reason = 'runtime_shutdown', lease_expires_at = NULL,
+           updated_at = ?, completed_at = ?
+       WHERE status = 'in_progress'`, timestamp, timestamp).changes;
+    }
+    finishAiConversationStreamRequest(requestId, status, terminalReason, assistantMessageId, referenceTime = new Date()) {
+        const timestamp = referenceTime.toISOString();
+        return this.db.transaction(() => {
+            const request = this.db.get("SELECT * FROM ai_conversation_stream_requests WHERE id = ?", requestId);
+            if (!request)
+                throw notFound("AI 对话请求");
+            if (assistantMessageId) {
+                const assistant = this.db.get(`SELECT id FROM ai_conversation_messages
+           WHERE id = ? AND conversation_id = ? AND role = 'assistant'`, assistantMessageId, requiredString(request, "conversation_id"));
+                if (!assistant)
+                    throw new AppError(400, "AI_STREAM_ASSISTANT_MISMATCH", "AI 回复消息不属于当前对话请求");
+            }
+            this.db.run(`UPDATE ai_conversation_stream_requests
+         SET status = ?, terminal_reason = ?, assistant_message_id = COALESCE(assistant_message_id, ?),
+             lease_expires_at = NULL, updated_at = ?, completed_at = ?
+         WHERE id = ? AND status = 'in_progress'`, status, terminalReason.slice(0, 500), assistantMessageId ?? null, timestamp, timestamp, requestId);
+            const completed = this.db.get("SELECT * FROM ai_conversation_stream_requests WHERE id = ?", requestId);
+            if (!completed)
+                throw notFound("AI 对话请求");
+            return this.mapAiConversationStreamRequest(completed);
+        });
+    }
+    forkAiConversation(conversationId, messageId, requestedTitle, requestId) {
         const conversation = this.db.get("SELECT * FROM ai_conversations WHERE id = ?", conversationId);
         if (!conversation)
             throw notFound("AI 对话");
+        const normalizedRequestId = requestId?.trim() || null;
+        if (normalizedRequestId) {
+            const existingFork = this.db.get("SELECT source_message_id, conversation_id FROM ai_conversation_forks WHERE source_conversation_id = ? AND request_id = ?", conversationId, normalizedRequestId);
+            if (existingFork) {
+                if (requiredString(existingFork, "source_message_id") !== messageId) {
+                    throw new AppError(409, "IDEMPOTENCY_KEY_REUSED", "该续写请求标识已用于另一条历史消息");
+                }
+                return this.getAiConversation(requiredString(existingFork, "conversation_id"));
+            }
+        }
         const messages = this.db.all("SELECT * FROM ai_conversation_messages WHERE conversation_id = ? ORDER BY created_at, rowid", conversationId);
         const targetIndex = messages.findIndex((message) => requiredString(message, "id") === messageId);
         if (targetIndex < 0)
             throw notFound("AI 对话消息");
         const forkId = id("conversation");
         const timestamp = now();
+        const workId = requiredString(conversation, "work_id");
         const sourceTitle = requiredString(conversation, "title");
         const title = requestedTitle?.trim() || `${sourceTitle} · 分支`;
         const sourceCompactedCount = Math.max(0, numberValue(conversation, "compacted_message_count"));
@@ -4859,13 +5511,21 @@ export class Store {
             ?? JSON.stringify(EMPTY_AI_INJECTED_ENTITIES);
         const systemClockText = optionalString(conversation, "system_clock_text") ?? "";
         this.db.transaction(() => {
-            this.db.run("INSERT INTO ai_conversations (id, work_id, roleplay_character_id, task_type, context_scope_json, title, compacted_summary, compacted_message_count, agent_tools_json, injected_entities_json, system_clock_text, created_at, updated_at, created_by_user_id) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)", forkId, requiredString(conversation, "work_id"), optionalString(conversation, "roleplay_character_id"), optionalString(conversation, "task_type"), optionalString(conversation, "context_scope_json"), title.slice(0, 200), forkSummary, forkCompactedCount, conversation.agent_tools_json == null
-                ? JSON.stringify(normalizeWorkAgentTools(this.getWorkAiSettings(requiredString(conversation, "work_id")).agentTools))
+            this.db.run("INSERT INTO ai_conversations (id, work_id, roleplay_character_id, task_type, context_scope_json, title, compacted_summary, compacted_message_count, agent_tools_json, injected_entities_json, system_clock_text, created_at, updated_at, created_by_user_id) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)", forkId, workId, optionalString(conversation, "roleplay_character_id"), optionalString(conversation, "task_type"), optionalString(conversation, "context_scope_json"), title.slice(0, 200), forkSummary, forkCompactedCount, conversation.agent_tools_json == null
+                ? JSON.stringify(normalizeWorkAgentTools(this.getWorkAiSettings(workId).agentTools))
                 : String(conversation.agent_tools_json), injectedEntitiesJson, systemClockText, timestamp, timestamp, currentRequestActor()?.userId ?? null);
             for (const message of messages.slice(0, targetIndex + 1)) {
                 this.db.run("INSERT INTO ai_conversation_messages (id, conversation_id, role, content, citations_json, metadata_json, request_id, created_at, created_by_user_id) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)", id("message"), forkId, requiredString(message, "role"), requiredString(message, "content"), requiredString(message, "citations_json"), requiredString(message, "metadata_json"), optionalString(message, "request_id"), requiredString(message, "created_at"), currentRequestActor()?.userId ?? null);
             }
+            if (normalizedRequestId) {
+                this.db.run("INSERT INTO ai_conversation_forks (source_conversation_id, source_message_id, request_id, conversation_id, created_at) VALUES (?, ?, ?, ?, ?)", conversationId, messageId, normalizedRequestId, forkId, timestamp);
+            }
             this.syncAiHistorySearchShortTermsForConversation(forkId);
+            this.audit(workId, "ai-conversation.forked", "ai-conversation", forkId, {
+                sourceConversationId: conversationId,
+                sourceMessageId: messageId,
+                messageCount: targetIndex + 1
+            });
         });
         return this.getAiConversation(forkId);
     }
@@ -4920,6 +5580,45 @@ export class Store {
             updatedAt: requiredString(row, "updated_at")
         };
     }
+    aiConversationMessageOrNull(messageId) {
+        if (!messageId)
+            return null;
+        const message = this.db.get("SELECT * FROM ai_conversation_messages WHERE id = ?", messageId);
+        return message ? this.mapAiConversationMessage(message) : null;
+    }
+    expireAiConversationStreamLease(conversationId, timestamp) {
+        const expired = this.db.get(`SELECT * FROM ai_conversation_stream_requests
+       WHERE conversation_id = ? AND status = 'in_progress' AND lease_expires_at <= ?`, conversationId, timestamp);
+        if (!expired)
+            return;
+        const userMessageId = optionalString(expired, "user_message_id");
+        const assistant = userMessageId
+            ? this.db.get(`SELECT id FROM ai_conversation_messages
+         WHERE conversation_id = ? AND role = 'assistant' AND request_id = ?`, conversationId, `assistant:${userMessageId}`)
+            : undefined;
+        this.db.run(`UPDATE ai_conversation_stream_requests
+       SET status = ?, terminal_reason = ?, assistant_message_id = ?, lease_expires_at = NULL,
+           updated_at = ?, completed_at = ?
+       WHERE id = ? AND status = 'in_progress'`, assistant ? "completed" : "abandoned", assistant ? "recovered_completed_response" : "lease_expired", assistant ? requiredString(assistant, "id") : null, timestamp, timestamp, requiredString(expired, "id"));
+    }
+    mapAiConversationStreamRequest(row) {
+        return {
+            id: requiredString(row, "id"),
+            workId: requiredString(row, "work_id"),
+            conversationId: requiredString(row, "conversation_id"),
+            actorScope: requiredString(row, "actor_scope"),
+            idempotencyKey: requiredString(row, "idempotency_key"),
+            requestHash: requiredString(row, "request_hash"),
+            status: requiredString(row, "status"),
+            terminalReason: optionalString(row, "terminal_reason"),
+            userMessageId: optionalString(row, "user_message_id"),
+            assistantMessageId: optionalString(row, "assistant_message_id"),
+            leaseExpiresAt: optionalString(row, "lease_expires_at"),
+            createdAt: requiredString(row, "created_at"),
+            updatedAt: requiredString(row, "updated_at"),
+            completedAt: optionalString(row, "completed_at")
+        };
+    }
     /** 锁定本对话可用工具集；已锁定则保持不变，避免中途改作品设置破坏 prompt cache。 */
     ensureAiConversationAgentTools(conversationId, workId) {
         const conversation = this.db.get("SELECT id, work_id, agent_tools_json FROM ai_conversations WHERE id = ?", conversationId);
@@ -5203,7 +5902,7 @@ export class Store {
     }
     updateTask(taskId, input) {
         const current = this.getTask(taskId);
-        const terminal = ["completed", "partial", "review", "expired", "cancelled"];
+        const terminal = ["completed", "partial", "failed", "review", "expired", "cancelled"];
         if (terminal.includes(String(current.status)) && input.status !== current.status) {
             throw new AppError(409, "INVALID_TASK_TRANSITION", "终态任务不能再变更状态");
         }
@@ -5571,6 +6270,7 @@ export class Store {
         let metrics = [];
         let sections = [];
         let relationshipChangePreviewSummary = null;
+        let characterExtractionPreviewSummary = null;
         if (taskType === "chapter-analysis") {
             let chapterTitle = String(result.chapterId ?? "指定章节");
             if (typeof result.chapterId === "string") {
@@ -5710,6 +6410,11 @@ export class Store {
             ];
         }
         else if (taskType === "character-extraction" || taskType === "character-summary") {
+            const extractedCandidates = this.taskResultObjects(result.characterCandidates);
+            const application = result.characterApplication && typeof result.characterApplication === "object"
+                && !Array.isArray(result.characterApplication)
+                ? result.characterApplication
+                : null;
             const ids = idList(result.characterIds);
             const characters = ids.flatMap((characterId) => {
                 try {
@@ -5732,13 +6437,71 @@ export class Store {
                     return [];
                 }
             });
-            summary = `识别 ${Number(result.candidateCount ?? characters.length)} 个角色候选，保存 ${characters.length} 个角色档案。`;
             const verification = result.verification && typeof result.verification === "object" && !Array.isArray(result.verification)
                 ? result.verification
                 : {};
-            metrics = [metric("保存角色", characters.length), metric("跳过", Array.isArray(result.skipped) ? result.skipped.length : 0), metric("覆盖章节", result.coveredChapterCount), metric("身份复核", verification.pairCount)];
-            storageTargets.unshift({ label: "角色档案", entity: "角色库", key: "characters", count: characters.length, note: "新角色会创建档案，命中已有角色时会合并可靠信息。" });
-            sections = [section("保存的角色", characters, "没有形成可保存的角色档案。"), section("未写入候选", result.skipped, "没有候选被跳过。")];
+            if (extractedCandidates.length > 0 || application) {
+                const applicationStatus = application?.status === "applied" ? "applied" : "pending";
+                const candidateItems = extractedCandidates.map((candidate) => ({
+                    name: String(candidate.name ?? "未命名角色"),
+                    aliases: Array.isArray(candidate.aliases) ? candidate.aliases.map(String) : [],
+                    identity: String(candidate.identity ?? ""),
+                    species: String(candidate.species ?? ""),
+                    evidence: candidate.firstEvidence ? [candidate.firstEvidence] : []
+                }));
+                const appliedItems = this.taskResultObjects(application?.items).map((item) => ({
+                    title: String(item.characterName ?? item.candidateId ?? "角色候选"),
+                    subtitle: item.status === "created" ? "已新建档案"
+                        : item.status === "merged" ? "已合并可靠信息"
+                            : item.status === "unchanged" ? "已有档案保持不变"
+                                : "已跳过",
+                    description: Array.isArray(item.conflicts) ? item.conflicts.map(String).join("；") : ""
+                }));
+                const totalCount = Number(application?.totalCount ?? result.candidateCount ?? extractedCandidates.length);
+                const createdCount = Number(application?.createdCount ?? 0);
+                const mergedCount = Number(application?.mergedCount ?? 0);
+                const unchangedCount = Number(application?.unchangedCount ?? 0);
+                const skippedCount = Number(application?.skippedCount ?? 0);
+                characterExtractionPreviewSummary = {
+                    status: applicationStatus,
+                    totalCount,
+                    createdCount,
+                    mergedCount,
+                    unchangedCount,
+                    skippedCount,
+                    ...(typeof application?.generatedAt === "string" ? { generatedAt: application.generatedAt } : {}),
+                    ...(typeof application?.appliedAt === "string" ? { appliedAt: application.appliedAt } : {})
+                };
+                summary = applicationStatus === "applied"
+                    ? `已处理 ${totalCount} 个角色候选：新建 ${createdCount} 个、合并 ${mergedCount} 个、保持不变 ${unchangedCount} 个、跳过 ${skippedCount} 个。`
+                    : `识别 ${totalCount} 个角色候选，角色库尚未修改；请预览、勾选并确认新建或合并策略。`;
+                metrics = [
+                    metric(applicationStatus === "applied" ? "新建角色" : "待确认", applicationStatus === "applied" ? createdCount : totalCount),
+                    metric("合并", mergedCount),
+                    metric("跳过", applicationStatus === "applied" ? skippedCount : Array.isArray(result.skipped) ? result.skipped.length : 0),
+                    metric("身份复核", verification.pairCount)
+                ];
+                storageTargets.unshift({
+                    label: "角色档案",
+                    entity: "角色库",
+                    key: "characters",
+                    count: characters.length,
+                    note: applicationStatus === "applied"
+                        ? "仅写入用户确认的新建或合并项；冲突字段保留原档案。"
+                        : "当前仅保存结构化预览，角色库尚未修改。"
+                });
+                sections = [
+                    section(applicationStatus === "applied" ? "抽取的角色候选" : "待确认角色候选", candidateItems, "没有形成可应用的角色候选。"),
+                    ...(applicationStatus === "applied" ? [section("应用结果", appliedItems, "没有角色候选被应用。")] : []),
+                    section("抽取阶段跳过的候选", result.skipped, "抽取阶段没有候选被跳过。")
+                ];
+            }
+            else {
+                summary = `识别 ${Number(result.candidateCount ?? characters.length)} 个角色候选，保存 ${characters.length} 个角色档案。`;
+                metrics = [metric("保存角色", characters.length), metric("跳过", Array.isArray(result.skipped) ? result.skipped.length : 0), metric("覆盖章节", result.coveredChapterCount), metric("身份复核", verification.pairCount)];
+                storageTargets.unshift({ label: "角色档案", entity: "角色库", key: "characters", count: characters.length, note: "该历史任务在生成结果时直接写入角色档案。" });
+                sections = [section("保存的角色", characters, "没有形成可保存的角色档案。"), section("未写入候选", result.skipped, "没有候选被跳过。")];
+            }
         }
         else if (taskType === "book-analysis") {
             const timelineIds = [...new Set([...idList(result.eventIds), ...idList(result.timelineEventIds)])];
@@ -5970,7 +6733,8 @@ export class Store {
             metrics,
             storageTargets: productStorageTargets(storageTargets),
             sections,
-            ...(relationshipChangePreviewSummary ? { relationshipChangePreview: relationshipChangePreviewSummary } : {})
+            ...(relationshipChangePreviewSummary ? { relationshipChangePreview: relationshipChangePreviewSummary } : {}),
+            ...(characterExtractionPreviewSummary ? { characterExtractionPreview: characterExtractionPreviewSummary } : {})
         };
     }
     taskResultForClient(result) {
@@ -6296,9 +7060,11 @@ export class Store {
     }
     search(workId, query) {
         this.getWork(workId);
-        const pattern = `%${query.replaceAll("%", "\\%").replaceAll("_", "\\_")}%`;
+        const normalizedQuery = normalizeWorkSearchQuery(query);
+        if (!normalizedQuery)
+            return [];
+        const pattern = `%${escapeSqlLikePattern(normalizedQuery)}%`;
         const chapters = this.db.all("SELECT id, title, content, volume_id FROM chapters WHERE work_id = ? AND deleted_at IS NULL AND (title LIKE ? ESCAPE '\\' OR content LIKE ? ESCAPE '\\') LIMIT 50", workId, pattern, pattern);
-        const normalizedQuery = query.toLocaleLowerCase("zh-CN");
         const races = this.listRaces(workId).filter((race) => {
             const lineage = race.lineage;
             const effectiveSettings = race.effectiveSettings;
@@ -6329,9 +7095,9 @@ export class Store {
          OR EXISTS (SELECT 1 FROM character_race_lineage lineage WHERE lineage.character_id = character.id AND lineage.name LIKE ? ESCAPE '\\')
        ) LIMIT 50`, workId, workId, pattern, pattern, pattern, pattern);
         const organizations = this.db.all("SELECT id, name, description, is_dissolved, settings_json FROM organizations WHERE work_id = ? AND (name LIKE ? ESCAPE '\\' OR description LIKE ? ESCAPE '\\' OR settings_json LIKE ? ESCAPE '\\') LIMIT 50", workId, pattern, pattern, pattern);
-        const characterSections = this.searchCharacterProfileSections(workId, query, 30);
+        const characterSections = this.searchCharacterProfileSections(workId, normalizedQuery, 30);
         const snippet = (content) => {
-            const index = content.toLocaleLowerCase().indexOf(query.toLocaleLowerCase());
+            const index = content.toLocaleLowerCase().indexOf(normalizedQuery);
             const start = Math.max(0, index - 40);
             return content.slice(start, start + 120);
         };
@@ -6418,6 +7184,35 @@ export class Store {
             cover: cover ? { mimeType: cover.mimeType, content: cover.content } : null
         });
     }
+    async exportEpub(workId, volumeId) {
+        const tree = this.getWorkTree(workId);
+        const allVolumes = tree.volumes;
+        const selectedVolume = volumeId ? allVolumes.find((volume) => String(volume.id) === volumeId) : undefined;
+        if (volumeId && !selectedVolume)
+            throw notFound("分卷");
+        const sourceVolumes = selectedVolume ? [selectedVolume] : allVolumes;
+        const title = selectedVolume ? `${String(tree.title)} - ${String(selectedVolume.title)}` : String(tree.title);
+        const cover = this.findWorkCover(workId);
+        const archive = await createEpubArchive({
+            title,
+            author: String(tree.author ?? ""),
+            description: String(tree.description ?? ""),
+            language: String(tree.language ?? "zh-CN"),
+            volumes: sourceVolumes.map((volume) => ({
+                title: String(volume.title),
+                chapters: volume.chapters.map((chapter) => ({
+                    title: String(chapter.title),
+                    content: String(chapter.content ?? "")
+                }))
+            })),
+            cover: cover ? { mimeType: cover.mimeType, content: cover.content } : null
+        });
+        return { title, archive };
+    }
+    async exportVolumeEpub(volumeId) {
+        const volume = this.getVolume(volumeId);
+        return this.exportEpub(String(volume.workId), volumeId);
+    }
     listAuditLogs(workId) {
         this.getWork(workId);
         return this.db.all(`SELECT log.*, user.display_name AS actor_display_name, user.username AS actor_username