@musnows/scriverse 0.5.1 → 0.5.3

package/dist/ai.js

@@ -4,6 +4,7 @@ import { logger, sanitizeError } from "./logger.js";
 import { paginated, paginationSql } from "./pagination.js";
 import { currentRequestActor } from "./request-context.js";
 import { fetchSafeAiEndpoint } from "./security.js";
+import { RELATIONSHIP_SEARCH_POLICY_VERSION, RelationshipApproximateMatchLimitError, findApproximateNameMatchesChunked, ftsPhrase, normalizeRelationshipSearchText, relationshipCharacterTokenText, relationshipCharacterTokens, relationshipPinyinTokenText, relationshipPinyinTokens } from "./relationship-search.js";
 import { clamp, id, json, maskSecret, normalizeBaseUrl, now } from "./utils.js";
 import { z } from "zod";
 export function aiErrorForLog(error) {
@@ -19,6 +20,11 @@ export function aiErrorForLog(error) {
 const allowedParameters = new Set(["temperature", "top_p", "max_tokens", "presence_penalty", "frequency_penalty", "seed"]);
 const DEFAULT_MAX_TOKENS = 32_000;
 const DEFAULT_CONTEXT_WINDOW = 128_000;
+const RELATIONSHIP_MAX_FUZZY_REFERENCES = 32;
+const RELATIONSHIP_MAX_FUZZY_SOURCES = 200;
+const RELATIONSHIP_MAX_FUZZY_SCAN_CHARACTERS = 4_000_000;
+const RELATIONSHIP_MAX_FUZZY_MATCHES = 600;
+const RELATIONSHIP_MAX_SOURCE_MATCHES = 256;
 function isGeminiProviderOrModel(provider, model) {
     const endpoint = stringValue(provider, "base_url").toLowerCase();
     const modelId = stringValue(model, "model_id").toLowerCase();
@@ -33,65 +39,44 @@ function thinkingParameters(provider, model) {
     return { thinking: { type: boolValue(model, "thinking_enabled") ? "enabled" : "disabled" } };
 }
 const AGENT_TOOL_IDS = ["story_index", "read_chapters", "grep", "search_story_entities", "read_character_sections"];
-const TASK_TRACE_PREVIEW_CHARACTER_LIMIT = 3_000;
 function traceRecord(value) {
     return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
-function previewTaskTraceMessages(messages) {
-    const records = messages.map(traceRecord);
-    const contents = records.map((message) => message.content === null ? "" : String(message.content ?? ""));
-    const allocations = contents.map(() => 0);
-    let remaining = TASK_TRACE_PREVIEW_CHARACTER_LIMIT;
-    let active = contents.map((_, index) => index).filter((index) => contents[index].length > 0);
-    while (remaining > 0 && active.length > 0) {
-        const share = Math.max(1, Math.floor(remaining / active.length));
-        const next = [];
-        for (const index of active) {
-            if (remaining <= 0)
-                break;
-            const available = contents[index].length - allocations[index];
-            const granted = Math.min(available, share, remaining);
-            allocations[index] = allocations[index] + granted;
-            remaining -= granted;
-            if (allocations[index] < contents[index].length)
-                next.push(index);
+function taskTraceSourceRefs(initialMessages, rounds) {
+    const refs = [];
+    const seen = new Set();
+    const add = (type, title) => {
+        const normalizedTitle = title.trim();
+        if (!normalizedTitle)
+            return;
+        const key = `${type}|${normalizedTitle}`;
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        refs.push({ type, title: normalizedTitle });
+    };
+    const roundMessages = rounds.flatMap((value) => {
+        const request = traceRecord(traceRecord(value).request);
+        return Array.isArray(request.messages) ? request.messages : [];
+    });
+    for (const message of [...initialMessages, ...roundMessages]) {
+        const content = String(traceRecord(message).content ?? "");
+        for (const match of content.matchAll(/<CHAPTER\b[^>]*\btitle="([^"]+)"[^>]*>/gu))
+            add("chapter", match[1] ?? "");
+        for (const match of content.matchAll(/<SETTING\b[^>]*\btitle="([^"]+)"[^>]*>/gu))
+            add("setting", match[1] ?? "");
+        for (const match of content.matchAll(/\[(?:# )?([^\]\n]+?)\s*\|\s*版本\s+\d+\]/gu)) {
+            const title = (match[1] ?? "").split(/\s+\/\s+/u).at(-1) ?? "";
+            add("chapter", title);
         }
-        active = next;
+        for (const match of content.matchAll(/(?:当前章节|所在章节)：([^\n|]+?)\s*\|\s*版本\s+\d+/gu))
+            add("chapter", match[1] ?? "");
+        for (const match of content.matchAll(/"chapterTitle"\s*:\s*"([^"]+)"/gu))
+            add("chapter", match[1] ?? "");
+        for (const match of content.matchAll(/"chapterId"\s*:\s*"[^"]+"[\s\S]{0,240}?"title"\s*:\s*"([^"]+)"/gu))
+            add("chapter", match[1] ?? "");
     }
-    return {
-        messages: records.map((message, index) => {
-            const content = contents[index];
-            const toolCalls = Array.isArray(message.tool_calls) ? message.tool_calls : [];
-            return {
-                role: typeof message.role === "string" ? message.role : "user",
-                content: content.slice(0, allocations[index]),
-                contentChars: content.length,
-                contentTruncated: allocations[index] < content.length,
-                toolCallCount: toolCalls.length,
-                ...(typeof message.tool_call_id === "string" ? { tool_call_id: message.tool_call_id } : {})
-            };
-        }),
-        totalChars: contents.reduce((total, content) => total + content.length, 0),
-        truncated: contents.some((content, index) => allocations[index] < content.length)
-    };
-}
-function summarizeTaskTraceRound(value) {
-    const round = traceRecord(value);
-    const request = traceRecord(round.request);
-    const messages = Array.isArray(request.messages) ? request.messages : [];
-    const attempts = Array.isArray(round.attempts) ? round.attempts : [];
-    const toolExecutions = Array.isArray(round.toolExecutions) ? round.toolExecutions : [];
-    return {
-        round: typeof round.round === "number" ? round.round : 1,
-        requestedAt: typeof round.requestedAt === "string" ? round.requestedAt : "",
-        messageCount: messages.length,
-        promptChars: messages.reduce((total, message) => {
-            const content = traceRecord(message).content;
-            return total + (content === null ? 0 : String(content ?? "").length);
-        }, 0),
-        attemptCount: attempts.length,
-        toolExecutionCount: toolExecutions.length
-    };
+    return refs;
 }
 function redactProviderSecret(value, apiKey) {
     if (!apiKey)
@@ -222,6 +207,11 @@ export function estimateAiTokens(value) {
     }
     return Math.max(1, Math.ceil(wideCharacters * 1.1 + narrowCharacters / 4));
 }
+export function collapseAiBlankLines(value) {
+    return value
+        .replace(/\r\n?/gu, "\n")
+        .replace(/\n[\t ]*\n(?:[\t ]*\n)+/gu, "\n\n");
+}
 function contextSearchTerms(value) {
     const normalized = value.normalize("NFKC").toLocaleLowerCase("zh-CN");
     const terms = new Set();
@@ -573,17 +563,20 @@ export class ContextBuilder {
     }
     buildPlan(workId, scope, maximumTokens = 60_000, bookSummaryMaximumTokens, query = "") {
         const work = this.store.getWork(workId);
-        const includeAutomaticContext = scope.type !== "none";
+        const includeAutomaticContext = scope.type !== "none" && scope.suppressAutomaticContext !== true;
+        const settingsOnly = scope.type === "settings";
         const constraints = includeAutomaticContext
             ? [`作品：${String(work.title)}\n作者：${String(work.author) || "未填写"}`]
             : [];
         const contentSections = [];
         const availableSettings = this.store.listSettings(workId);
-        const contextualSettings = scope.includeAllSettings ? availableSettings : availableSettings.filter((item) => item.locked);
+        const contextualSettings = !includeAutomaticContext || settingsOnly
+            ? []
+            : scope.includeAllSettings ? availableSettings : availableSettings.filter((item) => item.locked);
         const allCharacters = this.store.listCharacters(workId);
         const lockedCharacters = allCharacters.filter((item) => Array.isArray(item.lockedFields) && item.lockedFields.length > 0);
         const organizations = this.store.listOrganizations(workId);
-        const relationshipConstraints = scope.excludeRelationshipConstraints
+        const relationshipConstraints = !includeAutomaticContext || settingsOnly || scope.excludeRelationshipConstraints
             ? []
             : selectRelationshipConstraints(this.store, workId, scope.characterIds ?? []);
         if (includeAutomaticContext && contextualSettings.length > 0) {
@@ -591,7 +584,7 @@ export class ContextBuilder {
                 .map((item) => `- [${String(item.category)}] ${String(item.title)}：${String(item.content)}`)
                 .join("\n")}`);
         }
-        if (includeAutomaticContext && lockedCharacters.length > 0) {
+        if (includeAutomaticContext && !settingsOnly && lockedCharacters.length > 0) {
             constraints.push(`作者锁定角色属性（硬约束）：\n${lockedCharacters
                 .map((item) => {
                 const locked = item.lockedFields;
@@ -606,7 +599,7 @@ export class ContextBuilder {
             })
                 .join("\n")}`);
         }
-        if (includeAutomaticContext && organizations.length > 0) {
+        if (includeAutomaticContext && !settingsOnly && organizations.length > 0) {
             constraints.push(`世界内组织：\n${organizations.map((item) => {
                 const settings = Array.isArray(item.settings) ? item.settings.map(String).filter(Boolean) : [];
                 const members = Array.isArray(item.members)
@@ -663,6 +656,9 @@ export class ContextBuilder {
                 }
             }
         }
+        else if (scope.type === "settings" && scope.selection) {
+            contentSections.push(`待分析设定：\n${scope.selection}`);
+        }
         if (scope.includeBookSummary || scope.type === "book" || scope.type === "volume") {
             this.appendBookSummary(contentSections, workId, bookSummaryMaximumTokens ?? Math.max(160, Math.floor(maximumTokens * 0.35)), query, scope.type === "volume" ? scope.volumeId : undefined);
         }
@@ -691,7 +687,9 @@ export class ContextBuilder {
                 if (setting.workId !== workId)
                     throw new AppError(400, "SETTING_WORK_MISMATCH", "设定不属于当前作品");
             }
-            constraints.push(`选定设定：\n${settings.map((item) => `- [${String(item.category)}] ${String(item.title)}：${String(item.content)}`).join("\n")}`);
+            constraints.push(settingsOnly
+                ? `设定集条目：\n${settings.map((item) => `<SETTING id="${String(item.id)}" title="${String(item.title).replaceAll('"', "'")}">\n${String(item.content)}\n</SETTING>`).join("\n\n")}`
+                : `选定设定：\n${settings.map((item) => `- [${String(item.category)}] ${String(item.title)}：${String(item.content)}`).join("\n")}`);
         }
         if (scope.chapterIds?.length) {
             const chapterIds = [...new Set(scope.chapterIds)]
@@ -718,7 +716,7 @@ export class ContextBuilder {
             });
         }
         const sections = contentSections.map((text, order) => {
-            const required = /^(?:当前选中文本|当前章节|所在章节|作者主动引用的章节)/u.test(text);
+            const required = /^(?:当前选中文本|当前章节|所在章节|作者主动引用的章节|待分析设定)/u.test(text);
             const summary = /章节概要（/u.test(text);
             return {
                 id: `context-${order}`,
@@ -858,18 +856,30 @@ export class AiManager {
     vault;
     fetchImpl;
     validateOutboundUrl;
+    authorizeTaskRun;
     contextBuilder;
     taskControllers = new Map();
     autoRunBatches = new Map();
     autoRunTimers = new Map();
+    relationshipIndexBuilds = new Map();
+    relationshipSelectionCache = new Map();
+    relationshipSelectionBuilds = new Map();
+    relationshipIndexSerial = Promise.resolve();
+    relationshipIndexTimer = null;
+    relationshipIndexDisposed = false;
     providerSchedules = new Map();
-    constructor(store, vault, fetchImpl = fetch, validateOutboundUrl) {
+    constructor(store, vault, fetchImpl = fetch, validateOutboundUrl, authorizeTaskRun) {
         this.store = store;
         this.vault = vault;
         this.fetchImpl = fetchImpl;
         this.validateOutboundUrl = validateOutboundUrl;
+        this.authorizeTaskRun = authorizeTaskRun;
         this.contextBuilder = new ContextBuilder(store);
         this.store.setAnalysisTaskQueuedHandler((workId) => this.scheduleAutoRun(workId));
+        this.relationshipIndexTimer = setTimeout(() => {
+            this.relationshipIndexTimer = null;
+            void this.schedulePendingRelationshipIndexes();
+        }, 0);
         logger.info("ai.manager.ready");
     }
     resetAutoRunBatch(workId) {
@@ -921,6 +931,10 @@ export class AiManager {
             clearTimeout(timer);
         this.autoRunTimers.clear();
         this.autoRunBatches.clear();
+        this.relationshipIndexDisposed = true;
+        if (this.relationshipIndexTimer)
+            clearTimeout(this.relationshipIndexTimer);
+        this.relationshipIndexTimer = null;
         this.store.setAnalysisTaskQueuedHandler(null);
         logger.info("ai.manager.disposed");
     }
@@ -1099,14 +1113,27 @@ export class AiManager {
     }
     listPlatformModels() {
         return this.store.db
-            .all("SELECT m.*, p.name AS provider_name FROM models m JOIN providers p ON p.id = m.provider_id WHERE p.work_id = ? ORDER BY p.created_at, m.created_at", PLATFORM_AI_WORK_ID)
-            .map((row) => ({ ...this.mapModel(row), providerName: stringValue(row, "provider_name") }));
+            .all(`SELECT m.*, p.name AS provider_name, p.status AS provider_status, p.connection_status AS provider_connection_status
+        FROM models m JOIN providers p ON p.id = m.provider_id
+        WHERE p.work_id = ? ORDER BY p.created_at, m.created_at`, PLATFORM_AI_WORK_ID)
+            .map((row) => ({
+            ...this.mapModel(row),
+            providerName: stringValue(row, "provider_name"),
+            providerStatus: stringValue(row, "provider_status"),
+            providerConnectionStatus: stringValue(row, "provider_connection_status")
+        }));
     }
     listPlatformModelsPage(pagination) {
         const page = paginationSql(pagination);
-        const rows = this.store.db.all(`SELECT m.*, p.name AS provider_name FROM models m JOIN providers p ON p.id = m.provider_id
+        const rows = this.store.db.all(`SELECT m.*, p.name AS provider_name, p.status AS provider_status, p.connection_status AS provider_connection_status
+       FROM models m JOIN providers p ON p.id = m.provider_id
        WHERE p.work_id = ? ORDER BY p.created_at, m.created_at${page.sql}`, PLATFORM_AI_WORK_ID, ...page.params);
-        return paginated(rows.map((row) => ({ ...this.mapModel(row), providerName: stringValue(row, "provider_name") })), pagination);
+        return paginated(rows.map((row) => ({
+            ...this.mapModel(row),
+            providerName: stringValue(row, "provider_name"),
+            providerStatus: stringValue(row, "provider_status"),
+            providerConnectionStatus: stringValue(row, "provider_connection_status")
+        })), pagination);
     }
     listWorkModels(workId) {
         this.store.getWork(workId);
@@ -1158,6 +1185,19 @@ export class AiManager {
             model: this.getModel(stringValue(row, "model_id"))
         })), pagination);
     }
+    createTask(workId, input) {
+        this.store.getWork(workId);
+        const modelPurpose = this.analysisTaskModelPurpose(input.taskType);
+        const defaultRow = this.store.db.get("SELECT model_id FROM task_defaults WHERE work_id = ? AND task_type = ?", workId, modelPurpose);
+        const modelId = input.modelId ?? (defaultRow ? stringValue(defaultRow, "model_id") : undefined);
+        if (modelId)
+            this.resolveModel(workId, modelPurpose, modelId);
+        return this.store.createTask(workId, {
+            taskType: input.taskType,
+            ...(input.scope ? { scope: input.scope } : {}),
+            ...(modelId ? { modelId } : {})
+        });
+    }
     async createSuggestion(input) {
         const action = input.taskType === "continue" ? "append" : input.taskType === "polish" ? "replace-selection" : "note";
         if (action === "replace-selection" && !input.scope.selection) {
@@ -1372,9 +1412,10 @@ export class AiManager {
         })), pagination);
     }
     getTaskTrace(taskId) {
-        this.store.getTask(taskId);
+        this.store.getTaskWorkId(taskId);
         const rows = this.store.db.all(`SELECT call.id, call.task_type, call.provider_id, call.model_id, call.status, call.failure,
         call.input_chars, call.output_chars, call.created_at, call.completed_at, trace.call_id AS trace_call_id,
+        trace.source_refs_json,
         CASE WHEN trace.call_id IS NULL THEN 0 ELSE json_array_length(trace.initial_messages_json) END AS initial_message_count,
         CASE WHEN trace.call_id IS NULL THEN 0 ELSE json_array_length(trace.rounds_json) END AS round_count,
         CASE WHEN trace.call_id IS NULL THEN 0 ELSE length(trace.initial_messages_json) + length(trace.rounds_json) END AS trace_chars,
@@ -1389,6 +1430,9 @@ export class AiManager {
         const calls = rows.map((row) => {
             const hasTrace = row.trace_call_id !== null && row.trace_call_id !== undefined;
             const failure = row.failure === null ? null : stringValue(row, "failure");
+            const sourceRefs = hasTrace
+                ? json(stringValue(row, "source_refs_json"), [])
+                : [];
             return {
                 id: stringValue(row, "id"),
                 taskType: stringValue(row, "task_type"),
@@ -1410,6 +1454,7 @@ export class AiManager {
                 outputChars: numberValue(row, "output_chars"),
                 createdAt: stringValue(row, "created_at"),
                 completedAt: row.completed_at === null ? null : stringValue(row, "completed_at"),
+                sourceRefs,
                 trace: hasTrace ? {
                     available: true,
                     initialMessageCount: numberValue(row, "initial_message_count"),
@@ -1426,8 +1471,8 @@ export class AiManager {
             calls
         };
     }
-    getTaskTraceCall(taskId, callId, full = false) {
-        this.store.getTask(taskId);
+    getTaskTraceCall(taskId, callId) {
+        this.store.getTaskWorkId(taskId);
         const row = this.store.db.get(`SELECT trace.initial_messages_json, trace.rounds_json, trace.created_at, trace.updated_at
        FROM ai_calls call JOIN ai_call_traces trace ON trace.call_id = call.id AND trace.task_id = call.task_id
        WHERE call.id = ? AND call.task_id = ?`, callId, taskId);
@@ -1435,41 +1480,29 @@ export class AiManager {
             throw notFound("AI 调用追踪");
         const initialMessages = json(stringValue(row, "initial_messages_json"), []);
         const rounds = json(stringValue(row, "rounds_json"), []);
-        if (full) {
-            return {
-                taskId,
-                callId,
-                mode: "full",
-                trace: {
-                    initialMessages,
-                    rounds,
-                    createdAt: stringValue(row, "created_at"),
-                    updatedAt: stringValue(row, "updated_at")
-                }
-            };
-        }
-        const preview = previewTaskTraceMessages(initialMessages);
         return {
             taskId,
             callId,
-            mode: "preview",
-            previewLimit: TASK_TRACE_PREVIEW_CHARACTER_LIMIT,
-            truncated: preview.truncated,
-            totalPromptChars: preview.totalChars,
+            mode: "full",
             trace: {
-                initialMessages: preview.messages,
-                rounds: rounds.map(summarizeTaskTraceRound),
+                initialMessages,
+                rounds,
                 createdAt: stringValue(row, "created_at"),
                 updatedAt: stringValue(row, "updated_at")
             }
         };
     }
-    async runTask(taskId, modelId) {
+    async runTask(taskId, modelId, actor) {
         const task = this.store.getTask(taskId);
+        this.authorizeTaskRun?.(task, actor);
         const workId = String(task.workId);
+        const taskModel = task.model && typeof task.model === "object" && !Array.isArray(task.model)
+            ? task.model
+            : null;
+        const selectedModelId = modelId ?? (typeof taskModel?.id === "string" ? taskModel.id : undefined);
         const batch = this.getAutoRunBatch(workId);
         const startedAt = process.hrtime.bigint();
-        logger.info("ai.task.started", { taskId, workId, taskType: task.taskType, modelId: modelId ?? null });
+        logger.info("ai.task.started", { taskId, workId, taskType: task.taskType, modelId: selectedModelId ?? null });
         if (task.status !== "pending")
             throw new AppError(409, "TASK_NOT_PENDING", "只有待执行任务可以运行");
         if (!this.store.isTaskSourceCurrent(taskId)) {
@@ -1492,28 +1525,28 @@ export class AiManager {
             const scope = task.scope;
             let result;
             if (taskType === "chapter-analysis") {
-                result = await this.runChapterAnalysis(workId, scope, modelId, taskId);
+                result = await this.runChapterAnalysis(workId, scope, selectedModelId, taskId);
             }
             else if (taskType === "character-extraction" || taskType === "character-summary") {
-                result = await this.runCharacterExtraction(workId, scope, modelId, taskId);
+                result = await this.runCharacterExtraction(workId, scope, selectedModelId, taskId);
             }
             else if (taskType === "character-identity-audit") {
-                result = await this.runCharacterIdentityAudit(workId, scope, modelId, taskId);
+                result = await this.runCharacterIdentityAudit(workId, scope, selectedModelId, taskId);
             }
             else if (taskType === "timeline-analysis") {
-                result = await this.runTimelineAnalysis(workId, scope, modelId, taskId);
+                result = await this.runTimelineAnalysis(workId, scope, selectedModelId, taskId);
             }
             else if (taskType === "relationship-analysis") {
-                result = await this.runRelationshipAnalysis(workId, scope, modelId, taskId);
+                result = await this.runRelationshipAnalysis(workId, scope, selectedModelId, taskId);
             }
             else if (taskType === "worldview-analysis") {
-                result = await this.runWorldviewAnalysis(workId, scope, modelId, taskId);
+                result = await this.runWorldviewAnalysis(workId, scope, selectedModelId, taskId);
             }
             else if (taskType === "setting-extraction") {
-                result = await this.runSettingExtraction(workId, scope, modelId, taskId);
+                result = await this.runSettingExtraction(workId, scope, selectedModelId, taskId);
             }
             else if (taskType === "consistency-check") {
-                result = await this.runConsistencyCheck(workId, scope, modelId, taskId);
+                result = await this.runConsistencyCheck(workId, scope, selectedModelId, taskId);
             }
             else {
                 const generated = await this.generate({
@@ -1523,7 +1556,7 @@ export class AiManager {
                     instruction: "请基于上下文完成分析，给出有原文依据的中文结论。",
                     scope,
                     signal: taskController.signal,
-                    ...(modelId ? { modelId } : {})
+                    ...(selectedModelId ? { modelId: selectedModelId } : {})
                 });
                 result = { content: generated.content, callId: generated.callId };
             }
@@ -1754,7 +1787,7 @@ export class AiManager {
         return this.contextBuilder.buildPlan(input.workId, input.scope, workContextBudgetTokens, bookSummaryMaximumTokens, input.instruction);
     }
     buildContext(input, model) {
-        return this.buildContextPlan(input, model).context;
+        return collapseAiBlankLines(this.buildContextPlan(input, model).context);
     }
     enabledAgentToolIds(workId, taskType, requestedToolIds) {
         if (taskType !== "chat" && requestedToolIds === undefined)
@@ -1862,7 +1895,7 @@ export class AiManager {
                     const chapter = this.store.getChapter(chapterId);
                     if (chapter.workId !== workId)
                         return { chapterId, error: { code: "CHAPTER_WORK_MISMATCH", message: "The requested chapter belongs to a different work." } };
-                    const content = String(chapter.content);
+                    const content = collapseAiBlankLines(String(chapter.content));
                     const excerpt = content.slice(0, Math.max(0, remainingChars));
                     remainingChars -= excerpt.length;
                     return { chapterId, title: chapter.title, versionNo: chapter.versionNo, ...(include !== "content" ? { summary: summaries.get(chapterId) ?? "" } : {}), ...(include !== "summary" ? { content: excerpt, contentTruncated: excerpt.length < content.length } : {}) };
@@ -1924,7 +1957,7 @@ export class AiManager {
                     const section = this.store.getCharacterProfileSection(sectionId);
                     if (section.workId !== workId)
                         return { sectionId, error: { code: "CHARACTER_SECTION_WORK_MISMATCH", message: "The requested character section belongs to a different work." } };
-                    const content = String(section.contentMarkdown);
+                    const content = collapseAiBlankLines(String(section.contentMarkdown));
                     const excerpt = content.slice(0, Math.max(0, remainingChars));
                     remainingChars -= excerpt.length;
                     const character = this.store.getCharacter(String(section.characterId));
@@ -1985,14 +2018,14 @@ export class AiManager {
             this.store.db.run(`INSERT INTO ai_calls (id, work_id, task_id, task_type, provider_id, model_id, context_scope_json, parameters_json,
          status, input_chars, created_at, created_by_user_id) VALUES (?, ?, ?, ?, ?, ?, ?, ?, 'running', ?, ?, ?)`, callId, input.workId, input.taskId ?? null, input.taskType, stringValue(provider, "id"), stringValue(model, "id"), JSON.stringify(input.scope), JSON.stringify(parameters), context.length + input.instruction.length, timestamp, currentRequestActor()?.userId ?? null);
             if (input.taskId) {
-                this.store.db.run(`INSERT INTO ai_call_traces (call_id, task_id, initial_messages_json, rounds_json, created_at, updated_at)
-           VALUES (?, ?, ?, '[]', ?, ?)`, callId, input.taskId, JSON.stringify(messages), timestamp, timestamp);
+                this.store.db.run(`INSERT INTO ai_call_traces (call_id, task_id, initial_messages_json, rounds_json, source_refs_json, created_at, updated_at)
+           VALUES (?, ?, ?, '[]', ?, ?, ?)`, callId, input.taskId, JSON.stringify(messages), JSON.stringify(taskTraceSourceRefs(messages, [])), timestamp, timestamp);
             }
         });
         const saveTrace = () => {
             if (!input.taskId)
                 return;
-            this.store.db.run("UPDATE ai_call_traces SET rounds_json = ?, updated_at = ? WHERE call_id = ?", JSON.stringify(traceRounds), now(), callId);
+            this.store.db.run("UPDATE ai_call_traces SET rounds_json = ?, source_refs_json = ?, updated_at = ? WHERE call_id = ?", JSON.stringify(traceRounds), JSON.stringify(taskTraceSourceRefs(messages, traceRounds)), now(), callId);
         };
         const callStartedAt = process.hrtime.bigint();
         logger.info("ai.call.started", {
@@ -3317,10 +3350,836 @@ export class AiManager {
             }
         };
     }
+    async schedulePendingRelationshipIndexes() {
+        if (this.relationshipIndexDisposed)
+            return;
+        const workIds = this.store.db.all("SELECT DISTINCT work_id FROM relationship_source_index_queue ORDER BY work_id").map((row) => String(row.work_id));
+        await Promise.allSettled(workIds.map((workId) => this.ensureRelationshipSearchIndex(workId)));
+    }
+    ensureRelationshipSearchIndex(workId) {
+        const existing = this.relationshipIndexBuilds.get(workId);
+        if (existing)
+            return existing;
+        const build = this.relationshipIndexSerial.then(async () => this.drainRelationshipSearchIndex(workId));
+        this.relationshipIndexSerial = build.then(() => undefined, () => undefined);
+        this.relationshipIndexBuilds.set(workId, build);
+        void build.finally(() => {
+            if (this.relationshipIndexBuilds.get(workId) === build)
+                this.relationshipIndexBuilds.delete(workId);
+        }).catch(() => undefined);
+        return build;
+    }
+    async drainRelationshipSearchIndex(workId) {
+        if (this.relationshipIndexDisposed)
+            return 0;
+        const timestamp = now();
+        this.store.db.run(`INSERT INTO relationship_source_index_state(work_id, status, generation, error, updated_at)
+       VALUES (?, 'building', 0, '', ?)
+       ON CONFLICT(work_id) DO UPDATE SET status = 'building', error = '', updated_at = excluded.updated_at`, workId, timestamp);
+        let processed = 0;
+        try {
+            while (!this.relationshipIndexDisposed) {
+                const queued = this.store.db.all(`SELECT source_type, source_id, queued_at FROM relationship_source_index_queue
+           WHERE work_id = ? ORDER BY queued_at, source_type, source_id LIMIT 50`, workId);
+                if (queued.length === 0)
+                    break;
+                for (const item of queued) {
+                    const sourceType = String(item.source_type);
+                    const sourceId = String(item.source_id);
+                    const queuedAt = String(item.queued_at);
+                    this.store.db.transaction(() => {
+                        if (sourceType === "chapter")
+                            this.indexRelationshipChapter(workId, sourceId);
+                        else
+                            this.indexRelationshipSettingSource(workId, sourceType, sourceId);
+                        this.store.db.run(`DELETE FROM relationship_source_index_queue
+               WHERE work_id = ? AND source_type = ? AND source_id = ? AND queued_at = ?`, workId, sourceType, sourceId, queuedAt);
+                    });
+                    processed += 1;
+                }
+                await new Promise((resolve) => setImmediate(resolve));
+            }
+            if (this.relationshipIndexDisposed) {
+                this.store.db.run("UPDATE relationship_source_index_state SET status = 'queued', updated_at = ? WHERE work_id = ?", now(), workId);
+                return 0;
+            }
+            this.store.db.run(`UPDATE relationship_source_index_state
+         SET status = 'ready', generation = generation + ?, error = '', updated_at = ? WHERE work_id = ?`, processed > 0 ? 1 : 0, now(), workId);
+            const generation = Number(this.store.db.get("SELECT generation FROM relationship_source_index_state WHERE work_id = ?", workId)?.generation ?? 0);
+            logger.info("relationship.search_index.ready", { workId, generation, processed });
+            return generation;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "索引构建失败";
+            this.store.db.run("UPDATE relationship_source_index_state SET status = 'failed', error = ?, updated_at = ? WHERE work_id = ?", message.slice(0, 2_000), now(), workId);
+            logger.error("relationship.search_index.failed", { workId, processed, error: sanitizeError(error) });
+            throw error;
+        }
+    }
+    indexRelationshipChapter(workId, chapterId) {
+        const chapter = this.store.db.get("SELECT id FROM chapters WHERE id = ? AND work_id = ?", chapterId, workId);
+        if (!chapter)
+            return;
+        const paragraphs = this.store.db.all("SELECT id, search_content FROM chapter_paragraph_search WHERE chapter_id = ? ORDER BY paragraph_order", chapterId);
+        for (const paragraph of paragraphs) {
+            const rowId = Number(paragraph.id);
+            this.store.db.run("DELETE FROM chapter_paragraph_pinyin_fts WHERE rowid = ?", rowId);
+            this.store.db.run("INSERT INTO chapter_paragraph_pinyin_fts(rowid, pinyin_tokens) VALUES (?, ?)", rowId, relationshipPinyinTokenText(String(paragraph.search_content)));
+        }
+    }
+    indexRelationshipSettingSource(workId, sourceType, sourceId) {
+        const materialized = this.relationshipSettingSource(workId, sourceType, sourceId);
+        const existing = this.store.db.get("SELECT id FROM relationship_source_search WHERE work_id = ? AND source_type = ? AND source_id = ?", workId, sourceType, sourceId);
+        if (!materialized) {
+            if (existing)
+                this.store.db.run("DELETE FROM relationship_source_search WHERE id = ?", Number(existing.id));
+            return;
+        }
+        const searchable = `${materialized.title}\n${materialized.content}`;
+        const contentHash = this.store.hashContent(searchable);
+        let rowId = Number(existing?.id ?? 0);
+        if (existing) {
+            this.store.db.run(`UPDATE relationship_source_search SET source_version = ?, content_hash = ?, updated_at = ? WHERE id = ?`, materialized.version, contentHash, now(), rowId);
+            this.store.db.run("DELETE FROM relationship_source_exact_fts WHERE rowid = ?", rowId);
+            this.store.db.run("DELETE FROM relationship_source_pinyin_fts WHERE rowid = ?", rowId);
+        }
+        else {
+            rowId = Number(this.store.db.run(`INSERT INTO relationship_source_search(work_id, source_type, source_id, source_version, content_hash, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?)`, workId, sourceType, sourceId, materialized.version, contentHash, now()).lastInsertRowid);
+        }
+        this.store.db.run("INSERT INTO relationship_source_exact_fts(rowid, character_tokens) VALUES (?, ?)", rowId, relationshipCharacterTokenText(searchable));
+        this.store.db.run("INSERT INTO relationship_source_pinyin_fts(rowid, pinyin_tokens) VALUES (?, ?)", rowId, relationshipPinyinTokenText(searchable));
+    }
+    relationshipScopeChapterIds(workId, scope) {
+        if (scope.type === "settings")
+            return new Set();
+        if (scope.type === "chapter") {
+            if (!scope.chapterId)
+                throw new AppError(400, "CHAPTER_REQUIRED", "分析范围缺少章节标识");
+            const chapter = this.store.getChapter(scope.chapterId);
+            if (String(chapter.workId) !== workId)
+                throw new AppError(400, "CHAPTER_WORK_MISMATCH", "章节不属于当前作品");
+            return new Set([scope.chapterId]);
+        }
+        if (scope.type === "volume") {
+            if (!scope.volumeId)
+                throw new AppError(400, "VOLUME_REQUIRED", "分析范围缺少分卷标识");
+            const volume = this.store.getVolume(scope.volumeId);
+            if (String(volume.workId) !== workId)
+                throw new AppError(400, "VOLUME_WORK_MISMATCH", "分卷不属于当前作品");
+            return new Set(this.store.db.all(`SELECT id FROM chapters WHERE work_id = ? AND volume_id = ?
+         AND excluded_from_analysis = 0 AND chapter_type <> '作者的话'`, workId, scope.volumeId).map((row) => String(row.id)));
+        }
+        return new Set(this.store.db.all(`SELECT id FROM chapters WHERE work_id = ? AND excluded_from_analysis = 0 AND chapter_type <> '作者的话'`, workId).map((row) => String(row.id)));
+    }
+    relationshipIndexedSource(workId, sourceType, sourceId) {
+        if (sourceType === "chapter") {
+            try {
+                const chapter = this.store.getChapter(sourceId);
+                if (String(chapter.workId) !== workId)
+                    return null;
+                return {
+                    sourceType,
+                    sourceId,
+                    title: String(chapter.title),
+                    content: String(chapter.content),
+                    version: String(chapter.versionNo)
+                };
+            }
+            catch {
+                return null;
+            }
+        }
+        const source = this.relationshipSettingSource(workId, sourceType, sourceId);
+        return source ? {
+            sourceType,
+            sourceId,
+            title: source.title,
+            content: source.content,
+            version: source.version
+        } : null;
+    }
+    relationshipIndexedSourceKey(sourceType, sourceId) {
+        return `${sourceType}:${sourceId}`;
+    }
+    relationshipIndexedSourceRef(key) {
+        const separator = key.indexOf(":");
+        return separator < 0
+            ? { sourceType: "setting", sourceId: key }
+            : { sourceType: key.slice(0, separator), sourceId: key.slice(separator + 1) };
+    }
+    relationshipChapterExactMatches(workId, reference) {
+        const normalized = normalizeRelationshipSearchText(reference).trim();
+        if (!normalized)
+            return [];
+        const rows = [...normalized].length < 3
+            ? this.store.db.all(`SELECT DISTINCT paragraph.chapter_id FROM chapter_paragraph_short_terms term
+           JOIN chapter_paragraph_search paragraph ON paragraph.id = term.paragraph_id
+           WHERE paragraph.work_id = ? AND term.term = ?`, workId, normalized)
+            : this.store.db.all(`SELECT DISTINCT paragraph.chapter_id FROM chapter_paragraph_search_fts
+           JOIN chapter_paragraph_search paragraph ON paragraph.id = chapter_paragraph_search_fts.rowid
+           WHERE paragraph.work_id = ? AND chapter_paragraph_search_fts MATCH ?`, workId, `"${normalized.replaceAll('"', '""')}"`);
+        return rows.map((row) => String(row.chapter_id));
+    }
+    relationshipSettingExactMatches(workId, reference) {
+        const phrase = ftsPhrase(relationshipCharacterTokens(reference));
+        return this.store.db.all(`SELECT source.source_type, source.source_id FROM relationship_source_exact_fts
+       JOIN relationship_source_search source ON source.id = relationship_source_exact_fts.rowid
+       WHERE source.work_id = ? AND relationship_source_exact_fts MATCH ?
+         AND NOT (source.source_type = 'review' AND EXISTS (
+           SELECT 1 FROM review_items review
+           WHERE review.id = source.source_id AND review.item_type = 'character-name-variant'
+         ))`, workId, phrase).map((row) => this.relationshipIndexedSourceKey(String(row.source_type), String(row.source_id)));
+    }
+    relationshipFuzzyIndexMatches(workId, reference, includeSettings, scope) {
+        const result = new Set();
+        const characterTokens = [...new Set(relationshipCharacterTokens(reference))];
+        const pinyinTokens = [...new Set(relationshipPinyinTokens(reference))];
+        const score = new Map();
+        const add = (key) => {
+            score.set(key, (score.get(key) ?? 0) + 1);
+        };
+        const chapterScope = scope.type === "chapter"
+            ? { sql: "AND paragraph.chapter_id = ?", params: [scope.chapterId ?? ""] }
+            : scope.type === "volume"
+                ? {
+                    sql: `AND EXISTS (
+              SELECT 1 FROM chapters chapter WHERE chapter.id = paragraph.chapter_id
+                AND chapter.volume_id = ? AND chapter.excluded_from_analysis = 0 AND chapter.chapter_type <> '作者的话'
+            )`,
+                    params: [scope.volumeId ?? ""]
+                }
+                : {
+                    sql: `AND EXISTS (
+              SELECT 1 FROM chapters chapter WHERE chapter.id = paragraph.chapter_id
+                AND chapter.excluded_from_analysis = 0 AND chapter.chapter_type <> '作者的话'
+            )`,
+                    params: []
+                };
+        const includeChapters = scope.type !== "settings";
+        const pinyinPhrase = ftsPhrase(relationshipPinyinTokens(reference));
+        if (includeChapters) {
+            for (const row of this.store.db.all(`SELECT DISTINCT paragraph.chapter_id FROM chapter_paragraph_pinyin_fts
+         JOIN chapter_paragraph_search paragraph ON paragraph.id = chapter_paragraph_pinyin_fts.rowid
+         WHERE paragraph.work_id = ? AND chapter_paragraph_pinyin_fts MATCH ? ${chapterScope.sql}
+         LIMIT 201`, workId, pinyinPhrase, ...chapterScope.params))
+                result.add(this.relationshipIndexedSourceKey("chapter", String(row.chapter_id)));
+        }
+        if (includeSettings) {
+            for (const row of this.store.db.all(`SELECT source.source_type, source.source_id FROM relationship_source_pinyin_fts
+         JOIN relationship_source_search source ON source.id = relationship_source_pinyin_fts.rowid
+         WHERE source.work_id = ? AND relationship_source_pinyin_fts MATCH ?
+           AND NOT (source.source_type = 'review' AND EXISTS (
+             SELECT 1 FROM review_items review
+             WHERE review.id = source.source_id AND review.item_type = 'character-name-variant'
+           ))
+         LIMIT 201`, workId, pinyinPhrase))
+                result.add(this.relationshipIndexedSourceKey(String(row.source_type), String(row.source_id)));
+        }
+        const normalizedCharacters = [...normalizeRelationshipSearchText(reference).trim()];
+        if (includeChapters) {
+            for (const character of [...new Set(normalizedCharacters)]) {
+                for (const row of this.store.db.all(`SELECT DISTINCT paragraph.chapter_id FROM chapter_paragraph_short_terms term
+           JOIN chapter_paragraph_search paragraph ON paragraph.id = term.paragraph_id
+           WHERE paragraph.work_id = ? AND term.term = ? ${chapterScope.sql}
+           LIMIT 201`, workId, character, ...chapterScope.params))
+                    add(this.relationshipIndexedSourceKey("chapter", String(row.chapter_id)));
+            }
+            for (const token of pinyinTokens) {
+                for (const row of this.store.db.all(`SELECT DISTINCT paragraph.chapter_id FROM chapter_paragraph_pinyin_fts
+           JOIN chapter_paragraph_search paragraph ON paragraph.id = chapter_paragraph_pinyin_fts.rowid
+           WHERE paragraph.work_id = ? AND chapter_paragraph_pinyin_fts MATCH ? ${chapterScope.sql}
+           LIMIT 201`, workId, token, ...chapterScope.params))
+                    add(this.relationshipIndexedSourceKey("chapter", String(row.chapter_id)));
+            }
+        }
+        if (includeSettings) {
+            for (const token of characterTokens) {
+                for (const row of this.store.db.all(`SELECT source.source_type, source.source_id FROM relationship_source_exact_fts
+           JOIN relationship_source_search source ON source.id = relationship_source_exact_fts.rowid
+           WHERE source.work_id = ? AND relationship_source_exact_fts MATCH ?
+           AND NOT (source.source_type = 'review' AND EXISTS (
+               SELECT 1 FROM review_items review
+               WHERE review.id = source.source_id AND review.item_type = 'character-name-variant'
+             ))
+           LIMIT 201`, workId, token))
+                    add(this.relationshipIndexedSourceKey(String(row.source_type), String(row.source_id)));
+            }
+            for (const token of pinyinTokens) {
+                for (const row of this.store.db.all(`SELECT source.source_type, source.source_id FROM relationship_source_pinyin_fts
+           JOIN relationship_source_search source ON source.id = relationship_source_pinyin_fts.rowid
+           WHERE source.work_id = ? AND relationship_source_pinyin_fts MATCH ?
+           AND NOT (source.source_type = 'review' AND EXISTS (
+               SELECT 1 FROM review_items review
+               WHERE review.id = source.source_id AND review.item_type = 'character-name-variant'
+             ))
+           LIMIT 201`, workId, token))
+                    add(this.relationshipIndexedSourceKey(String(row.source_type), String(row.source_id)));
+            }
+        }
+        const threshold = Math.max(1, [...normalizeRelationshipSearchText(reference).trim()].length - 1);
+        for (const [key, count] of score)
+            if (count >= threshold)
+                result.add(key);
+        return result;
+    }
+    relationshipIdentityAnchors(workId, character) {
+        const characterId = String(character.id);
+        const relatedIds = new Set();
+        for (const relationship of this.store.listRelationships(workId)) {
+            if (String(relationship.fromCharacterId) === characterId)
+                relatedIds.add(String(relationship.toCharacterId));
+            if (String(relationship.toCharacterId) === characterId)
+                relatedIds.add(String(relationship.fromCharacterId));
+        }
+        const anchors = [
+            String(character.code ?? ""),
+            String(character.species ?? ""),
+            String(character.race?.name ?? ""),
+            ...(Array.isArray(character.organizations) ? character.organizations.map((item) => String(item.name ?? "")) : []),
+            ...[...relatedIds].flatMap((relatedId) => {
+                try {
+                    const related = this.store.getCharacter(relatedId);
+                    return [String(related.name), ...related.aliases];
+                }
+                catch {
+                    return [];
+                }
+            })
+        ].map((value) => normalizeRelationshipSearchText(value).trim())
+            .filter((value) => [...value].length >= 2);
+        return [...new Set(anchors)];
+    }
+    async localRelationshipSourceSelection(workId, scope, characters, selectedCharacterIds, generation) {
+        const targetCharacters = characters.filter((character) => selectedCharacterIds.has(String(character.id)));
+        const cacheKey = JSON.stringify({
+            workId,
+            scope: {
+                type: scope.type,
+                chapterId: scope.chapterId ?? null,
+                volumeId: scope.volumeId ?? null,
+                includeAllSettings: scope.includeAllSettings === true
+            },
+            targets: targetCharacters.map((character) => ({ id: character.id, versionNo: character.versionNo })),
+            generation,
+            policyVersion: RELATIONSHIP_SEARCH_POLICY_VERSION
+        });
+        const cached = this.relationshipSelectionCache.get(cacheKey);
+        if (cached)
+            return cached;
+        const existingBuild = this.relationshipSelectionBuilds.get(cacheKey);
+        if (existingBuild)
+            return existingBuild;
+        const build = (async () => {
+            const allowedChapterIds = this.relationshipScopeChapterIds(workId, scope);
+            const includeSettings = scope.type === "settings" || scope.includeAllSettings === true;
+            const exactKeys = new Set();
+            const candidates = [];
+            const candidateKeys = new Set();
+            const candidateOccurrences = new Map();
+            const loadedSources = new Map();
+            const knownCharacterReferences = new Set(characters.flatMap((character) => [
+                String(character.name),
+                ...(Array.isArray(character.aliases) ? character.aliases.map(String) : [])
+            ]).map((value) => normalizeRelationshipSearchText(value).trim()).filter(Boolean));
+            for (const character of targetCharacters) {
+                const targetCharacterId = String(character.id);
+                const exactReferences = [...new Set([String(character.name), ...character.aliases].map((item) => item.trim()).filter(Boolean))];
+                const fuzzyReferenceCount = exactReferences.filter((reference) => [...normalizeRelationshipSearchText(reference).trim()].length >= 2).length;
+                if (fuzzyReferenceCount > RELATIONSHIP_MAX_FUZZY_REFERENCES) {
+                    throw new AppError(409, "RELATIONSHIP_MATCH_CANDIDATES_EXCEEDED", "人物名称和别名过多，无法在安全预算内完成疑似写法匹配", {
+                        characterId: targetCharacterId,
+                        fuzzyReferenceCount,
+                        maximumFuzzyReferences: RELATIONSHIP_MAX_FUZZY_REFERENCES
+                    });
+                }
+                const normalizedExactReferences = new Set(exactReferences.map((item) => normalizeRelationshipSearchText(item).trim()));
+                const anchors = this.relationshipIdentityAnchors(workId, character);
+                const anchorKeys = new Set();
+                for (const anchor of anchors) {
+                    for (const chapterId of this.relationshipChapterExactMatches(workId, anchor)) {
+                        if (allowedChapterIds.has(chapterId))
+                            anchorKeys.add(this.relationshipIndexedSourceKey("chapter", chapterId));
+                    }
+                    if (includeSettings)
+                        for (const key of this.relationshipSettingExactMatches(workId, anchor))
+                            anchorKeys.add(key);
+                }
+                const targetIndexCandidateKeys = new Set();
+                const targetFuzzySourceKeys = new Set();
+                let fuzzyScanCharacters = 0;
+                let fuzzyMatchCount = 0;
+                for (const reference of exactReferences) {
+                    for (const chapterId of this.relationshipChapterExactMatches(workId, reference)) {
+                        if (allowedChapterIds.has(chapterId))
+                            exactKeys.add(this.relationshipIndexedSourceKey("chapter", chapterId));
+                    }
+                    if (includeSettings)
+                        for (const key of this.relationshipSettingExactMatches(workId, reference))
+                            exactKeys.add(key);
+                    const referenceLength = [...normalizeRelationshipSearchText(reference).trim()].length;
+                    if (referenceLength < 2)
+                        continue;
+                    const fuzzyIndexKeys = referenceLength === 2
+                        ? anchorKeys
+                        : this.relationshipFuzzyIndexMatches(workId, reference, includeSettings, scope);
+                    for (const key of fuzzyIndexKeys) {
+                        const ref = this.relationshipIndexedSourceRef(key);
+                        if (ref.sourceType === "chapter" && !allowedChapterIds.has(ref.sourceId))
+                            continue;
+                        if (ref.sourceType !== "chapter" && !includeSettings)
+                            continue;
+                        targetIndexCandidateKeys.add(key);
+                        if (targetIndexCandidateKeys.size > RELATIONSHIP_MAX_FUZZY_SOURCES) {
+                            throw new AppError(409, "RELATIONSHIP_MATCH_CANDIDATES_EXCEEDED", "疑似人物名来源过多，请补充人物别名或身份资料后重试", {
+                                characterId: targetCharacterId,
+                                candidateCount: targetIndexCandidateKeys.size,
+                                maximum: RELATIONSHIP_MAX_FUZZY_SOURCES
+                            });
+                        }
+                        let indexed = loadedSources.get(key);
+                        if (!indexed) {
+                            const loaded = this.relationshipIndexedSource(workId, ref.sourceType, ref.sourceId);
+                            if (!loaded)
+                                continue;
+                            indexed = loaded;
+                            loadedSources.set(key, indexed);
+                        }
+                        if (indexed.sourceType === "review" && indexed.content.includes('"itemType": "character-name-variant"'))
+                            continue;
+                        const searchable = `${indexed.title}\n${indexed.content}`;
+                        const normalizedSearchable = normalizeRelationshipSearchText(searchable);
+                        fuzzyScanCharacters += normalizedSearchable.length;
+                        if (fuzzyScanCharacters > RELATIONSHIP_MAX_FUZZY_SCAN_CHARACTERS) {
+                            throw new AppError(409, "RELATIONSHIP_MATCH_CANDIDATES_EXCEEDED", "疑似人物名待核对文本过多，请缩小分析范围或补充人物别名", {
+                                characterId: targetCharacterId,
+                                scannedCharacters: fuzzyScanCharacters,
+                                maximumScannedCharacters: RELATIONSHIP_MAX_FUZZY_SCAN_CHARACTERS
+                            });
+                        }
+                        const referenceCharacters = [...normalizeRelationshipSearchText(reference).trim()];
+                        let approximateMatches;
+                        try {
+                            approximateMatches = await findApproximateNameMatchesChunked(searchable, reference, 24, knownCharacterReferences, RELATIONSHIP_MAX_SOURCE_MATCHES);
+                        }
+                        catch (error) {
+                            if (!(error instanceof RelationshipApproximateMatchLimitError))
+                                throw error;
+                            throw new AppError(409, "RELATIONSHIP_MATCH_CANDIDATES_EXCEEDED", "单个来源中的疑似人物名写法过多，请缩小分析范围或补充人物别名", {
+                                characterId: targetCharacterId,
+                                sourceType: indexed.sourceType,
+                                sourceId: indexed.sourceId,
+                                maximumSourceMatches: error.maximumCandidates
+                            });
+                        }
+                        for (const match of approximateMatches) {
+                            if (normalizedExactReferences.has(normalizeRelationshipSearchText(match.observed).trim()))
+                                continue;
+                            if (referenceLength === 2
+                                && !anchors.some((anchor) => normalizedSearchable.includes(anchor)))
+                                continue;
+                            const occurrenceKey = [targetCharacterId, indexed.sourceType, indexed.sourceId, match.observed].join("|");
+                            const occurrenceCount = candidateOccurrences.get(occurrenceKey) ?? 0;
+                            if (occurrenceCount >= 3)
+                                continue;
+                            const candidateKey = [targetCharacterId, indexed.sourceType, indexed.sourceId, match.observed, reference, match.start].join("|");
+                            if (candidateKeys.has(candidateKey))
+                                continue;
+                            candidateKeys.add(candidateKey);
+                            candidateOccurrences.set(occurrenceKey, occurrenceCount + 1);
+                            fuzzyMatchCount += 1;
+                            if (fuzzyMatchCount > RELATIONSHIP_MAX_FUZZY_MATCHES) {
+                                throw new AppError(409, "RELATIONSHIP_MATCH_CANDIDATES_EXCEEDED", "疑似人物名写法过多，请缩小分析范围或补充人物别名", {
+                                    characterId: targetCharacterId,
+                                    fuzzyMatchCount,
+                                    maximumFuzzyMatches: RELATIONSHIP_MAX_FUZZY_MATCHES
+                                });
+                            }
+                            targetFuzzySourceKeys.add(key);
+                            const snippetStart = Math.max(0, match.utf16Start - 240);
+                            const snippetEnd = Math.min(normalizedSearchable.length, match.utf16End + 240);
+                            candidates.push({
+                                key: candidateKey,
+                                targetCharacterId,
+                                targetName: String(character.name),
+                                reference,
+                                sourceType: indexed.sourceType,
+                                sourceId: indexed.sourceId,
+                                sourceTitle: indexed.title,
+                                sourceVersion: indexed.version,
+                                observed: match.observed,
+                                snippet: normalizedSearchable.slice(snippetStart, snippetEnd),
+                                characterDistance: match.characterDistance,
+                                pinyinDistance: match.pinyinDistance
+                            });
+                        }
+                    }
+                }
+                if (targetFuzzySourceKeys.size > RELATIONSHIP_MAX_FUZZY_SOURCES) {
+                    throw new AppError(409, "RELATIONSHIP_MATCH_CANDIDATES_EXCEEDED", "疑似人物名来源过多，请补充人物别名或身份资料后重试", {
+                        characterId: targetCharacterId,
+                        candidateCount: targetFuzzySourceKeys.size,
+                        maximum: RELATIONSHIP_MAX_FUZZY_SOURCES
+                    });
+                }
+            }
+            const result = { generation, exactKeys: [...exactKeys], candidates };
+            this.relationshipSelectionCache.set(cacheKey, result);
+            if (this.relationshipSelectionCache.size > 128) {
+                const oldest = this.relationshipSelectionCache.keys().next().value;
+                if (typeof oldest === "string")
+                    this.relationshipSelectionCache.delete(oldest);
+            }
+            return result;
+        })();
+        this.relationshipSelectionBuilds.set(cacheKey, build);
+        try {
+            return await build;
+        }
+        finally {
+            if (this.relationshipSelectionBuilds.get(cacheKey) === build)
+                this.relationshipSelectionBuilds.delete(cacheKey);
+        }
+    }
+    async verifyRelationshipVariantCandidates(workId, candidates, modelId, taskId) {
+        if (candidates.length === 0)
+            return { decisions: [], callIds: [] };
+        const batches = [];
+        let batch = [];
+        let batchLength = 0;
+        for (const candidate of candidates) {
+            const length = JSON.stringify(candidate).length;
+            if (batch.length > 0 && batchLength + length > 12_000) {
+                batches.push(batch);
+                batch = [];
+                batchLength = 0;
+            }
+            batch.push(candidate);
+            batchLength += length;
+        }
+        if (batch.length > 0)
+            batches.push(batch);
+        const decisions = [];
+        const callIds = [];
+        try {
+            for (const candidateBatch of batches) {
+                const snippets = candidateBatch.map((candidate) => {
+                    const tag = candidate.sourceType === "chapter" ? "CHAPTER" : "SETTING";
+                    return [
+                        `<${tag} id="${candidate.sourceId.replaceAll('"', "'")}" title="${candidate.sourceTitle.replaceAll('"', "'")}">`,
+                        JSON.stringify({
+                            key: candidate.key,
+                            targetCharacterId: candidate.targetCharacterId,
+                            targetName: candidate.targetName,
+                            registeredReference: candidate.reference,
+                            observed: candidate.observed,
+                            characterDistance: candidate.characterDistance,
+                            pinyinDistance: candidate.pinyinDistance,
+                            snippet: candidate.snippet
+                        }),
+                        `</${tag}>`
+                    ].join("\n");
+                }).join("\n");
+                const generated = await this.generateTaggedJson({
+                    workId,
+                    taskId,
+                    taskType: "relationship-analysis",
+                    signal: this.taskSignal(taskId),
+                    maxAttempts: 2,
+                    scope: { type: "selection", selection: snippets, suppressAutomaticContext: true },
+                    ...(modelId ? { modelId } : {}),
+                    parameters: { temperature: 0.1 },
+                    instruction: [
+                        "你是人物名称变体确认器。判断每个片段中的 observed 是否指向对应 targetName，而不是另一个人物、普通词语或无法判断的对象。",
+                        "只依据每个候选附带的局部片段判断，禁止使用未提供的正文或设定。",
+                        "必须为每个 key 恰好输出一次结果，不得遗漏、重复或新增 key。",
+                        "verdict 只能是 same、separate、uncertain；confidence 是 0 到 1；reason 使用简短中文说明片段内依据。",
+                        "拼音相同或字形相近只能说明疑似，不能单独作为 same 的依据。上下文不能可靠确认时必须输出 uncertain。",
+                        "输出 JSON 数组，字段为 key、verdict、confidence、reason。"
+                    ].join("\n")
+                });
+                callIds.push(generated.callId);
+                const extracted = extractJson(generated.content);
+                if (!Array.isArray(extracted))
+                    throw new Error("variant verification result is not an array");
+                const byKey = new Map(candidateBatch.map((candidate) => [candidate.key, candidate]));
+                const seen = new Set();
+                for (const item of extracted) {
+                    if (!item || typeof item !== "object" || Array.isArray(item))
+                        throw new Error("variant verification item is invalid");
+                    const value = item;
+                    const key = typeof value.key === "string" ? value.key : "";
+                    const verdict = value.verdict;
+                    const confidence = Number(value.confidence);
+                    const reason = typeof value.reason === "string" ? value.reason.trim() : "";
+                    const candidate = byKey.get(key);
+                    if (!candidate || seen.has(key) || !["same", "separate", "uncertain"].includes(String(verdict))
+                        || !Number.isFinite(confidence) || confidence < 0 || confidence > 1 || !reason) {
+                        throw new Error("variant verification item is incomplete");
+                    }
+                    seen.add(key);
+                    decisions.push({
+                        ...candidate,
+                        verdict: verdict,
+                        confidence,
+                        reason
+                    });
+                }
+                if (seen.size !== candidateBatch.length)
+                    throw new Error("variant verification result omitted candidates");
+            }
+        }
+        catch (error) {
+            if (error instanceof AppError && error.code === "TASK_CANCELLED")
+                throw error;
+            throw new AppError(502, "RELATIONSHIP_VARIANT_VERIFICATION_FAILED", "疑似人物名身份确认失败，未写入人物关系", {
+                candidateCount: candidates.length,
+                completedCallCount: callIds.length
+            });
+        }
+        return { decisions, callIds };
+    }
+    async selectRelationshipSources(workId, scope, characters, selectedCharacterIds, modelId, taskId) {
+        let generation;
+        try {
+            generation = await this.ensureRelationshipSearchIndex(workId);
+        }
+        catch {
+            throw new AppError(503, "RELATIONSHIP_INDEX_BUILD_FAILED", "人物关系来源索引构建失败，请稍后重试");
+        }
+        const local = await this.localRelationshipSourceSelection(workId, scope, characters, selectedCharacterIds, generation);
+        const verified = await this.verifyRelationshipVariantCandidates(workId, local.candidates, modelId, taskId);
+        const accepted = verified.decisions.filter((decision) => decision.verdict === "same" && decision.confidence >= 0.8);
+        const selectedKeys = new Set([...local.exactKeys, ...accepted.map((decision) => this.relationshipIndexedSourceKey(decision.sourceType, decision.sourceId))]);
+        const chapters = [];
+        const settings = [];
+        for (const key of selectedKeys) {
+            const ref = this.relationshipIndexedSourceRef(key);
+            if (ref.sourceType === "chapter") {
+                const source = this.relationshipIndexedSource(workId, ref.sourceType, ref.sourceId);
+                if (source)
+                    chapters.push({
+                        id: source.sourceId,
+                        workId,
+                        title: source.title,
+                        content: collapseAiBlankLines(source.content),
+                        versionNo: Number(source.version)
+                    });
+            }
+            else {
+                const source = this.relationshipSettingSource(workId, ref.sourceType, ref.sourceId);
+                if (source)
+                    settings.push(source);
+            }
+        }
+        const chapterOrder = new Map(this.store.db.all(`SELECT chapter.id FROM chapters chapter JOIN volumes volume ON volume.id = chapter.volume_id
+       WHERE chapter.work_id = ? ORDER BY volume.sort_order, chapter.sort_order`, workId).map((row, index) => [String(row.id), index]));
+        chapters.sort((left, right) => (chapterOrder.get(String(left.id)) ?? Number.MAX_SAFE_INTEGER) - (chapterOrder.get(String(right.id)) ?? Number.MAX_SAFE_INTEGER));
+        settings.sort((left, right) => `${left.sourceType}:${left.id}`.localeCompare(`${right.sourceType}:${right.id}`, "zh-CN"));
+        return {
+            generation,
+            chapters,
+            settings,
+            variantDecisions: verified.decisions,
+            verificationCallIds: verified.callIds,
+            summary: {
+                policyVersion: RELATIONSHIP_SEARCH_POLICY_VERSION,
+                indexGeneration: generation,
+                exactSourceCount: new Set(local.exactKeys).size,
+                fuzzyCandidateCount: local.candidates.length,
+                confirmedSourceCount: new Set(accepted.map((decision) => this.relationshipIndexedSourceKey(decision.sourceType, decision.sourceId))).size,
+                rejectedSourceCount: verified.decisions.filter((decision) => decision.verdict === "separate").length,
+                uncertainSourceCount: verified.decisions.filter((decision) => decision.verdict === "uncertain" || (decision.verdict === "same" && decision.confidence < 0.8)).length,
+                reviewIds: []
+            }
+        };
+    }
+    relationshipSettingSource(workId, sourceType, sourceId) {
+        const cleanStrings = (value) => {
+            if (typeof value === "string")
+                return collapseAiBlankLines(value);
+            if (Array.isArray(value))
+                return value.map(cleanStrings);
+            if (!value || typeof value !== "object")
+                return value;
+            return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, cleanStrings(item)]));
+        };
+        const serialize = (value) => JSON.stringify(cleanStrings(value), null, 2);
+        const source = (title, value, version) => ({
+            id: sourceType === "setting" ? sourceId : `${sourceType}:${sourceId}`,
+            title,
+            sourceType,
+            content: serialize(value),
+            version: String(version ?? "")
+        });
+        try {
+            if (sourceType === "work") {
+                const item = this.store.getWork(sourceId);
+                if (String(item.id) !== workId)
+                    return null;
+                return source(`作品资料：${String(item.title)}`, {
+                    title: item.title, author: item.author, description: item.description, language: item.language
+                }, item.versionNo);
+            }
+            if (sourceType === "setting") {
+                const item = this.store.getSetting(sourceId);
+                if (String(item.workId) !== workId)
+                    return null;
+                return source(String(item.title), {
+                    category: item.category, content: item.content, tags: item.tags, status: item.status, authorNote: item.authorNote
+                }, item.versionNo ?? item.updatedAt);
+            }
+            if (sourceType === "character") {
+                const item = this.store.getCharacter(sourceId);
+                if (String(item.workId) !== workId)
+                    return null;
+                return source(`人物档案：${String(item.name)}`, {
+                    name: item.name, aliases: item.aliases, code: item.code, species: item.species, race: item.race,
+                    organizations: item.organizations, attributes: item.attributes, profile: item.profile,
+                    currentState: item.currentState, lockedFields: item.lockedFields
+                }, item.versionNo);
+            }
+            if (sourceType === "race") {
+                const item = this.store.getRace(sourceId);
+                if (String(item.workId) !== workId)
+                    return null;
+                return source(`种族设定：${String(item.name)}`, {
+                    name: item.name, description: item.description, lineage: item.lineage, settings: item.settings,
+                    effectiveSettings: item.effectiveSettings, members: item.members
+                }, item.versionNo);
+            }
+            if (sourceType === "organization") {
+                const item = this.store.getOrganization(sourceId);
+                if (String(item.workId) !== workId)
+                    return null;
+                return source(`组织设定：${String(item.name)}`, {
+                    name: item.name, description: item.description, settings: item.settings, members: item.members
+                }, item.versionNo);
+            }
+            if (sourceType === "timeline-track") {
+                const item = this.store.getTimelineTrack(sourceId);
+                if (String(item.workId) !== workId)
+                    return null;
+                return source(`时间轴：${String(item.name)}`, { name: item.name, description: item.description }, item.versionNo);
+            }
+            if (sourceType === "timeline-event") {
+                const item = this.store.getTimelineEvent(sourceId);
+                if (String(item.workId) !== workId)
+                    return null;
+                return source(`时间线事件：${String(item.name)}`, {
+                    name: item.name,
+                    description: item.description,
+                    eventType: item.eventType,
+                    timeLabel: item.timeLabel,
+                    participants: (Array.isArray(item.participantIds) ? item.participantIds : []).map((characterId) => {
+                        try {
+                            return { characterId, name: this.store.getCharacter(String(characterId)).name };
+                        }
+                        catch {
+                            return { characterId, name: "已删除角色" };
+                        }
+                    }),
+                    location: item.location,
+                    causes: item.causes,
+                    impactScope: item.impactScope,
+                    evidence: item.evidence,
+                    status: item.status
+                }, item.versionNo);
+            }
+            if (sourceType === "relationship") {
+                const item = this.store.getRelationship(sourceId);
+                if (String(item.workId) !== workId)
+                    return null;
+                const fromName = String(this.store.getCharacter(String(item.fromCharacterId)).name);
+                const toName = String(this.store.getCharacter(String(item.toCharacterId)).name);
+                return source(`人物关系：${fromName} / ${toName}`, {
+                    fromCharacter: { id: item.fromCharacterId, name: fromName },
+                    toCharacter: { id: item.toCharacterId, name: toName },
+                    category: item.category,
+                    subtype: item.subtype,
+                    keywords: item.keywords,
+                    directed: item.directed,
+                    currentStatus: item.currentStatus,
+                    timeRange: item.timeRange,
+                    confidence: item.confidence,
+                    evidence: item.evidence,
+                    confirmationStatus: item.confirmationStatus,
+                    locked: item.locked
+                }, item.versionNo);
+            }
+            if (sourceType === "chapter-outline") {
+                const item = this.store.getChapterOutline(sourceId);
+                if (!item || String(item.workId) !== workId)
+                    return null;
+                const volumeTitle = String(this.store.getVolume(String(item.volumeId)).title);
+                return source(`章节大纲：${volumeTitle} / ${String(item.chapterTitle)}`, {
+                    chapterTitle: item.chapterTitle,
+                    volumeTitle,
+                    goal: item.goal,
+                    conflict: item.conflict,
+                    turningPoint: item.turningPoint,
+                    notes: item.notes,
+                    status: item.status
+                }, item.versionNo ?? item.updatedAt);
+            }
+            if (sourceType === "foreshadow") {
+                const item = this.store.getForeshadow(sourceId);
+                if (String(item.workId) !== workId)
+                    return null;
+                return source(`伏笔：${String(item.title)}`, {
+                    title: item.title,
+                    description: item.description,
+                    status: item.status,
+                    importance: item.importance,
+                    resolutionNote: item.resolutionNote,
+                    occurrences: item.occurrences
+                }, item.versionNo);
+            }
+            if (sourceType === "review") {
+                const item = this.store.getReviewItem(sourceId);
+                if (String(item.workId) !== workId)
+                    return null;
+                return source(`审核项：${String(item.title)}`, {
+                    itemType: item.itemType,
+                    severity: item.severity,
+                    title: item.title,
+                    description: item.description,
+                    evidence: item.evidence,
+                    suggestion: item.suggestion,
+                    status: item.status,
+                    resolutionNote: item.resolutionNote
+                }, item.updatedAt);
+            }
+        }
+        catch {
+            return null;
+        }
+        return null;
+    }
+    relationshipSettingSources(workId, characters) {
+        const refs = [
+            ["work", workId],
+            ...this.store.listSettings(workId).map((item) => ["setting", String(item.id)]),
+            ...characters.map((item) => ["character", String(item.id)]),
+            ...this.store.listRaces(workId).map((item) => ["race", String(item.id)]),
+            ...this.store.listOrganizations(workId).map((item) => ["organization", String(item.id)]),
+            ...this.store.listTimelineTracks(workId).map((item) => ["timeline-track", String(item.id)]),
+            ...this.store.listTimelineEvents(workId).map((item) => ["timeline-event", String(item.id)]),
+            ...this.store.listRelationships(workId).map((item) => ["relationship", String(item.id)]),
+            ...this.store.listChapterOutlines(workId).map((item) => ["chapter-outline", String(item.chapterId)]),
+            ...this.store.listForeshadows(workId).map((item) => ["foreshadow", String(item.id)]),
+            ...this.store.listReviewItems(workId).map((item) => ["review", String(item.id)])
+        ];
+        return refs.flatMap(([sourceType, sourceId]) => {
+            const materialized = this.relationshipSettingSource(workId, sourceType, sourceId);
+            return materialized ? [materialized] : [];
+        });
+    }
     async runRelationshipAnalysis(workId, scope, modelId, taskId) {
         const characters = this.store.listCharacters(workId);
         if (characters.length < 2)
             throw new AppError(409, "CHARACTERS_REQUIRED", "人物关系分析至少需要两个角色档案");
+        const settingsOnly = scope.type === "settings";
         const selectedCharacterIds = new Set(scope.characterIds ?? []);
         for (const characterId of selectedCharacterIds) {
             const character = characters.find((item) => item.id === characterId);
@@ -3332,33 +4191,86 @@ export class AiManager {
             .filter((character) => selectedCharacterIds.has(String(character.id)))
             .map((character) => `${String(character.id)} | ${String(character.name)}`)
             .join("\n");
-        const chapters = this.getScopeChapters(workId, scope);
-        if (chapters.length === 0)
-            throw new AppError(409, "CHAPTERS_REQUIRED", "人物关系分析范围内没有章节");
-        const chunks = this.buildChapterChunks(chapters, 12_000);
+        const sourceSelection = targeted
+            ? await this.selectRelationshipSources(workId, scope, characters, selectedCharacterIds, modelId, taskId)
+            : null;
+        const scopedChapters = targeted ? [] : settingsOnly ? [] : this.getScopeChapters(workId, scope);
+        const chapters = sourceSelection?.chapters ?? scopedChapters;
+        const availableSettings = targeted ? [] : settingsOnly || scope.includeAllSettings === true
+            ? this.relationshipSettingSources(workId, characters)
+            : [];
+        const settings = sourceSelection?.settings ?? availableSettings;
+        if (!targeted && settingsOnly && availableSettings.length === 0)
+            throw new AppError(409, "SETTINGS_REQUIRED", "人物关系分析范围内没有设定数据");
+        if (!targeted && !settingsOnly && scopedChapters.length === 0 && availableSettings.length === 0) {
+            throw new AppError(409, "RELATIONSHIP_SOURCES_REQUIRED", "人物关系分析范围内没有章节或设定数据");
+        }
+        const chunks = [
+            ...this.buildChapterChunks(chapters, 12_000).map((chunk) => ({ ...chunk, sourceKind: "chapter" })),
+            ...this.buildSettingChunks(settings, 12_000).map((chunk) => ({ ...chunk, sourceKind: "setting" }))
+        ];
+        if (targeted && chunks.length === 0) {
+            return {
+                relationshipIds: [],
+                candidateCount: 0,
+                rawCandidateCount: 0,
+                skipped: [{ index: -1, reason: "没有章节或设定数据命中被分析角色的名称或别名" }],
+                batchCount: 0,
+                coveredChapterCount: 0,
+                coveredSettingCount: 0,
+                fallbackSegmentCount: 0,
+                policyOmittedSegmentCount: 0,
+                targetedCharacterIds: [...selectedCharacterIds],
+                targetedEvidenceCount: 0,
+                aggregationBatchCount: 0,
+                replacedRelationshipCount: 0,
+                sourceSelection: sourceSelection?.summary,
+                callIds: sourceSelection?.verificationCallIds ?? []
+            };
+        }
         const concurrency = this.configuredConcurrency(workId, "relationship-analysis", modelId);
         const roster = characters.map((character) => {
             const aliases = character.aliases.filter((alias) => this.isSafeGlobalAlias(alias));
             return `${String(character.id)} | ${String(character.name)}${aliases.length ? ` | 别名：${aliases.join("、")}` : ""}`;
         }).join("\n");
         const rawCandidates = [];
-        const callIds = [];
-        const extractChunk = async (text, maxAttempts = 3) => {
+        const chapterEvidenceCandidates = [];
+        const settingCandidates = [];
+        const callIds = [...(sourceSelection?.verificationCallIds ?? [])];
+        const settingsInstruction = [
+            "你是小说人物关系设定抽取器，不是续写者。只根据本批系统设定数据抽取角色规范表中人物之间被明确写出的长期关系。",
+            ...(targeted ? ["被分析角色：", targetedRoster, "只输出至少一端属于被分析角色的关系。"] : []),
+            "完整角色规范表：",
+            roster,
+            "硬规则：",
+            "1. 本批 SETTING 条目是本次唯一事实来源；它可能来自作品设定、人物档案、种族、组织、时间线、已有关系、大纲、伏笔或审核项，不得引用未提供的数据或常识补全关系。",
+            "2. 人名、别名、昵称和拼写变体必须归一到唯一 characterId，禁止创造角色或把相似名字强行合并。",
+            "3. 只抽取条目明确陈述的长期亲属、社会、情感或冲突关系；同场出现、同属阵营、相似背景和推测性措辞不能生成关系。",
+            "4. 父母→子女、君王→臣属、导师→学生、施害者→受害者、倾慕者→被倾慕者使用 directed=true；伴侣、朋友、手足、盟友、互为宿敌使用 directed=false。",
+            "5. category 只能是 family、social、emotional、conflict、uncertain；confidence 低于 0.6 不输出。",
+            "6. subtype 使用简短稳定中文词；同一人物对、同一 category、同一 subtype 只输出一次，不得输出反向重复边。",
+            "7. keywords 提供 2 至 8 个描述双方互动、权力结构、情感阶段或剧情张力的中文关键词。",
+            "8. 每条 evidence 必须提供 settingId、settingTitle、quote、supports；quote 必须是对应设定条目中的连续原文短句且不超过 80 字。",
+            "9. evidence 的 quote 和 supports 必须能共同识别关系双方及关系类型，不能只凭一方名字或模糊代词建立关系。",
+            "10. 输出 JSON 数组。字段：fromCharacterId、toCharacterId、category、subtype、keywords、directed、currentStatus、timeRange、confidence、evidence。没有明确关系时输出 []。"
+        ].join("\n");
+        const extractChunk = async (chunk, maxAttempts = 3) => {
             const generated = await this.generateTaggedJson({
                 workId,
                 taskId,
                 taskType: "relationship-analysis",
                 signal: this.taskSignal(taskId),
                 maxAttempts,
-                scope: {
-                    type: "selection",
-                    selection: text,
-                    includeAllSettings: scope.includeAllSettings,
-                    ...(targeted ? { characterIds: [...selectedCharacterIds], excludeRelationshipConstraints: scope.replaceExistingRelationships === true } : {})
-                },
+                scope: chunk.sourceKind === "setting"
+                    ? { type: "settings", selection: chunk.text }
+                    : {
+                        type: "selection",
+                        selection: chunk.text,
+                        ...(targeted ? { suppressAutomaticContext: true } : {})
+                    },
                 ...(modelId ? { modelId } : {}),
                 parameters: { temperature: 0.1 },
-                instruction: targeted ? [
+                instruction: chunk.sourceKind === "setting" ? settingsInstruction : targeted ? [
                     "你是定向人物关系证据收集器。本阶段只建立跨章节证据账本，不下最终关系结论。",
                     "被分析角色：",
                     targetedRoster,
@@ -3403,9 +4315,11 @@ export class AiManager {
                     "24. 共同执行一次任务、同属一个组织、在同一集体场景中被感谢或落泪、替第三人转发消息，都不能单独证明同事、朋友或盟友。此类关系必须有原文明示身份，或至少两个不同章节的持续互动证据。"
                 ].join("\n"),
                 extraSystemPrompt: [
-                    targeted
-                        ? "你正在为指定角色收集可审计的跨章节关系线索。不得在证据收集阶段把单次互动直接判定为长期关系。"
-                        : "关系候选必须可审计。严禁把梦境伴侣、醉后梦话、单次约定、同章共现、礼称、同族归属、救援照护或类比提及写成现实长期关系。逐句校验说话人和关系方向。",
+                    chunk.sourceKind === "setting"
+                        ? "本次只允许使用提供的系统设定条目。每条结论都必须能回溯到对应 settingId 的原文引文。"
+                        : targeted
+                            ? "你正在为指定角色收集可审计的跨章节关系线索。不得在证据收集阶段把单次互动直接判定为长期关系。"
+                            : "关系候选必须可审计。严禁把梦境伴侣、醉后梦话、单次约定、同章共现、礼称、同族归属、救援照护或类比提及写成现实长期关系。逐句校验说话人和关系方向。",
                     scope.additionalPrompt?.trim() ? `作者追加的关系分析提示：\n${scope.additionalPrompt.trim()}` : ""
                 ].filter(Boolean).join("\n\n")
             });
@@ -3419,26 +4333,32 @@ export class AiManager {
         };
         const chunkResults = await this.processChunks(chunks, concurrency, async (chunk) => {
             if (taskId && this.store.getTask(taskId).status !== "running") {
-                return { candidates: [], callIds: [], fallbackSegmentCount: 0, policyOmittedSegmentCount: 0 };
+                return { sourceKind: chunk.sourceKind, candidates: [], callIds: [], fallbackSegmentCount: 0, policyOmittedSegmentCount: 0 };
             }
             try {
-                const extracted = await extractChunk(chunk.text, 1);
-                return { candidates: extracted.candidates, callIds: [extracted.callId], fallbackSegmentCount: 0, policyOmittedSegmentCount: 0 };
+                const extracted = await extractChunk(chunk, 1);
+                return { sourceKind: chunk.sourceKind, candidates: extracted.candidates, callIds: [extracted.callId], fallbackSegmentCount: 0, policyOmittedSegmentCount: 0 };
             }
             catch {
+                if (chunk.sourceKind === "setting")
+                    throw new AppError(502, "AI_SETTINGS_BATCH_FAILED", "设定数据人物关系分析批次失败");
                 const segments = this.splitMarkedChapters(chunk.text);
-                return this.runChapterSegmentFallback(segments, taskId, extractChunk, undefined, concurrency);
+                const fallback = await this.runChapterSegmentFallback(segments, taskId, async (text, maxAttempts) => extractChunk({ sourceKind: "chapter", text }, maxAttempts), undefined, concurrency);
+                return { sourceKind: chunk.sourceKind, ...fallback };
             }
         }, (completed) => {
             if (taskId && this.store.getTask(taskId).status === "running") {
-                const maximumProgress = targeted ? 72 : 92;
+                const maximumProgress = targeted && !settingsOnly ? 72 : 92;
                 this.store.updateTask(taskId, { status: "running", progress: Math.min(maximumProgress, 5 + Math.round(completed / chunks.length * (maximumProgress - 5))) });
             }
         });
         let fallbackSegmentCount = 0;
         let policyOmittedSegmentCount = 0;
         for (const result of chunkResults) {
-            rawCandidates.push(...result.candidates);
+            if (result.sourceKind === "setting")
+                settingCandidates.push(...result.candidates);
+            else
+                chapterEvidenceCandidates.push(...result.candidates);
             callIds.push(...result.callIds);
             fallbackSegmentCount += result.fallbackSegmentCount;
             policyOmittedSegmentCount += result.policyOmittedSegmentCount;
@@ -3453,11 +4373,13 @@ export class AiManager {
                 batchCount: chunks.length
             });
         }
-        const targetedEvidenceCount = targeted ? rawCandidates.length : 0;
+        if (!targeted)
+            rawCandidates.push(...chapterEvidenceCandidates, ...settingCandidates);
+        const targetedEvidenceCount = targeted ? chapterEvidenceCandidates.length + settingCandidates.length : 0;
         let aggregationBatchCount = 0;
-        if (targeted && rawCandidates.length > 0) {
+        if (targeted && !settingsOnly && chapterEvidenceCandidates.length > 0) {
             const evidenceGroups = new Map();
-            for (const evidence of rawCandidates) {
+            for (const evidence of chapterEvidenceCandidates) {
                 const target = String(evidence.targetCharacterId ?? "");
                 const related = String(evidence.relatedCharacterId ?? evidence.relatedReference ?? "unknown");
                 const key = `${target}|${related}`;
@@ -3490,9 +4412,7 @@ export class AiManager {
                     maxAttempts: 2,
                     scope: {
                         type: "entities",
-                        includeAllSettings: scope.includeAllSettings,
-                        characterIds: [...selectedCharacterIds],
-                        excludeRelationshipConstraints: scope.replaceExistingRelationships === true
+                        suppressAutomaticContext: true
                     },
                     ...(modelId ? { modelId } : {}),
                     parameters: { temperature: 0.1 },
@@ -3532,10 +4452,14 @@ export class AiManager {
                     this.store.updateTask(taskId, { status: "running", progress: Math.min(92, 72 + Math.round(completed / evidenceBatches.length * 20)) });
                 }
             });
-            rawCandidates.splice(0, rawCandidates.length, ...aggregationResults.flatMap((result) => result.candidates));
+            rawCandidates.push(...aggregationResults.flatMap((result) => result.candidates));
             callIds.push(...aggregationResults.map((result) => result.callId));
         }
+        if (targeted)
+            rawCandidates.push(...settingCandidates);
         const chapterById = new Map(chapters.map((chapter) => [String(chapter.id), chapter]));
+        const settingById = new Map(settings.map((setting) => [String(setting.id), setting]));
+        const relationshipEvidenceKey = (item) => `${String(item.settingId ?? item.chapterId)}|${String(item.quote)}`;
         const categories = new Set(["family", "social", "emotional", "conflict", "uncertain"]);
         const merged = new Map();
         const skipped = [];
@@ -3584,21 +4508,36 @@ export class AiManager {
                 [fromCharacterId, toCharacterId] = [toCharacterId, fromCharacterId];
             const evidence = (Array.isArray(candidate.evidence) ? candidate.evidence : [])
                 .filter((item) => Boolean(item) && typeof item === "object" && !Array.isArray(item))
-                .filter((item) => {
-                if (typeof item.chapterId !== "string" || typeof item.quote !== "string" || item.quote.trim().length > 80)
-                    return false;
+                .flatMap((item) => {
+                if (typeof item.quote !== "string" || item.quote.trim().length > 80)
+                    return [];
+                if (typeof item.settingId === "string") {
+                    const setting = settingById.get(item.settingId);
+                    if (!setting || !this.quoteExists(String(setting.content), item.quote))
+                        return [];
+                    return [{
+                            settingId: item.settingId,
+                            settingTitle: String(setting.title),
+                            quote: item.quote.trim(),
+                            contextType: "setting",
+                            supports: typeof item.supports === "string" ? item.supports : ""
+                        }];
+                }
+                if (typeof item.chapterId !== "string")
+                    return [];
                 const chapter = chapterById.get(item.chapterId);
-                return Boolean(chapter && this.quoteExists(String(chapter.content), item.quote));
-            })
-                .map((item) => ({
-                chapterId: item.chapterId,
-                chapterTitle: String(chapterById.get(String(item.chapterId))?.title ?? ""),
-                quote: String(item.quote).trim(),
-                contextType: typeof item.contextType === "string" ? item.contextType : "current",
-                supports: typeof item.supports === "string" ? item.supports : ""
-            }));
+                if (!chapter || !this.quoteExists(String(chapter.content), item.quote))
+                    return [];
+                return [{
+                        chapterId: item.chapterId,
+                        chapterTitle: String(chapter.title),
+                        quote: item.quote.trim(),
+                        contextType: typeof item.contextType === "string" ? item.contextType : "current",
+                        supports: typeof item.supports === "string" ? item.supports : ""
+                    }];
+            });
             if (evidence.length === 0) {
-                skipped.push({ index, reason: "证据引文未在对应章节原文命中" });
+                skipped.push({ index, reason: "证据引文未在对应章节或设定条目命中" });
                 return;
             }
             const evidenceText = evidence.map((item) => String(item.quote)).join("\n");
@@ -3618,9 +4557,9 @@ export class AiManager {
                 }
             }
             if (category === "conflict" && subtype === "宿敌") {
-                const evidenceChapters = new Set(evidence.map((item) => String(item.chapterId)));
+                const evidenceSources = new Set(evidence.map((item) => String(item.settingId ?? item.chapterId)));
                 const explicitlyLongRunning = /宿敌|世仇|死敌|多年|长期|世代|一直.{0,24}(?:敌|威胁|对抗|杀手)|远古.{0,16}(?:战|敌)|多次.{0,16}(?:交战|对抗|冲突)/u.test(evidenceText);
-                if (evidenceChapters.size < 2 && !explicitlyLongRunning)
+                if (evidenceSources.size < 2 && !explicitlyLongRunning)
                     subtype = "战时敌对";
             }
             const key = [fromCharacterId, toCharacterId, category, this.normalizeReference(subtype), directed ? "1" : "0"].join("|");
@@ -3629,9 +4568,9 @@ export class AiManager {
                 current.confidence = Math.max(current.confidence, confidence);
                 current.currentStatus = currentStatus || current.currentStatus;
                 current.keywords = [...new Set([...current.keywords, ...keywords])].slice(0, 8);
-                const seenEvidence = new Set(current.evidence.map((item) => `${String(item.chapterId)}|${String(item.quote)}`));
+                const seenEvidence = new Set(current.evidence.map(relationshipEvidenceKey));
                 for (const item of evidence) {
-                    const evidenceKey = `${String(item.chapterId)}|${String(item.quote)}`;
+                    const evidenceKey = relationshipEvidenceKey(item);
                     if (!seenEvidence.has(evidenceKey))
                         current.evidence.push(item);
                 }
@@ -3656,20 +4595,30 @@ export class AiManager {
             const durablePeerSubtype = /同事|同僚|共事|搭档|伙伴|朋友|好友|挚友|老友|旧友|战友|盟友|同盟|联盟/u.test(candidate.subtype);
             if (candidate.category !== "social" || !durablePeerSubtype)
                 continue;
-            const evidenceChapters = new Set(candidate.evidence.map((item) => String(item.chapterId)));
+            const evidenceSources = new Set(candidate.evidence.map((item) => String(item.settingId ?? item.chapterId)));
             const evidenceText = candidate.evidence.map((item) => String(item.quote)).join("\n");
             const explicitlyLongRunning = /同事|同僚|共事|搭档|伙伴|朋友|好友|挚友|老友|旧友|老朋友|战友|盟友|同盟|联盟|结盟|缔盟|盟约|旧识|好久不见|多年|长期|几十年|经常|往日|一直.{0,16}(?:合作|支援|互助|并肩)/u.test(evidenceText);
-            if (evidenceChapters.size >= 2 || explicitlyLongRunning)
+            if (evidenceSources.size >= 2 || explicitlyLongRunning)
                 continue;
-            skipped.push({ index: -1, reason: `“${candidate.subtype}”缺少明确身份或跨章长期互动证据` });
+            skipped.push({ index: -1, reason: candidate.evidence.every((item) => item.contextType === "setting")
+                    ? `“${candidate.subtype}”缺少设定集中的明确长期关系表述`
+                    : `“${candidate.subtype}”缺少明确身份或跨章长期互动证据` });
             merged.delete(key);
         }
         const relationshipIds = [];
+        const relationshipOutcomes = new Map();
+        const recordRelationshipOutcome = (action, relationship) => {
+            const relationshipId = String(relationship.id);
+            const previous = relationshipOutcomes.get(relationshipId);
+            relationshipOutcomes.set(relationshipId, {
+                action: previous?.action === "created" ? "created" : action,
+                relationship
+            });
+        };
         let replacedRelationshipCount = 0;
+        if (!this.taskCanCommit(taskId))
+            return { interrupted: true, callIds };
         this.store.db.transaction(() => {
-            if (!targeted && scope.type === "book") {
-                this.store.db.run("DELETE FROM relationships WHERE work_id = ? AND confirmation_status = 'pending' AND locked = 0", workId);
-            }
             if (targeted && scope.replaceExistingRelationships === true) {
                 const relationshipsToReplace = this.store.listRelationships(workId).filter((relationship) => selectedCharacterIds.has(String(relationship.fromCharacterId)) || selectedCharacterIds.has(String(relationship.toCharacterId)));
                 for (const relationship of relationshipsToReplace)
@@ -3677,6 +4626,7 @@ export class AiManager {
                 replacedRelationshipCount = relationshipsToReplace.length;
             }
             const existing = this.store.listRelationships(workId).filter((relationship) => relationship.confirmationStatus !== "rejected");
+            const appendOnly = scope.replaceExistingRelationships !== true;
             const unorderedPairKey = (fromCharacterId, toCharacterId) => {
                 const pair = [String(fromCharacterId), String(toCharacterId)].sort((left, right) => left.localeCompare(right));
                 return `${pair[0]}|${pair[1]}`;
@@ -3794,11 +4744,15 @@ export class AiManager {
                 });
                 if (duplicateIndex >= 0) {
                     const duplicate = existing[duplicateIndex];
+                    if (appendOnly) {
+                        skipped.push({ index: -1, reason: `已有相同的“${candidate.subtype}”关系，追加模式不更新` });
+                        continue;
+                    }
                     if (duplicate.confirmationStatus === "pending" && duplicate.locked !== true) {
                         const mergedEvidence = [...(duplicate.evidence ?? [])];
-                        const seenEvidence = new Set(mergedEvidence.map((item) => `${String(item.chapterId)}|${String(item.quote)}`));
+                        const seenEvidence = new Set(mergedEvidence.map(relationshipEvidenceKey));
                         for (const item of candidate.evidence) {
-                            const evidenceKey = `${String(item.chapterId)}|${String(item.quote)}`;
+                            const evidenceKey = relationshipEvidenceKey(item);
                             if (!seenEvidence.has(evidenceKey))
                                 mergedEvidence.push(item);
                         }
@@ -3810,6 +4764,10 @@ export class AiManager {
                             timeRange: candidate.timeRange,
                             evidence: mergedEvidence
                         }, "analysis", taskId ?? null, "AI 合并关系证据");
+                        recordRelationshipOutcome("updated", existing[duplicateIndex]);
+                    }
+                    else {
+                        recordRelationshipOutcome("unchanged", duplicate);
                     }
                     if (candidatePeerStrength > 0) {
                         for (let index = existing.length - 1; index >= 0; index -= 1) {
@@ -3840,12 +4798,12 @@ export class AiManager {
                         && peerSocialStrength(relationship) > 0
                         && peerSocialStrength(relationship) < candidatePeerStrength)
                     : -1;
-                if (weakerExistingPeerIndex >= 0) {
+                if (weakerExistingPeerIndex >= 0 && !appendOnly) {
                     const weaker = existing[weakerExistingPeerIndex];
                     const mergedEvidence = [...(weaker.evidence ?? [])];
-                    const seenEvidence = new Set(mergedEvidence.map((item) => `${String(item.chapterId)}|${String(item.quote)}`));
+                    const seenEvidence = new Set(mergedEvidence.map(relationshipEvidenceKey));
                     for (const item of candidate.evidence) {
-                        const evidenceKey = `${String(item.chapterId)}|${String(item.quote)}`;
+                        const evidenceKey = relationshipEvidenceKey(item);
                         if (!seenEvidence.has(evidenceKey))
                             mergedEvidence.push(item);
                     }
@@ -3857,18 +4815,106 @@ export class AiManager {
                         timeRange: candidate.timeRange,
                         evidence: mergedEvidence
                     }, "analysis", taskId ?? null, "AI 更新关系强度");
+                    recordRelationshipOutcome("updated", existing[weakerExistingPeerIndex]);
                     continue;
                 }
                 const relationship = this.store.createRelationship(workId, { ...candidate, confirmationStatus: "pending", locked: false }, "analysis", taskId ?? null);
                 relationshipIds.push(String(relationship.id));
+                recordRelationshipOutcome("created", relationship);
                 existing.push(relationship);
             }
+            if (taskId && settingsOnly)
+                this.store.refreshTaskSourceVersions(taskId);
         });
+        if (sourceSelection) {
+            const acceptedVariants = sourceSelection.variantDecisions.filter((decision) => decision.verdict === "same" && decision.confidence >= 0.8);
+            const reviewIds = new Set();
+            this.store.db.transaction(() => {
+                for (const decision of acceptedVariants) {
+                    const observedIndex = decision.snippet.indexOf(decision.observed);
+                    const quote = observedIndex < 0
+                        ? decision.snippet.slice(0, 160)
+                        : decision.snippet.slice(Math.max(0, observedIndex - 60), Math.min(decision.snippet.length, observedIndex + decision.observed.length + 60));
+                    const dedupeKey = this.store.hashContent([
+                        decision.targetCharacterId,
+                        normalizeRelationshipSearchText(decision.observed),
+                        decision.sourceType,
+                        decision.sourceId,
+                        decision.sourceVersion
+                    ].join("|"));
+                    const review = this.store.createReviewItem(workId, {
+                        itemType: "character-name-variant",
+                        dedupeKey,
+                        severity: "medium",
+                        title: `疑似人物名错字：${decision.observed} → ${decision.targetName}`,
+                        description: `AI 判断来源“${decision.sourceTitle}”中的“${decision.observed}”可能指向人物“${decision.targetName}”。`,
+                        entityRefs: [{
+                                characterId: decision.targetCharacterId,
+                                sourceType: decision.sourceType,
+                                sourceId: decision.sourceId,
+                                sourceVersion: decision.sourceVersion
+                            }],
+                        evidence: [{
+                                sourceType: decision.sourceType,
+                                sourceId: decision.sourceId,
+                                sourceTitle: decision.sourceTitle,
+                                sourceVersion: decision.sourceVersion,
+                                observed: decision.observed,
+                                quote,
+                                confidence: decision.confidence,
+                                reason: decision.reason
+                            }],
+                        suggestion: `请核对“${decision.observed}”是否为“${decision.targetName}”的错别字；确认后再修改原文或登记别名。`,
+                        status: "pending"
+                    });
+                    reviewIds.add(String(review.id));
+                }
+            });
+            sourceSelection.summary.reviewIds = [...reviewIds];
+        }
+        const characterNameById = new Map(characters.map((character) => [String(character.id), String(character.name)]));
+        const relationshipResults = [...relationshipOutcomes.values()].map(({ action, relationship }) => {
+            const evidence = Array.isArray(relationship.evidence)
+                ? relationship.evidence.filter((item) => Boolean(item) && typeof item === "object" && !Array.isArray(item))
+                : [];
+            return {
+                relationshipId: String(relationship.id),
+                action,
+                fromCharacterId: String(relationship.fromCharacterId),
+                fromCharacterName: characterNameById.get(String(relationship.fromCharacterId)) ?? String(relationship.fromCharacterId),
+                toCharacterId: String(relationship.toCharacterId),
+                toCharacterName: characterNameById.get(String(relationship.toCharacterId)) ?? String(relationship.toCharacterId),
+                category: String(relationship.category),
+                subtype: String(relationship.subtype),
+                keywords: Array.isArray(relationship.keywords) ? relationship.keywords.map(String) : [],
+                directed: Boolean(relationship.directed),
+                currentStatus: String(relationship.currentStatus ?? ""),
+                timeRange: relationship.timeRange && typeof relationship.timeRange === "object" && !Array.isArray(relationship.timeRange)
+                    ? relationship.timeRange
+                    : {},
+                confidence: Number(relationship.confidence ?? 0),
+                confirmationStatus: String(relationship.confirmationStatus ?? "pending"),
+                evidenceCount: evidence.length,
+                evidence: evidence.slice(0, 3).map((item) => ({
+                    chapterId: String(item.chapterId ?? ""),
+                    chapterTitle: String(item.chapterTitle ?? chapterById.get(String(item.chapterId))?.title ?? ""),
+                    quote: String(item.quote ?? ""),
+                    supports: String(item.supports ?? "")
+                })),
+                evidenceTruncated: evidence.length > 3
+            };
+        });
+        const createdCount = relationshipResults.filter((item) => item.action === "created").length;
+        const updatedCount = relationshipResults.filter((item) => item.action === "updated").length;
+        const unchangedCount = relationshipResults.filter((item) => item.action === "unchanged").length;
         this.store.audit(workId, "relationship.analysis.completed", "work", workId, {
             batchCount: chunks.length,
             coveredChapterCount: chapters.length,
+            coveredSettingCount: settings.length,
             rawCandidateCount: rawCandidates.length,
             savedCount: relationshipIds.length,
+            updatedCount,
+            unchangedCount,
             skippedCount: skipped.length,
             fallbackSegmentCount,
             policyOmittedSegmentCount,
@@ -3881,16 +4927,32 @@ export class AiManager {
         return {
             relationshipIds,
             candidateCount: relationshipIds.length,
+            createdCount,
+            updatedCount,
+            unchangedCount,
+            relationshipResults,
+            analysisTarget: {
+                mode: targeted ? "targeted-characters" : "all-relationships",
+                scopeType: scope.type,
+                characterIds: [...selectedCharacterIds],
+                characterNames: characters
+                    .filter((character) => selectedCharacterIds.has(String(character.id)))
+                    .map((character) => String(character.name)),
+                coveredChapterCount: chapters.length,
+                includeAllSettings: scope.includeAllSettings === true
+            },
             rawCandidateCount: rawCandidates.length,
             skipped,
             batchCount: chunks.length,
             coveredChapterCount: chapters.length,
+            coveredSettingCount: settings.length,
             fallbackSegmentCount,
             policyOmittedSegmentCount,
             targetedCharacterIds: [...selectedCharacterIds],
             targetedEvidenceCount,
             aggregationBatchCount,
             replacedRelationshipCount,
+            ...(sourceSelection ? { sourceSelection: sourceSelection.summary } : {}),
             callIds
         };
     }
@@ -3980,6 +5042,29 @@ export class AiManager {
         flush();
         return chunks;
     }
+    buildSettingChunks(settings, maximumChars = 10_000) {
+        const chunks = [];
+        let text = "";
+        let settingIds = [];
+        const flush = () => {
+            if (settingIds.length === 0)
+                return;
+            chunks.push({ text, settingIds });
+            text = "";
+            settingIds = [];
+        };
+        for (const setting of settings) {
+            const block = `<SETTING id="${String(setting.id)}" title="${String(setting.title).replaceAll('"', "'")}">\n${String(setting.content)}\n</SETTING>\n`;
+            if (settingIds.length > 0 && text.length + block.length > maximumChars)
+                flush();
+            text += block;
+            settingIds.push(String(setting.id));
+            if (text.length >= maximumChars)
+                flush();
+        }
+        flush();
+        return chunks;
+    }
     splitMarkedChapters(text) {
         const segments = text.match(/<CHAPTER\b[^>]*>[\s\S]*?<\/CHAPTER>/gu) ?? [];
         return segments.length > 0 ? segments : [text];
@@ -4354,6 +5439,17 @@ export class AiManager {
         this.assertAvailable(provider, model);
         return { model, provider };
     }
+    analysisTaskModelPurpose(taskType) {
+        if (taskType === "timeline-analysis")
+            return "timeline-analysis";
+        if (taskType === "relationship-analysis")
+            return "relationship-analysis";
+        if (taskType === "consistency-check")
+            return "consistency-check";
+        if (taskType === "chapter-analysis")
+            return "chapter-analysis";
+        return "book-analysis";
+    }
     configuredConcurrency(workId, taskType, modelId) {
         const { provider } = this.resolveModel(workId, taskType, modelId);
         return Math.round(clamp(numberValue(provider, "concurrency_limit") || 10, 1, 100));