@musnows/scriverse 0.5.4 → 0.5.6

package/dist/store.js

@@ -7,7 +7,14 @@ import { currentRequestActor } from "./request-context.js";
 import { classifyWorkModulePermissions, emptyWorkModulePermissions, fullWorkModulePermissions, storedWorkModulePermissions } from "./work-permissions.js";
 import { countWords, documentShortSearchTerms, id, json, normalizeDocumentSearchText, normalizeParagraphSpacing, now, splitDocumentParagraphs } from "./utils.js";
 const defaultPlatformPageSizes = {
+    settings: 30,
     characters: 30,
+    races: 30,
+    organizations: 30,
+    timeline: 30,
+    outlines: 30,
+    relationships: 30,
+    reviews: 30,
     analysisTasks: 30,
     fileVersions: 30
 };
@@ -22,7 +29,14 @@ function platformPageSizes(value) {
             : defaultPlatformPageSizes[key];
     };
     return {
+        settings: pageSize("settings"),
         characters: pageSize("characters"),
+        races: pageSize("races"),
+        organizations: pageSize("organizations"),
+        timeline: pageSize("timeline"),
+        outlines: pageSize("outlines"),
+        relationships: pageSize("relationships"),
+        reviews: pageSize("reviews"),
         analysisTasks: pageSize("analysisTasks"),
         fileVersions: pageSize("fileVersions")
     };
@@ -534,6 +548,14 @@ export class Store {
             entityId: entityType === "user" && entityId ? accountReference(entityId) : entityId,
             detailKeys
         });
+        if (workId) {
+            try {
+                this.relationshipIndexQueuedHandler?.(workId);
+            }
+            catch {
+                // 索引调度失败不影响主写入路径
+            }
+        }
     }
     createWork(input) {
         const workId = id("work");
@@ -614,9 +636,13 @@ export class Store {
         return this.getPlatformUiSettings();
     }
     analysisTaskQueuedHandler = null;
+    relationshipIndexQueuedHandler = null;
     setAnalysisTaskQueuedHandler(handler) {
         this.analysisTaskQueuedHandler = handler;
     }
+    setRelationshipIndexQueuedHandler(handler) {
+        this.relationshipIndexQueuedHandler = handler;
+    }
     notifyAnalysisTaskQueued(workId) {
         try {
             this.analysisTaskQueuedHandler?.(workId);
@@ -744,7 +770,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 chapterRows = this.db.all("SELECT * FROM chapters WHERE work_id = ? 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) {
             const chapter = this.mapChapter(row);
@@ -767,7 +793,7 @@ export class Store {
         const volumeRows = this.db.all("SELECT * FROM volumes WHERE work_id = ? 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 = ? ORDER BY sort_order, created_at`, workId);
+       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) {
             const chapter = this.mapChapterDirectoryEntry(row);
@@ -791,7 +817,7 @@ export class Store {
         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
-       FROM chapters WHERE work_id = ? ORDER BY sort_order, created_at${page.sql}`, workId, ...page.params);
+       FROM chapters WHERE work_id = ? AND deleted_at IS NULL ORDER BY sort_order, created_at${page.sql}`, workId, ...page.params);
         const pageResult = paginated(chapterRows.map((row) => this.mapChapterDirectoryEntry(row)), pagination);
         const chaptersByVolume = new Map();
         for (const chapter of pageResult.items) {
@@ -854,7 +880,7 @@ export class Store {
             const current = this.getWork(workId);
             this.assertExpectedVersion("work", workId, expectedVersionNo, "作品", Number(current.versionNo));
             const currentTree = this.getWorkTree(workId);
-            const currentChapters = this.db.all("SELECT content FROM chapters WHERE work_id = ?", workId);
+            const currentChapters = this.db.all("SELECT content FROM chapters WHERE work_id = ? AND deleted_at IS NULL", workId);
             const wordCount = currentChapters.reduce((sum, row) => sum + countWords(requiredString(row, "content")), 0);
             const paragraphCount = currentChapters.reduce((sum, row) => {
                 const content = requiredString(row, "content").trim();
@@ -990,14 +1016,19 @@ export class Store {
         return this.getVolume(volumeId);
     }
     deleteVolume(volumeId, expectedVersionNo) {
-        const volume = this.getVolume(volumeId);
-        const count = this.db.get("SELECT COUNT(*) AS value FROM chapters WHERE volume_id = ?", volumeId);
-        if (numberValue(count ?? {}, "value") > 0) {
-            throw new AppError(409, "VOLUME_NOT_EMPTY", "卷内仍有章节，需先移动或删除章节");
-        }
         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", "卷内仍有章节，需先移动或删除章节");
+            }
+            if (numberValue(counts ?? {}, "deleted_count") > 0) {
+                throw new AppError(409, "VOLUME_HAS_DELETED_CHAPTERS", "分卷回收站中仍有章节，请先恢复并移动这些章节后再删除分卷");
+            }
             this.recordEntityVersion("volume", volumeId, "delete", null, "删除分卷");
             this.db.run("DELETE FROM volumes WHERE id = ?", volumeId);
             this.audit(String(current.workId), "volume.deleted", "volume", volumeId, { versionNo: Number(current.versionNo) });
@@ -1008,17 +1039,52 @@ export class Store {
         const volume = this.getVolume(input.volumeId);
         if (volume.workId !== workId)
             throw new AppError(400, "VOLUME_WORK_MISMATCH", "卷不属于当前作品");
-        const last = this.db.get("SELECT COALESCE(MAX(sort_order), -1) AS value FROM chapters WHERE volume_id = ?", input.volumeId);
+        const last = this.db.get("SELECT COALESCE(MAX(sort_order), -1) AS value FROM chapters WHERE volume_id = ? AND deleted_at IS NULL", input.volumeId);
         const chapterId = this.insertChapter(workId, input.volumeId, input.title, input.content ?? "", numberValue(last ?? {}, "value") + 1, "manual", null, input.chapterType ?? "正文");
         this.audit(workId, "chapter.created", "chapter", chapterId);
         return this.getChapter(chapterId);
     }
     getChapter(chapterId) {
-        const row = this.db.get("SELECT * FROM chapters WHERE id = ?", chapterId);
+        const row = this.db.get("SELECT * FROM chapters WHERE id = ? AND deleted_at IS NULL", chapterId);
         if (!row)
             throw notFound("章节");
         return this.mapChapter(row);
     }
+    listDeletedChapters(workId) {
+        this.getWork(workId);
+        return this.findDeletedChapterRows(workId).map((row) => this.mapDeletedChapter(row));
+    }
+    listDeletedChaptersPage(workId, pagination) {
+        this.getWork(workId);
+        const page = paginationSql(pagination);
+        const rows = this.findDeletedChapterRows(workId, page.sql, page.params);
+        return paginated(rows.map((row) => this.mapDeletedChapter(row)), pagination);
+    }
+    findDeletedChapterRows(workId, pageSql = "", pageParams = []) {
+        return this.db.all(`SELECT chapter.*, volume.title AS volume_title,
+        user.display_name AS actor_display_name, user.username AS actor_username
+       FROM chapters chapter
+       JOIN volumes volume ON volume.id = chapter.volume_id
+       LEFT JOIN chapter_versions version
+         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
+       ORDER BY chapter.deleted_at DESC, chapter.id DESC${pageSql}`, workId, ...pageParams);
+    }
+    mapDeletedChapter(row) {
+        return {
+            id: requiredString(row, "id"),
+            workId: requiredString(row, "work_id"),
+            volumeId: requiredString(row, "volume_id"),
+            volumeTitle: requiredString(row, "volume_title"),
+            title: requiredString(row, "title"),
+            contentPreview: requiredString(row, "content").slice(0, 300),
+            wordCount: numberValue(row, "word_count"),
+            versionNo: numberValue(row, "version_no"),
+            deletedAt: requiredString(row, "deleted_at"),
+            actor: optionalString(row, "actor_display_name") ?? optionalString(row, "actor_username") ?? "历史数据"
+        };
+    }
     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
@@ -1110,7 +1176,7 @@ export class Store {
        FROM chapters chapter
        JOIN volumes volume ON volume.id = chapter.volume_id
        JOIN chapter_insights insight ON insight.chapter_id = chapter.id AND insight.chapter_version = chapter.version_no
-       WHERE chapter.work_id = ?
+       WHERE chapter.work_id = ? AND chapter.deleted_at IS NULL
          AND NOT EXISTS (
            SELECT 1 FROM chapter_insights newer
            WHERE newer.chapter_id = insight.chapter_id
@@ -1173,7 +1239,10 @@ export class Store {
         const version = this.db.get("SELECT * FROM chapter_versions WHERE chapter_id = ? AND version_no = ?", chapterId, versionNo);
         if (!version)
             throw notFound("章节版本");
-        const existing = this.db.get("SELECT id FROM chapters WHERE id = ?", chapterId);
+        const existing = this.db.get("SELECT id, deleted_at FROM chapters WHERE id = ?", chapterId);
+        if (existing?.deleted_at) {
+            return this.restoreSoftDeletedChapterFromVersion(chapterId, version, expectedVersionNo);
+        }
         if (!existing) {
             this.assertExpectedRevision("chapter", chapterId, expectedVersionNo, "章节", this.currentChapterVersionNo(chapterId));
             return this.recreateChapterFromVersion(chapterId, version);
@@ -1192,7 +1261,7 @@ export class Store {
         const content = requiredString(version, "content");
         const chapterType = (optionalString(version, "chapter_type") ?? "正文");
         const sortOrder = version.sort_order === null || version.sort_order === undefined
-            ? numberValue(this.db.get("SELECT COALESCE(MAX(sort_order), -1) AS sort_order FROM chapters WHERE volume_id = ?", volumeId) ?? {}, "sort_order") + 1
+            ? numberValue(this.db.get("SELECT COALESCE(MAX(sort_order), -1) AS sort_order FROM chapters WHERE volume_id = ? AND deleted_at IS NULL", volumeId) ?? {}, "sort_order") + 1
             : numberValue(version, "sort_order");
         const timestamp = now();
         const nextVersionNo = numberValue(this.db.get("SELECT COALESCE(MAX(version_no), 0) AS version_no FROM chapter_versions WHERE chapter_id = ?", chapterId) ?? {}, "version_no") + 1;
@@ -1219,6 +1288,58 @@ export class Store {
         });
         return this.getChapter(chapterId);
     }
+    restoreSoftDeletedChapterFromVersion(chapterId, version, expectedVersionNo) {
+        const deleted = this.db.get("SELECT * FROM chapters WHERE id = ? AND deleted_at IS NOT NULL", chapterId);
+        if (!deleted)
+            throw notFound("章节");
+        const currentVersionNo = numberValue(deleted, "version_no");
+        this.assertExpectedRevision("chapter", chapterId, expectedVersionNo, "章节", currentVersionNo);
+        const workId = requiredString(deleted, "work_id");
+        const volumeId = optionalString(version, "volume_id");
+        if (!volumeId)
+            throw new AppError(400, "CHAPTER_RESTORE_INCOMPLETE", "历史版本缺少分卷信息，无法恢复已删除章节");
+        const volume = this.getVolume(volumeId);
+        if (volume.workId !== workId)
+            throw new AppError(400, "VOLUME_WORK_MISMATCH", "卷不属于当前作品");
+        const title = requiredString(version, "title");
+        const content = requiredString(version, "content");
+        const chapterType = (optionalString(version, "chapter_type") ?? "正文");
+        const sortOrder = version.sort_order === null || version.sort_order === undefined
+            ? numberValue(this.db.get("SELECT COALESCE(MAX(sort_order), -1) AS sort_order FROM chapters WHERE volume_id = ? AND deleted_at IS NULL", volumeId) ?? {}, "sort_order") + 1
+            : numberValue(version, "sort_order");
+        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);
+            if (!locked?.deleted_at)
+                throw new AppError(409, "CHAPTER_ALREADY_RESTORED", "章节已经恢复");
+            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);
+            this.syncChapterParagraphSearch(workId, chapterId, content);
+            this.insertChapterVersionRow({
+                workId,
+                chapterId,
+                versionNo: nextVersionNo,
+                title,
+                content,
+                volumeId,
+                sortOrder,
+                chapterType,
+                source: "restore",
+                sourceRef: requiredString(version, "id"),
+                changeNote: `恢复至 v${numberValue(version, "version_no")}`,
+                timestamp
+            });
+            this.db.run("UPDATE works SET updated_at = ? WHERE id = ?", timestamp, workId);
+            this.invalidateChapter(workId, chapterId, nextVersionNo);
+            this.audit(workId, "chapter.restored", "chapter", chapterId, {
+                versionNo: nextVersionNo,
+                fromVersion: numberValue(version, "version_no")
+            });
+        });
+        return this.getChapter(chapterId);
+    }
     moveChapter(chapterId, input, expectedVersionNo) {
         const chapter = this.getChapter(chapterId);
         this.assertExpectedRevision("chapter", chapterId, expectedVersionNo, "章节", Number(chapter.versionNo));
@@ -1228,15 +1349,243 @@ export class Store {
         this.db.transaction(() => {
             const lockedChapter = this.getChapter(chapterId);
             this.assertExpectedRevision("chapter", chapterId, expectedVersionNo, "章节", Number(lockedChapter.versionNo));
+            const sourceVolumeId = String(lockedChapter.volumeId);
+            const targetVolumeId = input.volumeId;
+            const sourceChapterIds = this.db.all("SELECT id FROM chapters WHERE volume_id = ? AND deleted_at IS NULL ORDER BY sort_order, created_at, id", sourceVolumeId).map((row) => requiredString(row, "id")).filter((idValue) => idValue !== chapterId);
+            const targetChapterIds = sourceVolumeId === targetVolumeId
+                ? sourceChapterIds
+                : this.db.all("SELECT id FROM chapters WHERE volume_id = ? AND deleted_at IS NULL ORDER BY sort_order, created_at, id", targetVolumeId).map((row) => requiredString(row, "id")).filter((idValue) => idValue !== chapterId);
+            const targetIndex = Math.min(input.sortOrder, targetChapterIds.length);
+            targetChapterIds.splice(targetIndex, 0, chapterId);
+            const timestamp = now();
+            sourceChapterIds.forEach((idValue, sortOrder) => {
+                this.db.run("UPDATE chapters SET sort_order = ?, updated_at = ? WHERE id = ?", sortOrder, timestamp, idValue);
+            });
+            targetChapterIds.forEach((idValue, sortOrder) => {
+                this.db.run("UPDATE chapters SET volume_id = ?, sort_order = ?, updated_at = ? WHERE id = ?", targetVolumeId, sortOrder, timestamp, idValue);
+            });
+            const versionNo = Number(lockedChapter.versionNo) + 1;
             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') = 'volume' AND json_extract(scope_json, '$.volumeId') = ?`, now(), String(chapter.workId), String(chapter.volumeId));
-            this.db.run("UPDATE chapters SET volume_id = ?, sort_order = ?, analysis_status = 'expired', updated_at = ? WHERE id = ?", input.volumeId, input.sortOrder, now(), chapterId);
-            this.invalidateChapter(String(chapter.workId), chapterId, Number(chapter.versionNo));
-            this.audit(String(chapter.workId), "chapter.moved", "chapter", chapterId, input);
+         AND json_extract(scope_json, '$.type') = 'volume'
+         AND json_extract(scope_json, '$.volumeId') IN (?, ?)`, timestamp, String(lockedChapter.workId), sourceVolumeId, targetVolumeId);
+            this.db.run("UPDATE chapters SET version_no = ?, analysis_status = 'expired', updated_at = ? WHERE id = ?", versionNo, timestamp, chapterId);
+            this.insertChapterVersionRow({
+                workId: String(lockedChapter.workId),
+                chapterId,
+                versionNo,
+                title: String(lockedChapter.title),
+                content: String(lockedChapter.content),
+                volumeId: targetVolumeId,
+                sortOrder: targetIndex,
+                chapterType: String(lockedChapter.chapterType),
+                source: "manual",
+                sourceRef: null,
+                changeNote: sourceVolumeId === targetVolumeId ? "调整章节顺序" : "移动章节分卷",
+                timestamp
+            });
+            this.db.run("UPDATE works SET updated_at = ? WHERE id = ?", timestamp, String(lockedChapter.workId));
+            this.invalidateChapter(String(lockedChapter.workId), chapterId, versionNo);
+            this.audit(String(lockedChapter.workId), "chapter.moved", "chapter", chapterId, {
+                volumeId: targetVolumeId,
+                sortOrder: targetIndex,
+                fromVolumeId: sourceVolumeId,
+                versionNo
+            });
         });
         return this.getChapter(chapterId);
     }
+    mapChapterAnnotation(row) {
+        return {
+            id: requiredString(row, "id"),
+            workId: requiredString(row, "work_id"),
+            chapterId: requiredString(row, "chapter_id"),
+            kind: requiredString(row, "kind"),
+            startLine: numberValue(row, "start_line"),
+            endLine: numberValue(row, "end_line"),
+            quote: requiredString(row, "quote"),
+            note: requiredString(row, "note"),
+            status: requiredString(row, "status"),
+            versionNo: numberValue(row, "version_no"),
+            actor: optionalString(row, "actor_display_name") ?? optionalString(row, "actor_username") ?? "历史数据",
+            createdAt: requiredString(row, "created_at"),
+            updatedAt: requiredString(row, "updated_at")
+        };
+    }
+    chapterAnnotationSnapshot(annotation) {
+        return {
+            kind: annotation.kind,
+            startLine: annotation.startLine,
+            endLine: annotation.endLine,
+            quote: annotation.quote,
+            note: annotation.note,
+            status: annotation.status,
+            deletedAt: annotation.deletedAt ?? null
+        };
+    }
+    recordChapterAnnotationVersion(annotation, source, timestamp) {
+        this.db.run(`INSERT INTO chapter_annotation_versions (id, annotation_id, version_no, snapshot_json, source, created_at, created_by_user_id)
+       VALUES (?, ?, ?, ?, ?, ?, ?)`, id("chapterAnnotationVersion"), String(annotation.id), Number(annotation.versionNo), JSON.stringify(this.chapterAnnotationSnapshot(annotation)), source, timestamp, currentRequestActor()?.userId ?? null);
+    }
+    getChapterAnnotation(annotationId, includeDeleted = false) {
+        const row = this.db.get(`SELECT annotation.*, user.display_name AS actor_display_name, user.username AS actor_username
+       FROM chapter_annotations annotation LEFT JOIN users user ON user.id = annotation.updated_by_user_id
+       WHERE annotation.id = ?${includeDeleted ? "" : " AND annotation.deleted_at IS NULL"}`, annotationId);
+        if (!row)
+            throw notFound("章节批注");
+        return { ...this.mapChapterAnnotation(row), deletedAt: optionalString(row, "deleted_at") };
+    }
+    listChapterAnnotations(chapterId) {
+        this.getChapter(chapterId);
+        return this.db.all(`SELECT annotation.*, user.display_name AS actor_display_name, user.username AS actor_username
+       FROM chapter_annotations annotation LEFT JOIN users user ON user.id = annotation.updated_by_user_id
+       WHERE annotation.chapter_id = ? AND annotation.deleted_at IS NULL
+       ORDER BY CASE annotation.status WHEN 'open' THEN 0 ELSE 1 END, annotation.start_line, annotation.created_at`, chapterId).map((row) => this.mapChapterAnnotation(row));
+    }
+    createChapterAnnotation(chapterId, input) {
+        const chapter = this.getChapter(chapterId);
+        const lines = String(chapter.content).replace(/\r\n?/gu, "\n").split("\n");
+        if (input.startLine > lines.length || input.endLine > lines.length)
+            throw new AppError(400, "ANNOTATION_LINE_RANGE_INVALID", "批注行号超出当前正文范围");
+        if (input.endLine - input.startLine >= 20)
+            throw new AppError(400, "ANNOTATION_LINE_RANGE_TOO_LARGE", "一次最多批注 20 行正文");
+        const annotationId = id("chapterAnnotation");
+        const timestamp = now();
+        const actorId = currentRequestActor()?.userId ?? null;
+        this.db.transaction(() => {
+            this.db.run(`INSERT INTO chapter_annotations (id, work_id, chapter_id, kind, start_line, end_line, quote, note, status, version_no, created_at, updated_at, created_by_user_id, updated_by_user_id)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, 'open', 1, ?, ?, ?, ?)`, annotationId, String(chapter.workId), chapterId, input.kind, input.startLine, input.endLine, lines.slice(input.startLine - 1, input.endLine).join("\n"), input.note.trim(), timestamp, timestamp, actorId, actorId);
+            const annotation = this.getChapterAnnotation(annotationId);
+            this.recordChapterAnnotationVersion(annotation, "create", timestamp);
+            this.audit(String(chapter.workId), "chapter.annotation.created", "chapter-annotation", annotationId, { kind: input.kind, chapterId, startLine: input.startLine, endLine: input.endLine });
+        });
+        return this.getChapterAnnotation(annotationId);
+    }
+    updateChapterAnnotation(annotationId, input, expectedVersionNo) {
+        const current = this.getChapterAnnotation(annotationId);
+        this.assertExpectedRevision("chapter-annotation", annotationId, expectedVersionNo, "章节批注", Number(current.versionNo));
+        const timestamp = now();
+        this.db.transaction(() => {
+            const locked = this.getChapterAnnotation(annotationId);
+            this.assertExpectedRevision("chapter-annotation", annotationId, expectedVersionNo, "章节批注", Number(locked.versionNo));
+            this.db.run("UPDATE chapter_annotations SET note = ?, status = ?, version_no = version_no + 1, updated_at = ?, updated_by_user_id = ? WHERE id = ?", input.note?.trim() ?? String(locked.note), input.status ?? String(locked.status), timestamp, currentRequestActor()?.userId ?? null, annotationId);
+            const updated = this.getChapterAnnotation(annotationId);
+            this.recordChapterAnnotationVersion(updated, "update", timestamp);
+            this.audit(String(updated.workId), "chapter.annotation.updated", "chapter-annotation", annotationId, { status: updated.status, versionNo: updated.versionNo });
+        });
+        return this.getChapterAnnotation(annotationId);
+    }
+    deleteChapterAnnotation(annotationId, expectedVersionNo) {
+        const current = this.getChapterAnnotation(annotationId);
+        this.assertExpectedRevision("chapter-annotation", annotationId, expectedVersionNo, "章节批注", Number(current.versionNo));
+        const timestamp = now();
+        this.db.transaction(() => {
+            this.db.run("UPDATE chapter_annotations SET version_no = version_no + 1, deleted_at = ?, updated_at = ?, updated_by_user_id = ? WHERE id = ?", timestamp, timestamp, currentRequestActor()?.userId ?? null, annotationId);
+            const deleted = this.getChapterAnnotation(annotationId, true);
+            this.recordChapterAnnotationVersion(deleted, "delete", timestamp);
+            this.audit(String(deleted.workId), "chapter.annotation.deleted", "chapter-annotation", annotationId, { versionNo: deleted.versionNo, recoverable: true });
+        });
+    }
+    batchManageChapters(workId, chapters, action) {
+        this.getWork(workId);
+        const uniqueIds = new Set(chapters.map((chapter) => chapter.id));
+        if (uniqueIds.size !== chapters.length)
+            throw new AppError(400, "DUPLICATE_CHAPTER", "批量操作中不能重复选择同一章节");
+        return this.db.transaction(() => {
+            const currentChapters = chapters.map((input) => {
+                const chapter = this.getChapter(input.id);
+                if (chapter.workId !== workId)
+                    throw new AppError(400, "CHAPTER_WORK_MISMATCH", "章节不属于当前作品");
+                this.assertExpectedRevision("chapter", input.id, input.expectedVersionNo, "章节", Number(chapter.versionNo));
+                return chapter;
+            });
+            const timestamp = now();
+            if (action.type === "move") {
+                const targetVolume = this.getVolume(action.volumeId);
+                if (targetVolume.workId !== workId)
+                    throw new AppError(400, "VOLUME_WORK_MISMATCH", "卷不属于当前作品");
+                const selectedIds = new Set(currentChapters.map((chapter) => String(chapter.id)));
+                const affectedVolumeIds = new Set(currentChapters.map((chapter) => String(chapter.volumeId)));
+                affectedVolumeIds.add(action.volumeId);
+                const orderedByVolume = new Map();
+                for (const volumeId of affectedVolumeIds) {
+                    orderedByVolume.set(volumeId, this.db.all("SELECT id FROM chapters WHERE volume_id = ? AND deleted_at IS NULL ORDER BY sort_order, created_at, id", volumeId).map((row) => requiredString(row, "id")).filter((chapterId) => !selectedIds.has(chapterId)));
+                }
+                orderedByVolume.get(action.volumeId)?.push(...currentChapters.map((chapter) => String(chapter.id)));
+                for (const [volumeId, chapterIds] of orderedByVolume) {
+                    chapterIds.forEach((chapterId, sortOrder) => {
+                        this.db.run("UPDATE chapters SET volume_id = ?, sort_order = ?, updated_at = ? WHERE id = ?", volumeId, sortOrder, timestamp, chapterId);
+                    });
+                }
+                for (const chapter of currentChapters) {
+                    const chapterId = String(chapter.id);
+                    const versionNo = Number(chapter.versionNo) + 1;
+                    const sortOrder = orderedByVolume.get(action.volumeId)?.indexOf(chapterId) ?? 0;
+                    this.db.run("UPDATE chapters SET version_no = ?, analysis_status = 'expired', updated_at = ? WHERE id = ?", versionNo, timestamp, chapterId);
+                    this.insertChapterVersionRow({
+                        workId,
+                        chapterId,
+                        versionNo,
+                        title: String(chapter.title),
+                        content: String(chapter.content),
+                        volumeId: action.volumeId,
+                        sortOrder,
+                        chapterType: String(chapter.chapterType),
+                        source: "manual",
+                        sourceRef: null,
+                        changeNote: "批量移动章节",
+                        timestamp
+                    });
+                    this.invalidateChapter(workId, chapterId, versionNo);
+                    this.audit(workId, "chapter.moved", "chapter", chapterId, { volumeId: action.volumeId, sortOrder, versionNo, batch: true });
+                }
+            }
+            else if (action.type === "setType") {
+                for (const chapter of currentChapters) {
+                    this.db.run("UPDATE chapters SET chapter_type = ?, analysis_status = 'expired', updated_at = ? WHERE id = ?", action.chapterType, timestamp, String(chapter.id));
+                    this.invalidateChapter(workId, String(chapter.id), Number(chapter.versionNo));
+                    this.audit(workId, "chapter.saved", "chapter", String(chapter.id), { chapterType: action.chapterType, batch: true });
+                }
+            }
+            else if (action.type === "setAnalysisExclusion") {
+                for (const chapter of currentChapters) {
+                    this.db.run("UPDATE chapters SET excluded_from_analysis = ?, updated_at = ? WHERE id = ?", action.excludedFromAnalysis ? 1 : 0, timestamp, String(chapter.id));
+                    this.audit(workId, "chapter.saved", "chapter", String(chapter.id), { excludedFromAnalysis: action.excludedFromAnalysis, batch: true });
+                }
+            }
+            else {
+                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.insertChapterVersionRow({
+                        workId,
+                        chapterId,
+                        versionNo,
+                        title: String(chapter.title),
+                        content: String(chapter.content),
+                        volumeId: String(chapter.volumeId),
+                        sortOrder: Number(chapter.sortOrder),
+                        chapterType: String(chapter.chapterType),
+                        source: "delete",
+                        sourceRef: null,
+                        changeNote: "批量删除章节（可恢复）",
+                        timestamp
+                    });
+                    this.db.run("DELETE FROM chapter_paragraph_search WHERE chapter_id = ?", chapterId);
+                    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, '$.chapterId') = ?
+               OR json_extract(scope_json, '$.type') = 'book'
+               OR (json_extract(scope_json, '$.type') = 'volume'
+                 AND json_extract(scope_json, '$.volumeId') = ?))`, timestamp, workId, chapterId, String(chapter.volumeId));
+                    this.audit(workId, "chapter.deleted", "chapter", chapterId, { versionNo, batch: true, recoverable: true });
+                }
+            }
+            this.db.run("UPDATE works SET updated_at = ? WHERE id = ?", timestamp, workId);
+            return { processed: currentChapters.length, action: action.type };
+        });
+    }
     deleteChapter(chapterId, expectedVersionNo) {
         const chapter = this.getChapter(chapterId);
         this.assertExpectedRevision("chapter", chapterId, expectedVersionNo, "章节", Number(chapter.versionNo));
@@ -1245,7 +1594,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 = ?, updated_at = ? WHERE id = ?", versionNo, timestamp, chapterId);
+            this.db.run("UPDATE chapters SET version_no = ?, deleted_at = ?, updated_at = ? WHERE id = ?", versionNo, timestamp, timestamp, chapterId);
             this.insertChapterVersionRow({
                 workId: String(chapter.workId),
                 chapterId,
@@ -1260,7 +1609,14 @@ export class Store {
                 changeNote: "删除章节",
                 timestamp
             });
-            this.db.run("DELETE FROM chapters WHERE id = ?", chapterId);
+            this.db.run("DELETE FROM chapter_paragraph_search WHERE chapter_id = ?", chapterId);
+            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, '$.chapterId') = ?
+           OR json_extract(scope_json, '$.type') = 'book'
+           OR (json_extract(scope_json, '$.type') = 'volume'
+             AND json_extract(scope_json, '$.volumeId') = ?))`, timestamp, String(chapter.workId), chapterId, String(chapter.volumeId));
+            this.db.run("UPDATE works SET updated_at = ? WHERE id = ?", timestamp, String(chapter.workId));
             this.audit(String(chapter.workId), "chapter.deleted", "chapter", chapterId, { versionNo });
         });
     }
@@ -1311,12 +1667,12 @@ export class Store {
         const rows = [...normalizedKeyword].length < 3
             ? this.db.all(`${columns}
            JOIN chapter_paragraph_short_terms term ON term.paragraph_id = paragraph.id
-           WHERE paragraph.work_id = ? AND term.term = ?
+           WHERE paragraph.work_id = ? AND chapter.deleted_at IS NULL AND term.term = ?
            ORDER BY volume.sort_order, chapter.sort_order, paragraph.paragraph_order
            LIMIT ?`, workId, normalizedKeyword, safeLimit)
             : this.db.all(`${columns}
            JOIN chapter_paragraph_search_fts fts ON fts.rowid = paragraph.id
-           WHERE paragraph.work_id = ? AND chapter_paragraph_search_fts MATCH ?
+           WHERE paragraph.work_id = ? AND chapter.deleted_at IS NULL AND chapter_paragraph_search_fts MATCH ?
            ORDER BY volume.sort_order, chapter.sort_order, paragraph.paragraph_order
            LIMIT ?`, workId, `"${normalizedKeyword.replaceAll('"', '""')}"`, safeLimit);
         return rows.map((row) => ({
@@ -1365,7 +1721,7 @@ 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 = ?", requiredString(row, "id"));
+        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"));
         return {
             id: requiredString(row, "id"),
@@ -1445,7 +1801,7 @@ export class Store {
        FROM chapters c
        JOIN volumes v ON v.id = c.volume_id
        LEFT JOIN chapter_outlines o ON o.chapter_id = c.id
-       WHERE c.work_id = ?
+       WHERE c.work_id = ? AND c.deleted_at IS NULL
        ORDER BY v.sort_order, c.sort_order, c.created_at`, workId);
         return rows.map((row) => ({
             chapterId: requiredString(row, "chapter_id"),
@@ -1474,7 +1830,7 @@ export class Store {
        FROM chapters c
        JOIN volumes v ON v.id = c.volume_id
        LEFT JOIN chapter_outlines o ON o.chapter_id = c.id
-       WHERE c.work_id = ?
+       WHERE c.work_id = ? AND c.deleted_at IS NULL
        ORDER BY v.sort_order, c.sort_order, c.created_at${page.sql}`, workId, ...page.params);
         return paginated(rows.map((row) => ({
             chapterId: requiredString(row, "chapter_id"),
@@ -3620,31 +3976,36 @@ export class Store {
     hashContent(content) {
         return createHash("sha256").update(content).digest("hex");
     }
-    relationshipSettingsSourceVersions(workId) {
+    relationshipRosterSourceVersions(workId) {
         const versions = {};
+        for (const character of this.listCharacters(workId, false)) {
+            versions[`character:${String(character.id)}`] = Number(character.versionNo);
+        }
+        for (const race of this.listRaces(workId))
+            versions[`race:${String(race.id)}`] = Number(race.versionNo);
+        for (const organization of this.listOrganizations(workId)) {
+            versions[`organization:${String(organization.id)}`] = Number(organization.versionNo);
+        }
+        for (const relationship of this.listRelationships(workId)) {
+            versions[`relationship:${String(relationship.id)}`] = Number(relationship.versionNo);
+        }
+        return versions;
+    }
+    relationshipSettingsSourceVersions(workId) {
+        const versions = this.relationshipRosterSourceVersions(workId);
         const work = this.getWork(workId);
         versions[`work:${workId}`] = Number(work.versionNo);
         for (const setting of this.listSettings(workId))
             versions[`setting:${String(setting.id)}`] = Number(setting.versionNo);
-        const characters = this.listCharacters(workId, true);
-        for (const character of characters) {
-            versions[`character:${String(character.id)}`] = Number(character.versionNo);
+        for (const character of this.listCharacters(workId, true)) {
             for (const section of this.listCharacterProfileSections(String(character.id))) {
                 versions[`character-section:${String(section.id)}`] = Number(section.versionNo);
             }
         }
-        for (const race of this.listRaces(workId))
-            versions[`race:${String(race.id)}`] = Number(race.versionNo);
-        for (const organization of this.listOrganizations(workId)) {
-            versions[`organization:${String(organization.id)}`] = Number(organization.versionNo);
-        }
         for (const track of this.listTimelineTracks(workId))
             versions[`timeline-track:${String(track.id)}`] = Number(track.versionNo);
         for (const event of this.listTimelineEvents(workId))
             versions[`timeline-event:${String(event.id)}`] = Number(event.versionNo);
-        for (const relationship of this.listRelationships(workId)) {
-            versions[`relationship:${String(relationship.id)}`] = Number(relationship.versionNo);
-        }
         for (const outline of this.listChapterOutlines(workId)) {
             const chapterId = String(outline.chapterId);
             versions[`chapter-meta:${chapterId}`] = Number(this.getChapter(chapterId).versionNo);
@@ -3658,6 +4019,34 @@ export class Store {
         }
         return versions;
     }
+    analysisTaskSourceVersions(workId, scope) {
+        const sourceVersions = {};
+        if (typeof scope.chapterId === "string") {
+            const chapter = this.getChapter(scope.chapterId);
+            if (chapter.workId !== workId)
+                throw new AppError(400, "CHAPTER_WORK_MISMATCH", "章节不属于当前作品");
+            sourceVersions[scope.chapterId] = Number(chapter.versionNo);
+        }
+        else if (scope.type === "book" || scope.type === "volume") {
+            const tree = this.getWorkTree(workId);
+            const volumes = tree.volumes;
+            const selectedVolumes = scope.type === "volume"
+                ? volumes.filter((volume) => volume.id === scope.volumeId)
+                : volumes;
+            if (scope.type === "volume" && selectedVolumes.length === 0)
+                throw notFound("卷");
+            for (const chapter of selectedVolumes.flatMap((volume) => volume.chapters)) {
+                sourceVersions[String(chapter.id)] = Number(chapter.versionNo);
+            }
+        }
+        if (scope.previewRelationshipChanges === true) {
+            Object.assign(sourceVersions, this.relationshipRosterSourceVersions(workId));
+        }
+        if (scope.type === "settings" || (scope.includeAllSettings === true && scope.previewRelationshipChanges === true)) {
+            Object.assign(sourceVersions, this.relationshipSettingsSourceVersions(workId));
+        }
+        return sourceVersions;
+    }
     mapContinuationGuard(row) {
         return {
             id: requiredString(row, "id"),
@@ -3677,7 +4066,6 @@ export class Store {
         const taskId = id("task");
         const timestamp = now();
         const scope = { ...(input.scope ?? { type: "book" }) };
-        const sourceVersions = {};
         const targetCharacters = [];
         if (Array.isArray(scope.characterIds)) {
             for (const characterId of scope.characterIds) {
@@ -3691,33 +4079,14 @@ export class Store {
             if (targetCharacters.length > 0)
                 scope.targetCharacters = targetCharacters;
         }
-        if (typeof scope.chapterId === "string") {
-            const chapter = this.getChapter(scope.chapterId);
-            if (chapter.workId !== workId)
-                throw new AppError(400, "CHAPTER_WORK_MISMATCH", "章节不属于当前作品");
-            sourceVersions[scope.chapterId] = Number(chapter.versionNo);
-        }
-        else if (scope.type === "book" || scope.type === "volume") {
-            const tree = this.getWorkTree(workId);
-            const volumes = tree.volumes;
-            const selectedVolumes = scope.type === "volume"
-                ? volumes.filter((volume) => volume.id === scope.volumeId)
-                : volumes;
-            if (scope.type === "volume" && selectedVolumes.length === 0)
-                throw notFound("卷");
-            for (const chapter of selectedVolumes.flatMap((volume) => volume.chapters)) {
-                sourceVersions[String(chapter.id)] = Number(chapter.versionNo);
-            }
-        }
-        else if (scope.type === "settings") {
-            Object.assign(sourceVersions, this.relationshipSettingsSourceVersions(workId));
-        }
+        const sourceVersions = this.analysisTaskSourceVersions(workId, scope);
         this.db.run(`INSERT INTO analysis_tasks (id, work_id, model_id, task_type, scope_json, status, source_versions_json, created_at, updated_at, created_by_user_id)
        VALUES (?, ?, ?, ?, ?, 'pending', ?, ?, ?, ?)`, taskId, workId, input.modelId ?? null, input.taskType, JSON.stringify(scope), JSON.stringify(sourceVersions), timestamp, timestamp, currentRequestActor()?.userId ?? null);
         this.audit(workId, "task.created", "analysis-task", taskId, {
             taskType: input.taskType,
             scope,
-            modelId: input.modelId ?? null
+            modelId: input.modelId ?? null,
+            ...(input.rerunOfTaskId ? { rerunOfTaskId: input.rerunOfTaskId } : {})
         });
         this.notifyAnalysisTaskQueued(workId);
         return this.getTask(taskId);
@@ -3738,7 +4107,7 @@ export class Store {
        WHERE task.work_id = ? ORDER BY task.created_at DESC, task.id DESC${page.sql}`, workId, ...page.params);
         const chapterSummaries = new Map(this.db.all(`SELECT chapter.id, chapter.title, volume.title AS volume_title
        FROM chapters chapter JOIN volumes volume ON volume.id = chapter.volume_id
-       WHERE chapter.work_id = ?`, workId).map((row) => [
+       WHERE chapter.work_id = ? AND chapter.deleted_at IS NULL`, workId).map((row) => [
             requiredString(row, "id"),
             `${requiredString(row, "volume_title")} · ${requiredString(row, "title")}`
         ]));
@@ -3781,34 +4150,13 @@ export class Store {
         const task = this.getTask(taskId);
         const scope = task.scope;
         const expected = task.sourceVersions;
-        if (scope.type === "settings") {
-            const current = this.relationshipSettingsSourceVersions(String(task.workId));
-            const expectedIds = Object.keys(expected).sort();
-            const currentIds = Object.keys(current).sort();
-            return expectedIds.length === currentIds.length
-                && expectedIds.every((settingId, index) => settingId === currentIds[index] && expected[settingId] === current[settingId]);
-        }
-        let chapters = [];
-        if (typeof scope.chapterId === "string") {
-            const row = this.db.get("SELECT id, work_id, version_no FROM chapters WHERE id = ?", scope.chapterId);
-            if (!row || requiredString(row, "work_id") !== task.workId)
-                return false;
-            chapters = [{ id: requiredString(row, "id"), versionNo: numberValue(row, "version_no") }];
-        }
-        else if (scope.type === "book" || scope.type === "volume") {
-            const tree = this.getWorkTree(String(task.workId));
-            const volumes = tree.volumes;
-            const selectedVolumes = scope.type === "volume"
-                ? volumes.filter((volume) => volume.id === scope.volumeId)
-                : volumes;
-            if (scope.type === "volume" && selectedVolumes.length === 0)
-                return false;
-            chapters = selectedVolumes.flatMap((volume) => volume.chapters);
+        let current;
+        try {
+            current = this.analysisTaskSourceVersions(String(task.workId), scope);
         }
-        else {
-            return true;
+        catch {
+            return false;
         }
-        const current = Object.fromEntries(chapters.map((chapter) => [String(chapter.id), Number(chapter.versionNo)]));
         const expectedIds = Object.keys(expected).sort();
         const currentIds = Object.keys(current).sort();
         return expectedIds.length === currentIds.length
@@ -3817,9 +4165,9 @@ export class Store {
     refreshTaskSourceVersions(taskId) {
         const task = this.getTask(taskId);
         const scope = task.scope;
-        if (scope.type !== "settings")
+        if (scope.type !== "settings" && !(scope.includeAllSettings === true && scope.previewRelationshipChanges === true))
             return;
-        this.db.run("UPDATE analysis_tasks SET source_versions_json = ?, updated_at = ? WHERE id = ?", JSON.stringify(this.relationshipSettingsSourceVersions(String(task.workId))), now(), taskId);
+        this.db.run("UPDATE analysis_tasks SET source_versions_json = ?, updated_at = ? WHERE id = ?", JSON.stringify(this.analysisTaskSourceVersions(String(task.workId), scope)), now(), taskId);
     }
     cancelTask(taskId) {
         const current = this.getTask(taskId);
@@ -4183,6 +4531,7 @@ export class Store {
         let summary = "分析已完成。";
         let metrics = [];
         let sections = [];
+        let relationshipChangePreviewSummary = null;
         if (taskType === "chapter-analysis") {
             let chapterTitle = String(result.chapterId ?? "指定章节");
             if (typeof result.chapterId === "string") {
@@ -4458,8 +4807,29 @@ export class Store {
         else if (taskType === "relationship-analysis") {
             const relationshipIds = idList(result.relationshipIds);
             const missingRelationshipIds = idList(result.missingRelationshipIds);
+            const changePreview = result.relationshipChangePreview && typeof result.relationshipChangePreview === "object"
+                && !Array.isArray(result.relationshipChangePreview)
+                ? result.relationshipChangePreview
+                : null;
+            const previewStatus = String(changePreview?.status ?? "");
+            if (changePreview) {
+                relationshipChangePreviewSummary = {
+                    status: previewStatus,
+                    totalCount: Number(changePreview.totalCount ?? 0),
+                    createdCount: Number(changePreview.createdCount ?? 0),
+                    updatedCount: Number(changePreview.updatedCount ?? 0),
+                    deletedCount: Number(changePreview.deletedCount ?? 0),
+                    ...(typeof changePreview.generatedAt === "string" ? { generatedAt: changePreview.generatedAt } : {}),
+                    ...(typeof changePreview.appliedAt === "string" ? { appliedAt: changePreview.appliedAt } : {}),
+                    ...(typeof changePreview.discardedAt === "string" ? { discardedAt: changePreview.discardedAt } : {})
+                };
+            }
             const relationships = this.taskResultObjects(result.relationshipResults).map((relationship) => {
-                const actionLabels = { created: "已新建", updated: "已更新", unchanged: "已保留原记录" };
+                const actionLabels = previewStatus === "pending"
+                    ? { created: "将新建", updated: "将更新", deleted: "将删除", unchanged: "将保留原记录" }
+                    : previewStatus === "discarded"
+                        ? { created: "已放弃新建", updated: "已放弃更新", deleted: "已放弃删除", unchanged: "已保留原记录" }
+                        : { created: "已新建", updated: "已更新", deleted: "已删除", unchanged: "已保留原记录" };
                 const categoryLabels = { family: "亲属", social: "社交", emotional: "情感", conflict: "冲突", uncertain: "未确定" };
                 const statusLabels = { active: "持续中", ongoing: "持续中", ended: "已结束", historical: "历史关系" };
                 const confirmationLabels = { pending: "待确认", confirmed: "已确认", rejected: "已否决" };
@@ -4489,21 +4859,26 @@ export class Store {
             const sourceSelection = result.sourceSelection && typeof result.sourceSelection === "object" && !Array.isArray(result.sourceSelection)
                 ? result.sourceSelection
                 : null;
-            summary = missingRelationshipIds.length > 0
-                ? `${targetSummary}。任务结果记录 ${relationshipIds.length} 条关系，当前作品中保留 ${relationships.length} 条可展示关系，另有 ${missingRelationshipIds.length} 条已删除或合并。`
-                : `${targetSummary}，共形成 ${relationships.length} 条可展示结果。`;
+            summary = previewStatus === "pending"
+                ? `${targetSummary}，生成 ${Number(changePreview?.totalCount ?? 0)} 项待确认变更，尚未写入人物关系库。`
+                : previewStatus === "discarded"
+                    ? `${targetSummary}，本次 ${Number(changePreview?.totalCount ?? 0)} 项关系变更已放弃，人物关系库未被修改。`
+                    : missingRelationshipIds.length > 0
+                        ? `${targetSummary}。任务结果记录 ${relationshipIds.length} 条关系，当前作品中保留 ${relationships.length} 条可展示关系，另有 ${missingRelationshipIds.length} 条已删除或合并。`
+                        : `${targetSummary}，共形成 ${relationships.length} 条可展示结果。`;
             if (sourceSelection) {
                 summary += ` 来源筛选命中 ${Number(sourceSelection.exactSourceCount ?? 0)} 个精确来源，确认 ${Number(sourceSelection.confirmedSourceCount ?? 0)} 个疑似来源。`;
             }
             const actionMetrics = [
                 ["新建", result.createdCount],
                 ["更新", result.updatedCount],
+                ["删除", result.deletedCount],
                 ["保留", result.unchangedCount]
             ].flatMap(([label, value]) => typeof value === "number" ? [metric(String(label), value)] : []);
             metrics = [
                 ...actionMetrics,
                 metric("任务记录", relationshipIds.length || relationships.length),
-                metric("当前可展示", relationships.length),
+                metric(previewStatus === "pending" ? "待确认变更" : "当前可展示", relationships.length),
                 metric("已删除或合并", missingRelationshipIds.length),
                 metric("跳过", Array.isArray(result.skipped) ? result.skipped.length : 0),
                 ...(sourceSelection ? [
@@ -4518,8 +4893,12 @@ export class Store {
                 label: "人物关系",
                 entity: "人物关系库",
                 key: "relationships",
-                count: relationshipIds.length || relationships.length,
-                note: `任务记录 ${relationshipIds.length || relationships.length} 条关系，当前可读取 ${relationships.length} 条；关系候选需由作者确认。`
+                count: previewStatus === "pending" ? 0 : relationshipIds.length || relationships.length,
+                note: previewStatus === "pending"
+                    ? `有 ${Number(changePreview?.totalCount ?? 0)} 项待确认变更，点击确认应用前不会写入或删除人物关系。`
+                    : previewStatus === "discarded"
+                        ? "本次待确认变更已放弃，人物关系库未被修改。"
+                        : `任务记录 ${relationshipIds.length || relationships.length} 条关系，当前可读取 ${relationships.length} 条；关系候选需由作者确认。`
             });
             const variantReviewIds = sourceSelection && Array.isArray(sourceSelection.reviewIds) ? sourceSelection.reviewIds.map(String) : [];
             if (variantReviewIds.length > 0)
@@ -4531,7 +4910,12 @@ export class Store {
                     note: "仅生成待处理审核项，不会修改正文或人物别名。"
                 });
             sections = [
-                { title: "分析出的关系", totalCount: relationships.length, items: relationships.slice(0, 100), emptyMessage: "没有形成可展示的人物关系。" },
+                {
+                    title: previewStatus === "pending" ? "待确认的关系变更" : previewStatus === "discarded" ? "已放弃的关系变更" : "分析出的关系",
+                    totalCount: relationships.length,
+                    items: relationships.slice(0, 100),
+                    emptyMessage: previewStatus === "pending" ? "本次没有需要应用的关系变更。" : "没有形成可展示的人物关系。"
+                },
                 section("未写入候选", result.skipped, "没有候选被跳过。")
             ];
         }
@@ -4546,7 +4930,8 @@ export class Store {
             summary,
             metrics,
             storageTargets: productStorageTargets(storageTargets),
-            sections
+            sections,
+            ...(relationshipChangePreviewSummary ? { relationshipChangePreview: relationshipChangePreviewSummary } : {})
         };
     }
     taskResultForClient(result) {
@@ -4620,7 +5005,8 @@ export class Store {
                 characterIds: targetCharacters.map((character) => String(character.id ?? "")).filter(Boolean),
                 characterNames: targetCharacters.map((character) => String(character.name ?? "")).filter(Boolean),
                 coveredChapterCount: Number(result.coveredChapterCount ?? 0),
-                includeAllSettings: scope.includeAllSettings === true
+                includeAllSettings: scope.includeAllSettings === true,
+                preFilterRelationshipSources: targetCharacters.length > 0 && scope.preFilterRelationshipSources !== false
             },
         });
     }
@@ -4703,7 +5089,7 @@ export class Store {
             const chapter = this.db.get(`SELECT chapter.title AS title, volume.title AS volume_title
          FROM chapters chapter
          JOIN volumes volume ON volume.id = chapter.volume_id
-         WHERE chapter.id = ? AND chapter.work_id = ?`, scope.chapterId, workId);
+         WHERE chapter.id = ? AND chapter.work_id = ? AND chapter.deleted_at IS NULL`, scope.chapterId, workId);
             if (!chapter)
                 return `章节已删除${targetedSuffix}`;
             const title = requiredString(chapter, "title");
@@ -4750,11 +5136,15 @@ export class Store {
         if (characterIds.length === 0)
             return "";
         const overwriteSuffix = scope.replaceExistingRelationships === true ? " · 覆盖已有关系" : "";
+        const preFilterSuffix = scope.preFilterRelationshipSources === false ? " · 未前置过滤" : "";
+        const sourcePreviewSuffix = Array.isArray(scope.relationshipSourceRefs)
+            ? ` · 已预检 ${scope.relationshipSourceRefs.length} 条来源`
+            : "";
         if (!includeCharacterNames)
-            return ` · 定向 ${characterIds.length} 人${overwriteSuffix}`;
+            return ` · 定向 ${characterIds.length} 人${preFilterSuffix}${sourcePreviewSuffix}${overwriteSuffix}`;
         const snapshotNames = this.taskCharacterSnapshotNames(scope);
         const names = characterIds.map((characterId) => snapshotNames.get(characterId) ?? characterNames.get(characterId) ?? "已删除角色");
-        return ` · 定向 ${characterIds.length} 人：${names.join("、")}${overwriteSuffix}`;
+        return ` · 定向 ${characterIds.length} 人：${names.join("、")}${preFilterSuffix}${sourcePreviewSuffix}${overwriteSuffix}`;
     }
     taskCharacterSnapshotNames(scope) {
         const snapshotNames = new Map();
@@ -4776,7 +5166,7 @@ export class Store {
                 volume.id AS volume_id, volume.title AS volume_title
          FROM chapters chapter
          JOIN volumes volume ON volume.id = chapter.volume_id
-         WHERE chapter.id = ? AND chapter.work_id = ?`, scope.chapterId, workId);
+         WHERE chapter.id = ? AND chapter.work_id = ? AND chapter.deleted_at IS NULL`, scope.chapterId, workId);
             if (!chapter)
                 return [{ type: "chapter", chapterId: scope.chapterId, missing: true }];
             return [{
@@ -4792,7 +5182,7 @@ export class Store {
             const volume = this.db.get("SELECT id, title FROM volumes WHERE id = ? AND work_id = ?", scope.volumeId, workId);
             if (!volume)
                 return [{ type: "volume", volumeId: scope.volumeId, missing: true }];
-            const chapters = this.db.all("SELECT id, title, version_no FROM chapters WHERE volume_id = ? ORDER BY sort_order, created_at", scope.volumeId);
+            const chapters = this.db.all("SELECT id, title, version_no FROM chapters WHERE volume_id = ? AND deleted_at IS NULL ORDER BY sort_order, created_at", scope.volumeId);
             return [{
                     type: "volume",
                     volumeId: requiredString(volume, "id"),
@@ -4820,7 +5210,7 @@ export class Store {
     search(workId, query) {
         this.getWork(workId);
         const pattern = `%${query.replaceAll("%", "\\%").replaceAll("_", "\\_")}%`;
-        const chapters = this.db.all("SELECT id, title, content, volume_id FROM chapters WHERE work_id = ? AND (title LIKE ? ESCAPE '\\' OR content LIKE ? ESCAPE '\\') LIMIT 50", workId, pattern, pattern);
+        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;
@@ -4953,5 +5343,70 @@ export class Store {
             createdAt: requiredString(row, "created_at")
         })), pagination);
     }
+    getWritingProgress(workId, days = 30) {
+        const work = this.getWork(workId);
+        const goal = this.db.get("SELECT * FROM writing_goals WHERE work_id = ?", workId);
+        const dailyGoal = goal ? numberValue(goal, "daily_goal") : 1000;
+        const targetTotal = goal ? numberValue(goal, "target_total") : 100000;
+        const today = new Date();
+        today.setUTCHours(0, 0, 0, 0);
+        const start = new Date(today);
+        start.setUTCDate(start.getUTCDate() - days + 1);
+        const startKey = start.toISOString().slice(0, 10);
+        const versions = this.db.all(`SELECT chapter_id, content, source, created_at FROM chapter_versions
+       WHERE work_id = ? AND created_at <= ? ORDER BY created_at, version_no, id`, workId, `${today.toISOString().slice(0, 10)}T23:59:59.999Z`);
+        const chapterWords = new Map();
+        const events = new Map();
+        for (const version of versions) {
+            const day = requiredString(version, "created_at").slice(0, 10);
+            if (day < startKey) {
+                chapterWords.set(requiredString(version, "chapter_id"), requiredString(version, "source") === "delete" ? 0 : countWords(requiredString(version, "content")));
+            }
+            else {
+                const dayEvents = events.get(day) ?? [];
+                dayEvents.push(version);
+                events.set(day, dayEvents);
+            }
+        }
+        let previousTotal = [...chapterWords.values()].reduce((sum, value) => sum + value, 0);
+        const trend = [];
+        for (let index = 0; index < days; index += 1) {
+            const date = new Date(start);
+            date.setUTCDate(start.getUTCDate() + index);
+            const day = date.toISOString().slice(0, 10);
+            for (const version of events.get(day) ?? []) {
+                chapterWords.set(requiredString(version, "chapter_id"), requiredString(version, "source") === "delete" ? 0 : countWords(requiredString(version, "content")));
+            }
+            const words = [...chapterWords.values()].reduce((sum, value) => sum + value, 0);
+            trend.push({ date: day, words, delta: words - previousTotal });
+            previousTotal = words;
+        }
+        const todayProgress = Number(trend.at(-1)?.delta ?? 0);
+        return {
+            goal: {
+                dailyGoal,
+                targetTotal,
+                deadline: goal ? optionalString(goal, "deadline") : null,
+                updatedAt: goal ? requiredString(goal, "updated_at") : null
+            },
+            currentWords: Number(work.wordCount ?? 0),
+            todayWords: Math.max(0, todayProgress),
+            dailyCompletion: dailyGoal > 0 ? Math.min(1, Math.max(0, todayProgress) / dailyGoal) : 0,
+            totalCompletion: targetTotal > 0 ? Math.min(1, Number(work.wordCount ?? 0) / targetTotal) : 0,
+            trend
+        };
+    }
+    updateWritingGoal(workId, input) {
+        this.getWork(workId);
+        const timestamp = now();
+        this.db.transaction(() => {
+            this.db.run(`INSERT INTO writing_goals (work_id, daily_goal, target_total, deadline, created_at, updated_at, updated_by_user_id)
+         VALUES (?, ?, ?, ?, ?, ?, ?)
+         ON CONFLICT(work_id) DO UPDATE SET daily_goal = excluded.daily_goal, target_total = excluded.target_total,
+         deadline = excluded.deadline, updated_at = excluded.updated_at, updated_by_user_id = excluded.updated_by_user_id`, workId, input.dailyGoal, input.targetTotal, input.deadline, timestamp, timestamp, currentRequestActor()?.userId ?? null);
+            this.audit(workId, "work.writing_goal.updated", "work", workId, input);
+        });
+        return this.getWritingProgress(workId);
+    }
 }
 //# sourceMappingURL=store.js.map