@musnows/scriverse 0.7.11 → 0.7.13

package/dist/store.js

@@ -13,6 +13,7 @@ import { countWords, documentShortSearchTerms, escapeSqlLikePattern, id, json, n
 import { buildWritingCalendar, writingDateKey } from "./writing-progress-time.js";
 import { resolveMaxAgentToolCallLimit } from "./ai-tool-results.js";
 const WORK_LIST_BATCH_SIZE = 500;
+const ENTITY_LIST_BATCH_SIZE = 400;
 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();
@@ -154,6 +155,29 @@ function knowledgeSectionsFromInput(sections, settingsMarkdown, settings, fallba
 function settingsFromKnowledgeSections(sections) {
     return sections.map((section) => section.contentMarkdown).filter((content) => content.trim());
 }
+export const chapterOutlineBoardForeshadowSortSql = {
+    cte: `WITH foreshadow_associations AS MATERIALIZED (
+    SELECT foreshadow.work_id, occurrence.chapter_id, foreshadow.id AS foreshadow_id, foreshadow.status
+    FROM foreshadows foreshadow
+    JOIN foreshadow_occurrences occurrence ON occurrence.foreshadow_id = foreshadow.id
+    WHERE foreshadow.work_id = ?
+    UNION
+    SELECT foreshadow.work_id, foreshadow.planned_payoff_chapter_id AS chapter_id,
+      foreshadow.id AS foreshadow_id, foreshadow.status
+    FROM foreshadows foreshadow
+    WHERE foreshadow.work_id = ? AND foreshadow.planned_payoff_chapter_id IS NOT NULL
+  ), foreshadow_association_counts AS MATERIALIZED (
+    SELECT association.work_id, association.chapter_id,
+      SUM(CASE WHEN association.status IN ('planned', 'planted') THEN 1 ELSE 0 END) AS unresolved_count,
+      COUNT(*) AS total_count
+    FROM foreshadow_associations association
+    GROUP BY association.work_id, association.chapter_id
+  )`,
+    join: `LEFT JOIN foreshadow_association_counts sorted_association
+    ON sorted_association.work_id = chapter.work_id AND sorted_association.chapter_id = chapter.id`,
+    order: `COALESCE(sorted_association.unresolved_count, 0) DESC,
+    COALESCE(sorted_association.total_count, 0) DESC`
+};
 const CHAPTER_OUTLINE_BOARD_PREVIEW_LENGTH = 600;
 function chapterOutlineBoardLikePattern(value) {
     return `%${value.normalize("NFKC").toLocaleLowerCase("zh-CN").replaceAll("\\", "\\\\").replaceAll("%", "\\%").replaceAll("_", "\\_")}%`;
@@ -315,6 +339,18 @@ export class Store {
         const row = this.db.get("SELECT MAX(version_no) AS version_no FROM entity_versions WHERE entity_type = ? AND entity_id = ?", type, entityId);
         return numberValue(row ?? {}, "version_no");
     }
+    currentEntityVersionNos(type, entityIds) {
+        const versions = new Map();
+        for (let offset = 0; offset < entityIds.length; offset += ENTITY_LIST_BATCH_SIZE) {
+            const batchIds = entityIds.slice(offset, offset + ENTITY_LIST_BATCH_SIZE);
+            const placeholders = batchIds.map(() => "?").join(", ");
+            const rows = this.db.all(`SELECT entity_id, MAX(version_no) AS version_no FROM entity_versions
+         WHERE entity_type = ? AND entity_id IN (${placeholders}) GROUP BY entity_id`, type, ...batchIds);
+            for (const row of rows)
+                versions.set(requiredString(row, "entity_id"), numberValue(row, "version_no"));
+        }
+        return versions;
+    }
     currentChapterVersionNo(chapterId) {
         return numberValue(this.db.get("SELECT MAX(version_no) AS version_no FROM chapter_versions WHERE chapter_id = ?", chapterId) ?? {}, "version_no");
     }
@@ -1240,18 +1276,19 @@ export class Store {
         }));
         return { ...work, volumes, directoryPage: pageResult };
     }
-    getStoryIndexChapterPage(workId, offset, limit) {
+    getStoryIndexChapterPage(workId, offset, limit, options = {}) {
         const work = this.getWork(workId);
         const permissions = work.modulePermissions;
         if (permissions.prose === "none")
             return { totalChapters: 0, chapters: [] };
+        const authorNoteFilter = options.excludeAuthorNotes ? " AND chapter.chapter_type <> '作者的话'" : "";
         const countRow = this.db.get(`SELECT COUNT(*) AS count FROM chapters chapter
        JOIN volumes volume ON volume.id = chapter.volume_id
-       WHERE chapter.work_id = ? AND chapter.deleted_at IS NULL AND volume.deleted_at IS NULL`, workId);
+       WHERE chapter.work_id = ? AND chapter.deleted_at IS NULL AND volume.deleted_at IS NULL${authorNoteFilter}`, workId);
         const chapterRows = this.db.all(`SELECT chapter.id, chapter.title, chapter.version_no, volume.title AS volume_title
        FROM chapters chapter
        JOIN volumes volume ON volume.id = chapter.volume_id
-       WHERE chapter.work_id = ? AND chapter.deleted_at IS NULL AND volume.deleted_at IS NULL
+       WHERE chapter.work_id = ? AND chapter.deleted_at IS NULL AND volume.deleted_at IS NULL${authorNoteFilter}
        ORDER BY volume.sort_order, volume.created_at, chapter.sort_order, chapter.created_at
        LIMIT ? OFFSET ?`, workId, limit, offset);
         const chapterIds = chapterRows.map((row) => requiredString(row, "id"));
@@ -1492,7 +1529,12 @@ export class Store {
             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);
+             OR (json_extract(scope_json, '$.type') = 'volume' AND json_extract(scope_json, '$.volumeId') = ?)
+             OR EXISTS (SELECT 1 FROM json_each(scope_json, '$.volumeIds') WHERE json_each.value = ?)
+             OR EXISTS (
+               SELECT 1 FROM json_each(scope_json, '$.chapterIds') selected_chapter
+               WHERE selected_chapter.value IN (SELECT id FROM chapters WHERE volume_id = ?)
+             ))`, timestamp, workId, volumeId, volumeId, volumeId);
             this.db.run("UPDATE works SET updated_at = ? WHERE id = ?", timestamp, workId);
             this.audit(workId, "volume.deleted", "volume", volumeId, {
                 versionNo,
@@ -2412,12 +2454,13 @@ export class Store {
         this.db.run(`UPDATE chapter_paragraph_line_ranges SET chapter_version = ?
        WHERE paragraph_id IN (SELECT id FROM chapter_paragraph_search WHERE chapter_id = ?)`, versionNo, chapterId);
     }
-    searchChapterParagraphs(workId, keyword, limit = 20) {
+    searchChapterParagraphs(workId, keyword, limit = 20, options = {}) {
         this.getWork(workId);
         const normalizedKeyword = normalizeDocumentSearchText(keyword.trim());
         if (!normalizedKeyword)
             return [];
         const safeLimit = Math.min(100, Math.max(1, Math.trunc(limit)));
+        const authorNoteFilter = options.excludeAuthorNotes ? " AND chapter.chapter_type <> '作者的话'" : "";
         const columns = `SELECT paragraph.chapter_id, chapter.title AS chapter_title, paragraph.content
       FROM chapter_paragraph_search paragraph
       JOIN chapters chapter ON chapter.id = paragraph.chapter_id
@@ -2425,12 +2468,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 chapter.deleted_at IS NULL AND term.term = ?
+           WHERE paragraph.work_id = ? AND chapter.deleted_at IS NULL${authorNoteFilter} 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.deleted_at IS NULL AND chapter_paragraph_search_fts MATCH ?
+           WHERE paragraph.work_id = ? AND chapter.deleted_at IS NULL${authorNoteFilter} 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) => ({
@@ -2445,9 +2488,14 @@ export class Store {
        AND NOT (status = 'pending' AND task_type = 'chapter-analysis'
          AND json_extract(scope_json, '$.chapterId') = ?)
        AND (json_extract(scope_json, '$.chapterId') = ?
+         OR EXISTS (SELECT 1 FROM json_each(scope_json, '$.chapterIds') WHERE json_each.value = ?)
          OR json_extract(scope_json, '$.type') = 'book'
          OR (json_extract(scope_json, '$.type') = 'volume'
-           AND json_extract(scope_json, '$.volumeId') = (SELECT volume_id FROM chapters WHERE id = ?)))`, now(), workId, chapterId, chapterId, chapterId);
+           AND (json_extract(scope_json, '$.volumeId') = (SELECT volume_id FROM chapters WHERE id = ?)
+             OR EXISTS (
+               SELECT 1 FROM json_each(scope_json, '$.volumeIds')
+               WHERE json_each.value = (SELECT volume_id FROM chapters WHERE id = ?)
+             ))))`, now(), workId, chapterId, chapterId, chapterId, chapterId, chapterId);
         const existing = this.db.get(`SELECT id FROM analysis_tasks WHERE work_id = ? AND task_type = 'chapter-analysis' AND status = 'pending'
        AND json_extract(scope_json, '$.chapterId') = ?`, workId, chapterId);
         if (!existing) {
@@ -2653,33 +2701,25 @@ export class Store {
             whereParams.push(...Array.from({ length: 8 }, () => pattern));
         }
         const whereSql = where.join(" AND ");
-        const associationCount = (statusSql = "") => `(
-      SELECT COUNT(*) FROM foreshadows sorted_foreshadow
-      WHERE sorted_foreshadow.work_id = chapter.work_id${statusSql}
-        AND (
-          sorted_foreshadow.planned_payoff_chapter_id = chapter.id
-          OR EXISTS (
-            SELECT 1 FROM foreshadow_occurrences sorted_occurrence
-            WHERE sorted_occurrence.foreshadow_id = sorted_foreshadow.id
-              AND sorted_occurrence.chapter_id = chapter.id
-          )
-        )
-    )`;
         const chapterTreeOrder = "chapter.sort_order, chapter.created_at, chapter.id";
         const chapterOrder = filters.sort === "status"
             ? `CASE WHEN outline.chapter_id IS NULL THEN 0 WHEN outline.status = 'draft' THEN 1 WHEN outline.status = 'ready' THEN 2 ELSE 3 END, ${chapterTreeOrder}`
             : filters.sort === "foreshadows"
-                ? `${associationCount(" AND sorted_foreshadow.status IN ('planned', 'planted')")} DESC, ${associationCount()} DESC, ${chapterTreeOrder}`
+                ? `${chapterOutlineBoardForeshadowSortSql.order}, ${chapterTreeOrder}`
                 : filters.sort === "title"
                     ? `chapter.title COLLATE NOCASE, ${chapterTreeOrder}`
                     : chapterTreeOrder;
         const orderSql = `volume.sort_order, volume.created_at, volume.id, ${chapterOrder}`;
+        const foreshadowSortCte = filters.sort === "foreshadows" ? chapterOutlineBoardForeshadowSortSql.cte : "";
+        const foreshadowSortJoin = filters.sort === "foreshadows" ? chapterOutlineBoardForeshadowSortSql.join : "";
+        const foreshadowSortParams = filters.sort === "foreshadows" ? [workId, workId] : [];
         const total = numberValue(this.db.get(`SELECT COUNT(*) AS count
        FROM chapters chapter
        JOIN volumes volume ON volume.id = chapter.volume_id AND volume.work_id = chapter.work_id
        LEFT JOIN chapter_outlines outline ON outline.chapter_id = chapter.id
        WHERE ${whereSql}`, ...whereParams) ?? {}, "count");
-        const pageRows = this.db.all(`SELECT volume.id AS volume_id, volume.title AS volume_title, volume.sort_order AS volume_order,
+        const pageRows = this.db.all(`${foreshadowSortCte}
+       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,
@@ -2691,9 +2731,10 @@ export class Store {
        FROM chapters chapter
        JOIN volumes volume ON volume.id = chapter.volume_id AND volume.work_id = chapter.work_id
        LEFT JOIN chapter_outlines outline ON outline.chapter_id = chapter.id
+       ${foreshadowSortJoin}
        WHERE ${whereSql}
        ORDER BY ${orderSql}
-       LIMIT ? OFFSET ?`, previewLength, previewLength, previewLength, previewLength, previewLength, previewLength, previewLength, previewLength, ...whereParams, pagination.limit + 1, pagination.offset);
+       LIMIT ? OFFSET ?`, ...foreshadowSortParams, previewLength, previewLength, previewLength, previewLength, previewLength, previewLength, previewLength, previewLength, ...whereParams, pagination.limit + 1, pagination.offset);
         const chapterPage = paginated(pageRows, pagination, total);
         const volumeRows = this.db.all(`SELECT volume.id, volume.title, volume.sort_order,
        COUNT(chapter.id) AS chapter_count
@@ -3003,20 +3044,25 @@ export class Store {
        WHERE fo.foreshadow_id = ? ORDER BY v.sort_order, c.sort_order, fo.created_at`, foreshadowId).map((item) => this.mapForeshadowOccurrence(item));
         const status = requiredString(row, "status");
         const plannedPayoffChapterId = optionalString(row, "planned_payoff_chapter_id");
+        const overdue = Boolean(currentChapterId && plannedPayoffChapterId && ["planned", "planted"].includes(status)
+            && this.chapterSequence(workId, plannedPayoffChapterId) < this.chapterSequence(workId, currentChapterId));
+        return this.mapForeshadow(row, occurrences, this.currentEntityVersionNo("foreshadow", foreshadowId), overdue);
+    }
+    mapForeshadow(row, occurrences, versionNo, overdue) {
+        const status = requiredString(row, "status");
         return {
             id: requiredString(row, "id"),
-            workId,
+            workId: requiredString(row, "work_id"),
             title: requiredString(row, "title"),
             description: requiredString(row, "description"),
             status,
             importance: requiredString(row, "importance"),
-            plannedPayoffChapterId,
+            plannedPayoffChapterId: optionalString(row, "planned_payoff_chapter_id"),
             resolutionNote: requiredString(row, "resolution_note"),
             unresolved: status === "planned" || status === "planted",
-            overdue: Boolean(currentChapterId && plannedPayoffChapterId && ["planned", "planted"].includes(status)
-                && this.chapterSequence(workId, plannedPayoffChapterId) < this.chapterSequence(workId, currentChapterId)),
+            overdue,
             occurrences,
-            versionNo: this.currentEntityVersionNo("foreshadow", foreshadowId),
+            versionNo,
             createdAt: requiredString(row, "created_at"),
             updatedAt: requiredString(row, "updated_at")
         };
@@ -3028,8 +3074,9 @@ export class Store {
         const where = status === "unresolved"
             ? "AND status IN ('planned', 'planted')"
             : status === "resolved" ? "AND status IN ('resolved', 'abandoned')" : "";
-        return this.db.all(`SELECT id FROM foreshadows WHERE work_id = ? ${where}
-       ORDER BY CASE importance WHEN 'high' THEN 0 WHEN 'medium' THEN 1 ELSE 2 END, created_at`, workId).map((row) => this.getForeshadow(requiredString(row, "id"), currentChapterId));
+        const rows = this.db.all(`SELECT * FROM foreshadows WHERE work_id = ? ${where}
+       ORDER BY CASE importance WHEN 'high' THEN 0 WHEN 'medium' THEN 1 ELSE 2 END, created_at`, workId);
+        return this.mapForeshadowList(rows, currentChapterId);
     }
     listForeshadowsPage(workId, pagination, status = "all", currentChapterId) {
         this.getWork(workId);
@@ -3039,9 +3086,63 @@ export class Store {
             ? "AND status IN ('planned', 'planted')"
             : status === "resolved" ? "AND status IN ('resolved', 'abandoned')" : "";
         const page = paginationSql(pagination);
-        const rows = this.db.all(`SELECT id FROM foreshadows WHERE work_id = ? ${where}
+        const rows = this.db.all(`SELECT * FROM foreshadows WHERE work_id = ? ${where}
        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);
+        return paginated(this.mapForeshadowList(rows, currentChapterId), pagination);
+    }
+    mapForeshadowList(rows, currentChapterId) {
+        if (rows.length === 0)
+            return [];
+        const foreshadowIds = rows.map((row) => requiredString(row, "id"));
+        const batch = {
+            occurrences: new Map(),
+            versions: this.currentEntityVersionNos("foreshadow", foreshadowIds),
+            chapterSequences: new Map()
+        };
+        for (let offset = 0; offset < foreshadowIds.length; offset += ENTITY_LIST_BATCH_SIZE) {
+            const batchIds = foreshadowIds.slice(offset, offset + ENTITY_LIST_BATCH_SIZE);
+            const placeholders = batchIds.map(() => "?").join(", ");
+            const occurrences = this.db.all(`SELECT fo.*, c.title AS chapter_title, c.volume_id, c.sort_order AS chapter_order,
+         v.title AS volume_title, v.sort_order AS volume_order
+         FROM foreshadow_occurrences fo
+         JOIN chapters c ON c.id = fo.chapter_id
+         JOIN volumes v ON v.id = c.volume_id
+         WHERE fo.foreshadow_id IN (${placeholders})
+         ORDER BY fo.foreshadow_id, v.sort_order, c.sort_order, fo.created_at`, ...batchIds);
+            for (const occurrence of occurrences) {
+                const foreshadowId = requiredString(occurrence, "foreshadow_id");
+                const grouped = batch.occurrences.get(foreshadowId) ?? [];
+                grouped.push(this.mapForeshadowOccurrence(occurrence));
+                batch.occurrences.set(foreshadowId, grouped);
+            }
+        }
+        if (currentChapterId) {
+            const chapterIds = [...new Set([
+                    currentChapterId,
+                    ...rows.map((row) => optionalString(row, "planned_payoff_chapter_id")).filter((chapterId) => Boolean(chapterId))
+                ])];
+            for (let offset = 0; offset < chapterIds.length; offset += ENTITY_LIST_BATCH_SIZE) {
+                const batchIds = chapterIds.slice(offset, offset + ENTITY_LIST_BATCH_SIZE);
+                const placeholders = batchIds.map(() => "?").join(", ");
+                const sequences = this.db.all(`SELECT c.id, v.sort_order * 1000000 + c.sort_order AS sequence
+           FROM chapters c JOIN volumes v ON v.id = c.volume_id
+           WHERE c.id IN (${placeholders}) AND c.work_id = ?`, ...batchIds, requiredString(rows[0] ?? {}, "work_id"));
+                for (const sequence of sequences) {
+                    batch.chapterSequences.set(requiredString(sequence, "id"), numberValue(sequence, "sequence"));
+                }
+            }
+        }
+        const currentChapterSequence = currentChapterId
+            ? batch.chapterSequences.get(currentChapterId) ?? Number.MAX_SAFE_INTEGER
+            : Number.MAX_SAFE_INTEGER;
+        return rows.map((row) => {
+            const foreshadowId = requiredString(row, "id");
+            const status = requiredString(row, "status");
+            const plannedPayoffChapterId = optionalString(row, "planned_payoff_chapter_id");
+            const overdue = Boolean(currentChapterId && plannedPayoffChapterId && ["planned", "planted"].includes(status)
+                && (batch.chapterSequences.get(plannedPayoffChapterId) ?? Number.MAX_SAFE_INTEGER) < currentChapterSequence);
+            return this.mapForeshadow(row, batch.occurrences.get(foreshadowId) ?? [], batch.versions.get(foreshadowId) ?? 0, overdue);
+        });
     }
     listChapterForeshadowReminders(workId, chapterId) {
         this.getWork(workId);
@@ -3724,13 +3825,16 @@ export class Store {
     }
     listOrganizations(workId, includeMarkdown = true) {
         this.getWork(workId);
-        return this.db.all("SELECT * FROM organizations WHERE work_id = ? ORDER BY name", workId).map((row) => this.mapOrganization(row, includeMarkdown));
+        const rows = this.db.all("SELECT * FROM organizations WHERE work_id = ? ORDER BY name", workId);
+        const batch = this.organizationListBatch(rows);
+        return rows.map((row) => this.mapOrganization(row, includeMarkdown, batch));
     }
     listOrganizationsPage(workId, pagination, includeMarkdown = true) {
         this.getWork(workId);
         const page = paginationSql(pagination);
         const rows = this.db.all(`SELECT * FROM organizations WHERE work_id = ? ORDER BY name${page.sql}`, workId, ...page.params);
-        return paginated(rows.map((row) => this.mapOrganization(row, includeMarkdown)), pagination);
+        const batch = this.organizationListBatch(rows);
+        return paginated(rows.map((row) => this.mapOrganization(row, includeMarkdown, batch)), pagination);
     }
     getOrganization(organizationId) {
         const row = this.db.get("SELECT * FROM organizations WHERE id = ?", organizationId);
@@ -3817,20 +3921,50 @@ export class Store {
         });
         return { mergeId, target: this.getOrganization(targetOrganizationId), source };
     }
-    mapOrganization(row, includeMarkdown = true) {
+    organizationListBatch(rows) {
+        const organizationIds = rows.map((row) => requiredString(row, "id"));
+        const batch = {
+            members: new Map(),
+            versions: this.currentEntityVersionNos("organization", organizationIds)
+        };
+        for (let offset = 0; offset < organizationIds.length; offset += ENTITY_LIST_BATCH_SIZE) {
+            const batchIds = organizationIds.slice(offset, offset + ENTITY_LIST_BATCH_SIZE);
+            const placeholders = batchIds.map(() => "?").join(", ");
+            const members = this.db.all(`SELECT m.organization_id, c.id, c.name, m.role, m.note
+         FROM character_organization_memberships m
+         JOIN characters c ON c.id = m.character_id
+         WHERE m.organization_id IN (${placeholders}) ORDER BY m.organization_id, c.name`, ...batchIds);
+            for (const member of members) {
+                const organizationId = requiredString(member, "organization_id");
+                const grouped = batch.members.get(organizationId) ?? [];
+                grouped.push({
+                    characterId: requiredString(member, "id"),
+                    name: requiredString(member, "name"),
+                    role: requiredString(member, "role"),
+                    note: requiredString(member, "note")
+                });
+                batch.members.set(organizationId, grouped);
+            }
+        }
+        return batch;
+    }
+    mapOrganization(row, includeMarkdown = true, batch) {
+        const organizationId = requiredString(row, "id");
         const settingsSections = knowledgeSectionsFromStored(row.settings_sections_json, json(requiredString(row, "settings_json"), []));
         const settings = settingsFromKnowledgeSections(settingsSections);
-        const members = this.db.all(`SELECT c.id, c.name, m.role, m.note
-       FROM character_organization_memberships m
-       JOIN characters c ON c.id = m.character_id
-       WHERE m.organization_id = ? ORDER BY c.name`, requiredString(row, "id")).map((member) => ({
-            characterId: requiredString(member, "id"),
-            name: requiredString(member, "name"),
-            role: requiredString(member, "role"),
-            note: requiredString(member, "note")
-        }));
+        const members = batch
+            ? batch.members.get(organizationId) ?? []
+            : this.db.all(`SELECT c.id, c.name, m.role, m.note
+         FROM character_organization_memberships m
+         JOIN characters c ON c.id = m.character_id
+         WHERE m.organization_id = ? ORDER BY c.name`, organizationId).map((member) => ({
+                characterId: requiredString(member, "id"),
+                name: requiredString(member, "name"),
+                role: requiredString(member, "role"),
+                note: requiredString(member, "note")
+            }));
         return {
-            id: requiredString(row, "id"),
+            id: organizationId,
             workId: requiredString(row, "work_id"),
             name: requiredString(row, "name"),
             description: requiredString(row, "description"),
@@ -3840,7 +3974,7 @@ export class Store {
                 : { settings: [], settingsCount: settingsSections.length }),
             memberIds: members.map((member) => member.characterId),
             members,
-            versionNo: this.currentEntityVersionNo("organization", requiredString(row, "id")),
+            versionNo: batch ? batch.versions.get(organizationId) ?? 0 : this.currentEntityVersionNo("organization", organizationId),
             createdAt: requiredString(row, "created_at"),
             updatedAt: requiredString(row, "updated_at")
         };
@@ -5626,6 +5760,43 @@ export class Store {
             throw notFound("AI 对话消息");
         return this.mapAiConversationMessage(persistInterruption(message));
     }
+    upsertAiConversationAssistantMessage(conversationId, requestId, content, metadata = {}, syncSearchIndex = false) {
+        const normalizedRequestId = requestId.trim();
+        if (!normalizedRequestId)
+            throw new AppError(400, "AI_MESSAGE_REQUEST_ID_REQUIRED", "AI 助手消息缺少请求标识");
+        const existing = this.db.get("SELECT * FROM ai_conversation_messages WHERE conversation_id = ? AND request_id = ?", conversationId, normalizedRequestId);
+        if (!existing) {
+            return this.addAiConversationMessage(conversationId, {
+                role: "assistant",
+                content,
+                requestId: normalizedRequestId,
+                metadata
+            });
+        }
+        if (requiredString(existing, "role") !== "assistant") {
+            throw new AppError(409, "AI_MESSAGE_ROLE_MISMATCH", "请求标识已用于用户消息");
+        }
+        const currentMetadata = json(requiredString(existing, "metadata_json"), {});
+        const nextMetadata = { ...currentMetadata, ...metadata };
+        const contentChanged = requiredString(existing, "content") !== content;
+        const metadataChanged = JSON.stringify(currentMetadata) !== JSON.stringify(nextMetadata);
+        if (!contentChanged && !metadataChanged) {
+            if (syncSearchIndex)
+                this.syncAiHistorySearchShortTermsForSource("message", requiredString(existing, "id"));
+            return this.mapAiConversationMessage(existing);
+        }
+        const timestamp = now();
+        this.db.transaction(() => {
+            this.db.run("UPDATE ai_conversation_messages SET content = ?, metadata_json = ? WHERE id = ?", content, JSON.stringify(nextMetadata), requiredString(existing, "id"));
+            this.db.run("UPDATE ai_conversations SET updated_at = ? WHERE id = ?", timestamp, conversationId);
+            if (syncSearchIndex)
+                this.syncAiHistorySearchShortTermsForSource("message", requiredString(existing, "id"));
+        });
+        const updated = this.db.get("SELECT * FROM ai_conversation_messages WHERE id = ?", requiredString(existing, "id"));
+        if (!updated)
+            throw notFound("AI 对话消息");
+        return this.mapAiConversationMessage(updated);
+    }
     beginAiConversationStreamRequest(input, referenceTime = new Date()) {
         const timestamp = referenceTime.toISOString();
         const leaseExpiresAt = new Date(referenceTime.getTime() + AI_CONVERSATION_STREAM_REQUEST_LEASE_MS).toISOString();
@@ -5743,10 +5914,18 @@ export class Store {
                 if (!assistant)
                     throw new AppError(400, "AI_STREAM_ASSISTANT_MISMATCH", "AI 回复消息不属于当前对话请求");
             }
+            const resolvedAssistantMessageId = assistantMessageId ?? (() => {
+                const userMessageId = optionalString(request, "user_message_id");
+                if (!userMessageId)
+                    return null;
+                const assistant = this.db.get(`SELECT id FROM ai_conversation_messages
+           WHERE conversation_id = ? AND role = 'assistant' AND request_id = ?`, requiredString(request, "conversation_id"), `assistant:${userMessageId}`);
+                return assistant ? requiredString(assistant, "id") : null;
+            })();
             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);
+         WHERE id = ? AND status = 'in_progress'`, status, terminalReason.slice(0, 500), resolvedAssistantMessageId, timestamp, timestamp, requestId);
             const completed = this.db.get("SELECT * FROM ai_conversation_stream_requests WHERE id = ?", requestId);
             if (!completed)
                 throw notFound("AI 对话请求");
@@ -5936,65 +6115,101 @@ export class Store {
     }
     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);
+        for (const row of this.db.all("SELECT id, version_no FROM characters WHERE work_id = ? AND merged_into_character_id IS NULL", workId)) {
+            versions[`character:${requiredString(row, "id")}`] = numberValue(row, "version_no");
         }
+        this.appendVersionedEntitySourceVersions(versions, workId, "race", "races");
+        this.appendVersionedEntitySourceVersions(versions, workId, "organization", "organizations");
+        this.appendVersionedEntitySourceVersions(versions, workId, "relationship", "relationships");
         return versions;
     }
+    appendVersionedEntitySourceVersions(versions, workId, entityType, table) {
+        const rows = this.db.all(`SELECT entity.id, COALESCE(MAX(version.version_no), 0) AS version_no
+       FROM ${table} entity
+       LEFT JOIN entity_versions version
+         ON version.work_id = entity.work_id AND version.entity_type = ? AND version.entity_id = entity.id
+       WHERE entity.work_id = ?
+       GROUP BY entity.id`, entityType, workId);
+        for (const row of rows) {
+            versions[`${entityType}:${requiredString(row, "id")}`] = numberValue(row, "version_no");
+        }
+    }
     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);
-        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 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 outline of this.listChapterOutlines(workId)) {
-            const chapterId = String(outline.chapterId);
-            versions[`chapter-meta:${chapterId}`] = Number(this.getChapter(chapterId).versionNo);
-            versions[`chapter-outline:${chapterId}`] = this.currentEntityVersionNo("chapter-outline", chapterId);
-        }
-        for (const foreshadow of this.listForeshadows(workId)) {
-            versions[`foreshadow:${String(foreshadow.id)}`] = Number(foreshadow.versionNo);
+        const work = this.db.get("SELECT version_no FROM works WHERE id = ? AND deleted_at IS NULL", workId);
+        if (!work)
+            throw notFound("作品");
+        versions[`work:${workId}`] = numberValue(work, "version_no");
+        this.appendVersionedEntitySourceVersions(versions, workId, "setting", "settings");
+        for (const row of this.db.all(`SELECT section.id, section.version_no
+       FROM character_profile_sections section
+       JOIN characters character ON character.id = section.character_id
+       WHERE section.work_id = ? AND character.merged_into_character_id IS NULL`, workId)) {
+            versions[`character-section:${requiredString(row, "id")}`] = numberValue(row, "version_no");
+        }
+        this.appendVersionedEntitySourceVersions(versions, workId, "timeline-track", "timeline_tracks");
+        this.appendVersionedEntitySourceVersions(versions, workId, "timeline-event", "timeline_events");
+        for (const row of this.db.all(`SELECT chapter.id, chapter.version_no AS chapter_version_no,
+         COALESCE(MAX(version.version_no), 0) AS outline_version_no
+       FROM chapter_outlines outline
+       JOIN chapters chapter ON chapter.id = outline.chapter_id
+       LEFT JOIN entity_versions version
+         ON version.work_id = chapter.work_id
+         AND version.entity_type = 'chapter-outline'
+         AND version.entity_id = chapter.id
+       WHERE chapter.work_id = ? AND chapter.deleted_at IS NULL
+       GROUP BY chapter.id, chapter.version_no`, workId)) {
+            const chapterId = requiredString(row, "id");
+            versions[`chapter-meta:${chapterId}`] = numberValue(row, "chapter_version_no");
+            versions[`chapter-outline:${chapterId}`] = numberValue(row, "outline_version_no");
         }
-        for (const review of this.listReviewItems(workId)) {
-            versions[`review:${String(review.id)}`] = String(review.updatedAt);
+        this.appendVersionedEntitySourceVersions(versions, workId, "foreshadow", "foreshadows");
+        for (const row of this.db.all("SELECT id, updated_at FROM review_items WHERE work_id = ?", workId)) {
+            versions[`review:${requiredString(row, "id")}`] = requiredString(row, "updated_at");
         }
         return versions;
     }
     analysisTaskSourceVersions(workId, scope) {
         const sourceVersions = {};
-        if (typeof scope.chapterId === "string") {
-            const chapter = this.getChapter(scope.chapterId);
-            if (chapter.workId !== workId)
+        const selectedChapterIds = [
+            ...(typeof scope.chapterId === "string" ? [scope.chapterId] : []),
+            ...(Array.isArray(scope.chapterIds) ? scope.chapterIds.filter((value) => typeof value === "string") : [])
+        ];
+        for (const chapterId of [...new Set(selectedChapterIds)]) {
+            const chapter = this.db.get("SELECT work_id, version_no, chapter_type FROM chapters WHERE id = ? AND deleted_at IS NULL", chapterId);
+            if (!chapter)
+                throw notFound("章节");
+            if (requiredString(chapter, "work_id") !== 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 (requiredString(chapter, "chapter_type") === "作者的话")
+                continue;
+            sourceVersions[chapterId] = numberValue(chapter, "version_no");
+        }
+        if (scope.type === "book" || scope.type === "volume") {
+            const selectedVolumeIds = [
+                ...(typeof scope.volumeId === "string" ? [scope.volumeId] : []),
+                ...(Array.isArray(scope.volumeIds) ? scope.volumeIds.filter((value) => typeof value === "string") : [])
+            ];
+            const selectedVolumeIdSet = new Set(selectedVolumeIds);
+            if (scope.type === "volume") {
+                if (selectedVolumeIdSet.size === 0)
+                    throw notFound("卷");
+                const volumePlaceholders = [...selectedVolumeIdSet].map(() => "?").join(", ");
+                const volumes = this.db.all(`SELECT id FROM volumes WHERE work_id = ? AND deleted_at IS NULL AND id IN (${volumePlaceholders})`, workId, ...selectedVolumeIdSet);
+                if (volumes.length !== selectedVolumeIdSet.size)
+                    throw notFound("卷");
+            }
+            const volumeFilter = scope.type === "volume"
+                ? `AND chapter.volume_id IN (${[...selectedVolumeIdSet].map(() => "?").join(", ")})`
+                : "";
+            const chapterRows = this.db.all(`SELECT chapter.id, chapter.version_no
+         FROM chapters chapter
+         JOIN volumes volume ON volume.id = chapter.volume_id
+         WHERE chapter.work_id = ? AND chapter.deleted_at IS NULL AND volume.deleted_at IS NULL
+           AND chapter.chapter_type <> '作者的话'
+           ${volumeFilter}`, workId, ...(scope.type === "volume" ? [...selectedVolumeIdSet] : []));
+            for (const chapter of chapterRows) {
+                sourceVersions[requiredString(chapter, "id")] = numberValue(chapter, "version_no");
             }
         }
         if (scope.previewRelationshipChanges === true) {
@@ -6029,10 +6244,12 @@ export class Store {
             for (const characterId of scope.characterIds) {
                 if (typeof characterId !== "string")
                     throw new AppError(400, "CHARACTER_REQUIRED", "被分析角色标识无效");
-                const character = this.getCharacter(characterId);
-                if (character.workId !== workId)
+                const character = this.db.get("SELECT work_id, name FROM characters WHERE id = ?", characterId);
+                if (!character)
+                    throw notFound("角色");
+                if (requiredString(character, "work_id") !== workId)
                     throw new AppError(400, "CHARACTER_WORK_MISMATCH", "被分析角色不属于当前作品");
-                targetCharacters.push({ id: characterId, name: String(character.name) });
+                targetCharacters.push({ id: characterId, name: requiredString(character, "name") });
             }
             if (targetCharacters.length > 0)
                 scope.targetCharacters = targetCharacters;
@@ -7158,8 +7375,22 @@ export class Store {
     }
     taskScopeSummaryFromMaps(scope, chapterSummaries, volumeTitles, characterNames, includeCharacterNames = true) {
         const targetedSuffix = this.taskTargetedSuffix(scope, characterNames, includeCharacterNames);
+        if (Array.isArray(scope.chapterIds) && scope.chapterIds.length > 0) {
+            const labels = scope.chapterIds
+                .filter((chapterId) => typeof chapterId === "string")
+                .map((chapterId) => chapterSummaries.get(chapterId) ?? "章节已删除");
+            const preview = labels.slice(0, 3).join("、");
+            return `指定章节（${labels.length}）：${preview}${labels.length > 3 ? "……" : ""}${targetedSuffix}`;
+        }
         if (typeof scope.chapterId === "string")
             return `${chapterSummaries.get(scope.chapterId) ?? "章节已删除"}${targetedSuffix}`;
+        if (Array.isArray(scope.volumeIds) && scope.volumeIds.length > 0) {
+            const labels = scope.volumeIds
+                .filter((volumeId) => typeof volumeId === "string")
+                .map((volumeId) => volumeTitles.get(volumeId) ? `分卷 · ${volumeTitles.get(volumeId)}` : "分卷已删除");
+            const preview = labels.slice(0, 3).join("、");
+            return `指定分卷（${labels.length}）：${preview}${labels.length > 3 ? "……" : ""}${targetedSuffix}`;
+        }
         if (scope.type === "volume" && typeof scope.volumeId === "string") {
             const title = volumeTitles.get(scope.volumeId);
             return `${title ? `分卷 · ${title}` : "分卷已删除"}${targetedSuffix}`;
@@ -7178,6 +7409,17 @@ export class Store {
     }
     taskScopeSummary(workId, scope, characterNames, includeCharacterNames = true) {
         const targetedSuffix = this.taskTargetedSuffix(scope, characterNames, includeCharacterNames);
+        if (Array.isArray(scope.chapterIds) && scope.chapterIds.length > 0) {
+            const labels = scope.chapterIds.map((chapterId) => {
+                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 = ? AND chapter.deleted_at IS NULL`, chapterId, workId);
+                return chapter ? `${requiredString(chapter, "volume_title")} · ${requiredString(chapter, "title")}` : "章节已删除";
+            });
+            const preview = labels.slice(0, 3).join("、");
+            return `指定章节（${labels.length}）：${preview}${labels.length > 3 ? "……" : ""}${targetedSuffix}`;
+        }
         if (typeof scope.chapterId === "string") {
             const chapter = this.db.get(`SELECT chapter.title AS title, volume.title AS volume_title
          FROM chapters chapter
@@ -7189,6 +7431,14 @@ export class Store {
             const volumeTitle = requiredString(chapter, "volume_title");
             return `${volumeTitle} · ${title}${targetedSuffix}`;
         }
+        if (Array.isArray(scope.volumeIds) && scope.volumeIds.length > 0) {
+            const labels = scope.volumeIds.map((volumeId) => {
+                const volume = this.db.get("SELECT title FROM volumes WHERE id = ? AND work_id = ?", volumeId, workId);
+                return volume ? `分卷 · ${requiredString(volume, "title")}` : "分卷已删除";
+            });
+            const preview = labels.slice(0, 3).join("、");
+            return `指定分卷（${labels.length}）：${preview}${labels.length > 3 ? "……" : ""}${targetedSuffix}`;
+        }
         if (scope.type === "volume" && typeof scope.volumeId === "string") {
             const volume = this.db.get("SELECT title FROM volumes WHERE id = ? AND work_id = ?", scope.volumeId, workId);
             return `${volume ? `分卷 · ${requiredString(volume, "title")}` : "分卷已删除"}${targetedSuffix}`;
@@ -7296,6 +7546,25 @@ export class Store {
         return snapshotNames;
     }
     taskScopeDetails(workId, scope) {
+        if (Array.isArray(scope.chapterIds) && scope.chapterIds.length > 0) {
+            return scope.chapterIds.map((chapterId) => {
+                const chapter = this.db.get(`SELECT chapter.id AS id, chapter.title AS title, chapter.version_no AS version_no,
+                  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 = ? AND chapter.deleted_at IS NULL`, chapterId, workId);
+                if (!chapter)
+                    return { type: "chapter", chapterId, missing: true };
+                return {
+                    type: "chapter",
+                    chapterId: requiredString(chapter, "id"),
+                    title: requiredString(chapter, "title"),
+                    versionNo: numberValue(chapter, "version_no"),
+                    volumeId: requiredString(chapter, "volume_id"),
+                    volumeTitle: requiredString(chapter, "volume_title")
+                };
+            });
+        }
         if (typeof scope.chapterId === "string") {
             const chapter = this.db.get(`SELECT chapter.id AS id, chapter.title AS title, chapter.version_no AS version_no,
                 volume.id AS volume_id, volume.title AS volume_title
@@ -7313,6 +7582,24 @@ export class Store {
                     volumeTitle: requiredString(chapter, "volume_title")
                 }];
         }
+        if (Array.isArray(scope.volumeIds) && scope.volumeIds.length > 0) {
+            return scope.volumeIds.map((volumeId) => {
+                const volume = this.db.get("SELECT id, title FROM volumes WHERE id = ? AND work_id = ?", volumeId, workId);
+                if (!volume)
+                    return { type: "volume", volumeId, missing: true };
+                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", volumeId);
+                return {
+                    type: "volume",
+                    volumeId: requiredString(volume, "id"),
+                    title: requiredString(volume, "title"),
+                    chapters: chapters.map((item) => ({
+                        chapterId: requiredString(item, "id"),
+                        title: requiredString(item, "title"),
+                        versionNo: numberValue(item, "version_no")
+                    }))
+                };
+            });
+        }
         if (scope.type === "volume" && typeof scope.volumeId === "string") {
             const volume = this.db.get("SELECT id, title FROM volumes WHERE id = ? AND work_id = ?", scope.volumeId, workId);
             if (!volume)