@musnows/scriverse 0.8.5 → 0.8.7

package/dist/store.js

@@ -19,7 +19,7 @@ export const RECYCLE_BIN_RETENTION_DAYS = 30;
 function recycleBinExpiresAt(deletedAt) {
     return new Date(new Date(deletedAt).getTime() + RECYCLE_BIN_RETENTION_DAYS * 24 * 60 * 60_000).toISOString();
 }
-export const attachmentPermissionModules = ["prose", "drafts", "settings", "characters", "races", "organizations"];
+export const attachmentPermissionModules = ["prose", "drafts", "settings", "characters", "races", "organizations", "ai-chat"];
 export const WORK_AGENT_TOOL_IDS = [
     "story_index",
     "read_chapters",
@@ -246,9 +246,13 @@ function parseRestorableFileSnapshot(value, workId) {
         }
         const description = volumeValue.description === undefined ? "" : volumeValue.description;
         const keywords = volumeValue.keywords === undefined ? [] : volumeValue.keywords;
+        const storyOrder = volumeValue.storyOrder === undefined ? volumeValue.sortOrder : volumeValue.storyOrder;
         if (typeof description !== "string" || !Array.isArray(keywords) || !keywords.every((keyword) => typeof keyword === "string")) {
             return invalidFileSnapshot();
         }
+        if (typeof storyOrder !== "number" || !Number.isInteger(storyOrder) || storyOrder < 0 || storyOrder > 1_000_000) {
+            return invalidFileSnapshot();
+        }
         const chapters = volumeValue.chapters.map((chapterValue) => {
             if (!isRecord(chapterValue) || typeof chapterValue.title !== "string" || typeof chapterValue.content !== "string"
                 || typeof chapterValue.sortOrder !== "number" || !Number.isFinite(chapterValue.sortOrder)
@@ -273,6 +277,7 @@ function parseRestorableFileSnapshot(value, workId) {
             description,
             keywords: [...keywords],
             sortOrder: volumeValue.sortOrder,
+            storyOrder,
             chapters
         };
     });
@@ -453,7 +458,8 @@ export class Store {
                 source: entity.source,
                 description: entity.description,
                 keywords: entity.keywords,
-                sortOrder: entity.sortOrder
+                sortOrder: entity.sortOrder,
+                storyOrder: entity.storyOrder
             };
         if (type === "draft")
             return {
@@ -931,7 +937,10 @@ export class Store {
             systemPrompt: String(row?.system_prompt ?? ""),
             dailyTokenQuota: row?.daily_token_quota === null || row?.daily_token_quota === undefined
                 ? null
-                : Math.max(10_000, Number(row.daily_token_quota)),
+                : Math.max(1, Number(row.daily_token_quota)),
+            monthlyTokenQuota: row?.monthly_token_quota === null || row?.monthly_token_quota === undefined
+                ? null
+                : Math.max(1, Number(row.monthly_token_quota)),
             autoRunEnabled: Number(row?.auto_run_enabled ?? 0) === 1,
             autoRunConcurrency: Math.min(8, Math.max(1, Number(row?.auto_run_concurrency ?? 2) || 2)),
             autoRunBatchLimit: Math.min(200, Math.max(1, Number(row?.auto_run_batch_limit ?? 20) || 20)),
@@ -967,6 +976,9 @@ export class Store {
         const nextDailyTokenQuota = input.dailyTokenQuota === undefined
             ? (current.dailyTokenQuota === null ? null : Number(current.dailyTokenQuota))
             : input.dailyTokenQuota;
+        const nextMonthlyTokenQuota = input.monthlyTokenQuota === undefined
+            ? (current.monthlyTokenQuota === null ? null : Number(current.monthlyTokenQuota))
+            : input.monthlyTokenQuota;
         const nextEnabled = input.autoRunEnabled ?? Boolean(current.autoRunEnabled);
         const nextConcurrency = input.autoRunConcurrency ?? Number(current.autoRunConcurrency);
         const nextBatchLimit = input.autoRunBatchLimit ?? Number(current.autoRunBatchLimit);
@@ -986,15 +998,16 @@ export class Store {
             ? (current.titleGenerationModelId ? String(current.titleGenerationModelId) : null)
             : input.titleGenerationModelId?.trim() || null;
         this.db.run(`INSERT INTO work_ai_settings (
-         work_id, system_prompt, daily_token_quota, auto_run_enabled, auto_run_concurrency, auto_run_batch_limit,
+         work_id, system_prompt, daily_token_quota, monthly_token_quota, auto_run_enabled, auto_run_concurrency, auto_run_batch_limit,
          auto_run_daily_task_limit, auto_run_failure_threshold, auto_run_stability_delay_minutes, auto_run_paused, auto_run_pause_reason,
          auto_run_resume_at, auto_run_consecutive_failures, book_summary_context_percent,
          context_compact_threshold, agent_tool_call_limit, agent_tool_call_global_multiplier,
          agent_tools_json, title_generation_model_id, image_tool_model_id, always_include_setting_info, updated_at
-       ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+       ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
        ON CONFLICT(work_id) DO UPDATE SET
          system_prompt = excluded.system_prompt,
          daily_token_quota = excluded.daily_token_quota,
+         monthly_token_quota = excluded.monthly_token_quota,
          auto_run_enabled = excluded.auto_run_enabled,
          auto_run_concurrency = excluded.auto_run_concurrency,
          auto_run_batch_limit = excluded.auto_run_batch_limit,
@@ -1013,10 +1026,11 @@ export class Store {
          title_generation_model_id = excluded.title_generation_model_id,
          image_tool_model_id = excluded.image_tool_model_id,
          always_include_setting_info = excluded.always_include_setting_info,
-         updated_at = excluded.updated_at`, workId, nextPrompt, nextDailyTokenQuota, nextEnabled ? 1 : 0, Math.min(8, Math.max(1, nextConcurrency)), Math.min(200, Math.max(1, nextBatchLimit)), Math.min(10_000, Math.max(0, nextDailyTaskLimit)), Math.min(10, Math.max(1, nextFailureThreshold)), Math.min(120, Math.max(1, nextStabilityDelayMinutes)), current.autoRunPaused ? 1 : 0, String(current.autoRunPauseReason ?? ""), current.autoRunResumeAt === null ? null : String(current.autoRunResumeAt), Math.max(0, Number(current.autoRunConsecutiveFailures) || 0), Math.min(90, Math.max(1, nextBookSummaryContextPercent)), Math.min(90, Math.max(50, nextContextCompactThreshold)), Math.min(maximumAgentToolCallLimit, Math.max(5, nextAgentToolCallLimit)), Math.min(6, Math.max(1, nextAgentToolCallGlobalMultiplier)), JSON.stringify(nextAgentTools), nextTitleGenerationModelId, nextImageToolModelId, nextAlwaysIncludeSettingInfo ? 1 : 0, timestamp);
+         updated_at = excluded.updated_at`, workId, nextPrompt, nextDailyTokenQuota, nextMonthlyTokenQuota, nextEnabled ? 1 : 0, Math.min(8, Math.max(1, nextConcurrency)), Math.min(200, Math.max(1, nextBatchLimit)), Math.min(10_000, Math.max(0, nextDailyTaskLimit)), Math.min(10, Math.max(1, nextFailureThreshold)), Math.min(120, Math.max(1, nextStabilityDelayMinutes)), current.autoRunPaused ? 1 : 0, String(current.autoRunPauseReason ?? ""), current.autoRunResumeAt === null ? null : String(current.autoRunResumeAt), Math.max(0, Number(current.autoRunConsecutiveFailures) || 0), Math.min(90, Math.max(1, nextBookSummaryContextPercent)), Math.min(90, Math.max(50, nextContextCompactThreshold)), Math.min(maximumAgentToolCallLimit, Math.max(5, nextAgentToolCallLimit)), Math.min(6, Math.max(1, nextAgentToolCallGlobalMultiplier)), JSON.stringify(nextAgentTools), nextTitleGenerationModelId, nextImageToolModelId, nextAlwaysIncludeSettingInfo ? 1 : 0, timestamp);
         this.audit(workId, "work.ai-settings.updated", "work-ai-settings", workId, {
             systemPromptChanged: input.systemPrompt !== undefined,
             dailyTokenQuota: nextDailyTokenQuota,
+            monthlyTokenQuota: nextMonthlyTokenQuota,
             autoRunEnabled: nextEnabled,
             autoRunConcurrency: Math.min(8, Math.max(1, nextConcurrency)),
             autoRunBatchLimit: Math.min(200, Math.max(1, nextBatchLimit)),
@@ -1322,18 +1336,43 @@ export class Store {
         const work = this.getWork(workId);
         const permissions = work.modulePermissions;
         if (permissions.prose === "none")
-            return { totalChapters: 0, chapters: [] };
+            return { totalChapters: 0, latestChaptersByStructure: [], 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${authorNoteFilter}`, workId);
-        const chapterRows = this.db.all(`SELECT chapter.id, chapter.title, chapter.version_no, volume.title AS volume_title
+        const chapterRows = this.db.all(`SELECT chapter.id, chapter.title, 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${authorNoteFilter}
-       ORDER BY volume.sort_order, volume.created_at, chapter.sort_order, chapter.created_at
+       ORDER BY volume.story_order, 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"));
+        const latestChapterRows = this.db.all(`SELECT chapter.id, chapter.title, 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 = '正文'
+         AND volume.story_order = (
+           SELECT MAX(candidate_volume.story_order)
+           FROM volumes candidate_volume
+           WHERE candidate_volume.work_id = ? AND candidate_volume.deleted_at IS NULL
+             AND EXISTS (
+               SELECT 1 FROM chapters candidate_volume_chapter
+               WHERE candidate_volume_chapter.volume_id = candidate_volume.id
+                 AND candidate_volume_chapter.deleted_at IS NULL
+                 AND candidate_volume_chapter.chapter_type = '正文'
+             )
+         )
+         AND chapter.sort_order = (
+           SELECT MAX(candidate_chapter.sort_order)
+           FROM chapters candidate_chapter
+           WHERE candidate_chapter.volume_id = chapter.volume_id
+             AND candidate_chapter.deleted_at IS NULL
+             AND candidate_chapter.chapter_type = '正文'
+         )
+       ORDER BY volume.created_at, volume.id, chapter.created_at, chapter.id`, workId, workId);
+        const chapterIds = [...new Set([...chapterRows, ...latestChapterRows].map((row) => requiredString(row, "id")))];
+        const storyOrders = this.getChapterStoryOrders(workId, chapterIds, { includeTimeline: options.includeTimeline });
         const summaries = new Map();
         if (chapterIds.length > 0) {
             const placeholders = chapterIds.map(() => "?").join(", ");
@@ -1352,18 +1391,116 @@ export class Store {
         }
         return {
             totalChapters: numberValue(countRow ?? {}, "count"),
+            latestChaptersByStructure: latestChapterRows.map((row) => {
+                const chapterId = requiredString(row, "id");
+                return {
+                    id: chapterId,
+                    title: requiredString(row, "title"),
+                    versionNo: numberValue(row, "version_no"),
+                    storyOrder: storyOrders.get(chapterId),
+                    summary: summaries.get(chapterId) ?? ""
+                };
+            }),
             chapters: chapterRows.map((row) => {
                 const chapterId = requiredString(row, "id");
                 return {
                     id: chapterId,
-                    volumeTitle: requiredString(row, "volume_title"),
                     title: requiredString(row, "title"),
                     versionNo: numberValue(row, "version_no"),
+                    storyOrder: storyOrders.get(chapterId),
                     summary: summaries.get(chapterId) ?? ""
                 };
             })
         };
     }
+    getChapterStoryOrders(workId, chapterIds, options = {}) {
+        const work = this.getWork(workId);
+        const permissions = work.modulePermissions;
+        if (permissions.prose === "none")
+            return new Map();
+        const includeTimeline = options.includeTimeline === true && permissions.timeline !== "none";
+        const uniqueChapterIds = [...new Set(chapterIds)].slice(0, 500);
+        if (!uniqueChapterIds.length)
+            return new Map();
+        const placeholders = uniqueChapterIds.map(() => "?").join(", ");
+        const rows = this.db.all(`SELECT chapter.id AS chapter_id, chapter.chapter_type, chapter.sort_order AS chapter_order,
+        volume.id AS volume_id, volume.title AS volume_title, volume.sort_order AS volume_directory_order,
+        volume.story_order AS volume_story_order,
+        CASE WHEN chapter.chapter_type = '正文'
+          AND volume.story_order = (
+            SELECT MAX(candidate_volume.story_order)
+            FROM volumes candidate_volume
+            WHERE candidate_volume.work_id = chapter.work_id AND candidate_volume.deleted_at IS NULL
+              AND EXISTS (
+                SELECT 1 FROM chapters candidate_volume_chapter
+                WHERE candidate_volume_chapter.volume_id = candidate_volume.id
+                  AND candidate_volume_chapter.deleted_at IS NULL AND candidate_volume_chapter.chapter_type = '正文'
+              )
+          )
+          AND chapter.sort_order = (
+            SELECT MAX(candidate_chapter.sort_order)
+            FROM chapters candidate_chapter
+            WHERE candidate_chapter.volume_id = chapter.volume_id
+              AND candidate_chapter.deleted_at IS NULL AND candidate_chapter.chapter_type = '正文'
+          )
+        THEN 1 ELSE 0 END AS is_latest_by_structure
+       FROM chapters chapter
+       JOIN volumes volume ON volume.id = chapter.volume_id AND volume.work_id = chapter.work_id
+       WHERE chapter.work_id = ? AND chapter.deleted_at IS NULL AND volume.deleted_at IS NULL
+         AND chapter.id IN (${placeholders})`, workId, ...uniqueChapterIds);
+        const result = new Map();
+        for (const row of rows) {
+            result.set(requiredString(row, "chapter_id"), {
+                volume: {
+                    volumeId: requiredString(row, "volume_id"),
+                    volumeTitle: requiredString(row, "volume_title"),
+                    directoryOrder: numberValue(row, "volume_directory_order"),
+                    storyOrder: numberValue(row, "volume_story_order")
+                },
+                chapter: {
+                    order: numberValue(row, "chapter_order"),
+                    type: requiredString(row, "chapter_type"),
+                    isLatestByStructure: booleanValue(row, "is_latest_by_structure")
+                },
+                ...(includeTimeline ? { confirmedTimelineEvents: [] } : {})
+            });
+        }
+        if (!includeTimeline || result.size === 0)
+            return result;
+        const timelineRows = this.db.all(`SELECT event.id, event.name, event.event_type, event.time_label, event.time_sort,
+        event.track_id, track.name AS track_name, track.sort_order AS track_order, event.chapter_ids_json
+       FROM timeline_events event
+       LEFT JOIN timeline_tracks track ON track.id = event.track_id
+       WHERE event.work_id = ? AND event.status = 'confirmed' AND event.time_sort IS NOT NULL
+         AND typeof(event.time_sort) IN ('integer', 'real') AND json_valid(event.chapter_ids_json)
+         AND EXISTS (
+           SELECT 1 FROM json_each(event.chapter_ids_json) linked_chapter
+           WHERE linked_chapter.value IN (${placeholders})
+         )
+       ORDER BY event.track_id IS NOT NULL, track.sort_order, event.time_sort, event.created_at, event.id`, workId, ...uniqueChapterIds);
+        const requestedIds = new Set(uniqueChapterIds);
+        for (const row of timelineRows) {
+            const timeSort = Number(row.time_sort);
+            if (!Number.isFinite(timeSort))
+                continue;
+            const event = {
+                id: requiredString(row, "id"),
+                name: requiredString(row, "name"),
+                eventType: requiredString(row, "event_type"),
+                timeLabel: requiredString(row, "time_label"),
+                timeSort,
+                trackId: optionalString(row, "track_id"),
+                trackName: optionalString(row, "track_name"),
+                trackOrder: row.track_order === null || row.track_order === undefined ? null : numberValue(row, "track_order")
+            };
+            for (const chapterId of json(requiredString(row, "chapter_ids_json"), [])) {
+                if (!requestedIds.has(chapterId))
+                    continue;
+                result.get(chapterId)?.confirmedTimelineEvents?.push(event);
+            }
+        }
+        return result;
+    }
     listFileVersions(workId) {
         this.getWork(workId);
         return this.db
@@ -1437,7 +1574,8 @@ export class Store {
                     source: volume.source,
                     description: volume.description,
                     keywords: volume.keywords,
-                    sortOrder: volume.sortOrder
+                    sortOrder: volume.sortOrder,
+                    storyOrder: volume.storyOrder
                 }, "restore", fileVersionId, `恢复文件版本 ${fileVersionId}`);
                 for (const chapter of volume.chapters) {
                     this.insertChapter(workId, volumeId, chapter.title, chapter.content, chapter.sortOrder, "restore", fileVersionId, chapter.chapterType);
@@ -1475,6 +1613,7 @@ export class Store {
         this.db.run(`INSERT INTO file_versions (id, work_id, file_name, file_type, word_count, paragraph_count, warnings_json, snapshot_json, created_at, created_by_user_id)
        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, fileVersionId, workId, fileName, fileType, parsed.wordCount, parsed.paragraphCount, JSON.stringify(parsed.warnings), JSON.stringify(snapshot), timestamp, currentRequestActor()?.userId ?? null);
         let volumeOrderOffset = 0;
+        let volumeStoryOrderOffset = 0;
         if (mode === "overwrite") {
             const activeVolumeIds = this.db.all("SELECT id FROM volumes WHERE work_id = ? AND deleted_at IS NULL", workId)
                 .map((row) => requiredString(row, "id"));
@@ -1486,7 +1625,9 @@ export class Store {
         }
         else {
             const lastVolume = this.db.get("SELECT COALESCE(MAX(sort_order), -1) AS value FROM volumes WHERE work_id = ? AND deleted_at IS NULL", workId);
+            const lastStoryVolume = this.db.get("SELECT COALESCE(MAX(story_order), -1) AS value FROM volumes WHERE work_id = ? AND deleted_at IS NULL", workId);
             volumeOrderOffset = numberValue(lastVolume ?? {}, "value") + 1;
+            volumeStoryOrderOffset = numberValue(lastStoryVolume ?? {}, "value") + 1;
         }
         let firstImportedChapterId = null;
         for (const volume of parsed.volumes) {
@@ -1495,7 +1636,8 @@ export class Store {
                 title: volume.title,
                 kind: volume.kind,
                 source: volume.source,
-                sortOrder: volumeOrderOffset + volume.order
+                sortOrder: volumeOrderOffset + volume.order,
+                storyOrder: volumeStoryOrderOffset + volume.order
             }, "import", fileVersionId, "导入分卷");
             for (const chapter of volume.chapters) {
                 const chapterId = this.insertChapter(workId, volumeId, chapter.title, chapter.content, chapter.order, "import", fileVersionId, chapter.chapterType);
@@ -1528,8 +1670,9 @@ export class Store {
         this.getWork(workId);
         const timestamp = now();
         const last = this.db.get("SELECT COALESCE(MAX(sort_order), -1) AS value FROM volumes WHERE work_id = ? AND deleted_at IS NULL", workId);
-        this.db.run(`INSERT INTO volumes (id, work_id, title, kind, source, description, keywords_json, sort_order, version_no, created_at, updated_at)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?)`, volumeId, workId, input.title, input.kind ?? "main", input.source ?? "manual", input.description?.trim() ?? "", JSON.stringify(this.normalizeVolumeKeywords(input.keywords ?? [])), input.sortOrder ?? numberValue(last ?? {}, "value") + 1, timestamp, timestamp);
+        const lastStory = this.db.get("SELECT COALESCE(MAX(story_order), -1) AS value FROM volumes WHERE work_id = ? AND deleted_at IS NULL", workId);
+        this.db.run(`INSERT INTO volumes (id, work_id, title, kind, source, description, keywords_json, sort_order, story_order, version_no, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?)`, volumeId, workId, input.title, input.kind ?? "main", input.source ?? "manual", input.description?.trim() ?? "", JSON.stringify(this.normalizeVolumeKeywords(input.keywords ?? [])), input.sortOrder ?? numberValue(last ?? {}, "value") + 1, input.storyOrder ?? numberValue(lastStory ?? {}, "value") + 1, timestamp, timestamp);
         const versionNo = this.recordEntityVersion("volume", volumeId, source, sourceRef, changeNote || "建立分卷", timestamp);
         if (versionNo !== 1)
             this.db.run("UPDATE volumes SET version_no = ? WHERE id = ?", versionNo, volumeId);
@@ -1548,7 +1691,7 @@ export class Store {
             const current = this.getVolume(volumeId);
             this.assertExpectedVersion("volume", volumeId, expectedVersionNo, "分卷", Number(current.versionNo));
             const timestamp = now();
-            this.db.run("UPDATE volumes SET title = ?, kind = ?, description = ?, keywords_json = ?, sort_order = ?, source = ?, version_no = version_no + 1, updated_at = ? WHERE id = ?", input.title ?? String(current.title), input.kind ?? String(current.kind), input.description?.trim() ?? String(current.description), JSON.stringify(input.keywords === undefined ? current.keywords : this.normalizeVolumeKeywords(input.keywords)), input.sortOrder ?? Number(current.sortOrder), source === "restore" ? String(current.source) : "manual", timestamp, volumeId);
+            this.db.run("UPDATE volumes SET title = ?, kind = ?, description = ?, keywords_json = ?, sort_order = ?, story_order = ?, source = ?, version_no = version_no + 1, updated_at = ? WHERE id = ?", input.title ?? String(current.title), input.kind ?? String(current.kind), input.description?.trim() ?? String(current.description), JSON.stringify(input.keywords === undefined ? current.keywords : this.normalizeVolumeKeywords(input.keywords)), input.sortOrder ?? Number(current.sortOrder), input.storyOrder ?? Number(current.storyOrder), source === "restore" ? String(current.source) : "manual", timestamp, volumeId);
             this.recordEntityVersion("volume", volumeId, source, sourceRef, changeNote || "更新分卷信息", timestamp);
             this.audit(String(current.workId), "volume.updated", "volume", volumeId, { ...input, versionNo: Number(current.versionNo) + 1, source, sourceRef, changeNote });
         });
@@ -2550,33 +2693,185 @@ 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);
     }
+    chapterParagraphSearchPlan(workId, normalizedKeyword, options) {
+        const shortKeyword = [...normalizedKeyword].length < 3;
+        const scopedChapterIds = options.chapterIds
+            ? [...new Set(options.chapterIds.filter(Boolean))].slice(0, 10_000)
+            : null;
+        const scopeFilter = scopedChapterIds
+            ? " AND chapter.id IN (SELECT CAST(value AS TEXT) FROM json_each(?))"
+            : "";
+        const authorNoteFilter = options.excludeAuthorNotes ? " AND chapter.chapter_type <> '作者的话'" : "";
+        return {
+            joinSql: shortKeyword
+                ? "JOIN chapter_paragraph_short_terms term ON term.paragraph_id = paragraph.id"
+                : "JOIN chapter_paragraph_search_fts fts ON fts.rowid = paragraph.id",
+            whereSql: `paragraph.work_id = ? AND chapter.deleted_at IS NULL AND volume.deleted_at IS NULL${authorNoteFilter}${scopeFilter}
+        AND ${shortKeyword ? "term.term = ?" : "chapter_paragraph_search_fts MATCH ?"}`,
+            params: [
+                workId,
+                ...(scopedChapterIds ? [JSON.stringify(scopedChapterIds)] : []),
+                shortKeyword ? normalizedKeyword : `"${normalizedKeyword.replaceAll('"', '""')}"`
+            ]
+        };
+    }
+    mapChapterParagraphMatches(workId, rows, options) {
+        const chapterIds = rows.map((row) => requiredString(row, "chapter_id"));
+        const storyOrders = options.includeStoryOrder
+            ? this.getChapterStoryOrders(workId, chapterIds, { includeTimeline: options.includeTimeline })
+            : new Map();
+        return rows.map((row) => {
+            const chapterId = requiredString(row, "chapter_id");
+            const storyOrder = storyOrders.get(chapterId);
+            return {
+                chapterId,
+                chapterTitle: requiredString(row, "chapter_title"),
+                paragraph: requiredString(row, "content"),
+                ...(options.includeParagraphOrder ? { paragraphOrder: numberValue(row, "paragraph_order") } : {}),
+                ...(storyOrder ? { storyOrder } : {})
+            };
+        });
+    }
     searchChapterParagraphs(workId, keyword, limit = 20, options = {}) {
-        this.getWork(workId);
+        const work = this.getWork(workId);
+        if (work.modulePermissions.prose === "none")
+            return [];
         const normalizedKeyword = normalizeDocumentSearchText(keyword.trim());
         if (!normalizedKeyword)
             return [];
+        if (options.chapterIds && options.chapterIds.length === 0)
+            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
+        const search = this.chapterParagraphSearchPlan(workId, normalizedKeyword, options);
+        const columns = `SELECT paragraph.chapter_id, chapter.title AS chapter_title, paragraph.content, paragraph.paragraph_order
       FROM chapter_paragraph_search paragraph
       JOIN chapters chapter ON chapter.id = paragraph.chapter_id
-      JOIN volumes volume ON volume.id = chapter.volume_id`;
-        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${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${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) => ({
-            chapterId: requiredString(row, "chapter_id"),
-            chapterTitle: requiredString(row, "chapter_title"),
-            paragraph: requiredString(row, "content")
-        }));
+      JOIN volumes volume ON volume.id = chapter.volume_id
+      ${search.joinSql}`;
+        const orderSql = options.order === "story_desc"
+            ? "volume.story_order DESC, chapter.sort_order DESC, paragraph.paragraph_order DESC, volume.id, chapter.id, paragraph.id"
+            : options.order === "story_asc"
+                ? "volume.story_order, chapter.sort_order, paragraph.paragraph_order, volume.id, chapter.id, paragraph.id"
+                : "volume.sort_order, chapter.sort_order, paragraph.paragraph_order, volume.id, chapter.id, paragraph.id";
+        const rows = this.db.all(`${columns}
+       WHERE ${search.whereSql}
+       ORDER BY ${orderSql}
+       LIMIT ?`, ...search.params, safeLimit);
+        return this.mapChapterParagraphMatches(workId, rows, {
+            includeStoryOrder: options.includeStoryOrder,
+            includeTimeline: options.includeTimeline,
+            includeParagraphOrder: options.includeStoryOrder
+        });
+    }
+    searchLatestChapterParagraphsByStructure(workId, keyword, options = {}) {
+        const work = this.getWork(workId);
+        if (work.modulePermissions.prose === "none")
+            return [];
+        const normalizedKeyword = normalizeDocumentSearchText(keyword.trim());
+        if (!normalizedKeyword || (options.chapterIds && options.chapterIds.length === 0))
+            return [];
+        const search = this.chapterParagraphSearchPlan(workId, normalizedKeyword, options);
+        const rows = this.db.all(`WITH matched_paragraphs AS (
+         SELECT DISTINCT paragraph.id AS paragraph_id, paragraph.chapter_id, chapter.title AS chapter_title,
+           paragraph.content, paragraph.paragraph_order, chapter.sort_order AS chapter_order,
+           volume.id AS volume_id, volume.story_order AS volume_story_order
+         FROM chapter_paragraph_search paragraph
+         JOIN chapters chapter ON chapter.id = paragraph.chapter_id
+         JOIN volumes volume ON volume.id = chapter.volume_id
+         ${search.joinSql}
+         WHERE ${search.whereSql}
+       ), latest_story_order AS (
+         SELECT MAX(volume_story_order) AS value FROM matched_paragraphs
+       ), ranked_paragraphs AS (
+         SELECT matched_paragraphs.*,
+           DENSE_RANK() OVER (
+             PARTITION BY volume_id
+             ORDER BY chapter_order DESC, paragraph_order DESC
+           ) AS occurrence_rank
+         FROM matched_paragraphs
+         JOIN latest_story_order ON matched_paragraphs.volume_story_order = latest_story_order.value
+       )
+       SELECT chapter_id, chapter_title, content, paragraph_order
+       FROM ranked_paragraphs
+       WHERE occurrence_rank = 1
+       ORDER BY volume_id, chapter_id, paragraph_id`, ...search.params);
+        return this.mapChapterParagraphMatches(workId, rows, {
+            includeStoryOrder: true,
+            includeTimeline: options.includeTimeline,
+            includeParagraphOrder: true
+        });
+    }
+    searchLatestChapterParagraphsByTimelineTrack(workId, keyword, options = {}) {
+        const work = this.getWork(workId);
+        const permissions = work.modulePermissions;
+        if (permissions.prose === "none" || permissions.timeline === "none")
+            return [];
+        const normalizedKeyword = normalizeDocumentSearchText(keyword.trim());
+        if (!normalizedKeyword || (options.chapterIds && options.chapterIds.length === 0))
+            return [];
+        const search = this.chapterParagraphSearchPlan(workId, normalizedKeyword, options);
+        const rows = this.db.all(`WITH matched_paragraphs AS (
+         SELECT DISTINCT paragraph.id AS paragraph_id, paragraph.chapter_id, chapter.title AS chapter_title,
+           paragraph.content, paragraph.paragraph_order, chapter.sort_order AS chapter_order,
+           volume.story_order AS volume_story_order
+         FROM chapter_paragraph_search paragraph
+         JOIN chapters chapter ON chapter.id = paragraph.chapter_id
+         JOIN volumes volume ON volume.id = chapter.volume_id
+         ${search.joinSql}
+         WHERE ${search.whereSql}
+       ), ranked_links AS (
+         SELECT matched_paragraphs.*, event.id AS event_id, event.name AS event_name,
+           event.event_type, event.time_label, event.time_sort, event.track_id,
+           track.name AS track_name, track.sort_order AS track_order,
+           ROW_NUMBER() OVER (
+             PARTITION BY event.track_id
+             ORDER BY event.time_sort DESC, matched_paragraphs.volume_story_order DESC,
+               matched_paragraphs.chapter_order DESC, matched_paragraphs.paragraph_order DESC,
+               event.id, matched_paragraphs.paragraph_id
+           ) AS track_rank,
+           COUNT(*) OVER (PARTITION BY event.track_id, event.time_sort) AS matching_links_at_time
+         FROM matched_paragraphs
+         JOIN timeline_events event ON event.work_id = ?
+           AND event.status = 'confirmed' AND event.time_sort IS NOT NULL
+           AND typeof(event.time_sort) IN ('integer', 'real')
+           AND event.time_sort BETWEEN -1.0e308 AND 1.0e308
+           AND json_valid(event.chapter_ids_json)
+         JOIN json_each(event.chapter_ids_json) linked_chapter
+           ON CAST(linked_chapter.value AS TEXT) = matched_paragraphs.chapter_id
+         LEFT JOIN timeline_tracks track ON track.id = event.track_id AND track.work_id = event.work_id
+       )
+       SELECT chapter_id, chapter_title, content, paragraph_order,
+         event_id, event_name, event_type, time_label, time_sort,
+         track_id, track_name, track_order, matching_links_at_time
+       FROM ranked_links
+       WHERE track_rank = 1
+       ORDER BY track_order IS NULL, track_order, track_id
+       LIMIT 100`, ...search.params, workId);
+        const occurrences = this.mapChapterParagraphMatches(workId, rows, {
+            includeStoryOrder: true,
+            includeTimeline: false,
+            includeParagraphOrder: true
+        });
+        return rows.flatMap((row, index) => {
+            const timeSort = Number(row.time_sort);
+            const occurrence = occurrences[index];
+            if (!occurrence || !Number.isFinite(timeSort))
+                return [];
+            return [{
+                    trackId: optionalString(row, "track_id"),
+                    trackName: optionalString(row, "track_name"),
+                    trackOrder: row.track_order === null || row.track_order === undefined ? null : numberValue(row, "track_order"),
+                    timeSort,
+                    timeLabel: requiredString(row, "time_label"),
+                    timelineEvent: {
+                        id: requiredString(row, "event_id"),
+                        name: requiredString(row, "event_name"),
+                        eventType: requiredString(row, "event_type")
+                    },
+                    occurrence,
+                    matchingLinksAtLatestTime: numberValue(row, "matching_links_at_time")
+                }];
+        });
     }
     invalidateChapter(workId, chapterId, versionNo) {
         this.db.run(`UPDATE analysis_tasks SET status = 'expired', updated_at = ?
@@ -2680,6 +2975,7 @@ export class Store {
             description: optionalString(row, "description") ?? "",
             keywords: json(optionalString(row, "keywords_json"), []),
             sortOrder: numberValue(row, "sort_order"),
+            storyOrder: numberValue(row, "story_order"),
             versionNo: numberValue(row, "version_no") || this.currentEntityVersionNo("volume", requiredString(row, "id")),
             createdAt: requiredString(row, "created_at"),
             updatedAt: requiredString(row, "updated_at")
@@ -4482,6 +4778,48 @@ export class Store {
             throw notFound("附件");
         return this.mapAttachment(row);
     }
+    getAttachmentDownloadContextName(attachmentId) {
+        const reference = this.db.get(`SELECT CASE reference.entity_type
+         WHEN 'setting' THEN (SELECT title FROM settings WHERE id = reference.entity_id AND work_id = reference.work_id)
+         WHEN 'character-section' THEN (
+           SELECT character.name
+           FROM character_profile_sections section
+           JOIN characters character ON character.id = section.character_id
+           WHERE section.id = reference.entity_id AND section.work_id = reference.work_id
+         )
+         WHEN 'race' THEN (SELECT name FROM races WHERE id = reference.entity_id AND work_id = reference.work_id)
+         WHEN 'organization' THEN (SELECT name FROM organizations WHERE id = reference.entity_id AND work_id = reference.work_id)
+         WHEN 'chapter' THEN (SELECT title FROM chapters WHERE id = reference.entity_id AND work_id = reference.work_id)
+         WHEN 'draft' THEN (SELECT title FROM drafts WHERE id = reference.entity_id AND work_id = reference.work_id)
+         ELSE NULL
+       END AS context_name
+       FROM attachment_references reference
+       WHERE reference.attachment_id = ?
+       ORDER BY CASE reference.entity_type
+         WHEN 'setting' THEN 0
+         WHEN 'character-section' THEN 1
+         WHEN 'race' THEN 2
+         WHEN 'organization' THEN 3
+         WHEN 'chapter' THEN 4
+         WHEN 'draft' THEN 5
+         ELSE 6
+       END, reference.created_at DESC, reference.entity_id
+       LIMIT 1`, attachmentId);
+        const contextName = optionalString(reference ?? {}, "context_name")?.trim();
+        if (contextName)
+            return contextName;
+        const access = this.db.get("SELECT module FROM attachment_access_modules WHERE attachment_id = ? ORDER BY module LIMIT 1", attachmentId);
+        const moduleLabels = {
+            settings: "设定库",
+            characters: "角色",
+            races: "种族",
+            organizations: "组织",
+            drafts: "想法",
+            prose: "正文",
+            "ai-chat": "AI对话"
+        };
+        return moduleLabels[String(access?.module ?? "")] ?? null;
+    }
     getSettingAttachment(workId, attachmentId) {
         const row = this.db.get(`SELECT attachment.*
        FROM attachments attachment
@@ -4566,7 +4904,9 @@ export class Store {
             ["chapter_versions", "content"],
             ["file_versions", "snapshot_json"]
         ];
-        return sources.reduce((count, [table, column]) => count + Number(this.db.get(`SELECT COUNT(*) AS count FROM ${table} WHERE instr(${column}, ?) > 0`, needle)?.count ?? 0), 0);
+        const historicalCount = sources.reduce((count, [table, column]) => count + Number(this.db.get(`SELECT COUNT(*) AS count FROM ${table} WHERE instr(${column}, ?) > 0`, needle)?.count ?? 0), 0);
+        const conversationCount = Number(this.db.get("SELECT COUNT(*) AS count FROM ai_conversation_messages WHERE instr(metadata_json, ?) > 0", attachmentId)?.count ?? 0);
+        return historicalCount + conversationCount;
     }
     queueUnreferencedAttachments(retentionMs = 24 * 60 * 60_000, limit = 100) {
         const cutoff = new Date(Date.now() - Math.max(0, retentionMs)).toISOString();
@@ -4615,6 +4955,69 @@ export class Store {
             throw notFound("角色");
         return this.mapCharacter(row);
     }
+    getCharacterAvatar(characterId) {
+        const character = this.db.get("SELECT id FROM characters WHERE id = ?", characterId);
+        if (!character)
+            throw notFound("角色");
+        const row = this.db.get("SELECT * FROM character_avatars WHERE character_id = ?", characterId);
+        if (!row)
+            return null;
+        return {
+            mimeType: requiredString(row, "mime_type"),
+            byteLength: numberValue(row, "byte_length"),
+            sha256: requiredString(row, "sha256"),
+            storageKey: requiredString(row, "storage_key"),
+            width: numberValue(row, "width"),
+            height: numberValue(row, "height"),
+            updatedAt: requiredString(row, "updated_at")
+        };
+    }
+    setCharacterAvatar(characterId, input) {
+        const character = this.db.get("SELECT work_id, merged_into_character_id FROM characters WHERE id = ?", characterId);
+        if (!character)
+            throw notFound("角色");
+        if (character.merged_into_character_id)
+            throw new AppError(409, "CHARACTER_ALREADY_MERGED", "已合并角色不能直接设置头像");
+        const previous = this.db.get("SELECT storage_key FROM character_avatars WHERE character_id = ?", characterId);
+        const previousStorageKey = optionalString(previous ?? {}, "storage_key");
+        const timestamp = now();
+        this.db.transaction(() => {
+            this.db.run(`INSERT INTO character_avatars (character_id, mime_type, byte_length, sha256, storage_key, width, height, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+         ON CONFLICT(character_id) DO UPDATE SET mime_type = excluded.mime_type, byte_length = excluded.byte_length,
+         sha256 = excluded.sha256, storage_key = excluded.storage_key, width = excluded.width,
+         height = excluded.height, updated_at = excluded.updated_at`, characterId, input.mimeType, input.byteLength, input.sha256, input.storageKey, input.width, input.height, timestamp);
+            this.audit(character.work_id, "character.avatar-updated", "character", characterId, {
+                mimeType: input.mimeType,
+                byteLength: input.byteLength,
+                width: input.width,
+                height: input.height
+            });
+        });
+        return { character: this.getCharacter(characterId), previousStorageKey };
+    }
+    deleteCharacterAvatar(characterId) {
+        const character = this.db.get("SELECT work_id FROM characters WHERE id = ?", characterId);
+        if (!character)
+            throw notFound("角色");
+        const current = this.db.get("SELECT storage_key FROM character_avatars WHERE character_id = ?", characterId);
+        const storageKey = optionalString(current ?? {}, "storage_key");
+        if (storageKey) {
+            this.db.transaction(() => {
+                this.db.run("DELETE FROM character_avatars WHERE character_id = ?", characterId);
+                this.audit(character.work_id, "character.avatar-deleted", "character", characterId);
+            });
+        }
+        return { character: this.getCharacter(characterId), storageKey };
+    }
+    listCharacterAvatarStorageKeysForWork(workId) {
+        return this.db.all(`SELECT avatar.storage_key FROM character_avatars avatar
+       JOIN characters character ON character.id = avatar.character_id
+       WHERE character.work_id = ?`, workId).map((row) => requiredString(row, "storage_key"));
+    }
+    characterAvatarStorageKeyInUse(storageKey) {
+        return Number(this.db.get("SELECT COUNT(*) AS count FROM character_avatars WHERE storage_key = ?", storageKey)?.count ?? 0) > 0;
+    }
     updateCharacter(characterId, input, source = "manual", sourceRef = null, changeNote = "", expectedVersionNo) {
         const current = this.getCharacter(characterId);
         this.assertExpectedRevision("character", characterId, expectedVersionNo, "人物", Number(current.versionNo));
@@ -4801,6 +5204,8 @@ export class Store {
                 versionNo: section.versionNo
             }));
         }
+        const avatar = this.db.get("SELECT sha256 FROM character_avatars WHERE character_id = ?", characterId);
+        const avatarSha256 = optionalString(avatar ?? {}, "sha256");
         return {
             id: characterId,
             workId: requiredString(row, "work_id"),
@@ -4824,6 +5229,9 @@ export class Store {
             profileSectionCount,
             currentState: json(requiredString(row, "current_state_json"), {}),
             isDead: booleanValue(row, "is_dead"),
+            avatarUrl: avatarSha256
+                ? `/api/characters/${encodeURIComponent(characterId)}/avatar?v=${encodeURIComponent(avatarSha256)}`
+                : null,
             lockedFields: json(requiredString(row, "locked_fields_json"), []),
             firstChapterId: optionalString(row, "first_chapter_id"),
             mergedIntoCharacterId: optionalString(row, "merged_into_character_id"),
@@ -5473,17 +5881,18 @@ export class Store {
         });
         return this.getAiConversation(conversationId);
     }
-    listAiConversations(workId) {
+    listAiConversations(workId, userId) {
         this.getWork(workId);
         return this.db.all(`SELECT conversation.*,
         (SELECT COUNT(*) FROM ai_conversation_messages message WHERE message.conversation_id = conversation.id) AS message_count,
         COALESCE((SELECT content FROM ai_conversation_messages message WHERE message.conversation_id = conversation.id ORDER BY message.created_at DESC, message.rowid DESC LIMIT 1), '') AS preview
        FROM ai_conversations conversation
        WHERE conversation.work_id = ?
+         AND (? IS NULL OR conversation.created_by_user_id = ?)
        ORDER BY conversation.is_favorite DESC, conversation.updated_at DESC, conversation.created_at DESC
-       LIMIT 100`, workId).map((row) => this.mapAiConversation(row));
+       LIMIT 100`, workId, userId ?? null, userId ?? null).map((row) => this.mapAiConversation(row));
     }
-    listAiConversationsPage(workId, pagination) {
+    listAiConversationsPage(workId, pagination, userId) {
         this.getWork(workId);
         const page = paginationSql(pagination);
         const rows = this.db.all(`SELECT conversation.*,
@@ -5491,9 +5900,77 @@ export class Store {
         COALESCE((SELECT content FROM ai_conversation_messages message WHERE message.conversation_id = conversation.id ORDER BY message.created_at DESC, message.rowid DESC LIMIT 1), '') AS preview
        FROM ai_conversations conversation
        WHERE conversation.work_id = ?
-       ORDER BY conversation.is_favorite DESC, conversation.updated_at DESC, conversation.created_at DESC${page.sql}`, workId, ...page.params);
+         AND (? IS NULL OR conversation.created_by_user_id = ?)
+       ORDER BY conversation.is_favorite DESC, conversation.updated_at DESC, conversation.created_at DESC${page.sql}`, workId, userId ?? null, userId ?? null, ...page.params);
         return paginated(rows.map((row) => this.mapAiConversation(row)), pagination);
     }
+    assertAiConversationOwner(conversationId, userId) {
+        const conversation = this.db.get("SELECT created_by_user_id FROM ai_conversations WHERE id = ?", conversationId);
+        if (!conversation)
+            throw notFound("AI 对话");
+        if (optionalString(conversation, "created_by_user_id") !== userId) {
+            throw new AppError(403, "AI_CONVERSATION_ACCESS_DENIED", "你只能访问自己创建的 AI 对话");
+        }
+    }
+    listAdminAiConversationsPage(pagination, filters = {}) {
+        const where = [];
+        const params = [];
+        if (filters.workId) {
+            where.push("conversation.work_id = ?");
+            params.push(filters.workId);
+        }
+        if (filters.userId) {
+            where.push("conversation.created_by_user_id = ?");
+            params.push(filters.userId);
+        }
+        const normalizedQuery = filters.query?.normalize("NFKC").trim() ?? "";
+        if (normalizedQuery) {
+            const pattern = `%${escapeSqlLikePattern(normalizedQuery)}%`;
+            where.push(`(
+        conversation.title LIKE ? ESCAPE '\\' COLLATE NOCASE
+        OR work.title LIKE ? ESCAPE '\\' COLLATE NOCASE
+        OR creator.username LIKE ? ESCAPE '\\' COLLATE NOCASE
+        OR creator.display_name LIKE ? ESCAPE '\\' COLLATE NOCASE
+        OR EXISTS (
+          SELECT 1 FROM ai_conversation_messages searched_message
+          WHERE searched_message.conversation_id = conversation.id
+            AND searched_message.content LIKE ? ESCAPE '\\' COLLATE NOCASE
+        )
+      )`);
+            params.push(pattern, pattern, pattern, pattern, pattern);
+        }
+        const whereSql = where.length > 0 ? `WHERE ${where.join(" AND ")}` : "";
+        const page = paginationSql(pagination);
+        const rows = this.db.all(`SELECT conversation.*,
+        work.title AS work_title,
+        work.deleted_at AS work_deleted_at,
+        creator.username AS creator_username,
+        creator.display_name AS creator_display_name,
+        creator.role AS creator_role,
+        creator.status AS creator_status,
+        (SELECT COUNT(*) FROM ai_conversation_messages message WHERE message.conversation_id = conversation.id) AS message_count,
+        COALESCE((SELECT content FROM ai_conversation_messages message WHERE message.conversation_id = conversation.id ORDER BY message.created_at DESC, message.rowid DESC LIMIT 1), '') AS preview
+       FROM ai_conversations conversation
+       JOIN works work ON work.id = conversation.work_id
+       LEFT JOIN users creator ON creator.id = conversation.created_by_user_id
+       ${whereSql}
+       ORDER BY conversation.updated_at DESC, conversation.created_at DESC${page.sql}`, ...params, ...page.params);
+        return paginated(rows.map((row) => ({
+            ...this.mapAiConversation(row),
+            work: {
+                id: requiredString(row, "work_id"),
+                title: requiredString(row, "work_title"),
+                deleted: Boolean(optionalString(row, "work_deleted_at"))
+            },
+            creator: optionalString(row, "created_by_user_id") ? {
+                userId: requiredString(row, "created_by_user_id"),
+                username: requiredString(row, "creator_username"),
+                displayName: requiredString(row, "creator_display_name"),
+                role: requiredString(row, "creator_role"),
+                status: requiredString(row, "creator_status")
+            } : null
+        })), pagination);
+    }
     getAiConversationSummary(conversationId) {
         const row = this.db.get(`SELECT conversation.*,
         (SELECT COUNT(*) FROM ai_conversation_messages message WHERE message.conversation_id = conversation.id) AS message_count,
@@ -5593,6 +6070,14 @@ export class Store {
             throw new AppError(400, "CONVERSATION_WORK_MISMATCH", "AI 对话不属于当前作品");
         return this.aiConversationLockedModelId(conversationId);
     }
+    getAiConversationHasImageAttachments(conversationId, workId) {
+        const conversation = this.db.get("SELECT work_id FROM ai_conversations WHERE id = ?", conversationId);
+        if (!conversation)
+            throw notFound("AI 对话");
+        if (requiredString(conversation, "work_id") !== workId)
+            throw new AppError(400, "CONVERSATION_WORK_MISMATCH", "AI 对话不属于当前作品");
+        return this.aiConversationHasImageAttachments(conversationId);
+    }
     aiConversationLockedModelId(conversationId) {
         const messages = this.db.all(`SELECT metadata_json FROM ai_conversation_messages
        WHERE conversation_id = ? AND role = 'user'
@@ -5604,6 +6089,16 @@ export class Store {
         }
         return null;
     }
+    aiConversationHasImageAttachments(conversationId) {
+        const messages = this.db.all(`SELECT metadata_json FROM ai_conversation_messages
+       WHERE conversation_id = ? AND role = 'user'
+       ORDER BY created_at, rowid`, conversationId);
+        return messages.some((message) => {
+            const metadata = json(requiredString(message, "metadata_json"), {});
+            return Array.isArray(metadata.chatImageAttachmentIds)
+                && metadata.chatImageAttachmentIds.some((attachmentId) => typeof attachmentId === "string" && attachmentId.trim().length > 0);
+        });
+    }
     getAiConversationInjectedEntities(conversationId, workId) {
         const conversation = this.db.get("SELECT work_id, injected_entities_json FROM ai_conversations WHERE id = ?", conversationId);
         if (!conversation)
@@ -6073,6 +6568,8 @@ export class Store {
         const timestamp = now();
         const workId = requiredString(conversation, "work_id");
         const sourceTitle = requiredString(conversation, "title");
+        const sourceHasImageAttachments = this.aiConversationHasImageAttachments(conversationId);
+        const sourceLockedModelId = sourceHasImageAttachments ? this.aiConversationLockedModelId(conversationId) : null;
         const title = requestedTitle?.trim() || `${sourceTitle} · 分支`;
         const sourceCompactedCount = Math.max(0, numberValue(conversation, "compacted_message_count"));
         const forkCompactedCount = targetIndex + 1 >= sourceCompactedCount ? Math.min(sourceCompactedCount, targetIndex + 1) : 0;
@@ -6087,8 +6584,14 @@ export class Store {
             for (const message of messages.slice(0, targetIndex + 1)) {
                 const role = requiredString(message, "role");
                 const inheritedMetadata = json(requiredString(message, "metadata_json"), {});
-                if (role === "user")
-                    delete inheritedMetadata.modelId;
+                if (role === "user") {
+                    if (sourceHasImageAttachments && sourceLockedModelId && typeof inheritedMetadata.modelId !== "string") {
+                        inheritedMetadata.modelId = sourceLockedModelId;
+                    }
+                    else if (!sourceHasImageAttachments) {
+                        delete inheritedMetadata.modelId;
+                    }
+                }
                 this.db.run("INSERT INTO ai_conversation_messages (id, conversation_id, role, content, citations_json, metadata_json, request_id, created_at, created_by_user_id) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)", id("message"), forkId, role, requiredString(message, "content"), requiredString(message, "citations_json"), JSON.stringify(inheritedMetadata), optionalString(message, "request_id"), requiredString(message, "created_at"), currentRequestActor()?.userId ?? null);
             }
             if (normalizedRequestId) {
@@ -6129,7 +6632,9 @@ export class Store {
     mapAiConversation(row) {
         const roleplayCharacterId = optionalString(row, "roleplay_character_id");
         const roleplayUserCharacterId = optionalString(row, "roleplay_user_character_id");
-        const lockedModelId = this.aiConversationLockedModelId(requiredString(row, "id"));
+        const conversationId = requiredString(row, "id");
+        const lockedModelId = this.aiConversationLockedModelId(conversationId);
+        const hasImageAttachments = this.aiConversationHasImageAttachments(conversationId);
         const roleplayCharacter = roleplayCharacterId
             ? this.db.get("SELECT id, name, code FROM characters WHERE id = ? AND work_id = ?", roleplayCharacterId, requiredString(row, "work_id"))
             : undefined;
@@ -6148,6 +6653,7 @@ export class Store {
             contextWarningPending: Boolean(optionalString(row, "context_warning_at")),
             taskType: optionalString(row, "task_type") ?? (roleplayCharacterId ? "roleplay" : "chat"),
             ...(lockedModelId ? { modelId: lockedModelId } : {}),
+            ...(hasImageAttachments ? { hasImageAttachments: true, modelLockedByImage: true } : {}),
             contextScope: json(optionalString(row, "context_scope_json") ?? "", { type: "none" }),
             roleplayCharacter: roleplayCharacter ? {
                 id: requiredString(roleplayCharacter, "id"),