@musnows/scriverse 0.3.10 → 0.4.0

package/dist/store.js

@@ -6,6 +6,72 @@ import { paginated, paginationSql } from "./pagination.js";
 import { currentRequestActor } from "./request-context.js";
 import { classifyWorkModulePermissions, emptyWorkModulePermissions, fullWorkModulePermissions, storedWorkModulePermissions } from "./work-permissions.js";
 import { countWords, documentShortSearchTerms, id, json, normalizeDocumentSearchText, normalizeParagraphSpacing, now, splitDocumentParagraphs } from "./utils.js";
+function settingsFromInput(settingsMarkdown, settings, fallback = []) {
+    if (settingsMarkdown !== undefined)
+        return settingsMarkdown.trim() ? [settingsMarkdown] : [];
+    return settings ?? fallback;
+}
+function settingsMarkdownFromList(settings) {
+    return Array.isArray(settings) ? settings.map(String).filter(Boolean).join("\n\n") : "";
+}
+function knowledgeSectionTitle(contentMarkdown, index) {
+    const heading = contentMarkdown.match(/^\s{0,3}#{1,6}\s+(.+?)\s*#*\s*$/mu)?.[1]?.trim();
+    return heading || `设定 ${index + 1}`;
+}
+function normalizeKnowledgeSections(sections) {
+    return sections.map((section, index) => {
+        const contentMarkdown = section.contentMarkdown ?? "";
+        return {
+            title: section.title.trim() || knowledgeSectionTitle(contentMarkdown, index),
+            contentMarkdown,
+            summary: section.summary?.trim() ?? "",
+            sortOrder: Number.isFinite(section.sortOrder) ? Math.max(0, Math.trunc(section.sortOrder)) : index
+        };
+    });
+}
+function knowledgeSectionInput(value, index) {
+    if (!isRecord(value))
+        return null;
+    const contentMarkdown = typeof value.contentMarkdown === "string"
+        ? value.contentMarkdown
+        : typeof value.content === "string" ? value.content : "";
+    const title = typeof value.title === "string" ? value.title : "";
+    return {
+        title: title || knowledgeSectionTitle(contentMarkdown, index),
+        contentMarkdown,
+        summary: typeof value.summary === "string" ? value.summary : "",
+        sortOrder: typeof value.sortOrder === "number" ? value.sortOrder : index
+    };
+}
+function knowledgeSectionsFromStored(value, fallback = []) {
+    const parsed = typeof value === "string" ? json(value, []) : value;
+    if (Array.isArray(parsed)) {
+        const sections = parsed.map((item, index) => knowledgeSectionInput(item, index)).filter((item) => item !== null);
+        if (sections.length > 0 || fallback.length === 0)
+            return normalizeKnowledgeSections(sections);
+    }
+    return normalizeKnowledgeSections(fallback.map((contentMarkdown, index) => ({
+        title: knowledgeSectionTitle(contentMarkdown, index),
+        contentMarkdown,
+        sortOrder: index
+    })));
+}
+function knowledgeSectionsFromInput(sections, settingsMarkdown, settings, fallbackSections = []) {
+    if (sections !== undefined)
+        return normalizeKnowledgeSections(sections);
+    if (settingsMarkdown !== undefined || settings !== undefined) {
+        const legacySettings = settingsFromInput(settingsMarkdown, settings);
+        return knowledgeSectionsFromStored(legacySettings.map((contentMarkdown, index) => ({
+            title: knowledgeSectionTitle(contentMarkdown, index),
+            contentMarkdown,
+            sortOrder: index
+        })));
+    }
+    return fallbackSections;
+}
+function settingsFromKnowledgeSections(sections) {
+    return sections.map((section) => section.contentMarkdown).filter((content) => content.trim());
+}
 export const versionedEntityTypes = [
     "work",
     "volume",
@@ -18,6 +84,65 @@ export const versionedEntityTypes = [
     "chapter-outline",
     "foreshadow"
 ];
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function invalidFileSnapshot() {
+    throw new AppError(409, "FILE_VERSION_INVALID", "正文历史快照已损坏，未执行恢复");
+}
+function parseRestorableFileSnapshot(value, workId) {
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch {
+        invalidFileSnapshot();
+    }
+    if (!isRecord(parsed) || parsed.id !== workId || !Array.isArray(parsed.volumes) || parsed.volumes.length > 10_000) {
+        return invalidFileSnapshot();
+    }
+    let chapterCount = 0;
+    let contentLength = 0;
+    const volumes = parsed.volumes.map((volumeValue) => {
+        if (!isRecord(volumeValue) || typeof volumeValue.title !== "string" || typeof volumeValue.kind !== "string"
+            || typeof volumeValue.source !== "string" || typeof volumeValue.sortOrder !== "number"
+            || !Number.isFinite(volumeValue.sortOrder) || !Array.isArray(volumeValue.chapters)) {
+            return invalidFileSnapshot();
+        }
+        const description = volumeValue.description === undefined ? "" : volumeValue.description;
+        const keywords = volumeValue.keywords === undefined ? [] : volumeValue.keywords;
+        if (typeof description !== "string" || !Array.isArray(keywords) || !keywords.every((keyword) => typeof keyword === "string")) {
+            return invalidFileSnapshot();
+        }
+        const chapters = volumeValue.chapters.map((chapterValue) => {
+            if (!isRecord(chapterValue) || typeof chapterValue.title !== "string" || typeof chapterValue.content !== "string"
+                || typeof chapterValue.sortOrder !== "number" || !Number.isFinite(chapterValue.sortOrder)
+                || !["正文", "设定", "作者的话", "其他"].includes(String(chapterValue.chapterType))) {
+                return invalidFileSnapshot();
+            }
+            chapterCount += 1;
+            contentLength += chapterValue.content.length;
+            if (chapterCount > 100_000 || contentLength > 20_000_000)
+                return invalidFileSnapshot();
+            return {
+                title: chapterValue.title,
+                content: chapterValue.content,
+                sortOrder: chapterValue.sortOrder,
+                chapterType: chapterValue.chapterType
+            };
+        });
+        return {
+            title: volumeValue.title,
+            kind: volumeValue.kind,
+            source: volumeValue.source,
+            description,
+            keywords: [...keywords],
+            sortOrder: volumeValue.sortOrder,
+            chapters
+        };
+    });
+    return { volumes };
+}
 function requiredString(row, key) {
     return String(row[key] ?? "");
 }
@@ -145,6 +270,7 @@ export class Store {
                 parentRaceId: entity.parentRaceId,
                 description: entity.description,
                 settings: entity.settings,
+                settingsSections: entity.settingsSections,
                 memberIds: entity.memberIds
             };
         if (type === "organization")
@@ -152,6 +278,7 @@ export class Store {
                 name: entity.name,
                 description: entity.description,
                 settings: entity.settings,
+                settingsSections: entity.settingsSections,
                 memberIds: entity.memberIds
             };
         if (type === "timeline-track")
@@ -655,7 +782,7 @@ export class Store {
             .all(`SELECT version.id, version.work_id, version.file_name, version.file_type, version.word_count, version.paragraph_count,
         version.warnings_json, version.created_at, user.display_name AS actor_display_name, user.username AS actor_username
         FROM file_versions version LEFT JOIN users user ON user.id = version.created_by_user_id
-        WHERE version.work_id = ? ORDER BY version.created_at DESC`, workId)
+        WHERE version.work_id = ? ORDER BY version.created_at DESC, version.id DESC`, workId)
             .map((row) => ({
             id: requiredString(row, "id"),
             workId: requiredString(row, "work_id"),
@@ -674,7 +801,7 @@ export class Store {
         const rows = this.db.all(`SELECT version.id, version.work_id, version.file_name, version.file_type, version.word_count, version.paragraph_count,
         version.warnings_json, version.created_at, user.display_name AS actor_display_name, user.username AS actor_username
        FROM file_versions version LEFT JOIN users user ON user.id = version.created_by_user_id
-       WHERE version.work_id = ? ORDER BY version.created_at DESC${page.sql}`, workId, ...page.params);
+       WHERE version.work_id = ? ORDER BY version.created_at DESC, version.id DESC${page.sql}`, workId, ...page.params);
         return paginated(rows.map((row) => ({
             id: requiredString(row, "id"),
             workId: requiredString(row, "work_id"),
@@ -692,8 +819,7 @@ export class Store {
         const version = this.db.get("SELECT * FROM file_versions WHERE id = ? AND work_id = ?", fileVersionId, workId);
         if (!version)
             throw notFound("文件版本");
-        const snapshot = json(requiredString(version, "snapshot_json"), {});
-        const volumes = Array.isArray(snapshot.volumes) ? snapshot.volumes : [];
+        const { volumes } = parseRestorableFileSnapshot(requiredString(version, "snapshot_json"), workId);
         return this.db.transaction(() => {
             const current = this.getWork(workId);
             this.assertExpectedVersion("work", workId, expectedVersionNo, "作品", Number(current.versionNo));
@@ -714,20 +840,16 @@ export class Store {
             this.db.run("DELETE FROM volumes WHERE work_id = ?", workId);
             for (const volume of volumes) {
                 const volumeId = id("volume");
-                const chapters = Array.isArray(volume.chapters) ? volume.chapters : [];
                 this.insertVolumeWithId(workId, volumeId, {
-                    title: String(volume.title ?? "正文"),
-                    kind: String(volume.kind ?? "main"),
-                    source: String(volume.source ?? "manual"),
-                    description: String(volume.description ?? ""),
-                    keywords: Array.isArray(volume.keywords) ? volume.keywords : [],
-                    sortOrder: Number(volume.sortOrder ?? 0)
+                    title: volume.title,
+                    kind: volume.kind,
+                    source: volume.source,
+                    description: volume.description,
+                    keywords: volume.keywords,
+                    sortOrder: volume.sortOrder
                 }, "restore", fileVersionId, `恢复文件版本 ${fileVersionId}`);
-                for (const chapter of chapters) {
-                    const chapterType = (["正文", "设定", "作者的话", "其他"].includes(String(chapter.chapterType))
-                        ? String(chapter.chapterType)
-                        : "正文");
-                    this.insertChapter(workId, volumeId, String(chapter.title ?? "未命名章节"), String(chapter.content ?? ""), Number(chapter.sortOrder ?? 0), "restore", fileVersionId, chapterType);
+                for (const chapter of volume.chapters) {
+                    this.insertChapter(workId, volumeId, chapter.title, chapter.content, chapter.sortOrder, "restore", fileVersionId, chapter.chapterType);
                 }
             }
             this.db.run("UPDATE works SET version_no = version_no + 1, updated_at = ? WHERE id = ?", timestamp, workId);
@@ -1566,9 +1688,11 @@ export class Store {
     }
     insertSettingWithId(workId, settingId, input, source = "create", sourceRef = null, changeNote = "") {
         const timestamp = now();
+        const content = input.content;
         this.db.transaction(() => {
             this.db.run(`INSERT INTO settings (id, work_id, title, category, content, tags_json, status, locked, evidence_json, scope_json, author_note, created_at, updated_at)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, settingId, workId, input.title, input.category, input.content, JSON.stringify(input.tags ?? []), input.status ?? "draft", input.locked ? 1 : 0, JSON.stringify(input.evidence ?? []), JSON.stringify(input.scope ?? {}), input.authorNote ?? "", timestamp, timestamp);
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, settingId, workId, input.title, input.category, content, JSON.stringify(input.tags ?? []), input.status ?? "draft", input.locked ? 1 : 0, JSON.stringify(input.evidence ?? []), JSON.stringify(input.scope ?? {}), input.authorNote ?? "", timestamp, timestamp);
+            this.syncMarkdownAttachmentReferences(workId, "setting", settingId, content);
             this.recordEntityVersion("setting", settingId, source, sourceRef, changeNote || "建立世界观设定", timestamp);
             this.audit(workId, source === "restore" ? "setting.restored" : "setting.created", "setting", settingId, {
                 locked: input.locked ?? false,
@@ -1596,10 +1720,12 @@ export class Store {
     }
     updateSetting(settingId, input, source = "manual", sourceRef = null, changeNote = "", expectedVersionNo) {
         const current = this.getSetting(settingId);
+        const content = input.content ?? String(current.content);
         this.db.transaction(() => {
             this.assertExpectedVersion("setting", settingId, expectedVersionNo, "设定");
             this.db.run(`UPDATE settings SET title = ?, category = ?, content = ?, tags_json = ?, status = ?, locked = ?,
-         evidence_json = ?, scope_json = ?, author_note = ?, updated_at = ? WHERE id = ?`, input.title ?? String(current.title), input.category ?? String(current.category), input.content ?? String(current.content), JSON.stringify(input.tags ?? current.tags), input.status ?? String(current.status), (input.locked ?? Boolean(current.locked)) ? 1 : 0, JSON.stringify(input.evidence ?? current.evidence), JSON.stringify(input.scope ?? current.scope), input.authorNote ?? String(current.authorNote), now(), settingId);
+         evidence_json = ?, scope_json = ?, author_note = ?, updated_at = ? WHERE id = ?`, input.title ?? String(current.title), input.category ?? String(current.category), content, JSON.stringify(input.tags ?? current.tags), input.status ?? String(current.status), (input.locked ?? Boolean(current.locked)) ? 1 : 0, JSON.stringify(input.evidence ?? current.evidence), JSON.stringify(input.scope ?? current.scope), input.authorNote ?? String(current.authorNote), now(), settingId);
+            this.syncMarkdownAttachmentReferences(String(current.workId), "setting", settingId, content);
             this.recordEntityVersion("setting", settingId, source, sourceRef, changeNote || "更新世界观设定");
             this.audit(String(current.workId), "setting.updated", "setting", settingId, { fields: Object.keys(input), source, sourceRef });
         });
@@ -1610,6 +1736,7 @@ export class Store {
         this.db.transaction(() => {
             this.assertExpectedVersion("setting", settingId, expectedVersionNo, "设定");
             this.recordEntityVersion("setting", settingId, "delete", null, "删除世界观设定");
+            this.clearMarkdownAttachmentReferences("setting", settingId);
             this.db.run("DELETE FROM settings WHERE id = ?", settingId);
             this.audit(String(current.workId), "setting.deleted", "setting", settingId);
         });
@@ -1647,10 +1774,13 @@ export class Store {
         const memberIds = [...new Set(input.memberIds ?? [])];
         this.assertCharactersInWork(workId, memberIds);
         const memberSnapshots = this.captureCharacterSnapshots(memberIds);
+        const settingsSections = knowledgeSectionsFromInput(input.settingsSections, input.settingsMarkdown, input.settings);
+        const settings = settingsFromKnowledgeSections(settingsSections);
         const timestamp = now();
         this.db.transaction(() => {
-            this.db.run(`INSERT INTO races (id, work_id, parent_race_id, name, normalized_name, description, settings_json, created_at, updated_at)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`, raceId, workId, parentRaceId, name, normalizedName, input.description ?? "", JSON.stringify(input.settings ?? []), timestamp, timestamp);
+            this.db.run(`INSERT INTO races (id, work_id, parent_race_id, name, normalized_name, description, settings_json, settings_sections_json, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, raceId, workId, parentRaceId, name, normalizedName, input.description ?? "", JSON.stringify(settings), JSON.stringify(settingsSections), timestamp, timestamp);
+            this.syncMarkdownAttachmentReferences(workId, "race", raceId, settingsMarkdownFromList(settings));
             this.replaceRaceMembers(raceId, name, memberIds);
             this.recordMembershipVersions(memberSnapshots, "race", raceId, `设为种族“${name}”`);
             this.recordEntityVersion("race", raceId, source, sourceRef, changeNote || "建立种族档案", timestamp);
@@ -1696,9 +1826,13 @@ export class Store {
             ? [...new Set([...current.memberIds, ...(memberIds ?? [])])]
             : [];
         const memberSnapshots = this.captureCharacterSnapshots(touchedMemberIds);
+        const currentSections = knowledgeSectionsFromStored(current.settingsSections, current.settings);
+        const settingsSections = knowledgeSectionsFromInput(input.settingsSections, input.settingsMarkdown, input.settings, currentSections);
+        const settings = settingsFromKnowledgeSections(settingsSections);
         this.db.transaction(() => {
             this.assertExpectedVersion("race", raceId, expectedVersionNo, "种族");
-            this.db.run(`UPDATE races SET parent_race_id = ?, name = ?, normalized_name = ?, description = ?, settings_json = ?, updated_at = ? WHERE id = ?`, parentRaceId, name, normalizedName, input.description ?? String(current.description), JSON.stringify(input.settings ?? current.settings), now(), raceId);
+            this.db.run(`UPDATE races SET parent_race_id = ?, name = ?, normalized_name = ?, description = ?, settings_json = ?, settings_sections_json = ?, updated_at = ? WHERE id = ?`, parentRaceId, name, normalizedName, input.description ?? String(current.description), JSON.stringify(settings), JSON.stringify(settingsSections), now(), raceId);
+            this.syncMarkdownAttachmentReferences(workId, "race", raceId, settingsMarkdownFromList(settings));
             if (nameChanged)
                 this.db.run("UPDATE characters SET species = ?, updated_at = ? WHERE race_id = ?", name, now(), raceId);
             if (memberIds)
@@ -1720,6 +1854,7 @@ export class Store {
             this.assertExpectedVersion("race", raceId, expectedVersionNo, "种族");
             this.recordEntityVersion("race", raceId, "delete", null, "删除种族档案");
             this.db.run("UPDATE characters SET race_id = NULL, species = '', updated_at = ? WHERE race_id = ?", now(), raceId);
+            this.clearMarkdownAttachmentReferences("race", raceId);
             this.db.run("DELETE FROM races WHERE id = ?", raceId);
             this.recordMembershipVersions(memberSnapshots, "race", raceId, `种族“${String(current.name)}”已删除`);
             this.audit(String(current.workId), "race.deleted", "race", raceId);
@@ -1746,15 +1881,19 @@ export class Store {
             : target.parentRaceId;
         const descriptionParts = [String(target.description).trim(), String(source.description).trim()].filter(Boolean);
         const description = [...new Set(descriptionParts)].join("\n\n");
-        const settings = [...new Set([...target.settings, ...source.settings])];
+        const settingsSections = [...knowledgeSectionsFromStored(target.settingsSections, target.settings), ...knowledgeSectionsFromStored(source.settingsSections, source.settings)]
+            .map((section, index) => ({ ...section, sortOrder: index }));
+        const settings = settingsFromKnowledgeSections(settingsSections);
         this.db.transaction(() => {
             this.recordEntityVersion("race", sourceRaceId, "delete", mergeId, `合并至种族“${String(target.name)}”`, timestamp);
-            this.db.run("UPDATE races SET parent_race_id = ?, description = ?, settings_json = ?, updated_at = ? WHERE id = ?", targetParentRaceId, description, JSON.stringify(settings), timestamp, targetRaceId);
+            this.db.run("UPDATE races SET parent_race_id = ?, description = ?, settings_json = ?, settings_sections_json = ?, updated_at = ? WHERE id = ?", targetParentRaceId, description, JSON.stringify(settings), JSON.stringify(settingsSections), timestamp, targetRaceId);
+            this.syncMarkdownAttachmentReferences(workId, "race", targetRaceId, settingsMarkdownFromList(settings));
             this.db.run("UPDATE characters SET race_id = ?, species = ?, updated_at = ? WHERE race_id = ?", targetRaceId, String(target.name), timestamp, sourceRaceId);
             for (const childRaceId of sourceChildren) {
                 this.db.run("UPDATE races SET parent_race_id = ?, updated_at = ? WHERE id = ?", targetRaceId, timestamp, childRaceId);
                 this.recordEntityVersion("race", childRaceId, "merge", mergeId, `因种族“${String(source.name)}”合并而迁移父种族`, timestamp);
             }
+            this.clearMarkdownAttachmentReferences("race", sourceRaceId);
             this.db.run("DELETE FROM races WHERE id = ?", sourceRaceId);
             this.recordMembershipVersions(memberSnapshots, "race", targetRaceId, `合并种族“${String(source.name)}”`);
             this.recordEntityVersion("race", targetRaceId, "merge", mergeId, `合并种族“${String(source.name)}”`, timestamp);
@@ -1772,6 +1911,8 @@ export class Store {
     mapRace(row) {
         const raceId = requiredString(row, "id");
         const lineage = this.raceLineage(raceId);
+        const settingsSections = knowledgeSectionsFromStored(row.settings_sections_json, json(requiredString(row, "settings_json"), []));
+        const settings = settingsFromKnowledgeSections(settingsSections);
         const members = this.db.all("SELECT id, name FROM characters WHERE race_id = ? ORDER BY name", requiredString(row, "id")).map((member) => ({
             characterId: requiredString(member, "id"),
             name: requiredString(member, "name")
@@ -1782,10 +1923,15 @@ export class Store {
             parentRaceId: optionalString(row, "parent_race_id"),
             name: requiredString(row, "name"),
             description: requiredString(row, "description"),
-            settings: json(requiredString(row, "settings_json"), []),
+            settings,
+            settingsMarkdown: settingsMarkdownFromList(settings),
+            settingsSections,
             lineage: lineage.map((item) => ({ id: item.id, name: item.name })),
-            effectiveSettings: lineage.flatMap((item, index) => item.settings.map((value) => ({
-                value,
+            effectiveSettings: lineage.flatMap((item, index) => item.settingsSections.map((section) => ({
+                title: section.title,
+                summary: section.summary,
+                sortOrder: section.sortOrder,
+                value: section.contentMarkdown,
                 sourceRaceId: item.id,
                 sourceRaceName: item.name,
                 inherited: index < lineage.length - 1
@@ -1835,13 +1981,15 @@ export class Store {
             if (seen.has(currentId))
                 throw new AppError(500, "RACE_HIERARCHY_INVALID", "种族层级存在循环");
             seen.add(currentId);
-            const row = this.db.get("SELECT id, name, settings_json, parent_race_id FROM races WHERE id = ?", currentId);
+            const row = this.db.get("SELECT id, name, settings_json, settings_sections_json, parent_race_id FROM races WHERE id = ?", currentId);
             if (!row)
                 throw new AppError(500, "RACE_HIERARCHY_INVALID", "种族层级引用了不存在的父种族");
+            const settingsSections = knowledgeSectionsFromStored(row.settings_sections_json, json(requiredString(row, "settings_json"), []));
             lineage.push({
                 id: requiredString(row, "id"),
                 name: requiredString(row, "name"),
-                settings: json(requiredString(row, "settings_json"), [])
+                settings: settingsFromKnowledgeSections(settingsSections),
+                settingsSections
             });
             currentId = optionalString(row, "parent_race_id");
         }
@@ -1867,10 +2015,13 @@ export class Store {
         const memberIds = [...new Set(input.memberIds ?? [])];
         this.assertCharactersInWork(workId, memberIds);
         const memberSnapshots = this.captureCharacterSnapshots(memberIds);
+        const settingsSections = knowledgeSectionsFromInput(input.settingsSections, input.settingsMarkdown, input.settings);
+        const settings = settingsFromKnowledgeSections(settingsSections);
         const timestamp = now();
         this.db.transaction(() => {
-            this.db.run(`INSERT INTO organizations (id, work_id, name, normalized_name, description, settings_json, created_at, updated_at)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?)`, organizationId, workId, name, normalizedName, input.description ?? "", JSON.stringify(input.settings ?? []), timestamp, timestamp);
+            this.db.run(`INSERT INTO organizations (id, work_id, name, normalized_name, description, settings_json, settings_sections_json, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`, organizationId, workId, name, normalizedName, input.description ?? "", JSON.stringify(settings), JSON.stringify(settingsSections), timestamp, timestamp);
+            this.syncMarkdownAttachmentReferences(workId, "organization", organizationId, settingsMarkdownFromList(settings));
             this.replaceOrganizationMembers(organizationId, memberIds);
             this.recordMembershipVersions(memberSnapshots, "organization", organizationId, `加入组织“${name}”`);
             this.recordEntityVersion("organization", organizationId, source, sourceRef, changeNote || "建立组织档案", timestamp);
@@ -1909,9 +2060,13 @@ export class Store {
             this.assertCharactersInWork(workId, memberIds);
         const touchedMemberIds = memberIds ? [...new Set([...current.memberIds, ...memberIds])] : [];
         const memberSnapshots = this.captureCharacterSnapshots(touchedMemberIds);
+        const currentSections = knowledgeSectionsFromStored(current.settingsSections, current.settings);
+        const settingsSections = knowledgeSectionsFromInput(input.settingsSections, input.settingsMarkdown, input.settings, currentSections);
+        const settings = settingsFromKnowledgeSections(settingsSections);
         this.db.transaction(() => {
             this.assertExpectedVersion("organization", organizationId, expectedVersionNo, "组织");
-            this.db.run(`UPDATE organizations SET name = ?, normalized_name = ?, description = ?, settings_json = ?, updated_at = ? WHERE id = ?`, name, normalizedName, input.description ?? String(current.description), JSON.stringify(input.settings ?? current.settings), now(), organizationId);
+            this.db.run(`UPDATE organizations SET name = ?, normalized_name = ?, description = ?, settings_json = ?, settings_sections_json = ?, updated_at = ? WHERE id = ?`, name, normalizedName, input.description ?? String(current.description), JSON.stringify(settings), JSON.stringify(settingsSections), now(), organizationId);
+            this.syncMarkdownAttachmentReferences(workId, "organization", organizationId, settingsMarkdownFromList(settings));
             if (memberIds) {
                 this.replaceOrganizationMembers(organizationId, memberIds);
                 this.recordMembershipVersions(memberSnapshots, "organization", organizationId, `组织“${name}”成员关系变更`);
@@ -1927,6 +2082,7 @@ export class Store {
         this.db.transaction(() => {
             this.assertExpectedVersion("organization", organizationId, expectedVersionNo, "组织");
             this.recordEntityVersion("organization", organizationId, "delete", null, "删除组织档案");
+            this.clearMarkdownAttachmentReferences("organization", organizationId);
             this.db.run("DELETE FROM organizations WHERE id = ?", organizationId);
             this.recordMembershipVersions(memberSnapshots, "organization", organizationId, `组织“${String(current.name)}”已删除`);
             this.audit(String(current.workId), "organization.deleted", "organization", organizationId);
@@ -1948,15 +2104,19 @@ export class Store {
         const memberSnapshots = this.captureCharacterSnapshots(memberIds);
         const descriptionParts = [String(target.description).trim(), String(source.description).trim()].filter(Boolean);
         const description = [...new Set(descriptionParts)].join("\n\n");
-        const settings = [...new Set([...target.settings, ...source.settings])];
+        const settingsSections = [...knowledgeSectionsFromStored(target.settingsSections, target.settings), ...knowledgeSectionsFromStored(source.settingsSections, source.settings)]
+            .map((section, index) => ({ ...section, sortOrder: index }));
+        const settings = settingsFromKnowledgeSections(settingsSections);
         const sourceMemberships = this.db.all("SELECT character_id, role, note, created_at FROM character_organization_memberships WHERE organization_id = ?", sourceOrganizationId);
         this.db.transaction(() => {
             this.recordEntityVersion("organization", sourceOrganizationId, "delete", mergeId, `合并至组织“${String(target.name)}”`, timestamp);
-            this.db.run("UPDATE organizations SET description = ?, settings_json = ?, updated_at = ? WHERE id = ?", description, JSON.stringify(settings), timestamp, targetOrganizationId);
+            this.db.run("UPDATE organizations SET description = ?, settings_json = ?, settings_sections_json = ?, updated_at = ? WHERE id = ?", description, JSON.stringify(settings), JSON.stringify(settingsSections), timestamp, targetOrganizationId);
+            this.syncMarkdownAttachmentReferences(workId, "organization", targetOrganizationId, settingsMarkdownFromList(settings));
             for (const membership of sourceMemberships) {
                 this.db.run(`INSERT INTO character_organization_memberships (character_id, organization_id, role, note, created_at, updated_at)
            VALUES (?, ?, ?, ?, ?, ?) ON CONFLICT(character_id, organization_id) DO NOTHING`, requiredString(membership, "character_id"), targetOrganizationId, requiredString(membership, "role"), requiredString(membership, "note"), requiredString(membership, "created_at"), timestamp);
             }
+            this.clearMarkdownAttachmentReferences("organization", sourceOrganizationId);
             this.db.run("DELETE FROM organizations WHERE id = ?", sourceOrganizationId);
             this.recordMembershipVersions(memberSnapshots, "organization", targetOrganizationId, `合并组织“${String(source.name)}”`);
             this.recordEntityVersion("organization", targetOrganizationId, "merge", mergeId, `合并组织“${String(source.name)}”`, timestamp);
@@ -1965,6 +2125,8 @@ export class Store {
         return { mergeId, target: this.getOrganization(targetOrganizationId), source };
     }
     mapOrganization(row) {
+        const settingsSections = knowledgeSectionsFromStored(row.settings_sections_json, json(requiredString(row, "settings_json"), []));
+        const settings = settingsFromKnowledgeSections(settingsSections);
         const members = this.db.all(`SELECT c.id, c.name, m.role, m.note
        FROM character_organization_memberships m
        JOIN characters c ON c.id = m.character_id
@@ -1979,7 +2141,9 @@ export class Store {
             workId: requiredString(row, "work_id"),
             name: requiredString(row, "name"),
             description: requiredString(row, "description"),
-            settings: json(requiredString(row, "settings_json"), []),
+            settings,
+            settingsMarkdown: settingsMarkdownFromList(settings),
+            settingsSections,
             memberIds: members.map((member) => member.characterId),
             members,
             versionNo: this.currentEntityVersionNo("organization", requiredString(row, "id")),
@@ -2178,21 +2342,27 @@ export class Store {
     attachmentIdsInMarkdown(contentMarkdown) {
         return [...new Set([...contentMarkdown.matchAll(/attachment:\/\/([A-Za-z0-9_-]{1,300})/gu)].map((match) => String(match[1])))];
     }
-    syncCharacterProfileSectionAttachments(section) {
-        const sectionId = String(section.id);
-        const workId = String(section.workId);
-        const attachmentIds = this.attachmentIdsInMarkdown(String(section.contentMarkdown));
+    syncMarkdownAttachmentReferences(workId, entityType, entityId, contentMarkdown) {
+        const attachmentIds = this.attachmentIdsInMarkdown(contentMarkdown);
         for (const attachmentId of attachmentIds) {
             const attachment = this.getAttachment(attachmentId);
             if (attachment.workId !== workId)
                 throw new AppError(400, "ATTACHMENT_WORK_MISMATCH", "附件不属于当前作品");
         }
-        this.db.run("DELETE FROM attachment_references WHERE entity_type = 'character-section' AND entity_id = ?", sectionId);
+        this.db.run("DELETE FROM attachment_references WHERE entity_type = ? AND entity_id = ?", entityType, entityId);
         for (const attachmentId of attachmentIds) {
             this.db.run(`INSERT INTO attachment_references (attachment_id, work_id, entity_type, entity_id, created_at)
-         VALUES (?, ?, 'character-section', ?, ?)`, attachmentId, workId, sectionId, now());
+         VALUES (?, ?, ?, ?, ?)`, attachmentId, workId, entityType, entityId, now());
         }
     }
+    clearMarkdownAttachmentReferences(entityType, entityId) {
+        this.db.run("DELETE FROM attachment_references WHERE entity_type = ? AND entity_id = ?", entityType, entityId);
+    }
+    syncCharacterProfileSectionAttachments(section) {
+        const sectionId = String(section.id);
+        const workId = String(section.workId);
+        this.syncMarkdownAttachmentReferences(workId, "character-section", sectionId, String(section.contentMarkdown));
+    }
     createCharacterProfileSection(characterId, input, source = "create", sourceRef = null) {
         const character = this.getCharacter(characterId);
         const sectionId = id("characterSection");
@@ -2386,7 +2556,7 @@ export class Store {
         const attachment = this.getAttachment(attachmentId);
         const references = Number(this.db.get("SELECT COUNT(*) AS count FROM attachment_references WHERE attachment_id = ?", attachmentId)?.count ?? 0);
         if (references > 0)
-            throw new AppError(409, "ATTACHMENT_IN_USE", "附件仍被人物档案章节引用，无法删除");
+            throw new AppError(409, "ATTACHMENT_IN_USE", "附件仍被资料引用，无法删除");
         const storageKey = String(attachment.storageKey);
         this.db.transaction(() => {
             this.db.run("DELETE FROM attachments WHERE id = ?", attachmentId);
@@ -3438,14 +3608,28 @@ export class Store {
     }
     listTasks(workId) {
         this.getWork(workId);
-        return this.db.all("SELECT * FROM analysis_tasks WHERE work_id = ? ORDER BY created_at DESC", workId).map((row) => this.mapTask(row));
+        return this.db.all("SELECT * FROM analysis_tasks WHERE work_id = ? ORDER BY created_at DESC, id DESC", workId).map((row) => this.mapTask(row));
     }
     listTasksPage(workId, pagination) {
         this.getWork(workId);
         const page = paginationSql(pagination);
-        const rows = this.db.all(`SELECT * FROM analysis_tasks WHERE work_id = ? ORDER BY created_at DESC${page.sql}`, workId, ...page.params);
+        const rows = this.db.all(`SELECT * FROM analysis_tasks WHERE work_id = ? ORDER BY created_at DESC, id DESC${page.sql}`, workId, ...page.params);
         return paginated(rows.map((row) => this.mapTask(row)), pagination);
     }
+    listTaskSummariesPage(workId, pagination) {
+        this.getWork(workId);
+        const page = paginationSql(pagination);
+        const rows = this.db.all(`SELECT id, work_id, task_type, scope_json, status, progress, created_at, updated_at
+       FROM analysis_tasks WHERE work_id = ? ORDER BY created_at DESC, id DESC${page.sql}`, workId, ...page.params);
+        const chapterSummaries = new Map(this.db.all(`SELECT chapter.id, chapter.title, volume.title AS volume_title
+       FROM chapters chapter JOIN volumes volume ON volume.id = chapter.volume_id
+       WHERE chapter.work_id = ?`, workId).map((row) => [
+            requiredString(row, "id"),
+            `${requiredString(row, "volume_title")} · ${requiredString(row, "title")}`
+        ]));
+        const volumeTitles = new Map(this.db.all("SELECT id, title FROM volumes WHERE work_id = ?", workId).map((row) => [requiredString(row, "id"), requiredString(row, "title")]));
+        return paginated(rows.map((row) => this.mapTaskSummary(row, chapterSummaries, volumeTitles)), pagination);
+    }
     getTask(taskId) {
         const row = this.db.get("SELECT * FROM analysis_tasks WHERE id = ?", taskId);
         if (!row)
@@ -3535,6 +3719,31 @@ export class Store {
             updatedAt: requiredString(row, "updated_at")
         };
     }
+    mapTaskSummary(row, chapterSummaries, volumeTitles) {
+        const scope = json(requiredString(row, "scope_json"), {});
+        return {
+            id: requiredString(row, "id"),
+            workId: requiredString(row, "work_id"),
+            taskType: requiredString(row, "task_type"),
+            scope,
+            scopeSummary: this.taskScopeSummaryFromMaps(scope, chapterSummaries, volumeTitles),
+            status: requiredString(row, "status"),
+            progress: numberValue(row, "progress"),
+            createdAt: requiredString(row, "created_at"),
+            updatedAt: requiredString(row, "updated_at")
+        };
+    }
+    taskScopeSummaryFromMaps(scope, chapterSummaries, volumeTitles) {
+        if (typeof scope.chapterId === "string")
+            return chapterSummaries.get(scope.chapterId) ?? "章节已删除";
+        if (scope.type === "volume" && typeof scope.volumeId === "string") {
+            const title = volumeTitles.get(scope.volumeId);
+            return title ? `分卷 · ${title}` : "分卷已删除";
+        }
+        if (scope.type === "book" || Object.keys(scope).length === 0)
+            return "全书";
+        return "未指定范围";
+    }
     taskScopeSummary(workId, scope) {
         if (typeof scope.chapterId === "string") {
             const chapter = this.db.get(`SELECT chapter.title AS title, volume.title AS volume_title